@dungle-scrubs/harness-cli-normalizer 0.1.1

package/dist/knowledge/muse.js

@@ -0,0 +1,94 @@
+/**
+ * The muse descriptor: facts about the `muse` CLI as data, verified against
+ * Muse Code 0.1.0 and lucid v1's registry. Descriptor groundwork only
+ * (D-003). The v1 scars this encodes: headless re-entry is `muse exec
+ * --session-id <id>` (the positional `muse resume <id>` is the INTERACTIVE
+ * picker - recognized when pasted, never built), and `muse exec` exits 0
+ * even when the work inside failed (verification always reruns the
+ * project's own checks).
+ */
+import { deepFreeze, UUID_SHAPE } from "./descriptor.js";
+import { SHARED_AUTH_MATCHERS, SHARED_LIMIT_MATCHERS } from "./matchers.js";
+export const museCode = deepFreeze({
+    name: "muse",
+    bin: "muse",
+    verifiedAgainst: "0.1.0",
+    versionSource: { kind: "installed" },
+    launch: {
+        // exec --json emits the payload_type/stream records the runner decodes
+        // (verified 0.1.0); bare exec streams human text.
+        baseFlags: ["exec", "--json"],
+        subcommands: ["exec"],
+        promptStyle: "positional",
+        toolsFlag: null,
+        streamFlags: [],
+        idFlag: "--session-id",
+    },
+    resume: {
+        // Headless re-entry: the same --session-id on exec (v1 registry). The
+        // interactive `muse resume <id>` spelling is parse-only.
+        style: "flag",
+        flag: "--session-id",
+        aliases: [],
+        idShape: UUID_SHAPE,
+        onMissing: "create",
+        // Structured output on resume too (see launch baseFlags).
+        extraFlags: ["--json"],
+        positionalParseWord: "resume",
+    },
+    sessionMode: null,
+    output: {
+        // muse exec --json emits payload.kind run_output_delta text chunks
+        // (verified 0.1.0), so this invocation is token-granular.
+        pins: [{ flags: ["--json"], granularity: "token" }],
+        floor: "none",
+        flagAliases: {},
+    },
+    identity: {
+        authority: "caller-assigned",
+        // Verified on 0.1.0 (--provider echo --json): records carry
+        // payload_type discriminators, no top-level type; the session id lives
+        // nested at stream.id - so match any record and read the path.
+        announce: { match: {}, idField: "stream.id" },
+    },
+    limitMatchers: [...SHARED_LIMIT_MATCHERS],
+    authMatchers: [...SHARED_AUTH_MATCHERS],
+    autonomy: { flag: "--yolo" },
+    vocabulary: {
+        modelFlag: "--model",
+        models: ["muse-spark-1.2-contributor", "muse-spark-1.2", "muse-spark-1.1"],
+        aliases: {},
+        efforts: ["none", "minimal", "low", "medium", "high", "xhigh", "ultra"],
+        effortFlag: "--reasoning-effort",
+        extensible: false,
+    },
+    store: {
+        // ~/.local/share/muse/sessions/YYYY/MM/DD/{id}/session.jsonl (index at
+        // session-index.db) - the template names the sessions root; the
+        // execution layer resolves the dated session file.
+        template: "{home}/.local/share/muse/sessions",
+        cwdSlug: "verbatim",
+    },
+    contextHook: null,
+    // `muse resume --last` exists (muse resume --help).
+    resumeLast: { flag: "--last" },
+    provider: null,
+    stdin: "inherit",
+    discoveryDisableFlags: [],
+    presence: {
+        headlessMarkers: ["exec"],
+    },
+    capabilities: {
+        // images: muse exec exposes --image <PATH>; kept false pending runtime
+        // verification (curated claims stay conservative).
+        vision: false,
+        images: false,
+        streamingByMode: {
+            "headless-turn": "token",
+            "headless-session": "none",
+            interactive: "none",
+        },
+        session: false,
+    },
+});
+//# sourceMappingURL=muse.js.map

