pi-mega-compact 0.20.45 → 0.20.47

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

@@ -0,0 +1,39 @@
+/**
+ * config/vector-cortex-enc0d.ts — ENC-0d promotion gate over real trained assets.
+ *
+ * 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 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-0d turns the ML5-E promotion gate into the real-asset promotion path:
+ * it accepts a `{color}` real candidate manifest (the ENC-0c trained head
+ * weights + the ENC-0b trunk, staged under
+ * ~/.pi/mega-compact-encoder/candidates/), digest-verifies every staged byte
+ * before any swap, and performs an atomic asset swap with rollback-to-previous
+ * on qualification failure. The extension itself never stages candidate assets —
+ * only the operator trains them. When the flag is ON and a digest-verified
+ * green candidate exists, an atomic swap is performed and the runtime flips into
+ * qualified mode A; a red qualification (or any verification failure) keeps the
+ * prior asset live and emits a demotion.
+ *
+ * `MEGACOMPACT_ENC_0D=0` accepts no candidate, swaps nothing, emits nothing, and
+ * the shipped manifest stays at the ENC-0c survivor — byte-identical predecessor.
+ *
+ * The split is purely mechanical: ENC_0D_ENABLED follows ENC_0C_ENABLED in name,
+ * semantics, and default, 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";
+/**
+ * ENC-0d — atomic real-asset promotion over trained candidates. Default ON.
+ * `MEGACOMPACT_ENC_0D=0` disables and is byte-identical to the predecessor
+ * (ENC-0c): no candidate is accepted, no swap is performed, no promote/
+ * demote/rollback events are emitted, and the shipped manifest stays at the
+ * ENC-0c 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.
+ */
+export const ENC_0D_ENABLED = () => sprintFlag("MEGACOMPACT_ENC_0D");

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

@@ -0,0 +1,40 @@
+/**
+ * config/vector-cortex-enc0e.ts — ENC-0e darwin-x64 explicit demotion reason.
+ *
+ * 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 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-0e closes HG-4's operator-visibility gap on macOS Intel (darwin-x64): the
+ * platform has no native binary upstream (arm64-only; a darwin-x64
+ * transform-class package ships only WASM), so the runtime demotes to mode-B
+ * WASM per HG-4. That demotion already exists in the ML5-C decision rule —
+ * ENC-0e makes it EXPLICIT by surfacing a deterministic demotion reason on the
+ * runtime-selection event and on the Setup Cortex blockers card, so an
+ * Intel-Mac operator sees exactly why mode A is unreachable.
+ *
+ * `MEGACOMPACT_ENC_0E=0` strips ONLY the reason surface: no demotionReason on
+ * the runtime-selection event, no Setup card row. The ML5-C demotion itself
+ * (mode-B/WASM on Intel Mac) remains the default and is NOT gated off — so the
+ * flag-off path is byte-identical to the predecessor. The flag MUST also be a
+ * dashboard SETTINGS toggle (visible, never in EXCLUDED_SETTINGS).
+ *
+ * The split is purely mechanical: ENC_0E_ENABLED follows ENC_0D_ENABLED in
+ * name, semantics, and default, 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";
+/**
+ * ENC-0e — darwin-x64 explicit demotion reason. Default ON.
+ * `MEGACOMPACT_ENC_0E=0` disables and is byte-identical to the predecessor
+ * (ENC-0d): the runtime-selection event carries no demotionReason and the Setup
+ * Cortex blockers card renders no demotion-reason row. The ML5-C darwin-x64
+ * WASM demotion itself is NOT gated off — only the explicit reason surface is.
+ * 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.
+ */
+export const ENC_0E_ENABLED = () => sprintFlag("MEGACOMPACT_ENC_0E");

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

