storage

type Config struct {
	TasksDir      string
	GoalsDir      string
	ThemesDir     string
	ObjectivesDir string
	VisionDir     string
	DailyDir      string
	TopicsDir     string
	Excludes      []string
}

type DailyNoteStorage interface {
	ReadDailyNote(ctx context.Context, vaultPath string, date string) (string, error)
	WriteDailyNote(ctx context.Context, vaultPath string, date string, content string) error
}

type DecisionStorage interface {
	ListDecisions(ctx context.Context, vaultPath string) ([]*domain.Decision, error)
	FindDecisionByName(ctx context.Context, vaultPath string, name string) (*domain.Decision, error)
	WriteDecision(ctx context.Context, decision *domain.Decision) error
}

type GoalStorage interface {
	WriteGoal(ctx context.Context, goal *domain.Goal) error
	FindGoalByName(ctx context.Context, vaultPath string, name string) (*domain.Goal, error)
}

type ObjectiveStorage interface {
	WriteObjective(ctx context.Context, objective *domain.Objective) error
	FindObjectiveByName(
		ctx context.Context,
		vaultPath string,
		name string,
	) (*domain.Objective, error)
}

type OpenQuestionItem struct {
	Index    int
	Question string
	Answer   string
	Marker   string
	Line     int
}

type PageStorage interface {
	ListPages(ctx context.Context, vaultPath string, pagesDir string) ([]*domain.Page, error)
	// ReadPage returns a single page from a specific directory in the vault.
	// Unlike ListPages it reads only the named file, and it fails when that file
	// is missing or unparseable rather than skipping it.
	//
	// name must be a bare page base name without the .md extension — the same
	// value ListPages reports in Page.Name.
	ReadPage(
		ctx context.Context,
		vaultPath string,
		pagesDir string,
		name string,
	) (*domain.Page, error)
}

type Storage interface {
	TaskStorage
	GoalStorage
	ThemeStorage
	ObjectiveStorage
	VisionStorage
	TopicStorage
	DailyNoteStorage
	PageStorage
	DecisionStorage
	// Legacy methods — used by storage tests, not by ops.
	// Keep on composed interface for backward compat; not on narrow interfaces.
	ReadTask(ctx context.Context, vaultPath string, taskID domain.TaskID) (*domain.Task, error)
	ListTasks(ctx context.Context, vaultPath string) ([]*domain.Task, error)
	ReadGoal(ctx context.Context, vaultPath string, goalID domain.GoalID) (*domain.Goal, error)
	ReadTheme(ctx context.Context, vaultPath string, themeID domain.ThemeID) (*domain.Theme, error)
	ReadObjective(
		ctx context.Context,
		vaultPath string,
		objectiveID domain.ObjectiveID,
	) (*domain.Objective, error)
	ReadVision(
		ctx context.Context,
		vaultPath string,
		visionID domain.VisionID,
	) (*domain.Vision, error)
}

type TaskStorage interface {
	WriteTask(ctx context.Context, task *domain.Task) error
	FindTaskByName(ctx context.Context, vaultPath string, name string) (*domain.Task, error)
	// ListTasks returns every task in the vault's configured tasks_dir. An
	// unreadable task file is skipped (logged at debug level) so a listing still
	// succeeds — see ListTasksStrict for the caller that must not lose a file.
	ListTasks(ctx context.Context, vaultPath string) ([]*domain.Task, error)
	// ListTasksStrict returns every task in the vault's configured tasks_dir and
	// fails on an unreadable task file instead of skipping it. A caller whose
	// result must not silently describe a smaller set (the weekly rollup) uses
	// this; the error names the offending file.
	ListTasksStrict(ctx context.Context, vaultPath string) ([]*domain.Task, error)
}

type ThemeStorage interface {
	WriteTheme(ctx context.Context, theme *domain.Theme) error
	FindThemeByName(ctx context.Context, vaultPath string, name string) (*domain.Theme, error)
}

type TopicStorage interface {
	WriteTopic(ctx context.Context, topic *domain.Topic) error
	FindTopicByName(ctx context.Context, vaultPath string, name string) (*domain.Topic, error)
}

type VisionStorage interface {
	WriteVision(ctx context.Context, vision *domain.Vision) error
	FindVisionByName(ctx context.Context, vaultPath string, name string) (*domain.Vision, error)
}