nodedex 0.1.0

package/dist/middleware/reflect/apply-flag-verdict.js.map

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

package/dist/middleware/reflect/arc-entity-resolve.d.ts

@@ -0,0 +1,29 @@
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { ConversationTurnRow } from "../../store/database.js";
+import type { ArcEntityResolveResult, Pass2Item } from "./types.js";
+export declare const ARC_ENTITY_RESOLVE_PROMPT = "You receive scene cards from N turns of ONE CONTINUOUS conversation arc.\n\n\u2500\u2500 YOUR JOB \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nIdentify entities mentioned across these turns. Group anaphoric mentions of\nthe same entity \u2014 where one turn names a thing specifically and a later turn\nrefers back to it with a generic noun or pronoun-like reference (\"the X\",\n\"this one\", \"it\"). For each entity, pick a single canonical_name following the\nstrict naming rule.\n\nThis is ANAPHORA RESOLUTION over a single conversation. The entity IS the\nunit the speaker keeps coming back to, even when they switch names for it.\n\n\u2500\u2500 STATE CONVENTION \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\"State\" in this prompt = text in the SCENE CARDS region below. Your training\nknowledge and \"what's commonly true about this domain\" are NOT state. An\nentity exists ONLY if the scene cards reference it. Familiarity \u2260 recorded.\n\n\u2500\u2500 WHEN TO CLUSTER (group mentions into ONE entity) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nTwo scene cards refer to the SAME entity when:\n  - Heavy overlap in technologies mentioned (\u22653 shared techs is a strong signal)\n  - Same people/actors referenced across both\n  - Anaphoric naming pattern: one scene card has a specific name and others\n    use a generic noun or back-reference (\"the X\", \"this X\", \"it\") that fits\n    the same concept\n  - Scene card scope descriptions tell the same story\n\n\u2500\u2500 WHEN TO KEEP SEPARATE (multiple entities, multiple clusters) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nTwo scene cards refer to DIFFERENT entities when:\n  - Disjoint signal sets \u2014 the technologies/tools/methods named in one do not\n    overlap with the other\n  - Different owners/contexts even when the kind of thing is similar (one\n    party's instance vs another party's instance of the same kind)\n  - The conversation legitimately covers multiple distinct topics\n\nDO NOT force-cluster just because scene cards are sequential. Anaphora is a\nLANGUAGE pattern (pronoun referencing) \u2014 only group when the signals say\n\"same entity,\" not \"same conversation.\"\n\n\u2500\u2500 CANONICAL NAME (the canonical_name field) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nThe canonical_name is the project segment of the strict label rule\n{project}_{type}_{concept}. Constraints:\n  - lowercase, hyphens-only (NO underscores \u2014 underscores separate label\n    DIMENSIONS, not words within a segment)\n  - 2-5 words separated by hyphens\n  - Use the MOST SPECIFIC name available across the scene cards: prefer a\n    specific name over a generic back-reference \u2014 the specific one carries\n    information, the generic one doesn't\n  - If multiple scene cards agree on a specific name, use that\n  - If all scene cards use generic names, synthesize the most specific name\n    you can defend from the scope descriptions and the signals present\n\nYOU pick the name. Do not return a bare generic noun just because that's what\nsome scene cards said \u2014 those are anaphoric forms, not the canonical name.\n\n\u2500\u2500 EVIDENCE (the evidence field \u2014 REQUIRED per cluster) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nFor each cluster you emit, populate evidence.{shared_technologies,\nshared_entities, shared_concepts} with the OBSERVED OVERLAPS that made you\ncluster these mentions. Empty arrays are valid when no overlap exists for\nthat dimension. But at least one of the three should be non-empty for a\nreal cluster (otherwise there's no evidence).\n\n\u2500\u2500 REASONING (the reasoning field \u2014 REQUIRED per cluster) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nFor each cluster, the reasoning field MUST:\n  1. Name which turns are in this cluster\n  2. Name SPECIFIC overlap signals you used (the shared technologies,\n     the anaphoric naming pattern, etc.)\n  3. Explain why mentions NOT in this cluster were excluded (when applicable)\n\nA reasoning that says only \"these mentions are related\" without naming\nspecifics fails. Cite the concrete signals.\n\n\u2500\u2500 UNRESOLVED MENTIONS (the unresolved_mentions field \u2014 OPTIONAL) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nIf a turn's scene card is too thin or ambiguous to confidently assign to any\ncluster, list it in unresolved_mentions instead of force-fitting. The caller\nwill decide whether to flag for review or fall back to per-turn naming.\n\n\u2500\u2500 OUTPUT \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nReturn a JSON object matching this SHAPE (placeholders show structure only \u2014\nfill every field from the actual scene cards, do not echo these labels):\n  {\n    \"clusters\": [\n      {\n        \"canonical_name\": \"<specific-hyphenated-name-you-chose>\",\n        \"mentions\": [\n          { \"turn_number\": <n>, \"scope_project_name\": \"<what that turn called it>\", \"item_ids\": [\"item_T<n>_<id>\", ...] }\n        ],\n        \"evidence\": {\n          \"shared_technologies\": [\"<observed overlapping tool/tech/method names>\"],\n          \"shared_entities\":     [\"<observed shared people/orgs>\"],\n          \"shared_concepts\":     [\"<observed shared concept tags>\"]\n        },\n        \"reasoning\": \"<which turns; the SPECIFIC overlap signals used; why excluded mentions were excluded>\"\n      }\n    ],\n    \"unresolved_mentions\": [],\n    \"arc_resolve_reasoning\": \"<one line: single- vs multi-entity arc, and why>\"\n  }";
+export interface StageCInputContext {
+    agent_id: string;
+    turns: ConversationTurnRow[];
+}
+export declare function buildArcEntityResolveInput(ctx: StageCInputContext): string;
+export interface RunArcEntityResolveOpts {
+    provider: LLMProvider;
+    agent_id: string;
+    turns: ConversationTurnRow[];
+    /** Stage C is skipped entirely when this is true (Sub-step 1.5 fixture
+     * may want to A/B compare with and without). Default false (Stage C runs). */
+    disabled?: boolean;
+    /** When set, the helper returns AFTER the LLM call without parsing the
+     * result schema (used by unit tests). Production callers leave this false. */
+    _testHookReturnRaw?: boolean;
+}
+export declare function runArcEntityResolve(opts: RunArcEntityResolveOpts): Promise<ArcEntityResolveResult | undefined>;
+export interface ApplyCanonicalNamesResult {
+    items: Pass2Item[];
+    renamed_count: number;
+    clusters_used: number;
+    unmatched_item_ids: string[];
+}
+export declare function applyArcEntityCanonicalNames(items: Pass2Item[], resolution: ArcEntityResolveResult | undefined): ApplyCanonicalNamesResult;
+//# sourceMappingURL=arc-entity-resolve.d.ts.map

