@lvlup-sw/exarchos 2.0.1

package/scripts/investigation-timer.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# Investigation Timer
+# Enforces the 15-minute investigation time-box for hotfix track.
+# Replaces prose "15-Minute Investigation Checkpoint" with deterministic validation.
+#
+# Usage: investigation-timer.sh --started-at <ISO8601> [--budget-minutes 15]
+#        investigation-timer.sh --state-file <path> [--budget-minutes 15]
+#
+# Exit codes:
+#   0 = within budget
+#   1 = budget exceeded
+#   2 = usage error (missing required args, invalid input)
+
+set -euo pipefail
+
+# ============================================================
+# ARGUMENT PARSING
+# ============================================================
+
+STARTED_AT=""
+STATE_FILE=""
+BUDGET_MINUTES=15
+
+usage() {
+    cat << 'USAGE'
+Usage: investigation-timer.sh --started-at <ISO8601> [--budget-minutes 15]
+       investigation-timer.sh --state-file <path> [--budget-minutes 15]
+
+Required (one of):
+  --started-at <ISO8601>   Investigation start timestamp
+  --state-file <path>      Path to workflow state JSON (reads investigation.startedAt)
+
+Optional:
+  --budget-minutes <N>     Investigation budget in minutes (default: 15)
+  --help                   Show this help message
+
+Exit codes:
+  0  Within budget
+  1  Budget exceeded — recommend escalating to thorough track
+  2  Usage error (missing args, invalid timestamp)
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --started-at)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --started-at requires an ISO8601 timestamp argument" >&2
+                exit 2
+            fi
+            STARTED_AT="$2"
+            shift 2
+            ;;
+        --state-file)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --state-file requires a path argument" >&2
+                exit 2
+            fi
+            STATE_FILE="$2"
+            shift 2
+            ;;
+        --budget-minutes)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --budget-minutes requires a number argument" >&2
+                exit 2
+            fi
+            BUDGET_MINUTES="$2"
+            shift 2
+            ;;
+        --help)
+            usage
+            exit 0
+            ;;
+        *)
+            echo "Error: Unknown argument '$1'" >&2
+            usage >&2
+            exit 2
+            ;;
+    esac
+done
+
+# ============================================================
+# RESOLVE STARTED_AT
+# ============================================================
+
+if [[ -z "$STARTED_AT" && -z "$STATE_FILE" ]]; then
+    echo "Error: Either --started-at or --state-file is required" >&2
+    usage >&2
+    exit 2
+fi
+
+if [[ -n "$STATE_FILE" && -z "$STARTED_AT" ]]; then
+    if [[ ! -f "$STATE_FILE" ]]; then
+        echo "Error: State file not found: $STATE_FILE" >&2
+        exit 2
+    fi
+
+    if ! command -v jq &>/dev/null; then
+        echo "Error: jq is required but not installed" >&2
+        exit 2
+    fi
+
+    STARTED_AT="$(jq -r '.investigation.startedAt // empty' "$STATE_FILE")"
+    if [[ -z "$STARTED_AT" ]]; then
+        echo "Error: No investigation.startedAt found in state file" >&2
+        exit 2
+    fi
+fi
+
+# ============================================================
+# VALIDATE TIMESTAMP
+# ============================================================
+
+# Try to parse the timestamp to epoch seconds
+# macOS date: date -j -f format
+# GNU date:   date -d string
+START_EPOCH=""
+
+# Try GNU date first (Linux), then macOS date (with TZ=UTC to handle Z suffix correctly)
+if START_EPOCH="$(date -d "$STARTED_AT" +%s 2>/dev/null)"; then
+    : # success
+elif START_EPOCH="$(TZ=UTC date -j -f "%Y-%m-%dT%H:%M:%SZ" "$STARTED_AT" +%s 2>/dev/null)"; then
+    : # success
+elif START_EPOCH="$(TZ=UTC date -j -f "%Y-%m-%dT%H:%M:%S%z" "$STARTED_AT" +%s 2>/dev/null)"; then
+    : # success
+else
+    echo "Error: Invalid timestamp: $STARTED_AT (expected ISO8601 format)" >&2
+    exit 2
+fi
+
+# ============================================================
+# CALCULATE ELAPSED TIME
+# ============================================================
+
+NOW_EPOCH="$(date +%s)"
+ELAPSED_SECONDS=$(( NOW_EPOCH - START_EPOCH ))
+BUDGET_SECONDS=$(( BUDGET_MINUTES * 60 ))
+
+# Format elapsed time as Xm Ys
+ELAPSED_MINUTES=$(( ELAPSED_SECONDS / 60 ))
+ELAPSED_REMAINDER=$(( ELAPSED_SECONDS % 60 ))
+
+# ============================================================
+# DETERMINE STATUS
+# ============================================================
+
+if [[ $ELAPSED_SECONDS -le $BUDGET_SECONDS ]]; then
+    REMAINING_SECONDS=$(( BUDGET_SECONDS - ELAPSED_SECONDS ))
+    REMAINING_MINUTES=$(( REMAINING_SECONDS / 60 ))
+    REMAINING_REMAINDER=$(( REMAINING_SECONDS % 60 ))
+    STATUS="WITHIN BUDGET (${REMAINING_MINUTES}m ${REMAINING_REMAINDER}s remaining)"
+    EXIT_CODE=0
+else
+    OVER_SECONDS=$(( ELAPSED_SECONDS - BUDGET_SECONDS ))
+    OVER_MINUTES=$(( OVER_SECONDS / 60 ))
+    OVER_REMAINDER=$(( OVER_SECONDS % 60 ))
+    STATUS="BUDGET EXCEEDED by ${OVER_MINUTES}m ${OVER_REMAINDER}s — Recommend escalating to thorough track"
+    EXIT_CODE=1
+fi
+
+# ============================================================
+# STRUCTURED OUTPUT
+# ============================================================
+
+echo "## Investigation Timer"
+echo "- **Started:** $STARTED_AT"
+echo "- **Elapsed:** ${ELAPSED_MINUTES}m ${ELAPSED_REMAINDER}s"
+echo "- **Budget:** ${BUDGET_MINUTES}m"
+echo "- **Status:** $STATUS"
+
+exit $EXIT_CODE

