synorch 0.2.0 → 0.4.0-beta.0

package/dist/harness/memory/markdown-memory-store.d.ts

@@ -0,0 +1,122 @@
+import { HarnessError, type MemoryDecisionOutcome, type MemoryId, type MemoryKind, type MemoryNote, type MemoryProposal, type MemoryQuery, type MemoryStore, type ProposalId, type RecalledMemory } from "../contracts/index.ts";
+import { type MemoryIndex } from "./memory-index.ts";
+import { type MemoryCandidate } from "./relations.ts";
+/**
+ * The file-backed `MemoryStore` (ADR-16/17). Notes are Markdown files the user may edit at any
+ * time; every write re-reads the file and refuses to replace content it has not seen.
+ */
+/** Longest note body accepted: notes carry distilled claims and pointers, never raw output. */
+export declare const MAX_NOTE_BODY_CHARS = 16000;
+export interface MemoryStoreOptions {
+    /** Workspace that relative `source_ref` values resolve against for stale detection. */
+    readonly workspaceRoot?: string | undefined;
+    readonly now?: (() => Date) | undefined;
+}
+export type SourceState = "none" | "fresh" | "changed" | "missing" | "unverifiable";
+export interface MemoryConflictDetails {
+    readonly memoryId: string;
+    readonly path: string;
+    readonly expected: string | undefined;
+    readonly actual: string | undefined;
+}
+/** The note changed on disk since the digest the writer last saw; nothing was written. */
+export declare class MemoryConflictError extends HarnessError {
+    readonly details: MemoryConflictDetails;
+    constructor(details: MemoryConflictDetails);
+}
+export interface RelatedView {
+    readonly note: MemoryNote;
+    readonly outgoing: readonly {
+        readonly type: string;
+        readonly target: string;
+        readonly title: string | undefined;
+    }[];
+    readonly incoming: readonly {
+        readonly type: string;
+        readonly source: string;
+        readonly title: string;
+    }[];
+    readonly linksOut: readonly {
+        readonly path: string;
+        readonly id: string | undefined;
+    }[];
+    readonly linksIn: readonly {
+        readonly path: string;
+        readonly id: string;
+    }[];
+    readonly candidates: readonly MemoryCandidate[];
+}
+export interface MemoryStatus {
+    readonly root: string;
+    readonly notes: number;
+    readonly byKind: Readonly<Partial<Record<MemoryKind, Readonly<Record<string, number>>>>>;
+    readonly pending: number;
+    readonly stale: readonly string[];
+    readonly invalid: MemoryIndex["invalid"];
+    readonly duplicates: MemoryIndex["duplicates"];
+    readonly brokenLinks: MemoryIndex["broken_links"];
+    readonly candidates: readonly MemoryCandidate[];
+}
+export type NoteInput = Omit<MemoryNote, "path" | "digest">;
+export declare class MarkdownMemoryStore implements MemoryStore {
+    readonly root: string;
+    private readonly workspaceRoot;
+    private readonly now;
+    constructor(root: string, options?: MemoryStoreOptions);
+    get(id: MemoryId): Promise<MemoryNote | undefined>;
+    search(query: MemoryQuery): Promise<readonly RecalledMemory[]>;
+    persist(note: NoteInput, expectedDigest: string | undefined): Promise<MemoryNote>;
+    propose(proposal: MemoryProposal): Promise<void>;
+    /** Proposals still awaiting a final decision: `pending` and `deferred`, oldest first. */
+    pending(): Promise<readonly MemoryProposal[]>;
+    proposal(proposalId: ProposalId): Promise<MemoryProposal | undefined>;
+    /** Applies a decision; returns the `memory/proposal_decided` and `memory/persisted` payloads for the event log. */
+    decide(proposalId: ProposalId, decision: NonNullable<MemoryProposal["decision"]>, state: "accepted" | "rejected" | "deferred"): Promise<MemoryDecisionOutcome>;
+    /**
+     * The decision desk's "edit": rewrites a still-open proposal's note text (title and body) before
+     * it is decided. The proposal stays pending; its rationale and evidence are kept.
+     */
+    amendProposal(proposalId: ProposalId, change: {
+        readonly title?: string | undefined;
+        readonly body?: string | undefined;
+    }): Promise<MemoryProposal>;
+    /**
+     * Correction control (UX-08): the user edits or retires a note of any kind. The note becomes the
+     * user's (`owner: human`, reviewed today); the write refuses when the file changed since `expectedDigest`.
+     */
+    correct(id: MemoryId, change: {
+        readonly title?: string | undefined;
+        readonly body?: string | undefined;
+        readonly status?: string | undefined;
+    }, expectedDigest: string): Promise<MemoryNote>;
+    reindex(): Promise<{
+        readonly notes: number;
+        readonly broken_links: number;
+    }>;
+    /** Rebuilds `.index/` from the notes and returns the full result, broken links included. */
+    rebuildIndex(): Promise<MemoryIndex>;
+    /** The derived index (rebuilt when the notes changed): the memory graph reads relations and links from it. */
+    index(): Promise<MemoryIndex>;
+    candidates(id?: string): Promise<readonly MemoryCandidate[]>;
+    related(id: MemoryId): Promise<RelatedView | undefined>;
+    status(): Promise<MemoryStatus>;
+    /** Where a stored note's vault-relative `path` lives on disk. */
+    absolutePath(vaultPath: string): string;
+    sourceState(frontmatter: {
+        readonly source_ref?: string | undefined;
+        readonly source_digest?: string | undefined;
+    }): Promise<SourceState>;
+    private apply;
+    private audit;
+    private writeNote;
+    private readNote;
+    private loadIndex;
+    private proposals;
+    private proposalFile;
+    private rootExists;
+}
+/** The I6 factory: a Markdown vault at `root`. Obsidian is never required. */
+export declare function createMemoryStore(root: string, options?: MemoryStoreOptions): MarkdownMemoryStore;
+export declare function isMemoryKind(value: string): value is MemoryKind;
+export declare function parseMemoryId(value: string): MemoryId | undefined;
+//# sourceMappingURL=markdown-memory-store.d.ts.map