package/dist/middleware/reflect/arc-entity-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arc-entity-resolve.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/arc-entity-resolve.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAsC,SAAS,EAAE,MAAM,YAAY,CAAC;AAoBxG,eAAO,MAAM,yBAAyB,4yNAgGlC,CAAC;AAkEL,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAsC1E;AAeD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;kFAC8E;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAgG7C;AAwBD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,EAAE,EAClB,UAAU,EAAE,sBAAsB,GAAG,SAAS,GAC7C,yBAAyB,CAkD3B"}

package/dist/middleware/reflect/arc-entity-resolve.js

@@ -0,0 +1,356 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEBT 5 Slice 1 Sub-step 1.2 — STAGE C: ARC ENTITY RESOLVE
+// ═══════════════════════════════════════════════════════════════════════════════
+//
+// Runs ONCE per arc trigger BEFORE Pass 2-5 over the consolidated input.
+//
+// Why this exists (Phase 11 evidence):
+//   In our 5-turn arc fixture, per-turn Pass 0 emitted 5 different
+//   `scope_project.name` values for what was clearly ONE entity (a Python web
+//   service): `json-api-service`, `service`, `this-service`, `the-service`,
+//   `system-performance`. Pass 3 trusted those verbatim (pass3.ts:75-77),
+//   producing 5 fragmented project roots for one arc.
+//
+// What this fixes:
+//   The MISSING cognitive step #11 (PROJECT-RESOLVE) per
+//   docs/PIPELINE-AUDIT-VS-FIRST-PRINCIPLES.md §2. Adds a reconciliation
+//   seam at arc time so Pass 3 receives a canonical entity map instead of
+//   per-turn-derived noise.
+//
+// Identity model (per docs/PIPELINE-AUDIT-DEPENDENCY-MAP.md §1):
+//   - Within-arc: entity = clustered by LLM judgment using technology +
+//     entity + scene-card-scope overlap signals
+//   - LLM picks canonical_name following strict {project}_{type}_{concept}
+//     naming rule — code does NOT pick names (rule 3 compliance)
+//   - Code only assembles the input + parses the output (rule 3 split)
+//
+// What this does NOT do (Slice 1 scope):
+//   - Cross-graph resolution (Slice 3 Stage D — checks scope/owner against
+//     existing graph; this is within-arc only)
+//   - Auto-merge — only emits canonical_name + cluster. Pass 3 uses the
+//     canonical name; system never silently merges blocks.
+//   - Flag unresolved mentions to pipeline_flags (could later via
+//     'entity_unresolved' flag_type; Sub-step 1.2 just emits them in the
+//     unresolved_mentions array for caller to inspect/decide)
+import { reflectTokenStats } from "./context.js";
+import { getThinkingBudget } from "./config.js";
+// Provider model override. Stage C is reasoning-heavy (anaphora judgment +
+// canonical-name selection) — same shape as Pass 4 which defaults to Pro for
+// Gemini. Defaults to provider's standard; opt-in to Pro via env.
+const STAGE_C_MODEL_OVERRIDE = process.env.NODEDEX_STAGE_C_MODEL ?? null;
+// ─── Prompt ────────────────────────────────────────────────────────────────────
+//
+// Design notes (per docs/PIPELINE-SLICE-1-DESIGN.md §7):
+//   - Frames the work as ANAPHORA RESOLUTION (LLM-good) not generic-clustering
+//   - Forces explicit evidence citation (model can't hand-wave "they seem related")
+//   - Defers to LLM for canonical name (rule 3 — naming is LLM's job)
+//   - Strict naming rule enforced at prompt level (no underscore in project segment)
+//   - Multi-entity arcs explicitly permitted (don't over-cluster legitimately
+//     distinct entities like auth-service + billing-service)
+//   - Unresolved fallback explicit (not all mentions need to cluster)
+export const ARC_ENTITY_RESOLVE_PROMPT = `You receive scene cards from N turns of ONE CONTINUOUS conversation arc.
+
+── YOUR JOB ─────────────────────────────────────────────────────────────────
+Identify entities mentioned across these turns. Group anaphoric mentions of
+the same entity — where one turn names a thing specifically and a later turn
+refers back to it with a generic noun or pronoun-like reference ("the X",
+"this one", "it"). For each entity, pick a single canonical_name following the
+strict naming rule.
+
+This is ANAPHORA RESOLUTION over a single conversation. The entity IS the
+unit the speaker keeps coming back to, even when they switch names for it.
+
+── STATE CONVENTION ─────────────────────────────────────────────────────────
+"State" in this prompt = text in the SCENE CARDS region below. Your training
+knowledge and "what's commonly true about this domain" are NOT state. An
+entity exists ONLY if the scene cards reference it. Familiarity ≠ recorded.
+
+── WHEN TO CLUSTER (group mentions into ONE entity) ─────────────────────────
+Two scene cards refer to the SAME entity when:
+  - Heavy overlap in technologies mentioned (≥3 shared techs is a strong signal)
+  - Same people/actors referenced across both
+  - Anaphoric naming pattern: one scene card has a specific name and others
+    use a generic noun or back-reference ("the X", "this X", "it") that fits
+    the same concept
+  - Scene card scope descriptions tell the same story
+
+── WHEN TO KEEP SEPARATE (multiple entities, multiple clusters) ─────────────
+Two scene cards refer to DIFFERENT entities when:
+  - Disjoint signal sets — the technologies/tools/methods named in one do not
+    overlap with the other
+  - Different owners/contexts even when the kind of thing is similar (one
+    party's instance vs another party's instance of the same kind)
+  - The conversation legitimately covers multiple distinct topics
+
+DO NOT force-cluster just because scene cards are sequential. Anaphora is a
+LANGUAGE pattern (pronoun referencing) — only group when the signals say
+"same entity," not "same conversation."
+
+── CANONICAL NAME (the canonical_name field) ────────────────────────────────
+The canonical_name is the project segment of the strict label rule
+{project}_{type}_{concept}. Constraints:
+  - lowercase, hyphens-only (NO underscores — underscores separate label
+    DIMENSIONS, not words within a segment)
+  - 2-5 words separated by hyphens
+  - Use the MOST SPECIFIC name available across the scene cards: prefer a
+    specific name over a generic back-reference — the specific one carries
+    information, the generic one doesn't
+  - If multiple scene cards agree on a specific name, use that
+  - If all scene cards use generic names, synthesize the most specific name
+    you can defend from the scope descriptions and the signals present
+
+YOU pick the name. Do not return a bare generic noun just because that's what
+some scene cards said — those are anaphoric forms, not the canonical name.
+
+── EVIDENCE (the evidence field — REQUIRED per cluster) ─────────────────────
+For each cluster you emit, populate evidence.{shared_technologies,
+shared_entities, shared_concepts} with the OBSERVED OVERLAPS that made you
+cluster these mentions. Empty arrays are valid when no overlap exists for
+that dimension. But at least one of the three should be non-empty for a
+real cluster (otherwise there's no evidence).
+
+── REASONING (the reasoning field — REQUIRED per cluster) ───────────────────
+For each cluster, the reasoning field MUST:
+  1. Name which turns are in this cluster
+  2. Name SPECIFIC overlap signals you used (the shared technologies,
+     the anaphoric naming pattern, etc.)
+  3. Explain why mentions NOT in this cluster were excluded (when applicable)
+
+A reasoning that says only "these mentions are related" without naming
+specifics fails. Cite the concrete signals.
+
+── UNRESOLVED MENTIONS (the unresolved_mentions field — OPTIONAL) ──────────
+If a turn's scene card is too thin or ambiguous to confidently assign to any
+cluster, list it in unresolved_mentions instead of force-fitting. The caller
+will decide whether to flag for review or fall back to per-turn naming.
+
+── OUTPUT ───────────────────────────────────────────────────────────────────
+Return a JSON object matching this SHAPE (placeholders show structure only —
+fill every field from the actual scene cards, do not echo these labels):
+  {
+    "clusters": [
+      {
+        "canonical_name": "<specific-hyphenated-name-you-chose>",
+        "mentions": [
+          { "turn_number": <n>, "scope_project_name": "<what that turn called it>", "item_ids": ["item_T<n>_<id>", ...] }
+        ],
+        "evidence": {
+          "shared_technologies": ["<observed overlapping tool/tech/method names>"],
+          "shared_entities":     ["<observed shared people/orgs>"],
+          "shared_concepts":     ["<observed shared concept tags>"]
+        },
+        "reasoning": "<which turns; the SPECIFIC overlap signals used; why excluded mentions were excluded>"
+      }
+    ],
+    "unresolved_mentions": [],
+    "arc_resolve_reasoning": "<one line: single- vs multi-entity arc, and why>"
+  }`;
+const ARC_ENTITY_RESOLVE_SCHEMA = {
+    type: "object",
+    properties: {
+        clusters: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    canonical_name: { type: "string" },
+                    mentions: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                turn_number: { type: "integer" },
+                                scope_project_name: { type: "string" },
+                                item_ids: { type: "array", items: { type: "string" } },
+                            },
+                            required: ["turn_number", "scope_project_name", "item_ids"],
+                        },
+                    },
+                    evidence: {
+                        type: "object",
+                        properties: {
+                            shared_technologies: { type: "array", items: { type: "string" } },
+                            shared_entities: { type: "array", items: { type: "string" } },
+                            shared_concepts: { type: "array", items: { type: "string" } },
+                        },
+                        required: ["shared_technologies", "shared_entities", "shared_concepts"],
+                    },
+                    reasoning: { type: "string" },
+                },
+                required: ["canonical_name", "mentions", "evidence", "reasoning"],
+            },
+        },
+        unresolved_mentions: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    turn_number: { type: "integer" },
+                    scope_project_name: { type: "string" },
+                    item_ids: { type: "array", items: { type: "string" } },
+                },
+                required: ["turn_number", "scope_project_name", "item_ids"],
+            },
+        },
+        arc_resolve_reasoning: { type: "string" },
+    },
+    required: ["clusters"],
+};
+export function buildArcEntityResolveInput(ctx) {
+    const header = `[ARC ENTITY RESOLVE — agent_id=${ctx.agent_id}, ${ctx.turns.length} turn(s)]
+This is ONE continuous conversation arc. Identify entities across turns and
+group anaphoric mentions. Pick canonical names following strict naming rule.
+`;
+    const sections = [header];
+    for (const turn of ctx.turns) {
+        let pass01 = null;
+        try {
+            pass01 = turn.pass01_output_json ? JSON.parse(turn.pass01_output_json) : null;
+        }
+        catch { /* malformed */ }
+        const sc = pass01?.scene_card ?? {};
+        const scopeName = sc.scope_project?.name ?? "(no scope project)";
+        const scopeDesc = sc.scope_project?.scope ?? "";
+        const projects = Array.isArray(sc.projects) ? sc.projects : [];
+        const technologies = Array.isArray(sc.technologies) ? sc.technologies : [];
+        const people = Array.isArray(sc.people) ? sc.people : [];
+        const items = Array.isArray(pass01?.items) ? pass01.items : [];
+        // Mirror the arc-prefix id convention from buildArcConsolidatedInput so
+        // the LLM emits matching item_ids (Pass 3 joins on these later).
+        const itemIds = items.map((it) => {
+            const cleanId = String(it.id ?? '').replace(/^item_/, '') || '?';
+            return `item_T${turn.turn_number}_${cleanId}`;
+        });
+        sections.push(`[TURN ${turn.turn_number}${turn.turn_name ? ` — ${turn.turn_name}` : ''}]
+Scope project:    ${scopeName}${scopeDesc ? ` — "${scopeDesc}"` : ''}
+Projects:         ${projects.length === 0 ? "(none)" : projects.map(p => `${p.name}${p.scope ? ` ("${p.scope}")` : ''}`).join(", ")}
+Technologies:     ${technologies.length === 0 ? "(none)" : technologies.map(t => t.name).join(", ")}
+People/Actors:    ${people.length === 0 ? "(none)" : people.map(p => `${p.name} (${p.role})`).join(", ")}
+Item IDs:         ${itemIds.length === 0 ? "(none)" : itemIds.join(", ")}`);
+    }
+    return sections.join("\n\n");
+}
+export async function runArcEntityResolve(opts) {
+    if (opts.disabled) {
+        console.log("[arc-entity-resolve] skipped (disabled flag)");
+        return undefined;
+    }
+    if (opts.turns.length === 0) {
+        console.warn("[arc-entity-resolve] no turns to resolve — returning empty result");
+        return { clusters: [], unresolved_mentions: [] };
+    }
+    if (!opts.provider.isAvailable()) {
+        console.warn("[arc-entity-resolve] provider unavailable — degrading (Pass 3 will use per-turn names)");
+        return undefined;
+    }
+    const userInput = buildArcEntityResolveInput({ agent_id: opts.agent_id, turns: opts.turns });
+    const r = await opts.provider.generateStructured(ARC_ENTITY_RESOLVE_PROMPT, userInput, ARC_ENTITY_RESOLVE_SCHEMA, {
+        thinkingBudget: getThinkingBudget(2048),
+        maxOutputTokens: 16384,
+        modelOverride: STAGE_C_MODEL_OVERRIDE ?? undefined,
+    });
+    // Telemetry — own slot per debt-4 §3
+    if (r.usage) {
+        reflectTokenStats.pass_c_resolve.input += r.usage.input ?? 0;
+        reflectTokenStats.pass_c_resolve.thinking += r.usage.thinking ?? 0;
+        reflectTokenStats.pass_c_resolve.output += r.usage.output ?? 0;
+    }
+    reflectTokenStats.pass_c_resolve.calls += 1;
+    if (!r.result) {
+        const reason = r.rateLimited ? "rate limited" : "failed";
+        console.warn(`[arc-entity-resolve] LLM call ${reason} — degrading (Pass 3 will use per-turn names) [${opts.provider.getName()}]`);
+        return undefined;
+    }
+    // Map raw LLM output → typed ArcEntityResolveResult. We trust the schema
+    // validator + sanitize defensively (LLM may emit extra fields the schema
+    // doesn't reject; we ignore them).
+    const clusters = (r.result.clusters ?? []).map(c => {
+        const mentions = (c.mentions ?? []).map(m => {
+            const sourceTurn = opts.turns.find(t => t.turn_number === m.turn_number);
+            return {
+                turn_id: sourceTurn?.id ?? `unknown_turn_${m.turn_number}`,
+                turn_number: m.turn_number,
+                scope_project_name: m.scope_project_name ?? "",
+                item_ids: Array.isArray(m.item_ids) ? m.item_ids : [],
+            };
+        });
+        return {
+            canonical_name: c.canonical_name ?? "",
+            mentions,
+            evidence: {
+                shared_technologies: c.evidence?.shared_technologies ?? [],
+                shared_entities: c.evidence?.shared_entities ?? [],
+                shared_concepts: c.evidence?.shared_concepts ?? [],
+            },
+            reasoning: c.reasoning ?? "",
+        };
+    });
+    const unresolved = (r.result.unresolved_mentions ?? []).map(m => {
+        const sourceTurn = opts.turns.find(t => t.turn_number === m.turn_number);
+        return {
+            turn_id: sourceTurn?.id ?? `unknown_turn_${m.turn_number}`,
+            turn_number: m.turn_number,
+            scope_project_name: m.scope_project_name ?? "",
+            item_ids: Array.isArray(m.item_ids) ? m.item_ids : [],
+        };
+    });
+    console.log(`[arc-entity-resolve] resolved ${clusters.length} cluster(s), ${unresolved.length} unresolved mention(s) [${opts.provider.getName()}]`);
+    return {
+        clusters,
+        unresolved_mentions: unresolved,
+        arc_resolve_reasoning: r.result.arc_resolve_reasoning,
+        // Provider trail — buildCostBreakdown reads these to bill Stage C in
+        // its own pass_c_resolve slot (mirror of 742f50d pass5 own-slot fix).
+        model: r.model,
+        attempts: r.attempts,
+    };
+}
+export function applyArcEntityCanonicalNames(items, resolution) {
+    // Degrade path — no resolution available
+    if (!resolution || resolution.clusters.length === 0) {
+        return {
+            items,
+            renamed_count: 0,
+            clusters_used: 0,
+            unmatched_item_ids: items.map(i => i.id),
+        };
+    }
+    // Build item_id → canonical_name map. If the same item_id appears in
+    // multiple clusters (shouldn't happen, but defensive), the first wins.
+    const idToCanonical = new Map();
+    const clustersUsedSet = new Set();
+    for (const cluster of resolution.clusters) {
+        for (const mention of cluster.mentions) {
+            for (const itemId of mention.item_ids) {
+                if (!idToCanonical.has(itemId)) {
+                    idToCanonical.set(itemId, cluster.canonical_name);
+                }
+            }
+        }
+    }
+    const unmatched = [];
+    let renamedCount = 0;
+    const out = items.map(item => {
+        const canonical = idToCanonical.get(item.id);
+        if (!canonical) {
+            unmatched.push(item.id);
+            return item;
+        }
+        if (canonical === item.project) {
+            // Already named correctly — count as cluster_used but not as rename
+            clustersUsedSet.add(canonical);
+            return item;
+        }
+        // Overwrite project. Shallow copy preserves all other fields.
+        renamedCount++;
+        clustersUsedSet.add(canonical);
+        return { ...item, project: canonical };
+    });
+    return {
+        items: out,
+        renamed_count: renamedCount,
+        clusters_used: clustersUsedSet.size,
+        unmatched_item_ids: unmatched,
+    };
+}
+//# sourceMappingURL=arc-entity-resolve.js.map

