pi-mega-compact 0.20.47 → 0.20.48

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

@@ -0,0 +1,36 @@
+/**
+ * config/vector-cortex-enc0f.ts — ENC-0f p95 + marginal-RSS qualification gate.
+ *
+ * Extracted from vector-cortex.ts so that file stays under the 300-line soft
+ * limit (soft-as-hard gate), exactly as vector-cortex-enc0a.ts / enc0b.ts /
+ * enc0c.ts / enc0d.ts / enc0e.ts and the VC8C/VC9A-D/ML5A-E/DEDUP_ATTR
+ * siblings were. vector-cortex.ts re-exports the flag below and root
+ * src/config.ts re-exports it, so no consumer import path changes.
+ *
+ * ENC-0f closes HG-5 (RSS margin) with a real asset: the qualification gate
+ * that admits the ENC-0d-promoted trained asset to mode A. The gate runs the
+ * ML5-B bench under --expose-gc and asserts p95 ≤ ENCODER_LATENCY_P95_MS
+ * (40 ms @ 512 tokens / 4 threads), marginal RSS ≤ ENCODER_RSS_BUDGET_BYTES
+ * (150 MiB, baseline-subtracted), determinism (distinct digests == 1), and
+ * the opset-21 handshake. On pass it emits a QualificationV1 record that flips
+ * the runtime to qualified mode A; on any failure the asset stays demoted.
+ *
+ * `MEGACOMPACT_ENC_0F=0` disables the gate entirely: no qualification gate
+ * runs, no QualificationV1 record is written for the real trained asset, and
+ * the runtime keeps serving the ENC-0d survivor. Flag-off is byte-identical to
+ * the predecessor. The flag MUST also be a dashboard SETTINGS toggle (visible
+ * in config UI, never in EXCLUDED_SETTINGS).
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+import { sprintFlag } from "./vector-cortex-flag.js";
+/**
+ * ENC-0f — p95 + marginal-RSS qualification gate for the real trained asset.
+ * Default ON. `MEGACOMPACT_ENC_0F=0` disables and is byte-identical to the
+ * predecessor (ENC-0e): no qualification gate runs, no QualificationV1 record
+ * is written for the real trained asset, and the runtime keeps serving the
+ * ENC-0d survivor. This flag MUST also be a dashboard SETTINGS toggle (visible
+ * in config UI, never in EXCLUDED_SETTINGS), mirroring
+ * ENC_0A/ENC_0B/ENC_0C/ENC_0D/ENC_0E.
+ */
+export const ENC_0F_ENABLED = () => sprintFlag("MEGACOMPACT_ENC_0F");

package/dist/config/vector-cortex.js

