@nlaprell/shipit 1.0.0

package/scripts/export-dashboard-json.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+/**
+ * Export dashboard JSON for the React dashboard.
+ * Reads: work/intent/, work/workflow-state/, _system/artifacts/, _system/drift/
+ * Layout: Supports both flat and per-intent workflow-state per workflow-state-layout.md
+ * Output: dashboard-app/public/dashboard.json
+ */
+
+import {
+  readFileSync,
+  readdirSync,
+  existsSync,
+  writeFileSync,
+  mkdirSync,
+} from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = join(__dirname, "..");
+
+function readText(path) {
+  try {
+    return readFileSync(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+
+function readJson(path) {
+  const text = readText(path);
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+function findIntentFiles(dir, files = []) {
+  if (!existsSync(dir)) return files;
+  const entries = readdirSync(dir, { withFileTypes: true });
+  for (const e of entries) {
+    const p = join(dir, e.name);
+    if (e.isDirectory()) {
+      if (e.name !== "templates") findIntentFiles(p, files);
+    } else if (e.name.endsWith(".md") && e.name !== "_TEMPLATE.md") {
+      files.push(p);
+    }
+  }
+  return files;
+}
+
+function parseIntentStatus(content) {
+  const m = content.match(/##\s*Status\s*\n\s*(\w+)/i);
+  return m ? m[1].toLowerCase() : "unknown";
+}
+
+function getIntentId(path) {
+  const base = path.split(/[/\\]/).pop() || "";
+  return base.replace(/\.md$/, "");
+}
+
+function collectIntents() {
+  const intentDir = join(REPO_ROOT, "work", "intent");
+  const files = findIntentFiles(intentDir);
+  const intents = [];
+  for (const f of files) {
+    const content = readText(f);
+    if (!content) continue;
+    const status = parseIntentStatus(content);
+    const id = getIntentId(f);
+    intents.push({ id, status });
+  }
+  const byStatus = { planned: 0, active: 0, shipped: 0, killed: 0 };
+  for (const i of intents) {
+    if (i.status in byStatus) byStatus[i.status]++;
+  }
+  return { intents, counts: byStatus };
+}
+
+function getWorkflowState() {
+  const flatActive = join(REPO_ROOT, "work", "workflow-state", "active.md");
+  const content = readText(flatActive);
+  let currentPhase = "none";
+  let activeIntent = "none";
+  const activeIntents = [];
+  let waitingForApproval = false;
+
+  const workflowDir = join(REPO_ROOT, "work", "workflow-state");
+  if (!existsSync(workflowDir)) {
+    return { currentPhase, activeIntent, activeIntents, waitingForApproval };
+  }
+
+  if (content) {
+    const phaseM = content.match(/Current Phase:\s*(\S+)/i);
+    const idM = content.match(/Intent ID:\s*(\S+)/i);
+    if (phaseM) currentPhase = phaseM[1];
+    if (idM && idM[1] !== "none") {
+      activeIntent = idM[1];
+      activeIntents.push(idM[1]);
+    }
+    // Multi-intent: parse "## Active intents" block (lines like "F-001 | Phase | active")
+    const activeSection = content.match(/##\s+Active intents\s*\n([\s\S]*?)(?=\n##|$)/i);
+    if (activeSection && activeSection[1]) {
+      const lines = activeSection[1].split("\n");
+      for (const line of lines) {
+        const m = line.match(/^(F-\d+|B-\d+|T-\d+)\s*\|/);
+        if (m && !activeIntents.includes(m[1])) activeIntents.push(m[1]);
+      }
+      if (activeIntents.length > 0 && activeIntent === "none")
+        activeIntent = activeIntents[0];
+      if (activeIntents.length > 1) currentPhase = "multiple";
+    }
+    waitingForApproval = /waiting|approval|gate/i.test(content);
+  }
+
+  return { currentPhase, activeIntent, activeIntents, waitingForApproval };
+}
+
+function getCalibration() {
+  try {
+    const out = execSync("pnpm calibration-report --json", {
+      cwd: REPO_ROOT,
+      encoding: "utf-8",
+    });
+    return JSON.parse(out);
+  } catch {
+    return { decisions_count: 0, message: "No calibration data" };
+  }
+}
+
+function getDocLinks() {
+  const base = REPO_ROOT;
+  const links = [];
+  const candidates = [
+    ["_system/artifacts/SYSTEM_STATE.md", "System State"],
+    ["work/release/plan.md", "Release Plan"],
+    ["work/roadmap/now.md", "Roadmap (Now)"],
+    ["work/roadmap/next.md", "Roadmap (Next)"],
+    ["work/roadmap/later.md", "Roadmap (Later)"],
+    ["_system/drift/metrics.md", "Drift Metrics"],
+    ["_system/artifacts/dependencies.md", "Dependencies"],
+  ];
+  for (const [rel, label] of candidates) {
+    if (existsSync(join(base, rel))) {
+      links.push({ path: rel, label });
+    }
+  }
+  return links;
+}
+
+function getDriftSummary() {
+  const p = join(REPO_ROOT, "_system", "drift", "metrics.md");
+  const content = readText(p);
+  if (!content) return null;
+  return { raw: content.slice(0, 2000), hasMetrics: true };
+}
+
+function getUsageSummary() {
+  const p = join(REPO_ROOT, "_system", "artifacts", "usage.json");
+  const data = readJson(p);
+  if (!data) return null;
+  const entries = Array.isArray(data) ? data : data.entries || [];
+  return { entryCount: entries.length, hasUsage: entries.length > 0 };
+}
+
+function getProjectName() {
+  const pj = readJson(join(REPO_ROOT, "project.json"));
+  if (pj?.name) return pj.name;
+  const pkg = readJson(join(REPO_ROOT, "package.json"));
+  return pkg?.name || "project";
+}
+
+function exportDashboard() {
+  const intents = collectIntents();
+  const workflow = getWorkflowState();
+  const calibration = getCalibration();
+  const docLinks = getDocLinks();
+  const drift = getDriftSummary();
+  const usage = getUsageSummary();
+
+  const payload = {
+    generated: new Date().toISOString(),
+    projectName: getProjectName(),
+    intents,
+    workflow,
+    calibration,
+    docLinks,
+    drift,
+    usage,
+    testSummary: null,
+  };
+
+  const outDir = join(REPO_ROOT, "dashboard-app", "public");
+  const outPath = join(outDir, "dashboard.json");
+  mkdirSync(outDir, { recursive: true });
+  writeFileSync(outPath, JSON.stringify(payload, null, 2), "utf-8");
+  console.log(`Wrote ${outPath}`);
+}
+
+try {
+  exportDashboard();
+} catch (err) {
+  console.error(err);
+  process.exit(1);
+}

package/scripts/fix-intents.sh

@@ -0,0 +1,239 @@
+#!/bin/bash
+
+# Fix Intent Issues Script
+# Detects and auto-fixes common intent issues
+
+set -euo pipefail
+
+error_exit() {
+    echo "ERROR: $1" >&2
+    exit "${2:-1}"
+}
+
+warning() {
+    echo "WARNING: $1" >&2
+}
+
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Source validation library
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/lib/validate-intents.sh" || error_exit "Failed to load validation library" 1
+
+INTENT_DIR="${INTENT_DIR:-work/intent}"
+
+# Fix whitespace issues in dependencies
+fix_whitespace() {
+    local intent_file="$1"
+    local temp_file=$(mktemp)
+    
+    if ! awk '
+        BEGIN { in_deps=0 }
+        /^## Dependencies/ {
+            in_deps=1
+            print
+            next
+        }
+        in_deps && /^## / {
+            in_deps=0
+            print
+            next
+        }
+        in_deps && /^[[:space:]]+- / {
+            # Remove leading whitespace
+            sub(/^[[:space:]]+/, "")
+            print
+            next
+        }
+        { print }
+    ' "$intent_file" > "$temp_file"; then
+        rm -f "$temp_file"
+        return 1
+    fi
+    
+    mv "$temp_file" "$intent_file"
+    echo "✓ Fixed whitespace in $(basename "$intent_file")"
+}
+
+# Fix dependency ordering by moving dependency to same/earlier release
+fix_dependency_ordering() {
+    local intent_id="$1"
+    local dep_id="$2"
+    local intent_release="$3"
+    
+    local dep_file=$(find "$INTENT_DIR" -type f -name "${dep_id}.md" -print -quit 2>/dev/null)
+    if [ -z "$dep_file" ] || [ ! -f "$dep_file" ]; then
+        warning "Cannot fix: $dep_id file not found"
+        return 1
+    fi
+    
+    # Update dependency's release target to match or be earlier than dependent's release
+    local temp_file=$(mktemp)
+    if ! awk -v target_release="$intent_release" '
+        BEGIN { in_release=0; release_set=0 }
+        /^## Release Target/ {
+            in_release=1
+            # Check if inline format
+            if (match($0, /R[0-9]+/)) {
+                current_release = substr($0, RSTART, RLENGTH)
+                current_num = substr(current_release, 2)
+                target_num = substr(target_release, 2)
+                if (current_num > target_num) {
+                    # Replace with target release
+                    sub(/R[0-9]+/, target_release)
+                    release_set=1
+                }
+                print
+                next
+            }
+            print
+            next
+        }
+        in_release && /^## / {
+            if (!release_set) {
+                # Release target not set yet, add it
+                print target_release
+                release_set=1
+            }
+            in_release=0
+            print
+            next
+        }
+        in_release && /R[0-9]+/ {
+            if (!/\|/) {  # Not a template line
+                if (match($0, /R[0-9]+/)) {
+                    current_release = substr($0, RSTART, RLENGTH)
+                    current_num = substr(current_release, 2)
+                    target_num = substr(target_release, 2)
+                    if (current_num > target_num) {
+                        # Replace with target release
+                        sub(/R[0-9]+/, target_release)
+                        release_set=1
+                    }
+                }
+            }
+            print
+            next
+        }
+        { print }
+        END {
+            if (in_release && !release_set) {
+                print target_release
+            }
+        }
+    ' "$dep_file" > "$temp_file"; then
+        rm -f "$temp_file"
+        return 1
+    fi
+    
+    mv "$temp_file" "$dep_file"
+    echo "✓ Moved $dep_id to $intent_release (to satisfy $intent_id dependency)"
+}
+
+# Main fix function
+main() {
+    echo -e "${BLUE}Scanning for intent issues...${NC}"
+    echo ""
+    
+    # Collect all issues
+    local all_issues=()
+    local intent_files=()
+    
+    # Find all intent files recursively
+    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)
+    
+    if [ ${#intent_files[@]} -eq 0 ]; then
+        echo -e "${GREEN}✓ No intent files found${NC}"
+        return 0
+    fi
+    
+    # Validate all intents and collect issues
+    for intent_file in "${intent_files[@]}"; do
+        while IFS= read -r issue; do
+            [ -n "$issue" ] && all_issues+=("$issue")
+        done < <(validate_intent "$intent_file" || true)
+    done
+    
+    if [ ${#all_issues[@]} -eq 0 ]; then
+        echo -e "${GREEN}✓ No issues found${NC}"
+        return 0
+    fi
+    
+    # Display issues
+    echo -e "${YELLOW}Found ${#all_issues[@]} issue(s):${NC}"
+    echo ""
+    
+    local i=1
+    for issue in "${all_issues[@]}"; do
+        local issue_type=$(echo "$issue" | cut -d'|' -f1)
+        local intent_id=$(echo "$issue" | cut -d'|' -f2)
+        local message=$(echo "$issue" | cut -d'|' -f3)
+        local fix_suggestion=$(echo "$issue" | cut -d'|' -f4)
+        
+        echo -e "${YELLOW}[$i]${NC} $intent_id: $message"
+        echo "    Fix: $fix_suggestion"
+        echo ""
+        i=$((i + 1))
+    done
+    
+    # Ask for confirmation
+    echo -e "${BLUE}Apply fixes? (y/n):${NC} "
+    read -r response
+    
+    if [ "$response" != "y" ] && [ "$response" != "Y" ]; then
+        echo "Cancelled."
+        return 0
+    fi
+    
+    echo ""
+    echo -e "${BLUE}Applying fixes...${NC}"
+    echo ""
+    
+    # Apply fixes
+    local fixed_count=0
+    for issue in "${all_issues[@]}"; do
+        local issue_type=$(echo "$issue" | cut -d'|' -f1)
+        local intent_id=$(echo "$issue" | cut -d'|' -f2)
+        local intent_file=$(find "$INTENT_DIR" -type f -name "${intent_id}.md" -print -quit 2>/dev/null)
+        if [ -z "$intent_file" ] || [ ! -f "$intent_file" ]; then
+            warning "Intent file not found: $intent_id"
+            continue
+        fi
+        
+        case "$issue_type" in
+            whitespace)
+                fix_whitespace "$intent_file"
+                fixed_count=$((fixed_count + 1))
+                ;;
+            dependency_ordering)
+                # Extract dependency ID from message
+                local dep_id=$(echo "$issue" | grep -o '[A-Z]-[0-9]*' | head -2 | tail -1)
+                local intent_release=$(echo "$issue" | grep -o 'R[0-9]*' | head -1)
+                if [ -n "$dep_id" ] && [ -n "$intent_release" ]; then
+                    fix_dependency_ordering "$intent_id" "$dep_id" "$intent_release"
+                    fixed_count=$((fixed_count + 1))
+                fi
+                ;;
+            missing_dependency|circular)
+                echo -e "${YELLOW}⚠ Skipping $issue_type issue (requires manual intervention)${NC}"
+                ;;
+        esac
+    done
+    
+    echo ""
+    if [ $fixed_count -gt 0 ]; then
+        echo -e "${GREEN}✓ Fixed $fixed_count issue(s)${NC}"
+    else
+        echo -e "${YELLOW}No automatic fixes applied${NC}"
+    fi
+}
+
+main "$@"

package/scripts/generate-dashboard.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+
+# Generate Project Dashboard Script
+# Creates a project status dashboard
+
+set -euo pipefail
+
+error_exit() {
+    echo "ERROR: $1" >&2
+    exit "${2:-1}"
+}
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+DASHBOARD_FILE="DASHBOARD.md"
+
+echo -e "${BLUE}Generating project dashboard...${NC}"
+
+# Check prerequisites
+if [ ! -f "project.json" ]; then
+    error_exit "project.json not found. Run /init-project first." 1
+fi
+
+PROJECT_NAME=$(jq -r '.name' project.json 2>/dev/null || echo "project")
+
+# Collect metrics
+intent_files=()
+while IFS= read -r file; do
+    intent_files+=("$file")
+done < <(find intent -type f -name "*.md" ! -name "_TEMPLATE.md" 2>/dev/null)
+
+INTENT_TOTAL=${#intent_files[@]}
+if [ "$INTENT_TOTAL" -gt 0 ]; then
+    INTENT_PLANNED=$(grep -l "Status.*planned" "${intent_files[@]}" 2>/dev/null | wc -l | tr -d ' ')
+    INTENT_ACTIVE=$(grep -l "Status.*active" "${intent_files[@]}" 2>/dev/null | wc -l | tr -d ' ')
+    INTENT_SHIPPED=$(grep -l "Status.*shipped" "${intent_files[@]}" 2>/dev/null | wc -l | tr -d ' ')
+    INTENT_BLOCKED=$(grep -l "Status.*blocked" "${intent_files[@]}" 2>/dev/null | wc -l | tr -d ' ')
+else
+    INTENT_PLANNED=0
+    INTENT_ACTIVE=0
+    INTENT_SHIPPED=0
+    INTENT_BLOCKED=0
+fi
+
+# Calculate progress
+if [ "$INTENT_TOTAL" -gt 0 ]; then
+    PROGRESS=$((INTENT_SHIPPED * 100 / INTENT_TOTAL))
+else
+    PROGRESS=0
+fi
+
+# Get active intent details
+ACTIVE_INTENT=$(grep -h "Intent ID:" work/workflow-state/active.md 2>/dev/null | grep -o "F-[0-9]*\|B-[0-9]*\|T-[0-9]*" | head -1 || echo "none")
+ACTIVE_PHASE=$(grep -h "Current Phase:" work/workflow-state/active.md 2>/dev/null | sed 's/.*Current Phase: *//' || echo "unknown")
+
+# Test coverage (if available)
+if command -v pnpm >/dev/null 2>&1 && [ -f "package.json" ]; then
+    COVERAGE=$(pnpm test:coverage 2>/dev/null | grep -o "[0-9]*%" | head -1 || echo "N/A")
+else
+    COVERAGE="N/A"
+fi
+
+# Generate dashboard
+cat > "$DASHBOARD_FILE" << EOF || error_exit "Failed to generate dashboard"
+# Project Dashboard: $PROJECT_NAME
+
+**Last Updated:** $(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+## 📊 Status Overview
+
+| Metric | Value |
+|--------|-------|
+| **Total Intents** | $INTENT_TOTAL |
+| **Planned** | $INTENT_PLANNED |
+| **Active** | $INTENT_ACTIVE |
+| **Shipped** | $INTENT_SHIPPED |
+| **Blocked** | $INTENT_BLOCKED |
+| **Progress** | $PROGRESS% |
+
+## 🎯 Current Work
+
+- **Active Intent:** $ACTIVE_INTENT
+- **Current Phase:** $ACTIVE_PHASE
+
+## 📈 Progress Visualization
+
+\`\`\`
+Shipped:    [$(printf '#%.0s' $(seq 1 $((PROGRESS / 2))))$(printf ' %.0s' $(seq 1 $((50 - PROGRESS / 2))))] $PROGRESS%
+\`\`\`
+
+## 🔄 Intent Status Breakdown
+
+- ✅ Shipped: $INTENT_SHIPPED
+- 🔄 Active: $INTENT_ACTIVE
+- 📋 Planned: $INTENT_PLANNED
+- ⛔ Blocked: $INTENT_BLOCKED
+
+## 🧪 Quality Metrics
+
+- **Test Coverage:** $COVERAGE
+- **Lint Status:** [Run: pnpm lint]
+- **Type Check:** [Run: pnpm typecheck]
+
+## 📋 Recent Intents
+
+$(if [ "$INTENT_TOTAL" -gt 0 ]; then printf "%s\n" "${intent_files[@]}" | head -5 | xargs -I{} basename "{}" .md | sed 's/^/- /'; else echo "No intents yet"; fi)
+
+## 🔗 Quick Links
+
+- [Project Context](./PROJECT_CONTEXT.md)
+- [Roadmap](./work/roadmap/now.md)
+- [Dependencies](./_system/artifacts/dependencies.md)
+- [Deployment History](./deployment-history.md)
+
+## 🚀 Next Actions
+
+1. Review active intent: $ACTIVE_INTENT
+2. Check workflow state: work/workflow-state/
+3. Update roadmap: work/roadmap/
+
+---
+
+*This dashboard is auto-generated. Run \`pnpm generate-dashboard\` to update.*
+EOF
+
+echo -e "${GREEN}✓ Generated $DASHBOARD_FILE${NC}"
+echo ""
+echo -e "${YELLOW}Dashboard Metrics:${NC}"
+echo "  Total Intents: $INTENT_TOTAL"
+echo "  Progress: $PROGRESS%"
+echo "  Active: $ACTIVE_INTENT"
+echo ""