@nlaprell/shipit 1.0.0

package/scripts/lib/verify-outputs.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+# Output Verification Library
+# Provides functions to verify script outputs and display summaries
+
+set -euo pipefail
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Verify a file exists
+verify_file_exists() {
+    local filepath="$1"
+    local description="${2:-$(basename "$filepath")}"
+    
+    if [ -f "$filepath" ]; then
+        echo -e "${GREEN}✓${NC} $description"
+        return 0
+    else
+        echo -e "${RED}✗${NC} $description (missing)"
+        return 1
+    fi
+}
+
+# Verify intent files were created
+verify_intent_files() {
+    local count="${1:-0}"
+    local pattern="${2:-F-*.md}"
+    local intent_dir="${INTENT_DIR:-work/intent}"
+    
+    if [ $count -eq 0 ]; then
+        return 0
+    fi
+    
+    local actual_count=$(find "$intent_dir" -name "$pattern" ! -name "_TEMPLATE.md" 2>/dev/null | wc -l | tr -d ' ')
+    
+    if [ "$actual_count" -ge "$count" ]; then
+        echo -e "${GREEN}✓${NC} Generated $actual_count intent file(s)"
+        return 0
+    else
+        echo -e "${RED}✗${NC} Expected $count intent file(s), found $actual_count"
+        return 1
+    fi
+}
+
+# Print summary header
+print_summary_header() {
+    local title="${1:-Summary}"
+    echo ""
+    echo -e "${YELLOW}$title${NC}"
+    echo ""
+}

package/scripts/lib/workflow_state.sh