@@ -30,5 +30,6 @@ export { ENC_0B_ENABLED } from "./vector-cortex-enc0b.js";
 export { ENC_0C_ENABLED } from "./vector-cortex-enc0c.js";
 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";
 // Breaker constants (TRIAD_RESILIENCE.md §breaker) extracted to vector-cortex-breakers.ts.
 export { BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./vector-cortex-breakers.js";

package/dist/config.js

@@ -114,4 +114,4 @@ export const NEW_UI = () => ragEnabled("MEGACOMPACT_NEW_UI");
 // default ON, `=0`/`_DISABLED` off. Re-exported from src/config/vector-cortex.ts
 // so root consumers share one source of truth.
 // ---------------------------------------------------------------------------
-export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, VC6A_ENABLED, VC6B_ENABLED, VC6C_ENABLED, VC7A_ENABLED, VC7B_ENABLED, VC7C_ENABLED, VC8A_ENABLED, VC8B_ENABLED, VC8C_ENABLED, VC9A_ENABLED, VC9B_ENABLED, VC9C_ENABLED, VC9D_ENABLED, PCC_ENABLED, ML5A_ENABLED, ML5B_ENABLED, ML5C_ENABLED, ML5D_ENABLED, ML5E_ENABLED, DEDUP_ATTR_ENABLED, ENC_0A_ENABLED, ENC_0B_ENABLED, ENC_0C_ENABLED, ENC_0D_ENABLED, ENC_0E_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";
+export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, VC6A_ENABLED, VC6B_ENABLED, VC6C_ENABLED, VC7A_ENABLED, VC7B_ENABLED, VC7C_ENABLED, VC8A_ENABLED, VC8B_ENABLED, VC8C_ENABLED, VC9A_ENABLED, VC9B_ENABLED, VC9C_ENABLED, VC9D_ENABLED, PCC_ENABLED, ML5A_ENABLED, ML5B_ENABLED, ML5C_ENABLED, ML5D_ENABLED, ML5E_ENABLED, DEDUP_ATTR_ENABLED, ENC_0A_ENABLED, ENC_0B_ENABLED, ENC_0C_ENABLED, ENC_0D_ENABLED, ENC_0E_ENABLED, ENC_0F_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";

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

@@ -63,5 +63,6 @@ export const VECTOR_CORTEX_SETTINGS = {
         boolDirect("MEGACOMPACT_ENC_0C", "ENC-0c Five-Head Supervision Transfer", "ENC-0c five-head supervision transfer on the frozen bge-small trunk: when a developer-trained head candidate is staged under ~/.pi/mega-compact-encoder/candidates/, the five heads serve the trained weights. OFF = no candidate is loaded, the heads serve byte-identical ENC-0b survivor defaults.", true),
         boolDirect("MEGACOMPACT_ENC_0D", "ENC-0d Real-Asset Promotion Gate", "ENC-0d promotion gate over real trained assets: accepts a {color} real candidate manifest (the ENC-0c trained head weights + the ENC-0b trunk), digest-verifies every staged byte, and atomically swaps the shipped manifest to a green candidate with rollback-to-previous on qualification failure. OFF = accepts no candidate, swaps nothing, emits nothing, shipped manifest stays at the ENC-0c survivor.", true),
         boolDirect("MEGACOMPACT_ENC_0E", "ENC-0e darwin-x64 Demotion Reason", "ENC-0e darwin-x64 explicit demotion: on an Intel Mac the runtime demotes to WASM (no native binary upstream); this surfaces a deterministic reason on the runtime-selection event and the Setup Cortex blockers card so an operator sees why mode A is unreachable. OFF = no demotion reason on the event and no Setup card row (the ML5-C WASM demotion itself remains the default, byte-identical predecessor).", true),
+        boolDirect("MEGACOMPACT_ENC_0F", "ENC-0f p95 + marginal-RSS Qualification Gate", "ENC-0f p95 + marginal-RSS qualification gate (real trained asset → mode A): runs the ENC-0d-promoted trained asset through the bench under --expose-gc, asserts p95 ≤ 40 ms @ 512/4 threads, marginal RSS ≤ 150 MiB (baseline-subtracted), determinism, and opset-21; on pass emits QualificationV1 + flips runtime to qualified mode A, on failure asset stays demoted to mode B. OFF = no qualification gate runs, no QualificationV1 written, runtime keeps serving the ENC-0d survivor (byte-identical predecessor).", true),
     ],
 };

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

@@ -0,0 +1,36 @@
+/**
+ * config/vector-cortex-enc0f.ts — ENC-0f p95 + marginal-RSS qualification gate.
+ *
+ * Extracted from vector-cortex.ts so that file stays under the 300-line soft
+ * limit (soft-as-hard gate), exactly as vector-cortex-enc0a.ts / enc0b.ts /
+ * enc0c.ts / enc0d.ts / enc0e.ts and the VC8C/VC9A-D/ML5A-E/DEDUP_ATTR
+ * siblings were. vector-cortex.ts re-exports the flag below and root
+ * src/config.ts re-exports it, so no consumer import path changes.
+ *
+ * ENC-0f closes HG-5 (RSS margin) with a real asset: the qualification gate
+ * that admits the ENC-0d-promoted trained asset to mode A. The gate runs the
+ * ML5-B bench under --expose-gc and asserts p95 ≤ ENCODER_LATENCY_P95_MS
+ * (40 ms @ 512 tokens / 4 threads), marginal RSS ≤ ENCODER_RSS_BUDGET_BYTES
+ * (150 MiB, baseline-subtracted), determinism (distinct digests == 1), and
+ * the opset-21 handshake. On pass it emits a QualificationV1 record that flips
+ * the runtime to qualified mode A; on any failure the asset stays demoted.
+ *
+ * `MEGACOMPACT_ENC_0F=0` disables the gate entirely: no qualification gate
+ * runs, no QualificationV1 record is written for the real trained asset, and
+ * the runtime keeps serving the ENC-0d survivor. Flag-off is byte-identical to
+ * the predecessor. The flag MUST also be a dashboard SETTINGS toggle (visible
+ * in config UI, never in EXCLUDED_SETTINGS).
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+import { sprintFlag } from "./vector-cortex-flag.js";
+/**
+ * ENC-0f — p95 + marginal-RSS qualification gate for the real trained asset.
+ * Default ON. `MEGACOMPACT_ENC_0F=0` disables and is byte-identical to the
+ * predecessor (ENC-0e): no qualification gate runs, no QualificationV1 record
+ * is written for the real trained asset, and the runtime keeps serving the
+ * ENC-0d survivor. This flag MUST also be a dashboard SETTINGS toggle (visible
+ * in config UI, never in EXCLUDED_SETTINGS), mirroring
+ * ENC_0A/ENC_0B/ENC_0C/ENC_0D/ENC_0E.
+ */
+export const ENC_0F_ENABLED = () => sprintFlag("MEGACOMPACT_ENC_0F");

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

