@pennyfarthing/core 7.9.0 → 7.9.2

package/pennyfarthing-dist/scripts/misc/doctor-dogfood.sh

@@ -1,392 +0,0 @@
-#!/bin/bash
-# doctor-dogfood.sh - Health check for Pennyfarthing developers (dogfooding)
-#
-# Usage: ./pennyfarthing-dist/scripts/doctor-dogfood.sh [--fix]
-#
-# Checks and optionally fixes common setup issues for developers working
-# on the pennyfarthing repo itself.
-
-set -uo pipefail
-
-FIX_MODE=false
-if [[ "${1:-}" == "--fix" ]]; then
-    FIX_MODE=true
-fi
-
-# Colors (if terminal supports them)
-if [[ -t 1 ]]; then
-    RED='\033[0;31m'
-    GREEN='\033[0;32m'
-    YELLOW='\033[0;33m'
-    NC='\033[0m' # No Color
-else
-    RED=''
-    GREEN=''
-    YELLOW=''
-    NC=''
-fi
-
-ERRORS=0
-WARNINGS=0
-FIXED=0
-
-ok() {
-    echo -e "${GREEN}OK${NC}    $1"
-}
-
-warn() {
-    echo -e "${YELLOW}WARN${NC}  $1"
-    ((WARNINGS++))
-}
-
-fail() {
-    echo -e "${RED}FAIL${NC}  $1"
-    ((ERRORS++))
-}
-
-fix() {
-    echo -e "${GREEN}FIX${NC}   $1"
-    ((FIXED++))
-}
-
-# Find project root
-find_project_root() {
-    local dir="$PWD"
-    while [[ ! -d "$dir/pennyfarthing-dist" ]] && [[ "$dir" != "/" ]]; do
-        dir="$(dirname "$dir")"
-    done
-    if [[ -d "$dir/pennyfarthing-dist" ]]; then
-        echo "$dir"
-    else
-        echo ""
-    fi
-}
-
-PROJECT_ROOT="$(find_project_root)"
-
-echo "Pennyfarthing Dogfooding Doctor"
-echo "================================"
-echo ""
-
-# Check we're in the right place
-if [[ -z "$PROJECT_ROOT" ]]; then
-    fail "Not in pennyfarthing repo (no pennyfarthing-dist/ found)"
-    exit 1
-fi
-
-cd "$PROJECT_ROOT"
-ok "Project root: $PROJECT_ROOT"
-
-echo ""
-echo "Checking prerequisites..."
-echo ""
-
-# Check Node.js
-if command -v node &>/dev/null; then
-    NODE_VERSION=$(node --version)
-    ok "Node.js: $NODE_VERSION"
-else
-    fail "Node.js not installed"
-fi
-
-# Check npm
-if command -v npm &>/dev/null; then
-    NPM_VERSION=$(npm --version)
-    ok "npm: $NPM_VERSION"
-else
-    fail "npm not installed"
-fi
-
-# Check yq (for sprint YAML manipulation)
-if command -v yq &>/dev/null; then
-    YQ_VERSION=$(yq --version 2>&1 | head -1)
-    ok "yq: $YQ_VERSION"
-else
-    warn "yq not installed (needed for post-merge hook)"
-    if $FIX_MODE; then
-        echo "     Run: brew install yq"
-    fi
-fi
-
-# Check jira CLI (optional)
-if command -v jira &>/dev/null; then
-    ok "jira CLI: installed"
-else
-    warn "jira CLI not installed (optional, for Jira sync)"
-fi
-
-echo ""
-echo "Checking symlinks..."
-echo ""
-
-# Check .pennyfarthing/ symlinks (new structure)
-PENNYFARTHING_SYMLINKS=("agents" "guides" "personas" "scripts")
-for item in "${PENNYFARTHING_SYMLINKS[@]}"; do
-    link_path=".pennyfarthing/$item"
-    expected_target="../pennyfarthing-dist/$item"
-
-    if [[ -L "$link_path" ]]; then
-        actual_target=$(readlink "$link_path")
-        if [[ "$actual_target" == "$expected_target" ]]; then
-            ok ".pennyfarthing/$item -> $expected_target"
-        else
-            warn ".pennyfarthing/$item points to: $actual_target (expected $expected_target)"
-        fi
-    elif [[ -d "$link_path" ]]; then
-        fail ".pennyfarthing/$item is a directory, should be symlink"
-        if $FIX_MODE; then
-            rm -rf "$link_path"
-            ln -s "$expected_target" "$link_path"
-            fix ".pennyfarthing/$item symlink created"
-        fi
-    else
-        fail ".pennyfarthing/$item missing"
-        if $FIX_MODE; then
-            mkdir -p .pennyfarthing
-            ln -s "$expected_target" "$link_path"
-            fix ".pennyfarthing/$item symlink created"
-        fi
-    fi
-done
-
-# Check .claude/ symlinks (commands and skills only)
-CLAUDE_SYMLINKS=("commands" "skills")
-for item in "${CLAUDE_SYMLINKS[@]}"; do
-    link_path=".claude/$item"
-    expected_target="../pennyfarthing-dist/$item"
-
-    if [[ -L "$link_path" ]]; then
-        actual_target=$(readlink "$link_path")
-        if [[ "$actual_target" == "$expected_target" ]]; then
-            ok ".claude/$item -> $expected_target"
-        else
-            warn ".claude/$item points to: $actual_target (expected $expected_target)"
-        fi
-    elif [[ -d "$link_path" ]]; then
-        warn ".claude/$item is a directory, should be symlink to pennyfarthing-dist/$item"
-        if $FIX_MODE; then
-            rm -rf "$link_path"
-            ln -s "$expected_target" "$link_path"
-            fix ".claude/$item symlink created"
-        fi
-    else
-        fail ".claude/$item missing"
-        if $FIX_MODE; then
-            ln -s "$expected_target" "$link_path"
-            fix ".claude/$item symlink created"
-        fi
-    fi
-done
-
-# Check scripts directory/symlink
-if [[ -L "scripts" ]]; then
-    TARGET=$(readlink "scripts")
-    ok "scripts -> $TARGET"
-elif [[ -d "scripts" ]]; then
-    # Check if contents are symlinks to pennyfarthing-dist
-    if [[ -L "scripts/core/agent-session.sh" ]]; then
-        ok "scripts/ directory with symlinks (dogfooding setup)"
-    else
-        warn "scripts/ is a directory but contents may not be symlinked"
-    fi
-else
-    fail "scripts/ missing"
-fi
-
-echo ""
-echo "Checking git hooks..."
-echo ""
-
-# Check git hooks
-HOOKS=("pre-commit" "pre-push" "post-merge")
-for hook in "${HOOKS[@]}"; do
-    hook_path=".git/hooks/$hook"
-    expected_target="../../pennyfarthing-dist/scripts/hooks/${hook}.sh"
-
-    if [[ -L "$hook_path" ]]; then
-        actual_target=$(readlink "$hook_path")
-        if [[ "$actual_target" == "$expected_target" ]]; then
-            ok "$hook hook -> $expected_target"
-        else
-            warn "$hook hook points to: $actual_target"
-            if $FIX_MODE; then
-                ln -sf "$expected_target" "$hook_path"
-                fix "$hook hook updated"
-            fi
-        fi
-    elif [[ -f "$hook_path" ]]; then
-        # Check if it's our hook (contains pennyfarthing marker)
-        if grep -q "pennyfarthing" "$hook_path" 2>/dev/null; then
-            ok "$hook hook (file, pennyfarthing)"
-        else
-            warn "$hook hook exists but is not pennyfarthing hook"
-            if $FIX_MODE; then
-                mv "$hook_path" "${hook_path}.backup"
-                ln -sf "$expected_target" "$hook_path"
-                fix "$hook hook replaced (backup saved)"
-            fi
-        fi
-    else
-        fail "$hook hook missing"
-        if $FIX_MODE; then
-            ln -sf "$expected_target" "$hook_path"
-            fix "$hook hook installed"
-        fi
-    fi
-done
-
-echo ""
-echo "Checking build..."
-echo ""
-
-# Check if packages/core/dist/ is up to date (monorepo structure)
-CORE_DIST="packages/core/dist"
-if [[ -d "$CORE_DIST" ]]; then
-    # Check if any src file is newer than its dist counterpart
-    OUTDATED=false
-    for src_file in packages/core/src/cli/commands/*.ts; do
-        if [[ -f "$src_file" ]]; then
-            base=$(basename "$src_file" .ts)
-            dist_file="${CORE_DIST}/cli/commands/${base}.js"
-            if [[ -f "$dist_file" ]]; then
-                if [[ "$src_file" -nt "$dist_file" ]]; then
-                    OUTDATED=true
-                    break
-                fi
-            fi
-        fi
-    done
-
-    if $OUTDATED; then
-        warn "packages/core/dist/ may be outdated (run: npm run build)"
-        if $FIX_MODE; then
-            npm run build >/dev/null 2>&1
-            fix "Rebuilt packages"
-        fi
-    else
-        ok "packages/core/dist/ appears up to date"
-    fi
-else
-    fail "packages/core/dist/ missing"
-    if $FIX_MODE; then
-        npm run build >/dev/null 2>&1
-        fix "Built packages"
-    fi
-fi
-
-# Check node_modules
-if [[ -d "node_modules" ]]; then
-    ok "node_modules/ exists"
-else
-    fail "node_modules/ missing (run: npm install)"
-    if $FIX_MODE; then
-        npm install >/dev/null 2>&1
-        fix "Installed dependencies"
-    fi
-fi
-
-echo ""
-echo "Checking for broken symlinks..."
-echo ""
-
-# Find broken symlinks in key directories
-BROKEN_LINKS=$(find .claude pennyfarthing-dist scripts -type l ! -exec test -e {} \; -print 2>/dev/null)
-if [[ -n "$BROKEN_LINKS" ]]; then
-    while IFS= read -r link; do
-        fail "Broken symlink: $link"
-        if $FIX_MODE; then
-            rm "$link" 2>/dev/null && fix "Removed $link"
-        fi
-    done <<< "$BROKEN_LINKS"
-else
-    ok "No broken symlinks"
-fi
-
-echo ""
-echo "Checking file locations..."
-echo ""
-
-# Check .pennyfarthing/sidecars exists (user-specific, not symlinked)
-if [[ -d ".pennyfarthing/sidecars" ]]; then
-    SIDECAR_COUNT=$(find .pennyfarthing/sidecars -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
-    ok ".pennyfarthing/sidecars/ exists ($SIDECAR_COUNT agent sidecars)"
-else
-    warn ".pennyfarthing/sidecars/ missing (agent learning files)"
-fi
-
-# Check .claude/project exists (project-specific customizations)
-if [[ -d ".claude/project" ]]; then
-    ok ".claude/project/ exists"
-else
-    warn ".claude/project/ missing"
-fi
-
-echo ""
-echo "Checking scripts/ structure..."
-echo ""
-
-# Count distributed vs local scripts
-DIST_SCRIPTS=0
-LOCAL_SCRIPTS=0
-if compgen -G "scripts/*.sh" > /dev/null 2>&1; then
-    for f in scripts/*.sh; do
-        if [[ -L "$f" ]]; then
-            ((DIST_SCRIPTS++))
-        elif [[ -f "$f" ]]; then
-            ((LOCAL_SCRIPTS++))
-        fi
-    done
-fi
-
-ok "$DIST_SCRIPTS distributed scripts (symlinks to pennyfarthing-dist/)"
-if [[ $LOCAL_SCRIPTS -gt 0 ]]; then
-    ok "$LOCAL_SCRIPTS local scripts (dogfooding only, not in npm package)"
-fi
-
-echo ""
-echo "Checking Claude Code integration..."
-echo ""
-
-# Check settings.local.json
-if [[ -f ".claude/settings.local.json" ]]; then
-    ok ".claude/settings.local.json exists"
-else
-    warn ".claude/settings.local.json missing"
-fi
-
-# Check persona config (priority: .pennyfarthing/ > .claude/shared)
-if [[ -f ".pennyfarthing/config.local.yaml" ]]; then
-    THEME=$(grep "^theme:" ".pennyfarthing/config.local.yaml" | awk '{print $2}')
-    ok "Theme: ${THEME:-unknown} (.pennyfarthing/)"
-elif [[ -f ".claude/persona-config.yaml" ]]; then
-    THEME=$(grep "^theme:" ".claude/persona-config.yaml" | awk '{print $2}')
-    ok "Theme: ${THEME:-unknown} (.claude/ shared)"
-else
-    warn "No persona config found (will use default theme)"
-fi
-
-echo ""
-echo "================================"
-echo "Summary"
-echo "================================"
-echo ""
-
-if [[ $ERRORS -eq 0 ]] && [[ $WARNINGS -eq 0 ]]; then
-    echo -e "${GREEN}All checks passed!${NC}"
-elif [[ $ERRORS -eq 0 ]]; then
-    echo -e "${YELLOW}$WARNINGS warning(s), 0 errors${NC}"
-else
-    echo -e "${RED}$ERRORS error(s), $WARNINGS warning(s)${NC}"
-fi
-
-if $FIX_MODE && [[ $FIXED -gt 0 ]]; then
-    echo -e "${GREEN}$FIXED issue(s) fixed${NC}"
-fi
-
-if [[ $ERRORS -gt 0 ]] && ! $FIX_MODE; then
-    echo ""
-    echo "Run with --fix to attempt automatic repairs:"
-    echo "  ./pennyfarthing-dist/scripts/doctor-dogfood.sh --fix"
-fi
-
-exit $ERRORS

package/pennyfarthing-dist/scripts/misc/find-related-work.sh

@@ -1,231 +0,0 @@
-#!/usr/bin/env zsh
-# Find related archived work sessions for context
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-# Usage
-usage() {
-    cat <<EOF
-Usage: $0 [OPTIONS] <search-term>
-
-Find related archived work sessions for context.
-
-OPTIONS:
-    -e, --epic EPIC_NUM    Find all stories in this epic (e.g., 35)
-    -s, --story STORY_ID   Find specific story (e.g., 35-6)
-    -k, --keyword TERM     Search by keyword in archived sessions
-    -l, --list             List all archived sessions
-    --summaries-only       Show only context summaries, not full sessions
-    -h, --help             Show this help
-
-EXAMPLES:
-    # Find all work related to epic 35
-    $0 --epic 35
-
-    # Find specific story
-    $0 --story 35-6
-
-    # Search for keyword
-    $0 --keyword "topology editor"
-
-    # List all archived work
-    $0 --list
-
-    # Show only lightweight summaries
-    $0 --epic 35 --summaries-only
-EOF
-}
-
-# Parse arguments
-EPIC=""
-STORY=""
-KEYWORD=""
-LIST_ALL=false
-SUMMARIES_ONLY=false
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -e|--epic)
-            EPIC="$2"
-            shift 2
-            ;;
-        -s|--story)
-            STORY="$2"
-            shift 2
-            ;;
-        -k|--keyword)
-            KEYWORD="$2"
-            shift 2
-            ;;
-        -l|--list)
-            LIST_ALL=true
-            shift
-            ;;
-        --summaries-only)
-            SUMMARIES_ONLY=true
-            shift
-            ;;
-        -h|--help)
-            usage
-            exit 0
-            ;;
-        *)
-            echo "Unknown option: $1"
-            usage
-            exit 1
-            ;;
-    esac
-done
-
-# Directories
-ARCHIVE_DIR="$PROJECT_ROOT/sprint/archive"
-CONTEXT_DIR="$PROJECT_ROOT/sprint/context"
-
-# Ensure directories exist
-mkdir -p "$ARCHIVE_DIR" "$CONTEXT_DIR"
-
-# Colors for output
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# List all archived sessions
-if [ "$LIST_ALL" = true ]; then
-    echo -e "${BLUE}=== Archived Work Sessions ===${NC}"
-    echo ""
-
-    if [ "$SUMMARIES_ONLY" = true ]; then
-        # List summaries
-        if [ -d "$CONTEXT_DIR" ]; then
-            for file in "$CONTEXT_DIR"/*-summary.md; do
-                [ -e "$file" ] || continue
-                basename "$file"
-            done
-        else
-            echo "No context summaries found."
-        fi
-    else
-        # List full sessions
-        for file in "$ARCHIVE_DIR"/*.md; do
-            [ -e "$file" ] || continue
-            basename "$file"
-        done
-    fi
-    exit 0
-fi
-
-# Search by epic
-if [ -n "$EPIC" ]; then
-    echo -e "${BLUE}=== Stories in Epic $EPIC ===${NC}"
-    echo ""
-
-    if [ "$SUMMARIES_ONLY" = true ]; then
-        # Search summaries
-        SUMMARY_FILE="$CONTEXT_DIR/epic-$EPIC-summary.md"
-        if [ -f "$SUMMARY_FILE" ]; then
-            echo -e "${GREEN}Found epic summary:${NC} $SUMMARY_FILE"
-            echo ""
-            cat "$SUMMARY_FILE"
-        else
-            echo "No summary found for epic $EPIC"
-            echo "Searching full archive..."
-            grep -l "epic-$EPIC\|Epic $EPIC\|$EPIC-[0-9]" "$ARCHIVE_DIR"/*.md 2>/dev/null || echo "No archived work found for epic $EPIC"
-        fi
-    else
-        # Search full sessions
-        MATCHES=$(grep -l "epic-$EPIC\|Epic $EPIC\|$EPIC-[0-9]" "$ARCHIVE_DIR"/*.md 2>/dev/null || true)
-
-        if [ -n "$MATCHES" ]; then
-            echo "$MATCHES" | while read -r file; do
-                echo -e "${GREEN}Found:${NC} $(basename "$file")"
-                echo "  Path: $file"
-
-                # Extract story ID and title if present
-                STORY_LINE=$(grep -m 1 "Story.*$EPIC-[0-9]\|ID:.*$EPIC-[0-9]" "$file" || true)
-                if [ -n "$STORY_LINE" ]; then
-                    echo -e "  ${YELLOW}Story:${NC} $STORY_LINE"
-                fi
-                echo ""
-            done
-        else
-            echo "No archived work found for epic $EPIC"
-        fi
-    fi
-    exit 0
-fi
-
-# Search by story
-if [ -n "$STORY" ]; then
-    echo -e "${BLUE}=== Story $STORY ===${NC}"
-    echo ""
-
-    if [ "$SUMMARIES_ONLY" = true ]; then
-        # Check for story summary
-        STORY_SUMMARY="$CONTEXT_DIR/story-$STORY-summary.md"
-        if [ -f "$STORY_SUMMARY" ]; then
-            echo -e "${GREEN}Found story summary:${NC} $STORY_SUMMARY"
-            echo ""
-            cat "$STORY_SUMMARY"
-            exit 0
-        fi
-    fi
-
-    # Search full archive
-    MATCHES=$(grep -l "$STORY\|story.*$STORY" "$ARCHIVE_DIR"/*.md 2>/dev/null || true)
-
-    if [ -n "$MATCHES" ]; then
-        echo "$MATCHES" | while read -r file; do
-            echo -e "${GREEN}Found:${NC} $(basename "$file")"
-            echo "  Path: $file"
-            echo ""
-
-            # Show first few lines of context
-            echo -e "${YELLOW}Context preview:${NC}"
-            head -30 "$file" | grep -v "^#\|^-\|^$" | head -10
-            echo ""
-        done
-    else
-        echo "No archived work found for story $STORY"
-    fi
-    exit 0
-fi
-
-# Search by keyword
-if [ -n "$KEYWORD" ]; then
-    echo -e "${BLUE}=== Search: '$KEYWORD' ===${NC}"
-    echo ""
-
-    SEARCH_DIR="$ARCHIVE_DIR"
-    if [ "$SUMMARIES_ONLY" = true ]; then
-        SEARCH_DIR="$CONTEXT_DIR"
-    fi
-
-    MATCHES=$(grep -il "$KEYWORD" "$SEARCH_DIR"/*.md 2>/dev/null || true)
-
-    if [ -n "$MATCHES" ]; then
-        echo "$MATCHES" | while read -r file; do
-            echo -e "${GREEN}Found in:${NC} $(basename "$file")"
-            echo "  Path: $file"
-            echo ""
-
-            # Show matching lines with context
-            grep -i -C 2 "$KEYWORD" "$file" | head -20
-            echo ""
-            echo "---"
-            echo ""
-        done
-    else
-        echo "No matches found for '$KEYWORD'"
-    fi
-    exit 0
-fi
-
-# No search term provided
-echo "Error: Must provide search term"
-echo ""
-usage
-exit 1