@lingjingai/scriptctl 0.49.16 → 0.51.0

package/dist/cli/register-workflows.js

@@ -0,0 +1,71 @@
+import { commandIngest } from "../usecases/ingest/command.js";
+import { commandIngestStatus } from "../usecases/ingest/status.js";
+import { commandView } from "../usecases/ingest/view-command.js";
+import { commandExportAuthoring } from "../usecases/script/export-authoring.js";
+import { commandCheckout, commandWorkingCopyPublish, commandWorkingCopyStatus, } from "../usecases/script/working-copy.js";
+import { commandWriteAuthoring } from "../usecases/script/write-authoring.js";
+import { describeArguments, dispatch, withScriptOpts, withWorkingCopyOpts, } from "./registry.js";
+export function registerWorkflowCommands(program, state, llm) {
+    const ingest = program.command("ingest")
+        .description("Convert source files into a Script v4 workspace")
+        .option("-s, --source-path <path>", "Source file or directory")
+        .option("-w, --workspace-path <path>", "Workspace directory", "workspace")
+        .option("--llm-config <path>", "LLM configuration file")
+        .option("--concurrency <n>", "Maximum concurrent model calls")
+        .option("--fps <n>", "Video sampling rate")
+        .option("--force", "Rebuild completed stages")
+        .addHelpText("after", "\nExample:\n  scriptctl ingest --source-path ./draft.md --workspace-path ./workspace\n")
+        .action(dispatch((options) => commandIngest(options, llm), state));
+    ingest.command("status")
+        .description("Show ingest workspace progress")
+        .option("-w, --workspace-path <path>", "Workspace directory")
+        .action(dispatch(commandIngestStatus, state));
+    program.command("view")
+        .description("Render or serve the workspace review page")
+        .option("-w, --workspace-path <path>", "Workspace directory", "workspace")
+        .option("--watch", "Serve and refresh the review page")
+        .option("--port <n>", "HTTP server port")
+        .action(dispatch(commandView, state));
+    withWorkingCopyOpts(program.command("checkout"))
+        .description("Download a remote script into a managed local copy")
+        .option("--discard-local", "Replace an existing dirty local copy")
+        .action(dispatch(commandCheckout, state));
+    withScriptOpts(program.command("status"), "read")
+        .description("Show local working-copy state")
+        .action(dispatch(commandWorkingCopyStatus, state));
+    withWorkingCopyOpts(program.command("publish"))
+        .description("Validate and publish the local working copy")
+        .action(dispatch(commandWorkingCopyPublish, state));
+    const write = withScriptOpts(program.command("write <file>"))
+        .description("Plan or apply an authoring document")
+        .option("--create", "Create the selected target")
+        .option("--replace", "Replace the selected target")
+        .option("--apply", "Apply the exact plan")
+        .option("--plan <digest>", "Exact plan digest to apply")
+        .addHelpText("after", "\nExample:\n  scriptctl write scene.scriptctl --replace\n  scriptctl write scene.scriptctl --replace --apply --plan <digest>\n")
+        .action(dispatch(commandWriteAuthoring, state));
+    describeArguments(write, ["Authoring source file"]);
+    const exportCommand = program.command("export")
+        .description("Export script content as an authoring document")
+        .action(() => exportCommand.outputHelp());
+    withScriptOpts(exportCommand.command("script"), "read")
+        .description("Export the complete script")
+        .requiredOption("-o, --output <file>", "Destination authoring file")
+        .action(dispatch((opts) => commandExportAuthoring("script", opts), state));
+    const descriptions = {
+        episodes: "Export selected episodes",
+        "episode-spans": "Export an inclusive episode span",
+        scenes: "Export selected scenes",
+        "scene-spans": "Export an inclusive scene span",
+        "action-spans": "Export an inclusive action span",
+    };
+    for (const kind of Object.keys(descriptions)) {
+        withScriptOpts(exportCommand.command(kind), "read")
+            .description(descriptions[kind])
+            .requiredOption("-i, --in <selector>", "Address or inclusive range to export")
+            .requiredOption("-o, --output <file>", "Destination authoring file")
+            .addHelpText("after", `\nExample:\n  scriptctl export ${kind} --in <selector> --output export.scriptctl\n`)
+            .action(dispatch((opts) => commandExportAuthoring(kind, opts), state));
+    }
+}
+//# sourceMappingURL=register-workflows.js.map

