gems/opal-task/internal/engine/history.go

package engine

import (
	"fmt"
	"strings"
	"time"

	"github.com/google/uuid"
)

// HistoryEntry represents a change_log entry for display.
type HistoryEntry struct {
	ID         int
	Timestamp  time.Time
	ChangeType string // "create", "update", "delete"
	Data       string // raw key:value data from change_log
}

// GetTaskHistory returns change_log entries for a task UUID, ordered chronologically.
func GetTaskHistory(taskUUID uuid.UUID) ([]HistoryEntry, error) {
	db := GetDB()
	if db == nil {
		return nil, fmt.Errorf("database not initialized")
	}

	rows, err := db.Query(
		"SELECT id, changed_at, change_type, data FROM change_log WHERE task_uuid = ? ORDER BY id ASC",
		taskUUID.String(),
	)
	if err != nil {
		return nil, fmt.Errorf("failed to query change_log: %w", err)
	}
	defer rows.Close()

	var entries []HistoryEntry
	for rows.Next() {
		var e HistoryEntry
		var changedAt int64
		if err := rows.Scan(&e.ID, &changedAt, &e.ChangeType, &e.Data); err != nil {
			return nil, fmt.Errorf("failed to scan change_log entry: %w", err)
		}
		e.Timestamp = time.Unix(changedAt, 0)
		entries = append(entries, e)
	}

	return entries, nil
}

// FormatTaskHistory returns a diff-style history display.
// Compares consecutive entries and shows only what changed.
func FormatTaskHistory(entries []HistoryEntry) string {
	if len(entries) == 0 {
		return "No history found.\n"
	}

	var sb strings.Builder
	var prevFields map[string]string

	for _, entry := range entries {
		ts := entry.Timestamp.Format("2006-01-02 15:04")
		currentFields := parseChangeData(entry.Data)

		if entry.ChangeType == "create" {
			// Show creation summary
			desc := currentFields["description"]
			priority := currentFields["priority"]
			tags := currentFields["tags"]
			line := fmt.Sprintf("%s  created    \"%s\"", ts, desc)
			if priority != "" && priority != "D" {
				line += fmt.Sprintf(" priority:%s", priority)
			}
			if tags != "" {
				for _, tag := range strings.Split(tags, ",") {
					line += fmt.Sprintf(" +%s", strings.TrimSpace(tag))
				}
			}
			sb.WriteString(line + "\n")
		} else if entry.ChangeType == "delete" {
			sb.WriteString(fmt.Sprintf("%s  deleted\n", ts))
		} else if entry.ChangeType == "update" {
			if prevFields == nil {
				// No previous entry to diff against, show as generic update
				sb.WriteString(fmt.Sprintf("%s  updated\n", ts))
			} else {
				// Diff against previous
				changes := diffFields(prevFields, currentFields)
				if len(changes) == 0 {
					sb.WriteString(fmt.Sprintf("%s  updated    (tags changed)\n", ts))
				} else {
					for i, change := range changes {
						if i == 0 {
							sb.WriteString(fmt.Sprintf("%s  modified   %s\n", ts, change))
						} else {
							sb.WriteString(fmt.Sprintf("                         %s\n", change))
						}
					}
				}
			}
		}

		prevFields = currentFields
	}

	return sb.String()
}

// parseChangeData parses key:value lines from change_log data.
func parseChangeData(data string) map[string]string {
	fields := make(map[string]string)
	for _, line := range strings.Split(data, "\n") {
		line = strings.TrimSpace(line)
		if line == "" {
			continue
		}
		parts := strings.SplitN(line, ": ", 2)
		if len(parts) == 2 {
			fields[parts[0]] = parts[1]
		}
	}
	return fields
}

// diffFields compares two field maps and returns human-readable change descriptions.
func diffFields(prev, curr map[string]string) []string {
	var changes []string

	// Skip internal/timestamp fields
	skip := map[string]bool{
		"uuid": true, "created": true, "modified": true,
	}

	// Check fields in current that differ from prev
	for key, currVal := range curr {
		if skip[key] {
			continue
		}
		prevVal, existed := prev[key]
		if !existed {
			changes = append(changes, fmt.Sprintf("%s: (none) → %s", key, formatFieldValue(key, currVal)))
		} else if prevVal != currVal {
			changes = append(changes, fmt.Sprintf("%s: %s → %s", key, formatFieldValue(key, prevVal), formatFieldValue(key, currVal)))
		}
	}

	// Check fields removed (in prev but not in current)
	for key, prevVal := range prev {
		if skip[key] {
			continue
		}
		if _, exists := curr[key]; !exists {
			changes = append(changes, fmt.Sprintf("%s: %s → (none)", key, formatFieldValue(key, prevVal)))
		}
	}

	return changes
}

// formatFieldValue formats a change_log field value for human display.
func formatFieldValue(key, value string) string {
	// For timestamp fields, try to format as dates
	switch key {
	case "due", "scheduled", "wait", "until", "start", "end":
		if t, err := parseUnixString(value); err == nil {
			return t.Format("2006-01-02")
		}
	case "status":
		return value // already human-readable
	}
	return value
}

// parseUnixString parses a unix timestamp string.
func parseUnixString(s string) (time.Time, error) {
	var ts int64
	_, err := fmt.Sscanf(s, "%d", &ts)
	if err != nil {
		return time.Time{}, err
	}
	return time.Unix(ts, 0), nil
}