@tacuchi/agent-workflow-cli 20.23.0 → 20.25.0

package/README.md

@@ -65,7 +65,7 @@ A plan at 100% of checkboxes with zero validated phases is work implemented, not
 The published tarball bundles the universal skill set under `skills/w/`. Install it into your host with `--target` (required):
 
 ```bash
-agent-workflow self install --target claude     # or: codex · warp · oz · agents · gemini · opencode · crush
+agent-workflow self install --target claude     # or: codex · warp · oz · gemini · opencode · crush · kimi · agents
 agent-workflow self install --target all --confirm-all
 agent-workflow self detect-hosts                # which hosts are present + already have it
 agent-workflow self install --target claude --dry-run
@@ -77,21 +77,44 @@ By default the CLI clears the target host's plugin cache before installing (opt
 
 `self install --target <host>` installs **SKILL + user-level slash commands + hooks** in one shot, scaled to what the host supports:
 
-| Host | SKILL | User-level commands | Hooks |
-|---|---|---|---|
-| `claude` | `~/.claude/skills/w/` | `~/.claude/commands/w/<n>.md` → `/w:<n>` | `~/.claude/settings.json` (JSON merge + backup) |
-| `codex` | `~/.codex/skills/w/` | synthesized skills `~/.codex/skills/w-<n>/` → `$w-<n>` (Codex reads no commands dir) | skipped (config.toml not yet wired) |
-| `warp` | `~/.warp/skills/w/` | synthesized skills `~/.warp/skills/w-<n>/` → `/w-<n>` | skipped (no hook system) |
-| `oz` | `~/.agents/skills/w/` | synthesized skills `~/.agents/skills/w-<n>/` | skipped |
-| `agents` | `~/.agents/skills/w/` | skipped (shared dir, not a host) | skipped |
-| `gemini` | `~/.gemini/skills/w/` | synthesized skills `~/.gemini/skills/w-<n>/` (Antigravity `agy`) + `~/.gemini/commands/w/<n>.toml` → `/w:<n>` (legacy Gemini CLI) | skipped |
-| `opencode` | `~/.opencode/skills/w/` | `~/.opencode/command/w/<n>.md` → `/w/<n>` | skipped |
-| `crush` | `~/.config/crush/skills/w/` (XDG — the only global root Crush reads; `~/.crush` holds commands only) | `~/.crush/commands/w/<n>.md` → palette `user:w:<n>` | skipped |
+| Host | Level | SKILL | User-level commands | Hooks |
+|---|---|---|---|---|
+| `claude` | official | `~/.claude/skills/w/` | `~/.claude/commands/w/<n>.md` → `/w:<n>` | `~/.claude/settings.json` (JSON merge + backup) |
+| `codex` | official | `~/.codex/skills/w/` | synthesized skills `~/.codex/skills/w-<n>/` → `$w-<n>` (Codex reads no commands dir) | not armed (its hooks live in `config.toml`, not wired yet) |
+| `warp` | official | `~/.warp/skills/w/` | synthesized skills `~/.warp/skills/w-<n>/` → `/w-<n>` | none (no hook system) |
+| `gemini` | official | `~/.gemini/skills/w/` | synthesized skills `~/.gemini/skills/w-<n>/` (Antigravity `agy`) + `~/.gemini/commands/w/<n>.toml` → `/w:<n>` (legacy Gemini CLI) | not armed (extension-bundled) |
+| `kimi` | official · pre-1.0 | `~/.kimi-code/skills/w/` (also reads `~/.agents/skills`) | synthesized skills `~/.kimi-code/skills/w-<n>/` → `/skill:w-<n>` | `~/.kimi-code/config.toml` → managed `[[hooks]]` block (marked + backup) |
+| `oz` | best-effort · pre-1.0 | `~/.agents/skills/w/` | synthesized skills `~/.agents/skills/w-<n>/` | none |
+| `opencode` | best-effort | `~/.opencode/skills/w/` | `~/.opencode/command/w/<n>.md` → `/w/<n>` | not armed (JS plugins) |
+| `crush` | best-effort · pre-1.0 | `~/.config/crush/skills/w/` (XDG — the only global root Crush reads; `~/.crush` holds commands only) | `~/.crush/commands/w/<n>.md` → palette `user:w:<n>` | not armed (preliminary) |
+| `agents` | *shared destination, not a host* | `~/.agents/skills/w/` | skipped (shared dir) | skipped |
 
 The bundle's internal manuals (`loops/*/LOOP.md`, `roles/*/ROLE.md`, `exports/*/EXPORT.md`, `harness/HARNESS.md`) are deliberately **not** `SKILL.md` files, so hosts that scan skill roots recursively (Codex, OpenCode, Crush) never list them as invocable skills — only the commands and the `w` orientation skill surface. Where a layer is skipped, the SKILL is sufficient — the AI reads it and invokes `agent-workflow <subcommand>` directly.
 
 Opt-out flags: `--skill-only`, `--no-commands`, `--no-hooks`. Override the source with `--from /path/to/skills/w`. Other flags: `--confirm-all` (required with `--target all`), `--keep-cache`, `--force`, `--dry-run`.
 
+**What `--target all` means.** Every **host** — never the shared skills dirs, which are install destinations rather than hosts and are reached explicitly (`--target agents`). `install` and `uninstall` use the same set, so the round trip matches: what `all` installs is what `all` removes. (`oz` installs into `~/.agents/skills`, so that directory is still covered under `all` through its host.)
+
+### Support levels and how long a verification is worth
+
+**official** — Claude Code, Codex, Warp, Gemini/Antigravity, Kimi Code. **best-effort** — Oz, OpenCode, Crush. `agents` is a shared destination, not a host, and never counts as one.
+
+The difference is what gets *checked*, not what gets installed: `npm run smoke:hosts` probes every host's runtime and version, and for the official ones it additionally installs into a throwaway `HOME` and verifies that the artifacts on disk are the ones this table promises — bundle, command surface, hooks — then uninstalls and verifies they are gone. Its result is written to `src/domain/host-verification.ts`, and that file is the **only** source of a "verified" claim anywhere in the CLI: a host no run has covered is shown as `unverified`, never as verified. `npm run smoke:hosts -- --check` runs the same checks without writing the ledger.
+
+Re-verify when a release touches a host. A host marked **pre-1.0** (Kimi Code, Crush, Oz) can change its surface between its own releases faster than we re-check — Kimi Code ships roughly twice a week — so the table states the version a run actually proved and the date it proved it. It is a claim about that version, not a promise about the next one.
+
+Validation platform: **macOS** is where all eight runtimes live and where the suite is expected to pass. **Windows** stays best-effort on the existing launch smokes. **Linux** is documented without a guarantee.
+
+### Retiring a host
+
+Removing a host's key from `InstallTarget` makes TypeScript demand you delete its `TARGET_ROOTS` entry too — and the moment that path is gone, nothing can clean what previous releases installed there. The pattern, modeled on the `crush` root migration:
+
+1. **Keep** the target alive in `InstallTarget` / `TARGET_ROOTS` for at least one release, and drop its `HarnessSpec` from `HARNESSES` — it stops being offered as a host while staying reachable for cleanup.
+2. **Move** its old roots into `LEGACY_SKILL_ROOTS_BY_TARGET` so `install`/`uninstall`/`clean-legacy` sweep them, ownership-verified (those roots can be shared namespaces — never delete by dir name alone).
+3. **Then** remove the key, once telemetry or a major version says nobody can still have it installed.
+
+Skipping step 2 strands files in a directory no code path can name any more.
+
 ## TUI
 
 Running `agent-workflow` (or `aw`) with no arguments opens the tab-based TUI:

package/dist/application/context/budget-service.js

@@ -0,0 +1,128 @@
+import { resolveBundleRoot } from "./bundle-root.js";
+import { loadManifest } from "./manifest.js";
+import { measureBundle } from "./measure.js";
+export class BaselineError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "BaselineError";
+    }
+}
+/** Why the receipt reports no token figure. Single wording for every surface. */
+export const TOKENS_UNAVAILABLE = "ningún host de la matriz expone al agente el consumo real de tokens; el gate usa bytes y no infiere equivalencia";
+export async function runContextBudget(fs, input = {}) {
+    const resolved = await resolveBundleRoot(fs, input.root);
+    const manifest = await loadManifest(fs, resolved.root);
+    const measurement = await measureBundle(fs, resolved.root, resolved.origin, manifest);
+    const baseline = await readBaseline(fs, input.baselinePath);
+    const budget = baseline === null
+        ? reportOnly(measurement)
+        : deriveBudget(measurement, baseline, manifest.budgetPolicy);
+    const offenders = budget.filter((line) => line.ok === false).map(describeOffender);
+    return {
+        ...measurement,
+        baseline_path: input.baselinePath ?? null,
+        baseline_revision: baseline?.revision ?? null,
+        tokens: { available: false, reason: TOKENS_UNAVAILABLE },
+        budget,
+        offenders,
+        verdict: baseline === null ? "measured" : offenders.length === 0 ? "ok" : "over-budget",
+    };
+}
+/** The frozen baseline is a prior `aw context-budget` output; only its measurement half is read. */
+export async function readBaseline(fs, path) {
+    if (path === undefined)
+        return null;
+    let raw;
+    try {
+        raw = await fs.readText(path);
+    }
+    catch {
+        throw new BaselineError("CONTEXT_BASELINE_MISSING", `no se pudo leer el baseline '${path}'`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new BaselineError("CONTEXT_BASELINE_INVALID", `'${path}' no es JSON válido: ${err.message}`);
+    }
+    // Every field `deriveBudget` dereferences is checked here, so a truncated
+    // baseline fails with its own code instead of a TypeError three frames down.
+    const missing = ["discovery", "activation", "execution", "guaranteed"].filter((key) => parsed[key] === undefined);
+    if (missing.length > 0) {
+        throw new BaselineError("CONTEXT_BASELINE_INVALID", `'${path}' no parece un baseline de contexto: falta ${missing.join(", ")}`);
+    }
+    return parsed;
+}
+function reportOnly(measurement) {
+    const lines = [
+        { metric: "discovery", actual: measurement.discovery.bytes },
+        { metric: "activation.median", actual: measurement.activation.median },
+        { metric: "execution.median", actual: measurement.execution.median },
+    ];
+    for (const entry of measurement.activation.entries) {
+        lines.push({ metric: `activation.${entry.command}`, actual: entry.bytes });
+    }
+    for (const journey of measurement.execution.journeys) {
+        lines.push({ metric: `journey.${journey.id}`, actual: journey.bytes });
+    }
+    for (const entry of measurement.guaranteed) {
+        lines.push({ metric: `guaranteed.${entry.command}`, actual: entry.bytes });
+    }
+    lines.push({ metric: "modules.total", actual: measurement.modules.bytes });
+    return lines;
+}
+export function deriveBudget(measurement, baseline, policy) {
+    const lines = [
+        line("discovery", measurement.discovery.bytes, baseline.discovery.bytes, policy.discovery_max_ratio),
+        line("activation.median", measurement.activation.median, baseline.activation.median, policy.activation_median_max_ratio),
+        line("execution.median", measurement.execution.median, baseline.execution.median, policy.execution_median_max_ratio),
+    ];
+    const baseActivation = new Map(baseline.activation.entries.map((e) => [e.command, e.bytes]));
+    for (const entry of measurement.activation.entries) {
+        const base = baseActivation.get(entry.command);
+        // A command with no baseline row is new since the freeze: it is reported,
+        // not judged. Inventing a target for it would be judging it against itself.
+        if (base === undefined) {
+            lines.push({ metric: `activation.${entry.command}`, actual: entry.bytes });
+            continue;
+        }
+        lines.push(line(`activation.${entry.command}`, entry.bytes, base, policy.activation_each_max_ratio));
+    }
+    const baseJourney = new Map(baseline.execution.journeys.map((j) => [j.id, j.bytes]));
+    for (const journey of measurement.execution.journeys) {
+        const base = baseJourney.get(journey.id);
+        if (base === undefined) {
+            lines.push({ metric: `journey.${journey.id}`, actual: journey.bytes });
+            continue;
+        }
+        lines.push(line(`journey.${journey.id}`, journey.bytes, base, policy.journey_max_ratio));
+    }
+    const baseGuaranteed = new Map((baseline.guaranteed ?? []).map((g) => [g.command, g.bytes]));
+    for (const entry of measurement.guaranteed) {
+        const base = baseGuaranteed.get(entry.command);
+        if (base === undefined) {
+            lines.push({ metric: `guaranteed.${entry.command}`, actual: entry.bytes });
+            continue;
+        }
+        lines.push(line(`guaranteed.${entry.command}`, entry.bytes, base, policy.journey_max_ratio));
+    }
+    // The conditional tree, budgeted directly. `baseline.modules` is frozen at the
+    // revision that introduced it — no pre-split analogue exists, since before the
+    // split there were no modules — so this line caps GROWTH, which is the hole it
+    // was added to close.
+    if (baseline.modules !== undefined) {
+        lines.push(line("modules.total", measurement.modules.bytes, baseline.modules.bytes, policy.journey_max_ratio));
+    }
+    return lines;
+}
+function line(metric, actual, baseline, ratio) {
+    const target = Math.floor(baseline * ratio);
+    return { metric, actual, baseline, target, ok: actual <= target };
+}
+function describeOffender(entry) {
+    return `${entry.metric}: ${entry.actual} B > techo ${entry.target} B (baseline ${entry.baseline} B)`;
+}
+//# sourceMappingURL=budget-service.js.map

package/dist/application/context/budget-service.js.map

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

package/dist/application/context/bundle-root.js

@@ -0,0 +1,41 @@
+import { join } from "node:path";
+import { resolveBundledSkillPath } from "../self/install-skill.js";
+import { MANIFEST_REL_PATH } from "./manifest.js";
+export class BundleRootError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "BundleRootError";
+    }
+}
+/**
+ * The bundle a context command measures.
+ *
+ * `--root <path>` points at any tree — a repo checkout for the CI gate, or the
+ * tree a host actually installed. With no flag the answer is the PACKAGED
+ * bundle, which is the same tree `self install` copies out, so the default is
+ * both deterministic and the honest proxy for an installation of this version.
+ *
+ * Detecting which host is installed where is deliberately NOT done here: that
+ * is spec 010's surface, and guessing it would make the receipt's `root` depend
+ * on a heuristic instead of on what the caller asked for.
+ */
+export async function resolveBundleRoot(fs, explicitRoot) {
+    if (explicitRoot !== undefined) {
+        await assertBundle(fs, explicitRoot, "explicit");
+        return { root: explicitRoot, origin: "explicit" };
+    }
+    const packaged = await resolveBundledSkillPath();
+    if (packaged === null) {
+        throw new BundleRootError("CONTEXT_ROOT_NOT_FOUND", "No se encontró el bundle empaquetado junto a la CLI. Pasá --root <path> con el árbol a medir.");
+    }
+    await assertBundle(fs, packaged, "packaged");
+    return { root: packaged, origin: "packaged" };
+}
+async function assertBundle(fs, root, origin) {
+    if (!(await fs.exists(join(root, MANIFEST_REL_PATH)))) {
+        throw new BundleRootError("CONTEXT_ROOT_NOT_A_BUNDLE", `'${root}' (${origin}) no trae ${MANIFEST_REL_PATH}: no es un bundle w medible`);
+    }
+}
+//# sourceMappingURL=bundle-root.js.map