package/dist/knowledge/muse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muse.js","sourceRoot":"","sources":["../../src/knowledge/muse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,CAAC,MAAM,QAAQ,GAAsB,UAAU,CAAC;IACpD,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,MAAM;IACX,eAAe,EAAE,OAAO;IACxB,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;IACpC,MAAM,EAAE;QACN,uEAAuE;QACvE,kDAAkD;QAClD,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC7B,WAAW,EAAE,CAAC,MAAM,CAAC;QACrB,WAAW,EAAE,YAAY;QACzB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,cAAc;KACvB;IACD,MAAM,EAAE;QACN,sEAAsE;QACtE,yDAAyD;QACzD,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,QAAQ;QACnB,0DAA0D;QAC1D,UAAU,EAAE,CAAC,QAAQ,CAAC;QACtB,mBAAmB,EAAE,QAAQ;KAC9B;IACD,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE;QACN,mEAAmE;QACnE,0DAA0D;QAC1D,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QACnD,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,EAAE;KAChB;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,iBAAiB;QAC5B,4DAA4D;QAC5D,uEAAuE;QACvE,+DAA+D;QAC/D,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;KAC9C;IACD,aAAa,EAAE,CAAC,GAAG,qBAAqB,CAAC;IACzC,YAAY,EAAE,CAAC,GAAG,oBAAoB,CAAC;IACvC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,UAAU,EAAE;QACV,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,CAAC,4BAA4B,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAC1E,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACvE,UAAU,EAAE,oBAAoB;QAChC,UAAU,EAAE,KAAK;KAClB;IACD,KAAK,EAAE;QACL,uEAAuE;QACvE,gEAAgE;QAChE,mDAAmD;QACnD,QAAQ,EAAE,mCAAmC;QAC7C,OAAO,EAAE,UAAU;KACpB;IACD,WAAW,EAAE,IAAI;IACjB,oDAAoD;IACpD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,SAAS;IAChB,qBAAqB,EAAE,EAAE;IACzB,QAAQ,EAAE;QACR,eAAe,EAAE,CAAC,MAAM,CAAC;KAC1B;IACD,YAAY,EAAE;QACZ,uEAAuE;QACvE,mDAAmD;QACnD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,KAAK;QACb,eAAe,EAAE;YACf,eAAe,EAAE,OAAO;YACxB,kBAAkB,EAAE,MAAM;YAC1B,WAAW,EAAE,MAAM;SACpB;QACD,OAAO,EAAE,KAAK;KACf;CACF,CAAC,CAAC"}

package/dist/knowledge/overrides.d.ts

@@ -0,0 +1,11 @@
+import { type HarnessDescriptor, type HarnessName } from "./descriptor.js";
+export type DescriptorSet = Partial<Record<HarnessName, HarnessDescriptor>>;
+export declare const defaultDescriptors: () => DescriptorSet;
+export declare class OverrideRefusalError extends Error {
+    readonly path: string;
+    readonly harness?: string | undefined;
+    constructor(path: string, detail: string, harness?: string | undefined);
+}
+/** Parse an override document and merge it over the code defaults. */
+export declare const parseOverrides: (jsonText: string, path: string) => DescriptorSet;
+//# sourceMappingURL=overrides.d.ts.map

package/dist/knowledge/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/knowledge/overrides.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAE5E,eAAO,MAAM,kBAAkB,QAAO,aAKpC,CAAC;AAEH,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM;IAH3B,YACW,IAAI,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACL,OAAO,CAAC,EAAE,MAAM,YAAA,EAM1B;CACF;AAuGD,sEAAsE;AACtE,eAAO,MAAM,cAAc,aAAc,MAAM,QAAQ,MAAM,KAAG,aAgC/D,CAAC"}

package/dist/knowledge/overrides.js

