pi-mega-compact 0.20.39 → 0.20.40

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

@@ -0,0 +1,42 @@
+/**
+ * dashboard-client/src/types/cortex-improve.ts — ML5-D Improve Cortex client types.
+ *
+ * Client-side mirrors of the server contract (extensions/dashboard-server/
+ * api-contracts/cortex-improve.ts), kept in lockstep so the ModelImprovementCard
+ * is fully typed end-to-end. The client bundle does not import the server tree,
+ * so these are redeclared here (PREVENT-011: no `any`; every type explicit).
+ * Aggregate values only — mode/verdict/digest/reason/progress, never payload
+ * bytes or corpus content (EVAL-REDACT-002).
+ */
+
+/** The five-head qualification verdict projected by an improve job. */
+export interface QualificationV1 {
+  readonly mode: "A" | "B" | "C";
+  readonly assetDigestPrefix: string | null;
+  readonly verdict: "qualified" | "demoted";
+  readonly reasonCode?: string;
+}
+
+/** Response body for POST /api/cortex/improve. */
+export interface CortexImproveStart {
+  readonly status: "improving";
+  readonly jobId: string;
+}
+
+/** Response body for GET /api/cortex/improve/status/:jobId. */
+export type CortexImproveStatus =
+  | {
+      readonly status: "improving";
+      readonly progress: number;
+    }
+  | {
+      readonly status: "qualified";
+      readonly progress: number;
+      readonly verdict: QualificationV1;
+      readonly assetDigest: string;
+    }
+  | {
+      readonly status: "demoted_to_B";
+      readonly progress: number;
+      readonly reason: string;
+    };

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

@@ -0,0 +1,82 @@
+/**
+ * api-contracts/cortex-improve.ts — ML5-D "Improve Cortex" job API types.
+ *
+ * Types for POST /api/cortex/improve (launch a local ML5-A training job that
+ * re-qualifies the five heads against the latest local corpus) and GET
+ * /api/cortex/improve/status/:jobId (poll the in-process job state to a
+ * terminal qualified / demoted_to_B verdict). Local-only, aggregate surfaces:
+ * mode / verdict / digest / reason / progress — never message content or corpus
+ * rows (EVAL-REDACT-002).
+ *
+ * PREVENT-PI-004: type definitions only, no network code.
+ * PREVENT-011: no `any` type — all types are explicit.
+ */
+
+/**
+ * The five-head qualification verdict projected from the improve job.
+ * Aggregate-only: current surrogate mode + asset digest prefix + a reason code
+ * when the asset failed to qualify (never weights or corpus content).
+ */
+export interface QualificationV1 {
+  /** Surrogate encoder mode the improve job would promote to on success. */
+  readonly mode: "A" | "B" | "C";
+  /** First 12 hex chars of the produced asset manifest digest, or null. */
+  readonly assetDigestPrefix: string | null;
+  /** Terminal verdict: qualified when the heads fit within gate, else demoted. */
+  readonly verdict: "qualified" | "demoted";
+  /** A stable reason code when verdict is "demoted" (e.g. ENC_ASSET_UNREADABLE). */
+  readonly reasonCode?: string;
+}
+
+/** Response body for POST /api/cortex/improve (confirmation-gated). */
+export interface CortexImproveStart {
+  /** Always "improving" immediately after the job is spawned. */
+  readonly status: "improving";
+  /** Opaque job token (sha256 of ts+random, hex-sliced), pollable via status. */
+  readonly jobId: string;
+}
+
+/** Lifecycle status of a Cortex improve job (in-process, restart-scoped). */
+export type CortexImproveJobStatus =
+  | "improving"
+  | "qualified"
+  | "demoted_to_B";
+
+/** Progressing (non-terminal) response for GET /api/cortex/improve/status/:jobId. */
+export interface CortexImproveProgress {
+  readonly status: "improving";
+  /** 0..1 progress through the local ML5-A training run. */
+  readonly progress: number;
+}
+
+/** Terminal success: the five heads re-qualified under mode A. */
+export interface CortexImproveQualified {
+  readonly status: "qualified";
+  readonly progress: number;
+  readonly verdict: QualificationV1;
+  readonly assetDigest: string;
+}
+
+/** Terminal demotion: the re-trained heads failed to qualify — stay mode B. */
+export interface CortexImproveDemoted {
+  readonly status: "demoted_to_B";
+  readonly progress: number;
+  readonly reason: string;
+}
+
+/** Response body for GET /api/cortex/improve/status/:jobId. */
+export type CortexImproveStatus =
+  | CortexImproveProgress
+  | CortexImproveQualified
+  | CortexImproveDemoted;
+
+/** Error body returned when the improve surface is disabled (flag off). */
+export interface CortexImproveDisabled {
+  readonly error: "disabled";
+}
+
+/** Request body for POST /api/cortex/improve. `confirm:true` is the server-side hard requirement. */
+export interface CortexImproveStartRequest {
+  /** Required explicit confirmation. Absent/false → 400 confirmation_required. */
+  readonly confirm: boolean;
+}

package/extensions/dashboard-server/api-contracts/endpoints/registry-ext.ts

@@ -25,6 +25,11 @@ import type {
   SetupCortexActionLogResponse,
 } from "../setup-cortex.js";
 import type { PrefixStabilityResponse } from "../prefix-stability.js";
