comfyui-mcp 0.16.0 → 0.17.1

package/README.md

@@ -551,6 +551,7 @@ npm install
 | `npm run test:integration` | Run integration tests (requires running ComfyUI) |
 | `npm run lint` | Type-check without emitting |
 | `npm run generations:stats` | Show local generation tracking statistics |
+| `npm run sync-agents` | Sync Claude skills/commands/hooks to Google Antigravity, OpenCode, and other AI IDE formats that supports .agents files |
 
 ### Local testing with Claude Code
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "comfyui-mcp",
-  "version": "0.16.0",
+  "version": "0.17.1",
   "mcpName": "io.github.artokun/comfyui-mcp",
   "description": "Claude Code plugin + MCP server for ComfyUI - 96 tools, 16 AI skills (Flux, WAN, LTX video, Qwen, Civitai), live graph editing from your Claude session. Generate images, video & audio, manage models and custom nodes.",
   "homepage": "https://comfyui-mcp.artokun.io/docs",
@@ -9,12 +9,22 @@
   "bin": {
     "comfyui-mcp": "dist/index.js"
   },
+  "files": [
+    "dist",
+    "plugin",
+    "packs",
+    "scripts",
+    "model-settings.json",
+    "model-settings.user.jsonc.example"
+  ],
   "scripts": {
+    "sync-agents": "node scripts/sync-agents.mjs",
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "dev:agent-poc": "tsx src/experimental/run.ts",
     "start": "node dist/index.js",
     "test": "vitest run --passWithNoTests",
+    "smoke": "npm run build && node scripts/smoke-install.mjs",
     "test:watch": "vitest",
     "test:integration": "cross-env COMFYUI_INTEGRATION=true vitest run",
     "test:agent": "npm run build && node scripts/test-agent.mjs",

package/scripts/smoke-install.mjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * Release smoke test: pack the package exactly as `npm publish` would, install
+ * that tarball into a clean throwaway project (which RUNS the postinstall hook),
+ * and verify the published layout + entrypoint actually boot.
+ *
+ * Catches the class of bug that shipped in 0.17.0: a `files` allowlist that
+ * dropped `scripts/` while `package.json` still declared
+ * `postinstall: node scripts/postinstall.mjs` — so every `npm install` / `npx`
+ * crashed on a missing file. Unit tests (`npm test`) never exercise the packed
+ * tarball, so this is the gap. Run in CI and as a pre-publish gate.
+ */
+import { execSync, spawnSync } from "node:child_process";
+import { mkdtempSync, writeFileSync, existsSync, readdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const run = (cmd, opts = {}) => {
+  console.log(`$ ${cmd}${opts.cwd ? `  (cwd: ${opts.cwd})` : ""}`);
+  execSync(cmd, { stdio: "inherit", ...opts });
+};
+
+// 1. Pack exactly what `npm publish` would upload.
+const packDir = mkdtempSync(join(tmpdir(), "cmcp-pack-"));
+run(`npm pack --pack-destination "${packDir}"`);
+const tgz = readdirSync(packDir).find((f) => f.endsWith(".tgz"));
+if (!tgz) throw new Error("npm pack produced no tarball");
+const tarball = join(packDir, tgz);
+
+// 2. Install the tarball in a clean project — this RUNS the postinstall hook.
+const proj = mkdtempSync(join(tmpdir(), "cmcp-smoke-"));
+writeFileSync(
+  join(proj, "package.json"),
+  JSON.stringify({ name: "comfyui-mcp-smoke", private: true, version: "0.0.0" }),
+);
+// --foreground-scripts surfaces postinstall output; a crashing hook exits non-zero.
+run(`npm install --foreground-scripts --no-audit --no-fund "${tarball}"`, { cwd: proj });
+
+// 3. Verify the published layout is intact (files the runtime/install need).
+const pkg = join(proj, "node_modules", "comfyui-mcp");
+for (const f of ["dist/index.js", "scripts/postinstall.mjs", "package.json"]) {
+  if (!existsSync(join(pkg, f))) {
+    console.error(`❌ published package is missing ${f}`);
+    process.exit(1);
+  }
+}
+if (!existsSync(join(proj, "node_modules", ".bin", "comfyui-mcp")) &&
+    !existsSync(join(proj, "node_modules", ".bin", "comfyui-mcp.cmd"))) {
+  console.error("❌ comfyui-mcp bin was not linked");
+  process.exit(1);
+}
+
+// 4. Entrypoint parses (syntax) and boots without an immediate crash.
+run(`node --check "${join(pkg, "dist/index.js")}"`);
+const boot = spawnSync(process.execPath, [join(pkg, "dist/index.js")], {
+  input: "",
+  timeout: 8000,
+  encoding: "utf8",
+});
+// Pass if it stayed up until the timeout (SIGTERM) or exited cleanly on stdin EOF.
+if (boot.signal === "SIGTERM" || boot.status === 0) {
+  console.log(`✅ entrypoint boots (signal=${boot.signal}, status=${boot.status})`);
+} else {
+  console.error(`❌ entrypoint crashed on boot (status=${boot.status}, signal=${boot.signal})`);
+  if (boot.stdout) console.error("stdout:\n" + boot.stdout);
+  if (boot.stderr) console.error("stderr:\n" + boot.stderr);
+  process.exit(1);
+}
+
+console.log("✅ pack/install smoke passed — tarball installs cleanly and boots");

package/scripts/sync-agents.mjs

@@ -0,0 +1,147 @@
+import fs from 'fs';
+import path from 'path';
+
+const PLUGIN_DIR = 'plugin';
+const AGENTS_DIR = '.agents';
+const GEMINI_DIR = '.gemini/commands';
+
+// Ensure directories exist
+fs.mkdirSync(path.join(AGENTS_DIR, 'skills'), { recursive: true });
+fs.mkdirSync(GEMINI_DIR, { recursive: true });
+
+function extractFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) return { frontmatter: {}, body: content };
+  
+  const frontmatterStr = match[1];
+  const body = match[2];
+  
+  const frontmatter = {};
+  for (const line of frontmatterStr.split('\n')) {
+    const colonIdx = line.indexOf(':');
+    if (colonIdx !== -1) {
+      const key = line.slice(0, colonIdx).trim();
+      const value = line.slice(colonIdx + 1).trim();
+      if (!key.startsWith('globs') && !line.trim().startsWith('-')) {
+         frontmatter[key] = value.replace(/^['"]|['"]$/g, '');
+      }
+    }
+  }
+  return { frontmatter, body };
+}
+
+function processSkillOrAgent(srcPath, destPath, defaultName, isAgent) {
+  if (!fs.existsSync(srcPath)) return;
+  const content = fs.readFileSync(srcPath, 'utf8');
+  let { frontmatter, body } = extractFrontmatter(content);
+  
+  const name = frontmatter.name || defaultName;
+  const description = frontmatter.description || (isAgent ? `Agent specialized in ${name}` : '');
+  
+  // Replace CLAUDE_PLUGIN_ROOT with ./plugin
+  body = body.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, './plugin');
+  
+  const newContent = `---
+name: ${name}
+description: ${description}
+---
+
+${body.trim()}`;
+
+  fs.mkdirSync(path.dirname(destPath), { recursive: true });
+  fs.writeFileSync(destPath, newContent, 'utf8');
+  console.log(`Synced ${srcPath} -> ${destPath}`);
+}
+
+// 1. Translate skills
+const skillsDir = path.join(PLUGIN_DIR, 'skills');
+if (fs.existsSync(skillsDir)) {
+  for (const skillName of fs.readdirSync(skillsDir)) {
+    const srcPath = path.join(skillsDir, skillName, 'SKILL.md');
+    const destPath = path.join(AGENTS_DIR, 'skills', skillName, 'SKILL.md');
+    processSkillOrAgent(srcPath, destPath, skillName, false);
+  }
+}
+
+// 2. Translate agents
+const agentsDir = path.join(PLUGIN_DIR, 'agents');
+if (fs.existsSync(agentsDir)) {
+  for (const file of fs.readdirSync(agentsDir)) {
+    if (file.endsWith('.md')) {
+      const agentName = path.basename(file, '.md');
+      const srcPath = path.join(agentsDir, file);
+      const destPath = path.join(AGENTS_DIR, 'skills', `comfy-${agentName}`, 'SKILL.md');
+      processSkillOrAgent(srcPath, destPath, `comfy-${agentName}`, true);
+    }
+  }
+}
+
+// 3. Translate commands
+const commandsDir = path.join(PLUGIN_DIR, 'commands');
+if (fs.existsSync(commandsDir)) {
+  for (const file of fs.readdirSync(commandsDir)) {
+    if (file.endsWith('.md')) {
+      const commandName = path.basename(file, '.md');
+      const srcPath = path.join(commandsDir, file);
+      const destPath = path.join(GEMINI_DIR, `comfy-${commandName}.toml`);
+      
+      const content = fs.readFileSync(srcPath, 'utf8');
+      let { frontmatter, body } = extractFrontmatter(content);
+      
+      body = body.replace(/\$ARGUMENTS/g, '{{args}}');
+      body = body.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, './plugin');
+      
+      const desc = frontmatter.description || `Command comfy-${commandName}`;
+      
+      const tomlContent = `name = "comfy-${commandName}"
+description = "${desc}"
+
+prompt = """
+${body.trim()}
+"""
+`;
+      fs.writeFileSync(destPath, tomlContent, 'utf8');
+      console.log(`Synced ${srcPath} -> ${destPath}`);
+    }
+  }
+}
+
+// 4. Translate hooks
+const hooksSrc = path.join(PLUGIN_DIR, 'hooks', 'hooks.json');
+const hooksDest = path.join(AGENTS_DIR, 'hooks.json');
+if (fs.existsSync(hooksSrc)) {
+  let hooksContent = fs.readFileSync(hooksSrc, 'utf8');
+  hooksContent = hooksContent.replace(/mcp__plugin_comfy_comfyui__/g, 'mcp__comfyui__');
+  hooksContent = hooksContent.replace(/\$\{CLAUDE_PLUGIN_ROOT\}\/hooks/g, './plugin/hooks');
+  hooksContent = hooksContent.replace(/\$\{CLAUDE_PLUGIN_ROOT\}\/scripts/g, './plugin/scripts');
+  fs.writeFileSync(hooksDest, hooksContent, 'utf8');
+  console.log(`Synced hooks -> ${hooksDest}`);
+}
+
+// 5. Create default mcp_config.json
+const mcpConfigPath = path.join(AGENTS_DIR, 'mcp_config.json');
+const mcpConfig = {
+  mcpServers: {
+    comfyui: {
+      command: "npx",
+      args: ["-y", "comfyui-mcp"],
+      env: {
+        CIVITAI_API_TOKEN: ""
+      }
+    },
+    civitai: {
+      url: "https://mcp.civitai.com/mcp",
+      headers: {
+        Authorization: "Bearer ${CIVITAI_API_TOKEN:-}"
+      }
+    },
+    huggingface: {
+      url: "https://huggingface.co/mcp",
+      headers: {
+        Authorization: "Bearer ${HUGGINGFACE_TOKEN:-}"
+      }
+    }
+  }
+};
+fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2), 'utf8');
+console.log(`Created default ${mcpConfigPath}`);