package/dist/application/context/bundle-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-root.js","sourceRoot":"","sources":["../../../src/application/context/bundle-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUlD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAE7B;IADX,YACW,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAkB,EAClB,YAAqB;IAErB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACpD,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,uBAAuB,EAAE,CAAC;IACjD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CACvB,wBAAwB,EACxB,+FAA+F,CAChG,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,EAAkB,EAClB,IAAY,EACZ,MAAwB;IAExB,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,eAAe,CACvB,2BAA2B,EAC3B,IAAI,IAAI,MAAM,MAAM,aAAa,iBAAiB,6BAA6B,CAChF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/application/context/manifest.js

@@ -0,0 +1,150 @@
+import { join } from "node:path";
+export const MANIFEST_REL_PATH = join("context", "MANIFEST.json");
+/** Supported manifest schema. A newer bundle is a load error, never a guess. */
+const SUPPORTED_VERSION = 1;
+const POLICY_KEYS = [
+    "discovery_max_ratio",
+    "activation_median_max_ratio",
+    "activation_each_max_ratio",
+    "execution_median_max_ratio",
+    "journey_max_ratio",
+];
+export class ManifestError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ManifestError";
+    }
+}
+export async function loadManifest(fs, bundleRoot) {
+    const path = join(bundleRoot, MANIFEST_REL_PATH);
+    if (!(await fs.exists(path))) {
+        throw new ManifestError("CONTEXT_MANIFEST_MISSING", `El bundle en '${bundleRoot}' no trae ${MANIFEST_REL_PATH}: no describe su propio grafo de contexto`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(await fs.readText(path));
+    }
+    catch (err) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", `${MANIFEST_REL_PATH} no es JSON válido: ${err.message}`);
+    }
+    return parseManifest(raw);
+}
+/** Exported for tests: the same validation, over an in-memory object. */
+export function parseManifest(raw) {
+    const root = asRecord(raw, "raíz del manifiesto");
+    const version = root.version;
+    if (version !== SUPPORTED_VERSION) {
+        throw new ManifestError("CONTEXT_MANIFEST_VERSION", `versión de manifiesto no soportada: ${String(version)} (esta CLI lee ${SUPPORTED_VERSION})`);
+    }
+    const signals = readSignals(root.signals);
+    const commands = readCommands(root.commands, signals);
+    const journeys = readJourneys(root.journeys, commands, signals);
+    const budgetPolicy = readPolicy(root.budget_policy);
+    return { version, signals, commands, journeys, budgetPolicy };
+}
+function readSignals(raw) {
+    const record = asRecord(raw, "signals");
+    const out = {};
+    for (const [id, description] of Object.entries(record)) {
+        if (id.startsWith("$"))
+            continue;
+        if (typeof description !== "string" || description.length === 0) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `signal '${id}' sin descripción`);
+        }
+        out[id] = description;
+    }
+    return out;
+}
+function readCommands(raw, signals) {
+    const record = asRecord(raw, "commands");
+    const out = {};
+    for (const [name, value] of Object.entries(record)) {
+        if (name.startsWith("$"))
+            continue;
+        const entry = asRecord(value, `commands.${name}`);
+        const core = asStringArray(entry.core, `commands.${name}.core`);
+        if (core.length === 0) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `commands.${name}.core vacío: todo comando carga al menos su propio cuerpo`);
+        }
+        out[name] = { core, modules: readModules(entry.modules, name, signals) };
+    }
+    if (Object.keys(out).length === 0) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", "commands vacío");
+    }
+    return out;
+}
+function readModules(raw, command, signals) {
+    if (!Array.isArray(raw)) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", `commands.${command}.modules debe ser una lista`);
+    }
+    return raw.map((item, index) => {
+        const module = asRecord(item, `commands.${command}.modules[${index}]`);
+        const path = module.path;
+        const signal = module.signal;
+        if (typeof path !== "string" || path.length === 0) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `commands.${command}.modules[${index}].path ausente`);
+        }
+        if (typeof signal !== "string" || !(signal in signals)) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `commands.${command}.modules[${index}].signal '${String(signal)}' no está declarada en signals`);
+        }
+        const requires = module.requires;
+        if (requires !== undefined && (typeof requires !== "string" || requires.length === 0)) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `commands.${command}.modules[${index}].requires debe nombrar una capacidad`);
+        }
+        return requires === undefined ? { path, signal } : { path, signal, requires };
+    });
+}
+function readJourneys(raw, commands, signals) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", "journeys debe ser una lista no vacía");
+    }
+    return raw.map((item, index) => {
+        const journey = asRecord(item, `journeys[${index}]`);
+        const id = asNonEmptyString(journey.id, `journeys[${index}].id`);
+        const label = asNonEmptyString(journey.label, `journeys[${index}].label`);
+        const command = asNonEmptyString(journey.command, `journeys[${index}].command`);
+        if (!(command in commands)) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `journeys[${index}].command '${command}' no existe en commands`);
+        }
+        const journeySignals = asStringArray(journey.signals, `journeys[${index}].signals`);
+        for (const signal of journeySignals) {
+            if (!(signal in signals)) {
+                throw new ManifestError("CONTEXT_MANIFEST_INVALID", `journeys[${index}].signals contiene '${signal}', no declarada en signals`);
+            }
+        }
+        return { id, label, command, signals: journeySignals };
+    });
+}
+function readPolicy(raw) {
+    const record = asRecord(raw, "budget_policy");
+    const out = {};
+    for (const key of POLICY_KEYS) {
+        const value = record[key];
+        if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+            throw new ManifestError("CONTEXT_MANIFEST_INVALID", `budget_policy.${key} debe ser un número positivo`);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+function asRecord(value, where) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", `${where} debe ser un objeto`);
+    }
+    return value;
+}
+function asStringArray(value, where) {
+    if (!Array.isArray(value)) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", `${where} debe ser una lista`);
+    }
+    return value.map((item, index) => asNonEmptyString(item, `${where}[${index}]`));
+}
+function asNonEmptyString(value, where) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new ManifestError("CONTEXT_MANIFEST_INVALID", `${where} debe ser un string no vacío`);
+    }
+    return value;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/application/context/manifest.js.map

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

