@sentropic/harness 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,8 @@
 # @sentropic/harness
 
-Neutral, host-agnostic **code-work / PR-workflow** tooling for AI-driven development:
-branch / scope / lot / verify discipline, behind a pluggable **profile** SPI.
+Neutral, host-agnostic **code-work / PR-workflow** tooling for AI-driven development: a homogeneous
+`harness <verb>` method layer (branch · scope · verify · test · debug · review · brainstorm · plan)
+behind a pluggable **profile** SPI. The NATIVE sentropic replacement for superpowers.
 
 - **Tooling-only**: zero product-runtime coupling (no Drizzle / Hono / Svelte / Mistral),
   zero `@sentropic/*` deps. Node built-ins + TypeScript only.
@@ -31,14 +32,34 @@ harness check branch --current-branch "$(git branch --show-current)" --expected-
 harness check scope --branch-md BRANCH.md --staged-files "$(git diff --cached --name-only | paste -sd,)" [--json]
 ```
 
-`--json` emits a neutral `VerificationRun`. `--profile sentropic|stub` selects the policy
-pack (default `sentropic`). In an `@sentropic` repo, `make scope-check` wraps the staged+
-unstaged scope check; agents (Claude/Codex/Gemini) are told to use harness — not a generic
-verification skill — for branch/scope discipline (see `AGENTS.md`/`GEMINI.md`).
+`--json` emits a neutral artifact. `--profile sentropic|stub` selects the policy pack (default
+`sentropic`). In an `@sentropic` repo, `make scope-check` wraps the staged+unstaged scope check.
 
-## This slice
-`BRANCH.md` parser · `ScopeBoundary` · **C1** branch-check · **C2** scope-check (advisory,
-BR25 **D5** Layer A) · neutral `VerificationRun`.
+## Verbs
 
-See `BRANCH.md` (branch root) for the lot plan and the design articulation specs
-(`SPEC_STUDY_HARNESS_WORKFLOW_ARTICULATION.md`, `SPEC_STUDY_CLI_ECOSYSTEM_GAPS.md`).
+`harness <verb> [<subject>] [--<option>]`, homogeneous with the sibling CLIs (`stp harness <verb>`):
+
+| Verb | Kind | Emits | Reasoning |
+|---|---|---|---|
+| `check scope\|branch` | producer | `VerificationRun` | — |
+| `verify --category <c>` | producer | `VerificationRun` (roll-up) | — |
+| `init` / `audit` | producer | profile descriptor / `VerificationRun` | skill `harness/adopt` |
+| `brainstorm [--peers] [--ladder]` | recorder | `WorkEvent` | skill `harness/brainstorm` |
+| `test [--category]` | recorder | `WorkEvent` | skill `harness/test` |
+| `debug` | recorder | `WorkEvent` | skill `harness/debug` |
+| `review --consensus [--peers]` | recorder | `WorkEvent` | skill `harness/review` |
+| `plan [--lots]` | recorder | `WorkEvent` | skill `harness/plan` |
+| `branch init\|close` | recorder | `WorkEvent` | — |
+| `skills install --host <h>` | recorder | `WorkEvent` | installs the pack |
+
+**Producers** compute a pass/fail verdict; **recorders** scaffold + record a narrative `WorkEvent` and
+point to a `harness/*` skill that carries the LLM reasoning (the binary never does the thinking).
+
+## Skill pack (superpowers replacement)
+
+`harness skills install --host claude|codex|gemini` installs `harness/{using-harness,brainstorm,test,
+debug,review,plan,adopt}`. `harness/using-harness` loads first and **supersedes** the superpowers skills
+for those acts. superpowers is never a dependency; the user may opt to keep it per repo.
+
+See `BRANCH.md` (branch root) for the lot plan and the design specs
+(`SPEC_DECISION_SCOPE_OWNERSHIP_HARNESS_TRACK_STP.md`, `SPEC_STUDY_HARNESS_WORKFLOW_ARTICULATION.md`).

package/dist/artifacts/work-event.d.ts

@@ -0,0 +1,28 @@
+export type WorkEventVerb = 'brainstorm' | 'debug' | 'review' | 'plan' | 'branch' | 'test' | 'skills';
+export type WorkEventStatus = 'opened' | 'closed' | 'requested' | 'recorded';
+/** A neutral detail value — primitives or string lists only (JSON-stable, ingester-friendly). */
+export type WorkEventValue = string | number | boolean | string[];
+export interface WorkEvent {
+    schemaVersion: 1;
+    kind: 'work-event';
+    /** The harness verb that produced this event. */
+    verb: WorkEventVerb;
+    /** Lifecycle marker of the act. */
+    status: WorkEventStatus;
+    /** Free-form subject of the act (topic, symptom, target, lot, slug). */
+    subject?: string;
+    /** The `harness/*` skill the host should load for the reasoning (method verbs). */
+    skill?: string;
+    /** Opaque references (spec path, decision id, thread, BRANCH.md path). */
+    refs: Record<string, string>;
+    /** Structured neutral detail bag (peers, category, host, recipe steps). */
+    detail: Record<string, WorkEventValue>;
+    runId: string;
+    commit: string;
+    branch: string;
+    env: string;
+    runner: string;
+    /** ISO-8601 timestamp. */
+    at: string;
+}
+//# sourceMappingURL=work-event.d.ts.map

