@outerlayer/cli 0.18.0 → 0.19.1

package/dist/{work-claim-cmd-34FERLYX.js → work-claim-cmd-ZRPSHMPT.js}

@@ -1,30 +1,29 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { RUNNER_PROTOCOL } from './chunk-KDVIU23F.js';
-import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, environmentFacts, findLiveItemForIssue } from './chunk-KK4VBOH6.js';
-export { WorkCommandError } from './chunk-KK4VBOH6.js';
-import './chunk-WBT5X3NH.js';
-import './chunk-IP7BIBXJ.js';
-import './chunk-S76AYB4M.js';
-import './chunk-MQJSXHV7.js';
-import { defaultRunnerConfigPath } from './chunk-XGP3VYOG.js';
+import { RUNNER_PROTOCOL } from './chunk-BWSUPRDK.js';
+import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, environmentFacts, findLiveItemForIssue } from './chunk-FBTGMSQF.js';
+export { WorkCommandError } from './chunk-FBTGMSQF.js';
+import './chunk-IF2OSI5T.js';
+import './chunk-CG36IONK.js';
+import './chunk-G3IJ3N6F.js';
+import './chunk-BM63HB2M.js';
+import { defaultRunnerConfigPath } from './chunk-P53VEAOF.js';
 import './chunk-UXYLWVTQ.js';
 import './chunk-7RQ73DLO.js';
-import './chunk-BMYGAGBJ.js';
-import './chunk-NACDBXUG.js';
+import './chunk-QNLX477Q.js';
 import './chunk-GOSFARMS.js';
 import './chunk-ANPNT6PM.js';
 import './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-ZRL6HKBY.js';
-import './chunk-52NC2FIU.js';
-import './chunk-N3CUDFCW.js';
+import { defaultFetch } from './chunk-FVMYKL6L.js';
+import './chunk-NTRCK4NH.js';
+import './chunk-BJ3KTMDH.js';
 import './chunk-EABW6AJQ.js';
+import './chunk-CRB3POP4.js';
+import './chunk-7VUK5RFS.js';
+import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import { ensureHostKey } from './chunk-M2ZWWTWZ.js';
 import './chunk-N2PXGQRL.js';
 import './chunk-BQXFBI7T.js';
-import './chunk-BJ3KTMDH.js';
-import './chunk-CRB3POP4.js';
-import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-Z5GEFMRW.js';
 import { hostname } from 'os';
 
@@ -116,7 +115,7 @@ async function runWorkRelease(opts) {
       { sessionId, ended: true },
       fetchImpl
     );
-    const { markWorkLeaseRenewed } = await import('./hook-fast-W5MKHMJT.js');
+    const { markWorkLeaseRenewed } = await import('./hook-fast-RL5E5OXE.js');
     markWorkLeaseRenewed(sessionId, opts.home ?? homeFromEnv(env));
     const output2 = opts.json ? JSON.stringify(data2) : `released session ${sessionId}'s lease on #${itemId}, if it held one`;
     if (!opts.quiet) process.stdout.write(output2 + "\n");

package/dist/{work-cmd-7S5B2H2P.js → work-cmd-5I3J2XQQ.js}