package/dist/middleware/reflect/arc-entity-resolve.js.map

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

package/dist/middleware/reflect/arc-inactivity-timer.d.ts

@@ -0,0 +1,47 @@
+import type { WorkspaceDB } from "../../store/database.js";
+/**
+ * Run one inactivity check. For each stale agent, fire arc extraction with
+ * trigger_source='inactivity'. Per-agent failures are logged but don't stop
+ * the tick. Exported so tests can drive it directly without setInterval.
+ */
+export declare function runInactivityTick(db: WorkspaceDB, thresholdMs?: number): Promise<{
+    checked: number;
+    extracted: number;
+    skipped_in_progress: number;
+    skipped_rate_limited: number;
+    skipped_min_range: number;
+    errors: number;
+}>;
+/**
+ * Start the inactivity check timer. Idempotent — calling twice is a no-op
+ * after the first call. Honor the enabled flag — if off, do nothing.
+ * Returns true if the timer started, false if it was disabled or already running.
+ */
+export declare function startArcInactivityTimer(db: WorkspaceDB): boolean;
+/**
+ * One-shot BOOT SWEEP — recover arcs stranded by a restart.
+ *
+ * The per-turn auto-trigger fires arc extraction fire-and-forget, so a restart
+ * mid-extraction kills it and leaves the turns `pass01_done` with nothing to
+ * re-trigger them. Without this they wait up to the full inactivity threshold
+ * (default 30 min) — or forever if the inactivity timer is off.
+ *
+ * After a short settle delay this runs ONE inactivity-style tick using the delay
+ * itself as the idle window, so it sweeps turns that were already sitting at boot
+ * but NOT a conversation that resumed afterwards (those are < delay old and the
+ * normal auto-trigger owns them). Distinct from the proactive inactivity timer:
+ * this is restart RECOVERY, so it's gated only on arc mode being on — a user who
+ * turned off the 30-min inactivity sweep still doesn't want a restart to strand
+ * captured turns. Off-switch: NODEDEX_ARC_BOOT_SWEEP=off. runArcExtraction's own
+ * in-flight + rate guards keep it from racing a live trigger.
+ */
+export declare function startBootArcSweep(db: WorkspaceDB): boolean;
+/**
+ * Stop the inactivity check timer. Used on shutdown + by tests.
+ */
+export declare function stopArcInactivityTimer(): void;
+/**
+ * For tests only — reports whether the timer is currently running.
+ */
+export declare function _isArcInactivityTimerRunningForTests(): boolean;
+//# sourceMappingURL=arc-inactivity-timer.d.ts.map

package/dist/middleware/reflect/arc-inactivity-timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arc-inactivity-timer.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/arc-inactivity-timer.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAuB3D;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,WAAW,GAAE,MAAyB,GAAG,OAAO,CAAC;IACxG,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAoCD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAoBhE;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAe1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C;AAED;;GAEG;AACH,wBAAgB,oCAAoC,IAAI,OAAO,CAE9D"}