@bastani/atomic 0.6.3 → 0.6.4

package/.agents/skills/ripgrep/SKILL.md

@@ -0,0 +1,382 @@
+---
+name: ripgrep
+description: Use when searching text in files, codebases, books, or documents. Use when finding files by pattern, searching large files that are too big to read fully, extracting specific content from many files, or when grep/find is too slow. Triggers on "search for", "find occurrences", "look for pattern", "search in files".
+---
+
+# Ripgrep (rg) - Fast Text Search Tool
+
+## Overview
+
+Ripgrep is a line-oriented search tool that recursively searches directories for regex patterns. It's **10-100x faster than grep** and respects `.gitignore` by default. Use it instead of grep, find, or manually reading large files.
+
+**Core principle:** When you need to find text in files, use ripgrep. Don't read entire files into context when you can search them.
+
+## When to Use
+
+**Use ripgrep when:**
+- Searching for text patterns across a codebase or directory
+- Finding all occurrences of a function, variable, or string
+- Searching through books, documentation, or large text files
+- Files are too large to read fully into context
+- Looking for specific content in many files at once
+- Finding files that contain (or don't contain) certain patterns
+- Extracting matching lines for analysis
+
+**Don't use when:**
+- You need the full file content (use Read tool)
+- Simple glob pattern matching for filenames only (use Glob tool)
+- You need structured data extraction (consider jq, awk)
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Basic search | `rg "pattern" [path]` |
+| Case insensitive | `rg -i "pattern"` |
+| Smart case (auto) | `rg -S "pattern"` |
+| Whole word only | `rg -w "word"` |
+| Fixed string (no regex) | `rg -F "literal.string"` |
+| Show context lines | `rg -C 3 "pattern"` (3 before & after) |
+| Show line numbers | `rg -n "pattern"` (default in tty) |
+| Only filenames | `rg -l "pattern"` |
+| Files without match | `rg --files-without-match "pattern"` |
+| Count matches | `rg -c "pattern"` |
+| Only matching part | `rg -o "pattern"` |
+| Invert match | `rg -v "pattern"` |
+| Multiline search | `rg -U "pattern.*\nmore"` |
+
+## File Filtering
+
+### By File Type
+
+Ripgrep has built-in file type definitions. Use `-t` to include, `-T` to exclude:
+
+```bash
+# Search only Python files
+rg -t py "def main"
+
+# Search only JavaScript and TypeScript
+rg -t js -t ts "import"
+
+# Exclude test files
+rg -T test "function"
+
+# List all known types
+rg --type-list
+```
+
+**Common types:** `py`, `js`, `ts`, `rust`, `go`, `java`, `c`, `cpp`, `rb`, `php`, `html`, `css`, `json`, `yaml`, `md`, `txt`, `sh`
+
+### By Glob Pattern
+
+```bash
+# Only .tsx files
+rg -g "*.tsx" "useState"
+
+# Exclude node_modules (in addition to gitignore)
+rg -g "!node_modules/**" "pattern"
+
+# Only files in src directory
+rg -g "src/**" "pattern"
+
+# Multiple globs
+rg -g "*.js" -g "*.ts" "pattern"
+
+# Case insensitive globs
+rg --iglob "*.JSON" "pattern"
+```
+
+### By File Size
+
+```bash
+# Skip files larger than 1MB
+rg --max-filesize 1M "pattern"
+```
+
+## Directory Control
+
+```bash
+# Limit depth
+rg --max-depth 2 "pattern"
+
+# Search hidden files (dotfiles)
+rg --hidden "pattern"
+
+# Follow symlinks
+rg -L "pattern"
+
+# Ignore all ignore files (.gitignore, etc.)
+rg --no-ignore "pattern"
+
+# Progressive unrestricted (-u can stack up to 3 times)
+rg -u "pattern"      # --no-ignore
+rg -uu "pattern"     # --no-ignore --hidden
+rg -uuu "pattern"    # --no-ignore --hidden --binary
+```
+
+## Context Options
+
+```bash
+# Lines after match
+rg -A 5 "pattern"
+
+# Lines before match
+rg -B 5 "pattern"
+
+# Lines before and after
+rg -C 5 "pattern"
+
+# Print entire file on match (passthrough mode)
+rg --passthru "pattern"
+```
+
+## Output Formats
+
+```bash
+# Just filenames with matches
+rg -l "pattern"
+
+# Files without matches
+rg --files-without-match "pattern"
+
+# Count matches per file
+rg -c "pattern"
+
+# Count total matches (not lines)
+rg --count-matches "pattern"
+
+# Only the matched text (not full line)
+rg -o "pattern"
+
+# JSON output (for parsing)
+rg --json "pattern"
+
+# Vim-compatible output (file:line:col:match)
+rg --vimgrep "pattern"
+
+# With statistics
+rg --stats "pattern"
+```
+
+## Regex Patterns
+
+Ripgrep uses Rust regex syntax by default:
+
+```bash
+# Alternation
+rg "foo|bar"
+
+# Character classes
+rg "[0-9]+"
+rg "[a-zA-Z_][a-zA-Z0-9_]*"
+
+# Word boundaries
+rg "\bword\b"
+
+# Quantifiers
+rg "colou?r"           # 0 or 1
+rg "go+gle"            # 1 or more
+rg "ha*"               # 0 or more
+rg "x{2,4}"            # 2 to 4 times
+
+# Groups
+rg "(foo|bar)baz"
+
+# Lookahead/lookbehind (requires -P for PCRE2)
+rg -P "(?<=prefix)content"
+rg -P "content(?=suffix)"
+```
+
+### Multiline Matching
+
+```bash
+# Enable multiline mode
+rg -U "start.*\nend"
+
+# Dot matches newline too
+rg -U --multiline-dotall "start.*end"
+
+# Match across lines
+rg -U "function\s+\w+\([^)]*\)\s*\{"
+```
+
+## Replacement (Preview Only)
+
+Ripgrep can show what replacements would look like (doesn't modify files):
+
+```bash
+# Simple replacement
+rg "old" -r "new"
+
+# Using capture groups
+rg "(\w+)@(\w+)" -r "$2::$1"
+
+# Remove matches (empty replacement)
+rg "pattern" -r ""
+```
+
+## Searching Special Files
+
+### Compressed Files
+
+```bash
+# Search in gzip, bzip2, xz, lz4, lzma, zstd files
+rg -z "pattern" file.gz
+rg -z "pattern" archive.tar.gz
+```
+
+### Binary Files
+
+```bash
+# Include binary files
+rg --binary "pattern"
+
+# Treat binary as text (may produce garbage)
+rg -a "pattern"
+```
+
+### Large Files
+
+For files too large to read into context:
+
+```bash
+# Search and show only matching lines
+rg "specific pattern" large_file.txt
+
+# Limit matches to first N per file
+rg -m 10 "pattern" huge_file.log
+
+# Show byte offset for large file navigation
+rg -b "pattern" large_file.txt
+
+# Use with head/tail for pagination
+rg "pattern" large_file.txt | head -100
+```
+
+## Performance Tips
+
+1. **Be specific with paths** - Don't search from root when you know the subdir
+2. **Use file types** - `-t py` is faster than `-g "*.py"`
+3. **Use fixed strings** - `-F` when you don't need regex
+4. **Limit depth** - `--max-depth` when you know structure
+5. **Let gitignore work** - Don't use `--no-ignore` unless needed
+6. **Use word boundaries** - `-w` is optimized
+
+## Common Patterns
+
+### Find function definitions
+```bash
+# Python
+rg "def \w+\(" -t py
+
+# JavaScript/TypeScript
+rg "(function|const|let|var)\s+\w+\s*=" -t js -t ts
+rg "^\s*(async\s+)?function" -t js
+
+# Go
+rg "^func\s+\w+" -t go
+```
+
+### Find imports/requires
+```bash
+# Python
+rg "^(import|from)\s+" -t py
+
+# JavaScript
+rg "^(import|require\()" -t js
+
+# Go
+rg "^import\s+" -t go
+```
+
+### Find TODO/FIXME comments
+```bash
+rg "(TODO|FIXME|HACK|XXX):"
+```
+
+### Find error handling
+```bash
+# Python
+rg "except\s+\w+:" -t py
+
+# JavaScript
+rg "\.catch\(|catch\s*\(" -t js
+```
+
+### Find class definitions
+```bash
+# Python
+rg "^class\s+\w+" -t py
+
+# JavaScript/TypeScript
+rg "^(export\s+)?(default\s+)?class\s+\w+" -t js -t ts
+```
+
+### Search in books/documents
+```bash
+# Find chapter headings
+rg "^(Chapter|CHAPTER)\s+\d+" book.txt
+
+# Find quoted text
+rg '"[^"]{20,}"' document.txt
+
+# Find paragraphs containing word
+rg -C 2 "keyword" book.txt
+```
+
+## Combining with Other Tools
+
+```bash
+# Find files, then search
+rg --files | xargs rg "pattern"
+
+# Search and count by file
+rg -c "pattern" | sort -t: -k2 -rn
+
+# Search and open in editor
+rg -l "pattern" | xargs code
+
+# Extract unique matches
+rg -o "\b[A-Z]{2,}\b" | sort -u
+
+# Search multiple patterns from file
+rg -f patterns.txt
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Matches found |
+| 1 | No matches found |
+| 2 | Error occurred |
+
+Useful for scripting:
+```bash
+if rg -q "pattern" file.txt; then
+    echo "Found"
+fi
+```
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Pattern has special chars | Use `-F` for fixed strings or escape: `rg "foo\.bar"` |
+| Can't find hidden files | Add `--hidden` or `-uu` |
+| Missing node_modules | Add `--no-ignore` (but it's usually right to skip) |
+| Regex too complex | Try `-P` for PCRE2 with lookahead/lookbehind |
+| Output too long | Use `-m N` to limit, or `-l` for just filenames |
+| Binary file skipped | Add `--binary` or `-a` for text mode |
+| Need to see full line | Remove `-o` (only-matching) flag |
+
+## When to Prefer Other Tools
+
+| Task | Better Tool |
+|------|-------------|
+| Structured JSON queries | `jq` |
+| Column-based text processing | `awk` |
+| Stream editing/substitution | `sed` (actually modifies files) |
+| Find files by name only | `fd` or `find` |
+| Simple file listing | `ls` or `glob` |
+| Full file content needed | Read tool |

package/.mcp.json

@@ -2,16 +2,15 @@
   "mcpServers": {
     "github": {
       "type": "http",
-      "url": "https://api.githubcopilot.com/mcp"
+      "url": "https://api.githubcopilot.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${GH_TOKEN}"
+      }
     },
     "azure-devops": {
       "type": "stdio",
       "command": "bunx",
-      "args": [
-        "-y",
-        "@azure-devops/mcp",
-        "<your-org>"
-      ]
+      "args": ["-y", "@azure-devops/mcp", "<your-org>"]
     }
   }
 }

package/dist/commands/cli/claude-inflight-hook.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Claude In-Flight Hook command — internal handler for the workflow's
+ * `SubagentStart` / `SubagentStop` / `TeammateIdle` hooks.
+ *
+ * Invoked as:
+ *   atomic _claude-inflight-hook start   (SubagentStart)
+ *   atomic _claude-inflight-hook stop    (SubagentStop)
+ *   atomic _claude-inflight-hook wait    (TeammateIdle)
+ *
+ * `start` / `stop` maintain a directory of one marker file per in-flight
+ * subagent under `~/.atomic/claude-inflight/<root_session_id>/<agent_id>`.
+ * `<root_session_id>` is the stage's top-level Claude session — for nested
+ * subagents (a subagent spawning its own subagent) we resolve the root by
+ * looking up the parent session's mapping, so all descendants of a stage
+ * funnel into the same marker dir.
+ *
+ * `wait` is the focused completion-signal handler used for `TeammateIdle`:
+ * read `session_id` from the payload, await `waitForInflightDrained`, exit
+ * 0. We don't reuse the Stop hook handler here because Stop also writes
+ * `~/.atomic/claude-stop/<session_id>` (which the runtime's `waitForIdle`
+ * watches) and polls queue/release — those are tied to the stage's root
+ * session, and TeammateIdle's `session_id` may be a teammate's session
+ * that the runtime never enqueues to or releases.
+ *
+ * Two consumers gate on the in-flight dir being empty:
+ *
+ *   1. `claudeStopHookCommand` — won't consume the `claude-release` marker
+ *      until in-flight is empty, so Claude itself doesn't exit while
+ *      backgrounded subagents are still running.
+ *
+ *   2. `clearClaudeSession` — calls `waitForInflightDrained` before tearing
+ *      down the pane, so the executor doesn't advance to the next stage
+ *      while the previous stage's subagents still hold FDs/PTYs on the
+ *      atomic tmux server.
+ *
+ * Always exits 0 — a non-zero exit would surface as a hook error in
+ * Claude's transcript, and silent miss + stale-sweep recovery is preferable
+ * to red noise on every workflow run.
+ */
+/**
+ * Shape of the JSON payload Claude pipes to the Subagent / TeammateIdle
+ * lifecycle hooks via stdin.
+ *
+ *   SubagentStart / SubagentStop  → `agent_id` (uuid), `agent_type`
+ *   TeammateIdle                  → `session_id` only (used by `wait` mode)
+ *
+ * `session_id` is the parent Claude session that triggered the event — for
+ * a top-level subagent, that's the stage's root; for a nested subagent,
+ * that's the spawning agent's session, and we look up its root via
+ * `inflightRoots`.
+ *
+ * Extra fields are ignored; missing ones cause a graceful exit-0 no-op.
+ */
+export interface ClaudeInflightHookPayload {
+    session_id: string;
+    hook_event_name?: string;
+    agent_id?: string;
+    agent_type?: string;
+    cwd?: string;
+}
+export type ClaudeInflightHookMode = "start" | "stop" | "wait";
+/**
+ * Handler for the hidden `_claude-inflight-hook` subcommand.
+ *
+ * Always returns 0 — silently swallows all errors. A buggy tracker must
+ * never kill stages.
+ */
+export declare function claudeInflightHookCommand(mode: ClaudeInflightHookMode): Promise<number>;
+/** True when the per-root marker dir is missing or contains no marker files. */
+export declare function inflightDirIsEmpty(rootSessionId: string): Promise<boolean>;
+/**
+ * Remove markers older than `thresholdMs` (default `ATOMIC_INFLIGHT_STALE_MS`
+ * or 2 h). Returns the number of markers reaped. Used by the Stop hook and
+ * `waitForInflightDrained` to recover from subagents that crashed without
+ * firing `SubagentStop`.
+ */
+export declare function sweepStaleInflight(rootSessionId: string, thresholdMs?: number): Promise<number>;
+export interface WaitForInflightOptions {
+    /** How long to wait before giving up. Default 30 minutes. */
+    timeoutMs?: number;
+    /** Poll cadence. Default 100 ms. */
+    pollIntervalMs?: number;
+    /** Stale-marker TTL. Default `ATOMIC_INFLIGHT_STALE_MS` or 2 h. */
+    staleMs?: number;
+}
+/**
+ * Resolve when the per-root marker dir is empty. Sweeps stale markers on
+ * every tick. Resolves silently on timeout — the caller can't usefully
+ * recover, so wedging vs. leaking is the only trade.
+ */
+export declare function waitForInflightDrained(rootSessionId: string, options?: WaitForInflightOptions): Promise<void>;
+/**
+ * Remove the per-root marker dir and any roots-mapping entries that point
+ * at this root. Called by `clearClaudeSession` on stage teardown so
+ * leftovers cannot bleed into a future session that reuses the same id
+ * (UUID collision is astronomically unlikely, but stale-sweep + cleanup
+ * costs nothing).
+ */
+export declare function clearInflightTracking(rootSessionId: string): Promise<void>;
+//# sourceMappingURL=claude-inflight-hook.d.ts.map

package/dist/commands/cli/claude-inflight-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-inflight-hook.d.ts","sourceRoot":"","sources":["../../../src/commands/cli/claude-inflight-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAMH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAsF/D;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA0EjB;AAMD,gFAAgF;AAChF,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhF"}

package/dist/commands/cli/claude-stop-hook.d.ts

@@ -47,6 +47,8 @@ export declare function claudeHookDirs(): {
     hil: string;
     pid: string;
     ready: string;
+    inflight: string;
+    inflightRoots: string;
 };
 /** Options for {@link claudeStopHookCommand}. Primarily used by tests to shrink the wait budget. */
 export interface ClaudeStopHookOptions {

package/dist/commands/cli/claude-stop-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-stop-hook.d.ts","sourceRoot":"","sources":["../../../src/commands/cli/claude-stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAeD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAkBA;AAED,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAsFD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,CAyMjB"}
+{"version":3,"file":"claude-stop-hook.d.ts","sourceRoot":"","sources":["../../../src/commands/cli/claude-stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAYH,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAeD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAgCA;AAED,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAsFD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,CAyNjB"}

package/dist/lib/spawn.d.ts

@@ -65,7 +65,7 @@ export interface EnsureOptions {
  * both packages (or the already-installed @bastani/atomic) share.
  */
 export declare function upgradeGlobalPackages(pkgs: string[]): Promise<void>;
-/** Upgrade @playwright/cli and @llamaindex/liteparse globally in one pass. */
+/** Upgrade @playwright/cli, @llamaindex/liteparse, and @ast-grep/cli globally in one pass. */
 export declare function upgradeGlobalToolPackages(): Promise<void>;
 /**
  * Ensure a terminal multiplexer (tmux on Unix, psmux on Windows) is installed.

package/dist/lib/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/lib/spawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuCjG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUnD;AAMD,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,wBAAgB,sCAAsC,CACpD,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,aAAa,EAAE,CAEjB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAET;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAI9C;AAkHD,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,MAAM,CAAC,YAA2B,GACvC,MAAM,GAAG,IAAI,CAWf;AA0HD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzE;AAED,8EAA8E;AAC9E,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6GpF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoExD;AAED;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD;AAMD,qBAAa,iBAAkB,SAAQ,KAAK;aACd,QAAQ,EAAE,MAAM,EAAE;gBAAlB,QAAQ,EAAE,MAAM,EAAE;CAQ/C;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,GACvC,MAAM,EAAE,CAaV"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/lib/spawn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuCjG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUnD;AAMD,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExE;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,wBAAgB,sCAAsC,CACpD,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,aAAa,EAAE,CAEjB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAET;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAI9C;AAkHD,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,MAAM,CAAC,YAA2B,GACvC,MAAM,GAAG,IAAI,CAWf;AA0HD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUzE;AAED,8FAA8F;AAC9F,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/D;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6GpF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoExD;AAED;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD;AAMD,qBAAa,iBAAkB,SAAQ,KAAK;aACd,QAAQ,EAAE,MAAM,EAAE;gBAAlB,QAAQ,EAAE,MAAM,EAAE;CAQ/C;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,GACvC,MAAM,EAAE,CAaV"}

package/dist/sdk/providers/claude.d.ts

@@ -23,6 +23,19 @@ import { type SessionMessage, type SDKUserMessage, type Options as SDKOptions }
  * waiting out the hook's safety timeout.
  *
  * Called by the runtime when a Claude stage is being torn down. Idempotent.
+ *
+ * After writing the release marker, this waits for the per-session in-flight
+ * marker dir (`~/.atomic/claude-inflight/<session_id>/`) to drain. The
+ * marker dir is populated by the SubagentStart/Stop and TaskCreated/Completed
+ * hooks registered in {@link WORKFLOW_HOOK_SETTINGS}. This wait is the
+ * synchronization barrier that prevents the executor from advancing to the
+ * next stage while the previous stage's backgrounded subagents/tasks still
+ * hold FDs/PTYs on the atomic tmux server — the failure mode that surfaced
+ * intermittently as `tmux respawn-pane: fork failed: Device not configured`.
+ *
+ * The wait has its own bounded timeout (default 30 minutes) so a wedged
+ * subagent can't permanently block the workflow; the in-hook stale-sweep
+ * (~2 hours TTL) is the ultimate safety net.
  */
 export declare function clearClaudeSession(paneId: string): Promise<void>;
 export interface ClaudeSessionOptions {
@@ -227,6 +240,21 @@ export declare function claudeQuery(options: ClaudeQueryOptions): Promise<Sessio
  * any extras that aren't already present. Exported for unit testing.
  */
 export declare function mergeDisallowedTools(existing: string[] | undefined, extras: string[]): string[];
+/**
+ * Fold the atomic-managed additional instructions into a caller's
+ * `systemPrompt` value. Behavior, in order of precedence:
+ *
+ *   - **No caller value** → return a `claude_code` preset with our content
+ *     in `append`. Preserves the SDK's full Claude Code persona.
+ *   - **Caller passed a preset object** → concatenate our content onto the
+ *     existing `append` (newline-separated when both are present).
+ *   - **Caller passed a custom string or array** → leave it alone. The
+ *     caller has explicitly opted into a custom prompt, and silently
+ *     prepending the persona-style preset text would break that contract.
+ *
+ * Exported for unit testing.
+ */
+export declare function mergeSystemPromptAppend(existing: SDKOptions["systemPrompt"], extra: string): SDKOptions["systemPrompt"];
 /**
  * Synthetic client wrapper for Claude stages.
  * Auto-starts the Claude CLI in the tmux pane during `start()`.
@@ -325,6 +353,13 @@ export declare function resolveHeadlessClaudeBin(): string;
  */
 export declare class HeadlessClaudeSessionWrapper {
     readonly paneId = "";
+    /**
+     * Project root the workflow is operating against. Used to resolve
+     * project-scoped config (e.g. `additional-instructions`) against the
+     * workflow's actual root rather than `process.cwd()`, which can drift
+     * when workflows are invoked programmatically or from a subdirectory.
+     */
+    private readonly _projectRoot;
     /**
      * The Claude session UUID of the most recently completed `query()`. Exposed
      * via `s.sessionId` so workflows can pass it to `s.save(s.sessionId)` and
@@ -332,6 +367,7 @@ export declare class HeadlessClaudeSessionWrapper {
      * Claude stages run in parallel (each call gets its own SDK-assigned UUID).
      */
     private _lastSessionId;
+    constructor(projectRoot: string);
     /**
      * Validated structured output captured from the most recent `query()`'s
      * `result` message. Populated only when callers pass

package/dist/sdk/providers/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/sdk/providers/claude.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/sdk/providers/claude.ts"],"names":[],"mappings":"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"}

package/dist/sdk/providers/copilot.d.ts

@@ -1,9 +1,10 @@
 /**
- * Copilot workflow source validation.
+ * Copilot workflow source validation + helpers.
  *
  * Checks that Copilot workflow source files use the runtime-managed
  * `s.client` and `s.session` instead of manual SDK client creation.
  */
+import type { SessionConfig as CopilotSessionConfig } from "@github/copilot-sdk";
 /**
  * Env inherited by the Copilot CLI subprocess the SDK spawns.
  *
@@ -21,6 +22,21 @@
  * mutating shared state.
  */
 export declare function copilotSubprocessEnv(): Record<string, string | undefined>;
+/**
+ * Fold the atomic-managed additional instructions into a caller's
+ * `systemMessage` value on `client.createSession`. Behavior:
+ *
+ *   - **No caller value** → `{ mode: "append", content: extra }`. The
+ *     SDK's default mode is append and preserves the SDK persona.
+ *   - **Append/customize mode** → concatenate our content to the existing
+ *     `content` field (newline-separated when both are present).
+ *   - **Replace mode** → leave alone. The caller has explicitly opted out
+ *     of SDK-managed sections; silently re-adding the persona-style append
+ *     would violate that contract.
+ *
+ * Exported for unit testing.
+ */
+export declare function mergeCopilotSystemMessage(existing: CopilotSessionConfig["systemMessage"], extra: string): CopilotSessionConfig["systemMessage"];
 /**
  * Validate a Copilot workflow source file for common mistakes.
  */

package/dist/sdk/providers/copilot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/sdk/providers/copilot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAEzE;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,+DAelC,CAAC"}
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/sdk/providers/copilot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGjF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAEzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,oBAAoB,CAAC,eAAe,CAAC,EAC/C,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAAC,eAAe,CAAC,CASvC;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,+DAelC,CAAC"}