@mudssky/trellis 0.6.16-mudssky.5

package/dist/commands/ablate.js

@@ -0,0 +1,308 @@
+/** Full, reversible project-level Trellis ablation and exact restoration. */
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { ALL_MANAGED_DIRS, getConfiguredPlatforms, } from "../configurators/index.js";
+import { DIR_NAMES } from "../constants/paths.js";
+import { COMMAND_NAME } from "../constants/version.js";
+import { ABLATION_STATE_ROOT_ENV, assertExternalStateRoot, canonicalProjectRoot, expectedFileFingerprint, fingerprintPath, getAblationStateRoot, getTransactionPaths, loadAblationTransaction, rollbackAblationTransaction, restoreAblationTransaction, stageAblationTransaction, transitionAblationState, verifyAblatedState, withAblationProjectLock, } from "../utils/ablation-store.js";
+import { writeFileAtomic } from "../utils/atomic-write.js";
+import { homedirBypassEnabled, homedirGuardMessage, isCwdHomedir, } from "../utils/cwd-guard.js";
+import { buildManagedRemovalPlan, lstatIfPresent, } from "../utils/managed-removal.js";
+import { pruneOrphanManifestKeys } from "../utils/manifest-prune.js";
+import { loadHashes } from "../utils/template-hash.js";
+function isTrellisPath(relativePath) {
+    return (relativePath === DIR_NAMES.WORKFLOW ||
+        relativePath.startsWith(`${DIR_NAMES.WORKFLOW}/`));
+}
+function backupPath(relativePath) {
+    return `backup/${relativePath}`;
+}
+function promptContinue(message) {
+    return inquirer
+        .prompt([{ type: "confirm", name: "proceed", message, default: true }])
+        .then(({ proceed }) => proceed);
+}
+function refuseNonInteractivePrompt(command) {
+    console.error(chalk.red(`Refusing to prompt for ${command} confirmation in a non-interactive shell. ` +
+        "Pass --yes/-y to confirm or --dry-run to preview."));
+    readline.createInterface({ input: process.stdin }).close();
+    process.exit(1);
+}
+function assertCommandCwd(command) {
+    if (isCwdHomedir() && !homedirBypassEnabled()) {
+        console.error(chalk.red(homedirGuardMessage(command)));
+        process.exit(1);
+    }
+}
+function renderAblatePlan(plan, prunableDirectories, transactionDir) {
+    const deletions = plan.deletions.filter((entry) => !entry.missing && !isTrellisPath(entry.posixPath));
+    console.log(chalk.bold("\nTrellis full ablation plan\n"));
+    console.log(chalk.red.bold(`Will be removed (${deletions.length + 1} managed entries):`));
+    for (const entry of deletions)
+        console.log(`  ${chalk.red("-")} ${entry.posixPath}`);
+    console.log(`  ${chalk.red("-")} ${DIR_NAMES.WORKFLOW}/`);
+    if (plan.modifications.length > 0) {
+        console.log(chalk.yellow.bold(`\nWill be scrubbed (${plan.modifications.length} mixed files):`));
+        for (const entry of plan.modifications) {
+            console.log(`  ${chalk.yellow("~")} ${entry.posixPath}`);
+        }
+    }
+    if (prunableDirectories.length > 0) {
+        console.log(chalk.gray(`\n${prunableDirectories.length} empty managed directories will be pruned.`));
+    }
+    console.log(chalk.gray(`\nRecovery transaction: ${transactionDir}`));
+    console.log(chalk.yellow("Recovery copies exact .trellis task/spec/workspace bytes, which may contain user-authored sensitive text. " +
+        "The private transaction is retained until verified restore.\n"));
+}
+function renderRestorePlan(transaction) {
+    console.log(chalk.bold("\nTrellis restore plan\n"));
+    console.log(`Will restore ${transaction.state.entries.length} managed path(s) from ${transaction.paths.transactionDir}`);
+    console.log(chalk.gray(`Transaction created with Trellis ${transaction.state.trellisVersion} at ${transaction.state.createdAt}.\n`));
+}
+function relativeFromRoot(projectRoot, absPath) {
+    return path.relative(projectRoot, absPath).split(path.sep).join("/");
+}
+function isManagedDirectoryTerritory(relativeDir) {
+    if (relativeDir === DIR_NAMES.WORKFLOW || isTrellisPath(relativeDir)) {
+        return false;
+    }
+    return ALL_MANAGED_DIRS.filter((managedDir) => managedDir !== DIR_NAMES.WORKFLOW).some((root) => relativeDir === root ||
+        relativeDir.startsWith(`${root}/`) ||
+        root.startsWith(`${relativeDir}/`));
+}
+/** Predict directories that become empty after every planned deletion. */
+function collectPrunableDirectories(projectRoot, plan) {
+    const deleted = new Set(plan.deletions
+        .filter((entry) => !entry.missing && !isTrellisPath(entry.posixPath))
+        .map((entry) => path.resolve(entry.absPath)));
+    const candidates = new Set();
+    for (const deletedPath of deleted) {
+        let current = path.dirname(deletedPath);
+        while (current !== projectRoot &&
+            current.startsWith(`${projectRoot}${path.sep}`)) {
+            const relative = relativeFromRoot(projectRoot, current);
+            if (!isManagedDirectoryTerritory(relative))
+                break;
+            candidates.add(current);
+            current = path.dirname(current);
+        }
+    }
+    const memo = new Map();
+    const willBeEmpty = (directory) => {
+        const cached = memo.get(directory);
+        if (cached !== undefined)
+            return cached;
+        const stat = lstatIfPresent(directory);
+        if (!stat || !stat.isDirectory() || stat.isSymbolicLink()) {
+            memo.set(directory, false);
+            return false;
+        }
+        const empty = fs.readdirSync(directory).every((name) => {
+            const child = path.join(directory, name);
+            if (deleted.has(path.resolve(child)))
+                return true;
+            const childStat = lstatIfPresent(child);
+            return Boolean(childStat?.isDirectory() &&
+                !childStat.isSymbolicLink() &&
+                candidates.has(child) &&
+                willBeEmpty(child));
+        });
+        memo.set(directory, empty);
+        return empty;
+    };
+    return [...candidates]
+        .filter((directory) => willBeEmpty(directory))
+        .map((directory) => relativeFromRoot(projectRoot, directory))
+        .sort((left, right) => right.split("/").length - left.split("/").length);
+}
+function addEntry(entries, seen, relativePath, pre, expectedAblated) {
+    if (seen.has(relativePath))
+        return;
+    seen.add(relativePath);
+    entries.push({
+        relativePath,
+        pre,
+        expectedAblated,
+        ...(pre.kind === "absent" ? {} : { backupPath: backupPath(relativePath) }),
+    });
+}
+function buildAblationEntries(projectRoot, plan, prunableDirectories) {
+    const entries = [];
+    const seen = new Set();
+    for (const deletion of plan.deletions) {
+        if (isTrellisPath(deletion.posixPath))
+            continue;
+        const pre = fingerprintPath(deletion.absPath);
+        if (pre.kind === "directory") {
+            throw new Error(`Manifest entry is a directory rather than a managed leaf: ${deletion.posixPath}`);
+        }
+        addEntry(entries, seen, deletion.posixPath, pre, { kind: "absent" });
+    }
+    for (const modification of plan.modifications) {
+        const pre = fingerprintPath(modification.absPath);
+        if (pre.kind !== "file") {
+            throw new Error(`Mixed managed path is not a regular file: ${modification.posixPath}`);
+        }
+        addEntry(entries, seen, modification.posixPath, pre, expectedFileFingerprint(modification.result.content, pre.mode));
+    }
+    for (const relativeDir of prunableDirectories) {
+        addEntry(entries, seen, relativeDir, fingerprintPath(path.join(projectRoot, ...relativeDir.split("/"))), { kind: "absent" });
+    }
+    const trellisPath = path.join(projectRoot, DIR_NAMES.WORKFLOW);
+    addEntry(entries, seen, DIR_NAMES.WORKFLOW, fingerprintPath(trellisPath), {
+        kind: "absent",
+    });
+    return entries;
+}
+function applyAblationPlan(projectRoot, plan, prunableDirectories, transaction) {
+    const preByPath = new Map(transaction.state.entries.map((entry) => [entry.relativePath, entry.pre]));
+    for (const modification of plan.modifications) {
+        writeFileAtomic(modification.absPath, modification.result.content);
+        const pre = preByPath.get(modification.posixPath);
+        if (process.platform !== "win32" && pre?.kind === "file") {
+            fs.chmodSync(modification.absPath, pre.mode);
+        }
+    }
+    for (const deletion of plan.deletions) {
+        if (deletion.missing || isTrellisPath(deletion.posixPath))
+            continue;
+        const stat = fs.lstatSync(deletion.absPath);
+        if (stat.isDirectory() && !stat.isSymbolicLink()) {
+            throw new Error(`Refusing to unlink managed directory: ${deletion.posixPath}`);
+        }
+        fs.unlinkSync(deletion.absPath);
+    }
+    const trellisPath = path.join(projectRoot, DIR_NAMES.WORKFLOW);
+    const trellisStat = lstatIfPresent(trellisPath);
+    if (trellisStat?.isSymbolicLink()) {
+        fs.unlinkSync(trellisPath);
+    }
+    else if (trellisStat) {
+        fs.rmSync(trellisPath, { recursive: true, force: false });
+    }
+    for (const relativeDir of prunableDirectories) {
+        const directory = path.join(projectRoot, ...relativeDir.split("/"));
+        if (fs.existsSync(directory) && fs.readdirSync(directory).length === 0) {
+            fs.rmdirSync(directory);
+        }
+    }
+}
+function rollbackFailedAblation(transaction, originalError, lockHeld = false) {
+    try {
+        rollbackAblationTransaction(transaction, { lockHeld });
+    }
+    catch (rollbackError) {
+        if (transaction.state.status !== "preparing" &&
+            transaction.state.status !== "restoring") {
+            transitionAblationState(transaction, "conflict");
+        }
+        throw new Error(`Ablation failed and automatic rollback was incomplete. Recovery state remains at ${transaction.paths.transactionDir}. ` +
+            `Original error: ${originalError instanceof Error ? originalError.message : String(originalError)}. ` +
+            `Rollback error: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`);
+    }
+    throw originalError;
+}
+export async function ablate(options = {}) {
+    assertCommandCwd("ablate");
+    const projectRoot = canonicalProjectRoot(process.cwd());
+    const stateRoot = getAblationStateRoot();
+    assertExternalStateRoot(projectRoot, stateRoot);
+    const transactionPaths = getTransactionPaths(projectRoot, stateRoot);
+    if (fs.existsSync(transactionPaths.transactionDir)) {
+        throw new Error(`This project is already ablated or has an interrupted ablation. Run \`${COMMAND_NAME} restore\` first.`);
+    }
+    const trellisPath = path.join(projectRoot, DIR_NAMES.WORKFLOW);
+    if (!lstatIfPresent(trellisPath)) {
+        console.log(chalk.gray("Trellis is not installed in this project."));
+        return;
+    }
+    const hashes = loadHashes(projectRoot);
+    if (Object.keys(hashes).length === 0) {
+        throw new Error(`Trellis manifest is missing or not v2. Run the current \`${COMMAND_NAME} update\` before ablation.`);
+    }
+    const configuredPlatforms = getConfiguredPlatforms(projectRoot);
+    const { hashes: prunedManifest, pruned } = pruneOrphanManifestKeys(projectRoot, [...configuredPlatforms], hashes, { persist: false });
+    if (pruned.length > 0) {
+        console.log(chalk.gray(`Pruned ${pruned.length} orphan manifest entries in memory.`));
+    }
+    let plan;
+    try {
+        plan = buildManagedRemovalPlan(projectRoot, prunedManifest, {
+            strictPaths: true,
+        });
+    }
+    catch (error) {
+        throw new Error(`${error instanceof Error ? error.message : String(error)} ` +
+            "Restore the managed file to its Trellis-generated form or remove its stale manifest entry, then retry.", { cause: error });
+    }
+    const prunableDirectories = collectPrunableDirectories(projectRoot, plan);
+    renderAblatePlan(plan, prunableDirectories, transactionPaths.transactionDir);
+    if (options.dryRun) {
+        console.log(chalk.gray("Dry run — no files or recovery state were modified."));
+        return;
+    }
+    if (!options.yes) {
+        if (!process.stdin.isTTY)
+            refuseNonInteractivePrompt("ablate");
+        if (!(await promptContinue("Temporarily remove all project Trellis surfaces?"))) {
+            console.log(chalk.yellow("Ablation cancelled. No files modified."));
+            return;
+        }
+    }
+    const entries = buildAblationEntries(projectRoot, plan, prunableDirectories);
+    withAblationProjectLock(transactionPaths, () => {
+        if (lstatIfPresent(transactionPaths.transactionDir)) {
+            throw new Error(`This project is already ablated or has an interrupted ablation. Run \`${COMMAND_NAME} restore\` first.`);
+        }
+        const transaction = stageAblationTransaction({
+            projectRoot,
+            configuredPlatforms: [...configuredPlatforms],
+            manifest: prunedManifest,
+            entries,
+        }, { lockHeld: true });
+        try {
+            applyAblationPlan(projectRoot, plan, prunableDirectories, transaction);
+            verifyAblatedState(transaction);
+            transitionAblationState(transaction, "applied");
+        }
+        catch (error) {
+            rollbackFailedAblation(transaction, error, true);
+        }
+    });
+    console.log(chalk.green("Trellis is fully ablated for this project."));
+    console.log(chalk.yellow("Start a fresh agent session before comparing behavior."));
+    console.log(chalk.gray("Git may show Trellis-managed deletions. The global CLI, channel logs, and host transcripts were not removed."));
+}
+export async function restore(options = {}) {
+    assertCommandCwd("restore");
+    const projectRoot = canonicalProjectRoot(process.cwd());
+    const transaction = loadAblationTransaction(projectRoot);
+    if (!transaction) {
+        console.log(chalk.gray("No Trellis ablation transaction exists for this project."));
+        return;
+    }
+    renderRestorePlan(transaction);
+    if (!options.dryRun && !options.yes) {
+        if (!process.stdin.isTTY)
+            refuseNonInteractivePrompt("restore");
+        if (!(await promptContinue("Restore the exact pre-ablation Trellis state?"))) {
+            console.log(chalk.yellow("Restore cancelled. No files modified."));
+            return;
+        }
+    }
+    restoreAblationTransaction(transaction, {
+        dryRun: options.dryRun,
+        deleteAfterRestore: !options.dryRun,
+    });
+    if (options.dryRun) {
+        console.log(chalk.gray("Dry run — restoration is conflict-free; no files were modified."));
+        return;
+    }
+    console.log(chalk.green("Trellis project state restored exactly."));
+    console.log(chalk.yellow("Start a fresh agent session to resume with Trellis."));
+}
+export { ABLATION_STATE_ROOT_ENV };
+//# sourceMappingURL=ablate.js.map