package/scripts/needs-schema-sync.sh

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+# needs-schema-sync.sh — Detect API file modifications requiring schema sync
+# Replaces "Schema Sync Auto-Detection" prose in delegation SKILL.md.
+#
+# Usage: needs-schema-sync.sh --repo-root <path> [--base-branch main] [--diff-file <path>]
+#
+# Exit codes:
+#   0 = no sync needed
+#   1 = sync needed (API files modified)
+#   2 = usage error (missing required args)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# ============================================================
+# ARGUMENT PARSING
+# ============================================================
+
+REPO_ROOT=""
+BASE_BRANCH="main"
+DIFF_FILE=""
+
+usage() {
+    cat << 'USAGE'
+Usage: needs-schema-sync.sh --repo-root <path> [--base-branch main] [--diff-file <path>]
+
+Required:
+  --repo-root <path>      Repository root directory
+
+Optional:
+  --base-branch <name>    Base branch/commit to diff against (default: main)
+  --diff-file <path>      Use pre-computed diff file instead of git diff
+  --help                  Show this help message
+
+Detects modifications to API files matching these patterns:
+  *Endpoints.cs, Models/*.cs, Requests/*.cs, Responses/*.cs, Dtos/*.cs
+
+Exit codes:
+  0  No sync needed (no API files modified)
+  1  Sync needed (API files modified — lists them)
+  2  Usage error (missing required args)
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --repo-root)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --repo-root requires a path argument" >&2
+                exit 2
+            fi
+            REPO_ROOT="$2"
+            shift 2
+            ;;
+        --base-branch)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --base-branch requires an argument" >&2
+                exit 2
+            fi
+            BASE_BRANCH="$2"
+            shift 2
+            ;;
+        --diff-file)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --diff-file requires a path argument" >&2
+                exit 2
+            fi
+            DIFF_FILE="$2"
+            shift 2
+            ;;
+        --help)
+            usage
+            exit 0
+            ;;
+        *)
+            echo "Error: Unknown argument '$1'" >&2
+            usage >&2
+            exit 2
+            ;;
+    esac
+done
+
+if [[ -z "$REPO_ROOT" ]]; then
+    echo "Error: --repo-root is required" >&2
+    usage >&2
+    exit 2
+fi
+
+# ============================================================
+# API FILE PATTERNS
+# ============================================================
+
+# Patterns that trigger schema sync
+# These match: *Endpoints.cs, Models/*.cs, Requests/*.cs, Responses/*.cs, Dtos/*.cs
+API_PATTERNS=(
+    'Endpoints\.cs$'
+    'Models/[^/]*\.cs$'
+    'Requests/[^/]*\.cs$'
+    'Responses/[^/]*\.cs$'
+    'Dtos/[^/]*\.cs$'
+)
+
+# ============================================================
+# GET CHANGED FILES
+# ============================================================
+
+CHANGED_FILES=""
+
+if [[ -n "$DIFF_FILE" ]]; then
+    # Extract file paths from diff file
+    if [[ ! -f "$DIFF_FILE" ]]; then
+        echo "Error: Diff file not found: $DIFF_FILE" >&2
+        exit 2
+    fi
+    # Parse diff headers to get file names (lines starting with +++ b/)
+    CHANGED_FILES="$(
+        grep -E '^\+\+\+ b/|^--- a/' "$DIFF_FILE" \
+        | sed -E 's|^\+\+\+ b/||; s|^--- a/||' \
+        | grep -v '^/dev/null$' \
+        | sort -u || true
+    )"
+else
+    # Use git diff to get changed files
+    if ! CHANGED_FILES="$(git -C "$REPO_ROOT" diff --name-only "$BASE_BRANCH"...HEAD 2>/dev/null || \
+                         git -C "$REPO_ROOT" diff --name-only "$BASE_BRANCH" HEAD 2>/dev/null || \
+                         git -C "$REPO_ROOT" diff --name-only "$BASE_BRANCH" 2>/dev/null)"; then
+        echo "Error: git diff failed for base '$BASE_BRANCH'" >&2
+        exit 1
+    fi
+fi
+
+# ============================================================
+# MATCH API FILES
+# ============================================================
+
+API_FILES=()
+
+while IFS= read -r file; do
+    [[ -z "$file" ]] && continue
+
+    for pattern in "${API_PATTERNS[@]}"; do
+        if echo "$file" | grep -qE "$pattern"; then
+            API_FILES+=("$file")
+            break
+        fi
+    done
+done <<< "$CHANGED_FILES"
+
+# ============================================================
+# OUTPUT
+# ============================================================
+
+if [[ ${#API_FILES[@]} -eq 0 ]]; then
+    echo "## Schema Sync Check"
+    echo ""
+    echo "**Result: No sync needed** — No API files modified"
+    exit 0
+else
+    echo "## Schema Sync Check"
+    echo ""
+    echo "**Result: Sync needed** — ${#API_FILES[@]} API file(s) modified:"
+    echo ""
+    for f in "${API_FILES[@]}"; do
+        echo "- \`$f\`"
+    done
+    exit 1
+fi

package/scripts/new-project.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+#
+# new-project.sh - Initialize a new project with Claude Code configuration
+#
+# Usage: new-project.sh [project-path] [options]
+#
+# Options:
+#   --typescript    Set up for TypeScript project
+#   --csharp        Set up for C# project
+#   --minimal       Only create CLAUDE.md, no local overrides
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Defaults
+PROJECT_PATH="${1:-.}"
+LANG=""
+MINIMAL=false
+
+# Parse arguments
+shift || true
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --typescript) LANG="typescript"; shift ;;
+        --csharp) LANG="csharp"; shift ;;
+        --minimal) MINIMAL=true; shift ;;
+        *) echo "Unknown option: $1"; exit 1 ;;
+    esac
+done
+
+# Resolve project path
+PROJECT_PATH="$(cd "$PROJECT_PATH" 2>/dev/null && pwd || echo "$PROJECT_PATH")"
+
+if [ ! -d "$PROJECT_PATH" ]; then
+    echo "Creating project directory: $PROJECT_PATH"
+    mkdir -p "$PROJECT_PATH"
+fi
+
+echo "Setting up Claude Code for: $PROJECT_PATH"
+echo ""
+
+# Create CLAUDE.md from template
+if [ -f "$PROJECT_PATH/CLAUDE.md" ]; then
+    echo "[skip] CLAUDE.md already exists"
+else
+    cp "$REPO_ROOT/CLAUDE.md.template" "$PROJECT_PATH/CLAUDE.md"
+    echo "[created] CLAUDE.md"
+
+    # Customize based on language
+    if [ "$LANG" = "typescript" ]; then
+        sed -i 's/npm run test:run/npm run test/g' "$PROJECT_PATH/CLAUDE.md"
+        sed -i 's/npm run test:coverage/npm run test -- --coverage/g' "$PROJECT_PATH/CLAUDE.md"
+    elif [ "$LANG" = "csharp" ]; then
+        sed -i 's/npm run test:run/dotnet test/g' "$PROJECT_PATH/CLAUDE.md"
+        sed -i 's/npm run test:coverage/dotnet test --collect:"XPlat Code Coverage"/g' "$PROJECT_PATH/CLAUDE.md"
+        sed -i 's/npm run typecheck/dotnet build/g' "$PROJECT_PATH/CLAUDE.md"
+    fi
+fi
+
+# Create .claude directory for local overrides (unless minimal)
+if [ "$MINIMAL" = false ]; then
+    mkdir -p "$PROJECT_PATH/.claude"
+
+    # Create local settings.json if it doesn't exist
+    if [ ! -f "$PROJECT_PATH/.claude/settings.json" ]; then
+        cat > "$PROJECT_PATH/.claude/settings.json" << 'EOF'
+{
+  "permissions": {
+    "allow": []
+  }
+}
+EOF
+        echo "[created] .claude/settings.json (local overrides)"
+    else
+        echo "[skip] .claude/settings.json already exists"
+    fi
+
+    # Add .claude/settings.local.json to .gitignore if git repo
+    if [ -d "$PROJECT_PATH/.git" ]; then
+        if ! grep -q "settings.local.json" "$PROJECT_PATH/.gitignore" 2>/dev/null; then
+            echo ".claude/settings.local.json" >> "$PROJECT_PATH/.gitignore"
+            echo "[updated] .gitignore (added settings.local.json)"
+        fi
+    fi
+fi
+
+echo ""
+echo "Setup complete!"
+echo ""
+echo "Available commands (via global config):"
+echo "  /ideate     - Collaborative design exploration"
+echo "  /plan       - TDD implementation planning"
+echo "  /delegate   - Dispatch to Jules or subagents"
+echo "  /review     - Two-stage code review"
+echo "  /synthesize - Merge and create PR"
+echo ""
+echo "Next steps:"
+echo "  1. Edit $PROJECT_PATH/CLAUDE.md with project-specific details"
+echo "  2. Add project-specific rules to $PROJECT_PATH/.claude/rules/ if needed"
+echo ""