package/.beads/README.md

@@ -1,81 +0,0 @@
-# Beads - AI-Native Issue Tracking
-
-Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
-
-## What is Beads?
-
-Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
-
-**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
-
-## Quick Start
-
-### Essential Commands
-
-```bash
-# Create new issues
-bd create "Add user authentication"
-
-# View all issues
-bd list
-
-# View issue details
-bd show <issue-id>
-
-# Update issue status
-bd update <issue-id> --claim
-bd update <issue-id> --status done
-
-# Sync with Dolt remote
-bd dolt push
-```
-
-### Working with Issues
-
-Issues in Beads are:
-- **Git-native**: Stored in Dolt database with version control and branching
-- **AI-friendly**: CLI-first design works perfectly with AI coding agents
-- **Branch-aware**: Issues can follow your branch workflow
-- **Always in sync**: Auto-syncs with your commits
-
-## Why Beads?
-
-✨ **AI-Native Design**
-- Built specifically for AI-assisted development workflows
-- CLI-first interface works seamlessly with AI coding agents
-- No context switching to web UIs
-
-🚀 **Developer Focused**
-- Issues live in your repo, right next to your code
-- Works offline, syncs when you push
-- Fast, lightweight, and stays out of your way
-
-🔧 **Git Integration**
-- Automatic sync with git commits
-- Branch-aware issue tracking
-- Dolt-native three-way merge resolution
-
-## Get Started with Beads
-
-Try Beads in your own projects:
-
-```bash
-# Install Beads
-curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
-
-# Initialize in your repo
-bd init
-
-# Create your first issue
-bd create "Try out Beads"
-```
-
-## Learn More
-
-- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
-- **Quick Start Guide**: Run `bd quickstart`
-- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
-
----
-
-*Beads: Issue tracking that moves at the speed of thought* ⚡