package/dist/harness/memory/markdown-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-memory-store.d.ts","sourceRoot":"","sources":["../../../src/harness/memory/markdown-memory-store.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,YAAY,EAQZ,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EAEf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAqF,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGxI,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYzF;;;GAGG;AAEH,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAM1C,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,0FAA0F;AAC1F,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,SAAgB,OAAO,EAAE,qBAAqB,CAAC;gBAE5B,OAAO,EAAE,qBAAqB;CAgBlD;AAYD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IACrH,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzG,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5E,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;AAE5D,qBAAa,mBAAoB,YAAW,WAAW;IACrD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAEd,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAMpD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAKlD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IA2C9D,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAejF,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7D,yFAAyF;IAC5E,OAAO,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAI7C,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAOlF,mHAAmH;IACtG,MAAM,CACjB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,EACjD,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAC1C,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;;OAGG;IACU,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAchK;;;OAGG;IACU,OAAO,CAClB,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EACzH,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;IAkBT,OAAO,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAK1F,4FAA4F;IAC/E,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAMjD,8GAA8G;IACjG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAI7B,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAK5D,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAoBvD,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IA8B5C,iEAAiE;IAC1D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIjC,WAAW,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;YAUxI,KAAK;IAsCnB,OAAO,CAAC,KAAK;YAIC,SAAS;YA4BT,QAAQ;YAQR,SAAS;YAST,SAAS;IAkBvB,OAAO,CAAC,YAAY;YAIN,UAAU;CAGzB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,mBAAmB,CAErG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAGjE"}

package/dist/harness/memory/markdown-memory-store.js

