@astragenie/astramemory-local 0.7.2

package/dist/config/writer.js.map

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

package/dist/consolidate/consolidate.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Consolidation — formation pipeline stage 9 (ADR-004, Wave 4b).
+ *
+ * Periodic offline pass over accumulated atoms, per (repo, type) group:
+ *
+ *  - similarity >= mergeThreshold  → auto merge-as-supersede. Non-destructive
+ *    by construction (architecture-review W4): the loser is superseded by the
+ *    winner via the event log, and the winner's derived_from gains the
+ *    loser's id — bitemporal history keeps the original readable forever.
+ *  - proposeThreshold <= similarity < mergeThreshold → propose-only row in
+ *    consolidation_proposals; the user confirms via REST. Nothing changes
+ *    until they do (strategy Pass 6 A4).
+ *
+ * v1 is deterministic: similarity is cosine over the stored embeddings, no
+ * LLM call. The second-order abstraction + contradiction detection passes
+ * (ADR-004 stage 9 b/c) are v1.x — they will reuse the same proposal queue.
+ *
+ * Winner selection: higher usefulness score wins (ADR-010), then higher
+ * importance, then the newer atom.
+ */
+import type { DB } from '../storage/db.js';
+export interface ConsolidateOpts {
+    /** Cosine similarity at/above which a pair auto-merges. */
+    mergeThreshold?: number;
+    /** Cosine similarity at/above which a pair becomes a proposal. */
+    proposeThreshold?: number;
+    /** Groups larger than this are skipped (O(n²) guard) and reported. */
+    maxGroupSize?: number;
+    /**
+     * Auto-merge pairs whose normalized text is equal or a strict subset of
+     * the other's, instead of queueing a manual proposal ("Port 7777 is the
+     * default" vs "port 7777 is the default."). The containing (superset)
+     * text always wins so no active information is lost — the shorter
+     * variant survives in bitemporal history like any supersede. Also
+     * auto-accepts EXISTING pending proposals whose loser text is contained
+     * in the winner's. Default true.
+     */
+    autoMergeContained?: boolean;
+}
+export interface ConsolidateSummary {
+    groupsScanned: number;
+    groupsSkipped: Array<{
+        repo: string | null;
+        type: string;
+        size: number;
+    }>;
+    merged: Array<{
+        winner: string;
+        loser: string;
+        similarity: number;
+        reason?: 'similarity' | 'contained';
+    }>;
+    proposed: Array<{
+        winner: string;
+        loser: string;
+        similarity: number;
+    }>;
+    /** Pending proposal ids auto-accepted by the containment sweep. */
+    autoAcceptedProposals: string[];
+    /** Pending proposal ids auto-rejected as stale (an atom no longer valid). */
+    staleRejectedProposals: string[];
+}
+/**
+ * Normalization for the containment rule: lowercase, strip backticks/quotes
+ * and punctuation, collapse whitespace. Deliberately aggressive — it only
+ * gates WHICH near-duplicates skip the manual queue, never what merging does.
+ */
+export declare function normalizeForContainment(text: string): string;
+/**
+ * 'a-contains-b' | 'b-contains-a' | 'equal' | null. Guards trivially short
+ * texts (a 3-char normalized string is contained in almost anything).
+ */
+export declare function containment(aText: string, bText: string): 'a-contains-b' | 'b-contains-a' | 'equal' | null;
+/**
+ * Merge-as-supersede: loser superseded by winner (event log + valid_to +
+ * memory_corrected usefulness signal, all via MemoryEventRepo.supersede),
+ * plus lineage — winner.derived_from gains the loser id. One transaction.
+ */
+export declare function mergeAsSupersede(db: DB, winnerId: string, loserId: string): void;
+export declare function runConsolidation(db: DB, opts?: ConsolidateOpts): ConsolidateSummary;

package/dist/consolidate/consolidate.js.map

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

