@bastani/atomic 0.6.8 → 0.7.0-1

package/dist/services/system/copy.d.ts

@@ -1,84 +0,0 @@
-/**
- * Utilities for copying directories and files with exclusions
- */
-import type { Ignore } from "ignore";
-/**
- * Safely create a directory (and parents) without throwing on EEXIST.
- *
- * `mkdir` with `{ recursive: true }` is supposed to be idempotent, but
- * cloud-sync tools like OneDrive can create the directory between the
- * internal existence check and the actual syscall, causing a spurious
- * EEXIST error on Windows.  This wrapper absorbs that race.
- */
-export declare function ensureDir(path: string): Promise<void>;
-/**
- * Synchronous version of {@link ensureDir}.
- */
-export declare function ensureDirSync(path: string): void;
-/**
- * Normalize a path for cross-platform comparison.
- * Converts Windows backslashes to forward slashes so that exclusion
- * patterns work consistently on both Windows and Unix systems.
- *
- * @param p - The path to normalize
- * @returns The path with all backslashes converted to forward slashes
- */
-export declare function normalizePath(p: string): string;
-/**
- * Check if a target path is safe (doesn't escape the base directory)
- * Protects against path traversal attacks
- */
-export declare function isPathSafe(basePath: string, targetPath: string): boolean;
-interface CopyOptions {
-    /** Paths to exclude (relative to source root or base names) */
-    exclude?: string[];
-    /** Gitignore-style filter for common junk patterns (via the `ignore` package) */
-    ignoreFilter?: Ignore;
-    /** Whether to skip scripts for the opposite platform */
-    skipOppositeScripts?: boolean;
-}
-/**
- * Copy a single file using Bun's file API
- * @throws Error if the copy operation fails
- */
-export declare function copyFile(src: string, dest: string): Promise<void>;
-/**
- * Check if a path should be excluded based on exclusion rules.
- * Uses normalized paths (forward slashes) to ensure consistent matching
- * on both Windows and Unix systems.
- *
- * When an {@link Ignore} filter is provided, gitignore-style glob patterns
- * are evaluated first so common junk files (.DS_Store, node_modules, etc.)
- * are filtered automatically without polluting the explicit `exclude` list.
- */
-export declare function shouldExclude(relativePath: string, name: string, exclude: string[], ignoreFilter?: Ignore): boolean;
-/**
- * Recursively copy a directory, overwriting existing destination files.
- */
-export declare function copyDir(src: string, dest: string, options?: CopyOptions, rootSrc?: string, rootDest?: string): Promise<void>;
-/**
- * Recursively copy a directory without overwriting existing destination files.
- */
-export declare function copyDirNonDestructive(src: string, dest: string, options?: CopyOptions, rootSrc?: string, rootDest?: string): Promise<void>;
-/**
- * Check if a path exists
- */
-export declare function pathExists(path: string): Promise<boolean>;
-/**
- * Check if a path is a directory
- */
-export declare function isDirectory(path: string): Promise<boolean>;
-/**
- * Check if a file is empty or contains only whitespace.
- *
- * A file is considered empty if:
- * - It does not exist (returns true to allow overwrite)
- * - It has 0 bytes
- * - It contains only whitespace characters (for files under 1KB)
- *
- * @param path - The path to the file to check
- * @returns true if the file is empty or whitespace-only, false otherwise
- */
-export declare function isFileEmpty(path: string): Promise<boolean>;
-export {};
-//# sourceMappingURL=copy.d.ts.map

package/dist/services/system/copy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/services/system/copy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQrC;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAahD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,UAAU,WAAW;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AAyDD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAyBT;AA+GD;;GAEG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,EACzB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,EACzB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBhE"}

package/dist/services/system/detect.d.ts

