@outerlayer/cli 0.40.0-next.20261116130619 → 0.40.0-next.20261116150436

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.
Files changed (33) hide show
  1. package/dist/build-info.json +1 -1
  2. package/dist/{check-7ZXMFO5K.js → check-TEABORIU.js} +5 -5
  3. package/dist/{chunk-UBSNF6VG.js → chunk-54J6P6BH.js} +1 -1
  4. package/dist/{chunk-DWZWXWZP.js → chunk-5KM5STHU.js} +1 -1
  5. package/dist/{chunk-3C2NLRL3.js → chunk-6ZHZXUFW.js} +1 -1
  6. package/dist/{chunk-MI2XJJTC.js → chunk-GNQF6XLZ.js} +5 -5
  7. package/dist/{chunk-K5CV7Y7U.js → chunk-JOED4C6S.js} +1 -1
  8. package/dist/{chunk-7FE6NARL.js → chunk-LUDRPWCQ.js} +1 -1
  9. package/dist/{chunk-FKIZCJOQ.js → chunk-XDVNW7TR.js} +3 -3
  10. package/dist/{chunk-ZSGCCX5U.js → chunk-XJVLKMQS.js} +1 -1
  11. package/dist/{chunk-4UDSLKAQ.js → chunk-YW35ZKUI.js} +6 -1
  12. package/dist/{cli-OAJGSXFK.js → cli-6ZKRVTHP.js} +38 -34
  13. package/dist/{command-TVXXAAXE.js → command-GUYK5W3K.js} +2 -2
  14. package/dist/{container-start-VHUXUJY4.js → container-start-OP4KPMQD.js} +3 -3
  15. package/dist/{doctor-VA2UFJFP.js → doctor-NP25CNXL.js} +3 -3
  16. package/dist/{host-checks-C2GDXJPJ.js → host-checks-5QZYFP37.js} +1 -1
  17. package/dist/index.js +1 -1
  18. package/dist/{init-4ERBO6N5.js → init-FP3RUUA5.js} +1 -1
  19. package/dist/{init-SCINBONF.js → init-IXL4YFO3.js} +1 -1
  20. package/dist/{init-agent-6UGX75WR.js → init-agent-ZUTFIH6K.js} +1 -1
  21. package/dist/{init-cmd-MXQZ4PRU.js → init-cmd-CXIVHTCB.js} +2 -2
  22. package/dist/{loop-DE37FAAT.js → loop-GFVQWJZ3.js} +5 -5
  23. package/dist/{machine-4JUM7RCO.js → machine-OTZR4ZMD.js} +1 -1
  24. package/dist/{runner-key-ZTHDMU44.js → runner-key-UK6POYN4.js} +1 -1
  25. package/dist/{setup-wiring-Z7WTN6R6.js → setup-wiring-W4LVR7LO.js} +3 -3
  26. package/dist/{status-CA5UYVDR.js → status-EXAXEXJ7.js} +1 -1
  27. package/dist/{update-steps-E4R6PAT3.js → update-steps-K2TLHXOV.js} +2 -2
  28. package/dist/{work-proofs-cmd-OFJ442KJ.js → work-proofs-cmd-IBJ4EUN3.js} +1 -1
  29. package/dist/{work-proofs-record-7JY3GSP2.js → work-proofs-record-QJB44PQV.js} +1 -1
  30. package/package.json +1 -1
  31. package/skill-pack/maintained/outerlayer-build/SKILL.md +26 -10
  32. package/skill-pack/maintained/outerlayer-build/references/agent-briefs.md +74 -55
  33. package/skill-pack/maintained/outerlayer-build/references/evidence.md +27 -20
@@ -1 +1 @@
1
- {"id":"2026-11-16T13:30:35.989Z","root":"/home/runner/work/outerlayer/outerlayer","pkg":"outerlayer"}
1
+ {"id":"2026-11-16T15:13:18.590Z","root":"/home/runner/work/outerlayer/outerlayer","pkg":"outerlayer"}
@@ -1,17 +1,17 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { probeCredentials } from './chunk-MI2XJJTC.js';
3
+ import { probeCredentials } from './chunk-GNQF6XLZ.js';
4
4
  import './chunk-7MVTX74D.js';
5
5
  import './chunk-E7R2GIAW.js';
6
- import './chunk-DWZWXWZP.js';
7
- import './chunk-ZSGCCX5U.js';
6
+ import './chunk-5KM5STHU.js';
7
+ import './chunk-XJVLKMQS.js';
8
8
  import './chunk-TXKHD4Q6.js';
9
9
  import './chunk-5XAV7LGB.js';
10
10
  import './chunk-H32FCHB5.js';
11
- import { fleetConfigProblem, managedProblems, managedFactsOf, askFleetMachine } from './chunk-K5CV7Y7U.js';
11
+ import { fleetConfigProblem, managedProblems, managedFactsOf, askFleetMachine } from './chunk-JOED4C6S.js';
12
12
  import './chunk-ETXP6DPT.js';
13
13
  import { findServiceUnit } from './chunk-VCPR7TRU.js';
14
- import { createGatewaySandboxClient, gatewayRefusalReason, placeholderQueues, placeholderProblem, permissionModeProblems, permissionModeProblem, HELPER_ENV, helperSocketPath, probeHelper, needsAgentCredential, agentCredentialCheck, claimPermissionProblem, formerSkillQueues, modellessQueues, formerSkillProblem, modellessProblem } from './chunk-4UDSLKAQ.js';
14
+ import { createGatewaySandboxClient, gatewayRefusalReason, placeholderQueues, placeholderProblem, permissionModeProblems, permissionModeProblem, HELPER_ENV, helperSocketPath, probeHelper, needsAgentCredential, agentCredentialCheck, claimPermissionProblem, formerSkillQueues, modellessQueues, formerSkillProblem, modellessProblem } from './chunk-YW35ZKUI.js';
15
15
  import './chunk-JXZ3LIHN.js';
16
16
  import './chunk-J74SL6JI.js';
17
17
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { summarizeChecks, summaryText, renderDoctorText } from './chunk-7FE6NARL.js';
3
+ import { summarizeChecks, summaryText, renderDoctorText } from './chunk-LUDRPWCQ.js';
4
4
  import { shellFunctionInstalled, removeShellFunction, installShellFunction, SHELL_FUNCTION_LINE } from './chunk-4KCWAP5L.js';
5
5
  import { runConnect, hasUncommittedPolicy, commitCommandsFor } from './chunk-RZRR2IUL.js';
6
6
  import { C } from './chunk-2AM6Z5BP.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { scrubReason, stripTerminalControls } from './chunk-4UDSLKAQ.js';
3
+ import { scrubReason, stripTerminalControls } from './chunk-YW35ZKUI.js';
4
4
  import { checkFit, RUNNER_RESERVE_BYTES } from './chunk-3BA7WFT5.js';
5
5
  import { RunnerAlreadyRunningError, readPidFile } from './chunk-LAMPJU6V.js';
6
6
  import { isSameProcess } from './chunk-JBJTC3UU.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { helperSocketPath } from './chunk-4UDSLKAQ.js';
3
+ import { helperSocketPath } from './chunk-YW35ZKUI.js';
4
4
  import { UNIT_MARKER } from './chunk-3BA7WFT5.js';
5
5
  import { runnerDir } from './chunk-QZ3QG4FE.js';
6
6
  import { createHash } from 'crypto';
@@ -2,14 +2,14 @@
2
2
  import { createRequire } from 'node:module';
3
3
  import { readHousekeepingRecord, writeHousekeepingRecord } from './chunk-7MVTX74D.js';
4
4
  import { fetchVersionMeta, npmVersion, npmSupportsProvenance, fetchTarballDigest, fetchProvenance, installVersion, auditSignatures } from './chunk-E7R2GIAW.js';
5
- import { reportFailedStart, fitImageBuildMemory } from './chunk-DWZWXWZP.js';
6
- import { renderUpdateSteps } from './chunk-ZSGCCX5U.js';
5
+ import { reportFailedStart, fitImageBuildMemory } from './chunk-5KM5STHU.js';
6
+ import { renderUpdateSteps } from './chunk-XJVLKMQS.js';
7
7
  import { decideInstalledSwitch } from './chunk-TXKHD4Q6.js';
8
8
  import { writeFleetState } from './chunk-5XAV7LGB.js';
9
9
  import { writePendingUpdate } from './chunk-H32FCHB5.js';
10
- import { fleetConfigProblem, realBlockedProbes, sliceMemoryOf, checkBlockedWithSlots, largeBuildMemoryBytes, LARGE_BUILD_DISK_BYTES, checkManagedRoom, askFleetMachine } from './chunk-K5CV7Y7U.js';
10
+ import { fleetConfigProblem, realBlockedProbes, sliceMemoryOf, checkBlockedWithSlots, largeBuildMemoryBytes, LARGE_BUILD_DISK_BYTES, checkManagedRoom, askFleetMachine } from './chunk-JOED4C6S.js';
11
11
  import { writeMarker, readMarker, currentVersion, removeMarker, isInLayout, startedThroughCurrent, entryIn, versionDir, switchCurrent, cleanVersions, stagingDir } from './chunk-ETXP6DPT.js';
