Files
joakim 5d01c9f564 refactor: implement configurable directory structure with XDG support
Separate configuration from data storage and make paths configurable
via environment variables and command-line flags. This improves
Unix/Linux compliance and supports both development and production
deployments.

Key changes:
- Separate config dir (opal.yml) from data dir (database, logs)
- Support XDG Base Directory specification
- Add --config-dir and --data-dir flags
- Environment variables: OPAL_CONFIG_DIR, OPAL_DATA_DIR, OPAL_DB_PATH
- Smart fallback: /etc/opal, /var/lib/opal -> ~/.config/opal, ~/.local/share/opal
- Server mode validates required OAuth/JWT environment variables
- Update naming from 'jade' to 'opal' throughout
- Update systemd service name to 'opal.service'
- Add migration guide in README

Default paths:
- Config: /etc/opal (fallback: ~/.config/opal)
- Data: /var/lib/opal (fallback: ~/.local/share/opal)

Files modified:
- internal/engine/config.go: New directory resolution logic
- internal/engine/database.go: Auto-create data directory
- cmd/root.go: Add global flags for directory overrides
- cmd/server.go: Add configuration validation
- cmd/sync.go, internal/sync/*: Use new path helper functions
- tests: Update to use directory overrides
- docs: Update deployment guide and README
2026-01-06 20:46:29 +01:00

98 lines
2.5 KiB
Go

package cmd
import (
"fmt"
"os"
"sort"
"git.jnss.me/joakim/opal/internal/engine"
"github.com/spf13/cobra"
)
// CreateReportCommands generates commands for all reports dynamically
func CreateReportCommands() []*cobra.Command {
reports := engine.AllReports()
commands := make([]*cobra.Command, 0, len(reports))
// Create a command for each report
for name, report := range reports {
// Capture in closure
reportName := name
reportObj := report
cmd := &cobra.Command{
Use: reportName + " [filter...]",
Short: reportObj.Description,
Long: fmt.Sprintf("%s\n\nThis is a report that shows: %s", reportObj.Description, reportObj.Description),
Run: func(cmd *cobra.Command, args []string) {
parsed := getParsedArgs(cmd)
if err := runReport(reportName, parsed.Filters); err != nil {
fmt.Fprintf(os.Stderr, "Error: %v\n", err)
os.Exit(1)
}
},
}
commands = append(commands, cmd)
}
return commands
}
// runReport executes a report by name with optional filters
func runReport(reportName string, filters []string) error {
// Get the report
report, err := engine.GetReport(reportName)
if err != nil {
return err
}
// Execute the report (returns sorted tasks)
tasks, err := report.Execute(filters)
if err != nil {
return fmt.Errorf("failed to execute report: %w", err)
}
// Build working set from sorted tasks - IDs will match display order
ws, err := engine.BuildWorkingSet(tasks)
if err != nil {
return fmt.Errorf("failed to build working set: %w", err)
}
// Display tasks based on format
var output string
if report.DisplayFormat == engine.DisplayFormatMinimal {
output = engine.FormatTaskListWithFormat(tasks, ws, "minimal")
} else {
output = engine.FormatTaskListWithFormat(tasks, ws, "table")
}
fmt.Println(output)
return nil
}
// reportsCmd shows all available reports
var reportsCmd = &cobra.Command{
Use: "reports",
Short: "List all available reports",
Long: `Display a list of all available task reports with their descriptions.`,
Run: func(cmd *cobra.Command, args []string) {
reports := engine.AllReports()
// Sort by name
names := make([]string, 0, len(reports))
for name := range reports {
names = append(names, name)
}
sort.Strings(names)
fmt.Println("Available reports:")
for _, name := range names {
report := reports[name]
fmt.Printf(" %-12s %s\n", name, report.Description)
}
fmt.Println("\nUsage: opal <report-name> [filters...]")
fmt.Println("Example: opal ready +home")
},
}