@@ -30,5 +30,6 @@ export { ENC_0B_ENABLED } from "./vector-cortex-enc0b.js";
 export { ENC_0C_ENABLED } from "./vector-cortex-enc0c.js";
 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";
 // Breaker constants (TRIAD_RESILIENCE.md §breaker) extracted to vector-cortex-breakers.ts.
 export { BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./vector-cortex-breakers.js";

package/dist/src/config.js

@@ -114,4 +114,4 @@ export const NEW_UI = () => ragEnabled("MEGACOMPACT_NEW_UI");
 // default ON, `=0`/`_DISABLED` off. Re-exported from src/config/vector-cortex.ts
 // so root consumers share one source of truth.
 // ---------------------------------------------------------------------------
-export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, VC6A_ENABLED, VC6B_ENABLED, VC6C_ENABLED, VC7A_ENABLED, VC7B_ENABLED, VC7C_ENABLED, VC8A_ENABLED, VC8B_ENABLED, VC8C_ENABLED, VC9A_ENABLED, VC9B_ENABLED, VC9C_ENABLED, VC9D_ENABLED, PCC_ENABLED, ML5A_ENABLED, ML5B_ENABLED, ML5C_ENABLED, ML5D_ENABLED, ML5E_ENABLED, DEDUP_ATTR_ENABLED, ENC_0A_ENABLED, ENC_0B_ENABLED, ENC_0C_ENABLED, ENC_0D_ENABLED, ENC_0E_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";
+export { VC0A_ENABLED, VC0B_ENABLED, VC1A_ENABLED, VC0C_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, VC3A_ENABLED, VC3B_ENABLED, VC3C_ENABLED, VC4A_ENABLED, VC4B_ENABLED, VC4C_ENABLED, VC5A_ENABLED, VC5B_ENABLED, VC5C_ENABLED, VC6A_ENABLED, VC6B_ENABLED, VC6C_ENABLED, VC7A_ENABLED, VC7B_ENABLED, VC7C_ENABLED, VC8A_ENABLED, VC8B_ENABLED, VC8C_ENABLED, VC9A_ENABLED, VC9B_ENABLED, VC9C_ENABLED, VC9D_ENABLED, PCC_ENABLED, ML5A_ENABLED, ML5B_ENABLED, ML5C_ENABLED, ML5D_ENABLED, ML5E_ENABLED, DEDUP_ATTR_ENABLED, ENC_0A_ENABLED, ENC_0B_ENABLED, ENC_0C_ENABLED, ENC_0D_ENABLED, ENC_0E_ENABLED, ENC_0F_ENABLED, BREAKER_WINDOW_MS, BREAKER_MIN_ATTEMPTS, BREAKER_PERF_FAILURES, BREAKER_PERF_FAILURE_RATE, BREAKER_CORRECTNESS_FAILURES, BREAKER_COOLDOWN_MS, BREAKER_PROBE_COUNT, BREAKER_RETRY_BASE_MS, BREAKER_RETRY_CAP_MS, BREAKER_RETRY_JITTER, BREAKER_HYSTERESIS_FAILURE_RATE, BREAKER_HYSTERESIS_BUDGET_P95_MS, BREAKER_MIN_HEALTHY_RESIDENCE_MS, } from "./config/vector-cortex.js";

package/dist/src/vector-cortex/encoder/qualify.js

@@ -0,0 +1,50 @@
+/**
+ * vector-cortex/encoder/qualify.ts — ENC-0f pure qualification function.
+ *
+ * Constructs a {@link QualificationV1} record from a {@link BenchResultV1} by
+ * asserting four independent gates (latency, marginal-RSS, determinism, opset)
+ * plus the bench's own conjunctive `gates.all`. A gated-off bench can NEVER be
+ * swept into mode A by a sub-threshold p95 alone — `bench_gates_not_green`
+ * forces `"failed"` regardless of the sub-threshold values.
+ *
+ * Pure (TRIAD_RESILIENCE §pure): no `any` (PREVENT-011), no casts, no clock, no
+ * storage, no network (PREVENT-PI-004). Thresholds are sourced from
+ * {@link ENCODER_LATENCY_P95_MS} / {@link ENCODER_RSS_BUDGET_BYTES} /
+ * {@link ENCODER_OPSET} — never magic numbers.
+ */
+import { ENCODER_LATENCY_P95_MS, ENCODER_RSS_BUDGET_BYTES, ENCODER_OPSET, } from "./types.js";
+/**
+ * Qualify a bench result against the four independent gates + the bench's own
+ * conjunctive gate. Returns a QualificationV1 with `verdict:"qualified"` only
+ * when ALL gates pass and `bench.gates.all` is true.
+ */
+export function qualifyEncodedAsset(bench, platform) {
+    const reasons = [];
+    if (bench.p95Ms !== null && bench.p95Ms > ENCODER_LATENCY_P95_MS) {
+        reasons.push("latency");
+    }
+    if (bench.rssMarginalMib !== null &&
+        bench.rssMarginalMib * 1024 * 1024 > ENCODER_RSS_BUDGET_BYTES) {
+        reasons.push("rss");
+    }
+    if (!bench.deterministic) {
+        reasons.push("determinism");
+    }
+    if (bench.opset !== null && bench.opset !== ENCODER_OPSET) {
+        reasons.push("opset");
+    }
+    if (!bench.gates.all && !reasons.includes("bench_gates_not_green")) {
+        reasons.push("bench_gates_not_green");
+    }
+    const verdict = reasons.length === 0 && bench.gates.all ? "qualified" : "failed";
+    return {
+        schema: "qualification-v1",
+        verdict,
+        reasons,
+        platform,
+        p95Ms: bench.p95Ms ?? 0,
+        rssMib: bench.rssMarginalMib ?? 0,
+        opset: bench.opset ?? 0,
+        digest: bench.digest ?? "",
+    };
+}

package/dist/vector-cortex/encoder/qualify.js

@@ -0,0 +1,50 @@
+/**
+ * vector-cortex/encoder/qualify.ts — ENC-0f pure qualification function.
+ *
+ * Constructs a {@link QualificationV1} record from a {@link BenchResultV1} by
+ * asserting four independent gates (latency, marginal-RSS, determinism, opset)
+ * plus the bench's own conjunctive `gates.all`. A gated-off bench can NEVER be
+ * swept into mode A by a sub-threshold p95 alone — `bench_gates_not_green`
+ * forces `"failed"` regardless of the sub-threshold values.
+ *
+ * Pure (TRIAD_RESILIENCE §pure): no `any` (PREVENT-011), no casts, no clock, no
+ * storage, no network (PREVENT-PI-004). Thresholds are sourced from
+ * {@link ENCODER_LATENCY_P95_MS} / {@link ENCODER_RSS_BUDGET_BYTES} /
+ * {@link ENCODER_OPSET} — never magic numbers.
+ */
+import { ENCODER_LATENCY_P95_MS, ENCODER_RSS_BUDGET_BYTES, ENCODER_OPSET, } from "./types.js";
+/**
+ * Qualify a bench result against the four independent gates + the bench's own
+ * conjunctive gate. Returns a QualificationV1 with `verdict:"qualified"` only
+ * when ALL gates pass and `bench.gates.all` is true.
+ */
+export function qualifyEncodedAsset(bench, platform) {
+    const reasons = [];
+    if (bench.p95Ms !== null && bench.p95Ms > ENCODER_LATENCY_P95_MS) {
+        reasons.push("latency");
+    }
+    if (bench.rssMarginalMib !== null &&
+        bench.rssMarginalMib * 1024 * 1024 > ENCODER_RSS_BUDGET_BYTES) {
+        reasons.push("rss");
+    }
+    if (!bench.deterministic) {
+        reasons.push("determinism");
+    }
+    if (bench.opset !== null && bench.opset !== ENCODER_OPSET) {
+        reasons.push("opset");
+    }
+    if (!bench.gates.all && !reasons.includes("bench_gates_not_green")) {
+        reasons.push("bench_gates_not_green");
+    }
+    const verdict = reasons.length === 0 && bench.gates.all ? "qualified" : "failed";
+    return {
+        schema: "qualification-v1",
+        verdict,
+        reasons,
+        platform,
+        p95Ms: bench.p95Ms ?? 0,
+        rssMib: bench.rssMarginalMib ?? 0,
+        opset: bench.opset ?? 0,
+        digest: bench.digest ?? "",
+    };
+}

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

@@ -282,5 +282,11 @@ export const VECTOR_CORTEX_SETTINGS: SettingGroup = {
 			"ENC-0e darwin-x64 explicit demotion: on an Intel Mac the runtime demotes to WASM (no native binary upstream); this surfaces a deterministic reason on the runtime-selection event and the Setup Cortex blockers card so an operator sees why mode A is unreachable. OFF = no demotion reason on the event and no Setup card row (the ML5-C WASM demotion itself remains the default, byte-identical predecessor).",
 			true,
 		),
+		boolDirect(
+			"MEGACOMPACT_ENC_0F",
+			"ENC-0f p95 + marginal-RSS Qualification Gate",
+			"ENC-0f p95 + marginal-RSS qualification gate (real trained asset → mode A): runs the ENC-0d-promoted trained asset through the bench under --expose-gc, asserts p95 ≤ 40 ms @ 512/4 threads, marginal RSS ≤ 150 MiB (baseline-subtracted), determinism, and opset-21; on pass emits QualificationV1 + flips runtime to qualified mode A, on failure asset stays demoted to mode B. OFF = no qualification gate runs, no QualificationV1 written, runtime keeps serving the ENC-0d survivor (byte-identical predecessor).",
+			true,
+		),
 	],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.20.47",
