nodedex 0.1.0

package/dist/middleware/reflect/pass2c.js

@@ -0,0 +1,360 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// PASS 2c — WIRE CAUSALITY  (Week 3 piece, debt #1, 2026-05-25)
+//
+// Role:  The third of three sub-passes in the Pass 2 split (see
+//        docs/PASS2-SPLIT-DESIGN.md §2 Pass ownership). Takes the items 2a
+//        classified and 2b filled, and decides their causal wiring:
+//        triggered_by (counterfactual), based_on (evidence), and semantic
+//        relations (contradicts / supports / resolves). BATCH visibility:
+//        a single LLM call sees all items at once because Q3/Q5 reason
+//        about pairs.
+//
+// What this pass DOES (§2 ownership):
+//   - Q3 TRIGGERED_BY — counterfactual wiring, circularity guard,
+//     REPLACEMENTS rule, HIERARCHY-level wiring rule
+//   - Q4 BASED_ON — evidence wiring
+//   - Q5 SEMANTIC RELATIONS — contradicts / supports / resolves
+//     (Parity note: design §2 also lists `derived_from` + `affects`, but the
+//      monolith pass2.ts Q5 emits ONLY the three above. Per §4 parity rule,
+//      pass2c mirrors monolith Q5 EXACTLY; extending Q5 to 5 relation types
+//      is a deliberate follow-up change, not part of this split.)
+//
+// What this pass does NOT do (anti-examples, §2 + Seam β contract):
+//   - Touch `type`, `unique`, `text`, `id`, `project`, or any other field
+//     written by 2a/2b — all READ-ONLY per §1 Seam β contract
+//   - Reclassify (a model that wants to re-type must FAIL back, not mutate)
+//   - Dedup — 2a already did Q0
+//   - Emit `skipped[]` — items reach 2c only if they survived 2a + Seam α
+//   - Validate the type↔unique{} schema — Tier 1B at Seam α did that pre-2c
+//   - Touch other PROJECT GRAPH blocks via writes — read-only, the orchestrator
+//     in pipeline.ts owns relation writes (this just RETURNS the wiring decisions)
+//
+// Status:
+//   - Standalone file. NOT wired into pipeline.ts yet (next step:
+//     composeForDownstream() then pipeline.ts behind NODEDEX_PASS2_SPLIT=1).
+//   - `pass2.ts` is FROZEN per §4. This file does NOT replace it.
+//
+// Charter alignment:
+//   - Rule 6 (guards catch failure, never override success): sanitizer strips
+//     forbidden output keys (anything outside the wiring bundle) and filters
+//     relation `type`s to the monolith-parity allowed set. A pass2c that emits
+//     less is fine; a pass2c that smuggles new shape into downstream is not.
+//   - Rule 7 (determinism is local): sanitizer + schema are pure code;
+//     judgment (which pairs are causally linked) is the LLM's.
+//   - Rule 9 (bugs live at seams): the Seam β contract that 2c MUST NOT mutate
+//     read-only fields is enforced STRUCTURALLY by `snapshotForSeamBeta` +
+//     `checkSeamBetaInvariant` in pass2-seams.ts — pass2c's output shape here
+//     is designed so the read-only fields are not even in the schema.
+//   - Rule 14 (store the path): one item ↔ one wiring bundle. The wiring
+//     decisions pass2c made for an item are ONE conceptual record;
+//     `Pass2cItemWiring` stores them as one unit, not split across arrays.
+// ═══════════════════════════════════════════════════════════════════════════════
+import { CONFIG } from "./config.js";
+// ─── Prompt ────────────────────────────────────────────────────────────────────
+//
+// Carved from PASS2_PROMPT in pass2.ts CAUSAL WIRING section (Q3 + Q4 + Q5
+// verbatim, lines 167-189 in the monolith). Sections REMOVED per §2:
+//   - Q0 DEDUP (2a)
+//   - Q1 TYPE — 5 TESTs (2a)
+//   - Q2 HIERARCHY (2a)
+//   - PROJECT ATTRIBUTION (2a)
+//   - SUPERSEDES_REF (2a; passed through as context)
+//   - REVIEW FLAGS (2a)
+//   - CLASSIFICATION REASONING (2a; passed through as context)
+//   - UNIQUE FIELDS section (2b)
+//   - NOVEL TYPE (2a)
+//
+// STATE CONVENTION preserved (Q5 references PROJECT GRAPH for cross-batch
+// relations; the same "state = text in marked regions" discipline applies).
+// SCENE CARD CONTEXT pared to just the CAUSAL LINKS note (Q3 still uses it;
+// APPROACHES/UNCHANGED/TASKS were 2a-only signals).
+//
+// Top framing adds Seam β read-only callout — explicit guard against the
+// model "fixing" what it thinks 2a got wrong by emitting new type/unique
+// fields. The sanitizer + Seam β invariant check are the structural backup.
+export const PASS2C_PROMPT = `You receive classified items from Pass 2a (type, project, refs)
+already filled by Pass 2b (unique{}). Your ONE job: wire causal relations
+between these items (and to existing blocks in PROJECT GRAPH).
+
+── SEAM β CONTRACT — READ-ONLY ─────────────────────────────────────────────
+DO NOT change any item's type. DO NOT touch unique{} fields. DO NOT change
+text, id, project, supersedes_ref, resolved_ref, or extends_item. DO NOT add
+or remove items. DO NOT emit skipped[]. DO NOT re-dedup (Pass 2a did Q0).
+DO NOT re-classify (Pass 2a did Q1). If you think 2a or 2b got something
+wrong, EMIT ONLY YOUR WIRING DECISIONS anyway — the seam validator will
+catch the mismatch.
+
+── STATE CONVENTION ─────────────────────────────────────────────────────────
+"State" in this prompt = text in marked regions below (PROJECT GRAPH, SCENE
+CARD, ITEMS). Your training knowledge and "what's commonly known about this
+domain" are NOT state. A causal link to an existing block is valid ONLY if a
+block in PROJECT GRAPH has that exact label.
+
+For EACH item: walk Q3 → Q4 → Q5 in order.
+
+── Q3: TRIGGERED_BY — "In a world where (X) didn't happen, would (Y) still have occurred?"
+  YES → no link. NO → X goes in triggered_by.
+  UNCERTAIN → no link. Wrong wiring (false narrative) costs more than missing wiring (recoverable).
+  CIRCULARITY GUARD: before adding A→B, check "Did I already put B→A?" YES → skip.
+  Use item IDs for batch, block labels for PROJECT GRAPH. Genesis → triggered_by: [].
+  REPLACEMENTS "X→Y": dead_end for X is triggered_by the decision that adopted Y.
+  HIERARCHY: "Did cause make the DECISION necessary, or only this mechanism?"
+    Decision → triggered_by on parent. Mechanism only → triggered_by on child.
+
+── Q4: BASED_ON — "Would this claim be UNSUPPORTED without that specific finding?"
+  NO → no link. YES → based_on.
+  UNCERTAIN → no link. False evidence link costs more than missing one.
+  Applies to conclusions, decisions justified by findings.
+
+── Q5: SEMANTIC RELATIONS — for each item pair in this batch:
+  "Does (X) directly contradict, support, or answer (Y)?"
+  contradicts: opposite claims about the same specific thing.
+  supports: independent evidence strengthening the same claim.
+  resolves: (X) answers the question or settles the hypothesis (Y) poses.
+  Use ONLY these three relation types. Other relation kinds are emitted by
+  other passes (e.g. supersedes, extends, derived_from) — do not emit them here.
+
+  PER-RELATION REASONING: every emitted relation MUST carry a reasoning field
+  that NAMES the case (contradicts / supports / resolves) AND CITES the specific
+  claim from each item that grounded the decision — e.g. a contradicts entry
+  should read "contradicts: item_5 claims X always Y; item_9 reports X did not Y in case Z".
+  This is the audit trail downstream consumers (chains, agent inspection) read to
+  understand WHY this wire exists. A wire without grounded reasoning is corruption;
+  if you cannot cite a specific claim-pair, do not emit the relation.
+
+── SCENE CARD CONTEXT ──────────────────────────────────────────────────────
+CAUSAL LINKS in the scene card name explicit cause→effect pairs the agent
+stated in this session — use them as Q3 input.
+
+── OUTPUT ──────────────────────────────────────────────────────────────────
+For EACH item, emit one wiring entry: { id, triggered_by[], based_on[], relations[] }.
+Each entry in relations[] is { type, target, reasoning } — reasoning REQUIRED per
+Q5 (names the case + cites the claim-pair). Use [] (empty array) for any axis
+with no links — do not omit fields. The id MUST match an input item's id exactly.
+Do NOT emit wiring for items not in the input.
+
+`;
+// ─── Output schema ─────────────────────────────────────────────────────────────
+//
+// Mirrors `Pass2cResult` — { wiring: [{ id, triggered_by, based_on, relations }] }.
+// Read-only fields (type, unique, text, project, etc.) are deliberately ABSENT
+// so any leakage is visible in pass-log output. Per Seam β contract, structural
+// exclusion is the first line of defense; the sanitizer + Seam β invariant
+// check are deeper backstops.
+const PASS2C_SCHEMA = {
+    type: "object",
+    properties: {
+        wiring: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    triggered_by: { type: "array", items: { type: "string" } },
+                    based_on: { type: "array", items: { type: "string" } },
+                    relations: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                type: { type: "string" },
+                                target: { type: "string" },
+                                reasoning: { type: "string" }, // Q5 case + claim-pair evidence (per meaning-first)
+                            },
+                            required: ["type", "target", "reasoning"],
+                        },
+                    },
+                },
+                required: ["id", "triggered_by", "based_on", "relations"],
+            },
+        },
+    },
+    required: ["wiring"],
+};
+// ─── Sanitizers ────────────────────────────────────────────────────────────────
+//
+// Two structural guards (charter rule 6):
+//
+// (1) FORBIDDEN_KEYS — keys outside the wiring bundle that some model may
+//     leak (especially if it "corrects" type or unique{}). Stripped at sanitize
+//     time so the leakage never reaches downstream. Includes the read-only
+//     Seam β fields plus a few false-friends (skipped, classified) that exist
+//     in the monolith schema but have no place in 2c output.
+//
+// (2) ALLOWED_PASS2C_RELATION_TYPES — Q5 emits only contradicts / supports /
+//     resolves per monolith parity. Other relation types come from other
+//     passes (Pass 4 cross-session, post-process CHAIN_RELS) or other 2a/2b
+//     mechanisms (supersedes, extends). Filter to keep the split's "what each
+//     pass owns" boundary structural, not just prompted.
+const FORBIDDEN_KEYS_ON_PASS2C_OUTPUT = [
+    "type",
+    "unique",
+    "text",
+    "project",
+    "extends_item",
+    "supersedes_ref",
+    "resolved_ref",
+    "review_reason",
+    "classification_reasoning",
+    "schema",
+    "skipped",
+    "classified",
+    "note",
+];
+export const ALLOWED_PASS2C_RELATION_TYPES = new Set([
+    "contradicts",
+    "supports",
+    "resolves",
+]);
+/**
+ * Strip forbidden keys from a single wiring entry. Returns the cleaned wiring
+ * + the list of stripped keys (so callers can audit-log contract violations).
+ *
+ * If `triggered_by` / `based_on` / `relations` are missing, default to empty
+ * arrays (the schema requires them; this is defensive). If `relations` items
+ * have type values outside ALLOWED_PASS2C_RELATION_TYPES, those entries are
+ * dropped — reported in `strippedRelationTypes`.
+ */
+export function sanitizePass2cItem(raw) {
+    const stripped = [];
+    const cleaned = { ...raw };
+    for (const k of FORBIDDEN_KEYS_ON_PASS2C_OUTPUT) {
+        if (k in cleaned) {
+            stripped.push(k);
+            delete cleaned[k];
+        }
+    }
+    const id = typeof cleaned.id === "string" ? cleaned.id : String(cleaned.id ?? "");
+    const triggered_by = Array.isArray(cleaned.triggered_by)
+        ? cleaned.triggered_by.filter((x) => typeof x === "string" && x.trim() !== "")
+        : [];
+    const based_on = Array.isArray(cleaned.based_on)
+        ? cleaned.based_on.filter((x) => typeof x === "string" && x.trim() !== "")
+        : [];
+    // Relations: filter to allowed types, coerce target to string, default reasoning
+    // to empty string if the model omitted it (the schema requires it, but be
+    // defensive — a missing reasoning is a contract failure to log, not a crash).
+    const strippedRelationTypes = [];
+    const relations = [];
+    if (Array.isArray(cleaned.relations)) {
+        for (const r of cleaned.relations) {
+            if (!r || typeof r !== "object")
+                continue;
+            const rType = typeof r.type === "string" ? r.type : "";
+            const rTarget = typeof r.target === "string" ? r.target : String(r.target ?? "");
+            const rReasoning = typeof r.reasoning === "string" ? r.reasoning : "";
+            if (!rType || !rTarget.trim())
+                continue;
+            if (!ALLOWED_PASS2C_RELATION_TYPES.has(rType)) {
+                strippedRelationTypes.push(rType);
+                continue;
+            }
+            relations.push({ type: rType, target: rTarget, reasoning: rReasoning });
+        }
+    }
+    return {
+        item: { id, triggered_by, based_on, relations },
+        stripped,
+        strippedRelationTypes,
+    };
+}
+/**
+ * Sanitize the full pass2c result. Aggregates per-item stripped keys + relation
+ * types so the caller can log the contract-violation surface.
+ */
+export function sanitizePass2cResult(raw) {
+    const perItemStripped = [];
+    const perItemStrippedRelationTypes = [];
+    let totalStrippedFields = 0;
+    const wiring = (raw.wiring ?? []).map((w) => {
+        const { item, stripped, strippedRelationTypes } = sanitizePass2cItem(w);
+        if (stripped.length > 0) {
+            perItemStripped.push({ id: item.id, stripped });
+            totalStrippedFields += stripped.length;
+        }
+        if (strippedRelationTypes.length > 0) {
+            perItemStrippedRelationTypes.push({ id: item.id, types: strippedRelationTypes });
+        }
+        return item;
+    });
+    return {
+        result: { wiring },
+        totalStrippedFields,
+        perItemStripped,
+        perItemStrippedRelationTypes,
+    };
+}
+// ─── LLM call ──────────────────────────────────────────────────────────────────
+//
+// BATCH call (single LLM invocation for all items) — per §2, pass2c needs full
+// batch visibility because Q3 counterfactuals and Q5 semantic relations reason
+// about PAIRS. Per-item parallelism would lose that visibility.
+//
+// Signature mirrors callPass2aLLM as far as practical so wiring code can
+// uniformly route between sub-passes. Returns usage + sanitization stats so
+// the caller can stamp the turn log without touching global state. Does NOT
+// update reflectTokenStats (wiring concern, deferred to pipeline.ts wiring step).
+export async function callPass2cLLM(provider, items, projectContext, thinkingBudget = 1024, sceneCard, 
+// Multi-model routing (C, 2026-05-25): 2c is semantic wiring — typically
+// the expensive-model slot (Gemini Flash/Pro) while 2a/2b go to Haiku.
+// Universal — provider-agnostic string. Undefined → use provider default.
+modelOverride) {
+    // Defensive: an empty batch is a valid (degenerate) input — emit empty wiring,
+    // skip the LLM. Spares cost on trivially-empty turns.
+    if (items.length === 0) {
+        return {
+            result: { wiring: [] },
+            thinking: "",
+            rateLimited: false,
+        };
+    }
+    const sceneCardSection = sceneCard
+        ? `SCENE CARD (CAUSAL LINKS name explicit cause→effect pairs from the session):\n${sceneCard}\n\n`
+        : "";
+    const projectSection = projectContext
+        ? `PROJECT GRAPH (existing blocks — use labels for cross-batch triggered_by/based_on/relations targets):\n${projectContext}\n\n`
+        : "";
+    const itemsSection = `ITEMS:\n${JSON.stringify(items, null, 2)}`;
+    const userInput = `${sceneCardSection}${projectSection}${itemsSection}`;
+    const r = await provider.generateStructured(PASS2C_PROMPT, userInput, PASS2C_SCHEMA, {
+        thinkingBudget,
+        maxOutputTokens: CONFIG.pass2.maxOutputTokens,
+        ...(modelOverride ? { modelOverride } : {}),
+    });
+    if (!r.result) {
+        console.error(`Auto-Reflect Pass 2c: ${r.rateLimited ? "rate limited" : "failed"} [${provider.getName()}]`);
+        return {
+            result: null,
+            thinking: r.thinking ?? "",
+            rateLimited: r.rateLimited,
+            model: r.model,
+            attempts: r.attempts,
+        };
+    }
+    const { result: clean, totalStrippedFields, perItemStripped, perItemStrippedRelationTypes, } = sanitizePass2cResult(r.result);
+    const tag = provider.getName() !== "gemini" ? ` [${provider.getName()}]` : "";
+    console.log(`Auto-Reflect Pass 2c: wired ${items.length} items | tokens: in=${r.usage?.input ?? "?"} think=${r.usage?.thinking ?? "?"} out=${r.usage?.output ?? "?"}${tag}`);
+    if (totalStrippedFields > 0) {
+        console.log(`Auto-Reflect Pass 2c: SANITIZER stripped ${totalStrippedFields} forbidden field(s) across ${perItemStripped.length} item(s)`);
+        for (const s of perItemStripped) {
+            console.log(`  ${s.id}: removed ${s.stripped.join(", ")}`);
+        }
+    }
+    if (perItemStrippedRelationTypes.length > 0) {
+        console.log(`Auto-Reflect Pass 2c: SANITIZER dropped non-parity relation type(s) across ${perItemStrippedRelationTypes.length} item(s)`);
+        for (const s of perItemStrippedRelationTypes) {
+            console.log(`  ${s.id}: dropped relation types ${s.types.join(", ")}`);
+        }
+    }
+    return {
+        result: clean,
+        thinking: r.thinking ?? "",
+        rateLimited: r.rateLimited,
+        model: r.model,
+        attempts: r.attempts,
+        usage: r.usage,
+        strippedFields: perItemStripped.length > 0 ? perItemStripped : undefined,
+        strippedRelationTypes: perItemStrippedRelationTypes.length > 0 ? perItemStrippedRelationTypes : undefined,
+    };
+}
+//# sourceMappingURL=pass2c.js.map

