nodedex 0.1.0

package/dist/middleware/reflect/provenance-reviewer.d.ts

@@ -0,0 +1,52 @@
+import type { WorkspaceDB, Block } from "../../store/database.js";
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { PipelineFlag, FlagActionTaken, ReviewVerdict } from "./types.js";
+export declare function provenanceReviewerEnabled(): boolean;
+/** Level 2 gate: only when on does the reviewer MUTATE (correct/demote). */
+export declare function provenanceAutoActEnabled(): boolean;
+export declare const PROVENANCE_REVIEW_PROMPT = "You are auditing a knowledge-graph block's PROVENANCE. The block claims it was\nextracted from a conversation, but an automatic check found its stored EXCERPT does\nnot appear in the transcript. Decide whether the block's CLAIM is actually grounded\nin the SOURCE TRANSCRIPT at all \u2014 read the transcript as ground truth.\n\n  grounded=true  \u2014 the claim IS supported somewhere in the transcript (the excerpt\n                   was merely paraphrased / reordered / mis-quoted). If you can find\n                   the exact passage the claim comes from, copy it VERBATIM into\n                   correct_excerpt; otherwise leave correct_excerpt empty.\n  grounded=false \u2014 the claim is NOT present in the transcript (the excerpt AND the\n                   claim were fabricated or mis-attributed). The block will be demoted.\n\nJudge by MEANING \u2014 surface word overlap is NOT enough. When genuinely uncertain\nwhether the claim is in the transcript, prefer grounded=true (demoting is heavier\nthan keeping a flagged block). correct_excerpt must be copied verbatim from the\ntranscript or left empty. reasoning \u2264 200 chars, citing what you found (or didn't).";
+export interface ProvenanceVerdict {
+    grounded: boolean;
+    correct_excerpt: string;
+    reasoning: string;
+}
+export declare function buildReviewInput(db: WorkspaceDB, block: Block, transcript: string): string;
+export declare function judgeProvenance(provider: LLMProvider, userInput: string): Promise<{
+    verdict: ProvenanceVerdict | null;
+    rateLimited: boolean;
+}>;
+export interface AppliedVerdict {
+    verdict: ReviewVerdict;
+    action_taken: FlagActionTaken;
+    reason: string;
+}
+/**
+ * Apply a verdict to one flagged block + record it. autoAct=false → verdict only,
+ * NO mutation (Level 1). Mutations (Level 2): correct the excerpt (grounded + a real
+ * fix) or archive the block (ungrounded) — both recoverable.
+ */
+export declare function applyProvenanceVerdict(db: WorkspaceDB, flag: PipelineFlag, block: Block, verdict: ProvenanceVerdict, autoAct: boolean): AppliedVerdict;
+export interface ProvenanceReviewerTickResult {
+    pending: number;
+    reviewed: number;
+    corrected: number;
+    demoted: number;
+    left: number;
+    skipped_soft: number;
+    skipped_no_transcript: number;
+    rate_limited: number;
+    errors: number;
+    wall_ms: number;
+}
+export declare function runProvenanceReviewerTick(opts: {
+    db: WorkspaceDB;
+    provider: LLMProvider;
+    limit?: number;
+    autoAct?: boolean;
+}): Promise<ProvenanceReviewerTickResult>;
+/** Start the reviewer timer. Idempotent; default OFF. Returns true if started. */
+export declare function startProvenanceReviewerTimer(db: WorkspaceDB): boolean;
+export declare function stopProvenanceReviewerTimer(): void;
+/** Tests only — is the timer running? */
+export declare function _isProvenanceReviewerTimerRunningForTests(): boolean;
+//# sourceMappingURL=provenance-reviewer.d.ts.map

