@fifine/aim-studio 0.0.1

package/dist/templates/trellis/scripts-shell-archive/common/git-context.sh

@@ -0,0 +1,263 @@
+#!/bin/bash
+# Git and Session Context utilities
+#
+# Usage:
+#   ./.trellis/scripts/common/git-context.sh           # Full context output
+#   ./.trellis/scripts/common/git-context.sh --json    # JSON format
+#
+# Or source in other scripts:
+#   source "$(dirname "$0")/common/git-context.sh"
+
+set -e
+
+COMMON_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$COMMON_DIR/paths.sh"
+source "$COMMON_DIR/developer.sh"
+
+# =============================================================================
+# JSON Output
+# =============================================================================
+
+output_json() {
+  local repo_root=$(get_repo_root)
+  local developer=$(get_developer "$repo_root")
+  local tasks_dir=$(get_tasks_dir "$repo_root")
+  local journal_file=$(get_active_journal_file "$repo_root")
+  local journal_lines=0
+  local journal_relative=""
+
+  if [[ -n "$journal_file" ]]; then
+    journal_lines=$(count_lines "$journal_file")
+    journal_relative="$DIR_WORKFLOW/$DIR_WORKSPACE/$developer/$(basename "$journal_file")"
+  fi
+
+  local branch=$(git branch --show-current 2>/dev/null || echo "unknown")
+  local git_status=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+  local is_clean="true"
+  [[ "$git_status" != "0" ]] && is_clean="false"
+
+  # Build commits JSON
+  local commits_json="["
+  local first=true
+  while IFS= read -r line; do
+    local hash=$(echo "$line" | cut -d' ' -f1)
+    local msg=$(echo "$line" | cut -d' ' -f2-)
+    msg=$(echo "$msg" | sed 's/"/\\"/g')
+    if [[ "$first" == "true" ]]; then
+      first=false
+    else
+      commits_json+=","
+    fi
+    commits_json+="{\"hash\":\"$hash\",\"message\":\"$msg\"}"
+  done < <(git log --oneline -5 2>/dev/null || echo "")
+  commits_json+="]"
+
+  # Build tasks JSON
+  local tasks_json="["
+  first=true
+  if [[ -d "$tasks_dir" ]]; then
+    for d in "$tasks_dir"/*/; do
+      if [[ -d "$d" ]] && [[ "$(basename "$d")" != "archive" ]]; then
+        local task_json="$d/$FILE_TASK_JSON"
+        if [[ -f "$task_json" ]]; then
+          local dir_name=$(basename "$d")
+          local name=$(jq -r '.name // .id // "unknown"' "$task_json" 2>/dev/null)
+          local status=$(jq -r '.status // "unknown"' "$task_json" 2>/dev/null)
+          if [[ "$first" == "true" ]]; then
+            first=false
+          else
+            tasks_json+=","
+          fi
+          tasks_json+="{\"dir\":\"$dir_name\",\"name\":\"$name\",\"status\":\"$status\"}"
+        fi
+      fi
+    done
+  fi
+  tasks_json+="]"
+
+  cat << EOF
+{
+  "developer": "$developer",
+  "git": {
+    "branch": "$branch",
+    "isClean": $is_clean,
+    "uncommittedChanges": $git_status,
+    "recentCommits": $commits_json
+  },
+  "tasks": {
+    "active": $tasks_json,
+    "directory": "$DIR_WORKFLOW/$DIR_TASKS"
+  },
+  "journal": {
+    "file": "$journal_relative",
+    "lines": $journal_lines,
+    "nearLimit": $([ "$journal_lines" -gt 1800 ] && echo "true" || echo "false")
+  }
+}
+EOF
+}
+
+# =============================================================================
+# Text Output
+# =============================================================================
+
+output_text() {
+  local repo_root=$(get_repo_root)
+  local developer=$(get_developer "$repo_root")
+
+  echo "========================================"
+  echo "SESSION CONTEXT"
+  echo "========================================"
+  echo ""
+
+  echo "## DEVELOPER"
+  if [[ -z "$developer" ]]; then
+    echo "ERROR: Not initialized. Run: ./$DIR_WORKFLOW/$DIR_SCRIPTS/init-developer.sh <name>"
+    exit 1
+  fi
+  echo "Name: $developer"
+  echo ""
+
+  echo "## GIT STATUS"
+  echo "Branch: $(git branch --show-current 2>/dev/null || echo 'unknown')"
+  local status_count=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+  if [[ "$status_count" == "0" ]]; then
+    echo "Working directory: Clean"
+  else
+    echo "Working directory: $status_count uncommitted change(s)"
+    echo ""
+    echo "Changes:"
+    git status --short 2>/dev/null | head -10
+  fi
+  echo ""
+
+  echo "## RECENT COMMITS"
+  git log --oneline -5 2>/dev/null || echo "(no commits)"
+  echo ""
+
+  echo "## CURRENT TASK"
+  local current_task=$(get_current_task "$repo_root")
+  if [[ -n "$current_task" ]]; then
+    local current_task_dir="$repo_root/$current_task"
+    local task_json="$current_task_dir/$FILE_TASK_JSON"
+    echo "Path: $current_task"
+
+    if [[ -f "$task_json" ]]; then
+      if command -v jq &> /dev/null; then
+        local t_name=$(jq -r '.name // .id // "unknown"' "$task_json")
+        local t_status=$(jq -r '.status // "unknown"' "$task_json")
+        local t_created=$(jq -r '.createdAt // "unknown"' "$task_json")
+        local t_desc=$(jq -r '.description // ""' "$task_json")
+        echo "Name: $t_name"
+        echo "Status: $t_status"
+        echo "Created: $t_created"
+        if [[ -n "$t_desc" ]]; then
+          echo "Description: $t_desc"
+        fi
+      fi
+    fi
+
+    # Check for prd.md
+    if [[ -f "$current_task_dir/prd.md" ]]; then
+      echo ""
+      echo "[!] This task has prd.md - read it for task details"
+    fi
+  else
+    echo "(none)"
+  fi
+  echo ""
+
+  echo "## ACTIVE TASKS"
+  local tasks_dir=$(get_tasks_dir "$repo_root")
+  local task_count=0
+  if [[ -d "$tasks_dir" ]]; then
+    for d in "$tasks_dir"/*/; do
+      if [[ -d "$d" ]] && [[ "$(basename "$d")" != "archive" ]]; then
+        local dir_name=$(basename "$d")
+        local t_json="$d/$FILE_TASK_JSON"
+        local status="unknown"
+        local assignee="-"
+        if [[ -f "$t_json" ]] && command -v jq &> /dev/null; then
+          status=$(jq -r '.status // "unknown"' "$t_json")
+          assignee=$(jq -r '.assignee // "-"' "$t_json")
+        fi
+        echo "- $dir_name/ ($status) @$assignee"
+        ((task_count++)) || true
+      fi
+    done
+  fi
+  if [[ $task_count -eq 0 ]]; then
+    echo "(no active tasks)"
+  fi
+  echo "Total: $task_count active task(s)"
+  echo ""
+
+  echo "## MY TASKS (Assigned to me)"
+  local my_task_count=0
+  if [[ -d "$tasks_dir" ]]; then
+    for d in "$tasks_dir"/*/; do
+      if [[ -d "$d" ]] && [[ "$(basename "$d")" != "archive" ]]; then
+        local t_json="$d/$FILE_TASK_JSON"
+        if [[ -f "$t_json" ]] && command -v jq &> /dev/null; then
+          local assignee=$(jq -r '.assignee // ""' "$t_json")
+          local status=$(jq -r '.status // "planning"' "$t_json")
+          if [[ "$assignee" == "$developer" ]] && [[ "$status" != "done" ]]; then
+            local title=$(jq -r '.title // .name // "unknown"' "$t_json")
+            local priority=$(jq -r '.priority // "P2"' "$t_json")
+            echo "- [$priority] $title ($status)"
+            ((my_task_count++)) || true
+          fi
+        fi
+      fi
+    done
+  fi
+  if [[ $my_task_count -eq 0 ]]; then
+    echo "(no tasks assigned to you)"
+  fi
+  echo ""
+
+  echo "## JOURNAL FILE"
+  local journal_file=$(get_active_journal_file "$repo_root")
+  if [[ -n "$journal_file" ]]; then
+    local lines=$(count_lines "$journal_file")
+    local relative="$DIR_WORKFLOW/$DIR_WORKSPACE/$developer/$(basename "$journal_file")"
+    echo "Active file: $relative"
+    echo "Line count: $lines / 2000"
+    if [[ "$lines" -gt 1800 ]]; then
+      echo "[!] WARNING: Approaching 2000 line limit!"
+    fi
+  else
+    echo "No journal file found"
+  fi
+  echo ""
+
+  echo "## PATHS"
+  echo "Workspace: $DIR_WORKFLOW/$DIR_WORKSPACE/$developer/"
+  echo "Tasks: $DIR_WORKFLOW/$DIR_TASKS/"
+  echo "Spec: $DIR_WORKFLOW/$DIR_SPEC/"
+  echo ""
+
+  echo "========================================"
+}
+
+# =============================================================================
+# Main Entry
+# =============================================================================
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  case "${1:-}" in
+    --json|-j)
+      output_json
+      ;;
+    --help|-h)
+      echo "Get Session Context for AI Agent"
+      echo ""
+      echo "Usage:"
+      echo "  $0           Output context in text format"
+      echo "  $0 --json    Output context in JSON format"
+      ;;
+    *)
+      output_text
+      ;;
+  esac
+fi

package/dist/templates/trellis/scripts-shell-archive/common/paths.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+# Common path utilities for Trellis workflow
+#
+# Usage: source this file in other scripts
+#   source "$(dirname "$0")/common/paths.sh"
+#
+# Provides:
+#   get_repo_root          - Get repository root directory
+#   get_developer          - Get developer name
+#   get_workspace_dir      - Get developer workspace directory
+#   get_tasks_dir          - Get tasks directory
+#   get_active_journal_file - Get current journal file
+
+# =============================================================================
+# Path Constants (change here to rename directories)
+# =============================================================================
+
+# Directory names
+DIR_WORKFLOW=".trellis"
+DIR_WORKSPACE="workspace"
+DIR_TASKS="tasks"
+DIR_ARCHIVE="archive"
+DIR_SPEC="spec"
+DIR_SCRIPTS="scripts"
+
+# File names
+FILE_DEVELOPER=".developer"
+FILE_CURRENT_TASK=".current-task"
+FILE_TASK_JSON="task.json"
+FILE_JOURNAL_PREFIX="journal-"
+
+# =============================================================================
+# Repository Root
+# =============================================================================
+
+get_repo_root() {
+  # Find the nearest directory containing .trellis/ folder
+  # This handles nested git repos correctly (e.g., test project inside another repo)
+  local current="$PWD"
+
+  while [[ "$current" != "/" ]]; do
+    if [[ -d "$current/$DIR_WORKFLOW" ]]; then
+      echo "$current"
+      return
+    fi
+    current=$(dirname "$current")
+  done
+
+  # Fallback to current directory if no .trellis/ found
+  echo "$PWD"
+}
+
+# =============================================================================
+# Developer
+# =============================================================================
+
+get_developer() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local dev_file="$repo_root/$DIR_WORKFLOW/$FILE_DEVELOPER"
+
+  if [[ -f "$dev_file" ]]; then
+    grep "^name=" "$dev_file" 2>/dev/null | cut -d'=' -f2
+  fi
+}
+
+check_developer() {
+  local developer=$(get_developer "$1")
+  [[ -n "$developer" ]]
+}
+
+# =============================================================================
+# Tasks Directory
+# =============================================================================
+
+get_tasks_dir() {
+  local repo_root="${1:-$(get_repo_root)}"
+  echo "$repo_root/$DIR_WORKFLOW/$DIR_TASKS"
+}
+
+# =============================================================================
+# Workspace Directory
+# =============================================================================
+
+get_workspace_dir() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local developer=$(get_developer "$repo_root")
+
+  if [[ -n "$developer" ]]; then
+    echo "$repo_root/$DIR_WORKFLOW/$DIR_WORKSPACE/$developer"
+  fi
+}
+
+# =============================================================================
+# Journal File
+# =============================================================================
+
+get_active_journal_file() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local workspace_dir=$(get_workspace_dir "$repo_root")
+
+  if [[ -z "$workspace_dir" ]] || [[ ! -d "$workspace_dir" ]]; then
+    echo ""
+    return
+  fi
+
+  local latest=""
+  local highest=0
+  for f in "$workspace_dir"/${FILE_JOURNAL_PREFIX}*.md; do
+    if [[ -f "$f" ]]; then
+      local num=$(basename "$f" | sed "s/${FILE_JOURNAL_PREFIX}//" | sed 's/\.md//')
+      if [[ "$num" =~ ^[0-9]+$ ]] && [[ "$num" -gt "$highest" ]]; then
+        highest=$num
+        latest="$f"
+      fi
+    fi
+  done
+
+  if [[ -n "$latest" ]]; then
+    echo "$latest"
+  fi
+}
+
+count_lines() {
+  local file="$1"
+  if [[ -f "$file" ]]; then
+    wc -l < "$file" | tr -d ' '
+  else
+    echo "0"
+  fi
+}
+
+# =============================================================================
+# Current Task Management
+# =============================================================================
+
+# Get .current-task file path
+_get_current_task_file() {
+  local repo_root="${1:-$(get_repo_root)}"
+  echo "$repo_root/$DIR_WORKFLOW/$FILE_CURRENT_TASK"
+}
+
+# Get current task directory path (relative to repo_root)
+get_current_task() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local current_file=$(_get_current_task_file "$repo_root")
+
+  if [[ -f "$current_file" ]]; then
+    cat "$current_file" 2>/dev/null
+  fi
+}
+
+# Get current task directory absolute path
+get_current_task_abs() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local relative=$(get_current_task "$repo_root")
+
+  if [[ -n "$relative" ]]; then
+    echo "$repo_root/$relative"
+  fi
+}
+
+# Set current task
+# Args: $1 - task directory path (relative to repo_root)
+set_current_task() {
+  local task_path="$1"
+  local repo_root="${2:-$(get_repo_root)}"
+  local current_file=$(_get_current_task_file "$repo_root")
+
+  if [[ -z "$task_path" ]]; then
+    echo "Error: task path is required" >&2
+    return 1
+  fi
+
+  # Verify task directory exists
+  local full_path="$repo_root/$task_path"
+  if [[ ! -d "$full_path" ]]; then
+    echo "Error: task directory not found: $task_path" >&2
+    return 1
+  fi
+
+  echo "$task_path" > "$current_file"
+}
+
+# Clear current task
+clear_current_task() {
+  local repo_root="${1:-$(get_repo_root)}"
+  local current_file=$(_get_current_task_file "$repo_root")
+
+  if [[ -f "$current_file" ]]; then
+    rm -f "$current_file"
+  fi
+}
+
+# Check if has current task
+has_current_task() {
+  local current=$(get_current_task "$1")
+  [[ -n "$current" ]]
+}
+
+# =============================================================================
+# Task ID Generation
+# =============================================================================
+
+# Generate task ID based on date (MM-DD format)
+# Returns: MM-DD (e.g., "01-21")
+generate_task_date_prefix() {
+  date +%m-%d
+}

package/dist/templates/trellis/scripts-shell-archive/common/phase.sh

@@ -0,0 +1,150 @@
+#!/bin/bash
+# =============================================================================
+# Phase Management Utilities
+# =============================================================================
+# Centralized phase tracking for multi-agent pipeline
+#
+# Usage:
+#   source common/phase.sh
+#
+#   get_current_phase "$task_json"          # Returns current phase number
+#   get_total_phases "$task_json"           # Returns total phase count
+#   get_phase_action "$task_json" "$phase"  # Returns action name for phase
+#   get_phase_info "$task_json"             # Returns "N/M (action)" format
+#   set_phase "$task_json" "$phase"         # Sets current_phase
+#   advance_phase "$task_json"              # Advances to next phase
+#   get_phase_for_action "$task_json" "$action"  # Returns phase number for action
+# =============================================================================
+
+# Get current phase number
+get_current_phase() {
+  local task_json="$1"
+  if [ ! -f "$task_json" ]; then
+    echo "0"
+    return
+  fi
+  jq -r '.current_phase // 0' "$task_json"
+}
+
+# Get total number of phases
+get_total_phases() {
+  local task_json="$1"
+  if [ ! -f "$task_json" ]; then
+    echo "0"
+    return
+  fi
+  jq -r '.next_action | length // 0' "$task_json"
+}
+
+# Get action name for a specific phase
+get_phase_action() {
+  local task_json="$1"
+  local phase="$2"
+  if [ ! -f "$task_json" ]; then
+    echo "unknown"
+    return
+  fi
+  jq -r --argjson phase "$phase" '.next_action[] | select(.phase == $phase) | .action // "unknown"' "$task_json"
+}
+
+# Get formatted phase info: "N/M (action)"
+get_phase_info() {
+  local task_json="$1"
+  if [ ! -f "$task_json" ]; then
+    echo "N/A"
+    return
+  fi
+
+  local current_phase=$(get_current_phase "$task_json")
+  local total_phases=$(get_total_phases "$task_json")
+  local action_name=$(get_phase_action "$task_json" "$current_phase")
+
+  if [ "$current_phase" = "0" ] || [ "$current_phase" = "null" ]; then
+    echo "0/${total_phases} (pending)"
+  else
+    echo "${current_phase}/${total_phases} (${action_name})"
+  fi
+}
+
+# Set current phase to a specific value
+set_phase() {
+  local task_json="$1"
+  local phase="$2"
+
+  if [ ! -f "$task_json" ]; then
+    echo "Error: task.json not found: $task_json" >&2
+    return 1
+  fi
+
+  jq --argjson phase "$phase" '.current_phase = $phase' "$task_json" > "${task_json}.tmp"
+  mv "${task_json}.tmp" "$task_json"
+}
+
+# Advance to next phase
+advance_phase() {
+  local task_json="$1"
+
+  if [ ! -f "$task_json" ]; then
+    echo "Error: task.json not found: $task_json" >&2
+    return 1
+  fi
+
+  local current=$(get_current_phase "$task_json")
+  local total=$(get_total_phases "$task_json")
+  local next=$((current + 1))
+
+  if [ "$next" -gt "$total" ]; then
+    echo "Warning: Already at final phase" >&2
+    return 0
+  fi
+
+  set_phase "$task_json" "$next"
+}
+
+# Get phase number for a specific action name
+get_phase_for_action() {
+  local task_json="$1"
+  local action="$2"
+
+  if [ ! -f "$task_json" ]; then
+    echo "0"
+    return
+  fi
+
+  jq -r --arg action "$action" '.next_action[] | select(.action == $action) | .phase // 0' "$task_json"
+}
+
+# Map subagent type to action name
+# Used by hooks to determine which action a subagent corresponds to
+map_subagent_to_action() {
+  local subagent_type="$1"
+
+  case "$subagent_type" in
+    implement) echo "implement" ;;
+    check) echo "check" ;;
+    debug) echo "debug" ;;
+    research) echo "research" ;;
+    # finish uses check agent but is a different action
+    *) echo "$subagent_type" ;;
+  esac
+}
+
+# Check if a phase is completed (current_phase > phase)
+is_phase_completed() {
+  local task_json="$1"
+  local phase="$2"
+
+  local current=$(get_current_phase "$task_json")
+  [ "$current" -gt "$phase" ]
+}
+
+# Check if we're at a specific action
+is_current_action() {
+  local task_json="$1"
+  local action="$2"
+
+  local current=$(get_current_phase "$task_json")
+  local action_phase=$(get_phase_for_action "$task_json" "$action")
+
+  [ "$current" = "$action_phase" ]
+}