@lingjingai/scriptctl 0.50.0 → 0.51.1

package/dist/help-text.js

@@ -1,1144 +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 → new Script v4
-
-Workflows
-- ingest    txt/md/docx/video → Script v4 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 | audit-assets
-
-Write
-- create | add-actor | add-location | add-prop | add-episode
-- replace | type | actor | emotion (v3) | parenthetical (v4)
-- 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               generate unreserved canonical ID candidates
-- 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 v4 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 (v4-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 v4 (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 v4 validation failed.
-- ready       script.json present and v4-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 or v4 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 atomically.
-- --plan <digest>       Exact digest returned by a fresh plan; required with --apply.
-- --script-path <file>  Local 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 candidate IDs. No script is required; when one exists,
-currently live IDs are excluded.
-
-Usage
-- scriptctl ids --kind <kind> --count <n> [--script-path <file>]
-
-Kinds
-- actor | location | prop | state | episode | scene | action
-
-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 or v4.
-
-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 <selector>     V4: bare episode/scene IDs, ID ranges, or query-only @ ordinals.
-                      V3: ep_NNN or ep_NNN/scn_NNN.
-- --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
-- V4 addr is the stable scene ID; V3 addr is ep_NNN/scn_NNN.
-- <addr> [space time] location=... 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:7'
-- scriptctl scenes --in scnK6wT3c
-- scriptctl scenes --in ep_007
-- scriptctl scenes --has-actor act_001
-`,
-    ],
-    [
-        ["actions"],
-        `Search actions across the script (the workhorse for "find where to edit").
-V4 rows expose parenthetical; V3 rows expose emotion. V4 addr is the stable
-Action ID; V3 addr remains ep_NNN/scn_NNN#idx.
-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 <selector>     V4: bare episode/scene/action IDs, same-kind ID ranges,
-                      or query-only 1-based @ ordinals.
-                      V3: existing compound addresses and query-only @ ordinals.
-- --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:
-  V4: addr ep_no scene_no global_scene_no action_no global_action_no timestamp type speaker actor parenthetical content
-  V3: addr ep_no scene_no global_scene_no action_no global_action_no timestamp type speaker actor emotion content
-
-Examples
-- scriptctl actions --in '@ep:2/scn:1'
-- scriptctl actions --in acR8cV4n..acT2fG6z
-- 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)
-`,
-    ],
-    [
-        ["audit-assets"],
-        `Run a model-backed whole-script asset consistency audit. Read-only for script.json;
-writes an asset-audit.json sidecar with merge/delete/review suggestions.
-
-Checks
-- duplicate actors across formatting, aliases, names, transcription and identity clues
-- duplicate stable visual states and suspicious unused/singleton states
-- duplicate location and prop assets (never merges scene occurrences)
-
-Usage
-- scriptctl audit-assets [options]
-
-Options
-- --script-path <file>   Script v3 input. Default: ./workspace/script.json
-- --llm-config <path>    Optional LLM routing config.
-- --output <path>        Audit sidecar. Default: next to script.json.
-- --json / --help
-
-Behavior
-- Never edits or merges the script automatically.
-- Exit 0 when no findings; exit 78 when findings need review.
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — content
-    // =========================================================================
-    [
-        ["replace"],
-        `Literal substring replace inside action.content.
-
-Usage
-- scriptctl replace <at> --from <text> [--to <text>] [--all] [options]
-
-Required
-- <at>                v4 Action ID, or v3 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 action.type on a specific action. V4 writes use an Action ID; converting
-a narrative v4 action into dialogue/inner_thought is refused because no speaker
-was supplied.
-
-Usage
-- scriptctl type <at> <dialogue|action|inner_thought>
-
-Example
-- scriptctl type ep_001/scn_001#3 dialogue
-`,
-    ],
-    [
-        ["actor"],
-        `Set a speaking action's actor speaker.
-
-Usage
-- scriptctl actor <at> <actor_id>
-
-Example
-- scriptctl actor ep_001/scn_001#3 act_002
-`,
-    ],
-    [
-        ["emotion"],
-        `Set or clear action.emotion on a Script v3 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
-`,
-    ],
-    [
-        ["parenthetical"],
-        `Set, preserve as empty, or remove a Script v4 speaking Action's parenthetical.
-
-Usage
-- scriptctl parenthetical <action-id> --set <text>
-- scriptctl parenthetical <action-id> --set ""
-- scriptctl parenthetical <action-id> --remove
-
-Selection
-- scriptctl parenthetical --in <id-or-id-range> [filters] --set <text>
-- scriptctl parenthetical --in <id-or-id-range> [filters] --remove
-
-Script v4 writes require stable Action IDs. Ordinal @ anchors are query-only.
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — structure (multipolar by first-arg address format)
-    // =========================================================================
-    [
-        ["insert"],
-        `Insert an action into a scene or a new empty scene into an episode.
-
-Script v4
-- Parent addresses are bare episode/scene IDs.
-- New IDs are generated as typed NanoIDs, or supplied with --action-id / --scene-id.
-- Placement uses sibling IDs with --before or --after; numeric --at is rejected.
-- Speaking actions accept --parenthetical, --actor and optional --speaker-state.
-- A scene location accepts one or more --state values; location may be omitted.
-
-Script v3
-- Parent addresses retain ep_NNN or ep_NNN/scn_NNN.
-- Numeric --at and v3 sibling addresses retain their existing semantics.
-- Speaking actions use --emotion.
-
-Examples
-- scriptctl insert scnK6wT3c --action-id acR8cV4n --type dialogue --content "欢迎。" --actor actA3kP9x --parenthetical "低声"
-- scriptctl insert epQ7mN2v --scene-id scnD4eF6g --location locF9dH2s --state default
-`,
-    ],
-    [
-        ["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
-- v4 uses bare typed IDs and asset_id/state_id; v3 uses its existing compound addresses.
-- action                     Remove the action.
-- scene                      Empty scene: removed. Non-empty: refused unless --force.
-- asset                      Refuses by default if refs exist. Pass --strategy:
-                              replace --replacement <addr>: rewrite all refs to the replacement, then delete.
-                              remove: scrub valid removable refs and delete.
-- state                      replace rewrites references; remove is refused if a v4
-                              scene state set would become empty.
-
-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 scenes, or a scene across episodes.
-
-Usage
-- scriptctl move <addr> <to> [--at <idx>] [--before <id>|--after <id>]
-
-V4 uses a source ID, target parent ID, and optional sibling Action/Scene ID.
-V3 retains numeric and compound-address placement.
-`,
-    ],
-    [
-        ["split"],
-        `Split a scene at an action boundary into two sibling scenes.
-
-Usage
-- v4: scriptctl split <scene-id> --at <first-tail-action-id> [--new-scene-id <id>]
-- v3: scriptctl split <ep/scn> --at <idx> [--new-scene-id <id>]
-
-The v4 anchor is the first Action moved into the new tail scene.
-`,
-    ],
-    [
-        ["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. V4 uses bare typed IDs; scene merge requires
-adjacent scenes in one episode and refuses conflicting locations.
-
-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 reference.
-
-Script v4
-- scriptctl scene-ref <scene-id> <asset-id> --state <state-id> [--state <state-id> ...]
-- scriptctl scene-ref <scene-id> <asset-id> --remove
-
-Each asset appears once per scene and carries a complete, non-empty state_ids set.
-Setting replaces that asset's whole set; values are stored in lexical ID order.
-
-Script v3
-
-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
-- v4: scriptctl rename <asset-id> <new_name>
-- v4: scriptctl rename <asset-id/state-id> <new_name>
-- v3: scriptctl rename <kind:id[/state_id]> <new_name>
-
-Examples
-- scriptctl rename actA3kP9x "陈墨"
-- scriptctl rename actA3kP9x/stB4xR8p "平静（新）"
-`,
-    ],
-    [
-        ["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 <episode-id> <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
-- global                       script top level
-- v4 bare episode / scene / Action / asset ID
-- v4 asset-id/state-id
-- v3 existing episode / scene / action / asset / state address
-
-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 scnK6wT3c mood '{"tone":"tense","lit":"neon"}' --json-value
-- scriptctl extend acR8cV4n camera "low angle, slow push-in"
-- scriptctl extend actA3kP9x reference_url https://example.com/ref.png
-`,
-    ],
-    // =========================================================================
-    // Edit verbs — state management
-    // =========================================================================
-    [
-        ["state-add"],
-        `Add a state to an asset's states[].
-
-Usage
-- scriptctl state-add <asset-address> <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. V4 otherwise generates st + six Base58 characters.
-
-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 <state-address> <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                             Remove the state from references. V4 refuses the
-                                     operation if any scene state set would become empty.
-
-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 or inner-thought line's inline speaker.
-
-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 or --kind. In v4 the Action must already be speaking;
-an actor and optional state must belong to the current scene reference.
-
-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           Script v3: apply to memory and validate without writing.
-- --apply             Script v4: apply a previously reviewed plan.
-- --plan <digest>     Script v4: exact digest returned by the dry-run.
-- --script-path / --json / --help
-
-Examples
-- scriptctl patch changes.json                                      # V4 dry-run plan
-- scriptctl patch changes.json --apply --plan sha256:...            # V4 apply
-- scriptctl patch changes.json --dry-run                            # V3 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