@aitne/daemon 0.1.4 → 0.1.7

package/dist/core/wiki/approval-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-queue.js","sourceRoot":"","sources":["../../../src/core/wiki/approval-queue.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAoCnD,MAAM,UAAU,mBAAmB,CACjC,EAAqB,EACrB,KAA+B;IAE/B,MAAM,eAAe,GAAG,sBAAsB,KAAK,CAAC,SAAS,aAAa,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACnN,sEAAsE;IACtE,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,mEAAmE;IACnE,oEAAoE;IACpE,kEAAkE;IAClE,6DAA6D;IAC7D,+DAA+D;IAC/D,MAAM,WAAW,GAAG;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,EAAE,KAAK,CAAC,UAAU;QACrB,mBAAmB,EAAE,KAAK,CAAC,WAAW,CAAC,aAAa;QACpD,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;QAC1C,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO;QACxC,WAAW,EAAE;YACX,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;YACpC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO;YAClC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;YACpC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM;SACjC;KACF,CAAC;IAEF,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;yEAGmE,CACpE;SACA,GAAG,CACF,eAAe,EACf,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAC3B,KAAK,CAAC,WAAW,CAAC,aAAa,CAChC,CAAC;IACJ,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CACT;QACE,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;QACxC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY;QACzC,UAAU;KACX,EACD,8CAA8C,CAC/C,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACzC,CAAC"}

package/dist/core/wiki/bridge.d.ts

@@ -0,0 +1,74 @@
+import type Database from "better-sqlite3";
+import type { WikiBridgeProposal, WikiBridgeResult } from "@aitne/shared";
+import type { WikiWorkspaceRow } from "./workspaces.js";
+export declare const BRIDGE_FILE_RE: RegExp;
+/**
+ * Inputs the bridge writer takes. The proposal payload is the
+ * `WikiBridgeProposal` from `@aitne/shared`; the workspace + db come
+ * from the API route handler.
+ */
+export interface ProcessBridgeProposalInput {
+    db: Database.Database;
+    workspace: WikiWorkspaceRow;
+    proposal: WikiBridgeProposal;
+    /** Override the timestamp used for filename + frontmatter. Tests only. */
+    nowIso?: string;
+    /** Override the actor recorded in `agent_actions`. Tests only. */
+    actor?: string;
+    /**
+     * Optional writer override for the bridge file. When omitted, the
+     * processor uses `writeFileAtomically` directly — fine for internal
+     * workspaces and tests. The API route injects a strategy-aware writer
+     * here so external-mode workspaces (iCloud-sandboxed) fall back to
+     * the Obsidian CLI on EPERM instead of throwing. Signature mirrors
+     * `WikiWriteStrategyResolver.writeFile` (workspace-relative path).
+     */
+    writeFile?: (relPath: string, content: string) => Promise<void>;
+}
+/**
+ * The chokepoint. Synchronous (no network or LLM dependency): hashing,
+ * dedup lookup, and file write are all local. The route handler awaits
+ * it but only the FS write is async-shaped.
+ */
+export declare function processBridgeProposal(input: ProcessBridgeProposalInput): Promise<WikiBridgeResult>;
+/**
+ * Public helper — exposed for tests and dashboard inspection. Same
+ * normalisation rule the writer uses so callers that need to
+ * pre-dedup against `wiki_bridge_dedup` can reproduce the hash.
+ */
+export declare function computeBridgeContentHash(proposal: Pick<WikiBridgeProposal, "summary" | "excerpt">): string;
+/**
+ * Filename derivation per §10.2. Timestamp segment encodes seconds-
+ * resolution and is timezone-stable (UTC). Slug is derived from the
+ * caller's hint or, failing that, from the summary's first words.
+ */
+export declare function bridgeFilename(nowIso: string, slug: string): string;
+/**
+ * Slug derivation. Caller hint wins when it matches the slug regex;
+ * otherwise we slugify the summary's first words. We clamp to 40
+ * chars so the filename stays well within ext4 / APFS 255-byte limits
+ * after the `bridge-<ts>-` prefix.
+ */
+export declare function canonicalBridgeSlug(proposal: WikiBridgeProposal): string;
+interface BridgeRenderContext {
+    detectedAtIso: string;
+    confidence: number;
+    workspaceName: string;
+}
+/**
+ * `type: bridge` frontmatter — the compiler keys segregation on this
+ * (§10.2). The body carries the summary first, then the verbatim
+ * excerpt under a heading the compiler can locate without parsing the
+ * agent's prose. When the caller supplies a `body` override we use it
+ * verbatim — the LLM may want to phrase it differently than the
+ * default scaffold.
+ */
+export declare function renderBridgeMarkdown(proposal: WikiBridgeProposal, ctx: BridgeRenderContext): string;
+/**
+ * Test helper — verify a vault tree has the bridge file. Pure read.
+ * Used by integration tests that hit the API and then assert the
+ * resulting file landed.
+ */
+export declare function bridgeFileExists(workspaceRoot: string, relPath: string): boolean;
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/core/wiki/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/bridge.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAEV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,eAAO,MAAM,cAAc,QAA4C,CAAC;AAGxE;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,gBAAgB,CAAC,CA6N3B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC,GACxD,MAAM,CAMR;AAsBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAIxE;AAcD,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,EAAE,mBAAmB,GACvB,MAAM,CA6BR;AAiGD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAGT"}

