harnery 0.46.1 → 0.47.0

package/dist/commands/autoupdate.js

@@ -0,0 +1,190 @@
+// `autoupdate`: inspect and drive project self-update (ADR 0229). The engine
+// lives in src/core/autoupdate/; this command owns flag parsing, human/JSON
+// rendering, and exit codes. `run --background` is what the activity tick
+// launches; people and agents use `status`, `check`, and `run`.
+import { resolveCoordRoot } from "../core/agents/coord-client.js";
+import { autoUpdateStatus, checkForUpdate, runAutoUpdate, } from "../core/autoupdate/engine.js";
+import { readAutoUpdateState } from "../core/autoupdate/state.js";
+import { AUTOUPDATE_DEFAULTS, EXIT_NEEDS_PERSON, } from "../core/autoupdate/types.js";
+import { readAutoUpdateConfig } from "../core/config.js";
+const DAY_MS = 24 * 60 * 60 * 1000;
+function emitLine(emit, s) {
+    emit.text(s.endsWith("\n") ? s : `${s}\n`);
+}
+function short(sha) {
+    return sha ? sha.slice(0, 7) : "none";
+}
+function formatDuration(ms) {
+    const minutes = Math.round(ms / 60_000);
+    if (minutes < 1)
+        return "under a minute";
+    if (minutes < 120)
+        return `${minutes} min`;
+    return `${Math.round(minutes / 60)} h`;
+}
+export function exitCodeForOutcome(outcome) {
+    if (outcome === "failed")
+        return 1;
+    if (outcome === "blocked")
+        return EXIT_NEEDS_PERSON;
+    return 0;
+}
+export function registerAutoUpdateCommand(program, emit, binName, options = {}) {
+    const root = options.root ?? (() => resolveCoordRoot() ?? process.cwd());
+    const deps = options.deps ?? {};
+    const guard = (fn) => async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (err) {
+            emit.error({ code: "autoupdate_error", message: err?.message ?? String(err) });
+            emit.setExitCode(1);
+        }
+    };
+    const cmd = program
+        .command("autoupdate")
+        .description("Project self-update: activity checks the upstream branch and watched paths, and runs " +
+        "the steps configured in .harnery/config.jsonc `autoUpdate` only when something changed.")
+        .addHelpText("after", `\nEnable per project with "autoUpdate": { "enabled": true, "steps": [[...]] } in .harnery/config.jsonc.\n` +
+        `Exit codes: 0 current/updated · 1 failed · ${EXIT_NEEDS_PERSON} blocked (needs a person).\n` +
+        `Start with \`${binName} autoupdate status\`.`);
+    cmd
+        .command("status")
+        .description("Show configuration, the last run, the converged head, notices, and the next check.")
+        .option("--json", "Emit the status as JSON.")
+        .action(guard((opts) => {
+        const status = autoUpdateStatus(root(), deps);
+        const now = (deps.now ?? Date.now)();
+        const recent = status.state.notices.filter((n) => now - Date.parse(n.at) < DAY_MS).length;
+        if (opts.json) {
+            emit.data({
+                enabled: status.config?.enabled ?? false,
+                config: status.config,
+                lastRun: status.state.lastRun ?? null,
+                converged: status.state.converged ?? null,
+                dailyAt: status.state.dailyAt ?? null,
+                cleanupAt: status.state.cleanupAt ?? null,
+                notices: status.state.notices.length,
+                recentNotices: recent,
+                stampAgeMs: status.stampAge,
+                nextCheckMs: status.nextCheckMs,
+                lock: status.locked.held
+                    ? {
+                        owner: status.locked.owner,
+                        stale: status.locked.stale,
+                        ageMs: status.locked.ageMs,
+                    }
+                    : null,
+            });
+            return;
+        }
+        const cfg = status.config;
+        const lines = [];
+        if (!cfg) {
+            lines.push("Auto-update is not configured (no `autoUpdate` section in .harnery/config.jsonc).");
+            emitLine(emit, lines.join("\n"));
+            return;
+        }
+        lines.push(`Enabled: ${cfg.enabled ? "yes" : "no"}`);
+        lines.push(`Check every: ${cfg.checkMinutes} min`);
+        lines.push(`Steps: ${cfg.steps.length ? cfg.steps.map((s) => s.join(" ")).join("; ") : "none"}`);
+        if (cfg.dailySteps.length) {
+            lines.push(`Daily steps: ${cfg.dailySteps.map((s) => s.join(" ")).join("; ")}`);
+        }
+        const last = status.state.lastRun;
+        if (last) {
+            lines.push(`Last run: ${last.outcome} (${last.reason}) at ${last.finishedAt}, ${short(last.fromHead)} -> ${short(last.toHead)}`);
+            if (last.error)
+                lines.push(`Last error: ${last.error}`);
+        }
+        else {
+            lines.push("Last run: never");
+        }
+        lines.push(`Converged head: ${short(status.state.converged?.head)}`);
+        lines.push(`Notices in the last 24 h: ${recent}`);
+        if (status.locked.held) {
+            const owner = status.locked.owner;
+            lines.push(`Running now: ${owner ? `pid ${owner.pid} since ${owner.at}` : "lock held"}${status.locked.stale ? " (stale)" : ""}`);
+        }
+        if (cfg.enabled) {
+            lines.push(`Next check: ${status.nextCheckMs ? `in ${formatDuration(status.nextCheckMs)}` : "due on the next activity"}`);
+        }
+        emitLine(emit, lines.join("\n"));
+    }));
+    cmd
+        .command("check")
+        .description("Decide whether an update is needed without running any step.")
+        .option("--json", "Emit the decision as JSON.")
+        .action(guard((opts) => {
+        const projectRoot = root();
+        const cfg = (deps.readConfig ?? readAutoUpdateConfig)(projectRoot);
+        if (!cfg) {
+            if (opts.json)
+                emit.data({ needed: false, reason: "disabled" });
+            else
+                emitLine(emit, "Auto-update is not configured.");
+            return;
+        }
+        const decision = checkForUpdate(projectRoot, cfg, readAutoUpdateState(projectRoot), deps);
+        if (opts.json) {
+            emit.data(decision);
+            return;
+        }
+        emitLine(emit, [
+            `${decision.needed ? "Update needed" : "No update needed"}: ${decision.reason}${decision.detail ? ` (${decision.detail})` : ""}`,
+            `Head: ${short(decision.head)}${decision.upstream ? ` · upstream ${decision.upstream} at ${short(decision.remoteSha)}` : ""}`,
+            ...(cfg.enabled ? [] : ["Auto-update is disabled; activity will not run it."]),
+        ].join("\n"));
+    }));
+    cmd
+        .command("run")
+        .description("Run the configured steps now if an update is needed (or always with --force).")
+        .option("--force", "Run the steps even when the checkout is current.")
+        .option("--background", "Write output to the log only (used by the activity tick).")
+        .option("--json", "Emit the run result as JSON.")
+        .action(guard(async (opts) => {
+        const projectRoot = root();
+        const result = await runAutoUpdate(projectRoot, {
+            force: opts.force,
+            background: opts.background,
+            deps,
+            onOutput: opts.background
+                ? undefined
+                : (chunk, stream) => {
+                    // Keep stdout clean for --json.
+                    const out = opts.json || stream === "stderr" ? process.stderr : process.stdout;
+                    out.write(chunk);
+                },
+        });
+        emit.setExitCode(exitCodeForOutcome(result.outcome));
+        if (opts.json) {
+            emit.data({
+                outcome: result.outcome,
+                decision: result.decision,
+                record: result.record,
+                notices: result.notices,
+                ...(result.outcome === "skipped-locked" ? { lockOwner: result.lockOwner ?? null } : {}),
+            });
+            return;
+        }
+        if (result.outcome === "skipped-locked") {
+            const owner = result.lockOwner;
+            emitLine(emit, `Another auto-update run holds the lock${owner ? ` (pid ${owner.pid} since ${owner.at})` : ""}; skipped.`);
+            return;
+        }
+        if (!result.record) {
+            emitLine(emit, `Auto-update is disabled; pass --force to run the steps anyway or enable it in .harnery/config.jsonc.`);
+            return;
+        }
+        const r = result.record;
+        const lines = [
+            `Auto-update ${r.outcome} (${r.reason}): ${short(r.fromHead)} -> ${short(r.toHead)}, ${r.steps.length} step(s).`,
+        ];
+        for (const n of result.notices)
+            lines.push(`notice [${n.kind}]: ${n.text}`);
+        if (r.outcome === "failed") {
+            lines.push(`Next automatic attempt after ${AUTOUPDATE_DEFAULTS.failureBackoffMinutes} min; run \`${binName} autoupdate run\` to retry now.`);
+        }
+        emitLine(emit, lines.join("\n"));
+    }));
+}