package/dist/application/context/measure.js

@@ -0,0 +1,227 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { readPackageVersion } from "../../runtime/version.js";
+import { splitCommandDoc } from "../self/install-skill.js";
+/**
+ * The three tramos of context cost (spec 009 § Requirement).
+ *
+ * Everything here is deterministic and offline: bytes of UTF-8 content read
+ * from a tree on disk, nothing sampled, nothing asked of a host. That is what
+ * lets a gate compare two revisions and get an answer that means something.
+ *
+ * Bytes — not tokens — is the gate metric on purpose: no host in the harness
+ * matrix exposes real token accounting to the agent, and inventing a bytes↔
+ * tokens equivalence would make the budget unfalsifiable (spec 009, scenario
+ * "metricas de tokens no disponibles").
+ */
+/** The file the discovery surface always includes besides the commands. */
+const ORIENTATION_DOC = "SKILL.md";
+const COMMANDS_DIR = "commands";
+/** Not a command: the commands folder's own index. */
+const COMMANDS_INDEX = "README.md";
+export function byteLength(text) {
+    return Buffer.byteLength(text, "utf8");
+}
+/**
+ * Median of a byte series, floored.
+ *
+ * Floored, and on the mean of the two central values for an even count, because
+ * a budget derived from it has to be reproducible to the byte across machines —
+ * a rounding rule chosen per call site is how two "same" measurements start
+ * disagreeing.
+ */
+export function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = sorted.length >> 1;
+    if (sorted.length % 2 === 1)
+        return sorted[mid] ?? 0;
+    return Math.floor(((sorted[mid - 1] ?? 0) + (sorted[mid] ?? 0)) / 2);
+}
+/**
+ * Discovery: the metadata a host renders BEFORE the command is invoked — the
+ * orientation skill's description plus one per command. Derived from the tree
+ * rather than declared in the manifest: a command that ships without paying
+ * discovery is precisely the drift the aggregate budget exists to catch.
+ */
+export async function measureDiscovery(fs, root) {
+    const paths = [ORIENTATION_DOC, ...(await listCommandDocs(fs, root))];
+    const entries = [];
+    for (const path of paths) {
+        entries.push({ path, bytes: byteLength(await readDescription(fs, join(root, path))) });
+    }
+    return { bytes: entries.reduce((sum, e) => sum + e.bytes, 0), entries };
+}
+/** Activation: the command body itself — what the host loads the moment it is invoked. */
+export async function measureActivation(fs, root) {
+    const entries = [];
+    for (const path of await listCommandDocs(fs, root)) {
+        const command = path.slice(`${COMMANDS_DIR}/`.length, -".md".length);
+        entries.push({ command, bytes: await fileBytes(fs, join(root, path)) });
+    }
+    entries.sort((a, b) => a.command.localeCompare(b.command));
+    return { median: median(entries.map((e) => e.bytes)), entries };
+}
+/** Execution: the whole read-set of a journey, core plus the modules its signals activate. */
+export async function measureExecution(fs, root, manifest) {
+    const journeys = [];
+    for (const journey of manifest.journeys) {
+        const readSet = resolveReadSet(manifest, journey.command, journey.signals);
+        const files = [];
+        for (const path of readSet.paths) {
+            const full = join(root, path);
+            const exists = await fs.exists(full);
+            files.push({
+                path,
+                bytes: exists ? await fileBytes(fs, full) : 0,
+                missing: !exists,
+            });
+        }
+        const entry = manifest.commands[journey.command];
+        const everyPath = [...(entry?.core ?? []), ...(entry?.modules ?? []).map((m) => m.path)];
+        let safeBytes = 0;
+        for (const path of everyPath) {
+            const full = join(root, path);
+            if (await fs.exists(full))
+                safeBytes += await fileBytes(fs, full);
+        }
+        journeys.push({
+            id: journey.id,
+            label: journey.label,
+            command: journey.command,
+            signals: journey.signals,
+            bytes: files.reduce((sum, f) => sum + f.bytes, 0),
+            files,
+            safe_bytes: safeBytes,
+            degraded: readSet.degraded || files.some((f) => f.missing),
+        });
+    }
+    return { median: median(journeys.map((j) => j.bytes)), journeys };
+}
+/**
+ * From (command, observed signals) to the ordered list of documents to read.
+ *
+ * Order is core-then-modules, and it is the order the agent reads in: the core
+ * carries the hard floor, so it can never end up behind a conditional module.
+ *
+ * An unknown SIGNAL does not fail: a caller that knows a signal this bundle
+ * does not is a half-finished update, which is a normal state, and the safe
+ * answer there is MORE context — every module, marked degraded.
+ *
+ * An unknown COMMAND is different and returns an EMPTY set: there is no core to
+ * fall back to, so nothing can be resolved. `runContextPlan` turns that into a
+ * hard error naming the commands that do exist.
+ */
+export function resolveReadSet(manifest, command, signals) {
+    const entry = manifest.commands[command];
+    if (entry === undefined) {
+        return {
+            paths: [],
+            degraded: true,
+            reasons: [`comando '${command}' no está declarado en el manifiesto`],
+        };
+    }
+    const reasons = [];
+    const unknownSignals = signals.filter((s) => !(s in manifest.signals));
+    if (unknownSignals.length > 0) {
+        reasons.push(`señales no declaradas: ${unknownSignals.join(", ")}`);
+    }
+    const observed = new Set(signals);
+    // An unknown signal means the caller knows something this bundle does not;
+    // the safe reading of that is every module, not the ones we happened to match.
+    const takeAll = unknownSignals.length > 0;
+    const modules = entry.modules.filter((m) => takeAll || observed.has(m.signal));
+    const paths = [];
+    for (const path of [...entry.core, ...modules.map((m) => m.path)]) {
+        if (!paths.includes(path))
+            paths.push(path);
+    }
+    return { paths, degraded: reasons.length > 0, reasons };
+}
+export async function measureTree(fs, root) {
+    const files = await listAllFiles(fs, root, "");
+    files.sort();
+    const hash = createHash("sha256");
+    for (const rel of files) {
+        hash.update(`${rel}:${await fileBytes(fs, join(root, rel))}\n`);
+    }
+    return {
+        cli_version: readPackageVersion(),
+        content_digest: hash.digest("hex").slice(0, 16),
+        file_count: files.length,
+    };
+}
+/** Core read-set cost of every command the manifest declares, no signal observed. */
+export async function measureGuaranteed(fs, root, manifest) {
+    const out = [];
+    for (const command of Object.keys(manifest.commands).sort()) {
+        const files = resolveReadSet(manifest, command, []).paths;
+        let bytes = 0;
+        for (const rel of files) {
+            const full = join(root, rel);
+            if (await fs.exists(full))
+                bytes += await fileBytes(fs, full);
+        }
+        out.push({ command, bytes, files });
+    }
+    return out;
+}
+/** Every distinct module the manifest declares, counted once. */
+export async function measureModules(fs, root, manifest) {
+    const seen = new Set();
+    for (const entry of Object.values(manifest.commands)) {
+        for (const module of entry.modules)
+            seen.add(module.path);
+    }
+    let bytes = 0;
+    for (const rel of seen) {
+        const full = join(root, rel);
+        if (await fs.exists(full))
+            bytes += await fileBytes(fs, full);
+    }
+    return { count: seen.size, bytes };
+}
+export async function measureBundle(fs, root, rootOrigin, manifest) {
+    return {
+        root,
+        root_origin: rootOrigin,
+        revision: await measureTree(fs, root),
+        discovery: await measureDiscovery(fs, root),
+        activation: await measureActivation(fs, root),
+        execution: await measureExecution(fs, root, manifest),
+        guaranteed: await measureGuaranteed(fs, root, manifest),
+        modules: await measureModules(fs, root, manifest),
+    };
+}
+async function listCommandDocs(fs, root) {
+    const dir = join(root, COMMANDS_DIR);
+    const entries = await fs.list(dir);
+    return entries
+        .filter((e) => e.type === "file" && e.name.endsWith(".md") && e.name !== COMMANDS_INDEX)
+        .map((e) => `${COMMANDS_DIR}/${e.name}`)
+        .sort();
+}
+/**
+ * The description as the INSTALLER extracts it — `splitCommandDoc`, the single
+ * parser every host wrapper already depends on. Measuring discovery with a
+ * second parser of its own would budget a string no host ever renders.
+ */
+async function readDescription(fs, path) {
+    return splitCommandDoc(await fs.readText(path)).description ?? "";
+}
+async function fileBytes(fs, path) {
+    return byteLength(await fs.readText(path));
+}
+async function listAllFiles(fs, root, prefix) {
+    const out = [];
+    for (const entry of await fs.list(join(root, prefix))) {
+        const rel = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
+        if (entry.type === "dir")
+            out.push(...(await listAllFiles(fs, root, rel)));
+        else if (entry.type === "file")
+            out.push(rel);
+    }
+    return out;
+}
+//# sourceMappingURL=measure.js.map