package/dist/cli/register-workflows.js.map

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

package/dist/cli/registry.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+import { type CommandOutput } from "../common.js";
+export type Handler = (opts: Record<string, unknown>) => Promise<[CommandOutput, number]> | [CommandOutput, number];
+export interface RunState {
+    jsonMode: boolean;
+    exitCode: number;
+    format?: string;
+}
+export declare function dispatch(handler: Handler, state: RunState): (...args: unknown[]) => Promise<void>;
+export declare function describeArguments(command: Command, descriptions: readonly string[]): Command;
+export declare function withScriptOpts(command: Command, access?: "read" | "write"): Command;
+export declare function withWorkingCopyOpts(command: Command): Command;
+export declare function withSelection(command: Command): Command;
+export declare const appendString: (value: string, previous: string[]) => string[];

package/dist/cli/registry.js

@@ -0,0 +1,65 @@
+import { scriptJsonPath } from "../common.js";
+import { withScriptFileLock } from "../infra/script-working-copy.js";
+import { emit } from "../output.js";
+const scriptAccess = new WeakMap();
+function camelToSnake(value) {
+    return value.replace(/([A-Z])/g, "_$1").toLowerCase();
+}
+function normalizeOpts(opts) {
+    return Object.fromEntries(Object.entries(opts).map(([key, value]) => [camelToSnake(key), value]));
+}
+function mergedCommandOpts(command) {
+    const chain = [];
+    let current = command;
+    while (current) {
+        chain.unshift(current);
+        current = current.parent;
+    }
+    return Object.assign({}, ...chain.map((item) => item.opts()));
+}
+export function dispatch(handler, state) {
+    return async (...args) => {
+        const command = args[args.length - 1];
+        const positionals = args.slice(0, -2).filter((value) => value !== undefined);
+        const normalized = normalizeOpts(mergedCommandOpts(command));
+        if (positionals.length > 0)
+            normalized["_args"] = positionals;
+        state.jsonMode = Boolean(normalized["json"]);
+        state.format = typeof normalized["format"] === "string" ? normalized["format"] : undefined;
+        const invoke = async () => handler(normalized);
+        const [output, exitCode] = scriptAccess.get(command) === "write"
+            ? await withScriptFileLock(scriptJsonPath(normalized), invoke)
+            : await invoke();
+        emit(output, exitCode, state.jsonMode, state.format);
+        state.exitCode = exitCode;
+    };
+}
+export function describeArguments(command, descriptions) {
+    command.registeredArguments.forEach((argument, index) => {
+        argument.description = descriptions[index] ?? "";
+    });
+    return command;
+}
+export function withScriptOpts(command, access = "write") {
+    scriptAccess.set(command, access);
+    return command.option("-p, --script-path <path>", "Script JSON file (default: ./workspace/script.json)");
+}
+export function withWorkingCopyOpts(command) {
+    scriptAccess.set(command, "write");
+    return command
+        .option("-p, --script-path <path>", "Local script JSON file (default: ./workspace/script.json)")
+        .option("--project-group-no <no>", "Remote project group number");
+}
+export function withSelection(command) {
+    return command
+        .option("-i, --in <selector>", "Address or address range to select")
+        .option("-t, --type <type>", "Action type to match")
+        .option("-a, --actor <id>", "Actor ID to match")
+        .option("-g, --grep <pattern>", "Text or regular expression to match")
+        .option("--has <facet>", "Require a populated action facet")
+        .option("--apply", "Apply the planned changes")
+        .option("--plan <digest>", "Exact plan digest to apply")
+        .option("-n, --dry-run", "Preview changes without writing");
+}
+export const appendString = (value, previous) => [...previous, value];
+//# sourceMappingURL=registry.js.map

package/dist/cli/registry.js.map

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

package/dist/cli.d.ts

@@ -1,2 +1,5 @@
+import { Command } from "commander";
+import { type RunState } from "./cli/registry.js";
 import { type LlmComposition } from "./llm/composition.js";
+export declare function buildProgram(state: RunState, llm?: LlmComposition): Command;
 export declare function main(argv?: string[] | null, llm?: LlmComposition): Promise<number>;