vinta-ai-maestro 0.7.0-alpha21 → 0.7.0-alpha23

package/README.md

@@ -60,7 +60,7 @@ pnpm install
 That is the development setup. To *use* it, there is no clone at all — the package is published:
 
 ```bash
-npx vinta-ai-maestro@alpha serve
+npx vinta-ai-maestro@alpha ui
 ```
 
 `@alpha` while the only published versions are pre-releases. Plain `npx vinta-ai-maestro` resolves the `latest` dist-tag, which is correct once a stable exists.
@@ -80,15 +80,20 @@ The published binary is a different file — `dist/cli/bin.js`, plain JavaScript
 
 Every command runs against a project checkout — your project, not this one. `--repo <dir>` names it; with no flag it is the current directory.
 
-## The six commands
+## The commands
 
 | Command | What it does |
 |---|---|
 | `doctor <workflow.json> [--repo <dir>] [--resume <run-id>]` | Preflights every check a run depends on and exits non-zero if a run cannot start. `--resume` asks the question for `run --resume <run-id>`: that run's own lanes are holding its phase branches on purpose, and are not leftovers to clear. |
 | `simulate <workflow.json>` | Projects the schedule without running it — wall clock, critical path, pool contention. Spawns no agent. |
-| `serve [--repo <dir>] [--host <host>] [--port <n>]` | Starts the daemon and prints the URL to open. Its editor edits `<repo>/ai-plans/*.workflow.json`. |
-| `run <workflow.json> [--repo <dir>] [--host <host>] [--port <n>]` | Starts the daemon *and* executes the workflow. Exits when the run ends. |
-| `purge [run-id] [--repo <dir>] [--yes] [--dry-run]` | Deletes run state under `.vinta-ai-maestro/runs/`. |
+| `run <workflow.json> [--repo <dir>]` | Starts the workflow as a **background job** and returns once it is under way. The run does not need the terminal: close it and the run carries on. `--foreground` hosts it in this process instead and exits when it ends, for CI. |
+| `run --resume <run-id>` | Picks an interrupted or paused run back up, as a background job. |
+| `status [run-id] [--json]` | Every run in the project and what it is doing — or one run, phase by phase. A run whose job died without ending it shows as `interrupted`. |
+| `logs <run-id> [-f] [-n <lines>]` | The run's job log: what `run` used to print to the terminal, plus its daemon's records. `-f` follows it until the job exits. |
+| `pause <run-id> [--wait]` | Nothing new starts; each running phase finishes the step it is in, then the job exits. The run is `paused`, its lanes intact, and `run --resume` continues it. |
+| `stop <run-id> [--wait]` | Kills every live agent turn and gate now. The run is `cancelled` and cannot be resumed. |
+| `ui [--repo <dir>] [--host <host>] [--port <n>]` | Serves the browser UI for every run in the project and prints the URL to open. Runs are not hosted here — close it whenever you like. A run started from its editor is launched as a background job. `serve` is the same command. |
+| `purge [run-id] [--repo <dir>] [--yes] [--dry-run]` | Deletes run state under `.vinta-ai-maestro/runs/`. A run whose job is still running is kept. |
 | `with <resource> -- <cmd>` | Inside an agent turn, waits for a semaphore resource, runs the command, and releases it. The live run supplies its daemon connection through the lane environment. |
 | `gate <gate-id>` | Inside an agent turn, asks the daemon to run one of the plan's declared gates against this turn's lane. The daemon holds the gate's resources and caches the result; the CLI exits with the gate's exit code. |
 
