@outerlayer/cli 0.5.0 → 0.6.0

package/dist/{cli-NNWPFP5S.js → cli-7WCNPBYC.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { gatherDoctorChecks, doctorExitCode, summarizeChecks, renderDoctorText, recordWrapped, recordUnwrapped, recordRemoval, readManifest, recordInstall, recordStatusline } from './chunk-ZLB7GCTY.js';
-import './chunk-D2KWEAN6.js';
+import { gatherDoctorChecks, doctorExitCode, summarizeChecks, renderDoctorText, recordWrapped, recordUnwrapped, recordRemoval, readManifest, recordInstall, recordStatusline } from './chunk-MIGEDH5P.js';
+import './chunk-7DBI6SNT.js';
 import './chunk-F47JBIAW.js';
 import './chunk-BKO6JEZI.js';
-import './chunk-RMAZ2NWA.js';
+import './chunk-BNMCXPG7.js';
 import './chunk-BFESLKPP.js';
-import './chunk-WOBNRVQT.js';
-import './chunk-EX6M5JPR.js';
+import './chunk-3DEVYTNQ.js';
+import './chunk-ANK2B36Y.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import { C, NO_COLOR_FLAG, warnDeprecated, stripNoColor, API_KEY_FLAG_DEPRECATION } from './chunk-YRYMNBGQ.js';
@@ -21,14 +21,14 @@ import './chunk-EABW6AJQ.js';
 import { resolveVersion } from './chunk-RA3O54FC.js';
 import './chunk-M5POMKKW.js';
 import './chunk-ZM2IMMYN.js';
-import { hookFiredMarkerPath, installedCliDistDir } from './chunk-UFFXNXLQ.js';
+import { hookFiredMarkerPath, installedCliDistDir } from './chunk-FA2BOX4O.js';
 import { managedHookScripts, removeJournalHooks, installPreCommitGuardHook, removePreCommitGuardHook } from './chunk-XCCLFVXM.js';
 import './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-Z5GEFMRW.js';
 import { EventEmitter } from 'events';
 import childProcess, { execFileSync } from 'child_process';
-import path, { isAbsolute, dirname, join } from 'path';
+import path, { join, dirname, isAbsolute } from 'path';
 import fs, { existsSync, unlinkSync, mkdirSync, cpSync, readdirSync, renameSync, statSync, rmSync, readFileSync, writeFileSync, realpathSync } from 'fs';
 import process2 from 'process';
 import { stripVTControlCharacters } from 'util';
@@ -3792,8 +3792,8 @@ ${starter.output}`),
   }
 }
 async function realConnectDepsForCwd() {
-  const { realConnectDeps } = await import('./connect-cmd-OJBFHZWP.js');
-  const { resolveRepoIdentity } = await import('./dist-WDV7U7UJ.js');
+  const { realConnectDeps } = await import('./connect-cmd-PCESZLTR.js');
+  const { resolveRepoIdentity } = await import('./dist-RDLP4GGJ.js');
   return {
     ...realConnectDeps(),
     home: homeFromEnv(),
@@ -3846,7 +3846,7 @@ function buildProgram(argv = process.argv) {
       else process.stdout.write(outcome.text);
       return;
     }
-    const { runInitCommand } = await import('./init-cmd-W5NOLQPX.js');
+    const { runInitCommand } = await import('./init-cmd-HMFNIFPI.js');
     const code = await runInitCommand(
       { json: opts.json, factory: opts.factory },
       {
@@ -3858,7 +3858,7 @@ function buildProgram(argv = process.argv) {
           return { ok, text, detail };
         },
         runAgentSetup: async () => {
-          const { runAgentSetup } = await import('./agent-setup-IFH3FB5X.js');
+          const { runAgentSetup } = await import('./agent-setup-USZ2SAXC.js');
           return runAgentSetup({ cwd: process.cwd() });
         },
         runDoctorChecks: gatherDoctorChecks
@@ -3870,7 +3870,7 @@ function buildProgram(argv = process.argv) {
     "after",
     "\nRun it in a repository, after `outerlayer login`. With a login, connect lists\nthe factories you can use and takes the first rule that leaves one answer:\n  1. --factory <org>/<factory>, or a factory id\n  2. the factory this repository is already connected to\n  3. the one factory this repository is linked to\n  4. the one factory you can use\n  5. on a terminal, ask; with no terminal, exit 1 and list each --factory value\n\nIt says what it chose and why. The choice is saved in this repository's git\ndirectory (outerlayer/connection.json), shared by every worktree of the\nclone and never committed. A factory key already belongs to one factory, so\nconnect changes nothing for it. Connect never links a repository.\n\nAfter it saves the choice, connect checks that this repository is linked to\nthe factory. If it is not, connect says so, prints the factory's Work page\nlink where you link it, and exits 2. The choice is saved either way. Run\nconnect again once the repository is linked. With --json, the document has\nlinked (true, false, or null when it could not be checked) and, when false,\nlinkUrl.\n"
   ).action(async (opts) => {
-    const { runConnectCommand } = await import('./connect-cmd-OJBFHZWP.js');
+    const { runConnectCommand } = await import('./connect-cmd-PCESZLTR.js');
     const code = await runConnectCommand({ factory: opts.factory, json: opts.json }, await realConnectDepsForCwd(), {
       stdout: process.stdout,
       stderr: process.stderr
@@ -3918,7 +3918,7 @@ function buildProgram(argv = process.argv) {
     "\nIncremental: only sessions newer than the last checkpoint ship. The tier\nis applied on this machine before anything leaves it; `--dry-run` prints\nexactly what would. The hook-triggered background sync runs `--quiet`.\nExit 2 means the server rejected at least one session.\n"
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runSync, SyncConfigError, SyncTransportError } = await import('./sync-cmd-SWQ5KLPL.js');
+    const { runSync, SyncConfigError, SyncTransportError } = await import('./sync-cmd-YONVGUYS.js');
     try {
       const result = await runSync({
         url: opts.url,
@@ -3947,7 +3947,7 @@ function buildProgram(argv = process.argv) {
     if (invokedCommandToken(argv) === "watch") {
       warnDeprecated("`outerlayer watch` is now `outerlayer daemon`; the old name will be removed in a future release.");
     }
-    const { runWatch } = await import('./watch-3YW6Z3DQ.js');
+    const { runWatch } = await import('./watch-HHKAF26L.js');
     await runWatch({ once: opts.once });
   });
   program2.command("hook <event>", { hidden: true }).description("capture-hook fast path, installed by `init`").action(() => {
@@ -4000,6 +4000,14 @@ function buildProgram(argv = process.argv) {
       process.exit(255);
     }
   });
+  program2.command("session-sender", { hidden: true }).description("stream a runner build's sessions to its work item while the build runs").action(async () => {
+    const { runSessionSender } = await import('./session-sender-ED26V45B.js');
+    try {
+      await runSessionSender();
+    } catch (err) {
+      fail(`session-sender: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  });
   program2.command("vm-init", { hidden: true }).description("lay out a microVM build's guest; the guest helper runs it").action(async () => {
     const { realGuestHost, runGuestInit } = await import('./guest-init-GENRHNP7.js');
     const { readFileSync: readFileSync3 } = await import('fs');
@@ -4051,7 +4059,7 @@ function registerEmitCommands(program2) {
       return;
     }
     warnIfApiKeyFlag(opts);
-    const { runEmitResult, EmitResultError } = await import('./emit-result-cmd-ID35SH53.js');
+    const { runEmitResult, EmitResultError } = await import('./emit-result-cmd-3PRQKB55.js');
     try {
       const result = await runEmitResult({
         name,
@@ -4102,7 +4110,7 @@ locally so it never uploads. One correction can retire several duplicates.
 `
   ).action(async (file, opts) => {
     warnIfApiKeyFlag(opts);
-    const { runEmitArtifact, EmitArtifactError } = await import('./emit-artifact-cmd-FDWYKURA.js');
+    const { runEmitArtifact, EmitArtifactError } = await import('./emit-artifact-cmd-TBF46VXZ.js');
     let pr;
     if (opts.pr !== void 0) {
       pr = parseTrackerNumber(opts.pr);
@@ -4137,7 +4145,7 @@ locally so it never uploads. One correction can retire several duplicates.
     '\n  outerlayer emit finding --id gate-skip --category tooling \\\n    --title "The pre-push gate prints green when a step was skipped" \\\n    --file scripts/git/pre-push-checks.mjs --where "build session"\n\nRecords one problem you hit in the factory: an instruction that is wrong or\nmissing (context), a flaky test, a misbehaving script (tooling), a local\nsetup trap (environment), a bug outside your own change (defect), or\nanything else. A problem in your own change is fixed, not recorded.\nA context finding needs --rule-path and --rule-relation, and --rule-quote\nunless the relation is missing.\n--item names the work item; without it, inside a recorded session, the\nitem that session was launched for is used automatically.\n'
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runEmitFinding, refuseRemovedFindingFlags, EmitFindingError } = await import('./emit-finding-cmd-POW7PKIA.js');
+    const { runEmitFinding, refuseRemovedFindingFlags, EmitFindingError } = await import('./emit-finding-cmd-GSI75K36.js');
     try {
       refuseRemovedFindingFlags(opts);
       const result = await runEmitFinding({
@@ -4176,7 +4184,7 @@ locally so it never uploads. One correction can retire several duplicates.
     "\n  outerlayer emit findings review.json --item 412\n\nRecords a whole batch at once \u2014 a FindingBatch JSON file (schemaVersion,\noptional headSha / contextSourceSha, and 1-500 findings), validated against\nthe same contract `emit finding` uses before anything is sent. Re-emitting\nan id already on the item replaces that row rather than adding a second one.\n--item names the work item; without it, inside a recorded session, the item\nthat session was launched for is used automatically.\n"
   ).action(async (file, opts) => {
     warnIfApiKeyFlag(opts);
-    const { runEmitFindings, EmitFindingError } = await import('./emit-finding-cmd-POW7PKIA.js');
+    const { runEmitFindings, EmitFindingError } = await import('./emit-finding-cmd-GSI75K36.js');
     try {
       const result = await runEmitFindings({
         file,
@@ -4200,7 +4208,7 @@ locally so it never uploads. One correction can retire several duplicates.
     '\n  outerlayer emit criteria criteria.json --item 412\n\nRecords the item\'s acceptance criteria as one list. The file is JSON:\n  { "criteria": [ { "id": "AC-1", "text": "Given ...", "proof": null },\n                  { "id": "login.redirect", "text": "...", "proof": "screenshot" } ] }\nAn id is 1-64 characters of A-Z a-z 0-9 . _ : - and is the id evidence is bound to with\n`emit artifact --for`. proof is video, screenshot, report, log, test, file or null (any bound\nartifact proves it). The list holds 1 to 200 criteria, each text at most 2,000\ncharacters, and no id twice. The list is validated before anything is sent.\nOnce an item has a list, only a person can replace it: run the command outside an\nagent session, with your own login. A key bound to no member cannot replace it either.\n--item names the work item; without it, inside a recorded session, the item that\nsession was launched for is used automatically.\n'
   ).action(async (file, opts) => {
     warnIfApiKeyFlag(opts);
-    const { runEmitCriteria, EmitCriteriaError } = await import('./emit-criteria-cmd-OCXHLK34.js');
+    const { runEmitCriteria, EmitCriteriaError } = await import('./emit-criteria-cmd-3427XKFW.js');
     try {
       const result = await runEmitCriteria({
         file,
@@ -4227,7 +4235,7 @@ function registerWorkCommands(program2) {
     "\n  outerlayer work build --issue 42                       # a host builds it\n  outerlayer work build --item 7                         # retry an item already on Work\n  outerlayer work build --issue 42 --local               # you build it\n  outerlayer work build --issue ENG-123 --tracker linear # a Linear issue\n\nWithout --local, records a build request: a host takes the item when it\nhas a free slot. It never links the calling session and never takes a\nlease, even run from inside one.\n\nWith --local, puts the item on Work with no build request, so no host\ntakes it, and prints the line that starts your session on it. That\nsession links itself and holds the item's lease while it works.\n"
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkBuild, WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkBuild, WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkBuild(opts);
     } catch (err) {
@@ -4238,14 +4246,14 @@ function registerWorkCommands(program2) {
       throw err;
     }
   });
-  workCmd.command("link-session").description("Link the calling session to a work item that already exists").argument("<number>", "the item's number inside this factory").option("--session-id <id>", "session id to record as-is, skipping detection (used by the SessionStart hook)").option("--retry <count>", "resend after a failure that may pass, with backoff").option("--no-lease", "link only \u2014 ask for no session lease (used by a host's own job)").option("--ended", "release this session's lease instead of taking or renewing one").option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").addHelpText(
+  workCmd.command("link-session").description("Link the calling session to a work item that already exists").argument("<number>", "the item's number inside this factory").option("--session-id <id>", "session id to record as-is, skipping detection (used by the SessionStart hook)").option("--retry <count>", "resend after a failure that may pass, with backoff").option("--no-lease", "link only \u2014 ask for no session lease (used by a host's own job)").option("--ended", "release this session's lease instead of taking or renewing one").addOption(new Option("--log-failures", "append a failure to the hook error log (used by hooks)").hideHelp()).option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").addHelpText(
     "after",
     "\n  outerlayer work link-session 42\n\nNames an item that already exists on the calling session \u2014 it never\ncreates one. Create one with `outerlayer work build --local`. Linking\nthe same session to the same item twice is a no-op. Also takes or\nrenews that session's own 20-minute lease, unless --no-lease or\n--ended is given, or another worker already holds a live one.\n"
   ).action(async (number, opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkLinkSession, WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkLinkSession, WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
-      await runWorkLinkSession({ ...opts, number, noLease: opts.lease === false });
+      await runWorkLinkSession({ ...opts, number, noLease: opts.lease === false, logFailures: opts.logFailures === true });
     } catch (err) {
       if (err instanceof WorkCommandError) {
         fail(err.message);
@@ -4268,8 +4276,8 @@ most one action flag may be given.
 `
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkComment, WorkCommentCommandError } = await import('./work-comment-cmd-6TTTYGHM.js');
-    const { WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkComment, WorkCommentCommandError } = await import('./work-comment-cmd-6DGQNTAH.js');
+    const { WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkComment(opts);
     } catch (err) {
@@ -4285,8 +4293,8 @@ most one action flag may be given.
     "\n  outerlayer work threads --item 7\n\nPrints the item's general thread, then one thread per acceptance\ncriterion that carries proof or a comment, each with who is waiting\non whom next.\n"
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkThreads, WorkCommentCommandError } = await import('./work-comment-cmd-6TTTYGHM.js');
-    const { WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkThreads, WorkCommentCommandError } = await import('./work-comment-cmd-6DGQNTAH.js');
+    const { WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkThreads(opts);
     } catch (err) {
@@ -4308,7 +4316,7 @@ live addition remains on it.
 `
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkRemove, WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkRemove, WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkRemove(opts);
     } catch (err) {
@@ -4321,7 +4329,7 @@ live addition remains on it.
   });
   workCmd.command("status").description("Show one item's stage, gate ledger, and additions").option("--item <number>", "the item's number inside this factory").option("--issue <number>", "issue number").option("--repo <owner/name>", "repository (default: the current checkout's remote)").option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkStatus, WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkStatus, WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkStatus(opts);
     } catch (err) {
@@ -4334,7 +4342,7 @@ live addition remains on it.
   });
   workCmd.command("list").description("List live work items for this factory").option("--stage <spec|build|review>", "filter by stage").option("--section <attention|waiting|flowing>", "filter by Queue section").option("--repo <owner/name>", "repository (default: the current checkout's remote)").option("--unclaimed", "only items with no live lease").option("--claimed", "only items with a live lease, held by a host or a local session").option("--startable", "only items with an unused build request and no live lease").option("--needs <amend>", "only items with a thread waiting on an agent").option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkList, WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkList, WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkList(opts);
     } catch (err) {
@@ -4350,7 +4358,7 @@ live addition remains on it.
     "\n  outerlayer work claim --item 42 --kind implement\n\nRecords a lease for this host. A live lease already held by a\ndifferent host is refused; claiming again under the same host extends\nit.\n"
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkClaim, WorkCommandError } = await import('./work-claim-cmd-BQPPURBW.js');
+    const { runWorkClaim, WorkCommandError } = await import('./work-claim-cmd-LXBZTMJA.js');
     try {
       await runWorkClaim(opts);
     } catch (err) {
@@ -4366,7 +4374,7 @@ live addition remains on it.
     "\n  outerlayer work renew --item 42\n\nExtends this host's own live lease. Refused with a 410 if the lease\nhas expired, or a 403 if a different host holds it.\n"
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkRenew, WorkCommandError } = await import('./work-claim-cmd-BQPPURBW.js');
+    const { runWorkRenew, WorkCommandError } = await import('./work-claim-cmd-LXBZTMJA.js');
     try {
       await runWorkRenew(opts);
     } catch (err) {
@@ -4385,7 +4393,7 @@ live addition remains on it.
     "\n  outerlayer work release --item 42 --outcome ok\n\nMarks this host's lease released, optionally with an outcome.\nReleasing an already-released lease is a no-op that returns the\nrecorded release time and outcome.\n"
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkRelease, WorkCommandError } = await import('./work-claim-cmd-BQPPURBW.js');
+    const { runWorkRelease, WorkCommandError } = await import('./work-claim-cmd-LXBZTMJA.js');
     try {
       await runWorkRelease(opts);
     } catch (err) {
@@ -4401,7 +4409,7 @@ live addition remains on it.
     "\n  outerlayer work pr 481\n\nRun inside a session already on a work item. Records that pull\nrequest 481 in the checkout's repository belongs to that item \u2014 the\nsame fact a `pr-link` in the session's own transcript records on\nsync. Idempotent: declaring the same pull request twice is a no-op.\n"
   ).action(async (number, opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkPr, WorkPrCommandError } = await import('./work-pr-cmd-QNUBE6IQ.js');
+    const { runWorkPr, WorkPrCommandError } = await import('./work-pr-cmd-QJJVHZDC.js');
     try {
       await runWorkPr({ ...opts, number });
     } catch (err) {
@@ -4417,8 +4425,8 @@ live addition remains on it.
     '\n  outerlayer work open-pr --title "Add the thing" --body-file pr.md\n\nIn a host build, which holds an item key, the gateway opens the pull\nrequest as the factory\'s GitHub App, from the branch the claim named,\nor edits the one already open on that branch. No gh command runs.\nIn your own session it runs `gh pr create` (or `gh pr edit`) under your\nlogin, then declares the pull request on the item, as `work pr` does.\nRun it again after a change to the title or description.\n'
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkOpenPr, WorkOpenPrCommandError } = await import('./work-open-pr-cmd-KZ7QQFLD.js');
-    const { WorkCommandError } = await import('./work-cmd-NUR4CAG6.js');
+    const { runWorkOpenPr, WorkOpenPrCommandError } = await import('./work-open-pr-cmd-FCZHFHZS.js');
+    const { WorkCommandError } = await import('./work-cmd-OVNF44FY.js');
     try {
       await runWorkOpenPr(opts);
     } catch (err) {
@@ -4434,8 +4442,8 @@ function registerRunnerCommands(program2) {
   const runnerCmd = program2.command("runner").description("Take work from the implement and amend queues on this machine");
   const configOption = "the cloud config file to run against (default: ~/.outerlayer/config.json)";
   runnerCmd.command("start").description("Run the loop: claim work, run it, report, clean up, repeat").option("--config <path>", configOption).action(async (opts) => {
-    const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-XVJYZ4IQ.js');
-    const { start, RunnerStartError } = await import('./loop-VGM772I7.js');
+    const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-HL2AIR3K.js');
+    const { start, RunnerStartError } = await import('./loop-UAJB34KA.js');
     const { RunnerAlreadyRunningError } = await import('./pidfile-UZRH774M.js');
     const configPath = opts.config ?? defaultRunnerConfigPath();
     try {
@@ -4450,8 +4458,8 @@ function registerRunnerCommands(program2) {
     }
   });
   runnerCmd.command("check").description("Validate the config, the hooks and the key, and print the effective settings").option("--config <path>", configOption).action(async (opts) => {
-    const { defaultRunnerConfigPath } = await import('./config-XVJYZ4IQ.js');
-    const { runRunnerCheck } = await import('./check-AXCXDYO2.js');
+    const { defaultRunnerConfigPath } = await import('./config-HL2AIR3K.js');
+    const { runRunnerCheck } = await import('./check-CCVPBN7A.js');
     const configPath = opts.config ?? defaultRunnerConfigPath();
     const result = await runRunnerCheck(configPath);
     if (!result.ok) {
@@ -4466,33 +4474,71 @@ function registerRunnerCommands(program2) {
     process.stdout.write(`${result.lines.join("\n")}
 `);
   });
-  runnerCmd.command("install").description("Put this CLI into the runner's install layout, so the runner can update itself").option("--config <path>", configOption).action(async (opts) => {
-    const { defaultRunnerConfigPath } = await import('./config-XVJYZ4IQ.js');
-    const { runRunnerInstall, RunnerInstallError } = await import('./install-cmd-7WXOIFDO.js');
+  runnerCmd.command("install").description("Put this CLI in the runner's install layout; --service adds its service").option("--config <path>", configOption).option("--service", "set up the service that keeps the runner running").option("--print", "with --service, print the unit and set up nothing").option("--user <account>", "with --service, the account the service runs as").option("--replace", "with --service, replace a unit this command did not write").addOption(new Option("--unit-name <name>", "with --service, the unit's name").hideHelp()).action(async (opts) => {
+    const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-HL2AIR3K.js');
+    const { runRunnerInstall, RunnerInstallError } = await import('./install-cmd-453C7IZT.js');
     const configPath = opts.config ?? defaultRunnerConfigPath();
+    if (opts.service !== true) {
+      for (const flag of ["print", "user", "replace", "unitName"]) {
+        if (opts[flag] !== void 0) {
+          fail(`--${flag === "unitName" ? "unit-name" : flag} is for --service.`);
+          return;
+        }
+      }
+    }
     try {
+      if (opts.service === true) {
+        const { installServiceCommand } = await import('./command-ARFK3OYF.js');
+        const result2 = await installServiceCommand({
+          configPath,
+          print: opts.print,
+          user: opts.user,
+          replace: opts.replace,
+          unitName: opts.unitName,
+          entryPath: process.argv[1] ?? "",
+          nodePath: process.execPath,
+          home: homeFromEnv()
+        });
+        if (result2.unit !== void 0) process.stdout.write(result2.unit);
+        if (result2.ok) for (const line of result2.lines) process.stdout.write(`${C.green}\u2713${C.reset} ${line}
+`);
+        else fail(result2.lines.length > 0 ? result2.lines.join("\n  ") : "the service was not set up");
+        return;
+      }
       const result = runRunnerInstall({ configPath, entryPath: process.argv[1] ?? "", nodePath: process.execPath });
       process.stdout.write(`${C.green}\u2713${C.reset} installed ${result.version} for the runner; \`current\` names it
 `);
       process.stdout.write(
         `
-Start the runner from the install layout by putting this line in the service unit, then restart the service:
+To keep it running, run ${C.yellow}outerlayer runner install --service${C.reset}. To start the runner from the install layout yourself, use this line, then restart the service:
   ${C.yellow}${result.execStart}${C.reset}
 `
       );
     } catch (err) {
-      if (err instanceof RunnerInstallError) {
+      if (err instanceof RunnerInstallError || err instanceof RunnerConfigError) {
         fail(err.message);
         return;
       }
       throw err;
     }
   });
-  runnerCmd.command("init").description("Write a runner block that fits this machine; on macOS, offers a Linux VM").option("--config <path>", configOption).option("--vm", "on macOS, run the runner in a Linux VM (Lima), with container builds").option("--no-vm", "on macOS, skip the VM and run builds as unisolated processes").option("--allow-process-builds", "where builds cannot be isolated, run them as processes anyway").addOption(new Option("--config-stdin", "the VM-side hand-off: read the whole config as JSON on stdin").hideHelp()).addOption(new Option("--vm-cli-package <path>", "install this packed CLI tarball in the VM instead of the published version").hideHelp()).action(async (opts) => {
-    const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-XVJYZ4IQ.js');
-    const { runRunnerInit, RunnerInitError } = await import('./init-3ZQLFPNC.js');
-    const { detectMachine } = await import('./machine-5WEJA36F.js');
-    const { chooseVm, runVmInit, VmInitError } = await import('./init-CZX7ZDWF.js');
+  runnerCmd.command("uninstall").description("Stop the runner's service and remove it (needs --service)").option("--config <path>", configOption).option("--service", "remove the service, and the launch agent or scheduled task").addOption(new Option("--unit-name <name>", "the unit's name").hideHelp()).action(async (opts) => {
+    if (opts.service !== true) {
+      fail("pass --service: `outerlayer runner uninstall --service` removes the runner's service.");
+      return;
+    }
+    const { defaultRunnerConfigPath } = await import('./config-HL2AIR3K.js');
+    const { uninstallServiceCommand } = await import('./command-ARFK3OYF.js');
+    const result = await uninstallServiceCommand({ configPath: opts.config ?? defaultRunnerConfigPath(), unitName: opts.unitName, home: homeFromEnv() });
+    if (result.ok) for (const line of result.lines) process.stdout.write(`${C.green}\u2713${C.reset} ${line}
+`);
+    else fail(result.lines.length > 0 ? result.lines.join("\n  ") : "the service was not removed");
+  });
+  runnerCmd.command("init").description("Write a runner block that fits this machine; on macOS, offers a Linux VM").option("--config <path>", configOption).option("--vm", "on macOS, run the runner in a Linux VM (Lima), with container builds").option("--no-vm", "on macOS, skip the VM and run builds as unisolated processes").option("--allow-process-builds", "where builds cannot be isolated, run them as processes anyway").addOption(new Option("--config-stdin", "the VM-side hand-off: read the whole config as JSON on stdin").hideHelp()).addOption(new Option("--vm-cli-package <path>", "install this packed CLI tarball in the VM instead of the published version").hideHelp()).addOption(new Option("--unit-name <name>", "the service unit's name").hideHelp()).action(async (opts) => {
+    const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-HL2AIR3K.js');
+    const { runRunnerInit, RunnerInitError } = await import('./init-WVR4BZQ4.js');
+    const { detectMachine } = await import('./machine-2JOWGRSZ.js');
+    const { chooseVm, runVmInit, VmInitError } = await import('./init-OHYFIKZD.js');
     const configPath = opts.config ?? defaultRunnerConfigPath();
     try {
       const machine = detectMachine();
@@ -4524,7 +4570,7 @@ hooks: ${result2.hooks}
         }
       });
       if (useVm) {
-        const { realLima } = await import('./lima-XN65D7GN.js');
+        const { realLima } = await import('./lima-7NPCNGWT.js');
         const { cpus, totalmem } = await import('os');
         const { resolvePackageVersion } = await import('./version-BWM6VLDI.js');
         const result2 = await runVmInit(configPath, {
@@ -4561,17 +4607,36 @@ ${C.yellow}${result.note}${C.reset}
 To isolate builds in containers instead, run ${C.yellow}outerlayer runner init --vm${C.reset}.
 `);
       }
-      const { runRunnerInstall, RunnerInstallError } = await import('./install-cmd-7WXOIFDO.js');
-      let execStart;
+      const { runRunnerInstall, RunnerInstallError } = await import('./install-cmd-453C7IZT.js');
+      let installedLayout = false;
       try {
         const installed = runRunnerInstall({ configPath, entryPath: process.argv[1] ?? "", nodePath: process.execPath });
-        execStart = installed.execStart;
+        installedLayout = true;
         process.stdout.write(`${C.green}\u2713${C.reset} installed ${installed.version} for the runner, so it can update itself
 `);
       } catch (installErr) {
         if (!(installErr instanceof RunnerInstallError)) throw installErr;
         process.stdout.write(`
 ${C.yellow}The runner will not update itself: ${installErr.message}${C.reset}
+`);
+      }
+      let serviceUp = false;
+      if (installedLayout) {
+        const { installServiceCommand } = await import('./command-ARFK3OYF.js');
+        const service = await installServiceCommand({
+          configPath,
+          entryPath: process.argv[1] ?? "",
+          nodePath: process.execPath,
+          home: homeFromEnv(),
+          unitName: opts.unitName,
+          layoutInstalled: true
+        });
+        serviceUp = service.ok && service.state !== "needs-wsl-shutdown";
+        for (const line of service.lines) process.stdout.write(service.ok ? `${C.green}\u2713${C.reset} ${line}
+` : `${C.yellow}${line}${C.reset}
+`);
+      } else {
+        process.stdout.write(`${C.yellow}No service was set up: it starts the runner from the install layout, which needs a CLI installed with npm.${C.reset}
 `);
       }
       process.stdout.write(
@@ -4579,9 +4644,8 @@ ${C.yellow}The runner will not update itself: ${installErr.message}${C.reset}
 Next:
   1. Edit the command lines in ${result.configPath} to start your agent.
   2. ${C.yellow}outerlayer runner check${C.reset}
-  3. ${C.yellow}outerlayer runner start${C.reset}
-` + (execStart === void 0 ? "" : `  To run it as a service that updates itself, start it with this line in the unit:
-     ${C.yellow}${execStart}${C.reset}
+` + (serviceUp ? `  The runner service claims nothing until step 1 is done and a Claude credential is in ${join(dirname(configPath), "runner.env")}; ${C.yellow}outerlayer runner status${C.reset} shows what it is doing.
+` : `  3. ${C.yellow}outerlayer runner start${C.reset}, or ${C.yellow}outerlayer runner install --service${C.reset} to keep it running.
 `)
       );
     } catch (err) {
@@ -4596,7 +4660,7 @@ Next:
     "after",
     "\nFetches the head of the default branch into the runner's cache, reads its\n.devcontainer/devcontainer.json, and builds the image with the devcontainer CLI. Settings\nthat reach the host or widen the container's privileges are ignored and listed. The\nimage holds this CLI and a pinned Claude Code. Nothing runs inside the image.\n"
   ).action(async (opts) => {
-    const { defaultRunnerConfigPath } = await import('./config-XVJYZ4IQ.js');
+    const { defaultRunnerConfigPath } = await import('./config-HL2AIR3K.js');
     const { buildRepositoryImage, RecipeError } = await import('./build-PAEKVYVK.js');
     const { currentCliBuild } = await import('./cli-build-K56DK4DS.js');
     const { createDockerHost } = await import('./docker-NEGDLU6D.js');
@@ -4648,19 +4712,21 @@ Next:
     }
   });
   runnerCmd.command("stop").description("Take no more work; wait for running jobs to finish, then exit").option("--config <path>", "the cloud config file naming the runner to stop").option("--now", "end running jobs immediately, with outcome stopped").action(async (opts) => {
-    const { defaultRunnerConfigPath } = await import('./config-XVJYZ4IQ.js');
-    const { requestStop } = await import('./loop-VGM772I7.js');
+    const { defaultRunnerConfigPath } = await import('./config-HL2AIR3K.js');
+    const { requestStop } = await import('./loop-UAJB34KA.js');
     const configPath = opts.config ?? defaultRunnerConfigPath();
     await requestStop(configPath, Boolean(opts.now));
   });
   runnerCmd.command("status").description("List running jobs; with --recent, finished ones too").option("--config <path>", "the cloud config file naming the runner to inspect").option("--recent", "also list finished jobs, newest first, capped at 20").option("--json", "machine-readable JSON output").action(async (opts) => {
-    const { defaultRunnerConfigPath, loadRunnerConfig } = await import('./config-XVJYZ4IQ.js');
-    const { jobsDir } = await import('./paths-OYKMVYJP.js');
-    const { listJobFiles, runnerProcessState } = await import('./loop-VGM772I7.js');
-    const { renderStatus } = await import('./status-KBDVUYQ3.js');
+    const { defaultRunnerConfigPath, loadRunnerConfig } = await import('./config-HL2AIR3K.js');
+    const { jobsDir, runnerDir } = await import('./paths-OYKMVYJP.js');
+    const { listJobFiles, runnerProcessState } = await import('./loop-UAJB34KA.js');
+    const { renderStatus } = await import('./status-6WNXX2O7.js');
+    const { readHousekeepingRecord } = await import('./record-C43U4PKS.js');
     const path2 = await import('path');
     const configPath = opts.config ?? defaultRunnerConfigPath();
     const all = listJobFiles(configPath);
+    const housekeeping = readHousekeepingRecord(runnerDir(configPath));
     let host = "unknown";
     let concurrency = 1;
     try {
@@ -4670,12 +4736,22 @@ Next:
     } catch {
     }
     const processState = runnerProcessState(configPath);
+    const service = await (async () => {
+      if (process.platform !== "linux" || !existsSync("/run/systemd/system")) return void 0;
+      const { inspectService, realInspectProbes } = await import('./inspect-XAUSB7L3.js');
+      const { DEFAULT_UNIT_NAME } = await import('./install-DSUZE2TJ.js');
+      const facts = inspectService(DEFAULT_UNIT_NAME, path2.dirname(configPath), realInspectProbes());
+      return facts === void 0 ? void 0 : { unit: facts.unit, running: facts.mainPid !== void 0, delegated: facts.delegate };
+    })();
     if (opts.json) {
       writeJson({
         host,
         configPath,
         process: processState,
+        service,
         concurrency,
+        // A hold is only true of a runner that is running.
+        housekeeping: processState.state === "running" ? housekeeping : { ...housekeeping, holding: void 0 },
         jobs: all.map(({ dirName, job }) => ({ ...withoutItemKey(job), jobDir: path2.join(jobsDir(configPath), dirName) }))
       });
       return;
@@ -4688,14 +4764,16 @@ Next:
         concurrency,
         jobs: all,
         now: /* @__PURE__ */ new Date(),
-        recent: Boolean(opts.recent)
+        recent: Boolean(opts.recent),
+        housekeeping,
+        service
       })}
 `
     );
   });
   runnerCmd.command("logs").argument("<item>", "the work item's number in the factory").description("Print the newest attempt's log for one item").option("--config <path>", "the cloud config file naming the runner to inspect").option("-f, --follow", "keep printing as the log grows").action(async (itemArg, opts) => {
-    const { defaultRunnerConfigPath } = await import('./config-XVJYZ4IQ.js');
-    const { listJobFiles } = await import('./loop-VGM772I7.js');
+    const { defaultRunnerConfigPath } = await import('./config-HL2AIR3K.js');
+    const { listJobFiles } = await import('./loop-UAJB34KA.js');
     const { newestAttempt, logPathFor, tail, RunnerLogsError } = await import('./logs-7RYUH5A6.js');
     const configPath = opts.config ?? defaultRunnerConfigPath();
     const item = parseTrackerNumber(itemArg);
@@ -5011,7 +5089,7 @@ function registerContextCommands(program2) {
     await compileContext({ dir: opts.dir, check: opts.check, json: opts.json });
   });
   contextCmd.command("adopt <stagedDir>", { hidden: true }).description("Copy context the runner staged into this checkout (container builds)").option("--json", "machine-readable JSON output").action(async (stagedDir) => {
-    const { runContextAdopt } = await import('./context-adopt-UMA4O5NY.js');
+    const { runContextAdopt } = await import('./context-adopt-G5JAELE7.js');
     const { exitCode, stdout } = runContextAdopt(stagedDir, process.cwd());
     process.stdout.write(stdout);
     process.exitCode = exitCode;
@@ -5020,7 +5098,7 @@ function registerContextCommands(program2) {
     "after",
     "\nThe same flow SessionStart runs automatically, exposed for a manual retry or a\nfirst check outside a session. Writes AGENTS.md, .claude/**, and .outerlayer/**.\n"
   ).action(async (opts) => {
-    const { materializeContext } = await import('./context-materialize-G2FUFC72.js');
+    const { materializeContext } = await import('./context-materialize-3HLPZAF6.js');
     const result = await materializeContext({ cwd: process.cwd(), sessionId: `manual-${Date.now()}` });
     const output = formatContextMaterializeOutput(result);
     if (output.exitCode !== void 0) process.exitCode = output.exitCode;