package/.beads/config.yaml

@@ -1,54 +0,0 @@
-# Beads Configuration File
-# This file configures default behavior for all bd commands in this repository
-# All settings can also be set via environment variables (BD_* prefix)
-# or overridden with command-line flags
-
-# Issue prefix for this repository (used by bd init)
-# If not set, bd init will auto-detect from directory name
-# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
-# issue-prefix: ""
-
-# Use no-db mode: JSONL-only, no Dolt database
-# When true, bd will use .beads/issues.jsonl as the source of truth
-# no-db: false
-
-# Enable JSON output by default
-# json: false
-
-# Feedback title formatting for mutating commands (create/update/close/dep/edit)
-# 0 = hide titles, N > 0 = truncate to N characters
-# output:
-#   title-length: 255
-
-# Default actor for audit trails (overridden by BEADS_ACTOR or --actor)
-# actor: ""
-
-# Export events (audit trail) to .beads/events.jsonl on each flush/sync
-# When enabled, new events are appended incrementally using a high-water mark.
-# Use 'bd export --events' to trigger manually regardless of this setting.
-# events-export: false
-
-# Multi-repo configuration (experimental - bd-307)
-# Allows hydrating from multiple repositories and routing writes to the correct database
-# repos:
-#   primary: "."  # Primary repo (where this database lives)
-#   additional:   # Additional repos to hydrate from (read-only)
-#     - ~/beads-planning  # Personal planning repo
-#     - ~/work-planning   # Work planning repo
-
-# JSONL backup (periodic export for off-machine recovery)
-# Auto-enabled when a git remote exists. Override explicitly:
-# backup:
-#   enabled: false     # Disable auto-backup entirely
-#   interval: 15m      # Minimum time between auto-exports
-#   git-push: false    # Disable git push (export locally only)
-#   git-repo: ""       # Separate git repo for backups (default: project repo)
-
-# Integration settings (access with 'bd config get/set')
-# These are stored in the database, not in this file:
-# - jira.url
-# - jira.project
-# - linear.url
-# - linear.api-key
-# - github.org
-# - github.repo

