@bastani/atomic 0.5.11 → 0.5.12-0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.11",
+  "version": "0.5.12-0",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",
@@ -41,9 +41,8 @@
   },
   "files": [
     "src",
-    "dist",
-    "tsconfig.json",
     "assets/settings.schema.json",
+    ".agents/skills",
     ".claude/agents",
     ".opencode/agents",
     ".github/agents",
@@ -67,18 +66,18 @@
     "@types/bun": "^1.3.12",
     "@types/react": "^19.2.14",
     "lefthook": "^2.1.5",
-    "oxlint": "^1.59.0",
+    "oxlint": "^1.60.0",
     "typescript": "^6.0.2",
     "typescript-language-server": "^5.1.3"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.104",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.105",
     "@clack/prompts": "^1.2.0",
     "@commander-js/extra-typings": "^14.0.0",
     "@github/copilot-sdk": "^0.2.2",
     "@opencode-ai/sdk": "^1.4.3",
-    "@opentui/core": "^0.1.97",
-    "@opentui/react": "^0.1.97",
+    "@opentui/core": "^0.1.99",
+    "@opentui/react": "^0.1.99",
     "commander": "^14.0.3",
     "ignore": "^7.0.5",
     "react": "^19.2.5",

package/src/commands/cli/init/index.ts

@@ -244,7 +244,7 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
     // Best-effort template copy: source checkouts still carry the bundled
     // gh-*/sl-* skill templates, but binary and npm installs no longer do
     // (they live in the skills CLI repo). `installLocalScmSkills` below
-    // handles the binary/npm case by invoking `npx skills add` — so a zero
+    // handles the binary/npm case by invoking `bunx skills add` — so a zero
     // copy here is not an error, just a signal that the template isn't
     // bundled for this install type.
     await syncProjectScmSkills({
@@ -273,7 +273,7 @@ export async function initCommand(options: InitOptions = {}): Promise<void> {
     s.stop(paint("success", "✓", { bold: true }) + " Skills configured");
 
     // Install SCM-specific skill variants locally for the active agent via
-    // `npx skills add` (best-effort: a failure is surfaced as a warning).
+    // `bunx skills add` (best-effort: a failure is surfaced as a warning).
     //
     // Source checkouts already have the bundled skills on disk and the
     // template-copy above has placed the selected variants into `targetDir`;

package/src/commands/cli/init/scm.ts

@@ -113,7 +113,7 @@ export async function syncProjectScmSkills(options: SyncProjectScmSkillsOptions)
   return copiedCount;
 }
 
-/** Skills-CLI agent identifiers (match `npx skills -a <value>`). */
+/** Skills-CLI agent identifiers (match `bunx skills -a <value>`). */
 const SKILLS_AGENT_BY_KEY: Record<AgentKey, string> = {
   claude: "claude-code",
   opencode: "opencode",
@@ -125,7 +125,7 @@ const SKILLS_REPO = "https://github.com/flora131/atomic.git";
 export interface InstallLocalScmSkillsOptions {
   scmType: SourceControlType;
   agentKey: AgentKey;
-  /** The directory to run `npx skills add` in (the project root). */
+  /** The directory to run `bunx skills add` in (the project root). */
   cwd: string;
 }
 
@@ -139,7 +139,7 @@ export interface InstallLocalScmSkillsResult {
 
 /**
  * Install the SCM skill variants (e.g. `gh-commit`, `gh-create-pr` for
- * GitHub) locally into the current project via `npx skills add`. The `-g`
+ * GitHub) locally into the current project via `bunx skills add`. The `-g`
  * flag is intentionally omitted so the skills are installed per-project
  * (in the given `cwd`).
  *
@@ -157,9 +157,9 @@ export async function installLocalScmSkills(
 
   const skills = SCM_SKILLS_BY_TYPE[scmType];
 
-  const npxPath = Bun.which("npx");
-  if (!npxPath) {
-    return { success: false, skills, details: "npx not found on PATH" };
+  const bunxPath = Bun.which("bunx");
+  if (!bunxPath) {
+    return { success: false, skills, details: "bunx not found on PATH" };
   }
 
   const agentFlag = SKILLS_AGENT_BY_KEY[agentKey];
@@ -168,8 +168,7 @@ export async function installLocalScmSkills(
   try {
     const proc = Bun.spawn({
       cmd: [
-        npxPath,
-        "--yes",
+        bunxPath,
         "skills",
         "add",
         SKILLS_REPO,

package/src/commands/cli/workflow-command.test.ts

@@ -288,6 +288,54 @@ describe("workflowCommand --list", () => {
     expect(cap.stdout).not.toContain("copilot-only");
   });
 
+  test("excludes workflows missing .compile() from the list", async () => {
+    await writeCompiledWorkflow({ name: "good", agent: "copilot" });
+    await writeCompiledWorkflow({
+      name: "not-compiled",
+      agent: "copilot",
+      source: `
+import { defineWorkflow } from "${join(process.cwd(), "src/sdk/workflows/index.ts")}";
+
+export default defineWorkflow({ name: "not-compiled" })
+  .run(async () => {});
+// intentionally missing .compile()
+`,
+    });
+
+    const cap = captureOutput();
+    const code = await workflowCommand({
+      list: true,
+      agent: "copilot",
+      cwd: tempDir,
+    });
+    cap.restore();
+
+    expect(code).toBe(0);
+    expect(cap.stdout).toContain("good");
+    expect(cap.stdout).not.toContain("not-compiled");
+  });
+
+  test("excludes workflows with type errors from the list", async () => {
+    await writeCompiledWorkflow({ name: "valid", agent: "copilot" });
+    await writeCompiledWorkflow({
+      name: "broken-syntax",
+      agent: "copilot",
+      source: `this is not valid typescript }{}{`,
+    });
+
+    const cap = captureOutput();
+    const code = await workflowCommand({
+      list: true,
+      agent: "copilot",
+      cwd: tempDir,
+    });
+    cap.restore();
+
+    expect(code).toBe(0);
+    expect(cap.stdout).toContain("valid");
+    expect(cap.stdout).not.toContain("broken-syntax");
+  });
+
   test("renders the empty state when no workflows exist and no agent filter is set", async () => {
     // No agent filter + a fresh tempdir means `discoverWorkflows` only
     // returns builtins for whichever agents exist on disk; to exercise
@@ -382,6 +430,32 @@ describe("workflowCommand named-mode error paths", () => {
     expect(executeWorkflowMock).not.toHaveBeenCalled();
   });
 
+  test("available workflows hint excludes uncompiled workflows", async () => {
+    await writeCompiledWorkflow({ name: "real-one", agent: "copilot" });
+    await writeCompiledWorkflow({
+      name: "uncompiled",
+      agent: "copilot",
+      source: `
+import { defineWorkflow } from "${join(process.cwd(), "src/sdk/workflows/index.ts")}";
+
+export default defineWorkflow({ name: "uncompiled" })
+  .run(async () => {});
+`,
+    });
+
+    const cap = captureOutput();
+    const code = await workflowCommand({
+      name: "does-not-exist",
+      agent: "copilot",
+      cwd: tempDir,
+    });
+    cap.restore();
+
+    expect(code).toBe(1);
+    expect(cap.stderr).toContain("real-one");
+    expect(cap.stderr).not.toContain("uncompiled");
+  });
+
   test("parse errors in passthrough args abort before loading", async () => {
     await writeCompiledWorkflow({ name: "parse-err", agent: "copilot" });
 

package/src/commands/cli/workflow.ts

@@ -198,11 +198,14 @@ export async function workflowCommand(options: {
   // merge modes inside `discoverWorkflows`, so shadowed local/global
   // workflows never reach the renderer.
   if (options.list) {
-    const workflows = await discoverWorkflows(
+    const discovered = await discoverWorkflows(
       cwd,
       options.agent as AgentType | undefined,
       { merge: false },
     );
+    // Filter out workflows that fail to load (type errors, missing
+    // .compile(), etc.) so the list only shows workflows ready to run.
+    const workflows = await loadWorkflowsMetadata(discovered);
     process.stdout.write(renderWorkflowList(workflows));
     return 0;
   }
@@ -440,7 +443,9 @@ async function runNamedMode(
       `  ~/.atomic/workflows/${name}/${agent}/index.ts ${COLORS.dim}(global)${COLORS.reset}`,
     );
 
-    const available = await discoverWorkflows(cwd, agent);
+    const available = await loadWorkflowsMetadata(
+      await discoverWorkflows(cwd, agent),
+    );
     if (available.length > 0) {
       console.error(`\nAvailable ${agent} workflows:`);
       for (const wf of available) {

package/src/scripts/bundle-configs.ts

@@ -0,0 +1,128 @@
+#!/usr/bin/env bun
+/**
+ * Bundle global configs for a release.
+ *
+ * Installs curated skills globally, copies bundled agent definitions to
+ * each agent's global config root, and packages everything into a zip
+ * archive suitable for attaching to a GitHub Release.
+ *
+ * Usage:
+ *   bun run src/scripts/bundle-configs.ts <version> [output-dir]
+ *
+ * <version>     Semver string (e.g. 0.4.47 or 0.4.47-0).
+ * [output-dir]  Directory for the zip file. Defaults to $GITHUB_WORKSPACE
+ *               or the current directory.
+ */
+
+import { $ } from "bun";
+import { cpSync, existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+
+const ROOT = resolve(import.meta.dir, "../..");
+const HOME = homedir();
+
+/** Source repo for the global skills install. */
+const SKILLS_REPO = "https://github.com/flora131/atomic.git";
+
+/** Skills excluded from the global install (VCS-specific commit/PR helpers). */
+const EXCLUDED_SKILLS = [
+  "gh-commit",
+  "gh-create-pr",
+  "sl-commit",
+  "sl-submit-diff",
+];
+
+/** Agent CLI flags accepted by `bunx skills`. */
+const AGENT_FLAGS = ["claude-code", "opencode", "github-copilot"];
+
+/**
+ * Local config root (in repo) → global root (~/) for each agent.
+ * Copilot uses `.github` locally but `.copilot` globally.
+ */
+const AGENT_ROOTS = {
+  claude: { local: ".claude", global: ".claude" },
+  opencode: { local: ".opencode", global: ".opencode" },
+  copilot: { local: ".github", global: ".copilot" },
+} as const;
+
+/** Paths included in the zip archive (relative to $HOME). */
+const ZIP_INCLUDES = [
+  ".agents/skills",
+  ".claude/agents",
+  ".claude/skills",
+  ".opencode/agents",
+  ".copilot/agents",
+  ".copilot/lsp-config.json",
+];
+
+// ── Steps ──────────────────────────────────────────────────────────────────
+
+async function installGlobalSkills(): Promise<void> {
+  console.log("Installing global skills…");
+
+  const agentArgs = AGENT_FLAGS.flatMap((a) => ["-a", a]);
+
+  await $`bunx skills add ${SKILLS_REPO} --skill "*" -g ${agentArgs} -y`;
+
+  const removeArgs = EXCLUDED_SKILLS.flatMap((s) => ["--skill", s]);
+  await $`bunx skills remove ${removeArgs} -g ${agentArgs} -y`;
+}
+
+async function copyBundledAgents(): Promise<void> {
+  console.log("Copying bundled agents to global roots…");
+
+  for (const [agent, { local, global: globalDir }] of Object.entries(
+    AGENT_ROOTS,
+  )) {
+    const src = join(ROOT, local, "agents");
+    const dest = join(HOME, globalDir, "agents");
+
+    mkdirSync(dest, { recursive: true });
+    cpSync(src, dest, { recursive: true });
+    console.log(`  ${agent}: ${src} → ${dest}`);
+  }
+
+  const lspSrc = join(ROOT, ".github", "lsp.json");
+  if (existsSync(lspSrc)) {
+    const lspDest = join(HOME, AGENT_ROOTS.copilot.global, "lsp-config.json");
+    cpSync(lspSrc, lspDest);
+    console.log(`  copilot: lsp.json → ${lspDest}`);
+  }
+}
+
+async function packageZip(
+  version: string,
+  outputDir: string,
+): Promise<string> {
+  const zipName = `atomic-configs-v${version}.zip`;
+  const zipPath = resolve(outputDir, zipName);
+
+  console.log(`Packaging ${zipName}…`);
+  await $`cd ${HOME} && zip -r ${zipPath} ${ZIP_INCLUDES} -x '*.DS_Store'`.quiet();
+  console.log(`  → ${zipPath}`);
+
+  return zipPath;
+}
+
+// ── Main ───────────────────────────────────────────────────────────────────
+
+async function main(): Promise<void> {
+  const version = process.argv[2]?.replace(/^v/, "");
+  const outputDir = process.argv[3] ?? process.env.GITHUB_WORKSPACE ?? ".";
+
+  if (!version) {
+    console.error(
+      "Usage: bun run src/scripts/bundle-configs.ts <version> [output-dir]",
+    );
+    process.exit(1);
+  }
+
+  await installGlobalSkills();
+  await copyBundledAgents();
+  await packageZip(version, outputDir);
+
+  console.log("\nDone.");
+}
+
+main();

package/src/sdk/components/compact-switcher.tsx

@@ -34,7 +34,7 @@ export function CompactSwitcher({ selectedIndex }: CompactSwitcherProps) {
     >
       {/* Header */}
       <box height={1} flexDirection="row" paddingLeft={1} paddingRight={1}>
-        <text fg={theme.textDim}>agents</text>
+        <text fg={theme.textDim}>stages</text>
         <box flexGrow={1} />
         <text fg={theme.textDim}>{headerHint}</text>
       </box>

package/src/sdk/components/orchestrator-panel-store.ts

@@ -17,6 +17,9 @@ export class PanelStore {
   exitResolve: (() => void) | null = null;
   abortResolve: (() => void) | null = null;
 
+  /** Number of background tasks/headless stages currently running. */
+  backgroundTaskCount = 0;
+
   /** Current view mode — graph overview or attached to a specific agent. */
   viewMode: ViewMode = "graph";
   /** ID of the agent currently attached to (only meaningful when viewMode === "attached"). */
@@ -113,6 +116,16 @@ export class PanelStore {
     this.emit();
   }
 
+  incrementBackgroundTasks(): void {
+    this.backgroundTaskCount++;
+    this.emit();
+  }
+
+  decrementBackgroundTasks(): void {
+    this.backgroundTaskCount = Math.max(0, this.backgroundTaskCount - 1);
+    this.emit();
+  }
+
   /**
    * Switch between graph and attached view modes.
    * When switching to "attached", provide the agent ID to attach to.

package/src/sdk/components/orchestrator-panel.tsx

@@ -122,6 +122,16 @@ export class OrchestratorPanel {
     });
   }
 
+  /** Increment the background task counter (shown in the statusline footer). */
+  backgroundTaskStarted(): void {
+    this.store.incrementBackgroundTasks();
+  }
+
+  /** Decrement the background task counter (shown in the statusline footer). */
+  backgroundTaskFinished(): void {
+    this.store.decrementBackgroundTasks();
+  }
+
   /** Show the workflow-complete banner with a link to saved transcripts. */
   showCompletion(workflowName: string, transcriptsPath: string): void {
     this.store.setCompletion(workflowName, transcriptsPath);

package/src/sdk/components/statusline.tsx

@@ -37,6 +37,18 @@ export function Statusline({
         </box>
       ) : null}
 
+      {store.backgroundTaskCount > 0 ? (
+        <box backgroundColor="transparent" paddingLeft={1} alignItems="center">
+          <text>
+            <span fg={theme.textDim}>{"\u00B7"} </span>
+            <span fg={theme.warning}>{"\u25C6"} </span>
+            <span fg={theme.textMuted}>
+              {store.backgroundTaskCount} background
+            </span>
+          </text>
+        </box>
+      ) : null}
+
       <box flexGrow={1} />
 
       {/* Navigation hints — always graph-mode (tmux status bar handles attached-mode hints) */}
@@ -54,7 +66,7 @@ export function Statusline({
             <span fg={theme.textMuted}> attach</span>
             <span fg={theme.textDim}> {"\u00B7"} </span>
             <span fg={theme.text}>/</span>
-            <span fg={theme.textMuted}> agents</span>
+            <span fg={theme.textMuted}> stages</span>
             <span fg={theme.textDim}> {"\u00B7"} </span>
             <span fg={theme.text}>q</span>
             <span fg={theme.textMuted}> quit</span>

package/src/sdk/providers/claude.ts

@@ -588,6 +588,48 @@ export class ClaudeSessionWrapper {
   async disconnect(): Promise<void> {}
 }
 
+// ---------------------------------------------------------------------------
+// Headless wrappers — use the Agent SDK directly (no tmux pane)
+// ---------------------------------------------------------------------------
+
+/**
+ * Headless client wrapper for Claude stages. No tmux pane — noop start/stop.
+ * Used when `options.headless` is true in `ctx.stage()`.
+ */
+export class HeadlessClaudeClientWrapper {
+  async start(): Promise<void> {}
+  async stop(): Promise<void> {}
+}
+
+/**
+ * Headless session wrapper for Claude stages. Uses the Agent SDK's `query()`
+ * directly instead of tmux pane operations. Implements the same `query()`
+ * interface as {@link ClaudeSessionWrapper} so workflow callbacks work
+ * identically for headless and interactive stages.
+ */
+export class HeadlessClaudeSessionWrapper {
+  readonly paneId = "";
+  readonly sessionId: string;
+
+  constructor(sessionId: string) {
+    this.sessionId = sessionId;
+  }
+
+  async query(prompt: string): Promise<ClaudeQueryResult> {
+    const { query } = await import("@anthropic-ai/claude-agent-sdk");
+    let output = "";
+    for await (const msg of query({ prompt })) {
+      if (msg.type === "result") {
+        // SDKResultSuccess has `result: string`, not `output`.
+        output = String((msg as Record<string, unknown>).result ?? "");
+      }
+    }
+    return { output, delivered: true };
+  }
+
+  async disconnect(): Promise<void> {}
+}
+
 // ---------------------------------------------------------------------------
 // Static source validation
 // ---------------------------------------------------------------------------