package/dist/middleware/reflect/pass2c.js.map

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

package/dist/middleware/reflect/pass3-batch.d.ts

@@ -0,0 +1,62 @@
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { Pass2Item } from "./types.js";
+export declare function pass3BatchEnabled(): boolean;
+/**
+ * Pass 3 batch size = min(reliability bound, token bound).
+ *
+ * RELIABILITY bound (NODEDEX_PASS3_BATCH_SIZE, default 20): under the empirically-
+ * reliable ~25 (25 & 15 covered fully; 59 dropped ~half). This is THE cap on a
+ * big-cap model — its output budget is never the limit (20 blocks ≈ 6k vs Gemini's
+ * 65536), so a big-cap model always lands here.
+ *
+ * TOKEN bound (small-cap models only): a model with a small output ceiling (e.g.
+ * claude-3.5-sonnet 8192) can hit that ceiling BEFORE the reliability bound, so scale
+ * the batch down to keep (batchSize × ~tokens/block + thinking) under the ceiling.
+ * `model` undefined → the provider default (assumed big-cap) → the flat bound. Pairs
+ * with the openai.ts per-model ceiling CLAMP (which already prevents the over-request
+ * glitch); this just reduces the truncation-retries that clamp would otherwise cause
+ * on a small-cap model. Pure (reads env + KNOWN_CAPS).
+ */
+export declare function pass3BatchSize(model?: string, thinkingBudget?: number): number;
+type Pass3Analysis = {
+    project_creates?: any[];
+    new_blocks?: any[];
+    updates?: any[];
+    skip_reasons?: any[];
+};
+/** Merge per-chunk Pass-3 analyses into ONE analysis the save loop consumes unchanged.
+ *  new_blocks/updates/skip_reasons concatenate (item ids are globally unique → no
+ *  collision); project_creates DEDUP by label (two chunks of a fresh project each coin
+ *  the same root). Pure / testable. */
+export declare function mergePass3Analyses(parts: Array<Pass3Analysis | null | undefined>): Pass3Analysis;
+/** Split items into chunks of at most `size`. Pure / testable. */
+export declare function chunkItems<T>(items: T[], size: number): T[][];
+type Pass3Result = {
+    analysis: any;
+    geminiThinking: string;
+    rateLimited: boolean;
+    model?: string;
+    attempts?: Array<{
+        model: string;
+        outcome: string;
+    }>;
+};
+/**
+ * Batched Pass 3 — drop-in for callPass3LLM. Delegates to a single call when the flag
+ * is off OR the item count fits one call; otherwise chunks → per-chunk callPass3LLM
+ * (sequential, sharing the same graph snapshot) → mergePass3Analyses. Sequential (not
+ * parallel) to stay gentle on rate limits — the chunks are independent reads of the
+ * same snapshot, so order does not change correctness (cross-chunk links wire at save).
+ */
+export declare function callPass3Batched(provider: LLMProvider, classified: Pass2Item[], knownRoots: Array<{
+    label: string;
+    essence: string;
+}>, projectContext: string, agentSavedBlocks: Array<{
+    id: string;
+    label: string;
+    type: string;
+    essence: string;
+    unique: Record<string, any>;
+}>, thinkingBudget?: number, duplicateAlerts?: string, itemContext?: Record<string, string>, batchSize?: number): Promise<Pass3Result>;
+export {};
+//# sourceMappingURL=pass3-batch.d.ts.map

