pi-mega-compact 0.20.6 → 0.20.8

package/dist/config/vector-cortex.js

@@ -196,6 +196,18 @@ export const VC5B_ENABLED = () => sprintFlag("MEGACOMPACT_VC5B");
  * mirroring VC4A/VC4B/VC4C/VC5A/VC5B.
  */
 export const VC5C_ENABLED = () => sprintFlag("MEGACOMPACT_VC5C");
+/**
+ * VC6A — advanced closure optimization. Default ON. `MEGACOMPACT_VC6A=0`
+ * disables and is byte-identical to the predecessor (VC5C): the `optimizeClosure`
+ * transitive-reduction arithmetic STILL RUNS (it is PURE), but the
+ * `vector_cortex_closure_optimized` / `vector_cortex_closure_proof_rejected`
+ * events are never emitted and the dashboard closure diagnostics seam is
+ * suppressed. Flag OFF gates the reporter + dashboard seam, never the arithmetic,
+ * so flag-off outbound/predecessor golden bytes match exactly. This flag MUST
+ * also be a dashboard SETTINGS toggle (visible in config UI, never in
+ * EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C.
+ */
+export const VC6A_ENABLED = () => sprintFlag("MEGACOMPACT_VC6A");
 // ---------------------------------------------------------------------------
 // Breaker state machine constants (TRIAD_RESILIENCE.md §breaker).
 // Rolled numbers for one 60s window; VC0C consumes these at its breaker seam.

package/dist/config.js

@@ -114,4 +114,4 @@ export const NEW_UI = () => ragEnabled("MEGACOMPACT_NEW_UI");
 // default ON, `=0`/`_DISABLED` off. Re-exported from src/config/vector-cortex.ts
 // so root consumers share one source of truth.
 // ---------------------------------------------------------------------------
-export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";
+export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, VC6A_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";

package/dist/extensions/dashboard-server/api-contracts/vector-cortex-heal.js

@@ -0,0 +1,11 @@
+/**
+ * api-contracts/vector-cortex-heal.ts — VC6A+ heal API contracts.
+ *
+ * Extracted from vector-cortex.ts to keep both files under the 400-line
+ * extension soft limit. Owns the reader-only closure-optimization and
+ * restoration diagnostic views emitted by the heal sprint handlers.
+ *
+ * PREVENT-PI-004: type definitions only, no network code.
+ * PREVENT-011: no `any` type.
+ */
+export {};

package/dist/extensions/dashboard-server/route-dispatch.js

@@ -0,0 +1,102 @@
+/**
+ * dashboard-server/route-dispatch.ts — extracted from server.ts.
+ *
+ * The dispatch chain: each handler returns true if it ended the response.
+ * Extracted to keep server.ts under the 400-line extension soft limit
+ * (delegate-shell pattern: server.ts calls this and handles the static fallback).
+ *
+ * PREVENT-PI-004: local filesystem read only, no network.
+ * PREVENT-011: no `any` type.
+ */
+import { handleIndex, handleRepoIndex, handleEvents, handleGameState, handleGameScores, handlePerfSamples, handlePerf, handleAchievements, handleSessions, handleTopics, handleTurns, handleMaintenance, handleProviderCache, handleMemoryStatus, handleCacheStripes, handleSetupStatus, handleSetupDetect, handleSetupConfigure, handleMemoryMap, handleRaptorTree, handleRaptorBuildHistory, handleContextHealth, handleCachePoison, handleHealthSettings, handleEmbedderHealth, handleRagSettings, handleRagMetrics, handleModelThresholds, handleWiki, handleVectorCortexEvaluation, handleVectorCortexHealth, handleVectorCortexBreakersReset, handleVectorCortexLedger, handleVectorCortexTopology, handleVectorCortexQuery, handleVectorCortexShards, handleVectorCortexResidual, handleVectorCortexReconstruct, handleVectorCortexPlans, handleVectorCortexRender, handleVectorCortexRollout, handleVectorCortexClosureProof, } from "./routes.js";
+/**
+ * Dispatch a request through every registered route handler.
+ * Returns true if a handler claimed the request (ended the response).
+ */
+export function dispatchRoutes(req, res, ctx) {
+    if (handleIndex(req, res, ctx))
+        return true;
+    if (handleRepoIndex(req, res, ctx))
+        return true;
+    if (handleEvents(req, res, ctx))
+        return true;
+    if (handleGameState(req, res, ctx))
+        return true;
+    if (handleGameScores(req, res, ctx))
+        return true;
+    if (handlePerfSamples(req, res, ctx))
+        return true;
+    if (handlePerf(req, res, ctx))
+        return true;
+    if (handleAchievements(req, res, ctx))
+        return true;
+    if (handleSessions(req, res, ctx))
+        return true;
+    if (handleTopics(req, res, ctx))
+        return true;
+    if (handleTurns(req, res, ctx))
+        return true;
+    if (handleMaintenance(req, res, ctx))
+        return true;
+    if (handleProviderCache(req, res, ctx))
+        return true;
+    if (handleMemoryStatus(req, res, ctx))
+        return true;
+    if (handleCacheStripes(req, res, ctx))
+        return true;
+    if (handleSetupStatus(req, res, ctx))
+        return true;
+    if (handleSetupDetect(req, res, ctx))
+        return true;
+    if (handleSetupConfigure(req, res, ctx))
+        return true;
+    if (handleMemoryMap(req, res, ctx))
+        return true;
+    if (handleRaptorTree(req, res, ctx))
+        return true;
+    if (handleRaptorBuildHistory(req, res, ctx))
+        return true;
+    if (handleContextHealth(req, res, ctx))
+        return true;
+    if (handleCachePoison(req, res, ctx))
+        return true;
+    if (handleHealthSettings(req, res, ctx))
+        return true;
+    if (handleEmbedderHealth(req, res, ctx))
+        return true;
+    if (handleRagSettings(req, res, ctx))
+        return true;
+    if (handleRagMetrics(req, res, ctx))
+        return true;
+    if (handleModelThresholds(req, res, ctx))
+        return true;
+    if (handleWiki(req, res, ctx))
+        return true;
+    if (handleVectorCortexEvaluation(req, res, ctx))
+        return true;
+    if (handleVectorCortexHealth(req, res, ctx))
+        return true;
+    if (handleVectorCortexBreakersReset(req, res, ctx))
+        return true;
+    if (handleVectorCortexLedger(req, res, ctx))
+        return true;
+    if (handleVectorCortexTopology(req, res, ctx))
+        return true;
+    if (handleVectorCortexQuery(req, res, ctx))
+        return true;
+    if (handleVectorCortexShards(req, res, ctx))
+        return true;
+    if (handleVectorCortexResidual(req, res, ctx))
+        return true;
+    if (handleVectorCortexReconstruct(req, res, ctx))
+        return true;
+    if (handleVectorCortexPlans(req, res, ctx))
+        return true;
+    if (handleVectorCortexRender(req, res, ctx))
+        return true;
+    if (handleVectorCortexRollout(req, res, ctx))
+        return true;
+    if (handleVectorCortexClosureProof(req, res, ctx))
+        return true;
+    return false;
+}

