@outerlayer/cli 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @outerlayer/cli
 
+## 0.14.0
+
+### Minor Changes
+
+- 4921c80: `outerlayer init --update` brings the files `init` wrote once up to the installed CLI's version: the template skills, `.outerlayer/policy.yaml`, the `code-review.yaml` and `acceptance-criteria.yaml` checks in `.outerlayer/validators/`, and the `outerlayer` and `outerlayer-docs` MCP entries. A file still equal to what an earlier release wrote is replaced, a missing one is written, and a file you edited is never touched. It then runs `outerlayer context emit` and leaves the changes uncommitted. `--dry-run` prints the plan, with a command to compare each edited file. `outerlayer doctor` adds a **Starter files** check that reports each file as current, outdated, edited or missing. An `outerlayer` MCP entry an earlier `init` wrote is reported there, not by the **MCP server** check. The quickstart no longer says the MCP server needs a global install.
+- 23aa007: The starter skills `outerlayer init` installs gain three practices. `/spec` decides a docs verdict and a structural verdict for every issue, each with a one-line reason, and `writing-specs` defines both. A new `writing-tests` template holds a language-neutral test standard: strong assertions, the right seam, a criterion id in a comment above its test, and an optional mutation check. `writing-specs/references/agents-snippet.md` holds optional writing rules to paste into an instructions file. The `writing-specs` frontmatter now parses as YAML, so tools that read it see its description.
+- 789f55f: `outerlayer sync` prints a line for each artifact it uploads, with its file name, caption and dashboard link, so an agent can pass the link straight to `outerlayer emit code-review --link`. `sync --json` lists them under `uploadedArtifacts`, and the spool state records each artifact's server id and link against its client id. `outerlayer emit artifact` prints the link when it uploads at once, and inside a session says the next `sync` prints it.
+- ef97624: `outerlayer init` writes a second check, `.outerlayer/validators/acceptance-criteria.yaml`, only when it is missing. The starter `/build` skill records its criteria judge's verdict on that check, so every pull request it opens has a row for it. The build records pass only when the judge found every criterion it judged satisfied, and fail when it found one unmet. When there is no criterion to judge, it records nothing, so the row reads "not proven".
+
+### Patch Changes
+
+- 0e6256b: `work comment`, `work threads`, `work pr`, `work open-pr`, `emit result`, `emit artifact`, `emit criteria`, `emit finding`, `context emit`, `import capture` and `import ruler` no longer print ANSI color codes when output is piped or `NO_COLOR` is set. They follow the same color rules as the rest of the CLI, including `--no-color` and `FORCE_COLOR`. Output on a terminal is unchanged.
+
 ## 0.13.0
 
 ### Minor Changes

package/dist/agent-setup-CN2HUBEJ.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+export { keepHandWritten, runAgentSetup } from './chunk-SXWS25JC.js';
+import './chunk-HFKKFTXU.js';
+import './chunk-XCK2YAY5.js';
+import './chunk-FOJGZYFC.js';
+import './chunk-YRYMNBGQ.js';
+import './chunk-3NLOVYJQ.js';
+import './chunk-LCEXHCHD.js';
+import './chunk-ZJSNLVCE.js';
+import './chunk-YO4PSLVB.js';
+import './chunk-BYT5O5RV.js';
+import './chunk-ZA5CHAFY.js';
+import './chunk-2M63GG56.js';
+import './chunk-PLMTLGYH.js';
+import './chunk-J5M7BSJQ.js';
+import './chunk-EABW6AJQ.js';
+import './chunk-RA3O54FC.js';
+import './chunk-V7NIVOFD.js';
+import './chunk-ZM2IMMYN.js';
+import './chunk-XCCLFVXM.js';
+import './chunk-BJ3KTMDH.js';
+import './chunk-VNVZDWO3.js';
+import './chunk-Z5GEFMRW.js';
+
+createRequire(import.meta.url);

