@mindfoldhq/trellis 0.1.0 → 0.1.1

package/dist/templates/scripts/multi-agent/status.sh.txt

@@ -0,0 +1,423 @@
+#!/bin/bash
+# =============================================================================
+# Multi-Agent Pipeline: Status Monitor
+# =============================================================================
+# Usage:
+#   ./status.sh                     Show summary of all features (default)
+#   ./status.sh --list              List all worktrees and agents
+#   ./status.sh --detail <feature>  Detailed feature status
+#   ./status.sh --watch <feature>   Watch agent log in real-time
+#   ./status.sh --log <feature>     Show recent log entries
+#   ./status.sh --registry          Show agent registry
+# =============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../common/paths.sh"
+source "$SCRIPT_DIR/../common/worktree.sh"
+source "$SCRIPT_DIR/../common/developer.sh"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+DIM='\033[2m'
+NC='\033[0m'
+
+PROJECT_ROOT=$(get_repo_root)
+
+# =============================================================================
+# Parse Arguments
+# =============================================================================
+ACTION="summary"
+TARGET=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --list)
+      ACTION="list"
+      shift
+      ;;
+    --detail)
+      ACTION="detail"
+      TARGET="$2"
+      shift 2
+      ;;
+    --watch)
+      ACTION="watch"
+      TARGET="$2"
+      shift 2
+      ;;
+    --log)
+      ACTION="log"
+      TARGET="$2"
+      shift 2
+      ;;
+    --registry)
+      ACTION="registry"
+      shift
+      ;;
+    -h|--help)
+      ACTION="help"
+      shift
+      ;;
+    *)
+      TARGET="$1"
+      shift
+      ;;
+  esac
+done
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+# Check if PID is running
+is_running() {
+  local pid="$1"
+  [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null
+}
+
+# Get status color
+status_color() {
+  local status="$1"
+  case "$status" in
+    completed) echo "${GREEN}" ;;
+    in_progress) echo "${BLUE}" ;;
+    planning) echo "${YELLOW}" ;;
+    *) echo "${DIM}" ;;
+  esac
+}
+
+# Find agent by feature name or ID
+find_agent() {
+  local search="$1"
+  AGENTS_DIR=$(get_agents_dir)
+  REGISTRY_FILE="${AGENTS_DIR}/registry.json"
+
+  if [ ! -f "$REGISTRY_FILE" ]; then
+    return 1
+  fi
+
+  # Try exact ID match first
+  local agent=$(jq -r --arg id "$search" '.agents[] | select(.id == $id)' "$REGISTRY_FILE" 2>/dev/null)
+
+  # Try partial match on feature_dir
+  if [ -z "$agent" ] || [ "$agent" = "null" ]; then
+    agent=$(jq -r --arg search "$search" '.agents[] | select(.feature_dir | contains($search))' "$REGISTRY_FILE" 2>/dev/null | head -1)
+  fi
+
+  echo "$agent"
+}
+
+# =============================================================================
+# Commands
+# =============================================================================
+
+cmd_help() {
+  cat << EOF
+Multi-Agent Pipeline: Status Monitor
+
+Usage:
+  $0                         Show summary of all features
+  $0 --list                  List all worktrees and agents
+  $0 --detail <feature>      Detailed feature status
+  $0 --watch <feature>       Watch agent log in real-time
+  $0 --log <feature>         Show recent log entries
+  $0 --registry              Show agent registry
+
+Examples:
+  $0 --detail my-feature
+  $0 --watch 16-worktree-support
+  $0 --log worktree-support
+EOF
+}
+
+cmd_list() {
+  echo -e "${BLUE}=== Git Worktrees ===${NC}"
+  echo ""
+  cd "$PROJECT_ROOT"
+  git worktree list
+  echo ""
+
+  echo -e "${BLUE}=== Registered Agents ===${NC}"
+  echo ""
+
+  AGENTS_DIR=$(get_agents_dir)
+  REGISTRY_FILE="${AGENTS_DIR}/registry.json"
+
+  if [ ! -f "$REGISTRY_FILE" ]; then
+    echo "  (no registry found)"
+    return
+  fi
+
+  local agents=$(jq -r '.agents[]' "$REGISTRY_FILE" 2>/dev/null)
+  if [ -z "$agents" ]; then
+    echo "  (no agents registered)"
+    return
+  fi
+
+  jq -r '.agents[] | "\(.id)|\(.pid)|\(.worktree_path)|\(.started_at)"' "$REGISTRY_FILE" 2>/dev/null | while IFS='|' read -r id pid wt started; do
+    local status_icon
+    if is_running "$pid"; then
+      status_icon="${GREEN}●${NC}"
+    else
+      status_icon="${RED}○${NC}"
+    fi
+    echo -e "  $status_icon $id (PID: $pid)"
+    echo -e "    ${DIM}Worktree: $wt${NC}"
+    echo -e "    ${DIM}Started:  $started${NC}"
+    echo ""
+  done
+}
+
+cmd_summary() {
+  ensure_developer
+
+  local features_dir=$(get_features_dir)
+  if [ ! -d "$features_dir" ]; then
+    echo "No features directory found"
+    exit 0
+  fi
+
+  echo -e "${BLUE}=== Feature Summary ===${NC}"
+  echo ""
+
+  AGENTS_DIR=$(get_agents_dir)
+  REGISTRY_FILE="${AGENTS_DIR}/registry.json"
+
+  for d in "$features_dir"/*/; do
+    [ ! -d "$d" ] && continue
+    [[ "$(basename "$d")" == "archive" ]] && continue
+
+    local name=$(basename "$d")
+    local feature_json="$d/feature.json"
+    local status="unknown"
+    local agent_status=""
+
+    if [ -f "$feature_json" ]; then
+      status=$(jq -r '.status // "unknown"' "$feature_json")
+    fi
+
+    # Check agent status
+    if [ -f "$REGISTRY_FILE" ]; then
+      local agent_info=$(jq -r --arg name "$name" '.agents[] | select(.feature_dir | contains($name))' "$REGISTRY_FILE" 2>/dev/null)
+      if [ -n "$agent_info" ] && [ "$agent_info" != "null" ]; then
+        local pid=$(echo "$agent_info" | jq -r '.pid')
+        if is_running "$pid"; then
+          agent_status=" ${GREEN}[agent running]${NC}"
+        else
+          agent_status=" ${RED}[agent stopped]${NC}"
+        fi
+      fi
+    fi
+
+    local color=$(status_color "$status")
+    echo -e "  ${color}●${NC} $name ($status)$agent_status"
+  done
+
+  echo ""
+}
+
+cmd_detail() {
+  if [ -z "$TARGET" ]; then
+    echo "Usage: $0 --detail <feature>"
+    exit 1
+  fi
+
+  local agent=$(find_agent "$TARGET")
+  if [ -z "$agent" ] || [ "$agent" = "null" ]; then
+    echo "Agent not found: $TARGET"
+    exit 1
+  fi
+
+  local id=$(echo "$agent" | jq -r '.id')
+  local pid=$(echo "$agent" | jq -r '.pid')
+  local worktree=$(echo "$agent" | jq -r '.worktree_path')
+  local feature_dir=$(echo "$agent" | jq -r '.feature_dir')
+  local started=$(echo "$agent" | jq -r '.started_at')
+
+  echo -e "${BLUE}=== Agent Detail: $id ===${NC}"
+  echo ""
+  echo "  ID:          $id"
+  echo "  PID:         $pid"
+  echo "  Worktree:    $worktree"
+  echo "  Feature Dir: $feature_dir"
+  echo "  Started:     $started"
+  echo ""
+
+  # Status
+  if is_running "$pid"; then
+    echo -e "  Status:      ${GREEN}Running${NC}"
+  else
+    echo -e "  Status:      ${RED}Stopped${NC}"
+  fi
+
+  # Feature info
+  local feature_json="$PROJECT_ROOT/$feature_dir/feature.json"
+  if [ -f "$feature_json" ]; then
+    echo ""
+    echo -e "${BLUE}=== Feature Info ===${NC}"
+    echo ""
+    local status=$(jq -r '.status // "unknown"' "$feature_json")
+    local branch=$(jq -r '.branch // "N/A"' "$feature_json")
+    local base=$(jq -r '.base_branch // "N/A"' "$feature_json")
+    echo "  Status:      $status"
+    echo "  Branch:      $branch"
+    echo "  Base Branch: $base"
+  fi
+
+  # Git changes
+  if [ -d "$worktree" ]; then
+    echo ""
+    echo -e "${BLUE}=== Git Changes ===${NC}"
+    echo ""
+    cd "$worktree"
+    local changes=$(git status --short 2>/dev/null | head -10)
+    if [ -n "$changes" ]; then
+      echo "$changes" | sed 's/^/  /'
+      local total=$(git status --short 2>/dev/null | wc -l | tr -d ' ')
+      if [ "$total" -gt 10 ]; then
+        echo "  ... and $((total - 10)) more"
+      fi
+    else
+      echo "  (no changes)"
+    fi
+  fi
+
+  echo ""
+}
+
+cmd_watch() {
+  if [ -z "$TARGET" ]; then
+    echo "Usage: $0 --watch <feature>"
+    exit 1
+  fi
+
+  local agent=$(find_agent "$TARGET")
+  if [ -z "$agent" ] || [ "$agent" = "null" ]; then
+    echo "Agent not found: $TARGET"
+    exit 1
+  fi
+
+  local worktree=$(echo "$agent" | jq -r '.worktree_path')
+  local log_file="$worktree/.agent-log"
+
+  if [ ! -f "$log_file" ]; then
+    echo "Log file not found: $log_file"
+    exit 1
+  fi
+
+  echo -e "${BLUE}Watching:${NC} $log_file"
+  echo -e "${DIM}Press Ctrl+C to stop${NC}"
+  echo ""
+
+  tail -f "$log_file"
+}
+
+cmd_log() {
+  if [ -z "$TARGET" ]; then
+    echo "Usage: $0 --log <feature>"
+    exit 1
+  fi
+
+  local agent=$(find_agent "$TARGET")
+  if [ -z "$agent" ] || [ "$agent" = "null" ]; then
+    echo "Agent not found: $TARGET"
+    exit 1
+  fi
+
+  local worktree=$(echo "$agent" | jq -r '.worktree_path')
+  local log_file="$worktree/.agent-log"
+
+  if [ ! -f "$log_file" ]; then
+    echo "Log file not found: $log_file"
+    exit 1
+  fi
+
+  echo -e "${BLUE}=== Recent Log: $TARGET ===${NC}"
+  echo ""
+
+  # Parse and format JSON log entries
+  tail -50 "$log_file" | while IFS= read -r line; do
+    local type=$(echo "$line" | jq -r '.type // empty' 2>/dev/null)
+    [ -z "$type" ] && continue
+
+    case "$type" in
+      system)
+        local subtype=$(echo "$line" | jq -r '.subtype // ""' 2>/dev/null)
+        echo -e "${CYAN}[SYSTEM]${NC} $subtype"
+        ;;
+      user)
+        local content=$(echo "$line" | jq -r '.message.content // empty' 2>/dev/null)
+        if [ -n "$content" ] && [ "$content" != "null" ]; then
+          echo -e "${GREEN}[USER]${NC} ${content:0:200}"
+        fi
+        ;;
+      assistant)
+        # Extract text or tool use
+        local text=$(echo "$line" | jq -r '.message.content[0].text // empty' 2>/dev/null)
+        local tool=$(echo "$line" | jq -r '.message.content[0].name // empty' 2>/dev/null)
+
+        if [ -n "$text" ] && [ "$text" != "null" ]; then
+          # Truncate long text
+          local display="${text:0:300}"
+          [ ${#text} -gt 300 ] && display="$display..."
+          echo -e "${BLUE}[ASSISTANT]${NC} $display"
+        elif [ -n "$tool" ] && [ "$tool" != "null" ]; then
+          echo -e "${YELLOW}[TOOL]${NC} $tool"
+        fi
+        ;;
+      result)
+        local tool_name=$(echo "$line" | jq -r '.tool // "unknown"' 2>/dev/null)
+        echo -e "${DIM}[RESULT]${NC} $tool_name completed"
+        ;;
+    esac
+  done
+}
+
+cmd_registry() {
+  AGENTS_DIR=$(get_agents_dir)
+  REGISTRY_FILE="${AGENTS_DIR}/registry.json"
+
+  echo -e "${BLUE}=== Agent Registry ===${NC}"
+  echo ""
+  echo "File: $REGISTRY_FILE"
+  echo ""
+
+  if [ -f "$REGISTRY_FILE" ]; then
+    jq '.' "$REGISTRY_FILE"
+  else
+    echo "(registry not found)"
+  fi
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+case "$ACTION" in
+  help)
+    cmd_help
+    ;;
+  list)
+    cmd_list
+    ;;
+  summary)
+    cmd_summary
+    ;;
+  detail)
+    cmd_detail
+    ;;
+  watch)
+    cmd_watch
+    ;;
+  log)
+    cmd_log
+    ;;
+  registry)
+    cmd_registry
+    ;;
+esac

package/dist/templates/scripts/worktree.yaml.txt

@@ -0,0 +1,49 @@
+# Worktree Configuration for Multi-Agent Pipeline
+# Used for worktree initialization in multi-agent workflows
+#
+# All paths are relative to project root
+
+#-------------------------------------------------------------------------------
+# Paths
+#-------------------------------------------------------------------------------
+
+# Worktree storage directory (relative to project root)
+worktree_dir: ../worktrees
+
+#-------------------------------------------------------------------------------
+# Files to Copy
+#-------------------------------------------------------------------------------
+
+# Files to copy to each worktree (each worktree needs independent copy)
+# These files contain sensitive info or need worktree-independent config
+copy:
+  # Environment variables (uncomment and customize as needed)
+  # - .env
+  # - .env.local
+  # Workflow config
+  - .trellis/.developer
+
+#-------------------------------------------------------------------------------
+# Post-Create Hooks
+#-------------------------------------------------------------------------------
+
+# Commands to run after creating worktree
+# Executed in worktree directory, in order, abort on failure
+post_create:
+  # Install dependencies (uncomment based on your package manager)
+  # - npm install
+  # - pnpm install --frozen-lockfile
+  # - yarn install --frozen-lockfile
+
+#-------------------------------------------------------------------------------
+# Pre-Merge Checks
+#-------------------------------------------------------------------------------
+
+# Pre-merge validation (used by create-pr.sh)
+pre_merge:
+  # Type checking (uncomment based on your setup)
+  # - npm run typecheck
+  # - pnpm typecheck
+  # Linting
+  # - npm run lint
+  # - pnpm lint

package/dist/types/ai-tools.d.ts

@@ -6,11 +6,11 @@
 /**
  * Supported AI coding tools
  */
-export type AITool = "claude-code" | "cursor";
+export type AITool = "claude-code" | "cursor" | "opencode";
 /**
  * Template directory categories
  */
-export type TemplateDir = "common" | "claude" | "cursor";
+export type TemplateDir = "common" | "claude" | "cursor" | "opencode";
 /**
  * Configuration for an AI tool
  */

package/dist/types/ai-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CASjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAE3D"}
+{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAajD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAE3D"}

package/dist/types/ai-tools.js

@@ -15,6 +15,10 @@ export const AI_TOOLS = {
         name: "Cursor",
         templateDirs: ["common", "cursor"],
     },
+    opencode: {
+        name: "OpenCode",
+        templateDirs: ["common", "opencode"],
+    },
 };
 /**
  * Get the configuration for a specific AI tool

package/dist/types/ai-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAiC;IACpD,aAAa,EAAE;QACb,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACnC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACnC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AACrC,CAAC"}
+{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAiC;IACpD,aAAa,EAAE;QACb,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACnC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACnC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;KACrC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AACrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindfoldhq/trellis",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",

package/dist/templates/agents/check.txt

@@ -1,120 +0,0 @@
----
-name: check
-description: |
-  Code and cross-layer check expert. Hook auto-injects all check specs and dev specs.
-  After receiving context: get diff → check against specs → self-fix issues.
-  Fix issues yourself, not just report them.
-tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-model: opus
----
-
-# Check Agent
-
-You are the Check Agent in the Multi-Agent Pipeline.
-
-## Context Auto-Injected
-
-> **Important**: Hook has automatically injected the following into your context:
->
-> - All check specs and dev specs (defined in check.jsonl)
-> - Requirements document (for understanding feature intent)
->
-> Typically includes: finish-work.md, check-*.md, quality.md, etc.
-> You don't need to manually read these files, just refer to the injected context.
-
-## Core Responsibilities
-
-1. **Get code changes** - Use git diff to get uncommitted code
-2. **Check against specs** - Refer to check specs in context
-3. **Self-fix** - Fix issues yourself, not just report them
-4. **Run verification** - typecheck and lint
-
-## Important
-
-**Fix issues yourself**, don't just report to Dispatch.
-
-You have Write and Edit tools, you can modify code directly.
-
----
-
-## Workflow
-
-### Step 1: Get Changes
-
-```bash
-git diff --name-only  # List changed files
-git diff              # View specific changes
-```
-
-### Step 2: Check Against Specs
-
-Refer to injected specs in context to check code:
-
-- Does it follow directory structure conventions
-- Does it follow naming conventions
-- Does it follow code patterns
-- Are there missing types
-- Are there potential bugs
-
-**Pay special attention to finish-work.md checklist**:
-
-- Impact radius analysis (L1-L5)
-- Documentation sync check
-- Interface completeness
-- Cross-layer verification
-
-### Step 3: Self-Fix
-
-After finding issues:
-
-1. Fix the issue directly (use Edit tool)
-2. Record what was fixed
-3. Continue checking other issues
-
-### Step 4: Run Verification
-
-Reference `.husky/pre-commit` verification logic:
-
-```bash
-cat .husky/pre-commit
-```
-
-Execute checks according to the script. If failed, fix issues and re-run.
-
----
-
-## Report Format
-
-```markdown
-## Self-Check Complete
-
-### Files Checked
-
-- src/components/Feature.tsx
-- src/hooks/useFeature.ts
-- src/services/feature/procedures/create.ts
-
-### Issues Found and Fixed
-
-1. ✅ `src/components/Feature.tsx:25` - Missing return type, added
-2. ✅ `src/hooks/useFeature.ts:12` - Unused import, removed
-3. ✅ `src/services/feature/procedures/create.ts:8` - Timestamp used seconds, changed to milliseconds
-
-### Impact Radius Analysis
-
-- L2 module-level change: Added useFeature hook
-- No documentation update needed (not L3+ change)
-
-### Issues Not Fixed
-
-(If there are issues that cannot be self-fixed, list them here with reasons)
-
-### Verification Results
-
-- TypeCheck: ✅ Passed
-- Lint: ✅ Passed
-
-### Summary
-
-Checked 3 files, found 3 issues, all fixed.
-```