pi-mega-compact 0.20.53 → 0.20.55

package/extensions/dashboard-server/api-contracts/cosine-fp.ts

@@ -0,0 +1,81 @@
+/**
+ * api-contracts/cosine-fp.ts — cosine-FP report API contract (COS-FP-A).
+ *
+ * Reader-only shape for GET /api/cosine-fp-report: the last written synthetic
+ * bench aggregate + report digest + recommendation. The bench emits counts +
+ * fractions + digests ONLY (EVAL-REDACT-002) — never template text. No `any`.
+ */
+
+/** Derived endpoint status (from vc-status.ts). */
+export type CosineFpStatus = "live" | "awaiting_data" | "deferred" | "structural" | "off";
+
+/** The bench aggregate's own outcome label. */
+export type CosineFpBenchStatus = "ok" | "no_data" | "off" | "awaiting_data";
+
+export interface CosineFpGrid {
+  readonly lo: number;
+  readonly hi: number;
+  readonly step: number;
+  readonly points: number;
+}
+
+export interface CosineFpPerTypeCounts {
+  readonly items: number;
+  readonly dup: number;
+  readonly near: number;
+  readonly clean: number;
+}
+
+export interface CosineFpPerTypeResult {
+  readonly fp: number;
+  readonly fpRate: number | null;
+  readonly fn: number;
+  readonly fnRate: number | null;
+}
+
+export interface CosineFpPerTypeRow {
+  readonly code: CosineFpPerTypeResult;
+  readonly prose: CosineFpPerTypeResult;
+  readonly mixed: CosineFpPerTypeResult;
+}
+
+export interface CosineFpRow {
+  readonly threshold: number;
+  readonly overallFpRate: number | null;
+  readonly overallFnRate: number | null;
+  readonly overallF1: number | null;
+  readonly perType: CosineFpPerTypeRow;
+}
+
+export interface CosineFpCorpusSummary {
+  readonly items: number;
+  readonly pairs: number;
+  readonly types: string[];
+  readonly perType: Readonly<Record<string, CosineFpPerTypeCounts>>;
+  readonly digest: string | null;
+}
+
+export interface CosineFpOverrides {
+  readonly code: number | null;
+  readonly prose: number | null;
+  readonly mixed: number | null;
+}
+
+/** Response body for GET /api/cosine-fp-report. */
+export interface CosineFpReportV1 {
+  /** Derived endpoint status (deriveVcStatus): off (flag) / awaiting_data (no run). */
+  readonly status: CosineFpStatus;
+  /** Outcome the bench itself recorded: ok / no_data / off / awaiting_data. */
+  readonly benchStatus: CosineFpBenchStatus;
+  readonly seed: number | null;
+  readonly grid: CosineFpGrid | null;
+  readonly corpusSummary: CosineFpCorpusSummary | null;
+  readonly rows: CosineFpRow[] | null;
+  readonly recommendedDefault: number | null;
+  readonly shippedDefault: number;
+  readonly overrides: CosineFpOverrides | null;
+  readonly fpBudget: number | null;
+  readonly digest: string | null;
+  /** mtime (epoch ms) of the bench-run aggregate file backing this response. */
+  readonly reportFileMtime: number | null;
+}

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

@@ -31,6 +31,7 @@ import type {
   CortexImproveStatus,
 } from "../cortex-improve.js";
 import type { DedupTierAttributionResponse } from "../dedup-attribution.js";