+  "version": "0.20.48",
   "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-enc0f.ts

@@ -0,0 +1,38 @@
+/**
+ * config/vector-cortex-enc0f.ts — ENC-0f p95 + marginal-RSS qualification gate.
+ *
+ * Extracted from vector-cortex.ts so that file stays under the 300-line soft
+ * limit (soft-as-hard gate), exactly as vector-cortex-enc0a.ts / enc0b.ts /
+ * enc0c.ts / enc0d.ts / enc0e.ts and the VC8C/VC9A-D/ML5A-E/DEDUP_ATTR
+ * siblings were. vector-cortex.ts re-exports the flag below and root
+ * src/config.ts re-exports it, so no consumer import path changes.
+ *
+ * ENC-0f closes HG-5 (RSS margin) with a real asset: the qualification gate
+ * that admits the ENC-0d-promoted trained asset to mode A. The gate runs the
+ * ML5-B bench under --expose-gc and asserts p95 ≤ ENCODER_LATENCY_P95_MS
+ * (40 ms @ 512 tokens / 4 threads), marginal RSS ≤ ENCODER_RSS_BUDGET_BYTES
+ * (150 MiB, baseline-subtracted), determinism (distinct digests == 1), and
+ * the opset-21 handshake. On pass it emits a QualificationV1 record that flips
+ * the runtime to qualified mode A; on any failure the asset stays demoted.
+ *
+ * `MEGACOMPACT_ENC_0F=0` disables the gate entirely: no qualification gate
+ * runs, no QualificationV1 record is written for the real trained asset, and
+ * the runtime keeps serving the ENC-0d survivor. Flag-off is byte-identical to
+ * the predecessor. The flag MUST also be a dashboard SETTINGS toggle (visible
+ * in config UI, never in EXCLUDED_SETTINGS).
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+
+import { sprintFlag } from "./vector-cortex-flag.js";
+
+/**
+ * ENC-0f — p95 + marginal-RSS qualification gate for the real trained asset.
+ * Default ON. `MEGACOMPACT_ENC_0F=0` disables and is byte-identical to the
+ * predecessor (ENC-0e): no qualification gate runs, no QualificationV1 record
+ * is written for the real trained asset, and the runtime keeps serving the
+ * ENC-0d survivor. This flag MUST also be a dashboard SETTINGS toggle (visible
+ * in config UI, never in EXCLUDED_SETTINGS), mirroring
+ * ENC_0A/ENC_0B/ENC_0C/ENC_0D/ENC_0E.
+ */
+export const ENC_0F_ENABLED = (): boolean => sprintFlag("MEGACOMPACT_ENC_0F");