package/.beads/hooks/post-checkout

@@ -1,24 +0,0 @@
-#!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.0 ---
-# This section is managed by beads. Do not remove these markers.
-if command -v bd >/dev/null 2>&1; then
-  export BD_GIT_HOOK=1
-  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}
-  if command -v timeout >/dev/null 2>&1; then
-    timeout "$_bd_timeout" bd hooks run post-checkout "$@"
-    _bd_exit=$?
-    if [ $_bd_exit -eq 124 ]; then
-      echo >&2 "beads: hook 'post-checkout' timed out after ${_bd_timeout}s — continuing without beads"
-      _bd_exit=0
-    fi
-  else
-    bd hooks run post-checkout "$@"
-    _bd_exit=$?
-  fi
-  if [ $_bd_exit -eq 3 ]; then
-    echo >&2 "beads: database not initialized — skipping hook 'post-checkout'"
-    _bd_exit=0
-  fi
-  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
-fi
-# --- END BEADS INTEGRATION v1.0.0 ---

package/.beads/hooks/post-merge

@@ -1,24 +0,0 @@
-#!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.0 ---
-# This section is managed by beads. Do not remove these markers.
-if command -v bd >/dev/null 2>&1; then
-  export BD_GIT_HOOK=1
-  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}
-  if command -v timeout >/dev/null 2>&1; then
-    timeout "$_bd_timeout" bd hooks run post-merge "$@"
-    _bd_exit=$?
-    if [ $_bd_exit -eq 124 ]; then
-      echo >&2 "beads: hook 'post-merge' timed out after ${_bd_timeout}s — continuing without beads"
-      _bd_exit=0
-    fi
-  else
-    bd hooks run post-merge "$@"
-    _bd_exit=$?
-  fi
-  if [ $_bd_exit -eq 3 ]; then
-    echo >&2 "beads: database not initialized — skipping hook 'post-merge'"
-    _bd_exit=0
-  fi
-  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
-fi
-# --- END BEADS INTEGRATION v1.0.0 ---

