pi-mega-compact 0.18.1 → 0.19.1

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

@@ -1,292 +1,19 @@
 /**
  * dashboard-server/routes-vector-cortex.ts — vector-cortex dashboard routes.
  *
- * VC0A ships a single reader-only GET /api/vector-cortex/evaluation that
- * aggregates redacted evaluation rows (persisted JSONL under the state dir)
- * via the reader. No writable capability — no reset/mutation here; VC0C adds
- * breaker health + reset endpoints into this same file, keeping it additive
- * and within extension limits.
+ * Delegate shell: each VC feature owns a focused handler module below the
+ * extension line limit, and this file re-exports them unchanged so the existing
+ * registration (`routes.ts`, `server.ts`) keeps working without modification.
  *
- * VC0C (task 5) adds:
- *   GET  /api/vector-cortex/health          — reader-only aggregate health card
- *   POST /api/vector-cortex/breakers/reset  — explicit admin capability
+ *   VC0A evaluation  -> routes-vector-cortex-eval.ts  (GET  /evaluation)
+ *   VC0C health/reset-> routes-vector-cortex-health.ts(GET  /health, POST /breakers/reset)
+ *   VC1B ledger      -> routes-vector-cortex-ledger.ts (GET  /ledger)
+ *   VC3A topology    -> routes-vector-cortex-topology.ts(GET /topology)
  *
  * Guardrails: PREVENT-PI-004 (local filesystem read only), PREVENT-011 (no
- * `any`), reader-only aggregate (never payloads/prompts/ledger — EVAL-REDACT-002).
+ * `any`), reader-only aggregates (never payloads/prompts/ledger text).
  */