package/dist/commands/ablate.js.map

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

package/dist/commands/channel/adapters/claude.d.ts

@@ -0,0 +1,53 @@
+import type { ParseResult } from "./types.js";
+/**
+ * Parse one line of Claude stream-json stdout.
+ * Returns the channel events to emit + any side effects.
+ *
+ * Pure function: same input always produces same output. No I/O.
+ */
+export declare function parseClaudeLine(line: string): ParseResult;
+/**
+ * Encode a channel user message into Claude stream-json stdin line(s).
+ */
+export declare function encodeClaudeUserMessage(text: string): string;
+/**
+ * Send Claude's provider-level interrupt control request before the
+ * replacement prompt. Current SDK behavior is best-effort, but keeping it
+ * separate from channel message metadata makes interrupt an explicit command path.
+ */
+export declare function encodeClaudeInterruptMessage(text: string): string;
+/**
+ * Prompts at or below this length stay inline on the worker command line.
+ * Inlining keeps Claude Code installs older than v2.0.34 (which lack
+ * `--append-system-prompt-file`) working exactly as before; larger prompts
+ * must go through a file because Windows CreateProcess caps the whole
+ * command line at 32,767 chars (spawn ENAMETOOLONG). 8,000 leaves ample
+ * headroom for the fixed flags plus Windows quoting/escaping expansion.
+ */
+export declare const INLINE_SYSTEM_PROMPT_MAX_CHARS = 8000;
+/**
+ * Decide whether a system prompt is large enough that the supervisor must
+ * hand it to the worker via a file instead of letting adapters inline it as
+ * an argv flag. Exported for tests and for the supervisor, which owns
+ * prompt-file persistence.
+ */
+export declare function shouldUseSystemPromptFile(systemPrompt: string): boolean;
+/**
+ * Build the Claude CLI args for `claude -p` in stream-json mode.
+ */
+export declare function buildClaudeArgs(opts: {
+    resumeSessionId?: string;
+    model?: string;
+    verbose?: boolean;
+    /** Appended to Claude's default system prompt (per agent definition body). */
+    systemPrompt?: string;
+    /**
+     * Path to a file whose content is appended to Claude's default system
+     * prompt. Takes precedence over `systemPrompt`. Inlining a large prompt
+     * on the command line breaks spawn(): Windows CreateProcess caps the
+     * command line at 32,767 chars (spawn ENAMETOOLONG), and Linux
+     * MAX_ARG_STRLEN caps a single arg at 128KiB.
+     */
+    systemPromptFile?: string;
+}): string[];
+//# sourceMappingURL=claude.d.ts.map

