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

117 lines
2.3 KiB
Go

package sync
import (
"encoding/json"
"fmt"
"os"
"git.jnss.me/joakim/opal/internal/engine"
"github.com/google/uuid"
)
// QueuedChange represents a change waiting to be synced
type QueuedChange struct {
ID string `json:"id"`
Timestamp int64 `json:"timestamp"`
TaskUUID uuid.UUID `json:"task_uuid"`
Type string `json:"type"` // create, update, delete
Data json.RawMessage `json:"data"`
}
// Queue manages offline changes
type Queue struct {
filepath string
changes []QueuedChange
}
// NewQueue creates a new queue instance
func NewQueue() (*Queue, error) {
queuePath, err := engine.GetSyncQueuePath()
if err != nil {
return nil, err
}
q := &Queue{filepath: queuePath}
if err := q.load(); err != nil {
// If file doesn't exist, start with empty queue
if !os.IsNotExist(err) {
return nil, err
}
q.changes = []QueuedChange{}
}
return q, nil
}
// Add adds a change to the queue
func (q *Queue) Add(change QueuedChange) error {
q.changes = append(q.changes, change)
return q.save()
}
// GetPending returns all pending changes
func (q *Queue) GetPending() []QueuedChange {
return q.changes
}
// Clear removes all changes from the queue
func (q *Queue) Clear() error {
q.changes = []QueuedChange{}
return q.save()
}
// Size returns the number of pending changes
func (q *Queue) Size() int {
return len(q.changes)
}
// load reads the queue from disk
func (q *Queue) load() error {
data, err := os.ReadFile(q.filepath)
if err != nil {
return err
}
return json.Unmarshal(data, &q.changes)
}
// save writes the queue to disk
func (q *Queue) save() error {
data, err := json.MarshalIndent(q.changes, "", " ")
if err != nil {
return err
}
return os.WriteFile(q.filepath, data, 0644)
}
// QueueLocalChanges adds local task changes to the queue
func QueueLocalChanges(tasks []*engine.Task) error {
queue, err := NewQueue()
if err != nil {
return fmt.Errorf("failed to create queue: %w", err)
}
for _, task := range tasks {
taskData, err := json.Marshal(task)
if err != nil {
continue
}
change := QueuedChange{
ID: uuid.New().String(),
Timestamp: task.Modified.Unix(),
TaskUUID: task.UUID,
Type: "update",
Data: taskData,
}
if err := queue.Add(change); err != nil {
return fmt.Errorf("failed to queue change: %w", err)
}
}
return nil
}