@bastani/atomic 0.5.12-5 → 0.5.13-0

package/dist/sdk/workflows/builtin/ralph/helpers/prompts.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Ralph Prompt Utilities
+ *
+ * Prompts used by the Ralph plan → orchestrate → review → debug loop:
+ *   - buildPlannerPrompt:           initial planning OR re-planning from a debugger report
+ *   - buildOrchestratorPrompt:      spawn workers to execute the task list
+ *   - buildInfraDiscoveryPrompts:   prompts for parallel sub-agent infrastructure discovery
+ *   - buildReviewPrompt:            structured code review with injected changeset + discovery context
+ *   - buildDebuggerReportPrompt:    diagnose review findings, produce a re-plan brief
+ *
+ * Plus Zod schemas for structured output, parsing helpers for the reviewer
+ * JSON output, and the debugger markdown report.
+ */
+import { z } from "zod";
+/** Zod schema for a single review finding. */
+export declare const ReviewFindingSchema: z.ZodObject<{
+    title: z.ZodString;
+    body: z.ZodString;
+    confidence_score: z.ZodOptional<z.ZodNumber>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    code_location: z.ZodOptional<z.ZodObject<{
+        absolute_file_path: z.ZodString;
+        line_range: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Zod schema for the full structured review output. */
+export declare const ReviewResultSchema: z.ZodObject<{
+    findings: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        body: z.ZodString;
+        confidence_score: z.ZodOptional<z.ZodNumber>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        code_location: z.ZodOptional<z.ZodObject<{
+            absolute_file_path: z.ZodString;
+            line_range: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    overall_correctness: z.ZodString;
+    overall_explanation: z.ZodString;
+    overall_confidence_score: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** JSON Schema derived from the Zod schema — used by Claude and OpenCode SDKs. */
+export declare const REVIEW_RESULT_JSON_SCHEMA: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+    findings: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        body: z.ZodString;
+        confidence_score: z.ZodOptional<z.ZodNumber>;
+        priority: z.ZodOptional<z.ZodNumber>;
+        code_location: z.ZodOptional<z.ZodObject<{
+            absolute_file_path: z.ZodString;
+            line_range: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    overall_correctness: z.ZodString;
+    overall_explanation: z.ZodString;
+    overall_confidence_score: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/** Result from a reviewer stage with structured output support. */
+export interface StructuredReviewResult {
+    /** Parsed and filtered review from SDK structured output, or null if unavailable */
+    structured: ReviewResult | null;
+    /** Raw text output for fallback parsing and debugger input */
+    raw: string;
+}
+/**
+ * Merge two parallel reviewer results into one.
+ *
+ * Two independent reviewers run the same prompt simultaneously. This function
+ * unions their findings and picks the more conservative overall_correctness.
+ * When either reviewer's structured output is unavailable, it falls back to
+ * text parsing ({@link parseReviewResult}) before merging.
+ */
+export declare function mergeReviewResults(a: StructuredReviewResult, b: StructuredReviewResult): StructuredReviewResult;
+export interface PlannerContext {
+    /** 1-indexed loop iteration. Iteration 1 = initial plan; >1 = re-plan. */
+    iteration: number;
+    /** Markdown report from the previous iteration's debugger sub-agent. */
+    debuggerReport?: string;
+}
+/**
+ * Build the planner prompt. The first iteration decomposes the original spec;
+ * subsequent iterations decompose the work needed to resolve the debugger
+ * report from the previous loop iteration.
+ */
+export declare function buildPlannerPrompt(spec: string, context?: PlannerContext): string;
+export interface OrchestratorContext {
+    /**
+     * Trailing commentary from the planner's last assistant message, if any.
+     * The Copilot and OpenCode workflows create a fresh session for each
+     * sub-agent, so the planner's in-session output is NOT automatically
+     * visible to the orchestrator — only what the planner persisted via
+     * `TaskCreate`. Forward the planner's final text here so the orchestrator
+     * sees any caveats, risks, or execution hints that didn't fit into task
+     * bodies.
+     */
+    plannerNotes?: string;
+}
+/**
+ * Build the orchestrator prompt. The orchestrator retrieves the planner's
+ * task list, validates the dependency graph, and spawns parallel workers.
+ *
+ * @param spec - The original user specification. Required because the
+ *   orchestrator runs in a fresh session on Copilot/OpenCode and needs the
+ *   end-user goal to resolve ambiguous tasks.
+ * @param context - Optional planner handoff context (trailing commentary).
+ */
+export declare function buildOrchestratorPrompt(spec: string, context?: OrchestratorContext): string;
+/** Prompts for the three parallel infrastructure-discovery sub-agents. */
+export interface InfraDiscoveryPrompts {
+    /** Prompt for the codebase-locator sub-agent. */
+    locator: string;
+    /** Prompt for the codebase-analyzer sub-agent. */
+    analyzer: string;
+    /** Prompt for the codebase-pattern-finder sub-agent. */
+    patternFinder: string;
+}
+/**
+ * Build prompts for three parallel sub-agent stages that discover the
+ * repository's build, test, lint, and CI infrastructure. Each sub-agent
+ * explores the codebase dynamically — no hard-coded file lists or patterns.
+ *
+ * Inspired by the deep-research-codebase workflow which dispatches
+ * codebase-locator, codebase-analyzer, and codebase-pattern-finder
+ * sub-agents in parallel for exploratory research.
+ */
+export declare function buildInfraDiscoveryPrompts(): InfraDiscoveryPrompts;
+/** A single finding from the reviewer sub-agent. */
+export interface ReviewFinding {
+    title: string;
+    body: string;
+    confidence_score?: number;
+    priority?: number;
+    code_location?: {
+        absolute_file_path: string;
+        line_range: {
+            start: number;
+            end: number;
+        };
+    };
+}
+/** Parsed reviewer JSON output. */
+export interface ReviewResult {
+    findings: ReviewFinding[];
+    overall_correctness: string;
+    overall_explanation: string;
+    overall_confidence_score?: number;
+}
+export interface ReviewContext {
+    /**
+     * Full branch changeset captured by {@link captureBranchChangeset}.
+     * Contains diff stat, name-status, and uncommitted changes relative to
+     * the parent branch — giving the reviewer complete visibility into every
+     * change this branch introduces.
+     */
+    changeset: {
+        baseBranch: string;
+        diffStat: string;
+        uncommitted: string;
+        nameStatus: string;
+        errors: string[];
+    };
+    /** 1-indexed loop iteration, used in the prompt header. */
+    iteration?: number;
+    /**
+     * When true, instructs the reviewer to call the `submit_review` tool
+     * instead of outputting JSON directly. Used by the Copilot SDK which
+     * achieves structured output through tool definitions.
+     */
+    useSubmitTool?: boolean;
+    /**
+     * Raw output from the parallel infrastructure-discovery sub-agents
+     * (codebase-locator, codebase-analyzer, codebase-pattern-finder).
+     * When present, the reviewer uses this to identify and run the
+     * repository's build/test/lint commands as part of verification.
+     */
+    discoveryContext?: string;
+}
+/**
+ * Build the reviewer prompt. Injects a deterministic branch-relative
+ * changeset so the reviewer sees every file this branch has touched —
+ * both committed and uncommitted — without expensive tool calls.
+ */
+export declare function buildReviewPrompt(spec: string, context: ReviewContext): string;
+export interface DebuggerContext {
+    /** 1-indexed loop iteration the debugger is investigating. */
+    iteration: number;
+    /**
+     * Branch changeset captured immediately before the review. Provides the
+     * debugger with the same file-level context as the reviewer.
+     */
+    changeset: {
+        baseBranch: string;
+        diffStat: string;
+        uncommitted: string;
+        nameStatus: string;
+        errors: string[];
+    };
+}
+/**
+ * Build a prompt asking the debugger sub-agent to investigate a set of review
+ * findings and produce a structured report. The debugger MUST NOT apply
+ * fixes — its only deliverable is the report, which the next iteration's
+ * planner consumes.
+ */
+export declare function buildDebuggerReportPrompt(review: ReviewResult | null, rawReview: string, context: DebuggerContext): string;
+/**
+ * Parse the reviewer's JSON output. Tries, in order:
+ *   1. Direct JSON.parse on the entire content.
+ *   2. The LAST fenced ```json (or unlabelled) code block.
+ *   3. The LAST balanced object containing a "findings" key in surrounding prose.
+ *
+ * Filters out P3 (minor/style) findings — only P0/P1/P2 count as actionable.
+ * Returns null when no parse strategy succeeds.
+ */
+export declare function parseReviewResult(content: string): ReviewResult | null;
+export declare function filterActionable(parsed: {
+    findings: ReviewFinding[];
+    overall_correctness: string;
+    overall_explanation?: string;
+    overall_confidence_score?: number;
+}): ReviewResult;
+/**
+ * Extract the LAST fenced ```markdown block from a piece of text. Used for
+ * parsing the debugger's structured report out of a long Claude pane
+ * scrollback or any other output that may include extra prose.
+ *
+ * Falls back to the trimmed full input when no fenced block is present, so
+ * the planner still receives the debugger's content even if formatting drifts.
+ */
+export declare function extractMarkdownBlock(content: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/sdk/workflows/builtin/ralph/helpers/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/helpers/prompts.ts"],"names":[],"mappings":"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"}

package/dist/sdk/workflows/builtin/ralph/helpers/review.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Review analysis helpers for the Ralph workflow.
+ *
+ * Simplified versions of the internal conductor-based helpers,
+ * operating on direct values instead of StageOutput maps.
+ */
+import type { ReviewResult } from "./prompts.ts";
+/**
+ * Check whether the reviewer produced actionable findings.
+ *
+ * Returns true when:
+ * 1. The parsed ReviewResult has one or more findings, OR
+ * 2. The review could not be parsed (null) but the raw response
+ *    text is non-empty (treat unparseable output as actionable).
+ *
+ * @param review  - Parsed ReviewResult, or null if parsing failed.
+ * @param rawText - The raw reviewer response text.
+ */
+export declare function hasActionableFindings(review: ReviewResult | null, rawText: string): boolean;
+//# sourceMappingURL=review.d.ts.map

package/dist/sdk/workflows/builtin/ralph/helpers/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/helpers/review.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAQT"}

package/dist/sdk/workflows/builtin/ralph/opencode/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Ralph workflow for OpenCode — plan → orchestrate → review → debug loop.
+ *
+ * Each sub-agent invocation spawns its own visible session in the graph,
+ * so users can see each iteration's progress in real time. The loop
+ * terminates when:
+ *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - Two parallel reviewer passes both return zero findings.
+ *
+ * The reviewer stages use the OpenCode SDK's structured output
+ * (`format: { type: "json_schema" }`) to guarantee the review result
+ * matches the {@link ReviewResultSchema}.
+ *
+ * Run: atomic workflow -n ralph -a opencode "<your spec>"
+ */
+declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", "prompt">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/ralph/opencode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;AAqDH,wBA4La"}

package/dist/sdk/workflows/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * atomic/workflows
+ *
+ * Workflow SDK for defining dynamic agent workflows.
+ * Workflows use defineWorkflow().run().compile() with ctx.stage()
+ * for spawning agent sessions using native TypeScript control flow.
+ */
+export { defineWorkflow, WorkflowBuilder } from "../define-workflow.ts";
+export type { AgentType, ValidationWarning, Transcript, SavedMessage, SaveTranscript, SessionContext, SessionRef, SessionHandle, SessionRunOptions, WorkflowContext, WorkflowOptions, WorkflowDefinition, WorkflowInput, WorkflowInputType, StageClientOptions, StageSessionOptions, ProviderClient, ProviderSession, CopilotClient, CopilotClientOptions, CopilotSession, CopilotSessionConfig, OpencodeClient, OpencodeSession, ClaudeClientWrapper, ClaudeSessionWrapper, ClaudeQueryDefaults, } from "../types.ts";
+export type { SessionEvent as CopilotSessionEvent } from "@github/copilot-sdk";
+export type { SessionPromptResponse as OpenCodePromptResponse } from "@opencode-ai/sdk/v2";
+export type { SessionMessage as ClaudeSessionMessage } from "@anthropic-ai/claude-agent-sdk";
+export { createClaudeSession, claudeQuery, clearClaudeSession, extractAssistantText, validateClaudeWorkflow } from "../providers/claude.ts";
+export type { ClaudeSessionOptions, ClaudeQueryOptions } from "../providers/claude.ts";
+export { validateCopilotWorkflow } from "../providers/copilot.ts";
+export { validateOpenCodeWorkflow } from "../providers/opencode.ts";
+export type { TmuxResult, TmuxSession, SessionType } from "../runtime/tmux.ts";
+export { SOCKET_NAME, isTmuxInstalled, getMuxBinary, resetMuxBinaryCache, isInsideTmux, isInsideAtomicSocket, createSession, createWindow, createPane, sendLiteralText, sendSpecialKey, sendKeysAndSubmit, capturePane, capturePaneVisible, capturePaneScrollback, killSession, killWindow, sessionExists, listSessions, attachSession, spawnMuxAttach, switchClient, getCurrentSession, attachOrSwitch, detachAndAttachAtomic, selectWindow, setSessionEnv, getSessionEnv, parseSessionName, waitForOutput, tmuxRun, normalizeTmuxCapture, normalizeTmuxLines, paneLooksReady, paneHasActiveTask, paneIsIdle, waitForPaneReady, attemptSubmitRounds, } from "../runtime/tmux.ts";
+export { AGENTS, discoverWorkflows, findWorkflow, loadWorkflowsMetadata, WORKFLOWS_GITIGNORE, } from "../runtime/discovery.ts";
+export type { DiscoveredWorkflow, WorkflowWithMetadata, } from "../runtime/discovery.ts";
+export { WorkflowLoader } from "../runtime/loader.ts";
+export { executeWorkflow } from "../runtime/executor.ts";
+export type { WorkflowRunOptions } from "../runtime/executor.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5I,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/services/config/definitions.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Agent configuration definitions for atomic CLI
+ */
+export interface AgentConfig {
+    /** Display name for the agent */
+    name: string;
+    /** Command to execute the agent */
+    cmd: string;
+    /** Flags used when spawning the agent in interactive chat mode */
+    chat_flags: string[];
+    /** Environment variables to set when spawning the agent (merged with process env) */
+    env_vars: Record<string, string>;
+    /** Config folder relative to repo root */
+    folder: string;
+    /** URL for installation instructions */
+    install_url: string;
+    /** Paths to exclude when copying (relative to folder) */
+    exclude: string[];
+    /** Project files managed by `atomic init` for provider onboarding */
+    onboarding_files: Array<{
+        source: string;
+        destination: string;
+        merge: boolean;
+    }>;
+}
+declare const AGENT_KEYS: readonly ["claude", "opencode", "copilot"];
+export type AgentKey = (typeof AGENT_KEYS)[number];
+export declare const AGENT_CONFIG: Record<AgentKey, AgentConfig>;
+export declare function isValidAgent(key: string): key is AgentKey;
+export declare function getAgentConfig(key: AgentKey): AgentConfig;
+export declare function getAgentKeys(): AgentKey[];
+/**
+ * Source Control Management (SCM) configuration definitions
+ */
+/** SCM keys for iteration */
+declare const SCM_KEYS: readonly ["github", "sapling"];
+/** Supported source control types — derived from SCM_KEYS tuple. */
+export type SourceControlType = (typeof SCM_KEYS)[number];
+export interface ScmConfig {
+    /** Internal identifier */
+    name: string;
+    /** Display name for prompts */
+    displayName: string;
+    /** Primary CLI tool (git or sl) */
+    cliTool: string;
+    /** Code review tool (gh, jf submit, arc diff, etc.) */
+    reviewTool: string;
+    /** Code review system (github, phabricator) */
+    reviewSystem: string;
+    /** Directory marker for potential future auto-detection */
+    detectDir: string;
+    /** Code review command file name */
+    reviewCommandFile: string;
+    /** Required configuration files */
+    requiredConfigFiles?: string[];
+}
+export declare const SCM_CONFIG: Record<SourceControlType, ScmConfig>;
+/** Commands that have SCM-specific variants */
+export declare const SCM_SPECIFIC_COMMANDS: string[];
+/**
+ * SCM-variant skill names, grouped by source control type.
+ *
+ * These are the skills that `installGlobalSkills` removes from the global
+ * scope after the initial install, and that `installLocalScmSkills`
+ * re-installs per-project based on the user's selected SCM. Passed to
+ * `npx skills add --skill <name>` as explicit names (the skills CLI does
+ * not support glob patterns like `gh-*`).
+ */
+export declare const SCM_SKILLS_BY_TYPE: Record<SourceControlType, readonly string[]>;
+/** Flat list of every SCM-variant skill across all source control types. */
+export declare const ALL_SCM_SKILLS: readonly string[];
+/**
+ * Get all SCM keys for iteration
+ */
+export declare function getScmKeys(): SourceControlType[];
+/**
+ * Check if a string is a valid SCM type
+ */
+export declare function isValidScm(key: string): key is SourceControlType;
+/**
+ * Get the configuration for a specific SCM type
+ */
+export declare function getScmConfig(key: SourceControlType): ScmConfig;
+export {};
+//# sourceMappingURL=definitions.d.ts.map

package/dist/services/config/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/services/config/definitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,gBAAgB,EAAE,KAAK,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,QAAA,MAAM,UAAU,4CAA6C,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAyEtD,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,QAAQ,CAEzD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAEzD;AAED,wBAAgB,YAAY,IAAI,QAAQ,EAAE,CAEzC;AAED;;GAEG;AAEH,6BAA6B;AAC7B,QAAA,MAAM,QAAQ,gCAAiC,CAAC;AAEhD,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,iBAAiB,EAAE,SAAS,CAoB3D,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,UAAa,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAIzE,CAAC;AAEJ,4EAA4E;AAC5E,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAG3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,IAAI,iBAAiB,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAEhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,CAE9D"}

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

@@ -0,0 +1,77 @@
+/**
+ * Utilities for copying directories and files with exclusions
+ */
+/**
+ * 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[];
+    /** 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.
+ */
+export declare function shouldExclude(relativePath: string, name: string, exclude: string[]): 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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/services/system/copy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;;;;;;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,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;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAsBT;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

@@ -0,0 +1,75 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.12-5",
+  "version": "0.5.13-0",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",
@@ -41,6 +41,7 @@
   },
   "files": [
     "src",
+    "dist",
     "assets/settings.schema.json",
     ".agents/skills",
     ".claude/agents",