@project-ava-supernova/core 0.2.71

package/dist/tasks/task-manager.d.ts

@@ -0,0 +1,164 @@
+import type { TaskEntry, TaskStore, TaskStatus, TaskPriority, TaskCategory, TaskSource, TaskRecurrence, TaskSubtask, TaskReminderLead, TaskContext, TaskListOptions } from './types.js';
+/**
+ * One-time move of a scoped account's global task store into a dedicated
+ * `tasks/` subfolder: `<scopedRoot>/tasks.json` → `<scopedRoot>/tasks/tasks.json`.
+ * Mirrors the `creative/` layout so the panel's "Open save folder" button has a
+ * clean target, and keeps the account root tidy. Safe to call on every startup —
+ * it no-ops once moved. Callers then construct TaskManager with
+ * `globalDir: join(scopedRoot, 'tasks')`.
+ *
+ * SYNCHRONOUS on purpose: TaskManager reads its store lazily, so the move must
+ * finish before the manager is constructed — otherwise an empty store could be
+ * written to the new path first and the move would silently skip (data loss).
+ * Call it immediately before `new TaskManager(...)`.
+ */
+export declare function migrateGlobalTasksToSubfolder(scopedRoot: string): void;
+/**
+ * The wall-clock moment a task's reminder should fire, in epoch ms — or null if
+ * the task has no reminder (no `reminderLead`, or no `dueDate` to anchor to).
+ * Date-only tasks default to a 09:00 local due time. Parsed as LOCAL time
+ * (no trailing Z) so "18:00" means 6pm where the user is.
+ * Pure + shared so the extension host and the IDE sidecar compute it identically.
+ */
+export declare function reminderFireTimeMs(entry: TaskEntry): number | null;
+/** Optional platform sync interface — mirrors PlatformMemorySync pattern. */
+export interface PlatformTaskSync {
+    pushTasks(tasks: TaskEntry[]): Promise<void>;
+    pullTasks(): Promise<TaskEntry[]>;
+}
+/** Options for creating a new task. */
+export interface TaskCreateOptions {
+    title: string;
+    description?: string;
+    priority?: TaskPriority;
+    status?: TaskStatus;
+    dueDate?: string;
+    dueTime?: string;
+    category?: TaskCategory;
+    source?: TaskSource;
+    project?: string;
+    recurrence?: TaskRecurrence;
+    subtasks?: TaskSubtask[];
+    reminderLead?: TaskReminderLead;
+    context?: TaskContext;
+    scope?: 'global' | 'project';
+}
+/** Options for updating a task. */
+export interface TaskUpdateOptions {
+    title?: string;
+    description?: string;
+    priority?: TaskPriority;
+    status?: TaskStatus;
+    dueDate?: string;
+    dueTime?: string;
+    category?: TaskCategory;
+    recurrence?: TaskRecurrence;
+    subtasks?: TaskSubtask[];
+    reminderLead?: TaskReminderLead;
+    context?: TaskContext;
+    /** Scheduler bookkeeping — stamp when a reminder has fired. */
+    reminderFiredAt?: string;
+}
+export declare class TaskManager {
+    private readonly globalDir;
+    private readonly projectDir;
+    private readonly projectRoot;
+    private readonly sync?;
+    private globalStore;
+    private projectStore;
+    /** When true, skip all platform sync. Default: true (local-first). */
+    private localOnly;
+    private sessionTasks;
+    constructor(opts: {
+        globalDir: string;
+        projectRoot?: string;
+        sync?: PlatformTaskSync;
+        localOnly?: boolean;
+    });
+    /** Toggle cloud sync at runtime. */
+    setLocalOnly(value: boolean): void;
+    /** Load global task store. */
+    loadGlobalStore(): Promise<TaskStore>;
+    /** Load project task store. */
+    loadProjectStore(): Promise<TaskStore | null>;
+    /** Add a new task. Returns the created entry. */
+    addTask(opts: TaskCreateOptions): Promise<TaskEntry>;
+    /** Update an existing task by ID. Searches both stores. */
+    updateTask(id: string, updates: TaskUpdateOptions): Promise<TaskEntry | null>;
+    /** Delete a task by ID. Returns true if found and deleted. */
+    deleteTask(id: string): Promise<boolean>;
+    /** Get a single task by ID. */
+    getTask(id: string): Promise<TaskEntry | null>;
+    /** List tasks with optional filters. Returns from both stores. */
+    listTasks(opts?: TaskListOptions): Promise<TaskEntry[]>;
+    /** Get today's tasks — due today OR status in-progress. */
+    getTodayTasks(): Promise<TaskEntry[]>;
+    /**
+     * Reminders that are due to fire right now and haven't yet — for the
+     * host/sidecar scheduler. Skips done/archived tasks and anything already
+     * stamped (`reminderFiredAt`). Caps catch-up so a task due more than 24h ago
+     * doesn't nag on next launch.
+     */
+    getDueReminders(nowMs?: number): Promise<TaskEntry[]>;
+    /** Stamp a task's reminder as fired (dedupe guard for the scheduler). */
+    markReminderFired(id: string): Promise<TaskEntry | null>;
+    /** Complete a task — sets status to 'done' and records completedAt. */
+    completeTask(id: string): Promise<TaskEntry | null>;
+    /** Archive a task. */
+    archiveTask(id: string): Promise<TaskEntry | null>;
+    /** Restore an archived task to todo. */
+    restoreTask(id: string): Promise<TaskEntry | null>;
+    /** Add a subtask to a task. Returns the updated task. */
+    addSubtask(taskId: string, title: string): Promise<TaskEntry | null>;
+    /** Toggle (or set) a subtask's done state. Returns the updated task. */
+    toggleSubtask(taskId: string, subtaskId: string, done?: boolean): Promise<TaskEntry | null>;
+    /** Add a session task (in-memory only, from Ava's todo_write). */
+    addSessionTask(task: {
+        id: string;
+        title: string;
+        status: TaskStatus;
+    }): void;
+    /** Update a session task status. */
+    updateSessionTask(id: string, status: TaskStatus): void;
+    /** Get all session tasks. */
+    getSessionTasks(): TaskEntry[];
+    /**
+     * No-op by design. Session tasks (Ava's todo_write working notes) are
+     * EPHEMERAL — they live in memory and surface only in the live "Ava's
+     * Progress" band. They are deliberately NOT persisted into the user's task
+     * store: flushing them polluted real task lists with dozens of stale `ava`
+     * todos that couldn't be cleared. The method is kept (callers across the
+     * extension, IDE, CLI and auto-executor invoke it) but does nothing.
+     */
+    flushSessionTasks(): Promise<void>;
+    /** Clear session tasks from memory. */
+    clearSessionTasks(): void;
+    /**
+     * Hard-wipe EVERY stored task from both the global and project stores
+     * (active, done, archived alike) plus the in-memory session tasks. Empties
+     * the entry arrays directly — no per-id matching — so it clears reliably even
+     * for entries the per-id delete can't resolve (e.g. flushed `session-*` todos).
+     */
+    clearAllStored(): Promise<void>;
+    /** Process recurring tasks — create new instances for completed recurring tasks. */
+    processRecurrence(): Promise<number>;
+    private loadStore;
+    private persistStore;
+    private writeSafe;
+    private ensureProjectStore;
+    private updateInStore;
+    private deleteFromStore;
+    /** Fire-and-forget platform sync. */
+    private syncTasks;
+    /**
+     * Pull the latest tasks from the platform and merge into local
+     * stores. Tasks are split by their `project` field — 'global' goes
+     * to the global store; entries matching the current workspace's
+     * basename go to the project store; entries belonging to other
+     * workspaces are ignored (they'll sync when the user opens that
+     * workspace). Remote wins on newer updatedAt, consistent with push
+     * semantics. Returns the total count of new + updated tasks.
+     */
+    pullLatest(): Promise<number>;
+}
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/tasks/task-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/tasks/task-manager.ts"],"names":[],"mappings":"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"}