@@ -0,0 +1,239 @@
+/**
+ * config/vector-cortex-vc3to8.ts — VC3A..VC8B flag siblings (extracted).
+ *
+ * Mechanical extract from vector-cortex.ts so that barrel stays under the
+ * 300-line soft-as-hard cap (each sprint adds one re-export line; the VC3A..VC8B
+ * inline definitions were the bulk). Mirrors the vector-cortex-early.ts precedent
+ * (VC0A..VC2C extracted there) and the VC8C+/ML5/ENC sibling-extract pattern.
+ * vector-cortex.ts re-exports every flag below, so no consumer import path changes.
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011). Default ON;
+ * `=0` byte-identical to the predecessor for every flag.
+ */
+import { sprintFlag } from "./vector-cortex-flag.js";
+/**
+ * VC3A — capability-gated cortex store (CortexReader/Writer/Admin, CortexRecordV1).
+ * Default ON. `MEGACOMPACT_VC3A=0` disables and is byte-identical to the
+ * predecessor (mode C: the derived cortex store is absent, mode B in-memory is
+ * not consulted, zero `vector_cortex_record_append_failed` /
+ * `vector_cortex_generation_rebuilt` emissions; the predecessor derived pointer
+ * and goldens are unchanged). The real consumers are the cortex append seam, the
+ * cortex rebuild/admin seam and the reader-only topology summary seam.
+ */
+export const VC3A_ENABLED = () => sprintFlag("MEGACOMPACT_VC3A");
+/**
+ * VC3B — deterministic cortical topology (TopologyV1 / EdgeV1).
+ * Default ON. `MEGACOMPACT_VC3B=0` disables and is byte-identical to the
+ * predecessor (mode C: no topology graph is built or emitted, the dashboard
+ * topology view returns the VC3A-precise aggregation shape with no node/edge
+ * arrays, zero `vector_cortex_topology_*` emissions). The real consumers are
+ * the topology build seam (build.ts) and the dashboard topology node/edge view.
+ */
+export const VC3B_ENABLED = () => sprintFlag("MEGACOMPACT_VC3B");
+/**
+ * VC3C — topology query + router invalidation (TopologyQueryV1 / RouterKeyV2,
+ * M6 router-generation-v2 migration).
+ * Default ON. `MEGACOMPACT_VC3C=0` disables and is byte-identical to the
+ * predecessor (mode C: no length-delimited router key, no generation
+ * invalidation, zero `vector_cortex_router_generation_invalidated` /
+ * `vector_cortex_topology_query_demoted` emissions; the predecessor tiered
+ * router keying is unchanged). The real consumers are the topology query seam
+ * (query.ts), the M6 router-generation-v2 migration seam, and the reader-only
+ * dashboard topology query diagnostic view.
+ */
+export const VC3C_ENABLED = () => sprintFlag("MEGACOMPACT_VC3C");
+/**
+ * VC4A — dual-tier shard contract (SemanticShardV1 / ExactShardV1 /
+ * ShardManifestV1).
+ * Default ON. `MEGACOMPACT_VC4A=0` disables and is byte-identical to the
+ * predecessor (mode C: exact anchors/current transcript only, no semantic or
+ * exact shard manifest is assembled or emitted, zero
+ * `vector_cortex_shard_manifest_built` / `vector_cortex_protected_span_rejected`
+ * emissions; the predecessor derived pointer and goldens are unchanged). The
+ * real consumers are the shard assembly seam (manifest.ts) and the reader-only
+ * dashboard shards aggregate view.
+ */
+export const VC4A_ENABLED = () => sprintFlag("MEGACOMPACT_VC4A");
+/**
+ * VC4B — residual codec and numeric parity (ResidualCodecV1 / ParityShardV1).
+ * Default ON. `MEGACOMPACT_VC4B=0` disables and is byte-identical to the
+ * predecessor (mode C: no residual artifact is admitted, the exact compressed
+ * payload / ledger bytes remain the only representation, zero
+ * `vector_cortex_residual_admitted` / `vector_cortex_parity_recovery_failed`
+ * emissions; the VC4A shard manifest and its goldens are unchanged). The real
+ * consumers are the codec admission seam (codec.ts) and the reader-only
+ * dashboard residual aggregate view. The codec math itself is PURE — flag OFF
+ * gates the reporter/admission seam, never the arithmetic.
+ */
+export const VC4B_ENABLED = () => sprintFlag("MEGACOMPACT_VC4B");
+/**
+ * VC4C — reconstruction fidelity (closure + assemble + validate). Default ON.
+ * `MEGACOMPACT_VC4C=0` disables and is byte-identical to the predecessor
+ * (VC4B): no conservative closure is computed, the reconstruction validator's
+ * `vector_cortex_reconstruction_validated` / `vector_cortex_closure_rejected`
+ * events are never emitted, and the assembled reconstruction is never produced
+ * (the prompt continues to be built by the legacy VC4B exact/residual path and
+ * the VC4A shard goldens are unchanged). The closure/assemble/validate
+ * functions are PURE — flag OFF gates the reporter seam, never the arithmetic.
+ * This flag MUST also be a dashboard SETTINGS toggle (visible in config UI,
+ * never in EXCLUDED_SETTINGS), mirroring VC4A/VC4B.
+ */
+export const VC4C_ENABLED = () => sprintFlag("MEGACOMPACT_VC4C");
+/**
+ * VC5A — PromptDagV1 + budgeted portfolio planner. Default ON.
+ * `MEGACOMPACT_VC5A=0` disables and is byte-identical to the predecessor
+ * (VC4C): no prompt DAG is built or validated, no budgeted plan is selected,
+ * the `vector_cortex_plan_selected` / `vector_cortex_plan_mandatory_overflow`
+ * events are never emitted, and the prompt continues to be built by the
+ * predecessor VC4C closure/reconstruction path (its goldens are unchanged).
+ * The builder/validator/portfolio functions are PURE — flag OFF gates the
+ * reporter + dashboard seam, never the arithmetic. This flag MUST also be a
+ * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
+ * mirroring VC4A/VC4B/VC4C.
+ */
+export const VC5A_ENABLED = () => sprintFlag("MEGACOMPACT_VC5A");
+/**
+ * VC5B — validated prompt renderer + provider profiles. Default ON.
+ * `MEGACOMPACT_VC5B=0` disables and is byte-identical to the predecessor
+ * (VC5A): no render manifest is produced, no canonical request is hashed, the
+ * `vector_cortex_render_validated` / `vector_cortex_provider_bypassed` events are
+ * never emitted, and the prompt continues to be built by the predecessor VC5A
+ * DAG/plan path (its goldens are unchanged). The render/validate functions are
+ * PURE — flag OFF gates the reporter + dashboard seam, never the arithmetic.
+ * This flag MUST also be a dashboard SETTINGS toggle (visible in config UI, never
+ * in EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A.
+ */
+export const VC5B_ENABLED = () => sprintFlag("MEGACOMPACT_VC5B");
+/**
+ * VC5C — live graduated rollout. Default ON. `MEGACOMPACT_VC5C=0` disables and
+ * is byte-identical to the predecessor (VC5B): no session is assigned a stable
+ * 10k bucket, no gate-advance decision runs, the `vector_cortex_rollout_assigned`
+ * / `vector_cortex_rollout_promotion_blocked` events are never emitted, and the
+ * prompt continues to be built by the predecessor VC5B renderer path (its goldens
+ * are unchanged). The assign/gate/emit functions are PURE — flag OFF gates the
+ * reporter + dashboard seam, never the arithmetic. This flag MUST also be a
+ * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
+ * mirroring VC4A/VC4B/VC4C/VC5A/VC5B.
+ */
+export const VC5C_ENABLED = () => sprintFlag("MEGACOMPACT_VC5C");
+/**
+ * VC6A — advanced closure optimization. Default ON. `MEGACOMPACT_VC6A=0`
+ * disables and is byte-identical to the predecessor (VC5C): the `optimizeClosure`
+ * transitive-reduction arithmetic STILL RUNS (it is PURE), but the
+ * `vector_cortex_closure_optimized` / `vector_cortex_closure_proof_rejected`
+ * events are never emitted and the dashboard closure diagnostics seam is
+ * suppressed. Flag OFF gates the reporter + dashboard seam, never the arithmetic,
+ * so flag-off outbound/predecessor golden bytes match exactly. This flag MUST
+ * also be a dashboard SETTINGS toggle (visible in config UI, never in
+ * EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C.
+ */
+export const VC6A_ENABLED = () => sprintFlag("MEGACOMPACT_VC6A");
+/**
+ * VC6B — exact source restoration. Default ON. `MEGACOMPACT_VC6B=0` disables and
+ * is byte-identical to the predecessor (VC6A): the `restoreSources` /
+ * `verifyRestored` arithmetic STILL RUNS (it is PURE — an exact-source read plus
+ * a SHA-256 comparison, with no clock, storage, or network), but the
+ * `vector_cortex_source_restored` / `vector_cortex_restore_digest_rejected`
+ * events are never emitted and the dashboard restoration diagnostics seam is
+ * suppressed. Flag OFF gates the reporter + dashboard seam, never the
+ * restore/verify arithmetic, so flag-off outbound/predecessor golden bytes match
+ * exactly. This flag MUST also be a dashboard SETTINGS toggle (visible in config
+ * UI, never in EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C/VC6A.
+ */
+export const VC6B_ENABLED = () => sprintFlag("MEGACOMPACT_VC6B");
+/**
+ * VC6C — self-healing derived controller. Default ON. `MEGACOMPACT_VC6C=0`
+ * disables and is byte-identical to the predecessor (VC6B): the `detectGaps` /
+ * `planRebuild` / `rebuildGeneration` / `switchPointer` arithmetic STILL RUNS (it
+ * is PURE — a high-water comparison plus a SHA-256 root-digest check, with an
+ * INJECTED clock and no storage or network), but the
+ * `vector_cortex_repair_planned` / `vector_cortex_repair_pointer_switched` /
+ * `vector_cortex_repair_backoff` events are never emitted and the dashboard
+ * repair diagnostics seam is suppressed. Flag OFF gates the reporter + dashboard
+ * seam, never the gap-detection/rebuild arithmetic (in particular, an unverified
+ * pointer switch stays refused with the flag off), so flag-off
+ * outbound/predecessor golden bytes match exactly. This flag MUST also be a
+ * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
+ * mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C/VC6A/VC6B.
+ */
+export const VC6C_ENABLED = () => sprintFlag("MEGACOMPACT_VC6C");
+/**
+ * VC7A — frozen range crystals. Default ON. `MEGACOMPACT_VC7A=0` disables and is
+ * byte-identical to the predecessor (VC6C): the `encodeCrystalKey` /
+ * `CrystalStore` arithmetic STILL RUNS (it is PURE — a canonical length-prefixed
+ * encoding plus SHA-256, with no clock, storage, or network), so a crystal is
+ * keyed identically and a same-key/different-bytes write is still refused with
+ * the flag off. The flag gates ONLY the `vector_cortex_crystal_written` /
+ * `vector_cortex_crystal_collision` events and the cache-crystals dashboard seam,
+ * which reports `enabled:false` + mode C when off. Flag OFF never gates the
+ * crystal/store arithmetic, so flag-off outbound/predecessor golden bytes match
+ * exactly. This flag MUST also be a dashboard SETTINGS toggle (visible in config
+ * UI, never in EXCLUDED_SETTINGS), mirroring VC4A..VC6C.
+ */
+export const VC7A_ENABLED = () => sprintFlag("MEGACOMPACT_VC7A");
+/**
+ * VC7B — provider cache economics + crystal compiler. Default ON.
+ * `MEGACOMPACT_VC7B=0` disables and is byte-identical to the predecessor
+ * (VC7A): `computeEconomics`, `compileCrystalBoundaries` and `assignExperiment`
+ * STILL RUN (they are PURE — exact integer/rational arithmetic and a SHA-256
+ * session bucket, with no clock, storage, or network), so a session keeps its
+ * SAME experiment arm and the compiler keeps producing the SAME boundaries with
+ * the flag off. Crucially the compiler never changes request identity in either
+ * state, so the outbound canonical request — and therefore the VC7A crystal key
+ * and the predecessor golden bytes — are unaffected by this flag.
+ *
+ * The flag gates ONLY the `vector_cortex_cache_experiment_assigned` /
+ * `vector_cortex_cache_economics_estimated` events and the cache-economics
+ * dashboard seam, which reports `enabled:false` + mode C when off. This flag
+ * MUST also be a dashboard SETTINGS toggle (visible in config UI, never in
+ * EXCLUDED_SETTINGS), mirroring VC4A..VC7A.
+ */
+export const VC7B_ENABLED = () => sprintFlag("MEGACOMPACT_VC7B");
+/**
+ * VC7C — cache miss diagnostics, cache-level breakers and the completed M5
+ * request-hash-v2 switch. Default ON. `MEGACOMPACT_VC7C=0` disables and is
+ * byte-identical to the predecessor (VC7B): the miss `classify`, the breaker
+ * demotion decision and the M5 request-hash-v2 ARITHMETIC STILL RUN (they are
+ * PURE — an exclusive ordered comparison over already-computed digests plus a
+ * canonical length-prefixed SHA-256, with no clock, storage, or network), so a
+ * miss is classified into the SAME single class, a collision / stale generation
+ * / digest failure / profile mismatch still demotes BEFORE any cache serve, and
+ * the v2 hash of a given request is unchanged with the flag off. A cache is
+ * never allowed to serve a stale or colliding entry merely because reporting is
+ * off — that would be a correctness change, not a reporting change.
+ *
+ * The flag gates ONLY the `vector_cortex_cache_miss_classified` /
+ * `vector_cortex_cache_serve_blocked` events and the cache-diagnostics dashboard
+ * seam, which reports `enabled:false` + mode C when off. This flag MUST also be
+ * a dashboard SETTINGS toggle (visible in config UI, never in
+ * EXCLUDED_SETTINGS), mirroring VC4A..VC7B.
+ */
+export const VC7C_ENABLED = () => sprintFlag("MEGACOMPACT_VC7C");
+/**
+ * VC8A — consent-bound outcome ledger + offline learning dataset. Default ON.
+ * `MEGACOMPACT_VC8A=0` disables and is byte-identical to the predecessor
+ * (VC7C): the outcome ledger, consent records, and dataset manifest builder
+ * STILL RUN (they are PURE — append-only validation, consent evaluation, and
+ * SHA-256 digests, with no clock, storage, or network), so an outcome is still
+ * validated identically and a consent revocation still excludes a row. The
+ * flag gates ONLY the `vector_cortex_outcome_appended` /
+ * `vector_cortex_dataset_record_excluded` events and the outcomes dashboard
+ * seam, which reports `enabled:false` + mode C when off. This flag MUST also be
+ * a dashboard SETTINGS toggle (visible in config UI, never in
+ * EXCLUDED_SETTINGS), mirroring VC4A..VC7C.
+ */
+export const VC8A_ENABLED = () => sprintFlag("MEGACOMPACT_VC8A");
+/**
+ * VC8B — bounded shadow adaptive policy + M7 pressure-v2. Default ON.
+ * `MEGACOMPACT_VC8B=0` disables and is byte-identical to the predecessor
+ * (VC8A): the policy engine, shadow evaluator, and M7 migration STILL RUN
+ * (they are PURE — action validation, budget clamping, pressure canonicalization
+ * and copy/validate/switch, with no clock, storage, or network), so a budget is
+ * still clamped identically and an unknown pressure label is still rejected. The
+ * flag gates ONLY the `vector_cortex_shadow_decision_recorded` /
+ * `vector_cortex_policy_action_rejected` events and the policy dashboard seam,
+ * which reports `enabled:false` + mode C when off. This flag MUST also be a
+ * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
+ * mirroring VC4A..VC8A.
+ */
+export const VC8B_ENABLED = () => sprintFlag("MEGACOMPACT_VC8B");