package/dist/middleware/reflect/provenance-reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance-reviewer.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/provenance-reviewer.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU/E,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AACD,4EAA4E;AAC5E,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAcD,eAAO,MAAM,wBAAwB,iqCAe+C,CAAC;AAYrF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA0B1F;AAID,wBAAsB,eAAe,CACnC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAMtE;AAID,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE;AAE1G;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,OAAO,GACf,cAAc,CAwBhB;AAID,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IACpF,YAAY,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAC5G;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,EAAE,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3E,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA8CxC;AA4BD,kFAAkF;AAClF,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAWrE;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,yCAAyC;AACzC,wBAAgB,yCAAyC,IAAI,OAAO,CAEnE"}

package/dist/middleware/reflect/provenance-reviewer.js

@@ -0,0 +1,253 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// GAP ④(b) — PROVENANCE MEANING-REVIEWER (the expensive-narrow half)
+// ═══════════════════════════════════════════════════════════════════════════════
+//
+// Consumes the HARD (severity='missing') provenance_mismatch flags the $0 detector
+// (provenance-check.ts) wrote. For each, it re-reads the STORED source transcript
+// (never the user's new turn) + the block's chain, and judges BY MEANING:
+//
+//   grounded=true  → the block's claim IS in the transcript (the excerpt was just
+//                    mis-quoted). If it can find the real passage → correct_excerpt.
+//   grounded=false → the claim is NOT in the transcript at all → fabricated → demote.
+//
+// TRIAGE → INVESTIGATE: fuzzy (soft) flags NEVER reach here — they're benign
+// paraphrase and would be the scale-cost trap. Only hard flags cost an LLM call.
+//
+// Mirrors flag-reviewer.ts (the dup reviewer) + describe-roots.ts (the timer):
+//   input builder → LLM judge → act → markFlagReviewed → bounded async tick.
+//
+// Safety LEVELS (mirror flag-reviewer's auto-merge gate):
+//   Level 0 (default): NODEDEX_PROVENANCE_REVIEWER_ENABLED unset → worker never
+//                      starts. runProvenanceReviewerTick still callable (REST/tests).
+//   Level 1: ENABLED=on, AUTO_ACT unset → verdicts WRITTEN, graph NOT mutated.
+//   Level 2: + NODEDEX_PROVENANCE_AUTO_ACT=on → corrections + demotes execute
+//            (updateBlock excerpt / archiveBlock — recoverable, charter Rule 2).
+import { getPendingFlags, markFlagReviewed } from "./pipeline-flags.js";
+import { getBlockTranscript } from "./provenance-check.js";
+import { extractPrimaryValueFromUnique } from "./dedup-by-source-and-value.js";
+import { getLLMProvider } from "../../engine/providers/index.js";
+import { budgetTripped } from "./cost-guard.js";
+import { modelOverride, intFromEnv } from "./config.js";
+// ─── Config ──────────────────────────────────────────────────────────────────────
+export function provenanceReviewerEnabled() {
+    return (process.env.NODEDEX_PROVENANCE_REVIEWER_ENABLED ?? "").toLowerCase() === "on";
+}
+/** Level 2 gate: only when on does the reviewer MUTATE (correct/demote). */
+export function provenanceAutoActEnabled() {
+    return (process.env.NODEDEX_PROVENANCE_AUTO_ACT ?? "").toLowerCase() === "on";
+}
+function batchSize() {
+    return intFromEnv("NODEDEX_PROVENANCE_REVIEWER_BATCH", 5); // caps $$ per tick
+}
+function intervalMs() {
+    return intFromEnv("NODEDEX_PROVENANCE_REVIEWER_INTERVAL_MS", 1_800_000); // 30 min (slow background)
+}
+function reviewerModel() {
+    return modelOverride("NODEDEX_PROVENANCE_REVIEWER_MODEL");
+}
+const MAX_TRANSCRIPT_CHARS = 8000; // bound input tokens
+// ─── Prompt + schema ───────────────────────────────────────────────────────────
+export const PROVENANCE_REVIEW_PROMPT = `You are auditing a knowledge-graph block's PROVENANCE. The block claims it was
+extracted from a conversation, but an automatic check found its stored EXCERPT does
+not appear in the transcript. Decide whether the block's CLAIM is actually grounded
+in the SOURCE TRANSCRIPT at all — read the transcript as ground truth.
+
+  grounded=true  — the claim IS supported somewhere in the transcript (the excerpt
+                   was merely paraphrased / reordered / mis-quoted). If you can find
+                   the exact passage the claim comes from, copy it VERBATIM into
+                   correct_excerpt; otherwise leave correct_excerpt empty.
+  grounded=false — the claim is NOT present in the transcript (the excerpt AND the
+                   claim were fabricated or mis-attributed). The block will be demoted.
+
+Judge by MEANING — surface word overlap is NOT enough. When genuinely uncertain
+whether the claim is in the transcript, prefer grounded=true (demoting is heavier
+than keeping a flagged block). correct_excerpt must be copied verbatim from the
+transcript or left empty. reasoning ≤ 200 chars, citing what you found (or didn't).`;
+const PROVENANCE_REVIEW_SCHEMA = {
+    type: "object",
+    properties: {
+        grounded: { type: "boolean" },
+        correct_excerpt: { type: "string" },
+        reasoning: { type: "string" },
+    },
+    required: ["grounded", "reasoning"],
+};
+// ─── Context builder (DB reads, no LLM — testable) ──────────────────────────────
+export function buildReviewInput(db, block, transcript) {
+    let claim = "";
+    try {
+        const c = typeof block.content === "string" ? JSON.parse(block.content) : (block.content || {});
+        claim = extractPrimaryValueFromUnique(block.type, c.unique || {}) || "";
+    }
+    catch { /* tolerate */ }
+    const chainLines = [];
+    const cid = block.chain_id;
+    if (cid) {
+        try {
+            for (const m of db.getBlocksByChain(cid)) {
+                if (m.id === block.id)
+                    continue;
+                chainLines.push(`  - [${m.type}] ${m.label} — "${(m.essence || "").slice(0, 100)}"`);
+            }
+        }
+        catch { /* tolerate */ }
+    }
+    const tx = transcript.length > MAX_TRANSCRIPT_CHARS ? transcript.slice(0, MAX_TRANSCRIPT_CHARS) + " …[truncated]" : transcript;
+    return [
+        `BLOCK: [${block.type}] "${(block.essence || "").slice(0, 200)}"`,
+        claim ? `IDENTITY CLAIM: "${claim.slice(0, 200)}"` : "",
+        `STORED EXCERPT (suspect): "${String(block.source_excerpt ?? "").slice(0, 300)}"`,
+        chainLines.length ? `CHAIN (context):\n${chainLines.join("\n")}` : "CHAIN: (none)",
+        `\nSOURCE TRANSCRIPT:\n${tx}`,
+    ].filter(Boolean).join("\n");
+}
+// ─── LLM judge (the only cost) ──────────────────────────────────────────────────
+export async function judgeProvenance(provider, userInput) {
+    const r = await provider.generateStructured(PROVENANCE_REVIEW_PROMPT, userInput, PROVENANCE_REVIEW_SCHEMA, { thinkingBudget: 512, modelOverride: reviewerModel() });
+    return { verdict: r.result ?? null, rateLimited: r.rateLimited };
+}
+/**
+ * Apply a verdict to one flagged block + record it. autoAct=false → verdict only,
+ * NO mutation (Level 1). Mutations (Level 2): correct the excerpt (grounded + a real
+ * fix) or archive the block (ungrounded) — both recoverable.
+ */
+export function applyProvenanceVerdict(db, flag, block, verdict, autoAct) {
+    const raw = db.db;
+    let out;
+    if (!verdict.grounded) {
+        if (autoAct)
+            db.archiveBlock(block.id, `provenance: claim not found in source transcript — ${verdict.reasoning.slice(0, 120)}`);
+        out = { verdict: "demoted", action_taken: autoAct ? "demoted_unprovenanced" : "none", reason: verdict.reasoning };
+    }
+    else {
+        const fix = (verdict.correct_excerpt ?? "").trim();
+        const needsFix = fix.length > 0 && fix !== String(block.source_excerpt ?? "").trim();
+        if (needsFix && autoAct) {
+            db.updateBlock(block.id, { source_excerpt: fix }, "provenance: corrected excerpt to verbatim source", "provenance_reviewer");
+            out = { verdict: "corrected", action_taken: "corrected_excerpt", reason: verdict.reasoning };
+        }
+        else if (needsFix) {
+            out = { verdict: "corrected", action_taken: "none", reason: verdict.reasoning }; // Level 1: would-correct, not applied
+        }
+        else {
+            out = { verdict: "leave", action_taken: "none", reason: verdict.reasoning };
+        }
+    }
+    markFlagReviewed(raw, {
+        flag_id: flag.id, verdict: out.verdict, reason: out.reason, action_taken: out.action_taken,
+    });
+    return out;
+}
+export async function runProvenanceReviewerTick(opts) {
+    const t0 = Date.now();
+    const { db, provider } = opts;
+    const autoAct = opts.autoAct ?? provenanceAutoActEnabled();
+    const res = {
+        pending: 0, reviewed: 0, corrected: 0, demoted: 0, left: 0,
+        skipped_soft: 0, skipped_no_transcript: 0, rate_limited: 0, errors: 0, wall_ms: 0,
+    };
+    const raw = db.db;
+    const flags = getPendingFlags(raw, {
+        flag_type: "provenance_mismatch", origin_writer: "provenance_check", limit: opts.limit ?? batchSize(),
+    });
+    res.pending = flags.length;
+    for (const flag of flags) {
+        try {
+            // soft (fuzzy) flags never cost an LLM call — close them with 'leave'.
+            if (flag.criteria?.severity !== "hard") {
+                markFlagReviewed(raw, { flag_id: flag.id, verdict: "leave", reason: "soft (paraphrase) — not LLM-reviewed", action_taken: "none" });
+                res.skipped_soft++;
+                continue;
+            }
+            const block = db.getBlock(flag.block_id_a);
+            if (!block || block.status === "archived") {
+                markFlagReviewed(raw, { flag_id: flag.id, verdict: "leave", reason: "block gone/archived", action_taken: "none" });
+                continue;
+            }
+            const src = getBlockTranscript(db, block.id);
+            if (!src) {
+                markFlagReviewed(raw, { flag_id: flag.id, verdict: "leave", reason: "no source transcript to verify against", action_taken: "none" });
+                res.skipped_no_transcript++;
+                continue;
+            }
+            const { verdict, rateLimited } = await judgeProvenance(provider, buildReviewInput(db, block, src.text));
+            if (rateLimited || !verdict) {
+                res.rate_limited += rateLimited ? 1 : 0;
+                res.errors += verdict ? 0 : 1;
+                continue;
+            }
+            const applied = applyProvenanceVerdict(db, flag, block, verdict, autoAct);
+            res.reviewed++;
+            if (applied.verdict === "corrected")
+                res.corrected++;
+            else if (applied.verdict === "demoted")
+                res.demoted++;
+            else
+                res.left++;
+        }
+        catch (e) {
+            res.errors++;
+            console.warn(`[provenance-reviewer] flag ${flag.id} threw: ${e?.message ?? e}`);
+        }
+    }
+    res.wall_ms = Date.now() - t0;
+    return res;
+}
+// ─── Timer wrapper (env-gated, default OFF — mirrors describe-roots) ─────────────
+let _handle = null;
+let _inFlight = false;
+async function tick(db) {
+    if (_inFlight)
+        return;
+    _inFlight = true;
+    try {
+        const budget = await budgetTripped();
+        if (budget?.tripped) {
+            console.warn(`[provenance-reviewer] tick skipped — cost breaker: ${budget.reason}`);
+            return;
+        }
+        const provider = getLLMProvider();
+        if (!provider.isAvailable()) {
+            console.warn("[provenance-reviewer] provider unavailable — skipping tick");
+            return;
+        }
+        const r = await runProvenanceReviewerTick({ db, provider });
+        if (r.reviewed > 0 || r.errors > 0) {
+            console.log(`[provenance-reviewer] tick: pending=${r.pending} reviewed=${r.reviewed} ` +
+                `corrected=${r.corrected} demoted=${r.demoted} left=${r.left} soft=${r.skipped_soft} ` +
+                `errors=${r.errors} wall_ms=${r.wall_ms}`);
+        }
+    }
+    catch (e) {
+        console.warn(`[provenance-reviewer] tick threw: ${e?.message ?? e}`);
+    }
+    finally {
+        _inFlight = false;
+    }
+}
+/** Start the reviewer timer. Idempotent; default OFF. Returns true if started. */
+export function startProvenanceReviewerTimer(db) {
+    if (!provenanceReviewerEnabled()) {
+        console.log("[provenance-reviewer] disabled (set NODEDEX_PROVENANCE_REVIEWER_ENABLED=on to enable)");
+        return false;
+    }
+    if (_handle !== null)
+        return false;
+    const ms = intervalMs();
+    console.log(`[provenance-reviewer] starting: interval=${ms}ms autoAct=${provenanceAutoActEnabled()}`);
+    _handle = setInterval(() => { tick(db).catch((e) => console.warn(`[provenance-reviewer] interval rejected: ${e?.message ?? e}`)); }, ms);
+    if (typeof _handle.unref === "function")
+        _handle.unref();
+    return true;
+}
+export function stopProvenanceReviewerTimer() {
+    if (_handle !== null) {
+        clearInterval(_handle);
+        _handle = null;
+    }
+}
+/** Tests only — is the timer running? */
+export function _isProvenanceReviewerTimerRunningForTests() {
+    return _handle !== null;
+}
+//# sourceMappingURL=provenance-reviewer.js.map

