@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/help-text.js

@@ -1,1112 +0,0 @@
-const HELP_ENTRIES = [
-    [
-        [],
-        `scriptctl — 剧本阶段统一 CLI
-
-Usage
-- scriptctl <query> [flags]             # read a script
-- scriptctl <verb> <address> [flags]    # edit a script
-- scriptctl ingest --source-path SRC    # txt/md/docx/video → Script v3
-
-Workflows
-- ingest    txt/md/docx/video → Script v3 workspace. Run: scriptctl ingest --help
-- view      Render a workspace script.json to review.html (no model)
-- checkout  Download one remote snapshot into a managed local working copy
-- status    Show whether the local working copy is managed and dirty
-- publish   Validate and CAS-publish the local working copy
-- export    Produce canonical file-backed authoring blocks from a local script
-
-Read
-- summary | episodes | scenes | actions
-- actors | locations | props | assets | states
-- issues | refs | validate
-
-Write
-- create | add-actor | add-location | add-prop | add-episode
-- replace | type | actor | emotion
-- insert | delete | move | split | merge
-- rename | describe | alias | role | importance | worldview | synopsis | extend
-- state-add | state-rename | state-delete | transition | scene-ref
-- dialogue
-
-Batch
-- write <file>      plan/apply complete script, episode, scene, or span blocks
-- ids               inspect the next unreserved canonical IDs
-- do [file|-]       run one CLI verb per line as one transaction
-- patch [file|-]    apply JSON ops; use --schema to inspect op shapes
-
-Tools
-- doctor | update | changelog
-
-Target
-- reads and edits use --script-path FILE (default: ./workspace/script.json)
-- remote access exists only in checkout/publish; project defaults from the environment
-- selection where supported: --in SELECTOR plus filters; see command help
-
-Output
-- default text is agent-facing
-- --json        structured envelope for jq/scripts
-- --format addr address stream for xargs / do generation
-
-More help
-- scriptctl <command> --help
-- scriptctl patch --schema
-
-Exit codes
-- 0   success
-- 64  usage or arguments error
-- 66  input file unavailable
-- 70  provider or runtime failure
-- 78  validation failed; agent repair needed
-`,
-    ],
-    [
-        ["update"],
-        `Update the globally installed scriptctl package.
-
-Usage
-- scriptctl update [options]
-
-Options
-- --dry-run         Show the package-manager command without running it.
-- --patch           Update only within the current major.minor patch line.
-- --json            Print machine-readable JSON.
-- --help            Show this help.
-`,
-    ],
-    [
-        ["changelog"],
-        `Show scriptctl feature changes.
-
-Usage
-- scriptctl changelog
-- scriptctl changelog <version>
-- scriptctl changelog --from <version> [--to <version>]
-- scriptctl changelog --unreleased
-
-Options
-- --from <version>  Show released changes after this version.
-- --to <version>    Upper bound for --from. Default: current package version.
-- --unreleased      Show development changes not yet assigned to a release.
-- --json            Print machine-readable JSON.
-- --help            Show this help.
-`,
-    ],
-    [
-        ["doctor"],
-        `Check the standalone scriptctl CLI environment.
-
-Usage
-- scriptctl doctor [options]
-
-Options
-- --llm-config <path>  LLM task/model routing YAML. Otherwise env, fixed global path, then built-in config.
-- --json            Print machine-readable JSON.
-- --help            Show this help.
-
-Checks
-- Node version
-- optional source-conversion/LLM dependencies
-- resolved LLM config, providers, profiles, task routes, and referenced credentials
-- local .env discovery
-- storage backend
-`,
-    ],
-    [
-        ["ingest"],
-        `Convert a txt/md/docx or video source into a Script v3 workspace.
-
-Text pipeline: pass1 chunk → pass2 normalize (DeepSeek Flash emits structured JSON,
-validated deterministically) → pass3 merge → compile (provisional script.initial.json +
-evidence) → pass5 govern (asset recall + refine → merge/canonical/prune) →
-script.json (v3-validated). Fully decoupled from direct.
-
-Video pipeline (file or directory of episodes): serial parse — each episode's
-Gemini call watches the video WITH the running cross-episode context (character
-registry + plot digest + open threads) and returns the episode content plus a
-registry delta. Identity is resolved by plot as it goes (unknown people get an
-anchored provisional, resolved once a later episode reveals them), so no roster
-merge / correction / speaker passes. Converges onto the SAME deterministic tail as
-text → identical Script v3 (timestamps ride extend.timestamp). script.json is
-rebuilt after every episode so it streams as it grows. Needs GEMINI_API_KEY.
-
-Usage
-- scriptctl ingest --source-path <file|dir> [options]
-
-Options
-- --source-path <path>   txt/md/docx file, or a video file/directory. Required.
-- --workspace-path <dir> Workspace root (manifest + pass dirs + products). Default: workspace,
-                         resolved under the current directory (<cwd>/workspace). Pass an
-                         explicit dir to place it elsewhere; the resolved absolute path is
-                         echoed in the result (feed the same path to view / publish / ingest status).
-- --llm-config <path>    LLM config override.
-- --concurrency <n>      Text pipeline fanout concurrency. Default: 30. (Video is serial — ignored.)
-- --fps <n>              Video sampling fps (>1 unlocks sub-second timecodes). Default: 3.
-- --force                Same-source rerun: clears ingest products and redoes. Cannot switch sources.
-
-Notes
-- Resumes from per-unit checkpoints (text: chunk JSON; video: per-episode
-  ep/ep_NNN.md (raw transcript) + ep/ep_NNN.json + context.json); a cross-source
-  workspace fails (choose a fresh --workspace-path). Unsupported inputs
-  (pdf/json/xlsx) are refused.
-- script.json validates without synopsis/metadata; enrich later with those commands.
-- Video: run \`scriptctl view\` for the click-to-seek review UI; episode numbering is
-  by filename number (all-or-none; mixed fails).
-`,
-    ],
-    [
-        ["ingest", "status"],
-        `Report ingest progress from the workspace's REAL file state (no model, no store).
-Status is a pure function of the on-disk files — there is no separate state file
-to drift out of sync. This is the authoritative status: the runtime watcher and
-frontend consume \`--json\` instead of re-deriving it.
-
-Usage
-- scriptctl ingest status [--workspace-path <dir>] [--json]
-
-Options
-- --workspace-path <dir> Ingest workspace to inspect. Default: workspace, resolved
-                         under the current directory (<cwd>/workspace). Pass the
-                         same path you gave \`scriptctl ingest\`.
-- --json                 Machine payload under \`.status\` (see below).
-
-State (top-level, folded from the files)
-- empty       No ingest workspace (no manifest.json).
-- incomplete  Started, not finished, no hard error (rerun \`scriptctl ingest\` to resume).
-- failed      Leftover unit error sidecars OR final v3 validation failed.
-- ready       script.json present and v3-validated.
-
---json payload (.status)
-- { workspace, exists, kind, state, phase, passes[], units, script, validation, errors[], updated }
-  passes[] = per-pass {name, done, unit?{total,done,failed}}; units = primary bar
-  (text: chunks; video: episodes). Liveness (is a run active?) is deliberately
-  NOT here — it can't be read from files; that's the watcher's / agent's concern.
-
-Examples
-- scriptctl ingest status
-- scriptctl ingest status --workspace-path 1_script/workspace --json
-`,
-    ],
-    [
-        ["view"],
-        `Render a workspace's script.json into review.html at the workspace root. No model.
-
-Usage
-- scriptctl view [--workspace-path <dir>]
-`,
-    ],
-    [
-        ["checkout"],
-        `Create or refresh a managed local working copy from one atomic remote snapshot.
-
-Usage
-- scriptctl checkout [--script-path <file>] [--project-group-no <no>] [--discard-local]
-
-Options
-- --script-path <file>      Local target. Default: ./workspace/script.json
-- --project-group-no <no>   Remote project. Default: SANDBOX_PROJECT_GROUP_NO
-- --discard-local           Explicitly discard an existing unmanaged or dirty local file.
-
-Without --discard-local, checkout refuses to overwrite local work.
-`,
-    ],
-    [
-        ["status"],
-        `Show local working-copy state without contacting the network.
-
-Usage
-- scriptctl status [--script-path <file>]
-
-Reports whether the file exists, whether it is managed, its base revision, and
-whether its semantic JSON content differs from the checked-out/published base.
-`,
-    ],
-    [
-        ["publish"],
-        `Validate and publish a local Script v3 working copy with strict revision CAS.
-
-Usage
-- scriptctl publish [--script-path <file>] [--project-group-no <no>]
-
-An unmanaged local file may create the first remote revision only. A managed
-working copy fetches the latest snapshot and PATCHes its local-wins diff with
-strict CAS. Network/CAS failures re-fetch and retry. Clean copies use no network.
-`,
-    ],
-    [
-        ["write"],
-        `Plan or atomically apply one canonical authoring file.
-
-Usage
-- scriptctl write <file> (--create|--replace) [--script-path <file>]
-- scriptctl write <file> (--create|--replace) --apply --plan <digest> [--script-path <file>]
-
-Options
-- --create              Create script/episode/scene targets. Span targets do not support create.
-- --replace             Replace existing episode/scene targets or explicit non-empty spans.
-- --apply               Persist the proposed Script v3 atomically.
-- --plan <digest>       Exact digest returned by a fresh plan; required with --apply.
-- --script-path <file>  Local Script v3 target. Default: ./workspace/script.json
-- --json                Print the complete structured plan.
-
-The source must be a named file; stdin is not accepted. Default execution is a
-no-write plan. The digest binds exact source bytes, mode, resolved targets, and
-the current semantic local-script baseline. Every plan and apply invocation
-holds the per-script local lock; apply also rechecks the baseline before rename.
-`,
-    ],
-    [
-        ["ids"],
-        `Return unreserved canonical candidate IDs from the current local Script v3.
-
-Usage
-- scriptctl ids --kind <kind> --count <n> [--script-path <file>]
-
-Kinds
-- actor | location | prop | state | episode | scene
-
-The command is read-only and does not reserve IDs. Concurrent conflicts are
-detected later by the write plan's semantic-baseline binding.
-`,
-    ],
-    [
-        ["export"],
-        `Export canonical .scriptctl authoring files from a local Script v3.
-
-Usage
-- scriptctl export script --output <file> [--script-path <file>]
-- scriptctl export episodes --in <selector> --output <file> [--script-path <file>]
-- scriptctl export episode-spans --in <selector> --output <file> [--script-path <file>]
-- scriptctl export scenes --in <selector> --output <file> [--script-path <file>]
-- scriptctl export scene-spans --in <selector> --output <file> [--script-path <file>]
-- scriptctl export action-spans --in <selector> --output <file> [--script-path <file>]
-
-Selectors are comma-separated points or inclusive from..through regions in
-current document order. Each scene span stays in one episode; each action span
-stays in one scene. Export writes one homogeneous authoring file atomically.
-`,
-    ],
-    [
-        ["export", "script"],
-        `Export a complete create-only script authoring file, including all formal
-metadata, assets, states, episodes, scenes, actions, and extensions.
-
-Usage
-- scriptctl export script --output <file> [--script-path <file>]
-`,
-    ],
-    [
-        ["export", "episodes"],
-        `Export independent complete episode targets for one-to-one batch replacement.
-
-Usage
-- scriptctl export episodes --in "ep_002..ep_004,ep_010" --output <file> [--script-path <file>]
-`,
-    ],
-    [
-        ["export", "episode-spans"],
-        `Export one complete episode-span target per selector region.
-
-Usage
-- scriptctl export episode-spans --in "ep_002..ep_004,ep_010" --output <file> [--script-path <file>]
-`,
-    ],
-    [
-        ["export", "scenes"],
-        `Export independent complete scene targets for one-to-one batch replacement.
-
-Usage
-- scriptctl export scenes --in "ep_003/scn_010..ep_003/scn_012" --output <file> [--script-path <file>]
-`,
-    ],
-    [
-        ["export", "scene-spans"],
-        `Export one complete same-episode scene-span target per selector region.
-
-Usage
-- scriptctl export scene-spans --in "ep_003/scn_010..ep_003/scn_012" --output <file> [--script-path <file>]
-`,
-    ],
-    [
-        ["export", "action-spans"],
-        `Export one complete same-scene, zero-based action-span target per selector region.
-
-Usage
-- scriptctl export action-spans --in "ep_003/scn_010#12..ep_003/scn_010#18" --output <file> [--script-path <file>]
-`,
-    ],
-    // =========================================================================
-    // 0.6.0 flat namespace — plural-noun queries
-    // =========================================================================
-    [
-        ["summary"],
-        `Show title, counts (episodes / scenes / actions / actors / locations / props)
-and the whole-script overview fields when present: worldview (+ worldview_raw),
-style, logline, theme, synopsis, main characters.
-
-Usage
-- scriptctl summary [options]
-
-Target selection (applies to every query / edit verb)
-- --script-path       A local script JSON file. Default: ./workspace/script.json.
-                      All query and atomic edit commands are local-only.
-
-Options
-- --json              Print JSON envelope for deterministic programs. Avoid unless parsing.
-- --help              Show this help.
-
-Read-only. Always safe to run.
-`,
-    ],
-    [
-        ["episodes"],
-        `List episodes as TSV rows with per-episode counts, char totals, and synopsis.
-
-Usage
-- scriptctl episodes [options]
-
-Options
-- --id <ep_id>        Filter to one episode.
-- --in <selector>     Multi-region selector, e.g. "ep_003..ep_007,ep_010".
-- --min-chars <n>     Only episodes with total chars >= N.
-- --max-chars <n>     Only episodes with total chars <= N.
-- --format addr       Print only episode ids.
-- --script-path / --json / --help
-
-Default output
-- TSV header + one row per episode:
-  addr episode_id title scenes actions chars_total chars_dialogue chars_action synopsis
-
-Examples
-- scriptctl episodes
-- scriptctl episodes --min-chars 1000
-- scriptctl episodes --id ep_007
-- scriptctl episodes --in "ep_003..ep_007"
-`,
-    ],
-    [
-        ["scenes"],
-        `List scenes with their environment, asset refs, and action counts.
-
-Usage
-- scriptctl scenes [options]
-
-Options
-- --in <addr>         Scope to ep_NNN (episode) or ep_NNN/scn_NNN (single scene).
-- --has-actor <id>    Only scenes whose context references this actor.
-- --has-location <id> Only scenes whose context references this location.
-- --has-prop <id>     Only scenes whose context references this prop.
-- --script-path / --json / --help
-
-Output line
-- ep_NNN/scn_NNN [space time] location=loc_NNN(name) actors=... props=... actions=N t=<t_start>..<t_end>
-  t_start / t_end are the first / last action extend.timestamp in the scene
-  (omitted when the scene carries no timestamps).
-
-Examples
-- scriptctl scenes --in ep_007
-- scriptctl scenes --has-actor act_001
-- scriptctl scenes --in ep_001/scn_001
-`,
-    ],
-    [
-        ["actions"],
-        `Search actions across the script (the workhorse for "find where to edit").
-Default output is TSV: addr, timestamp, type, speaker, actor, emotion, content.
-timestamp is the action's extend.timestamp (episode-local "M:SS"; empty when
-absent) — the anchor for event-level alignment (an event spans first→last ts).
-
-Usage
-- scriptctl actions [options]
-
-Options
-- --in <addr>         Scope to ep_NNN / ep_NNN/scn_NNN / ep_NNN/scn_NNN#idx.
-- --grep <text>       Literal substring (default) or /regex/flags. Matches action.content.
-- --type <type>       dialogue | inner_thought | action | transition.
-- --actor <id>        Actions whose inline speaker is this actor (action.speaker.actor_id).
-- --has <kind>        transition | speaker (filter by structural feature).
-- --context <n>       Include N actions before/after each hit (for context windows).
-- --script-path / --json / --help
-
-Requires at least one of: --in, --grep, --type, --actor, --speaker, --has. Bare \`scriptctl actions\`
-errors out — dumping every action across all episodes is too large.
-
-Default output
-- TSV header + one row per action:
-  addr timestamp type speaker actor emotion content
-
-Examples
-- scriptctl actions --grep "台下掌声雷动"
-- scriptctl actions --in ep_001 --type dialogue
-- scriptctl actions --grep "金碧辉煌" --context 2
-- scriptctl actions --actor act_001 --has speaker
-`,
-    ],
-    [
-        ["actors"],
-        `List actors with role / aliases / state counts.
-
-Usage
-- scriptctl actors [options]
-
-Options
-- --id <actor_id>     Filter to one actor.
-- --name <substr>     Match name substring (case-sensitive).
-- --in <addr>         Restrict to actors referenced under this address (ep/scn/action).
-- --counts            Append appearance counts: scenes=N episodes_count=M episodes=<ranges>
-                      (scene-context presence, compacted to episode ranges).
-- --script-path / --json / --help
-
-Examples
-- scriptctl actors --name "陈"
-- scriptctl actors --counts
-- scriptctl actors --in ep_023
-- scriptctl actors --in ep_001/scn_001
-`,
-    ],
-    [
-        ["locations"],
-        `List locations with state counts.
-
-Usage
-- scriptctl locations [options]
-
-Options mirror \`scriptctl actors\`: --id, --name, --in, --counts, --script-path, etc.
---counts appends scenes / episode-count / episode ranges of scene-context presence.
-
-Examples
-- scriptctl locations --name "办公室"
-- scriptctl locations --counts
-- scriptctl locations --in ep_007
-`,
-    ],
-    [
-        ["props"],
-        `List props with state counts.
-
-Usage
-- scriptctl props [options]
-
-Options mirror \`scriptctl actors\`: --id, --name, --in, --counts, --script-path, etc.
---counts appends scenes / episode-count / episode ranges of scene-context presence.
-
-Examples
-- scriptctl props --name "公文包"
-- scriptctl props --counts
-- scriptctl props --in ep_001/scn_001
-`,
-    ],
-    [
-        ["assets"],
-        `Unified search across actor / location / prop. Use when you don't care which kind.
-
-Usage
-- scriptctl assets [options]
-
-Options
-- --kind <actor|location|prop>  Narrow to one kind.
-- --id <id>                     Filter by id.
-- --name <substr>               Match name substring.
-- --in <addr>                   Restrict to assets referenced under this address.
-- --counts                      Append scene / episode appearance counts per asset.
-- --script-path / --json / --help
-
-Examples
-- scriptctl assets --name "陈"
-- scriptctl assets --kind actor --name "陈"
-`,
-    ],
-    [
-        ["states"],
-        `List every state on one asset: state_id ↔ name ↔ description ↔ episode arc.
-
-This is the read half of the state address space — run it to learn a state's
-id before editing (rename / delete / describe / state-change), instead of
-reading the raw script.json. Duplicate ids/names are flagged inline
-([DUP_ID] / [DUP_NAME]).
-
-The address accepts a bare id (act_001 / loc_001 / prp_001) or the tagged form
-(actor:act_001) — the kind is inferred from the id prefix in the bare case.
-
-Each state line ends with its episode arc — where the state is bound across the
-script (scene context + action state_changes), compacted to episode ranges:
-  actor:act_001/st_002  石膏轮椅装  desc="…"  episodes=ep_018..ep_021 (4 eps, 4 scenes)
-This is the character's visual arc: which look is active in which episodes.
-A state bound nowhere shows episodes=none.
-
-Usage
-- scriptctl states <asset-addr>
-
-Examples
-- scriptctl states act_001
-- scriptctl states actor:act_001
-- scriptctl states location:loc_003
-
-Then edit by the printed address:
-- scriptctl rename actor:act_001/st_010 "平静（新）"
-- scriptctl delete actor:act_001/st_010 --strategy remove
-`,
-    ],
-    [
-        ["issues"],
-        `List current validation issues. Runs validateScript on demand.
-
-Usage
-- scriptctl issues [options]
-
-Options
-- --severity <severity>   Filter by severity (error / warning / info / blocking).
-- --code <code>           Filter by issue code (e.g. STATE_NOT_FOUND).
-- --script-path / --json / --help
-
-Output line
-- <severity> <code>: <summary> [<location>]
-
-Examples
-- scriptctl issues --severity error
-- scriptctl issues --code STATE_NOT_FOUND
-`,
-    ],
-    [
-        ["refs"],
-        `Reverse lookup: every place an asset / state / speaker is referenced.
-
-Usage
-- scriptctl refs <addr> [options]
-
-Address forms
-- actor:<id> / location:<id> / prop:<id>          asset refs
-- actor:<id>/<state_id> (and location/prop)        state refs
-- spk_<id>                                         speaker refs
-
-Options
-- --level <scene|action>   Restrict to scene-level or action-level refs only.
-- --script-path / --json / --help
-
-Output line
-- <location> [<role>]   (e.g. ep_001/scn_001#3.actor_id [action_actor])
-
-Examples
-- scriptctl refs actor:act_001
-- scriptctl refs actor:act_001 --level scene
-- scriptctl refs actor:act_001/st_calm
-- scriptctl refs spk_001
-`,
-    ],
-    [
-        ["validate"],
-        `Validate the current final script. Read-only side; writes a validation report to workspace.
-
-Usage
-- scriptctl validate [options]
-
-Options
-- --script-path / --json / --help
-
-Exit codes
-- 0   passed
-- 78  validation needs repair (see scriptctl issues)
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — content
-    // =========================================================================
-    [
-        ["replace"],
-        `Literal substring replace inside action.content.
-
-Usage
-- scriptctl replace <at> --from <text> [--to <text>] [--all] [options]
-
-Required
-- <at>                Action address: ep_NNN/scn_NNN#idx
-- --from              Non-empty substring to replace.
-
-Options
-- --to                Replacement text. Default: "" (delete the substring).
-- --all               Replace every occurrence in the action. Without it, multiple matches reject.
-- --script-path / --json / --help
-
-Example
-- scriptctl replace ep_001/scn_001#3 --from "，台下掌声雷动" --to ""
-`,
-    ],
-    [
-        ["type"],
-        `Set the action.type on a specific action.
-
-Usage
-- scriptctl type <at> <dialogue|action|inner_thought>
-
-Example
-- scriptctl type ep_001/scn_001#3 dialogue
-`,
-    ],
-    [
-        ["actor"],
-        `Set or clear action.actor_id (the action's narrative subject).
-
-Usage
-- scriptctl actor <at> <actor_id|none>
-
-Example
-- scriptctl actor ep_001/scn_001#3 act_002
-- scriptctl actor ep_001/scn_001#3 none
-`,
-    ],
-    [
-        ["emotion"],
-        `Set or clear action.emotion on an action.
-
-Usage
-- scriptctl emotion <at> <emotion>
-- scriptctl emotion <at> --clear
-
-Selection
-- scriptctl emotion --in <selector> [filters] <emotion> [--apply]
-- scriptctl emotion --in <selector> [filters] --clear [--apply]
-
-Examples
-- scriptctl emotion ep_001/scn_001#3 愤怒
-- scriptctl emotion ep_001/scn_001#3 --clear
-- scriptctl emotion --in ep_001 --type dialogue 紧张 --apply
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — structure (multipolar by first-arg address format)
-    // =========================================================================
-    [
-        ["insert"],
-        `Insert an action (into a scene) or a brand-new empty scene (into an episode).
-
-Usage
-- scriptctl insert <ep/scn> --type <type> --content <text> [position-flags] [options]   # action insert
-- scriptctl insert <ep> --location <loc_id> [position-flags] [options]                  # scene insert
-
-Action insert (first arg is ep/scn)
-- Prerequisite         Scene location, with a materialized state on every referenced scene asset.
-- --type              dialogue / action / inner_thought / transition.
-- --content           Action content text.
-- --emotion <text>    Optional action.emotion.
-- --actor <id>        Required for an actor dialogue/inner_thought; actor must already be in this scene.
-- --kind <kind>       Non-actor dialogue/inner_thought speaker: system|broadcast|offscreen|group.
-- --label <text>      Optional label for a non-actor speaker.
-
-Scene insert (first arg is ep)
-- --location <id>     Required: the scene's location.
-- --time <time>       Default: day.
-- --space <space>     Default: interior.
-- --scene-id <id>     Optional explicit scene id (auto-assigned otherwise).
-
-Position (both forms)
-- --at <idx>          Numeric index in the parent collection.
-- --before <addr>     Insert before this sibling.
-- --after <addr>      Insert after this sibling.
-- Default             Append at end.
-
-Examples
-- scriptctl insert ep_001/scn_001 --type action --content "..." --emotion "紧张" --after ep_001/scn_001#3
-- scriptctl insert ep_001/scn_001 --type dialogue --content "欢迎光临。" --actor act_001
-- scriptctl insert ep_001/scn_001 --type dialogue --content "列车即将进站。" --kind broadcast --label 广播
-- scriptctl insert ep_001 --after ep_001/scn_005 --location loc_001
-`,
-    ],
-    [
-        ["delete"],
-        `Delete an action, scene, asset, state, or speaker. Multipolar by address format.
-
-Usage
-- scriptctl delete <addr> [--strategy replace|remove] [--replacement <id>] [--force]
-
-Behavior by address kind
-- action (ep/scn#idx)        Remove the action; later indices shift.
-- scene (ep/scn)             Empty scene: removed. Non-empty: refused unless --force.
-- asset (kind:id)            Refuses by default if refs exist. Pass --strategy:
-                              replace --replacement <addr>: rewrite all refs to the replacement, then delete.
-                              remove:                       scrub refs and delete (refs become dangling).
-- state (kind:id/state_id)   --strategy replace --replacement <state_id>: repoint context/state_changes, then drop.
-                              --strategy remove: scrub the state from refs and drop. (Same as state-delete.)
-- speaker (spk_id)           Same --strategy logic as asset.
-
-Examples
-- scriptctl delete ep_001/scn_001#3
-- scriptctl delete ep_001/scn_005 --force
-- scriptctl delete actor:act_001 --strategy replace --replacement actor:act_002
-- scriptctl delete actor:act_001/st_010 --strategy remove
-- scriptctl delete spk_001 --strategy remove
-`,
-    ],
-    [
-        ["move"],
-        `Move an action across actions / scenes, or move a scene across episodes.
-
-Usage
-- scriptctl move <addr> <to> [--at <idx>]
-
-Behavior by source address kind
-- action (ep/scn#idx)   <to> is target action address; insertion is "before that index".
-- scene (ep/scn)        <to> is target episode id (or ep/scn for insert-before-anchor);
-                        --at <idx> overrides position; default: append at end.
-
-Examples
-- scriptctl move ep_001/scn_001#5 ep_001/scn_002#0       # cross-scene
-- scriptctl move ep_001/scn_005 ep_002                   # cross-episode
-- scriptctl move ep_001/scn_005 ep_002 --at 0            # to ep_002 start
-`,
-    ],
-    [
-        ["split"],
-        `Split a scene at an action boundary into two sibling scenes.
-
-Usage
-- scriptctl split <ep/scn> --at <idx> [--new-scene-id <id>]
-
-Required
-- <ep/scn>            Scene to split.
-- --at                Action index (1 <= idx < action count).
-
-Options
-- --new-scene-id      Optional explicit id for the new tail scene.
-
-Example
-- scriptctl split ep_001/scn_005 --at 7
-`,
-    ],
-    [
-        ["merge"],
-        `Merge one asset / scene into another. Source disappears; refs are rewritten to the target.
-
-Usage
-- scriptctl merge <src> --into <dst>
-
-Both addresses must be the same kind (asset/asset same kind, or scene/scene same episode).
-
-Examples
-- scriptctl merge actor:act_001 --into actor:act_002
-- scriptctl merge ep_001/scn_005 --into ep_001/scn_006
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — state / transition / context on actions+scenes
-    // =========================================================================
-    [
-        ["transition"],
-        `Set or clear an action.transition_prompt (process + contrast for visual generation).
-
-Usage
-- scriptctl transition <at> <kind:id> --process <text> --contrast <text>
-- scriptctl transition <at> <kind:id> --clear
-
-Examples
-- scriptctl transition ep_001/scn_001#3 actor:act_001 --process "深呼吸三秒" --contrast "由静转动"
-- scriptctl transition ep_001/scn_001#3 actor:act_001 --clear
-`,
-    ],
-    [
-        ["scene-ref"],
-        `Manage a scene's cast / props / location ref (v3: scene.actors[] / props[] / location).
-
-Usage
-- scriptctl scene-ref <ep/scn> <kind:id> --state <state_id>   # upsert ref + set state
-- scriptctl scene-ref <ep/scn> actor:<id> --state <state_id> --append  # append another ref for the same actor
-- scriptctl scene-ref <ep/scn> actor:<id> --state <state_id> --occurrence <n>  # update the nth matching ref (1-based)
-- scriptctl scene-ref <ep/scn> <kind:id> --state none         # repair intermediate: upsert ref, no state
-- scriptctl scene-ref <ep/scn> <kind:id> --clear [--occurrence <n>]  # keep ref, clear state
-- scriptctl scene-ref <ep/scn> <kind:id> --remove [--occurrence <n>] # remove ref
-
-kind is actor / location / prop. Actor refs may repeat; use --append to add another and --occurrence when a target repeats. Location is single-valued per scene (set replaces).
-Exactly one of --state / --clear / --remove must be passed.
-New body insertion is blocked while any scene asset ref has no materialized state.
-
-Examples
-- scriptctl scene-ref ep_001/scn_001 actor:act_001 --state st_calm
-- scriptctl scene-ref ep_001/scn_001 actor:act_001 --state st_injured --append
-- scriptctl scene-ref ep_001/scn_001 actor:act_001 --remove --occurrence 2
-- scriptctl scene-ref ep_001/scn_001 location:loc_003 --state default
-- scriptctl scene-ref ep_001/scn_001 actor:act_001 --remove
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — asset metadata
-    // =========================================================================
-    [
-        ["rename"],
-        `Rename an asset (actor / location / prop) or a state. Dispatches by address kind.
-
-Usage
-- scriptctl rename <kind:id> <new_name>            # asset
-- scriptctl rename <kind:id/state_id> <new_name>   # state (same as state-rename)
-
-Examples
-- scriptctl rename actor:act_001 "陈墨"
-- scriptctl rename actor:act_001/st_010 "平静（新）"
-`,
-    ],
-    [
-        ["describe"],
-        `Set the description on an asset or a state (address with /state_id).
-
-Usage
-- scriptctl describe <kind:id> <text>                    # asset description
-- scriptctl describe <kind:id/state_id> <text>           # state description
-
-Examples
-- scriptctl describe actor:act_001 "男主，30 岁，雷厉风行"
-- scriptctl describe actor:act_001/st_calm "默认形态：平静"
-`,
-    ],
-    [
-        ["alias"],
-        `Add or remove aliases on an asset.
-
-Usage
-- scriptctl alias <kind:id> [--add <alias>] [--remove <alias>]
-
-Either --add or --remove (or both, repeatable) must be provided.
-
-Examples
-- scriptctl alias actor:act_001 --add "陈总"
-- scriptctl alias actor:act_001 --add "陈总" --add "老板"
-- scriptctl alias actor:act_001 --remove "老板"
-`,
-    ],
-    [
-        ["role"],
-        `Set an actor's role_type.
-
-Usage
-- scriptctl role <actor:id> <主角|配角>
-
-Only valid on actor:* addresses.
-
-Example
-- scriptctl role actor:act_001 主角
-`,
-    ],
-    [
-        ["importance"],
-        `Set an asset's importance tier. featured = 主角/配角 (downstream gets a render
-asset + state tracking); background = 龙套/背景 (skipped downstream).
-
-Usage
-- scriptctl importance <kind:id> <featured|background>
-
-Valid on actor / location / prop addresses.
-
-Examples
-- scriptctl importance actor:act_002 background
-- scriptctl importance location:loc_001 featured
-`,
-    ],
-    [
-        ["worldview"],
-        `Set the script-level worldview (story setting / time period).
-
-Usage
-- scriptctl worldview <value>
-
-Value must match the supported enum (see SCRIPT_SCHEMA worldview values).
-
-Example
-- scriptctl worldview 现代
-`,
-    ],
-    [
-        ["synopsis"],
-        `Set the whole-script synopsis or one episode's synopsis.
-
-Usage
-- scriptctl synopsis <text>                 # set script.synopsis
-- scriptctl synopsis <ep_NNN> <text>        # set episode.synopsis
-- scriptctl synopsis generate --apply       # generate missing synopsis fields
-
-Patch ops
-- meta.synopsis.set
-- episode.synopsis.set
-
-Examples
-- scriptctl synopsis "陈墨归国复仇，与苏晴重逢，围绕林氏集团的阴谋逐步展开。"
-- scriptctl synopsis ep_001 "陈墨第一时间来到总裁办公室，与苏晴重逢。"
-`,
-    ],
-    [
-        ["synopsis", "generate"],
-        `Generate missing episode and whole-script synopsis fields from script.json.
-
-Usage
-- scriptctl synopsis generate --script-path output/script.json
-- scriptctl synopsis generate --script-path output/script.json --apply
-- scriptctl synopsis generate --script-path output/script.json --overwrite --apply
-
-Behavior
-- Default is dry-run: runs extraction and validation but does not write.
-- Without --overwrite, existing episode synopsis fields are reused and only missing
-  fields are filled.
-- Whole-script fields are generated when any of synopsis/theme/logline/style/main_characters
-  is missing; --overwrite regenerates them.
-- Uses a text-output contract and parser, not tool_use.
-
-Options
-- --llm-config <path>     task/model routing YAML; built-in route uses the grok gateway
-- --concurrency <n>       parallel chunk extraction, default 30
-- --checkpoint <dir>      checkpoint directory, default workspace direct loom dir
-- --overwrite             regenerate existing synopsis fields
-- --apply                 write script.json
-`,
-    ],
-    [
-        ["extend"],
-        `Attach a free-form extend{} namespace (arbitrary key→value) to any node.
-A dual-mode verb: with a key it writes, without a key it reads.
-
-The extend{} container is isolated from the known schema fields and survives
-validation untouched — use it for production metadata the schema has no slot for
-(camera notes, reference URLs, localization flags, runtime, ad-hoc tags).
-
-Addresses (every dimension)
-- global                       script top level
-- ep_001                       episode
-- ep_001/scn_001               scene
-- ep_001/scn_001#3             action (0-based index)
-- actor:act_001                asset (also location: / prop:)
-- actor:act_001/st_calm        asset state
-- spk_001                      speaker
-
-Usage
-- scriptctl extend <addr> <key> <value>              # write a string
-- scriptctl extend <addr> <key> <value> --json-value # parse value as JSON (number/bool/object/array)
-- scriptctl extend <addr> <key> --clear              # delete one key
-- scriptctl extend <addr> --clear                    # wipe the whole container
-- scriptctl extend <addr>                             # read: list the node's extend keys
-
-Notes
-- The value-parsing flag is --json-value (NOT --json: that is the global
-  output-mode flag and is consumed before this command sees it).
-- key is a FLAT name; dots (a.b.c) are literal, NOT a path. For nested structure
-  pass an object via --json-value.
-- Deleting a missing key / clearing an absent container is a no-op (no error).
-- An emptied container is removed entirely (no "extend": {} left behind).
-
-Examples
-- scriptctl extend global art_style cyberpunk
-- scriptctl extend ep_001/scn_001 mood '{"tone":"tense","lit":"neon"}' --json-value
-- scriptctl extend ep_001/scn_001#3 camera "low angle, slow push-in"
-- scriptctl extend actor:act_001 reference_url https://example.com/ref.png
-- scriptctl extend global art_style --clear
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — state management
-    // =========================================================================
-    [
-        ["state-add"],
-        `Add a state to an asset's states[].
-
-Usage
-- scriptctl state-add <kind:id> <state_name> [--description <text>] [--state-id <id>]
-
-Required
-- <kind:id>           Asset target.
-- <state_name>        Human-readable state name (must be unique within the asset).
-
-Options
-- --description       Optional description.
-- --state-id          Optional explicit id (auto-assigned otherwise).
-
-Examples
-- scriptctl state-add actor:act_001 "震惊"
-- scriptctl state-add actor:act_001 "震惊" --description "瞠目结舌" --state-id st_shock
-`,
-    ],
-    [
-        ["state-rename"],
-        `Rename a state on an asset.
-
-Usage
-- scriptctl state-rename <kind:id/state_id> <new_name>
-
-Example
-- scriptctl state-rename actor:act_001/st_calm "平静（新）"
-`,
-    ],
-    [
-        ["state-delete"],
-        `Delete a state from an asset's states[]. Refs are handled via --strategy.
-
-Usage
-- scriptctl state-delete <kind:id/state_id> --strategy <replace|remove> [--replacement <state_id>]
-
-Strategy
-- replace --replacement <state_id>   Rewrite all refs to the replacement state, then delete.
-- remove                             Clear refs and delete (scene-initial state becomes null;
-                                     state_changes referencing this state are dropped).
-
-Examples
-- scriptctl state-delete actor:act_001/st_calm --strategy remove
-- scriptctl state-delete actor:act_001/st_calm --strategy replace --replacement actor:act_001/st_default
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — dialogue / speaker
-    // =========================================================================
-    [
-        ["dialogue"],
-        `Set a dialogue line's inline speaker (v3: a single speaker per line). Also flips
-the action to type=dialogue.
-
-Usage
-- scriptctl dialogue <at> --actor <actor_id>                      # an actor speaks
-- scriptctl dialogue <at> --kind <system|broadcast|offscreen|group> [--label <text>]
-
-Pass exactly one of --actor (an actor) or --kind (a non-actor source).
-
-Examples
-- scriptctl dialogue ep_001/scn_001#3 --actor act_001
-- scriptctl dialogue ep_001/scn_001#3 --kind broadcast --label 广播
-`,
-    ],
-    // =========================================================================
-    // Patch (batch transactions)
-    // =========================================================================
-    [
-        ["patch"],
-        `Apply a batch JSON patch to the current script. Use ONLY for >=3 ops in one transaction;
-single-op edits should use the corresponding atomic verb (replace / type / delete / rename /
-state-add / etc.).
-
-Usage
-- scriptctl patch <file> [options]
-
-Required
-- <file>              JSON patch file. Top-level may be:
-                        an array of ops, or
-                        { "ops": [...] }, or
-                        { "operations": [...] }, or
-                        a single op object.
-
-Op names use dot-style only (state.add / action.delete / asset.rename / etc.).
-The 0.5.0 snake-style ops (set_worldview, rename_actor, merge_scenes, ...) were removed.
-Use \`scriptctl patch --schema\` to see every supported op + its required fields.
-
-Options
-- --schema [<op>]     Dump op schema (JSON) instead of applying. With <op>, dump just that op.
-- --dry-run           Apply to an in-memory copy, run validate, do NOT write to gateway.
-- --script-path / --json / --help
-
-Examples
-- scriptctl patch changes.json
-- scriptctl patch changes.json --dry-run
-- scriptctl patch --schema
-- scriptctl patch --schema asset.rename
-`,
-    ],
-];
-function keyOf(command) {
-    return command.join("
");
-}
-const HELP_MAP = new Map(HELP_ENTRIES.map(([cmd, text]) => [keyOf(cmd), text]));
-export function getHelp(command) {
-    return HELP_MAP.get(keyOf(command));
-}
-export const HELP = HELP_MAP;
-//# sourceMappingURL=help-text.js.map