@@ -1,75 +0,0 @@
-/**
- * Utilities for command and platform detection
- */
-export declare const WSL_INSTALL_URL = "https://learn.microsoft.com/en-us/windows/wsl/install";
-/**
- * Check if a command is installed and available in PATH
- */
-export declare function isCommandInstalled(cmd: string): boolean;
-/**
- * Get the resolved absolute path to a command executable.
- *
- * On Windows, this properly resolves .cmd, .bat, .exe and other executable
- * extensions through Bun.which(), which handles the PATHEXT environment
- * variable. This is essential for spawning commands correctly on Windows
- * where 'opencode' might actually be 'opencode.cmd'.
- *
- * @param cmd - The command name to resolve (e.g., 'opencode', 'claude')
- * @returns The absolute path to the command, or null if not found
- */
-export declare function getCommandPath(cmd: string): string | null;
-/**
- * Get the version string of a command
- * Returns null if command is not installed or version check fails
- */
-export declare function getCommandVersion(cmd: string): string | null;
-/**
- * Check if running on Windows
- */
-export declare function isWindows(): boolean;
-/**
- * Check if running on macOS
- */
-export declare function isMacOS(): boolean;
-/**
- * Check if running on Linux
- */
-export declare function isLinux(): boolean;
-/**
- * Get the appropriate script extension for the current platform
- * Returns ".ps1" on Windows, ".sh" on Unix-like systems
- */
-export declare function getScriptExtension(): string;
-/**
- * Get the opposite script extension (for filtering)
- * Returns ".sh" on Windows, ".ps1" on Unix-like systems
- */
-export declare function getOppositeScriptExtension(): string;
-/**
- * Check if WSL is installed on Windows
- * Returns false on non-Windows platforms
- */
-export declare function isWslInstalled(): boolean;
-/**
- * Check if colors are enabled (respects NO_COLOR standard)
- * See: https://no-color.org/
- */
-export declare function supportsColor(): boolean;
-/**
- * Check if the terminal supports true color (24-bit).
- *
- * Checks COLORTERM, TERM, and TERM_PROGRAM environment variables.
- * macOS Terminal.app (Apple_Terminal) does NOT support truecolor and
- * will degrade hex colors to washed-out 256-color approximations.
- */
-export declare function supportsTrueColor(): boolean;
-/**
- * Check if the terminal supports 256 colors
- *
- * Note: This returns true when supportsTrueColor() returns true.
- * Since supportsTrueColor() defaults to true for modern terminals,
- * this function will also return true in most cases. This is intentional -
- * most modern terminals support at least 256 colors.
- */
-export declare function supports256Color(): boolean;
-//# sourceMappingURL=detect.d.ts.map

package/dist/services/system/detect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/services/system/detect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,eAAe,0DAC6B,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAIxC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAMvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAgC3C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/dist/theme/colors.d.ts

@@ -1,35 +0,0 @@
-import { type ColorName } from "@catppuccin/palette";
-export declare const COLORS: {
-    readonly bold: "\u001B[1m";
-    readonly dim: "\u001B[2m";
-    readonly reset: "\u001B[0m";
-    readonly red: "\u001B[31m";
-    readonly green: "\u001B[32m";
-    readonly yellow: "\u001B[33m";
-    readonly blue: "\u001B[34m";
-} | {
-    readonly bold: "";
-    readonly dim: "";
-    readonly reset: "";
-    readonly red: "";
-    readonly green: "";
-    readonly yellow: "";
-    readonly blue: "";
-};
-export type PaletteKey = "text" | "dim" | "accent" | "success" | "error" | "warning" | "mauve" | "info";
-export declare function paletteRgb(name: ColorName): readonly [number, number, number];
-export declare const PALETTE: Record<PaletteKey, readonly [number, number, number]>;
-export interface PaintOptions {
-    bold?: boolean;
-}
-export type Paint = (key: PaletteKey, text: string, opts?: PaintOptions) => string;
-/**
- * Build a colour-aware painter for the current terminal.
- *
- * Truecolor terminals get the full Catppuccin palette; legacy terminals
- * degrade to basic ANSI; NO_COLOR emits plain text. The optional `bold`
- * flag adds weight contrast — essential for typographic hierarchy in a
- * monospace medium where size and family are fixed.
- */
-export declare function createPainter(): Paint;
-//# sourceMappingURL=colors.d.ts.map

package/dist/theme/colors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/theme/colors.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA0B9D,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;CAA2C,CAAC;AAS/D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAExG,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAG7E;AAED,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CASzE,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,MAAM,CAAC;AAEnF;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,KAAK,CA2BrC"}

package/src/cli.ts

