@outerlayer/cli 0.15.0 → 0.17.0

package/dist/{status-7ZX57OFJ.js → status-7VNQN5PW.js}

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { LEASE_SECONDS, ALREADY_RELEASED, RENEW_INTERVAL_SECONDS } from './chunk-ASOSIKA4.js';
+import { LEASE_SECONDS, ALREADY_RELEASED, RENEW_INTERVAL_SECONDS } from './chunk-G5NPRL2K.js';
 import './chunk-RMWLBUCJ.js';
+import './chunk-NNRTPG7X.js';
 import './chunk-HYZRY4KZ.js';
-import './chunk-KFRM23WD.js';
-import './chunk-MSASO5O4.js';
+import './chunk-NWQTTSBB.js';
 import './chunk-HHJDN6AU.js';
 import { formatBytes } from './chunk-YYYRBYWG.js';
 import './chunk-TBT347UY.js';
-import { formatDuration, formatClock, relativeToRunner } from './chunk-UUDDPNRJ.js';
+import { formatDuration, formatClock, relativeToRunner } from './chunk-MAK5LYRF.js';
 import './chunk-KMDLFI4P.js';
 import './chunk-QKFB4K7X.js';
 import './chunk-RSNSZ2LJ.js';
-import './chunk-JR6ERP3M.js';
-import './chunk-NPQWKGUA.js';
+import './chunk-S3NYLI2P.js';
+import './chunk-6Y5RUTHO.js';
 import './chunk-IP7BIBXJ.js';
 import './chunk-22RMZBGW.js';
 import './chunk-UXYLWVTQ.js';
@@ -27,7 +27,7 @@ import './chunk-4Q7OMKAT.js';
 import './chunk-CX22S5BA.js';
 import './chunk-F7CU5ABH.js';
 import './chunk-BKO6JEZI.js';
-import './chunk-YDSMROTB.js';
+import './chunk-3NSNIIBE.js';
 import './chunk-WUYTWNMA.js';
 import './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';
@@ -36,20 +36,21 @@ import './chunk-YRYMNBGQ.js';
 import './chunk-GQD22KKN.js';
 import './chunk-WZBHBH3J.js';
 import './chunk-5QRP3MVS.js';
-import './chunk-3NLOVYJQ.js';
-import './chunk-LCEXHCHD.js';
+import './chunk-YZ5F4PIS.js';
+import './chunk-WTE3MQML.js';
+import './chunk-C5Y5ZJJZ.js';
 import './chunk-ZJSNLVCE.js';
 import './chunk-YO4PSLVB.js';
 import './chunk-BYT5O5RV.js';
-import './chunk-ZA5CHAFY.js';
-import './chunk-2M63GG56.js';
+import './chunk-POJMEEJJ.js';
+import './chunk-OHVJA253.js';
 import './chunk-PLMTLGYH.js';
 import './chunk-J5M7BSJQ.js';
 import './chunk-EABW6AJQ.js';
 import './chunk-RA3O54FC.js';
 import './chunk-V7NIVOFD.js';
 import { runnerDir, jobsDir } from './chunk-ZM2IMMYN.js';
-import './chunk-PQUM37BK.js';
+import './chunk-BWQ66M6N.js';
 import './chunk-XCCLFVXM.js';
 import './chunk-BJ3KTMDH.js';
 import './chunk-VNVZDWO3.js';