package/dist/consolidate/proposals.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Consolidation proposal queue (ADR-004 stage 9, propose-only flow).
+ * The consolidation job writes pending rows; the user resolves them here.
+ * Accepting a merge proposal executes the same non-destructive
+ * merge-as-supersede path the auto-merges use.
+ */
+import type { DB } from '../storage/db.js';
+export interface ConsolidationProposal {
+    id: string;
+    kind: 'merge' | 'contradiction';
+    winner_id: string;
+    loser_id: string;
+    similarity: number;
+    status: 'pending' | 'accepted' | 'rejected';
+    created_at: number;
+    resolved_at: number | null;
+}
+export declare class ProposalNotFoundError extends Error {
+    constructor(id: string);
+}
+export declare class ProposalAlreadyResolvedError extends Error {
+    constructor(id: string, status: string);
+}
+export declare class ProposalRepo {
+    private db;
+    constructor(db: DB);
+    list(status?: ConsolidationProposal['status']): ConsolidationProposal[];
+    get(id: string): ConsolidationProposal | null;
+    /** Accept: execute the merge, mark accepted — one transaction. */
+    accept(id: string): ConsolidationProposal;
+    /** Reject: mark rejected, nothing else changes. */
+    reject(id: string): ConsolidationProposal;
+    private mustBePending;
+    private resolve;
+}

package/dist/consolidate/proposals.js

@@ -0,0 +1,66 @@
+/**
+ * Consolidation proposal queue (ADR-004 stage 9, propose-only flow).
+ * The consolidation job writes pending rows; the user resolves them here.
+ * Accepting a merge proposal executes the same non-destructive
+ * merge-as-supersede path the auto-merges use.
+ */
+import { mergeAsSupersede } from './consolidate.js';
+export class ProposalNotFoundError extends Error {
+    constructor(id) {
+        super(`consolidation proposal not found: ${id}`);
+        this.name = 'ProposalNotFoundError';
+    }
+}
+export class ProposalAlreadyResolvedError extends Error {
+    constructor(id, status) {
+        super(`consolidation proposal ${id} is already ${status}`);
+        this.name = 'ProposalAlreadyResolvedError';
+    }
+}
+export class ProposalRepo {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    list(status) {
+        if (status) {
+            return this.db.prepare('SELECT * FROM consolidation_proposals WHERE status = ? ORDER BY created_at ASC').all(status);
+        }
+        return this.db.prepare('SELECT * FROM consolidation_proposals ORDER BY created_at ASC').all();
+    }
+    get(id) {
+        const row = this.db.prepare('SELECT * FROM consolidation_proposals WHERE id = ?')
+            .get(id);
+        return row ?? null;
+    }
+    /** Accept: execute the merge, mark accepted — one transaction. */
+    accept(id) {
+        const tx = this.db.transaction(() => {
+            const p = this.mustBePending(id);
+            mergeAsSupersede(this.db, p.winner_id, p.loser_id);
+            return this.resolve(p.id, 'accepted');
+        });
+        return tx();
+    }
+    /** Reject: mark rejected, nothing else changes. */
+    reject(id) {
+        const tx = this.db.transaction(() => {
+            const p = this.mustBePending(id);
+            return this.resolve(p.id, 'rejected');
+        });
+        return tx();
+    }
+    mustBePending(id) {
+        const p = this.get(id);
+        if (!p)
+            throw new ProposalNotFoundError(id);
+        if (p.status !== 'pending')
+            throw new ProposalAlreadyResolvedError(id, p.status);
+        return p;
+    }
+    resolve(id, status) {
+        this.db.prepare('UPDATE consolidation_proposals SET status = ?, resolved_at = ? WHERE id = ?').run(status, Date.now(), id);
+        return this.get(id);
+    }
+}
+//# sourceMappingURL=proposals.js.map

package/dist/consolidate/proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.js","sourceRoot":"","sources":["../../src/consolidate/proposals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAapD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,EAAU;QACpB,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,EAAU,EAAE,MAAc;QACpC,KAAK,CAAC,0BAA0B,EAAE,eAAe,MAAM,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,EAAM;QAAN,OAAE,GAAF,EAAE,CAAI;IAAG,CAAC;IAE9B,IAAI,CAAC,MAAwC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CACpB,gFAAgF,CACjF,CAAC,GAAG,CAAC,MAAM,CAA4B,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CACpB,+DAA+D,CAChE,CAAC,GAAG,EAA6B,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC;aAC9E,GAAG,CAAC,EAAE,CAAsC,CAAC;QAChD,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAC,EAAU;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAA0B,EAAE;YACzD,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACjC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,MAAM,CAAC,EAAU;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAA0B,EAAE;YACzD,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAEO,aAAa,CAAC,EAAU;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,4BAA4B,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACjF,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,OAAO,CAAC,EAAU,EAAE,MAA+B;QACzD,IAAI,CAAC,EAAE,CAAC,OAAO,CACb,6EAA6E,CAC9E,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAA0B,CAAC;IAC/C,CAAC;CACF"}