12
- import { leaseTimeLeftMs, createContainerRuntime, withTunnelLog, itemTag, releaseLease, runDecision, claimRun, LEASE_SECONDS, isUnfinished, prepareResume, restoreSessionIntoMicroVm, restoreSessionIntoContainer, restoreSessionIntoSandbox, restoreWork, keptSessionDir, workRestoredEnv, sessionGuestOfMicroVm, sessionGuestOfContainer, sessionGuestOfSandbox, recordsProofsOnly, itemScope, attemptNote, fetchManagedClaudeKey, holdManagedClaudeKey, fetchManagedBuildSettings, holdManagedBuildSettings, setStage, jobEnv, runHook, describeHookEnd, needsBuildSkill, provisionContainer, leaseExpiresAtMs, withJobTimeLimit, deliverContainerHooks, provisionSandbox, deliverSandboxHooks, provisionMicroVm, deliverCommitHooks, provisionEnvironment, readProvisionOut, resolveHostBuild, workdirProblem, listenOnBroker, hostEnvironment, deliverExecMaven, runWithSpawn, hostCommandEnvironment, lifecycleSteps, execArgv, lifecycleFailureReason, decideHostBuildSkill, prepareBranch, keptCommitsLine, currentSkillCommand, formerSkillProblem, commandLogOffset, startSandboxCommand, MICROVM_COMMAND_DIR, startMicroVmCommand, microVmCommandLine, runCommand, containerCommandExec, execCommandLine, startSender, startHostServices, finishJob, sampleGuest, foldSample, isSandboxTracked, isContainerTracked, isMicroVmTracked, probeSandboxCommand, probeMicroVmCommand, probeCommand, appendCommandLog, judgeProbe, SandboxGoneError, SandboxContainerStoppedError, EXIT_CODE_FILE, isTracked, isGroupAlive, outcomeFromExitCode, isIsolatedJob, jobTimeLimitMinutes, isTimedOut, readCpuUsec, isIdle, HELPER_ENV, setUpRunnerCgroup, stopOrphanedMicroVms, unfinishedJobs, sweepImageBuilders, listUnreadableJobs, listAdoptableJobs, retryFailedReleases, recoverLostJobs, GUEST_USAGE_INTERVAL_MS, vmAlive, filesAreCopied, inSandbox, listItemDisks, usableCpus, hookLimitsFor, runCommandOf, AttemptLogBook, environmentFor, builtOf, judgeCredential, readWorkItem, makeRecorder, microVmOomKills, needsRenew, renewRun, renewLease, RENEW_INTERVAL_SECONDS, stoppedHelperReason, measureDisk, listTrackedJobs, sweepSandboxes, keptSandboxIds, parseCpuList, ensureTunnel, keepGhConfigCurrent, restartSender, rejoinSandboxBuild, createHousekeepingDocker, housekeepingDockerIfReachable, runHousekeeping, shellQuote, jobRecordsClaim, freeItemDisksUntil, savedStatesDir, readRecords, removeOldestUntil, treeFileText, timeoutAfter, scrubReason, ensureNetworkReady, ADOPTED_FETCH_RETRY_WINDOW_MS, managedBuildSettingsFor, gitRemoteFor, startServicesFor, installTrust, createLeaseChannel, serveLease, writeGuestGhConfig, deliverJobFiles, inTeardown } from './chunk-4UDSLKAQ.js';
12
+ import { leaseTimeLeftMs, createContainerRuntime, withTunnelLog, itemTag, releaseLease, runDecision, claimRun, LEASE_SECONDS, isUnfinished, prepareResume, restoreSessionIntoMicroVm, restoreSessionIntoContainer, restoreSessionIntoSandbox, restoreWork, keptSessionDir, workRestoredEnv, sessionGuestOfMicroVm, sessionGuestOfContainer, sessionGuestOfSandbox, recordsProofsOnly, itemScope, attemptNote, fetchManagedClaudeKey, holdManagedClaudeKey, fetchManagedBuildSettings, holdManagedBuildSettings, setStage, jobEnv, runHook, describeHookEnd, needsBuildSkill, provisionContainer, leaseExpiresAtMs, withJobTimeLimit, deliverContainerHooks, provisionSandbox, deliverSandboxHooks, provisionMicroVm, deliverCommitHooks, provisionEnvironment, readProvisionOut, resolveHostBuild, workdirProblem, listenOnBroker, hostEnvironment, deliverExecMaven, runWithSpawn, hostCommandEnvironment, lifecycleSteps, execArgv, lifecycleFailureReason, decideHostBuildSkill, prepareBranch, keptCommitsLine, currentSkillCommand, formerSkillProblem, commandLogOffset, startSandboxCommand, MICROVM_COMMAND_DIR, startMicroVmCommand, microVmCommandLine, runCommand, containerCommandExec, execCommandLine, startSender, startHostServices, finishJob, sampleGuest, foldSample, isSandboxTracked, isContainerTracked, isMicroVmTracked, probeSandboxCommand, probeMicroVmCommand, probeCommand, appendCommandLog, judgeProbe, SandboxGoneError, SandboxContainerStoppedError, EXIT_CODE_FILE, isTracked, isGroupAlive, outcomeFromExitCode, isIsolatedJob, jobTimeLimitMinutes, isTimedOut, readCpuUsec, isIdle, HELPER_ENV, setUpRunnerCgroup, stopOrphanedMicroVms, unfinishedJobs, sweepImageBuilders, listUnreadableJobs, listAdoptableJobs, retryFailedReleases, recoverLostJobs, GUEST_USAGE_INTERVAL_MS, vmAlive, filesAreCopied, inSandbox, listItemDisks, usableCpus, hookLimitsFor, runCommandOf, AttemptLogBook, environmentFor, builtOf, judgeCredential, readWorkItem, makeRecorder, microVmOomKills, needsRenew, renewRun, renewLease, RENEW_INTERVAL_SECONDS, stoppedHelperReason, measureDisk, listTrackedJobs, sweepSandboxes, keptSandboxIds, parseCpuList, ensureTunnel, keepGhConfigCurrent, restartSender, rejoinSandboxBuild, createHousekeepingDocker, housekeepingDockerIfReachable, runHousekeeping, shellQuote, jobRecordsClaim, freeItemDisksUntil, savedStatesDir, readRecords, removeOldestUntil, treeFileText, timeoutAfter, scrubReason, ensureNetworkReady, ADOPTED_FETCH_RETRY_WINDOW_MS, managedBuildSettingsFor, gitRemoteFor, startServicesFor, installTrust, createLeaseChannel, serveLease, writeGuestGhConfig, deliverJobFiles, inTeardown } from './chunk-YW35ZKUI.js';
13
13
  import { RUNNER_PROTOCOL } from './chunk-JXZ3LIHN.js';
14
14
  import { criteriaOf, loadCitationFinder, wholeItems, itemsSentence, oneLineReason, wholeEntries, parseJudgeAnswer } from './chunk-J74SL6JI.js';
15
15
  import { RUNNER_RESERVE_BYTES } from './chunk-3BA7WFT5.js';
