@lmctl-ai/lmctl 0.2.12 → 0.2.14

package/dist/cli/save-script.d.ts

@@ -0,0 +1,36 @@
+import type { CliIo } from './common.js';
+export interface SaveScriptRequest {
+    destPath: string;
+    /** Resolved script name, e.g. "plan" (default) or "plan-minimal" (--script). */
+    slug: string;
+    force: boolean;
+}
+export interface ExtractSaveScriptResult {
+    rest: string[];
+    request?: SaveScriptRequest;
+    error?: string;
+}
+/**
+ * Strips --save-script <file>, --script <slug>, and (unless the command
+ * already owns --force itself, e.g. `plan`) a bare --force from args.
+ * --script only makes sense paired with --save-script.
+ */
+export declare function extractSaveScriptFlags(args: string[], command: string, opts?: {
+    ownsForce?: boolean;
+}): ExtractSaveScriptResult;
+/**
+ * Fetches https://lmctl.com/lmscript/commands/<slug>.lms and writes it to
+ * request.destPath. Verifies the full response BEFORE writing anything --
+ * a failed fetch, a 404, or an HTML page (offline/misconfigured host
+ * fallback) never reaches the destination file, half-written or otherwise.
+ */
+export declare function performSaveScript(io: CliIo, request: SaveScriptRequest, fetchFn?: typeof fetch): Promise<number>;
+/**
+ * Wraps a command's own run function with --save-script handling: strips
+ * the flags, runs the command UNCHANGED with the remaining args, and -- only
+ * if the command itself succeeded -- fetches and writes the script as an
+ * additive side effect. A failed command is left alone; nothing is fetched.
+ */
+export declare function runWithSaveScript(io: CliIo, command: string, args: string[], runCommand: (rest: string[]) => Promise<number>, opts?: {
+    ownsForce?: boolean;
+}): Promise<number>;