@outerlayer/cli 0.34.0-next.20261026182624 → 0.34.0-next.20261026200155

package/dist/{work-proofs-cmd-YMMDAA6W.js → work-proofs-cmd-LIXV252G.js}

@@ -1,22 +1,22 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { classifyProofs, classifyProofsAt, otherPullRequestHeads, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-GYVMMU3U.js';
-import './chunk-6D7H5DMZ.js';
-import './chunk-JKNOJKVD.js';
+export { classifyProofs, classifyProofsAt, otherPullRequestHeads, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-KR2TIRNQ.js';
+import './chunk-6CK2OC4Q.js';
+import './chunk-QABXXQ67.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-IO2BBKG4.js';
-import './chunk-EUQZAH2W.js';
-import './chunk-Y5YCX6AL.js';
+import './chunk-OKGHWCSK.js';
+import './chunk-O7QPHJWN.js';
+import './chunk-NWHU5G6R.js';
 import './chunk-G2JWZDFA.js';
 import './chunk-ANPNT6PM.js';
-import './chunk-MECW77XP.js';
-import './chunk-NKOM4JKY.js';
+import './chunk-IXPH4EXK.js';
+import './chunk-LYCJQOO2.js';
 import './chunk-7QAJQDHS.js';
 import './chunk-PJDQPF5N.js';
 import './chunk-L5VHGRQE.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-ZQSANKS4.js';
-import './chunk-Z7WMU3RA.js';
+import './chunk-OVNF4LLC.js';
+import './chunk-OOD5NDQA.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
@@ -24,8 +24,8 @@ import './chunk-T2Q7ISPE.js';
 import './chunk-WZBHBH3J.js';
 import './chunk-CRB3POP4.js';
 import './chunk-YQR6E6OV.js';
-import './chunk-FGXT5OXS.js';
-import './chunk-EOTMDIYC.js';
+import './chunk-XFJ7YOPD.js';
+import './chunk-DINRXUQA.js';
 import './chunk-VNVZDWO3.js';
 import './chunk-GJ4KBHBD.js';
 import './chunk-SDAEXUIX.js';

package/dist/{work-proofs-record-NUCWR7ZJ.js → work-proofs-record-MCSA56F5.js}

@@ -1,37 +1,38 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { runWorkComment } from './chunk-JSZRBQY3.js';
-import { resolveProofsItem, ownPullRequest, proofsCommentId, otherPullRequestHeads, classifyProofsAt, kindProblem, proofsCommentBody, runWorkProofs } from './chunk-GYVMMU3U.js';
-import './chunk-6D7H5DMZ.js';
-import { runEmitDemo } from './chunk-ELO5XEES.js';
+import { resolveProofsItem, ownPullRequest, proofsCommentId, otherPullRequestHeads, classifyProofsAt, kindProblem, proofsCommentBody, runWorkProofs } from './chunk-KR2TIRNQ.js';
+import { runWorkComment } from './chunk-EBVK3QBO.js';
+import './chunk-6CK2OC4Q.js';
+import { runEmitDemo } from './chunk-K3ACC2CV.js';
 import { readNewestDemo } from './chunk-ER6KQCVJ.js';
-import { runEmitArtifact } from './chunk-XL2MPORM.js';
-import { runSync } from './chunk-VUQKGBIQ.js';
-import './chunk-XSFR76J7.js';
+import { runEmitArtifact } from './chunk-QWXBWOVV.js';
+import { runSync } from './chunk-QRJIBTNQ.js';
+import './chunk-7DK2FOZ4.js';
 import './chunk-ESVW4MJY.js';
 import './chunk-TBT347UY.js';
 import './chunk-2PGI6RDE.js';
+import './chunk-TQMI335S.js';
 import './chunk-4UPET3R7.js';
-import { WorkCommandError, resolveCredentials, getJson } from './chunk-JKNOJKVD.js';
+import { WorkCommandError, resolveCredentials, getJson } from './chunk-QABXXQ67.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-IO2BBKG4.js';
-import './chunk-EUQZAH2W.js';
-import './chunk-Y5YCX6AL.js';
+import './chunk-OKGHWCSK.js';
+import './chunk-O7QPHJWN.js';
+import './chunk-NWHU5G6R.js';
 import './chunk-G2JWZDFA.js';
 import './chunk-ANPNT6PM.js';
-import './chunk-MECW77XP.js';
-import './chunk-NKOM4JKY.js';
+import './chunk-IXPH4EXK.js';
+import './chunk-LYCJQOO2.js';
 import { defaultFetch } from './chunk-7QAJQDHS.js';
 import './chunk-PJDQPF5N.js';
 import './chunk-L5VHGRQE.js';
-import './chunk-NHEU5CON.js';
+import './chunk-CCHSD7RS.js';
 import './chunk-ZJSNLVCE.js';
 import './chunk-2O5KA67H.js';
 import './chunk-BKO6JEZI.js';
 import './chunk-HCVLP7XA.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-ZQSANKS4.js';
-import { resolveRepoIdentity } from './chunk-Z7WMU3RA.js';
+import './chunk-OVNF4LLC.js';
+import { resolveRepoIdentity } from './chunk-OOD5NDQA.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
@@ -41,8 +42,8 @@ import './chunk-CRB3POP4.js';
 import './chunk-URIZRCRY.js';
 import './chunk-YQR6E6OV.js';
 import './chunk-TUSYOL2O.js';
-import { parseProofsConfig } from './chunk-FGXT5OXS.js';
-import { ARTIFACT_MAX_CAPTION_LENGTH } from './chunk-EOTMDIYC.js';
+import { parseProofsConfig } from './chunk-XFJ7YOPD.js';
+import { ARTIFACT_MAX_CAPTION_LENGTH } from './chunk-DINRXUQA.js';
 import './chunk-VNVZDWO3.js';
 import './chunk-GJ4KBHBD.js';
 import './chunk-SDAEXUIX.js';

package/dist/{work-stop-cmd-MRLJEQRP.js → work-stop-cmd-SAT4XVM2.js}

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { resolveCredentials, postJson, WorkCommandError } from './chunk-JKNOJKVD.js';
+import { resolveCredentials, postJson, WorkCommandError } from './chunk-QABXXQ67.js';
 import './chunk-IP7BIBXJ.js';
-import './chunk-IO2BBKG4.js';
-import './chunk-EUQZAH2W.js';
-import './chunk-Y5YCX6AL.js';
+import './chunk-OKGHWCSK.js';
+import './chunk-O7QPHJWN.js';
+import './chunk-NWHU5G6R.js';
 import './chunk-G2JWZDFA.js';
 import './chunk-ANPNT6PM.js';
-import './chunk-MECW77XP.js';
-import './chunk-NKOM4JKY.js';
+import './chunk-IXPH4EXK.js';
+import './chunk-LYCJQOO2.js';
 import { defaultFetch } from './chunk-7QAJQDHS.js';
 import './chunk-PJDQPF5N.js';
 import './chunk-L5VHGRQE.js';
 import './chunk-BJ3KTMDH.js';
-import './chunk-ZQSANKS4.js';
-import './chunk-Z7WMU3RA.js';
+import './chunk-OVNF4LLC.js';
+import './chunk-OOD5NDQA.js';
 import './chunk-5BHIBJDA.js';
 import './chunk-CDDED64E.js';
 import './chunk-RA3O54FC.js';
 import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
 import './chunk-CRB3POP4.js';
-import './chunk-FGXT5OXS.js';
-import './chunk-EOTMDIYC.js';
+import './chunk-XFJ7YOPD.js';
+import './chunk-DINRXUQA.js';
 import './chunk-VNVZDWO3.js';
 import './chunk-GJ4KBHBD.js';
 import './chunk-SDAEXUIX.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outerlayer/cli",
-  "version": "0.34.0-next.20261026182624",
+  "version": "0.34.0-next.20261026200155",
   "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.",
   "license": "Apache-2.0",
   "author": "Magu Studios, Inc.",

package/skill-pack/maintained/outerlayer-build/references/agent-briefs.md

@@ -277,12 +277,26 @@ tests at HEAD that hold the id of each proof that is not current, and runs them.
   files go.
 - A demo test uses `@outerlayer/playwright`, one chapter for each screenshot or
   video criterion in the criteria's order, as the outerlayer-evidence skill's
-  "Record a demo" says. The fixture writes the manifest where
-  `OUTERLAYER_PROOF_OUT` names.
+  "Record a demo" says. Tell each chapter in beats with `demo.say()`: sign in
+  once, and seed and wait between beats, so the demo shows only narrated
+  steps. Render it with `outerlayer emit demo <manifest> --output demo.webm`
+  and watch it before you commit the test. The fixture writes the manifest
+  where `OUTERLAYER_PROOF_OUT` names.
 - A report, log or file proof is a test, in any language, that writes
   `$OUTERLAYER_PROOF_OUT/<criterion id>.<ext>`. The kind of the file must be the
   kind the criterion declares. The test writes outside the repository, so there is
   nothing to ignore or commit.
+- A `test` proof is a JUnit XML file of test results, bound to the criterion.
+  `--record` does not record it, so record it yourself, unless the policy file
+  sets `criteria.test_proof: ci`. CI then records it. Run the repository's test
+  command with its JUnit reporter, such as
+  `vitest run --reporter=junit --outputFile=<file>`, `pytest --junitxml=<file>`
+  or `node --test --test-reporter=junit --test-reporter-destination=<file>`.
+  Write the file outside the repository. Then run
+  `outerlayer emit artifact <file> --caption "<one sentence>" --for <criterion id>`.
+  Add `--test "<test name>"` for each test that cites the criterion, unless the
+  criterion is about the whole suite. To replace an earlier result, add
+  `--replaces <its id>`.
 - A proof that no test can make stays without a test. Give the reason in
   `build-reports/evidence.md`.
 
@@ -290,7 +304,7 @@ Commit the setup file and every test. Then run
 `outerlayer work proofs --record` from the committed checkout. It stops when a
 tracked file differs from HEAD. It runs only what is committed at HEAD, and
 emits each proof at HEAD. It skips a proof that is current. Never emit by hand
-a proof that a test can make. Always pass `--pr <number>` when the item links
+a proof that a test can make, except a `test` proof, as above. Always pass `--pr <number>` when the item links
 more than one pull request in the repository.
 
 The output names each proof that is still not current, with the reason. Fix

package/skill-pack/maintained/outerlayer-build/references/evidence.md

@@ -10,7 +10,7 @@ earlier phase from the state file.
 ## The phase
 
 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
+itself. The one exception is the test results it records at the last head. 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 outerlayer-evidence skill.
 
@@ -45,6 +45,11 @@ proof that is not current and skips the rest. If a commit lands after that,
 record once more after it. The final report names that head and the proofs
 recorded there.
 
+`--record` skips a criterion that declares `proof: test`, and the list command
+leaves it out. So at that same head, record each one as the Evidence brief in
+[agent-briefs.md](agent-briefs.md) says, unless the policy file sets
+`criteria.test_proof: ci`. The final report names each one with its artifact.
+
 Run the list command once more before the run ends. A criterion still listed
 as out of date or missing goes in `build-reports/evidence.md` with the reason.
 A written reason never excuses an `uncited` or `failed` row. Fix it first. Never

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

@@ -78,51 +78,30 @@ the recorded list does not hold gets no row.
 
 ## Record a demo
 
-Record every video proof as a chapter of the item's one demo. A demo has
-one chapter for each criterion that declares a video, in the criteria's
-order. Each chapter is that criterion's video proof, with a spoken line and the
-checks that ran. Emit a video with `emit artifact` only when Playwright cannot
-drive the flow.
+Record every video proof, and every `proof: screenshot` criterion a test can
+reach, as a chapter of the item's one demo. Emit a video with `emit artifact`
+only when Playwright cannot drive the flow.
 
-Write a Playwright test with `@outerlayer/playwright`, one `demo.chapter`
-for each criterion:
+A demo plays like a person showing the app. Tell each chapter in beats with
+`demo.say(line, steps)`: the line is spoken while its steps run on screen.
+The demo shows only beats, so sign in, seed data and wait outside them. Show
+a CLI step with `demo.terminal()`. The recorder, `@outerlayer/playwright`,
+releases with the CLI: install it at the CLI's version first. The test, and
+the rules a reviewer holds it to, are in
+[references/demo.md](references/demo.md).
 
-    import { expect, test } from "@outerlayer/playwright";
-
-    test("a member signs in", async ({ page, demo }) => {
-      await page.goto("/login");
-      await demo.chapter("LOGIN-01", "Sign in", "The member signs in and lands on the dashboard.", async () => {
-        await page.getByRole("button", { name: "Sign in" }).click();
-        await expect(page.getByRole("heading", { name: "Dashboard" })).toBeVisible();
-      });
-    });
-
-Commit the test: `work proofs --record` finds it by its chapter ids.
-
-Record each `proof: screenshot` criterion as a chapter too. Call `await
-demo.screenshot()` inside it, right after the `expect` that shows the result.
-Options: `{ fullPage: true }`, `{ masks: true }`. `emit demo` stores the frame
-when every check passed, or says why not.
-
-Install it with `npm install --save-dev @outerlayer/playwright`. Use the
-recorded criterion id as the first argument, or `null` for an opening scene.
-Keep each narration line short. Put the `expect` calls that prove the
-criterion inside the chapter: each is recorded as a check.
-
-Run the test. It writes `demo/manifest.json` and `demo/video.webm` in the
-test's output folder. Then emit the demo:
+Commit the test: `work proofs --record` finds it by its chapter ids. Run it,
+then emit the demo:
 
     outerlayer emit demo test-results/<test folder>/demo/manifest.json
 
-The command stores the whole demo as one video and uploads its bytes once.
-Each chapter is its own video proof with a time range in that video. A
-chapter whose checks all passed is bound to its criterion. A chapter with
-a failed check is stored unbound, and the command exits 1: fix the app and
-record again. The command needs `ffmpeg` and `espeak-ng` on PATH. Pass
-`--no-narration` when you cannot install `espeak-ng`. It refuses before it
-uploads anything when a chapter is out of order, a criterion id is not
-recorded, a line is too long, or a chapter's clip is over 8 MiB. A video over 8 MiB falls back to one clip
-for each chapter. A runner build has everything installed.
+Pass `--output demo.webm` first and watch the demo. The command shows only
+the beats and cuts each stretch in which the screen does not move and nothing
+is said. It refuses a demo that still holds one over 2 s, a chapter id that is
+not recorded, or a line too long for its beat. A chapter whose checks all
+passed is bound to its criterion. A chapter with a failed check is stored
+unbound, and the command exits 1: fix the app and record again. It needs
+`ffmpeg` and `espeak-ng`. A runner build has both.
 
 ## The noise rule
 

package/skill-pack/maintained/outerlayer-evidence/references/demo.md

@@ -0,0 +1,75 @@
+# Write a demo
+
+A demo is a reviewer's first look at the change. It plays like a person
+showing the app: each step happens on screen while a line says what it is.
+Setup, sign-ins and waits never reach the video.
+
+## The test
+
+The fixture, `@outerlayer/playwright`, releases with the CLI at the same
+version. `outerlayer --version` prints the CLI's version first. Before you
+write the test, install the fixture at that version with the repository's
+package manager. Commit that change with the test. Keep a newer version, and
+keep a `workspace:` dependency as it is. Import `test` and `expect` from the
+fixture:
+
+    import { expect, test } from "@outerlayer/playwright";
+
+    test("a member saves a build variable", async ({ page, demo }) => {
+      await signIn(page);                 // setup: outside every beat
+      await page.goto("/settings");
+      await demo.chapter("AC-7-02", "Save a variable", async () => {
+        await demo.say("The member saves a variable named NPM token.", async () => {
+          await page.getByLabel("Name").fill("NPM_TOKEN");
+          await page.getByRole("button", { name: "Save" }).click();
+          await expect(page.getByText("The variable is saved")).toBeVisible();
+        });
+        await page.reload();              // setup: the demo cuts it
+        await demo.say("After a reload, the list shows its name and no value.", async () => {
+          await expect(page.getByText("NPM_TOKEN")).toBeVisible();
+          await demo.screenshot();
+        });
+      });
+    });
+
+Each beat lasts as long as its line. Inside a beat a pointer moves to each
+click, `fill` types its text, and the page scrolls smoothly. Set
+`OUTERLAYER_CLI` to the CLI so each beat is timed to its real line.
+
+## Rules
+
+- One chapter for each criterion that declares `video` or `screenshot`, in
+  the criteria's order. Its first argument is the recorded id. `null` names
+  an opening scene, and only the first chapter may use it.
+- One persona in one organization. Sign in once, before the first chapter.
+  Never sign out and in again to change state.
+- Change state between beats: through the app where a screen exists, or
+  directly where none does. The demo leaves it out, so a long wait costs
+  nothing.
+- One beat for each step a viewer should see. Its line says what happens,
+  in the present tense, in one or two short sentences. Do not read
+  criterion ids aloud.
+- Inside a beat, move between pages through the app's own links. Reload a
+  list between beats.
+- Put each `expect` that proves the criterion inside a beat: it is a check.
+  Call `await demo.screenshot()` right after the check that shows a
+  screenshot criterion's result.
+- Show a step outside the browser with
+  `await demo.terminal(command, run)`. Return the command's real output from
+  `run`, and check it.
+- Show a call to an API with `await demo.http({ method, url, body }, run)`
+  when a criterion's proof is an API response, or a step goes through the
+  API and no page shows it. Return the real `{ status, body }` from `run`.
+- Point to the one element a line talks about on a busy page with
+  `await demo.highlight(locator)`, such as a status in a long list. Highlight
+  at most one element in a beat, and none where the element is plain to see.
+- Turn off `demoOptions.animations` to keep the app's own transitions. Each
+  still and screenshot stops motion either way.
+
+## Before you emit
+
+Render the demo with `outerlayer emit demo <manifest> --output demo.webm`
+and watch it. Fix a beat that shows a loading screen, a sign-in or a step
+its line does not name. The command exits 1 while the demo holds a frozen,
+silent stretch over 2 s. When it notes that the fixture's version is not the
+CLI's, install the version it names and record the demo again.