@@ -0,0 +1,201 @@
+#!/bin/bash
+
+# Workflow state path resolution for flat vs per-intent layout.
+# Source this after common.sh. See _system/architecture/workflow-state-layout.md.
+# Usage: source scripts/lib/workflow_state.sh
+#   get_workflow_state_dir [intent_id]  -> path (no trailing slash for dir)
+#   list_active_intent_ids             -> space-separated list
+#   ensure_workflow_state_dir intent_id -> path (for writing)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+WS_BASE="$REPO_ROOT/work/workflow-state"
+ACTIVE_FILE="$WS_BASE/active.md"
+
+# List intent IDs that have per-intent state directories (F-*, B-*, T-*).
+list_per_intent_dirs() {
+    local ids=()
+    if [ ! -d "$WS_BASE" ]; then
+        echo ""
+        return 0
+    fi
+    local d
+    for d in "$WS_BASE"/F-* "$WS_BASE"/B-* "$WS_BASE"/T-*; do
+        [ -d "$d" ] || continue
+        ids+=("$(basename "$d")")
+    done 2>/dev/null || true
+    [ ${#ids[@]} -eq 0 ] && echo "" || echo "${ids[*]}"
+}
+
+# Parse active.md for active intent id(s).
+# Legacy: **Intent ID:** F-001 (single). Multi: ## Active intents block with "F-001 | Phase | status" lines.
+# Output: space-separated list of intent ids considered active (from active.md and/or per-intent dirs).
+list_active_intent_ids() {
+    local from_file=()
+    local from_dirs=()
+    if [ -f "$ACTIVE_FILE" ]; then
+        local line
+        while IFS= read -r line; do
+            if [[ "$line" =~ \*\*Intent\ ID:\*\*\ ([^[:space:]]+) ]]; then
+                local id="${BASH_REMATCH[1]}"
+                [[ "$id" != "none" ]] && from_file+=("$id")
+            fi
+            if [[ "$line" =~ ^(F-[0-9]+|B-[0-9]+|T-[0-9]+)[[:space:]]*\| ]]; then
+                from_file+=("${BASH_REMATCH[1]}")
+            fi
+        done < "$ACTIVE_FILE"
+    fi
+    local dirs
+    dirs="$(list_per_intent_dirs)"
+    if [ -n "$dirs" ]; then
+        from_dirs=($dirs)
+    fi
+    # Merge: unique list, file first then dirs
+    local seen=()
+    local out=()
+    for id in "${from_file[@]}" "${from_dirs[@]}"; do
+        [ -z "$id" ] && continue
+        found=0
+        if [ ${#seen[@]} -gt 0 ]; then
+            for s in "${seen[@]}"; do [ "$s" = "$id" ] && found=1 && break; done
+        fi
+        [ "$found" -eq 0 ] && seen+=("$id") && out+=("$id")
+    done
+    [ ${#out[@]} -eq 0 ] && echo "" || echo "${out[*]}"
+}
+
+# Is flat layout in use? (flat phase files exist and no per-intent dirs, or flat is only state)
+flat_in_use() {
+    if [ -f "$WS_BASE/01_analysis.md" ] || [ -f "$WS_BASE/02_plan.md" ]; then
+        local dirs
+        dirs="$(list_per_intent_dirs)"
+        [ -z "$dirs" ] && return 0
+    fi
+    return 1
+}
+
+# Resolve workflow state directory for reading or writing.
+# Usage: get_workflow_state_dir [intent_id]
+# - With intent_id: returns work/workflow-state/<intent_id> (per-intent).
+# - Without intent_id: returns flat work/workflow-state if flat layout in use; otherwise empty (caller must pass intent_id when multiple actives).
+get_workflow_state_dir() {
+    local intent_id="${1:-}"
+    if [ -n "$intent_id" ]; then
+        if [ -d "$WS_BASE/$intent_id" ]; then
+            echo "$WS_BASE/$intent_id"
+            return 0
+        fi
+        # Flat in use and active.md single intent matches: return flat so existing single-intent repos keep working.
+        if flat_in_use; then
+            local actives
+            actives=($(list_active_intent_ids))
+            if [ "${#actives[@]}" -eq 1 ] && [ "${actives[0]}" = "$intent_id" ]; then
+                echo "$WS_BASE"
+                return 0
+            fi
+        fi
+        echo "$WS_BASE/$intent_id"
+        return 0
+    fi
+    # No intent_id: return flat if flat in use (single-intent backward compat).
+    if flat_in_use; then
+        echo "$WS_BASE"
+        return 0
+    fi
+    # Multiple per-intent dirs or no flat: no single "current" dir.
+    echo ""
+    return 0
+}
+
+# For writing: ensure we have a directory path for this intent. When to use flat vs per-intent:
+# - If flat is in use and this is the only active intent, use flat.
+# - Otherwise use work/workflow-state/<intent_id>/.
+# Usage: ensure_workflow_state_dir <intent_id>
+# Output: path to dir (no trailing slash). Creates dir if per-intent.
+ensure_workflow_state_dir() {
+    local intent_id="$1"
+    [ -n "$intent_id" ] || { echo ""; return 1; }
+    if [ -d "$WS_BASE/$intent_id" ]; then
+        echo "$WS_BASE/$intent_id"
+        return 0
+    fi
+    if flat_in_use; then
+        local actives
+        actives=($(list_active_intent_ids))
+        if [ "${#actives[@]}" -le 1 ] && { [ "${#actives[@]}" -eq 0 ] || [ "${actives[0]}" = "$intent_id" ]; }; then
+            echo "$WS_BASE"
+            return 0
+        fi
+    fi
+    mkdir -p "$WS_BASE/$intent_id"
+    echo "$WS_BASE/$intent_id"
+    return 0
+}
+
+# Append an intent to active.md's active list (for multi-intent). Call when starting workflow for intent_id.
+# If active.md has legacy single **Intent ID:** and it's "none" or same intent, update in place.
+# If we're adding a second intent, ensure "## Active intents" exists and append "intent_id | Phase | active".
+append_or_set_active_intent() {
+    local intent_id="$1"
+    local phase_name="${2:-Analysis}"
+    [ -n "$intent_id" ] || return 1
+    mkdir -p "$(dirname "$ACTIVE_FILE")"
+    if [ ! -f "$ACTIVE_FILE" ]; then
+        cat > "$ACTIVE_FILE" << EOF
+# Active Intent
+
+**Intent ID:** $intent_id
+**Status:** active
+**Current Phase:** $phase_name
+**Started:** $(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+## Progress
+
+- [ ] Phase 1: Analysis
+- [ ] Phase 2: Planning
+- [ ] Phase 3: Implementation
+- [ ] Phase 4: Verification
+- [ ] Phase 5: Release Notes
+
+## Active intents
+
+$intent_id | $phase_name | active
+EOF
+        return 0
+    fi
+    local actives
+    actives=($(list_active_intent_ids))
+    if [ "${#actives[@]}" -eq 0 ]; then
+        # Replace legacy "none" or empty with this intent
+        sed -e "s/**Intent ID:\*\* .*/**Intent ID:** $intent_id/" \
+            -e "s/**Status:\*\* .*/**Status:** active/" \
+            -e "s/**Current Phase:\*\* .*/**Current Phase:** $phase_name/" \
+            -e "s/**Started:\*\* .*/**Started:** $(date -u +"%Y-%m-%dT%H:%M:%SZ")/" \
+            "$ACTIVE_FILE" > "${ACTIVE_FILE}.tmp" && mv "${ACTIVE_FILE}.tmp" "$ACTIVE_FILE"
+        if ! grep -q "## Active intents" "$ACTIVE_FILE"; then
+            printf '\n## Active intents\n\n%s | %s | active\n' "$intent_id" "$phase_name" >> "$ACTIVE_FILE"
+        else
+            grep -q "$intent_id" "$ACTIVE_FILE" || printf '%s | %s | active\n' "$intent_id" "$phase_name" >> "$ACTIVE_FILE"
+        fi
+        return 0
+    fi
+    if [[ " ${actives[*]} " == *" $intent_id "* ]]; then
+        # Already listed; update phase if we have ## Active intents
+        if grep -q "## Active intents" "$ACTIVE_FILE"; then
+            local tmp
+            tmp="$(mktemp)"
+            awk -v id="$intent_id" -v ph="$phase_name" '
+                $0 ~ "^" id "[[:space:]]*\\|" { print id " | " ph " | active"; next }
+                { print }
+            ' "$ACTIVE_FILE" > "$tmp" && mv "$tmp" "$ACTIVE_FILE"
+        fi
+        return 0
+    fi
+    # Add new intent to list
+    if ! grep -q "## Active intents" "$ACTIVE_FILE"; then
+        printf '\n## Active intents\n\n%s | %s | active\n' "$intent_id" "$phase_name" >> "$ACTIVE_FILE"
+    else
+        printf '%s | %s | active\n' "$intent_id" "$phase_name" >> "$ACTIVE_FILE"
+    fi
+    return 0
+}

package/scripts/new-intent.sh

@@ -0,0 +1,271 @@
+#!/bin/bash
+
+# Automated Intent Creation Script
+# Creates a new intent file from template with interactive prompts
+
+set -euo pipefail
+
+# Error handling
+error_exit() {
+    echo "ERROR: $1" >&2
+    exit "${2:-1}"
+}
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+INTENT_BASE_DIR="work/intent"
+TEMPLATES_DIR="$INTENT_BASE_DIR/templates"
+
+# Validate prerequisites: default template must exist
+if [ ! -f "$INTENT_BASE_DIR/_TEMPLATE.md" ]; then
+    error_exit "Template file not found: $INTENT_BASE_DIR/_TEMPLATE.md"
+fi
+
+# Get intent type
+echo -e "${YELLOW}Intent Type:${NC}"
+echo "1) Feature (F-###)"
+echo "2) Bug (B-###)"
+echo "3) Tech Debt (T-###)"
+read -p "Select type [1-3]: " type_choice
+
+case $type_choice in
+    1) INTENT_TYPE="feature"; PREFIX="F"; INTENT_DIR="$INTENT_BASE_DIR/features" ;;
+    2) INTENT_TYPE="bug"; PREFIX="B"; INTENT_DIR="$INTENT_BASE_DIR/bugs" ;;
+    3) INTENT_TYPE="tech-debt"; PREFIX="T"; INTENT_DIR="$INTENT_BASE_DIR/tech-debt" ;;
+    *) error_exit "Invalid choice" 1 ;;
+esac
+
+# Template (optional): Generic or kind-specific
+echo -e "${YELLOW}Template (optional):${NC}"
+echo "1) Generic (default)"
+echo "2) API endpoint"
+echo "3) Frontend feature"
+echo "4) Infra change"
+echo "5) Bugfix"
+echo "6) Refactor"
+read -p "Select template [1-6, default=1]: " template_choice
+
+case $template_choice in
+    1) TEMPLATE_FILE="$INTENT_BASE_DIR/_TEMPLATE.md" ;;
+    2) TEMPLATE_FILE="$TEMPLATES_DIR/api-endpoint.md" ;;
+    3) TEMPLATE_FILE="$TEMPLATES_DIR/frontend-feature.md" ;;
+    4) TEMPLATE_FILE="$TEMPLATES_DIR/infra-change.md" ;;
+    5) TEMPLATE_FILE="$TEMPLATES_DIR/bugfix.md" ;;
+    6) TEMPLATE_FILE="$TEMPLATES_DIR/refactor.md" ;;
+    *) TEMPLATE_FILE="$INTENT_BASE_DIR/_TEMPLATE.md" ;;
+esac
+# Fallback to default if chosen template file does not exist (e.g. project without templates/)
+if [ ! -f "$TEMPLATE_FILE" ]; then
+    TEMPLATE_FILE="$INTENT_BASE_DIR/_TEMPLATE.md"
+fi
+
+mkdir -p "$INTENT_DIR"
+
+# Get next intent number without overwriting existing files
+LAST_INTENT=0
+while IFS= read -r file; do
+    [ -e "$file" ] || continue
+    base="$(basename "$file")"
+    if [[ "$base" =~ ^[FBT]-([0-9]+)\.md$ ]]; then
+        num="${BASH_REMATCH[1]}"
+        if ((10#$num > LAST_INTENT)); then
+            LAST_INTENT=$((10#$num))
+        fi
+    fi
+done < <(find "$INTENT_BASE_DIR" -type f -name '[FBT]-*.md' 2>/dev/null)
+NEXT_NUM=$((LAST_INTENT + 1))
+INTENT_ID="${PREFIX}-$(printf "%03d" $NEXT_NUM)"
+
+# Get title
+read -p "Title: " TITLE
+if [ -z "$TITLE" ]; then
+    error_exit "Title is required" 1
+fi
+
+# Get motivation
+echo -e "${YELLOW}Motivation (press Enter after each line, type 'done' when finished):${NC}"
+MOTIVATION=""
+while IFS= read -r line; do
+    [ "$line" = "done" ] && break
+    MOTIVATION="${MOTIVATION}- ${line}\n"
+done
+
+# Get priority
+echo -e "${YELLOW}Priority:${NC}"
+echo "1) p0 (Critical)"
+echo "2) p1 (High)"
+echo "3) p2 (Medium)"
+echo "4) p3 (Low)"
+read -p "Select priority [1-4, default=2]: " priority_choice
+
+case $priority_choice in
+    1) PRIORITY="p0" ;;
+    2) PRIORITY="p1" ;;
+    3) PRIORITY="p2" ;;
+    4) PRIORITY="p3" ;;
+    *) PRIORITY="p2" ;;
+esac
+
+# Get effort
+echo -e "${YELLOW}Effort:${NC}"
+echo "1) Small (s)"
+echo "2) Medium (m)"
+echo "3) Large (l)"
+read -p "Select effort [1-3, default=2]: " effort_choice
+
+case $effort_choice in
+    1) EFFORT="s" ;;
+    2) EFFORT="m" ;;
+    3) EFFORT="l" ;;
+    *) EFFORT="m" ;;
+esac
+
+# Get release target
+echo -e "${YELLOW}Release Target:${NC}"
+echo "1) R1 (Next release)"
+echo "2) R2 (Following release)"
+echo "3) R3 (Future)"
+echo "4) R4 (Backlog)"
+read -p "Select release target [1-4, default=2]: " release_choice
+
+case $release_choice in
+    1) RELEASE_TARGET="R1" ;;
+    2) RELEASE_TARGET="R2" ;;
+    3) RELEASE_TARGET="R3" ;;
+    4) RELEASE_TARGET="R4" ;;
+    *) RELEASE_TARGET="R2" ;;
+esac
+
+# Get dependencies
+echo -e "${YELLOW}Dependencies:${NC}"
+echo "Enter intent IDs (e.g., F-001, F-002) or 'none' for no dependencies"
+echo "Press Enter after each ID, type 'done' when finished:"
+DEPENDENCIES=()
+while IFS= read -r dep_line; do
+    [ "$dep_line" = "done" ] && break
+    [ -z "$dep_line" ] && continue
+    if [ "$dep_line" = "none" ]; then
+        DEPENDENCIES=()
+        break
+    fi
+    # Validate format (F-###, B-###, T-###)
+    if [[ "$dep_line" =~ ^[FBT]-[0-9]+$ ]]; then
+        DEPENDENCIES+=("$dep_line")
+    else
+        echo -e "${RED}Invalid format. Use F-###, B-###, or T-###${NC}"
+    fi
+done
+
+# Get risk level
+echo -e "${YELLOW}Risk Level:${NC}"
+echo "1) Low"
+echo "2) Medium"
+echo "3) High"
+read -p "Select risk [1-3, default=1]: " risk_choice
+
+case $risk_choice in
+    1) RISK_LEVEL="low" ;;
+    2) RISK_LEVEL="medium" ;;
+    3) RISK_LEVEL="high" ;;
+    *) RISK_LEVEL="low" ;;
+esac
+
+# Create intent file
+INTENT_FILE="$INTENT_DIR/$INTENT_ID.md"
+if [ -e "$INTENT_FILE" ]; then
+    error_exit "Intent file already exists: $INTENT_FILE" 1
+fi
+
+# Read template and replace placeholders (portable across BSD/GNU sed)
+TEMP_FILE="$(mktemp)"
+MOTIVATION_FILE="$(mktemp)"
+
+sed -e "s/# F-###: Title/# $INTENT_ID: $TITLE/" \
+    -e "s/feature | bug | tech-debt/$INTENT_TYPE/" \
+    -e "s/planned | active | blocked | validating | shipped | killed/planned/" \
+    -e "s/p0 | p1 | p2 | p3/$PRIORITY/" \
+    -e "s/s | m | l/$EFFORT/" \
+    -e "s/R1 | R2 | R3 | R4/$RELEASE_TARGET/" \
+    -e "s/low | medium | high/$RISK_LEVEL/" \
+    "$TEMPLATE_FILE" > "$TEMP_FILE" || error_exit "Failed to create intent template"
+
+printf "%b" "$MOTIVATION" | sed 's/^/  /' > "$MOTIVATION_FILE"
+
+# Create dependencies file
+DEP_FILE="$(mktemp)"
+if [ ${#DEPENDENCIES[@]} -eq 0 ]; then
+    echo "- (none)" > "$DEP_FILE"
+else
+    for dep in "${DEPENDENCIES[@]}"; do
+        echo "- $dep" >> "$DEP_FILE"
+    done
+fi
+
+awk -v motivation_file="$MOTIVATION_FILE" -v deps_file="$DEP_FILE" '
+    $0 == "(Why it exists, 1–3 bullets)" {
+        while ((getline line < motivation_file) > 0) print line;
+        close(motivation_file);
+        next;
+    }
+    /^- \(Other intent IDs that must ship first\)$/ {
+        while ((getline line < deps_file) > 0) print line;
+        close(deps_file);
+        # Skip remaining placeholder dependency lines
+        while (getline > 0) {
+            if (/^## / || /^$/) {
+                print;
+                break;
+            }
+            # Skip placeholder lines (lines starting with "- (")
+            if (!/^- \(/) {
+                print;
+            }
+        }
+        next;
+    }
+    { print }
+' "$TEMP_FILE" > "$INTENT_FILE" || error_exit "Failed to create intent file"
+
+rm -f "$TEMP_FILE" "$MOTIVATION_FILE" "$DEP_FILE"
+
+echo -e "${GREEN}✓ Created intent: $INTENT_FILE${NC}"
+
+# Refresh roadmap after creating a new intent (best effort)
+if [ -x "./scripts/generate-roadmap.sh" ]; then
+    echo -e "${YELLOW}Updating roadmap...${NC}"
+    ./scripts/generate-roadmap.sh || echo "WARNING: roadmap generation failed"
+fi
+
+# Refresh release plan after creating a new intent (best effort)
+if [ -x "./scripts/generate-release-plan.sh" ]; then
+    echo -e "${YELLOW}Updating release plan...${NC}"
+    ./scripts/generate-release-plan.sh || echo "WARNING: release plan generation failed"
+fi
+
+echo ""
+echo -e "${GREEN}════════════════════════════════════════${NC}"
+echo -e "${GREEN}✓ Intent created successfully!${NC}"
+echo -e "${GREEN}════════════════════════════════════════${NC}"
+echo ""
+echo -e "${YELLOW}Intent Details:${NC}"
+echo "  ID: $INTENT_ID"
+echo "  Title: $TITLE"
+echo "  Type: $INTENT_TYPE"
+echo "  Priority: $PRIORITY"
+echo "  Effort: $EFFORT"
+echo "  Release Target: $RELEASE_TARGET"
+echo "  Risk Level: $RISK_LEVEL"
+if [ ${#DEPENDENCIES[@]} -gt 0 ]; then
+    echo "  Dependencies: ${DEPENDENCIES[*]}"
+else
+    echo "  Dependencies: (none)"
+fi
+echo ""
+echo -e "${YELLOW}Next steps:${NC}"
+echo "1. Review $INTENT_FILE"
+echo "2. Fill in acceptance criteria, invariants, and other details"
+echo "3. Run: /ship $INTENT_ID"

package/scripts/publish-npm.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Publish @nlaprell/shipit to npm. Run from repo root.
+# Auth: set NODE_AUTH_TOKEN, or put your npm token (one line, no newline) in .npm-token (gitignored).
+# Token must be granular with Bypass 2FA for scope @nlaprell.
+# Uses a temp .npmrc so stale token in ~/.npmrc is ignored.
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+if [[ -n "${NODE_AUTH_TOKEN:-}" ]]; then
+  echo "Using NODE_AUTH_TOKEN from environment."
+elif [[ -f .npm-token ]]; then
+  export NODE_AUTH_TOKEN
+  NODE_AUTH_TOKEN=$(cat .npm-token | tr -d '\n\r')
+  echo "Using token from .npm-token"
+else
+  echo "No NODE_AUTH_TOKEN and no .npm-token file."
+  echo "Create .npm-token with one line: your granular npm token (Bypass 2FA, scope @nlaprell)."
+  echo "Or run: NODE_AUTH_TOKEN=<token> pnpm publish:npm"
+  exit 1
+fi
+
+# Force npm to use only our token (ignore stale ~/.npmrc)
+tmp_npmrc=$(mktemp)
+echo "//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}" > "$tmp_npmrc"
+trap 'rm -f "$tmp_npmrc"' EXIT
+
+echo "Publishing @nlaprell/shipit@$(node -p "require('./package.json').version")..."
+npm publish --access public --userconfig "$tmp_npmrc"