@outerlayer/cli 0.8.0 → 0.8.2

package/dist/{work-claim-cmd-ARIYZARE.js → work-claim-cmd-HRPJ4VUF.js}

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { RUNNER_PROTOCOL } from './chunk-AIW6GLET.js';
-import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, resolveRepository, findLiveItem } from './chunk-5QLNZGAQ.js';
-export { WorkCommandError } from './chunk-5QLNZGAQ.js';
-import './chunk-4ACZCY4I.js';
+import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, resolveRepository, findLiveItem } from './chunk-R5SPFO6F.js';
+export { WorkCommandError } from './chunk-R5SPFO6F.js';
+import './chunk-WMPO3SKK.js';
 import './chunk-BFESLKPP.js';
-import './chunk-ILEA3YHM.js';
+import './chunk-EWBM2USM.js';
 import './chunk-ZYHKJKSU.js';
-import './chunk-GAYWY4GI.js';
+import './chunk-HN2JBGSI.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
-import { defaultRunnerConfigPath } from './chunk-PWBILI5P.js';
+import { defaultRunnerConfigPath } from './chunk-7KI224YS.js';
 import './chunk-UXYLWVTQ.js';
 import './chunk-7RQ73DLO.js';
-import './chunk-OD2VTIHN.js';
+import './chunk-2FWL7CE2.js';
 import './chunk-HKMPVPO7.js';
 import './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-BCLJSQCV.js';
-import './chunk-BOLTI6LR.js';
+import { defaultFetch } from './chunk-YO4PSLVB.js';
+import './chunk-PLMTLGYH.js';
 import './chunk-YNJEOGDL.js';
 import './chunk-EABW6AJQ.js';
-import { ensureHostKey } from './chunk-M5POMKKW.js';
+import { ensureHostKey } from './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
 import './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';