@@ -1,397 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Atomic CLI - Configuration management for coding agents
- *
- * Built with Commander.js for robust argument parsing and type-safe options.
- *
- * Usage:
- *   atomic chat -a <agent>                    Start interactive chat with an agent
- *   atomic chat session list                  List running chat/workflow sessions
- *   atomic chat session connect <id>          Attach to a session
- *   atomic workflow list                      List available workflows
- *   atomic workflow inputs <name> -a <agent>  Print a workflow's input schema (JSON)
- *   atomic workflow status [<id>]             Query workflow status (JSON)
- *   atomic workflow session list              List running sessions
- *   atomic workflow session connect <id>      Attach to a session
- *   atomic session list                       List all running sessions
- *   atomic session connect [id]               Interactive session picker
- *   atomic session kill [id] [--all] [-y]     Kill sessions; no id opens multi-select
- *   atomic config set <key> <value>           Set configuration value
- *   atomic --version                          Show version
- *   atomic --help                             Show help
- */
-
-import { Command } from "@commander-js/extra-typings";
-import { VERSION } from "./version.ts";
-import { COLORS } from "./theme/colors.ts";
-import { AGENT_CONFIG, type AgentKey } from "./services/config/index.ts";
-import { SUPPORTED_SHELLS, type Shell } from "./completions/index.ts";
-import { workflowCommand } from "./commands/cli/workflow.ts";
-import { addSessionSubcommand } from "./commands/cli/management-commands.ts";
-
-// The SDK ships its own orchestrator entry script; the dev's CLI never
-// has to opt in to re-entry handling. Session subcommand builders live
-// in `./commands/cli/management-commands.ts` so `atomic chat session`,
-// `atomic workflow session`, and `atomic session` share one
-// implementation.
-
-// ─── Program ────────────────────────────────────────────────────────────────
-
-/**
- * Create and configure the main CLI program
- */
-export function createProgram() {
-    const program = new Command()
-        .name("atomic")
-        .description("Configuration management CLI for coding agents")
-        .version(VERSION, "-v, --version", "Show version number")
-        // Required so subcommands (workflow list, session connect) can define
-        // their own options without the parent absorbing them first.
-        .enablePositionalOptions()
-
-        // Global options available to all commands
-        .option("-y, --yes", "Auto-confirm all prompts (non-interactive mode)")
-        .option("--no-banner", "Skip ASCII banner display")
-
-        // Configure error output with colors
-        .configureOutput({
-            writeErr: (str) => {
-                process.stderr.write(`${COLORS.red}${str}${COLORS.reset}`);
-            },
-            outputError: (str, write) => {
-                write(`${COLORS.red}${str}${COLORS.reset}`);
-            },
-        });
-
-    // Build agent choices string for help text
-    const agentChoices = Object.keys(AGENT_CONFIG).join(", ");
-
-    // ── Chat command (default) ──────────────────────────────────────────────
-    const chatCmd = program
-        .command("chat", { isDefault: true })
-        .description("Start an interactive chat session with a coding agent")
-        .option("-a, --agent <name>", `Agent to chat with (${agentChoices})`)
-        .allowUnknownOption()
-        .allowExcessArguments(true)
-        .enablePositionalOptions()
-        .passThroughOptions()
-        .addHelpText(
-            "after",
-            `
-All arguments after -a <agent> are forwarded to the native agent CLI.
-
-Examples:
-  $ atomic chat -a claude                           Start Claude interactively
-  $ atomic chat -a copilot                          Start Copilot interactively
-  $ atomic chat -a opencode                         Start OpenCode interactively
-  $ atomic chat -a claude "fix the bug"             Claude with initial prompt
-  $ atomic chat session list                        List running sessions
-  $ atomic chat session connect <id>                Attach to a session
-  $ atomic chat session kill [id]                   Kill a chat session (multi-select when no id)`,
-        )
-        .action(async (localOpts, cmd) => {
-            const validAgents = Object.keys(AGENT_CONFIG);
-            const agentType = localOpts.agent;
-
-            if (!agentType) {
-                console.error(
-                    `${COLORS.red}Error: Missing agent.${COLORS.reset}`,
-                );
-                console.error(
-                    "Start chat with an explicit provider, for example: atomic chat -a claude",
-                );
-                process.exit(1);
-            }
-
-            // Validate agent choice
-            if (!validAgents.includes(agentType)) {
-                console.error(
-                    `${COLORS.red}Error: Unknown agent '${agentType}'${COLORS.reset}`,
-                );
-                console.error(`Valid agents: ${agentChoices}`);
-                process.exit(1);
-            }
-
-            // Collect extra args/options to forward to the native CLI
-            const passthroughArgs = cmd.args;
-
-            const { chatCommand } = await import("./commands/cli/chat.ts");
-            const exitCode = await chatCommand({
-                agentType: agentType as AgentKey,
-                passthroughArgs,
-            });
-
-            process.exit(exitCode);
-        });
-
-    // Chat session subcommands: atomic chat session list / connect
-    addSessionSubcommand(chatCmd, "chat");
-
-    // ── Workflow command ─────────────────────────────────────────────────────
-    //
-    // The base Command (with -n, -a, -d flags and workflow dispatch) is
-    // produced by the SDK dispatcher. Subcommands (list, inputs, status,
-    // session) are attached here so they live under `atomic workflow *`.
-    //
-    // `enablePositionalOptions()` on the dispatcher is what makes
-    // `atomic workflow list -a claude` route `-a` to the `list`
-    // subcommand instead of the parent dispatcher (which *also* declares
-    // `-a/--agent` for the dispatch path). Without it, Commander would
-    // greedily bind the flag to the parent and the subcommand would
-    // never see it.
-    workflowCommand
-        .description("Run a multi-session agent workflow")
-        .enablePositionalOptions()
-        .addHelpText(
-            "after",
-            `
-Examples:
-  $ atomic workflow list                            List available workflows
-  $ atomic workflow list -a claude                  List Claude workflows only
-  $ atomic workflow -a claude                       Open the interactive picker
-  $ atomic workflow -n ralph -a claude "fix bug"    Run a free-form workflow
-  $ atomic workflow -n ralph -a claude -d "fix bug" Run detached in the background
-  $ atomic workflow inputs <name> -a claude         Print a workflow's input schema (JSON)
-  $ atomic workflow status                          List status for all running workflows
-  $ atomic workflow status <id>                     Query a single workflow's status
-  $ atomic workflow session list                    List running sessions
-  $ atomic workflow session connect <id>            Attach to a session
-  $ atomic workflow session kill --all -y           Kill all workflow sessions, no prompt`,
-        );
-
-    program.addCommand(workflowCommand);
-
-    // Workflow list subcommand: atomic workflow list [-a <agent>]
-    // Prints the builtin registry. `-a` filters to one agent so users
-    // can narrow to workflows runnable with their configured provider.
-    workflowCommand
-        .command("list")
-        .description("List available workflows (optionally filter by agent)")
-        .option("-a, --agent <name>", `Filter by agent backend (${agentChoices})`)
-        .action(async (localOpts) => {
-            const { workflowListCommand } = await import(
-                "./commands/cli/workflow-list.ts"
-            );
-            const exitCode = await workflowListCommand({
-                agent: localOpts.agent,
-            });
-            process.exit(exitCode);
-        });
-
-    // Workflow inputs subcommand: atomic workflow inputs <name> -a <agent>
-    // Exposes the declared input schema so an orchestrating agent can build
-    // a valid `atomic workflow -n ...` invocation without reading source.
-    workflowCommand
-        .command("inputs")
-        .description("Print a workflow's declared input schema (JSON by default)")
-        .argument("<name>", "Workflow name")
-        .requiredOption("-a, --agent <name>", `Agent backend (${agentChoices})`)
-        .option("--format <format>", "Output format: json | text", "json")
-        .action(async (name, localOpts) => {
-            const { workflowInputsCommand } = await import(
-                "./commands/cli/workflow-inputs.ts"
-            );
-            const exitCode = await workflowInputsCommand({
-                name,
-                agent: localOpts.agent,
-                format: localOpts.format === "text" ? "text" : "json",
-            });
-            process.exit(exitCode);
-        });
-
-    // Workflow status subcommand: atomic workflow status [<id>]
-    // Returns one of in_progress | error | completed | needs_review.
-    // Defaults to JSON so agents can parse it without screen-scraping.
-    workflowCommand
-        .command("status")
-        .description(
-            "Query workflow status (in_progress, error, completed, needs_review)",
-        )
-        .argument("[session_id]", "Workflow tmux session id (omit to list all)")
-        .option("--format <format>", "Output format: json | text", "json")
-        .action(async (sessionId, localOpts) => {
-            const { workflowStatusCommand } = await import(
-                "./commands/cli/workflow-status.ts"
-            );
-            const exitCode = await workflowStatusCommand({
-                id: sessionId,
-                format: localOpts.format === "text" ? "text" : "json",
-            });
-            process.exit(exitCode);
-        });
-
-    // Workflow session subcommands: atomic workflow session list / connect
-    addSessionSubcommand(workflowCommand, "workflow");
-
-    // ── Top-level session command ───────────────────────────────────────────
-    addSessionSubcommand(program);
-
-    // ── Config command ──────────────────────────────────────────────────────
-    const configCmd = program
-        .command("config")
-        .description("Manage atomic configuration");
-
-    // Add 'set' subcommand to config
-    configCmd
-        .command("set")
-        .description("Set a configuration value")
-        .argument("<key>", "Configuration key (telemetry | scm)")
-        .argument("<value>", "Value to set (telemetry: true|false; scm: github|azure-devops|sapling)")
-        .action(async (key: string, value: string) => {
-            const { configCommand } = await import("./commands/cli/config.ts");
-            const exitCode = await configCommand("set", key, value);
-            process.exit(exitCode);
-        });
-
-    // ── Internal: footer renderer (spawned inside agent tmux windows) ──────
-    program
-        .command("_footer", { hidden: true })
-        .description("Internal: render the attached-mode footer for an agent window")
-        .requiredOption("--name <name>", "Agent window name")
-        .option("--agent <agent>", "Agent type — renders provider pill in the footer")
-        .action(async (opts: { name: string; agent?: string }) => {
-            const { footerCommand } = await import("./commands/cli/footer.tsx");
-            const { isValidAgent } = await import("./services/config/definitions.ts");
-            const agentType = opts.agent && isValidAgent(opts.agent) ? opts.agent : undefined;
-            const exitCode = await footerCommand(opts.name, agentType);
-            process.exit(exitCode);
-        });
-
-    // ── Internal: Claude Stop hook handler ────────────────────────────────
-    program
-        .command("_claude-stop-hook", { hidden: true })
-        .description("Internal: Claude Code Stop hook handler — writes a marker file for idle detection")
-        .action(async () => {
-            const { claudeStopHookCommand } = await import("./commands/cli/claude-stop-hook.ts");
-            const exitCode = await claudeStopHookCommand();
-            process.exit(exitCode);
-        });
-
-    // ── Internal: Claude SessionStart hook handler ────────────────────────
-    program
-        .command("_claude-session-start-hook", { hidden: true })
-        .description("Internal: Claude Code SessionStart hook handler — writes a ready-marker file")
-        .action(async () => {
-            const { claudeSessionStartHookCommand } = await import("./commands/cli/claude-session-start-hook.ts");
-            const exitCode = await claudeSessionStartHookCommand();
-            process.exit(exitCode);
-        });
-
-    // ── Internal: Claude AskUserQuestion hook handler ─────────────────────
-    program
-        .command("_claude-ask-hook", { hidden: true })
-        .description("Internal: Claude Code AskUserQuestion hook handler — writes/removes HIL marker")
-        .argument("<mode>", "enter (PreToolUse) or exit (PostToolUse / PostToolUseFailure)")
-        .action(async (mode: string) => {
-            if (mode !== "enter" && mode !== "exit") {
-                console.error(`[claude-ask-hook] Invalid mode: ${mode}`);
-                process.exit(0);
-            }
-            const { claudeAskHookCommand } = await import("./commands/cli/claude-ask-hook.ts");
-            const exitCode = await claudeAskHookCommand(mode);
-            process.exit(exitCode);
-        });
-
-    // ── Internal: Claude Subagent / TeammateIdle lifecycle hook handler ───
-    program
-        .command("_claude-inflight-hook", { hidden: true })
-        .description("Internal: Claude Code Subagent/TeammateIdle lifecycle hook handler — touches/removes inflight markers, or waits for them to drain")
-        .argument("<mode>", "start (SubagentStart), stop (SubagentStop), or wait (TeammateIdle)")
-        .action(async (mode: string) => {
-            if (mode !== "start" && mode !== "stop" && mode !== "wait") {
-                // Silent exit-0 to match the handler's contract — never red
-                // hook errors in transcripts.
-                process.exit(0);
-            }
-            const { claudeInflightHookCommand } = await import("./commands/cli/claude-inflight-hook.ts");
-            const exitCode = await claudeInflightHookCommand(mode);
-            process.exit(exitCode);
-        });
-
-    // ── Completions command ────────────────────────────────────────────────
-    program
-        .command("completions")
-        .description("Output shell completion script")
-        .argument("<shell>", `Shell type (${SUPPORTED_SHELLS.join(", ")})`)
-        .addHelpText(
-            "after",
-            `
-Install completions for your shell:
-
-  Bash   eval "$(atomic completions bash)"     # add to ~/.bashrc
-  Zsh    eval "$(atomic completions zsh)"      # add to ~/.zshrc
-  Fish   atomic completions fish | source      # or save to ~/.config/fish/completions/atomic.fish
-  PowerShell  atomic completions powershell | Invoke-Expression  # add to $PROFILE`,
-        )
-        .action(async (shell) => {
-            if (!SUPPORTED_SHELLS.includes(shell as Shell)) {
-                console.error(
-                    `${COLORS.red}Error: Unknown shell '${shell}'${COLORS.reset}`,
-                );
-                console.error(`Supported shells: ${SUPPORTED_SHELLS.join(", ")}`);
-                process.exit(1);
-            }
-            const { completionsCommand } = await import("./commands/cli/completions.ts");
-            const exitCode = completionsCommand(shell as Shell);
-            process.exit(exitCode);
-        });
-
-    return program;
-}
-
-// Create the program instance for use by main() and tests
-export const program = createProgram();
-
-/**
- * Main entry point for the CLI.
- *
- * The SDK owns orchestrator re-entry now (see
- * `src/sdk/runtime/orchestrator-entry.ts`), so the atomic CLI just
- * runs its bootstrap, parses argv, and exits.
- */
-async function main(): Promise<void> {
-    try {
-        // Bootstrap `~/.atomic/settings.json` on every invocation if absent,
-        // so users always have a file to edit with JSON Schema intellisense
-        // wired up. Idempotent; swallows FS errors internally.
-        const { ensureGlobalAtomicSettings } = await import(
-            "./services/config/settings.ts"
-        );
-        await ensureGlobalAtomicSettings();
-
-        // Sync tooling deps and global skills on first launch after install
-        // or upgrade. Runs at most once per version bump (gated on a marker
-        // file under ~/.atomic). Skipped for `--version` / `--help` so info
-        // paths stay instant.
-        const argv = process.argv.slice(2);
-        const isInfoCommand =
-            argv.includes("--version") ||
-            argv.includes("-v") ||
-            argv.includes("--help") ||
-            argv.includes("-h") ||
-            argv[0] === "completions" ||
-            argv[0] === "_footer" ||
-            argv[0] === "_claude-stop-hook" ||
-            argv[0] === "_claude-ask-hook" ||
-            argv[0] === "_claude-session-start-hook" ||
-            argv[0] === "_claude-inflight-hook";
-
-        if (!isInfoCommand) {
-            const { autoSyncIfStale } = await import(
-                "./services/system/auto-sync.ts"
-            );
-            await autoSyncIfStale();
-        }
-
-        await program.parseAsync();
-    } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`${COLORS.red}Error: ${message}${COLORS.reset}`);
-        process.exit(1);
-    }
-}
-
-// Run the CLI
-if (import.meta.main) {
-    await main();
-}

