@linzumi/cli 1.0.171 → 1.0.173

package/dist/topics-cli.mjs

@@ -0,0 +1,58 @@
+import { createRequire as __linzumiBundleCreateRequire } from 'node:module';
+const require = __linzumiBundleCreateRequire(import.meta.url);
+import*as K from"node:crypto";function k(e){if(e===null||e.BS_PRIVATE_NESTED_SOME_NONE===void 0)return e;let t=e.BS_PRIVATE_NESTED_SOME_NONE;if(t!==0)return{BS_PRIVATE_NESTED_SOME_NONE:t-1|0}}function W(e,t){let i=e.length,s=new Array(i),o=0;for(let l=0;l<i;++l){let n=e[l],u=t(n);u!==void 0&&(s[o]=k(u),o=o+1|0)}return s.length=o,s}var P=(e=>t=>t&&typeof t[e]=="string"?t[e]:void 0),ye=P("stack"),C=P("message"),we=P("name"),Se=P("fileName");function p(e,t){if(e!==void 0)return t(k(e))}function _(e,t){return e!==void 0?k(e):t}function z(e,t){return e!==void 0?e:t}function U(e){return e===void 0}function B(e,t){let i=e.indexOf(t);if(i!==-1)return i}function se(e){return e==null?!1:typeof e.RE_EXN_ID=="string"}function L(e){return se(e)?e:{RE_EXN_ID:"JsExn",_1:e}}function ae(e){return K.createHash("sha256").update(e,"utf8").digest().subarray(0,8).toString("base64url")}function R(e,t){return{operationName:e,documentId:ae(t),text:t}}var Q=R("TopicsCliTopicLookup",`query TopicsCliTopicLookup($workspaceSlug: String!, $slug: String!) {
+  topic(workspaceSlug: $workspaceSlug, slug: $slug) {
+    id
+    slug
+    title
+    status
+  }
+}`),Y=R("TopicsCliCreateTopic",`mutation TopicsCliCreateTopic($input: CreateTopicInput!) {
+  createTopic(input: $input) {
+    ok
+    error
+    topic {
+      id
+      slug
+    }
+  }
+}`),Z=R("TopicsCliPostEntry",`mutation TopicsCliPostEntry($input: PostTopicEntryInput!) {
+  postTopicEntry(input: $input) {
+    ok
+    error
+    entry {
+      entrySeq
+    }
+  }
+}`),ke=[Q,Y,Z],M=["plan","reasoning","command_execution","terminal_input","file_change","tool_call","approval_request","web_search","status","artifact","assistant_output"];function G(){return`Usage: linzumi topics post [options]
+
+Post one entry into a long-lived topic (spec/topics-rules.md). The topic
+auto-creates on first post, so producers never lose an entry to a missing
+topic.
+
+Required:
+  --workspace <slug>       Workspace the topic lives in.
+  --topic <slug>           The topic's per-workspace slug.
+
+Options:
+  --kind <kind>            Entry kind (default: status). One of:
+                           `+M.join(", ")+`.
+  --preview <text>         Short preview line for collapsed rendering.
+  --body <text>            Full entry body text.
+  --payload-json <json>    JSON object payload (e.g. '{"severity":"error"}').
+  --dedupe-key <key>       Idempotency key; a replayed post with the same key
+                           returns the existing entry.
+  --title <text>           Title used only when the topic auto-creates.
+  --no-create              Fail instead of auto-creating a missing topic.
+  --json                   Machine-readable output.
+  --linzumi-url <url>      Server URL (defaults to the production server).
+  --token <token>          Explicit access token (defaults to cached login).
+  -h, --help               Show this help.
+`}var de=["workspace","topic","kind","preview","body","payload-json","dedupe-key","title","linzumi-url","api-url","token"],ce=["json","help","no-create"];function pe(e){let t=[],i={},s,o=0;for(;U(s)&&o<e.length;){let n=e[o];if(n==="-h"||n==="--help")i.help="FlagOn";else if(n.startsWith("--")){let u=B(n,"="),r=u!==void 0?n.slice(2,u):n.slice(2);if(ce.includes(r))u!==void 0?s="--"+r+" does not take a value":i[r]="FlagOn";else if(de.includes(r))if(u!==void 0)i[r]={TAG:"FlagString",_0:n.slice(u+1|0)};else{let d=e[o+1|0],O=0;d!==void 0&&!d.startsWith("--")?(i[r]={TAG:"FlagString",_0:d},o=o+1|0):O=1,O===1&&(s="--"+r+" requires a value")}else s="unknown flag --"+r+" (see: linzumi topics --help)"}else t.push(n);o=o+1|0}let l=s;return l!==void 0?{TAG:"Error",_0:l}:{TAG:"Ok",_0:{subcommand:t[0],flags:i}}}function m(e,t){let i=e[t];if(typeof i=="object")return i._0}function I(e,t){let i=e[t];return i!==void 0?typeof i!="object":!1}function _e(e){let t;try{t=JSON.parse(e)}catch{return{TAG:"Error",_0:"--payload-json must be valid JSON"}}return typeof t=="object"&&t!==null&&!Array.isArray(t)?{TAG:"Ok",_0:void 0}:{TAG:"Error",_0:"--payload-json must be a JSON object"}}function f(e,t){if(typeof e=="object"&&e!==null&&!Array.isArray(e))return e[t]}function w(e){if(typeof e=="string")return e}function V(e){if(typeof e=="boolean")return e}function me(e){if(typeof e=="number")return e}function he(e,t,i,s){let o=f(s,"errors"),l=o!==void 0?Array.isArray(o)?o:[]:[];if(l.length!==0){let u=W(l,r=>p(f(r,"extensions"),d=>w(f(d,"code"))));return u.includes("PERSISTED_DOCUMENT_NOT_FOUND")?"DocumentNotFound":{TAG:"GraphqlErrors",_0:{messages:l.map(r=>_(w(f(r,"message")),"unknown error")),codes:u}}}if(!e)return{TAG:"HttpFailure",_0:"HTTP "+t.toString()+" "+i};let n=f(s,"data");return n!==void 0?{TAG:"Data",_0:n}:{TAG:"HttpFailure",_0:"empty response body"}}function H(e){if(typeof e!="object")return"topics request failed";switch(e.TAG){case"Data":return"topics request failed";case"GraphqlErrors":let t=e._0;if(t.codes.includes("FREE_FORM_GRAPHQL_FORBIDDEN"))return"this Linzumi server does not know this CLI version's topics documents yet (its persisted-document manifest predates them); nothing was changed - retry after the next server deploy";let i=t.messages;return i.some(o=>{let l=o.toLowerCase();return l.includes("cannot query field")||l.includes("unknown argument")||l.includes("unknown type")||l.includes("unknown field")?!0:l.includes("has invalid value $input")})?"this Linzumi server does not support topics yet (the topics server rollout has not reached it); nothing was changed":"topics request returned errors: "+i.join("; ");case"HttpFailure":return"topics request failed: "+e._0}}function Oe(e,t,i){let s=async o=>{let l=Object.fromEntries([["content-type","application/json"],["authorization","Bearer "+t]]),n=await i(e,{method:"POST",headers:l,body:JSON.stringify(o)}),u;try{u=await n.json()}catch{u=null}return he(n.ok,n.status,n.statusText,u)};return async(o,l)=>{let n=await s(Object.fromEntries([["documentId",o.documentId],["operationName",o.operationName],["variables",l]]));if(typeof n!="object"){let u=await s(Object.fromEntries([["query",o.text],["operationName",o.operationName],["variables",l]]));return typeof u!="object"||u.TAG!=="Data"?{TAG:"Error",_0:H(u)}:{TAG:"Ok",_0:u._0}}switch(n.TAG){case"Data":return{TAG:"Ok",_0:n._0};case"GraphqlErrors":case"HttpFailure":return{TAG:"Error",_0:H(n)}}}}function ge(e){return Object.fromEntries([["workspaceSlug",e.workspaceSlug],["slug",e.topicSlug]])}async function X(e,t){let i=await e(Q,ge(t));return i.TAG==="Ok"?{TAG:"Ok",_0:w(p(f(i._0,"topic"),s=>f(s,"id")))}:{TAG:"Error",_0:i._0}}async function Ee(e,t){if(!M.includes(t.kind))return{TAG:"Error",_0:'unknown entry kind "'+t.kind+'" (one of: '+M.join(", ")+")"};let i=t.payloadJson,s=i!==void 0?_e(i):{TAG:"Ok",_0:void 0};if(s.TAG!=="Ok")return{TAG:"Error",_0:s._0};let o=await X(e,t);if(o.TAG!=="Ok")return{TAG:"Error",_0:o._0};let l=o._0,n;if(l!==void 0)n={TAG:"Ok",_0:[l,!1]};else if(t.createMissing){let h=Object.fromEntries([["workspaceSlug",t.workspaceSlug],["slug",t.topicSlug]]),j=t.title;j!==void 0&&(h.title=j);let N=await e(Y,Object.fromEntries([["input",h]]));if(N.TAG==="Ok"){let F=f(N._0,"createTopic"),ee=_(V(p(F,c=>f(c,"ok"))),!1),D=w(p(p(F,c=>f(c,"topic")),c=>f(c,"id"))),A=w(p(F,c=>f(c,"error"))),q=0;if(ee&&D!==void 0?n={TAG:"Ok",_0:[D,!0]}:q=1,q===1){let c;if(A!==void 0){let T=A.toLowerCase();c=T.includes("taken")||T.includes("slug")}else c=!1;if(c){let T=await X(e,t),$=0;if(T.TAG==="Ok"){let J=T._0;J!==void 0?n={TAG:"Ok",_0:[J,!1]}:$=2}else $=2;$===2&&(n={TAG:"Error",_0:'could not create topic "'+t.topicSlug+'": '+_(A,"unknown error")})}else n={TAG:"Error",_0:'could not create topic "'+t.topicSlug+'": '+_(A,"unknown error")}}}else n={TAG:"Error",_0:N._0}}else n={TAG:"Error",_0:'topic "'+t.topicSlug+'" does not exist in workspace "'+t.workspaceSlug+'" (drop --no-create to auto-create it)'};if(n.TAG!=="Ok")return{TAG:"Error",_0:n._0};let u=n._0,r=Object.fromEntries([["topicId",u[0]],["kind",t.kind.toUpperCase()]]),d=t.preview;d!==void 0&&(r.previewText=d);let O=t.body;O!==void 0&&(r.body=O);let S=t.payloadJson;S!==void 0&&(r.payloadJson=S);let v=t.dedupeKey;v!==void 0&&(r.dedupeKey=v);let g=await e(Z,Object.fromEntries([["input",r]]));if(g.TAG!=="Ok")return{TAG:"Error",_0:g._0};let y=f(g._0,"postTopicEntry"),b=_(V(p(y,h=>f(h,"ok"))),!1),a=me(p(p(y,h=>f(h,"entry")),h=>f(h,"entrySeq")));if(b&&a!==void 0)return{TAG:"Ok",_0:{topicSlug:t.topicSlug,entrySeq:a|0,created:u[1]}};let E=w(p(y,h=>f(h,"error")));return{TAG:"Error",_0:'could not post to topic "'+t.topicSlug+'": '+_(E,"unknown error")}}async function be(e,t){let i=t.stdout,s=i!==void 0?i:u=>{process.stdout.write(u)},o=t.stderr,l=o!==void 0?o:u=>{process.stderr.write(u)},n=pe(e);if(n.TAG==="Ok"){let u=n._0,r=u.flags,d=u.subcommand;if(I(r,"help"))return s(G()),0;if(d!==void 0){if(d==="post"){let O=m(r,"workspace"),S=m(r,"topic");if(O!==void 0){if(S!==void 0){let v=_(z(m(r,"linzumi-url"),m(r,"api-url")),t.defaultUrl),g,y=0,b;try{let a=m(r,"token");b=await(a!==void 0?t.resolveToken({kandanUrl:v,explicitToken:a}):t.resolveToken({kandanUrl:v})),y=1}catch(a){let E=L(a);if(E.RE_EXN_ID==="JsExn")g={TAG:"Error",_0:_(C(E._1),"token resolution failed")};else throw E}if(y===1){let a=Oe(t.graphqlEndpoint(v),b,_(t.fetchImpl,fetch));g=await Ee(a,{workspaceSlug:O,topicSlug:S,kind:_(m(r,"kind"),"status"),preview:m(r,"preview"),body:m(r,"body"),payloadJson:m(r,"payload-json"),dedupeKey:m(r,"dedupe-key"),title:m(r,"title"),createMissing:!I(r,"no-create")})}if(g.TAG==="Ok"){let a=g._0;if(I(r,"json")){let E=Object.fromEntries([["topicSlug",a.topicSlug],["entrySeq",a.entrySeq],["created",a.created]]);s(JSON.stringify(E)+`
+`)}else{let E=a.created?" (topic auto-created)":"";s("posted entry #"+a.entrySeq.toString()+" to "+O+"/"+a.topicSlug+E+`
+`)}return 0}return l(g._0+`
+`),1}return l(`--workspace and --topic are required (see: linzumi topics --help)
+`),1}return l(`--workspace and --topic are required (see: linzumi topics --help)
+`),1}return l('unknown topics subcommand "'+d+`"
+`),s(G()),1}return s(G()),1}return l(n._0+`
+`),1}export{ce as booleanFlags,Y as createDocument,Oe as createTransport,R as documentOf,ke as documents,H as errorFromOutcome,I as flagOn,m as flagString,G as helpText,he as interpretGraphqlResponse,V as jsonBool,f as jsonField,me as jsonNumber,w as jsonString,Q as lookupDocument,X as lookupTopicId,ge as lookupVariables,pe as parseTopicsArgs,ae as persistedDocumentId,Z as postDocument,Ee as postTopicEntry,be as runTopicsCommand,M as topicEntryKinds,_e as validatePayloadJson,de as valueFlags};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linzumi/cli",
-  "version": "1.0.171",
+  "version": "1.0.173",
   "description": "Linzumi CLI \u2014 point a Codex agent at the real code on your laptop, with your team watching and steering from shared threads.",
   "type": "module",
   "bin": {

package/scripts/build.mjs

@@ -156,6 +156,43 @@ try {
   );
 }
 