@@ -0,0 +1,166 @@
+/**
+ * Override loading (D-006): code defaults plus a validated override file;
+ * the override wins, and a malformed file - structurally OR semantically -
+ * throws with the file path and offending harness in the message. A silent
+ * fallback to defaults, or a garbage value flowing onward, would ship an
+ * override bug invisibly. Pure over TEXT: the caller reads the file and
+ * passes its content; nothing here touches the filesystem.
+ *
+ * Merge semantics: recursive to full depth for plain-object sections (a
+ * partial nested override keeps its sibling keys); arrays replace
+ * wholesale; every leaf is type-checked against the code default's shape,
+ * closed string vocabularies are enforced, and any path whose default
+ * carries a RegExp cannot be overridden from JSON.
+ */
+import { claudeCode } from "./claude-code.js";
+import { codexCli } from "./codex.js";
+import { HARNESS_NAMES, SESSION_INPUT_KINDS, } from "./descriptor.js";
+import { museCode } from "./muse.js";
+import { piCli } from "./pi.js";
+export const defaultDescriptors = () => ({
+    claude: claudeCode,
+    codex: codexCli,
+    pi: piCli,
+    muse: museCode,
+});
+export class OverrideRefusalError extends Error {
+    path;
+    harness;
+    constructor(path, detail, harness) {
+        super(`invalid harness override file ${path}: ${harness === undefined ? "" : `harness ${JSON.stringify(harness)}: `}${detail}`);
+        this.path = path;
+        this.harness = harness;
+        this.name = "OverrideRefusalError";
+    }
+}
+const isPlain = (v) => typeof v === "object" && v !== null && !Array.isArray(v) && !(v instanceof RegExp);
+const FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+const hasRegExpDeep = (value) => {
+    if (value instanceof RegExp)
+        return true;
+    if (Array.isArray(value))
+        return value.some(hasRegExpDeep);
+    if (isPlain(value))
+        return Object.values(value).some(hasRegExpDeep);
+    return false;
+};
+/** Closed string vocabularies by descriptor path - a typo like "Verbatim"
+ * must refuse loudly, not collapse every store path into one directory. */
+const enumAt = (keyPath) => {
+    if (keyPath[0] === "capabilities" && keyPath[1] === "streamingByMode") {
+        return ["token", "message", "none"];
+    }
+    switch (keyPath.join(".")) {
+        case "stdin":
+            return ["inherit", "close-required"];
+        case "store.cwdSlug":
+            return ["dash-separators", "pi-dash-wrapped", "verbatim"];
+        case "resume.style":
+            return ["flag", "positional"];
+        case "identity.authority":
+            return ["caller-assigned", "harness-minted"];
+        case "output.floor":
+            return ["token", "message", "none"];
+        case "launch.promptStyle":
+            return ["positional"];
+        case "sessionMode.input.kind":
+            return SESSION_INPUT_KINDS;
+        default:
+            return null;
+    }
+};
+const mergeValue = (base, override, keyPath, refuse) => {
+    const at = keyPath.length === 0 ? "descriptor" : `section ${JSON.stringify(keyPath.join("."))}`;
+    if (base instanceof RegExp) {
+        refuse(`${at} carries a regular expression and cannot be overridden from JSON`);
+    }
+    if (base === null) {
+        if (override === null)
+            return null;
+        refuse(`${at} defaults to null - there is no shape to validate an override against`);
+    }
+    if (isPlain(base)) {
+        if (!isPlain(override))
+            refuse(`${at} must be an object`);
+        const merged = { ...base };
+        for (const [key, value] of Object.entries(override)) {
+            if (FORBIDDEN_KEYS.has(key))
+                refuse(`${at} key ${JSON.stringify(key)} is not allowed`);
+            if (keyPath.length === 0 && key === "name") {
+                refuse(`the "name" field is the registry key and cannot be overridden`);
+            }
+            if (!Object.hasOwn(base, key)) {
+                refuse(`${at} has no field ${JSON.stringify(key)} to override`);
+            }
+            merged[key] = mergeValue(base[key], value, [...keyPath, key], refuse);
+        }
+        return merged;
+    }
+    if (Array.isArray(base)) {
+        if (hasRegExpDeep(base)) {
+            refuse(`${at} carries regular expressions and cannot be overridden from JSON`);
+        }
+        if (!Array.isArray(override))
+            refuse(`${at} must be an array`);
+        const element = base[0];
+        if (element === undefined) {
+            // Every empty-default array in the descriptor is a string list.
+            if (override.some((v) => typeof v !== "string")) {
+                refuse(`${at} must be an array of strings`);
+            }
+            return override;
+        }
+        if (isPlain(element)) {
+            // Object elements (output.pins) validate recursively against the
+            // default element's shape - null or wrong-shaped entries must refuse
+            // here, not crash a consumer later.
+            return override.map((v, i) => mergeValue(element, v, [...keyPath, String(i)], refuse));
+        }
+        if (override.some((v) => typeof v !== typeof element || v === null)) {
+            refuse(`${at} must be an array of ${typeof element}s`);
+        }
+        return override;
+    }
+    if (typeof override !== typeof base) {
+        refuse(`${at} must be a ${typeof base}, got ${typeof override}`);
+    }
+    const allowed = enumAt(keyPath);
+    if (allowed !== null && !allowed.includes(override)) {
+        refuse(`${at} must be one of ${allowed.join(", ")}, got ${JSON.stringify(override)}`);
+    }
+    return override;
+};
+/** Parse an override document and merge it over the code defaults. */
+export const parseOverrides = (jsonText, path) => {
+    let doc;
+    try {
+        doc = JSON.parse(jsonText);
+    }
+    catch (cause) {
+        throw new OverrideRefusalError(path, `not valid JSON (${cause.message})`);
+    }
+    if (!isPlain(doc)) {
+        throw new OverrideRefusalError(path, "top level must be an object keyed by harness name");
+    }
+    const defaults = defaultDescriptors();
+    const merged = { ...defaults };
+    for (const [name, sections] of Object.entries(doc)) {
+        const refuse = (detail) => {
+            throw new OverrideRefusalError(path, detail, name);
+        };
+        if (!HARNESS_NAMES.includes(name)) {
+            refuse(`unknown harness; known: ${HARNESS_NAMES.join(", ")}`);
+        }
+        const base = defaults[name];
+        if (base === undefined) {
+            refuse("this harness has no code defaults to override yet");
+        }
+        const next = mergeValue(base, sections, [], refuse);
+        if (next.store.template.includes("..")) {
+            refuse('store.template must not contain ".."');
+        }
+        merged[name] = next;
+    }
+    return merged;
+};
+//# sourceMappingURL=overrides.js.map