package/dist/core/wiki/bridge.js

@@ -0,0 +1,405 @@
+/**
+ * WIKI_BUILDER_DESIGN.md Phase 5 — bridge mechanism.
+ *
+ * The DM agent (or any in-process caller) proposes a bridge candidate;
+ * this module decides whether to:
+ *
+ *   1. drop it as a loop-guard violation (the source is itself a
+ *      bridge file — never re-bridge our own output),
+ *   2. drop it as below the per-workspace confidence threshold
+ *      (`bridge_min_confidence`, §10.3 Q6),
+ *   3. dedup it against an earlier proposal with the same canonical
+ *      content (§10.3 Q3 — SHA-256 over normalised body text),
+ *   4. log it as a `wiki.bridge.candidate` row in `agent_actions` while
+ *      the workspace is in measurement-only mode (§P5.A),
+ *   5. write it to `<vault>/10_raw/bridge-<ts>-<slug>.md` with the
+ *      `type: bridge` frontmatter the compiler keys on (§10.2).
+ *
+ * Pure-ish: the writer takes its filesystem clock as `nowIso`/`nowMs`
+ * for deterministic tests. Real callers use the no-arg defaults.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { writeFileAtomically } from "../atomic-write.js";
+import { upsertWikiFulltextRow } from "./wiki-fts.js";
+export const BRIDGE_FILE_RE = /^10_raw\/bridge-[a-z0-9][a-z0-9-]*\.md$/;
+const BRIDGE_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
+/**
+ * The chokepoint. Synchronous (no network or LLM dependency): hashing,
+ * dedup lookup, and file write are all local. The route handler awaits
+ * it but only the FS write is async-shaped.
+ */
+export async function processBridgeProposal(input) {
+    const { db, workspace, proposal } = input;
+    const nowIso = input.nowIso ?? new Date().toISOString();
+    const confidence = effectiveConfidence(proposal);
+    const contentHash = computeBridgeContentHash(proposal);
+    const dedupKey = {
+        sourceKind: proposal.sourceKind,
+        sourceRef: proposal.sourceRef,
+    };
+    // (1) Loop guard. The DM agent must never bridge its own output — a
+    // `sourceRef` that already names a bridge file is a self-reference
+    // and would compound on every compile. The check is path-shaped
+    // because `sourceRef` semantics differ per caller (a session id, a
+    // file path, a message id), but only the file-path case can collide.
+    if (BRIDGE_FILE_RE.test(proposal.sourceRef)) {
+        recordBridgeAudit(db, workspace, {
+            actor: input.actor,
+            outcome: "loop_guard",
+            proposal,
+            confidence,
+            contentHash,
+            path: null,
+            detectedAtIso: nowIso,
+        });
+        return {
+            outcome: "loop_guard",
+            workspace: workspace.name,
+            path: null,
+            contentHash,
+            confidence,
+            measurementOnly: workspace.bridge_measurement_only === 1,
+            dedupKey,
+            reason: "source is itself a bridge file",
+        };
+    }
+    // (2) Feature gate. `bridge_enabled = 0` means the workspace owner
+    // never opted in; we don't even log a candidate row. `dm_agent_write_enabled`
+    // is the API-route precondition; this module trusts the route's
+    // 403 enforcement and only re-checks `bridge_enabled` because the
+    // in-process callers (e.g. a future routine) bypass the route auth.
+    if (workspace.bridge_enabled !== 1) {
+        return {
+            outcome: "feature_disabled",
+            workspace: workspace.name,
+            path: null,
+            contentHash,
+            confidence,
+            measurementOnly: workspace.bridge_measurement_only === 1,
+            dedupKey,
+            reason: "bridge_enabled is 0 on the workspace",
+        };
+    }
+    // (3) Confidence threshold. Explicit triggers always pass — the
+    // owner asked for it. Self-judged proposals must clear the
+    // per-workspace floor.
+    if (proposal.trigger === "self_judged" && confidence < workspace.bridge_min_confidence) {
+        recordBridgeAudit(db, workspace, {
+            actor: input.actor,
+            outcome: "below_threshold",
+            proposal,
+            confidence,
+            contentHash,
+            path: null,
+            detectedAtIso: nowIso,
+        });
+        return {
+            outcome: "below_threshold",
+            workspace: workspace.name,
+            path: null,
+            contentHash,
+            confidence,
+            measurementOnly: workspace.bridge_measurement_only === 1,
+            dedupKey,
+            reason: `confidence ${confidence} below threshold ${workspace.bridge_min_confidence}`,
+        };
+    }
+    // (4) Dedup. The unique index on `(workspace_id, content_hash)` is
+    // the durable enforcement; the SELECT lets us return the prior
+    // bridge's path so the caller (and the audit row) can surface "this
+    // is the same insight you bridged on 2026-05-01".
+    const prior = db
+        .prepare(`SELECT bridge_path FROM wiki_bridge_dedup
+       WHERE workspace_id = ? AND content_hash = ?
+       LIMIT 1`)
+        .get(workspace.id, contentHash);
+    if (prior) {
+        recordBridgeAudit(db, workspace, {
+            actor: input.actor,
+            outcome: "deduplicated",
+            proposal,
+            confidence,
+            contentHash,
+            path: null,
+            detectedAtIso: nowIso,
+            existingPath: prior.bridge_path,
+        });
+        return {
+            outcome: "deduplicated",
+            workspace: workspace.name,
+            path: null,
+            contentHash,
+            confidence,
+            measurementOnly: workspace.bridge_measurement_only === 1,
+            dedupKey,
+            existingPath: prior.bridge_path,
+            reason: "same content_hash already bridged in this workspace",
+        };
+    }
+    // (5) Measurement-only mode. Log the candidate, persist the dedup
+    // row (so a re-proposal of the same content still short-circuits),
+    // but do NOT touch the filesystem.
+    const measurementOnly = workspace.bridge_measurement_only === 1;
+    if (measurementOnly) {
+        db.prepare(`INSERT OR IGNORE INTO wiki_bridge_dedup
+         (workspace_id, content_hash, source_kind, source_ref,
+          bridge_path, confidence, accepted, detected_at)
+       VALUES (?, ?, ?, ?, NULL, ?, 0, ?)`).run(workspace.id, contentHash, proposal.sourceKind, proposal.sourceRef, confidence, nowIso);
+        recordBridgeAudit(db, workspace, {
+            actor: input.actor,
+            outcome: "candidate_logged",
+            proposal,
+            confidence,
+            contentHash,
+            path: null,
+            detectedAtIso: nowIso,
+        });
+        return {
+            outcome: "candidate_logged",
+            workspace: workspace.name,
+            path: null,
+            contentHash,
+            confidence,
+            measurementOnly: true,
+            dedupKey,
+            reason: "workspace is in bridge_measurement_only mode",
+        };
+    }
+    // (6) Real write. Compose the filename and body, snapshot the dedup
+    // row, then materialise. The file is `create-only` (the raw-layer
+    // append-only invariant) so we rely on the unique-index dedup to
+    // serialise identical content; truly-distinct content gets a
+    // unique timestamp+slug filename.
+    const slug = canonicalBridgeSlug(proposal);
+    const filename = bridgeFilename(nowIso, slug);
+    const relPath = `10_raw/${filename}`;
+    const absPath = resolve(workspace.root_path, relPath);
+    const body = renderBridgeMarkdown(proposal, {
+        detectedAtIso: nowIso,
+        confidence,
+        workspaceName: workspace.name,
+    });
+    mkdirSync(dirname(absPath), { recursive: true });
+    if (input.writeFile) {
+        await input.writeFile(relPath, body);
+    }
+    else {
+        writeFileAtomically(absPath, body);
+    }
+    db.prepare(`INSERT OR REPLACE INTO wiki_bridge_dedup
+       (workspace_id, content_hash, source_kind, source_ref,
+        bridge_path, confidence, accepted, detected_at)
+     VALUES (?, ?, ?, ?, ?, ?, 1, ?)`).run(workspace.id, contentHash, proposal.sourceKind, proposal.sourceRef, relPath, confidence, nowIso);
+    upsertWikiFulltextRow(db, {
+        workspaceId: workspace.id,
+        path: relPath,
+        layer: "raw",
+        content: body,
+    });
+    recordBridgeAudit(db, workspace, {
+        actor: input.actor,
+        outcome: "written",
+        proposal,
+        confidence,
+        contentHash,
+        path: relPath,
+        detectedAtIso: nowIso,
+    });
+    db.prepare(`UPDATE wiki_workspaces SET updated_at = CURRENT_TIMESTAMP WHERE id = ?`).run(workspace.id);
+    return {
+        outcome: "written",
+        workspace: workspace.name,
+        path: relPath,
+        contentHash,
+        confidence,
+        measurementOnly: false,
+        dedupKey,
+    };
+}
+/**
+ * Public helper — exposed for tests and dashboard inspection. Same
+ * normalisation rule the writer uses so callers that need to
+ * pre-dedup against `wiki_bridge_dedup` can reproduce the hash.
+ */
+export function computeBridgeContentHash(proposal) {
+    return createHash("sha256")
+        .update(normaliseForHash(proposal.summary))
+        .update("\n--\n")
+        .update(normaliseForHash(proposal.excerpt))
+        .digest("hex");
+}
+/**
+ * Canonicalise free-form prose into a stable hash input: lowercase,
+ * collapse whitespace, strip trailing/leading whitespace, and drop
+ * common punctuation. Survives spelling-preserving paraphrases that
+ * keep the same words but re-flow them across lines.
+ */
+function normaliseForHash(text) {
+    return text
+        .toLowerCase()
+        .replace(/[\p{Pd}\p{Pe}\p{Pf}\p{Pi}\p{Po}\p{Ps}]/gu, " ")
+        .replace(/\s+/gu, " ")
+        .trim();
+}
+function effectiveConfidence(proposal) {
+    if (proposal.trigger === "explicit")
+        return 1;
+    if (typeof proposal.confidence !== "number")
+        return 0;
+    return Math.max(0, Math.min(1, proposal.confidence));
+}
+/**
+ * Filename derivation per §10.2. Timestamp segment encodes seconds-
+ * resolution and is timezone-stable (UTC). Slug is derived from the
+ * caller's hint or, failing that, from the summary's first words.
+ */
+export function bridgeFilename(nowIso, slug) {
+    const ts = nowIso.replace(/[-:T]/g, "").replace(/\..+/, "").slice(0, 14);
+    // ts is e.g. "20260512T101530" → strip the embedded T → "20260512101530"
+    // but we want a hyphenated form `YYYY-MM-DD-HHmmss`.
+    const formatted = `${ts.slice(0, 4)}-${ts.slice(4, 6)}-${ts.slice(6, 8)}-${ts.slice(8, 14)}`;
+    return `bridge-${formatted}-${slug}.md`;
+}
+/**
+ * Slug derivation. Caller hint wins when it matches the slug regex;
+ * otherwise we slugify the summary's first words. We clamp to 40
+ * chars so the filename stays well within ext4 / APFS 255-byte limits
+ * after the `bridge-<ts>-` prefix.
+ */
+export function canonicalBridgeSlug(proposal) {
+    const hint = (proposal.slug ?? "").trim().toLowerCase();
+    if (hint && BRIDGE_SLUG_RE.test(hint))
+        return clampSlug(hint);
+    return clampSlug(slugifyFromSummary(proposal.summary));
+}
+function slugifyFromSummary(summary) {
+    const slug = summary
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "untitled";
+}
+function clampSlug(slug) {
+    return slug.slice(0, 40).replace(/-+$/, "") || "untitled";
+}
+/**
+ * `type: bridge` frontmatter — the compiler keys segregation on this
+ * (§10.2). The body carries the summary first, then the verbatim
+ * excerpt under a heading the compiler can locate without parsing the
+ * agent's prose. When the caller supplies a `body` override we use it
+ * verbatim — the LLM may want to phrase it differently than the
+ * default scaffold.
+ */
+export function renderBridgeMarkdown(proposal, ctx) {
+    if (proposal.body) {
+        return proposal.body.endsWith("\n") ? proposal.body : `${proposal.body}\n`;
+    }
+    const lines = [];
+    lines.push("---");
+    lines.push(`type: bridge`);
+    lines.push(`workspace: ${ctx.workspaceName}`);
+    lines.push(`trigger: ${proposal.trigger}`);
+    lines.push(`detected_at: ${ctx.detectedAtIso}`);
+    lines.push(`confidence: ${ctx.confidence.toFixed(2)}`);
+    lines.push(`source_kind: ${proposal.sourceKind}`);
+    lines.push(`source_ref: ${proposal.sourceRef}`);
+    if (proposal.sessionId)
+        lines.push(`session_id: ${proposal.sessionId}`);
+    if (proposal.messageId)
+        lines.push(`message_id: ${proposal.messageId}`);
+    if (proposal.routineName)
+        lines.push(`routine: ${proposal.routineName}`);
+    lines.push("---");
+    lines.push("");
+    lines.push("# Bridge");
+    lines.push("");
+    lines.push("## Summary");
+    lines.push("");
+    lines.push(proposal.summary.trim());
+    lines.push("");
+    lines.push("## Source excerpt");
+    lines.push("");
+    lines.push(proposal.excerpt.trim());
+    lines.push("");
+    return `${lines.join("\n")}`;
+}
+/**
+ * §11.1 — re-use `agent_actions`. The action_type encodes the outcome
+ * so the dashboard timeline filter can split written vs. candidate vs.
+ * dedup rows without parsing `detail` JSON.
+ *
+ *   - `wiki.bridge`            — written
+ *   - `wiki.bridge.candidate`  — measurement-only candidate logged
+ *   - `wiki.bridge.dedup`      — dedup short-circuit
+ *   - `wiki.bridge.skip`       — below_threshold / loop_guard
+ *
+ * `source_kind = 'wiki'` keeps the existing
+ * `idx_agent_actions_source` lookup working for the wiki dashboard.
+ */
+function recordBridgeAudit(db, workspace, input) {
+    const actionType = bridgeActionType(input.outcome);
+    const detail = {
+        processKey: "wiki.bridge",
+        workspace: workspace.name,
+        workspace_id: workspace.id,
+        outcome: input.outcome,
+        trigger: input.proposal.trigger,
+        confidence: input.confidence,
+        content_hash: input.contentHash,
+        source_kind_of: input.proposal.sourceKind,
+        source_ref_of: input.proposal.sourceRef,
+        session_id: input.proposal.sessionId ?? null,
+        message_id: input.proposal.messageId ?? null,
+        routine: input.proposal.routineName ?? null,
+        targets: input.path ? [input.path] : [],
+        existing_path: input.existingPath ?? null,
+        summary_chars: input.proposal.summary.length,
+        excerpt_chars: input.proposal.excerpt.length,
+        actor: input.actor ?? "dm-agent",
+    };
+    db.prepare(`INSERT INTO agent_actions
+       (event_id, action_type, trigger, result, detail,
+        started_at, completed_at, source_kind, source_ref)
+     VALUES (?, ?, 'autonomous', ?, json(?), ?, ?, 'wiki', ?)`).run(`wiki.bridge:${workspace.name}:${input.contentHash}`, actionType, bridgeAuditResult(input.outcome), JSON.stringify(detail), input.detectedAtIso, input.detectedAtIso, workspace.name);
+}
+function bridgeActionType(outcome) {
+    switch (outcome) {
+        case "written":
+            return "wiki.bridge";
+        case "candidate_logged":
+            return "wiki.bridge.candidate";
+        case "deduplicated":
+            return "wiki.bridge.dedup";
+        case "below_threshold":
+        case "loop_guard":
+        case "feature_disabled":
+            return "wiki.bridge.skip";
+        default: {
+            // Exhaustiveness guard — adding a new outcome upstream without
+            // mapping it here is a compile-time error.
+            const _exhaustive = outcome;
+            void _exhaustive;
+            return "wiki.bridge.skip";
+        }
+    }
+}
+function bridgeAuditResult(outcome) {
+    if (outcome === "written")
+        return "success";
+    if (outcome === "candidate_logged" || outcome === "deduplicated")
+        return "partial";
+    return "skipped";
+}
+/**
+ * Test helper — verify a vault tree has the bridge file. Pure read.
+ * Used by integration tests that hit the API and then assert the
+ * resulting file landed.
+ */
+export function bridgeFileExists(workspaceRoot, relPath) {
+    if (!BRIDGE_FILE_RE.test(relPath))
+        return false;
+    return existsSync(resolve(workspaceRoot, relPath));
+}
+//# sourceMappingURL=bridge.js.map

