@ai-substrate/engineering-harness 0.2.0-canary.45

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI-Substrate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# The Engineering Harness
+
+An engineering harness productises the software-development loop so humans and agents can move from intent to evidence, then encode what they learn into the next run.
+
+> **💡 Fastest start — let your agent do it.** Copy this into Claude Code / Copilot / Cursor / Codex in your repo:
+>
+> ```text
+> Install the engineering harness from https://github.com/AI-Substrate/harness-engineering
+> and adopt it in this repo: read that repo's README and skills/README.md, install the
+> skills with npx skills, then run the eng-harness-0-adopt skill.
+> ```
+
+## The problem
+
+Out of all the problems with agent-driven development, two matter most:
+
+- **The loop closes too slowly.** The agent takes too long to get real feedback from your codebase, so it guesses, loops, or waits for a human.
+- **The loop is hard to trust.** "Looks good to me" from a model is inference, not proof.
+
+Underneath both: every agent session is a fresh developer onboarding into your repo — cold. If the supported path lives in scattered scripts, docs, and tribal memory, the agent has to infer it, and you pay for that inference every session, on every dev machine.
+
+> Can a fresh human or agent move from clean start to proved product behaviour without private tribal knowledge?
+
+If the answer is no, the engineering harness is the surface to improve.
+
+## The loop
+
+An engineering harness makes the **product-development loop** explicit and operable:
+
+```text
+Boot -> Backpressure Check -> Do Work and Observe -> Retro and Magic Wand -> Improve
+```
+
+- **Boot** proves the product can start from a known state.
+- **Backpressure Check** is an LLM-assisted, advisory survey of the current scope against the deterministic sensors the repo exposes.
+- **Do Work and Observe** exercises real product behaviour through supported surfaces and captures what happened in inspectable forms.
+- **Retro and Magic Wand** turns friction, missing signals, and improvement wishes into reviewable candidates.
+- **Improve** encodes what was learned so the next run is faster, clearer, safer, or backed by stronger signals.
+
+The harness is not throwaway scaffolding. It is a **productised development surface**: the repo-local commands, fixtures, docs, checks, state, workflows, proof paths, and feedback loops every future feature, experiment, human, and agent passes through.
+
+## The layers
+
+Intent flows down. Evidence flows up. The engineering harness is the **deterministic layer** — the one your repo probably doesn't have as a first-class thing.
+
+<!-- Diagram source: docs/media/harness-layers.mmd — re-render to docs/media/harness-layers.png
+     (image, not a ```mermaid block, so it renders on npm too — npm doesn't render Mermaid). -->
+![The engineering harness layers — intent flows down, evidence flows up; the deterministic (engineering harness) layer sits between the inference layer and the codebase.](docs/media/harness-layers.png)
+
+> "If the agent had to infer it twice, encode it here."
+
+## The focal point
+
+Reduce all that diffuse engineering-environment information to a single focal point — the harness CLI — and you get three things:
+
+- **A — Discover, in one place.** `--help` instead of tribal memory. Months of team encoding shows up in help text, fetched on demand, not stuffed into agent context.
+- **B — Prove, with backpressure.** One place deterministic verdicts live: yes or no, evidence attached. The agent can claim it's done; the harness decides whether the claim is supported.
+- **C — Improve, on rails.** When friction shows up there's a tangible place to encode the fix — a new command, check, fixture, or sensor — and everyone on the repo, human or agent, gets it.
+
+The agent explores it the way it explores the git CLI: it has never seen your repo, but it knows how to work a CLI. The nucleus, in one line:
+
+```text
+[CLI focal point + required agent use] + [deterministic backpressure]
+  + [friction capture] + [human-selected encoding] = engineering harness nucleus
+```
+
+## See the full intro
+
+- **[The full deck](https://ai-substrate.github.io/harness-engineering/)** — readable scrolling page with commentary, or hit `P` to present it.
+- **[The layers, one page](https://ai-substrate.github.io/harness-engineering/layers.html)** — the layer model as a self-contained visual explainer.
+- The canonical deck source lives at [`docs/harness-presentations/intro-to-harness.md`](docs/harness-presentations/intro-to-harness.md).
+
+## Install the skills
+
+This repo publishes a **setup group** (`skills/eng-harness-setup/`) and an **interactive loop group** (`skills/eng-harness-loop/`), consumable by [`npx skills@latest`](https://github.com/vercel-labs/skills):
+
+```bash
+npx skills@latest add AI-Substrate/harness-engineering/skills -a claude-code -g
+```
+
+Swap `-a` for `github-copilot`, `codex`, `cursor`, `opencode`, `pi`…; drop `-g` for a project-local install; add `-s <skill-name>` for a single skill. The harness CLI also wraps this as `harness skills install` (and `harness skills update` to refresh to latest **and prune** skills this repo has renamed or removed). The full per-CLI / global-vs-local matrix is in [`INSTALL.md`](./INSTALL.md), and [`skills/README.md`](skills/README.md) explains when to run each skill.
+
+## Engineering harness versus agent harness
+
+This repo is about the **engineering harness**, not agent runtimes themselves. (You'll hear the practice called "harness engineering" in the wild — we lead with *engineering harness*, the artifact, so it never gets tangled with agent-harness engineering.)
+
+| Layer | Makes operable | Examples | Proves |
+|---|---|---|---|
+| Engineering harness | The product and its development loop | boot commands, build/test/run flows, seed data, fixtures, health checks, diagnostics, proof bundles, retros, encoded improvements | Whether the actual product can run and prove behaviour |
+| Agent harness | The model as a tool-using agent | tool dispatch, permissions, context, session management, orchestration, memory, execution environment | Whether an agent can attempt or coordinate work |
+
+An agent harness can drive an engineering harness, but it cannot replace one. If the product cannot boot, run, seed, observe, and prove behaviour, the agent has nothing reliable to operate.
+
+## Backpressure
+
+A useful harness is also a **backpressure system**: project-side feedback that makes wrong, unsafe, incomplete, or unproven work hard to continue and easy to correct. It is how the harness says: **not yet, and here is why.**
+
+Good backpressure includes type checks, compilers, linters, schemas, tests and proof gates; health checks, doctor commands, browser traces, logs, screenshots and database checks; structured command output with failure categories and next actions; proof artefacts that show what passed and how to rerun; and human judgement routes for decisions machines cannot make.
+
+Prompts and checklists are useful guides, but high-risk or repeated invariants should move into the strongest practical refusal surface: a command, type, schema, fixture, validation, generated guard, diagnostic, or reviewable proof path. The goal is not ceremony — it is to stop wasting human attention on machine-checkable failure and reserve human judgement for ambiguity, product intent, tradeoffs, taste, and risk.
+
+## What's in this repo
+
+| Area | What it is |
+|---|---|
+| [`harness-foundations/`](harness-foundations/) | The thesis: [first principles](harness-foundations/first-principles.md), [patterns that work](harness-foundations/patterns-that-work.md), [directives](harness-foundations/directives.md), [the simple version](harness-foundations/simple-mode.md), and [source notes](harness-foundations/source-notes/). |
+| [`harness/cli/`](harness/cli/) | The harness CLI core — npx-installed, upgradeable, extended per repo from `.harness/extensions/`. |
+| [`skills/`](skills/) | The deployable skills. Adoption: [`eng-harness-0-adopt`](skills/eng-harness-setup/eng-harness-0-adopt/SKILL.md), [`eng-harness-0-harnessability-assessment`](skills/eng-harness-setup/eng-harness-0-harnessability-assessment/SKILL.md), [`eng-harness-0-add-extension`](skills/eng-harness-setup/eng-harness-0-add-extension/SKILL.md). Loop: `eng-harness-1-boot`, `eng-harness-2-backpressure`, `eng-harness-4-retro`. See [`skills/README.md`](skills/README.md). |
+| [`docs/`](docs/) | How-to guides ([records](docs/how/record-and-record-types.md), [architecture conformance](docs/how/architecture-conformance.md), [dogfooding](docs/how/dogfood-harness-flow.md)), presentations, plans, and project rules. |
+
+Start with [first-principles](harness-foundations/first-principles.md) for the thesis, [patterns-that-work](harness-foundations/patterns-that-work.md) for practical moves, or [directives](harness-foundations/directives.md) for the shortest operating version.
+
+## About this repo
+
+This is the **home of the harness product itself**: the CLI and skills are authored here and deployed into *other* repos. We also **dogfood** the harness on this repo — *editing* the CLI or skills is product development that ships to every consumer; *running* the loop skills is dogfooding this checkout. See [`AGENTS.md`](./AGENTS.md#this-repos-dual-role) and the constitution ([`docs/project-rules/constitution.md`](docs/project-rules/constitution.md) §1).
+
+The CLI's hexagonal architecture is itself under deterministic backpressure: `harness arch-check` proves the import graph against committed dependency-cruiser rules on every PR. Two dogfood extensions exercise the harness against real, unfamiliar repos (`harness validate-harnessability`, `harness validate-harness-flow`) — collected retros are **surfaced, never auto-implemented**. See [`docs/how/dogfood-harness-flow.md`](docs/how/dogfood-harness-flow.md).
+
+**Publication boundary**: this repo distils private and public research into general, publication-safe principles. Raw notes and private source material live outside the public surface. Public content should avoid private names, internal codewords, local paths, unreleased details, and exact private metrics unless explicitly approved.

package/harness/cli/bin/harness.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// Committed executable bin wrapper (plan 017 — T014 CI repair).
+//
+// `package.json#bin` used to point straight at the tsc output
+// (`harness/cli/dist/index.js`), which tsc emits WITHOUT the execute bit and
+// git does not track. Whether `npx --no-install harness` then works depends
+// entirely on npm's install-time bin fixup having chmodded the build output —
+// observed to be unreliable in CI (same npm 10.9.8, green at 08:36, "sh: 1:
+// harness: Permission denied" at 10:12). This wrapper is tracked with git
+// mode 100755, so the execute bit survives every checkout deterministically
+// and the bin needs no install-time chmod at all.
+import '../dist/index.js';

package/harness/cli/dist/acts/docs.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+import { type CliIo } from '../output/output-port.js';
+/**
+ * Register the `docs` command — the CLI front door to the bundled, curated
+ * corpus (plan 007). A CORE command (reserved, like `help`/`doctor`/`new`); it
+ * owns no business logic — the pure `DocsService` lists/resolves, and this act
+ * maps the outcome onto output + exit code:
+ *
+ *   - `harness docs`        → `ok` envelope `{ docs: DocEntry[] }` (human table), exit 0
+ *   - `harness docs <id>`   → the doc's RAW markdown to stdout (no envelope), exit 0
+ *   - `harness docs <bad>`  → `error` envelope `E160`, exit 1
+ *
+ * The raw-dump path mirrors minih `agent-readme`: agent-pipe-friendly, EPIPE-safe
+ * (the entrypoint swallows a broken stdout pipe). Exits route through the single
+ * exit kernel (`exitWithEnvelope`).
+ */
+export declare function registerDocsAct(program: Command, io: CliIo): void;

package/harness/cli/dist/acts/docs.js

@@ -0,0 +1,73 @@
+import { SystemClock } from '../adapters/clock/system-clock.js';
+import { formatError, formatOk } from '../output/envelope.js';
+import { ErrorCodes } from '../output/error-codes.js';
+import { emitRawAndExit, exitWithEnvelope } from '../output/exit.js';
+import { createOutputPort } from '../output/output-port.js';
+import { getDoc, listDocs } from '../services/docs/docs-service.js';
+/** Human-mode listing: one block per doc (id + title, then the summary). */
+function renderList(result) {
+    const width = Math.max(4, ...result.docs.map((doc) => doc.id.length));
+    const lines = ['harness docs — bundled documentation', ''];
+    for (const doc of result.docs) {
+        lines.push(`  ${doc.id.padEnd(width)}  ${doc.title}`);
+        lines.push(`  ${' '.repeat(width)}  ${doc.summary}`);
+    }
+    lines.push('', 'Run `harness docs <id>` to print one.');
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Register the `docs` command — the CLI front door to the bundled, curated
+ * corpus (plan 007). A CORE command (reserved, like `help`/`doctor`/`new`); it
+ * owns no business logic — the pure `DocsService` lists/resolves, and this act
+ * maps the outcome onto output + exit code:
+ *
+ *   - `harness docs`        → `ok` envelope `{ docs: DocEntry[] }` (human table), exit 0
+ *   - `harness docs <id>`   → the doc's RAW markdown to stdout (no envelope), exit 0
+ *   - `harness docs <bad>`  → `error` envelope `E160`, exit 1
+ *
+ * The raw-dump path mirrors minih `agent-readme`: agent-pipe-friendly, EPIPE-safe
+ * (the entrypoint swallows a broken stdout pipe). Exits route through the single
+ * exit kernel (`exitWithEnvelope`).
+ */
+export function registerDocsAct(program, io) {
+    program
+        .command('docs')
+        .description('List the bundled docs, or print one by id (`harness docs <id>`)')
+        .argument('[id]', 'doc id to print verbatim (omit to list all docs)')
+        .action((id) => {
+        const clock = new SystemClock();
+        if (id === undefined) {
+            const result = listDocs();
+            const envelope = formatOk('docs', result, clock, {
+                next_action: 'Run `harness docs <id>` to print a doc.',
+            });
+            const port = io.mode === 'json'
+                ? createOutputPort('json', io.writers)
+                : { emit: () => io.writers.out(renderList(result)) };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        const lookup = getDoc(id);
+        if ('notFound' in lookup) {
+            const envelope = formatError('docs', ErrorCodes.DOC_NOT_FOUND, `no curated doc with id "${id}"`, clock, { next_action: 'Run `harness docs` to see the available ids.' });
+            const port = io.mode === 'json'
+                ? createOutputPort('json', io.writers)
+                : {
+                    emit: (e) => {
+                        io.writers.err(`harness docs: ${e.error?.message ?? 'failed'}\n`);
+                        if (e.next_action) {
+                            io.writers.err(`  → ${e.next_action}\n`);
+                        }
+                    },
+                };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        // Found → write the raw markdown verbatim to stdout and let the process
+        // exit NATURALLY with 0. We deliberately do NOT route this through
+        // process.exit: a large doc piped/redirected could be truncated if the
+        // process terminates before stdout flushes (companion F002 HIGH).
+        emitRawAndExit(lookup.content, io.writers);
+    });
+}
+//# sourceMappingURL=docs.js.map

package/harness/cli/dist/acts/docs.js.map

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

package/harness/cli/dist/acts/doctor.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+import { type CliIo } from '../output/output-port.js';
+import type { VerbRegistry } from '../services/extensions/registry.js';
+import type { RecordRegistry } from '../services/record/registry.js';
+/**
+ * Register the `doctor` command — safe to run at session start. Constructs the
+ * real adapters, injects them + the verb registry + the merged record registry
+ * (provided by the composition root) into the doctor service, and renders: human
+ * mode writes the layered report to stderr + a summary to stdout; JSON mode emits
+ * the envelope to stdout. Always exits 0 (reporting succeeded). `doctor`
+ * enumerates extensions + record types (P7) without invoking any handler — and is
+ * itself a CORE command, never an extension.
+ */
+export declare function registerDoctorAct(program: Command, io: CliIo, registry: VerbRegistry, recordRegistry?: RecordRegistry): void;

package/harness/cli/dist/acts/doctor.js

@@ -0,0 +1,43 @@
+import { SystemClock } from '../adapters/clock/system-clock.js';
+import { NodeEnv } from '../adapters/env/node-env.js';
+import { NodeFs } from '../adapters/fs/node-fs.js';
+import { ExecGit } from '../adapters/git/exec-git.js';
+import { NodeProcess } from '../adapters/process/node-process.js';
+import { exitWithEnvelope } from '../output/exit.js';
+import { createOutputPort } from '../output/output-port.js';
+import { buildDoctorReport, doctorEnvelope, renderDoctorText, } from '../services/doctor/doctor-service.js';
+/**
+ * Register the `doctor` command — safe to run at session start. Constructs the
+ * real adapters, injects them + the verb registry + the merged record registry
+ * (provided by the composition root) into the doctor service, and renders: human
+ * mode writes the layered report to stderr + a summary to stdout; JSON mode emits
+ * the envelope to stdout. Always exits 0 (reporting succeeded). `doctor`
+ * enumerates extensions + record types (P7) without invoking any handler — and is
+ * itself a CORE command, never an extension.
+ */
+export function registerDoctorAct(program, io, registry, recordRegistry) {
+    program
+        .command('doctor')
+        .description('Report what is configured + which extensions loaded (safe at session start)')
+        .action(() => {
+        const clock = new SystemClock();
+        const report = buildDoctorReport({
+            fs: new NodeFs(),
+            proc: new NodeProcess(),
+            git: new ExecGit(),
+            env: new NodeEnv(),
+            clock,
+        }, registry, recordRegistry);
+        const envelope = doctorEnvelope(report, clock);
+        const port = io.mode === 'json'
+            ? createOutputPort('json', io.writers)
+            : {
+                emit: (e) => {
+                    io.writers.err(renderDoctorText(report));
+                    io.writers.out(`doctor: ${e.status}\n`);
+                },
+            };
+        exitWithEnvelope(envelope, port);
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/harness/cli/dist/acts/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/acts/doctor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAc,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAI9C;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,EAAS,EACT,QAAsB,EACtB,cAA+B;IAE/B,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,iBAAiB,CAC9B;YACE,EAAE,EAAE,IAAI,MAAM,EAAE;YAChB,IAAI,EAAE,IAAI,WAAW,EAAE;YACvB,GAAG,EAAE,IAAI,OAAO,EAAE;YAClB,GAAG,EAAE,IAAI,OAAO,EAAE;YAClB,KAAK;SACN,EACD,QAAQ,EACR,cAAc,CACf,CAAC;QACF,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,MAAM,IAAI,GACR,EAAE,CAAC,IAAI,KAAK,MAAM;YAChB,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC;YACtC,CAAC,CAAC;gBACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;oBACV,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;oBACzC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;gBAC1C,CAAC;aACF,CAAC;QACR,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/harness/cli/dist/acts/help.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+import type { FsPort } from '../adapters/fs/fs-port.js';
+import { type CliIo } from '../output/output-port.js';
+import type { VerbRegistry } from '../services/extensions/registry.js';
+/**
+ * Register the `help` orientation command. Human mode prints rich help text
+ * (leading with the AGENTS START HERE banner, plan 014 AC-4); JSON mode emits a
+ * stable `formatOk('help', …)` envelope whose `data.verbs[]` is the
+ * machine-readable, extension-owned command map (AC-1) with per-verb
+ * `has_instructions`. The verb registry is injected by the composition root; the
+ * `FsPort` powers the per-verb briefing existence probes at help-build time (D4);
+ * an empty registry yields an honest "no extensions installed yet" next_action.
+ */
+export declare function registerHelpAct(program: Command, io: CliIo, registry: VerbRegistry, fs: FsPort): void;

package/harness/cli/dist/acts/help.js

@@ -0,0 +1,29 @@
+import { SystemClock } from '../adapters/clock/system-clock.js';
+import { formatOk } from '../output/envelope.js';
+import { exitWithEnvelope } from '../output/exit.js';
+import { createOutputPort } from '../output/output-port.js';
+import { buildHelp, helpEmptyHint, renderHelpText } from '../services/help/help-service.js';
+/**
+ * Register the `help` orientation command. Human mode prints rich help text
+ * (leading with the AGENTS START HERE banner, plan 014 AC-4); JSON mode emits a
+ * stable `formatOk('help', …)` envelope whose `data.verbs[]` is the
+ * machine-readable, extension-owned command map (AC-1) with per-verb
+ * `has_instructions`. The verb registry is injected by the composition root; the
+ * `FsPort` powers the per-verb briefing existence probes at help-build time (D4);
+ * an empty registry yields an honest "no extensions installed yet" next_action.
+ */
+export function registerHelpAct(program, io, registry, fs) {
+    program
+        .command('help')
+        .description('Explain the harness: purpose, commands, output modes, safe first actions')
+        .action(() => {
+        const content = buildHelp(registry, fs);
+        const hint = helpEmptyHint(content);
+        const envelope = formatOk('help', content, new SystemClock(), hint ? { next_action: hint } : undefined);
+        const port = io.mode === 'json'
+            ? createOutputPort('json', io.writers)
+            : { emit: () => io.writers.out(renderHelpText(content, io.useColor ?? false)) };
+        exitWithEnvelope(envelope, port);
+    });
+}
+//# sourceMappingURL=help.js.map

package/harness/cli/dist/acts/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/acts/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAc,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AAEzF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAE5F;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,EAAS,EACT,QAAsB,EACtB,EAAU;IAEV,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,QAAQ,CACvB,MAAM,EACN,OAAO,EACP,IAAI,WAAW,EAAE,EACjB,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CACzC,CAAC;QACF,MAAM,IAAI,GACR,EAAE,CAAC,IAAI,KAAK,MAAM;YAChB,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC;YACtC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QACpF,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/harness/cli/dist/acts/init.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from 'commander';
+import type { Clock } from '../adapters/clock/clock-port.js';
+import type { FsPort } from '../adapters/fs/fs-port.js';
+import type { ProcessPort } from '../adapters/process/process-port.js';
+import { type CliIo } from '../output/output-port.js';
+/** The ports the `init` act injects: `fs`+`proc` for the service, `clock` for the envelope timestamp. */
+export interface InitActDeps {
+    fs: FsPort;
+    proc: ProcessPort;
+    clock: Clock;
+}
+/**
+ * Register the `init` command — the governance-doc INCEPTION writer. Stamps the
+ * `.harness/engineering-harness.md` skeleton (scaffold-and-seed only) and returns
+ * its path. A CORE command (reserved, like `help`/`doctor`/`new`/`record`; runs
+ * even under `--no-extensions`). Idempotent + never-clobber. It owns no business
+ * logic — the `init-service` resolves the path + writes, and this act maps the
+ * outcome onto the Envelope + exit code (created/exists → ok 0, write failure →
+ * error 1). `maturity_seed:'L0'` rides only on a fresh create — it names what
+ * THIS run seeded, so an idempotent re-run that wrote nothing omits it.
+ */
+export declare function registerInitAct(program: Command, io: CliIo, deps: InitActDeps): void;

package/harness/cli/dist/acts/init.js

@@ -0,0 +1,61 @@
+import { formatError, formatOk } from '../output/envelope.js';
+import { exitWithEnvelope } from '../output/exit.js';
+import { createOutputPort } from '../output/output-port.js';
+import { initGovernance } from '../services/init/init-service.js';
+/**
+ * Register the `init` command — the governance-doc INCEPTION writer. Stamps the
+ * `.harness/engineering-harness.md` skeleton (scaffold-and-seed only) and returns
+ * its path. A CORE command (reserved, like `help`/`doctor`/`new`/`record`; runs
+ * even under `--no-extensions`). Idempotent + never-clobber. It owns no business
+ * logic — the `init-service` resolves the path + writes, and this act maps the
+ * outcome onto the Envelope + exit code (created/exists → ok 0, write failure →
+ * error 1). `maturity_seed:'L0'` rides only on a fresh create — it names what
+ * THIS run seeded, so an idempotent re-run that wrote nothing omits it.
+ */
+export function registerInitAct(program, io, deps) {
+    program
+        .command('init')
+        .description('Seed the engineering-harness governance doc skeleton at .harness/engineering-harness.md (idempotent; returns its path)')
+        .action(() => {
+        const outcome = initGovernance(deps);
+        if (outcome.ok) {
+            const data = outcome.created
+                ? { path: outcome.path, created: true, maturity_seed: 'L0' }
+                : { path: outcome.path, created: false };
+            const next_action = outcome.created
+                ? 'Run eng-harness-0-adopt (or fill the TODO sections by hand) to populate boot, signals, and the injection map.'
+                : 'Already present — left untouched. Edit it directly, or run eng-harness-0-adopt to fill the injection map.';
+            const envelope = formatOk('init', data, deps.clock, {
+                evidence: [{ label: 'governance doc', path: outcome.path }],
+                next_action,
+            });
+            const port = io.mode === 'json'
+                ? createOutputPort('json', io.writers)
+                : {
+                    emit: () => {
+                        io.writers.out(outcome.created
+                            ? `Created ${outcome.path}\n`
+                            : `Already present: ${outcome.path} (left untouched)\n`);
+                        io.writers.out('init: ok\n');
+                    },
+                };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        const envelope = formatError('init', outcome.code, outcome.message, deps.clock, {
+            next_action: outcome.next_action,
+        });
+        const port = io.mode === 'json'
+            ? createOutputPort('json', io.writers)
+            : {
+                emit: (e) => {
+                    io.writers.err(`harness init: ${e.error?.message ?? e.next_action ?? 'failed'}\n`);
+                    if (e.next_action)
+                        io.writers.err(`  → ${e.next_action}\n`);
+                    io.writers.out(`init: ${e.status}\n`);
+                },
+            };
+        exitWithEnvelope(envelope, port);
+    });
+}
+//# sourceMappingURL=init.js.map

package/harness/cli/dist/acts/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/acts/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAc,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AASlE;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,EAAS,EAAE,IAAiB;IAC5E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,wHAAwH,CACzH;SACA,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO;gBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;gBAC5D,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO;gBACjC,CAAC,CAAC,+GAA+G;gBACjH,CAAC,CAAC,2GAA2G,CAAC;YAChH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;gBAClD,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC3D,WAAW;aACZ,CAAC,CAAC;YACH,MAAM,IAAI,GACR,EAAE,CAAC,IAAI,KAAK,MAAM;gBAChB,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC;gBACtC,CAAC,CAAC;oBACE,IAAI,EAAE,GAAG,EAAE;wBACT,EAAE,CAAC,OAAO,CAAC,GAAG,CACZ,OAAO,CAAC,OAAO;4BACb,CAAC,CAAC,WAAW,OAAO,CAAC,IAAI,IAAI;4BAC7B,CAAC,CAAC,oBAAoB,OAAO,CAAC,IAAI,qBAAqB,CAC1D,CAAC;wBACF,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBAC/B,CAAC;iBACF,CAAC;YACR,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAa,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE;YACxF,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QACH,MAAM,IAAI,GACR,EAAE,CAAC,IAAI,KAAK,MAAM;YAChB,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC;YACtC,CAAC,CAAC;gBACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;oBACV,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,CAAC,WAAW,IAAI,QAAQ,IAAI,CAAC,CAAC;oBACnF,IAAI,CAAC,CAAC,WAAW;wBAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;oBAC5D,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;gBACxC,CAAC;aACF,CAAC;QACR,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/harness/cli/dist/acts/instructions.d.ts

@@ -0,0 +1,21 @@
+import type { Command } from 'commander';
+import type { Clock } from '../adapters/clock/clock-port.js';
+import type { FsPort } from '../adapters/fs/fs-port.js';
+import { type CliIo } from '../output/output-port.js';
+import type { VerbRegistry } from '../services/extensions/registry.js';
+/** The ports the `instructions` act injects (a subset of VerbActDeps). */
+export interface InstructionsActDeps {
+    fs: FsPort;
+    clock: Clock;
+}
+/**
+ * Register the `instructions` command — the calling agent's self-briefing
+ * channel (plan 014 AC-1/2/3). A CORE act (reserved, like `help`/`doctor`):
+ * bare → the baked core agent briefing + which verbs carry their own briefing;
+ * `instructions <verb>` → that extension's `instructions.md`, read from disk at
+ * THIS invocation (D4 — edit → next call, no rebuild). Outcome → envelope per
+ * D3: ok → 0; unknown verb / missing file → unconfigured → 2 (gap semantics, no
+ * error code); exists-but-unreadable → error E145 → 1. Never a crash, never a
+ * silent empty.
+ */
+export declare function registerInstructionsAct(program: Command, io: CliIo, deps: InstructionsActDeps, registry: VerbRegistry): void;

package/harness/cli/dist/acts/instructions.js

@@ -0,0 +1,75 @@
+import { formatError, formatOk, formatUnconfigured } from '../output/envelope.js';
+import { ErrorCodes } from '../output/error-codes.js';
+import { exitWithEnvelope } from '../output/exit.js';
+import { createOutputPort } from '../output/output-port.js';
+import { buildCoreInstructions, loadVerbInstructions, } from '../services/instructions/instructions-service.js';
+/**
+ * Register the `instructions` command — the calling agent's self-briefing
+ * channel (plan 014 AC-1/2/3). A CORE act (reserved, like `help`/`doctor`):
+ * bare → the baked core agent briefing + which verbs carry their own briefing;
+ * `instructions <verb>` → that extension's `instructions.md`, read from disk at
+ * THIS invocation (D4 — edit → next call, no rebuild). Outcome → envelope per
+ * D3: ok → 0; unknown verb / missing file → unconfigured → 2 (gap semantics, no
+ * error code); exists-but-unreadable → error E145 → 1. Never a crash, never a
+ * silent empty.
+ */
+export function registerInstructionsAct(program, io, deps, registry) {
+    program
+        .command('instructions')
+        .description("Print the harness's agent briefing, or one verb's instructions.md (the calling agent's role)")
+        .argument('[verb]', 'verb whose extension briefing to print; omit for the core briefing')
+        .action((verb) => {
+        if (verb === undefined) {
+            emitCore(io, deps, registry);
+            return;
+        }
+        emitVerb(verb, io, deps, registry);
+    });
+}
+/** Bare `harness instructions` → the baked core briefing (always available). */
+function emitCore(io, deps, registry) {
+    const payload = buildCoreInstructions(registry, deps.fs);
+    const envelope = formatOk('instructions', payload, deps.clock, {
+        next_action: 'Run `harness instructions <verb>` to read a verb briefing before using it.',
+    });
+    const port = io.mode === 'json'
+        ? createOutputPort('json', io.writers)
+        : {
+            emit: () => {
+                io.writers.out(payload.instructions);
+                io.writers.out(payload.verbs_with_instructions.length > 0
+                    ? `\nVerb briefings available: ${payload.verbs_with_instructions.join(', ')}\n`
+                    : '\nNo verb briefings authored yet (see `harness doctor`).\n');
+            },
+        };
+    exitWithEnvelope(envelope, port);
+}
+/** `harness instructions <verb>` → that verb's runtime-loaded briefing, or an honest gap/fault. */
+function emitVerb(verb, io, deps, registry) {
+    const outcome = loadVerbInstructions(verb, registry, deps.fs);
+    if (outcome.kind === 'ok') {
+        const envelope = formatOk('instructions', { verb: outcome.verb, path: outcome.path, instructions: outcome.instructions }, deps.clock, { next_action: `Apply the briefing, then run \`harness ${outcome.verb}\`.` });
+        const port = io.mode === 'json'
+            ? createOutputPort('json', io.writers)
+            : { emit: () => io.writers.out(outcome.instructions) };
+        exitWithEnvelope(envelope, port);
+        return;
+    }
+    const envelope = outcome.kind === 'unreadable'
+        ? formatError('instructions', ErrorCodes.INSTRUCTIONS_UNREADABLE, `instructions.md at ${outcome.path} exists but could not be read`, deps.clock, { next_action: 'Check the path is a readable UTF-8 text file, then retry.' })
+        : outcome.kind === 'missing'
+            ? formatUnconfigured('instructions', `Author ${outcome.path} — the briefing for this verb's calling agent (see \`harness instructions\` for the pattern).`, deps.clock)
+            : formatUnconfigured('instructions', `No verb '${verb}' is registered. Run \`harness help\` for the verb map.`, deps.clock);
+    const port = io.mode === 'json'
+        ? createOutputPort('json', io.writers)
+        : {
+            emit: (e) => {
+                io.writers.err(`harness instructions: ${e.error?.message ?? e.next_action ?? 'failed'}\n`);
+                if (e.next_action)
+                    io.writers.err(`  → ${e.next_action}\n`);
+                io.writers.out(`instructions: ${e.status}\n`);
+            },
+        };
+    exitWithEnvelope(envelope, port);
+}
+//# sourceMappingURL=instructions.js.map

package/harness/cli/dist/acts/instructions.js.map

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

package/harness/cli/dist/acts/new.d.ts

@@ -0,0 +1,19 @@
+import type { Command } from 'commander';
+import type { Clock } from '../adapters/clock/clock-port.js';
+import type { FsPort } from '../adapters/fs/fs-port.js';
+import type { ProcessPort } from '../adapters/process/process-port.js';
+import { type CliIo } from '../output/output-port.js';
+/** The ports the `new` act injects into the scaffold service (a subset of VerbActDeps). */
+export interface NewActDeps {
+    fs: FsPort;
+    proc: ProcessPort;
+    clock: Clock;
+}
+/**
+ * Register the `new` command — scaffolds a fresh, loadable extension into the
+ * repo's `.harness/extensions/`. A CORE command (reserved, like `help`/`doctor`,
+ * runs even in `--no-extensions` mode); it owns no business logic — the
+ * `scaffold-service` validates + writes, and this act maps the outcome onto the
+ * Envelope + exit code (ok → 0, error → 1).
+ */
+export declare function registerNewAct(program: Command, io: CliIo, deps: NewActDeps): void;