package/dist/knowledge/overrides.js.map

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

package/dist/knowledge/pi.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The pi descriptor: facts about the `pi` CLI as data, verified against
+ * pi 0.84.1. Descriptor groundwork only (D-003). The load-bearing scars:
+ * pi reads stdin even in -p mode (a backgrounded call without `< /dev/null`
+ * hangs forever), it auto-discovers instruction files/skills/extensions
+ * unless disabled, and its model registry is runtime-extensible (D-008) -
+ * the curated list here is a baseline, never a refusal authority.
+ */
+import { type HarnessDescriptor } from "./descriptor.js";
+export declare const piCli: HarnessDescriptor;
+//# sourceMappingURL=pi.d.ts.map

package/dist/knowledge/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../src/knowledge/pi.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAc,KAAK,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAGjF,eAAO,MAAM,KAAK,EAAE,iBAqFlB,CAAC"}

package/dist/knowledge/pi.js

@@ -0,0 +1,97 @@
+/**
+ * The pi descriptor: facts about the `pi` CLI as data, verified against
+ * pi 0.84.1. Descriptor groundwork only (D-003). The load-bearing scars:
+ * pi reads stdin even in -p mode (a backgrounded call without `< /dev/null`
+ * hangs forever), it auto-discovers instruction files/skills/extensions
+ * unless disabled, and its model registry is runtime-extensible (D-008) -
+ * the curated list here is a baseline, never a refusal authority.
+ */
+import { deepFreeze, UUID_SHAPE } from "./descriptor.js";
+import { SHARED_AUTH_MATCHERS, SHARED_LIMIT_MATCHERS } from "./matchers.js";
+export const piCli = deepFreeze({
+    name: "pi",
+    bin: "pi",
+    verifiedAgainst: "0.84.1",
+    versionSource: { kind: "npm", package: "@earendil-works/pi-coding-agent" },
+    launch: {
+        // -p --mode json: bare -p prints plain text; --mode json emits the
+        // structured v3 records the runner decodes (verified 0.84.1).
+        baseFlags: ["-p", "--mode", "json"],
+        subcommands: [],
+        promptStyle: "positional",
+        toolsFlag: null,
+        streamFlags: [],
+        idFlag: "--session-id",
+    },
+    resume: {
+        // Caller-assigned: the same --session-id re-enters the session. Resume
+        // carries the same structured-output flags launch does, or a resumed
+        // turn would stream plain text the runner cannot decode.
+        style: "flag",
+        flag: "--session-id",
+        aliases: [],
+        idShape: UUID_SHAPE,
+        onMissing: "create",
+        extraFlags: ["-p", "--mode", "json"],
+    },
+    // --mode rpc exists on 0.84.1 but its session semantics are unverified
+    // against a live run; per the truthfulness rule it stays null until a
+    // spike proves the contract (the claude slice is the proven vertical -
+    // D-003).
+    sessionMode: null,
+    output: {
+        // pi -p prints plain text; --mode json emits structured v3 records
+        // INCLUDING assistantMessageEvent text_delta tokens (verified 0.84.1),
+        // so this invocation is token-granular, not merely message.
+        pins: [{ flags: ["--mode", "json"], granularity: "token" }],
+        floor: "none",
+        flagAliases: {},
+    },
+    identity: {
+        authority: "caller-assigned",
+        // The v3 session record header: {"type":"session","version":3,"id":...}
+        // - the field is `id`, observed in real transcripts under ~/.pi/sessions.
+        announce: { match: { type: "session" }, idField: "id" },
+    },
+    limitMatchers: [...SHARED_LIMIT_MATCHERS],
+    authMatchers: [...SHARED_AUTH_MATCHERS],
+    autonomy: null,
+    vocabulary: {
+        modelFlag: "--model",
+        models: ["zai/glm-5.2"],
+        aliases: {},
+        efforts: ["off", "minimal", "low", "medium", "high", "xhigh", "max"],
+        effortFlag: "--thinking",
+        // D-008: providers register models at runtime (~/.pi/models.json), so
+        // the vocabulary is open - validation accepts clean unknown selectors
+        // and capability claims degrade to unknown instead.
+        extensible: true,
+    },
+    store: {
+        // Verified on pi 0.84.1: ~/.pi/sessions/<slug>/<ISO-stamp>_<uuid>.jsonl
+        // where the slug is the cwd dash-flattened and dash-wrapped, dots
+        // preserved (--Users-kevin-dev-x--). The stamp needs a store scan, so
+        // the template names the per-cwd directory.
+        template: "{home}/.pi/sessions/{cwdSlug}",
+        cwdSlug: "pi-dash-wrapped",
+    },
+    contextHook: null,
+    resumeLast: null,
+    provider: { flag: "--provider" },
+    stdin: "close-required",
+    discoveryDisableFlags: ["-nt", "-nc", "-ne", "-ns"],
+    presence: {
+        headlessMarkers: ["-p", "--print"],
+    },
+    capabilities: {
+        vision: false,
+        images: false,
+        streamingByMode: {
+            "headless-turn": "token",
+            "headless-session": "none",
+            interactive: "none",
+        },
+        session: false,
+    },
+});
+//# sourceMappingURL=pi.js.map