@@ -1,25 +1,24 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkCommandError, environmentFacts, findLiveItemForIssue, getJson, parsePositiveInt, patchJson, postJson, resolveCredentials, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-KK4VBOH6.js';
-import './chunk-WBT5X3NH.js';
-import './chunk-IP7BIBXJ.js';
-import './chunk-S76AYB4M.js';
-import './chunk-MQJSXHV7.js';
-import './chunk-BMYGAGBJ.js';
-import './chunk-NACDBXUG.js';
+export { WorkCommandError, environmentFacts, findLiveItemForIssue, getJson, parsePositiveInt, patchJson, postJson, resolveCredentials, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-FBTGMSQF.js';
+import './chunk-IF2OSI5T.js';
+import './chunk-CG36IONK.js';
+import './chunk-G3IJ3N6F.js';
+import './chunk-BM63HB2M.js';
+import './chunk-QNLX477Q.js';
 import './chunk-GOSFARMS.js';
 import './chunk-ANPNT6PM.js';
 import './chunk-WZBHBH3J.js';
-import './chunk-ZRL6HKBY.js';
-import './chunk-52NC2FIU.js';
-import './chunk-N3CUDFCW.js';
+import './chunk-FVMYKL6L.js';
+import './chunk-NTRCK4NH.js';
+import './chunk-BJ3KTMDH.js';
 import './chunk-EABW6AJQ.js';
+import './chunk-CRB3POP4.js';
+import './chunk-7VUK5RFS.js';
+import './chunk-VNVZDWO3.js';
 import './chunk-M2ZWWTWZ.js';
 import './chunk-N2PXGQRL.js';
 import './chunk-BQXFBI7T.js';
-import './chunk-BJ3KTMDH.js';
-import './chunk-CRB3POP4.js';
-import './chunk-VNVZDWO3.js';
 import './chunk-Z5GEFMRW.js';
 
 createRequire(import.meta.url);

package/dist/{work-comment-cmd-SZJSPM5S.js → work-comment-cmd-UCCPWUSR.js}

@@ -1,25 +1,24 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { resolveCredentials, postJson, getJson } from './chunk-KK4VBOH6.js';
-import './chunk-WBT5X3NH.js';
-import { detectActiveSession } from './chunk-IP7BIBXJ.js';
-import './chunk-S76AYB4M.js';
-import { sanitizeTerminal } from './chunk-MQJSXHV7.js';
-import { resolveRepoIdentity } from './chunk-BMYGAGBJ.js';
-import './chunk-NACDBXUG.js';
+import { resolveCredentials, postJson, getJson } from './chunk-FBTGMSQF.js';
+import { detectActiveSession } from './chunk-IF2OSI5T.js';
+import './chunk-CG36IONK.js';
+import { sanitizeTerminal } from './chunk-G3IJ3N6F.js';
+import './chunk-BM63HB2M.js';
+import { resolveRepoIdentity } from './chunk-QNLX477Q.js';
 import './chunk-GOSFARMS.js';
 import { C } from './chunk-ANPNT6PM.js';
 import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-ZRL6HKBY.js';
-import './chunk-52NC2FIU.js';
-import './chunk-N3CUDFCW.js';
+import { defaultFetch } from './chunk-FVMYKL6L.js';
+import './chunk-NTRCK4NH.js';
+import './chunk-BJ3KTMDH.js';
 import './chunk-EABW6AJQ.js';
+import './chunk-CRB3POP4.js';
+import './chunk-7VUK5RFS.js';
+import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-M2ZWWTWZ.js';
 import './chunk-N2PXGQRL.js';
 import './chunk-BQXFBI7T.js';
-import './chunk-BJ3KTMDH.js';
-import './chunk-CRB3POP4.js';
-import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-Z5GEFMRW.js';
 import { randomUUID } from 'crypto';
 

package/dist/work-logs-cmd-7352CJPG.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { resolveCredentials, getJson } from './chunk-FBTGMSQF.js';
+import './chunk-IF2OSI5T.js';
+import './chunk-CG36IONK.js';
+import './chunk-G3IJ3N6F.js';
+import './chunk-BM63HB2M.js';
+import './chunk-QNLX477Q.js';
+import './chunk-GOSFARMS.js';
+import './chunk-ANPNT6PM.js';
+import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
+import { defaultFetch } from './chunk-FVMYKL6L.js';
+import './chunk-NTRCK4NH.js';
+import './chunk-BJ3KTMDH.js';
+import './chunk-EABW6AJQ.js';
+import './chunk-CRB3POP4.js';
+import './chunk-7VUK5RFS.js';
+import './chunk-VNVZDWO3.js';
+import './chunk-M2ZWWTWZ.js';
+import './chunk-N2PXGQRL.js';
+import './chunk-BQXFBI7T.js';
+import './chunk-Z5GEFMRW.js';
+
+createRequire(import.meta.url);
+
+// src/work-logs-cmd.ts
+var WorkLogsCommandError = class extends Error {
+};
+async function runWorkLogs(opts) {
+  const itemNumber = parseTrackerNumber(opts.item);
+  if (itemNumber === void 0) {
+    throw new WorkLogsCommandError(trackerNumberError("--item", opts.item ?? ""));
+  }
+  const creds = resolveCredentials(opts);
+  const fetchImpl = opts.fetchImpl ?? defaultFetch;
+  const attempt = opts.attempt ?? "newest";
+  const { data } = await getJson(
+    creds.url,
+    `/v1/work-items/${itemNumber}/claims/${encodeURIComponent(attempt)}/log`,
+    creds.apiKey,
+    creds.appId,
+    fetchImpl
+  );
+  const body = data;
+  if (opts.json) {
+    const output2 = JSON.stringify(data);
+    if (!opts.quiet) process.stdout.write(output2 + "\n");
+    if (body.log === null) throw new WorkLogsCommandError(unavailable(body));
+    return { data, output: output2 };
+  }
+  if (body.log === null) throw new WorkLogsCommandError(unavailable(body));
+  const output = body.log;
+  if (!opts.quiet) process.stdout.write(output);
+  return { data, output };
+}
+function unavailable(body) {
+  return body.releasedAt === null ? `attempt ${body.claimId} is still running; the runner sends its log when it releases the attempt` : `attempt ${body.claimId} was released by a runner too old to upload its log`;
+}
+
+export { WorkLogsCommandError, runWorkLogs };

package/dist/{work-open-pr-cmd-RPXKCBWS.js → work-open-pr-cmd-LSH4VHJM.js}

@@ -1,27 +1,26 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-B3UKB46N.js';
-import { resolveCredentials } from './chunk-KK4VBOH6.js';
-import './chunk-WBT5X3NH.js';
-import './chunk-IP7BIBXJ.js';
-import './chunk-S76AYB4M.js';
-import './chunk-MQJSXHV7.js';
-import './chunk-BMYGAGBJ.js';
-import './chunk-NACDBXUG.js';
+import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-LRG3ZMZD.js';
+import { resolveCredentials } from './chunk-FBTGMSQF.js';
+import './chunk-IF2OSI5T.js';
+import './chunk-CG36IONK.js';
+import './chunk-G3IJ3N6F.js';
+import './chunk-BM63HB2M.js';
+import './chunk-QNLX477Q.js';
 import './chunk-GOSFARMS.js';
 import { C } from './chunk-ANPNT6PM.js';
 import { parseWorkItemEnv } from './chunk-T2Q7ISPE.js';
 import './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-ZRL6HKBY.js';
-import './chunk-52NC2FIU.js';
-import './chunk-N3CUDFCW.js';
+import { defaultFetch } from './chunk-FVMYKL6L.js';
+import './chunk-NTRCK4NH.js';
+import './chunk-BJ3KTMDH.js';
 import './chunk-EABW6AJQ.js';
+import './chunk-CRB3POP4.js';
+import './chunk-7VUK5RFS.js';
+import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-M2ZWWTWZ.js';
 import './chunk-N2PXGQRL.js';
 import './chunk-BQXFBI7T.js';
-import './chunk-BJ3KTMDH.js';
-import './chunk-CRB3POP4.js';
-import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import './chunk-Z5GEFMRW.js';
 import { spawnSync } from 'child_process';
 import { readFileSync } from 'fs';

package/dist/{work-pr-cmd-5LGANL32.js → work-pr-cmd-H4OQR26N.js}

@@ -1,26 +1,25 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-B3UKB46N.js';
-import './chunk-WBT5X3NH.js';
-import './chunk-IP7BIBXJ.js';
-import './chunk-S76AYB4M.js';
-import './chunk-MQJSXHV7.js';
-import './chunk-BMYGAGBJ.js';
-import './chunk-NACDBXUG.js';
+export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-LRG3ZMZD.js';
+import './chunk-IF2OSI5T.js';
+import './chunk-CG36IONK.js';
+import './chunk-G3IJ3N6F.js';
+import './chunk-BM63HB2M.js';
+import './chunk-QNLX477Q.js';
 import './chunk-GOSFARMS.js';
 import './chunk-ANPNT6PM.js';
 import './chunk-T2Q7ISPE.js';
 import './chunk-WZBHBH3J.js';
-import './chunk-ZRL6HKBY.js';
-import './chunk-52NC2FIU.js';
-import './chunk-N3CUDFCW.js';
+import './chunk-FVMYKL6L.js';
+import './chunk-NTRCK4NH.js';
+import './chunk-BJ3KTMDH.js';
 import './chunk-EABW6AJQ.js';
+import './chunk-CRB3POP4.js';
+import './chunk-7VUK5RFS.js';
+import './chunk-VNVZDWO3.js';
 import './chunk-M2ZWWTWZ.js';
 import './chunk-N2PXGQRL.js';
 import './chunk-BQXFBI7T.js';
-import './chunk-BJ3KTMDH.js';
-import './chunk-CRB3POP4.js';
-import './chunk-VNVZDWO3.js';
 import './chunk-Z5GEFMRW.js';
 
 createRequire(import.meta.url);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outerlayer/cli",
-  "version": "0.18.0",
-  "description": "OuterLayer CLI — commands: init, connect, doctor, login, logout, sync, daemon (alias: watch), emit, work, spec, runner, hooks, mcp, import, context. Capture and sync coding-agent sessions, and record proof of factory work.",
+  "version": "0.19.1",
+  "description": "OuterLayer CLI — commands: init, claude, connect, doctor, login, logout, sync, daemon (alias: watch), emit, work, spec, runner, hooks, mcp, import, context. Capture and sync coding-agent sessions, and record proof of factory work.",
   "license": "Apache-2.0",
   "author": "Magu Studios, Inc.",
   "repository": {

package/skill-pack/maintained/outerlayer-cli/SKILL.md

@@ -5,8 +5,8 @@ description: >
   OUTERLAYER_WORK variable, the factory, and building an issue or specifying one.
   Use when asked about OuterLayer, a work item, OUTERLAYER_WORK, "build issue
   42", how an issue becomes a pull request, how a build opens its pull request
-  (a runner build or a local session), or how to attach evidence or answer a
-  review.
+  (a runner build or a local session), why a build failed or ended, or how to
+  attach evidence or answer a review.
 ---
 
 Run the CLI as `outerlayer`. If that command is not on PATH, run `npx -y @outerlayer/cli` with the same arguments. Every `outerlayer ...` command below follows this rule.
@@ -69,6 +69,13 @@ Launching recorded work needs Claude Code. It is the one agent whose sessions
 OuterLayer can start with `OUTERLAYER_WORK` set and record. Other agents can
 read the files this repository emits, but they cannot be launched as work.
 
+## When a build failed or ended
+
+Start from OuterLayer, not from the host. The work item says how an attempt
+ended, which session ran in it, and what the runner did around the agent. The
+steps, and what each outcome and reason means, are in
+[references/find-out-why-a-build-ended.md](references/find-out-why-a-build-ended.md).
+
 ## Reading work items
 
 When the OuterLayer MCP server is configured in this repository, its

package/skill-pack/maintained/outerlayer-cli/references/find-out-why-a-build-ended.md

@@ -0,0 +1,76 @@
+# Find out why a build ended
+
+A host build that ends badly leaves a record on its work item. Read it in this
+order, and go to the host only when OuterLayer cannot answer. Each step names
+the CLI command and the MCP tool that read the same data.
+
+## 1. Read the item
+
+`outerlayer work status --item <number> --json`, or the MCP tool
+`get_work_item`. The item lists every attempt in `claims`, newest first. Each
+attempt has an `id`, its `outcome`, the `stage` it ended in, the `exitCode` of
+that stage's process, a `reason`, and when it started and was released.
+
+## 2. Read the claim
+
+Take the newest claim whose `holderKind` is `host`. Classify how it ended from
+`outcome`, `stage`, `exitCode` and `reason`.
+
+| Outcome | Meaning |
+| --- | --- |
+| `ok` | The command exited 0 and the item's checks passed. |
+| `incomplete` | The command exited 0, but the item's checks failed or had no result. The `reason` names what is not done. |
+| `failed` | The command exited non-zero, or a stage failed. Read `stage` and `reason`. |
+| `timed_out` | The runner ended the command at its time limit. |
+| `idle` | The runner ended the command because it wrote nothing for the idle limit. |
+| `lease_lost` | The runner could not renew its lease, so it ended the build. |
+| `interrupted` | The runner stopped or crashed and found the build unfinished. |
+| `stopped` | An operator stopped the runner with `runner stop --now`. |
+
+Two reasons say the command ended without the runner's doing:
+
+- `the command exited <status>, the status of a process killed by <SIGNAL>; the runner did not end it`.
+  The status is 128 plus the signal number. A process killed by a signal
+  reports that status, and so does a program that exits with it on its own.
+  The runner cannot tell them apart. `137` is the status a process killed by
+  SIGKILL returns, which the kernel's out-of-memory killer also uses.
+- `the command was killed by <SIGNAL> on the host; the runner did not end it`.
+  The command's process on the host died of a signal the runner did not send,
+  and there is no exit code.
+
+Either one means something outside the runner ended the command: a person or
+a script on the host, a supervisor, or the kernel. A build the kernel killed
+for memory says so in its own reason, which comes first.
+
+## 3. Read the session
+
+Each session on the item has a `claimId`. The session whose `claimId` matches
+the attempt is the one that ran in it. Read it with the MCP tool `get_session`
+and the session's `traceId`. It shows what the agent was doing when the attempt
+ended, including a turn that ended while work was still running. A session
+linked by a person or a pull request has a `claimId` of null.
+
+## 4. Read the runner log
+
+`outerlayer work logs --item <number>`, or the MCP tool `get_runner_log`. Add
+`--attempt <claim id>`, or pass `claimId`, for an attempt that is not the
+newest. The log is what the runner did around the agent: claiming,
+provisioning, starting and ending the command, syncing, cleaning up and
+releasing. When the attempt ended in provision, sync, cleanup or report, it ends
+with the last 200 lines of that stage's log.
+
+The command exits 1 when the attempt is still running, or when a runner too old
+to upload its log released it. The runner log never holds the command's
+output. The session does.
+
+## 5. Read the threads
+
+`outerlayer work threads --item <number> --json`, or the MCP tool
+`get_work_item_threads`. A person's request that asked an agent to amend the
+work is a comment on a thread that is `waitingOn` the agent.
+
+## 6. Log in to the host
+
+Only now, and say which question OuterLayer could not answer. Never signal a
+build's processes by hand on a runner host. A build ended that way is lost, and
+nothing on the item can show who did it.

package/skill-pack/shipped.json

@@ -46,6 +46,7 @@
       "4153d69f6882ba72db97c236134dc24ae4ad7f46a30e13ac075bac4567a6cfd0",
       "4687f56bcec766f1926d58a208418f800a1727c073b5e6047b40e3aaac2bd6c9",
       "4cfc10bc9d380e67b0ec5c243eb5f2c63f03ee3348d7956a45467620acc656fc",
+      "6adbc4b2f4d90deb1aa7541f09239723de8ee19af68dd20330c81ad16a3c0aa1",
       "7ba5273d911f6830a2d7575d446ea997d4b8c99a6826137c555990dd7dd54f3b",
       "81a764eb317fcb4672bedd35e7b9aa68d1c0b73f82fc2dfa03e5a78758db8f14",
       "85069e15aa3fdfeb8a0d1b8d1a450fb6a574bcf933246a7b7f7864be1c39faa3",

package/skill-pack/template/build/references/release.md

@@ -16,7 +16,9 @@ already cleared, run one check round on the rebased diff before going on.
 
 ## Open the pull request
 
-Open a scoped pull request that closes the issue. The body carries the
+Open a scoped pull request. For a GitHub issue, the body closes the issue.
+For a Linear or Jira issue, the body links the issue instead, and a person
+completes it in that tracker after merge. The body carries the
 problem, the change, how to verify it, and, when the change alters what a user
 sees or does, a link to each documentation file added or changed. It carries
 no telemetry, round tables or reviewer roles. Those go in the final report.

package/dist/chunk-WBT5X3NH.js

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from 'node:module';
-import { fetchFactories, selectFactory, saveFactoryConnection, autoConnectedLine } from './chunk-S76AYB4M.js';
-import { resolveRepoIdentity } from './chunk-BMYGAGBJ.js';
-import { resolveGatewayCredentials } from './chunk-52NC2FIU.js';
-import { findGitDirs, readRepoConnection } from './chunk-BJ3KTMDH.js';
-import { cliInvocation } from './chunk-CRB3POP4.js';
-import { homeFromEnv } from './chunk-VNVZDWO3.js';
-
-createRequire(import.meta.url);
-
-// src/auto-connect.ts
-async function autoConnect(opts) {
-  const env = opts.env ?? process.env;
-  const home = opts.home ?? homeFromEnv(env);
-  const cwd = opts.cwd ?? process.cwd();
-  const resolved = resolveGatewayCredentials({ url: opts.url, apiKey: opts.apiKey, appId: opts.appId, home, env, cwd });
-  if (resolved.ok || resolved.kind !== "login" || !resolved.credential || !resolved.url) return void 0;
-  const dirs = findGitDirs(cwd);
-  const repository = opts.repository ?? resolveRepoIdentity(cwd).gitRepo;
-  if (dirs === void 0 || repository === void 0) return void 0;
-  const listed = await fetchFactories(opts.fetchImpl ?? fetch, resolved.url, resolved.credential, repository);
-  if (!listed.ok || listed.factories.length === 0) return void 0;
-  const chosen = selectFactory(listed.factories, readRepoConnection(cwd), repository);
-  if (chosen.factory === void 0) {
-    return `you are logged in, but no factory is chosen for this repository, and more than one fits. Run \`${cliInvocation()} connect --factory <org>/<factory>\` with one of:
-${chosen.text}
-Or pass --app-id / set OUTERLAYER_APP_ID.`;
-  }
-  try {
-    saveFactoryConnection(dirs.gitCommonDir, void 0, chosen.factory, /* @__PURE__ */ new Date());
-  } catch {
-    return void 0;
-  }
-  process.stderr.write(`${autoConnectedLine(repository, chosen.factory, chosen.reason)}
-`);
-  return void 0;
-}
-
-export { autoConnect };