package/dist/core/wiki/bridge.js.map

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

package/dist/core/wiki/compile-lock.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Workspace-scoped in-process lock for `wiki.compile` sessions.
+ *
+ * WIKI_BUILDER_DESIGN.md §3.5 / §14 Q4 — "Second `!compile` mid-`!compile`
+ * → returns 409 `compile_in_progress` with the running session's id.
+ * Compiles are not queued: a queued compile would land on a vault state
+ * already reflecting the queued user's intent (because the in-progress
+ * run picked up the same raw items), producing duplicate work."
+ *
+ * Design:
+ *   - The bang handler calls `tryAcquireWikiCompileLock` at enqueue
+ *     time. The lock is held until the dispatcher releases it via
+ *     `releaseWikiCompileLock` in `executeDefault`'s `finally` block.
+ *   - The lock is purely in-process; that matches the dispatcher's
+ *     existing concurrency invariants (`hourlyCheckInProgress`,
+ *     `morningRoutineActive` are also in-memory flags). A second
+ *     daemon process would not see the lock — but the daemon is
+ *     single-process by design.
+ *   - TTL fallback: an unreleased lock older than 1h is treated as
+ *     orphaned (daemon crashed before release, or a session legitimately
+ *     ran longer than any wiki.compile budget envelope tolerates). The
+ *     next acquire succeeds and overwrites the stale entry. Without
+ *     this, a crash mid-compile would block all future `!compile` calls
+ *     for that workspace until the next daemon restart.
+ */
+export interface WikiCompileLockHolder {
+    workspace: string;
+    startedAt: Date;
+    correlationId?: string;
+}
+export type WikiCompileLockAcquireResult = {
+    ok: true;
+} | {
+    ok: false;
+    holder: WikiCompileLockHolder;
+};
+export declare function tryAcquireWikiCompileLock(workspace: string, correlationId?: string, now?: Date): WikiCompileLockAcquireResult;
+export declare function releaseWikiCompileLock(workspace: string): void;
+export declare function getWikiCompileLockHolder(workspace: string): WikiCompileLockHolder | null;
+/** Test helper — wipes the lock state. Never call outside test setup. */
+export declare function __resetWikiCompileLockForTests(): void;
+//# sourceMappingURL=compile-lock.d.ts.map

