@lingjingai/scriptctl 0.13.0 → 0.15.0

package/dist/help-text.js

@@ -6,8 +6,8 @@ const HELP_ENTRIES = [
 Usage
 - scriptctl <verb> <address> [flags]      # 编辑（多态 verb 按 address 格式分发）
 - scriptctl <plural-noun> [flags]         # 查询
-- scriptctl direct <command> [flags]      # 直转 workflow
-- scriptctl write <command> [flags]       # 逐集写作 workflow
+- scriptctl direct <command> [flags]      # 直转 workflow（已有素材）
+- scriptctl parse [dir] [flags]           # 手写 md → script 组装
 
 Workflow groups
 - direct init       Build the initial direct-conversion script (resumable; selective re-run).
@@ -15,13 +15,7 @@ Workflow groups
 - direct validate   Validate the current initial script.
 - direct review     Proofread the draft: curation/issues, or --episode N for source↔extract.
 - direct export     Store the final script through Gateway after validation.
-- write init        Scaffold workspace/episodes/ + meta.json template.
-- write draft <n>   Draft + lint + assemble-validate + auto-commit a single episode.
-- write batch       Draft a range of episodes in one go.
-- write workspace   List per-episode draft state in the from-scratch workspace.
-- write merge       Local assembly: committed episodes → script.json + receipt.
-- write push        Upload the merge artifact to gateway.
-- write spec        Print the spec-md grammar.
+- parse [dir]       Assemble an agent-authored md workspace into a script (deterministic; --publish to store).
 
 Query (plural-noun)
 - summary           title + counts of episodes / scenes / actions / assets / speakers
@@ -29,9 +23,16 @@ Query (plural-noun)
 - scenes            per-scene line with asset names; filters: --in / --has-actor / --has-location / --has-prop
 - actions           per-action line; filters: --in / --grep / --type / --actor / --speaker / --has / --context
 - actors / locations / props / assets / speakers   asset queries (kind-scoped or unified)
-- issues            current validation issues
+- issues            current validation issues (completeness gaps are warnings, not errors)
 - refs <addr>       reverse lookup: state / asset / speaker → reference sites
-- validate          Validate the current final script.
+- validate          Validate the current final script (structural integrity; unfinished is OK)
+
+Create + add entities (build bottom-up from an empty script)
+- create [--title X] [--force]                          new blank schema-v2 script (--script-path / --draft / --project-group-no)
+- add-actor <name> [--id X] [--role 主角|配角] [--description X] [--alias X ...]
+- add-location <name> [--id X] [--description X]
+- add-prop <name> [--id X] [--description X]
+- add-episode [--id ep_NNN] [--title X]                 append an empty episode; then insert scenes/actions
 
 Edit content
 - replace <at> --from X [--to X] [--all]                literal substring replace in action.content
@@ -303,315 +304,30 @@ Exit codes
 `,
     ],
     [
-        ["write"],
-        `scriptctl episode drives per-episode incremental script production for the creative
-mainline (灵感线 / 小说线 / 原创线). The full per-project loop:
-
-  scriptctl episode init             → scaffold + env preflight (once per project)
-  scriptctl episode draft <n>        → provider → parse → lint → assemble-validate → commit
-  scriptctl episode merge            → assemble committed episodes locally; write artifact + receipt
-  scriptctl episode push             → upload merge artifact to gateway (after sha re-check)
-
-Each draft is self-contained: any quality / consistency issue surfaces at the
-moment of introduction. merge / push are deliberately split — merge is pure local
-(no network), push is upload-only (no assembly). push refuses if the merge artifact
-or any input drifted, forcing a fresh merge before any inconsistent snapshot can ship.
+        ["parse"],
+        `Assemble an agent-authored markdown workspace into a structured script —
+deterministic, no LLM. You write the md (per-episode body + 人物/场景/道具/发声源
+docs); parse turns it into a schema-v2 script.
 
 Usage
-- scriptctl episode <command> [options]
-
-Commands
-- init          Scaffold episodes/ + meta.json template; print gateway env preflight.
-- draft <n>     Single-command pipeline for one episode: extract title from outline H1
-                → call provider → parse → collision check → lint → cross-episode
-                assembled validation → auto-commit on full pass. Any blocker stops
-                here at the source rather than accumulating into a publish-time bomb.
-- batch         Loop draft over an inclusive episode range.
-- workspace     List drafted / committed / blocked-collision / blocked-lint per episode
-                in the \`episode\` from-scratch draft area. NOT a query against the
-                final script — use \`scriptctl summary\` / \`scriptctl episodes\` for that.
-- merge         Local-only assembly: committed episodes + meta.json → script.json + receipt
-                under workspace/episodes/.merged/. No gateway calls. Re-run after any
-                episode edit.
-- push          Upload the merge artifact to gateway. Pure uploader; refuses if the
-                merge receipt's recorded hashes don't match current files on disk.
-- spec          Print the spec-md grammar scriptctl's parser accepts. Use this before
-                writing a spec md by hand (for \`episode draft --from-md\` / \`--resume\`).
-
-Workspace layout (scriptctl episode owns everything under workspace/episodes/)
-- workspace/episodes/meta.json             project meta (agent writes; scaffold via "episode init")
-- workspace/episodes/ep<NN>.outline.md     agent-written per-episode outline
-- workspace/episodes/ep<NN>.md             draft spec markdown (scriptctl writes)
-- workspace/episodes/ep<NN>.json           parsed fragment
-- workspace/episodes/ep<NN>.lint.json      lint report
-- workspace/episodes/ep<NN>.collision.json present only when hard collisions exist
-- workspace/episodes/ep<NN>.history/       prior versions archived on --regen
-- workspace/episodes/asset-registry.json   cross-episode asset registry
-- workspace/episodes/.done-<NN>            commit marker (auto-commit at draft end)
-- workspace/episodes/.merged/script.json   assembled script (merge output, push input)
-- workspace/episodes/.merged/merge-receipt.json  hashes of script + meta + each ep<n>.json
-- workspace/episodes/.merged/push-receipt.json   revision / request_id / pushedAt (push output)
-
-The .merged/ directory is scriptctl-owned. Do not hand-edit its files — push validates
-sha consistency and will block any tampered or stale snapshot. To "republish", re-run
-merge (after any source edit) then push.
-`,
-    ],
-    [
-        ["write", "init"],
-        `Scaffold the episode workspace. Creates <workspace>/episodes/ and writes a
-meta.json template with TODO placeholders for title / worldview / style.
-
-Usage
-- scriptctl episode init [options]
+- scriptctl parse [dir] [options]
+- scriptctl parse --spec                  print the md grammar parse accepts
 
 Options
-- --workspace-path    Workspace directory. Default: workspace
-- --force             Overwrite an existing meta.json with the placeholder template.
-
-After running init, edit episodes/meta.json to fill in the real title / worldview /
-style values, then prepare per-episode outlines at episodes/ep<NN>.outline.md and
-run \`scriptctl episode draft 1\`.
-
-Exit code: 0 always (skipped or written).
-`,
-    ],
-    [
-        ["write", "draft"],
-        `Draft + lint + assemble-validate + auto-commit episode <n> in one command.
-
-The full pipeline for one episode:
-  1. Extract episode title from outline H1 (e.g. "# 第 N 集：副标题").
-     Hard fail if missing — title must come from outline, not be patched later.
-  2. Call provider (Gemini by default) → spec markdown.
-  3. parseMarkdownBatch (fragment mode) — schema-strict parse.
-  4. Collision detection against asset-registry.json. Hard collision → block.
-  5. lint (40-char dialogue cap, anti-novelization, 5-module structure).
-  6. Cross-episode assembled validation against ALL drafted episodes +
-     episodes/meta.json. Catches schema drift / asset reference issues at the
-     source, not at publish time.
-  7. On full pass: registry transitions uncommitted → committed for this
-     episode's assets; .done-<NN> marker written.
-
-Usage
-- scriptctl episode draft <n> [options]
-
-Required
-- <n>                 Positive episode number.
-
-Options
-- --workspace-path    Workspace directory (scriptctl's own output dir).
-                      Default: workspace
-- --prompt-template   Path to the writing-prompt template (e.g. the skill's
-                      assets/gemini-writing-prompt.md). When omitted, scriptctl's
-                      bundled default is used. The template may contain the
-                      placeholder \`<!-- MARKDOWN_BATCH_PROMPT_SPEC -->\`, which is
-                      replaced with the authoritative parser spec at draft time
-                      (same mechanism the bundled default uses) so skill prompts
-                      stay in sync with the parser as it evolves.
-- --outline           Path to this episode's per-episode 集纲 file. Accepts a
-                      literal path or a template with the {NN} placeholder.
-                      Default: <workspace>/episodes/ep{NN}.outline.md
-- --ref <spec>        Inject a named context block. Format: "<title>=<path>".
-                      Repeatable; later entries with the same title override earlier.
-                      scriptctl itself knows NO external file names — the SKILL or
-                      agent owns which refs to pass.
-                      Example: --ref "全局设定=analysis-workspace/全局设定.md"
-- --from-md           Skip the provider call; ingest a user-provided spec md
-                      from this path. Useful when the agent / editor wrote the
-                      episode by hand. Note: the outline file (ep<NN>.outline.md
-                      at the default or --outline location) is still required —
-                      the episode title comes from its H1, ensuring assembled
-                      title and body remain in sync. Run \`scriptctl episode spec\`
-                      to see the exact spec-md grammar before writing by hand.
-- --provider          Writer provider. Production: gemini (default; omit the flag).
-                      For tests only: mock. Claude does NOT write episode bodies —
-                      it stays on direct-init structured extraction.
-- --model             Override the Gemini model (default: gemini-2.5-pro).
-- --max-tokens        Override max_tokens for this draft.
-- --regen             Archive the existing ep<n>.md to ep<n>.history/ and roll
-                      back uncommitted registry entries before drafting.
-- --resume            Skip the provider call; re-parse and re-collision-check
-                      the existing ep<n>.md. Use after hand-editing a collision.
-
-Context injection (in order, scriptctl builds the prompt itself):
-  1. The writing-prompt template (--prompt-template)
-  2. Asset registry summary (auto, from <workspace>/episodes/asset-registry.json)
-  3. Reference blocks (from --ref, one block per flag)
-  4. The per-episode outline (from --outline or default location)
-  5. Previous-episode tail (auto, from <workspace>/episodes/ep<N-1>.md)
-
-Only the registry, the previous-episode lookup, and the outline default live in
-scriptctl's own writing directory (<workspace>/episodes/). Everything else is
-agent / SKILL-controlled via --ref.
-
-Exit codes
-- 0   pipeline passed all gates; episode committed
-- 64  usage / arguments error (incl. missing outline H1 title)
-- 66  input file unavailable (prompt template, outline, --from-md path missing)
-- 70  provider failure or final parse failure after retry
-- 78  hard collision OR lint critical OR assembled validation blocking — fix and re-run with --resume
-`,
-    ],
-    [
-        ["write", "batch"],
-        `Batch-draft an inclusive range of episodes.
-
-Usage
-- scriptctl episode batch --range <a-b> [options]
-
-Required
-- --range <a-b>       Inclusive episode range, e.g. --range 1-10.
-
-Options
-- --workspace-path    Workspace directory. Default: workspace
-- --prompt-template   Required unless every episode is being --resume'd.
-- --outline           Path template with {NN} placeholder (e.g.
-                      workspace/episodes/ep{NN}.outline.md). Same as draft.
-- --ref <spec>        Repeatable context ref (see "episode draft --help").
-- --provider          gemini (default) | mock (tests only). Same restriction as draft.
-- --model             Override the Gemini model.
-- --max-tokens        Per-episode max_tokens override.
-
-Output
-- A summary listing committed / blocked episodes.
-- Blocked episodes need agent resolution; see their collision.json or lint.json.
-`,
-    ],
-    [
-        ["write", "merge"],
-        `Assemble all committed episodes (those with .done-<NN> markers) + episodes/meta.json
-into a single script.json, run schema validation, and persist locally for review.
-NO network — gateway upload is the separate "episode push" command.
-
-Usage
-- scriptctl episode merge [options]
+- [dir]               md workspace directory. Default: <workspace>/parse.
+- --workspace-path <path>  Workspace root behind the default md dir (<workspace>/parse). Default: workspace.
+- --md-dir <path>     Point directly at the md workspace root (overrides [dir] / --workspace-path).
+- --episodes-dir <path>  Override the per-episode body directory.
+- --title <title>     Script title when the workspace omits 元信息.md.
+- --publish           Validate then store the assembled script in the DB
+                      (omit to assemble + validate only, no write).
+- --project-group-no <no>  Target project for --publish.
+- --request-id <id>   Idempotency key for --publish.
 
-Required workspace files
-- workspace/episodes/meta.json            {"title": "...", "worldview": "现代",
-                                            "worldview_raw": "...", "style": "..."}
-                                            scaffold via "scriptctl episode init"
-- workspace/episodes/.done-<NN>           at least one episode passed draft auto-commit
-
-Options
-- --workspace-path    Workspace directory. Default: workspace
-- --meta-path         Override meta location. Default: <workspace>/episodes/meta.json
-- --from <n>          Lower bound episode number (inclusive). Default: all
-- --to <n>            Upper bound episode number (inclusive). Default: all
-- --force             Allow non-blocking validation warnings. Blocking errors still
-                      refuse to write a receipt.
-
-Behavior
-- Scans episodes with .done-<NN> marker only — blocked (collision / lint) drafts
-  are skipped so a half-broken draft can never enter the merged script.
-- Assembles using direct-core's mergeEpisodeResults (same shape as direct export).
-- Re-runs validateScript (defense-in-depth — catches hand-edited ep<n>.json).
-- On success: writes script.json + merge-receipt.json (sha256 of script, meta,
-  each ep<n>.json). \`episode push\` later re-verifies these hashes before uploading.
-- On validation failure: script.json IS written (for agent inspection) but NO
-  receipt is — push will refuse until you re-merge.
-
-Outputs
-- workspace/episodes/.merged/script.json          assembled script for review
-- workspace/episodes/.merged/merge-receipt.json   inputs + output sha256, locks state
-
-Don't edit either file by hand. \`episode push\` validates them strictly; any drift
-means re-merge. Treat .merged/ as read-only output of \`episode merge\`.
-
-Exit codes
-- 0   merged OK; receipt written; ready to push
-- 64  usage / arguments error
-- 66  meta or committed episodes missing
-- 78  validation needs agent repair
-`,
-    ],
-    [
-        ["write", "push"],
-        `Upload the most recent \`episode merge\` artifact to the script-output gateway.
-Pure uploader — does not assemble or validate (merge already did). Refuses to
-upload if the artifact / inputs drifted since merge.
-
-Usage
-- scriptctl episode push [options]
-
-Required environment (gateway)
-- AWB_BASE_URL              gateway base
-- LINGJING_AWB_ACCESS_KEY   gateway access key
-- SANDBOX_PROJECT_GROUP_NO  or --project-group-no
-
-Required workspace files
-- workspace/episodes/.merged/script.json        produced by \`episode merge\`
-- workspace/episodes/.merged/merge-receipt.json produced by \`episode merge\`
-
-Options
-- --workspace-path    Workspace directory. Default: workspace
-- --project-group-no  Override the project group number.
-- --request-id        Override the auto-derived idempotency key (defaults to
-                      sha256 of the merged script).
-
-Behavior — triple hash check (refuses any drift)
-- (a) workspace/episodes/.merged/script.json sha == receipt.scriptSha256
-- (b) meta.json (path from receipt) sha == receipt.metaSha256
-- (c) every ep<n>.json sha == receipt.episodes[i].sha256
-- Any mismatch → BLOCKED; agent must re-run \`episode merge\`.
-- All pass → single gateway call (replaceScript), idempotency key from script sha.
-
-Outputs
-- workspace/episodes/.merged/push-receipt.json  revision, requestId, pushedAt
-
-Exit codes
-- 0   uploaded OK
-- 64  usage / arguments error
-- 66  merge artifact or env missing
-- 70  gateway runtime failure
-- 78  merge receipt stale — re-merge required
-`,
-    ],
-    [
-        ["write", "spec"],
-        `Print the spec-md grammar scriptctl's parser accepts. \`episode draft\` (Gemini)
-auto-injects this into the writing prompt; this command exposes the same string
-for agents writing spec md by hand (for \`episode draft --from-md\` / \`--resume\`).
-
-Usage
-- scriptctl episode spec
-- scriptctl episode spec > spec.md      (capture to a file for reference)
-
-Behavior
-- Reads the same MARKDOWN_BATCH_PROMPT_SPEC constant the bundled prompt uses —
-  single source of truth. No options, no side effects, no network.
-
-Output
-- Default text mode: the spec body verbatim — no title / exit wrapper, so
-  \`scriptctl episode spec > spec.md\` produces a clean spec file.
-- --json mode: standard envelope with \`body\` field holding the spec text.
-
-Exit codes
-- 0  always (read-only command).
-`,
-    ],
-    [
-        ["write", "workspace"],
-        `Report per-episode draft state inside the \`episode\` from-scratch workspace.
-
-This is a workspace-area introspection command. It only knows about files under
-workspace/episodes/. An empty result means "no from-scratch drafts in this
-workspace" — NOT "no final script exists". To query the existing final script
-(episode count, per-episode size, asset counts, etc.) use:
-  scriptctl summary
-  scriptctl episodes
-
-Usage
-- scriptctl episode workspace [options]
-
-Options
-- --workspace-path    Workspace directory. Default: workspace
-
-States
-- drafted             ep<NN>.md exists, no auto-commit yet
-- blocked-collision   collision report exists; agent must resolve
-- blocked-lint        lint critical report exists; agent must resolve
-- committed           .done-<NN> marker exists
+Notes
+- Completeness gaps (empty episode/scene, missing description) are warnings, not
+  blockers — same semantics as validate. Only integrity errors block --publish.
+- Run \`scriptctl parse --spec\` first to see the exact md layout and line grammar.
 `,
     ],
     // =========================================================================

