agent-threader 2.0.5

package/install-local.sh

@@ -0,0 +1,239 @@
+#!/usr/bin/env bash
+# install-local.sh -- Build and install skills + companion CLI from a local clone
+# Run once from the project root: bash install-local.sh [--claude] [--cursor] [--windsurf] [--opencode] [--codex] [--all]
+# No flags = auto-detect installed tools
+
+set -e
+
+PROJECT_NAME="${AGENT_THREADER_PACKAGE_NAME:-agent-threader}"
+CLI_BIN_NAME="agent-threader"
+MANAGED_MARKER="managed_by: agent-threader"
+SKILLS=("agent-threader")
+
+SKILL_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+CLAUDE_SKILLS_DIR="$HOME/.claude/skills"
+CURSOR_RULES_DIR="$HOME/.cursor/rules"
+CURSOR_SKILLS_DIR="$HOME/.cursor/skills"
+WINDSURF_RULES_DIR="$HOME/.windsurf/rules"
+WINDSURF_SKILLS_DIR="$HOME/.codeium/windsurf/skills"
+OPENCODE_AGENTS_DIR="$HOME/.config/opencode/agents"
+CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
+CODEX_SKILLS_DIR="$CODEX_HOME_DIR/skills"
+
+cleanup_managed() {
+  local dir="$1"
+  [[ -d "$dir" ]] || return 0
+  grep -rl "$MANAGED_MARKER" "$dir" 2>/dev/null | while read -r f; do
+    rm -f "$f"
+    local parent; parent="$(dirname "$f")"
+    [[ "$parent" != "$dir" ]] && rmdir "$parent" 2>/dev/null || true
+    echo "    Removed: $f"
+  done
+}
+
+COMPILED_DIR="$SKILL_DIR/compiled"
+
+install_claude() {
+  local skill_name="$1"
+  local src="$COMPILED_DIR/claude/${skill_name}/SKILL.md"
+  local dest_dir="$CLAUDE_SKILLS_DIR/${skill_name}"
+  mkdir -p "$dest_dir"
+  cp "$src" "$dest_dir/SKILL.md"
+  echo "    Claude:   $dest_dir/SKILL.md"
+}
+
+install_cursor() {
+  local skill_name="$1"
+  local src="$COMPILED_DIR/cursor/rules/${skill_name}.mdc"
+  mkdir -p "$CURSOR_RULES_DIR"
+  cp "$src" "$CURSOR_RULES_DIR/${skill_name}.mdc"
+  echo "    Cursor (rule):  $CURSOR_RULES_DIR/${skill_name}.mdc"
+  local src2="$COMPILED_DIR/cursor/skills/${skill_name}/SKILL.md"
+  local dest_dir="$CURSOR_SKILLS_DIR/${skill_name}"
+  mkdir -p "$dest_dir"
+  cp "$src2" "$dest_dir/SKILL.md"
+  echo "    Cursor (skill): $dest_dir/SKILL.md"
+}
+
+install_windsurf() {
+  local skill_name="$1"
+  local src="$COMPILED_DIR/windsurf/rules/${skill_name}.md"
+  mkdir -p "$WINDSURF_RULES_DIR"
+  cp "$src" "$WINDSURF_RULES_DIR/${skill_name}.md"
+  echo "    Windsurf (rule):  $WINDSURF_RULES_DIR/${skill_name}.md"
+  local src2="$COMPILED_DIR/windsurf/skills/${skill_name}/SKILL.md"
+  local dest_dir="$WINDSURF_SKILLS_DIR/${skill_name}"
+  mkdir -p "$dest_dir"
+  cp "$src2" "$dest_dir/SKILL.md"
+  echo "    Windsurf (skill): $dest_dir/SKILL.md"
+}
+
+install_opencode() {
+  local skill_name="$1"
+  local src="$COMPILED_DIR/opencode/${skill_name}.md"
+  mkdir -p "$OPENCODE_AGENTS_DIR"
+  cp "$src" "$OPENCODE_AGENTS_DIR/${skill_name}.md"
+  echo "    OpenCode: $OPENCODE_AGENTS_DIR/${skill_name}.md"
+}
+
+install_codex() {
+  local skill_name="$1"
+  local src="$COMPILED_DIR/codex/${skill_name}/SKILL.md"
+  local dest_dir="$CODEX_SKILLS_DIR/${skill_name}"
+  mkdir -p "$dest_dir"
+  cp "$src" "$dest_dir/SKILL.md"
+  echo "    Codex:    $dest_dir/SKILL.md"
+}
+
+uninstall_claude()   { for skill in "${SKILLS[@]}"; do rm -rf "$CLAUDE_SKILLS_DIR/$skill"; done; echo "    Claude:   removed"; }
+uninstall_cursor()   { for skill in "${SKILLS[@]}"; do rm -f "$CURSOR_RULES_DIR/${skill}.mdc"; rm -rf "$CURSOR_SKILLS_DIR/$skill"; done; echo "    Cursor:   removed"; }
+uninstall_windsurf() { for skill in "${SKILLS[@]}"; do rm -f "$WINDSURF_RULES_DIR/${skill}.md"; rm -rf "$WINDSURF_SKILLS_DIR/$skill"; done; echo "    Windsurf: removed"; }
+uninstall_opencode() { for skill in "${SKILLS[@]}"; do rm -f "$OPENCODE_AGENTS_DIR/${skill}.md"; done; echo "    OpenCode: removed"; }
+uninstall_codex()    { for skill in "${SKILLS[@]}"; do rm -rf "$CODEX_SKILLS_DIR/$skill"; done; echo "    Codex:    removed"; }
+
+detect_editors() {
+  local detected=()
+  [[ -d "$HOME/.claude" ]] && detected+=("claude")
+  [[ -d "$HOME/.cursor" ]] && detected+=("cursor")
+  [[ -d "$HOME/.windsurf" || -d "$HOME/.codeium/windsurf" ]] && detected+=("windsurf")
+  [[ -d "$HOME/.config/opencode" || -d "$HOME/.opencode" ]] && detected+=("opencode")
+  [[ -n "${CODEX_HOME:-}" || -d "$CODEX_HOME_DIR" ]] && detected+=("codex")
+  echo "${detected[@]}"
+}
+
+TARGETS=()
+DO_BUILD=true
+DO_UNINSTALL=false
+DO_COMPILE_ONLY=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --claude)    TARGETS+=("claude"); shift ;;
+    --cursor)    TARGETS+=("cursor"); shift ;;
+    --windsurf)  TARGETS+=("windsurf"); shift ;;
+    --opencode)  TARGETS+=("opencode"); shift ;;
+    --codex)     TARGETS+=("codex"); shift ;;
+    --all)       TARGETS=("claude" "cursor" "windsurf" "opencode" "codex"); shift ;;
+    --skills-only) DO_BUILD=false; shift ;;
+    --uninstall) DO_UNINSTALL=true; shift ;;
+    --compile-only) DO_COMPILE_ONLY=true; shift ;;
+    --help|-h)
+      echo "Usage: bash install-local.sh [options]"
+      echo ""
+      echo "Options:"
+      echo "  --claude        Install skills for Claude Code"
+      echo "  --cursor        Install skills for Cursor"
+      echo "  --windsurf      Install skills for Windsurf"
+      echo "  --opencode      Install skills for OpenCode"
+      echo "  --codex         Install skills for Codex"
+      echo "  --all           Install for all five tools"
+      echo "  --skills-only   Skip npm install/build/link (just copy skills)"
+      echo "  --uninstall     Remove installed skills from target tools"
+      echo "  --compile-only  Generate compiled/ output directory (no install)"
+      echo "  -h, --help      Show this help"
+      echo ""
+      echo "No flags = auto-detect installed tools."
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $1"
+      echo "Run: bash install-local.sh --help"
+      exit 1
+      ;;
+  esac
+done
+
+if [[ "$DO_COMPILE_ONLY" == true ]]; then
+  echo "==> Delegating to compile.mjs..."
+  node "$SKILL_DIR/skill/build/compile.mjs"
+  exit $?
+fi
+
+if [[ ${#TARGETS[@]} -eq 0 ]]; then
+  read -ra TARGETS <<< "$(detect_editors)"
+fi
+
+if [[ ${#TARGETS[@]} -eq 0 ]]; then
+  echo "ERROR: No supported tools detected. Use --claude, --cursor, --windsurf, --opencode, or --codex."
+  exit 1
+fi
+
+if [[ "$DO_UNINSTALL" == true ]]; then
+  echo "==> Uninstalling $PROJECT_NAME"
+  echo "    Targets: ${TARGETS[*]}"
+  echo ""
+  for target in "${TARGETS[@]}"; do
+    "uninstall_${target}"
+  done
+
+  echo "--> Removing $CLI_BIN_NAME CLI..."
+  npm unlink "$PROJECT_NAME" 2>/dev/null || true
+  hash -r 2>/dev/null || true
+  if command -v "$CLI_BIN_NAME" &>/dev/null; then
+    echo "    WARNING: $CLI_BIN_NAME still in PATH at $(which "$CLI_BIN_NAME")"
+  else
+    echo "    $CLI_BIN_NAME removed"
+  fi
+
+  echo ""
+  echo "==> Done. Skills and CLI removed."
+  exit 0
+fi
+
+echo "==> $PROJECT_NAME setup"
+echo "    Project: $SKILL_DIR"
+echo "    Targets: ${TARGETS[*]}"
+echo ""
+
+if [[ "$DO_BUILD" == true ]]; then
+  echo "--> Installing dependencies..."
+  npm install
+
+  echo "--> Cleaning previous build..."
+  rm -rf "$SKILL_DIR/dist"
+
+  echo "--> Building TypeScript..."
+  npm run build
+  chmod +x "$SKILL_DIR/dist/cli/index.js"
+
+  echo "--> Compiling skills..."
+  npm run compile
+
+  echo "--> Installing $CLI_BIN_NAME CLI globally..."
+  npm link
+
+  NPM_BIN="$(npm prefix -g)/bin"
+  if [[ -x "$NPM_BIN/$CLI_BIN_NAME" ]]; then
+    echo "    $CLI_BIN_NAME: $NPM_BIN/$CLI_BIN_NAME"
+    echo "    version:  $("$NPM_BIN/$CLI_BIN_NAME" --version 2>/dev/null || echo 'unknown')"
+  else
+    echo "    WARNING: $CLI_BIN_NAME not found in $NPM_BIN after npm link."
+    echo "    Try running: npm link"
+  fi
+fi
+
+echo "--> Cleaning stale $PROJECT_NAME files..."
+for target in "${TARGETS[@]}"; do
+  case "$target" in
+    claude)   cleanup_managed "$CLAUDE_SKILLS_DIR" ;;
+    cursor)   cleanup_managed "$CURSOR_RULES_DIR"; cleanup_managed "$CURSOR_SKILLS_DIR" ;;
+    windsurf) cleanup_managed "$WINDSURF_RULES_DIR"; cleanup_managed "$WINDSURF_SKILLS_DIR" ;;
+    opencode) cleanup_managed "$OPENCODE_AGENTS_DIR" ;;
+    codex)    cleanup_managed "$CODEX_SKILLS_DIR" ;;
+  esac
+done
+
+echo "--> Installing skills..."
+for skill in "${SKILLS[@]}"; do
+  echo "  ${skill}:"
+  for target in "${TARGETS[@]}"; do
+    "install_${target}" "$skill"
+  done
+done
+
+echo ""
+echo "==> Done."
+echo ""
+echo "Skills installed for: ${TARGETS[*]}"
+echo "CLI available as: $CLI_BIN_NAME"

package/install.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# install.sh -- Bootstrap installer for the published agent-threader package
+# Usage: bash <(curl -fsSL https://agentthreader.com/install.sh) [--claude] [--cursor] [--windsurf] [--opencode] [--codex] [--all]
+
+set -euo pipefail
+
+PROJECT_NAME="${AGENT_THREADER_PACKAGE_NAME:-agent-threader}"
+PROJECT_VERSION="${AGENT_THREADER_PACKAGE_VERSION:-latest}"
+CLI_BIN_NAME="agent-threader"
+PACKAGE_SPEC="${PROJECT_NAME}@${PROJECT_VERSION}"
+INSTALLER_ARGS=("$@")
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "ERROR: npm is required but was not found in PATH."
+  exit 1
+fi
+
+echo "==> Bootstrapping ${PACKAGE_SPEC}"
+echo "--> Installing ${PACKAGE_SPEC} globally..."
+npm install -g "$PACKAGE_SPEC"
+
+NPM_ROOT="$(npm root -g)"
+PACKAGE_DIR="$NPM_ROOT/$PROJECT_NAME"
+LOCAL_INSTALLER="$PACKAGE_DIR/install-local.sh"
+
+if [[ ! -f "$LOCAL_INSTALLER" ]]; then
+  echo "ERROR: Could not find install-local.sh in $PACKAGE_DIR"
+  exit 1
+fi
+
+echo "--> Delegating to local installer..."
+bash "$LOCAL_INSTALLER" --skills-only "${INSTALLER_ARGS[@]}"
+
+echo ""
+echo "==> Done."
+echo "CLI available as: $CLI_BIN_NAME"

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "agent-threader",
+  "version": "2.0.5",
+  "description": "AgentThreader -- skill + companion CLI for manifest-driven agentic CLI orchestration with structured contracts, resumable state, and bounded self-healing",
+  "type": "module",
+  "bin": {
+    "agent-threader": "dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "compiled",
+    "skill",
+    "site",
+    "README.md",
+    "install.sh",
+    "install-local.sh"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit",
+    "setup": "bash install-local.sh",
+    "setup:all": "bash install-local.sh --all",
+    "install-skills": "bash install-local.sh --skills-only",
+    "uninstall-skills": "bash install-local.sh --uninstall",
+    "compile": "node skill/build/compile.mjs",
+    "compile:validate": "node skill/build/compile.mjs --validate",
+    "compile:watch": "node skill/build/compile.mjs --watch"
+  },
+  "dependencies": {
+    "ajv": "^8.17.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "eslint": "^9.0.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/site/CNAME

@@ -0,0 +1 @@
+agentthreader.com

package/site/index.html

@@ -0,0 +1,141 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>AgentThreader</title>
+  <meta name="description" content="Manifest-driven agentic CLI orchestration with structured contracts, resumable state, and bounded self-healing." />
+  <link rel="stylesheet" href="/style.css" />
+</head>
+<body>
+  <div class="page">
+    <header class="hero">
+      <div class="container">
+        <h1 class="logo">Agent<span class="accent">Threader</span></h1>
+        <p class="tagline">Manifest-driven agentic CLI orchestration</p>
+        <p class="subtitle">Structured contracts. Resumable state. Bounded self-healing.</p>
+        <div class="cta-row">
+          <a href="https://github.com/barretts/AgentThreader" class="btn btn-primary">View on GitHub</a>
+          <a href="#install" class="btn btn-secondary">Install</a>
+        </div>
+      </div>
+    </header>
+
+    <section id="features" class="features">
+      <div class="container">
+        <h2>How It Works</h2>
+        <div class="grid">
+          <div class="card">
+            <div class="card-icon">1</div>
+            <h3>Declare Work</h3>
+            <p>Define tasks, dependencies, timeouts, and verification profiles in a <code>manifest.v2</code> JSON file.</p>
+          </div>
+          <div class="card">
+            <div class="card-icon">2</div>
+            <h3>Thread Agents</h3>
+            <p>The orchestrator schedules tasks through CLI adapters with dependency-aware ordering and resumable execution state.</p>
+          </div>
+          <div class="card">
+            <div class="card-icon">3</div>
+            <h3>Verify &amp; Checkpoint</h3>
+            <p>Every result is parsed, schema-validated, and verified before state is committed. Atomic writes keep resume safe.</p>
+          </div>
+          <div class="card">
+            <div class="card-icon">4</div>
+            <h3>Self-Heal</h3>
+            <p>Bounded healing logic diagnoses failures, patches prompts, and retries without letting the run spiral.</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section class="contracts">
+      <div class="container">
+        <h2>v2 Contract Stack</h2>
+        <div class="contract-grid">
+          <div class="contract-item">
+            <code>manifest.v2</code>
+            <span>Task declarations</span>
+          </div>
+          <div class="contract-item">
+            <code>task_result.v2</code>
+            <span>Worker output</span>
+          </div>
+          <div class="contract-item">
+            <code>heal_decision.v2</code>
+            <span>Healer output</span>
+          </div>
+          <div class="contract-item">
+            <code>state.v2</code>
+            <span>Run state</span>
+          </div>
+          <div class="contract-item">
+            <code>verify_profile.v2</code>
+            <span>Verification steps</span>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section class="cli-section">
+      <div class="container">
+        <h2>Companion CLI</h2>
+        <div class="terminal">
+          <div class="terminal-bar">
+            <span class="dot red"></span>
+            <span class="dot yellow"></span>
+            <span class="dot green"></span>
+          </div>
+          <pre><code><span class="prompt">$</span> agent-threader validate-manifest manifest.json
+<span class="success">Valid manifest: 12 tasks</span>
+<span class="dim">Dependency order: WP-001 -&gt; WP-003 -&gt; WP-002 -&gt; ...</span>
+
+<span class="prompt">$</span> agent-threader init-state manifest.json
+<span class="success">State initialized: .agentic/state.json</span>
+<span class="dim">  Run ID:  run-2026-04-02</span>
+<span class="dim">  Tasks:   12</span>
+<span class="dim">  Heal:    auto</span>
+
+<span class="prompt">$</span> agent-threader status
+<span class="bold">Run run-2026-04-02: RUNNING</span>
+<span class="dim">  DONE       8</span>
+<span class="dim">  RUNNING    2</span>
+<span class="dim">  PENDING    2</span></code></pre>
+        </div>
+      </div>
+    </section>
+
+    <section id="install" class="install-section">
+      <div class="container">
+        <h2>Quick Start</h2>
+        <div class="terminal">
+          <div class="terminal-bar">
+            <span class="dot red"></span>
+            <span class="dot yellow"></span>
+            <span class="dot green"></span>
+          </div>
+          <pre><code><span class="prompt">$</span> bash &lt;(curl -fsSL https://agentthreader.com/install.sh) --all
+<span class="dim">==&gt; Bootstrapping agent-threader@latest</span>
+<span class="dim">--&gt; Installing agent-threader@latest globally...</span>
+<span class="dim">--&gt; Delegating to local installer...</span>
+<span class="success">==&gt; Done.</span>
+
+<span class="prompt">$</span> npx --yes agent-threader@latest --help</code></pre>
+        </div>
+        <p class="install-note">The hosted bootstrap script installs the published package, then delegates to the packaged <code>install-local.sh</code> to copy compiled skills into your detected tools.</p>
+        <p class="install-note">Release automation uses <code>AGENT_TOKEN</code> for release commit/tag push and <code>AGENT_NPM_TOKEN</code> for npm publish.</p>
+        <div class="install-links">
+          <a href="/install.sh" class="text-link">View install.sh</a>
+          <a href="https://github.com/barretts/AgentThreader" class="text-link">Repository</a>
+        </div>
+      </div>
+    </section>
+
+    <footer>
+      <div class="container">
+        <p>MIT License &middot; <a href="https://github.com/barretts/AgentThreader">github.com/barretts/AgentThreader</a></p>
+      </div>
+    </footer>
+  </div>
+</body>
+</html>

package/site/install.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# install.sh -- Bootstrap installer for the published agent-threader package
+# Usage: bash <(curl -fsSL https://agentthreader.com/install.sh) [--claude] [--cursor] [--windsurf] [--opencode] [--codex] [--all]
+
+set -euo pipefail
+
+PROJECT_NAME="${AGENT_THREADER_PACKAGE_NAME:-agent-threader}"
+PROJECT_VERSION="${AGENT_THREADER_PACKAGE_VERSION:-latest}"
+CLI_BIN_NAME="agent-threader"
+PACKAGE_SPEC="${PROJECT_NAME}@${PROJECT_VERSION}"
+INSTALLER_ARGS=("$@")
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "ERROR: npm is required but was not found in PATH."
+  exit 1
+fi
+
+echo "==> Bootstrapping ${PACKAGE_SPEC}"
+echo "--> Installing ${PACKAGE_SPEC} globally..."
+npm install -g "$PACKAGE_SPEC"
+
+NPM_ROOT="$(npm root -g)"
+PACKAGE_DIR="$NPM_ROOT/$PROJECT_NAME"
+LOCAL_INSTALLER="$PACKAGE_DIR/install-local.sh"
+
+if [[ ! -f "$LOCAL_INSTALLER" ]]; then
+  echo "ERROR: Could not find install-local.sh in $PACKAGE_DIR"
+  exit 1
+fi
+
+echo "--> Delegating to local installer..."
+bash "$LOCAL_INSTALLER" --skills-only "${INSTALLER_ARGS[@]}"
+
+echo ""
+echo "==> Done."
+echo "CLI available as: $CLI_BIN_NAME"