package/dist/middleware/reflect/provenance-reviewer.js.map

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

package/dist/middleware/reflect/prune-collapsed-types.d.ts

@@ -0,0 +1,11 @@
+import type { WorkspaceDB } from "../../store/database.js";
+/** The block types collapsed on 2026-06-15. Their content folded into fact/insight. */
+export declare const COLLAPSED_TYPE_NAMES: readonly ["reasoning_chain", "metric", "claim"];
+export interface PruneCollapsedResult {
+    /** Which of the collapsed-type rows actually existed and were removed. */
+    deleted: string[];
+    /** block_types row count AFTER the prune (sanity). */
+    remaining_types: number;
+}
+export declare function pruneCollapsedTypes(db: WorkspaceDB): PruneCollapsedResult;
+//# sourceMappingURL=prune-collapsed-types.d.ts.map

package/dist/middleware/reflect/prune-collapsed-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-collapsed-types.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/prune-collapsed-types.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,iDAAkD,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,oBAAoB,CAYzE"}

package/dist/middleware/reflect/prune-collapsed-types.js

@@ -0,0 +1,32 @@
+// prune-collapsed-types.ts — registry cleanup for the 2026-06-15 type collapse.
+//
+// reasoning_chain→insight and metric/claim→fact were collapsed: removed from the
+// code's builtin-types seed, the prompts, and the validator. But a DB seeded BEFORE
+// the collapse still carries their `block_types` rows — `INSERT OR IGNORE` only adds,
+// never deletes — so they persist and still surface to the agent (via /api/session)
+// and re-union into the pipeline's seedTypeNames. This prunes EXACTLY those three
+// rows by name.
+//
+// Deliberately NOT a "delete everything not in the seed" reconcile: that would also
+// wipe user-created custom types (workspace_create_type). Explicit names = zero
+// collateral. Idempotent. $0, no LLM. Existing BLOCKS of these types are left
+// forward-only — the validator trusts unknown types, so they recall/traverse fine;
+// re-typing old blocks is a separate, heavier migration we deliberately do not do.
+//
+// Runs through the server's single DB connection (safe live, unlike a side-script).
+/** The block types collapsed on 2026-06-15. Their content folded into fact/insight. */
+export const COLLAPSED_TYPE_NAMES = ["reasoning_chain", "metric", "claim"];
+export function pruneCollapsedTypes(db) {
+    const raw = db.db;
+    const placeholders = COLLAPSED_TYPE_NAMES.map(() => "?").join(",");
+    const present = raw
+        .prepare(`SELECT name FROM block_types WHERE name IN (${placeholders})`)
+        .all(...COLLAPSED_TYPE_NAMES)
+        .map((r) => r.name);
+    if (present.length > 0) {
+        raw.prepare(`DELETE FROM block_types WHERE name IN (${present.map(() => "?").join(",")})`).run(...present);
+    }
+    const remaining_types = raw.prepare(`SELECT COUNT(*) AS n FROM block_types`).get().n;
+    return { deleted: present, remaining_types };
+}
+//# sourceMappingURL=prune-collapsed-types.js.map