+import type {
+  CortexImproveStartRequest,
+  CortexImproveStart,
+  CortexImproveStatus,
+} from "../cortex-improve.js";
 
 /** Additive endpoint entries spread into the ENDPOINTS registry. */
 export const EXTRA_ENDPOINTS = {
@@ -123,4 +128,30 @@ export const EXTRA_ENDPOINTS = {
 		undefined,
 		PrefixStabilityResponse
 	>,
+
+	// ─── ML5-D Improve Cortex (dashboard Vector Cortex tab) ───────────
+
+	/** POST /api/cortex/improve — launch a local ML5-A training job. */
+	improveCortex: {
+		method: "POST",
+		path: "/api/cortex/improve",
+		description:
+			"Launch a local ML5-A training job that re-qualifies the five heads against the latest local corpus and returns an opaque jobId. Requires confirm:true; flag-off returns 404. Local-only — never fetches anything.",
+	} as const satisfies EndpointDef<
+		"POST",
+		CortexImproveStartRequest,
+		CortexImproveStart
+	>,
+
+	/** GET /api/cortex/improve/status/:jobId — poll an improve job. */
+	improveCortexStatus: {
+		method: "GET",
+		path: "/api/cortex/improve/status/:jobId",
+		description:
+			"Poll an in-process Cortex improve job to terminal qualified / demoted_to_B. Unknown jobId or flag-off returns 404. Read-only, in-memory job state.",
+	} as const satisfies EndpointDef<
+		"GET",
+		undefined,
+		CortexImproveStatus
+	>,
 } as const;

package/extensions/dashboard-server/api-contracts/index.ts

@@ -323,3 +323,15 @@ export type {
 	ModelThresholdDeleteResponse,
 	ModelThresholdsError,
 } from "./model-thresholds.js";
+
+// ML5-D — dashboard "Improve Cortex" job API
+export type {
+	QualificationV1,
+	CortexImproveStart,
+	CortexImproveStatus,
+	CortexImproveProgress,
+	CortexImproveQualified,
+	CortexImproveDemoted,
+	CortexImproveDisabled,
+	CortexImproveStartRequest,
+} from "./cortex-improve.js";

package/extensions/dashboard-server/route-dispatch.ts

@@ -60,6 +60,8 @@ import {
 	handleSetupCortexStatus,
 	handleSetupCortexAction,
 	handleSetupCortexActionLog,
+	handleImproveCortex,
+	handleImproveCortexStatus,
 } from "./routes.js";
 // VC6C repair lives in its own module (routes-vector-cortex-repair.ts) so the
 // heal route file stays well under the 400-line extension soft limit.
@@ -154,5 +156,7 @@ export function dispatchRoutes(
 	if (handleSetupCortexStatus(req, res, ctx)) return true;
 	if (handleSetupCortexAction(req, res, ctx)) return true;
 	if (handleSetupCortexActionLog(req, res, ctx)) return true;
+	if (handleImproveCortex(req, res, ctx)) return true;
+	if (handleImproveCortexStatus(req, res, ctx)) return true;
 	return false;
 }

package/extensions/dashboard-server/routes-cortex-improve.ts

@@ -0,0 +1,256 @@
+/**
+ * dashboard-server/routes-cortex-improve.ts — ML5-D "Improve Cortex" job routes.
+ *
+ *   POST /api/cortex/improve          — confirmation-gated local ML5-A training
+ *   GET  /api/cortex/improve/status/:jobId — poll an in-process job to terminal
+ *
+ * The Improve action launches the committed ML5-A training pipeline
+ * (training/vector-cortex/train.py) as a background child_process against the
+ * latest local corpus, then re-qualifies the five heads. Job state is kept
+ * in-process in a Map<jobId, JobState> on this module; nothing is persisted
+ * across restarts (the status endpoint is read-only, in-memory).
+ *
+ * LOCAL ONLY (PREVENT-PI-004): the job spawns a local python process and reads
+ * local files — never a fetch. The `onnxruntime-node` native path is attempted
+ * only when MEGACOMPACT_ENCODER_NATIVE=1 (default OFF); otherwise the harness
+ * uses the WASM/trigram fallback. The status payload surfaces mode/verdict/
+ * digest/reason/progress only — never message or corpus content (EVAL-REDACT-002).
+ *
+ * Guardrails: PREVENT-011 (no `any`), PREVENT-001 (guarded JSON.parse via
+ * readJsonBody), flag-off byte-identical (no card + endpoints 404).
+ */
+
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { spawn } from "node:child_process";
+import { createHash, randomBytes } from "node:crypto";
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { RouteContext } from "./routes-core.js";
+import { sendJson, readJsonBody } from "./routes-vector-cortex-shared.js";
+import { ML5D_ENABLED } from "../../src/config.js";
+import { qualifyDecision } from "../../src/vector-cortex/improve.js";
+import type {
+  CortexImproveStart,
+  CortexImproveStatus,
+  QualificationV1,
+} from "./api-contracts/cortex-improve.js";
+
+/** Resolve the committed training entry by walking up to the repo root. */
+function trainingScript(): string | null {
+  let dir = dirname(fileURLToPath(import.meta.url));
+  const rel = join("training", "vector-cortex", "train.py");
+  for (let i = 0; i < 8; i++) {
+    // guardrails-allow PREVENT-PI-004: local script read (loopback)
+    const candidate = join(dir, rel);
+    if (existsSync(candidate)) return candidate;
+    const next = dirname(dir);
+    if (next === dir) break;
+    dir = next;
+  }
+  return null;
+}
+
+/** An in-process improve job (restart-scoped, never persisted). */
+interface JobState {
+  status: "improving" | "qualified" | "demoted_to_B";
+  progress: number;
+  verdict?: QualificationV1;
+  assetDigest?: string;
+  reason?: string;
+  updatedAt: string;
+}
+
+/** In-process job registry; nothing survives a server restart. */
+const JOBS = new Map<string, JobState>();
+
+/** Opaque job token: sha256(ts+random) hex-sliced. */
+function newJobId(): string {
+  return createHash("sha256")
+    .update(`${Date.now()}:${randomBytes(16).toString("hex")}`)
+    .digest("hex")
+    .slice(0, 24);
+}
+
+/**
+ * Spawn the ML5-A training pipeline in the background and drive the job state
+ * to a terminal qualified / demoted_to_B verdict. Honest: an empty corpus (the
+ * host state) makes train.py no-op and the job ends demoted_to_B.
+ */
+function startJob(jobId: string): void {
+  const script = trainingScript();
+  const boot = Date.now();
+  JOBS.set(jobId, { status: "improving", progress: 0, updatedAt: new Date().toISOString() });
+
+  if (script === null) {
+    settle(jobId, { status: "demoted_to_B", reason: "ENC_TRAIN_PIPELINE_ABSENT", progress: 1 });
+    return;
+  }
+
+  const env = { ...process.env };
+  const proc = spawn("python3", [script], {
+    env,
+    cwd: join(dirname(script), "..", ".."),
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+
+  let output = "";
+  const step = () => {
+    const pct = Math.min(0.9, 0.1 + ((Date.now() - boot) / 60000) * 0.6);
+    const cur = JOBS.get(jobId);
+    if (cur && cur.status === "improving" && pct > cur.progress) {
+      JOBS.set(jobId, { ...cur, progress: pct, updatedAt: new Date().toISOString() });
+    }
+  };
+  const timer = setInterval(step, 2000);
+  const stop = () => clearInterval(timer);
+
+  proc.stdout?.on("data", (d: Buffer) => {
+    output += d.toString();
+  });
+  proc.stderr?.on("data", (d: Buffer) => {
+    output += d.toString();
+  });
+  proc.on("error", (err) => {
+    stop();
+    settle(jobId, {
+      status: "demoted_to_B",
+      reason: `ENC_TRAIN_SPAWN_FAILED:${err.message}`,
+      progress: 1,
+    });
+  });
+  proc.on("close", (code) => {
+    stop();
+    // Read the produced trained-heads artifact digest. The report line includes
+    // `trainedHeadsPath`; verify the file exists after a successful run.
+    const match = /trainedHeadsPath":\s*"([^"]+)"/.exec(output);
+    const assetPath = match?.[1];
+    let digest: string | null = null;
+    if (assetPath) {
+      // guardrails-allow PREVENT-PI-004: local artifact read (loopback)
+      try {
+        digest = createHash("sha256")
+          .update(readFileSync(assetPath))
+          .digest("hex")
+          .slice(0, 12);
+      } catch {
+        digest = null;
+      }
+    }
+    const decision = qualifyDecision(code ?? -1, digest);
+    if (decision === "qualified") {
+      settle(jobId, {
+        status: "qualified",
+        progress: 1,
+        assetDigest: digest ?? undefined,
+        verdict: { mode: "A", assetDigestPrefix: digest ?? null, verdict: "qualified" },
+      });
+    } else {
+      settle(jobId, {
+        status: "demoted_to_B",
+        reason: assetPath
+          ? "trained asset did not verify — demoted to mode B"
+          : "empty corpus (no groups) — no qualified asset emitted",
+        progress: 1,
+      });
+    }
+  });
+}
+
+/** Write a terminal job state (idempotent — only advances from improving). */
+function settle(
+  jobId: string,
+  terminal: { status: "qualified" | "demoted_to_B"; progress: number; verdict?: QualificationV1; assetDigest?: string; reason?: string },
+): void {
+  const cur = JOBS.get(jobId);
+  if (cur && cur.status !== "improving") return;
+  JOBS.set(jobId, { ...terminal, updatedAt: new Date().toISOString() });
+}
+
+/** Flag-off response, byte-identical regardless of request (ML5-D absent). */
+function sendDisabled(res: ServerResponse): void {
+  sendJson(res, 404, { error: "disabled" });
+}
+
+/**
+ * POST /api/cortex/improve (ML5-D). Returns true when it claims the request.
+ * Requires `confirm:true` server-side (mirrors the client window.confirm).
+ */
+export function handleImproveCortex(
+  req: IncomingMessage,
+  res: ServerResponse,
+  _ctx: RouteContext,
+): boolean {
+  const url = req.url ?? "";
+  if (url !== "/api/cortex/improve") return false;
+  if (req.method !== "POST") {
+    sendJson(res, 405, { error: "method_not_allowed" });
+    return true;
+  }
+  if (!ML5D_ENABLED()) {
+    sendDisabled(res);
+    return true;
+  }
+  readJsonBody(req, (parsed) => {
+    if (!parsed.ok) {
+      sendJson(res, 400, { error: "invalid_body" });
+      return;
+    }
+    if (parsed.value.confirm !== true) {
+      sendJson(res, 400, { error: "confirmation_required" });
+      return;
+    }
+    const jobId = newJobId();
+    startJob(jobId);
+    const body: CortexImproveStart = { status: "improving", jobId };
+    sendJson(res, 200, body);
+  });
+  return true;
+}
+
+/**
+ * GET /api/cortex/improve/status/:jobId (ML5-D). Returns true when it claims the
+ * request. Flag-off or unknown jobId → 404. Read-only in-memory.
+ */
+export function handleImproveCortexStatus(
+  req: IncomingMessage,
+  res: ServerResponse,
+  _ctx: RouteContext,
+): boolean {
+  const url = req.url ?? "";
+  const match = /^\/api\/cortex\/improve\/status\/([A-Za-z0-9]+)$/.exec(url);
+  if (!match) return false;
+  if (req.method !== "GET") {
+    sendJson(res, 405, { error: "method_not_allowed" });
+    return true;
+  }
+  if (!ML5D_ENABLED()) {
+    sendDisabled(res);
+    return true;
+  }
+  const job = JOBS.get(match[1]);
+  if (!job) {
+    sendJson(res, 404, { error: "job_not_found" });
+    return true;
+  }
+  // Narrow job.status into the discriminated CortexImproveStatus variant. The
+  // terminal shapes require their payload fields, so construct per-state.
+  const body: CortexImproveStatus =
+    job.status === "improving"
+      ? { status: "improving", progress: job.progress }
+      : job.status === "qualified"
+        ? {
+            status: "qualified",
+            progress: job.progress,
+            verdict:
+              job.verdict ?? { mode: "A", assetDigestPrefix: null, verdict: "qualified" },
+            assetDigest: job.assetDigest ?? "",
+          }
+        : {
+            status: "demoted_to_B",
+            progress: job.progress,
+            reason: job.reason ?? "UNKNOWN_TERMINAL",
+          };
+  sendJson(res, 200, body);
+  return true;
+}

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

@@ -234,5 +234,11 @@ export const VECTOR_CORTEX_SETTINGS: SettingGroup = {
 			"ML5-C runtime backend selection (WASM vs native): selects the ONNX runtime backend based on the ML5-B bench record and platform support. ON (default) = the runtime-selection dispatch runs and emits vector_cortex_runtime_selected. OFF = no selection runs — encoder serves mode B trigram, byte-identical to ML5-B.",
 			true,
 		),
+		boolDirect(
+			"MEGACOMPACT_ML5_D",
+			"ML5-D Dashboard Improve Cortex",
+			"ML5-D dashboard 'Improve Cortex' surface: the ModelImprovementCard + POST /api/cortex/improve + GET /api/cortex/improve/status/:jobId. ON (default) = the card renders and Improve launches a local ML5-A training job. OFF = both improve endpoints return 404 and VectorCortexTab omits the card, byte-identical to ML5-C.",
+			true,
+		),
 	],
 };

package/extensions/dashboard-server/routes.ts

@@ -62,3 +62,7 @@ export {
 	handleSetupCortexAction,
 	handleSetupCortexActionLog,
 } from "./routes-setup-cortex-actions.js";
+export {
+	handleImproveCortex,
+	handleImproveCortexStatus,
+} from "./routes-cortex-improve.js";

package/extensions/mega-runtime/dashboard-snapshot.ts

@@ -159,8 +159,8 @@ export function buildDashboardSnapshot(ctx: SnapshotBuildContext): DashboardSnap
 			// per-session in rt and there's no cumulative counter yet.
 			total: ctx.repo.dedupCollapsed,
 			sessionTokensSaved: ctx.rt.cacheHitTokens,
-			// Cumulative tokens saved across all sessions in this repo —
-			// was a placeholder (dedupCollapsed * 100).
+			// Cumulative tokens saved across all sessions in this repo = the
+			// real repo counter (audit Table 1 stub 8 closed — no rolled-up math).
 			totalTokensSaved: ctx.repo.tokensSaved,
 		},
 		compacts: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.20.39",
+  "version": "0.20.40",
   "description": "Layered, local, vector-backed context compressor for pi — supersede/collapse/cluster compaction with deduped inline recall.",
   "type": "module",
   "license": "BSD-3-Clause",

package/src/config/vector-cortex-ml5d.ts

@@ -0,0 +1,30 @@
+/**
+ * config/vector-cortex-ml5d.ts — ML5-D dashboard "Improve Cortex" flag.
+ *
+ * Sibling extract mirroring vector-cortex-ml5a.ts / vector-cortex-ml5b.ts /
+ * vector-cortex-ml5c.ts, so vector-cortex.ts stays under its 300-line soft
+ * limit (soft-as-hard gate). This is the dashboard "Improve Cortex" surface +
+ * promote workflow sprint flag.
+ * vector-cortex.ts re-exports the ENUM below and root src/config.ts re-exports
+ * it, so no consumer import path changes.
+ *
+ * ML5-D adds the dashboard ModelImprovementCard + the POST /api/cortex/improve
+ * and GET /api/cortex/improve/status/:jobId endpoints. The flag gates that
+ * surface only; when OFF the endpoints return 404/disabled and VectorCortexTab
+ * renders exactly as before (byte-identical to the ML5-C-era tab — no
+ * ModelImprovementCard, no improve job is ever spawned).
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+
+import { sprintFlag } from "./vector-cortex-flag.js";
+
+/**
+ * ML5-D — dashboard "Improve Cortex" surface + promote workflow. Default ON.
+ * `MEGACOMPACT_ML5_D=0` disables and is byte-identical to the ML5-C survivor:
+ * both `/api/cortex/improve*` endpoints return 404 and VectorCortexTab omits the
+ * ModelImprovementCard. The flag gates the dashboard surface only; it does not
+ * gate the underlying ML5-A training pipeline or the encoder's mode-A/B/C
+ * selection (those are governed by ML5-A and the encoder independently).
+ */
+export const ML5D_ENABLED = (): boolean => sprintFlag("MEGACOMPACT_ML5_D");

package/src/config/vector-cortex.ts

@@ -269,8 +269,7 @@ export const VC8A_ENABLED = (): boolean => sprintFlag("MEGACOMPACT_VC8A");
  */
 export const VC8B_ENABLED = (): boolean => sprintFlag("MEGACOMPACT_VC8B");
 
-// VC8C (canary selection + Rust parity) extracted to vector-cortex-vc8c.ts;
-// re-exported so existing `./config/vector-cortex.js` imports keep resolving.
+// VC8C (canary selection + Rust parity) extracted to vector-cortex-vc8c.ts; re-exported so existing imports keep resolving.
 export { VC8C_ENABLED } from "./vector-cortex-vc8c.js";
 // Sibling extracts to stay under the 300-line soft limit.
 export { VC9A_ENABLED } from "./vector-cortex-vc9a.js";
@@ -281,6 +280,7 @@ export { PCC_ENABLED } from "./vector-cortex-pcc.js";
 export { ML5A_ENABLED } from "./vector-cortex-ml5a.js";
 export { ML5B_ENABLED } from "./vector-cortex-ml5b.js";
 export { ML5C_ENABLED } from "./vector-cortex-ml5c.js";
+export { ML5D_ENABLED } from "./vector-cortex-ml5d.js";
 
 // Breaker constants (TRIAD_RESILIENCE.md §breaker) extracted to vector-cortex-breakers.ts.
 export {

package/src/config.ts

@@ -186,6 +186,7 @@ export {
   ML5A_ENABLED,
   ML5B_ENABLED,
   ML5C_ENABLED,
+  ML5D_ENABLED,
   BREAKER_WINDOW_MS,
   BREAKER_MIN_ATTEMPTS,
   BREAKER_PERF_FAILURES,

package/src/vector-cortex/improve.ts

@@ -0,0 +1,28 @@
+/**
+ * vector-cortex/improve.ts — ML5-D "Improve Cortex" pure decision rule.
+ *
+ * The single pure decision of the improve job harness: given the training
+ * process exit code and whether a readable produced-asset digest exists,
+ * decide whether the five heads qualify (promote) or are demoted to mode B.
+ *
+ * Lives under src/ so both the dashboard-server route (routes-cortex-improve.ts)
+ * and the ML5-D acceptance aggregator (dist/vector-cortex/ml5d-acceptance.test.js)
+ * can import it — the mirrored dist/vector-cortex/ subtree carries this file via
+ * the publish-acceptance copyTree, so the acceptance suite needs no real
+ * training run.
+ *
+ * Pure, total over its inputs, zero I/O (PREVENT-PI-004 / PREVENT-011).
+ */
+
+/**
+ * Terminal decision for an improve job: qualified only when the training
+ * process exited 0 AND a readable produced-asset digest exists; otherwise the
+ * job is demoted to mode B (honest degradation — an empty corpus or a failed
+ * train never fabricates a promotion).
+ */
+export function qualifyDecision(
+  exitCode: number,
+  assetDigest: string | null,
+): "qualified" | "demoted_to_B" {
+  return exitCode === 0 && assetDigest !== null ? "qualified" : "demoted_to_B";
+}

package/extensions/dashboard-client/dist/assets/MemoryMapTab-BFy0hb6F.js

@@ -1,2 +0,0 @@
-import{j as e,r as u,a1 as V,a2 as z}from"./index-DqjmZ88m.js";import{T as P}from"./toggle-MQQwdkwD.js";const S={checkpoint:"#6366f1",turn:"#58a6ff","turn-content":"#22c55e",memory:"#f59e0b"},U={checkpoint:"Checkpoint",turn:"Turn","turn-content":"Turn Content",memory:"Memory"};function Y(t,s){return`M 0,-${s} L ${t},0 L 0,${s} L -${t},0 Z`}function Q(t){return!t||t==="active"?1:.5}function X(t,s,l,h,n,p,c){const x=p?S[h]??"#6366f1":"#d1d5db",i=n?"#ef4444":"none",m=Q(c);switch(h){case"checkpoint":return e.jsx("circle",{cx:t,cy:s,r:n?l+3:l,fill:x,opacity:m,stroke:i,strokeWidth:n?2:0});case"turn":return e.jsx("circle",{cx:t,cy:s,r:n?l+3:l,fill:"none",stroke:x,strokeWidth:2.5,opacity:m});case"turn-content":return e.jsxs("g",{children:[e.jsx("circle",{cx:t,cy:s,r:n?l+3:l,fill:"none",stroke:x,strokeWidth:2.5,opacity:m}),e.jsx("circle",{cx:t,cy:s,r:Math.max(3,l*.3),fill:x,opacity:m})]});case"memory":const d=l*.85,g=l*.85;return e.jsx("path",{d:Y(d,g),transform:`translate(${t}, ${s})`,fill:x,opacity:m,stroke:i,strokeWidth:n?2:0})}}const Z=5e3,O=.005,D=.01,_=.9,J=.1,L=50;function K(t){const s=t.nodes.map((n,p)=>{const c=2*Math.PI*p/Math.max(t.nodes.length,1),x=200;return{...n,pos:{x:Math.cos(c)*x+300,y:Math.sin(c)*x+200},vx:0,vy:0,pinned:!1}}),l=new Map;s.forEach((n,p)=>l.set(n.id,p));const h=t.edges.map(n=>{const p=l.get(n.source),c=l.get(n.target);return p===void 0||c===void 0||p===c?null:{source:p,target:c,weight:n.weight,type:n.type}}).filter(n=>n!==null);return{nodes:s,edges:h}}function ee(t){const{nodes:s,edges:l}=t,h=s.length;if(h!==0)for(let n=0;n<h;n++){if(s[n].pinned)continue;let p=0,c=0;for(let i=0;i<h;i++){if(n===i)continue;const m=s[n].pos.x-s[i].pos.x,d=s[n].pos.y-s[i].pos.y,g=m*m+d*d||1,v=Z/g,y=Math.sqrt(g);p+=m/y*v,c+=d/y*v}for(const i of l){let m;if(i.source===n)m=i.target;else if(i.target===n)m=i.source;else continue;const d=s[m].pos.x-s[n].pos.x,g=s[m].pos.y-s[n].pos.y;p+=d*O*i.weight,c+=g*O*i.weight}p-=s[n].pos.x*D,c-=s[n].pos.y*D,s[n].vx=(s[n].vx+p)*_,s[n].vy=(s[n].vy+c)*_;const x=Math.sqrt(s[n].vx*s[n].vx+s[n].vy*s[n].vy);x>L&&(s[n].vx=s[n].vx/x*L,s[n].vy=s[n].vy/x*L),x>J&&(s[n].pos.x+=s[n].vx,s[n].pos.y+=s[n].vy)}}const te=300,re=.3,k=900,w=600,f=40;function M(t){switch(t){case"temporal":return"#6366f1";case"semantic":return"#22c55e";case"raptor_parent":return"#f59e0b"}}const N=({color:t,shape:s,label:l})=>{const h={display:"inline-block",width:"10px",height:"10px",verticalAlign:"middle",marginRight:"3px",borderRadius:s.startsWith("hollow")||s==="filled-circle"?"50%":void 0};let n;return s==="line"?e.jsx("span",{style:{color:t,marginRight:"6px"},children:l}):(s==="filled-circle"?n=e.jsx("span",{style:{...h,backgroundColor:t}}):s==="hollow-circle"?n=e.jsx("span",{style:{...h,border:`2px solid ${t}`,backgroundColor:"transparent"}}):s==="hollow-ring"?n=e.jsx("span",{style:{...h,border:`2px solid ${t}`,backgroundColor:"transparent",position:"relative"},children:e.jsx("span",{style:{display:"block",width:"4px",height:"4px",borderRadius:"50%",backgroundColor:t,margin:"2px auto"}})}):n=e.jsx("span",{style:{...h,clipPath:"polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%)",backgroundColor:t}}),e.jsxs(e.Fragment,{children:[e.jsxs("span",{className:"memory-map-legend-item",children:[n,l]})," "]}))},se=()=>{const[t,s]=u.useState(null),[l,h]=u.useState(!0),[n,p]=u.useState(null),[c,x]=u.useState(null),[i,m]=u.useState(""),[d]=u.useState(""),[g,v]=u.useState(0),y=u.useRef(null),T=u.useRef(0);u.useEffect(()=>{let r=!1;const o=new URLSearchParams;return d&&o.set("sessionId",d),o.set("threshold","0.7"),o.set("maxEdgesPerNode","4"),h(!0),p(null),fetch(`/api/memory-map?${o.toString()}`).then(a=>{if(!a.ok)throw new Error(`HTTP ${a.status}`);return a.json()}).then(a=>{r||(s(a),y.current=K(a),v(1),h(!1))}).catch(a=>{r||(p(a instanceof Error?a.message:"Unknown error"),h(!1))}),()=>{r=!0,cancelAnimationFrame(T.current)}},[d]),u.useEffect(()=>{if(!y.current||g===0)return;const r=y.current;let o=0;const a=()=>{o>=te||(ee(r),o++,v(o),T.current=requestAnimationFrame(a))};return T.current=requestAnimationFrame(a),()=>cancelAnimationFrame(T.current)},[g]);const F=u.useCallback((r,o)=>{const a=y.current;a&&(a.nodes[o].pinned=!a.nodes[o].pinned,a.nodes[o].pinned||(a.nodes[o].vx=0,a.nodes[o].vy=0),x(b=>b?.id===r.id?null:r),v(b=>b+1))},[]),A=u.useMemo(()=>{const r=y.current;if(!r||!i)return null;const o=i.toLowerCase();return new Set(r.nodes.map((a,b)=>a.summaryTruncated.toLowerCase().includes(o)||a.label.toLowerCase().includes(o)?b:-1).filter(a=>a>=0))},[i]),C=u.useMemo(()=>{const r=t?.validation;return r?r.gatesPassed<r.gatesRun?{level:"red",label:"Gate failure"}:r.warnings.length>0?{level:"yellow",label:`${r.warnings.length} warning(s)`}:{level:"green",label:"Healthy"}:{level:"yellow",label:"No validation"}},[t?.validation]),W={green:"#22c55e",yellow:"#eab308",red:"#ef4444"},H=u.useMemo(()=>{const r=t?.validation;if(!r)return`${t?.metadata.totalNodes??0} nodes`;const o=[];return r.sources.checkpoint>0&&o.push(`${r.sources.checkpoint} checkpoints`),r.sources.turn>0&&o.push(`${r.sources.turn} turns`),r.sources.turnContent>0&&o.push(`${r.sources.turnContent} turn-content`),r.sources.memory>0&&o.push(`${r.sources.memory} memories`),o.length===0&&o.push(`${t?.metadata.totalNodes??0} nodes`),o.join(" · ")},[t?.validation,t?.metadata.totalNodes]),I=u.useMemo(()=>{const r=t?.validation;if(!r)return"";const o=[];return o.push(r.sources.checkpoint>0?"✓ checkpoints":"✗ checkpoints"),o.push(r.sources.turn>0?"✓ turns":"✗ turns"),o.push(r.sources.turnContent>0?"✓ turn-content":"✗ turn-content"),o.push(r.sources.memory>0?"✓ memories":"✗ memories"),o.join(" | ")},[t?.validation]),B=u.useMemo(()=>{const r=t?.validation;return r?r.sources.checkpoint===0&&r.sources.turn===0&&r.sources.turnContent===0&&r.sources.memory===0:t?.metadata.totalNodes===0},[t?.validation,t?.metadata.totalNodes]);if(l)return e.jsx("div",{className:"rounded-lg border border-border bg-bg-card p-6 text-center text-sm text-muted-foreground",children:"Loading memory graph..."});if(n)return e.jsxs("div",{className:"rounded-lg border border-border bg-bg-card p-6 text-center text-sm",children:[e.jsxs("p",{className:"text-red-400",children:["Failed to load memory map: ",n]}),e.jsx("button",{className:"mt-3 rounded-md border border-border px-3 py-1.5 text-sm transition-colors hover:bg-bg-elevated hover:text-foreground",onClick:()=>v(r=>r+1),children:"Retry"})]});if(!t||!y.current||B)return e.jsx("div",{className:"rounded-lg border border-border bg-bg-card p-6 text-sm text-muted-foreground",children:e.jsx("p",{children:"Memories appear after your first compaction. The graph shows checkpoints (compaction summaries) linked by semantic similarity and time. Run a longer session or lower the compaction tier to see it sooner."})});const j=y.current;return e.jsxs("div",{className:"flex flex-col gap-3",children:[e.jsxs("div",{className:"flex flex-wrap items-center gap-3",children:[e.jsx("input",{type:"text",placeholder:"Search memories...",value:i,onInput:r=>m(r.target.value),className:"w-56 rounded-md border border-border bg-bg-elevated/50 px-3 py-2 text-sm outline-none transition-colors focus:border-primary"}),e.jsxs("span",{className:"text-xs text-muted-foreground",children:[e.jsx("span",{children:H})," · ",e.jsxs("span",{children:[t.edges.length," edges"]})]}),e.jsx("span",{className:"ml-auto rounded-full px-2 py-1 text-[11px] font-semibold text-white",style:{backgroundColor:W[C.level]??"#6b7280"},title:`Validation: ${C.label}`,children:C.level==="green"?"Healthy":C.level==="yellow"?"Warnings":"Critical"})]}),I?e.jsx("div",{className:"text-[11px] text-muted-foreground",children:I}):null,e.jsxs("div",{className:"flex flex-wrap items-center gap-x-4 gap-y-1 rounded-lg border border-border/60 bg-bg-card px-3 py-2 text-xs",children:[e.jsx("span",{className:"font-semibold text-muted-foreground",children:"Nodes:"}),e.jsx(N,{type:"node",color:S.checkpoint,shape:"filled-circle",label:"Checkpoint"}),e.jsx(N,{type:"node",color:S.turn,shape:"hollow-circle",label:"Turn"}),e.jsx(N,{type:"node",color:S["turn-content"],shape:"hollow-ring",label:"Turn Content"}),e.jsx(N,{type:"node",color:S.memory,shape:"diamond",label:"Memory"}),e.jsx("span",{className:"font-semibold text-muted-foreground",children:"Edges:"}),e.jsx(N,{type:"edge",color:M("semantic"),shape:"line",label:"Semantic"}),e.jsx(N,{type:"edge",color:M("temporal"),shape:"line",label:"Temporal"}),e.jsx(N,{type:"edge",color:M("raptor_parent"),shape:"line",label:"Raptor"})]}),e.jsxs("svg",{width:k,height:w,viewBox:`0 0 ${k} ${w}`,className:"memory-map-svg",children:[j.edges.map((r,o)=>{const a=j.nodes[r.source],b=j.nodes[r.target],R=M(r.type),E=Math.max(1,r.weight*2.5);return e.jsx("line",{x1:f+a.pos.x/(j.nodes.length||1)*(k-2*f),y1:f+a.pos.y/(j.nodes.length||1)*(w-2*f),x2:f+b.pos.x/(j.nodes.length||1)*(k-2*f),y2:f+b.pos.y/(j.nodes.length||1)*(w-2*f),stroke:R,strokeWidth:E,opacity:re},`edge-${o}`)}),j.nodes.map((r,o)=>{const a=f+r.pos.x/(j.nodes.length||1)*(k-2*f),b=f+r.pos.y/(j.nodes.length||1)*(w-2*f),R=Math.min(20,8+r.tokenEstimate/500),E=A?A.has(o):!0,G=c?.id===r.id,q=r.label.length>20?r.label.slice(0,18)+"...":r.label;return e.jsxs("g",{className:"memory-map-node-group",onClick:()=>F(r,o),style:{cursor:"pointer"},children:[X(a,b,R,r.nodeType,G,E,r.dedupStatus),e.jsx("text",{x:a,y:b+R+12,textAnchor:"middle",fontSize:"9px",fill:"#374151",className:"memory-map-label",children:q})]},`node-${o}`)})]}),c?e.jsxs("div",{className:"rounded-lg border border-border/60 bg-bg-card p-4 text-sm",children:[e.jsxs("h3",{className:"font-heading text-base font-semibold",children:[e.jsx("span",{className:"mr-1.5 text-xs font-normal text-muted-foreground",children:U[c.nodeType]}),c.label]}),e.jsx("p",{className:"mt-1",children:c.summaryTruncated}),c.topicSummary?e.jsxs("p",{className:"mt-1",children:["Topic: ",c.topicSummary]}):null,e.jsxs("p",{className:"mt-1",children:["Tokens: ",c.tokenEstimate," | Decisions: ",c.decisionCount]}),e.jsxs("p",{children:["Session: ",c.sessionId]}),e.jsxs("p",{children:["Raptor Level: ",c.raptorLevel]}),e.jsx("p",{className:"mt-1 text-muted-foreground",children:c.textSnippet})]}):null]})};function ne(t){return t===0?"#d4a017":t===1?"#3b82f6":"#14b8a6"}function $(t){return t?new Date(t).toLocaleString():"—"}function oe({node:t}){const s=ne(t.level),l=t.children.length>0?`${t.children.length} child${t.children.length===1?"":"ren"}`:"leaf";return e.jsxs("div",{style:{background:"#14142b",border:`1px solid ${s}`,borderRadius:"8px",padding:"0.75rem 1rem",marginBottom:"0.6rem",marginLeft:t.level*24,maxWidth:"90%"},children:[e.jsxs("div",{style:{display:"flex",gap:"0.75rem",alignItems:"center",marginBottom:"0.35rem"},children:[e.jsxs("span",{style:{display:"inline-block",background:s,color:"#fff",borderRadius:"10px",padding:"1px 8px",fontSize:"11px",fontWeight:600},children:["L",t.level]}),e.jsxs("span",{style:{fontSize:"12px",color:"#6b7280"},children:[l," · ",t.tokenEstimate," tok · ",t.qualityMarker]}),e.jsx("span",{style:{fontSize:"12px",color:"#6b7280",marginLeft:"auto"},children:$(t.builtAt)})]}),e.jsx("div",{style:{fontSize:"0.92rem",color:"#e5e7eb"},children:t.summary})]})}function le(){const[t,s]=u.useState(null),[l,h]=u.useState(null),[n,p]=u.useState(!0),[c,x]=u.useState(null);if(u.useEffect(()=>{let d=!1;return p(!0),x(null),Promise.all([V(),z()]).then(([g,v])=>{d||(s(g),h(v),p(!1))}).catch(g=>{d||(x(g instanceof Error?g.message:"Unknown error"),p(!1))}),()=>{d=!0}},[]),n)return e.jsx("div",{className:"rounded-lg border border-border bg-bg-card p-6 text-center text-sm text-muted-foreground",children:"Loading RAPTOR tree..."});if(c)return e.jsx("div",{className:"rounded-lg border border-dashed border-border bg-bg-card p-8 text-center text-sm",children:e.jsxs("p",{className:"text-red-400",children:["Failed to load RAPTOR tree: ",c]})});if(!t||t.empty||t.nodes.length===0)return e.jsx("div",{className:"rounded-lg border border-dashed border-border bg-bg-card p-8 text-center text-sm text-muted-foreground",children:e.jsx("p",{children:"No RAPTOR tree built yet — run a compaction (the tree builds during compaction)."})});const i=l&&!l.empty?l.builds[0]:null,m=i?.coherenceScore!=null?Math.round(i.coherenceScore*100):null;return e.jsxs("div",{className:"w-full p-4",children:[e.jsxs("div",{className:"mb-4 flex items-center gap-6 text-sm text-muted-foreground",children:[e.jsxs("span",{children:[e.jsx("strong",{children:t.nodes.length})," nodes"]}),e.jsxs("span",{children:[e.jsx("strong",{children:t.levels+1})," levels"]}),e.jsxs("span",{children:["Built ",$(t.builtAt??0)]}),i&&e.jsxs(e.Fragment,{children:[e.jsxs("span",{children:["Coherence:"," ",e.jsx("strong",{style:{color:m!=null&&m>=70?"#22c55e":"#f59e0b"},children:m!=null?`${m}%`:"—"})]}),e.jsxs("span",{children:["Leaves: ",e.jsx("strong",{children:i.leafCount})]}),e.jsxs("span",{children:["Depth: ",e.jsx("strong",{children:i.depth})]}),i.timedOut&&e.jsx("span",{style:{color:"#ef4444"},children:"budget timeout"})]})]}),l&&!l.empty&&l.builds.length>1&&e.jsxs("details",{className:"mb-4",children:[e.jsxs("summary",{className:"cursor-pointer text-xs text-muted-foreground",children:["Build history (",l.builds.length," builds)"]}),e.jsx("div",{className:"mt-2 space-y-1",children:l.builds.slice(0,10).map(d=>e.jsxs("div",{className:"flex items-center gap-4 text-xs text-muted-foreground",children:[e.jsx("span",{children:$(d.completedAt)}),e.jsxs("span",{children:[d.nodeCount," nodes"]}),e.jsxs("span",{children:[d.leafCount," leaves"]}),e.jsxs("span",{children:["depth ",d.depth]}),e.jsxs("span",{children:["coherence"," ",d.coherenceScore!=null?`${Math.round(d.coherenceScore*100)}%`:"—"]}),d.timedOut&&e.jsx("span",{style:{color:"#ef4444"},children:"timeout"})]},d.buildId))})]}),t.nodes.map(d=>e.jsx(oe,{node:d},d.id))]})}const ie=()=>{const[t,s]=u.useState("map");return e.jsxs("div",{className:"flex flex-col gap-4",children:[e.jsxs("nav",{className:"flex gap-2 border-b border-border pb-2 pt-2","aria-label":"Memory map sections",children:[e.jsx(P,{pressed:t==="map",onClick:()=>s("map"),"aria-label":"Memory Map view",children:"Memory Map"}),e.jsx(P,{pressed:t==="raptor",onClick:()=>s("raptor"),"aria-label":"RAPTOR Tree view",children:"RAPTOR Tree"})]}),t==="map"&&e.jsx(se,{}),t==="raptor"&&e.jsx(le,{})]})};export{ie as default};
-//# sourceMappingURL=MemoryMapTab-BFy0hb6F.js.map