package/dist/contracts/atom-wire.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Memory row -> astramem/atom@1 wire shape (ADR-001, contracts/schemas/atom.v1.schema.json).
+ *
+ * astramem-local's storage columns are the pragmatic v1 form: flat
+ * provenance fields (repo/project/agent/session_id), epoch-ms timestamps,
+ * and a single evidence excerpt string. The wire contract nests provenance
+ * and uses ISO 8601 timestamps to match the capture envelope precedent
+ * (docs/capture-protocol.md) and to stay storage-engine-agnostic for the
+ * cloud (.NET/Postgres) consumer. This mapper is the one place that
+ * reconciles the two shapes — see contracts/README.md "Evidence
+ * reconciliation" for why evidence is left as-is (string) rather than
+ * upgraded to the array-of-refs form here.
+ */
+import type { Memory } from './memory.js';
+export interface AtomWireV1 {
+    schema: 'astramem/atom@1';
+    id: string;
+    type: string;
+    text: string;
+    evidence: string | Array<{
+        transcript_id: string;
+        span?: [number, number];
+    }>;
+    confidence: number;
+    importance: number;
+    provenance: {
+        tool: string | null;
+        session_id: string | null;
+        repo: string | null;
+        project: string | null;
+        extractor: string | null;
+    };
+    valid_from: string;
+    valid_to: string | null;
+    superseded_by: string | null;
+    derived_from: string[] | null;
+    scope: string;
+    content_hash: string;
+    entities: string[];
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Serialize a local `memories` row into the astramem/atom@1 wire shape.
+ * Pure function — no I/O, no DB access — so it is trivially unit-testable
+ * and reusable from the (future) sync shipper (Wave 3d).
+ */
+export declare function toAtomWireV1(memory: Memory): AtomWireV1;

package/dist/contracts/atom-wire.js

@@ -0,0 +1,55 @@
+/**
+ * Memory row -> astramem/atom@1 wire shape (ADR-001, contracts/schemas/atom.v1.schema.json).
+ *
+ * astramem-local's storage columns are the pragmatic v1 form: flat
+ * provenance fields (repo/project/agent/session_id), epoch-ms timestamps,
+ * and a single evidence excerpt string. The wire contract nests provenance
+ * and uses ISO 8601 timestamps to match the capture envelope precedent
+ * (docs/capture-protocol.md) and to stay storage-engine-agnostic for the
+ * cloud (.NET/Postgres) consumer. This mapper is the one place that
+ * reconciles the two shapes — see contracts/README.md "Evidence
+ * reconciliation" for why evidence is left as-is (string) rather than
+ * upgraded to the array-of-refs form here.
+ */
+import { PKG_VERSION } from '../server/lib/wire-meta.js';
+/** epoch ms -> ISO 8601 string. */
+function toIso(ms) {
+    return new Date(ms).toISOString();
+}
+/**
+ * Serialize a local `memories` row into the astramem/atom@1 wire shape.
+ * Pure function — no I/O, no DB access — so it is trivially unit-testable
+ * and reusable from the (future) sync shipper (Wave 3d).
+ */
+export function toAtomWireV1(memory) {
+    return {
+        schema: 'astramem/atom@1',
+        id: memory.id,
+        type: memory.type,
+        text: memory.text,
+        // Local v1 form: evidence is stored as a plain excerpt string (or absent).
+        // Empty-string fallback keeps the field non-optional per the schema's
+        // `evidence` requirement ("receipts — never optional", ADR-001) even for
+        // pre-AM-1 rows that predate the evidence column.
+        evidence: memory.evidence ?? '',
+        confidence: memory.confidence,
+        importance: memory.importance,
+        provenance: {
+            tool: memory.agent,
+            session_id: memory.session_id,
+            repo: memory.repo,
+            project: memory.project,
+            extractor: `astramem-local@${PKG_VERSION}`,
+        },
+        valid_from: toIso(memory.valid_from),
+        valid_to: memory.valid_to !== null ? toIso(memory.valid_to) : null,
+        superseded_by: memory.superseded_by,
+        derived_from: memory.derived_from,
+        scope: memory.scope,
+        content_hash: memory.hash,
+        entities: [],
+        created_at: toIso(memory.created_at),
+        updated_at: toIso(memory.updated_at),
+    };
+}
+//# sourceMappingURL=atom-wire.js.map

package/dist/contracts/atom-wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom-wire.js","sourceRoot":"","sources":["../../src/contracts/atom-wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA4BzD,mCAAmC;AACnC,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,MAAM,EAAE,iBAAiB;QACzB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,2EAA2E;QAC3E,sEAAsE;QACtE,yEAAyE;QACzE,kDAAkD;QAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE;YACV,IAAI,EAAE,MAAM,CAAC,KAAK;YAClB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,kBAAkB,WAAW,EAAE;SAC3C;QACD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;QAClE,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY,EAAE,MAAM,CAAC,IAAI;QACzB,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/contracts/embed.d.ts

@@ -0,0 +1,41 @@
+export interface EmbedHealth {
+    ok: boolean;
+    model: string;
+    dim: number;
+    error?: string;
+}
+/**
+ * Default/legacy embedding dimension (FEAT-409). This is the ONE source of
+ * truth every coordinated surface derives from: config default
+ * (config.ts), embed providers (ollama.ts / azure-openai.ts `dim` ctor
+ * arg), the vec schema (migrations/001-init.sql's `__EMBED_DIM__`
+ * placeholder, substituted by storage/migrate.ts), the boot-time dim
+ * preflight (doctor/probes/embed-probe.ts), and the eval/mock providers.
+ *
+ * Matches both `mxbai-embed-large` (Ollama default, native 1024) and
+ * `text-embedding-3-*` (Azure, configured via `dimensions: 1024`).
+ *
+ * Changing `config.embedding.dim` for a FRESH database is a plain config
+ * edit — migrate() bakes the configured dim into `memories_vec` at
+ * creation. Changing it for an EXISTING database with live data requires
+ * the resumable re-embed procedure (`astramem-local reembed-dim`, migration
+ * 011 / docs/embed-dim-migration.md) because sqlite-vec's vec0 virtual
+ * table fixes its dim at CREATE TABLE time — there is no ALTER for it.
+ */
+export declare const DEFAULT_EMBED_DIM = 1024;
+/**
+ * Embedding provider. `dim` is provider-instance-scoped (constructor arg,
+ * defaulting to DEFAULT_EMBED_DIM) rather than a fixed literal — FEAT-409
+ * parameterized what was a v1 system-wide invariant. All memories embedded
+ * by one provider instance must share its `dim`; switching providers/models
+ * (even at the same dim) still requires a re-embed pass since different
+ * models are different geometric spaces. Doctor enforces the
+ * configured-vs-actual dim match at startup (embed-probe.ts).
+ */
+export interface EmbedProvider {
+    readonly name: 'ollama' | 'azure-openai';
+    readonly model: string;
+    readonly dim: number;
+    embed(texts: string[]): Promise<Float32Array[]>;
+    health(): Promise<EmbedHealth>;
+}

package/dist/contracts/embed.js

@@ -0,0 +1,20 @@
+/**
+ * Default/legacy embedding dimension (FEAT-409). This is the ONE source of
+ * truth every coordinated surface derives from: config default
+ * (config.ts), embed providers (ollama.ts / azure-openai.ts `dim` ctor
+ * arg), the vec schema (migrations/001-init.sql's `__EMBED_DIM__`
+ * placeholder, substituted by storage/migrate.ts), the boot-time dim
+ * preflight (doctor/probes/embed-probe.ts), and the eval/mock providers.
+ *
+ * Matches both `mxbai-embed-large` (Ollama default, native 1024) and
+ * `text-embedding-3-*` (Azure, configured via `dimensions: 1024`).
+ *
+ * Changing `config.embedding.dim` for a FRESH database is a plain config
+ * edit — migrate() bakes the configured dim into `memories_vec` at
+ * creation. Changing it for an EXISTING database with live data requires
+ * the resumable re-embed procedure (`astramem-local reembed-dim`, migration
+ * 011 / docs/embed-dim-migration.md) because sqlite-vec's vec0 virtual
+ * table fixes its dim at CREATE TABLE time — there is no ALTER for it.
+ */
+export const DEFAULT_EMBED_DIM = 1024;
+//# sourceMappingURL=embed.js.map

package/dist/contracts/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/contracts/embed.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,5 @@
+export * from './llm.js';
+export * from './embed.js';
+export * from './vector.js';
+export * from './memory.js';
+export * from './job.js';

package/dist/contracts/index.js

@@ -0,0 +1,6 @@
+export * from './llm.js';
+export * from './embed.js';
+export * from './vector.js';
+export * from './memory.js';
+export * from './job.js';
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/contracts/job.d.ts

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+export type JobState = 'pending' | 'running' | 'completed' | 'failed' | 'poison' | 'paused';
+export type JobKind = 'distill' | 'reembed' | 'cleanup' | 'distill-events' | 'consolidate';
+export declare const DistillPayloadSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"distill">;
+    transcript_id: z.ZodString;
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "distill";
+    transcript_id: string;
+    session_id: string;
+}, {
+    kind: "distill";
+    transcript_id: string;
+    session_id: string;
+}>;
+/**
+ * ADR-008 events capture kind — pre-typed atom candidates (runner-plugin
+ * grades/lessons/review verdicts) that skip pipeline stages 1-5 and enter
+ * at reduce (stage 6). Same payload shape as DistillPayloadSchema; the
+ * `kind` discriminator routes the job to distillEventsHandler instead.
+ */
+export declare const DistillEventsPayloadSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"distill-events">;
+    transcript_id: z.ZodString;
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "distill-events";
+    transcript_id: string;
+    session_id: string;
+}, {
+    kind: "distill-events";
+    transcript_id: string;
+    session_id: string;
+}>;
+export declare const ReembedPayloadSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"reembed">;
+    memory_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "reembed";
+    memory_id: string;
+}, {
+    kind: "reembed";
+    memory_id: string;
+}>;
+export declare const CleanupPayloadSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"cleanup">;
+    older_than_days: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "cleanup";
+    older_than_days: number;
+}, {
+    kind: "cleanup";
+    older_than_days?: number | undefined;
+}>;
+export declare const JobPayloadSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"distill">;
+    transcript_id: z.ZodString;
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "distill";
+    transcript_id: string;
+    session_id: string;
+}, {
+    kind: "distill";
+    transcript_id: string;
+    session_id: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"reembed">;
+    memory_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "reembed";
+    memory_id: string;
+}, {
+    kind: "reembed";
+    memory_id: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"cleanup">;
+    older_than_days: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "cleanup";
+    older_than_days: number;
+}, {
+    kind: "cleanup";
+    older_than_days?: number | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"distill-events">;
+    transcript_id: z.ZodString;
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "distill-events";
+    transcript_id: string;
+    session_id: string;
+}, {
+    kind: "distill-events";
+    transcript_id: string;
+    session_id: string;
+}>]>;
+export type DistillPayload = z.infer<typeof DistillPayloadSchema>;
+export type ReembedPayload = z.infer<typeof ReembedPayloadSchema>;
+export type CleanupPayload = z.infer<typeof CleanupPayloadSchema>;
+export type DistillEventsPayload = z.infer<typeof DistillEventsPayloadSchema>;
+export type JobPayload = z.infer<typeof JobPayloadSchema>;
+export interface Job {
+    id: string;
+    kind: JobKind;
+    payload_json: string;
+    state: JobState;
+    attempts: number;
+    last_error: string | null;
+    created_at: number;
+    updated_at: number;
+}