+// Long-lived topics producer (spec/topics-rules.md :topics/first-producers-v1
+// slice a): `linzumi topics post` is ReScript per the zero-TS program
+// (CommanderTopicsCli.res); bundle it beside the flat CLI bundle so the
+// dispatcher's `new URL('./topics-cli.mjs', import.meta.url)` resolves at
+// runtime. Publish CI compiles @linzumi/cli-rescript before pack, so real
+// releases always carry it; a checkout without the compiled artifacts gets
+// the same warn-and-skip posture as the mcp bundle above (the dispatcher
+// then falls back to the package-source candidate, and failing that prints
+// an honest "unavailable in this build" refusal).
+try {
+  await build({
+    entryPoints: [
+      join(
+        packageRoot,
+        '../linzumi-cli-rescript/src/topics/CommanderTopicsCli.res.mjs'
+      ),
+    ],
+    bundle: true,
+    platform: 'node',
+    target: 'node20',
+    format: 'esm',
+    outfile: join(packageRoot, 'dist/topics-cli.mjs'),
+    minify: true,
+    sourcemap: false,
+    legalComments: 'none',
+    banner,
+  });
+} catch (error) {
+  console.warn(
+    '[build] topics-cli bundle could not be built (are the ' +
+      'linzumi-cli-rescript artifacts compiled?); `linzumi topics post` ' +
+      `falls back to the package-source candidate: ${
+        error instanceof Error ? error.message : String(error)
+      }`
+  );
+}
+
 // The in-guest CLOUD turn driver: a self-contained dist/cloud-supervisor.mjs
 // bundle that vmCloudSupervisor injects onto the persistent overlay of a
 // workspace-agent smolcloud VM and runs with a bare `node` (the guest's