package/src/config/vector-cortex.ts

@@ -60,6 +60,7 @@ export { ENC_0B_ENABLED } from "./vector-cortex-enc0b.js";
 export { ENC_0C_ENABLED } from "./vector-cortex-enc0c.js";
 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";
 // Breaker constants (TRIAD_RESILIENCE.md §breaker) extracted to vector-cortex-breakers.ts.
 export {
   BREAKER_WINDOW_MS,

package/src/config.ts

@@ -194,6 +194,7 @@ export {
   ENC_0C_ENABLED,
   ENC_0D_ENABLED,
   ENC_0E_ENABLED,
+  ENC_0F_ENABLED,
   BREAKER_WINDOW_MS,
   BREAKER_MIN_ATTEMPTS,
   BREAKER_PERF_FAILURES,

package/src/vector-cortex/encoder/qualify.ts

@@ -0,0 +1,83 @@
+/**
+ * vector-cortex/encoder/qualify.ts — ENC-0f pure qualification function.
+ *
+ * Constructs a {@link QualificationV1} record from a {@link BenchResultV1} by
+ * asserting four independent gates (latency, marginal-RSS, determinism, opset)
+ * plus the bench's own conjunctive `gates.all`. A gated-off bench can NEVER be
+ * swept into mode A by a sub-threshold p95 alone — `bench_gates_not_green`
+ * forces `"failed"` regardless of the sub-threshold values.
+ *
+ * Pure (TRIAD_RESILIENCE §pure): no `any` (PREVENT-011), no casts, no clock, no
+ * storage, no network (PREVENT-PI-004). Thresholds are sourced from
+ * {@link ENCODER_LATENCY_P95_MS} / {@link ENCODER_RSS_BUDGET_BYTES} /
+ * {@link ENCODER_OPSET} — never magic numbers.
+ */
+
+import type { BenchResultV1 } from "./bench-export.js";
+import {
+  ENCODER_LATENCY_P95_MS,
+  ENCODER_RSS_BUDGET_BYTES,
+  ENCODER_OPSET,
+} from "./types.js";
+
+/** The qualification verdict for a real trained encoder asset. */
+export interface QualificationV1 {
+  readonly schema: "qualification-v1";
+  readonly verdict: "qualified" | "failed";
+  readonly reasons: string[];
+  readonly platform: string;
+  readonly p95Ms: number;
+  readonly rssMib: number;
+  readonly opset: number;
+  /** SHA-256 hex of the bench run's embedding output (never payload content). */
+  readonly digest: string;
+}
+
+/**
+ * Qualify a bench result against the four independent gates + the bench's own
+ * conjunctive gate. Returns a QualificationV1 with `verdict:"qualified"` only
+ * when ALL gates pass and `bench.gates.all` is true.
+ */
+export function qualifyEncodedAsset(
+  bench: BenchResultV1,
+  platform: string,
+): QualificationV1 {
+  const reasons: string[] = [];
+
+  if (bench.p95Ms !== null && bench.p95Ms > ENCODER_LATENCY_P95_MS) {
+    reasons.push("latency");
+  }
+
+  if (
+    bench.rssMarginalMib !== null &&
+    bench.rssMarginalMib * 1024 * 1024 > ENCODER_RSS_BUDGET_BYTES
+  ) {
+    reasons.push("rss");
+  }
+
+  if (!bench.deterministic) {
+    reasons.push("determinism");
+  }
+
+  if (bench.opset !== null && bench.opset !== ENCODER_OPSET) {
+    reasons.push("opset");
+  }
+
+  if (!bench.gates.all && !reasons.includes("bench_gates_not_green")) {
+    reasons.push("bench_gates_not_green");
+  }
+
+  const verdict: "qualified" | "failed" =
+    reasons.length === 0 && bench.gates.all ? "qualified" : "failed";
+
+  return {
+    schema: "qualification-v1",
+    verdict,
+    reasons,
+    platform,
+    p95Ms: bench.p95Ms ?? 0,
+    rssMib: bench.rssMarginalMib ?? 0,
+    opset: bench.opset ?? 0,
+    digest: bench.digest ?? "",
+  };
+}