package/dist/knowledge/pi.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@dungle-scrubs/harness-cli-normalizer",
+  "version": "0.1.1",
+  "description": "One stable interface to four coding-agent CLIs that survives their updates.",
+  "license": "MIT",
+  "author": "Kevin Frilot",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dungle-scrubs/harness-cli-normalizer.git"
+  },
+  "homepage": "https://github.com/dungle-scrubs/harness-cli-normalizer#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./knowledge": {
+      "types": "./dist/knowledge/index.d.ts",
+      "import": "./dist/knowledge/index.js"
+    },
+    "./interpretation": {
+      "types": "./dist/interpretation/index.d.ts",
+      "import": "./dist/interpretation/index.js"
+    },
+    "./execution": {
+      "types": "./dist/execution/index.d.ts",
+      "import": "./dist/execution/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@11.5.2",
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "node scripts/build.ts",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm test:bun && pnpm build && pnpm check:package",
+    "check:package": "node scripts/check-package.ts",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:bun": "bun test",
+    "prepare": "git config --local core.hooksPath .git/hooks && lefthook install --force",
+    "prepack": "pnpm build",
+    "smoke:claude": "bun scripts/smoke-claude.ts",
+    "smoke:all": "bun scripts/smoke-all.ts",
+    "demo": "bun scripts/demo.ts",
+    "smoke:seven": "bun scripts/smoke-seven.ts",
+    "check:versions": "bun scripts/check-versions.ts"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@types/node": "^26.2.0",
+    "lefthook": "^2.1.10",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  }
+}

