@event4u/agent-config 9.14.0 → 9.16.0

package/dist/scripts/_lib/surface_tiers.js

@@ -0,0 +1,125 @@
+/**
+ * Surface-tier (core vs lab) resolution for the install split.
+ *
+ * Ported from the retired Python `src/scripts/_lib/surface_tiers.py` (ADR-200 — Python→TS
+ * migration). Public API mirrors the Python module exactly (snake_case kept
+ * deliberately — fidelity over TS idiom).
+ *
+ * road-to-install-contract-stability Phase 2. `core` = the lean stable engine
+ * users install; `lab` = experimental / pilot tooling. A core-only install
+ * excludes `lab`-tier artefacts so lab churn cannot destabilise the adoptable
+ * surface.
+ *
+ * Pack tier lives in `src/config/discovery/packs.yml` (`surface_tier: lab`);
+ * the deployed artefacts carry it in frontmatter — commands as `pack:` (scalar),
+ * skills as `packs:` (list). The script-cluster tier registry is
+ * `src/scripts/surface-tiers.yml` (consumed by the boundary guard, not here).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// Conservative fallback if packs.yml is unreadable: the day-one lab packs.
+const _LAB_FALLBACK = new Set(['ai-video', 'ai-image', 'fun']);
+/** Pack ids tagged `surface_tier: lab` in packs.yml (+ safe fallback). */
+export function load_lab_pack_ids(repo_root) {
+    const vocab = path.join(repo_root, 'src', 'config', 'discovery', 'packs.yml');
+    const ids = new Set();
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const YAML = require('yaml');
+        // version '1.1' matches PyYAML's safe_load.
+        const data = YAML.parse(fs.readFileSync(vocab, 'utf-8'), { version: '1.1' });
+        for (const entry of data ?? []) {
+            if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
+                const rec = entry;
+                if (rec['surface_tier'] === 'lab') {
+                    const pid = rec['id'];
+                    if (typeof pid === 'string') {
+                        ids.add(pid);
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // packs.yml missing / unparseable / no yaml → conservative fallback.
+        return new Set(_LAB_FALLBACK);
+    }
+    return ids.size > 0 ? ids : new Set(_LAB_FALLBACK);
+}
+/**
+ * Parse a markdown file's leading frontmatter into its pack set.
+ *
+ * Handles both shapes: `pack: <id>` (commands) and `packs:` followed by
+ * `- <id>` list items (skills). Returns an empty set on any parse failure
+ * or when the file carries no pack tag.
+ */
+export function frontmatter_packs(md_path) {
+    let text;
+    try {
+        text = fs.readFileSync(md_path, 'utf-8');
+    }
+    catch {
+        // OSError / decode error → empty.
+        return new Set();
+    }
+    if (!text.startsWith('---')) {
+        return new Set();
+    }
+    const end = text.indexOf('\n---', 3);
+    const block = end !== -1 ? text.slice(3, end) : text.slice(3);
+    const packs = new Set();
+    let in_packs_list = false;
+    for (const raw of block.split('\n')) {
+        const line = raw.replace(/\s+$/, '');
+        const stripped = line.trim();
+        if (in_packs_list) {
+            if (stripped.startsWith('- ')) {
+                packs.add(_strip_quotes(stripped.slice(2).trim()));
+                continue;
+            }
+            in_packs_list = false;
+        }
+        if (stripped.startsWith('pack:')) {
+            const val = _strip_quotes(stripped.split(':').slice(1).join(':').trim());
+            if (val) {
+                packs.add(val);
+            }
+        }
+        else if (stripped.startsWith('packs:')) {
+            const inline = stripped.split(':').slice(1).join(':').trim();
+            if (inline.startsWith('[') && inline.endsWith(']')) {
+                for (const raw_item of inline.slice(1, -1).split(',')) {
+                    const item = _strip_quotes(raw_item.trim());
+                    if (item) {
+                        packs.add(item);
+                    }
+                }
+            }
+            else {
+                in_packs_list = true;
+            }
+        }
+    }
+    return packs;
+}
+/** True when a deployed markdown artefact belongs to a lab-tier pack. */
+export function is_lab_artefact(md_path, lab_ids) {
+    for (const p of frontmatter_packs(md_path)) {
+        if (lab_ids.has(p)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Mirror of Python `str.strip("'\"")` — strips matching outer quote chars. */
+function _strip_quotes(s) {
+    let out = s;
+    while (out.length > 0 && (out[0] === "'" || out[0] === '"')) {
+        out = out.slice(1);
+    }
+    while (out.length > 0 && (out[out.length - 1] === "'" || out[out.length - 1] === '"')) {
+        out = out.slice(0, -1);
+    }
+    return out;
+}
+//# sourceMappingURL=surface_tiers.js.map

package/dist/scripts/_lib/surface_tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface_tiers.js","sourceRoot":"","sources":["../../../src/scripts/_lib/surface_tiers.ts"],"names":[],"mappings":"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"}

package/dist/scripts/_lib/token_count.js

@@ -0,0 +1,166 @@
+/**
+ * Real-tokenizer counting for the budget tooling
+ * (roadmap 0B.1 → token-saving Phase 0, "real tokenizer into the bench path").
+ *
+ * `char != token`. Every budget in this suite is historically in characters;
+ * this helper reports a token count *alongside* chars so chars stay the cheap
+ * proxy and tokens become the truth where a real tokenizer is available.
+ *
+ * Design — optional dependency, graceful proxy fallback, **synchronous** API:
+ *
+ * - **GPT** — uses `js-tiktoken` (encoding `cl100k_base`) when the dependency
+ *   is present, producing EXACT BPE counts flagged `exact: true`. `js-tiktoken`
+ *   is a build/measurement-time **devDependency** (consumed by the bench /
+ *   audit tooling, never shipped to a consumer runtime). When it is absent —
+ *   e.g. a consumer that installed without devDependencies — the module falls
+ *   back to the documented `chars / 4` proxy flagged `exact: false`. The
+ *   optional load is a synchronous `createRequire(...)` inside a try/catch so
+ *   the public `measure()` / `gpt_tokens()` API stays synchronous and never
+ *   hard-fails on a missing dependency (no mandatory install, no network).
+ * - **Claude** — no offline Claude tokenizer exists; documented `chars / 3.6`
+ *   proxy, always `exact: false`. (Anthropic's exact count is API-only.)
+ *
+ * Both proxies are intentionally conservative ratios drawn from English-prose +
+ * markdown samples; they are estimates, never gates.
+ *
+ * The `*_proxy` helpers (`gpt_tokens_proxy`, `measure_proxy`,
+ * `method_note_proxy`) expose the fallback math directly — they are used by the
+ * fallback regression guard in the test suite and by any report that wants to
+ * record both the exact and the proxy count to flag the delta.
+ *
+ * Parity notes: "chars" counts Unicode code points (`len(str)` parity), not
+ * UTF-16 units; proxy rounding is banker's rounding.
+ */
+import { createRequire } from "node:module";
+// Proxy ratios (chars per token) for the no-tokenizer fallback. Tuned for
+// English markdown rule/skill prose; deliberately conservative.
+const _GPT_CHARS_PER_TOKEN = 4.0;
+const _CLAUDE_CHARS_PER_TOKEN = 3.6;
+// Roadmap (token-saving Phase 0) mandates the `cl100k_base` encoding. The
+// dependency also bundles `o200k_base` (GPT-4o / GPT-4.1 family); switching the
+// GPT count basis is a one-line change to this constant. The exact-vs-proxy
+// delta is recorded in every report via `method_note()`.
+const _TIKTOKEN_ENCODING = "cl100k_base";
+/**
+ * Load the optional `js-tiktoken` encoder synchronously, returning `null` when
+ * the dependency is absent or fails to initialise (graceful proxy fallback).
+ * `createRequire` resolves the CJS build so the call stays synchronous even
+ * though this module is ESM.
+ */
+function _loadEncoder() {
+    try {
+        const require = createRequire(import.meta.url);
+        const mod = require("js-tiktoken");
+        return mod.getEncoding(_TIKTOKEN_ENCODING);
+    }
+    catch {
+        return null;
+    }
+}
+// Resolved once at module load. js-tiktoken's `getEncoding` is synchronous with
+// bundled rank tables, so eager init is cheap and keeps `TIKTOKEN_AVAILABLE` a
+// plain const (the historical API shape).
+const _ENCODER = _loadEncoder();
+/** True when the real tokenizer is available (exact GPT counts), else proxy. */
+export const TIKTOKEN_AVAILABLE = _ENCODER !== null;
+/** A single token measurement and whether it is exact or a proxy. */
+export class TokenCount {
+    tokens;
+    exact;
+    constructor(tokens, exact) {
+        this.tokens = tokens;
+        this.exact = exact;
+        Object.freeze(this); // dataclass(frozen=True) parity
+    }
+}
+/** Count Unicode code points — `len(str)` parity. */
+function _len(text) {
+    let count = 0;
+    // for..of iterates code points, so astral chars count once.
+    for (const _ch of text)
+        count += 1;
+    return count;
+}
+/** Banker's rounding (round half to even) — proxy-path parity. */
+function _python_round(x) {
+    const floor = Math.floor(x);
+    const diff = x - floor;
+    if (diff > 0.5)
+        return floor + 1;
+    if (diff < 0.5)
+        return floor;
+    return floor % 2 === 0 ? floor : floor + 1;
+}
+/** Render a float like a Python f-string (4.0 → "4.0", 3.6 → "3.6"). */
+function _py_float_repr(x) {
+    return Number.isInteger(x) ? `${x}.0` : `${x}`;
+}
+/**
+ * GPT token count — EXACT via js-tiktoken (`cl100k_base`) when available,
+ * otherwise the documented `chars / 4` proxy.
+ */
+export function gpt_tokens(text) {
+    if (_ENCODER !== null) {
+        return new TokenCount(_ENCODER.encode(text).length, true);
+    }
+    return gpt_tokens_proxy(text);
+}
+/**
+ * GPT proxy count (`chars / 4`, banker's rounding) — the fallback path,
+ * exposed directly for the fallback regression guard and delta reporting.
+ */
+export function gpt_tokens_proxy(text) {
+    return new TokenCount(_python_round(_len(text) / _GPT_CHARS_PER_TOKEN), false);
+}
+/** Claude token count — documented offline proxy (no local Claude tokenizer). */
+export function claude_tokens(text) {
+    return new TokenCount(_python_round(_len(text) / _CLAUDE_CHARS_PER_TOKEN), false);
+}
+/**
+ * Return chars + per-model token counts for one text blob.
+ *
+ * `tokens_gpt` is exact (js-tiktoken) when available; `tokens_gpt_exact` tells
+ * the report consumer which path produced it. `tokens_claude` is always the
+ * proxy (no offline Claude tokenizer).
+ */
+export function measure(text) {
+    const g = gpt_tokens(text);
+    const c = claude_tokens(text);
+    return {
+        chars: _len(text),
+        tokens_gpt: g.tokens,
+        tokens_gpt_exact: g.exact,
+        tokens_claude: c.tokens,
+        tokens_claude_exact: c.exact,
+    };
+}
+/**
+ * Proxy-only measure (forces the chars-based estimate for GPT regardless of
+ * tokenizer availability). Use to record both the exact and the proxy count
+ * and flag the delta, and as the fallback regression guard.
+ */
+export function measure_proxy(text) {
+    const g = gpt_tokens_proxy(text);
+    const c = claude_tokens(text);
+    return {
+        chars: _len(text),
+        tokens_gpt: g.tokens,
+        tokens_gpt_exact: g.exact,
+        tokens_claude: c.tokens,
+        tokens_claude_exact: c.exact,
+    };
+}
+/** Proxy-path provenance string (the fallback note). */
+export function method_note_proxy() {
+    return (`tokens_gpt: proxy (chars/${_py_float_repr(_GPT_CHARS_PER_TOKEN)}, tiktoken not installed); ` +
+        `tokens_claude: proxy (chars/${_py_float_repr(_CLAUDE_CHARS_PER_TOKEN)})`);
+}
+/** One-line provenance of how token counts were produced (for reports). */
+export function method_note() {
+    if (TIKTOKEN_AVAILABLE) {
+        return (`tokens_gpt: exact (tiktoken ${_TIKTOKEN_ENCODING}); ` +
+            `tokens_claude: proxy (chars/${_py_float_repr(_CLAUDE_CHARS_PER_TOKEN)})`);
+    }
+    return method_note_proxy();
+}
+//# sourceMappingURL=token_count.js.map

package/dist/scripts/_lib/token_count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_count.js","sourceRoot":"","sources":["../../../src/scripts/_lib/token_count.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,0EAA0E;AAC1E,gEAAgE;AAChE,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,0EAA0E;AAC1E,gFAAgF;AAChF,4EAA4E;AAC5E,yDAAyD;AACzD,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAOzC;;;;;GAKG;AACH,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAEhC,CAAC;QACF,OAAO,GAAG,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,+EAA+E;AAC/E,0CAA0C;AAC1C,MAAM,QAAQ,GAAoB,YAAY,EAAE,CAAC;AAEjD,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,KAAK,IAAI,CAAC;AAEpD,qEAAqE;AACrE,MAAM,OAAO,UAAU;IACZ,MAAM,CAAS;IACf,KAAK,CAAU;IAExB,YAAY,MAAc,EAAE,KAAc;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,gCAAgC;IACvD,CAAC;CACF;AAED,qDAAqD;AACrD,SAAS,IAAI,CAAC,IAAY;IACxB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,4DAA4D;IAC5D,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,KAAK,IAAI,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kEAAkE;AAClE,SAAS,aAAa,CAAC,CAAS;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC;IACjC,IAAI,IAAI,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,wEAAwE;AACxE,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,EAAE,KAAK,CAAC,CAAC;AACjF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,UAAU,CACnB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,EACnD,KAAK,CACN,CAAC;AACJ,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM;QACpB,gBAAgB,EAAE,CAAC,CAAC,KAAK;QACzB,aAAa,EAAE,CAAC,CAAC,MAAM;QACvB,mBAAmB,EAAE,CAAC,CAAC,KAAK;KAC7B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM;QACpB,gBAAgB,EAAE,CAAC,CAAC,KAAK;QACzB,aAAa,EAAE,CAAC,CAAC,MAAM;QACvB,mBAAmB,EAAE,CAAC,CAAC,KAAK;KAC7B,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CACL,4BAA4B,cAAc,CAAC,oBAAoB,CAAC,6BAA6B;QAC7F,+BAA+B,cAAc,CAAC,uBAAuB,CAAC,GAAG,CAC1E,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW;IACzB,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,CACL,+BAA+B,kBAAkB,KAAK;YACtD,+BAA+B,cAAc,CAAC,uBAAuB,CAAC,GAAG,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}

package/dist/scripts/_lib/trigger_eval_floors.js

@@ -21,4 +21,12 @@ export const DOMAIN_FLOORS = {
 export function floor_for(skill) {
     return (skill !== null && skill !== undefined && DOMAIN_FLOORS[skill]) || DEFAULT_FLOOR;
 }
+/**
+ * Advisory floor for the rules-mode canary leg (`rule_trigger_eval.ts`,
+ * road-to-tested-routing Phase 4). Deliberately loose: it is a drift canary
+ * over a ~40-case derived suite spanning ~97 rules, not a per-rule quality
+ * gate — ratchet only after live baseline data exists. A breach fails the
+ * scheduled canary job only, never a PR.
+ */
+export const RULES_MODE_FLOOR = { minRecall: 0.5, minPrecision: 0.5 };
 //# sourceMappingURL=trigger_eval_floors.js.map

package/dist/scripts/_lib/trigger_eval_floors.js.map

@@ -1 +1 @@
-{"version":3,"file":"trigger_eval_floors.js","sourceRoot":"","sources":["../../../src/scripts/_lib/trigger_eval_floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAqB,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;AAErF,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAA+C;IACrE,kBAAkB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE;IAC1D,WAAW,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;IAClD,gBAAgB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;CAC1D,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,KAAgC;IACtD,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,aAAa,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"trigger_eval_floors.js","sourceRoot":"","sources":["../../../src/scripts/_lib/trigger_eval_floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAqB,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;AAErF,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAA+C;IACrE,kBAAkB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE;IAC1D,WAAW,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;IAClD,gBAAgB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;CAC1D,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,KAAgC;IACtD,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,aAAa,CAAC;AAC5F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC"}

package/dist/scripts/condense.js

@@ -31,11 +31,18 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import * as YAML from 'yaml';
-import { artefact_roots as _agent_src_artefact_roots, iter_all_sources as _agent_src_iter_all_sources, resolve_logical as _agent_src_resolve_logical, strip_source_prefix, } from './_lib/agent_src.js';
+import { _domains_command_logical, artefact_roots as _agent_src_artefact_roots, iter_all_sources as _agent_src_iter_all_sources, resolve_logical as _agent_src_resolve_logical, strip_source_prefix, } from './_lib/agent_src.js';
+// Import-safety note: `project_thin_rules` guards its CLI entry
+// (`_isCliEntry()` before `process.exit(main())`), so importing it here is
+// side-effect-free. condense.ts is bundled into the installer, where a bare
+// top-level `process.exit` would fire at consumer runtime — the documented
+// bundled-CLI-entry-guard landmine. Verified before wiring, not assumed.
+import { build_thin } from './project_thin_rules.js';
 import { build_claude_hook_matrix } from './_lib/claude_settings_hooks.js';
 import { is_claude_builtin_name } from './_lib/claude_builtin_names.js';
 import { project_settings_path, load_agent_settings } from './_lib/agent_settings.js';
 import { rule_is_compile_enabled } from './_lib/compile_time_toggles.js';
+import { resolve_rule_pack_scope } from './_lib/scoped_projection.js';
 import { info, success, flush_summary, resolve_level } from './_lib/script_output.js';
 import { TIER_TO_CLAUDE_MODEL as _TIER_TO_CLAUDE_MODEL, MODEL_TIER_RE as _MODEL_TIER_RE, } from './_lib/model_tier.js';
 // The Python module imports `_SLUG_PREFIX_RE` from `_lib.agent_src`. The TS
@@ -885,12 +892,15 @@ export { _HRR_BANNER_MARKER };
 // the kernel is unconditional and workspace-independent by definition
 // (rule-router contract § Schema v2). Untagged rules fail safe: they ship.
 // ADR-040: projection-time filtering only, no runtime resolver.
-function _read_projection_list(key) {
+function _read_projection_raw(key) {
     const data = load_agent_settings({ project_path: MODULE_STATE.SETTINGS_FILE });
     const proj = data['projection'];
-    const value = typeof proj === 'object' && proj !== null && !Array.isArray(proj)
+    return typeof proj === 'object' && proj !== null && !Array.isArray(proj)
         ? proj[key]
         : null;
+}
+function _read_projection_list(key) {
+    const value = _read_projection_raw(key);
     if (Array.isArray(value) && value.length > 0) {
         return value.map((v) => String(v));
     }
@@ -899,8 +909,22 @@ function _read_projection_list(key) {
 function _read_rule_workspaces() {
     return _read_projection_list('rule_workspaces');
 }
+/** `runtime.active_packs` overlay, empty when unset (fresh-install default). */
+function _read_runtime_active_packs() {
+    const data = load_agent_settings({ project_path: MODULE_STATE.SETTINGS_FILE });
+    const rt = data['runtime'];
+    const value = typeof rt === 'object' && rt !== null && !Array.isArray(rt)
+        ? rt['active_packs']
+        : null;
+    return Array.isArray(value) ? value.map((v) => String(v)) : [];
+}
+/**
+ * Pack scope for the rule layer. `rule_packs: auto` derives the active-pack
+ * set (the same one the skill/command prune uses) instead of a hand-typed id
+ * list; anything else keeps the historical list-or-inactive semantics.
+ */
 function _read_rule_packs() {
-    return _read_projection_list('rule_packs');
+    return resolve_rule_pack_scope(_read_projection_raw('rule_packs'), MODULE_STATE.PROJECT_ROOT, _read_runtime_active_packs());
 }
 /**
  * Whether a rule source file projects under the given workspace + pack +
@@ -936,10 +960,18 @@ export function generate_rule_symlinks() {
     const tool_dirs = _filter_tool_dirs(TOOL_DIRS);
     let thin_files = null;
     if (_lean_projection_mode() === 'thin') {
-        // The `project_thin_rules` twin is not ported (out of scope — thin mode
-        // is opt-in and not exercised by golden parity). Throw a clear error if
-        // a consumer actually enables it, mirroring an unmet import.
-        throw new Error('lean_projection.mode=thin requires project_thin_rules (not ported in condense.ts)');
+        // DEAD-SWITCH REPAIR (road-to-renewal-foundation Phase 2). This branch
+        // used to THROW: the port was skipped as "out of scope, not exercised by
+        // golden parity", which left a documented, settings-selectable mode that
+        // could only ever crash. `build_thin` was ported and has been present the
+        // whole time — the wiring was the only thing missing.
+        //
+        // Scope note: this repairs the SWITCH only. The default stays
+        // `eager-all`. Flipping it is parked behind the thin-projection honest
+        // null (thin win-rate 36.2% < the 48% pre-registered threshold), and
+        // nothing here disturbs that verdict — but a mode that throws cannot
+        // even be re-measured, which is why the repair earns its place alone.
+        thin_files = Object.fromEntries(build_thin(MODULE_STATE.RULES_SOURCE, _read_rule_workspaces()));
     }
     const dedup_on = _read_projection_scope_dedup();
     const user_home = process.env['HOME'] ?? os.homedir();
@@ -1026,6 +1058,9 @@ function _WINDSURF_WORKFLOWS_DIR() {
 function _CURSOR_COMMANDS_DIR() {
     return path.join(MODULE_STATE.PROJECT_ROOT, '.cursor', 'commands');
 }
+function _CLAUDE_COMMANDS_DIR() {
+    return path.join(MODULE_STATE.PROJECT_ROOT, '.claude', 'commands');
+}
 function _parse_frontmatter(content) {
     if (!content.startsWith('---')) {
         return [{}, content];
@@ -1412,6 +1447,86 @@ export function extract_description_from_md(content) {
     }
     return '';
 }
+/**
+ * The `commands/<sub>` path of a command source file, or `null` when it is a
+ * FLAT command (`commands/<name>.md`).
+ *
+ * A nested path is what Claude Code renders as `/cluster:sub`. Flat command
+ * FILES are not registered by Claude Code (probed ≤ 2.1.204 — see the
+ * flat-command mitigation in `install.ts`), which is why flat commands keep a
+ * skill wrapper and nested ones do not need one.
+ */
+function _nested_command_subpath(source_file) {
+    const rel = _relativeToPosix(source_file, MODULE_STATE.PROJECT_ROOT);
+    const logical = _domains_command_logical(rel);
+    if (logical === null || !logical.startsWith('commands/')) {
+        return null;
+    }
+    const sub = logical.slice('commands/'.length).replace(/\.md$/, '');
+    return sub.includes('/') ? sub : null;
+}
+/**
+ * Project-scope `.claude/commands/<cluster>/<sub>.md` — the colon form.
+ *
+ * Before this, the package repo's own `.claude/` carried NO commands
+ * directory: every command reached Claude Code as a hyphen-named skill
+ * wrapper in `.claude/skills/`, while the colon form existed only in the
+ * user-global tree written by `install.ts`. Every clustered command was
+ * therefore listed TWICE for anyone with a global install
+ * (`roadmap-process-full` AND `roadmap:process-full`), costing 4,214 GPT tok
+ * of always-loaded catalog for zero added reach — measured 2026-08-02.
+ *
+ * Emitting the nested form here lets `generate_claude_commands` stop wrapping
+ * the clustered commands: one listing, same reachability, and reachability no
+ * longer depends on a global deploy having run. Claude Code dedupes project
+ * and user scope by name, so the two copies of `/cluster:sub` collapse.
+ *
+ * ADR-003 (colon canonical for clusters) and ADR-044 (flat commands stay
+ * hyphenated) both hold: flat commands are untouched and keep their wrapper.
+ */
+export function generate_claude_project_commands(active_command_slugs = null) {
+    if (!_isDir(path.join(MODULE_STATE.PROJECT_ROOT, 'src', 'domains'))) {
+        return 0;
+    }
+    const nested = [];
+    for (const [source_file, slug] of iterCommands()) {
+        if (active_command_slugs !== null && !active_command_slugs.has(slug)) {
+            continue;
+        }
+        const sub = _nested_command_subpath(source_file);
+        if (sub !== null) {
+            nested.push([source_file, sub]);
+        }
+    }
+    const target_root = _CLAUDE_COMMANDS_DIR();
+    const valid = new Set(nested.map(([, sub]) => `${sub}.md`));
+    // Sweep stale links first: a renamed or deleted command must not linger as
+    // a dangling `/cluster:sub`.
+    if (_exists(target_root)) {
+        for (const item of _rglobSorted(target_root, '*.md')) {
+            const rel = _relativeToPosix(item, target_root);
+            if (!valid.has(rel)) {
+                fs.unlinkSync(item);
+            }
+        }
+    }
+    let count = 0;
+    for (const [source_file, sub] of nested) {
+        const link = path.join(target_root, `${sub}.md`);
+        _mkdirp(path.dirname(link));
+        if (_existsOrSymlink(link)) {
+            fs.unlinkSync(link);
+        }
+        // path.relative, not a hand-counted `../` run: the nesting depth
+        // varies (2 and 3 segments both occur) and an off-by-one here writes
+        // a dangling link that still LOOKS right in `ls -l`.
+        const rel_target = path.relative(path.dirname(link), source_file);
+        fs.symlinkSync(rel_target, link);
+        count += 1;
+    }
+    info(`  ✅  Linked ${count} \`.claude/commands/**/*.md\` files (colon form)`);
+    return count;
+}
 export function generate_claude_commands(active_command_slugs = null) {
     if (!_isDir(path.join(MODULE_STATE.PROJECT_ROOT, 'src', 'domains'))) {
         process.stderr.write('  ⚠️  src/domains/ not found — skipping commands\n');
@@ -1438,6 +1553,15 @@ export function generate_claude_commands(active_command_slugs = null) {
             skipped += 1;
             continue;
         }
+        // A clustered command already reaches Claude Code as `/cluster:sub`
+        // from `.claude/commands/` (generate_claude_project_commands). A
+        // hyphen wrapper on top would be a second listing of the same command
+        // — the double-listing this de-duplicates. Flat commands still need
+        // the wrapper: Claude Code does not register flat command FILES.
+        if (_nested_command_subpath(source_file) !== null) {
+            skipped += 1;
+            continue;
+        }
         // Never claim a `/name` that is a Claude Code built-in command or
         // bundled skill — a same-name entry shadows the built-in (e.g. a
         // `review` entry hides Claude Code's own /review). Nested
@@ -1937,6 +2061,11 @@ function _generate_tools_inner(cmd_slugs, skill_names) {
         generate_gemini_md();
     }
     const skills = _tool_active('claude-code') ? generate_claude_skills(skill_names) : 0;
+    // Colon form first: `generate_claude_commands` skips every command this
+    // one emitted, so the ordering is what keeps the two from double-listing.
+    const claude_cmds = _tool_active('claude-code')
+        ? generate_claude_project_commands(cmd_slugs)
+        : 0;
     const commands = _tool_active('claude-code') ? generate_claude_commands(cmd_slugs) : 0;
     const subagents = _tool_active('claude-code') ? generate_claude_subagents() : 0;
     const subagent_contexts = generate_subagent_host_contexts();
@@ -1949,7 +2078,8 @@ function _generate_tools_inner(cmd_slugs, skill_names) {
     const cursor_cmds = _tool_active('cursor') ? generate_cursor_commands(cmd_slugs) : 0;
     const windsurf_wf = _tool_active('windsurf') ? generate_windsurf_workflows(cmd_slugs) : 0;
     const summary = `✅  generate-tools — rules=${rules} skills=${skills} ` +
-        `commands=${commands} subagents=${subagents} subagent_contexts=${subagent_contexts} plugin_cmd_skills=${plugin_cmd_skills} ` +
+        `claude_commands=${claude_cmds} command_skills=${commands} ` +
+        `subagents=${subagents} subagent_contexts=${subagent_contexts} plugin_cmd_skills=${plugin_cmd_skills} ` +
         `plugin_hooks=${plugin_hooks} ` +
         `personas=${personas} user_types=${user_types} ` +
         `cursor_mdc=${cursor_mdc} windsurf_rules=${windsurf_modern} ` +