package/dist/contracts/job.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const DistillPayloadSchema = z.object({
+    kind: z.literal('distill'),
+    transcript_id: z.string().min(1),
+    session_id: z.string().min(1)
+});
+/**
+ * ADR-008 events capture kind — pre-typed atom candidates (runner-plugin
+ * grades/lessons/review verdicts) that skip pipeline stages 1-5 and enter
+ * at reduce (stage 6). Same payload shape as DistillPayloadSchema; the
+ * `kind` discriminator routes the job to distillEventsHandler instead.
+ */
+export const DistillEventsPayloadSchema = z.object({
+    kind: z.literal('distill-events'),
+    transcript_id: z.string().min(1),
+    session_id: z.string().min(1)
+});
+export const ReembedPayloadSchema = z.object({
+    kind: z.literal('reembed'),
+    memory_id: z.string().min(1)
+});
+export const CleanupPayloadSchema = z.object({
+    kind: z.literal('cleanup'),
+    older_than_days: z.number().int().min(1).default(30)
+});
+export const JobPayloadSchema = z.discriminatedUnion('kind', [
+    DistillPayloadSchema,
+    ReembedPayloadSchema,
+    CleanupPayloadSchema,
+    DistillEventsPayloadSchema
+]);
+//# sourceMappingURL=job.js.map