package/src/execution/channel.ts

@@ -0,0 +1,86 @@
+/**
+ * A single-consumer async channel with producer backpressure: push from
+ * producers (await the returned promise - past the high water mark it
+ * blocks until the consumer drains below low water, so OS pipe
+ * backpressure can reach a child process), iterate from EXACTLY ONE
+ * consumer, close to end iteration. A second concurrent iterator would
+ * overwrite the consumer wake and strand the first - it throws instead.
+ * push after close is a silent no-op by contract (the closer decided the
+ * stream is over; racing producers must not crash).
+ */
+export class AsyncChannel<T> implements AsyncIterable<T> {
+  private items: T[] = [];
+  private head = 0;
+  private closed = false;
+  private wake: (() => void) | null = null;
+  private producerWaiters: Array<() => void> = [];
+  private consuming = false;
+  private backpressureEnabled = true;
+
+  constructor(
+    private readonly highWater = 1024,
+    private readonly lowWater = 256,
+  ) {}
+
+  private get size(): number {
+    return this.items.length - this.head;
+  }
+
+  push(item: T): Promise<void> {
+    if (this.closed) return Promise.resolve();
+    this.items.push(item);
+    this.wake?.();
+    if (this.backpressureEnabled && this.size > this.highWater) {
+      return new Promise((resolve) => this.producerWaiters.push(resolve));
+    }
+    return Promise.resolve();
+  }
+
+  close(): void {
+    this.closed = true;
+    this.wake?.();
+    this.releaseProducers();
+  }
+
+  /** Stop blocking producers without closing delivery. This is a terminal
+   * process state: the child has exited and output reads are being disposed,
+   * so only already-buffered pipe data can still be added. */
+  releaseBackpressure(): void {
+    this.backpressureEnabled = false;
+    this.releaseProducers();
+  }
+
+  get isClosed(): boolean {
+    return this.closed;
+  }
+
+  private releaseProducers(): void {
+    const waiters = this.producerWaiters;
+    this.producerWaiters = [];
+    for (const release of waiters) release();
+  }
+
+  async *[Symbol.asyncIterator](): AsyncIterator<T> {
+    if (this.consuming) {
+      throw new Error("AsyncChannel is single-consumer; a second iterator would strand the first");
+    }
+    this.consuming = true;
+    while (true) {
+      if (this.size > 0) {
+        const item = this.items[this.head++];
+        if (this.head === this.items.length) {
+          this.items = [];
+          this.head = 0;
+        }
+        if (this.size < this.lowWater) this.releaseProducers();
+        if (item !== undefined) yield item;
+        continue;
+      }
+      if (this.closed) return;
+      await new Promise<void>((resolve) => {
+        this.wake = resolve;
+      });
+      this.wake = null;
+    }
+  }
+}