package/dist/middleware/reflect/pass3-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass3-batch.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/pass3-batch.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,cAAc,SAAO,GAAG,MAAM,CAO5E;AAED,KAAK,aAAa,GAAG;IACnB,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;CACtB,CAAC;AAEF;;;uCAGuC;AACvC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,aAAa,CAgBhG;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAK7D;AAED,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,GAAG,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAAC,EAClH,cAAc,SAAO,EACrB,eAAe,SAAK,EACpB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACxC,SAAS,SAAwD,GAChE,OAAO,CAAC,WAAW,CAAC,CAgCtB"}

package/dist/middleware/reflect/pass3-batch.js

@@ -0,0 +1,139 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// PASS 3 — BATCHED WRITE (the back-half scale fix; 2026-06-14)
+// ═══════════════════════════════════════════════════════════════════════════════
+//
+// WHY: Pass 3 writes EVERY block in ONE LLM call. The model reliably covers ~25
+// items; past that it returns a syntactically-valid but INCOMPLETE response
+// (live: 59 items → only 28 covered, using 5751/65536 output tokens = 9% of budget).
+// So it is NOT a token ceiling — it is the model giving up on a too-long item list.
+// Per-group fixed the same failure at the FRONT (COMPREHEND); this fixes it at the
+// BACK (the write).
+//
+// HOW: split `classified` into chunks of ~N (default 20, safely under the proven-good
+// 25), run callPass3LLM per chunk against the SAME existing-graph snapshot, then MERGE
+// the per-chunk analyses into the ONE analysis shape the save loop already consumes.
+// The merge is safe because:
+//   - item ids are globally unique across the arc → from_item_id stays unique → the
+//     save loop's itemIdToLabel map is consistent → cross-CHUNK triggered_by/based_on
+//     resolve SERVER-SIDE (pipeline.ts:1772+), with pendingTriggeredBy for forward refs;
+//   - Pass 2 already owns cross-item dedup (Pass 3 only checks label collision) → no
+//     dedup is lost by not showing chunks each other;
+//   - novel cross-chunk links the per-chunk LLM couldn't see are swept by Pass 4.
+//
+// DROP-IN: callPass3Batched has the SAME signature + return shape as callPass3LLM and,
+// when the flag is OFF or the item count is ≤ batch size, simply DELEGATES to it — so
+// the default path is byte-identical to today. Default OFF: NODEDEX_PASS3_BATCH=1.
+import { intFromEnv, modelForPass } from "./config.js";
+import { modelOutputCeiling } from "../../engine/providers/model-caps.js";
+import { callPass3LLM } from "./pass3.js";
+// Default ON (promoted 2026-06-14 — validated: bounds the last unbounded write pass);
+// set NODEDEX_PASS3_BATCH=0 to opt out (single-call write, byte-identical for small sets).
+export function pass3BatchEnabled() {
+    return process.env.NODEDEX_PASS3_BATCH !== "0";
+}
+// Heuristic visible-output tokens per Pass-3 block (~300 observed: "20 blocks ≈ 6k"
+// + headroom for dense unique{}/relations). Used ONLY to keep a batch from
+// over-requesting a SMALL-CAP model's output ceiling; a big-cap model fits the flat
+// default many times over so this never lowers it there.
+const PASS3_OUTPUT_TOKENS_PER_BLOCK = 400;
+/**
+ * Pass 3 batch size = min(reliability bound, token bound).
+ *
+ * RELIABILITY bound (NODEDEX_PASS3_BATCH_SIZE, default 20): under the empirically-
+ * reliable ~25 (25 & 15 covered fully; 59 dropped ~half). This is THE cap on a
+ * big-cap model — its output budget is never the limit (20 blocks ≈ 6k vs Gemini's
+ * 65536), so a big-cap model always lands here.
+ *
+ * TOKEN bound (small-cap models only): a model with a small output ceiling (e.g.
+ * claude-3.5-sonnet 8192) can hit that ceiling BEFORE the reliability bound, so scale
+ * the batch down to keep (batchSize × ~tokens/block + thinking) under the ceiling.
+ * `model` undefined → the provider default (assumed big-cap) → the flat bound. Pairs
+ * with the openai.ts per-model ceiling CLAMP (which already prevents the over-request
+ * glitch); this just reduces the truncation-retries that clamp would otherwise cause
+ * on a small-cap model. Pure (reads env + KNOWN_CAPS).
+ */
+export function pass3BatchSize(model, thinkingBudget = 4096) {
+    const flat = intFromEnv("NODEDEX_PASS3_BATCH_SIZE", 20);
+    if (!model)
+        return flat;
+    const outBudget = modelOutputCeiling(model) - thinkingBudget;
+    if (outBudget <= PASS3_OUTPUT_TOKENS_PER_BLOCK)
+        return 1; // tiny ceiling — one block per call
+    const tokenBound = Math.floor(outBudget / PASS3_OUTPUT_TOKENS_PER_BLOCK);
+    return Math.max(1, Math.min(flat, tokenBound));
+}
+/** Merge per-chunk Pass-3 analyses into ONE analysis the save loop consumes unchanged.
+ *  new_blocks/updates/skip_reasons concatenate (item ids are globally unique → no
+ *  collision); project_creates DEDUP by label (two chunks of a fresh project each coin
+ *  the same root). Pure / testable. */
+export function mergePass3Analyses(parts) {
+    const new_blocks = [];
+    const updates = [];
+    const skip_reasons = [];
+    const projByLabel = new Map();
+    for (const p of parts) {
+        if (!p)
+            continue;
+        for (const b of p.new_blocks ?? [])
+            new_blocks.push(b);
+        for (const u of p.updates ?? [])
+            updates.push(u);
+        for (const s of p.skip_reasons ?? [])
+            skip_reasons.push(s);
+        for (const pc of p.project_creates ?? []) {
+            const k = String(pc?.label ?? "").trim();
+            if (k && !projByLabel.has(k))
+                projByLabel.set(k, pc);
+        }
+    }
+    return { project_creates: [...projByLabel.values()], new_blocks, updates, skip_reasons };
+}
+/** Split items into chunks of at most `size`. Pure / testable. */
+export function chunkItems(items, size) {
+    if (size <= 0)
+        return [items];
+    const out = [];
+    for (let i = 0; i < items.length; i += size)
+        out.push(items.slice(i, i + size));
+    return out;
+}
+/**
+ * Batched Pass 3 — drop-in for callPass3LLM. Delegates to a single call when the flag
+ * is off OR the item count fits one call; otherwise chunks → per-chunk callPass3LLM
+ * (sequential, sharing the same graph snapshot) → mergePass3Analyses. Sequential (not
+ * parallel) to stay gentle on rate limits — the chunks are independent reads of the
+ * same snapshot, so order does not change correctness (cross-chunk links wire at save).
+ */
+export async function callPass3Batched(provider, classified, knownRoots, projectContext, agentSavedBlocks, thinkingBudget = 4096, duplicateAlerts = "", itemContext = {}, batchSize = pass3BatchSize(modelForPass("pass3"), thinkingBudget)) {
+    if (!pass3BatchEnabled() || classified.length <= batchSize) {
+        return callPass3LLM(provider, classified, knownRoots, projectContext, agentSavedBlocks, thinkingBudget, duplicateAlerts, itemContext);
+    }
+    const chunks = chunkItems(classified, batchSize);
+    console.log(`Auto-Reflect Pass 3: batched write — ${classified.length} items in ${chunks.length} chunk(s) of ≤${batchSize}`);
+    const analyses = [];
+    let rateLimited = false;
+    let model;
+    let geminiThinking = "";
+    const attempts = [];
+    for (let i = 0; i < chunks.length; i++) {
+        const r = await callPass3LLM(provider, chunks[i], knownRoots, projectContext, agentSavedBlocks, thinkingBudget, duplicateAlerts, itemContext);
+        if (r.analysis)
+            analyses.push(r.analysis);
+        rateLimited = rateLimited || r.rateLimited;
+        if (!model)
+            model = r.model;
+        if (r.attempts)
+            attempts.push(...r.attempts);
+        if (r.geminiThinking)
+            geminiThinking += (geminiThinking ? "\n" : "") + r.geminiThinking;
+        const got = (r.analysis?.new_blocks?.length ?? 0) + (r.analysis?.skip_reasons?.length ?? 0) + (r.analysis?.updates?.length ?? 0);
+        console.log(`  [pass3-batch] chunk ${i + 1}/${chunks.length}: ${chunks[i].length} item(s) → ${got} accounted${r.rateLimited ? " (rate limited)" : ""}`);
+    }
+    // Every chunk failed (all null) → bubble up a null analysis so the existing
+    // re-queue path fires, exactly as a single failed call would.
+    if (analyses.length === 0) {
+        return { analysis: null, geminiThinking, rateLimited, model, attempts };
+    }
+    return { analysis: mergePass3Analyses(analyses), geminiThinking, rateLimited, model, attempts };
+}
+//# sourceMappingURL=pass3-batch.js.map