-import { VC0A_ENABLED, VC0C_ENABLED, VC1B_ENABLED } from "../../src/config.js";
-import { readEvalRows } from "../../src/vector-cortex/eval/persist.js";
-import { summarizeEvalRows } from "../../src/vector-cortex/eval/reader.js";
-import { createVectorCortexSafety } from "../mega-runtime/vector-cortex-safety.js";
-import { createLedgerStore } from "../../src/vector-cortex/ledger/store.js";
-/** Admin capability: an actor-supplied subsystem selector for breaker reset. */
-function readJsonBody(req, cb) {
-    let body = "";
-    let tooBig = false;
-    req.on("data", (chunk) => {
-        if (body.length > 65536) {
-            tooBig = true;
-            return;
-        }
-        body += chunk.toString();
-    });
-    req.on("end", () => {
-        if (tooBig)
-            return cb({ ok: false, error: "body_too_large" });
-        try {
-            const v = body ? JSON.parse(body) : {};
-            if (typeof v !== "object" || v === null || Array.isArray(v)) {
-                return cb({ ok: false, error: "invalid_object" });
-            }
-            cb({ ok: true, value: v });
-        }
-        catch {
-            cb({ ok: false, error: "invalid_json" });
-        }
-    });
-}
-function sendJson(res, status, body) {
-    // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
-    res.writeHead(status, { "Content-Type": "application/json" });
-    res.end(JSON.stringify(body));
-}
-/** Reader-only aggregate GET /api/vector-cortex/evaluation. */
-export function handleVectorCortexEvaluation(req, res, ctx) {
-    const url = req.url ?? "";
-    if (url !== "/api/vector-cortex/evaluation")
-        return false;
-    if (req.method !== "GET") {
-        // Reader-only: no mutation endpoints exist on this path.
-        // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
-        res.writeHead(405, { "Content-Type": "application/json" });
-        res.end(JSON.stringify({ error: "method_not_allowed" }));
-        return true;
-    }
-    const enabled = VC0A_ENABLED();
-    const rows = enabled ? readEvalRows(ctx.stateDir) : [];
-    const summary = summarizeEvalRows(rows);
-    const body = {
-        enabled,
-        mode: enabled ? "A" : "C",
-        samples: summary.samples,
-        byMode: {
-            A: summary.byMode.A,
-            B: summary.byMode.B,
-            C: summary.byMode.C,
-        },
-        histogram: {
-            edges: [...summary.histogram.edges],
-            cells: [...summary.histogram.cells],
-            overflow: summary.histogram.overflow,
-            total: summary.histogram.total,
-        },
-        rejects: [], // VC0C wires live breaker/reject telemetry here
-        updatedAt: new Date().toISOString(),
-    };
-    sendJson(res, 200, body);
-    return true;
-}
-/**
- * Reader-only GET /api/vector-cortex/health (VC0C).
- *
- * Aggregate health card: breaker state (window/probe/backoff), durable spool
- * frontier/authority/lag, and a worst-state aggregate. Constructs the safety
- * adapter over the state dir — durable spool state (frontier-frozen, lag) is
- * read from disk, so it reflects restart. Purely read: no mutation, never
- * payloads/prompts/ledger.
- */
-export function handleVectorCortexHealth(req, res, ctx) {
-    const url = req.url ?? "";
-    if (url !== "/api/vector-cortex/health")
-        return false;
-    if (req.method !== "GET") {
-        // Reader-only path: no mutation endpoint lives at /health.
-        sendJson(res, 405, { error: "method_not_allowed" });
-        return true;
-    }
-    const enabled = VC0C_ENABLED();
-    const safety = enabled ? createVectorCortexSafety({ stateDir: ctx.stateDir }) : null;
-    const card = safety ? safety.health() : null;
-    const fallback = {
-        enabled: false,
-        mode: "C",
-        state: "CLOSED_A",
-        subsystem: "provider",
-        sinceMs: 0,
-        windowMs: 0,
-        probeCount: 0,
-        backoffDelayMs: 0,
-        frontierFrozen: false,
-        authorityOutage: false,
-        spoolLag: 0,
-        attempts: 0,
-        failures: 0,
-        p95Ms: 0,
-        failureRate: 0,
-        updatedAt: new Date().toISOString(),
-        aggregate: "CLOSED_A",
-        stateSource: "ephemeral",
-    };
-    if (!card) {
-        sendJson(res, 200, fallback);
-        return true;
-    }
-    const mode = card.state === "CLOSED_A" ? "A" : card.state === "MANUAL_HALT" ? "C" : "B";
-    const aggregate = card.state === "MANUAL_HALT"
-        ? "MANUAL_HALT"
-        : card.state === "OPEN_C"
-            ? "OPEN_C"
-            : card.state === "OPEN_B"
-                ? "OPEN_B"
-                : card.state === "PROBE_B" || card.state === "PROBE_A"
-                    ? "PROBE"
-                    : "CLOSED_A";
-    const body = {
-        enabled,
-        mode,
-        state: card.state,
-        subsystem: card.subsystem,
-        sinceMs: card.sinceMs,
-        reason: card.reason,
-        windowMs: card.windowMs,
-        probeCount: card.probeCount,
-        backoffDelayMs: card.backoffDelayMs,
-        frontierFrozen: card.frontierFrozen,
-        authorityOutage: card.authorityOutage,
-        spoolLag: card.spoolLag,
-        attempts: card.attempts,
-        failures: card.failures,
-        p95Ms: card.p95Ms,
-        failureRate: card.failureRate,
-        updatedAt: new Date().toISOString(),
-        aggregate,
-        stateSource: card.stateSource,
-    };
-    sendJson(res, 200, body);
-    return true;
-}
-/**
- * Admin POST /api/vector-cortex/breakers/reset (VC0C).
- *
- * Explicit admin capability (separate from the reader GET). Clears a breaker's
- * cooldown — or unwires a MANUAL_HALT — but NEVER evidence (attempts/failures
- * are retained, per TRIAD_RESILIENCE). The subsystem is actor-supplied via the
- * JSON body `{ subsystem }`. Every reset is documented in the returned record
- * (state, retained evidence, updatedAt) — an auditable mutation surface; the
- * GET path can never mutate.
- */
-export function handleVectorCortexBreakersReset(req, res, ctx) {
-    const url = req.url ?? "";
-    if (url !== "/api/vector-cortex/breakers/reset")
-        return false;
-    if (req.method !== "POST") {
-        sendJson(res, 405, { error: "method_not_allowed" });
-        return true;
-    }
-    if (!VC0C_ENABLED()) {
-        sendJson(res, 409, { error: "vco_c_disabled" });
-        return true;
-    }
-    readJsonBody(req, (parsed) => {
-        if (!parsed.ok) {
-            sendJson(res, 400, { error: parsed.error });
-            return;
-        }
-        const subsystem = parsed.value.subsystem;
-        if (typeof subsystem !== "string" || subsystem.length === 0) {
-            sendJson(res, 400, { error: "subsystem_required" });
-            return;
-        }
-        try {
-            const safety = createVectorCortexSafety({ stateDir: ctx.stateDir });
-            const rec = safety.reset(subsystem);
-            const body = {
-                subsystem: rec.subsystem,
-                state: rec.state,
-                cooldownCleared: true,
-                attempts: rec.attempts,
-                failures: rec.failures,
-                probeCount: rec.probeCount,
-                manualReason: rec.manualReason,
-                updatedAt: rec.updatedAt,
-            };
-            sendJson(res, 200, body);
-        }
-        catch {
-            sendJson(res, 500, { error: "reset_failed" });
-        }
-    });
-    return true;
-}
-/**
- * Reader-only GET /api/vector-cortex/ledger (VC1B).
- *
- * Built on the LedgerReader capability: opens the occurrence-v2 ledger for this
- * repo's state dir and returns the session's occurrence IDENTITY rows
- * (seq/eventId/kind/digest/toolCallId) plus high-water/count. NEVER ships
- * sourceBytes or prompt text (reader-only no-ledger-text rule). Optional
- * `?session=<id>` query selects the session (default "default").
- */
-export function handleVectorCortexLedger(req, res, ctx) {
-    const url = req.url ?? "";
-    const path = url.split("?")[0] ?? url;
-    if (path !== "/api/vector-cortex/ledger")
-        return false;
-    if (req.method !== "GET") {
-        // Reader-only path: no mutation endpoint lives at /ledger.
-        sendJson(res, 405, { error: "method_not_allowed" });
-        return true;
-    }
-    // Parse the optional session query parameter.
-    let session = "default";
-    const qs = url.split("?")[1];
-    if (qs !== undefined) {
-        for (const pair of qs.split("&")) {
-            const [k, v] = pair.split("=");
-            if (k === "session" && v !== undefined && v.length > 0) {
-                session = decodeURIComponent(v);
-            }
-        }
-    }
-    const enabled = VC1B_ENABLED();
-    let active = enabled;
-    let highWater = "0";
-    let count = 0;
-    let occurrences = [];
-    if (enabled) {
-        try {
-            const store = createLedgerStore({ stateDir: ctx.stateDir });
-            try {
-                const reader = store.reader();
-                highWater = reader.highWater(session).toString();
-                const rows = reader.readSession(session);
-                count = rows.length;
-                // Identity only: never sourceBytes or prompt text (reader-only rule).
-                occurrences = rows.slice(-500).map((occ) => ({
-                    seq: occ.seq.toString(),
-                    eventId: occ.eventId,
-                    kind: occ.kind,
-                    digest: occ.digest,
-                    ...(occ.toolCallId !== undefined ? { toolCallId: occ.toolCallId } : {}),
-                }));
-            }
-            finally {
-                store.close();
-            }
-        }
-        catch {
-            // Non-fatal: a missing/corrupt ledger DB degrades to `enabled:false`.
-            active = false;
-        }
-    }
-    const body = {
-        enabled: active,
-        session,
-        highWater,
-        count,
-        occurrences,
-        updatedAt: new Date().toISOString(),
-    };
-    sendJson(res, 200, body);
-    return true;
-}
+export { handleVectorCortexEvaluation } from "./routes-vector-cortex-eval.js";
+export { handleVectorCortexHealth, handleVectorCortexBreakersReset } from "./routes-vector-cortex-health.js";
+export { handleVectorCortexLedger } from "./routes-vector-cortex-ledger.js";
+export { handleVectorCortexTopology } from "./routes-vector-cortex-topology.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, } from "./routes-vector-cortex.js";
+export { handleVectorCortexEvaluation, handleVectorCortexHealth, handleVectorCortexBreakersReset, handleVectorCortexLedger, handleVectorCortexTopology, } from "./routes-vector-cortex.js";

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