@@ -4827,7 +4827,7 @@ async function startRunner(configPath, deps, startup) {
4827
4827
  check: update.check ? () => update.check(configPath) : async () => {
4828
4828
  const held = runnerAgents(deps.agents).flatMap((agent) => heldAgentCredential(agent.descriptor.id) ?? []);
4829
4829
  const env = { ...process.env, ...Object.fromEntries(held.map((credential) => [credential.variable, credential.value])) };
4830
- return (await import('./check-7ZXMFO5K.js')).runRunnerCheck(configPath, { fetchImpl: deps.fetchImpl, env });
4830
+ return (await import('./check-TEABORIU.js')).runRunnerCheck(configPath, { fetchImpl: deps.fetchImpl, env });
4831
4831
  },
4832
4832
  now: () => (deps.now ?? (() => /* @__PURE__ */ new Date()))().getTime(),
4833
4833
  log
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { placeholderQueues, placeholderProblem } from './chunk-4UDSLKAQ.js';
3
+ import { placeholderQueues, placeholderProblem } from './chunk-YW35ZKUI.js';
4
4
  import { checkFit, RUNNER_RESERVE_BYTES } from './chunk-3BA7WFT5.js';
5
5
  import { getJson, WorkCommandError } from './chunk-XJTA4GJE.js';
6
6
  import { isBuiltinVm, isBuiltinSandbox, builtinKind, EGRESS_SWITCHABLE_KEYS, imageBuildOf, keepsHostBuilder } from './chunk-EY5PK33O.js';
@@ -1122,7 +1122,7 @@ async function gatherDoctorChecks(options = {}) {
1122
1122
  const { runnerVmCheck } = await import('./doctor-53F2PYY7.js');
1123
1123
  checks.push(runnerVmCheck(configPath, { lima: realLima(), home: homeFromEnv(), instance: runnerVm.instance }));
1124
1124
  } else if (hasRunnerBlock(configPath)) {
1125
- const { runnerHostChecks } = await import('./doctor-VA2UFJFP.js');
1125
+ const { runnerHostChecks } = await import('./doctor-NP25CNXL.js');
1126
1126
  const gateway = (() => {
1127
1127
  try {
1128
1128
  const loaded = loadRunnerConfig(configPath);
@@ -129,14 +129,14 @@ function governingDir(cwd) {
129
129
  async function testProofMode(cwd) {
130
130
  const dir = governingDir(cwd);
131
131
  if (dir === void 0) return "any";
132
- const { testProofIn } = await import('./host-checks-C2GDXJPJ.js');
132
+ const { testProofIn } = await import('./host-checks-5QZYFP37.js');
133
133
  return testProofIn(dir);
134
134
  }
135
135
  async function judgeCheckName(cwd) {
136
136
  const dir = governingDir(cwd);
137
137
  if (dir === void 0) return {};
138
138
  if (!existsSync(dir)) return { note: `the governed context at ${dir} is not readable` };
139
- const { checksIn, isJudgeCheck } = await import('./host-checks-C2GDXJPJ.js');
139
+ const { checksIn, isJudgeCheck } = await import('./host-checks-5QZYFP37.js');
140
140
  const quiet = { line: () => void 0, error: () => void 0 };
141
141
  const check = checksIn(dir, quiet, "").checks.find((c) => isJudgeCheck(c) && c.judge.subjects === "criteria");
142
142
  return check === void 0 ? {} : { name: check.name };
@@ -372,7 +372,7 @@ async function runWorkProofs(opts) {
372
372
  async function runWorkProofsCommand(opts) {
373
373
  try {
374
374
  if (opts.record || opts.check) {
375
- const { runWorkProofsRecord } = await import('./work-proofs-record-7JY3GSP2.js');
375
+ const { runWorkProofsRecord } = await import('./work-proofs-record-QJB44PQV.js');
376
376
  const result2 = await runWorkProofsRecord(opts);
377
377
  process.exitCode = result2.exitCode;
378
378
  return;
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { stripTerminalControls } from './chunk-4UDSLKAQ.js';
3
+ import { stripTerminalControls } from './chunk-YW35ZKUI.js';
4
4
  import { tagToPull, imageTag, pullInstruction, readUpdateStatus, runnerImageVersion } from './chunk-ZX6NQ4TE.js';
5
5
  import { readFileSync } from 'fs';
6
6
 
@@ -4406,6 +4406,7 @@ var SANDBOX_DIR = "/var/lib/ol-runner";
4406
4406
  var OLD_SANDBOX_DIR = "/tmp/ol";
4407
4407
  var CLI_DIR = `${SANDBOX_DIR}/dist`;
4408
4408
  var SKILL_PACK_DIR = `${SANDBOX_DIR}/skill-pack`;
4409
+ var PACKAGE_FILE = `${SANDBOX_DIR}/package.json`;
4409
4410
  var SECRET_FILE = `${SANDBOX_DIR}/join-secret`;
4410
4411
  var CONTAINER_SECRET_FILE = "/run/outerlayer-relay/join-secret";
4411
4412
  var JOIN_WS_PORT = 7077;
@@ -4581,6 +4582,7 @@ function sandboxRunArgs(args, opts = {}) {
4581
4582
  "--mount",
4582
4583
  `type=bind,src=${CLI_DIR},dst=/opt/outerlayer/cli/dist,readonly`,
4583
4584
  ...opts.skillPack === true ? ["--mount", `type=bind,src=${SKILL_PACK_DIR},dst=/opt/outerlayer/cli/skill-pack,readonly`] : [],
4585
+ ...opts.packageFile === true ? ["--mount", `type=bind,src=${PACKAGE_FILE},dst=/opt/outerlayer/cli/package.json,readonly`] : [],
4584
4586
  "--mount",
4585
4587
  `type=bind,src=${SECRET_FILE},dst=${CONTAINER_SECRET_FILE},readonly`,
4586
4588
  ...opts.joined === true ? ["--mount", `type=bind,src=${JOIN_DIR},dst=${CONTAINER_JOIN_DIR}`] : [],
@@ -5011,6 +5013,8 @@ async function provisionSandboxOnce(input, itemDiskFailed) {
5011
5013
  runtime.sandbox.joinSecrets.set(buildId, joinSecret);
5012
5014
  const packDir = join(runtime.cliBuild().distDir, "..", "skill-pack");
5013
5015
  const skillPack = existsSync(packDir) ? packDir : void 0;
5016
+ const packagePath = join(runtime.cliBuild().distDir, "..", "package.json");
5017
+ const packageFile = existsSync(packagePath) ? packagePath : void 0;
5014
5018
  try {
5015
5019
  const made = await sandboxClient.command(sandbox, `sudo mkdir -p ${CLI_DIR} && sudo chown -R "$(id -u):$(id -g)" ${SANDBOX_DIR}`);
5016
5020
  if (made.exitCode !== 0) return bail(`making ${SANDBOX_DIR} in the sandbox failed (exit ${made.exitCode ?? "none"})${said(made.stderr)}`);
@@ -5020,6 +5024,7 @@ async function provisionSandboxOnce(input, itemDiskFailed) {
5020
5024
  const placed = await sandboxClient.command(sandbox, `mkdir -p ${SKILL_PACK_DIR} && tar xzf ${SANDBOX_DIR}/skill-pack.tgz -C ${SKILL_PACK_DIR} && rm -f ${SANDBOX_DIR}/skill-pack.tgz`);
5021
5025
  if (placed.exitCode !== 0) return bail(`putting the skill pack in the sandbox failed (exit ${placed.exitCode ?? "none"})${said(placed.stderr)}`);
5022
5026
  }
5027
+ if (packageFile !== void 0) await sandboxClient.upload(sandbox, PACKAGE_FILE, readFileSync(packageFile));
5023
5028
  await sandboxClient.upload(sandbox, SECRET_FILE, joinSecret);
5024
5029
  const unpacked = await sandboxClient.command(sandbox, `tar xzf ${SANDBOX_DIR}/dist.tgz -C ${CLI_DIR} && rm -f ${SANDBOX_DIR}/dist.tgz && sudo chown 60100:60100 ${SECRET_FILE} && sudo chmod 400 ${SECRET_FILE}`);
5025
5030
  if (unpacked.exitCode !== 0) return bail(`putting the CLI in the sandbox failed (exit ${unpacked.exitCode ?? "none"})${said(unpacked.stderr)}`);
@@ -5071,7 +5076,7 @@ async function provisionSandboxOnce(input, itemDiskFailed) {
5071
5076
  if ("none" in network) log.line(`${tag} ${noHelperLine(network.none)}`);
5072
5077
  else containerState.network = network.helper;
5073
5078
  const runArgs = containerRunArgs({ ...runInput, home: containerState.home, network: containerState.network }, runtime.agents);
5074
- const started = await host.run(sandboxRunArgs(runArgs, { skillPack: skillPack !== void 0, dockerGroup, joined: containerState.network !== void 0 }), { logPath });
5079
+ const started = await host.run(sandboxRunArgs(runArgs, { skillPack: skillPack !== void 0, packageFile: packageFile !== void 0, dockerGroup, joined: containerState.network !== void 0 }), { logPath });
5075
5080
  if (started.status !== 0) return dockerFailed("starting the build's container", started);
5076
5081
  joinRelay(runtime, sandbox, { buildId, container }, services.streams, joinSecret, (line2) => log.line(`${tag} ${line2}`));
5077
5082
  if (input.aborted()) return bail("", true);
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { gatherDoctorChecks, doctorExitCode, summarizeChecks, renderDoctorText, recordWrapped, recordUnwrapped, recordRemoval, readManifest, recordInstall, recordStatusline } from './chunk-7FE6NARL.js';
3
+ import { gatherDoctorChecks, doctorExitCode, summarizeChecks, renderDoctorText, recordWrapped, recordUnwrapped, recordRemoval, readManifest, recordInstall, recordStatusline } from './chunk-LUDRPWCQ.js';
4
4
  import './chunk-UU3A53VB.js';
5
5
  import { verifiedTrackerNames, TRACKERS } from './chunk-XJTA4GJE.js';
6
6
  import './chunk-A7M4QXVX.js';
@@ -274,11 +274,11 @@ var Help = class {
274
274
  visibleOptions.push(helpOption);
275
275
  } else if (helpOption.long && !removeLong) {
276
276
  visibleOptions.push(
277
- cmd.createOption(helpOption.long, helpOption.description)
277
+ cmd.createOption(helpOption.long, helpOption.description).helpGroup(helpOption.helpGroupHeading)
278
278
  );
279
279
  } else if (helpOption.short && !removeShort) {
280
280
  visibleOptions.push(
281
- cmd.createOption(helpOption.short, helpOption.description)
281
+ cmd.createOption(helpOption.short, helpOption.description).helpGroup(helpOption.helpGroupHeading)
282
282
  );
283
283
  }
284
284
  }
@@ -810,7 +810,7 @@ var Option = class {
810
810
  this.description = description || "";
811
811
  this.required = flags.includes("<");
812
812
  this.optional = flags.includes("[");
813
- this.variadic = /\w\.\.\.[>\]]$/.test(flags);
813
+ this.variadic = /\p{ID_Continue}\.\.\.[>\]]$/u.test(flags);
814
814
  this.mandatory = false;
815
815
  const optionFlags = splitOptionFlags(flags);
816
816
  this.short = optionFlags.shortFlag;
@@ -1992,7 +1992,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
1992
1992
  getOptionValueSourceWithGlobals(key) {
1993
1993
  let source;
1994
1994
  this._getCommandAndAncestors().forEach((cmd) => {
1995
- if (cmd.getOptionValueSource(key) !== void 0) {
1995
+ if (Object.hasOwn(cmd._optionValueSources, key)) {
1996
1996
  source = cmd.getOptionValueSource(key);
1997
1997
  }
1998
1998
  });
@@ -2635,7 +2635,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
2635
2635
  return arg.length > 1 && arg[0] === "-";
2636
2636
  }
2637
2637
  const negativeNumberArg = (arg) => {
2638
- if (!/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(arg)) return false;
2638
+ if (!/^-(\d+|\d*\.\d+)([eE][+-]?\d+)?$/.test(arg)) return false;
2639
2639
  return !this._getCommandAndAncestors().some(
2640
2640
  (cmd) => cmd.options.map((opt) => opt.short).some((short) => /^-\d$/.test(short))
2641
2641
  );
@@ -3083,7 +3083,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
3083
3083
  * (This does not override a group set directly on the subcommand using .helpGroup().)
3084
3084
  *
3085
3085
  * @example
3086
- * program.commandsGroup('Development Commands:);
3086
+ * program.commandsGroup('Development Commands:');
3087
3087
  * program.command('watch')...
3088
3088
  * program.command('lint')...
3089
3089
  * ...
@@ -3254,7 +3254,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
3254
3254
  * Pass in false to disable the built-in help option.
3255
3255
  *
3256
3256
  * @example
3257
- * program.helpOption('-?, --help' 'show help'); // customise
3257
+ * program.helpOption('-?, --help', 'show help'); // customise
3258
3258
  * program.helpOption(false); // disable
3259
3259
  *
3260
3260
  * @param {(string | boolean)} flags
@@ -3383,16 +3383,20 @@ function incrementNodeInspectorPort(args) {
3383
3383
  let debugHost = "127.0.0.1";
3384
3384
  let debugPort = "9229";
3385
3385
  let match;
3386
- if ((match = arg.match(/^(--inspect(-brk)?)$/)) !== null) {
3386
+ if ((match = arg.match(/^(--inspect(-brk|-wait)?)$/)) !== null) {
3387
3387
  debugOption = match[1];
3388
- } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+)$/)) !== null) {
3388
+ } else if ((match = arg.match(
3389
+ /^(--inspect(-brk|-port|-wait)?)=(\[[^\]]+\]|[^:]+)$/
3390
+ )) !== null) {
3389
3391
  debugOption = match[1];
3390
3392
  if (/^\d+$/.test(match[3])) {
3391
3393
  debugPort = match[3];
3392
3394
  } else {
3393
3395
  debugHost = match[3];
3394
3396
  }
3395
- } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/)) !== null) {
3397
+ } else if ((match = arg.match(
3398
+ /^(--inspect(-brk|-port|-wait)?)=(\[[^\]]+\]|[^:]+):(\d+)$/
3399
+ )) !== null) {
3396
3400
  debugOption = match[1];
3397
3401
  debugHost = match[3];
3398
3402
  debugPort = match[4];
@@ -3954,13 +3958,13 @@ what CLIs older than ${FIRST_VERSION_READING_AGENTS_SKILLS} do. \`` + cliInvocat
3954
3958
  if (changed.length > 0 && !opts.json) process.stdout.write(`Removed the claude function from ${changed.join(", ")}.
3955
3959
  `);
3956
3960
  }
3957
- const shell = !opts.remove && opts.shellFunction !== void 0 ? (await import('./init-cmd-MXQZ4PRU.js')).applyShellFunctionFlag(opts.shellFunction, { home: homeFromEnv(), shellPath: process.env.SHELL }) : void 0;
3961
+ const shell = !opts.remove && opts.shellFunction !== void 0 ? (await import('./init-cmd-CXIVHTCB.js')).applyShellFunctionFlag(opts.shellFunction, { home: homeFromEnv(), shellPath: process.env.SHELL }) : void 0;
3958
3962
  if (opts.json) writeJson(shell === void 0 ? outcome.result : { ...outcome.result, shellFunction: { outcome: shell.outcome, reason: shell.reason } });
3959
3963
  else process.stdout.write(outcome.text + skillsLine + (shell?.text ?? ""));
3960
3964
  return;
3961
3965
  }
3962
3966
  await installMachineSkillsForSetup();
3963
- const { runInitCommand } = await import('./init-cmd-MXQZ4PRU.js');
3967
+ const { runInitCommand } = await import('./init-cmd-CXIVHTCB.js');
3964
3968
  const code = await runInitCommand(
3965
3969
  { json: opts.json, factory: opts.factory, shellFunction: opts.shellFunction },
3966
3970
  {
@@ -4018,7 +4022,7 @@ not have, and prints the commit commands instead.
4018
4022
  `
4019
4023
  ).action(async (opts) => {
4020
4024
  const { runSetupCommand } = await import('./setup-cmd-YE6FV6GI.js');
4021
- const { realSetupDeps } = await import('./setup-wiring-Z7WTN6R6.js');
4025
+ const { realSetupDeps } = await import('./setup-wiring-W4LVR7LO.js');
4022
4026
  const cliBin = resolveCliBin();
4023
4027
  const agentWords = runnerHelpWords();
4024
4028
  const code = await runSetupCommand(
@@ -5291,7 +5295,7 @@ a runner build, no row is failed.
5291
5295
  fail(trackerNumberError("--pr", opts.pr));
5292
5296
  return;
5293
5297
  }
5294
- const { runWorkProofsCommand } = await import('./work-proofs-cmd-OFJ442KJ.js');
5298
+ const { runWorkProofsCommand } = await import('./work-proofs-cmd-IBJ4EUN3.js');
5295
5299
  await runWorkProofsCommand({ ...opts, ...pr === void 0 ? {} : { pr } });
5296
5300
  });
5297
5301
  workCmd.command("list").description("List live work items for this factory").option("--stage <spec|build|review>", "filter by stage").option("--section <attention|waiting|flowing>", "filter by Queue section").option("--repo <owner/name>", "repository (default: the current checkout's remote)").option("--unclaimed", "only items with no live lease").option("--claimed", "only items with a live lease, held by a host or a local session").option("--startable", "only items a host can start: a build request, no open PR, no live lease").option("--needs <amend>", "only items with a thread waiting on an agent").option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").action(async (opts) => {
@@ -5514,7 +5518,7 @@ function registerRunnerCommands(program2) {
5514
5518
  const configOption = "the cloud config file to run against (default: ~/.outerlayer/config.json)";
5515
5519
  runnerCmd.command("start").description("Run the loop: claim work, run it, report, clean up, repeat").option("--config <path>", configOption).action(async (opts) => {
5516
5520
  const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-XZL5SJFQ.js');
5517
- const { start, RunnerStartError } = await import('./loop-DE37FAAT.js');
5521
+ const { start, RunnerStartError } = await import('./loop-GFVQWJZ3.js');
5518
5522
  const { RunnerAlreadyRunningError } = await import('./pidfile-PN5VYXTM.js');
5519
5523
  const configPath = opts.config ?? defaultRunnerConfigPath();
5520
5524
  try {
@@ -5538,8 +5542,8 @@ The image sets OUTERLAYER_RUNNER_IMAGE; outside the image, use \`runner start\`.
5538
5542
  `
5539
5543
  ).action(async () => {
5540
5544
  const { defaultRunnerConfigPath, RunnerConfigError } = await import('./config-XZL5SJFQ.js');
5541
- const { containerStart, containerStartExit } = await import('./container-start-VHUXUJY4.js');
5542
- const { start, RunnerStartError } = await import('./loop-DE37FAAT.js');
5545
+ const { containerStart, containerStartExit } = await import('./container-start-OP4KPMQD.js');
5546
+ const { start, RunnerStartError } = await import('./loop-GFVQWJZ3.js');
5543
5547
  const { RunnerAlreadyRunningError } = await import('./pidfile-PN5VYXTM.js');
5544
5548
  try {
5545
5549
  const outcome = containerStartExit(await containerStart({
@@ -5563,14 +5567,14 @@ The image sets OUTERLAYER_RUNNER_IMAGE; outside the image, use \`runner start\`.
5563
5567
  ).action(async (opts) => {
5564
5568
  const { defaultRunnerConfigPath } = await import('./config-XZL5SJFQ.js');
5565
5569
  const { runnerDir } = await import('./paths-OYHBXFV4.js');
5566
- const { runUpdateSteps } = await import('./update-steps-E4R6PAT3.js');
5570
+ const { runUpdateSteps } = await import('./update-steps-K2TLHXOV.js');
5567
5571
  const text = await runUpdateSteps({ runnerDirPath: runnerDir(opts.config ?? defaultRunnerConfigPath()) });
5568
5572
  process.stdout.write(`${text}
5569
5573
  `);
5570
5574
  });
5571
5575
  runnerCmd.command("check").description("Validate the config, the hooks and the key, and print the effective settings").option("--config <path>", configOption).action(async (opts) => {
5572
5576
  const { defaultRunnerConfigPath } = await import('./config-XZL5SJFQ.js');
5573
- const { runRunnerCheck } = await import('./check-7ZXMFO5K.js');
5577
+ const { runRunnerCheck } = await import('./check-TEABORIU.js');
5574
5578
  const configPath = opts.config ?? defaultRunnerConfigPath();
5575
5579
  const result = await runRunnerCheck(configPath);
5576
5580
  if (!result.ok) {
@@ -5604,13 +5608,13 @@ The image sets OUTERLAYER_RUNNER_IMAGE; outside the image, use \`runner start\`.
5604
5608
  }
5605
5609
  }
5606
5610
  const buildCpusMax = opts.buildCpusMax === void 0 ? void 0 : Number(opts.buildCpusMax);
5607
- if (buildCpusMax !== void 0 && !(await import('./command-TVXXAAXE.js')).cpusAreValid(buildCpusMax)) {
5611
+ if (buildCpusMax !== void 0 && !(await import('./command-GUYK5W3K.js')).cpusAreValid(buildCpusMax)) {
5608
5612
  fail(`--build-cpus-max ${opts.buildCpusMax} is not a number of CPUs from 0.01 to 1024.`);
5609
5613
  return;
5610
5614
  }
5611
5615
  try {
5612
5616
  if (opts.service === true) {
5613
- const { installServiceCommand, serviceSuccessText } = await import('./command-TVXXAAXE.js');
5617
+ const { installServiceCommand, serviceSuccessText } = await import('./command-GUYK5W3K.js');
5614
5618
  const result2 = await installServiceCommand({
5615
5619
  configPath,
5616
5620
  print: opts.print,
@@ -5665,7 +5669,7 @@ To keep it running, run ${C.yellow}${cliInvocation()} runner install --service${
5665
5669
  return;
5666
5670
  }
5667
5671
  const { defaultRunnerConfigPath } = await import('./config-XZL5SJFQ.js');
5668
- const { uninstallServiceCommand } = await import('./command-TVXXAAXE.js');
5672
+ const { uninstallServiceCommand } = await import('./command-GUYK5W3K.js');
5669
5673
  const result = await uninstallServiceCommand({ configPath: opts.config ?? defaultRunnerConfigPath(), unitName: opts.unitName, home: homeFromEnv() });
5670
5674
  if (result.ok) for (const line of result.lines) process.stdout.write(`${C.green}\u2713${C.reset} ${line}
5671
5675
  `);
@@ -5696,11 +5700,11 @@ already in ${words().envFile} is used.
5696
5700
  `
5697
5701
  ).action(async (opts) => {
5698
5702
  const { defaultRunnerConfigPath, loadRunnerConfig, RunnerConfigError } = await import('./config-XZL5SJFQ.js');
5699
- const { prepareRunnerInit, runRunnerInit, RunnerInitError, writeRunnerInit, removeRunnerBlock, nativeWindowsSandboxRefusal, SANDBOX_MACHINES } = await import('./init-4ERBO6N5.js');
5700
- const { askManagedSandboxes } = await import('./check-7ZXMFO5K.js');
5701
- const { obtainRunnerKey, runnerKeyLogin } = await import('./runner-key-ZTHDMU44.js');
5702
- const { detectMachine } = await import('./machine-4JUM7RCO.js');
5703
- const { chooseVm, runVmInit, VmInitError } = await import('./init-SCINBONF.js');
5703
+ const { prepareRunnerInit, runRunnerInit, RunnerInitError, writeRunnerInit, removeRunnerBlock, nativeWindowsSandboxRefusal, SANDBOX_MACHINES } = await import('./init-FP3RUUA5.js');
5704
+ const { askManagedSandboxes } = await import('./check-TEABORIU.js');
5705
+ const { obtainRunnerKey, runnerKeyLogin } = await import('./runner-key-UK6POYN4.js');
5706
+ const { detectMachine } = await import('./machine-OTZR4ZMD.js');
5707
+ const { chooseVm, runVmInit, VmInitError } = await import('./init-IXL4YFO3.js');
5704
5708
  const { credentialFromStdin, isAgentName, restartForCredential, RunnerEnvError } = await import('./runner-env-PS42B5IJ.js');
5705
5709
  const { headlessNames: headlessNames2 } = await import('./runner-agents-6LXWGCI5.js');
5706
5710
  const configPath = opts.config ?? defaultRunnerConfigPath();
@@ -5736,7 +5740,7 @@ already in ${words().envFile} is used.
5736
5740
  return;
5737
5741
  }
5738
5742
  try {
5739
- const { agentCredentialText, credentialQuestion, initAgent, terminalQuestion } = await import('./init-agent-6UGX75WR.js');
5743
+ const { agentCredentialText, credentialQuestion, initAgent, terminalQuestion } = await import('./init-agent-ZUTFIH6K.js');
5740
5744
  agent = await initAgent({
5741
5745
  flag: agent,
5742
5746
  handOff: opts.configStdin === true,
@@ -5894,7 +5898,7 @@ ${C.yellow}The runner will not update itself: ${installErr.message}${C.reset}
5894
5898
  let serviceUp = false;
5895
5899
  let restart;
5896
5900
  if (installedLayout) {
5897
- const { installServiceCommand } = await import('./command-TVXXAAXE.js');
5901
+ const { installServiceCommand } = await import('./command-GUYK5W3K.js');
5898
5902
  const service = await installServiceCommand({
5899
5903
  configPath,
5900
5904
  entryPath: process.argv[1] ?? "",
@@ -6034,7 +6038,7 @@ A repository with no devcontainer file builds on the universal image the CLI pin
6034
6038
  });
6035
6039
  runnerCmd.command("stop").description("Take no more work; finish running jobs, then exit").option("--config <path>", "the cloud config file naming the runner to stop").option("--now", "end running jobs immediately, with outcome stopped").action(async (opts) => {
6036
6040
  const { defaultRunnerConfigPath } = await import('./config-XZL5SJFQ.js');
6037
- const { requestStop } = await import('./loop-DE37FAAT.js');
6041
+ const { requestStop } = await import('./loop-GFVQWJZ3.js');
6038
6042
  const configPath = opts.config ?? defaultRunnerConfigPath();
6039
6043
  const { runnerImageVersion } = await import('./image-tag-DTTH4Z6T.js');
6040
6044
  await requestStop(configPath, Boolean(opts.now), void 0, { image: runnerImageVersion() !== void 0 });
@@ -6042,8 +6046,8 @@ A repository with no devcontainer file builds on the universal image the CLI pin
6042
6046
  runnerCmd.command("status").description("List running jobs; with --recent, finished ones too").option("--config <path>", "the cloud config file naming the runner to inspect").option("--recent", "also list finished jobs, newest first, capped at 20").option("--json", "machine-readable JSON output").action(async (opts) => {
6043
6047
  const { builtinKind, defaultRunnerConfigPath, loadRunnerConfig } = await import('./config-XZL5SJFQ.js');
6044
6048
  const { jobsDir, runnerDir } = await import('./paths-OYHBXFV4.js');
6045
- const { listJobFiles, runnerProcessState } = await import('./loop-DE37FAAT.js');
6046
- const { renderStatus } = await import('./status-CA5UYVDR.js');
6049
+ const { listJobFiles, runnerProcessState } = await import('./loop-GFVQWJZ3.js');
6050
+ const { renderStatus } = await import('./status-EXAXEXJ7.js');
6047
6051
  const { readHousekeepingRecord } = await import('./record-H5TSGSHS.js');
6048
6052
  const path2 = await import('path');
6049
6053
  const configPath = opts.config ?? defaultRunnerConfigPath();
@@ -6116,7 +6120,7 @@ A repository with no devcontainer file builds on the universal image the CLI pin
6116
6120
  });
6117
6121
  runnerCmd.command("logs").argument("<item>", "the work item's number in the factory, or a build's claim id").description("Print the newest attempt's log for one item or claim id").option("--config <path>", "the cloud config file naming the runner to inspect").option("-f, --follow", "keep printing as the log grows").action(async (itemArg, opts) => {
6118
6122
  const { defaultRunnerConfigPath } = await import('./config-XZL5SJFQ.js');
6119
- const { listJobFiles } = await import('./loop-DE37FAAT.js');
6123
+ const { listJobFiles } = await import('./loop-GFVQWJZ3.js');
6120
6124
  const { describeAmbiguous, logPathFor, selectAttempt, tail, RunnerLogsError } = await import('./logs-I4VXXTV5.js');
6121
6125
  const configPath = opts.config ?? defaultRunnerConfigPath();
6122
6126
  const jobs = listJobFiles(configPath);
@@ -4,10 +4,10 @@ import { realLaunchAgentHost } from './chunk-3FCYURWW.js';
4
4
  import { realOwnership, accountNamed, handOver, runRunnerInstall, launcherSummary, restartNote, accountIdentity } from './chunk-TT6C65II.js';
5
5
  import { installSandboxAgent, uninstallSandboxAgent } from './chunk-UEK65YH6.js';
6
6
  import './chunk-TXKHD4Q6.js';
7
- import { installHelper, helperUnitFor, helperSocketFor, uninstallHelper } from './chunk-3C2NLRL3.js';
7
+ import { installHelper, helperUnitFor, helperSocketFor, uninstallHelper } from './chunk-6ZHZXUFW.js';
8
8
  import './chunk-C5TJZMYS.js';
9
9
  import { currentLink, execStartCommand } from './chunk-ETXP6DPT.js';
10
- import { detectMachine, ensureFirecrackerAndJailer } from './chunk-4UDSLKAQ.js';
10
+ import { detectMachine, ensureFirecrackerAndJailer } from './chunk-YW35ZKUI.js';
11
11
  import './chunk-JXZ3LIHN.js';
12
12
  import './chunk-J74SL6JI.js';
13
13
  import './chunk-I3LTIAOR.js';
@@ -1,8 +1,8 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { reportFailedStart, BUILD_MEMORY_VARIABLE } from './chunk-DWZWXWZP.js';
4
- import { readOwnContainer } from './chunk-ZSGCCX5U.js';
5
- import { detectMachine, supportsContainerBuilds, MIN_ENGINE_MAJOR, describeMachineDocker, RunnerInitError, prepareRunnerInit, writeRunnerInit } from './chunk-4UDSLKAQ.js';
3
+ import { reportFailedStart, BUILD_MEMORY_VARIABLE } from './chunk-5KM5STHU.js';
4
+ import { readOwnContainer } from './chunk-XJVLKMQS.js';
5
+ import { detectMachine, supportsContainerBuilds, MIN_ENGINE_MAJOR, describeMachineDocker, RunnerInitError, prepareRunnerInit, writeRunnerInit } from './chunk-YW35ZKUI.js';
6
6
  import './chunk-JXZ3LIHN.js';
7
7
  import './chunk-J74SL6JI.js';
8
8
  import './chunk-I3LTIAOR.js';
@@ -1,10 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { helperBinaryFor } from './chunk-3C2NLRL3.js';
4
- import { managedProblems, fleetConfigProblem, askFleetMachine } from './chunk-K5CV7Y7U.js';
3
+ import { helperBinaryFor } from './chunk-6ZHZXUFW.js';
4
+ import { managedProblems, fleetConfigProblem, askFleetMachine } from './chunk-JOED4C6S.js';
5
5
  import { launcherCheck } from './chunk-C5TJZMYS.js';
6
6
  import './chunk-ETXP6DPT.js';
7
- import { needsAgentCredential, agentCredentialCheck, detectMachine, supportsContainerBuilds, describeMachineDocker, MIN_ENGINE_MAJOR, reachDockerStep, supportsMicroVmBuilds, microVmArchSupported, microVmAssetsPinned, helperFirecrackerNote, probeHelper, helperSocketPath, KIND_LABEL, missingPermissionOf, missingPermissionFix } from './chunk-4UDSLKAQ.js';
7
+ import { needsAgentCredential, agentCredentialCheck, detectMachine, supportsContainerBuilds, describeMachineDocker, MIN_ENGINE_MAJOR, reachDockerStep, supportsMicroVmBuilds, microVmArchSupported, microVmAssetsPinned, helperFirecrackerNote, probeHelper, helperSocketPath, KIND_LABEL, missingPermissionOf, missingPermissionFix } from './chunk-YW35ZKUI.js';
8
8
  import './chunk-JXZ3LIHN.js';
9
9
  import './chunk-J74SL6JI.js';
10
10
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { MAX_CHECK_ITEMS_BYTES, builtOf, checksIn, commandItems, isJudgeCheck, makeRecorder, readDefinitions, runHostChecks, testProofIn, timeoutAfter } from './chunk-4UDSLKAQ.js';
3
+ export { MAX_CHECK_ITEMS_BYTES, builtOf, checksIn, commandItems, isJudgeCheck, makeRecorder, readDefinitions, runHostChecks, testProofIn, timeoutAfter } from './chunk-YW35ZKUI.js';
4
4
  import './chunk-JXZ3LIHN.js';
5
5
  import './chunk-J74SL6JI.js';
6
6
  import './chunk-I3LTIAOR.js';
package/dist/index.js CHANGED
@@ -25,5 +25,5 @@ var { runSubcommand } = await import('./agent-subcommand-627NTYCT.js');
25
25
  var launcherCode = await runSubcommand(argv);
26
26
  if (launcherCode !== void 0) process.exit(launcherCode);
27
27
  (await import('./hook-fast-TBCK3I4E.js')).recordLinkExitFailure(argv);
28
- var { runCli } = await import('./cli-OAJGSXFK.js');
28
+ var { runCli } = await import('./cli-6ZKRVTHP.js');
29
29
  await runCli(process.argv);
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { PLACEHOLDER_MARKER, RunnerInitError, SANDBOX_MACHINES, isPlaceholderCommand, nativeWindowsSandboxRefusal, prepareRunnerInit, readConfigObject, removeRunnerBlock, runRunnerInit, writeRunnerInit } from './chunk-4UDSLKAQ.js';
3
+ export { PLACEHOLDER_MARKER, RunnerInitError, SANDBOX_MACHINES, isPlaceholderCommand, nativeWindowsSandboxRefusal, prepareRunnerInit, readConfigObject, removeRunnerBlock, runRunnerInit, writeRunnerInit } from './chunk-YW35ZKUI.js';
4
4
  import './chunk-JXZ3LIHN.js';
5
5
  import './chunk-J74SL6JI.js';
6
6
  import './chunk-I3LTIAOR.js';
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
3
  import { npmSupportsProvenance } from './chunk-E7R2GIAW.js';
4
- import { RunnerInitError, readConfigObject } from './chunk-4UDSLKAQ.js';
4
+ import { RunnerInitError, readConfigObject } from './chunk-YW35ZKUI.js';
5
5
  import './chunk-JXZ3LIHN.js';
6
6
  import './chunk-J74SL6JI.js';
7
7
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { RunnerInitError } from './chunk-4UDSLKAQ.js';
3
+ import { RunnerInitError } from './chunk-YW35ZKUI.js';
4
4
  import './chunk-JXZ3LIHN.js';
5
5
  import './chunk-J74SL6JI.js';
6
6
  import './chunk-I3LTIAOR.js';
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { applyShellFunctionFlag, runInitCommand } from './chunk-UBSNF6VG.js';
4
- import './chunk-7FE6NARL.js';
3
+ export { applyShellFunctionFlag, runInitCommand } from './chunk-54J6P6BH.js';
4
+ import './chunk-LUDRPWCQ.js';
5
5
  import './chunk-4KCWAP5L.js';
6
6
  import './chunk-UU3A53VB.js';
7
7
  import './chunk-XJTA4GJE.js';
@@ -1,16 +1,16 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { LAPSED_REASON, RunnerStartError, applyComments, endWhenStartFails, fleetKeepalive, leaseTimeLeftFor, listJobFiles, logUnusableHelper, prepareSession, probeBuild, probeCredentials, provisionsBesideOthers, requestStop, runnerProcessState, runtimeOf, sampleUsage, start, tick, watchTick } from './chunk-MI2XJJTC.js';
3
+ export { LAPSED_REASON, RunnerStartError, applyComments, endWhenStartFails, fleetKeepalive, leaseTimeLeftFor, listJobFiles, logUnusableHelper, prepareSession, probeBuild, probeCredentials, provisionsBesideOthers, requestStop, runnerProcessState, runtimeOf, sampleUsage, start, tick, watchTick } from './chunk-GNQF6XLZ.js';
4
4
  import './chunk-7MVTX74D.js';
5
5
  import './chunk-E7R2GIAW.js';
6
- import './chunk-DWZWXWZP.js';
7
- import './chunk-ZSGCCX5U.js';
6
+ import './chunk-5KM5STHU.js';
7
+ import './chunk-XJVLKMQS.js';
8
8
  import './chunk-TXKHD4Q6.js';
9
9
  import './chunk-5XAV7LGB.js';
10
10
  import './chunk-H32FCHB5.js';
11
- import './chunk-K5CV7Y7U.js';
11
+ import './chunk-JOED4C6S.js';
12
12
  import './chunk-ETXP6DPT.js';
13
- import './chunk-4UDSLKAQ.js';
13
+ import './chunk-YW35ZKUI.js';
14
14
  import './chunk-JXZ3LIHN.js';
15
15
  import './chunk-J74SL6JI.js';
16
16
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { describeMachineDocker, detectMachine, microVmArchSupported, microVmAssetsPinned, reachDockerStep, supportsContainerBuilds, supportsMicroVmBuilds } from './chunk-4UDSLKAQ.js';
3
+ export { describeMachineDocker, detectMachine, microVmArchSupported, microVmAssetsPinned, reachDockerStep, supportsContainerBuilds, supportsMicroVmBuilds } from './chunk-YW35ZKUI.js';
4
4
  import './chunk-JXZ3LIHN.js';
5
5
  import './chunk-J74SL6JI.js';
6
6
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { readConfigObject, RunnerInitError } from './chunk-4UDSLKAQ.js';
3
+ import { readConfigObject, RunnerInitError } from './chunk-YW35ZKUI.js';
4
4
  import './chunk-JXZ3LIHN.js';
5
5
  import './chunk-J74SL6JI.js';
6
6
  import './chunk-I3LTIAOR.js';
@@ -1,10 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { runInitCommand } from './chunk-UBSNF6VG.js';
4
- import './chunk-7FE6NARL.js';
3
+ import { runInitCommand } from './chunk-54J6P6BH.js';
4
+ import './chunk-LUDRPWCQ.js';
5
5
  import './chunk-4KCWAP5L.js';
6
6
  import { currentBranch, openSetupPullRequest, setupPullRequestUrl, setupBranchPushed, setupMerged, setupBaseBranch, markSetupInstalled, setupInstalled } from './chunk-SVJKVEUF.js';
7
- import { detectMachine, supportsMicroVmBuilds, supportsContainerBuilds, reachDockerStep, describeMachineDocker } from './chunk-4UDSLKAQ.js';
7
+ import { detectMachine, supportsMicroVmBuilds, supportsContainerBuilds, reachDockerStep, describeMachineDocker } from './chunk-YW35ZKUI.js';
8
8
  import './chunk-JXZ3LIHN.js';
9
9
  import './chunk-J74SL6JI.js';
10
10
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { isReadable, LEASE_SECONDS, ALREADY_RELEASED, RENEW_INTERVAL_SECONDS } from './chunk-4UDSLKAQ.js';
3
+ import { isReadable, LEASE_SECONDS, ALREADY_RELEASED, RENEW_INTERVAL_SECONDS } from './chunk-YW35ZKUI.js';
4
4
  import './chunk-JXZ3LIHN.js';
5
5
  import './chunk-J74SL6JI.js';
6
6
  import './chunk-I3LTIAOR.js';
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { readOwnContainer, renderUpdateSteps, runUpdateSteps } from './chunk-ZSGCCX5U.js';
4
- import './chunk-4UDSLKAQ.js';
3
+ export { readOwnContainer, renderUpdateSteps, runUpdateSteps } from './chunk-XJVLKMQS.js';
4
+ import './chunk-YW35ZKUI.js';
5
5
  import './chunk-JXZ3LIHN.js';
6
6
  import './chunk-J74SL6JI.js';
7
7
  import './chunk-I3LTIAOR.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { classifyProofs, classifyProofsAt, otherPullRequestHeads, renderProofRow, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-FKIZCJOQ.js';
3
+ export { classifyProofs, classifyProofsAt, otherPullRequestHeads, renderProofRow, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-XDVNW7TR.js';
4
4
  import './chunk-J74SL6JI.js';
5
5
  import './chunk-XJTA4GJE.js';
6
6
  import './chunk-A7M4QXVX.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, testProofMode, classifyProofsAt, runWorkProofs, proofsCommentId, testFilesOf, freshXmlFiles, joinResults, testSelectors, kindProblem, renderProofRow, proofsCommentBody } from './chunk-FKIZCJOQ.js';
3
+ import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, testProofMode, classifyProofsAt, runWorkProofs, proofsCommentId, testFilesOf, freshXmlFiles, joinResults, testSelectors, kindProblem, renderProofRow, proofsCommentBody } from './chunk-XDVNW7TR.js';
4
4
  import { runWorkComment } from './chunk-DQ77PKPL.js';
5
5
  import { runEmitDemo, planScreenshots, chapterPassed, readStill } from './chunk-U7CJ6EPP.js';
6
6
  import { readNewestDemo } from './chunk-ER6KQCVJ.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@outerlayer/cli",
3
- "version": "0.40.0-next.20261116130619",
3
+ "version": "0.40.0-next.20261116150436",
4
4
  "description": "OuterLayer CLI — commands: setup, init, claude, opencode, codex, connect, doctor, login, logout, sync, daemon (alias: watch), emit, demo, findings, work, run, 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.",
@@ -340,6 +340,14 @@ Run them in order.
340
340
  repository's own pre-push checks and tests pass on the branch. A branch
341
341
  that cannot go green escalates.
342
342
 
343
+ The implementer writes the test of every declared proof in this phase,
344
+ beside the feature and before the gate. A criterion that declares
345
+ `proof: video` or `proof: screenshot` gets a chapter of the item's demo
346
+ test, named by its id. A repository's gate can refuse a push without that
347
+ chapter. The demo test is code: write it even when the app does not start
348
+ here. A later phase can run it again. A proof with no test can never be
349
+ recorded.
350
+
343
351
  The implementer runs on the Implementing model setting. Default: the model
344
352
  the session runs on.
345
353
 
@@ -372,9 +380,10 @@ Run them in order.
372
380
  finds on the pull request.
373
381
  5. **Evidence.** Run `outerlayer emit step "Evidence" --item "$OUTERLAYER_WORK"`,
374
382
  then apply the team's changes for this phase. Read [references/evidence.md](references/evidence.md)
375
- when the pull request opens, and run it. Write and commit the demo test and the
376
- file-proof tests. Each test uses the id of the criterion it records a proof for. When the
377
- repository has no `.outerlayer-proofs.yaml`, write and commit one. In a
383
+ when the pull request opens, and run it. This phase runs the proof tests
384
+ the Implement phase committed, and fixes each one that fails. It does not
385
+ write a missing demo test from the start: a declared proof with no test is
386
+ an Implement fault, and the implementer writes it. In a
378
387
  runner build, check each proof with `outerlayer work proofs --check`, and
379
388
  record none: the host records them at the pushed head. In a local session,
380
389
  record each proof with `outerlayer work proofs --record` after the last
@@ -399,18 +408,25 @@ is "The tests need STRIPE_KEY. Add it as a build variable." Keep it under 200
399
408
  characters. The Work page and the Overview tab show your sentence as the reason
400
409
  the item needs attention. Skip it when the build opens a pull request.
401
410
 
411
+ Only one kind of proof can stay unproven: a proof this host cannot produce.
412
+ It needs something the host does not have, such as macOS, Windows, a
413
+ physical device or a real third-party account. `build-reports/evidence.md`
414
+ names each such proof and what it needs. Its test is still committed when a
415
+ test can record it. A written reason excuses no other proof. A database,
416
+ app or browser that does not start is a fault to fix, never such a reason.
417
+
402
418
  In a runner build, end the run only when `outerlayer work proofs --check`
403
- exits 0 at the last commit, or when `build-reports/evidence.md` names each
404
- proof that failed and the reason. Do not run `--record`: the host records each
405
- proof at the pushed head. A row marked `failed` fails the check, and no reason
406
- excuses it: add or change a test that proves the criterion, commit, and check
407
- again.
419
+ exits 0 at the last commit, apart from proofs this host cannot produce. Do
420
+ not run `--record`: the host records each proof at the pushed head. A proof
421
+ that fails the check, or a row marked `failed`, needs a fix: add or change
422
+ the test that proves the criterion, commit, and check again. A proof that
423
+ still fails after the takeover in state rule 2 escalates. The final report
424
+ names it as failed, never as excused.
408
425
 
409
426
  In a local session, run the release command below last, after the pull request is open and the
410
427
  evidence is emitted, and run no other tool call after it. Before it, run `outerlayer sync` and then
411
428
  `outerlayer work proofs --item "$OUTERLAYER_WORK"`. End the run only when it
412
- exits 0, or when `build-reports/evidence.md` names each proof it still lists
413
- and the reason. A proof out of date because of a later commit needs
429
+ exits 0, apart from proofs this host cannot produce. A proof out of date because of a later commit needs
414
430
  `outerlayer work proofs --record` at the final commit, not a reason. A row marked `failed` has no such excuse: add or change a test that
415
431
  proves the criterion, and run the command again. Exit 2 means it could not
416
432
  decide: fix the reason it prints and run it again:
@@ -112,6 +112,41 @@ report. When the build drafted the criteria from the issue's description, they
112
112
  are requirements in the same way. When no criteria were recorded, write tests
113
113
  from the description in the same order.
114
114
 
115
+ Write the test of every declared proof in this phase, in the same commits as
116
+ the feature and before the gate. The Evidence phase runs these tests and
117
+ fixes what fails. It does not write them.
118
+
119
+ - A criterion that declares `proof: video` or `proof: screenshot` gets a
120
+ chapter of the item's demo test. The demo test is a Playwright test named
121
+ `*.demo.spec.ts`. Put it where the repository keeps its Playwright tests, in
122
+ the folder the instructions name, else in `e2e/demo/`. It uses
123
+ `@outerlayer/playwright`, as the outerlayer-evidence skill's "Record a demo"
124
+ says. Open each chapter with the id of its criterion, for example
125
+ `demo.chapter("AC-7-02", "<title>", async () => { ... })`. Keep the chapters
126
+ in the criteria's order. A screenshot criterion's chapter calls
127
+ `demo.screenshot()` after the `expect` that shows the result.
128
+ - Tell each chapter in beats with `demo.say()`. Sign in once, and seed and
129
+ wait between beats, so the demo shows only narrated steps. In each beat,
130
+ check first with `expect(locator)` the element its line names, so the
131
+ recorder rings it. Write each line as you would say it to a teammate at
132
+ your screen, in plain words. If the repository's CI cannot start the app,
133
+ mark the file so that CI skips it.
134
+ - A `// proves` comment on a unit or jsdom test records no video or
135
+ screenshot. Only a demo chapter does.
136
+ - Write the demo test even when the app does not start here. It is code, like
137
+ the feature. When the app starts, run the demo test once before the gate.
138
+ When it does not, quote the command and its error in your report.
139
+ - A report, log or file proof is a test, in any language, that writes
140
+ `$OUTERLAYER_PROOF_OUT/<criterion id>.<ext>`. The kind of the file must be
141
+ the kind the criterion declares. The test writes outside the repository, so
142
+ there is nothing to ignore or commit.
143
+ - The repository has one `.outerlayer-proofs.yaml` at its root. When it is
144
+ missing, write it and commit it. `setup` lists the commands that seed and
145
+ start the app. Each setup command must return once the app is ready.
146
+ `teardown` lists the commands that stop it. Each entry in `runners` has a
147
+ `files` glob of test files and a `command` that runs them, with `{files}`
148
+ where the matched files go.
149
+
115
150
  Version any new database migration with the current UTC time, never a round or
116
151
  guessed one. Two open branches that guess the same time both pass their own
117
152
  checks, and the second to merge breaks the build for everyone.
@@ -201,53 +236,34 @@ The shared rules apply, and the outerlayer-evidence skill governs the emit
201
236
  mechanics. Your inputs are the issue, the pull request number, the criteria
202
237
  that declare a proof form, and the instructions-file pointer.
203
238
 
239
+ The Implement phase committed the test of every declared proof: a chapter of
240
+ the item's demo test for each video or screenshot criterion, and a test that
241
+ writes each report, log or file proof. Your work is to run those tests, look
242
+ at what they record, and fix what fails. Do not write a missing demo test from
243
+ the start. When a criterion that declares a proof form has no test, name it in
244
+ your report as an Implement fault, and go on with the others. The orchestrator
245
+ sends it back to the implementer.
246
+
204
247
  Run the app and drive the feature by hand. A screenshot or video is taken in a
205
248
  real browser against the running application, reached through its own routes
206
249
  by a signed-in user, inside its real shell and theme. Never capture a test
207
250
  render, a jsdom dump or a standalone file of a component. It shows neither what
208
251
  a user sees nor that the page works. Seed what the page needs through the
209
- application's own paths. When a state cannot be reached that way, the criterion
210
- is not evidenced, and `evidence.md` says why. Before emitting, look at each
252
+ application's own paths. When a state cannot be reached that way, change the
253
+ demo test so it seeds through those paths. Before you go on, look at each
211
254
  capture: it shows the application's navigation and real rows.
212
255
 
213
- Write the demo, when a criterion needs a video or a screenshot, as a Playwright
214
- test that is part of the change. Put it where the repository keeps its Playwright tests, in the
215
- folder the instructions name, else in `e2e/demo/`. Name it `*.demo.spec.ts`.
216
- Commit it in the pull request. The demo record names this test, so an amend
217
- can run it again at a new head. If the repository's CI cannot start the app,
218
- mark the file so that CI skips it.
219
-
220
- Record each criterion that declares `proof: screenshot` as a chapter of the same
221
- demo, with a `demo.screenshot()` call where the result shows. The frame then
222
- comes from the committed test, so a later session records it again at the new head.
223
-
224
- Every proof comes from a test that you commit with the change. The test uses
225
- the id of the criterion it proves where it records the proof, for example
256
+ Every proof comes from a test committed with the change. The test uses the id
257
+ of the criterion it proves where it records the proof, for example
226
258
  `demo.chapter("AC-7-02", ...)` or the file `<criterion id>.log` it writes.
227
259
  `outerlayer work proofs --record` finds the tests at HEAD that hold the id of
228
- each proof that is not current, and runs them.
260
+ each proof that is not current, and runs them. The demo record names the demo
261
+ test, so an amend can run it again at a new head.
229
262
 
230
- - The repository has one `.outerlayer-proofs.yaml` at its root. When it is
231
- missing, write it and commit it. `setup` lists the commands that seed and start
232
- the app. Each setup command must return once the app is ready. `teardown`
233
- lists the commands that stop it. Each entry in `runners` has a `files` glob of
234
- test files and a `command` that runs them, with `{files}` where the matched
235
- files go.
236
- - A demo test uses `@outerlayer/playwright`, one chapter for each screenshot or
237
- video criterion in the criteria's order, as the outerlayer-evidence skill's
238
- "Record a demo" says. Tell each chapter in beats with `demo.say()`: sign in
239
- once, and seed and wait between beats, so the demo shows only narrated
240
- steps. In each beat, check first with `expect(locator)` the element its
241
- line names, so the recorder rings it. Write each line as you would say it to a
242
- teammate at your screen, in plain words. Render it with `outerlayer emit
243
- demo <manifest> --output demo.webm`, then watch and listen to it before
244
- you commit the test. Each beat rings what its line names. Write again each
245
- line that sounds read off a spec or like an advert. The fixture writes the
246
- manifest where `OUTERLAYER_PROOF_OUT` names.
247
- - A report, log or file proof is a test, in any language, that writes
248
- `$OUTERLAYER_PROOF_OUT/<criterion id>.<ext>`. The kind of the file must be the
249
- kind the criterion declares. The test writes outside the repository, so there is
250
- nothing to ignore or commit.
263
+ - Render the demo with `outerlayer emit demo <manifest> --output demo.webm`.
264
+ The fixture writes the manifest where `OUTERLAYER_PROOF_OUT` names. Watch
265
+ and listen to it. Each beat rings what its line names. Write again each line
266
+ that sounds read off a spec or like an advert, and commit the change.
251
267
  - A `test` proof is a JUnit XML file of test results, bound to the criterion.
252
268
  Record it yourself the first time, unless the policy file sets
253
269
  `criteria.test_proof: ci`. CI then records it. Run the repository's test
@@ -270,23 +286,25 @@ each proof that is not current, and runs them.
270
286
  - files: "apps/api/src/test/java/**/*Test.java"
271
287
  command: 'cd apps/api && ./mvnw -q test -Dtest="$(for f in {files}; do basename "$f" .java; done | paste -sd, -)"'
272
288
  ```
273
- - A proof that no test can make stays without a test. Give the reason in
289
+ - A proof this host cannot produce is the one proof that can stay unproven.
290
+ It needs something the host does not have, such as macOS, Windows, a
291
+ physical device or a real third-party account. Name what it needs in
274
292
  `build-reports/evidence.md`.
275
293
  - A setup command that fails is a fault to fix. Examples are a database, an
276
- app or a browser that does not start. It is not a proof that no test can
277
- make. Read the error and fix the cause. If you cannot, still write and
278
- commit the test for each criterion. Then quote the command and its error in
279
- `build-reports/evidence.md`. Without a committed test, no later job can
280
- record the proof.
281
-
282
- Commit the setup file and every test. In a runner build (`OUTERLAYER_JOB_DIR`
283
- is set), run `outerlayer work proofs --check` from the committed checkout. In a
284
- local session, run `outerlayer work proofs --record`. Each stops when a
285
- tracked file differs from HEAD, and runs only what is committed at HEAD. Each
286
- skips a proof that is current. `--record` emits each proof at HEAD. `--check`
287
- emits nothing, because the host records each proof at the pushed head. Never emit by hand
288
- a proof that a test can make, except a `test` proof the first time, as above. Always pass `--pr <number>` when the item links
289
- more than one pull request in the repository.
294
+ app or a browser that does not start. It is not a proof this host cannot
295
+ produce. Read the error and fix the cause. If you cannot, quote the command
296
+ and its error in `build-reports/evidence.md`. The proof stays failed, and
297
+ the final report names it as failed, not as excused.
298
+
299
+ Commit every fix. In a runner build (`OUTERLAYER_JOB_DIR` is set), run
300
+ `outerlayer work proofs --check` from the committed checkout. In a local
301
+ session, run `outerlayer work proofs --record`. Each stops when a tracked file
302
+ differs from HEAD, and runs only what is committed at HEAD. Each skips a proof
303
+ that is current. `--record` emits each proof at HEAD. `--check` emits nothing,
304
+ because the host records each proof at the pushed head. Never emit by hand a
305
+ proof that a test can make, except a `test` proof the first time, as above.
306
+ Always pass `--pr <number>` when the item links more than one pull request in
307
+ the repository.
290
308
 
291
309
  The output names each proof that failed or is still not current, with the
292
310
  reason. Fix that test, commit it and run the same command again. Do not run it
@@ -295,6 +313,7 @@ orchestrator runs it once more, at the run's last head.
295
313
 
296
314
  Run `outerlayer sync`, then `outerlayer work proofs --item "$OUTERLAYER_WORK"`.
297
315
 
298
- Write `build-reports/evidence.md` naming every criterion with its artifact, or
299
- with the reason none could be produced. A criterion you could not evidence is
300
- a result, not a gap to leave silent.
316
+ Write `build-reports/evidence.md` naming every criterion with its artifact or
317
+ check result. Name each criterion with no test, each proof that still fails
318
+ with its error, and each proof this host cannot produce with what it needs. A
319
+ criterion you could not evidence is a result, not a gap to leave silent.
@@ -15,17 +15,22 @@ the issue, the pull request number, the criteria that declare a proof form, the
15
15
  instructions-file pointer and the outerlayer-evidence skill.
16
16
 
17
17
  A criterion that declares `proof: screenshot` needs a screenshot bound to its
18
- id. The evidence agent records it as a chapter of the item's demo, with a
19
- `demo.screenshot()` call. It emits a screenshot with `emit artifact` only for a
20
- state no demo test can reach. One that declares `proof: video` needs a video: its chapter of the
21
- item's one demo. A screenshot never satisfies `proof: video`. A criterion that declares `proof: test` needs
22
- passing test results at the head commit. A criterion with `proof: null` is one a person proves, and needs no artifact.
18
+ id: a chapter of the item's demo, with a `demo.screenshot()` call. The
19
+ evidence agent emits a screenshot with `emit artifact` only for a state no demo
20
+ test can reach. One that declares `proof: video` needs a video: its chapter of
21
+ the item's one demo. A screenshot never satisfies `proof: video`. A criterion
22
+ that declares `proof: test` needs passing test results at the head commit. A
23
+ criterion with `proof: null` is one a person proves, and needs no artifact.
23
24
 
24
- The evidence agent captures every proof from tests it commits with the
25
- change. Each test names the id of its criterion. `outerlayer work proofs --record`
26
- finds those tests at HEAD, runs them through `.outerlayer-proofs.yaml`, and emits
27
- each proof. A capture script outside the tests is not allowed, because no later
28
- session can run it again.
25
+ The implementer wrote and committed those tests in the Implement phase, before
26
+ the gate. Each test names the id of its criterion. `outerlayer work proofs
27
+ --record` finds those tests at HEAD, runs them through
28
+ `.outerlayer-proofs.yaml`, and emits each proof. The evidence agent runs them,
29
+ looks at what they record, and fixes what fails. It does not write a missing
30
+ demo test from the start. When its report names a criterion with no test,
31
+ spawn the implementer again with that list, to write those tests and nothing
32
+ else. Then spawn the evidence agent again. A capture script outside the tests
33
+ is not allowed, because no later session can run it again.
29
34
 
30
35
  After the evidence agent returns, run `outerlayer sync`, then
31
36
  `outerlayer work proofs --item "$OUTERLAYER_WORK"`. It lists each declared proof
@@ -45,10 +50,11 @@ In a runner build (`OUTERLAYER_JOB_DIR` is set), do not record a proof. Run
45
50
  setup, tests and teardown as `--record`. It reports each proof as passed or
46
51
  failed, and emits nothing. After the run ends, the host records each proof
47
52
  once, at the pushed head. A proof that fails the check fails there too. Fix
48
- its test, commit, and check again. The run ends when the check exits 0, or
49
- when `build-reports/evidence.md` names each proof that failed and the reason.
50
- A screenshot or video criterion with no committed demo test is not ready for
51
- that file. Write its test first, even when the app does not start here.
53
+ its test, commit, and check again. The run ends when the check exits 0,
54
+ apart from proofs this host cannot produce, as "Ending the run" in SKILL.md
55
+ says. A written reason excuses no other proof. A screenshot or video
56
+ criterion with no committed demo test goes back to the implementer, even
57
+ when the app does not start here.
52
58
 
53
59
  In a local session, push the last commit, then run
54
60
  `outerlayer work proofs --record` once. It records each proof that is not
@@ -73,12 +79,13 @@ ends. In a local session, the final report names each test proof with its
73
79
  artifact. In a runner build, it names each test proof that passed the check.
74
80
 
75
81
  In a local session, run the list command once more before the run ends. A
76
- criterion still listed as out of date or missing goes in
77
- `build-reports/evidence.md` with the reason. In a runner build, the list shows
78
- each proof as out of date or missing until the host records it. There, a
79
- proof that fails `--check` goes in `build-reports/evidence.md` with the
80
- reason. A written reason never excuses a `failed` row. Fix it first. Never
81
- drive the browser yourself.
82
+ criterion still listed as out of date or missing needs a fix, unless this
83
+ host cannot produce its proof. In a runner build, the list shows each proof
84
+ as out of date or missing until the host records it. There, a proof that
85
+ fails `--check` needs a fix in the same way. `build-reports/evidence.md`
86
+ names each proof that still fails with its error, so the final report names
87
+ it as failed. A written reason never excuses a `failed` row. Never drive the
88
+ browser yourself.
82
89
 
83
90
  Re-read the pull request's evidence comment. Resolve or escalate every row that
84
91
  needs attention. A row is resolved when a re-read shows it, not when the fixing