package/dist/extensions/dashboard-server/routes-rag-settings-helpers.js

@@ -1,12 +1,4 @@
-/**
- * dashboard-server/routes-rag-settings-helpers.ts — SETTINGS inventory.
- *
- * The full catalog of user-adjustable MEGACOMPACT_* settings surfaced by the
- * dashboard Setup panel, grouped by category. Kept separate from the route
- * handler so the inventory can grow without bloating the handler file.
- *
- * PREVENT-011: no `any` type.
- */
+import { VECTOR_CORTEX_SETTINGS } from "./routes-rag-settings-vector-cortex.js";
 // Shorthand builders to keep the inventory terse and unambiguous.
 const boolFlag = (key, label, description, def, requiresLlm = false) => ({
     key,
@@ -90,6 +82,7 @@ export const SETTINGS = [
             boolDirect("MEGACOMPACT_MARK_ONLY_L1", "Mark Only L1", "L1 runs but does not collapse", false),
             boolDirect("MEGACOMPACT_MARK_ONLY_L2", "Mark Only L2", "L2 runs but does not collapse", false),
             boolDirect("MEGACOMPACT_MINILM", "MiniLM Embedder", "Use MiniLM instead of trigram", false),
+            boolDirect("MEGACOMPACT_DEDUP_AUDIT", "Dedup Audit Trail", "Append one events.log line per tier decision (which layer collapsed a region, onto what, at what similarity) to tune the thresholds below. Pure instrumentation — dedup behavior is identical either way.", true),
         ],
     },
     {
@@ -131,29 +124,7 @@ export const SETTINGS = [
             num("MEGACOMPACT_EMBEDDING_CHARS_PER_TOKEN", "Embedding Chars per Token", "Estimated characters per token used for embedder chunking size", 4, 1, 32),
         ],
     },
-    {
-        name: "Vector Cortex",
-        settings: [
-            boolDirect("MEGACOMPACT_VC0A", "VC0A Baseline Observability", "Structured evaluation observer (MetricEventV1 + latency histogram). OFF = mode C, byte-identical to predecessor.", true),
-            boolDirect("MEGACOMPACT_VC0B", "VC0B Replay Correctness", "ReplayCutV2 effective-cut (min of boundary-safe/commit/capture high-water + pair retreat + anchor floor) and M3 effective-cut-v2 migration. OFF = legacy capped replay, byte-identical.", true),
-            boolDirect("MEGACOMPACT_VC1A", "VC1A Canonical Byte Events", "EventV2 byte-authority ledger codec (original bytes + SHA-256, strict UTF-8, derived NFC) and canonical validator (EVT_DIGEST_MISMATCH / EVT_UTF8_TAG_INVALID / EVT_DUPLICATE_ID). OFF = mode C, transcript codec unchanged, byte-identical.", true),
-            boolDirect("MEGACOMPACT_VC1B", "VC1B Occurrence Ledger + Tool Identity", "Neutral occurrence ledger (LedgerReader/Writer/Admin + CompatJournalV1): per-session monotonic seq, tool result references one earlier call, uniqueness by (eventId,digest) only, and the M2 copy-validate-switch downgrade journal. OFF = mode C, ledger unwritten, byte-identical.", true),
-            boolDirect("MEGACOMPACT_VC0C", "VC0C Live Safety Envelope", "TriadResult/Breaker live circuit breaker (60s window, 20 attempts, 30s cooldown, 3 probes, 5min healthy residence) + durable spool before provider invocation; manual reset clears cooldown but never evidence. OFF = mode C, unchanged transcript, byte-identical.", true),
-            boolDirect("MEGACOMPACT_VC1C", "VC1C Cross-Language Conformance v2", "FixtureManifestV2 canonical manifest validator + DowngradeReport deterministic downgrade export + MinHashV2 exact big-integer signatures and the M4 copy/validate/switch minhash-v2 migration (seed table frozen, cross-language byte-exact). OFF = mode C, v1 sync dedup scan unchanged, byte-identical.", true),
-            boolDirect("MEGACOMPACT_VC2A", "VC2A Offline Model Runtime", "ModelManifestV1 digest-before-load ONNX runtime (opset17/batch1/max512) + asset-free trigram demotion. Asset path assets/vector-cortex/encoder-v1 is immutable/digest-pinned. OFF = mode C, byte-identical to predecessor.", true),
-            boolDirect("MEGACOMPACT_VC2B", "VC2B Multi-Head Encoder", "VectorSetV1 five L2-normalized heads (384/128/128/64/32) with head-calibration draft + asset-free trigram B (512d) and lexical C fallbacks, plus the per-head emit seam. OFF = mode C, no per-head vectors emitted, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC2C", "VC2C Encoder Qualification + Calibration", "QualifiedEncoderV1/CalibrationV1: calibration fit on the calibration split only (held-out labels prohibited) + atomic selection across MODEL_ASSET and per-head EVALUATION thresholds (any field failure demotes all of A). OFF = mode C, no qualification/calibration selection, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC3A", "VC3A Cortex Store", "Capability-gated derived cortex store (CortexReader/Writer/Admin + CortexRecordV1): additive, keyed (sourceHighWater, algorithmVersion, id), immutable records, deterministic generation rebuild + one root digest. OFF = mode C, no cortex records written, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC3B", "VC3B Deterministic Topology", "Deterministic cortical topology (TopologyV1/EdgeV1): per-(source,head) top-k=16/head calibrated-threshold edges, stable score-desc/then-target-ID sort, dependency directed + contradiction symmetric paired records, one stable generation digest. OFF = mode C, no topology graph built/emitted, predecessor-precise topology view, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC3C", "VC3C Topology Query + Router Invalidation", "TopologyQueryV1/RouterKeyV2 structured keys (length-delimited, unsigned-byte order, no prefix ambiguity), exact (session,generation) invalidation, stale-generation rejection (TOP_GENERATION_STALE), and the M6 router-generation-v2 copy/validate/switch migration. OFF = mode C, no structured router key / generation invalidation, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC4A", "VC4A Dual-Tier Shards", "SemanticShardV1/ExactShardV1/ShardManifestV1: partition a session ONLY at complete EventV2 boundaries; exact shards preserve every tool call/result pair, anchor and invalid UTF-8 event as original bytes (pairs never split across exact shards); manifest enforces disjoint sorted ranges + complete protected-span coverage. OFF = mode C, exact anchors/current transcript only, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC4B", "VC4B Residual Basis Parity", "Residual codec: orthonormal DCT-II basis + int16 block quantization + block-scoped exact correction stream + (9,6) Reed-Solomon parity shards with SHA-256 corruption detection; admission gates on encodedSize <= 95% of exact-compressed size. OFF = mode C, no residual artifact produced, byte-identical predecessor.", true),
-            boolDirect("MEGACOMPACT_VC4C", "VC4C Reconstruction Fidelity", "Conservative closure + source-order assembly + reconstruction validator: recursively closes dependencies and whole tool pairs to a fixed point, resolves contradictions by retaining the later exact source resolution, assembles spans solely by source range, and rejects missing anchors / split pairs / digest mismatch / unresolved contradiction. Mandatory token estimate is content-only and handed unchanged to VC5A. OFF = mode C, no closure/validator, byte-identical predecessor (VC4B).", true),
-            boolDirect("MEGACOMPACT_VC5A", "VC5A PromptDagV1 + Budgeted Planner", "Single-session DAG (PromptDagV1) + budgeted 0/1 portfolio planner: builds a stable Kahn-ordered DAG, computes the mandatory dependency/tool/anchor closure before optional selection, returns MANDATORY_CLOSURE_OVER_BUDGET with evidence preserved on overflow, and runs a utility-per-token portfolio that never exceeds the remaining budget. Framing is owned here, not in VC4C. OFF = byte-identical predecessor (VC4C).", true),
-            boolDirect("MEGACOMPACT_VC5B", "VC5B Validated Renderer + Provider Profiles", "Validated prompt renderer: replays VC5A's stable Kahn order verbatim, preserves exact tool bytes (PREVENT-PI-002), places compacted context via the host before_agent_start prepend seam — never role:system (PREVENT-PI-003) — and SHA-256 hashes the entire canonical outbound request before provider invocation. Unknown provider/model cleanly bypasses to the predecessor prompt path. OFF = byte-identical predecessor (VC5A).", true),
-            boolDirect("MEGACOMPACT_VC5C", "VC5C Live Graduated Rollout", "Live graduated rollout: deterministically hashes each session into a stable 10,000-bucket cohort and advances the exposure gate (1/5/25/50/100%) only after a 72h monotonic residency, a powered sample, >=10,000 events, and >=200 sessions — advancing ONE gate at a time. A hard causal/tool/anchor/exact failure freezes promotion and selects the pre-VC path. OFF = byte-identical predecessor (VC5B).", true),
-        ],
-    },
+    VECTOR_CORTEX_SETTINGS,
     {
         name: "Cost API",
         settings: [

package/dist/extensions/dashboard-server/routes-rag-settings-types.js

@@ -0,0 +1,11 @@
+/**
+ * dashboard-server/routes-rag-settings-types.ts — SETTINGS inventory contract.
+ *
+ * The shared shapes the settings inventory is built from. Extracted so the
+ * inventory can be split across sibling files (helpers.ts + the per-area groups)
+ * without either side importing the other's data — contract-first, per
+ * docs/ENGINEERING_PRACTICES.md.
+ *
+ * PREVENT-011: no `any` type.
+ */
+export {};

package/dist/extensions/dashboard-server/routes-rag-settings-vector-cortex.js

@@ -0,0 +1,44 @@
+/**
+ * dashboard-server/routes-rag-settings-vector-cortex.ts — Vector Cortex SETTINGS.
+ *
+ * The VC0A..VC5C chain flag inventory, split out of routes-rag-settings-helpers.ts
+ * to keep that file under the 400-line extensions/ soft limit. Every VC flag is a
+ * user-visible dashboard toggle (never in EXCLUDED_SETTINGS) per the chain spec,
+ * and each carries the long description the Setup panel renders as help text.
+ *
+ * PREVENT-011: no `any` type.
+ */
+const boolDirect = (key, label, description, def) => ({
+    key,
+    label,
+    description,
+    type: "boolean",
+    default: def,
+    disabledConvention: false,
+    requiresLlm: false,
+});
+/** The Vector Cortex chain flags, as one SETTINGS category. */
+export const VECTOR_CORTEX_SETTINGS = {
+    name: "Vector Cortex",
+    settings: [
+        boolDirect("MEGACOMPACT_VC0A", "VC0A Baseline Observability", "Structured evaluation observer (MetricEventV1 + latency histogram). OFF = mode C, byte-identical to predecessor.", true),
+        boolDirect("MEGACOMPACT_VC0B", "VC0B Replay Correctness", "ReplayCutV2 effective-cut (min of boundary-safe/commit/capture high-water + pair retreat + anchor floor) and M3 effective-cut-v2 migration. OFF = legacy capped replay, byte-identical.", true),
+        boolDirect("MEGACOMPACT_VC1A", "VC1A Canonical Byte Events", "EventV2 byte-authority ledger codec (original bytes + SHA-256, strict UTF-8, derived NFC) and canonical validator (EVT_DIGEST_MISMATCH / EVT_UTF8_TAG_INVALID / EVT_DUPLICATE_ID). OFF = mode C, transcript codec unchanged, byte-identical.", true),
+        boolDirect("MEGACOMPACT_VC1B", "VC1B Occurrence Ledger + Tool Identity", "Neutral occurrence ledger (LedgerReader/Writer/Admin + CompatJournalV1): per-session monotonic seq, tool result references one earlier call, uniqueness by (eventId,digest) only, and the M2 copy-validate-switch downgrade journal. OFF = mode C, ledger unwritten, byte-identical.", true),
+        boolDirect("MEGACOMPACT_VC0C", "VC0C Live Safety Envelope", "TriadResult/Breaker live circuit breaker (60s window, 20 attempts, 30s cooldown, 3 probes, 5min healthy residence) + durable spool before provider invocation; manual reset clears cooldown but never evidence. OFF = mode C, unchanged transcript, byte-identical.", true),
+        boolDirect("MEGACOMPACT_VC1C", "VC1C Cross-Language Conformance v2", "FixtureManifestV2 canonical manifest validator + DowngradeReport deterministic downgrade export + MinHashV2 exact big-integer signatures and the M4 copy/validate/switch minhash-v2 migration (seed table frozen, cross-language byte-exact). OFF = mode C, v1 sync dedup scan unchanged, byte-identical.", true),
+        boolDirect("MEGACOMPACT_VC2A", "VC2A Offline Model Runtime", "ModelManifestV1 digest-before-load ONNX runtime (opset17/batch1/max512) + asset-free trigram demotion. Asset path assets/vector-cortex/encoder-v1 is immutable/digest-pinned. OFF = mode C, byte-identical to predecessor.", true),
+        boolDirect("MEGACOMPACT_VC2B", "VC2B Multi-Head Encoder", "VectorSetV1 five L2-normalized heads (384/128/128/64/32) with head-calibration draft + asset-free trigram B (512d) and lexical C fallbacks, plus the per-head emit seam. OFF = mode C, no per-head vectors emitted, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC2C", "VC2C Encoder Qualification + Calibration", "QualifiedEncoderV1/CalibrationV1: calibration fit on the calibration split only (held-out labels prohibited) + atomic selection across MODEL_ASSET and per-head EVALUATION thresholds (any field failure demotes all of A). OFF = mode C, no qualification/calibration selection, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC3A", "VC3A Cortex Store", "Capability-gated derived cortex store (CortexReader/Writer/Admin + CortexRecordV1): additive, keyed (sourceHighWater, algorithmVersion, id), immutable records, deterministic generation rebuild + one root digest. OFF = mode C, no cortex records written, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC3B", "VC3B Deterministic Topology", "Deterministic cortical topology (TopologyV1/EdgeV1): per-(source,head) top-k=16/head calibrated-threshold edges, stable score-desc/then-target-ID sort, dependency directed + contradiction symmetric paired records, one stable generation digest. OFF = mode C, no topology graph built/emitted, predecessor-precise topology view, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC3C", "VC3C Topology Query + Router Invalidation", "TopologyQueryV1/RouterKeyV2 structured keys (length-delimited, unsigned-byte order, no prefix ambiguity), exact (session,generation) invalidation, stale-generation rejection (TOP_GENERATION_STALE), and the M6 router-generation-v2 copy/validate/switch migration. OFF = mode C, no structured router key / generation invalidation, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC4A", "VC4A Dual-Tier Shards", "SemanticShardV1/ExactShardV1/ShardManifestV1: partition a session ONLY at complete EventV2 boundaries; exact shards preserve every tool call/result pair, anchor and invalid UTF-8 event as original bytes (pairs never split across exact shards); manifest enforces disjoint sorted ranges + complete protected-span coverage. OFF = mode C, exact anchors/current transcript only, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC4B", "VC4B Residual Basis Parity", "Residual codec: orthonormal DCT-II basis + int16 block quantization + block-scoped exact correction stream + (9,6) Reed-Solomon parity shards with SHA-256 corruption detection; admission gates on encodedSize <= 95% of exact-compressed size. OFF = mode C, no residual artifact produced, byte-identical predecessor.", true),
+        boolDirect("MEGACOMPACT_VC4C", "VC4C Reconstruction Fidelity", "Conservative closure + source-order assembly + reconstruction validator: recursively closes dependencies and whole tool pairs to a fixed point, resolves contradictions by retaining the later exact source resolution, assembles spans solely by source range, and rejects missing anchors / split pairs / digest mismatch / unresolved contradiction. Mandatory token estimate is content-only and handed unchanged to VC5A. OFF = mode C, no closure/validator, byte-identical predecessor (VC4B).", true),
+        boolDirect("MEGACOMPACT_VC5A", "VC5A PromptDagV1 + Budgeted Planner", "Single-session DAG (PromptDagV1) + budgeted 0/1 portfolio planner: builds a stable Kahn-ordered DAG, computes the mandatory dependency/tool/anchor closure before optional selection, returns MANDATORY_CLOSURE_OVER_BUDGET with evidence preserved on overflow, and runs a utility-per-token portfolio that never exceeds the remaining budget. Framing is owned here, not in VC4C. OFF = byte-identical predecessor (VC4C).", true),
+        boolDirect("MEGACOMPACT_VC5B", "VC5B Validated Renderer + Provider Profiles", "Validated prompt renderer: replays VC5A's stable Kahn order verbatim, preserves exact tool bytes (PREVENT-PI-002), places compacted context via the host before_agent_start prepend seam — never role:system (PREVENT-PI-003) — and SHA-256 hashes the entire canonical outbound request before provider invocation. Unknown provider/model cleanly bypasses to the predecessor prompt path. OFF = byte-identical predecessor (VC5A).", true),
+        boolDirect("MEGACOMPACT_VC5C", "VC5C Live Graduated Rollout", "Live graduated rollout: deterministically hashes each session into a stable 10,000-bucket cohort and advances the exposure gate (1/5/25/50/100%) only after a 72h monotonic residency, a powered sample, >=10,000 events, and >=200 sessions — advancing ONE gate at a time. A hard causal/tool/anchor/exact failure freezes promotion and selects the pre-VC path. OFF = byte-identical predecessor (VC5B).", true),
+        boolDirect("MEGACOMPACT_VC6A", "VC6A Advanced Closure Optimization", "Advanced closure optimization: deterministically reduces the already-mandatory VC4C closure by transitive reduction over depends edges, emitting a ClosureProofV2 receipt per closure and a verifier that replays reductions against the conservative oracle (HEAL_PROOF_SET_MISMATCH on selected-set divergence). Protected edges (tool-pair / anchor / contradiction / sole-dependency) are never removed. The optimized selected set is byte-identical to the conservative closure. OFF = byte-identical predecessor (VC5C); arithmetic runs, only the reporter + dashboard seam is suppressed.", true),
+    ],
+};

package/dist/extensions/dashboard-server/routes-vector-cortex-heal.js

@@ -0,0 +1,47 @@
+/**
+ * dashboard-server/routes-vector-cortex-heal.ts — VC6A closure-optimization
+ * dashboard route.
+ *
+ * Reader-only GET /api/vector-cortex/closure-proof returning aggregate-only
+ * closure diagnostics: whether the flag is enabled, the runtime triad mode, and
+ * cumulative edge/traversal counters. NEVER exposes per-edge proof rows, the
+ * closed selection, node ids, or any source payload (reader-only, SECURITY_PRIVACY
+ * — the detailed proof lives in the structured event log, not the dashboard).
+ *
+ * When the flag is OFF (`MEGACOMPACT_VC6A=0`) the runtime falls back to mode B
+ * (the conservative VC4C closure, no reduction) — that is exactly the spec's
+ * fallback rule — so `mode:"B"` + `enabled:false` is the byte-stable OFF view.
+ *
+ * Guardrails: PREVENT-PI-004 (local in-process state only), PREVENT-011 (no
+ * `any`), reader-only aggregate (counts + mode only).
+ */
+import { VC6A_ENABLED } from "../../src/config.js";
+import { sendJson } from "./routes-vector-cortex-shared.js";
+/** Reader-only GET /api/vector-cortex/closure-proof (VC6A). */
+export function handleVectorCortexClosureProof(req, res, _ctx) {
+    const url = req.url ?? "";
+    const path = url.split("?")[0] ?? url;
+    if (path !== "/api/vector-cortex/closure-proof")
+        return false;
+    if (req.method !== "GET") {
+        sendJson(res, 405, { error: "method_not_allowed" });
+        return true;
+    }
+    const enabled = VC6A_ENABLED();
+    // Flag-off routes to mode B (conservative closure, no reduction) per spec.
+    const mode = enabled ? "A" : "B";
+    const body = {
+        enabled,
+        mode,
+        optimizations: 0,
+        proofRejections: 0,
+        retainedEdgeTotal: 0,
+        removedEdgeTotal: 0,
+        conservativeTraversalTotal: 0,
+        optimizedTraversalTotal: 0,
+        lastRejection: null,
+        updatedAt: new Date().toISOString(),
+    };
+    sendJson(res, 200, body);
+    return true;
+}

package/dist/extensions/dashboard-server/routes-vector-cortex.js

@@ -24,3 +24,4 @@ export { handleVectorCortexReconstruct } from "./routes-vector-cortex-reconstruc
 export { handleVectorCortexPlans } from "./routes-vector-cortex-plans.js";
 export { handleVectorCortexRender } from "./routes-vector-cortex-render.js";
 export { handleVectorCortexRollout } from "./routes-vector-cortex-rollout.js";
+export { handleVectorCortexClosureProof } from "./routes-vector-cortex-heal.js";

package/dist/extensions/dashboard-server/routes.js

@@ -23,4 +23,4 @@ export { handleRagSettings } from "./routes-rag-settings.js";
 export { handleRagMetrics } from "./routes-rag-metrics.js";
 export { handleModelThresholds } from "./routes-model-thresholds.js";
 export { handleWiki } from "./routes-wiki.js";
-export { handleVectorCortexEvaluation, handleVectorCortexHealth, handleVectorCortexBreakersReset, handleVectorCortexLedger, handleVectorCortexTopology, handleVectorCortexQuery, handleVectorCortexShards, handleVectorCortexResidual, handleVectorCortexReconstruct, handleVectorCortexPlans, handleVectorCortexRender, handleVectorCortexRollout, } from "./routes-vector-cortex.js";
+export { handleVectorCortexEvaluation, handleVectorCortexHealth, handleVectorCortexBreakersReset, handleVectorCortexLedger, handleVectorCortexTopology, handleVectorCortexQuery, handleVectorCortexShards, handleVectorCortexResidual, handleVectorCortexReconstruct, handleVectorCortexPlans, handleVectorCortexRender, handleVectorCortexRollout, handleVectorCortexClosureProof, } from "./routes-vector-cortex.js";

package/dist/extensions/dashboard-server/server.js

@@ -14,7 +14,8 @@ import { createRequire } from "node:module";
 import { NEW_UI } from "../../src/config.js";
 import { log, setLogPath, setDashboardServerVersion } from "./state.js";
 import { detectTailscaleIP } from "./tailscale.js";
-import { buildRouteContext, handleIndex, handleRepoIndex, handleEvents, handleGameState, handleGameScores, handlePerf, handlePerfSamples, handleAchievements, handleSessions, handleTopics, handleTurns, handleMaintenance, handleProviderCache, handleCacheStripes, handleMemoryStatus, handleSetupStatus, handleSetupDetect, handleSetupConfigure, handleMemoryMap, handleRaptorTree, handleRaptorBuildHistory, handleContextHealth, handleCachePoison, handleHealthSettings, handleEmbedderHealth, handleRagSettings, handleRagMetrics, handleModelThresholds, handleWiki, handleVectorCortexEvaluation, handleVectorCortexHealth, handleVectorCortexBreakersReset, handleVectorCortexLedger, handleVectorCortexTopology, handleVectorCortexQuery, handleVectorCortexShards, handleVectorCortexResidual, handleVectorCortexReconstruct, handleVectorCortexPlans, handleVectorCortexRender, handleVectorCortexRollout, handleStatic, } from "./routes.js";
+import { buildRouteContext, handleStatic } from "./routes.js";
+import { dispatchRoutes } from "./route-dispatch.js";
 export async function launchDashboardServer(stateDir) {
     // Our own package version — exposed at /api/version so the launcher can
     // detect a stale server (started by an older build) and replace it on
@@ -199,87 +200,7 @@ export async function launchDashboardServer(stateDir) {
             return;
         }
         // Dispatch — each handler returns true if it ended the response.
-        if (handleIndex(req, res, ctx))
-            return;
-        if (handleRepoIndex(req, res, ctx))
-            return;
-        if (handleEvents(req, res, ctx))
-            return;
-        if (handleGameState(req, res, ctx))
-            return;
-        if (handleGameScores(req, res, ctx))
-            return;
-        if (handlePerfSamples(req, res, ctx))
-            return;
-        if (handlePerf(req, res, ctx))
-            return;
-        if (handleAchievements(req, res, ctx))
-            return;
-        if (handleSessions(req, res, ctx))
-            return;
-        if (handleTopics(req, res, ctx))
-            return;
-        if (handleTurns(req, res, ctx))
-            return;
-        if (handleMaintenance(req, res, ctx))
-            return;
-        if (handleProviderCache(req, res, ctx))
-            return;
-        if (handleMemoryStatus(req, res, ctx))
-            return;
-        if (handleCacheStripes(req, res, ctx))
-            return;
-        if (handleSetupStatus(req, res, ctx))
-            return;
-        if (handleSetupDetect(req, res, ctx))
-            return;
-        if (handleSetupConfigure(req, res, ctx))
-            return;
-        if (handleMemoryMap(req, res, ctx))
-            return;
-        if (handleRaptorTree(req, res, ctx))
-            return;
-        if (handleRaptorBuildHistory(req, res, ctx))
-            return;
-        if (handleContextHealth(req, res, ctx))
-            return;
-        if (handleCachePoison(req, res, ctx))
-            return;
-        if (handleHealthSettings(req, res, ctx))
-            return;
-        if (handleEmbedderHealth(req, res, ctx))
-            return;
-        if (handleRagSettings(req, res, ctx))
-            return;
-        if (handleRagMetrics(req, res, ctx))
-            return;
-        if (handleModelThresholds(req, res, ctx))
-            return;
-        if (handleWiki(req, res, ctx))
-            return;
-        if (handleVectorCortexEvaluation(req, res, ctx))
-            return;
-        if (handleVectorCortexHealth(req, res, ctx))
-            return;
-        if (handleVectorCortexBreakersReset(req, res, ctx))
-            return;
-        if (handleVectorCortexLedger(req, res, ctx))
-            return;
-        if (handleVectorCortexTopology(req, res, ctx))
-            return;
-        if (handleVectorCortexQuery(req, res, ctx))
-            return;
-        if (handleVectorCortexShards(req, res, ctx))
-            return;
-        if (handleVectorCortexResidual(req, res, ctx))
-            return;
-        if (handleVectorCortexReconstruct(req, res, ctx))
-            return;
-        if (handleVectorCortexPlans(req, res, ctx))
-            return;
-        if (handleVectorCortexRender(req, res, ctx))
-            return;
-        if (handleVectorCortexRollout(req, res, ctx))
+        if (dispatchRoutes(req, res, ctx))
             return;
         handleStatic(req, res, ctx);
     });

package/dist/src/config/dedup.js

@@ -69,6 +69,7 @@ export function loadDedupConfig() {
         RAPTOR_MAX_LEAF_EXPANSION: envNum("MEGACOMPACT_RAPTOR_MAX_LEAF_EXP", 10),
         RAPTOR_FRESHNESS_HOURS: envNum("MEGACOMPACT_RAPTOR_FRESHNESS_HOURS", 4),
         RAPTOR_INJECT_SUMMARIES: envBool("MEGACOMPACT_RAPTOR_INJECT_SUMMARIES", true),
+        DEDUP_AUDIT: envBool("MEGACOMPACT_DEDUP_AUDIT", true),
         FP_RATE_L0: envNum("MEGACOMPACT_FP_RATE_L0", 0.01),
         FP_RATE_L1L2: envNum("MEGACOMPACT_FP_RATE_L1L2", 0.05),
         ALERT_WINDOW_MS: envNum("MEGACOMPACT_ALERT_WINDOW_MS", 600_000),

package/dist/src/config/vector-cortex.js

@@ -196,6 +196,18 @@ export const VC5B_ENABLED = () => sprintFlag("MEGACOMPACT_VC5B");
  * mirroring VC4A/VC4B/VC4C/VC5A/VC5B.
  */
 export const VC5C_ENABLED = () => sprintFlag("MEGACOMPACT_VC5C");
+/**
+ * VC6A — advanced closure optimization. Default ON. `MEGACOMPACT_VC6A=0`
+ * disables and is byte-identical to the predecessor (VC5C): the `optimizeClosure`
+ * transitive-reduction arithmetic STILL RUNS (it is PURE), but the
+ * `vector_cortex_closure_optimized` / `vector_cortex_closure_proof_rejected`
+ * events are never emitted and the dashboard closure diagnostics seam is
+ * suppressed. Flag OFF gates the reporter + dashboard seam, never the arithmetic,
+ * so flag-off outbound/predecessor golden bytes match exactly. This flag MUST
+ * also be a dashboard SETTINGS toggle (visible in config UI, never in
+ * EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C.
+ */
+export const VC6A_ENABLED = () => sprintFlag("MEGACOMPACT_VC6A");
 // ---------------------------------------------------------------------------
 // Breaker state machine constants (TRIAD_RESILIENCE.md §breaker).
 // Rolled numbers for one 60s window; VC0C consumes these at its breaker seam.

package/dist/src/config.js

@@ -114,4 +114,4 @@ export const NEW_UI = () => ragEnabled("MEGACOMPACT_NEW_UI");
 // default ON, `=0`/`_DISABLED` off. Re-exported from src/config/vector-cortex.ts
 // so root consumers share one source of truth.
 // ---------------------------------------------------------------------------
-export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";
+export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, VC6A_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";

package/dist/src/dedup-audit.test-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * dedup-audit.test-helpers.ts — shared harness for the dedup audit trail tests.
+ *
+ * Extracted so dedup-audit.test.ts and dedup-audit-gating.test.ts share one
+ * temp-dir lifecycle and one events.log reader instead of duplicating them, and
+ * so each test file stays under the 300-line src/ soft limit.
+ *
+ * Hermetic: every store gets its own temp state dir, so no test can observe
+ * another's audit lines. No network (PREVENT-PI-004).
+ */
+import { mkdtempSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadDedupConfig } from "./config/dedup.js";
+import { defaultEventsPath } from "./monitoring.js";
+/** Root temp dir shared by both audit test files (each run gets a subdir). */
+export const baseTmp = mkdtempSync(join(tmpdir(), "mc-dedup-audit-"));
+/** The live config with per-test overrides applied. */
+export function cfg(over = {}) {
+    return { ...loadDedupConfig(), ...over };
+}
+let seq = 0;
+/** A never-before-used state dir under `baseTmp`. */
+export function freshDir() {
+    return join(baseTmp, `run-${seq++}-${Math.floor(performance.now() * 1000)}`);
+}
+/** Read every dedup_audit line from a store's default events.log. */
+export function auditLines(stateDir) {
+    const path = defaultEventsPath(stateDir);
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, "utf-8")
+        .split("\n")
+        .filter((l) => l.trim())
+        .map((l) => JSON.parse(l))
+        .filter((e) => e.type === "dedup_audit");
+}
+/** A path whose parent directory can never be created: it sits under a FILE. */
+export function unwritablePath() {
+    const blocker = join(baseTmp, `blocker-${seq++}`);
+    writeFileSync(blocker, "not a directory");
+    return join(blocker, "sub", "events.log");
+}

package/dist/src/monitoring.js

@@ -142,3 +142,12 @@ export function logRecallQuality(path, ev) {
         /* best-effort — never break the extension */
     }
 }
+// ---------------------------------------------------------------------------
+// Dedup audit trail (external-audit item #2)
+// ---------------------------------------------------------------------------
+// The event shape and its append helper are DEFINED in vectorStore/dedup-audit.ts,
+// co-located with the only recorder that emits them (this file already carries
+// decision events + the metrics snapshot + FP alerting and must stay under its
+// 300-line soft limit). Re-exported here so callers that treat monitoring.ts as
+// the events.log barrel — including the dashboard SSE tail — keep one import.
+export { logDedupAudit } from "./vectorStore/dedup-audit.js";

package/dist/src/vector-cortex/heal/_acceptance-fixture.js

@@ -0,0 +1,56 @@
+/**
+ * heal/_acceptance-fixture.ts — conformance fixture I/O for VC6A closure
+ * optimization acceptance rows.
+ *
+ * Reads the v2 conformance manifest + the per-sprint closure-optimization
+ * fixture files, and exposes the `HealFx` shape the acceptance aggregator
+ * drives. No mocks/stubs: the fixtures are the committed canonical corpus, fed
+ * verbatim into `closeSelection` → `optimizeClosure` → `verifyProof`.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import assert from "node:assert/strict";
+const HERE = dirname(fileURLToPath(import.meta.url));
+function repoRoot(from) {
+    let dir = from;
+    for (let i = 0; i < 8; i++) {
+        if (existsSync(join(dir, "conformance", "vector-cortex")))
+            return dir;
+        const next = dirname(dir);
+        if (next === dir)
+            break;
+        dir = next;
+    }
+    throw new Error("conformance corpus not found above " + from);
+}
+export const REPO_ROOT = repoRoot(HERE);
+export const V2 = join(REPO_ROOT, "conformance", "vector-cortex", "v2");
+export function readManifest() {
+    return JSON.parse(readFileSync(join(V2, "manifest.json"), "utf8"));
+}
+function readFixture(id, prefix) {
+    const m = readManifest();
+    const row = m.fixtures.find((f) => f.id === id && f.path.startsWith(`${prefix}/`));
+    assert.ok(row, `fixture ${id} registered under ${prefix}/ in manifest`);
+    return JSON.parse(readFileSync(join(V2, row.path), "utf8"));
+}
+export function healFixture(id) {
+    return readFixture(id, "closure-optimization");
+}
+/** Flag-pinned wrapper: VC6A gated by MEGACOMPACT_VC6A (defaults ON). */
+export function withFlagsOn(fn) {
+    return () => {
+        const saved = process.env.MEGACOMPACT_VC6A;
+        process.env.MEGACOMPACT_VC6A = "1";
+        try {
+            fn();
+        }
+        finally {
+            if (saved === undefined)
+                delete process.env.MEGACOMPACT_VC6A;
+            else
+                process.env.MEGACOMPACT_VC6A = saved;
+        }
+    };
+}