package/dist/{sync-cmd-UWD5JOFU.js → sync-cmd-GVPPFZ3G.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { CHUNK_PART_TARGET_BYTES, RETRYABLE_STATUSES, SyncConfigError, SyncTransportError, detectCi, isLoopbackUrl, resolveTier, runSync } from './chunk-MSASO5O4.js';
+export { CHUNK_PART_TARGET_BYTES, RETRYABLE_STATUSES, SyncConfigError, SyncTransportError, detectCi, isLoopbackUrl, resolveTier, runSync } from './chunk-NWQTTSBB.js';
 import './chunk-HHJDN6AU.js';
 import './chunk-TBT347UY.js';
 import './chunk-IP7BIBXJ.js';
@@ -19,7 +19,7 @@ import './chunk-J5M7BSJQ.js';
 export { cloudConfigPath, readCloudConfig, writeCloudConfig } from './chunk-EABW6AJQ.js';
 import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
-import './chunk-PQUM37BK.js';
+import './chunk-BWQ66M6N.js';
 import './chunk-XCCLFVXM.js';
 import './chunk-BJ3KTMDH.js';
 import './chunk-VNVZDWO3.js';

package/dist/{watch-DBNB7R6X.js → watch-23HSAEI6.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { LiveUploader } from './chunk-MSASO5O4.js';
+import { LiveUploader } from './chunk-NWQTTSBB.js';
 import './chunk-HHJDN6AU.js';
 import './chunk-TBT347UY.js';
 import './chunk-IP7BIBXJ.js';
@@ -19,7 +19,7 @@ import './chunk-J5M7BSJQ.js';
 import './chunk-EABW6AJQ.js';
 import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
-import './chunk-PQUM37BK.js';
+import './chunk-BWQ66M6N.js';
 import './chunk-XCCLFVXM.js';
 import './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';

package/dist/{work-claim-cmd-A6IS6CQ7.js → work-claim-cmd-LKL3GHFQ.js}

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { RUNNER_PROTOCOL } from './chunk-ADJRGVZC.js';
-import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, environmentFacts, resolveRepository, findLiveItem } from './chunk-JR6ERP3M.js';
-export { WorkCommandError } from './chunk-JR6ERP3M.js';
-import './chunk-NPQWKGUA.js';
+import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, environmentFacts, resolveRepository, findLiveItem } from './chunk-S3NYLI2P.js';
+export { WorkCommandError } from './chunk-S3NYLI2P.js';
+import './chunk-6Y5RUTHO.js';
 import './chunk-IP7BIBXJ.js';
 import { defaultRunnerConfigPath } from './chunk-22RMZBGW.js';
 import './chunk-UXYLWVTQ.js';
 import './chunk-7RQ73DLO.js';
 import './chunk-4Q7OMKAT.js';
-import './chunk-YDSMROTB.js';
+import './chunk-3NSNIIBE.js';
 import './chunk-WUYTWNMA.js';
 import './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';
@@ -118,7 +118,7 @@ async function runWorkRelease(opts) {
       { sessionId, ended: true },
       fetchImpl
     );