package/dist/core/wiki/compile-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-lock.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/compile-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,MAAM,4BAA4B,GACpC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEjD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,EACtB,GAAG,GAAE,IAAiB,GACrB,4BAA4B,CAgB9B;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAChB,qBAAqB,GAAG,IAAI,CAE9B;AAED,yEAAyE;AACzE,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/core/wiki/compile-lock.js

@@ -0,0 +1,55 @@
+/**
+ * Workspace-scoped in-process lock for `wiki.compile` sessions.
+ *
+ * WIKI_BUILDER_DESIGN.md §3.5 / §14 Q4 — "Second `!compile` mid-`!compile`
+ * → returns 409 `compile_in_progress` with the running session's id.
+ * Compiles are not queued: a queued compile would land on a vault state
+ * already reflecting the queued user's intent (because the in-progress
+ * run picked up the same raw items), producing duplicate work."
+ *
+ * Design:
+ *   - The bang handler calls `tryAcquireWikiCompileLock` at enqueue
+ *     time. The lock is held until the dispatcher releases it via
+ *     `releaseWikiCompileLock` in `executeDefault`'s `finally` block.
+ *   - The lock is purely in-process; that matches the dispatcher's
+ *     existing concurrency invariants (`hourlyCheckInProgress`,
+ *     `morningRoutineActive` are also in-memory flags). A second
+ *     daemon process would not see the lock — but the daemon is
+ *     single-process by design.
+ *   - TTL fallback: an unreleased lock older than 1h is treated as
+ *     orphaned (daemon crashed before release, or a session legitimately
+ *     ran longer than any wiki.compile budget envelope tolerates). The
+ *     next acquire succeeds and overwrites the stale entry. Without
+ *     this, a crash mid-compile would block all future `!compile` calls
+ *     for that workspace until the next daemon restart.
+ */
+const LOCK_TTL_MS = 60 * 60 * 1000;
+const inFlight = new Map();
+export function tryAcquireWikiCompileLock(workspace, correlationId, now = new Date()) {
+    const existing = inFlight.get(workspace);
+    if (existing) {
+        const age = now.getTime() - existing.startedAt.getTime();
+        if (age < LOCK_TTL_MS) {
+            return { ok: false, holder: existing };
+        }
+        // Stale — overwrite below.
+    }
+    const holder = {
+        workspace,
+        startedAt: now,
+        ...(correlationId ? { correlationId } : {}),
+    };
+    inFlight.set(workspace, holder);
+    return { ok: true };
+}
+export function releaseWikiCompileLock(workspace) {
+    inFlight.delete(workspace);
+}
+export function getWikiCompileLockHolder(workspace) {
+    return inFlight.get(workspace) ?? null;
+}
+/** Test helper — wipes the lock state. Never call outside test setup. */
+export function __resetWikiCompileLockForTests() {
+    inFlight.clear();
+}
+//# sourceMappingURL=compile-lock.js.map

package/dist/core/wiki/compile-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-lock.js","sourceRoot":"","sources":["../../../src/core/wiki/compile-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAQnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;AAM1D,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,aAAsB,EACtB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzD,IAAI,GAAG,GAAG,WAAW,EAAE,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC;QACD,2BAA2B;IAC7B,CAAC;IACD,MAAM,MAAM,GAA0B;QACpC,SAAS;QACT,SAAS,EAAE,GAAG;QACd,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,SAAiB;IAEjB,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,8BAA8B;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/core/wiki/compile-preview.d.ts

@@ -0,0 +1,8 @@
+import type { WikiCompilePreview, WikiCompileMode } from "@aitne/shared";
+import type { WikiWorkspaceRow } from "./workspaces.js";
+export interface CompilePreviewInput {
+    workspace: WikiWorkspaceRow;
+    mode: WikiCompileMode;
+}
+export declare function buildCompilePreview(input: CompilePreviewInput): WikiCompilePreview;
+//# sourceMappingURL=compile-preview.d.ts.map

package/dist/core/wiki/compile-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-preview.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/compile-preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAuCxD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,kBAAkB,CAkElF"}