package/src/commands/builtin-registry.ts

@@ -1,37 +0,0 @@
-/**
- * Atomic-CLI-specific registry of builtin workflows.
- *
- * Lives outside the SDK because the set of builtins is an atomic CLI
- * concern: third-party CLIs build their own registries with their own
- * workflows.
- */
-
-import { createRegistry } from "../sdk/registry.ts";
-
-// ralph
-import ralphClaude from "../sdk/workflows/builtin/ralph/claude/index.ts";
-import ralphCopilot from "../sdk/workflows/builtin/ralph/copilot/index.ts";
-import ralphOpencode from "../sdk/workflows/builtin/ralph/opencode/index.ts";
-
-// deep-research-codebase
-import drcClaude from "../sdk/workflows/builtin/deep-research-codebase/claude/index.ts";
-import drcCopilot from "../sdk/workflows/builtin/deep-research-codebase/copilot/index.ts";
-import drcOpencode from "../sdk/workflows/builtin/deep-research-codebase/opencode/index.ts";
-
-// open-claude-design
-import ocdClaude from "../sdk/workflows/builtin/open-claude-design/claude/index.ts";
-import ocdCopilot from "../sdk/workflows/builtin/open-claude-design/copilot/index.ts";
-import ocdOpencode from "../sdk/workflows/builtin/open-claude-design/opencode/index.ts";
-
-export function createBuiltinRegistry() {
-  return createRegistry()
-    .register(ralphClaude)
-    .register(ralphCopilot)
-    .register(ralphOpencode)
-    .register(drcClaude)
-    .register(drcCopilot)
-    .register(drcOpencode)
-    .register(ocdClaude)
-    .register(ocdCopilot)
-    .register(ocdOpencode);
-}