package/dist/config/vector-cortex.js

@@ -7,236 +7,12 @@
  *
  * Breaker/triad constants (TRIAD_RESILIENCE.md) live here; pi-agnostic, dep-free.
  */
-import { sprintFlag } from "./vector-cortex-flag.js";
 // VC0/VC1/VC2 foundation-phase flags in vector-cortex-early.ts; re-exported
 // so every existing `from "./config/vector-cortex.js"` import resolves unchanged.
 export { VC0A_ENABLED, VC0B_ENABLED, VC0C_ENABLED, VC1A_ENABLED, VC1B_ENABLED, VC1C_ENABLED, VC2A_ENABLED, VC2B_ENABLED, VC2C_ENABLED, } from "./vector-cortex-early.js";
-/**
- * VC3A — capability-gated cortex store (CortexReader/Writer/Admin, CortexRecordV1).
- * Default ON. `MEGACOMPACT_VC3A=0` disables and is byte-identical to the
- * predecessor (mode C: the derived cortex store is absent, mode B in-memory is
- * not consulted, zero `vector_cortex_record_append_failed` /
- * `vector_cortex_generation_rebuilt` emissions; the predecessor derived pointer
- * and goldens are unchanged). The real consumers are the cortex append seam, the
- * cortex rebuild/admin seam and the reader-only topology summary seam.
- */
-export const VC3A_ENABLED = () => sprintFlag("MEGACOMPACT_VC3A");
-/**
- * VC3B — deterministic cortical topology (TopologyV1 / EdgeV1).
- * Default ON. `MEGACOMPACT_VC3B=0` disables and is byte-identical to the
- * predecessor (mode C: no topology graph is built or emitted, the dashboard
- * topology view returns the VC3A-precise aggregation shape with no node/edge
- * arrays, zero `vector_cortex_topology_*` emissions). The real consumers are
- * the topology build seam (build.ts) and the dashboard topology node/edge view.
- */
-export const VC3B_ENABLED = () => sprintFlag("MEGACOMPACT_VC3B");
-/**
- * VC3C — topology query + router invalidation (TopologyQueryV1 / RouterKeyV2,
- * M6 router-generation-v2 migration).
- * Default ON. `MEGACOMPACT_VC3C=0` disables and is byte-identical to the
- * predecessor (mode C: no length-delimited router key, no generation
- * invalidation, zero `vector_cortex_router_generation_invalidated` /
- * `vector_cortex_topology_query_demoted` emissions; the predecessor tiered
- * router keying is unchanged). The real consumers are the topology query seam
- * (query.ts), the M6 router-generation-v2 migration seam, and the reader-only
- * dashboard topology query diagnostic view.
- */
-export const VC3C_ENABLED = () => sprintFlag("MEGACOMPACT_VC3C");
-/**
- * VC4A — dual-tier shard contract (SemanticShardV1 / ExactShardV1 /
- * ShardManifestV1).
- * Default ON. `MEGACOMPACT_VC4A=0` disables and is byte-identical to the
- * predecessor (mode C: exact anchors/current transcript only, no semantic or
- * exact shard manifest is assembled or emitted, zero
- * `vector_cortex_shard_manifest_built` / `vector_cortex_protected_span_rejected`
- * emissions; the predecessor derived pointer and goldens are unchanged). The
- * real consumers are the shard assembly seam (manifest.ts) and the reader-only
- * dashboard shards aggregate view.
- */
-export const VC4A_ENABLED = () => sprintFlag("MEGACOMPACT_VC4A");
-/**
- * VC4B — residual codec and numeric parity (ResidualCodecV1 / ParityShardV1).
- * Default ON. `MEGACOMPACT_VC4B=0` disables and is byte-identical to the
- * predecessor (mode C: no residual artifact is admitted, the exact compressed
- * payload / ledger bytes remain the only representation, zero
- * `vector_cortex_residual_admitted` / `vector_cortex_parity_recovery_failed`
- * emissions; the VC4A shard manifest and its goldens are unchanged). The real
- * consumers are the codec admission seam (codec.ts) and the reader-only
- * dashboard residual aggregate view. The codec math itself is PURE — flag OFF
- * gates the reporter/admission seam, never the arithmetic.
- */
-export const VC4B_ENABLED = () => sprintFlag("MEGACOMPACT_VC4B");
-/**
- * VC4C — reconstruction fidelity (closure + assemble + validate). Default ON.
- * `MEGACOMPACT_VC4C=0` disables and is byte-identical to the predecessor
- * (VC4B): no conservative closure is computed, the reconstruction validator's
- * `vector_cortex_reconstruction_validated` / `vector_cortex_closure_rejected`
- * events are never emitted, and the assembled reconstruction is never produced
- * (the prompt continues to be built by the legacy VC4B exact/residual path and
- * the VC4A shard goldens are unchanged). The closure/assemble/validate
- * functions are PURE — flag OFF gates the reporter seam, never the arithmetic.
- * This flag MUST also be a dashboard SETTINGS toggle (visible in config UI,
- * never in EXCLUDED_SETTINGS), mirroring VC4A/VC4B.
- */
-export const VC4C_ENABLED = () => sprintFlag("MEGACOMPACT_VC4C");
-/**
- * VC5A — PromptDagV1 + budgeted portfolio planner. Default ON.
- * `MEGACOMPACT_VC5A=0` disables and is byte-identical to the predecessor
- * (VC4C): no prompt DAG is built or validated, no budgeted plan is selected,
- * the `vector_cortex_plan_selected` / `vector_cortex_plan_mandatory_overflow`
- * events are never emitted, and the prompt continues to be built by the
- * predecessor VC4C closure/reconstruction path (its goldens are unchanged).
- * The builder/validator/portfolio functions are PURE — flag OFF gates the
- * reporter + dashboard seam, never the arithmetic. This flag MUST also be a
- * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
- * mirroring VC4A/VC4B/VC4C.
- */
-export const VC5A_ENABLED = () => sprintFlag("MEGACOMPACT_VC5A");
-/**
- * VC5B — validated prompt renderer + provider profiles. Default ON.
- * `MEGACOMPACT_VC5B=0` disables and is byte-identical to the predecessor
- * (VC5A): no render manifest is produced, no canonical request is hashed, the
- * `vector_cortex_render_validated` / `vector_cortex_provider_bypassed` events are
- * never emitted, and the prompt continues to be built by the predecessor VC5A
- * DAG/plan path (its goldens are unchanged). The render/validate functions are
- * PURE — flag OFF gates the reporter + dashboard seam, never the arithmetic.
- * This flag MUST also be a dashboard SETTINGS toggle (visible in config UI, never
- * in EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A.
- */
-export const VC5B_ENABLED = () => sprintFlag("MEGACOMPACT_VC5B");
-/**
- * VC5C — live graduated rollout. Default ON. `MEGACOMPACT_VC5C=0` disables and
- * is byte-identical to the predecessor (VC5B): no session is assigned a stable
- * 10k bucket, no gate-advance decision runs, the `vector_cortex_rollout_assigned`
- * / `vector_cortex_rollout_promotion_blocked` events are never emitted, and the
- * prompt continues to be built by the predecessor VC5B renderer path (its goldens
- * are unchanged). The assign/gate/emit functions are PURE — flag OFF gates the
- * reporter + dashboard seam, never the arithmetic. This flag MUST also be a
- * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
- * mirroring VC4A/VC4B/VC4C/VC5A/VC5B.
- */
-export const VC5C_ENABLED = () => sprintFlag("MEGACOMPACT_VC5C");
-/**
- * VC6A — advanced closure optimization. Default ON. `MEGACOMPACT_VC6A=0`
- * disables and is byte-identical to the predecessor (VC5C): the `optimizeClosure`
- * transitive-reduction arithmetic STILL RUNS (it is PURE), but the
- * `vector_cortex_closure_optimized` / `vector_cortex_closure_proof_rejected`
- * events are never emitted and the dashboard closure diagnostics seam is
- * suppressed. Flag OFF gates the reporter + dashboard seam, never the arithmetic,
- * so flag-off outbound/predecessor golden bytes match exactly. This flag MUST
- * also be a dashboard SETTINGS toggle (visible in config UI, never in
- * EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C.
- */
-export const VC6A_ENABLED = () => sprintFlag("MEGACOMPACT_VC6A");
-/**
- * VC6B — exact source restoration. Default ON. `MEGACOMPACT_VC6B=0` disables and
- * is byte-identical to the predecessor (VC6A): the `restoreSources` /
- * `verifyRestored` arithmetic STILL RUNS (it is PURE — an exact-source read plus
- * a SHA-256 comparison, with no clock, storage, or network), but the
- * `vector_cortex_source_restored` / `vector_cortex_restore_digest_rejected`
- * events are never emitted and the dashboard restoration diagnostics seam is
- * suppressed. Flag OFF gates the reporter + dashboard seam, never the
- * restore/verify arithmetic, so flag-off outbound/predecessor golden bytes match
- * exactly. This flag MUST also be a dashboard SETTINGS toggle (visible in config
- * UI, never in EXCLUDED_SETTINGS), mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C/VC6A.
- */
-export const VC6B_ENABLED = () => sprintFlag("MEGACOMPACT_VC6B");
-/**
- * VC6C — self-healing derived controller. Default ON. `MEGACOMPACT_VC6C=0`
- * disables and is byte-identical to the predecessor (VC6B): the `detectGaps` /
- * `planRebuild` / `rebuildGeneration` / `switchPointer` arithmetic STILL RUNS (it
- * is PURE — a high-water comparison plus a SHA-256 root-digest check, with an
- * INJECTED clock and no storage or network), but the
- * `vector_cortex_repair_planned` / `vector_cortex_repair_pointer_switched` /
- * `vector_cortex_repair_backoff` events are never emitted and the dashboard
- * repair diagnostics seam is suppressed. Flag OFF gates the reporter + dashboard
- * seam, never the gap-detection/rebuild arithmetic (in particular, an unverified
- * pointer switch stays refused with the flag off), so flag-off
- * outbound/predecessor golden bytes match exactly. This flag MUST also be a
- * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
- * mirroring VC4A/VC4B/VC4C/VC5A/VC5B/VC5C/VC6A/VC6B.
- */
-export const VC6C_ENABLED = () => sprintFlag("MEGACOMPACT_VC6C");
-/**
- * VC7A — frozen range crystals. Default ON. `MEGACOMPACT_VC7A=0` disables and is
- * byte-identical to the predecessor (VC6C): the `encodeCrystalKey` /
- * `CrystalStore` arithmetic STILL RUNS (it is PURE — a canonical length-prefixed
- * encoding plus SHA-256, with no clock, storage, or network), so a crystal is
- * keyed identically and a same-key/different-bytes write is still refused with
- * the flag off. The flag gates ONLY the `vector_cortex_crystal_written` /
- * `vector_cortex_crystal_collision` events and the cache-crystals dashboard seam,
- * which reports `enabled:false` + mode C when off. Flag OFF never gates the
- * crystal/store arithmetic, so flag-off outbound/predecessor golden bytes match
- * exactly. This flag MUST also be a dashboard SETTINGS toggle (visible in config
- * UI, never in EXCLUDED_SETTINGS), mirroring VC4A..VC6C.
- */
-export const VC7A_ENABLED = () => sprintFlag("MEGACOMPACT_VC7A");
-/**
- * VC7B — provider cache economics + crystal compiler. Default ON.
- * `MEGACOMPACT_VC7B=0` disables and is byte-identical to the predecessor
- * (VC7A): `computeEconomics`, `compileCrystalBoundaries` and `assignExperiment`
- * STILL RUN (they are PURE — exact integer/rational arithmetic and a SHA-256
- * session bucket, with no clock, storage, or network), so a session keeps its
- * SAME experiment arm and the compiler keeps producing the SAME boundaries with
- * the flag off. Crucially the compiler never changes request identity in either
- * state, so the outbound canonical request — and therefore the VC7A crystal key
- * and the predecessor golden bytes — are unaffected by this flag.
- *
- * The flag gates ONLY the `vector_cortex_cache_experiment_assigned` /
- * `vector_cortex_cache_economics_estimated` events and the cache-economics
- * dashboard seam, which reports `enabled:false` + mode C when off. This flag
- * MUST also be a dashboard SETTINGS toggle (visible in config UI, never in
- * EXCLUDED_SETTINGS), mirroring VC4A..VC7A.
- */
-export const VC7B_ENABLED = () => sprintFlag("MEGACOMPACT_VC7B");
-/**
- * VC7C — cache miss diagnostics, cache-level breakers and the completed M5
- * request-hash-v2 switch. Default ON. `MEGACOMPACT_VC7C=0` disables and is
- * byte-identical to the predecessor (VC7B): the miss `classify`, the breaker
- * demotion decision and the M5 request-hash-v2 ARITHMETIC STILL RUN (they are
- * PURE — an exclusive ordered comparison over already-computed digests plus a
- * canonical length-prefixed SHA-256, with no clock, storage, or network), so a
- * miss is classified into the SAME single class, a collision / stale generation
- * / digest failure / profile mismatch still demotes BEFORE any cache serve, and
- * the v2 hash of a given request is unchanged with the flag off. A cache is
- * never allowed to serve a stale or colliding entry merely because reporting is
- * off — that would be a correctness change, not a reporting change.
- *
- * The flag gates ONLY the `vector_cortex_cache_miss_classified` /
- * `vector_cortex_cache_serve_blocked` events and the cache-diagnostics dashboard
- * seam, which reports `enabled:false` + mode C when off. This flag MUST also be
- * a dashboard SETTINGS toggle (visible in config UI, never in
- * EXCLUDED_SETTINGS), mirroring VC4A..VC7B.
- */
-export const VC7C_ENABLED = () => sprintFlag("MEGACOMPACT_VC7C");
-/**
- * VC8A — consent-bound outcome ledger + offline learning dataset. Default ON.
- * `MEGACOMPACT_VC8A=0` disables and is byte-identical to the predecessor
- * (VC7C): the outcome ledger, consent records, and dataset manifest builder
- * STILL RUN (they are PURE — append-only validation, consent evaluation, and
- * SHA-256 digests, with no clock, storage, or network), so an outcome is still
- * validated identically and a consent revocation still excludes a row. The
- * flag gates ONLY the `vector_cortex_outcome_appended` /
- * `vector_cortex_dataset_record_excluded` events and the outcomes dashboard
- * seam, which reports `enabled:false` + mode C when off. This flag MUST also be
- * a dashboard SETTINGS toggle (visible in config UI, never in
- * EXCLUDED_SETTINGS), mirroring VC4A..VC7C.
- */
-export const VC8A_ENABLED = () => sprintFlag("MEGACOMPACT_VC8A");
-/**
- * VC8B — bounded shadow adaptive policy + M7 pressure-v2. Default ON.
- * `MEGACOMPACT_VC8B=0` disables and is byte-identical to the predecessor
- * (VC8A): the policy engine, shadow evaluator, and M7 migration STILL RUN
- * (they are PURE — action validation, budget clamping, pressure canonicalization
- * and copy/validate/switch, with no clock, storage, or network), so a budget is
- * still clamped identically and an unknown pressure label is still rejected. The
- * flag gates ONLY the `vector_cortex_shadow_decision_recorded` /
- * `vector_cortex_policy_action_rejected` events and the policy dashboard seam,
- * which reports `enabled:false` + mode C when off. This flag MUST also be a
- * dashboard SETTINGS toggle (visible in config UI, never in EXCLUDED_SETTINGS),
- * mirroring VC4A..VC8A.
- */
-export const VC8B_ENABLED = () => sprintFlag("MEGACOMPACT_VC8B");
+// VC3A..VC8B flags extracted to vector-cortex-vc3to8.ts (mechanical move so
+// this barrel stays under the 300-line soft cap); re-exported unchanged.
+export { 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, } from "./vector-cortex-vc3to8.js";
 export { VC8C_ENABLED } from "./vector-cortex-vc8c.js";
 export { VC9A_ENABLED } from "./vector-cortex-vc9a.js";
 export { VC9B_ENABLED } from "./vector-cortex-vc9b.js";