@@ -0,0 +1,419 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { parse, stringify } from "yaml";
+import { isSafeRelativePath } from "../../domain/relative-path.js";
+import { formatZodIssues } from "../../domain/zod-issues.js";
+import { AUTO_PERSIST_KINDS, digestText, HarnessError, MEMORY_KINDS, MEMORY_STATUSES, memoryIdSchema, memoryNoteFrontmatterSchema, memoryProposalSchema, proposalIdSchema, } from "../contracts/index.js";
+import { buildIndex, indexMatchesFiles, readIndex, scoreText, writeIndex } from "./memory-index.js";
+import { parseNoteFile, serializeNote, splitTitle } from "./note-format.js";
+import { redactSecrets, redactValue } from "./redaction.js";
+import { findCandidates, INACTIVE_STATUSES } from "./relations.js";
+import { ensureVaultScaffold, fromVaultPath, isMissing, KIND_DIRECTORIES, listNoteFiles, QUEUE_DIRECTORY, readTextIfExists, writeAtomic, } from "./vault.js";
+/**
+ * The file-backed `MemoryStore` (ADR-16/17). Notes are Markdown files the user may edit at any
+ * time; every write re-reads the file and refuses to replace content it has not seen.
+ */
+/** Longest note body accepted: notes carry distilled claims and pointers, never raw output. */
+export const MAX_NOTE_BODY_CHARS = 16_000;
+const CONTROL_CHARACTERS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f\u009b]/;
+/** The note changed on disk since the digest the writer last saw; nothing was written. */
+export class MemoryConflictError extends HarnessError {
+    details;
+    constructor(details) {
+        super({
+            code: "store_write_failed",
+            message: details.actual === undefined
+                ? `memory note ${details.memoryId} was removed since it was read; nothing was written`
+                : details.expected === undefined
+                    ? `memory note ${details.memoryId} already exists at ${details.path}; nothing was written`
+                    : `memory note ${details.memoryId} changed on disk since it was read; nothing was written`,
+            ids: { memory_id: details.memoryId, path: details.path },
+            workspace_effect: "none",
+            retry_safe: false,
+            next_command: `syn memory show ${details.memoryId}`,
+        });
+        this.details = details;
+    }
+}
+function usage(message, nextCommand) {
+    return new HarnessError({
+        code: "usage_invalid",
+        message,
+        workspace_effect: "none",
+        retry_safe: false,
+        ...(nextCommand === undefined ? {} : { next_command: nextCommand }),
+    });
+}
+export class MarkdownMemoryStore {
+    root;
+    workspaceRoot;
+    now;
+    constructor(root, options = {}) {
+        this.root = path.resolve(root);
+        this.workspaceRoot = options.workspaceRoot === undefined ? undefined : path.resolve(options.workspaceRoot);
+        this.now = options.now ?? (() => new Date());
+    }
+    async get(id) {
+        const entry = (await this.loadIndex()).notes.find((note) => note.id === id);
+        return entry === undefined ? undefined : this.readNote(entry.path);
+    }
+    async search(query) {
+        const index = await this.loadIndex();
+        const text = query.text?.trim() ?? "";
+        const hits = [];
+        for (const entry of index.notes) {
+            if (entry.project_id !== query.projectId && entry.scope !== "user")
+                continue;
+            if (query.kinds !== undefined && !query.kinds.includes(entry.kind))
+                continue;
+            const offBranch = entry.scope === "branch" && entry.branch !== query.branch;
+            const inactive = INACTIVE_STATUSES.includes(entry.status);
+            if ((offBranch || inactive) && !query.includeInactive)
+                continue;
+            const match = text.length > 0 ? scoreText(entry, text) : { score: 0, fields: [] };
+            if (text.length > 0 && match.score === 0)
+                continue;
+            hits.push({ entry, score: match.score, fields: match.fields, offBranch, inactive });
+        }
+        hits.sort((left, right) => Number(left.offBranch || left.inactive) - Number(right.offBranch || right.inactive) ||
+            right.score - left.score ||
+            (left.entry.id < right.entry.id ? -1 : left.entry.id > right.entry.id ? 1 : 0));
+        const results = [];
+        for (const hit of hits.slice(0, Math.max(0, query.limit))) {
+            const note = await this.readNote(hit.entry.path);
+            if (note === undefined)
+                continue;
+            const source = await this.sourceState(note.frontmatter);
+            const sourceStale = source === "changed" || source === "missing" || note.frontmatter.status === "stale";
+            const reasons = [
+                hit.fields.length === 0 ? "matches the scope filter" : hit.fields.includes("id") && hit.score >= 1000 ? "exact id match" : `matched "${text}" in ${hit.fields.join(", ")}`,
+                note.frontmatter.scope === "branch"
+                    ? hit.offBranch
+                        ? `scoped to branch ${note.frontmatter.branch ?? "?"}, not ${query.branch ?? "the current checkout"}; not current here`
+                        : `scoped to branch ${note.frontmatter.branch ?? "?"}`
+                    : `${note.frontmatter.scope} scope`,
+                `${note.frontmatter.kind} ${note.frontmatter.status}${hit.inactive ? " (historical only)" : ""}`,
+                ...(source === "changed" ? [`source ${note.frontmatter.source_ref ?? ""} changed since it was recorded`] : []),
+                ...(source === "missing" ? [`source ${note.frontmatter.source_ref ?? ""} is missing`] : []),
+                ...(source === "unverifiable" ? ["source not verifiable here"] : []),
+            ];
+            results.push({ note, reason: reasons.join("; "), stale: sourceStale || hit.offBranch || hit.inactive });
+        }
+        return results;
+    }
+    async persist(note, expectedDigest) {
+        const kind = note.frontmatter.kind;
+        if (!AUTO_PERSIST_KINDS.includes(kind)) {
+            throw new HarnessError({
+                code: "policy_denied",
+                message: `${kind} notes are not written directly; queue a proposal for review (ADR-17)`,
+                ids: { memory_id: note.frontmatter.id },
+                workspace_effect: "none",
+                retry_safe: false,
+                next_command: "syn memory review",
+            });
+        }
+        return this.writeNote(note, expectedDigest);
+    }
+    async propose(proposal) {
+        const parsed = memoryProposalSchema.safeParse(redactValue(proposal));
+        if (!parsed.success)
+            throw usage(`invalid memory proposal: ${formatZodIssues(parsed.error)}`);
+        if (parsed.data.state !== "pending")
+            throw usage("a new proposal must be pending");
+        const file = this.proposalFile(parsed.data.proposal_id);
+        if ((await readTextIfExists(file)) !== undefined)
+            throw usage(`proposal ${parsed.data.proposal_id} already exists`, "syn memory review");
+        await ensureVaultScaffold(this.root);
+        await writeAtomic(file, stringify(parsed.data, { lineWidth: 0 }));
+    }
+    /** Proposals still awaiting a final decision: `pending` and `deferred`, oldest first. */
+    async pending() {
+        return (await this.proposals()).filter((proposal) => proposal.state === "pending" || proposal.state === "deferred");
+    }
+    async proposal(proposalId) {
+        const content = await readTextIfExists(this.proposalFile(proposalId));
+        if (content === undefined)
+            return undefined;
+        const parsed = memoryProposalSchema.safeParse(parse(content));
+        return parsed.success ? parsed.data : undefined;
+    }
+    /** Applies a decision; returns the `memory/proposal_decided` and `memory/persisted` payloads for the event log. */
+    async decide(proposalId, decision, state) {
+        const current = await this.proposal(proposalId);
+        if (current === undefined)
+            throw usage(`unknown or unreadable proposal ${proposalId}`, "syn memory review");
+        if (current.state === "accepted" || current.state === "rejected")
+            throw usage(`proposal ${proposalId} was already ${current.state}`);
+        const parsed = memoryProposalSchema.safeParse({ ...current, state, decision: redactValue(decision) });
+        if (!parsed.success)
+            throw usage(`invalid decision: ${formatZodIssues(parsed.error)}`);
+        const decided = parsed.data;
+        const persisted = state === "accepted" ? await this.apply(decided) : undefined;
+        await writeAtomic(this.proposalFile(proposalId), stringify(decided, { lineWidth: 0 }));
+        const record = decided.decision ?? decision;
+        return {
+            proposal: decided,
+            decided: { proposal_id: decided.proposal_id, state, decided_by: record.by, reason: record.reason },
+            persisted,
+            runId: record.by === "orchestrator" ? record.run_id : undefined,
+        };
+    }
+    /**
+     * The decision desk's "edit": rewrites a still-open proposal's note text (title and body) before
+     * it is decided. The proposal stays pending; its rationale and evidence are kept.
+     */
+    async amendProposal(proposalId, change) {
+        const current = await this.proposal(proposalId);
+        if (current === undefined)
+            throw usage(`unknown or unreadable proposal ${proposalId}`, "syn memory review");
+        if (current.state !== "pending" && current.state !== "deferred")
+            throw usage(`proposal ${proposalId} was already ${current.state}`);
+        if (current.kind !== "note")
+            throw usage("only note proposals carry text to edit");
+        const { title, body } = splitTitle(current.body ?? "");
+        const nextTitle = (change.title ?? title ?? current.note?.id ?? "note").replace(/[\r\n]+/g, " ").trim();
+        const nextBody = (change.body ?? body).trim();
+        const parsed = memoryProposalSchema.safeParse(redactValue({ ...current, state: "pending", decision: undefined, body: `# ${nextTitle}${nextBody === "" ? "" : `\n\n${nextBody}`}` }));
+        if (!parsed.success)
+            throw usage(`invalid proposal edit: ${formatZodIssues(parsed.error)}`);
+        await writeAtomic(this.proposalFile(proposalId), stringify(parsed.data, { lineWidth: 0 }));
+        return parsed.data;
+    }
+    /**
+     * Correction control (UX-08): the user edits or retires a note of any kind. The note becomes the
+     * user's (`owner: human`, reviewed today); the write refuses when the file changed since `expectedDigest`.
+     */
+    async correct(id, change, expectedDigest) {
+        const current = await this.get(id);
+        if (current === undefined)
+            throw usage(`no memory note ${id}`, "/memory");
+        const date = this.now().toISOString().slice(0, 10);
+        const status = change.status ?? current.frontmatter.status;
+        if (!MEMORY_STATUSES[current.frontmatter.kind].includes(status)) {
+            throw usage(`${status} is not a ${current.frontmatter.kind} status (${MEMORY_STATUSES[current.frontmatter.kind].join(", ")})`);
+        }
+        return this.writeNote({
+            frontmatter: { ...current.frontmatter, status, owner: "human", updated_at: date, reviewed_at: date },
+            title: change.title ?? current.title,
+            body: change.body ?? current.body,
+        }, expectedDigest);
+    }
+    async reindex() {
+        const index = await this.rebuildIndex();
+        return { notes: index.notes.length, broken_links: index.broken_links.length };
+    }
+    /** Rebuilds `.index/` from the notes and returns the full result, broken links included. */
+    async rebuildIndex() {
+        const index = await buildIndex(this.root);
+        if (await this.rootExists())
+            await writeIndex(this.root, index);
+        return index;
+    }
+    /** The derived index (rebuilt when the notes changed): the memory graph reads relations and links from it. */
+    async index() {
+        return this.loadIndex();
+    }
+    async candidates(id) {
+        const all = findCandidates((await this.loadIndex()).notes);
+        return id === undefined ? all : all.filter((candidate) => candidate.source === id || candidate.target === id);
+    }
+    async related(id) {
+        const index = await this.loadIndex();
+        const entry = index.notes.find((note) => note.id === id);
+        if (entry === undefined)
+            return undefined;
+        const note = await this.readNote(entry.path);
+        if (note === undefined)
+            return undefined;
+        const byId = new Map(index.notes.map((item) => [item.id, item]));
+        const byPath = new Map(index.notes.map((item) => [item.path.toLowerCase(), item]));
+        return {
+            note,
+            outgoing: entry.relations.map((relation) => ({ type: relation.type, target: relation.target, title: byId.get(relation.target)?.title })),
+            incoming: index.notes.flatMap((item) => item.relations.filter((relation) => relation.target === id).map((relation) => ({ type: relation.type, source: item.id, title: item.title }))),
+            linksOut: entry.links.map((link) => ({ path: link, id: byPath.get(link.toLowerCase())?.id })),
+            linksIn: index.notes.filter((item) => item.links.some((link) => link.toLowerCase() === entry.path.toLowerCase())).map((item) => ({ path: item.path, id: item.id })),
+            candidates: await this.candidates(id),
+        };
+    }
+    async status() {
+        const index = await this.loadIndex();
+        const byKind = {};
+        for (const note of index.notes) {
+            const counts = byKind[note.kind] ?? {};
+            counts[note.status] = (counts[note.status] ?? 0) + 1;
+            byKind[note.kind] = counts;
+        }
+        const stale = [];
+        for (const note of index.notes) {
+            if (note.status === "stale") {
+                stale.push(note.id);
+                continue;
+            }
+            const state = await this.sourceState(note);
+            if (state === "changed" || state === "missing")
+                stale.push(note.id);
+        }
+        return {
+            root: this.root,
+            notes: index.notes.length,
+            byKind,
+            pending: (await this.pending()).length,
+            stale,
+            invalid: index.invalid,
+            duplicates: index.duplicates,
+            brokenLinks: index.broken_links,
+            candidates: findCandidates(index.notes),
+        };
+    }
+    /** Where a stored note's vault-relative `path` lives on disk. */
+    absolutePath(vaultPath) {
+        return fromVaultPath(this.root, vaultPath);
+    }
+    async sourceState(frontmatter) {
+        if (frontmatter.source_ref === undefined || frontmatter.source_digest === undefined)
+            return "none";
+        if (this.workspaceRoot === undefined)
+            return "unverifiable";
+        const reference = frontmatter.source_ref.replace(/[@#].*$/, "").trim();
+        if (reference.length === 0 || !isSafeRelativePath(reference) || /^[a-z]+_[0-9A-HJKMNP-TV-Z]{26}/.test(reference))
+            return "unverifiable";
+        const content = await readTextIfExists(path.join(this.workspaceRoot, reference)).catch(() => undefined);
+        if (content === undefined)
+            return "missing";
+        return digestText(content) === frontmatter.source_digest ? "fresh" : "changed";
+    }
+    async apply(proposal) {
+        const decision = proposal.decision;
+        if (decision === undefined)
+            throw usage("an accepted proposal needs a decision");
+        const date = decision.at.slice(0, 10);
+        if (proposal.kind === "note") {
+            const note = proposal.note;
+            if (note === undefined)
+                throw usage("a note proposal carries a note");
+            const { title, body } = splitTitle(proposal.body ?? "");
+            const frontmatter = {
+                ...note,
+                status: note.kind === "decision" && note.status === "proposed" ? "accepted" : note.status,
+                reviewed_at: date,
+                source_run: note.source_run ?? proposal.created_by.run_id,
+            };
+            return this.audit(await this.writeNote({ frontmatter, title: title ?? note.id, body }, undefined));
+        }
+        const targetId = proposal.target;
+        if (targetId === undefined)
+            throw usage(`a ${proposal.kind} proposal names its target`);
+        const entry = (await this.loadIndex()).notes.find((note) => note.id === targetId);
+        const target = entry === undefined ? undefined : await this.readNote(entry.path);
+        if (target === undefined)
+            throw usage(`proposal target ${targetId} does not exist`, `syn memory search ${targetId}`);
+        let frontmatter = { ...target.frontmatter, updated_at: date };
+        if (proposal.kind === "status-change") {
+            const next = proposal.new_status ?? "";
+            if (!MEMORY_STATUSES[target.frontmatter.kind].includes(next)) {
+                throw usage(`${next} is not a ${target.frontmatter.kind} status (${MEMORY_STATUSES[target.frontmatter.kind].join(", ")})`);
+            }
+            frontmatter = { ...frontmatter, status: next, reviewed_at: date };
+        }
+        else {
+            const relation = proposal.relation;
+            if (relation === undefined)
+                throw usage(`a ${proposal.kind} proposal carries a relation`);
+            if (!frontmatter.relations.some((item) => item.type === relation.type && item.target === relation.target)) {
+                frontmatter = { ...frontmatter, relations: [...frontmatter.relations, relation] };
+            }
+        }
+        return this.audit(await this.writeNote({ frontmatter, title: target.title, body: target.body }, target.digest));
+    }
+    audit(note) {
+        return { memory_id: note.frontmatter.id, kind: note.frontmatter.kind, path: note.path, digest: note.digest };
+    }
+    async writeNote(input, expectedDigest) {
+        const title = redactSecrets(input.title).text.trim();
+        const body = redactSecrets(input.body).text.trim();
+        const parsed = memoryNoteFrontmatterSchema.safeParse(redactValue(input.frontmatter));
+        if (!parsed.success)
+            throw usage(`invalid memory note: ${formatZodIssues(parsed.error)}`);
+        const frontmatter = parsed.data;
+        if (title.length === 0 || /[\r\n]/.test(title))
+            throw usage("a memory note title is one non-empty line");
+        if (CONTROL_CHARACTERS.test(body) || CONTROL_CHARACTERS.test(title)) {
+            throw usage("raw terminal or tool output is not stored in memory; persist a distilled summary with source_ref and source_digest");
+        }
+        if (body.length > MAX_NOTE_BODY_CHARS) {
+            throw usage(`a memory note body is limited to ${MAX_NOTE_BODY_CHARS} characters; store a pointer (source_ref + source_digest), not raw output`);
+        }
+        await ensureVaultScaffold(this.root);
+        const existing = (await this.loadIndex()).notes.find((note) => note.id === frontmatter.id);
+        const vaultPath = existing?.path ?? `${KIND_DIRECTORIES[frontmatter.kind]}/${frontmatter.id}.md`;
+        const file = fromVaultPath(this.root, vaultPath);
+        const content = serializeNote({ frontmatter, title, body });
+        const onDisk = await readTextIfExists(file);
+        const actual = onDisk === undefined ? undefined : digestText(onDisk);
+        if (actual !== expectedDigest) {
+            throw new MemoryConflictError({ memoryId: frontmatter.id, path: vaultPath, expected: expectedDigest, actual });
+        }
+        await writeAtomic(file, content);
+        return { frontmatter, title, body, path: vaultPath, digest: digestText(content) };
+    }
+    async readNote(vaultPath) {
+        const content = await readTextIfExists(fromVaultPath(this.root, vaultPath));
+        if (content === undefined)
+            return undefined;
+        const parsed = parseNoteFile(content);
+        if (!parsed.ok)
+            return undefined;
+        return { frontmatter: parsed.frontmatter, title: parsed.title, body: parsed.body, path: vaultPath, digest: digestText(content) };
+    }
+    async loadIndex() {
+        const files = await listNoteFiles(this.root);
+        const cached = await readIndex(this.root);
+        if (cached !== undefined && indexMatchesFiles(cached, files))
+            return cached;
+        const index = await buildIndex(this.root, files);
+        if (await this.rootExists())
+            await writeIndex(this.root, index);
+        return index;
+    }
+    async proposals() {
+        let names;
+        try {
+            names = (await readdir(fromVaultPath(this.root, QUEUE_DIRECTORY))).filter((name) => name.endsWith(".yaml"));
+        }
+        catch (error) {
+            if (isMissing(error))
+                return [];
+            throw error;
+        }
+        const proposals = [];
+        for (const name of names.sort()) {
+            const id = proposalIdSchema.safeParse(name.slice(0, -".yaml".length));
+            if (!id.success)
+                continue;
+            const proposal = await this.proposal(id.data).catch(() => undefined);
+            if (proposal !== undefined)
+                proposals.push(proposal);
+        }
+        return proposals.sort((left, right) => (left.created_at < right.created_at ? -1 : left.created_at > right.created_at ? 1 : 0));
+    }
+    proposalFile(proposalId) {
+        return fromVaultPath(this.root, `${QUEUE_DIRECTORY}/${proposalId}.yaml`);
+    }
+    async rootExists() {
+        return (await readdir(this.root).then(() => true, () => false));
+    }
+}
+/** The I6 factory: a Markdown vault at `root`. Obsidian is never required. */
+export function createMemoryStore(root, options = {}) {
+    return new MarkdownMemoryStore(root, options);
+}
+export function isMemoryKind(value) {
+    return MEMORY_KINDS.includes(value);
+}
+export function parseMemoryId(value) {
+    const parsed = memoryIdSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+//# sourceMappingURL=markdown-memory-store.js.map

package/dist/harness/memory/markdown-memory-store.js.map

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

package/dist/harness/memory/memory-command.d.ts

@@ -0,0 +1,22 @@
+import { type CommandHandler, type MemoryConfig, type MemoryDecisionOutcome } from "../contracts/index.ts";
+import { type ObsidianLauncher } from "./obsidian.ts";
+import type { MemoryGraphView } from "../contracts/views.ts";
+/** `syn memory status|search|show|related|review|accept|reject|open|reindex` (contracts/cli-and-jsonl.md). */
+export declare const MEMORY_SUBCOMMANDS: readonly ["status", "search", "show", "related", "review", "accept", "reject", "open", "reindex", "graph"];
+export interface MemoryCommandOptions {
+    readonly config?: MemoryConfig | undefined;
+    readonly home?: string | undefined;
+    readonly platform?: NodeJS.Platform | undefined;
+    readonly obsidian?: ObsidianLauncher | undefined;
+    readonly now?: (() => Date) | undefined;
+    /** Vault root when `--root` is absent; defaults to `resolveMemoryRoot(config, projectId, home)`. */
+    readonly root?: ((projectId: string) => string) | undefined;
+    /** Receives every decision's audit payloads so the caller can append them as session events. */
+    readonly onDecision?: ((outcome: MemoryDecisionOutcome) => Promise<void>) | undefined;
+    /** Draws `syn memory graph` (the CLI composition root passes the terminal graph renderer); plain adjacency text otherwise. */
+    readonly renderGraph?: ((view: MemoryGraphView) => string) | undefined;
+}
+export declare function createMemoryCommand(options?: MemoryCommandOptions): CommandHandler;
+/** The handler the CLI composition root wires as `syn memory`. */
+export declare const memoryCommand: CommandHandler;
+//# sourceMappingURL=memory-command.d.ts.map

package/dist/harness/memory/memory-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-command.d.ts","sourceRoot":"","sources":["../../../src/harness/memory/memory-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,cAAc,EAGnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAI3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAiD,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGrG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,8GAA8G;AAE9G,eAAO,MAAM,kBAAkB,4GAA6G,CAAC;AAmB7I,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACxC,oGAAoG;IACpG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5D,gGAAgG;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACtF,8HAA8H;IAC9H,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACxE;AA6BD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc,CAiEtF;AAED,kEAAkE;AAClE,eAAO,MAAM,aAAa,EAAE,cAAsC,CAAC"}