pi-mega-compact 0.20.24 → 0.20.26

package/extensions/dashboard-client/src/types/vector-cortex.ts

@@ -6,6 +6,8 @@
 
 export interface VectorCortexEvaluationSummary {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   mode: "A" | "B" | "C";
   samples: number;
   byMode: { A: number; B: number; C: number };
@@ -25,6 +27,8 @@ export interface VectorCortexEvaluationSummary {
  */
 export interface VectorCortexHealthCard {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   mode: "A" | "B" | "C";
   state:
     | "CLOSED_A"
@@ -82,6 +86,8 @@ export interface VectorCortexResetResult {
  */
 export interface VectorCortexTopologyView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   generationId: string | null;
   rootDigest: string | null;
   sourceHighWater: string;
@@ -111,6 +117,8 @@ export interface VectorCortexTopologyView {
  */
 export interface VectorCortexQueryView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   routerVersion: number;
   updatedAt: string;
 }
@@ -121,6 +129,8 @@ export interface VectorCortexQueryView {
  */
 export interface VectorCortexShardsView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   semanticCount: number;
   exactCount: number;
   byteTotal: number;
@@ -135,6 +145,8 @@ export interface VectorCortexShardsView {
  */
 export interface VectorCortexReconstructView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   closureAttempts: number;
   closureRejections: number;
   validatedCount: number;
@@ -150,6 +162,8 @@ export interface VectorCortexReconstructView {
  */
 export interface VectorCortexLedgerView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   session: string;
   highWater: string;
   count: number;
@@ -177,6 +191,8 @@ export interface VectorCortexPlanManifest {
 
 export interface VectorCortexPlansView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   dagCount: number;
   plannerCount: number;
   plans: VectorCortexPlanManifest[];
@@ -186,6 +202,8 @@ export interface VectorCortexPlansView {
 /** Reader-only render + provider-profile view (VC5B). */
 export interface VectorCortexRenderView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   renderCount: number;
   providerCount: number;
   knownProfiles: string[];
@@ -199,6 +217,8 @@ export interface VectorCortexRenderView {
  */
 export interface VectorCortexRolloutView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   gateIndex: number;
   gatePct: number;
   buckets: number;
@@ -216,6 +236,8 @@ export interface VectorCortexRolloutView {
  */
 export interface VectorCortexRestoreView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   mode: "A" | "B" | "C";
   restoreAttempts: number;
   restoredCount: number;
@@ -232,6 +254,8 @@ export interface VectorCortexRestoreView {
  */
 export interface VectorCortexRepairView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   mode: "A" | "B" | "C";
   repairAttempts: number;
   repairsPlanned: number;
@@ -245,6 +269,8 @@ export interface VectorCortexRepairView {
 /** Reader-only closure-optimization diagnostics view (VC6A). Aggregate only. */
 export interface VectorCortexClosureProofView {
   enabled: boolean;
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
+  readonly deferredReason?: string;
   mode: "A" | "B" | "C";
   optimizations: number;
   proofRejections: number;

package/extensions/dashboard-server/api-contracts/vector-cortex-cache.ts

@@ -55,4 +55,6 @@ export interface VectorCortexCrystalsView {
    * why emit-only counters are reported instead of live cache-serve integration.
    */
   readonly deferredReason?: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }

package/extensions/dashboard-server/api-contracts/vector-cortex-diagnostics.ts

@@ -75,4 +75,6 @@ export interface VectorCortexDiagnosticsView {
   readonly lastFailure: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }

package/extensions/dashboard-server/api-contracts/vector-cortex-economics.ts

@@ -46,4 +46,6 @@ export interface VectorCortexEconomicsView {
   readonly updatedAt: string;
   /** Present when the economic aggregate is not yet computed, with a reason. */
   readonly deferredReason?: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }

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

@@ -40,6 +40,8 @@ export interface VectorCortexClosureProofView {
   readonly lastRejection: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }
 
 /**
@@ -70,6 +72,8 @@ export interface VectorCortexRestoreView {
   readonly lastRejection: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }
 
 /**
@@ -108,4 +112,6 @@ export interface VectorCortexRepairView {
   readonly lastFailure: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }

package/extensions/dashboard-server/api-contracts/vector-cortex-outcomes.ts

@@ -37,6 +37,8 @@ export interface VectorCortexOutcomesView {
   readonly lastFailure: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }
 
 /** Consent admin API request body (audited). */

package/extensions/dashboard-server/api-contracts/vector-cortex-platform.ts

@@ -31,4 +31,6 @@ export interface VectorCortexPlatformView {
   readonly lastFailure: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }

package/extensions/dashboard-server/api-contracts/vector-cortex-policy.ts

@@ -35,4 +35,6 @@ export interface VectorCortexPolicyView {
   readonly updatedAt: string;
   /** Present when the shadow controller is not yet instantiated, with a reason. */
   readonly deferredReason?: string;
+  /** Live-state derivation for the dashboard (off/awaiting_data/deferred/structural). */
+  readonly status?: "live" | "awaiting_data" | "deferred" | "structural" | "off";
 }

package/extensions/dashboard-server/api-contracts/vector-cortex.ts

@@ -10,6 +10,13 @@
  * PREVENT-011: no `any` type.
  */
 
+/**
+ * Live-state derivation shared across the VC views: "off" (flag disabled),
+ * "awaiting_data" (enabled but no data yet), "deferred" (echoed with a
+ * deferredReason), "structural" (enabled, structure-only metrics), "live".
+ */
+type VcStatus = "live" | "awaiting_data" | "deferred" | "structural" | "off";
+
 /**
  * Aggregate evaluation summary for GET /api/vector-cortex/evaluation.
  * Reader-only: exposes aggregates (histogram cells, counts), never payloads or
@@ -39,6 +46,7 @@ export interface VectorCortexEvaluationSummary {
   readonly rejects: readonly string[];
   /** ISO timestamp of the summary. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -101,6 +109,7 @@ export interface VectorCortexHealthCard {
    * (lexical). Reader-only aggregate — the measured digest prefix, never bytes.
    */
   readonly encoderMode: "A" | "B" | "C";
+  readonly status?: VcStatus;
 }
 
 /**
@@ -117,6 +126,7 @@ export interface VectorCortexResetResult {
   readonly probeCount: number;
   readonly manualReason?: string;
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -158,6 +168,7 @@ export interface VectorCortexTopologyView {
   readonly generationDigest?: string | null;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -175,6 +186,7 @@ export interface VectorCortexQueryView {
   readonly routerVersion: number;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -199,6 +211,7 @@ export interface VectorCortexShardsView {
   readonly protectedByteTotal: number;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -228,6 +241,7 @@ export interface VectorCortexResidualView {
   readonly exactByteTotal: number;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -256,6 +270,7 @@ export interface VectorCortexReconstructView {
   readonly byteTotal: number;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -294,6 +309,7 @@ export interface VectorCortexPlansView {
   readonly plans: readonly VectorCortexPlanManifest[];
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -314,6 +330,7 @@ export interface VectorCortexRenderView {
   readonly knownProfiles: readonly string[];
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -345,6 +362,7 @@ export interface VectorCortexRolloutView {
   readonly promotionBlocked: boolean;
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 /**
@@ -372,6 +390,7 @@ export interface VectorCortexLedgerView {
   }[];
   /** ISO timestamp of the snapshot. */
   readonly updatedAt: string;
+  readonly status?: VcStatus;
 }
 
 export type {

package/extensions/dashboard-server/routes-vector-cortex-crystals.ts

@@ -29,6 +29,7 @@ import type { RouteContext } from "./routes-core.js";
 import { VC7A_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import { countVcEvents, vcCount } from "./vc-event-counts.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type { VectorCortexCrystalsView } from "./api-contracts/vector-cortex-cache.js";
 
 // Actual events emitted by src/vector-cortex/cache/crystal-emit.ts.
@@ -77,6 +78,11 @@ export function handleVectorCortexCrystals(
     lastFailure: null,
     updatedAt: new Date().toISOString(),
     deferredReason: "crystal_store_not_instantiated_v0_20_23",
+    status: deriveVcStatus({
+      enabled,
+      deferredReason: "crystal_store_not_instantiated_v0_20_23",
+      hasData: vcCount(counts, "vector_cortex_crystal_written") > 0,
+    }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-diagnostics.ts

@@ -31,6 +31,7 @@ import type { RouteContext } from "./routes-core.js";
 import { VC7C_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import { countVcEvents, vcCount } from "./vc-event-counts.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type { VectorCortexDiagnosticsView } from "./api-contracts/vector-cortex-diagnostics.js";
 
 // Actual events emitted by src/vector-cortex/cache/diagnostics-emit.ts.
@@ -77,6 +78,11 @@ export function handleVectorCortexDiagnostics(
     lastFailure: null,
     updatedAt: new Date().toISOString(),
     deferredReason: "cache_classifier_not_wired_v0_20_23",
+    status: deriveVcStatus({
+      enabled,
+      deferredReason: "cache_classifier_not_wired_v0_20_23",
+      hasData: vcCount(counts, "vector_cortex_cache_serve_blocked") > 0,
+    }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-economics.ts

@@ -27,6 +27,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./routes-core.js";
 import { VC7B_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type { VectorCortexEconomicsView } from "./api-contracts/vector-cortex-economics.js";
 
 /**
@@ -63,6 +64,11 @@ export function handleVectorCortexEconomics(
     lastFailure: null,
     updatedAt: new Date().toISOString(),
     deferredReason: "economics_not_computed_v0_20_23",
+    status: deriveVcStatus({
+      enabled,
+      deferredReason: "economics_not_computed_v0_20_23",
+      hasData: false,
+    }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-eval.ts

@@ -17,6 +17,7 @@ import { readEvalRows } from "../../src/vector-cortex/eval/persist.js";
 import { summarizeEvalRows } from "../../src/vector-cortex/eval/reader.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import type { VectorCortexEvaluationSummary } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 /** Reader-only aggregate GET /api/vector-cortex/evaluation. */
 export function handleVectorCortexEvaluation(
@@ -53,6 +54,7 @@ export function handleVectorCortexEvaluation(
     },
     rejects: [], // VC0C wires live breaker/reject telemetry here
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled, hasData: summary.samples > 0 }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-heal.ts

@@ -25,6 +25,7 @@ import type { RouteContext } from "./routes-core.js";
 import { VC6A_ENABLED, VC6B_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import { countVcEvents, vcCount } from "./vc-event-counts.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type {
   VectorCortexClosureProofView,
   VectorCortexRestoreView,
@@ -69,6 +70,10 @@ export function handleVectorCortexClosureProof(
     optimizedTraversalTotal: 0,
     lastRejection: null,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({
+      enabled,
+      hasData: vcCount(counts, "vector_cortex_closure_optimized") > 0,
+    }),
   };
   sendJson(res, 200, body);
   return true;
@@ -110,6 +115,10 @@ export function handleVectorCortexRestore(
     digestRejections: vcCount(counts, "vector_cortex_restore_digest_rejected"),
     lastRejection: null,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({
+      enabled,
+      hasData: vcCount(counts, "vector_cortex_source_restored") > 0,
+    }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-health.ts

@@ -23,6 +23,7 @@ import type {
   VectorCortexHealthCard,
   VectorCortexResetResult,
 } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 /** Resolve the committed encoder-v1 asset dir by walking up to the repo root. */
 function encoderAssetDir(): string | null {
@@ -169,6 +170,7 @@ export function handleVectorCortexHealth(
     stateSource: "ephemeral",
     encoderAssetDigest: enc.assetDigest,
     encoderMode: enc.mode,
+    status: deriveVcStatus({ enabled: false, hasData: false }),
   };
   if (!card) {
     sendJson(res, 200, fallback);
@@ -210,6 +212,7 @@ export function handleVectorCortexHealth(
     stateSource: card.stateSource,
     encoderAssetDigest: enc.assetDigest,
     encoderMode: enc.mode,
+    status: deriveVcStatus({ enabled, hasData: true, structuralOnly: true }),
   };
   sendJson(res, 200, body);
   return true;
@@ -263,6 +266,7 @@ export function handleVectorCortexBreakersReset(
         probeCount: rec.probeCount,
         manualReason: rec.manualReason,
         updatedAt: rec.updatedAt,
+        status: deriveVcStatus({ enabled: true, hasData: true }),
       };
       sendJson(res, 200, body);
     } catch {

package/extensions/dashboard-server/routes-vector-cortex-ledger.ts

@@ -18,6 +18,7 @@ import { VC1B_ENABLED } from "../../src/config.js";
 import { createLedgerStore } from "../../src/vector-cortex/ledger/store.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import type { VectorCortexLedgerView } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 /**
  * Reader-only GET /api/vector-cortex/ledger (VC1B).
@@ -86,6 +87,7 @@ export function handleVectorCortexLedger(
     count,
     occurrences,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled: active, hasData: count > 0 }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-outcomes.ts

@@ -21,12 +21,18 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./routes-core.js";
 import { VC8A_ENABLED } from "../../src/config.js";
 import { sendJson, readJsonBody } from "./routes-vector-cortex-shared.js";
+import { countVcEvents, vcCount } from "./vc-event-counts.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type {
   VectorCortexOutcomesView,
   ConsentAdminRequest,
   ConsentAdminResponse,
 } from "./api-contracts/vector-cortex-outcomes.js";
 
+// Actual events emitted by src/vector-cortex/outcomes/* — the outcome append is
+// the sole aggregate signal (consent grants/revokes are not emitted as events).
+const OUTCOME_EVENTS = ["vector_cortex_outcome_appended"] as const;
+
 /**
  * GET /api/vector-cortex/outcomes — reader-only outcomes aggregate (VC8A).
  * POST /api/vector-cortex/outcomes/consent — audited consent admin API.
@@ -34,7 +40,7 @@ import type {
 export function handleVectorCortexOutcomes(
   req: IncomingMessage,
   res: ServerResponse,
-  _ctx: RouteContext,
+  ctx: RouteContext,
 ): boolean {
   const url = req.url ?? "";
   const path = url.split("?")[0] ?? url;
@@ -77,17 +83,20 @@ export function handleVectorCortexOutcomes(
   }
 
   const enabled = VC8A_ENABLED();
+  const counts = countVcEvents(ctx.stateDir, OUTCOME_EVENTS);
+  const outcomeCount = vcCount(counts, "vector_cortex_outcome_appended");
   const mode: "A" | "B" | "C" = enabled ? "A" : "C";
   const body: VectorCortexOutcomesView = {
     enabled,
     mode,
-    outcomeCount: 0,
+    outcomeCount,
     consentedSessions: 0,
     revokedSessions: 0,
     manifestCount: 0,
     excludedCount: 0,
     lastFailure: null,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled, hasData: outcomeCount > 0 }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-plans.ts

@@ -27,6 +27,7 @@ import { DAG_IDS } from "../../src/vector-cortex/prompt-dag/types.js";
 import { PLN_IDS } from "../../src/vector-cortex/planner/types.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import type { VectorCortexPlansView } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 /**
  * Reader-only GET /api/vector-cortex/plans (VC5A).
@@ -52,6 +53,7 @@ export function handleVectorCortexPlans(
     plannerCount: enabled ? PLN_IDS.length : 0,
     plans: [],
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled, hasData: true, structuralOnly: true }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-platform.ts

@@ -18,13 +18,22 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./routes-core.js";
 import { VC8C_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
+import { countVcEvents, vcCount } from "./vc-event-counts.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type { VectorCortexPlatformView } from "./api-contracts/vector-cortex-platform.js";
 
+// Actual events emitted by src/vector-cortex/platform/* — a parity run checks
+// fixtures and a demotion records an engine-selection downgrade.
+const PLATFORM_EVENTS = [
+  "vector_cortex_engine_parity_checked",
+  "vector_cortex_engine_selection_demoted",
+] as const;
+
 /** GET /api/vector-cortex/platform — reader-only engine parity/selection aggregate (VC8C). */
 export function handleVectorCortexPlatform(
   req: IncomingMessage,
   res: ServerResponse,
-  _ctx: RouteContext,
+  ctx: RouteContext,
 ): boolean {
   const url = req.url ?? "";
   const path = url.split("?")[0] ?? url;
@@ -36,16 +45,19 @@ export function handleVectorCortexPlatform(
   }
 
   const enabled = VC8C_ENABLED();
+  const counts = countVcEvents(ctx.stateDir, PLATFORM_EVENTS);
   const mode: VectorCortexPlatformView["mode"] = enabled ? "A" : "C";
+  const fixtureCount = vcCount(counts, "vector_cortex_engine_parity_checked");
   const body: VectorCortexPlatformView = {
     enabled,
     mode,
-    fixtureCount: 0,
+    fixtureCount,
     passed: 0,
     failed: 0,
     externalRunnerConfigured: process.env.MEGACOMPACT_RUST_RUNNER !== undefined,
     lastFailure: null,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled, hasData: fixtureCount > 0 }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-policy.ts

@@ -20,6 +20,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./routes-core.js";
 import { VC8B_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type { VectorCortexPolicyView } from "./api-contracts/vector-cortex-policy.js";
 
 /** GET /api/vector-cortex/policy — reader-only policy + shadow aggregate (VC8B). */
@@ -50,6 +51,11 @@ export function handleVectorCortexPolicy(
     lastFailure: null,
     updatedAt: new Date().toISOString(),
     deferredReason: "shadow_controller_not_instantiated_v0_20_23",
+    status: deriveVcStatus({
+      enabled,
+      deferredReason: "shadow_controller_not_instantiated_v0_20_23",
+      hasData: false,
+    }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-query.ts

@@ -19,6 +19,7 @@ import { VC3C_ENABLED } from "../../src/config.js";
 import { ROUTER_KEY_VERSION } from "../../src/vector-cortex/topology/query.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import type { VectorCortexQueryView } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 /**
  * Reader-only GET /api/vector-cortex/query (VC3C query-layer diagnostics).
@@ -48,6 +49,7 @@ export function handleVectorCortexQuery(
     enabled,
     routerVersion: ROUTER_KEY_VERSION,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled, hasData: true, structuralOnly: true }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-reconstruct.ts

@@ -13,6 +13,7 @@ import { VC4C_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import { countVcEvents, vcCount } from "./vc-event-counts.js";
 import type { VectorCortexReconstructView } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 // Closure attempt/rejection events emitted by src/vector-cortex/heal/emit.ts.
 const RECONSTRUCT_EVENTS = [
@@ -43,6 +44,10 @@ export function handleVectorCortexReconstruct(
     spanTotal: 0,
     byteTotal: 0,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({
+      enabled,
+      hasData: vcCount(counts, "vector_cortex_closure_optimized") > 0,
+    }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-render.ts

@@ -21,6 +21,7 @@ import { PRO_IDS } from "../../src/vector-cortex/provider/types.js";
 import { KNOWN_PROVIDER_KEYS } from "../../src/vector-cortex/provider/registry.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import type { VectorCortexRenderView } from "./api-contracts/vector-cortex.js";
+import { deriveVcStatus } from "./vc-status.js";
 
 /** Reader-only GET /api/vector-cortex/render (VC5B). */
 export function handleVectorCortexRender(
@@ -43,6 +44,7 @@ export function handleVectorCortexRender(
     providerCount: enabled ? PRO_IDS.length : 0,
     knownProfiles: enabled ? KNOWN_PROVIDER_KEYS : [],
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({ enabled, hasData: true, structuralOnly: true }),
   };
   sendJson(res, 200, body);
   return true;

package/extensions/dashboard-server/routes-vector-cortex-repair.ts

@@ -26,6 +26,7 @@ import type { RouteContext } from "./routes-core.js";
 import { VC6C_ENABLED } from "../../src/config.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import { countVcEvents, vcCount } from "./vc-event-counts.js";
+import { deriveVcStatus } from "./vc-status.js";
 import type { VectorCortexRepairView } from "./api-contracts/vector-cortex.js";
 
 // Actual event names emitted by src/vector-cortex/heal/repair-emit.ts.
@@ -75,6 +76,10 @@ export function handleVectorCortexRepair(
     lastBackoffMs: null,
     lastFailure: null,
     updatedAt: new Date().toISOString(),
+    status: deriveVcStatus({
+      enabled,
+      hasData: vcCount(counts, "vector_cortex_repair_planned") > 0,
+    }),
   };
   sendJson(res, 200, body);
   return true;