@contextgit/store 0.1.9 → 0.2.0

package/dist/local/queries.d.ts

@@ -1,5 +1,5 @@
 import type { Database } from 'better-sqlite3';
-import type { Agent, AgentInput, Branch, BranchInput, Claim, ClaimInput, Commit, CommitInput, Pagination, Project, ProjectInput, SearchResult, SessionSnapshot, Thread } from '@contextgit/core';
+import type { Agent, AgentInput, ArchivedThread, Branch, BranchInput, Claim, ClaimInput, Commit, CommitInput, Pagination, PlanNode, PlanNodeInput, PlanNodeStatus, Project, ProjectInput, SearchResult, SessionSnapshot, Thread, TraceEntry } from '@contextgit/core';
 export declare class Queries {
     private readonly db;
     private readonly stmts;
@@ -20,13 +20,72 @@ export declare class Queries {
     getCommit(id: string): Commit | null;
     listCommits(branchId: string, pagination: Pagination): Commit[];
     getLastCommit(branchId: string): Commit | null;
-    insertThread(id: string, description: string, projectId: string, branchId: string, openedInCommit: string, workflowType: string | null): Thread;
+    insertThread(id: string, description: string, projectId: string, branchId: string, openedInCommit: string, workflowType: string | null, kind?: Thread['kind']): Thread;
     syncThread(thread: Thread): Thread;
     closeThread(threadId: string, closedInCommit: string, note: string): void;
+    /**
+     * Move an open thread from `threads` to `thread_archive`. Single transaction.
+     * `closedInCommit` is the commit triggering the archive (the save's new commit
+     * for manual closes; the last-touched commit for sweep-based archival).
+     */
+    archiveThread(threadId: string, reason: ArchivedThread['archivedReason'], closedInCommit: string | null): ArchivedThread;
+    /**
+     * Move a row from `thread_archive` back to `threads` with `status='open'`,
+     * clearing closed_in_commit and closed_note (the restore semantically reopens it).
+     */
+    restoreThread(threadId: string): Thread;
+    listArchivedThreads(projectId: string): ArchivedThread[];
+    /**
+     * Bulk restore: move every archived row matching one of the given reasons back
+     * to `threads`. Returns the number of rows moved. Used to recover from a wrong
+     * one-time-sweep (e.g. the 0.2.1 calibration bug that archived live threads on
+     * long-lived branches via the old OR-of-distance rule).
+     */
+    restoreAllArchivedByReason(projectId: string, reasons: ArchivedThread['archivedReason'][]): number;
+    /**
+     * Find an open thread on this project whose normalized description matches.
+     * Used by dedupe-on-save (02 DELTA spec §A) — open-thread count per project is
+     * bounded by the decay system being built, so a JS-side scan is acceptable.
+     */
+    findOpenThreadByNormalizedDescription(projectId: string, normalized: string): Thread | undefined;
+    /**
+     * Resolve a 6-char handle to an open thread on the project.
+     * Returns undefined if no match; throws if multiple match (collision).
+     */
+    findOpenThreadByHandle(projectId: string, handle: string): Thread | undefined;
+    findArchivedThreadByHandle(projectId: string, handle: string): ArchivedThread | undefined;
+    /**
+     * Project-scoped sweep run by createCommit at the end of every save: any open
+     * thread on this project that classifies as `stale` or `expired` is moved to
+     * `thread_archive`. Returns counts by reason for the save response.
+     */
+    sweepStaleThreads(projectId: string, now: number): {
+        archived: number;
+        byReason: {
+            'stale-age': number;
+            'stale-distance': number;
+            'watch-expired': number;
+        };
+    };
+    updateThreadLastTouched(threadId: string, commitId: string): void;
     listOpenThreads(projectId: string): Thread[];
     listOpenThreadsByBranch(branchId: string): Thread[];
+    /**
+     * Set the derived `stale` (open) or `expired` (watch) flag on a thread by
+     * looking up the touched commit's timestamp and counting project/branch
+     * commits since. Returns a new Thread — never mutates the input.
+     */
+    private attachDecayFlags;
     /** Move open threads from source branch to target (called during merge). */
     reassignOpenThreads(fromBranchId: string, toBranchId: string): void;
+    insertTraceEntry(input: {
+        id: string;
+        projectId: string;
+        branchId: string;
+        note: string;
+        gitCommitSha?: string;
+    }): TraceEntry;
+    listTraceEntries(projectId: string, pagination: Pagination): TraceEntry[];
     upsertAgent(input: AgentInput): Agent;
     incrementAgentCommits(agentId: string): void;
     listAgents(projectId: string): Agent[];
@@ -38,9 +97,51 @@ export declare class Queries {
     listThreadChangesSince(projectId: string, since: number): Thread[];
     getSessionSnapshot(projectId: string, branchId: string, options?: {
         agentRole?: string;
+        commitWindow?: number;
     }): SessionSnapshot;
     semanticSearch(db: Database, embeddingVector: Float32Array, projectId: string, limit: number): SearchResult[];
     fullTextSearch(db: Database, query: string, projectId: string): SearchResult[];
     insertEmbedding(db: Database, commitId: string, embedding: Float32Array): void;
+    /**
+     * Insert a plan tree of arbitrary depth atomically. `level` is semantic:
+     *   - root (parent_id IS NULL) → 'plan'
+     *   - has children at insert time → 'step' (container)
+     *   - no children at insert time → 'task' (leaf)
+     *
+     * Hierarchy is determined by parent_id, not by depth. The depth-based
+     * mapping from earlier 04 DELTA versions was wrong on trees deeper than 3
+     * (Slice at depth 2 would get labeled 'task' but actually had children).
+     * Content-based labeling is correct at any depth.
+     */
+    insertPlanTree(projectId: string, input: PlanNodeInput): PlanNode;
+    /**
+     * Read the active plan tree for a project. Top-level plans with full child
+     * trees and derived `progress = { done, total }` per node — DIRECT-CHILD
+     * semantics: progress.total = number of direct children; progress.done =
+     * number of direct children that are effectively-done. Effectively-done
+     * propagates recursively: a node is effectively-done if (it has no children
+     * AND status='done') OR (it has children AND every child is effectively-done).
+     *
+     * Plans that are effectively-done are excluded from the active view — they
+     * belong in listCompletedPlans.
+     */
+    getPlanTree(projectId: string): PlanNode[];
+    /**
+     * List plans (parent_id IS NULL) that are effectively-done. The completed
+     * delivery record — kept indefinitely, never archived.
+     */
+    listCompletedPlans(projectId: string): PlanNode[];
+    /** Shared tree builder for getPlanTree / listCompletedPlans. */
+    private buildPlanTrees;
+    /**
+     * Set a plan node's status. When transitioning to 'done', stamps completed_at
+     * and optionally git_commit_sha (the commit that completed it).
+     */
+    updatePlanNodeStatus(id: string, status: PlanNodeStatus, gitCommitSha: string | null): void;
+    updatePlanNodeTitle(id: string, title: string): void;
+    /** Resolve a 6-char handle to a plan node. Throws on prefix collision. */
+    findPlanNodeByHandle(projectId: string, handle: string): PlanNode | undefined;
+    /** Resolve an exact title match. Throws when the title is ambiguous across nodes. */
+    findPlanNodeByTitle(projectId: string, title: string): PlanNode | undefined;
 }
 //# sourceMappingURL=queries.d.ts.map

package/dist/local/queries.d.ts.map

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