package/scripts/codex-wire-canary.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Codex wire canary launcher (spec/codex-wire-capture-replay.spec.md, "Live
+# canary lane"): resolves the wire corpus + the pinned @openai/codex version
+# and runs the ReScript canary bin (HarnessCodexWireCanaryMain.res).
+#
+#   codex-wire-canary.sh corpus            the scheduled corpus check
+#                                          (fidelity + shape baseline +
+#                                          freshness vs the pinned codex)
+#   codex-wire-canary.sh fresh <capture>   drift-diff a freshly recorded
+#                                          canary capture BEFORE promotion
+#
+# The canary corpus is every wire capture the replay lane treats as real
+# wire truth: test/fixtures/agent-raw-replay/wire-corpus/*.ndjson plus the
+# real-probe session (test/fixtures/agent-raw-replay/real-probe/codex.ndjson).
+# The committed shape baseline lives beside the corpus
+# (wire-corpus/shape-baseline.json); the vitest corpus gate pins the same
+# set, so this script and the test cannot disagree silently.
+#
+# Build the ReScript package first (`npx rescript build
+# packages/linzumi-cli-rescript`); the CLI test pipeline already does.
+set -euo pipefail
+
+here="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cli_root="$(cd "$here/.." && pwd)"
+bin_module="$cli_root/../linzumi-cli-rescript/src/harness/HarnessCodexWireCanaryMain.res.mjs"
+baseline="$cli_root/test/fixtures/agent-raw-replay/wire-corpus/shape-baseline.json"
+
+if [[ ! -f "$bin_module" ]]; then
+  echo "codex-wire-canary: compiled module missing at $bin_module - run: npx rescript build <repo>/packages/linzumi-cli-rescript" >&2
+  exit 66
+fi
+
+mode="${1:-}"
+case "$mode" in
+  corpus)
+    pinned_version="$(node -p "require('$cli_root/package.json').dependencies['@openai/codex'].replace(/^[^0-9]*/, '')")"
+    captures=("$cli_root"/test/fixtures/agent-raw-replay/wire-corpus/*.ndjson)
+    captures+=("$cli_root/test/fixtures/agent-raw-replay/real-probe/codex.ndjson")
+    exec node "$bin_module" corpus \
+      --baseline "$baseline" \
+      --pinned-codex-version "$pinned_version" \
+      "${captures[@]}"
+    ;;
+  fresh)
+    shift
+    if [[ $# -lt 1 ]]; then
+      echo "codex-wire-canary: fresh mode needs the freshly recorded capture path" >&2
+      exit 64
+    fi
+    exec node "$bin_module" fresh --baseline "$baseline" "$@"
+    ;;
+  *)
+    echo "codex-wire-canary: unknown mode '${mode}' (use corpus or fresh)" >&2
+    exit 64
+    ;;
+esac

package/scripts/replay-agent-backend.ts

@@ -67,6 +67,15 @@ type BackendReplayOptions = {
   // machinery is exercised against the REAL backend.
   readonly wire: boolean;
   readonly wireStrictness: string | undefined;
+  // Replay-to-a-point (spec §Replay-to-a-point): --wire-breakpoint specs
+  // for the wire stub (`ordinal:<n>`, `method:<rpcMethod>[:<n>]`,
+  // `first-delta`, `turn-started[:<n>]`, `turn-completed[:<n>]`), in hold
+  // order. While the stub holds, the whole stack (runner -> backend ->
+  // client projection) is frozen at the recorded prefix; an external
+  // driver (Playwright DOM assertions, the film rig) observes and releases
+  // the hold over the stub's HTTP control routes (GET /replay/breakpoint,
+  // POST /replay/resume against the printed control URL).
+  readonly wireBreakpoints: readonly string[];
 };
 
 type WireReplayServerHandle = {
@@ -93,6 +102,7 @@ async function startWireReplayServerForFixture(
       readonly capturePath?: string;
       readonly strictness?: string | undefined;
       readonly clock?: string | undefined;
+      readonly breakpoints?: readonly string[];
     }) => Promise<WireReplayServerHandle>;
     wireReplayClockForBackendSpeed: (
       speed: string | undefined
@@ -105,13 +115,27 @@ async function startWireReplayServerForFixture(
   // test/agentReplayFixture.test.ts.
   const wireClock = wireModule.wireReplayClockForBackendSpeed(options.speed);
 
-  return wireModule.startWireReplayServerJs({
+  const server = await wireModule.startWireReplayServerJs({
     capturePath: options.fixturePath,
     ...(options.wireStrictness === undefined
       ? {}
       : { strictness: options.wireStrictness }),
     ...(wireClock === undefined ? {} : { clock: wireClock }),
+    ...(options.wireBreakpoints.length === 0
+      ? {}
+      : { breakpoints: options.wireBreakpoints }),
   });
+  if (options.wireBreakpoints.length > 0) {
+    // The external driver's handle on the frozen stack: poll GET
+    // /replay/breakpoint until held, assert on the frozen DOM/projection,
+    // then POST /replay/resume.
+    console.error(
+      `[wire-breakpoint] control http://127.0.0.1:${server.port} breakpoints=${options.wireBreakpoints.join(
+        ','
+      )}`
+    );
+  }
+  return server;
 }
 
 type BackendReplayBrowserAuth = {
@@ -403,6 +427,7 @@ function parseArgs(args: readonly string[]): BackendReplayOptions {
     oracleFeatureId: argValue(args, '--oracle-feature'),
     wire: args.includes('--wire'),
     wireStrictness: argValue(args, '--wire-strictness'),
+    wireBreakpoints: argValues(args, '--wire-breakpoint'),
   };
 }
 
@@ -1888,6 +1913,24 @@ function evaluateRequiredFeatureGate(
   }
 }
 
+// Every value of a repeatable flag, in argv order (--wire-breakpoint may
+// name several ordered holds).
+function argValues(args: readonly string[], name: string): readonly string[] {
+  const values: string[] = [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] !== name) {
+      continue;
+    }
+    const value = args[index + 1];
+    if (value === undefined) {
+      throw new Error(`${name} requires a value`);
+    }
+    values.push(value);
+    index += 1;
+  }
+  return values;
+}
+
 function argValue(args: readonly string[], name: string): string | undefined {
   const index = args.indexOf(name);
 
@@ -1906,7 +1949,7 @@ function argValue(args: readonly string[], name: string): string | undefined {
 
 function printHelp(): void {
   process.stdout.write(
-    `Usage: pnpm run replay:agent-backend -- --fixture <path> [options]\n\nOptions:\n  --dry-run                         Validate fixture/manifest/diagnostics without backend connection\n  --probe-backend                   Also join the real Phoenix local_runner channel, then exit\n  --provider auto|codex|claude-code Replay provider. Default: auto\n  --speed immediate|realtime|<n>x|<n>ms\n                                      Replay speed. Default: immediate\n  --backend-url <url>               Local Phoenix backend URL; required by --probe-backend/replay\n  --setup-fixture                   Create a throwaway fixture user/workspace/channel first; requires local fixture registration\n  --setup-label <label>             Prefix for throwaway fixture setup. Default: agent-backend-replay\n  --workspace <slug>                Target workspace slug for session-token exchange and future replay\n  --channel <slug>                  Target channel slug for token scoping and future replay\n  --thread-id <id>                  Target thread id for the future backend replay slice\n  --runner-id <id>                  Local runner id for backend probing. Default: generated\n  --cwd <path>                      Cwd advertised in backend probe/replay. Default: current directory\n  --work-description <text>         Work description sent through the normal start mutation\n  --token <token>                   Local-runner token; also reads LINZUMI_AGENT_BACKEND_REPLAY_TOKEN\n  --session-token <token>           Browser/session token to exchange for a local-runner token; also reads LINZUMI_AGENT_BACKEND_REPLAY_SESSION_TOKEN\n  --out-dir <path>                  Artifact directory for summary.json. Default: agent-backend-replay-output\n  --wire                            Serve the fixture from the stub codex app-server websocket (spec/codex-wire-capture-replay.spec.md) so the runner's real socket machinery is exercised\n  --wire-strictness shape|exact     Wire mode validation of runner-sent packets against the recording. Default: shape\n  --require-feature <featureId>     Fail before backend setup unless manifest readiness says the feature is ready\n  --oracle-feature <featureId>      Run feature-specific backend oracles without using readiness as a preflight gate\n  --no-summary                      Do not write summary.json; stdout JSON is still printed\n\nExamples:\n  pnpm --filter @linzumi/cli run replay:agent-backend -- --fixture test/fixtures/agent-raw-replay/real-probe/claude.ndjson --provider claude-code --dry-run\n  pnpm --filter @linzumi/cli run replay:agent-backend -- --fixture test/fixtures/agent-raw-replay/real-probe/claude.ndjson --provider claude-code --probe-backend --backend-url http://127.0.0.1:4140 --workspace default --session-token <browser-session-token>\n  pnpm --filter @linzumi/cli run replay:agent-backend -- --fixture test/fixtures/agent-raw-replay/real-probe/claude.ndjson --provider claude-code --backend-url http://127.0.0.1:4140 --setup-fixture\n`
+    `Usage: pnpm run replay:agent-backend -- --fixture <path> [options]\n\nOptions:\n  --dry-run                         Validate fixture/manifest/diagnostics without backend connection\n  --probe-backend                   Also join the real Phoenix local_runner channel, then exit\n  --provider auto|codex|claude-code Replay provider. Default: auto\n  --speed immediate|realtime|<n>x|<n>ms\n                                      Replay speed. Default: immediate\n  --backend-url <url>               Local Phoenix backend URL; required by --probe-backend/replay\n  --setup-fixture                   Create a throwaway fixture user/workspace/channel first; requires local fixture registration\n  --setup-label <label>             Prefix for throwaway fixture setup. Default: agent-backend-replay\n  --workspace <slug>                Target workspace slug for session-token exchange and future replay\n  --channel <slug>                  Target channel slug for token scoping and future replay\n  --thread-id <id>                  Target thread id for the future backend replay slice\n  --runner-id <id>                  Local runner id for backend probing. Default: generated\n  --cwd <path>                      Cwd advertised in backend probe/replay. Default: current directory\n  --work-description <text>         Work description sent through the normal start mutation\n  --token <token>                   Local-runner token; also reads LINZUMI_AGENT_BACKEND_REPLAY_TOKEN\n  --session-token <token>           Browser/session token to exchange for a local-runner token; also reads LINZUMI_AGENT_BACKEND_REPLAY_SESSION_TOKEN\n  --out-dir <path>                  Artifact directory for summary.json. Default: agent-backend-replay-output\n  --wire                            Serve the fixture from the stub codex app-server websocket (spec/codex-wire-capture-replay.spec.md) so the runner's real socket machinery is exercised\n  --wire-strictness shape|exact     Wire mode validation of runner-sent packets against the recording. Default: shape\n  --wire-breakpoint <spec>          Replay-to-a-point hold (repeatable, ordered): ordinal:<n> | method:<rpcMethod>[:<n>] | first-delta | turn-started[:<n>] | turn-completed[:<n>]. The stub freezes the stack at the hold; observe/release via GET /replay/breakpoint + POST /replay/resume on the printed control URL\n  --require-feature <featureId>     Fail before backend setup unless manifest readiness says the feature is ready\n  --oracle-feature <featureId>      Run feature-specific backend oracles without using readiness as a preflight gate\n  --no-summary                      Do not write summary.json; stdout JSON is still printed\n\nExamples:\n  pnpm --filter @linzumi/cli run replay:agent-backend -- --fixture test/fixtures/agent-raw-replay/real-probe/claude.ndjson --provider claude-code --dry-run\n  pnpm --filter @linzumi/cli run replay:agent-backend -- --fixture test/fixtures/agent-raw-replay/real-probe/claude.ndjson --provider claude-code --probe-backend --backend-url http://127.0.0.1:4140 --workspace default --session-token <browser-session-token>\n  pnpm --filter @linzumi/cli run replay:agent-backend -- --fixture test/fixtures/agent-raw-replay/real-probe/claude.ndjson --provider claude-code --backend-url http://127.0.0.1:4140 --setup-fixture\n`
   );
 }