@nlaprell/shipit 1.0.0

package/scripts/status.sh

@@ -0,0 +1,278 @@
+#!/bin/bash
+
+# Show current ShipIt project status
+# Displays active intent(s), workflow phase(s), intent counts. Supports flat and per-intent layout.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/workflow_state.sh
+[ -f "$SCRIPT_DIR/lib/workflow_state.sh" ] && source "$SCRIPT_DIR/lib/workflow_state.sh"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+INTENT_DIR="work/intent"
+WS_BASE="work/workflow-state"
+
+echo -e "${BLUE}════════════════════════════════════════${NC}"
+echo -e "${BLUE}ShipIt Project Status${NC}"
+echo -e "${BLUE}════════════════════════════════════════${NC}"
+echo ""
+
+# Check if project.json exists
+if [ ! -f "project.json" ]; then
+    echo -e "${RED}⚠ Not a ShipIt project (project.json missing)${NC}"
+    echo "Run /init-project to initialize a project."
+    exit 1
+fi
+
+PROJECT_NAME=$(jq -r '.name' project.json 2>/dev/null || echo "unknown")
+echo -e "${CYAN}Project:${NC} $PROJECT_NAME"
+echo ""
+
+# Active intent(s) — from flat active.md or per-intent dirs
+ACTIVE_IDS=($(list_active_intent_ids))
+if [ "${#ACTIVE_IDS[@]}" -gt 0 ]; then
+    echo -e "${CYAN}Active Intent(s):${NC}"
+    for aid in "${ACTIVE_IDS[@]}"; do
+        dir="$(get_workflow_state_dir "$aid")"
+        phase=""
+        if [ -n "$dir" ] && [ -f "$dir/02_plan.md" ]; then
+            phase="Planning"
+        elif [ -n "$dir" ] && [ -f "$dir/03_implementation.md" ]; then
+            phase="Implementation"
+        elif [ -n "$dir" ] && [ -f "$dir/04_verification.md" ]; then
+            phase="Verification"
+        elif [ -n "$dir" ] && [ -f "$dir/01_analysis.md" ]; then
+            phase="Analysis"
+        else
+            phase="(see workflow state)"
+        fi
+        echo "  $aid — $phase"
+    done
+    echo ""
+fi
+if [ -f "$WS_BASE/active.md" ]; then
+    ACTIVE_STATUS=$(grep -E "^\\*\\*Status:\\*\\*" "$WS_BASE/active.md" 2>/dev/null | sed 's/.*\*\*Status:\*\* //' | tr -d ' ' || echo "")
+    if [ "$ACTIVE_STATUS" = "idle" ] && [ "${#ACTIVE_IDS[@]}" -eq 0 ]; then
+        echo -e "${CYAN}Active Intent:${NC} none (idle)"
+        echo ""
+    fi
+fi
+
+# Intent counts (initialize to 0)
+PLANNED=0
+ACTIVE=0
+BLOCKED=0
+VALIDATING=0
+SHIPPED=0
+KILLED=0
+TOTAL=0
+
+if [ -d "$INTENT_DIR" ]; then
+    intent_files=()
+    while IFS= read -r file; do
+        intent_files+=("$file")
+    done < <(find "$INTENT_DIR" -type f -name "*.md" ! -name "_TEMPLATE.md" 2>/dev/null)
+
+    for file in "${intent_files[@]}"; do
+        [ -f "$file" ] || continue
+
+        STATUS=$(awk '
+            $0 ~ /^## Status/ {found=1; next}
+            found && $0 ~ /^## / {exit}
+            found && $0 ~ /[^[:space:]]/ {gsub(/^[[:space:]]+|[[:space:]]+$/, "", $0); print tolower($0); exit}
+        ' "$file" 2>/dev/null || echo "planned")
+
+        case "$STATUS" in
+            planned) PLANNED=$((PLANNED + 1)) ;;
+            active) ACTIVE=$((ACTIVE + 1)) ;;
+            blocked) BLOCKED=$((BLOCKED + 1)) ;;
+            validating) VALIDATING=$((VALIDATING + 1)) ;;
+            shipped) SHIPPED=$((SHIPPED + 1)) ;;
+            killed) KILLED=$((KILLED + 1)) ;;
+        esac
+    done
+
+    TOTAL=$((PLANNED + ACTIVE + BLOCKED + VALIDATING + SHIPPED + KILLED))
+fi
+
+if [ "$TOTAL" -gt 0 ]; then
+    echo -e "${CYAN}Intent Status:${NC}"
+    echo "  Planned: $PLANNED"
+    echo "  Active: $ACTIVE"
+    echo "  Blocked: $BLOCKED"
+    echo "  Validating: $VALIDATING"
+    echo "  Shipped: $SHIPPED"
+    echo "  Killed: $KILLED"
+    echo "  Total: $TOTAL"
+    echo ""
+fi
+
+# Workflow state files (flat or per-intent)
+if [ -d "$WS_BASE" ]; then
+    echo -e "${CYAN}Workflow State:${NC}"
+    if [ "${#ACTIVE_IDS[@]}" -eq 0 ]; then
+        WORKFLOW_DIR="$WS_BASE"
+        for phase in 01_analysis 02_plan 03_implementation 04_verification 05_release_notes 06_shipped; do
+            if [ -f "$WORKFLOW_DIR/${phase}.md" ]; then
+                echo -e "  ${GREEN}✓${NC} $phase"
+            else
+                echo -e "  ${YELLOW}○${NC} $phase (not started)"
+            fi
+        done
+    else
+        for aid in "${ACTIVE_IDS[@]}"; do
+            dir="$(get_workflow_state_dir "$aid")"
+            [ -z "$dir" ] && continue
+            echo "  [$aid]"
+            for phase in 01_analysis 02_plan 03_implementation 04_verification 05_release_notes 06_shipped; do
+                if [ -f "$dir/${phase}.md" ]; then
+                    echo -e "    ${GREEN}✓${NC} $phase"
+                else
+                    echo -e "    ${YELLOW}○${NC} $phase (not started)"
+                fi
+            done
+        done
+    fi
+    echo ""
+fi
+
+# Workflow state sanity check (top-level required files)
+required_top_files=( "active.md" "blocked.md" "validating.md" "shipped.md" "disagreements.md" )
+required_phase_files=( "01_analysis.md" "02_plan.md" "03_implementation.md" "04_verification.md" "05_release_notes.md" )
+if [ -d "$WS_BASE" ]; then
+    missing_top=()
+    for file in "${required_top_files[@]}"; do
+        [ ! -f "$WS_BASE/$file" ] && missing_top+=("$file")
+    done
+    for aid in "${ACTIVE_IDS[@]}"; do
+        dir="$(get_workflow_state_dir "$aid")"
+        [ -z "$dir" ] && continue
+        for file in "${required_phase_files[@]}"; do
+            [ ! -f "$dir/$file" ] && missing_top+=("$aid/$file")
+        done
+    done
+    if [ "${#ACTIVE_IDS[@]}" -eq 0 ]; then
+        for file in "${required_phase_files[@]}"; do
+            [ ! -f "$WS_BASE/$file" ] && missing_top+=("$file")
+        done
+    fi
+    if [ "${#missing_top[@]}" -gt 0 ]; then
+        echo -e "${YELLOW}⚠ Workflow State Check:${NC}"
+        echo "  Missing: ${missing_top[*]}"
+        echo "  💡 Run /ship <id> or re-run /init-project to seed files"
+        echo ""
+    fi
+fi
+
+# Recent intents
+if [ -d "$INTENT_DIR" ] && [ "${TOTAL:-0}" -gt 0 ]; then
+    echo -e "${CYAN}Recent Intents:${NC}"
+    if [ "${#intent_files[@]}" -gt 0 ]; then
+        ls -t "${intent_files[@]}" 2>/dev/null | head -5 | while read -r file; do
+        ID=$(basename "$file" .md)
+        TITLE=$(grep "^# " "$file" 2>/dev/null | head -1 | sed 's/^# [^:]*: //' || echo "$ID")
+        STATUS=$(awk '
+            $0 ~ /^## Status/ {found=1; next}
+            found && $0 ~ /^## / {exit}
+            found && $0 ~ /[^[:space:]]/ {gsub(/^[[:space:]]+|[[:space:]]+$/, "", $0); print tolower($0); exit}
+        ' "$file" 2>/dev/null || echo "unknown")
+        echo "  $ID: $TITLE ($STATUS)"
+        done
+    fi
+    echo ""
+fi
+
+# Pending approvals (check flat or each active's plan)
+check_pending_approval() {
+    local f="$1"
+    [ ! -f "$f" ] && return 0
+    if grep -q "\[ \].*approval\|\[ \].*Approval" "$f" 2>/dev/null && ! grep -q "\[x\].*approval\|\[x\].*Approval\|Approved\|APPROVE" "$f" 2>/dev/null; then
+        echo -e "${YELLOW}⚠ Pending Approval:${NC}"
+        echo "  Plan approval required in $f"
+        echo ""
+        return 1
+    fi
+    return 0
+}
+if [ "${#ACTIVE_IDS[@]}" -eq 0 ] && [ -f "$WS_BASE/02_plan.md" ]; then
+    check_pending_approval "$WS_BASE/02_plan.md" || true
+else
+    for aid in "${ACTIVE_IDS[@]}"; do
+        dir="$(get_workflow_state_dir "$aid")"
+        [ -n "$dir" ] && [ -f "$dir/02_plan.md" ] && check_pending_approval "$dir/02_plan.md" || true
+    done
+fi
+
+# Test results summary
+if command -v pnpm >/dev/null 2>&1 && [ -f "package.json" ]; then
+    echo -e "${CYAN}Test Status:${NC}"
+    if [ -f "package.json" ] && grep -q '"test"' package.json; then
+        # Try to get test results (non-blocking, timeout to avoid hanging)
+        test_output=$(timeout 10 pnpm test 2>&1 | tail -5 || echo "")
+        if [ -n "$test_output" ] && echo "$test_output" | grep -q "PASS\|pass\|✓\|Test Files.*passed"; then
+            test_count=$(echo "$test_output" | grep -oE "[0-9]+ passing\|[0-9]+ passed\|Test Files.*[0-9]+" | head -1 || echo "")
+            echo -e "  ${GREEN}✓${NC} Tests passing${test_count:+ ($test_count)}"
+        elif [ -n "$test_output" ] && echo "$test_output" | grep -q "FAIL\|fail\|✗\|failed"; then
+            echo -e "  ${RED}✗${NC} Tests failing (run 'pnpm test' for details)"
+        else
+            echo "  ${YELLOW}○${NC} Run 'pnpm test' to check test status"
+        fi
+    else
+        echo "  ${YELLOW}○${NC} No test script configured"
+    fi
+    echo ""
+fi
+
+# Token/usage summary (if usage.json exists)
+USAGE_FILE="_system/artifacts/usage.json"
+if [ -f "$USAGE_FILE" ] && command -v jq >/dev/null 2>&1; then
+    ENTRY_COUNT=$(jq '.entries | length' "$USAGE_FILE" 2>/dev/null || echo "0")
+    if [ "${ENTRY_COUNT:-0}" -gt 0 ]; then
+        echo -e "${CYAN}Usage (tokens/cost):${NC}"
+        LAST=$(jq -r '.entries[-1] | "\(.intent_id) \(.phase): \(.tokens_in + .tokens_out) tokens" + (if .estimated_cost_usd != null then " (~$" + (.estimated_cost_usd|tostring) + ")" else " (estimate)" end)' "$USAGE_FILE" 2>/dev/null || true)
+        if [ -n "$LAST" ]; then
+            echo "  Last: $LAST"
+        fi
+        echo "  Run \`pnpm usage-report\` for full table"
+        echo ""
+    fi
+fi
+
+# Recent changes (git)
+if command -v git >/dev/null 2>&1 && git rev-parse --git-dir >/dev/null 2>&1; then
+    echo -e "${CYAN}Recent Changes:${NC}"
+    recent_commits=$(git log --oneline -5 2>/dev/null | head -5 || true)
+    if [ -n "$recent_commits" ]; then
+        echo "$recent_commits" | while IFS= read -r line; do
+            [ -n "$line" ] && echo "  $line"
+        done
+    else
+        echo "  (No commits yet)"
+    fi
+    echo ""
+fi
+
+# Suggestions
+echo -e "${CYAN}Next Steps:${NC}"
+if [ "$TOTAL" -eq 0 ]; then
+    echo "  💡 Run /scope-project to break down your project"
+    echo "  💡 Run /new_intent to create your first intent"
+elif [ "$ACTIVE" -eq 0 ] && [ "$PLANNED" -gt 0 ]; then
+    echo "  💡 Run /ship <id> to start working on a planned intent"
+    echo "  💡 Run /new_intent to create another intent"
+elif [ "$ACTIVE" -gt 0 ]; then
+    echo "  💡 Continue workflow for active intent"
+    echo "  💡 Run /status to see current phase"
+else
+    echo "  💡 Run /generate-release-plan to update release plan"
+    echo "  💡 Run /generate-roadmap to update roadmap"
+fi
+echo ""

package/scripts/suggest.sh

@@ -0,0 +1,173 @@
+#!/bin/bash
+
+# Suggest next actions based on current project state
+# Supports flat and per-intent workflow state; considers all active intents.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/workflow_state.sh
+[ -f "$SCRIPT_DIR/lib/workflow_state.sh" ] && source "$SCRIPT_DIR/lib/workflow_state.sh"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+INTENT_DIR="work/intent"
+WS_BASE="work/workflow-state"
+
+echo -e "${BLUE}ShipIt Suggestions${NC}"
+echo ""
+
+# Check if project exists
+if [ ! -f "project.json" ]; then
+    echo -e "${YELLOW}→ Initialize a project:${NC} /init-project \"My Project\""
+    exit 0
+fi
+
+# Count intents by status (initialize to 0)
+PLANNED=0
+ACTIVE=0
+SHIPPED=0
+KILLED=0
+TOTAL=0
+
+if [ -d "$INTENT_DIR" ]; then
+    intent_files=()
+    while IFS= read -r file; do
+        intent_files+=("$file")
+    done < <(find "$INTENT_DIR" -type f -name "*.md" ! -name "_TEMPLATE.md" 2>/dev/null)
+
+    for file in "${intent_files[@]}"; do
+        [ -f "$file" ] || continue
+
+        STATUS=$(awk '
+            $0 ~ /^## Status/ {found=1; next}
+            found && $0 ~ /^## / {exit}
+            found && $0 ~ /[^[:space:]]/ {gsub(/^[[:space:]]+|[[:space:]]+$/, "", $0); print tolower($0); exit}
+        ' "$file" 2>/dev/null || echo "planned")
+
+        case "$STATUS" in
+            planned) PLANNED=$((PLANNED + 1)) ;;
+            active) ACTIVE=$((ACTIVE + 1)) ;;
+            shipped) SHIPPED=$((SHIPPED + 1)) ;;
+            killed) KILLED=$((KILLED + 1)) ;;
+        esac
+    done
+fi
+
+TOTAL=$((PLANNED + ACTIVE + SHIPPED + KILLED))
+
+# Active intent(s) — use first for phase-based suggestions; show all if multiple
+ACTIVE_IDS=($(list_active_intent_ids))
+ACTIVE_ID=""
+ACTIVE_PHASE=""
+WORKFLOW_DIR=""
+if [ "${#ACTIVE_IDS[@]}" -gt 0 ]; then
+    ACTIVE_ID="${ACTIVE_IDS[0]}"
+    WORKFLOW_DIR="$(get_workflow_state_dir "$ACTIVE_ID")"
+    [ -z "$WORKFLOW_DIR" ] && WORKFLOW_DIR="$WS_BASE"
+    if [ -n "$WORKFLOW_DIR" ]; then
+        if [ -f "$WORKFLOW_DIR/02_plan.md" ]; then ACTIVE_PHASE="Plan"; fi
+        if [ -f "$WORKFLOW_DIR/03_implementation.md" ]; then ACTIVE_PHASE="Implementation"; fi
+        if [ -f "$WORKFLOW_DIR/04_verification.md" ]; then ACTIVE_PHASE="Verification"; fi
+        if [ -f "$WORKFLOW_DIR/01_analysis.md" ] && [ -z "$ACTIVE_PHASE" ]; then ACTIVE_PHASE="Analysis"; fi
+    fi
+fi
+
+# Generate suggestions
+SUGGESTIONS=()
+
+# No intents at all
+if [ "$TOTAL" -eq 0 ]; then
+    SUGGESTIONS+=("${CYAN}1. Scope your project:${NC} /scope-project \"project description\"")
+    SUGGESTIONS+=("${CYAN}2. Create your first intent:${NC} /new_intent")
+fi
+
+# Has planned intents but no active
+if [ "$PLANNED" -gt 0 ] && [ -z "$ACTIVE_ID" ]; then
+    # Find first planned intent (actually check status)
+    FIRST_PLANNED=""
+    for file in "${intent_files[@]}"; do
+        [ -f "$file" ] || continue
+        STATUS=$(awk '
+            $0 ~ /^## Status/ {found=1; next}
+            found && $0 ~ /^## / {exit}
+            found && $0 ~ /[^[:space:]]/ {gsub(/^[[:space:]]+|[[:space:]]+$/, "", $0); print tolower($0); exit}
+        ' "$file" 2>/dev/null || echo "")
+        if [ "$STATUS" = "planned" ]; then
+            FIRST_PLANNED=$(basename "$file" .md)
+            break
+        fi
+    done
+    if [ -n "$FIRST_PLANNED" ]; then
+        SUGGESTIONS+=("${CYAN}1. Start working on an intent:${NC} /ship $FIRST_PLANNED")
+    fi
+fi
+
+# Has active intent(s)
+if [ -n "$ACTIVE_ID" ]; then
+    if [ "${#ACTIVE_IDS[@]}" -gt 1 ]; then
+        SUGGESTIONS+=("${CYAN}Multiple active intents:${NC} ${ACTIVE_IDS[*]} — use /ship <id> or /verify <id>")
+    fi
+    case "$ACTIVE_PHASE" in
+        *analysis*|*Analysis*)
+            SUGGESTIONS+=("${CYAN}1. Continue analysis:${NC} Fill in $WORKFLOW_DIR/01_analysis.md")
+            SUGGESTIONS+=("${CYAN}2. Move to planning:${NC} Run /ship $ACTIVE_ID (will proceed to Phase 2)")
+            ;;
+        *plan*|*Plan*)
+            if [ -n "$WORKFLOW_DIR" ] && [ -f "$WORKFLOW_DIR/02_plan.md" ] && grep -q "\[ \].*approval\|\[ \].*Approval" "$WORKFLOW_DIR/02_plan.md" 2>/dev/null && ! grep -q "\[x\].*approval\|\[x\].*Approval\|Approved\|APPROVE" "$WORKFLOW_DIR/02_plan.md" 2>/dev/null; then
+                SUGGESTIONS+=("${YELLOW}1. ⚠ Approval required:${NC} Review and approve $WORKFLOW_DIR/02_plan.md")
+            else
+                SUGGESTIONS+=("${CYAN}1. Continue to implementation:${NC} Run /ship $ACTIVE_ID")
+            fi
+            ;;
+        *implementation*|*Implementation*)
+            SUGGESTIONS+=("${CYAN}1. Continue implementation:${NC} Fill in $WORKFLOW_DIR/03_implementation.md")
+            SUGGESTIONS+=("${CYAN}2. Move to verification:${NC} Run /verify $ACTIVE_ID")
+            ;;
+        *verification*|*Verification*)
+            SUGGESTIONS+=("${CYAN}1. Complete verification:${NC} Fill in $WORKFLOW_DIR/04_verification.md")
+            SUGGESTIONS+=("${CYAN}2. Move to release:${NC} Run /ship $ACTIVE_ID")
+            ;;
+        *)
+            SUGGESTIONS+=("${CYAN}1. Continue workflow:${NC} Run /ship $ACTIVE_ID")
+            ;;
+    esac
+fi
+
+# Release plan needs update
+if [ "$PLANNED" -gt 0 ] || [ "$ACTIVE" -gt 0 ]; then
+    if [ ! -f "work/release/plan.md" ] || [ -n "$(find "$INTENT_DIR" -type f -name "*.md" ! -name "_TEMPLATE.md" -newer "work/release/plan.md" -print -quit 2>/dev/null)" ]; then
+        SUGGESTIONS+=("${CYAN}Update release plan:${NC} /generate-release-plan")
+    fi
+fi
+
+# Roadmap needs update
+if [ "$PLANNED" -gt 0 ] || [ "$ACTIVE" -gt 0 ]; then
+    if [ ! -f "work/roadmap/now.md" ] || [ -n "$(find "$INTENT_DIR" -type f -name "*.md" ! -name "_TEMPLATE.md" -newer "work/roadmap/now.md" -print -quit 2>/dev/null)" ]; then
+        SUGGESTIONS+=("${CYAN}Update roadmap:${NC} /generate-roadmap")
+    fi
+fi
+
+# Show suggestions
+if [ ${#SUGGESTIONS[@]} -eq 0 ]; then
+    echo -e "${GREEN}✓ Everything looks good!${NC}"
+    echo ""
+    echo "You might want to:"
+    echo "  → Create a new intent: /new_intent"
+    echo "  → Check project status: /status"
+    echo "  → Review release plan: /generate-release-plan"
+else
+    for suggestion in "${SUGGESTIONS[@]}"; do
+        echo -e "$suggestion"
+    done
+fi
+
+echo ""
+echo -e "${CYAN}More help:${NC} /help [command]"
+echo -e "${CYAN}Project status:${NC} /status"

package/scripts/test-headless.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# Smoke test for headless mode (issue #65). Ensures run-phase.sh runs and fails cleanly without API keys.
+# With OPENAI_API_KEY or ANTHROPIC_API_KEY set, you can run phase 1 and assert output file exists.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$REPO_ROOT"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+fail() { echo -e "${RED}FAIL: $*${NC}" >&2; exit 1; }
+ok()   { echo -e "${GREEN}OK: $*${NC}"; }
+
+# Need an intent that exists and has workflow state (or we'll get "run workflow-orchestrator first")
+INTENT_ID="${1:-F-DUMMY}"
+if [ ! -f "work/intent/features/$INTENT_ID.md" ] && [ ! -f "work/intent/$INTENT_ID.md" ]; then
+  # Try to find any intent
+  INTENT_ID=""
+  for f in work/intent/features/*.md work/intent/*.md; do
+    [ -f "$f" ] && INTENT_ID="$(basename "$f" .md)" && break
+  done 2>/dev/null || true
+fi
+[ -n "$INTENT_ID" ] || { echo "Skip: no intent file found (create one or pass intent-id)"; exit 0; }
+
+# 1) Without API keys, run-phase.sh must exit 1 with clear message
+unset OPENAI_API_KEY ANTHROPIC_API_KEY
+out="$(bash scripts/headless/run-phase.sh "$INTENT_ID" 1 2>&1)" || true
+if [ "${#out}" -eq 0 ]; then
+  fail "run-phase.sh should print message when API keys unset"
+fi
+if ! echo "$out" | grep -q "OPENAI_API_KEY\|ANTHROPIC_API_KEY"; then
+  fail "run-phase.sh should mention API key env vars when unset"
+fi
+ok "run-phase.sh exits with clear message when API keys unset"
+
+# 2) Invalid phase number must exit 1
+out2="$(bash scripts/headless/run-phase.sh "$INTENT_ID" 99 2>&1)" || true
+if ! echo "$out2" | grep -q "Phase must be 1-5\|error\|Error"; then
+  fail "run-phase.sh should reject invalid phase number"
+fi
+ok "run-phase.sh rejects invalid phase"
+
+echo ""
+echo -e "${GREEN}Headless smoke test passed.${NC}"

package/scripts/test-shipit.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Automated ShipIt framework E2E test: create test project and run basic assertions.
+# Headless (no editor). For full workflow use .cursor/commands/test_shipit.md.
+# Usage: ./scripts/test-shipit.sh [--clean]
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT_DIR"
+
+# Optional: remove existing test project first
+if [[ "${1:-}" == "--clean" ]]; then
+  rm -rf tests/test-project
+fi
+
+# Source common for error_exit
+# shellcheck source=scripts/lib/common.sh
+source "$ROOT_DIR/scripts/lib/common.sh"
+
+echo "ShipIt framework E2E test (headless)"
+echo "  Root: $ROOT_DIR"
+echo ""
+
+# 1) Create test project (non-interactive; reads tests/fixtures.json)
+echo "Step 1: Create test project..."
+./scripts/init-project.sh shipit-test || error_exit "init-project.sh failed" 1
+
+# 2) Assert key files and dirs exist
+TP="$ROOT_DIR/tests/test-project"
+assert() {
+  local path="$1"
+  local desc="${2:-$path}"
+  if [[ -e "$path" ]]; then
+    echo "  ok: $desc"
+  else
+    error_exit "Missing: $desc ($path)" 1
+  fi
+}
+
+echo "Step 2: Assert project structure..."
+assert "$TP/project.json" "project.json"
+assert "$TP/AGENTS.md" "AGENTS.md"
+assert "$TP/scripts" "scripts/"
+assert "$TP/scripts/verify.sh" "scripts/verify.sh"
+assert "$TP/_system/architecture/CANON.md" "_system/architecture/CANON.md"
+assert "$TP/work/intent" "work/intent/"
+# .override/ is created by CLI init; init-project.sh may or may not create it
+[[ -d "$TP/.override" ]] && echo "  ok: .override/" || true
+
+echo ""
+echo "PASS: ShipIt framework E2E (test project creation and structure)"
+exit 0

package/scripts/test-workflow-state.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Smoke test for workflow-state flat vs per-intent layout (issue #60).
+# Run from repo root: bash scripts/test-workflow-state.sh
+# Requires: project.json, work/intent (with at least one intent).
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$REPO_ROOT"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+fail() { echo -e "${RED}FAIL: $*${NC}" >&2; exit 1; }
+ok()   { echo -e "${GREEN}OK: $*${NC}"; }
+
+# Source the lib (use ORCHESTRATOR_DIR pattern so SCRIPT_DIR in lib is lib dir)
+source "$SCRIPT_DIR/lib/workflow_state.sh"
+
+# 1) list_active_intent_ids: should not crash; may be empty or list ids
+ids=($(list_active_intent_ids))
+ok "list_active_intent_ids returned ${#ids[@]} active(s)"
+
+# 2) get_workflow_state_dir with no arg: when flat in use, returns WS_BASE
+dir="$(get_workflow_state_dir)"
+if flat_in_use; then
+  [ "$dir" = "$WS_BASE" ] || fail "get_workflow_state_dir (no arg) should be WS_BASE when flat in use, got: $dir"
+  ok "get_workflow_state_dir () returns flat when flat in use"
+fi
+
+# 3) get_workflow_state_dir with intent id: returns path (flat or per-intent)
+if [ ${#ids[@]} -gt 0 ]; then
+  first="${ids[0]}"
+  dir="$(get_workflow_state_dir "$first")"
+  [ -n "$dir" ] || fail "get_workflow_state_dir $first returned empty"
+  [[ "$dir" == *"workflow-state"* ]] || fail "get_workflow_state_dir $first should contain workflow-state, got: $dir"
+  ok "get_workflow_state_dir $first = $dir"
+fi
+
+# 4) ensure_workflow_state_dir with new id: creates per-intent when flat already has one active
+# Skip if we don't have two intents - just ensure ensure_workflow_state_dir runs
+d="$(ensure_workflow_state_dir "F-DUMMY")"
+[ -n "$d" ] || fail "ensure_workflow_state_dir F-DUMMY returned empty"
+ok "ensure_workflow_state_dir F-DUMMY = $d"
+
+echo ""
+echo -e "${GREEN}Workflow state layout smoke test passed.${NC}"

package/scripts/usage-report.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# Print token/cost usage report from _system/artifacts/usage.json.
+# Usage: usage-report.sh [--last N]
+# Default: show all entries. --last N: show last N entries only.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+CD="${CD:-$REPO_ROOT}"
+cd "$CD"
+
+# shellcheck source=scripts/lib/common.sh
+. "$SCRIPT_DIR/lib/common.sh"
+
+require_cmd jq
+
+USAGE_FILE="_system/artifacts/usage.json"
+LAST_N=""
+
+if [ "${1:-}" = "--last" ] && [ -n "${2:-}" ]; then
+    LAST_N="$2"
+fi
+
+if [ ! -f "$USAGE_FILE" ]; then
+    echo "No usage data (missing $USAGE_FILE). Record with: pnpm usage-record <intent_id> <phase> <tokens_in> <tokens_out>" >&2
+    exit 0
+fi
+
+ENTRIES=$(jq -r '.entries // []' "$USAGE_FILE")
+if [ "$ENTRIES" = "[]" ] || [ -z "$ENTRIES" ]; then
+    echo "No usage entries yet."
+    exit 0
+fi
+
+if [ -n "$LAST_N" ]; then
+    DATA=$(jq --argjson n "$LAST_N" '.entries | if length > $n then .[length-$n:] else . end' "$USAGE_FILE")
+else
+    DATA=$(jq '.entries' "$USAGE_FILE")
+fi
+
+# Table: intent_id, phase, tokens_in, tokens_out, total, estimated_cost_usd, date, source
+printf "%-12s %-14s %10s %10s %10s %12s %-25s %s\n" "intent_id" "phase" "tokens_in" "tokens_out" "total" "cost_usd" "timestamp_iso" "source"
+echo "$DATA" | jq -r '.[] | [.intent_id, .phase, (.tokens_in|tostring), (.tokens_out|tostring), ((.tokens_in + .tokens_out)|tostring), (if .estimated_cost_usd == null then "-" else (.estimated_cost_usd | tostring) end), .timestamp_iso, .source] | @tsv' 2>/dev/null | while IFS=$'\t' read -r intent_id phase tokens_in tokens_out total cost ts source; do
+    printf "%-12s %-14s %10s %10s %10s %12s %-25s %s\n" "$intent_id" "$phase" "$tokens_in" "$tokens_out" "$total" "$cost" "$ts" "$source"
+done