+import type { CosineFpReportV1 } from "../cosine-fp.js";
 
 /** Additive endpoint entries spread into the ENDPOINTS registry. */
 export const EXTRA_ENDPOINTS = {
@@ -169,4 +170,14 @@ export const EXTRA_ENDPOINTS = {
 		undefined,
 		DedupTierAttributionResponse
 	>,
+
+	// ─── COS-FP-A cosine threshold report ────────────────────────────
+
+	/** GET /api/cosine-fp-report — reader-only synthetic FP bench recommendation. */
+	cosineFpReport: {
+		method: "GET",
+		path: "/api/cosine-fp-report",
+		description:
+			"Reader-only cosine-FP report (COS-FP-A): the last written synthetic bench aggregate — grid summary, per-content-type FP/FN/F1, recommended default, report digest. Counts + fractions + digests only, never template text. Missing report → awaiting_data; flag-off returns 404.",
+	} as const satisfies EndpointDef<"GET", undefined, CosineFpReportV1>,
 } as const;

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

@@ -343,3 +343,17 @@ export type {
 	DedupTierAccumulator,
 	DedupTierAttributionResponse,
 } from "./dedup-attribution.js";
+
+// COS-FP-A — synthetic cosine threshold report
+export type {
+	CosineFpStatus,
+	CosineFpBenchStatus,
+	CosineFpGrid,
+	CosineFpPerTypeCounts,
+	CosineFpPerTypeResult,
+	CosineFpPerTypeRow,
+	CosineFpRow,
+	CosineFpCorpusSummary,
+	CosineFpOverrides,
+	CosineFpReportV1,
+} from "./cosine-fp.js";

package/extensions/dashboard-server/assets/cosine-fp-report.json

@@ -0,0 +1 @@
+{"corpusSummary":{"digest":"53f87630c2fa1ee5c4020d025fda56caae5020110bb12521e6c9a85981e180c5","items":72,"pairs":2556,"perType":{"code":{"clean":8,"dup":8,"items":24,"near":8},"mixed":{"clean":8,"dup":8,"items":24,"near":8},"prose":{"clean":8,"dup":8,"items":24,"near":8}},"types":["code","prose","mixed"]},"digest":"2312c120c43c75ff46db9fc8f362c25df879a54862790d8d2cbac2e88466d646","fpBudget":0.05,"grid":{"hi":0.98,"lo":0.8,"points":37,"step":0.005},"overrides":{"code":0.915,"mixed":0.955,"prose":0.95},"recommendedDefault":0.815,"rows":[{"overallF1":0.1279,"overallFnRate":0.9314,"overallFpRate":0.0612,"perType":{"code":{"fn":128,"fnRate":0.8205,"fp":23,"fpRate":0.1917},"mixed":{"fn":135,"fnRate":0.8654,"fp":13,"fpRate":0.1083},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.8},{"overallF1":0.1255,"overallFnRate":0.9328,"overallFpRate":0.0576,"perType":{"code":{"fn":128,"fnRate":0.8205,"fp":22,"fpRate":0.1833},"mixed":{"fn":135,"fnRate":0.8654,"fp":12,"fpRate":0.1},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.805},{"overallF1":0.1182,"overallFnRate":0.937,"overallFpRate":0.0532,"perType":{"code":{"fn":131,"fnRate":0.8397,"fp":21,"fpRate":0.175},"mixed":{"fn":136,"fnRate":0.8718,"fp":10,"fpRate":0.0833},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.81},{"overallF1":0.1133,"overallFnRate":0.9398,"overallFpRate":0.0488,"perType":{"code":{"fn":131,"fnRate":0.8397,"fp":18,"fpRate":0.15},"mixed":{"fn":139,"fnRate":0.891,"fp":9,"fpRate":0.075},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.815},{"overallF1":0.112,"overallFnRate":0.9405,"overallFpRate":0.0488,"perType":{"code":{"fn":131,"fnRate":0.8397,"fp":18,"fpRate":0.15},"mixed":{"fn":139,"fnRate":0.891,"fp":9,"fpRate":0.075},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.82},{"overallF1":0.1108,"overallFnRate":0.9412,"overallFpRate":0.0479,"perType":{"code":{"fn":132,"fnRate":0.8462,"fp":18,"fpRate":0.15},"mixed":{"fn":139,"fnRate":0.891,"fp":9,"fpRate":0.075},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.825},{"overallF1":0.1096,"overallFnRate":0.9419,"overallFpRate":0.0461,"perType":{"code":{"fn":132,"fnRate":0.8462,"fp":17,"fpRate":0.1417},"mixed":{"fn":139,"fnRate":0.891,"fp":9,"fpRate":0.075},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.83},{"overallF1":0.0945,"overallFnRate":0.9503,"overallFpRate":0.0399,"perType":{"code":{"fn":136,"fnRate":0.8718,"fp":15,"fpRate":0.125},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.835},{"overallF1":0.0844,"overallFnRate":0.9559,"overallFpRate":0.0337,"perType":{"code":{"fn":139,"fnRate":0.891,"fp":13,"fpRate":0.1083},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.84},{"overallF1":0.0805,"overallFnRate":0.958,"overallFpRate":0.0301,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":10,"fpRate":0.0833},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.845},{"overallF1":0.0805,"overallFnRate":0.958,"overallFpRate":0.0293,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":10,"fpRate":0.0833},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.85},{"overallF1":0.078,"overallFnRate":0.9594,"overallFpRate":0.0284,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":9,"fpRate":0.075},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.855},{"overallF1":0.0728,"overallFnRate":0.9622,"overallFpRate":0.0248,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.86},{"overallF1":0.0728,"overallFnRate":0.9622,"overallFpRate":0.0239,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.865},{"overallF1":0.0689,"overallFnRate":0.9643,"overallFpRate":0.023,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.87},{"overallF1":0.0689,"overallFnRate":0.9643,"overallFpRate":0.0222,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.875},{"overallF1":0.0689,"overallFnRate":0.9643,"overallFpRate":0.0222,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.88},{"overallF1":0.0689,"overallFnRate":0.9643,"overallFpRate":0.0222,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.885},{"overallF1":0.065,"overallFnRate":0.9664,"overallFpRate":0.0213,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.89},{"overallF1":0.065,"overallFnRate":0.9664,"overallFpRate":0.0213,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.895},{"overallF1":0.065,"overallFnRate":0.9664,"overallFpRate":0.0213,"perType":{"code":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.9},{"overallF1":0.0637,"overallFnRate":0.9671,"overallFpRate":0.0204,"perType":{"code":{"fn":141,"fnRate":0.9038,"fp":7,"fpRate":0.0583},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.905},{"overallF1":0.0624,"overallFnRate":0.9678,"overallFpRate":0.0204,"perType":{"code":{"fn":142,"fnRate":0.9103,"fp":7,"fpRate":0.0583},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.91},{"overallF1":0.0624,"overallFnRate":0.9678,"overallFpRate":0.0195,"perType":{"code":{"fn":142,"fnRate":0.9103,"fp":6,"fpRate":0.05},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.915},{"overallF1":0.0611,"overallFnRate":0.9685,"overallFpRate":0.0186,"perType":{"code":{"fn":143,"fnRate":0.9167,"fp":5,"fpRate":0.0417},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.92},{"overallF1":0.0611,"overallFnRate":0.9685,"overallFpRate":0.0186,"perType":{"code":{"fn":143,"fnRate":0.9167,"fp":5,"fpRate":0.0417},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.925},{"overallF1":0.0611,"overallFnRate":0.9685,"overallFpRate":0.0186,"perType":{"code":{"fn":143,"fnRate":0.9167,"fp":5,"fpRate":0.0417},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.93},{"overallF1":0.0598,"overallFnRate":0.9692,"overallFpRate":0.0177,"perType":{"code":{"fn":144,"fnRate":0.9231,"fp":4,"fpRate":0.0333},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.935},{"overallF1":0.0598,"overallFnRate":0.9692,"overallFpRate":0.0177,"perType":{"code":{"fn":144,"fnRate":0.9231,"fp":4,"fpRate":0.0333},"mixed":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.94},{"overallF1":0.0558,"overallFnRate":0.9713,"overallFpRate":0.0151,"perType":{"code":{"fn":146,"fnRate":0.9359,"fp":2,"fpRate":0.0167},"mixed":{"fn":141,"fnRate":0.9038,"fp":7,"fpRate":0.0583},"prose":{"fn":140,"fnRate":0.8974,"fp":8,"fpRate":0.0667}},"threshold":0.945},{"overallF1":0.0505,"overallFnRate":0.9741,"overallFpRate":0.0115,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":141,"fnRate":0.9038,"fp":7,"fpRate":0.0583},"prose":{"fn":142,"fnRate":0.9103,"fp":6,"fpRate":0.05}},"threshold":0.95},{"overallF1":0.0465,"overallFnRate":0.9762,"overallFpRate":0.0089,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":143,"fnRate":0.9167,"fp":5,"fpRate":0.0417},"prose":{"fn":143,"fnRate":0.9167,"fp":5,"fpRate":0.0417}},"threshold":0.955},{"overallF1":0.0438,"overallFnRate":0.9776,"overallFpRate":0.0071,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":143,"fnRate":0.9167,"fp":5,"fpRate":0.0417},"prose":{"fn":145,"fnRate":0.9295,"fp":3,"fpRate":0.025}},"threshold":0.96},{"overallF1":0.0411,"overallFnRate":0.979,"overallFpRate":0.0053,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":144,"fnRate":0.9231,"fp":4,"fpRate":0.0333},"prose":{"fn":146,"fnRate":0.9359,"fp":2,"fpRate":0.0167}},"threshold":0.965},{"overallF1":0.0385,"overallFnRate":0.9804,"overallFpRate":0.0035,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":145,"fnRate":0.9295,"fp":3,"fpRate":0.025},"prose":{"fn":147,"fnRate":0.9423,"fp":1,"fpRate":0.0083}},"threshold":0.97},{"overallF1":0.0344,"overallFnRate":0.9825,"overallFpRate":0.0009,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"prose":{"fn":147,"fnRate":0.9423,"fp":1,"fpRate":0.0083}},"threshold":0.975},{"overallF1":0.0331,"overallFnRate":0.9832,"overallFpRate":0,"perType":{"code":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"mixed":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0},"prose":{"fn":148,"fnRate":0.9487,"fp":0,"fpRate":0}},"threshold":0.98}],"seed":20260806,"shippedDefault":0.85,"status":"ok"}

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

@@ -63,6 +63,7 @@ import {
 	handleImproveCortex,
 	handleImproveCortexStatus,
 	handleDedupTierAttribution,
+	handleCosineFpReport,
 } 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.
@@ -160,5 +161,6 @@ export function dispatchRoutes(
 	if (handleImproveCortex(req, res, ctx)) return true;
 	if (handleImproveCortexStatus(req, res, ctx)) return true;
 	if (handleDedupTierAttribution(req, res, ctx)) return true;
+	if (handleCosineFpReport(req, res, ctx)) return true;
 	return false;
 }

package/extensions/dashboard-server/routes-cosine-fp.ts

@@ -0,0 +1,288 @@
+/**
+ * dashboard-server/routes-cosine-fp.ts — COS-FP-A cosine-FP report route.
+ *
+ * GET /api/cosine-fp-report — reader-only aggregate answering "what did the last
+ * synthetic bench recommend for the L2 cosine threshold?". Reads the last
+ * written bench-run aggregate (scripts/cosine-fp/bench-run/cosine-fp-report.json,
+ * located by walking up to the repo root) + its mtime, memoized by
+ * {mtime,size} (mirrors routes-vector-cortex-health.ts memoized-facts), and
+ * serves the report digest + recommendation + grid summary. Reader-only: emits
+ * counts + fractions + digests, never template text (EVAL-REDACT-002).
+ *
+ * Flag-off (MEGACOMPACT_COSINE_FP_BENCH=0) returns 404 — byte-identical
+ * predecessor. Missing report file is reported as `awaiting_data` with
+ * benchStatus awaiting_data — never a fabricated zero row (COS-FP-A-003).
+ *
+ * Guardrails: PREVENT-PI-004 (local filesystem read only), PREVENT-001
+ * (JSON.parse guarded), PREVENT-011 (no `any`).
+ */
+
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { readFileSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { RouteContext } from "./routes-core.js";
+import { sendJson } from "./routes-vector-cortex-shared.js";
+import { COSINE_FP_BENCH_ENABLED } from "../../src/config.js";
+import { deriveVcStatus } from "./vc-status.js";
+import type {
+  CosineFpReportV1,
+  CosineFpBenchStatus,
+  CosineFpPerTypeCounts,
+} from "./api-contracts/cosine-fp.js";
+
+const MEMO_TTL_MS = 5000; // ≤5s per file state
+const REPORT_FILENAME = "cosine-fp-report.json";
+
+interface MemoEntry {
+  key: string;
+  at: number;
+  body: CosineFpReportV1;
+}
+
+let memo: MemoEntry | null = null;
+
+/**
+ * Resolve the dir containing the cosine-fp-report.json aggregate. Two locations
+ * are probed in order:
+ *
+ *  1. The bundled asset `extensions/dashboard-server/assets/cosine-fp-report.json`.
+ *     This is the PRODUCTION path: the `extensions/` source tree ships at the
+ *     npm package root, so `/api/cosine-fp-report` serves the recommendation on
+ *     an installed package (PREVENT-DIST-001). tsc does NOT copy `.json` assets
+ *     into `dist/`, so the compiled module probes both the co-located
+ *     `assets/` (source tree) and the repo-root `extensions/.../assets/`
+ *     (reached from `dist/extensions/dashboard-server/`). Without the bundled
+ *     asset the endpoint would always return `awaiting_data` on devices,
+ *     because `scripts/` (the bench-run path) is NOT shipped.
+ *
+ *  2. The git-checkout bench-run dir (`scripts/cosine-fp/bench-run/`) for dev
+ *     use, walked up to from this module — this is where `bench.mjs` writes the
+ *     report.
+ *
+ * The test seam MEGACOMPACT_COSINE_FP_BENCH_RUN_DIR (read lazily so a test can
+ * set it post-import) overrides BOTH so route tests can point at a temp dir
+ * without touching the repo or the bundled asset.
+ */
+export function benchRunDir(): string | null {
+  const testRunDir = process.env.MEGACOMPACT_COSINE_FP_BENCH_RUN_DIR;
+  if (testRunDir) return testRunDir;
+  const here = dirname(fileURLToPath(import.meta.url));
+  // 1. Bundled asset candidates — the PRODUCTION path (PREVENT-DIST-001). tsc
+  //    does NOT copy `.json` assets into dist/, and the `extensions/` source
+  //    tree ships at the package root next to `dist/`. Probe both relative to
+  //    this module's location (mirrors server.ts clientDist candidates):
+  //      here = extensions/dashboard-server        (source tree, dev run)
+  //      here = dist/extensions/dashboard-server   (compiled, published)
+  const bundledCandidates = [
+    join(here, "assets"), // source tree / co-located
+    join(here, "..", "..", "..", "extensions", "dashboard-server", "assets"), // repo-root source from compiled dist/
+  ];
+  for (const bundled of bundledCandidates) {
+    try {
+      // guardrails-allow PREVENT-PI-004: local bundled report stat (loopback)
+      statSync(join(bundled, REPORT_FILENAME));
+      return bundled;
+    } catch {
+      /* try next candidate, then fall through to git-checkout walk */
+    }
+  }
+  // 2. Git-checkout bench-run dir — dev path only.
+  let dir = here;
+  const rel = join("scripts", "cosine-fp", "bench-run");
+  for (let i = 0; i < 8; i++) {
+    const candidate = join(dir, rel);
+    try {
+      // guardrails-allow PREVENT-PI-004: local bench-run dir stat (loopback)
+      statSync(candidate);
+      return candidate;
+    } catch {
+      /* keep walking */
+    }
+    const next = dirname(dir);
+    if (next === dir) break;
+    dir = next;
+  }
+  return null;
+}
+
+/** Read + minimally validate the aggregate JSON (PREVENT-001). Returns null on
+ *  any parse/shape failure — the caller treats that as awaiting_data, never as
+ *  a fabricated zero row. */
+function readAggregate(runDir: string): Record<string, unknown> | null {
+  const p = join(runDir, "cosine-fp-report.json");
+  let raw: string;
+  try {
+    raw = readFileSync(p, "utf8"); // guardrails-allow PREVENT-PI-004: local bench-run report read (loopback)
+  } catch {
+    return null;
+  }
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+  return parsed as Record<string, unknown>;
+}
+
+function toNum(v: unknown): number | null {
+  return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+
+/** Project per-content-type count entries into the contract shape (PREVENT-011). */
+function projectPerType(
+  raw: unknown,
+): Readonly<Record<string, CosineFpPerTypeCounts>> {
+  const out: Record<string, CosineFpPerTypeCounts> = {};
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return out;
+  for (const [key, v] of Object.entries(raw as Record<string, unknown>)) {
+    if (!v || typeof v !== "object" || Array.isArray(v)) continue;
+    const o = v as Record<string, unknown>;
+    out[key] = {
+      items: toNum(o.items) ?? 0,
+      dup: toNum(o.dup) ?? 0,
+      near: toNum(o.near) ?? 0,
+      clean: toNum(o.clean) ?? 0,
+    };
+  }
+  return out;
+}
+
+/** Project the raw aggregate into the full CosineFpReportV1 (reader-only). */
+function buildBody(runDir: string, aggregate: Record<string, unknown>): CosineFpReportV1 {
+  let mtime: number | null = null;
+  try {
+    const s = statSync(join(runDir, "cosine-fp-report.json")); // guardrails-allow PREVENT-PI-004: local stat (loopback)
+    mtime = s.mtimeMs;
+  } catch {
+    mtime = null;
+  }
+  const benchStatus: CosineFpBenchStatus = aggregate.status === "ok" ? "ok" : "no_data";
+  const hasData = benchStatus === "ok";
+  const status = deriveVcStatus({ enabled: true, hasData, structuralOnly: false });
+
+  const grid = aggregate.grid;
+  const overrides = aggregate.overrides;
+  const corpus = aggregate.corpusSummary;
+  const rows = aggregate.rows;
+
+  return {
+    status,
+    benchStatus,
+    seed: toNum(aggregate.seed),
+    grid:
+      grid && typeof grid === "object"
+        ? {
+            lo: toNum((grid as Record<string, unknown>).lo) ?? 0,
+            hi: toNum((grid as Record<string, unknown>).hi) ?? 0,
+            step: toNum((grid as Record<string, unknown>).step) ?? 0,
+            points: toNum((grid as Record<string, unknown>).points) ?? 0,
+          }
+        : null,
+    corpusSummary:
+      corpus && typeof corpus === "object"
+        ? {
+            items: toNum((corpus as Record<string, unknown>).items) ?? 0,
+            pairs: toNum((corpus as Record<string, unknown>).pairs) ?? 0,
+            types: Array.isArray((corpus as Record<string, unknown>).types)
+              ? ((corpus as Record<string, unknown>).types as string[])
+              : [],
+            perType: projectPerType((corpus as Record<string, unknown>).perType),
+            digest:
+              typeof (corpus as Record<string, unknown>).digest === "string"
+                ? ((corpus as Record<string, unknown>).digest as string)
+                : null,
+          }
+        : null,
+    rows: Array.isArray(rows) ? (rows as CosineFpReportV1["rows"]) : null,
+    recommendedDefault: toNum(aggregate.recommendedDefault),
+    shippedDefault: toNum(aggregate.shippedDefault) ?? 0.85,
+    overrides:
+      overrides && typeof overrides === "object"
+        ? {
+            code: toNum((overrides as Record<string, unknown>).code),
+            prose: toNum((overrides as Record<string, unknown>).prose),
+            mixed: toNum((overrides as Record<string, unknown>).mixed),
+          }
+        : null,
+    fpBudget: toNum(aggregate.fpBudget),
+    digest: typeof aggregate.digest === "string" ? (aggregate.digest as string) : null,
+    reportFileMtime: mtime,
+  };
+}
+
+function awaitingDataBody(reason: "flag" | "missing"): CosineFpReportV1 {
+  const status = deriveVcStatus({
+    enabled: reason !== "flag",
+    hasData: false,
+    structuralOnly: false,
+  });
+  return {
+    status,
+    benchStatus: reason === "flag" ? "off" : "awaiting_data",
+    seed: null,
+    grid: null,
+    corpusSummary: null,
+    rows: null,
+    recommendedDefault: null,
+    shippedDefault: 0.85,
+    overrides: null,
+    fpBudget: null,
+    digest: null,
+    reportFileMtime: null,
+  };
+}
+
+export function handleCosineFpReport(
+  req: IncomingMessage,
+  res: ServerResponse,
+  _ctx: RouteContext,
+): boolean {
+  const url = req.url ?? "";
+  if (url !== "/api/cosine-fp-report") return false;
+  if (req.method !== "GET") {
+    sendJson(res, 405, { error: "method_not_allowed" });
+    return true;
+  }
+  if (!COSINE_FP_BENCH_ENABLED()) {
+    // Flag-off: 404 — byte-identical predecessor.
+    sendJson(res, 404, { error: "not_found" });
+    return true;
+  }
+
+  const runDir = benchRunDir();
+  if (runDir === null) {
+    sendJson(res, 200, awaitingDataBody("missing"));
+    return true;
+  }
+
+  // Memoized-facts pattern: serve a still-fresh entry keyed on {mtime,size}.
+  let size = 0;
+  let mtime = 0;
+  try {
+    const s = statSync(join(runDir, "cosine-fp-report.json")); // guardrails-allow PREVENT-PI-004: local stat (loopback)
+    size = s.size;
+    mtime = s.mtimeMs;
+  } catch {
+    // no report on disk yet
+  }
+  if (size === 0 && mtime === 0) {
+    sendJson(res, 200, awaitingDataBody("missing"));
+    return true;
+  }
+
+  const key = `${mtime}:${size}`;
+  const now = Date.now();
+  if (memo !== null && memo.key === key && now - memo.at <= MEMO_TTL_MS) {
+    sendJson(res, 200, memo.body);
+    return true;
+  }
+
+  const aggregate = readAggregate(runDir);
+  const body = aggregate === null ? awaitingDataBody("missing") : buildBody(runDir, aggregate);
+  memo = { key, at: now, body };
+  sendJson(res, 200, body);
+  return true;
+}

package/extensions/dashboard-server/routes-rag-settings-helpers.ts

@@ -331,4 +331,12 @@ export const EXCLUDED_SETTINGS: readonly string[] = [
 	"MEGACOMPACT_RAPTOR_LEVEL_WEIGHTS",
 	// Internal calibration, not user-facing.
 	"MEGACOMPACT_FTS5_MAX_BM25",
+	// COS-FP-A: per-content-type L2 override landing slots. Null/unset by
+	// default and NOT wired into the live L2 decision this sprint — the
+	// top-level MEGACOMPACT_L2_THRESHOLD is the single runtime firing point. A
+	// default-OFF numeric slot is not yet an adjustable firing knob, so it is
+	// excluded (the report carries the recommendation; adoption is a separate
+	// gated sprint).
+	"MEGACOMPACT_L2_THRESHOLD_CODE",
+	"MEGACOMPACT_L2_THRESHOLD_PROSE",
 ];

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

@@ -312,5 +312,11 @@ export const VECTOR_CORTEX_SETTINGS: SettingGroup = {
 			"ENC-2a exposes the runtime operator knob MEGACOMPACT_NATIVE_ORT_BUDGET_MIB (default 300 MiB, clamp 8192) as a dashboard Settings field. The knob gates budgetOk in the encoder runtime decision (decision.ts installBudgetMib + runtime-select.ts selectRuntimeBackend). Persisted to the per-repo .mega-compact.env via the setup-configure writer branch; the GET status route surfaces the persisted value AND the effective integer installBudgetMib() resolves to (so the dashboard shows the runtime's actual operand). OFF = no new GET fields, no writer branch, no new Settings rows (byte-identical ENC-1b predecessor).",
 			true,
 		),
+		boolDirect(
+			"MEGACOMPACT_COSINE_FP_BENCH",
+			"COS-FP-A Synthetic FP Bench",
+			"Synthetic FP harness + L2 cosine threshold calibration (COS-FP-A): drives the deterministic synthetic-corpus grid sweep (scripts/cosine-fp/bench.mjs) that measures L2 cosine false-positive rates and emits a recommended default, and serves the reader-only GET /api/cosine-fp-report. Synthetic-corpus-only — never reads real session/ledger bytes. OFF = bench inert, endpoint 404s, no report write, L2_COSINE plain MEGACOMPACT_L2_THRESHOLD (byte-identical predecessor).",
+			true,
+		),
 	],
 };

package/extensions/dashboard-server/routes.ts

@@ -67,3 +67,4 @@ export {
 	handleImproveCortexStatus,
 } from "./routes-cortex-improve.js";
 export { handleDedupTierAttribution } from "./routes-dedup-attribution.js";
+export { handleCosineFpReport } from "./routes-cosine-fp.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.20.53",
+  "version": "0.20.55",
   "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/dedup.ts

@@ -28,6 +28,15 @@ function envNum(name: string, def: number): number {
   return Number.isFinite(n) ? n : def;
 }
 
+/** COS-FP-A: numeric env var that is `null` when unset ("off") — a dormant
+ *  override whose absence must mean "no behavior change". */
+function envNumOrNull(name: string): number | null {
+  const v = process.env[name];
+  if (v === undefined || v === "off" || v === "") return null;
+  const n = Number(v);
+  return Number.isFinite(n) ? n : null;
+}
+
 /** S42B: parse a comma-separated numeric env var (e.g. "1.0,0.9,0.8"). */
 function envNumArray(name: string, def: number[]): number[] {
   const v = process.env[name];
@@ -50,6 +59,12 @@ export interface DedupConfigShape {
   MINILM_EMBEDDER: boolean;
   // Thresholds.
   L2_COSINE: number; // semantic dedup firing point
+  /** COS-FP-A: optional per-content-type L2 override — null when unset (the
+   *  top-level L2_COSINE remains the single runtime firing point; these are a
+   *  default-OFF landing slot for the compliance report's recommendation, NOT
+   *  wired into the live L2 decision this sprint). */
+  L2_COSINE_CODE: number | null;
+  L2_COSINE_PROSE: number | null;
   L1_JACCARD: number; // MinHash/LSH near-dup verification
   DEDUP_SIM: number; // legacy content-similarity fallback
   MMR_LAMBDA: number; // retrieval diversity
@@ -105,6 +120,8 @@ export function loadDedupConfig(): DedupConfigShape {
     MARK_ONLY_L2: envBool("MEGACOMPACT_MARK_ONLY_L2", false),
     MINILM_EMBEDDER: envBool("MEGACOMPACT_MINILM", false),
     L2_COSINE: envNum("MEGACOMPACT_L2_THRESHOLD", 0.85),
+    L2_COSINE_CODE: envNumOrNull("MEGACOMPACT_L2_THRESHOLD_CODE"),
+    L2_COSINE_PROSE: envNumOrNull("MEGACOMPACT_L2_THRESHOLD_PROSE"),
     L1_JACCARD: envNum("MEGACOMPACT_L1_JACCARD", 0.8),
     DEDUP_SIM: envNum("MEGACOMPACT_DEDUP_SIM", 0.9),
     MMR_LAMBDA: envNum("MEGACOMPACT_MMR_LAMBDA", 0.5),

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

@@ -0,0 +1,34 @@
+/**
+ * config/vector-cortex-cosfp.ts — COS-FP-A synthetic FP harness sprint flag.
+ *
+ * Extracted from vector-cortex.ts so that barrel stays under the 300-line soft
+ * limit (soft-as-hard gate), exactly as vector-cortex-vc9a.ts and the other
+ * per-sprint flag siblings were. Gating the synthetic cosine false-positive
+ * harness: the corpus/bench scripts, the derived report, and the reader-only
+ * GET /api/cosine-fp-report endpoint. A pure-local, synthetic-corpus-only tool
+ * (EVAL-REDACT-002) — it never reads real session/ledger bytes.
+ *
+ * The split is mechanical: COSINE_FP_BENCH_ENABLED is byte-identical in name,
+ * semantics, and default to the sibling flag convention (positive, default ON),
+ * and vector-cortex.ts re-exports it so every existing
+ * `from "./config/vector-cortex.js"` import keeps resolving unchanged.
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+
+import { sprintFlag } from "./vector-cortex-flag.js";
+
+/**
+ * COS-FP-A — synthetic FP harness + L2 cosine threshold calibration.
+ * Default ON. `MEGACOMPACT_COSINE_FP_BENCH=0` disables and is byte-identical to
+ * the predecessor: `scripts/cosine-fp/bench.mjs` is inert (gates report
+ * emission + the endpoint to 404/absent), no report is (re)written, and
+ * `L2_COSINE` continues to be plain `MEGACOMPACT_L2_THRESHOLD`. The two
+ * content-type override fields added to config/dedup.ts are null when unset and
+ * are NOT wired into the live L2 decision this sprint (a declared landing slot
+ * for the report's per-content-type recommendation). This flag MUST also be a
+ * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS).
+ * The harness + endpoint perform only local filesystem reads (PREVENT-PI-004).
+ */
+export const COSINE_FP_BENCH_ENABLED = (): boolean =>
+  sprintFlag("MEGACOMPACT_COSINE_FP_BENCH");

package/src/config/vector-cortex.ts

@@ -62,6 +62,8 @@ export { ENC_0D_ENABLED } from "./vector-cortex-enc0d.js";
 export { ENC_0E_ENABLED } from "./vector-cortex-enc0e.js";
 export { ENC_0F_ENABLED } from "./vector-cortex-enc0f.js";
 export { ENC_0G_ENABLED } from "./vector-cortex-enc0g.js";
+// COS-FP-A synthetic FP harness flag extracted to vector-cortex-cosfp.ts.
+export { COSINE_FP_BENCH_ENABLED } from "./vector-cortex-cosfp.js";
 export { ENC_1A_ENABLED } from "./vector-cortex-enc1a.js";
 export {
   ENC_1B_ENABLED,

package/src/config.ts

@@ -202,6 +202,7 @@ export {
   ENC_2BUDGET_NATIVE_ORT_BUDGET_ENV,
   ENC_2BUDGET_MAX_MIB,
   ENC_2BUDGET_DEFAULT_MIB,
+  COSINE_FP_BENCH_ENABLED,
   BREAKER_WINDOW_MS,
   BREAKER_MIN_ATTEMPTS,
   BREAKER_PERF_FAILURES,

package/extensions/dashboard-client/dist/assets/CacheTab-BS_G9_YV.js

@@ -1,2 +0,0 @@
-import{j as e,r as h,u as m,x as I,y as k,w,l as D}from"./index-mZRDesSq.js";import{C as W,T as F}from"./TimeSavedCard-D_mBYAzE.js";import{b as u,c as v,d as _,e as O,f as x}from"./format-COjDIVGj.js";import{l as G}from"./pricing-DkYp8-vi.js";import{C as f,a as C,b as S,c as N}from"./card-DMzHffVs.js";import{B}from"./button-Cl_gFaIf.js";import{a as K}from"./client-extra-Dkkppa5C.js";function L(t){return t>=80?"ov-stat-value-green":t>=50?"ov-stat-value-yellow":"ov-stat-value-red"}function U(t){return t==null?"":t>=0?"ov-stat-value-green":"ov-stat-value-red"}function n({label:t,value:a,className:s,title:l}){return e.jsxs("div",{className:"flex items-baseline justify-between border-b border-border py-1 text-sm",children:[e.jsx("span",{className:"text-xs text-muted-foreground",title:l,children:t}),e.jsx("span",{className:`font-semibold${s?` ${s}`:""}`,children:a})]})}function V(t){return e.jsxs(f,{className:"electric-hover",children:[e.jsx(C,{children:e.jsx(S,{children:"Provider Prompt Cache"})}),e.jsxs(N,{children:[e.jsx(n,{label:"Cache Hit Rate",value:`${t.hitPct.toFixed(1)}%`,className:L(t.hitPct)}),e.jsx(n,{label:"Turns Recorded",value:String(t.turnCount)}),e.jsx(n,{label:"Cache Read Tokens",value:u(t.totalCacheRead)}),e.jsx(n,{label:"Cache Write Tokens",value:u(t.totalCacheWrite)}),e.jsx(n,{label:"Input Tokens",value:u(t.totalInput)}),e.jsx(n,{label:"$ Saved (reads)",value:v(t.cacheReadSaved)}),e.jsx(n,{label:"Write Investment",value:v(t.cacheWriteCost)}),e.jsx(n,{label:"Net Saved",value:v(t.netSaved),className:U(t.netSaved)}),e.jsx(n,{label:"Model",value:t.modelLabel??"—"}),e.jsx(n,{label:"Tracked Since",value:_(t.firstTurnAt)}),e.jsx(n,{label:"Last Updated",value:O(t.latestTurnAt)}),t.byModel.length>0&&e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"mt-2 text-xs font-semibold text-muted-foreground",children:"Per Model"}),t.byModel.map(a=>{const s=G(a.model),l=s!=null?a.totalCacheRead/1e6*s:null,r=s!=null?a.totalCacheWrite/1e6*s:null;return e.jsxs("div",{className:"mt-2",children:[e.jsx(n,{label:"Model",value:a.model}),e.jsx(n,{label:"Hit Rate",value:`${a.hitPct.toFixed(1)}%`,className:L(a.hitPct)}),e.jsx(n,{label:"Cache Read",value:u(a.totalCacheRead)}),e.jsx(n,{label:"Cache Write",value:u(a.totalCacheWrite)}),e.jsx(n,{label:"Samples",value:String(a.sampleCount)}),e.jsx(n,{label:"$ Saved (reads)",value:l!=null?v(l):"—"}),e.jsx(n,{label:"Write Investment",value:r!=null?v(r):"—"})]},a.model)})]})]})]})}const q=["ov-bar-green","ov-bar-blue","ov-bar-teal","ov-bar-yellow","ov-bar-gray"],z=["Permanent","Epoch","Topic","Thread","Volatile"],J={good:"ov-text-green",fair:"ov-text-yellow",degraded:"ov-text-orange",poor:"ov-text-red"};function Q({data:t}){const a=Math.max(...t.buckets.map(l=>l.count),1),s=J[t.health.label]??"ov-text-gray";return e.jsxs("div",{className:"ov-card",children:[e.jsx("h3",{className:"ov-card-title",children:"Cache Stripe Distribution"}),e.jsxs("div",{className:"ov-stripe-health-summary",children:[e.jsx("span",{className:`ov-stripe-health-badge ${s}`,children:t.health.label}),e.jsx("span",{className:"ov-stripe-health-score",children:x(t.health.score)}),e.jsxs("span",{className:"ov-stripe-churn",children:["Churn: ",x(t.health.churnRate)]}),e.jsxs("span",{className:"ov-stripe-total",children:[t.totalChunks," total chunks"]})]}),e.jsx("div",{className:"ov-stripe-bars",children:t.buckets.map(l=>{const r=a>0?Math.max(0,Math.min(100,l.count/a*100)):0,i=q[l.stripe]??"ov-bar-gray",o=l.label||(z[l.stripe]??`Stripe ${l.stripe}`);return e.jsxs("div",{className:"ov-stripe-row",children:[e.jsx("span",{className:"ov-stripe-label",title:o,children:o}),e.jsx("div",{className:"ov-bar-track",children:e.jsx("div",{className:`ov-bar-fill ${i}`,style:{width:`${r}%`}})}),e.jsx("span",{className:"ov-stripe-count",children:l.count}),e.jsx("span",{className:"ov-stripe-stability",title:`min ${x(l.minStability)} / max ${x(l.maxStability)}`,children:x(l.avgStability)})]},l.stripe)})}),e.jsxs("div",{className:"ov-stripe-footer",children:["Epoch: ",t.epochId??"—","· Dominant tier: ",x(t.health.dominantTier)]})]})}function g(t){return`${t.toFixed(1)}%`}function X(t){return t>=80?"ov-bar-green":t>=60?"ov-bar-teal":t>=40?"ov-bar-yellow":t>=20?"ov-bar-orange":"ov-bar-red"}const Y=({perf:t})=>{const{cache_hit_pct:a}=t,s=a.samples&&a.samples.length>0?a.samples:[];return e.jsxs(f,{className:"electric-hover",children:[e.jsx(C,{children:e.jsx(S,{children:"Cache Hit-Rate Trend"})}),e.jsxs(N,{children:[e.jsxs("div",{className:"mb-3 flex gap-4 text-sm text-muted-foreground",children:[e.jsxs("div",{children:["Avg: ",e.jsx("strong",{className:"text-foreground",children:g(a.avg)})]}),e.jsxs("div",{children:["Latest: ",e.jsx("strong",{className:"text-foreground",children:g(a.latest)})]}),e.jsxs("div",{children:["Samples: ",e.jsx("strong",{className:"text-foreground",children:a.n})]})]}),s.length>0?e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"ov-sparkline",role:"img","aria-label":`Cache hit rate trend: ${a.n} samples, average ${g(a.avg)}, latest ${g(a.latest)}`,children:s.map((l,r)=>{const i=Math.max(2,Math.round(l.pct*.6)),o=X(l.pct),c=r===s.length-1;return e.jsx("div",{className:`ov-sparkline-bar ${o}${c?" ov-bar-latest":""}`,style:{height:`${i}px`},title:`${g(l.pct)} at ${new Date(l.ts).toLocaleTimeString()}`},r)})}),e.jsxs("div",{className:"mt-1 text-xs text-muted-foreground",children:[s.length," sample",s.length!==1?"s":""," over"," ",s.length>1?`${Math.round((s[s.length-1].ts-s[0].ts)/1e3)}s`:"latest turn"]})]}):e.jsx("div",{className:"text-sm text-muted-foreground",children:"No cache-hit samples yet"})]})]})};function T(t){return`${(t*100).toFixed(1)}%`}function Z(t){const a=t*100;return a>=80?"ov-bar-green":a>=60?"ov-bar-teal":a>=40?"ov-bar-yellow":a>=20?"ov-bar-orange":"ov-bar-red"}const A={improving:"Improving",stable:"Stable",degrading:"Degrading"},ee=({data:t})=>{const{turns:a,avgRatio:s,trend:l}=t;return e.jsxs(f,{className:"electric-hover",children:[e.jsx(C,{children:e.jsx(S,{children:"Per-Turn Stable Prefix"})}),e.jsxs(N,{children:[e.jsxs("div",{className:"mb-3 flex gap-4 text-sm text-muted-foreground",children:[e.jsxs("div",{children:["Avg:"," ",e.jsx("strong",{className:"text-foreground",children:T(s)})]}),e.jsxs("div",{children:["Trend:"," ",e.jsx("strong",{className:"text-foreground",children:A[l]})]}),e.jsxs("div",{children:["Turns: ",e.jsx("strong",{className:"text-foreground",children:a.length})]})]}),a.length>0?e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"ov-sparkline",role:"img","aria-label":`Per-turn stable-prefix ratio trend: ${a.length} turns, average ${T(s)}, trend ${A[l]}`,children:a.map((r,i)=>{const o=Math.max(2,Math.round(r.ratio*60)),c=Z(r.ratio),p=i===a.length-1;return e.jsx("div",{className:`ov-sparkline-bar ${c}${p?" ov-bar-latest":""}`,style:{height:`${o}px`},title:`Turn ${r.turnIndex}: ${T(r.ratio)} (${r.stablePrefix}/${r.totalMessages} msg) @ ${new Date(r.timestamp).toLocaleTimeString()}`},i)})}),e.jsx("div",{className:"mt-1 text-xs text-muted-foreground",children:"Shared prompt-cache prefix ratio per turn — higher is better."})]}):e.jsx("div",{className:"text-sm text-muted-foreground",children:"No stable-prefix samples yet"})]})]})};function oe(){const[t,a]=h.useState(!1),{data:s,loading:l,error:r}=m(h.useCallback(()=>I(),[]),{pollInterval:5e3}),{data:i,loading:o,error:c}=m(h.useCallback(()=>k(),[]),{pollInterval:15e3}),{data:p,loading:E,error:y}=m(h.useCallback(()=>w({minutes:30}),[]),{pollInterval:15e3}),{data:P,loading:M}=m(h.useCallback(()=>K(50),[]),{pollInterval:15e3}),{data:d,loading:H,error:$}=m(h.useCallback(()=>D(),[]),{pollInterval:5e3});return e.jsxs("div",{className:"flex flex-col gap-4",children:[e.jsxs("div",{children:[e.jsx(B,{type:"button",variant:"outline",onClick:()=>a(!t),children:t?"Hide Guidance":"Show Cache-Friendly Prompt Ordering Guidance"}),t&&e.jsxs(f,{className:"mt-3",children:[e.jsx(C,{children:e.jsx(S,{children:"Cache-Friendly Prompt Ordering"})}),e.jsxs(N,{children:[e.jsxs("ul",{className:"list-disc space-y-1 pl-5",children:[e.jsx("li",{children:"Keep system prompts and stable context at the top of your conversation — the provider caches the leading prefix."}),e.jsxs("li",{children:["Tool results and volatile content are automatically moved to the tail by message separation (",e.jsx("code",{children:"MEGACOMPACT_MESSAGE_SEPARATION"}),") so they don't invalidate the cache prefix."]}),e.jsxs("li",{children:["Cache striping (",e.jsx("code",{children:"MEGACOMPACT_CACHE_STRIPING"}),") further orders stable context by a stability score so the most durable chunks lead."]}),e.jsx("li",{children:"Avoid inserting new instructions mid-conversation — prepend them instead."})]}),d&&e.jsxs("div",{className:"mt-2 text-sm",children:[e.jsx("strong",{children:"Status:"})," ",d.config.auto?"Auto-compaction Enabled":"Auto-compaction Disabled"," |"," ","fast-gate ",d.config.fastGatePct,"% / threshold"," ",d.config.thresholdTokens.toLocaleString()," tokens"]})]})]})]}),e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Provider Prompt Cache"}),l?e.jsx("p",{className:"tab-stub",children:"Loading..."}):r?e.jsxs("p",{className:"tab-stub",children:["Provider cache unavailable: ",r.message]}):s?e.jsx(V,{hitPct:s.cache.avgHitPct,turnCount:s.cache.turnCount,totalCacheRead:s.cache.totalCacheRead,totalCacheWrite:s.cache.totalCacheWrite,totalInput:s.cache.totalInput,cacheReadSaved:s.savings?.cacheReadSaved??null,cacheWriteCost:s.savings?.cacheWriteCost??null,netSaved:s.savings?.netSaved??null,modelLabel:s.savings?.model??null,firstTurnAt:s.cache.firstTurnAt,latestTurnAt:s.cache.latestTurnAt,byModel:s.cache.byModel??[]}):null,e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Cache Stripe Distribution"}),o?e.jsx("p",{className:"tab-stub",children:"Loading..."}):c?e.jsxs("p",{className:"tab-stub",children:["Cache stripe data unavailable: ",c.message]}):i?e.jsx(Q,{data:i}):null,e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Cache Hit-Rate Trend"}),E?e.jsx("p",{className:"tab-stub",children:"Loading..."}):y?e.jsxs("p",{className:"tab-stub",children:["Hit-rate trend unavailable: ",y.message]}):p?e.jsx(Y,{perf:p}):null,P&&!M?e.jsxs("div",{children:[e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Per-Turn Stable Prefix"}),e.jsx(ee,{data:P})]}):null,e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Mega-Compact Dedup Cache"}),H?e.jsx("p",{className:"tab-stub",children:"Loading..."}):$?e.jsxs("p",{className:"tab-stub",children:["Snapshot unavailable: ",$.message]}):d&&(()=>{const{cacheHits:b,compacts:R,timeSaved:j}=d;return e.jsxs("div",{className:"grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-3",children:[e.jsx(W,{cacheHitsSession:b.session,cacheHitsTotal:b.total,tokensSavedSession:b.sessionTokensSaved,tokensSavedTotal:b.totalTokensSaved,compactionsSession:R.session,compactionsTotal:R.total}),e.jsx(F,{compactSessionSec:j.compact.sessionSec,compactTotalSec:j.compact.totalSec,cacheHitSessionSec:j.cacheHit.sessionSec,cacheHitTotalSec:j.cacheHit.totalSec})]})})()]})}export{oe as default};
-//# sourceMappingURL=CacheTab-BS_G9_YV.js.map