dsh-continual-evolve 0.15.4 → 0.15.5

package/lib/store.d.ts

@@ -1,4 +1,5 @@
 import type { MemoryProposal } from "./memory-rules.js";
+import { type SkillProposal } from "./skill-rules.js";
 import { type ProposalContext, type ProposalOutcome } from "./store-apply.js";
 export type { MemoryProposal, ProposalContext, ProposalOutcome };
 /** Thrown when the runtime lacks `node:sqlite` — the degrade signal. */
@@ -12,6 +13,36 @@ export declare const MD_IMPORT_STATE_KEY = "md-imported";
 export declare const GLOBAL_WORKSPACE = "";
 /** Preview size cap for the card's content endpoint (ZCode's viewer uses 5 MiB). */
 export declare const MEMORY_FILE_PREVIEW_LIMIT: number;
+/** One stored skill record (snake_case columns camelCased). Skills carry no type. */
+export interface SkillRecord {
+    workspaceId: string;
+    id: string;
+    title: string;
+    description: string;
+    body: string;
+    status: "active" | "quarantined" | "archived";
+    /** Origin session id, `null` for imports. */
+    sourceSession: string | null;
+    /** Trajectory seq range the skill came from ("820-831"), `null` when unknown. */
+    sourceSeqs: string | null;
+    /** The run that wrote it; `'explicit'` for tool writes. */
+    sourceRun: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** What a single skill proposal produced. */
+export interface SkillProposalOutcome {
+    id: string;
+    action: SkillProposal["action"];
+    ok: boolean;
+    /** Blocking reason when `ok` is false. */
+    reason?: string;
+}
+/** A non-fatal file-projection problem the caller should surface. */
+export interface SkillFileWarning {
+    id: string;
+    warning: string;
+}
 /** One stored memory record (snake_case columns camelCased). */
 export interface MemoryRecord {
     workspaceId: string;
@@ -67,6 +98,20 @@ export interface PatrolResult {
         id: string;
         reason: string;
     }[];
+    /** Orphan skill FTS rows (no matching skill) removed. */
+    skillOrphanFtsRows: number;
+    /** Skills quarantined by the secret screen, with the redacted reasons. */
+    skillQuarantined: {
+        workspaceId: string;
+        id: string;
+        reason: string;
+    }[];
+    /** Managed SKILL.md files rewritten or created to match the store. */
+    skillFilesReconciled: number;
+    /** Orphan managed SKILL.md files (no active store row) removed. */
+    skillOrphanFilesRemoved: number;
+    /** Managed file operations that failed (retried by the next patrol). */
+    skillFileErrors: number;
 }
 /** The store surface every consumer (tool, extraction, card, injection) uses. */
 export interface MemoryStore {
@@ -93,11 +138,11 @@ export interface MemoryStore {
     listWorkspaces(): WorkspaceSummary[];
     /**
      * The partition with the most recent session activity: the newest ledger
-     * instant against the newest memory write, whichever is later. The ledger
-     * carries a row for every run — including skips and explicit writes — so it
-     * tracks "a session worked here", while the memory write is the durable
-     * fallback for a partition whose ledger rows were pruned. Undefined only
-     * when the store holds neither.
+     * instant against the newest memory or skill write, whichever is later.
+     * The ledgers carry a row for every run — including skips and explicit
+     * writes — so they track "a session worked here", while the memory write
+     * is the durable fallback for a partition whose ledger rows were pruned.
+     * Undefined only when the store holds neither.
      */
     mostRecentlyActiveWorkspace(): string | undefined;
     /** Hygiene pass: orphan FTS cleanup + secret quarantine. */
@@ -105,6 +150,29 @@ export interface MemoryStore {
     /** Ledger rows older than the cutoff, removed (the one unbounded table). */
     pruneLedger(beforeIso: string): number;
     close(): void;
+    /** One active skill row from a partition, undefined when absent. */
+    getSkill(workspaceId: string, id: string): SkillRecord | undefined;
+    /** Active skills of one partition, newest first. */
+    listSkills(workspaceId: string): SkillRecord[];
+    /** Every non-archived skill of one partition, newest first. */
+    listAllSkills(workspaceId: string): SkillRecord[];
+    /**
+     * Keyword search over skills, workspace-scoped: same AND-combined
+     * trigram/LIKE discipline as memory search.
+     */
+    searchSkills(workspaceId: string, query: string, limit?: number): SkillRecord[];
+    /**
+     * The sole skill write gate: validate all proposals, apply atomically,
+     * ledger with before/after snapshots, then sync the materialized files.
+     * File sync never fails the batch — the database is the source of truth
+     * and patrol retries whatever the filesystem refused.
+     */
+    applySkillProposals(ctx: ProposalContext, proposals: readonly SkillProposal[]): {
+        outcomes: SkillProposalOutcome[];
+        warnings: SkillFileWarning[];
+    };
+    /** Partitions holding active skills (the card's skill fence). */
+    listSkillWorkspaces(): WorkspaceSummary[];
 }
 /** Default database location: `$DSH_HOME/evolve/memory.db`, else `~/.dsh/…`. */
 export declare function defaultStorePath(): string;