package/src/execution/decode.ts

@@ -0,0 +1,79 @@
+/**
+ * Stream-line decoding: one claude stream-json line in, zero or more
+ * HarnessEvents out. Stateful only through the explicit DecodeState the
+ * caller threads (identity dedupe per D-022). Unparseable lines on a
+ * structured stream are tolerated - scanned for walls, never fatal.
+ */
+import { capabilitiesOf } from "../interpretation/capabilities.js";
+import { contentEventsOf } from "../interpretation/content.js";
+import { decodeIdentity } from "../interpretation/identity.js";
+import { detectLimitInLine } from "../interpretation/limits.js";
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+import type { HarnessEvent } from "./events.js";
+
+export interface DecodeState {
+  lastSeenId: string | null;
+  limitSeen: boolean;
+  /** The id this turn expects (resume paths); rotation is classified
+   * against it. Null for fresh launches. */
+  requestedId: string | null;
+}
+
+export const freshDecodeState = (requestedId: string | null = null): DecodeState => ({
+  lastSeenId: null,
+  limitSeen: false,
+  requestedId,
+});
+
+export const decodeLine = (
+  h: HarnessDescriptor,
+  line: string,
+  state: DecodeState,
+  model: string,
+): HarnessEvent[] => {
+  let raw: unknown;
+  try {
+    raw = JSON.parse(line);
+  } catch {
+    // Not structured output: the only signal a plain line can carry is a wall.
+    const code = detectLimitInLine(h, line);
+    if (code !== null) {
+      state.limitSeen = true;
+      return [{ kind: "limit", code, message: `limit wall detected (${code})` }];
+    }
+    return [];
+  }
+  return decodeParsed(h, raw, state, model);
+};
+
+/** The parsed-record half of decodeLine, for pumps that already parsed the
+ * line once (a session pump inspects `type` before routing) - the hottest
+ * path must not JSON.parse every token delta twice. */
+export const decodeParsed = (
+  h: HarnessDescriptor,
+  raw: unknown,
+  state: DecodeState,
+  model: string,
+): HarnessEvent[] => {
+  const events: HarnessEvent[] = [];
+  const decoded = decodeIdentity(h, raw, state.lastSeenId, state.requestedId);
+  if (decoded.sessionId !== null) state.lastSeenId = decoded.sessionId;
+  if (decoded.identity !== null) {
+    events.push({
+      kind: "identity",
+      sessionId: decoded.identity,
+      authority: h.identity.authority,
+      capabilities: capabilitiesOf(h, model, "headless-turn"),
+    });
+  } else if (decoded.outcome === "malformed" || decoded.outcome === "rotated") {
+    // The interpretation layer classified an identity anomaly; swallowing
+    // it would leave the runner waiting for an identity that already
+    // failed to arrive (or bind a rotated one).
+    events.push({ kind: "error", message: `identity ${decoded.outcome}` });
+  }
+
+  // Content (message/token/tool/error) is per-harness; identity above is
+  // descriptor-driven. contentEventsOf dispatches by harness name.
+  for (const content of contentEventsOf(h.name, raw)) events.push(content);
+  return events;
+};