package/dist/middleware/reflect/prune-collapsed-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-collapsed-types.js","sourceRoot":"","sources":["../../../src/middleware/reflect/prune-collapsed-types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,iFAAiF;AACjF,oFAAoF;AACpF,sFAAsF;AACtF,oFAAoF;AACpF,kFAAkF;AAClF,gBAAgB;AAChB,EAAE;AACF,oFAAoF;AACpF,gFAAgF;AAChF,8EAA8E;AAC9E,mFAAmF;AACnF,mFAAmF;AACnF,EAAE;AACF,oFAAoF;AAKpF,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AASpF,MAAM,UAAU,mBAAmB,CAAC,EAAe;IACjD,MAAM,GAAG,GAAI,EAAU,CAAC,EAAuB,CAAC;IAChD,MAAM,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,GAAG;SAChB,OAAO,CAAC,+CAA+C,YAAY,GAAG,CAAC;SACvE,GAAG,CAAC,GAAG,oBAAoB,CAAC;SAC5B,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,0CAA0C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,eAAe,GAAI,GAAG,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,EAAU,CAAC,CAAW,CAAC;IACxG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AAC/C,CAAC"}

package/dist/middleware/reflect/recognize-root.d.ts

@@ -0,0 +1,75 @@
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { Pass2Item } from "./types.js";
+export declare function recognizerEnabled(): boolean;
+export interface KnownRoot {
+    label: string;
+    essence: string;
+}
+export interface RecognizerVerdict {
+    decision: "attach" | "new" | "uncertain";
+    matched_root: string;
+    same_owner: boolean;
+    shared_subject: string;
+    reasoning: string;
+}
+/** The deterministic action after applying guard #4 (bias to NOT-attach). */
+export interface RecognizerAction {
+    action: "attach" | "keep";
+    root?: string;
+}
+/**
+ * Map an LLM verdict → an action. ATTACH only when the model is confident
+ * (decision==="attach"), names a root that ACTUALLY EXISTS, confirms same
+ * owner, AND names the shared subject-matter (guard #6 — an attach must carry
+ * its falsifiable evidence; an unevidenced attach is a contract violation, so
+ * the safe direction is fork). Everything else → keep. Pure / testable.
+ */
+export declare function decideAction(verdict: RecognizerVerdict, knownRootLabels: ReadonlySet<string>): RecognizerAction;
+/** Distinct project names among items that are NOT existing roots = the
+ *  new-root candidates the recognizer should judge. Pure / testable. */
+export declare function newRootCandidateNames(items: Pass2Item[], knownRootLabels: ReadonlySet<string>): string[];
+export declare const RECOGNIZE_ROOT_PROMPT = "A knowledge graph is about to create a NEW project root for a cluster of new\nknowledge. Decide whether that cluster actually belongs to an EXISTING project\ninstead \u2014 so related knowledge COMPOUNDS onto one project rather than fragmenting.\n\nYou are given:\n  - NEW CLUSTER: the new knowledge (its proposed project name + member items).\n  - EXISTING PROJECTS: each as a one-line DESCRIPTION (domain + owner).\n\nDecide ONE:\n  - \"attach\"    \u2014 the cluster clearly belongs to one EXISTING project: SAME DOMAIN\n                  AND SAME OWNER. Set matched_root to that project's exact label and\n                  shared_subject to the specific subject-matter they share.\n  - \"new\"       \u2014 no existing project fits; this is genuinely a new project.\n  - \"uncertain\" \u2014 plausibly related to an existing project but you are NOT confident\n                  (e.g. similar domain but unclear/different owner, or a weak fit).\n\nRULES (read carefully):\n  - Judge on the DESCRIPTION's meaning, NOT on label string similarity. Two similar\n    names can be different projects; two different names can be the same project.\n  - SAME OWNER is required for \"attach\". Same domain but a DIFFERENT or UNKNOWN owner\n    (e.g. one customer's data vs another's) is NOT the same project \u2192 \"new\" or \"uncertain\".\n  - \"attach\" requires a NAMEABLE SHARED SUBJECT: shared_subject must name the specific\n    thing both bodies of work are ABOUT. A shared MANNER is not a subject \u2014 that both\n    involve someone remembering, reasoning, or planning a response names no subject,\n    because every conversation involves those. If you cannot name what they are both\n    about, the fit is not real \u2192 \"new\" or \"uncertain\", with shared_subject \"\".\n  - When the fit is merely plausible, choose \"uncertain\", NOT \"attach\". A wrong attach\n    silently merges two real projects (hard to undo); a fork is recoverable. Bias to caution.\n  - reasoning MUST cite the specific evidence (which description, which overlapping\n    content) \u2014 not \"they seem related\".";
+export declare function buildRecognizeInput(newProjectName: string, clusterItems: Pass2Item[], candidateRoots: KnownRoot[], itemCap: number, rootCap: number): string;
+export declare function recognizeClusterRoot(provider: LLMProvider, newProjectName: string, clusterItems: Pass2Item[], candidateRoots: KnownRoot[]): Promise<{
+    verdict: RecognizerVerdict | null;
+    rateLimited: boolean;
+    usage?: {
+        input?: number;
+        thinking?: number;
+        output?: number;
+    };
+}>;
+export interface RecognizeRootsResult {
+    /** project-name → existing-root-label rewrites to apply to items. */
+    remap: Array<{
+        from: string;
+        to: string;
+    }>;
+    candidates: number;
+    attached: number;
+    llm_calls: number;
+    rate_limited: number;
+    errors: number;
+}
+/**
+ * For each new-root candidate cluster, ask the recognizer "attach to an existing
+ * root?" and collect the confident-attach rewrites. Caller applies the remap to
+ * item.project (then Pass 3 + root-create attach to the existing root). Does NOT
+ * mutate items itself (pure-ish: returns the remap). LLM-bounded (one call per
+ * new-root candidate). NO knownRoots → nothing to attach to → empty remap.
+ */
+export declare function recognizeRootsForArc(opts: {
+    provider: LLMProvider;
+    items: Pass2Item[];
+    knownRoots: KnownRoot[];
+}): Promise<RecognizeRootsResult>;
+/** Apply a remap (from recognizeRootsForArc) to items' .project — returns a NEW
+ *  array (shallow-copies only the rewritten items). Pure / testable. */
+export declare function applyRootRemap(items: Pass2Item[], remap: Array<{
+    from: string;
+    to: string;
+}>): {
+    items: Pass2Item[];
+    rewritten: number;
+};
+//# sourceMappingURL=recognize-root.d.ts.map

package/dist/middleware/reflect/recognize-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recognize-root.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/recognize-root.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAUD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,iBAAiB,EAC1B,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GACnC,gBAAgB,CAalB;AAED;wEACwE;AACxE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAAE,EAClB,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GACnC,MAAM,EAAE,CAUV;AAID,eAAO,MAAM,qBAAqB,wjEA6BM,CAAC;AAczC,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,SAAS,EAAE,EACzB,cAAc,EAAE,SAAS,EAAE,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,MAAM,CAaR;AAID,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,SAAS,EAAE,EACzB,cAAc,EAAE,SAAS,EAAE,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAQtI;AAID,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiChC;AAED;wEACwE;AACxE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GACzC;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAW3C"}