@outerlayer/cli 0.33.0-next.20261022160949 → 0.33.0-next.20261022161023

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"id":"2026-10-22T16:11:53.196Z+8818aa0","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}
1
+ {"id":"2026-10-22T16:41:55.061Z+a212c93","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@outerlayer/cli",
3
- "version": "0.33.0-next.20261022160949",
3
+ "version": "0.33.0-next.20261022161023",
4
4
  "description": "OuterLayer CLI — commands: init, claude, connect, doctor, login, logout, sync, daemon (alias: watch), emit, findings, work, spec, runner, hooks, mcp, context. Capture and sync coding-agent sessions, and record proof of factory work.",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Magu Studios, Inc.",
@@ -9,7 +9,7 @@ description: >
9
9
  the reviewer failed". Invoke with /outerlayer-amend.
10
10
  ---
11
11
 
12
- 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.
12
+ 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. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
13
13
 
14
14
  Answer every thread waiting on an agent on one work item's pull request, then
15
15
  stop. A work item has one general thread and one thread per acceptance
@@ -67,10 +67,10 @@ change, to its own branch only.
67
67
  `criterion` (null for the general thread), `waitingOn` (`agent`, `person` or
68
68
  null), `verdict`, `proof` and `comments`, each comment with its `author`,
69
69
  `body`, `action` and `artifact`. Keep the threads whose `waitingOn` is
70
- `agent`: one send of notes can leave several.
71
- If none is waiting and step 1 resolved no conflict, say so and stop: there
72
- is nothing to answer. Take the pull request (`repository`, `prNumber`) from
73
- the step 1 status JSON's `pullRequests`.
70
+ `agent`.
71
+ If none is waiting and step 1 resolved no conflict, say so and stop. Take
72
+ the pull request (`repository`, `prNumber`) from the step 1 status JSON's
73
+ `pullRequests`.
74
74
  3. **Re-orient.** The status JSON's `issue.body` is OuterLayer's copy of the
75
75
  issue. It is the spec: find each thread's criterion there. Read the pull
76
76
  request, with its evidence comment, through the git host. Read every person's comment since the last agent
@@ -80,8 +80,7 @@ change, to its own branch only.
80
80
  `reason`. When a person asks you to fix failing checks or criteria, fix
81
81
  each failing check item by its reason.
82
82
  4. **Decide each thread.** Reply on every criterion thread waiting on an
83
- agent, with `--criterion`, so each note gets its answer under it. Read each
84
- note and pick one:
83
+ agent, with `--criterion`. Read each note and pick one:
85
84
  - **Answer it.** A question gets an answer. Reply with the answer and
86
85
  change nothing. Say which file or test you looked at.
87
86
  - **Fix it.** A requested change gets a fix. Change the code, tests, docs or
@@ -139,13 +138,12 @@ change, to its own branch only.
139
138
  and why. Post the lines once on the general thread:
140
139
  `outerlayer work comment --item "$OUTERLAYER_WORK" --body "<the lines>"`.
141
140
  A plain comment from an agent leaves the general thread waiting on a person.
142
- A local session also posts them on the pull request; a build's token
143
- cannot. End with the same lines.
141
+ A local session also posts them on the pull request. End with the same lines.
144
142
 
145
143
  ## Rules
146
144
 
147
- - **Answer only threads waiting on an agent.** A thread waiting on a person, or
148
- on no one, is not yours to reply on.
145
+ - **Answer only threads waiting on an agent.** Never reply on one waiting on a
146
+ person or on no one.
149
147
  - **One thread, one proof.** Never attach an artifact that does not prove that
150
148
  thread's criterion.
151
149
  - **A person decides.** Never pass `--pass` or `--fail`, never mark a check as
@@ -7,7 +7,7 @@ description: >
7
7
  skill tells you to. Only the `build` skill starts it.
8
8
  ---
9
9
 
10
- 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.
10
+ 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. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
11
11
 
12
12
  Build one issue into an evidenced pull request. `/spec` writes and gets
13
13
  approval for the issue. This skill builds it. It never writes the spec.
@@ -9,7 +9,7 @@ description: >
9
9
  attach evidence or answer a review.
10
10
  ---
11
11
 
12
- 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.
12
+ 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. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
13
13
 
14
14
  OuterLayer is a software factory. An issue goes in. A reviewed and verified
15
15
  pull request comes out, with the evidence that backs it. An agent builds it in
@@ -8,7 +8,7 @@ description: >
8
8
  works", and in CI steps that produce verifiable output.
9
9
  ---
10
10
 
11
- 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.
11
+ 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. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
12
12
 
13
13
  An artifact is an exhibit: evidence *of* a specific change, anchored to the
14
14
  pull request and rendered in its evidence comment. Emit the few exhibits the
@@ -12,7 +12,7 @@ description: >
12
12
  `outerlayer emit finding` command.
13
13
  ---
14
14
 
15
- 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.
15
+ 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. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
16
16
 
17
17
  ## What this is for
18
18
 
@@ -74,8 +74,7 @@ title.
74
74
 
75
75
  ## What to record in a finding
76
76
 
77
- Fill these in whenever you know them. They are what lets the next agent
78
- recognise the problem and fix its cause.
77
+ Fill these in whenever you know them.
79
78
 
80
79
  - `--cause`: what is actually wrong. Write `unknown` when you do not know.
81
80
  - `--detail`: what happened, a few paragraphs.
@@ -124,9 +123,8 @@ failure: read the candidates, then run the same command again:
124
123
  - `--new` when none of them is the same problem. Use it rather than linking
125
124
  the nearest one.
126
125
 
127
- `--problem` always needs `--link-reason`. Apply rule 1 to every candidate: the
128
- same error is not enough, one fix has to resolve both. If a candidate's
129
- reports carry a different cause, it is a different problem.
126
+ `--problem` always needs `--link-reason`. Apply rule 1 to every candidate. If
127
+ a candidate's reports carry a different cause, it is a different problem.
130
128
 
131
129
  If a key of your finding is owned by a problem, the finding joins that problem
132
130
  whatever `--problem` you named, and the output says so.
@@ -86,6 +86,7 @@
86
86
  "82f75a53c591f94615dc27c099e94fcf95e2a09b95aceb38b9022d5f7f054cb0",
87
87
  "8d3a5131d0c82302279d319c51bcde74f7677e8d2e3f6cd68aa7f3ea84fa1051",
88
88
  "9039ae30d4e836b5c5cfba4a14344e46fd13694ae9e4d88e750abce34dfcd9e6",
89
+ "ba26711f3ac400f38e2bb78d4e410cde940e666317cd9aeb3fa949d89bb39f15",
89
90
  "fc2bec8d43764c4e4b40b0ee761b7f9ee8646950dd4e52392f652e68679f79ea"
90
91
  ],
91
92
  ".outerlayer/skills/writing-specs/SKILL.md": [
@@ -9,7 +9,7 @@ description: >
9
9
  /spec <what you want built>.
10
10
  ---
11
11
 
12
- 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.
12
+ 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. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
13
13
 
14
14
  Take one idea from a sentence to an issue a person can build from. This file
15
15
  is the procedure. The content discipline is the `writing-specs` skill: summary