package/dist/commands/channel/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../src/commands/channel/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AA4D5D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAuCzD;AAyFD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,EAAE,CAoBX"}

package/dist/commands/channel/adapters/claude.js

@@ -0,0 +1,225 @@
+function summarizeInput(input, max = 120) {
+    if (input === null || input === undefined)
+        return "";
+    let s;
+    try {
+        s = typeof input === "string" ? input : JSON.stringify(input);
+    }
+    catch {
+        s = String(input);
+    }
+    return s.length > max ? s.slice(0, max) + "…" : s;
+}
+function isMcpToolName(name) {
+    return /^mcp__/.test(name);
+}
+/**
+ * Parse one line of Claude stream-json stdout.
+ * Returns the channel events to emit + any side effects.
+ *
+ * Pure function: same input always produces same output. No I/O.
+ */
+export function parseClaudeLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return { events: [] };
+    let msg;
+    try {
+        msg = JSON.parse(trimmed);
+    }
+    catch {
+        return {
+            events: [
+                {
+                    kind: "error",
+                    payload: {
+                        message: "Failed to parse Claude stdout line",
+                        raw_excerpt: trimmed.slice(0, 200),
+                    },
+                },
+            ],
+        };
+    }
+    switch (msg.type) {
+        case "system":
+            return handleSystem(msg);
+        case "assistant":
+            return handleAssistant(msg);
+        case "user":
+            return { events: [] };
+        case "rate_limit_event":
+            return { events: [] };
+        case "result":
+            return handleResult(msg);
+        case "control_response":
+            // Acknowledgement of our outbound control_request (e.g. interrupt).
+            // Silently consume — supervisor doesn't need to wait on it.
+            return { events: [] };
+        default:
+            return { events: [] };
+    }
+}
+function handleSystem(msg) {
+    if (msg.subtype === "init" && msg.session_id) {
+        return {
+            events: [],
+            side: { persistSessionId: msg.session_id },
+        };
+    }
+    return { events: [] };
+}
+function handleAssistant(msg) {
+    const blocks = msg.message?.content;
+    if (!Array.isArray(blocks))
+        return { events: [] };
+    const events = [];
+    for (const b of blocks) {
+        switch (b.type) {
+            case "text": {
+                if (b.text && b.text.length > 0) {
+                    events.push({ kind: "message", payload: { text: b.text } });
+                }
+                break;
+            }
+            case "tool_use": {
+                const name = b.name ?? "";
+                const payload = {
+                    detail: {
+                        tool: name,
+                        input_summary: summarizeInput(b.input),
+                    },
+                };
+                if (isMcpToolName(name)) {
+                    const parts = name.split("__");
+                    payload.detail.kind = "mcp";
+                    if (parts.length >= 3) {
+                        payload.detail.server = parts[1];
+                        payload.detail.tool_name = parts
+                            .slice(2)
+                            .join("__");
+                    }
+                }
+                events.push({ kind: "progress", payload });
+                break;
+            }
+            case "thinking":
+                // skip in default mode
+                break;
+            default:
+                // unknown block type — skip silently
+                break;
+        }
+    }
+    return { events };
+}
+function handleResult(msg) {
+    if (msg.is_error) {
+        return {
+            events: [
+                {
+                    kind: "error",
+                    payload: {
+                        message: msg.result ?? "Claude reported is_error",
+                        duration_ms: msg.duration_ms,
+                    },
+                },
+            ],
+        };
+    }
+    // Intentionally do NOT copy `msg.result` into `done.text`. Claude already
+    // emitted the final text as an `assistant.message.content[].text` block,
+    // which we turned into a `kind:message` event above. Repeating it on
+    // `done` makes GUI consumers render the answer twice.
+    return {
+        events: [
+            {
+                kind: "done",
+                payload: {
+                    duration_ms: msg.duration_ms,
+                    total_cost_usd: msg.total_cost_usd,
+                    num_turns: msg.num_turns,
+                },
+            },
+        ],
+    };
+}
+/**
+ * Encode a channel user message into Claude stream-json stdin line(s).
+ */
+export function encodeClaudeUserMessage(text) {
+    const lines = [];
+    lines.push(JSON.stringify({
+        type: "user",
+        message: {
+            role: "user",
+            content: [{ type: "text", text }],
+        },
+    }));
+    return lines.join("\n") + "\n";
+}
+/**
+ * Send Claude's provider-level interrupt control request before the
+ * replacement prompt. Current SDK behavior is best-effort, but keeping it
+ * separate from channel message metadata makes interrupt an explicit command path.
+ */
+export function encodeClaudeInterruptMessage(text) {
+    const lines = [
+        JSON.stringify({
+            type: "control_request",
+            request_id: `trellis-int-${Date.now()}-${Math.random()
+                .toString(36)
+                .slice(2, 8)}`,
+            request: { subtype: "interrupt" },
+        }),
+        encodeClaudeUserMessage(text).trimEnd(),
+    ];
+    return lines.join("\n") + "\n";
+}
+/**
+ * Prompts at or below this length stay inline on the worker command line.
+ * Inlining keeps Claude Code installs older than v2.0.34 (which lack
+ * `--append-system-prompt-file`) working exactly as before; larger prompts
+ * must go through a file because Windows CreateProcess caps the whole
+ * command line at 32,767 chars (spawn ENAMETOOLONG). 8,000 leaves ample
+ * headroom for the fixed flags plus Windows quoting/escaping expansion.
+ */
+export const INLINE_SYSTEM_PROMPT_MAX_CHARS = 8_000;
+/**
+ * Decide whether a system prompt is large enough that the supervisor must
+ * hand it to the worker via a file instead of letting adapters inline it as
+ * an argv flag. Exported for tests and for the supervisor, which owns
+ * prompt-file persistence.
+ */
+export function shouldUseSystemPromptFile(systemPrompt) {
+    return (systemPrompt.trim().length > 0 &&
+        systemPrompt.length > INLINE_SYSTEM_PROMPT_MAX_CHARS);
+}
+/**
+ * Build the Claude CLI args for `claude -p` in stream-json mode.
+ */
+export function buildClaudeArgs(opts) {
+    const args = [
+        "-p",
+        "--input-format",
+        "stream-json",
+        "--output-format",
+        "stream-json",
+        "--permission-mode",
+        "bypassPermissions",
+        "--dangerously-skip-permissions",
+    ];
+    if (opts.verbose !== false)
+        args.push("--verbose");
+    if (opts.resumeSessionId)
+        args.push("--resume", opts.resumeSessionId);
+    if (opts.model)
+        args.push("--model", opts.model);
+    if (opts.systemPromptFile) {
+        args.push("--append-system-prompt-file", opts.systemPromptFile);
+    }
+    else if (opts.systemPrompt?.trim()) {
+        args.push("--append-system-prompt", opts.systemPrompt);
+    }
+    return args;
+}
+//# sourceMappingURL=claude.js.map

package/dist/commands/channel/adapters/claude.js.map

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