@@ -96,6 +101,14 @@ There is also `judge-hook`, which is internal: it is the hook `--permission judg
 
 `--port` defaults to `0`, an OS-assigned port printed with the URL. `--host` defaults to `127.0.0.1` — see [The URL is the credential](#the-url-is-the-credential). `vinta-ai-maestro <command> --help` prints the command's own options.
 
+### A run is a background job
+
+`run` hands the run to a detached copy of itself — the run's *job* — and returns as soon as the job says the run has started. The job is the run's only host: it holds the scheduler, the agents, and a loopback API the agents call back into (`with`, `gate`). It writes `.vinta-ai-maestro/runs/<run-id>/job.json` — its pid, that API's address and its token — and every other command finds the run through that file. It serves no UI.
+
+`ui` is the browser's way in. It reads every run's history from the journal, and for a run whose job is alive it forwards that run's requests and socket to the job, so the live graph, steering, answering a question and taking over a terminal all work as if the two were one process. Close `ui` and the runs carry on; open it tomorrow and it shows them where they got to.
+
+A run ends one of four ways, and the journal says which: it settles (`done` or `failed`), it is paused (`paused`, resumable), it is stopped (`cancelled`, final), or its job is killed by a signal (`failed`, resumable — exactly what closing the terminal used to do). `status` shows a run whose job vanished without writing any of those — a reboot, a `kill -9` — as `interrupted`, and `run --resume` picks it up.
+
 The daemon-facing commands use three exit codes, so a script can tell the cases
 apart: `0` success, `1` the command ran and the answer was no, `2` the command
 line was wrong. `with` and `gate` pass through the exit code of the thing they
@@ -304,10 +317,10 @@ A repository with two phases that depend on nothing, so both belong to wave 1 an
 
   Scope it to what your phases actually need; this is the permissive end.
 
-**3. Review and approve it in the editor.** `serve` opens the daemon with no run attached. Its Editor lists every `ai-plans/*.workflow.json` in the project — the file you just wrote, or the one `plan-feature` wrote — and saving writes back to that same file:
+**3. Review and approve it in the editor.** `ui` serves the browser UI for the project. Its Editor lists every `ai-plans/*.workflow.json` in the project — the file you just wrote, or the one `plan-feature` wrote — and saving writes back to that same file:
 
 ```console
-$ vinta-ai-maestro serve
+$ vinta-ai-maestro ui
 vinta-ai-maestro: daemon listening on http://127.0.0.1:52218
 Open this URL. It carries the access token, so treat it as a secret:
   http://127.0.0.1:52218/?token=<the-token-printed-here>
@@ -370,13 +383,16 @@ Both phases start at `0s` — that is the parallelism the plan claimed, confirme
 
 ```console
 $ vinta-ai-maestro run ai-plans/widget-tags.workflow.json
-vinta-ai-maestro: daemon listening on http://127.0.0.1:52765
-Open this URL. It carries the access token, so treat it as a secret:
-  http://127.0.0.1:52765/?token=<the-token-printed-here>
-vinta-ai-maestro: run widget-tags-mtvodosx started (2 nodes).
+vinta-ai-maestro: starting run widget-tags-mtvodosx in the background…
+vinta-ai-maestro: run widget-tags-mtvodosx started (job pid 48213).
+  status   vinta-ai-maestro status widget-tags-mtvodosx
+  logs     vinta-ai-maestro logs widget-tags-mtvodosx --follow
+  ui       vinta-ai-maestro ui
+  pause    vinta-ai-maestro pause widget-tags-mtvodosx
+  stop     vinta-ai-maestro stop widget-tags-mtvodosx
 ```
 
-The daemon comes up before the first node dispatches, so you can open the URL and watch. Both phases are assigned a lane immediately and implement concurrently, each in its own worktree under `.vinta-ai-maestro/lanes/`, on its own branch cut from `base_branch`:
+The command returns; the run does not need this terminal. The preflight is the job's — if it refuses, `run` prints the report and says the run did not start. Watch it from the terminal with `status` and `logs -f`, or keep `ui` open in another one and follow it in the browser. Both phases are assigned a lane immediately and implement concurrently, each in its own worktree under `.vinta-ai-maestro/lanes/`, on its own branch cut from `base_branch`:
 
 ```console
 $ git branch
@@ -388,7 +404,7 @@ $ git branch
   wt/widget-tags-mtvodosx-lane-2
 ```
 
-`plan/…/phase-<id>` is the phase's own branch; `wt/…` are the branches the lane and integration worktrees are checked out on. When the run ends, read [What this walkthrough has and has not been run against](#what-this-walkthrough-has-and-has-not-been-run-against) before you read the last two lines it prints.
+`plan/…/phase-<id>` is the phase's own branch; `wt/…` are the branches the lane and integration worktrees are checked out on. Need the machine back for an hour? `vinta-ai-maestro pause <run-id>` lets the phases finish the step they are in and ends the job; `vinta-ai-maestro run --resume <run-id>` carries on later. When the run ends, read [What this walkthrough has and has not been run against](#what-this-walkthrough-has-and-has-not-been-run-against) before you read the last two lines it prints.
 
 **7. Read what happened, then clean up.** A finished run leaves its worktrees, branches and databases in place on purpose — they are the evidence. The post-mortem is written at the end and is what `plan-feature` reads before drawing the next feature's graph:
 
@@ -420,6 +436,8 @@ Everything a run writes lives inside the project, never in a global cache direct
   logs/daemon.<n>.ndjson        # rotations, oldest pruned past five
   lanes/<lane>/                 # the lane worktrees, and .templates/ for forked DBs
   runs/<run-id>/
+    job.json                    # while the job runs: pid, API address, token (0600)
+    job.log                     # the job's console, every attempt appended
     workflow.json               # the snapshot frozen at run start
     postmortem.json             # written once the run has ended
     nodes/<node-id>/
@@ -448,10 +466,10 @@ It removes the run *directory* — snapshot, transcripts, raw streams, gate logs
 
 Transcripts say what the *agents* did. This says what the *daemon* did — which is the half you need when the answer is "nothing happened", "it stopped", or "the process is gone".
 
-It is a file and a view, and they show the same records:
+It is a file and a view, and they show the same records. Every process writes to the same file — each run's job and `ui` — and every record carries its `pid`. For one run's job alone, `vinta-ai-maestro logs <run-id>` is shorter:
 
 ```console
-$ vinta-ai-maestro serve
+$ vinta-ai-maestro ui
 vinta-ai-maestro: daemon listening on http://127.0.0.1:52765
 Open this URL. It carries the access token, so treat it as a secret:
   http://127.0.0.1:52765/?token=<the-token-printed-here>
@@ -505,9 +523,9 @@ Everything other than `message` is **identifiers only** — the rule `flow.db` f
 Flags:
 
 ```console
-$ vinta-ai-maestro serve --log-level debug   # adds a line per request and per socket
-$ vinta-ai-maestro serve --log-stderr        # also print to the terminal, one line each
-$ vinta-ai-maestro serve --log-detail kind   # drop error messages, keep kinds and frames
+$ vinta-ai-maestro ui --log-level debug   # adds a line per request and per socket
+$ vinta-ai-maestro ui --log-stderr        # also print to the terminal, one line each
+$ vinta-ai-maestro ui --log-detail kind   # drop error messages, keep kinds and frames
 ```
 
 `run` accepts the same three, and writes to the same file.
@@ -526,6 +544,8 @@ Open this URL. It carries the access token, so treat it as a secret:
 
 That line is the only place in this package's output where the token ever appears. It is not in the "listening on" line, not in warnings, not in errors — so pasting a log into a ticket is safe, and pasting *that* URL into a ticket publishes the run.
 
+Each run's job has a token of its own, which it is never printed: it is written to that run's `job.json`, readable by your user only, and removed when the job ends. `ui` reads it to forward a live run's traffic, and the browser never sees it — its requests carry `ui`'s token, which the job would refuse. Treat `job.json` like the URL: it is access to the run.
+
 **`--host` is explicit and warned about.** The default bind is `127.0.0.1`. Any other value makes the daemon reachable from other machines, and the daemon prints a warning naming the host — on stderr, where it cannot be mistaken for part of the URL. Anyone who can reach the daemon and holds the token can drive the run: there is no per-user access control, by design. Prefer an SSH port-forward to `--host` for a daemon on a bigger box.
 
 ## Harnesses
@@ -544,7 +564,7 @@ Point the adapter at a specific binary with an environment variable, which overr
 
 ### What an agent may do in its lane
 
-`--permission <ask|auto|full|judged>` on `run` and `serve`, defaulting to **`auto`**: the agent works unattended inside its own lane, which is what a lane is for.
+`--permission <ask|auto|full|judged>` on `run` and `ui` (for the runs it starts), defaulting to **`auto`**: the agent works unattended inside its own lane, which is what a lane is for.
 
 **The operator sets this, never the workflow document.** It is an argument to the command rather than a field in the JSON, and deliberately so — the document is committed and shared, and a file in a repository should not be able to tell someone else's machine to run agents without approvals. A plan may say which model writes a phase; it may not say how much of a stranger's filesystem that model gets.
 
@@ -555,7 +575,7 @@ Point the adapter at a specific binary with an environment variable, which overr
 | `full` | `--allow-dangerously-skip-permissions --permission-mode bypassPermissions` | `--dangerously-bypass-approvals-and-sandbox` |
 | `judged` | as `full`, plus a `PreToolUse` hook that asks a System One classifier about each judged call | refused by `doctor` |
 
-`ask` is the CLIs' own default and the one to avoid headlessly: nothing answers a permission prompt in a `run`. The request surfaces as a `permission_request` event and the transcript renders it, but no reply is ever sent — so the agent reports a blocked working directory and the phase fails having written nothing. Use it with `serve` and a human watching, or not at all.
+`ask` is the CLIs' own default and the one to avoid headlessly: nothing answers a permission prompt in a `run`. The request surfaces as a `permission_request` event and the transcript renders it, but no reply is ever sent — so the agent reports a blocked working directory and the phase fails having written nothing. Use it with `ui` open and a human watching, or not at all.
 
 `full` is available and is not the default. Both vendors describe their equivalent as being for sandboxes with no internet access, and a lane is not that — it has the network and whatever credentials the machine holds.
 
@@ -567,7 +587,7 @@ A lane is still a worktree of your repository, so committed settings travel into
 
 ## System One classifiers
 
-`--system-one <config.json>` on `run`, `serve` and `doctor` points a run at a fast classifier — one that answers yes/no or scores a fixed set of labels, and writes nothing. The file is the operator's and never part of the plan:
+`--system-one <config.json>` on `run`, `ui` and `doctor` points a run at a fast classifier — one that answers yes/no or scores a fixed set of labels, and writes nothing. The file is the operator's and never part of the plan:
 
 ```jsonc
 {
@@ -579,7 +599,7 @@ A lane is still a worktree of your repository, so committed settings travel into
 }
 ```
 
-`http` POSTs `{ kind, question, labels, input }` and reads `{ scores }` or `{ yes }` back, with the key from the environment variable you name (removed from the daemon's environment once read, so agents never see it). `command` runs a local program with the same JSON on stdin and stdout — the choice when repository content must not leave the machine, because a hosted classifier receives diffs, gate logs and shell commands.
+`http` POSTs `{ kind, question, labels, input }` and reads `{ scores }` or `{ yes }` back, with the key from the environment variable you name (removed from the daemon's environment once read, so agents never see it). Before a run starts, the preflight asks the classifier one synthetic question, so a missing or rejected key, or an unreachable URL, stops the run at minute zero instead of at the first gate. Set `"probe": false` to skip it. `doctor` also warns about an `http` adapter with no `api_key_env`, since that sends no `Authorization` header. `command` runs a local program with the same JSON on stdin and stdout — the choice when repository content must not leave the machine, because a hosted classifier receives diffs, gate logs and shell commands.
 
 A plan can then declare **judge gates** next to its command gates:
 

package/dist/cli/halt.js

@@ -0,0 +1,185 @@
+/**
+ * `vinta-ai-maestro pause <runId>` and `vinta-ai-maestro stop <runId>`.
+ *
+ * Both end a run before its DAG does, and both reach it the same way: through
+ * the run's own job, found by its `job.json` and asked over the API its agents
+ * already use. Not by signal — a signal means "interrupted" to the job, and on
+ * Windows there is no signal to send that the job could catch at all.
+ *
+ * - **pause** drains. No new phase starts, each running phase finishes the step
+ *   it is in, and the job exits with the run `paused` and every lane in place.
+ *   `run --resume` picks it up.
+ * - **stop** kills: every live agent turn and every running gate ends now, and
+ *   the run is `cancelled`, which `--resume` refuses.
+ *
+ * Both return as soon as the job has the request; `--wait` stays until it has
+ * exited. A pause can take as long as the longest step in flight.
+ *
+ * **When there is no job to ask.** A run whose job died is already as
+ * resumable as a pause would make it, so `pause` says so and changes nothing.
+ * `stop` still has something to do — make the run final — and does it
+ * directly in the journal. A job that is alive and not answering is the one
+ * case `stop` ends by force: its process tree is signalled, and the
+ * cancellation is written once it is gone.
+ */
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { isAlive, liveJob } from '../job/job.js';
+import { openJournal } from '../journal/journal.js';
+import { killTree } from '../platform/platform.js';
+import { FAILED, OK, USAGE } from './io.js';
+import { storeFor } from './paths.js';
+import { isResumable, runState } from './status.js';
+export const PAUSE_USAGE = `usage: vinta-ai-maestro pause <runId> [--repo <dir>] [--wait]
+
+  Pauses a running run. Nothing new starts; each running phase finishes the
+  step it is in — the agent turn or gate under way — and then the run's job
+  exits, leaving every lane as it was. Resume it with
+  \`vinta-ai-maestro run --resume <runId>\`.
+
+  --repo <dir>   The project. Defaults to the current directory.
+  --wait         Return once the job has exited, not once it has the request.`;
+export const STOP_USAGE = `usage: vinta-ai-maestro stop <runId> [--repo <dir>] [--wait]
+
+  Stops a run for good. Every live agent turn and every running gate is
+  killed, and the run ends "cancelled": it cannot be resumed. Lanes and
+  branches are left in place, as for any finished run. A paused or
+  interrupted run can be stopped too, which makes it final.
+
+  --repo <dir>   The project. Defaults to the current directory.
+  --wait         Return once the job has exited, not once it has the request.`;
+export const pauseCommand = (argv, io, deps = {}) => haltCommand('pause', argv, io, deps);
+export const stopCommand = (argv, io, deps = {}) => haltCommand('stop', argv, io, deps);
+async function haltCommand(mode, argv, io, deps) {
+    const usage = mode === 'pause' ? PAUSE_USAGE : STOP_USAGE;
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: [...argv],
+            options: { repo: { type: 'string' }, wait: { type: 'boolean' } },
+            allowPositionals: true,
+        });
+    }
+    catch {
+        io.err(usage);
+        return USAGE;
+    }
+    const runId = parsed.positionals[0];
+    if (runId === undefined || parsed.positionals.length > 1) {
+        io.err(usage);
+        return USAGE;
+    }
+    const repoPath = resolve(parsed.values.repo ?? process.cwd());
+    if (!existsSync(storeFor(repoPath))) {
+        io.err(`vinta-ai-maestro: no run "${runId}" in ${repoPath}`);
+        return FAILED;
+    }
+    const alive = deps.alive ?? isAlive;
+    const sleep = deps.sleep ?? ((ms) => new Promise((done) => setTimeout(done, ms)));
+    const journal = openJournal(repoPath);
+    try {
+        const row = journal.run(runId);
+        if (row === undefined) {
+            io.err(`vinta-ai-maestro: no run "${runId}" in ${repoPath}`);
+            return FAILED;
+        }
+        const job = liveJob(repoPath, runId, alive);
+        const state = runState(row, job);
+        if (job === null)
+            return haltUnhosted(mode, journal, runId, state, io);
+        const asked = await ask(job, mode, deps.fetch ?? fetch);
+        if (asked === 'unreachable') {
+            if (mode === 'pause') {
+                io.err(`vinta-ai-maestro: run ${runId}'s job (pid ${job.pid}) is not answering. ` +
+                    `\`vinta-ai-maestro stop ${runId}\` ends it regardless.`);
+                return FAILED;
+            }
+            return await forceStop(journal, runId, job, io, { alive, sleep, kill: deps.kill ?? signalTree });
+        }
+        if (asked === 'refused') {
+            io.err(`vinta-ai-maestro: run ${runId} is ${state}; there is nothing to ${mode}.`);
+            return FAILED;
+        }
+        io.out(mode === 'pause'
+            ? `vinta-ai-maestro: pausing run ${runId}. Running phases finish their current step, then the job exits.`
+            : `vinta-ai-maestro: stopping run ${runId}.`);
+        if (parsed.values.wait !== true) {
+            io.out(`vinta-ai-maestro: follow it with: vinta-ai-maestro logs ${runId} --follow`);
+            return OK;
+        }
+        while (alive(job.pid))
+            await sleep(250);
+        const ended = journal.run(runId)?.status ?? 'unknown';
+        io.out(`vinta-ai-maestro: run ${runId} is ${ended}.`);
+        return OK;
+    }
+    finally {
+        journal.close();
+    }
+}
+/** The run's own API, asked. `refused` is a 409: the run is not running. */
+async function ask(job, mode, fetchImpl) {
+    try {
+        const response = await fetchImpl(`${job.url}/api/runs/${encodeURIComponent(job.runId)}/${mode}`, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${job.token}`, 'content-type': 'application/json' },
+            body: '{}',
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (response.ok)
+            return 'accepted';
+        return response.status === 409 ? 'refused' : 'unreachable';
+    }
+    catch {
+        return 'unreachable';
+    }
+}
+function haltUnhosted(mode, journal, runId, state, io) {
+    if (state === 'done' || state === 'cancelled') {
+        io.err(`vinta-ai-maestro: run ${runId} already ended (${state}).`);
+        return FAILED;
+    }
+    if (mode === 'pause') {
+        // Nothing is running it, so there is nothing to drain — and it is already
+        // exactly as resumable as a pause would leave it.
+        io.err(`vinta-ai-maestro: run ${runId} is ${state} — nothing is running it, so there is nothing to pause.`);
+        if (isResumable(state))
+            io.err(`vinta-ai-maestro: resume it with: vinta-ai-maestro run --resume ${runId}`);
+        return FAILED;
+    }
+    journal.append({ runId, type: 'run_ended', payload: { status: 'cancelled' } });
+    io.out(`vinta-ai-maestro: run ${runId} cancelled (it was ${state}). It can no longer be resumed.`);
+    return OK;
+}
+/**
+ * A job that is alive and will not answer: ended from outside. SIGTERM first —
+ * the job's own handler records the run as interrupted — then SIGKILL if it
+ * will not go, and the cancellation written over whatever it managed to say.
+ */
+async function forceStop(journal, runId, job, io, deps) {
+    io.err(`vinta-ai-maestro: run ${runId}'s job (pid ${job.pid}) is not answering; ending it.`);
+    deps.kill(job.pid, 'SIGTERM');
+    for (let waited = 0; waited < 10_000 && deps.alive(job.pid); waited += 250)
+        await deps.sleep(250);
+    if (deps.alive(job.pid))
+        deps.kill(job.pid, 'SIGKILL');
+    journal.append({ runId, type: 'run_ended', payload: { status: 'cancelled' } });
+    io.out(`vinta-ai-maestro: run ${runId} cancelled.`);
+    // Agents and gates lead process groups of their own, which a job killed from
+    // outside never got the chance to end.
+    io.err('vinta-ai-maestro: agent or gate processes it started may still be running.');
+    return OK;
+}
+/** The job leads its own session (it was spawned detached), so its group is its tree. */
+function signalTree(pid, signal) {
+    if (!killTree(pid, signal)) {
+        try {
+            process.kill(pid, signal);
+        }
+        catch {
+            // Already gone.
+        }
+    }
+}
+//# sourceMappingURL=halt.js.map

package/dist/cli/halt.js.map

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

package/dist/cli/index.js

@@ -1,10 +1,10 @@
 /**
  * The `vinta-ai-maestro` command line.
  *
- * Seven subcommands, dispatched by hand. `node:util`'s `parseArgs` does the flag
+ * A dozen subcommands, dispatched by hand. `node:util`'s `parseArgs` does the flag
  * parsing inside each one, and nothing else does any: a framework here would be
  * a dependency, a plugin lifecycle and a help renderer bought to replace a
- * switch statement over seven strings.
+ * switch statement over a dozen strings.
  *
  * `main` returns an exit code rather than calling `process.exit`. That is what
  * makes the commands testable without a built binary, and it keeps the one
@@ -18,10 +18,13 @@
 import { OK, USAGE, processIo } from './io.js';
 import { DOCTOR_USAGE, doctorCommand } from './doctor.js';
 import { GATE_USAGE, gateCommand } from './gate.js';
+import { PAUSE_USAGE, STOP_USAGE, pauseCommand, stopCommand } from './halt.js';
+import { LOGS_USAGE, logsCommand } from './logs.js';
 import { PURGE_USAGE, purgeCommand } from './purge.js';
 import { RUN_USAGE, runCommand } from './run.js';
 import { SERVE_USAGE, serveCommand } from './serve.js';
 import { SIMULATE_USAGE, simulateCommand } from './simulate.js';
+import { STATUS_USAGE, statusCommand } from './status.js';
 import { WITH_USAGE, withCommand } from './with.js';
 import { judgeHookCommandMain } from '../system-one/hook.js';
 export const HELP = `vinta-ai-maestro — code-orchestrated parallel execution of a plan.
@@ -32,11 +35,16 @@ usage: vinta-ai-maestro <command> [options]
                              non-zero if a run cannot start.
   simulate <workflow.json>   Project the schedule without running it: wall
                              clock, critical path and pool contention.
-  serve                      Start the daemon and print the URL to open.
-                             Runs submitted to it outlive the terminal that
-                             submitted them.
-  run <workflow.json>        Start the daemon and execute the workflow.
-  run --resume <run-id>      Pick an interrupted run back up where it stopped.
+  run <workflow.json>        Start the workflow as a background job and
+                             return. The run outlives this terminal.
+  run --resume <run-id>      Pick an interrupted or paused run back up.
+  status [run-id]            What every run — or one run — is doing.
+  logs <run-id> [-f]         A run's job log; -f follows it to the end.
+  pause <run-id>             Let running steps finish, then stop. Resumable.
+  stop <run-id>              Kill the run now. Final.
+  ui                         Serve the browser UI for every run and print the
+                             URL to open. Closing it leaves runs running.
+                             (\`serve\` is the same command.)
   purge [run-id]             Delete run state under .vinta-ai-maestro/ — transcripts
                              and gate logs hold repository contents verbatim.
   with <resource> -- <cmd>   Run a command while holding a live run's resource.
@@ -58,7 +66,12 @@ const USAGES = {
     doctor: DOCTOR_USAGE,
     simulate: SIMULATE_USAGE,
     serve: SERVE_USAGE,
+    ui: SERVE_USAGE,
     run: RUN_USAGE,
+    status: STATUS_USAGE,
+    logs: LOGS_USAGE,
+    pause: PAUSE_USAGE,
+    stop: STOP_USAGE,
     purge: PURGE_USAGE,
     with: WITH_USAGE,
     gate: GATE_USAGE,
@@ -86,9 +99,18 @@ export async function main(argv, io = processIo()) {
         case 'simulate':
             return await simulateCommand(rest, io);
         case 'serve':
+        case 'ui':
             return await serveCommand(rest, io);
         case 'run':
             return await runCommand(rest, io);
+        case 'status':
+            return await statusCommand(rest, io);
+        case 'logs':
+            return await logsCommand(rest, io);
+        case 'pause':
+            return await pauseCommand(rest, io);
+        case 'stop':
+            return await stopCommand(rest, io);
         case 'purge':
             return await purgeCommand(rest, io);
         case 'with':
@@ -123,6 +145,9 @@ export { doctorCommand } from './doctor.js';
 export { simulateCommand } from './simulate.js';
 export { serveCommand, announce } from './serve.js';
 export { runCommand } from './run.js';
+export { statusCommand } from './status.js';
+export { logsCommand } from './logs.js';
+export { pauseCommand, stopCommand } from './halt.js';
 export { purgeCommand } from './purge.js';
 export { withCommand } from './with.js';
 export { gateCommand } from './gate.js';

package/dist/cli/index.js.map

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

package/dist/cli/logs.js

@@ -0,0 +1,133 @@
+/**
+ * `vinta-ai-maestro logs <runId>` — what a run's job has said.
+ *
+ * The job's console, from `runs/<id>/job.log`: everything `run` used to print
+ * to the terminal it no longer holds — the preflight report, warnings, the
+ * start and end lines — and the daemon's own records for that process, one per
+ * line. Every attempt at the run appends to the same file, so a resumed run
+ * reads as one history.
+ *
+ * `--follow` tails it until the job exits, which is how a pause or a stop is
+ * watched to its end. It is a poll of the file's size, because a follow that
+ * depended on a filesystem watcher would behave differently on every platform
+ * this package runs on, and a quarter-second is fast enough for a human.
+ *
+ * The file is read and printed as the job wrote it, and nothing here adds to
+ * it. What is in it is what §11 allows on a stream — identifiers and the
+ * operator's own command lines — and it sits under `runs/`, so `purge` takes
+ * it with the run.
+ */
+import { closeSync, existsSync, openSync, readSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { isAlive, jobLogPathFor, readJob } from '../job/job.js';
+import { FAILED, OK, USAGE } from './io.js';
+export const LOGS_USAGE = `usage: vinta-ai-maestro logs <runId> [--repo <dir>] [--follow] [--lines <n>]
+
+  Prints the run's job log: what the run would have printed to a terminal,
+  and its daemon's records, one per line. Every attempt — the original and
+  each resume — is in the same file.
+
+  --repo <dir>     The project. Defaults to the current directory.
+  -f, --follow     Keep printing as the job writes, until it exits.
+  -n, --lines <n>  Only the last n lines. Defaults to all of them.`;
+export async function logsCommand(argv, io, deps = {}) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: [...argv],
+            options: {
+                repo: { type: 'string' },
+                follow: { type: 'boolean', short: 'f' },
+                lines: { type: 'string', short: 'n' },
+            },
+            allowPositionals: true,
+        });
+    }
+    catch {
+        io.err(LOGS_USAGE);
+        return USAGE;
+    }
+    const runId = parsed.positionals[0];
+    if (runId === undefined || parsed.positionals.length > 1) {
+        io.err(LOGS_USAGE);
+        return USAGE;
+    }
+    const rawLines = parsed.values.lines;
+    const lines = rawLines === undefined ? undefined : Number(rawLines);
+    if (lines !== undefined && (!Number.isInteger(lines) || lines < 0)) {
+        io.err('vinta-ai-maestro: --lines must be a whole number');
+        return USAGE;
+    }
+    const repoPath = resolve(parsed.values.repo ?? process.cwd());
+    const path = jobLogPathFor(repoPath, runId);
+    if (!existsSync(path)) {
+        io.err(`vinta-ai-maestro: run "${runId}" has no job log in ${repoPath}.`);
+        return FAILED;
+    }
+    let offset = 0;
+    const initial = readFrom(path, 0);
+    offset = initial.length;
+    let text = initial.toString('utf8');
+    if (lines !== undefined) {
+        const all = text.split('\n');
+        if (all.at(-1) === '')
+            all.pop();
+        text = all.slice(Math.max(0, all.length - lines)).join('\n');
+    }
+    // A partial last line waits for the rest of itself before it is printed.
+    let pending = '';
+    const emit = (chunk) => {
+        const parts = (pending + chunk).split('\n');
+        pending = parts.pop() ?? '';
+        for (const line of parts)
+            io.out(line);
+    };
+    emit(lines === undefined || text === '' ? text : `${text}\n`);
+    if (parsed.values.follow !== true) {
+        if (pending !== '')
+            io.out(pending);
+        return OK;
+    }
+    const alive = deps.alive ?? isAlive;
+    const sleep = deps.sleep ?? ((ms) => new Promise((done) => setTimeout(done, ms)));
+    for (;;) {
+        const job = readJob(repoPath, runId);
+        const chunk = readFrom(path, offset);
+        offset += chunk.length;
+        if (chunk.length > 0)
+            emit(chunk.toString('utf8'));
+        // Read once more after the job is gone, so its last words are not lost to
+        // the race between its final write and its exit.
+        if (job === null || !alive(job.pid)) {
+            const last = readFrom(path, offset);
+            if (last.length > 0)
+                emit(last.toString('utf8'));
+            if (pending !== '')
+                io.out(pending);
+            return OK;
+        }
+        await sleep(250);
+    }
+}
+function readFrom(path, offset) {
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return Buffer.alloc(0);
+    }
+    if (size <= offset)
+        return Buffer.alloc(0);
+    const fd = openSync(path, 'r');
+    try {
+        const buffer = Buffer.alloc(size - offset);
+        const read = readSync(fd, buffer, 0, buffer.length, offset);
+        return buffer.subarray(0, read);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/cli/logs.js.map

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