package/dist/contracts/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../src/contracts/job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3D,oBAAoB;IACpB,oBAAoB;IACpB,oBAAoB;IACpB,0BAA0B;CAC3B,CAAC,CAAC"}

package/dist/contracts/llm.d.ts

@@ -0,0 +1,30 @@
+export interface ChatMsg {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatOpts {
+    temperature?: number;
+    json?: boolean;
+    maxTokens?: number;
+}
+export interface ChatUsage {
+    in: number;
+    out: number;
+    usd: number;
+}
+export interface ChatResult {
+    text: string;
+    usage: ChatUsage;
+}
+export interface LLMHealth {
+    ok: boolean;
+    model: string;
+    latency_ms: number;
+    error?: string;
+}
+export interface LLMProvider {
+    readonly name: 'ollama' | 'azure-openai';
+    readonly model: string;
+    chat(messages: ChatMsg[], opts?: ChatOpts): Promise<ChatResult>;
+    health(): Promise<LLMHealth>;
+}

package/dist/contracts/llm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llm.js.map

package/dist/contracts/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/contracts/llm.ts"],"names":[],"mappings":""}

package/dist/contracts/memory.d.ts

@@ -0,0 +1,47 @@
+/** Single runtime source of truth for memory types — CLI validation and any
+ *  future enum checks must use this array, not a hand-copied list (the CLI
+ *  once drifted to a stale 5-type copy and silently rejected note/event). */
+export declare const MEMORY_TYPES: readonly ["decision", "fact", "lesson", "command", "todo", "note", "event"];
+export type MemoryType = (typeof MEMORY_TYPES)[number];
+/** ADR-009 memory scope — personal is the default for all local-agent writes. */
+export type MemoryScope = 'personal' | 'team' | 'org';
+export interface Memory {
+    id: string;
+    type: MemoryType;
+    text: string;
+    normalized_text: string;
+    repo: string | null;
+    project: string | null;
+    branch: string | null;
+    agent: string | null;
+    session_id: string | null;
+    importance: number;
+    confidence: number;
+    hash: string;
+    embedding_provider: string | null;
+    embedding_model: string | null;
+    embedding_dim: number | null;
+    created_at: number;
+    updated_at: number;
+    source_hash: string | null;
+    evidence: string | null;
+    /** Bitemporal valid-time start (ADR-001). Set to created_at at insert time;
+     *  advanced to the supersession instant when this atom becomes a successor
+     *  (supersede() co-issues new.valid_from = old.valid_to — FEAT-401). */
+    valid_from: number;
+    /** Bitemporal valid-time end. NULL = currently valid. */
+    valid_to: number | null;
+    /** Id of the memory that superseded this one (lifecycle ops, Wave 2b). */
+    superseded_by: string | null;
+    /** Consolidation lineage — memory ids this atom was derived from. */
+    derived_from: string[] | null;
+    /** ADR-009 scope. Defaults to 'personal'. */
+    scope: MemoryScope;
+    /** TTL/archival tiers (FEAT-404). true once the archival policy (or a
+     *  direct MemoryEventRepo.archive() call) has archived this atom — set in
+     *  the same transaction as valid_to, non-destructively (row survives,
+     *  restorable via MemoryEventRepo.restore()). */
+    archived: boolean;
+    /** Epoch ms the archive transition happened; null while archived=false. */
+    archived_at: number | null;
+}