package/.beads/hooks/pre-commit

@@ -1,24 +0,0 @@
-#!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.0 ---
-# This section is managed by beads. Do not remove these markers.
-if command -v bd >/dev/null 2>&1; then
-  export BD_GIT_HOOK=1
-  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}
-  if command -v timeout >/dev/null 2>&1; then
-    timeout "$_bd_timeout" bd hooks run pre-commit "$@"
-    _bd_exit=$?
-    if [ $_bd_exit -eq 124 ]; then
-      echo >&2 "beads: hook 'pre-commit' timed out after ${_bd_timeout}s — continuing without beads"
-      _bd_exit=0
-    fi
-  else
-    bd hooks run pre-commit "$@"
-    _bd_exit=$?
-  fi
-  if [ $_bd_exit -eq 3 ]; then
-    echo >&2 "beads: database not initialized — skipping hook 'pre-commit'"
-    _bd_exit=0
-  fi
-  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
-fi
-# --- END BEADS INTEGRATION v1.0.0 ---

package/.beads/hooks/pre-push

@@ -1,24 +0,0 @@
-#!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.0 ---
-# This section is managed by beads. Do not remove these markers.
-if command -v bd >/dev/null 2>&1; then
-  export BD_GIT_HOOK=1
-  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}
-  if command -v timeout >/dev/null 2>&1; then
-    timeout "$_bd_timeout" bd hooks run pre-push "$@"
-    _bd_exit=$?
-    if [ $_bd_exit -eq 124 ]; then
-      echo >&2 "beads: hook 'pre-push' timed out after ${_bd_timeout}s — continuing without beads"
-      _bd_exit=0
-    fi
-  else
-    bd hooks run pre-push "$@"
-    _bd_exit=$?
-  fi
-  if [ $_bd_exit -eq 3 ]; then
-    echo >&2 "beads: database not initialized — skipping hook 'pre-push'"
-    _bd_exit=0
-  fi
-  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
-fi
-# --- END BEADS INTEGRATION v1.0.0 ---

package/.beads/hooks/prepare-commit-msg

@@ -1,24 +0,0 @@
-#!/usr/bin/env sh
-# --- BEGIN BEADS INTEGRATION v1.0.0 ---
-# This section is managed by beads. Do not remove these markers.
-if command -v bd >/dev/null 2>&1; then
-  export BD_GIT_HOOK=1
-  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}
-  if command -v timeout >/dev/null 2>&1; then
-    timeout "$_bd_timeout" bd hooks run prepare-commit-msg "$@"
-    _bd_exit=$?
-    if [ $_bd_exit -eq 124 ]; then
-      echo >&2 "beads: hook 'prepare-commit-msg' timed out after ${_bd_timeout}s — continuing without beads"
-      _bd_exit=0
-    fi
-  else
-    bd hooks run prepare-commit-msg "$@"
-    _bd_exit=$?
-  fi
-  if [ $_bd_exit -eq 3 ]; then
-    echo >&2 "beads: database not initialized — skipping hook 'prepare-commit-msg'"
-    _bd_exit=0
-  fi
-  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
-fi
-# --- END BEADS INTEGRATION v1.0.0 ---

package/.beads/metadata.json

@@ -1,7 +0,0 @@
-{
-  "database": "dolt",
-  "backend": "dolt",
-  "dolt_mode": "embedded",
-  "dolt_database": "comfyui_mcp",
-  "project_id": "36b5b81f-eb4b-408e-9917-4eaae6aaaa0c"
-}

