deepspider 0.1.0

package/.trellis/scripts/common/worktree.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+# Worktree utilities for Multi-Agent Pipeline
+#
+# Usage: source this file in multi-agent scripts
+#   source "$(dirname "$0")/../common/worktree.sh"
+#
+# Provides:
+#   get_worktree_config         - Get worktree.yaml path
+#   get_worktree_base_dir       - Get worktree storage directory
+#   get_worktree_copy_files     - Get files to copy list
+#   get_worktree_post_create_hooks - Get post-create hooks
+#   get_agents_dir              - Get agents registry directory
+#
+# Requires: paths.sh (for get_repo_root)
+
+# Ensure paths.sh is loaded
+if ! type get_repo_root &>/dev/null; then
+  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  source "$SCRIPT_DIR/paths.sh"
+fi
+
+# =============================================================================
+# Worktree Configuration
+# =============================================================================
+
+# Worktree config file relative path (relative to repo root)
+WORKTREE_CONFIG_PATH="$DIR_WORKFLOW/worktree.yaml"
+
+# Get worktree.yaml config file path
+# Args: $1 - repo_root (optional)
+# Returns: absolute path to config file
+get_worktree_config() {
+  local repo_root="${1:-$(get_repo_root)}"
+  echo "$repo_root/$WORKTREE_CONFIG_PATH"
+}
+
+# Read simple value from worktree.yaml
+# Args: $1 - key, $2 - config_file (optional)
+# Returns: value
+_yaml_get_value() {
+  local key="$1"
+  local config="${2:-$(get_worktree_config)}"
+  grep "^${key}:" "$config" 2>/dev/null | sed "s/^${key}:[[:space:]]*//" | tr -d '"' | tr -d "'"
+}
+
+# Read list from worktree.yaml
+# Args: $1 - section, $2 - config_file (optional)
+# Returns: list items (one per line)
+_yaml_get_list() {
+  local section="$1"
+  local config="${2:-$(get_worktree_config)}"
+  local in_section=0
+
+  while IFS= read -r line; do
+    if [[ "$line" =~ ^${section}: ]]; then
+      in_section=1
+      continue
+    fi
+
+    if [ $in_section -eq 1 ]; then
+      # Exit when encountering new top-level key
+      if [[ "$line" =~ ^[a-z_]+: ]] && [[ ! "$line" =~ ^[[:space:]] ]]; then
+        break
+      fi
+      # Read list item
+      if [[ "$line" =~ ^[[:space:]]*-[[:space:]](.+)$ ]]; then
+        echo "${BASH_REMATCH[1]}" | tr -d '"' | tr -d "'"
+      fi
+    fi
+  done < "$config"
+}
+
+# Get worktree base directory
+# Args: $1 - repo_root (optional)
+# Returns: absolute path to worktree base directory
+get_worktree_base_dir() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local config=$(get_worktree_config "$repo_root")
+  local worktree_dir=$(_yaml_get_value "worktree_dir" "$config")
+
+  # Default value
+  if [ -z "$worktree_dir" ]; then
+    worktree_dir="../worktrees"
+  fi
+
+  # Handle relative path
+  if [[ "$worktree_dir" == ../* ]] || [[ "$worktree_dir" == ./* ]]; then
+    # Relative to repo_root
+    echo "$repo_root/$worktree_dir"
+  else
+    # Absolute path
+    echo "$worktree_dir"
+  fi
+}
+
+# Get files to copy list
+# Args: $1 - repo_root (optional)
+# Returns: file list (one per line)
+get_worktree_copy_files() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local config=$(get_worktree_config "$repo_root")
+  _yaml_get_list "copy" "$config"
+}
+
+# Get post_create hooks
+# Args: $1 - repo_root (optional)
+# Returns: command list (one per line)
+get_worktree_post_create_hooks() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local config=$(get_worktree_config "$repo_root")
+  _yaml_get_list "post_create" "$config"
+}
+
+# =============================================================================
+# Agents Registry
+# =============================================================================
+
+# Get agents directory for current developer
+# Args: $1 - repo_root (optional)
+# Returns: absolute path to agents directory
+get_agents_dir() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local workspace_dir=$(get_workspace_dir "$repo_root")
+
+  if [[ -n "$workspace_dir" ]]; then
+    echo "$workspace_dir/.agents"
+  fi
+}

package/.trellis/scripts/create-bootstrap.sh

@@ -0,0 +1,299 @@
+#!/bin/bash
+# Create Bootstrap Task for First-Time Setup
+#
+# Creates a guided task to help users fill in project guidelines
+# after initializing Trellis for the first time.
+#
+# Usage:
+#   ./.trellis/scripts/create-bootstrap.sh [project-type]
+#
+# Arguments:
+#   project-type: frontend | backend | fullstack (default: fullstack)
+#
+# Prerequisites:
+#   - .trellis/.developer must exist (run init-developer.sh first)
+#
+# Creates:
+#   .trellis/tasks/00-bootstrap-guidelines/
+#     ├── task.json    # Task metadata
+#     └── prd.md       # Task description and guidance
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common/paths.sh"
+source "$SCRIPT_DIR/common/developer.sh"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+TASK_NAME="00-bootstrap-guidelines"
+
+# Project type (default: fullstack)
+PROJECT_TYPE="${1:-fullstack}"
+
+# Validate project type
+case "$PROJECT_TYPE" in
+  frontend|backend|fullstack)
+    ;;
+  *)
+    echo -e "${YELLOW}Unknown project type: $PROJECT_TYPE, defaulting to fullstack${NC}"
+    PROJECT_TYPE="fullstack"
+    ;;
+esac
+
+# =============================================================================
+# PRD Content
+# =============================================================================
+
+write_prd_header() {
+  cat << 'EOF'
+# Bootstrap: Fill Project Development Guidelines
+
+## Purpose
+
+Welcome to Trellis! This is your first task.
+
+AI agents use `.trellis/spec/` to understand YOUR project's coding conventions.
+**Empty templates = AI writes generic code that doesn't match your project style.**
+
+Filling these guidelines is a one-time setup that pays off for every future AI session.
+
+---
+
+## Your Task
+
+Fill in the guideline files based on your **existing codebase**.
+EOF
+}
+
+write_prd_backend_section() {
+  cat << 'EOF'
+
+### Backend Guidelines
+
+| File | What to Document |
+|------|------------------|
+| `.trellis/spec/backend/directory-structure.md` | Where different file types go (routes, services, utils) |
+| `.trellis/spec/backend/database-guidelines.md` | ORM, migrations, query patterns, naming conventions |
+| `.trellis/spec/backend/error-handling.md` | How errors are caught, logged, and returned |
+| `.trellis/spec/backend/logging-guidelines.md` | Log levels, format, what to log |
+| `.trellis/spec/backend/quality-guidelines.md` | Code review standards, testing requirements |
+EOF
+}
+
+write_prd_frontend_section() {
+  cat << 'EOF'
+
+### Frontend Guidelines
+
+| File | What to Document |
+|------|------------------|
+| `.trellis/spec/frontend/directory-structure.md` | Component/page/hook organization |
+| `.trellis/spec/frontend/component-guidelines.md` | Component patterns, props conventions |
+| `.trellis/spec/frontend/hook-guidelines.md` | Custom hook naming, patterns |
+| `.trellis/spec/frontend/state-management.md` | State library, patterns, what goes where |
+| `.trellis/spec/frontend/type-safety.md` | TypeScript conventions, type organization |
+| `.trellis/spec/frontend/quality-guidelines.md` | Linting, testing, accessibility |
+EOF
+}
+
+write_prd_footer() {
+  cat << 'EOF'
+
+### Thinking Guides (Optional)
+
+The `.trellis/spec/guides/` directory contains thinking guides that are already
+filled with general best practices. You can customize them for your project if needed.
+
+---
+
+## How to Fill Guidelines
+
+### Principle: Document Reality, Not Ideals
+
+Write what your codebase **actually does**, not what you wish it did.
+AI needs to match existing patterns, not introduce new ones.
+
+### Steps
+
+1. **Look at existing code** - Find 2-3 examples of each pattern
+2. **Document the pattern** - Describe what you see
+3. **Include file paths** - Reference real files as examples
+4. **List anti-patterns** - What does your team avoid?
+
+---
+
+## Tips for Using AI
+
+Ask AI to help analyze your codebase:
+
+- "Look at my codebase and document the patterns you see"
+- "Analyze my code structure and summarize the conventions"
+- "Find error handling patterns and document them"
+
+The AI will read your code and help you document it.
+
+---
+
+## Completion Checklist
+
+- [ ] Guidelines filled for your project type
+- [ ] At least 2-3 real code examples in each guideline
+- [ ] Anti-patterns documented
+
+When done:
+
+```bash
+./.trellis/scripts/task.sh finish
+./.trellis/scripts/task.sh archive 00-bootstrap-guidelines
+```
+
+---
+
+## Why This Matters
+
+After completing this task:
+
+1. AI will write code that matches your project style
+2. Relevant `/trellis:before-*-dev` commands will inject real context
+3. `/trellis:check-*` commands will validate against your actual standards
+4. Future developers (human or AI) will onboard faster
+EOF
+}
+
+write_prd() {
+  local dir="$1"
+  local project_type="$2"
+
+  {
+    write_prd_header
+
+    case "$project_type" in
+      frontend)
+        write_prd_frontend_section
+        ;;
+      backend)
+        write_prd_backend_section
+        ;;
+      fullstack)
+        write_prd_backend_section
+        write_prd_frontend_section
+        ;;
+    esac
+
+    write_prd_footer
+  } > "$dir/prd.md"
+}
+
+# =============================================================================
+# Task JSON
+# =============================================================================
+
+write_task_json() {
+  local dir="$1"
+  local developer="$2"
+  local project_type="$3"
+  local today=$(date +%Y-%m-%d)
+
+  # Generate subtasks based on project type
+  local subtasks
+  local related_files
+
+  case "$project_type" in
+    frontend)
+      subtasks='[
+    {"name": "Fill frontend guidelines", "status": "pending"},
+    {"name": "Add code examples", "status": "pending"}
+  ]'
+      related_files='[
+    ".trellis/spec/frontend/"
+  ]'
+      ;;
+    backend)
+      subtasks='[
+    {"name": "Fill backend guidelines", "status": "pending"},
+    {"name": "Add code examples", "status": "pending"}
+  ]'
+      related_files='[
+    ".trellis/spec/backend/"
+  ]'
+      ;;
+    fullstack)
+      subtasks='[
+    {"name": "Fill backend guidelines", "status": "pending"},
+    {"name": "Fill frontend guidelines", "status": "pending"},
+    {"name": "Add code examples", "status": "pending"}
+  ]'
+      related_files='[
+    ".trellis/spec/backend/",
+    ".trellis/spec/frontend/"
+  ]'
+      ;;
+  esac
+
+  cat > "$dir/task.json" << EOF
+{
+  "id": "$TASK_NAME",
+  "name": "Bootstrap Guidelines",
+  "description": "Fill in project development guidelines for AI agents",
+  "status": "in_progress",
+  "dev_type": "docs",
+  "priority": "P1",
+  "creator": "$developer",
+  "assignee": "$developer",
+  "createdAt": "$today",
+  "completedAt": null,
+  "commit": null,
+  "subtasks": $subtasks,
+  "relatedFiles": $related_files,
+  "notes": "First-time setup task created by trellis init ($project_type project)"
+}
+EOF
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+
+main() {
+  local repo_root=$(get_repo_root)
+  local developer=$(get_developer "$repo_root")
+
+  # Check developer initialized
+  if [[ -z "$developer" ]]; then
+    echo -e "${RED}Error: Developer not initialized${NC}"
+    echo "Run: ./$DIR_WORKFLOW/$DIR_SCRIPTS/init-developer.sh <your-name>"
+    exit 1
+  fi
+
+  local tasks_dir=$(get_tasks_dir "$repo_root")
+  local task_dir="$tasks_dir/$TASK_NAME"
+  local relative_path="$DIR_WORKFLOW/$DIR_TASKS/$TASK_NAME"
+
+  # Check if already exists
+  if [[ -d "$task_dir" ]]; then
+    echo -e "${YELLOW}Bootstrap task already exists: $relative_path${NC}"
+    exit 0
+  fi
+
+  # Create task directory
+  mkdir -p "$task_dir"
+
+  # Write files
+  write_task_json "$task_dir" "$developer" "$PROJECT_TYPE"
+  write_prd "$task_dir" "$PROJECT_TYPE"
+
+  # Set as current task
+  set_current_task "$relative_path" "$repo_root"
+
+  # Silent output - init command handles user-facing messages
+  # Only output the task path for programmatic use
+  echo "$relative_path"
+}
+
+main "$@"

package/.trellis/scripts/get-context.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Get Session Context for AI Agent
+#
+# This is a wrapper that calls the actual implementation in common/git-context.sh
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec "$SCRIPT_DIR/common/git-context.sh" "$@"

package/.trellis/scripts/get-developer.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Get current developer name
+#
+# This is a wrapper that uses common/paths.sh
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common/paths.sh"
+
+developer=$(get_developer)
+if [[ -n "$developer" ]]; then
+  echo "$developer"
+else
+  echo "Developer not initialized" >&2
+  exit 1
+fi

package/.trellis/scripts/init-developer.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Initialize developer for workflow
+#
+# Usage:
+#   ./.trellis/scripts/init-developer.sh <developer-name>
+#
+# This creates:
+#   - .trellis/.developer file with developer info
+#   - .trellis/workspace/<name>/ directory structure
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common/paths.sh"
+source "$SCRIPT_DIR/common/developer.sh"
+
+if [[ -z "$1" ]]; then
+  echo "Usage: $0 <developer-name>"
+  echo ""
+  echo "Example:"
+  echo "  $0 john"
+  exit 1
+fi
+
+# Check if already initialized
+existing=$(get_developer)
+if [[ -n "$existing" ]]; then
+  echo "Developer already initialized: $existing"
+  echo ""
+  echo "To reinitialize, remove $DIR_WORKFLOW/$FILE_DEVELOPER first"
+  exit 0
+fi
+
+init_developer "$1"