@@ -13,7 +13,7 @@ import { fileURLToPath } from "node:url";
 import { createRequire } from "node:module";
 import { NEW_UI } from "../../src/config.js";
 import { log, setLogPath, setDashboardServerVersion } from "./state.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, handleStatic, } from "./routes.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, handleStatic, } from "./routes.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
@@ -249,6 +249,8 @@ export async function launchDashboardServer(stateDir) {
             return;
         if (handleVectorCortexLedger(req, res, ctx))
             return;
+        if (handleVectorCortexTopology(req, res, ctx))
+            return;
         handleStatic(req, res, ctx);
     });
     // Bind base + range are env-configurable so tests can use a private,

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

@@ -82,6 +82,25 @@ export const VC2A_ENABLED = () => sprintFlag("MEGACOMPACT_VC2A");
  * emit seam and the multi-head encoder producers (heads/trigram/lexical).
  */
 export const VC2B_ENABLED = () => sprintFlag("MEGACOMPACT_VC2B");
+/**
+ * VC2C — encoder qualification + calibration (QualifiedEncoderV1 / CalibrationV1).
+ * Default ON. `MEGACOMPACT_VC2C=0` disables and is byte-identical to the
+ * predecessor (mode C: no qualification manifest is read or selected, the
+ * calibrate/select/fallback seams are idle, zero `vector_cortex_encoder_qualification_*`
+ * emissions; the trigram/lexical paths are unchanged). The real consumers are
+ * the encoder-qualification emit seam and the calibrate/select seams.
+ */
+export const VC2C_ENABLED = () => sprintFlag("MEGACOMPACT_VC2C");
+/**
+ * VC3A — capability-gated cortex store (CortexReader/Writer/Admin, CortexRecordV1).
+ * Default ON. `MEGACOMPACT_VC3A=0` disables and is byte-identical to the
+ * predecessor (mode C: the derived cortex store is absent, mode B in-memory is
+ * not consulted, zero `vector_cortex_record_append_failed` /
+ * `vector_cortex_generation_rebuilt` emissions; the predecessor derived pointer
+ * and goldens are unchanged). The real consumers are the cortex append seam, the
+ * cortex rebuild/admin seam and the reader-only topology summary seam.
+ */
+export const VC3A_ENABLED = () => sprintFlag("MEGACOMPACT_VC3A");
 // ---------------------------------------------------------------------------
 // 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, 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, 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";