package/dist/artifacts/work-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-event.d.ts","sourceRoot":"","sources":["../../src/artifacts/work-event.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7E,iGAAiG;AACjG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,aAAa,CAAC;IACpB,mCAAmC;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/artifacts/work-event.js

@@ -0,0 +1,9 @@
+// Neutral work-event emitted by harness method/branch verbs.
+//
+// `WorkEvent` is the host-agnostic JSON a NON-pass/fail act produces — `brainstorm`, `debug`,
+// `review`, `plan`, `branch`, `test`, `skills`. harness EMITS it and never writes into
+// `@sentropic/track`; a track-side adapter ingests it (the same emit-only seam as
+// `VerificationRun`). It records the NARRATIVE of an act (a session opened/closed, a request),
+// NOT a verification verdict — cognition is not shoehorned into the verification taxonomy.
+export {};
+//# sourceMappingURL=work-event.js.map

package/dist/artifacts/work-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-event.js","sourceRoot":"","sources":["../../src/artifacts/work-event.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,8FAA8F;AAC9F,uFAAuF;AACvF,kFAAkF;AAClF,+FAA+F;AAC/F,2FAA2F"}

package/dist/branch-md/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/branch-md/parse.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAuF1D"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/branch-md/parse.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA4F1D"}

package/dist/branch-md/parse.js

@@ -47,12 +47,17 @@ export function parseBranchMd(text) {
             currentLot = null;
             continue;
         }