@@ -252,5 +28,7 @@ export { DEDUP_ATTR_ENABLED } from "./vector-cortex-dedup-attr.js";
 export { ENC_0A_ENABLED } from "./vector-cortex-enc0a.js";
 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";
 // 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, 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, 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

@@ -61,5 +61,7 @@ export const VECTOR_CORTEX_SETTINGS = {
         boolDirect("MEGACOMPACT_ENC_0A", "ENC-0a Encoder Backend Decision", "ENC-0a learned-encoder backend-decision lock: records the transformers.js/WASM vs onnxruntime-node choice, per-platform install matrix, opset-21 baseline and pinned digests in docs/vector-cortex/encoder-backend-decision.md. OFF = no decision record written / no resolver runs, mode B trigram byte-identical predecessor.", true),
         boolDirect("MEGACOMPACT_ENC_0B", "ENC-0b Real Trunk Fetch & Gated Path", "ENC-0b real ONNX trunk fetch + gated inference: replaces the LCG placeholder with the real bge-small int8 model through an ONNX InferenceSession (onnxruntime-web WASM). OFF = LCG placeholder serves byte-identical predecessor output, no ONNX session built.", true),
         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),
     ],
 };

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

@@ -22,8 +22,9 @@ import { createHash } from "node:crypto";
 import { readFileSync, statSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { VC9A_ENABLED } from "../../src/config.js";
+import { VC9A_ENABLED, ENC_0E_ENABLED } from "../../src/config.js";
 import { readEncoderManifest, verifyEncoderAsset, detectPlatform } from "../../src/vector-cortex/encoder/asset.js";
+import { selectRuntimeBackend } from "../../src/vector-cortex/encoder/runtime-select.js";
 import { sendJson } from "./routes-vector-cortex-shared.js";
 import { deriveVcStatus } from "./vc-status.js";
 import { SETUP_CORTEX_BLOCKERS } from "./setup-cortex-blockers.js";
@@ -123,6 +124,11 @@ export function handleSetupCortexStatus(req, res, _ctx) {
     const enabled = VC9A_ENABLED();
     const facts = enabled ? setupCortexFacts() : null;
     const blocks = enabled ? [...SETUP_CORTEX_BLOCKERS] : [];
+    // ENC-0e: surface the darwin-x64 demotion reason additively (reader-only GET,
+    // no new route). The platform is read locally; the selection is pure. On a
+    // non-darwin-x64 host or flag-off this is null and the field is omitted —
+    // byte-compatible payload.
+    const darwinX64 = enabled ? darwinX64StatusBlock() : null;
     const body = {
         enabled,
         flag: "MEGACOMPACT_VC9A",
@@ -137,7 +143,30 @@ export function handleSetupCortexStatus(req, res, _ctx) {
             : { assetDigestPrefix: null, mode: "C" },
         updatedAt: new Date().toISOString(),
         status: deriveVcStatus({ enabled, hasData: !!facts && facts.verdict !== "unavailable", structuralOnly: true }),
+        ...(darwinX64 !== null ? { darwinX64 } : {}),
     };
     sendJson(res, 200, body);
     return true;
 }
+/**
+ * ENC-0e helper: the darwin-x64 demotion block for the setup-cortex status
+ * response. Exported for direct unit assertion without a live HTTP round-trip —
+ * returns null on any non-darwin-x64 platform or flag-off (so the additive
+ * contract field is omitted from the payload, byte-compatible). The demotion
+ * reason flows from the pure `selectRuntimeBackend` selection, never a literal
+ * in the route.
+ */
+export function darwinX64StatusBlock() {
+    const platform = detectPlatform();
+    if (platform !== "darwin-x64" || !ENC_0E_ENABLED())
+        return null;
+    const chosen = selectRuntimeBackend({
+        platform,
+        benchRecord: null,
+        nativeOptIn: process.env.MEGACOMPACT_ENCODER_NATIVE === "1",
+    });
+    return {
+        demoted: chosen.backend === "wasm",
+        reason: chosen.demotionReason ?? undefined,
+    };
+}