@ai-substrate/engineering-harness 0.2.0

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

@@ -0,0 +1,256 @@
+import { formatDegraded, formatError, formatOk } 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 { DEFAULT_SKILLS_SOURCE, KNOWN_SKILL_TARGETS, LEGACY_SKILL_SLUGS, } from '../services/skills/contract.js';
+import { buildInstallArgv, buildRemoveArgv, formatInstallCommand, resolveSkillsSource, } from '../services/skills/skills-service.js';
+const SKILLS_DOCS_URL = 'https://github.com/vercel-labs/skills';
+const MAX_STDERR_TAIL = 800;
+/**
+ * Emit an actionable `E108` (invalid args) and exit 1 — shared by the install/update
+ * subcommands. Never blocks on a prompt: the CLI is agent-first, so a bad flag combo
+ * returns guidance, not a hang. JSON → a single envelope on stdout; human → stderr
+ * lines prefixed with `label` (e.g. `harness skills install`).
+ */
+function failInvalidArgs(io, deps, label, message, next_action) {
+    const envelope = formatError('skills', ErrorCodes.INVALID_ARGS, message, deps.clock, {
+        next_action,
+    });
+    const port = io.mode === 'json'
+        ? createOutputPort('json', io.writers)
+        : {
+            emit: (e) => {
+                io.writers.err(`${label}: ${e.error?.message ?? 'failed'}\n`);
+                if (e.next_action)
+                    io.writers.err(`  → ${e.next_action}\n`);
+            },
+        };
+    exitWithEnvelope(envelope, port);
+}
+/**
+ * Register the `skills` command + its `install` subcommand — a first-class CORE
+ * capability (reserved, like `help`/`doctor`/`new`/`docs`; it ships with the
+ * published CLI so the harness can install its own skills in any repo). It owns
+ * no install logic: it is a transparent PASS-THROUGH to Vercel's `npx skills add`
+ * (Principle 8, wrap-don't-rebuild — that tool already owns the CLI-target × scope
+ * matrix). The act:
+ *   - builds the exact argv with the pure `buildInstallArgv` (always `-y`, so the
+ *     blocking interactive picker never appears);
+ *   - **announces the exact `npx …` command before running it** — to stderr in
+ *     human mode, and inside the envelope (`data.command` + `next_action`) in JSON
+ *     mode, so the `--json` stdout stays a single parseable envelope (Principle 4);
+ *   - shells out ONLY through the injected `ExecPort` (no direct child/shell);
+ *   - maps the result onto an Envelope + exit code (ok → 0, `E170` → 1).
+ *
+ * Targets are flags, not a blocking prompt: the harness CLI is agent-first and
+ * non-blocking, so a missing `--target` returns `E108` with a `next_action` that
+ * enumerates the valid targets. The *skill* (`eng-harness-0-adopt`) is what asks
+ * the user, then runs this with flags.
+ */
+export function registerSkillsAct(program, io, deps) {
+    const skills = program
+        .command('skills')
+        .description("Install this harness's skills via the Vercel `npx skills` CLI");
+    // Bare `harness skills` → agent-friendly orientation (no blocking, exit 0).
+    skills.action(() => {
+        const envelope = formatOk('skills', { subcommands: ['install', 'update'], installer: SKILLS_DOCS_URL }, deps.clock, {
+            next_action: 'Run `harness skills install --target <cli> [--global]` (or `update` to refresh + prune).',
+        });
+        const port = io.mode === 'json'
+            ? createOutputPort('json', io.writers)
+            : {
+                emit: () => io.writers.out("harness skills — install this harness's skills.\n" +
+                    '  harness skills install --target <cli> [--global]   # add / refresh\n' +
+                    '  harness skills update  --target <cli> [--global]   # refresh to latest + prune renamed/removed\n'),
+            };
+        exitWithEnvelope(envelope, port);
+    });
+    skills
+        .command('install')
+        .description("Install this repo's skills into a CLI (pass-through to `npx skills add`, always -y)")
+        .option('-t, --target <cli...>', `CLI target(s), repeatable: ${KNOWN_SKILL_TARGETS.join(', ')}`)
+        .option('-g, --global', 'install globally (omit for a project-local install)')
+        .option('--source <repo>', 'skills source (owner/repo or local path)', DEFAULT_SKILLS_SOURCE)
+        .option('-b, --branch <ref>', 'install from a branch (single-segment; rewrites a GitHub source to /tree/<ref>). Also accepted as --source owner/repo#ref')
+        .option('-s, --skill <slug...>', 'install only specific skill slug(s)')
+        .action(async (opts) => {
+        const targets = opts.target ?? [];
+        const jsonPort = () => createOutputPort('json', io.writers);
+        // No target → at least one CLI target is required. Fail fast with an actionable
+        // E108 (never block on a prompt — the CLI is agent-first).
+        if (targets.length === 0) {
+            failInvalidArgs(io, deps, 'harness skills install', 'no --target given: at least one CLI target is required.', `Pass --target <cli> (one or more of: ${KNOWN_SKILL_TARGETS.join(', ')}). Example: harness skills install --target github-copilot --global`);
+            return;
+        }
+        // Resolve --source (+ --branch / a `#ref` suffix) into the specifier the
+        // Vercel installer truly accepts (a GitHub /tree/<ref> URL for a branch).
+        const resolved = resolveSkillsSource(opts.source, opts.branch);
+        if (!resolved.ok) {
+            failInvalidArgs(io, deps, 'harness skills install', resolved.reason, `Re-run with a valid source/branch. ${resolved.reason}`);
+            return;
+        }
+        const installOpts = {
+            source: resolved.source,
+            targets,
+            global: Boolean(opts.global),
+            skills: opts.skill,
+        };
+        const argv = buildInstallArgv(installOpts);
+        const command = formatInstallCommand(argv);
+        // Announce BEFORE running. Human → stderr; JSON → folded into the envelope (data + next_action),
+        // never prose on stdout (keeps `--json` stdout a single valid envelope).
+        if (io.mode !== 'json') {
+            io.writers.err(`harness skills install — about to run:\n  ${command}\n` +
+                `(wraps the Vercel skills installer — more at ${SKILLS_DOCS_URL})\n`);
+        }
+        const result = await deps.exec.run('npx', argv, { cwd: deps.proc.cwd() });
+        if (result.ok) {
+            const envelope = formatOk('skills', {
+                command,
+                targets,
+                global: Boolean(opts.global),
+                source: resolved.source,
+                ...(resolved.branch ? { branch: resolved.branch } : {}),
+                installer: SKILLS_DOCS_URL,
+            }, deps.clock, {
+                next_action: `Skills installed for ${targets.join(', ')}. Verify with your CLI's skills listing.`,
+            });
+            const port = io.mode === 'json'
+                ? jsonPort()
+                : {
+                    emit: () => {
+                        if (result.stdout.trim())
+                            io.writers.out(`${result.stdout.replace(/\n$/, '')}\n`);
+                        io.writers.out(`skills install: ok (${targets.join(', ')})\n`);
+                    },
+                };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        const envelope = formatError('skills', ErrorCodes.SKILLS_INSTALL_FAILED, `\`npx skills add\` failed (exit ${result.code}).`, deps.clock, {
+            next_action: `Check network + that \`npx\` is available, then re-run: ${command}`,
+            details: { command, stderr_tail: result.stderr.slice(-MAX_STDERR_TAIL) },
+        });
+        const port = io.mode === 'json'
+            ? jsonPort()
+            : {
+                emit: (e) => {
+                    if (result.stderr.trim())
+                        io.writers.err(`${result.stderr.replace(/\n$/, '')}\n`);
+                    io.writers.err(`harness skills install: ${e.error?.message ?? 'failed'}\n`);
+                    if (e.next_action)
+                        io.writers.err(`  → ${e.next_action}\n`);
+                },
+            };
+        exitWithEnvelope(envelope, port);
+    });
+    skills
+        .command('update')
+        .description("Update this repo's skills to latest AND prune renamed/removed ones (refresh via `npx skills add`, then `npx skills remove` the legacy slugs)")
+        .option('-t, --target <cli...>', `CLI target(s), repeatable: ${KNOWN_SKILL_TARGETS.join(', ')}`)
+        .option('-g, --global', 'update the global install (omit for a project-local update)')
+        .option('--source <repo>', 'skills source (owner/repo or local path)', DEFAULT_SKILLS_SOURCE)
+        .option('-b, --branch <ref>', 'update from a branch (single-segment; rewrites a GitHub source to /tree/<ref>). Also accepted as --source owner/repo#ref')
+        .action(async (opts) => {
+        const targets = opts.target ?? [];
+        const jsonPort = () => createOutputPort('json', io.writers);
+        // No target → at least one CLI target is required (same agent-first E108 as install).
+        if (targets.length === 0) {
+            failInvalidArgs(io, deps, 'harness skills update', 'no --target given: at least one CLI target is required.', `Pass --target <cli> (one or more of: ${KNOWN_SKILL_TARGETS.join(', ')}). Example: harness skills update --target github-copilot --global`);
+            return;
+        }
+        const resolved = resolveSkillsSource(opts.source, opts.branch);
+        if (!resolved.ok) {
+            failInvalidArgs(io, deps, 'harness skills update', resolved.reason, `Re-run with a valid source/branch. ${resolved.reason}`);
+            return;
+        }
+        const global = Boolean(opts.global);
+        const refreshArgv = buildInstallArgv({ source: resolved.source, targets, global });
+        const refreshCommand = formatInstallCommand(refreshArgv);
+        const removeOpts = { slugs: [...LEGACY_SKILL_SLUGS], targets, global };
+        const pruneArgv = buildRemoveArgv(removeOpts);
+        const pruneCommand = formatInstallCommand(pruneArgv);
+        // Announce BOTH commands before running. Human → stderr; JSON → folded into the
+        // envelope (refresh_command + prune_command), never prose on stdout.
+        if (io.mode !== 'json') {
+            io.writers.err(`harness skills update — about to run:\n  ${refreshCommand}\n  ${pruneCommand}\n` +
+                `(refresh to latest, then prune renamed/removed skills — wraps the Vercel skills installer; more at ${SKILLS_DOCS_URL})\n`);
+        }
+        const cwd = deps.proc.cwd();
+        // 1) Refresh: install/refresh the current published set (also pulls any NEW skills).
+        //    If this fails we DON'T prune — the existing skills stay intact (no regression).
+        const refresh = await deps.exec.run('npx', refreshArgv, { cwd });
+        if (!refresh.ok) {
+            const envelope = formatError('skills', ErrorCodes.SKILLS_INSTALL_FAILED, `\`npx skills add\` (refresh) failed (exit ${refresh.code}); skills left unchanged (prune not attempted).`, deps.clock, {
+                next_action: `Check network + that \`npx\` is available, then re-run: harness skills update --target ${targets.join(' --target ')}${global ? ' --global' : ''}`,
+                details: {
+                    command: refreshCommand,
+                    stderr_tail: refresh.stderr.slice(-MAX_STDERR_TAIL),
+                },
+            });
+            const port = io.mode === 'json'
+                ? jsonPort()
+                : {
+                    emit: (e) => {
+                        if (refresh.stderr.trim())
+                            io.writers.err(`${refresh.stderr.replace(/\n$/, '')}\n`);
+                        io.writers.err(`harness skills update: ${e.error?.message ?? 'failed'}\n`);
+                        if (e.next_action)
+                            io.writers.err(`  → ${e.next_action}\n`);
+                    },
+                };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        // 2) Prune: remove the renamed/removed legacy slugs (no-ops on any not installed).
+        const prune = await deps.exec.run('npx', pruneArgv, { cwd });
+        const baseData = {
+            refresh_command: refreshCommand,
+            prune_command: pruneCommand,
+            pruned_candidates: [...LEGACY_SKILL_SLUGS],
+            targets,
+            global,
+            source: resolved.source,
+            ...(resolved.branch ? { branch: resolved.branch } : {}),
+            installer: SKILLS_DOCS_URL,
+        };
+        if (prune.ok) {
+            const envelope = formatOk('skills', baseData, deps.clock, {
+                next_action: `Skills updated for ${targets.join(', ')} — refreshed to latest and pruned renamed/removed slugs. Verify with your CLI's skills listing.`,
+            });
+            const port = io.mode === 'json'
+                ? jsonPort()
+                : {
+                    emit: () => {
+                        if (refresh.stdout.trim())
+                            io.writers.out(`${refresh.stdout.replace(/\n$/, '')}\n`);
+                        io.writers.out(`skills update: ok (${targets.join(', ')}) — refreshed + pruned\n`);
+                    },
+                };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        // Refresh succeeded but prune failed → degraded (exit 0): latest IS installed, but
+        // renamed copies may linger. Honest, recoverable — re-run the prune by hand.
+        const envelope = formatDegraded('skills', {
+            ...baseData,
+            prune_failed: true,
+            prune_stderr_tail: prune.stderr.slice(-MAX_STDERR_TAIL),
+        }, `Refreshed to latest, but pruning renamed skills failed (exit ${prune.code}). Re-run the prune manually: ${pruneCommand}`, deps.clock);
+        const port = io.mode === 'json'
+            ? jsonPort()
+            : {
+                emit: (e) => {
+                    if (refresh.stdout.trim())
+                        io.writers.out(`${refresh.stdout.replace(/\n$/, '')}\n`);
+                    if (prune.stderr.trim())
+                        io.writers.err(`${prune.stderr.replace(/\n$/, '')}\n`);
+                    io.writers.out(`skills update: refreshed (${targets.join(', ')}); prune incomplete\n`);
+                    if (e.next_action)
+                        io.writers.err(`  → ${e.next_action}\n`);
+                },
+            };
+        exitWithEnvelope(envelope, port);
+    });
+}
+//# sourceMappingURL=skills.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { Command } from 'commander';
+import type { Clock } from '../adapters/clock/clock-port.js';
+import type { EnvPort } from '../adapters/env/env-port.js';
+import type { ExecPort } from '../adapters/exec/exec-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 `update`/`self-install` acts inject — a subset of VerbActDeps (no git). */
+export interface UpdateActDeps {
+    exec: ExecPort;
+    fs: FsPort;
+    env: EnvPort;
+    clock: Clock;
+    proc: ProcessPort;
+}
+/**
+ * Register `harness update` (+ `--check` / `--pin` / `--target`) and `self-install`.
+ * CORE commands that keep the globally-installed CLI current from the GitHub
+ * Packages release (plan 018) AND reconcile this harness's skills. Every `update`
+ * envelope carries a `skills` sub-object: report-only without `--target`,
+ * refreshed+pruned with it. `installed` is the running version.
+ */
+export declare function registerUpdateAct(program: Command, io: CliIo, deps: UpdateActDeps, installed: string): void;

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

@@ -0,0 +1,297 @@
+import { NodeVersionLookup } from '../adapters/version-lookup/node-version-lookup.js';
+import { formatDegraded, formatError, formatOk } 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 { DEFAULT_SKILLS_SOURCE, KNOWN_SKILL_TARGETS, LEGACY_SKILL_SLUGS, } from '../services/skills/contract.js';
+import { buildInstallArgv, buildRemoveArgv, formatInstallCommand, } from '../services/skills/skills-service.js';
+import { PACKAGE_NAME } from '../services/update/constants.js';
+import { classifyInstallFailure, formatNpmCommand, normalizePin, npmInstallArgv, } from '../services/update/install.js';
+import { isValidVersion } from '../services/update/semver.js';
+import { runCheck } from '../services/update/update-service.js';
+const MAX_STDERR_TAIL = 800;
+const severity = (s) => s === 'error' ? 3 : s === 'unconfigured' ? 2 : s === 'degraded' ? 1 : 0;
+const worst = (a, b) => (severity(a) >= severity(b) ? a : b);
+/**
+ * Run a global `npm i -g <pkg>@<spec>` and build the outcome (no exit). Announces
+ * the exact command first (human → stderr), shells ONLY through the injected
+ * ExecPort, and maps a failure via `classifyInstallFailure` (AC10).
+ */
+async function runNpmInstall(io, deps, commandName, installed, spec, installedAfter) {
+    const argv = npmInstallArgv(spec);
+    const command = formatNpmCommand(argv);
+    if (io.mode !== 'json') {
+        io.writers.err(`harness ${commandName} — about to run:\n  ${command}\n`);
+    }
+    const result = await deps.exec.run('npm', argv, { cwd: deps.proc.cwd() });
+    if (result.ok) {
+        return {
+            status: 'ok',
+            data: { installed_before: installed, installed_after: installedAfter, command },
+            next_action: `Done. Verify with \`harness --version\`${installedAfter ? ` (expecting ${installedAfter})` : ''}.`,
+            summary: `${commandName}: ok${installedAfter ? ` (${installedAfter})` : ''}`,
+            stdout: result.stdout,
+        };
+    }
+    const failure = classifyInstallFailure(result, command, spec === 'latest' ? undefined : { pinned: spec });
+    return {
+        status: 'error',
+        data: { command },
+        error: {
+            code: failure.code,
+            message: failure.message,
+            details: { command, stderr_tail: result.stderr.slice(-MAX_STDERR_TAIL) },
+        },
+        next_action: failure.next_action,
+        summary: `${commandName}: failed`,
+        stderr: result.stderr,
+    };
+}
+/** Emit a single binary envelope (self-install, and the update error-early path), then exit. */
+function emitBinary(io, deps, commandName, o) {
+    const jsonPort = () => createOutputPort('json', io.writers);
+    if (o.status === 'error' && o.error) {
+        const envelope = formatError(commandName, o.error.code, o.error.message, deps.clock, {
+            next_action: o.next_action,
+            details: o.error.details,
+        });
+        const port = io.mode === 'json'
+            ? jsonPort()
+            : {
+                emit: (e) => {
+                    if (o.stderr?.trim())
+                        io.writers.err(`${o.stderr.replace(/\n$/, '')}\n`);
+                    io.writers.err(`harness ${commandName}: ${e.error?.message ?? 'failed'}\n`);
+                    if (e.next_action)
+                        io.writers.err(`  → ${e.next_action}\n`);
+                },
+            };
+        exitWithEnvelope(envelope, port);
+        return;
+    }
+    const envelope = formatOk(commandName, o.data, deps.clock, { next_action: o.next_action });
+    const port = io.mode === 'json'
+        ? jsonPort()
+        : {
+            emit: () => {
+                if (o.stdout?.trim())
+                    io.writers.out(`${o.stdout.replace(/\n$/, '')}\n`);
+                io.writers.out(`${o.summary}\n`);
+            },
+        };
+    exitWithEnvelope(envelope, port);
+}
+/**
+ * The skills half of `harness update`. With `--target` (and not `--check`) it
+ * reconciles via the EXISTING skills-update path — refresh (`npx skills add`)
+ * then prune the legacy slugs (`npx skills remove`), reusing the already-exported
+ * helpers (KF-05). Refresh-fail ⇒ error; prune-fail ⇒ degraded. Without a target
+ * (or under `--check`) it is REPORT-ONLY: it mutates nothing, lists the prune
+ * candidates, and suggests the exact command (AC13/AC14).
+ */
+async function skillsOutcome(io, deps, opts) {
+    const targets = opts.target ?? [];
+    const global = Boolean(opts.global);
+    const reconcile = !opts.check && targets.length > 0;
+    if (!reconcile) {
+        return {
+            status: 'ok',
+            skills: {
+                reconciled: false,
+                prune_candidates: [...LEGACY_SKILL_SLUGS],
+                suggested_command: 'harness skills update --target <cli>',
+            },
+            next_action: `To also refresh + prune this harness's skills, run: harness skills update --target <cli> (targets: ${KNOWN_SKILL_TARGETS.join(', ')}).`,
+            summary: `skills: report-only — run \`harness skills update --target <cli>\` to refresh + prune (${LEGACY_SKILL_SLUGS.length} legacy slugs tracked)`,
+        };
+    }
+    const refreshArgv = buildInstallArgv({ source: DEFAULT_SKILLS_SOURCE, targets, global });
+    const refreshCommand = formatInstallCommand(refreshArgv);
+    const pruneArgv = buildRemoveArgv({ slugs: [...LEGACY_SKILL_SLUGS], targets, global });
+    const pruneCommand = formatInstallCommand(pruneArgv);
+    if (io.mode !== 'json') {
+        io.writers.err(`harness update — reconciling skills:\n  ${refreshCommand}\n  ${pruneCommand}\n`);
+    }
+    const cwd = deps.proc.cwd();
+    // Refresh first; if it fails we DON'T prune (existing skills stay intact).
+    const refresh = await deps.exec.run('npx', refreshArgv, { cwd });
+    if (!refresh.ok) {
+        return {
+            status: 'error',
+            skills: {
+                reconciled: true,
+                refreshed: false,
+                pruned: false,
+                targets,
+                global,
+                refresh_command: refreshCommand,
+                stderr_tail: refresh.stderr.slice(-MAX_STDERR_TAIL),
+            },
+            next_action: `Skills refresh failed (exit ${refresh.code}); skills left unchanged. Re-run: ${refreshCommand}`,
+            summary: `skills: refresh failed (${targets.join(', ')})`,
+        };
+    }
+    const prune = await deps.exec.run('npx', pruneArgv, { cwd });
+    if (prune.ok) {
+        return {
+            status: 'ok',
+            skills: {
+                reconciled: true,
+                refreshed: true,
+                pruned: true,
+                targets,
+                global,
+                refresh_command: refreshCommand,
+                prune_command: pruneCommand,
+                pruned_candidates: [...LEGACY_SKILL_SLUGS],
+            },
+            next_action: `Skills reconciled for ${targets.join(', ')} (refreshed + pruned).`,
+            summary: `skills: reconciled (${targets.join(', ')}) — refreshed + pruned`,
+        };
+    }
+    return {
+        status: 'degraded',
+        skills: {
+            reconciled: true,
+            refreshed: true,
+            pruned: false,
+            targets,
+            global,
+            refresh_command: refreshCommand,
+            prune_command: pruneCommand,
+            prune_stderr_tail: prune.stderr.slice(-MAX_STDERR_TAIL),
+        },
+        next_action: `Skills refreshed but prune failed (exit ${prune.code}). Re-run the prune: ${pruneCommand}`,
+        summary: `skills: refreshed (${targets.join(', ')}); prune incomplete`,
+    };
+}
+/** Compute the binary (CLI) outcome for the chosen mode (--check / --pin / bare). */
+async function binaryOutcome(io, deps, installed, opts) {
+    const lookup = new NodeVersionLookup(deps.exec, PACKAGE_NAME, deps.proc.cwd());
+    if (opts.check) {
+        const result = await runCheck({ fs: deps.fs, env: deps.env, clock: deps.clock, lookup }, installed, {
+            force: true,
+        });
+        const available = result.update_available !== null;
+        return {
+            status: 'ok',
+            data: { installed, latest: result.latest, update_available: available },
+            next_action: available
+                ? `A newer version (${result.latest}) is available. Run \`harness update\` to upgrade.`
+                : result.latest
+                    ? `You are on the latest version (${installed}).`
+                    : 'Could not determine the latest version (registry unreachable or auth missing).',
+            summary: `update --check: installed ${installed}, latest ${result.latest ?? 'unknown'}${available ? ' — update available' : ''}`,
+        };
+    }
+    if (opts.pin) {
+        const spec = normalizePin(opts.pin);
+        // --pin is for ONE concrete version (AC3). Reject dist-tags like `latest`/
+        // `canary` — bare `harness update` is the way to track @latest (companion F005).
+        if (!isValidVersion(spec)) {
+            return {
+                status: 'error',
+                data: { pin: opts.pin },
+                error: {
+                    code: ErrorCodes.INVALID_ARGS,
+                    message: `--pin needs a concrete version (e.g. v0.3.0), not '${opts.pin}'.`,
+                },
+                next_action: `Pass an exact version: harness update --pin v0.3.0 (run harness update --check for the latest, or bare harness update to track @latest).`,
+                summary: `update --pin: invalid version '${opts.pin}'`,
+            };
+        }
+        return runNpmInstall(io, deps, 'update', installed, spec, spec);
+    }
+    const result = await runCheck({ fs: deps.fs, env: deps.env, clock: deps.clock, lookup }, installed, {
+        force: true,
+    });
+    if (result.latest && result.update_available === null) {
+        const command = formatNpmCommand(npmInstallArgv('latest'));
+        return {
+            status: 'ok',
+            data: {
+                installed_before: installed,
+                installed_after: installed,
+                command,
+                already_latest: true,
+            },
+            next_action: `Already on the latest version (${installed}).`,
+            summary: `update: already on latest (${installed})`,
+        };
+    }
+    return runNpmInstall(io, deps, 'update', installed, 'latest', result.latest);
+}
+/**
+ * Register `harness update` (+ `--check` / `--pin` / `--target`) and `self-install`.
+ * CORE commands that keep the globally-installed CLI current from the GitHub
+ * Packages release (plan 018) AND reconcile this harness's skills. Every `update`
+ * envelope carries a `skills` sub-object: report-only without `--target`,
+ * refreshed+pruned with it. `installed` is the running version.
+ */
+export function registerUpdateAct(program, io, deps, installed) {
+    program
+        .command('update')
+        .description('Update the globally-installed harness CLI from the registry (and reconcile skills with --target)')
+        .option('--check', 'check for a newer version without installing (exit 0)')
+        .option('--pin <version>', 'install one exact version (e.g. v0.3.0), not persisted')
+        .option('-t, --target <cli...>', `also reconcile skills for CLI target(s): ${KNOWN_SKILL_TARGETS.join(', ')}`)
+        .option('-g, --global', 'with --target: reconcile the global skills install')
+        .action(async (opts) => {
+        const binary = await binaryOutcome(io, deps, installed, opts);
+        // Binary failure → pure error envelope; skip skills (fix the CLI update first).
+        if (binary.status === 'error') {
+            emitBinary(io, deps, 'update', binary);
+            return;
+        }
+        const skills = await skillsOutcome(io, deps, opts);
+        const status = worst(binary.status, skills.status);
+        const data = { ...binary.data, skills: skills.skills };
+        const jsonPort = () => createOutputPort('json', io.writers);
+        // Skills refresh failed → error/1 (AC14), with the combined data in details.
+        if (status === 'error') {
+            const envelope = formatError('update', ErrorCodes.SKILLS_INSTALL_FAILED, 'the CLI is current, but the skills refresh failed.', deps.clock, { next_action: skills.next_action, details: data });
+            const port = io.mode === 'json'
+                ? jsonPort()
+                : {
+                    emit: (e) => {
+                        io.writers.out(`${binary.summary}\n`);
+                        io.writers.err(`harness update: ${e.error?.message ?? 'failed'}\n`);
+                        if (e.next_action)
+                            io.writers.err(`  → ${e.next_action}\n`);
+                    },
+                };
+            exitWithEnvelope(envelope, port);
+            return;
+        }
+        const next_action = status === 'degraded'
+            ? skills.next_action
+            : [binary.next_action, skills.next_action].filter(Boolean).join(' · ');
+        const envelope = status === 'degraded'
+            ? formatDegraded('update', data, next_action, deps.clock)
+            : formatOk('update', data, deps.clock, { next_action });
+        const port = io.mode === 'json'
+            ? jsonPort()
+            : {
+                emit: () => {
+                    if (binary.stdout?.trim())
+                        io.writers.out(`${binary.stdout.replace(/\n$/, '')}\n`);
+                    io.writers.out(`${binary.summary}\n`);
+                    io.writers.out(`${skills.summary}\n`);
+                    if (next_action)
+                        io.writers.err(`→ ${next_action}\n`);
+                },
+            };
+        exitWithEnvelope(envelope, port);
+    });
+    program
+        .command('self-install')
+        .description('Install the harness CLI globally from the registry (first-time bootstrap)')
+        .action(async () => {
+        // Convenience global install from the public npm registry. A registry or
+        // transport failure surfaces as a classified error + next_action via
+        // classifyInstallFailure (AC4/AC10). No skills phase.
+        const o = await runNpmInstall(io, deps, 'self-install', installed, 'latest', null);
+        emitBinary(io, deps, 'self-install', o);
+    });
+}
+//# sourceMappingURL=update.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { Command } from 'commander';
+import type { Clock } from '../adapters/clock/clock-port.js';
+import type { EnvPort } from '../adapters/env/env-port.js';
+import type { ExecPort } from '../adapters/exec/exec-port.js';
+import type { FsPort } from '../adapters/fs/fs-port.js';
+import type { GitPort } from '../adapters/git/git-port.js';
+import type { ProcessPort } from '../adapters/process/process-port.js';
+import { type CliIo } from '../output/output-port.js';
+import type { HarnessVerb } from '../services/extensions/contract.js';
+/** The ports a verb act needs: the ctx ports + the process port for cwd. */
+export interface VerbActDeps {
+    exec: ExecPort;
+    fs: FsPort;
+    env: EnvPort;
+    git: GitPort;
+    clock: Clock;
+    proc: ProcessPort;
+}
+/**
+ * Register ONE extension verb as a top-level `harness <verb>` subcommand. Thin:
+ * it maps the declarative `HarnessVerb` onto commander (name, description,
+ * options, args), and its action parses opts/args → builds the `VerbContext`
+ * (cwd from the process port) → `await runVerb` → exits via the kernel (so the
+ * status→exit mapping + `process.exit` confinement are unchanged). No business
+ * logic lives here. Returns the created Command (usage is inspectable).
+ */
+export declare function registerVerbAct(program: Command, verb: HarnessVerb, deps: VerbActDeps, io: CliIo): Command;