@outerlayer/cli 0.34.0-next.20261026184303 → 0.34.0-next.20261026214534

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.20261026184303",
+  "version": "0.34.0-next.20261026214534",
   "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,8 +277,11 @@ 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

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.