package/dist/commands/computer.d.ts

@@ -0,0 +1,45 @@
+import { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+import { type ComputerProjectConfig } from "../core/config.js";
+import type { DesktopDriver, HostInfo, LeaseApi, LeaseOwner } from "../lib/computer/types.js";
+/** Exit code for a desktop held by another agent. */
+export declare const EXIT_LEASE_HELD = 3;
+/** `call` waits this long for another agent's lease when nothing overrides it. */
+export declare const DEFAULT_CALL_WAIT_SECONDS = 30;
+/** Everything the command touches outside itself; tests inject fakes. */
+export interface ComputerDeps {
+    emit: EmitContext;
+    binName: string;
+    host: () => HostInfo;
+    driver: DesktopDriver;
+    lease: LeaseApi;
+    owner: () => LeaseOwner;
+    config: () => ComputerProjectConfig;
+    /** Lease directory for a desktop state dir. */
+    leaseDir: (desktopStateDir: string) => string;
+    /** Idle expiry when config sets none. */
+    defaultIdleMs: number;
+    /** Driver stderr passthrough. */
+    writeStderr: (text: string) => void;
+    now: () => number;
+}
+export type ComputerDepsInput = Pick<ComputerDeps, "emit" | "binName"> & Partial<ComputerDeps>;
+/**
+ * Who is asking for the desktop: the coordinated agent when one is resolvable,
+ * else the calling OS user (`shell:<user>@<hostname>`, label `shell-<user>`), so
+ * separate shell invocations by the same person share one lease.
+ */
+export declare function resolveLeaseOwner(): LeaseOwner;
+/**
+ * Replace inline base64 screenshots in driver output with a short note, so a
+ * single state read cannot flood the calling agent's context. Works on the raw
+ * text, so the driver's formatting survives.
+ */
+export declare function redactInlineScreenshots(stdout: string): string;
+/**
+ * Build the `computer` command tree under `parent` (a fresh root when omitted)
+ * and return it. Tests pass fakes for host/driver/lease/owner/config.
+ */
+export declare function createComputerCommand(input: ComputerDepsInput, parent?: Command): Command;
+export declare function registerComputerCommand(program: Command, emit: EmitContext, binName: string): void;
+//# sourceMappingURL=computer.d.ts.map

package/dist/commands/computer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer.d.ts","sourceRoot":"","sources":["../../src/commands/computer.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,KAAK,qBAAqB,EAAsB,MAAM,mBAAmB,CAAC;AACnF,OAAO,KAAK,EAEV,aAAa,EAGb,QAAQ,EACR,QAAQ,EAER,UAAU,EACX,MAAM,0BAA0B,CAAC;AAElC,qDAAqD;AACrD,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,QAAQ,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,UAAU,CAAC;IACxB,MAAM,EAAE,MAAM,qBAAqB,CAAC;IACpC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE/F;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAgB9C;AA8ID;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM9D;AAkGD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,EACxB,MAAM,GAAE,OAAuB,GAC9B,OAAO,CAsVT;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN"}