-    const { markWorkLeaseRenewed } = await import('./hook-fast-WYQD6D7T.js');
+    const { markWorkLeaseRenewed } = await import('./hook-fast-R4FVSZ2H.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-EQSW5DTD.js → work-cmd-Z2WXLZPH.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkCommandError, environmentFacts, findLiveItem, getJson, parsePositiveInt, postJson, resolveCredentials, resolveRepository, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-JR6ERP3M.js';
-import './chunk-NPQWKGUA.js';
+export { WorkCommandError, environmentFacts, findLiveItem, getJson, parsePositiveInt, postJson, resolveCredentials, resolveRepository, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-S3NYLI2P.js';
+import './chunk-6Y5RUTHO.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-YDSMROTB.js';
+import './chunk-3NSNIIBE.js';
 import './chunk-WUYTWNMA.js';
 import './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';

package/dist/{work-comment-cmd-7VLKI7FN.js → work-comment-cmd-AWHP56M2.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { resolveCredentials, postJson, getJson } from './chunk-JR6ERP3M.js';
-import './chunk-NPQWKGUA.js';
+import { resolveCredentials, postJson, getJson } from './chunk-S3NYLI2P.js';
+import './chunk-6Y5RUTHO.js';
 import { detectActiveSession } from './chunk-IP7BIBXJ.js';
-import './chunk-YDSMROTB.js';
+import './chunk-3NSNIIBE.js';
 import { sanitizeTerminal } from './chunk-WUYTWNMA.js';
 import { resolveRepoIdentity } from './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';

package/dist/{work-open-pr-cmd-JEVD4HMQ.js → work-open-pr-cmd-IOM4AVQQ.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-JJEGKEFV.js';
-import { resolveCredentials } from './chunk-JR6ERP3M.js';
-import './chunk-NPQWKGUA.js';
+import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-YU3VKZ5F.js';
+import { resolveCredentials } from './chunk-S3NYLI2P.js';
+import './chunk-6Y5RUTHO.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-YDSMROTB.js';
+import './chunk-3NSNIIBE.js';
 import './chunk-WUYTWNMA.js';
 import './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';

package/dist/{work-pr-cmd-L77K32WK.js → work-pr-cmd-HNEUIEN7.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-JJEGKEFV.js';
-import './chunk-NPQWKGUA.js';
+export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-YU3VKZ5F.js';
+import './chunk-6Y5RUTHO.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-YDSMROTB.js';
+import './chunk-3NSNIIBE.js';
 import './chunk-WUYTWNMA.js';
 import './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outerlayer/cli",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "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.",

package/skill-pack/maintained/{amend → outerlayer-amend}/SKILL.md

@@ -1,13 +1,15 @@
 ---
-name: amend
+name: outerlayer-amend
 description: >
   Answer the review threads waiting on an agent on an open pull request: read each
   thread a person handed to an agent, fix what it says on the pull request's branch,
   reply on the thread with a replacement artifact or a sentence, and push. Use when a
   work item has threads waiting on an agent, or when asked to "answer the review" or
-  "fix what the reviewer failed". Invoke with /amend.
+  "fix what the reviewer failed". Invoke with /outerlayer-amend.
 ---
 
+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.
+
 Answer every thread waiting on an agent on one work item's pull request, then
 stop. A work item has one general thread and one thread per acceptance
 criterion. A person's fail on the general thread leaves it waiting on an agent.

package/skill-pack/maintained/{outerlayer → outerlayer-cli}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: outerlayer
+name: outerlayer-cli
 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.
@@ -9,6 +9,8 @@ description: >
   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.
+
 OuterLayer is a software factory. An issue goes in. A reviewed and verified
 pull request comes out, with the evidence that backs it. An agent builds it in
 this repository, on the machine it already runs on.
@@ -34,9 +36,9 @@ from the output of `outerlayer work build`.
    instead. With `--local`, the person builds it on their own machine with
    `OUTERLAYER_WORK=<number> claude "/build"`.
 4. `outerlayer emit artifact <file> --caption "<what it shows>"` attaches a
-   screenshot, recording, report or log as evidence. The `emitting-evidence`
+   screenshot, recording, report or log as evidence. The `outerlayer-evidence`
    skill says what to capture.
-5. `/amend` answers the review threads a person handed to an agent.
+5. `/outerlayer-amend` answers the review threads a person handed to an agent.
 
 ## Several repositories
 

package/skill-pack/maintained/{emitting-evidence → outerlayer-evidence}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: emitting-evidence
+name: outerlayer-evidence
 description: >
   Emit artifacts — screenshots, recordings, reports, logs — as proof that a
   change works, bound to the pull request via `outerlayer emit artifact`.
@@ -8,6 +8,8 @@ description: >
   works", and in CI steps that produce verifiable output.
 ---
 
+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.
+
 An artifact is an exhibit: evidence *of* a specific change, anchored to the
 pull request and rendered in its evidence comment. Emit the few exhibits the
 spec asks for — a reviewer should see the change working, not a gallery.
@@ -98,7 +100,7 @@ Emit the review report, an HTML file, as a report artifact with no `--for`:
 
     outerlayer emit artifact review.html --caption "Review of the change and what it found"
 
-Then run `outerlayer sync`, and copy the report's deep link from the pull request's evidence comment. Never build the link by hand, and never link a pull request comment. Record the review's verdict on the `code-review` check that `outerlayer init` writes, with that link as its proof:
+Then run `outerlayer sync`. It prints a line for the report that ends with its link (`outerlayer sync --json` lists them under `uploadedArtifacts`). Take the link from that line. If `sync` printed no line for the report, another sync already uploaded it: run `outerlayer sync --link <the artifact id>`, with the id `emit artifact` printed. Never build the link by hand, and never link a pull request comment. Record the review's verdict on the `code-review` check that `outerlayer init` writes, with that link as its proof:
 
     outerlayer emit code-review --item "$OUTERLAYER_WORK" --result pass --link <the report's deep link>
 
@@ -108,7 +110,7 @@ Use `--result fail` when the review left a finding unfixed. Record it once. Outs
 
 Bind the judge's report on each criterion, an HTML file, with `--for acceptance-criteria`. The item page links it at the top of its Criteria tab for the reviewer. Emit it only when the item has recorded criteria.
 
-Then run `outerlayer sync`, copy the report's deep link from the evidence comment the same way, and record the judge's verdict on the `acceptance-criteria` check that `outerlayer init` writes:
+Then run `outerlayer sync`, take the report's deep link from the line it prints the same way, and record the judge's verdict on the `acceptance-criteria` check that `outerlayer init` writes:
 
     outerlayer emit acceptance-criteria --item "$OUTERLAYER_WORK" --result pass --link <the report's deep link>
 

package/skill-pack/maintained/{reporting-findings → outerlayer-findings}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: reporting-findings
+name: outerlayer-findings
 description: >
   Records factory problems: anything in a repository's instructions, tests, tooling or
   local setup that cost an agent time and was not caused by its own change. Use when
@@ -12,6 +12,8 @@ description: >
   `outerlayer emit finding` command.
 ---
 
+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.
+
 ## What this is for
 
 A finding is a problem in the factory, not in the change: an instruction
@@ -88,17 +90,24 @@ server join a finding to a known problem without asking you.
 
 ## Time lost
 
-When you run `outerlayer emit finding` without `--started-at`, it prints your
-recent session events, each with an id and a time:
+Every finding records the time it cost, read from two events of your session
+or its subagents. Never estimate minutes yourself.
+
+- Start: `--started-at <id>`, else the first tool output that shows your
+  `--error` text. Copy `--error` exactly as the output printed it.
+- End: `--ended-at <id>`, else the newest event. Record as soon as you are
+  past the problem, and the default is right.
+
+With no start found, nothing is stored and the recent events are listed:
 
 ```
-e118    14:02:11  agent: Bash: yarn test
+e118           14:02:11  agent: Bash: yarn test
+a5c9fb78:e42   14:09:30  user: result: FAIL src/app.test.ts
 ```
 
-Run it again with `--started-at <id>` for the event where you first hit the
-problem and `--ended-at <id>` for the event where you got past it. The time is
-read from those two events. Never estimate minutes yourself. A finding with no
-events still counts toward how often the problem occurs.
+Run it again with `--started-at`. A prefixed id is a subagent's event.
+`--find <text>` lists older events containing the text. `--untimed` is only
+for a problem that cost no time here. Never pipe the command through `tail`.
 
 ## Linking a finding to a problem
 
@@ -129,33 +138,28 @@ outerlayer emit finding --id <short-id> --category <category> \
   --title "<one sentence>" --file <path> [--line <n>] --where "<what you were doing>" \
   [--cause "<cause>"] [--detail "<text>"] [--suggestion "<text>"] \
   [--command "<cmd>"] [--error "<first error line>"] [--test "<name>"] [--symbol "<function>"] \
-  [--started-at <event id> --ended-at <event id>] \
+  [--started-at <event id>] [--ended-at <event id>] \
   [--problem <id> --link-reason "<why>" | --new]
 ```
 
 Inside a recorded session the work item is found automatically. Outside one,
 add `--item <number>`.
 
-Examples, one per category:
+Examples. The ones with no `--error` name their start:
 
 ```bash
-outerlayer emit finding --id worktree-hooks --category context \
-  --title "No document says a fresh worktree has no git hooks until yarn prepare runs" \
-  --file AGENTS.md --rule-path AGENTS.md --rule-relation missing \
-  --where "first push from a new worktree"
-
 outerlayer emit finding --id stale-path --category context \
   --title "The build skill names a directory that no longer exists" \
   --file .outerlayer/skills/build/SKILL.md --line 42 \
   --rule-path .outerlayer/skills/build/SKILL.md --rule-line 42 --rule-relation broken \
   --rule-quote "Read the plan from reports/plan.md" \
-  --where "implementation stage"
+  --where "implementation stage" --started-at e118
 
 outerlayer emit finding --id flaky-refresh --category flaky-test \
   --title "refresh.test.ts fails once, then passes on rerun" \
   --file apps/tenant-dashboard/src/lib/system/pr-session-comment/__tests__/refresh.test.ts \
   --test "refreshes the comment after a push" \
-  --where "vitest run <file> failed, then passed with no change"
+  --where "vitest run <file> failed, then passed with no change" --started-at e204
 
 outerlayer emit finding --id gate-skip --category tooling \
   --title "The pre-push gate prints green when a step was skipped" \
@@ -164,19 +168,10 @@ outerlayer emit finding --id gate-skip --category tooling \
   --cause "the skip path returns before the summary is computed" \
   --where "expected a failure, got exit 0"
 
-outerlayer emit finding --id shared-db --category environment \
-  --title "A peer session reset the shared Supabase project mid-run" \
-  --file apps/tenant-dashboard/supabase/config.toml \
-  --where "needed a stable database, found it re-seeded"
-
 outerlayer emit finding --id null-read --category defect \
   --title "readItem throws on an item with no claim" \
   --file src/lib/work/read.ts --line 88 --symbol readItem \
-  --where "reproduce: call readItem on a fresh item"
-
-outerlayer emit finding --id slow-hook --category other \
-  --title "The session-start hook adds about ten seconds on every launch" \
-  --file .husky/post-checkout --where "timed with time(1)"
+  --where "reproduce: call readItem on a fresh item" --started-at a5c9fb78:e42
 ```
 
 To record several at once, write a JSON batch and run
@@ -207,9 +202,10 @@ To record several at once, write a JSON batch and run
 }
 ```
 
-`startedAt` and `endedAt` are event ids from `emit finding`'s list, given
-together or not at all. `problems` with `linkReason`, and `new: true`, are
-for a finding that needs a choice; give neither and the server decides by key
+`startedAt` and `endedAt` are event ids, defaulting as in `emit finding`. A
+finding with no start found stops the batch; `"untimed": true` is the
+exception. `problems` with `linkReason`, and `new: true`, are for a finding
+that needs a choice; give neither and the server decides by key
 or lists candidates. `emit findings` stores the findings that match a key,
 lists the ones that need a choice, and exits with code 3.
 

package/skill-pack/shipped.json

@@ -6,15 +6,20 @@
       "78c95632b51600df0cb2e206d843e75789ccba2f80fd8dfab36d16239062b008"
     ],
     ".outerlayer/skills/build/SKILL.md": [
+      "0fe8ee00567a1e8942de27597b0a64588fd4b75abd8fb5cd4998785b3e6c7f2b",
       "5cf9bd75fb1f984f6e6b470d1f1581dc06168abf062448e6f43711fed8f6632a",
       "6177ea457be0d238659640e6d29807708d60d68533ae3ff93af10fb513139ced",
       "77cab8b446fb1aa865710f7cb8356c5334301a942f58f9243766bf1acf1377ad",
       "93953397c31d47a6f1c06edb8ae2190e1d8a3fca20c616deb33991311cee39a8",
       "a6743050c5c387e962ad4264526d9a3c10edf36823e4b6829f200bf79a4e45e7",
       "b0aa9b6962675f772b67a4390c15b6b0100390983d958c656a826a066399f3d0",
+      "b95986e95ea3b1ef4202f7f0c00bfcd35865d4fda033b3d6947a5bb9d33cd24c",
+      "e9d086f6b989e3a17f14d6dcaacabd438bed861076f9a620fce61accc8fce4fb",
       "f4e1661c6f87d7ff6d23c6182530fa0a9cb87c4dc3f31e48f2be11f32ebb2c00"
     ],
     ".outerlayer/skills/build/references/agent-briefs.md": [
+      "09bfa482e1d7f8ceabd29a6e23e74641f3ff6e655126362d27a05df422c584ed",
+      "20eece295abc7ccecd289ce6d408dd3c4c038e2cbfdb3acdba069bd0ccb86496",
       "3c875a4f287f574eea954c6daa52b17529cdeba8ec4007d78084d911350d1218",
       "7c2a651e7c827d8e3fb9df889d3776b552eb02d315db5ace27d2baad78aab6a5"
     ],
@@ -22,19 +27,24 @@
       "62db8f6d77f31ca25a9071c05429e0f639f9b2bdd7f7cb04cb14a1b0db509537"
     ],
     ".outerlayer/skills/build/references/evidence.md": [
+      "557d62885555606d64e86cc9fb16a5e2ee0f2257e6fe2aeec5a294292d57cecf",
       "ceff5488bae31198ed4738ae1a230c0119f973ced439dac360eba6e24e1604f4",
       "f27502610358e436e7ffb61d4fd281289e162f6de6b2c11396f17b2fa63802c9"
     ],
     ".outerlayer/skills/build/references/release.md": [
       "0b0af40c82473cf192f697537ed5a84801a14e79bb11790d72226d7f7f49cca0",
       "1113259bdf7d8c28edcbdb9b4c83c2f2bd4c5eaf817cf30bf428478ff91694e9",
+      "1d0e000433676a39c7ac4fbf3e92b1fe4235b10240c09f87ec0003f3c8d7956e",
       "1f4fe97ca8f11d6681db5734f3103af5ea175a9472ff1d38b10cb463f4956a6a",
       "4687f56bcec766f1926d58a208418f800a1727c073b5e6047b40e3aaac2bd6c9",
+      "4cfc10bc9d380e67b0ec5c243eb5f2c63f03ee3348d7956a45467620acc656fc",
       "81a764eb317fcb4672bedd35e7b9aa68d1c0b73f82fc2dfa03e5a78758db8f14",
       "985e02b98105b00c356014e003b2d60e9c458c3dcbeef7378274ccb84af031fc"
     ],
     ".outerlayer/skills/build/references/review-briefs.md": [
-      "2c8b436795b583a61aa6f98f48611db554f0dd52b27a9ab748a7db5f96526aec"
+      "2c8b436795b583a61aa6f98f48611db554f0dd52b27a9ab748a7db5f96526aec",
+      "8f04427895a01c1b86f1ee2caab983163201c75fafe4c0feba02e8f665089aac",
+      "a9af0ddd115496480702743e628be3206426c40563f03aa4bb1714176ff70146"
     ],
     ".outerlayer/skills/build/references/review-loop.md": [
       "155ab732ccf4c25f000853e98a27a3d2f3a022c75979601bb71d86f07983216d",
@@ -43,19 +53,23 @@
       "9d4d2e5e0307ea8c38cf885cd67d06a939b7fc2bed65f5080ca9610178949d74"
     ],
     ".outerlayer/skills/build/scripts/criterion-citations.mjs": [
-      "0902118ec216182f9d0ba0f6c7966306ad6891d8e846022123d3f86aaf175fce"
+      "0902118ec216182f9d0ba0f6c7966306ad6891d8e846022123d3f86aaf175fce",
+      "aa9446b29c7c8fa4d312b8ec54b2a2a154f52708691a7eaf61e3a1b67ae6a9ef"
     ],
     ".outerlayer/skills/build/scripts/record-criteria.mjs": [
       "36f19e730bc220fa21622b3bb0a306999f038b8220a0a07a1efe21ec0f748729",
       "596e9a78e62cbea040a3bf428cd54bf59687e9e89001fad719304f88d03ca2ea",
-      "64de9445087b247b0781a4e6e025ef97b1259ce1c91819bf541decc26b8f8400"
+      "64de9445087b247b0781a4e6e025ef97b1259ce1c91819bf541decc26b8f8400",
+      "f3d6ed58118209d8b169d00b4283d48f25d3cac5121d2e29364274dd36ed113a"
     ],
     ".outerlayer/skills/spec/SKILL.md": [
       "71e81fabf353ad6117c54e061868538bf00066b78c2528f5a8364445d1def02e",
+      "82f75a53c591f94615dc27c099e94fcf95e2a09b95aceb38b9022d5f7f054cb0",
       "9039ae30d4e836b5c5cfba4a14344e46fd13694ae9e4d88e750abce34dfcd9e6"
     ],
     ".outerlayer/skills/writing-specs/SKILL.md": [
       "a956aac4249118a058c4327c5751472883588720950d4a96f80c7e91f454bef9",
+      "dbadb39cba5dae936e7c4b97cb852c59072e4a60e44caec01b128a045c1be090",
       "eb8aa95f5e76a46ae9bf340989fb40e470fd750ded791ba80b5f8c5c325513e5"
     ],
     ".outerlayer/skills/writing-specs/references/agents-snippet.md": [
@@ -65,10 +79,12 @@
       "b00f5970b568159ca0bfbc75c3834938749ad5e2e73a80769d88bbe3c8c26737"
     ],
     ".outerlayer/validators/acceptance-criteria.yaml": [
-      "3b2054aa1d4bd9f7441e88eec1a3bdf61b61ad00efa79736e26a5dd601d43910"
+      "3b2054aa1d4bd9f7441e88eec1a3bdf61b61ad00efa79736e26a5dd601d43910",
+      "d9bef4bf0962015c662f1bc16d86807414dfc6e095f99aa3727bc4613676ab2a"
     ],
     ".outerlayer/validators/code-review.yaml": [
       "05041976e4d84d6256ed88995ea4fd1566abc6d3a9574863065cf855dcafcf70",
+      "40653bc6b170f28be1df410d9d8e270987184a2d04cbec588ae07f50afa59ba3",
       "fbdf0baca0064b09e47f5984afc322d582accd142c3377c06622bc6567b0e98c"
     ]
   }

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

@@ -8,6 +8,8 @@ description: >
 disable-model-invocation: true
 ---
 
+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.
+
 Build one issue into an evidenced pull request. `/spec` writes and gets
 approval for the issue. This skill builds it. It never writes the spec.
 
@@ -82,7 +84,7 @@ These bind the orchestrator in every phase. Rule 5 also binds every spawned agen
    report bodies. Delete both at the end of phase 6.
    Once a pull request exists, read `outerlayer work threads --item
    "$OUTERLAYER_WORK" --json`. Each thread with `waitingOn` of `agent` holds a
-   person's comment. Answer each before the run ends, as the `amend` skill does.
+   person's comment. Answer each before the run ends, as the `outerlayer-amend` skill does.
 5. **A session never records a pass or fail on an artifact.** It emits
    artifacts. A person decides pass or fail. A build records two results,
    both verdicts of its own agents: its review's, on the `code-review`
@@ -106,6 +108,10 @@ These bind the orchestrator in every phase. Rule 5 also binds every spawned agen
    state file. Past three quarters, say where the count stands in the status
    line. A run that would exceed the budget stops and lists what is left
    unverified. The review phase also holds a limit on agents in flight.
+10. **Factory problems are findings.** Every agent records the problems it
+   hit outside the change with the `outerlayer-findings` skill, as its brief
+   says. The orchestrator records only the ones it hit itself. The final
+   report lists every finding by id.
 
 ## Phases
 

package/skill-pack/template/build/references/agent-briefs.md

@@ -61,6 +61,12 @@ report with the command, and leave that step undone.
 
 A session never records a pass or fail on an artifact.
 
+A problem in the repository's instructions, tests, tooling or setup that
+cost you time, and that the change did not cause, is a finding. Record it with
+the `outerlayer-findings` skill as soon as you are past it, under an id that
+starts with your stage, such as `implement-tooling-1`. End your report with a
+"Factory problems" section that lists each id and title.
+
 Write your full report to the path this brief names. Then return at most ten
 lines. Anything you leave out of the file is lost to the next stage.
 
@@ -218,7 +224,7 @@ ten lines naming the CI conclusion, the mergeability and every failed check.
 
 ## Evidence brief
 
-The shared rules apply, and the emitting-evidence skill governs the emit
+The shared rules apply, and the outerlayer-evidence skill governs the emit
 mechanics. Your inputs are the issue, the pull request number, the criteria
 that declare a proof form, and the instructions-file pointer.
 

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

@@ -12,7 +12,7 @@ earlier phase from the state file.
 The orchestrator does not run the app, drive a browser or emit an artifact
 itself. Spawn one evidence agent in a fresh context on the Evidence brief, with
 the issue, the pull request number, the criteria that declare a proof form, the
-instructions-file pointer and the emitting-evidence skill.
+instructions-file pointer and the outerlayer-evidence skill.
 
 A criterion that declares `proof: screenshot` needs a screenshot bound to its
 id. One that declares `proof: video` needs a video. A screenshot never

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

@@ -23,7 +23,7 @@ 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
+`.outerlayer/skills/outerlayer-cli/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
@@ -48,16 +48,18 @@ request before going on.
 
 ## Record the code review
 
-Once the pull request is linked, run `outerlayer sync`. Copy the review
-report's deep link from the pull request's evidence comment. Never build the
-link by hand, and never link a pull request comment. Then record the review's
-verdict on the `code-review` check, once:
+Once the pull request is linked, run `outerlayer sync`. It prints a line for
+the review report that ends with its link. Take the link from that line. If
+`sync` printed no line for the report, another sync already uploaded it: run
+`outerlayer sync --link <the artifact id>`, with the id `emit artifact`
+printed. Never build the link by hand, and never link a pull request comment.
+Then record the review's verdict on the `code-review` check, once:
 
     outerlayer emit code-review --item "$OUTERLAYER_WORK" --result pass --link <the report's deep link>
 
 Record `--result fail` when the review ended with a blocking finding unfixed.
-When the link has not appeared after a sync, stop and name it as a blocker in
-the final report. Never record the result with another link.
+When neither command gives a link, stop and name it as a blocker in the final
+report. Never record the result with another link.
 
 ## Judge the criteria
 
@@ -83,11 +85,11 @@ that is missing in the evidence phase.
 
 ## Record the criteria verdict
 
-Once the judge's report is synced, copy its deep link from the pull request's
-evidence comment. The link can take up to a minute to appear after the sync.
-If it is not there yet, wait a minute and read the comment again. Never build
-the link by hand, and never link a pull request comment. Then record the
-judge's verdict on the `acceptance-criteria` check, once:
+Once the judge's report is synced, take its deep link from the line `sync`
+printed for it. If `sync` printed no line for the report, run
+`outerlayer sync --link <the artifact id>`, with the id `emit artifact`
+printed. Never build the link by hand, and never link a pull request comment.
+Then record the judge's verdict on the `acceptance-criteria` check, once:
 
     outerlayer emit acceptance-criteria --item "$OUTERLAYER_WORK" --result pass --link <the judge report's deep link>
 

package/skill-pack/template/build/references/review-briefs.md

@@ -38,6 +38,12 @@ git.
 Never ask the user a question. If you need a ruling, state your assumption in
 your report and continue.
 
+A problem in the repository's instructions, tests, tooling or setup that
+cost you time, and that the change did not cause, is a finding. Record it with
+the `outerlayer-findings` skill as soon as you are past it, under an id that
+starts with your stage, such as `implement-tooling-1`. End your report with a
+"Factory problems" section that lists each id and title.
+
 You are a cold adversarial reviewer. You know nothing about how this change
 was built, and that is deliberate. Judge only the branch diff, the issue (its
 criteria, when it has them, are the definition of done), and the