package/dist/help-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"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"}

package/dist/infra/providers.d.ts

@@ -2,11 +2,6 @@ import { type ProviderLike } from "../domain/direct-core.js";
 type Dict = Record<string, unknown>;
 export declare class MockProvider implements ProviderLike {
     readonly name = "mock";
-    /**
-     * Mock completion for episode draft tests. Returns a small valid spec-md fragment.
-     * Real callers must never use mock provider for delivery.
-     */
-    complete(_prompt: string, _maxTokens?: number): Promise<string>;
     extractEpisode(sourceText: string, episodePlan: Dict): Dict;
     extractBatch(sourceText: string, batchPlan: Dict): Dict;
     extractMetadata(_sourceText: string, script: Dict): Dict;
@@ -28,42 +23,11 @@ export declare class AnthropicProvider implements ProviderLike {
      * raise a method-specific CliError.
      */
     private collectToolUseInput;
-    /**
-     * Generic completion entry point. Used by episode subcommand's gemini-writer to draft
-     * one episode's spec markdown from the assembled prompt. Throws CliError when the
-     * provider truncates output (so the caller can surface a deterministic error rather
-     * than committing a half-baked episode).
-     */
-    complete(prompt: string, maxTokens?: number): Promise<string>;
     extractEpisode(sourceText: string, episodePlan: Dict): Promise<Dict>;
     extractBatch(sourceText: string, batchPlan: Dict): Promise<Dict>;
     extractEpisodeTitles(sourceText: string, episodePlan: Dict): Promise<Dict>;
     extractAssetCuration(_sourceText: string, script: Dict): Promise<Dict>;
     extractMetadata(_sourceText: string, script: Dict): Promise<Dict>;
 }
-/**
- * Google Gemini provider via REST API. No SDK dependency (uses fetch).
- *
- * Used as the default writer for `scriptctl episode draft`. The Anthropic provider
- * stays available for other internal extraction tasks (metadata / title generation /
- * direct-init batch extraction) where Claude tends to outperform Gemini on JSON
- * schema adherence.
- *
- * Env:
- *   - `SCRIPTCTL_GEMINI_API_KEY` (or fallback `GEMINI_API_KEY`)  required
- *   - `SCRIPTCTL_GEMINI_BASE_URL`                                optional override
- *   - `SCRIPTCTL_GEMINI_MODEL`                                   optional default-model override
- */
-export declare class GeminiProvider implements ProviderLike {
-    readonly name = "gemini";
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly model;
-    constructor(model?: string);
-    /**
-     * Plain-text completion. Used by `episode draft` to write a spec-md episode body.
-     */
-    complete(prompt: string, maxTokens?: number): Promise<string>;
-}
 export declare function makeProvider(name: string, model: string): ProviderLike;
 export {};