package/dist/{work-cmd-B3FOXZAL.js → work-cmd-W4GQUUBC.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkCommandError, findLiveItem, getJson, parsePositiveInt, postJson, resolveCredentials, resolveRepository, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-5QLNZGAQ.js';
-import './chunk-4ACZCY4I.js';
+export { WorkCommandError, findLiveItem, getJson, parsePositiveInt, postJson, resolveCredentials, resolveRepository, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-R5SPFO6F.js';
+import './chunk-WMPO3SKK.js';
 import './chunk-BFESLKPP.js';
-import './chunk-ILEA3YHM.js';
+import './chunk-EWBM2USM.js';
 import './chunk-ZYHKJKSU.js';
-import './chunk-GAYWY4GI.js';
+import './chunk-HN2JBGSI.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
 import './chunk-WZBHBH3J.js';
-import './chunk-BCLJSQCV.js';
-import './chunk-BOLTI6LR.js';
+import './chunk-YO4PSLVB.js';
+import './chunk-PLMTLGYH.js';
 import './chunk-YNJEOGDL.js';
 import './chunk-EABW6AJQ.js';
-import './chunk-M5POMKKW.js';
+import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
 import './chunk-BJ3KTMDH.js';
 import './chunk-VNVZDWO3.js';

package/dist/{work-comment-cmd-O5WGRI6K.js → work-comment-cmd-DDZ4SZ35.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { resolveCredentials, postJson, getJson } from './chunk-5QLNZGAQ.js';
-import './chunk-4ACZCY4I.js';
+import { resolveCredentials, postJson, getJson } from './chunk-R5SPFO6F.js';
+import './chunk-WMPO3SKK.js';
 import { detectActiveSession } from './chunk-BFESLKPP.js';
-import './chunk-ILEA3YHM.js';
+import './chunk-EWBM2USM.js';
 import { sanitizeTerminal } from './chunk-ZYHKJKSU.js';
-import { resolveRepoIdentity } from './chunk-GAYWY4GI.js';
+import { resolveRepoIdentity } from './chunk-HN2JBGSI.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
 import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-BCLJSQCV.js';
-import './chunk-BOLTI6LR.js';
+import { defaultFetch } from './chunk-YO4PSLVB.js';
+import './chunk-PLMTLGYH.js';
 import './chunk-YNJEOGDL.js';
 import './chunk-EABW6AJQ.js';
-import './chunk-M5POMKKW.js';
+import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
 import './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';

package/dist/{work-open-pr-cmd-M6CQW7KW.js → work-open-pr-cmd-GXULDTSC.js}

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { runWorkPr, WorkPrCommandError } from './chunk-K35RW5HP.js';
-import { resolveCredentials } from './chunk-5QLNZGAQ.js';
-import './chunk-4ACZCY4I.js';
+import { runWorkPr, WorkPrCommandError } from './chunk-33GOCSRO.js';
+import { resolveCredentials } from './chunk-R5SPFO6F.js';
+import './chunk-WMPO3SKK.js';
 import './chunk-BFESLKPP.js';
-import './chunk-ILEA3YHM.js';
+import './chunk-EWBM2USM.js';
 import './chunk-ZYHKJKSU.js';
-import './chunk-GAYWY4GI.js';
+import './chunk-HN2JBGSI.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
 import './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-BCLJSQCV.js';
-import './chunk-BOLTI6LR.js';
+import { defaultFetch } from './chunk-YO4PSLVB.js';
+import './chunk-PLMTLGYH.js';
 import './chunk-YNJEOGDL.js';
 import './chunk-EABW6AJQ.js';
-import './chunk-M5POMKKW.js';
+import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
 import './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';

package/dist/{work-pr-cmd-C4YEGKD6.js → work-pr-cmd-T6SU4TYN.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkPrCommandError, runWorkPr } from './chunk-K35RW5HP.js';
-import './chunk-4ACZCY4I.js';
+export { WorkPrCommandError, runWorkPr } from './chunk-33GOCSRO.js';
+import './chunk-WMPO3SKK.js';
 import './chunk-BFESLKPP.js';
-import './chunk-ILEA3YHM.js';
+import './chunk-EWBM2USM.js';
 import './chunk-ZYHKJKSU.js';
-import './chunk-GAYWY4GI.js';
+import './chunk-HN2JBGSI.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
 import './chunk-WZBHBH3J.js';
-import './chunk-BCLJSQCV.js';
-import './chunk-BOLTI6LR.js';
+import './chunk-YO4PSLVB.js';
+import './chunk-PLMTLGYH.js';
 import './chunk-YNJEOGDL.js';
 import './chunk-EABW6AJQ.js';
-import './chunk-M5POMKKW.js';
+import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
 import './chunk-BJ3KTMDH.js';
 import './chunk-VNVZDWO3.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outerlayer/cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "OuterLayer CLI — commands: init, connect, doctor, login, logout, sync, daemon (alias: watch), emit, work, 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.",
@@ -54,7 +54,7 @@
     "@types/node": "^22.20.1",
     "commander": "^15.0.0",
     "http-message-sig": "0.3.0",
-    "structured-headers": "2.0.3",
+    "structured-headers": "2.1.0",
     "tsup": "^8.5.0",
     "tsx": "^4.22.4",
     "typescript": "^5.5.3",

package/skill-pack/maintained/amend/SKILL.md

@@ -26,6 +26,15 @@ request's branch first if the working tree is not already on it.
   needs a person becomes a hand-off (step 5), never a stop that leaves a thread
   silently waiting on an agent.
 
+## Builds and local sessions
+
+A session a runner started for the item is a build. `OUTERLAYER_JOB_DIR` is
+set in a build and nowhere else. The GitHub token a runner gives a build can
+read the issue and the pull request but cannot comment on either. In the
+runner's own build environments, git pushes go through the runner, not
+straight to the git host. A local session uses the person's own git remote and
+`gh` login.
+
 ## Steps
 
 1. **Read the threads.**
@@ -56,8 +65,11 @@ request's branch first if the working tree is not already on it.
    - Make the change on the pull request's branch. Keep it to what the comment
      asks. Do not refactor around it.
    - Run the tests that cover the criterion, then the repository's full
-     pre-push checks through a normal `git push`. Never bypass a hook. If the
-     git host drops the connection during a long gate, push again with
+     pre-push checks through a normal `git push`. Never bypass a hook.
+   - A runner accepts a build's push only to the pull request's branch. If it
+     refuses one, read the reason git prints, fix it and push again.
+   - In a local session over SSH, the git host can drop the connection during
+     a long gate. Push again with
      `GIT_SSH_COMMAND="ssh -o ServerAliveInterval=20 -o ServerAliveCountMax=60"`.
    - **When the thread asks for new proof** (a criterion thread whose proof the
      person failed), capture it after the fixed state exists, in the form the
@@ -83,10 +95,14 @@ request's branch first if the working tree is not already on it.
 6. **Check nothing is left waiting.** Read the threads again. No thread you
    started with may still be waiting on an agent. If one is, the reply did not
    land or was flagged `unchanged`. Find out why and fix it, or report it.
-7. **Report.** Comment once on the pull request: one line per thread, naming the
-   criterion (or the general thread) and saying fixed (with the replacement) or
-   handed off (with the reason). Plain language. No session labels, no raw
-   command output.
+7. **Report.** Write one line per thread, naming the criterion (or the general
+   thread) and saying fixed (with the replacement) or handed off (with the
+   reason). Plain language. No session labels, no raw command output. Post the
+   lines once on the general thread, in a build and in a local session alike:
+   `outerlayer work comment --item "$OUTERLAYER_WORK" --body "<the lines>"`.
+   A plain comment from an agent leaves the general thread waiting on a person.
+   A local session also posts the lines once as a pull request comment. A build
+   does not try: its token cannot comment. End the session with the same lines.
 
 ## Rules
 

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

@@ -4,8 +4,9 @@ description: >
   Explain what OuterLayer is and how work flows through it: work items, the
   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, or how to attach evidence or answer
-  a review.
+  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.
 ---
 
 OuterLayer is a software factory. An issue goes in. A reviewed and verified
@@ -37,6 +38,15 @@ from the output of `outerlayer work build`.
    skill says what to capture.
 5. `/amend` answers the review threads a person handed to an agent.
 
+## Opening the pull request
+
+A runner build opens its pull request with `outerlayer work open-pr`, never
+with `gh pr create`. A session is a runner build when `OUTERLAYER_WORK` is set
+and `OUTERLAYER_API_KEY` holds an item key, which starts with `olitem_`. A
+local session uses `gh pr create` and then `outerlayer work pr <number>`. The
+full steps are in
+[references/open-pull-request.md](references/open-pull-request.md).
+
 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.

package/skill-pack/maintained/outerlayer/references/open-pull-request.md

@@ -0,0 +1,29 @@
+# Opening the pull request
+
+How a build opens its pull request depends on where it runs.
+
+A session is a runner build when `OUTERLAYER_WORK` is set and
+`OUTERLAYER_API_KEY` holds an item key, which starts with `olitem_`. Any other
+session is a local session.
+
+## A runner build
+
+A runner build opens its pull request with `outerlayer work open-pr`:
+
+    outerlayer work open-pr --title "<title>" --body-file <path>
+
+The build holds an item key, so the gateway opens the pull request as the
+factory's GitHub App on the branch the build's claim named. The build needs no
+GitHub login of its own, and it does not run `gh pr create`. The command also
+links the pull request to the work item, so no `outerlayer work pr` follows.
+Run it again to edit the pull request that is already open.
+
+A runner build whose command exits 0 while its item has no pull request is
+released `incomplete`, not `ok`. Open the pull request before the build ends.
+
+## A local session
+
+A local session opens the pull request under the person's own GitHub login
+with `gh pr create`. It then declares the pull request to the work item with
+`outerlayer work pr <number>`. Without that declaration the item shows no pull
+request, no evaluation and no evidence.

package/skill-pack/template/build/SKILL.md

@@ -179,8 +179,9 @@ Run them in order.
 
 5. **Sync and pull request.** Read [references/release.md](references/release.md)
    on entry and run it. A release agent rebases, gates and pushes. Open the
-   pull request. Then run `outerlayer work pr <number>` so the item links the
-   pull request. When the issue has criteria, a fresh agent judges them with
+   pull request as release.md says: a runner build with `outerlayer work open-pr`,
+   which links it, and a local session with `gh pr create` and then
+   `outerlayer work pr <number>`. When the issue has criteria, a fresh agent judges them with
    [references/criteria-judge.md](references/criteria-judge.md), and the
    judge's HTML report is emitted:
 

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

@@ -21,12 +21,17 @@ 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.
 
+How to open it, and how to link it to the work item, depends on whether this is
+a runner build or a local session. Read
+`.outerlayer/skills/outerlayer/references/open-pull-request.md` and follow the
+steps for where this build runs.
+
 Run the reader pass on the title and body before opening, and after any later
 edit. Add an "Unverified, non-blocking" section to the review report when
 classes were left unrefuted.
 
-The moment the pull request exists, declare it to the work item from this
-session:
+In a local session, the moment the pull request exists, declare it to the work
+item from this session:
 
     outerlayer work pr <number>
 
@@ -37,6 +42,10 @@ evaluation and no evidence. Check that the command reports the link as created
 or already present before going on. A CLI that does not know the command needs
 refreshing, and the final report names that as a blocker.
 
+A runner build declares nothing. `outerlayer work open-pr` opens the pull
+request and links it to the item in one step. Check that it reports the pull
+request before going on.
+
 ## Judge the criteria
 
 When the issue has criteria, spawn one fresh agent on