package/.codex/hooks.json

@@ -1,15 +0,0 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bd prime"
-          }
-        ]
-      }
-    ]
-  }
-}

package/.dockerignore

@@ -1,24 +0,0 @@
-# Build artifacts and deps — rebuilt inside the image
-node_modules
-dist
-
-# VCS and local agent worktrees
-.git
-.claude
-
-# Env / secrets / local user config
-.env
-.env.*
-model-settings.user.jsonc
-
-# Tests and docs not needed at runtime
-src/__tests__
-**/*.test.ts
-*.md
-TODO.md
-
-# Editor / OS cruft
-.vscode
-.idea
-.DS_Store
-npm-debug.log*

package/.gitattributes

@@ -1,4 +0,0 @@
-# Keep generated pack installers deterministic across OSes so CI's
-# "installers up to date" check is stable.
-*.sh text eol=lf
-*.bat text eol=crlf

package/AGENTS.md

@@ -1,84 +0,0 @@
-# Agent Instructions
-
-This project uses **bd** (beads) for issue tracking. Run `bd prime` for full workflow context.
-
-## Quick Reference
-
-```bash
-bd ready              # Find available work
-bd show <id>          # View issue details
-bd update <id> --claim  # Claim work atomically
-bd close <id>         # Complete work
-bd dolt push          # Push beads data to remote
-```
-
-## Non-Interactive Shell Commands
-
-**ALWAYS use non-interactive flags** with file operations to avoid hanging on confirmation prompts.
-
-Shell commands like `cp`, `mv`, and `rm` may be aliased to include `-i` (interactive) mode on some systems, causing the agent to hang indefinitely waiting for y/n input.
-
-**Use these forms instead:**
-```bash
-# Force overwrite without prompting
-cp -f source dest           # NOT: cp source dest
-mv -f source dest           # NOT: mv source dest
-rm -f file                  # NOT: rm file
-
-# For recursive operations
-rm -rf directory            # NOT: rm -r directory
-cp -rf source dest          # NOT: cp -r source dest
-```
-
-**Other commands that may prompt:**
-- `scp` - use `-o BatchMode=yes` for non-interactive
-- `ssh` - use `-o BatchMode=yes` to fail instead of prompting
-- `apt-get` - use `-y` flag
-- `brew` - use `HOMEBREW_NO_AUTO_UPDATE=1` env var
-
-<!-- BEGIN BEADS INTEGRATION v:1 profile:minimal hash:ca08a54f -->
-## Beads Issue Tracker
-
-This project uses **bd (beads)** for issue tracking. Run `bd prime` to see full workflow context and commands.
-
-### Quick Reference
-
-```bash
-bd ready              # Find available work
-bd show <id>          # View issue details
-bd update <id> --claim  # Claim work
-bd close <id>         # Complete work
-```
-
-### Rules
-
-- Use `bd` for ALL task tracking — do NOT use TodoWrite, TaskCreate, or markdown TODO lists
-- Run `bd prime` for detailed command reference and session close protocol
-- Use `bd remember` for persistent knowledge — do NOT use MEMORY.md files
-
-## Session Completion
-
-**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
-
-**MANDATORY WORKFLOW:**
-
-1. **File issues for remaining work** - Create issues for anything that needs follow-up
-2. **Run quality gates** (if code changed) - Tests, linters, builds
-3. **Update issue status** - Close finished work, update in-progress items
-4. **PUSH TO REMOTE** - This is MANDATORY:
-   ```bash
-   git pull --rebase
-   bd dolt push
-   git push
-   git status  # MUST show "up to date with origin"
-   ```
-5. **Clean up** - Clear stashes, prune remote branches
-6. **Verify** - All changes committed AND pushed
-7. **Hand off** - Provide context for next session
-
-**CRITICAL RULES:**
-- Work is NOT complete until `git push` succeeds
-- NEVER stop before pushing - that leaves work stranded locally
-- NEVER say "ready to push when you are" - YOU must push
-- If push fails, resolve and retry until it succeeds
-<!-- END BEADS INTEGRATION -->