package/dist/{build-LELVCWHV.js → build-BG2YENGK.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { buildRepositoryImage } from './chunk-3FMPZPJQ.js';
-import './chunk-N5FOE5PS.js';
+export { buildRepositoryImage } from './chunk-R7PF5OOU.js';
 export { RecipeError } from './chunk-QOZKPLVJ.js';
+import './chunk-N5FOE5PS.js';
 import './chunk-CX22S5BA.js';
 import './chunk-BYT5O5RV.js';
 import './chunk-ZM2IMMYN.js';

package/dist/build-info.json

@@ -1 +1 @@
-{"id":"2026-10-08T17:26:49.421Z+36ec792","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}
+{"id":"2026-10-08T21:15:36.925Z+415a9ac","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}

package/dist/{builder-UUS4ORDH.js → builder-2D3WSOOY.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { MIN_BUILDX_VERSION, builderName, builderSpec, buildxState, ensureBuilder, ensureFailureCount, isOutOfMemory, proxyEnvironment, trackImageBuild } from './chunk-NX57IBNK.js';
-import './chunk-CX22S5BA.js';
-import './chunk-JXYVA45C.js';
+export { MIN_BUILDX_VERSION, builderName, builderSpec, buildxState, ensureBuilder, ensureFailureCount, isOutOfMemory, proxyEnvironment, trackImageBuild } from './chunk-4NPZVMJU.js';
 import './chunk-7RQ73DLO.js';
 import './chunk-4Q7OMKAT.js';
-import './chunk-J5M7BSJQ.js';
+import './chunk-CX22S5BA.js';
+import './chunk-JXYVA45C.js';
 import './chunk-BYT5O5RV.js';
+import './chunk-J5M7BSJQ.js';
 import './chunk-ZM2IMMYN.js';
 import './chunk-Z5GEFMRW.js';
 

package/dist/{check-63IDCEEV.js → check-SRGR36KI.js}

@@ -1,69 +1,69 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { probeCredentials } from './chunk-SVEP7PVH.js';
-import './chunk-C6IV5BV7.js';
+import { probeCredentials } from './chunk-NHDVD7DU.js';
+import './chunk-4OGPT6I2.js';
 import './chunk-O765JR4W.js';
 import './chunk-UGP76IZ5.js';
 import './chunk-3JVYMD4G.js';
 import './chunk-YETTWTAY.js';
 import './chunk-RMWLBUCJ.js';
 import './chunk-I2UOAV7X.js';
+import './chunk-HYZRY4KZ.js';
 import './chunk-FI5UYJMQ.js';
-import './chunk-XJKL4BNU.js';
-import './chunk-3D4OYFCD.js';
+import './chunk-KFRM23WD.js';
+import './chunk-MSASO5O4.js';
 import './chunk-HHJDN6AU.js';
-import './chunk-HYZRY4KZ.js';
-import { placeholderQueues, placeholderProblem, permissionModeProblems, permissionModeProblem, needsClaudeCredential, claudeCredentialCheck, claimPermissionProblem } from './chunk-TOPDNXHZ.js';
+import { placeholderQueues, placeholderProblem, permissionModeProblems, permissionModeProblem, needsClaudeCredential, claudeCredentialCheck, claimPermissionProblem } from './chunk-SMHOCDCI.js';
 import './chunk-YYYRBYWG.js';
 import './chunk-TI7B7UEO.js';
 import './chunk-TBT347UY.js';
-import './chunk-MJXXRX4M.js';
-import './chunk-P6FX4D43.js';
-import './chunk-MZN7AQOB.js';
+import './chunk-Q2UK3C4P.js';
+import './chunk-JYIEHQIF.js';
+import './chunk-RBKIH5ST.js';
+import './chunk-KMDLFI4P.js';
+import './chunk-QKFB4K7X.js';
+import './chunk-RSNSZ2LJ.js';
 import './chunk-T5VPP6H7.js';
 import './chunk-RLYZLUQ7.js';
 import { parseRunnerEnv } from './chunk-6MZSX4M7.js';
-import './chunk-3FMPZPJQ.js';
+import './chunk-SWHQ4LUM.js';
+import './chunk-NPQWKGUA.js';
+import './chunk-IP7BIBXJ.js';
+import { loadRunnerConfig, RunnerConfigError, checkHooks } from './chunk-22RMZBGW.js';
+import './chunk-UXYLWVTQ.js';
+import './chunk-R7PF5OOU.js';
+import './chunk-QOZKPLVJ.js';
 import './chunk-N5FOE5PS.js';
 import './chunk-OGFGZQA3.js';
-import './chunk-3KTA5UU2.js';
-import './chunk-QOZKPLVJ.js';
-import './chunk-NX57IBNK.js';
+import './chunk-4NPZVMJU.js';
+import './chunk-7RQ73DLO.js';
+import './chunk-4Q7OMKAT.js';
 import './chunk-CX22S5BA.js';
-import './chunk-QKFB4K7X.js';
-import './chunk-RSNSZ2LJ.js';
 import './chunk-F7CU5ABH.js';
 import './chunk-BKO6JEZI.js';
-import './chunk-P4MM66C6.js';
-import './chunk-EFZLAYPE.js';
-import './chunk-IP7BIBXJ.js';
-import './chunk-4QVZCVWT.js';
-import './chunk-CNFVHDHG.js';
+import './chunk-YDSMROTB.js';
+import './chunk-WUYTWNMA.js';
 import './chunk-JXYVA45C.js';
 import './chunk-4KSQKQXE.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
-import { loadRunnerConfig, RunnerConfigError, checkHooks } from './chunk-22RMZBGW.js';
-import './chunk-UXYLWVTQ.js';
-import './chunk-7RQ73DLO.js';
-import './chunk-4Q7OMKAT.js';
 import './chunk-GQD22KKN.js';
 import './chunk-WZBHBH3J.js';
 import './chunk-5QRP3MVS.js';
-import './chunk-GI4XXD4I.js';
-import './chunk-ZJSNLVCE.js';
-import './chunk-TCIW27FM.js';
+import './chunk-3NLOVYJQ.js';
 import './chunk-LCEXHCHD.js';
-import './chunk-2M63GG56.js';
+import './chunk-ZJSNLVCE.js';
 import './chunk-YO4PSLVB.js';
+import './chunk-BYT5O5RV.js';
+import './chunk-ZA5CHAFY.js';
+import './chunk-2M63GG56.js';
 import './chunk-PLMTLGYH.js';
 import './chunk-J5M7BSJQ.js';
 import './chunk-EABW6AJQ.js';
-import './chunk-BYT5O5RV.js';
 import './chunk-RA3O54FC.js';
 import './chunk-V7NIVOFD.js';
 import './chunk-ZM2IMMYN.js';
-import './chunk-SFFHGX3G.js';
+import './chunk-PQUM37BK.js';
 import './chunk-XCCLFVXM.js';
 import './chunk-BJ3KTMDH.js';
 import './chunk-VNVZDWO3.js';

package/dist/{chunk-GI4XXD4I.js → chunk-3NLOVYJQ.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { appendContextProvenance } from './chunk-ZJSNLVCE.js';
-import { loadMaintainedFiles, writeMaintainedFiles } from './chunk-TCIW27FM.js';
 import { readPin, pinExists, readBuildHold, readContextManifest, manifestFilesPresent, writeDegraded, writeSourceCache, SOURCE_CACHE_TTL_RETRY_MS, SOURCE_CACHE_TTL_SUCCESS_MS, isLastCheckFresh, readDegraded, touchLastCheck, clearDegraded, writeContextManifest, writePinIfChanged, readSourceCache, isSourceCacheFresh } from './chunk-LCEXHCHD.js';
-import { normalizeRepoName, parseGoverns, CONTEXT_SOURCE_CONFIG_PATH, parseOuterlayerConfig, classifyTree, emitTree } from './chunk-2M63GG56.js';
+import { appendContextProvenance } from './chunk-ZJSNLVCE.js';
 import { defaultFetch } from './chunk-YO4PSLVB.js';
-import { resolveGatewayCredentials } from './chunk-PLMTLGYH.js';
 import { withTokenHeader } from './chunk-BYT5O5RV.js';
+import { loadMaintainedFiles, writeMaintainedFiles } from './chunk-ZA5CHAFY.js';
+import { normalizeRepoName, parseGoverns, CONTEXT_SOURCE_CONFIG_PATH, parseOuterlayerConfig, classifyTree, emitTree } from './chunk-2M63GG56.js';
+import { resolveGatewayCredentials } from './chunk-PLMTLGYH.js';
 import { ensureContextExcludes, ensurePreCommitGuardHook } from './chunk-XCCLFVXM.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import { execFileSync } from 'child_process';

package/dist/{chunk-C6IV5BV7.js → chunk-4OGPT6I2.js}

@@ -1,25 +1,25 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { writeJobFile, readJobFile } from './chunk-RMWLBUCJ.js';
-import { senderPidfile } from './chunk-XJKL4BNU.js';
-import { installScrubContext } from './chunk-3D4OYFCD.js';
 import { DOCKERD_LOG } from './chunk-HYZRY4KZ.js';
-import { AssetError, describeCallFailure, obtainImage, ensureRootfs, gitRemoteFor, startServicesFor, createBuildDisk, machineConfig, refusalCode, resolveAgentUser, AgentUserError, runBuildSteps, removeStagedContext, stageGovernedContext, shellQuote, createRunnerLog, createContainerRuntime, stopContainer, cleanupContainer, outOfMemoryReason, formatDuration, retrySend, formatClock, containerSenderCommand, syncInContainer, copyTranscriptsFromContainer, GH_CONFIG_YML, ghHostsYml, ADDED_USER, isLiteralAddress, signalInContainer, deleteBuildDisk, startCheckContainer, lifecycleSteps, lifecycleFailureReason, writeEvalInput, EVAL_INPUT_NAME, copyTranscripts, senderSignalScript } from './chunk-MZN7AQOB.js';
-import { readBranchHead, diffBetween, fetchCommit } from './chunk-3FMPZPJQ.js';
-import { isSameProcess, startTimeOf } from './chunk-N5FOE5PS.js';
-import { childEnvironment } from './chunk-3KTA5UU2.js';
-import { CLAUDE_CODE_VERSION } from './chunk-CX22S5BA.js';
+import { senderPidfile } from './chunk-KFRM23WD.js';
+import { installScrubContext } from './chunk-MSASO5O4.js';
+import { AssetError, describeCallFailure, obtainImage, ensureRootfs, gitRemoteFor, startServicesFor, createBuildDisk, machineConfig, refusalCode, resolveAgentUser, AgentUserError, runBuildSteps, removeStagedContext, stageGovernedContext, shellQuote, createRunnerLog, createContainerRuntime, stopContainer, cleanupContainer, outOfMemoryReason, formatDuration, retrySend, formatClock, containerSenderCommand, syncInContainer, copyTranscriptsFromContainer, GH_CONFIG_YML, ghHostsYml, ADDED_USER, isLiteralAddress, signalInContainer, deleteBuildDisk, startCheckContainer, lifecycleSteps, lifecycleFailureReason, writeEvalInput, EVAL_INPUT_NAME, copyTranscripts, senderSignalScript } from './chunk-RBKIH5ST.js';
+import { childEnvironment } from './chunk-KMDLFI4P.js';
 import { waitForAgent, vmExecArgs } from './chunk-QKFB4K7X.js';
 import { socketPathProblem, vsockLinks, linkVsockSockets } from './chunk-RSNSZ2LJ.js';
-import { WorkCommandError, postJson, isSignatureRefusal, getJson } from './chunk-P4MM66C6.js';
-import { planArtifactUpload } from './chunk-CNFVHDHG.js';
-import { scrubText } from './chunk-JXYVA45C.js';
+import { WorkCommandError, postJson, isSignatureRefusal, getJson } from './chunk-SWHQ4LUM.js';
 import { isBuiltinContainer, isBuiltinProcess, isBuiltinVm, DEFAULT_CHECK_TIME_LIMIT_MINUTES } from './chunk-22RMZBGW.js';
+import { readBranchHead, diffBetween, fetchCommit } from './chunk-R7PF5OOU.js';
+import { isSameProcess, startTimeOf } from './chunk-N5FOE5PS.js';
 import { parseSize } from './chunk-7RQ73DLO.js';
 import { claudeCredential, repositoriesOf, primaryOf, buildEnvironment, JOB_MOUNT, CHECKOUT_DIR, parseIsolation, proxyEnvironment, containerLocalAddress, destinationEnvironment, CLAUDE_CREDENTIAL_VARIABLES, builtInEnvironment, startBuildServices, BUILT_IN_NAMES, AGENT_CREDENTIAL_MISSING, sharedUserEnvironment, headerVariables, withTunnelRecord, RELAY_PORT, checkEnvironment, EVAL_INPUT_DIR } from './chunk-4Q7OMKAT.js';
+import { CLAUDE_CODE_VERSION } from './chunk-CX22S5BA.js';
+import { planArtifactUpload } from './chunk-WUYTWNMA.js';
+import { scrubText } from './chunk-JXYVA45C.js';
+import { withHooksPath, authorEnvironment, commitIdentityRecord } from './chunk-BYT5O5RV.js';
 import { parsePolicy } from './chunk-2M63GG56.js';
 import { readCloudConfig } from './chunk-EABW6AJQ.js';
-import { withHooksPath, authorEnvironment, commitIdentityRecord } from './chunk-BYT5O5RV.js';
 import { resolveVersion } from './chunk-RA3O54FC.js';
 import { signerFor } from './chunk-V7NIVOFD.js';
 import { runnerDir, buildDir, vsockPath, RUNNER_FILE_MODE } from './chunk-ZM2IMMYN.js';

package/dist/{chunk-DXQ5MHCO.js → chunk-FOJGZYFC.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { C } from './chunk-YRYMNBGQ.js';
-import { resolvePackRoot, loadTemplateFiles, loadMaintainedFiles, TEMPLATE_SKILLS, skillDir, writeMaintainedFiles, MAINTAINED_SKILLS } from './chunk-TCIW27FM.js';
+import { resolvePackRoot, loadTemplateFiles, loadMaintainedFiles, TEMPLATE_SKILLS, skillDir, writeMaintainedFiles, MAINTAINED_SKILLS } from './chunk-ZA5CHAFY.js';
 import { resolvePackageVersion } from './chunk-RA3O54FC.js';
 import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
@@ -10,7 +10,10 @@ createRequire(import.meta.url);
 var DEFAULT_TEMPLATE = "default";
 var POLICY_PATH = ".outerlayer/policy.yaml";
 var POLICY_CONTENT = "review: required\n";
-var VALIDATOR_FILES = ["code-review.yaml"];
+var VALIDATOR_FILES = [
+  { name: "code-review.yaml", label: "the code review check" },
+  { name: "acceptance-criteria.yaml", label: "the criteria judge check" }
+];
 var VALIDATORS_DIR = ".outerlayer/validators";
 var StarterPackError = class extends Error {
 };
@@ -24,7 +27,7 @@ function installStarterPack(opts) {
   const version = opts.version ?? resolvePackageVersion();
   const templateFiles = loadTemplateFiles(packRoot, version);
   const maintainedFiles = loadMaintainedFiles(packRoot, version);
-  const validatorFiles = VALIDATOR_FILES.map((name) => ({
+  const validatorFiles = VALIDATOR_FILES.map(({ name }) => ({
     path: `${VALIDATORS_DIR}/${name}`,
     content: readFileSync(join(packRoot, "validators", name), "utf8")
   }));
@@ -72,6 +75,9 @@ function installStarterPack(opts) {
   };
 }
 var skillFile = (skill) => `${skillDir(skill)}/SKILL.md`;
+function validatorLabel(path) {
+  return VALIDATOR_FILES.find(({ name }) => path === `${VALIDATORS_DIR}/${name}`)?.label ?? "a check";
+}
 function formatStarterPackOutput(result) {
   const lines = [];
   lines.push(`${C.green}\u2713${C.reset} Installed the starter skills in .outerlayer/skills/`, "");
@@ -87,7 +93,7 @@ function formatStarterPackOutput(result) {
     "",
     result.policy === "written" ? `${C.green}\u2713${C.reset} Wrote ${POLICY_PATH} (review required)` : `${C.dim}${POLICY_PATH} already exists \u2014 left as it is${C.reset}`,
     ...result.validatorsWritten.map(
-      (path) => `${C.green}\u2713${C.reset} Wrote ${path} (yours to edit \u2014 the code review check)`
+      (path) => `${C.green}\u2713${C.reset} Wrote ${path} (yours to edit \u2014 ${validatorLabel(path)})`
     ),
     ...result.validatorsKept.map((path) => `${C.dim}${path} already exists \u2014 left as it is${C.reset}`),
     "",
@@ -97,4 +103,4 @@ function formatStarterPackOutput(result) {
   return lines.join("\n") + "\n";
 }
 
-export { StarterPackError, assertKnownTemplate, formatStarterPackOutput, installStarterPack };
+export { POLICY_CONTENT, POLICY_PATH, StarterPackError, VALIDATORS_DIR, VALIDATOR_FILES, assertKnownTemplate, formatStarterPackOutput, installStarterPack };

package/dist/{chunk-HDTVTA6I.js → chunk-HFKKFTXU.js}

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { maintainedFilesForExistingSkills, loadMaintainedFiles, writeMaintainedFiles } from './chunk-TCIW27FM.js';
+import { C } from './chunk-YRYMNBGQ.js';
+import { maintainedFilesForExistingSkills, loadMaintainedFiles, writeMaintainedFiles } from './chunk-ZA5CHAFY.js';
 import { emitTree, parseOuterlayerConfig, classifyTree, generatedHeaderSource, CONTEXT_PIN_FILENAME, normalizePath } from './chunk-2M63GG56.js';
 import { existsSync, readFileSync, mkdirSync, writeFileSync, copyFileSync, readdirSync } from 'fs';
 import { join, dirname, relative, sep } from 'path';
@@ -9,11 +10,6 @@ createRequire(import.meta.url);
 var CONTENT_KINDS = /* @__PURE__ */ new Set(["instructions", "skill", "skill-reference", "command", "mcp"]);
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git"]);
 var NO_CONFIG_MESSAGE = 'no .outerlayer/config.json with a non-empty targets array \u2014 create one, e.g. {"targets": ["claude-code"]}';
-var GREEN = "\x1B[32m";
-var YELLOW = "\x1B[33m";
-var RED = "\x1B[31m";
-var DIM = "\x1B[2m";
-var RESET = "\x1B[0m";
 var EmitError = class extends Error {
 };
 function resolveTargetsFromConfig(repoRoot) {
@@ -87,20 +83,20 @@ function writeOutputs(repoRoot, result, maintained) {
 function renderSuccess(targets, files, copies, maintained) {
   const copySuffix = copies.length > 0 ? `, ${copies.length} ${copies.length === 1 ? "copy" : "copies"}` : "";
   const lines = [
-    `${GREEN}\u2713${RESET} emitted ${files.length} file${files.length === 1 ? "" : "s"}${copySuffix} for ${DIM}${targets.join(", ")}${RESET}`
+    `${C.green}\u2713${C.reset} emitted ${files.length} file${files.length === 1 ? "" : "s"}${copySuffix} for ${C.dim}${targets.join(", ")}${C.reset}`
   ];
-  for (const path of maintained) lines.push(`  ${DIM}updated ${path} to this CLI's version${RESET}`);
+  for (const path of maintained) lines.push(`  ${C.dim}updated ${path} to this CLI's version${C.reset}`);
   return lines.join("\n");
 }
 function renderFailure(errors) {
-  const lines = [`${RED}\u2717${RESET} emit failed \u2014 nothing written`];
-  for (const e of errors) lines.push(`  ${RED}\u2717${RESET} ${e.path}: ${e.message}`);
+  const lines = [`${C.red}\u2717${C.reset} emit failed \u2014 nothing written`];
+  for (const e of errors) lines.push(`  ${C.red}\u2717${C.reset} ${e.path}: ${e.message}`);
   return lines.join("\n");
 }
 function renderCheck(targets, drift) {
-  if (drift.length === 0) return `${GREEN}\u2713${RESET} up to date for ${DIM}${targets.join(", ")}${RESET}`;
-  const lines = [`${RED}\u2717${RESET} drift detected (${drift.length}) \u2014 run \`outerlayer emit\` to update`];
-  for (const d of drift) lines.push(`  ${RED}\u2717${RESET} ${d.kind.padEnd(8)} ${d.path}`);
+  if (drift.length === 0) return `${C.green}\u2713${C.reset} up to date for ${C.dim}${targets.join(", ")}${C.reset}`;
+  const lines = [`${C.red}\u2717${C.reset} drift detected (${drift.length}) \u2014 run \`outerlayer emit\` to update`];
+  for (const d of drift) lines.push(`  ${C.red}\u2717${C.reset} ${d.kind.padEnd(8)} ${d.path}`);
   return lines.join("\n");
 }
 function compareFile(repoRoot, path, expectedContent) {
@@ -205,7 +201,7 @@ function runEmit(opts = {}) {
       process.stderr.write(output + "\n");
     } else {
       process.stdout.write(output + "\n");
-      for (const w of result.warnings) process.stderr.write(`  ${YELLOW}!${RESET} ${w.path}: ${w.message}
+      for (const w of result.warnings) process.stderr.write(`  ${C.yellow}!${C.reset} ${w.path}: ${w.message}
 `);
     }
   }
@@ -249,7 +245,7 @@ function runCheck(cwd, opts, targets, result, hasErrors, sourcePaths, maintained
       process.stderr.write(output + "\n");
     } else {
       process.stdout.write(output + "\n");
-      for (const w of result.warnings) process.stderr.write(`  ${YELLOW}!${RESET} ${w.path}: ${w.message}
+      for (const w of result.warnings) process.stderr.write(`  ${C.yellow}!${C.reset} ${w.path}: ${w.message}
 `);
     }
   }

package/dist/{chunk-DPKX26LT.js → chunk-HFKQIZXL.js}

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
+import { checkStarterFiles } from './chunk-MTF3PHVZ.js';
+import { resolveCredentials, getJson, WorkCommandError } from './chunk-SWHQ4LUM.js';
 import { readStatuslineState, STATE_FRESH_MS } from './chunk-F47JBIAW.js';
-import { resolveCredentials, getJson, WorkCommandError } from './chunk-P4MM66C6.js';
-import { isLinkedRepository } from './chunk-4QVZCVWT.js';
-import { sanitizeTerminal } from './chunk-CNFVHDHG.js';
+import { isLinkedRepository } from './chunk-YDSMROTB.js';
+import { sanitizeTerminal } from './chunk-WUYTWNMA.js';
 import { resolveRepoIdentity, compareVersions, SUPPORTED_VERSIONS } from './chunk-JXYVA45C.js';
 import { C } from './chunk-YRYMNBGQ.js';
 import { readSettings, settingsPath, isOurStatuslineSlot, statuslineWrappedOriginal, REGISTERED_EVENTS, isOurHookCommand, ourCommandBins, cliBinResolvable, ourDirectScriptBins, wrappedOriginalCommand } from './chunk-5QRP3MVS.js';
@@ -11,7 +12,7 @@ import { readPin, readContextManifest, readDegraded, readSourceCache } from './c
 import { defaultFetch } from './chunk-YO4PSLVB.js';
 import { resolveGatewayCredentials } from './chunk-PLMTLGYH.js';
 import { readCloudConfig } from './chunk-EABW6AJQ.js';
-import { sanitizeForContext, spoolDir, assessSyncHealth, readSyncStatus, SYNC_STALE_AFTER_MS, formatAgo, checkInstalledCliStaleness, workspaceRootOf, hookFiredMarkerPath, refreshCommand } from './chunk-SFFHGX3G.js';
+import { sanitizeForContext, spoolDir, assessSyncHealth, readSyncStatus, SYNC_STALE_AFTER_MS, formatAgo, checkInstalledCliStaleness, workspaceRootOf, hookFiredMarkerPath, refreshCommand } from './chunk-PQUM37BK.js';
 import { deadHooksState, preparePackageManagerCommand, contextExcludesPresent } from './chunk-XCCLFVXM.js';
 import { findGitDirs } from './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
@@ -174,6 +175,7 @@ function runDoctor(env = {}) {
   const now = env.now ?? Date.now;
   const laptop = env.runnerHost !== true;
   const transcripts = laptop ? scanTranscripts(home) : void 0;
+  const starter = laptop ? checkStarterFiles(env.cwd) : void 0;
   return [
     ...laptop ? [checkClaudeDir(home), checkTranscripts(transcripts, now), ...checkHooks(home, env.cwd, transcripts, now)] : [LAPTOP_CHECKS_NOT_APPLICABLE],
     ...checkDeadHooksState(env.cwd),
@@ -186,7 +188,8 @@ function runDoctor(env = {}) {
     checkSettingsValid(home, env.cwd),
     ...laptop ? checkStatusline(home, now, env.cwd) : [],
     ...checkInstalls(env),
-    ...laptop ? checkMcpCommand(env.cwd, env.processEnv) : [],
+    ...starter?.checks ?? [],
+    ...starter !== void 0 && !starter.mcpOutdated ? checkMcpCommand(env.cwd, env.processEnv) : [],
     ...checkContextSource(home, env.cwd),
     ...checkInstalledCli(home, env.cwd ?? process.cwd())
   ];
@@ -1092,7 +1095,7 @@ async function gatherDoctorChecks() {
     const { runnerVmCheck } = await import('./doctor-53F2PYY7.js');
     checks.push(runnerVmCheck(configPath, { lima: realLima(), home: homeFromEnv(), instance: runnerVm.instance }));
   } else if (hasRunnerBlock(configPath)) {
-    const { runnerHostChecks } = await import('./doctor-3H25Q7WT.js');
+    const { runnerHostChecks } = await import('./doctor-H7REBSLQ.js');
     const hooks = (() => {
       try {
         return loadRunnerConfig(configPath).hooks;

package/dist/{chunk-6S3H3J6H.js → chunk-JJEGKEFV.js}

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { autoConnect } from './chunk-EFZLAYPE.js';
+import { autoConnect } from './chunk-NPQWKGUA.js';
 import { detectActiveSession } from './chunk-IP7BIBXJ.js';
 import { resolveRepoIdentity } from './chunk-JXYVA45C.js';
+import { C } from './chunk-YRYMNBGQ.js';
 import { parseWorkItemEnv } from './chunk-GQD22KKN.js';
 import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
 import { defaultFetch } from './chunk-YO4PSLVB.js';
@@ -12,9 +13,6 @@ import { homeFromEnv } from './chunk-VNVZDWO3.js';
 createRequire(import.meta.url);
 
 // src/work-pr-cmd.ts
-var GREEN = "\x1B[32m";
-var DIM = "\x1B[2m";
-var RESET = "\x1B[0m";
 var WorkPrCommandError = class extends Error {
 };
 function resolveCredentials(opts) {
@@ -43,7 +41,7 @@ function sessionNotOnItemMessage(error, sessionId) {
 }
 function itemLabel(data) {
   if (data.workItemNumber == null) return data.workItemId;
-  return data.workItemTitle ? `item ${data.workItemNumber} ${DIM}\xB7${RESET} ${data.workItemTitle}` : `item ${data.workItemNumber}`;
+  return data.workItemTitle ? `item ${data.workItemNumber} ${C.dim}\xB7${C.reset} ${data.workItemTitle}` : `item ${data.workItemNumber}`;
 }
 async function runWorkPrWithdraw(opts, ctx) {
   const itemNumber = parseTrackerNumber(opts.item);
@@ -88,7 +86,7 @@ async function runWorkPrWithdraw(opts, ctx) {
     throw new WorkPrCommandError(json.error?.message ?? `request failed (${response.status})`);
   }
   const data = json.data;
-  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} withdrawn ${DIM}\xB7${RESET} ${data.repository}#${data.prNumber} ${DIM}from${RESET} item ${itemNumber}`;
+  const output = opts.json ? JSON.stringify(data) : `${C.green}\u2713${C.reset} withdrawn ${C.dim}\xB7${C.reset} ${data.repository}#${data.prNumber} ${C.dim}from${C.reset} item ${itemNumber}`;
   if (!opts.quiet) process.stdout.write(output + "\n");
   return { data, output };
 }
@@ -170,7 +168,7 @@ async function runWorkPr(opts) {
   }
   const data = json.data;
   const verb = data.created ? "declared" : "already declared";
-  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} ${verb} ${DIM}\xB7${RESET} ${data.repository}#${data.prNumber} ${DIM}\u2192${RESET} ${itemLabel(data)}`;
+  const output = opts.json ? JSON.stringify(data) : `${C.green}\u2713${C.reset} ${verb} ${C.dim}\xB7${C.reset} ${data.repository}#${data.prNumber} ${C.dim}\u2192${C.reset} ${itemLabel(data)}`;
   if (!opts.quiet) process.stdout.write(output + "\n");
   return { data, output };
 }

package/dist/{chunk-P6FX4D43.js → chunk-JYIEHQIF.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { MIN_ENGINE_MAJOR } from './chunk-MZN7AQOB.js';
+import { MIN_ENGINE_MAJOR } from './chunk-RBKIH5ST.js';
 import { firecrackerArch, MICROVM_ARCHES, guestAssetsPinned } from './chunk-CX22S5BA.js';
 import { spawnSync } from 'child_process';
 import { existsSync, accessSync, constants, statSync, readFileSync } from 'fs';

package/dist/{chunk-XJKL4BNU.js → chunk-KFRM23WD.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { LiveUploader } from './chunk-3D4OYFCD.js';
+import { LiveUploader } from './chunk-MSASO5O4.js';
 import { CaptureDaemon } from './chunk-JXYVA45C.js';
 import { parseWorkItemEnv } from './chunk-GQD22KKN.js';
-import { spoolDir } from './chunk-SFFHGX3G.js';
+import { spoolDir } from './chunk-PQUM37BK.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
 import { mkdirSync, writeFileSync, rmSync } from 'fs';
 import { join } from 'path';

package/dist/{chunk-3KTA5UU2.js → chunk-KMDLFI4P.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { RecipeError } from './chunk-QOZKPLVJ.js';
-import { trackImageBuild, isOutOfMemory, ensureBuilder } from './chunk-NX57IBNK.js';
+import { trackImageBuild, isOutOfMemory, ensureBuilder } from './chunk-4NPZVMJU.js';
 import { spawn } from 'child_process';
 import { existsSync, mkdirSync, createWriteStream, rmSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';

package/dist/{chunk-3D4OYFCD.js → chunk-MSASO5O4.js}

@@ -4,7 +4,7 @@ import { LaunchFilter } from './chunk-HHJDN6AU.js';
 import { RepoFilter } from './chunk-TBT347UY.js';
 import { hookExecSpoolPath } from './chunk-F7CU5ABH.js';
 import { applyReportedCost } from './chunk-BKO6JEZI.js';
-import { migrateLegacyArtifactSidecars, planArtifactUpload, artifactsStatePath, sanitizeTerminal, acquireArtifactSpoolLock, artifactBlobsDir, resolveArtifactTurnIndex, isArtifactTombstoned, ARTIFACT_RETRY_MAX_AGE_MS, writeArtifactSpoolState, reclaimUnneededArtifactBlobs, neededArtifactShas } from './chunk-CNFVHDHG.js';
+import { migrateLegacyArtifactSidecars, planArtifactUpload, artifactsStatePath, sanitizeTerminal, acquireArtifactSpoolLock, artifactBlobsDir, resolveArtifactTurnIndex, isArtifactTombstoned, ARTIFACT_RETRY_MAX_AGE_MS, writeArtifactSpoolState, reclaimUnneededArtifactBlobs, neededArtifactShas } from './chunk-WUYTWNMA.js';
 import { setCustomScrubbers, setLocalIdentity, tailTranscript, enrichSessionRepo, scanAll, setRepoRoot, resolveRepoIdentity, sessionIdFromPath, scrubDeep, SOURCE_ADAPTERS } from './chunk-JXYVA45C.js';
 import { C } from './chunk-YRYMNBGQ.js';
 import { readLaunchSpoolState, launchStatusIsDecisive, launchedItemsBySession, launchesPath } from './chunk-GQD22KKN.js';
@@ -14,7 +14,7 @@ import { resolveGatewayCredentials, unauthorizedMessage } from './chunk-PLMTLGYH
 import { CAPTURE_TIERS, inferArtifactKind, bannedPathsForTier, downconvertSession, isHumanUserTurn, turnCountBound, EVENT_TYPES } from './chunk-J5M7BSJQ.js';
 import { readCloudConfig, cloudConfigPath, writeCloudConfig } from './chunk-EABW6AJQ.js';
 import { signerFor, signRunnerRequest } from './chunk-V7NIVOFD.js';
-import { writeSyncStatus, spoolDir } from './chunk-SFFHGX3G.js';
+import { writeSyncStatus, spoolDir } from './chunk-PQUM37BK.js';
 import { removeJournalHooks } from './chunk-XCCLFVXM.js';
 import { readRepoConnection, findGitDirs } from './chunk-BJ3KTMDH.js';
 import { homeFromEnv } from './chunk-VNVZDWO3.js';
@@ -928,6 +928,21 @@ var NEVER_REACHED_SERVER_ERROR_CODES = /* @__PURE__ */ new Set([
   "payload_too_large",
   "unreadable_test_results"
 ]);
+async function readUploadedIdentity(response) {
+  let data;
+  try {
+    data = (await response.json()).data;
+  } catch {
+  }
+  return {
+    id: typeof data?.id === "string" ? data.id : null,
+    url: typeof data?.url === "string" ? data.url : null
+  };
+}
+function uploadedArtifactLine(artifact) {
+  const where = artifact.url !== null ? sanitizeTerminal(artifact.url) : artifact.id !== null ? `id ${sanitizeTerminal(artifact.id)} ${C.dim}(the gateway returned no link)${C.reset}` : `${C.dim}(the gateway returned no link)${C.reset}`;
+  return `  ${C.green}\u2191${C.reset} ${sanitizeTerminal(artifact.filename)} ${C.dim}\xB7${C.reset} ${sanitizeTerminal(artifact.caption)} ${C.dim}\xB7${C.reset} ${where}`;
+}
 function splitPayload(payload) {
   const mid = Math.ceil(payload.sessions.length / 2);
   const first = payload.sessions.slice(0, mid);
@@ -1553,10 +1568,12 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
     }
     let artifactsUploaded;
     let artifactsHeld;
+    let uploadedArtifacts;
     const artifactLock = combinedRecords.length > 0 || artifactPlan.held.length > 0 ? await acquireArtifactSpoolLock(home, { waitMs: opts.artifactLockWaitMs }) : void 0;
     if (artifactLock !== void 0 && !artifactLock.ok) {
       artifactsUploaded = 0;
       artifactsHeld = combinedRecords.length + artifactPlan.held.length;
+      uploadedArtifacts = [];
       if (!opts.quiet) {
         process.stderr.write(
           `${C.yellow}!${C.reset} artifacts not attempted: ${artifactLock.reason} \u2014 ${artifactsHeld} record(s) stay queued for the next sync
@@ -1575,6 +1592,7 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
       let uploadedCount = 0;
       let heldCount = livePlan.held.length;
       let droppedCount = 0;
+      const uploadedThisRun = [];
       const warn = (message) => {
         if (!opts.quiet) process.stderr.write(`${C.yellow}!${C.reset} ${message}
 `);
@@ -1651,6 +1669,7 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
         let status;
         let errorCode = "";
         let serverMessage = "";
+        let accepted;
         try {
           const response = await fetchImpl(artifactEndpoint, {
             method: "POST",
@@ -1670,19 +1689,31 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
               if (typeof body.error?.message === "string") serverMessage = body.error.message;
             } catch {
             }
+          } else {
+            accepted = response;
           }
         } catch (err) {
           failure = String(err);
         }
-        if (!failure) {
+        if (accepted !== void 0) {
+          const identity = await readUploadedIdentity(accepted);
           state.set(record.artifactId, {
             state: "uploaded",
             attempts: (existing?.attempts ?? 0) + 1,
             firstSeen: firstSeenIso,
             sha256: record.sha256,
-            reachedServer: true
+            reachedServer: true,
+            ...identity.id !== null ? { serverId: identity.id } : {},
+            ...identity.url !== null ? { url: identity.url } : {}
           });
           uploadedCount += 1;
+          uploadedThisRun.push({
+            artifactId: record.artifactId,
+            filename: record.filename,
+            caption: record.caption,
+            id: identity.id,
+            url: identity.url
+          });
           continue;
         }
         if (status === 401) {
@@ -1739,11 +1770,15 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
         artifactsUploaded = uploadedCount;
         artifactsHeld = heldCount;
         artifactsDropped = droppedCount;
+        uploadedArtifacts = uploadedThisRun;
         if (!opts.quiet) {
           process.stderr.write(
             `${C.dim}artifacts${C.reset} ${uploadedCount} uploaded \xB7 ${heldCount} held \xB7 ${droppedCount} dropped
 `
           );
+          if (!opts.json) {
+            for (const uploaded of uploadedThisRun) process.stdout.write(uploadedArtifactLine(uploaded) + "\n");
+          }
         }
       }
       const persisted = writeArtifactSpoolState(state, home);
@@ -1776,6 +1811,7 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
         );
       }
     }
+    const artifactReport = artifactsUploaded !== void 0 ? { artifactsUploaded, artifactsHeld, uploadedArtifacts } : {};
     let output;
     if (opts.json) {
       output = JSON.stringify({
@@ -1787,7 +1823,7 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
         artifactsDropped,
         tier,
         url,
-        ...artifactsUploaded !== void 0 ? { artifactsUploaded, artifactsHeld } : {}
+        ...artifactReport
       });
     } else {
       const lines = [];
@@ -1826,7 +1862,7 @@ ${C.yellow}!${C.reset} batch ${shippedBatches + 1}/${batches.length} accounting
       url,
       dryRun: false,
       watermarkMs,
-      ...artifactsUploaded !== void 0 ? { artifactsUploaded, artifactsHeld } : {},
+      ...artifactReport,
       output
     };
   }