-        if (/\*\*Allowed Paths\*\*/i.test(line)) {
+        // Prefix-match the bucket headings: the canonical BRANCH_TEMPLATE.md carries a
+        // parenthetical suffix (e.g. `**Allowed Paths (implementation scope)**`), so the
+        // closing `**` is NOT adjacent to "Paths". Match the prefix only (as Conditional
+        // already did) — otherwise Allowed/Forbidden silently parse to empty on every
+        // real BRANCH.md and in-scope files wrongly classify as `unknown`.
+        if (/\*\*Allowed Paths/i.test(line)) {
             bucket = 'allowed';
             pushBucket(backtickGlobs(line));
             continue;
         }
-        if (/\*\*Forbidden Paths\*\*/i.test(line)) {
+        if (/\*\*Forbidden Paths/i.test(line)) {
             bucket = 'forbidden';
             pushBucket(backtickGlobs(line));
             continue;

package/dist/branch-md/parse.js.map

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

package/dist/cli/args.d.ts

@@ -0,0 +1,10 @@
+export type FlagValue = string | boolean;
+export interface ParsedArgs {
+    positionals: string[];
+    flags: Record<string, FlagValue>;
+}
+/** Split argv into positionals and `--key [value]` flags (a bare `--key` is boolean true). */
+export declare function parseFlags(args: string[]): ParsedArgs;
+export declare function str(v: FlagValue | undefined): string | undefined;
+export declare function list(v: FlagValue | undefined): string[];
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmBrD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,EAAE,CAGvD"}

package/dist/cli/args.js

@@ -0,0 +1,32 @@
+// Shared, pure argv helpers for the harness CLI driver.
+/** Split argv into positionals and `--key [value]` flags (a bare `--key` is boolean true). */
+export function parseFlags(args) {
+    const positionals = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a.startsWith('--')) {
+            const key = a.slice(2);
+            const next = args[i + 1];
+            if (next === undefined || next.startsWith('--')) {
+                flags[key] = true;
+            }
+            else {
+                flags[key] = next;
+                i++;
+            }
+        }
+        else {
+            positionals.push(a);
+        }
+    }
+    return { positionals, flags };
+}
+export function str(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+export function list(v) {
+    const s = str(v);
+    return s ? s.split(/[\s,]+/).filter(Boolean) : [];
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,wDAAwD;AASxD,8FAA8F;AAC9F,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBAClB,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAwB;IAC1C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,CAAwB;IAC3C,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC"}

package/dist/cli/mechanical-verbs.d.ts

@@ -0,0 +1,9 @@
+import { type FlagValue } from './args.js';
+export declare const MECHANICAL_VERBS: readonly ["verify", "init", "audit"];
+export type MechanicalVerb = (typeof MECHANICAL_VERBS)[number];
+/**
+ * Handle a mechanical/producer verb. Returns the exit code (`null` when `verb` is not one of
+ * `verify`/`init`/`audit`). Emits a `VerificationRun` (`--json`) or a human summary via `out`.
+ */
+export declare function handleMechanicalVerb(positionals: string[], flags: Record<string, FlagValue>, out: (s: string) => void): number | null;
+//# sourceMappingURL=mechanical-verbs.d.ts.map

package/dist/cli/mechanical-verbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mechanical-verbs.d.ts","sourceRoot":"","sources":["../../src/cli/mechanical-verbs.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAO,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,gBAAgB,sCAAuC,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAuE/D;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GACvB,MAAM,GAAG,IAAI,CA+Cf"}

package/dist/cli/mechanical-verbs.js

@@ -0,0 +1,124 @@
+// Mechanical / producer verbs of the harness CLI.
+//
+// Unlike the method verbs (which record a WorkEvent), these COMPUTE a verdict and emit a neutral
+// `VerificationRun`: `verify` is the category-level roll-up over the available static checks (the
+// canonical VerificationRun producer); `audit` diffs the repo against the active profile; `init`
+// scaffolds a profile descriptor so the same C1/C2 kernel can run against ANY repo. Pure: the only
+// IO is reading the `--branch-md` file (shared with `check scope`); no git/docker/fs writes.
+import { toVerificationRun } from '../run/emit.js';
+import { checkBranch } from '../checks/branch-check.js';
+import { sentropicProfile } from '../profile/sentropic.js';
+import { stubProfile } from '../profile/stub.js';
+import { scopeFromFlags } from './scope.js';
+import { str } from './args.js';
+const PLACEHOLDER_TS = '1970-01-01T00:00:00.000Z';
+const CATEGORIES = ['none', 'static', 'unit', 'integration', 'e2e', 'ci', 'uat'];
+export const MECHANICAL_VERBS = ['verify', 'init', 'audit'];
+function isMechanicalVerb(v) {
+    return v !== undefined && MECHANICAL_VERBS.includes(v);
+}
+function isCategory(s) {
+    return CATEGORIES.includes(s);
+}
+function resolveProfile(flags) {
+    return str(flags.profile) === 'stub' ? stubProfile : sentropicProfile;
+}
+function runContext(flags, category, command) {
+    return {
+        runId: 'cli',
+        commit: str(flags.commit) ?? 'unknown',
+        branch: str(flags['current-branch']) ?? 'unknown',
+        env: str(flags.env) ?? 'cli',
+        runner: 'harness',
+        category,
+        command,
+        startedAt: PLACEHOLDER_TS,
+        finishedAt: PLACEHOLDER_TS,
+    };
+}
+/** Gather the static checks computable from supplied flags (C2 scope, C1 branch). */
+function staticChecks(flags, profile, out) {
+    const checks = [];
+    if (flags['staged-files'] !== undefined || flags['branch-md'] !== undefined) {
+        const outcome = scopeFromFlags(flags, profile);
+        if (outcome.unreadable !== undefined) {
+            out(`harness: cannot read plan file: ${outcome.unreadable}`);
+            return null;
+        }
+        if (outcome.result)
+            checks.push({ code: 'C2', category: 'static', result: outcome.result });
+    }
+    if (flags['current-branch'] !== undefined || flags['expected-branch'] !== undefined) {
+        const result = checkBranch({
+            currentBranch: str(flags['current-branch']) ?? '',
+            expectedBranch: str(flags['expected-branch']) ?? '',
+            profile,
+        });
+        checks.push({ code: 'C1', category: 'static', result });
+    }
+    return checks;
+}
+function emitRun(checks, flags, category, command, out) {
+    const run = toVerificationRun(checks, runContext(flags, category, command));
+    if (flags.json === true) {
+        out(JSON.stringify(run, null, 2));
+    }
+    else {
+        out(`${run.result === 'pass' ? 'PASS' : 'FAIL'} ${command} (${category}): ${checks.length} check(s)`);
+        for (const v of run.violations)
+            out(`  - ${v.severity}: ${v.message}`);
+    }
+    return 0;
+}
+/**
+ * Handle a mechanical/producer verb. Returns the exit code (`null` when `verb` is not one of
+ * `verify`/`init`/`audit`). Emits a `VerificationRun` (`--json`) or a human summary via `out`.
+ */
+export function handleMechanicalVerb(positionals, flags, out) {
+    const verb = positionals[0];
+    if (!isMechanicalVerb(verb))
+        return null;
+    const profile = resolveProfile(flags);
+    if (verb === 'init') {
+        const descriptor = {
+            id: profile.id,
+            forbiddenPathDefaults: profile.forbiddenPathDefaults,
+            exceptionIdPattern: profile.exceptionIdPattern.source,
+            conditionalRequiresException: profile.conditionalRequiresException,
+            branchMatch: profile.branchMatch,
+        };
+        if (flags.json === true) {
+            out(JSON.stringify(descriptor, null, 2));
+        }
+        else {
+            out(`harness init — profile '${descriptor.id}' (edit and commit as harness.profile.json):`);
+            out(`  forbiddenPathDefaults: ${descriptor.forbiddenPathDefaults.join(', ') || '(none)'}`);
+            out(`  exceptionIdPattern: ${descriptor.exceptionIdPattern}`);
+            out(`  conditionalRequiresException: ${descriptor.conditionalRequiresException}`);
+            out(`  branchMatch: ${descriptor.branchMatch}`);
+        }
+        return 0;
+    }
+    if (verb === 'verify') {
+        const cat = str(flags.category) ?? 'static';
+        if (!isCategory(cat)) {
+            out(`usage: harness verify [--category ${CATEGORIES.join('|')}] ...`);
+            return 2;
+        }
+        const checks = staticChecks(flags, profile, out);
+        if (checks === null)
+            return 2;
+        return emitRun(checks, flags, cat, 'harness verify', out);
+    }
+    // verb === 'audit' — repo-vs-profile drift as a static VerificationRun.
+    const outcome = scopeFromFlags(flags, profile);
+    if (outcome.unreadable !== undefined) {
+        out(`harness: cannot read plan file: ${outcome.unreadable}`);
+        return 2;
+    }
+    const checks = outcome.result
+        ? [{ code: 'C2', category: 'static', result: outcome.result }]
+        : [];
+    return emitRun(checks, flags, 'static', 'harness audit', out);
+}
+//# sourceMappingURL=mechanical-verbs.js.map

package/dist/cli/mechanical-verbs.js.map

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

package/dist/cli/method-verbs.d.ts

@@ -0,0 +1,14 @@
+import type { WorkEventContext } from '../run/work-event.js';
+import { type FlagValue } from './args.js';
+/** The recorder verbs handled here (not the `check`/`verify`/`init`/`audit` producers). */
+export declare const METHOD_VERBS: readonly ["brainstorm", "debug", "review", "plan", "test", "branch", "skills"];
+export type MethodVerb = (typeof METHOD_VERBS)[number];
+export declare function isMethodVerb(v: string | undefined): v is MethodVerb;
+/** Pure work-event context — the caller injects commit/branch/env; the driver passes placeholders. */
+export declare function workContext(flags: Record<string, FlagValue>): WorkEventContext;
+/**
+ * Handle a method/recorder verb. Returns the exit code; emits a `WorkEvent` (JSON with `--json`)
+ * or human-readable guidance via `out`. `null` is returned when `verb` is not a method verb.
+ */
+export declare function handleMethodVerb(positionals: string[], flags: Record<string, FlagValue>, out: (s: string) => void): number | null;
+//# sourceMappingURL=method-verbs.d.ts.map

package/dist/cli/method-verbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-verbs.d.ts","sourceRoot":"","sources":["../../src/cli/method-verbs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAO,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAIhD,2FAA2F;AAC3F,eAAO,MAAM,YAAY,gFAAiF,CAAC;AAC3G,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,UAAU,CAEnE;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,gBAAgB,CAS9E;AAoID;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GACvB,MAAM,GAAG,IAAI,CAgBf"}

package/dist/cli/method-verbs.js

@@ -0,0 +1,170 @@
+// Method / recorder verbs of the harness CLI.
+//
+// These verbs do NOT compute a pass/fail verdict — they record a neutral `WorkEvent` and print
+// guidance + the `harness/*` skill pointer that carries the LLM reasoning. They stay PURE: no
+// git/docker/fs side-effects (a worktree, a test run, a skills copy are make/host recipes the
+// verb PRINTS, never performs). The reasoning lives in the skill; the binary only scaffolds +
+// records (see SPEC_DECISION_SCOPE_OWNERSHIP_HARNESS_TRACK_STP.md).
+import { toWorkEvent } from '../run/work-event.js';
+import { HARNESS_SKILLS, HOST_SKILL_DIR, isHostId } from '../skills/manifest.js';
+import { str } from './args.js';
+const PLACEHOLDER_TS = '1970-01-01T00:00:00.000Z';
+/** The recorder verbs handled here (not the `check`/`verify`/`init`/`audit` producers). */
+export const METHOD_VERBS = ['brainstorm', 'debug', 'review', 'plan', 'test', 'branch', 'skills'];
+export function isMethodVerb(v) {
+    return v !== undefined && METHOD_VERBS.includes(v);
+}
+/** Pure work-event context — the caller injects commit/branch/env; the driver passes placeholders. */
+export function workContext(flags) {
+    return {
+        runId: 'cli',
+        commit: str(flags.commit) ?? 'unknown',
+        branch: str(flags['current-branch']) ?? 'unknown',
+        env: str(flags.env) ?? 'cli',
+        runner: 'harness',
+        at: PLACEHOLDER_TS,
+    };
+}
+function num(v) {
+    const s = str(v);
+    if (s === undefined)
+        return undefined;
+    const n = Number(s);
+    return Number.isFinite(n) ? n : undefined;
+}
+function prune(detail) {
+    const out = {};
+    for (const [k, v] of Object.entries(detail))
+        if (v !== undefined)
+            out[k] = v;
+    return out;
+}
+function header(verb, status, skill) {
+    return `harness ${verb} — ${status}${skill ? ` (skill: ${skill})` : ''}`;
+}
+function build(verb, positionals, flags) {
+    const subject = positionals[1];
+    switch (verb) {
+        case 'brainstorm': {
+            const detail = prune({ peers: num(flags.peers), ladder: str(flags.ladder) });
+            return {
+                input: { verb, status: 'opened', subject, skill: 'harness/brainstorm', detail },
+                lines: [
+                    header('brainstorm', 'opened', 'harness/brainstorm'),
+                    '  load harness/brainstorm: spec-ladder STUDY→VOL→EVOL, ≥2-peer adversarial review, batched decisions.',
+                ],
+                code: 0,
+            };
+        }
+        case 'debug': {
+            return {
+                input: { verb, status: 'opened', subject, skill: 'harness/debug', detail: {} },
+                lines: [
+                    header('debug', 'opened', 'harness/debug'),
+                    '  load harness/debug: reproduce → evidence → one hypothesis → one fix → re-observe → regression test.',
+                ],
+                code: 0,
+            };
+        }
+        case 'review': {
+            const consensus = flags.consensus === true;
+            const detail = prune({ consensus, peers: num(flags.peers) ?? (consensus ? 2 : undefined) });
+            return {
+                input: { verb, status: 'requested', subject, skill: 'harness/review', detail },
+                lines: [
+                    header('review', 'requested', 'harness/review'),
+                    consensus
+                        ? '  load harness/review: ≥2 independent peers, distinct lenses, reconcile findings.'
+                        : '  load harness/review (single pass; add --consensus for ≥2-peer reconciliation).',
+                ],
+                code: 0,
+            };
+        }
+        case 'plan': {
+            const detail = prune({ lots: num(flags.lots) });
+            return {
+                input: { verb, status: 'opened', subject, skill: 'harness/plan', detail },
+                lines: [
+                    header('plan', 'opened', 'harness/plan'),
+                    '  load harness/plan: spec-ladder + BRANCH.md lots; harness writes BRANCH.md, then `track branch import`.',
+                ],
+                code: 0,
+            };
+        }
+        case 'test': {
+            const detail = prune({ category: str(flags.category), watch: flags.watch === true });
+            return {
+                input: { verb, status: 'requested', subject, skill: 'harness/test', detail },
+                lines: [
+                    header('test', 'requested', 'harness/test'),
+                    '  load harness/test: test-pyramid + scoped loop; run `make test-<area> SCOPE=… ENV=test-<slug>`.',
+                ],
+                code: 0,
+            };
+        }
+        case 'branch': {
+            const sub = positionals[1];
+            if (sub !== 'init' && sub !== 'close') {
+                return { lines: ['usage: harness branch <init|close> [<slug>]'], code: 2 };
+            }
+            const slug = positionals[2];
+            const status = sub === 'init' ? 'opened' : 'closed';
+            const recipe = sub === 'init'
+                ? '  recipe: git worktree add -b feat/<slug> tmp/<slug> origin/main; scaffold BRANCH.md from plan/BRANCH_TEMPLATE.md.'
+                : '  recipe: run the lot-gate roll-up, scope-check staged files, then open/refresh the PR from BRANCH.md.';
+            return {
+                input: { verb, status, subject: slug, detail: { sub } },
+                lines: [header(`branch ${sub}`, status), recipe],
+                code: 0,
+            };
+        }
+        case 'skills': {
+            const sub = positionals[1];
+            const host = str(flags.host);
+            if (sub !== 'install' || !isHostId(host)) {
+                return { lines: ['usage: harness skills install --host <claude|codex|gemini>'], code: 2 };
+            }
+            const dir = HOST_SKILL_DIR[host];
+            const lines = [
+                header('skills install', 'requested', 'harness/using-harness'),
+                `  install plan → ${dir} (host: ${host}); harness/using-harness supersedes superpowers:`,
+                ...HARNESS_SKILLS.map((s) => `    ${dir}/harness-${s.name}/SKILL.md${s.supersedes ? ` (supersedes superpowers:${s.supersedes})` : ''}`),
+            ];
+            return {
+                input: {
+                    verb,
+                    status: 'requested',
+                    subject: 'install',
+                    skill: 'harness/using-harness',
+                    detail: { host, dir, skills: HARNESS_SKILLS.map((s) => s.name) },
+                },
+                lines,
+                code: 0,
+            };
+        }
+    }
+}
+/**
+ * Handle a method/recorder verb. Returns the exit code; emits a `WorkEvent` (JSON with `--json`)
+ * or human-readable guidance via `out`. `null` is returned when `verb` is not a method verb.
+ */
+export function handleMethodVerb(positionals, flags, out) {
+    const verb = positionals[0];
+    if (!isMethodVerb(verb))
+        return null;
+    const built = build(verb, positionals, flags);
+    if (built.code !== 0 || !built.input) {
+        for (const l of built.lines)
+            out(l);
+        return built.code;
+    }
+    if (flags.json === true) {
+        out(JSON.stringify(toWorkEvent(built.input, workContext(flags)), null, 2));
+    }
+    else {
+        for (const l of built.lines)
+            out(l);
+    }
+    return 0;
+}
+//# sourceMappingURL=method-verbs.js.map

package/dist/cli/method-verbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-verbs.js","sourceRoot":"","sources":["../../src/cli/method-verbs.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,+FAA+F;AAC/F,8FAA8F;AAC9F,8FAA8F;AAC9F,8FAA8F;AAC9F,oEAAoE;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,GAAG,EAAkB,MAAM,WAAW,CAAC;AAEhD,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAG3G,MAAM,UAAU,YAAY,CAAC,CAAqB;IAChD,OAAO,CAAC,KAAK,SAAS,IAAK,YAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,WAAW,CAAC,KAAgC;IAC1D,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS;QACtC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,SAAS;QACjD,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK;QAC5B,MAAM,EAAE,SAAS;QACjB,EAAE,EAAE,cAAc;KACnB,CAAC;AACJ,CAAC;AAQD,SAAS,GAAG,CAAC,CAAwB;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED,SAAS,KAAK,CAAC,MAAkD;IAC/D,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,MAAc,EAAE,KAAc;IAC1D,OAAO,WAAW,IAAI,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,KAAK,CAAC,IAAgB,EAAE,WAAqB,EAAE,KAAgC;IACtF,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE/B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE;gBAC/E,KAAK,EAAE;oBACL,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,oBAAoB,CAAC;oBACpD,uGAAuG;iBACxG;gBACD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC9E,KAAK,EAAE;oBACL,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC;oBAC1C,uGAAuG;iBACxG;gBACD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5F,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE;gBAC9E,KAAK,EAAE;oBACL,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC;oBAC/C,SAAS;wBACP,CAAC,CAAC,mFAAmF;wBACrF,CAAC,CAAC,kFAAkF;iBACvF;gBACD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE;gBACzE,KAAK,EAAE;oBACL,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC;oBACxC,0GAA0G;iBAC3G;gBACD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;YACrF,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE;gBAC5E,KAAK,EAAE;oBACL,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC;oBAC3C,kGAAkG;iBACnG;gBACD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBACtC,OAAO,EAAE,KAAK,EAAE,CAAC,6CAA6C,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7E,CAAC;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YACpD,MAAM,MAAM,GACV,GAAG,KAAK,MAAM;gBACZ,CAAC,CAAC,oHAAoH;gBACtH,CAAC,CAAC,wGAAwG,CAAC;YAC/G,OAAO;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE;gBACvD,KAAK,EAAE,CAAC,MAAM,CAAC,UAAU,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC;gBAChD,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,OAAO,EAAE,KAAK,EAAE,CAAC,4DAA4D,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5F,CAAC;YACD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG;gBACZ,MAAM,CAAC,gBAAgB,EAAE,WAAW,EAAE,uBAAuB,CAAC;gBAC9D,oBAAoB,GAAG,WAAW,IAAI,kDAAkD;gBACxF,GAAG,cAAc,CAAC,GAAG,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACjH;aACF,CAAC;YACF,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI;oBACJ,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE,uBAAuB;oBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;iBACjE;gBACD,KAAK;gBACL,IAAI,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAqB,EACrB,KAAgC,EAChC,GAAwB;IAExB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK;YAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK;YAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/run.d.ts

@@ -1,9 +1,10 @@
 /**
  * Pure, arg-based CLI driver — reads everything from `argv`, writes via `out`, returns an exit code.
- * No internal git calls (the caller supplies branch + staged files), no `process.exit`.
+ * No internal git calls (the caller supplies branch + staged files), no `process.exit`, no fs writes.
  * Advisory (D5 Layer A): a failing check returns 0; only a usage error returns non-zero.
- * Acquiring git state under Docker-first (the `make scope-check` passthrough) is a separate,
- * to-be-double-reviewed concern.
+ *
+ * Verb families: `check` (C1/C2 → VerificationRun); method/recorder verbs (brainstorm/test/debug/
+ * review/plan/branch/skills → WorkEvent + skill pointer, see `method-verbs.ts`).
  */
 export declare function runHarnessCli(argv: string[], out: (s: string) => void): number;
 //# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AA8CA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAsE9E"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAuFA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAgB9E"}