package/dist/middleware/reflect/pass3-batch.js.map

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

package/dist/middleware/reflect/pass3.d.ts

@@ -0,0 +1,23 @@
+import type { LLMProvider } from "../../engine/ai-provider.js";
+import type { Pass2Item } from "./types.js";
+export declare const PASS3_PROMPT: string;
+export declare function callPass3LLM(provider: LLMProvider, classified: Pass2Item[], knownRoots: Array<{
+    label: string;
+    essence: string;
+}>, projectContext: string, agentSavedBlocks: Array<{
+    id: string;
+    label: string;
+    type: string;
+    essence: string;
+    unique: Record<string, any>;
+}>, thinkingBudget?: number, duplicateAlerts?: string, itemContext?: Record<string, string>): Promise<{
+    analysis: any;
+    geminiThinking: string;
+    rateLimited: boolean;
+    model?: string;
+    attempts?: Array<{
+        model: string;
+        outcome: string;
+    }>;
+}>;
+//# sourceMappingURL=pass3.d.ts.map

package/dist/middleware/reflect/pass3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass3.d.ts","sourceRoot":"","sources":["../../../src/middleware/reflect/pass3.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8B5C,eAAO,MAAM,YAAY,QAkI4D,CAAC;AAkItF,wBAAsB,YAAY,CAChC,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAAC,EAClH,cAAc,SAAO,EACrB,eAAe,SAAK,EACpB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACvC,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmGhJ"}