@pennyfarthing/core 7.4.0 → 7.4.1

package/pennyfarthing-dist/scripts/misc/add-short-names.mjs

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+/**
+ * add-short-names.mjs
+ *
+ * Pre-generates shortName field for all characters in theme YAML files.
+ * Finds the shortest unique identifier that distinguishes each character.
+ *
+ * Usage:
+ *   node add-short-names.mjs                    # Dry run - show what would change
+ *   node add-short-names.mjs --write            # Actually write changes
+ *   node add-short-names.mjs --theme discworld  # Only process one theme
+ */
+
+import { readFileSync, writeFileSync, readdirSync } from 'fs';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const themesDir = join(__dirname, '..', 'personas', 'themes');
+
+// Common titles/prefixes to strip for comparison
+const SKIP_PREFIXES = new Set([
+  'the', 'dr.', 'dr', 'captain', 'admiral', 'colonel', 'lieutenant', 'commander',
+  'president', 'lord', 'lady', 'sir', 'professor', 'inspector', 'sergeant',
+  'mr.', 'mr', 'mrs.', 'mrs', 'miss', 'ms.', 'ms', 'chief', 'major', 'general',
+  'king', 'queen', 'prince', 'princess', 'duke', 'earl', 'count', 'baron',
+  'first', 'grand', 'arch', 'high',
+  // Family/religious titles
+  'uncle', 'aunt', 'brother', 'sister', 'father', 'mother', 'friar',
+  // Role titles
+  'avatar', 'agent', 'detective', 'officer', 'private', 'corporal',
+  'chancellor', 'ambassador', 'senator', 'governor', 'minister',
+  // Honorifics
+  'master', 'young', 'old', 'elder', 'reverend', 'bishop', 'cardinal'
+]);
+
+// Words that make poor short names on their own (contextless or too generic)
+const POOR_SHORT_NAMES = new Set([
+  'big', 'little', 'old', 'young', 'true', 'false', 'good', 'bad',
+  'thought', 'ministry', 'situation', 'room', 'place', 'house',
+  'superintendent', 'commander', 'speaker', 'council',
+  'mode', 'narrator', 'chronicler',
+  // Avoid single/double initials
+  'h.m.', 'j.f.', 'a.w.', 'e.b.', 'l.'
+]);
+
+// Names that should use the full form (iconic two-word names)
+const USE_FULL_NAME = new Set([
+  'big brother',
+  'sun tzu'
+]);
+
+/**
+ * Extract quoted nickname from character name if present
+ * e.g., 'Colonel John "Hannibal" Smith' -> 'Hannibal'
+ * Returns null if no nickname or if nickname is multi-word (like "Howling Mad")
+ */
+function extractNickname(name) {
+  const match = name.match(/["']([^"']+)["']/);
+  if (match) {
+    const nickname = match[1].trim();
+    // Only use single-word nicknames (skip descriptive like "Howling Mad")
+    if (nickname && !nickname.includes(' ')) {
+      return nickname;
+    }
+  }
+  return null;
+}
+
+/**
+ * Clean character name by removing parenthetical annotations and slash alternatives
+ */
+function cleanName(name) {
+  // Remove parenthetical annotations like '(Season 1)', '(Architect)', '(DevOps)'
+  let cleaned = name.replace(/\s*\([^)]+\)\s*/g, ' ').trim();
+  // For slash alternatives like 'Commander/Captain John', take the last part
+  // e.g., 'Commander/Captain' becomes just 'Captain', 'John Sheridan' stays
+  cleaned = cleaned.replace(/\b\w+\/(\w+)\s/g, '$1 ');
+  // Remove quoted nicknames like "Apollo" or 'Bones'
+  cleaned = cleaned.replace(/\s*["'][^"']+["']\s*/g, ' ').trim();
+  // Collapse multiple spaces
+  cleaned = cleaned.replace(/\s+/g, ' ').trim();
+  return cleaned;
+}
+
+/**
+ * Tokenize a name into meaningful parts
+ */
+function tokenize(name) {
+  const cleaned = cleanName(name);
+  const words = cleaned.split(/\s+/).filter(w => w.length > 0);
+
+  // Filter out prefixes and single-letter initials (like R. or L.)
+  const filtered = words.filter(w => {
+    const lower = w.toLowerCase();
+    if (SKIP_PREFIXES.has(lower)) return false;
+    if (/^[A-Z]\.$/.test(w)) return false;  // Single initial like R.
+    if (/^[IVXLCDM]+$/.test(w)) return false;  // Roman numerals
+    return true;
+  });
+
+  return filtered.length > 0 ? filtered : words;
+}
+
+/**
+ * Compute display name map for all characters in a theme
+ */
+function computeShortNames(agents) {
+  const shortNames = new Map();
+  const characters = Object.values(agents)
+    .filter(a => a?.character)
+    .map(a => a.character);
+
+  /**
+   * Check if a candidate is unique among all characters
+   */
+  function isUnique(candidate, exceptFor) {
+    const candidateLower = candidate.toLowerCase();
+    for (const char of characters) {
+      if (char === exceptFor) continue;
+      const tokens = tokenize(char);
+      if (tokens.some(t => t.toLowerCase() === candidateLower)) return false;
+    }
+    return true;
+  }
+
+  /**
+   * Check if a candidate would make a good short name
+   */
+  function isGoodShortName(candidate) {
+    const lower = candidate.toLowerCase();
+    return !POOR_SHORT_NAMES.has(lower) && candidate.length > 1;
+  }
+
+  /**
+   * Find the best short name for a character
+   */
+  function findShortName(fullName) {
+    const cleaned = cleanName(fullName);
+
+    // Check if this is an iconic name that should stay full
+    if (USE_FULL_NAME.has(cleaned.toLowerCase())) {
+      return cleaned;
+    }
+
+    // Strategy 0: Prefer quoted nickname if present (e.g., "Hannibal", "Starbuck")
+    const nickname = extractNickname(fullName);
+    if (nickname && isGoodShortName(nickname)) {
+      return nickname;
+    }
+
+    const tokens = tokenize(fullName);
+
+    if (tokens.length === 0) {
+      return cleaned;
+    }
+
+    if (tokens.length === 1) {
+      return tokens[0];
+    }
+
+    // Strategy 1: First token (if good and unique)
+    if (isGoodShortName(tokens[0]) && isUnique(tokens[0], fullName)) {
+      return tokens[0];
+    }
+
+    // Strategy 2: Last token (surname, if good and unique)
+    const lastToken = tokens[tokens.length - 1];
+    if (isGoodShortName(lastToken) && isUnique(lastToken, fullName)) {
+      return lastToken;
+    }
+
+    // Strategy 3: First + Last
+    if (tokens.length >= 2) {
+      const firstLast = `${tokens[0]} ${lastToken}`;
+      if (isUnique(firstLast, fullName)) {
+        return firstLast;
+      }
+    }
+
+    // Fallback: cleaned full name
+    return cleanName(fullName);
+  }
+
+  // Compute short name for each character
+  for (const char of characters) {
+    shortNames.set(char, findShortName(char));
+  }
+
+  return shortNames;
+}
+
+/**
+ * Process a single theme file
+ */
+function processTheme(filename, dryRun = true) {
+  const filepath = join(themesDir, filename);
+  const content = readFileSync(filepath, 'utf-8');
+  const theme = parseYaml(content);
+
+  if (!theme?.agents) {
+    console.log(`  Skipping ${filename} - no agents found`);
+    return { changes: 0, filename };
+  }
+
+  const shortNames = computeShortNames(theme.agents);
+  let changes = 0;
+
+  for (const [role, agent] of Object.entries(theme.agents)) {
+    if (!agent?.character) continue;
+
+    const shortName = shortNames.get(agent.character);
+    const existing = agent.shortName;
+
+    if (shortName && shortName !== existing) {
+      if (dryRun) {
+        const existingNote = existing ? ` (was: "${existing}")` : '';
+        console.log(`  ${role}: "${agent.character}" -> "${shortName}"${existingNote}`);
+      }
+      agent.shortName = shortName;
+      changes++;
+    }
+  }
+
+  if (!dryRun && changes > 0) {
+    // Write back with yaml stringify
+    const newContent = stringifyYaml(theme, { lineWidth: 0 });
+    writeFileSync(filepath, newContent, 'utf-8');
+    console.log(`  Wrote ${changes} changes to ${filename}`);
+  }
+
+  return { changes, filename };
+}
+
+// Main execution
+const args = process.argv.slice(2);
+const dryRun = !args.includes('--write');
+const themeArg = args.find(a => a.startsWith('--theme='))?.split('=')[1];
+const singleTheme = args.includes('--theme') ? args[args.indexOf('--theme') + 1] : themeArg;
+
+console.log(dryRun ? '🔍 DRY RUN - No files will be modified\n' : '✏️ WRITING CHANGES\n');
+
+let files = readdirSync(themesDir).filter(f => f.endsWith('.yaml'));
+if (singleTheme) {
+  files = files.filter(f => f === `${singleTheme}.yaml` || f === singleTheme);
+}
+
+let totalChanges = 0;
+for (const file of files.sort()) {
+  console.log(`\n📁 ${file}:`);
+  const { changes } = processTheme(file, dryRun);
+  totalChanges += changes;
+  if (changes === 0) {
+    console.log('  (no changes needed)');
+  }
+}
+
+console.log(`\n${'='.repeat(50)}`);
+console.log(`Total: ${totalChanges} changes across ${files.length} themes`);
+if (dryRun && totalChanges > 0) {
+  console.log('\nRun with --write to apply changes');
+}

package/pennyfarthing-dist/scripts/misc/backlog.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env zsh
+# backlog.sh - Display backlog stories in a formatted table
+# Usage: backlog.sh
+# Reads sprint/current-sprint.yaml and outputs backlog stories
+
+set -euo pipefail
+
+SCRIPT_DIR="${0:A:h}"
+PROJECT_ROOT="${SCRIPT_DIR}/../.."
+
+# Find project root by looking for .claude directory
+find_project_root() {
+    local dir="$PWD"
+    while [[ "$dir" != "/" ]]; do
+        if [[ -d "$dir/.claude" ]]; then
+            echo "$dir"
+            return 0
+        fi
+        dir="$(dirname "$dir")"
+    done
+    echo "$PWD"
+}
+
+PROJECT_ROOT="$(find_project_root)"
+SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
+
+if [[ ! -f "$SPRINT_FILE" ]]; then
+    echo "Error: sprint/current-sprint.yaml not found" >&2
+    exit 1
+fi
+
+# Parse YAML and extract backlog stories
+# Output format: | Story | Title | Pts | Epic |
+
+echo "| Story | Title | Pts | Epic |"
+echo "|-------|-------|-----|------|"
+
+# Use yq if available, otherwise fall back to grep/awk
+if command -v yq &>/dev/null; then
+    yq eval '
+        .epics[] |
+        .id as $epic_id |
+        .stories[]? |
+        select(.status == "backlog") |
+        "| " + .id + " | " + .title + " | " + (.points | tostring) + " | " + $epic_id + " |"
+    ' "$SPRINT_FILE"
+else
+    # Fallback: grep-based extraction
+    current_epic=""
+    in_stories=false
+
+    while IFS= read -r line; do
+        # Detect epic id
+        if [[ "$line" =~ ^[[:space:]]*-[[:space:]]*id:[[:space:]]*(MSSCI-[0-9]+) ]]; then
+            current_epic="${match[1]}"
+            in_stories=false
+        fi
+
+        # Detect stories section
+        if [[ "$line" =~ ^[[:space:]]*stories: ]]; then
+            in_stories=true
+        fi
+
+        # Detect story with backlog status (look ahead)
+        if [[ "$in_stories" == true && "$line" =~ ^[[:space:]]*-[[:space:]]*id:[[:space:]]*(MSSCI-[0-9]+) ]]; then
+            story_id="${match[1]}"
+            story_title=""
+            story_points=""
+            story_status=""
+
+            # Read next lines for this story
+            while IFS= read -r detail; do
+                [[ "$detail" =~ ^[[:space:]]*-[[:space:]]*id: ]] && break
+                [[ "$detail" =~ ^[[:space:]]*title:[[:space:]]*[\"\']*(.+)[\"\']*$ ]] && story_title="${match[1]}"
+                [[ "$detail" =~ ^[[:space:]]*points:[[:space:]]*([0-9]+) ]] && story_points="${match[1]}"
+                [[ "$detail" =~ ^[[:space:]]*status:[[:space:]]*(.+) ]] && story_status="${match[1]}"
+
+                # If we have all fields and status is backlog, print and break
+                if [[ -n "$story_title" && -n "$story_points" && "$story_status" == "backlog" ]]; then
+                    echo "| $story_id | $story_title | $story_points | $current_epic |"
+                    break
+                fi
+
+                # If status is not backlog, skip this story
+                if [[ -n "$story_status" && "$story_status" != "backlog" ]]; then
+                    break
+                fi
+            done
+        fi
+    done < "$SPRINT_FILE"
+fi

package/pennyfarthing-dist/scripts/misc/check-status.sh

@@ -0,0 +1,247 @@
+#!/usr/bin/env zsh
+# Enhanced multi-repo git status with color and summaries
+# Usage: ./check-status.sh [repos]
+
+set -e
+
+# Load environment
+if [ -f .env ]; then
+    set -a; source .env; set +a
+elif [ -f ../.env ]; then
+    set -a; source ../.env; set +a
+fi
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+MAGENTA='\033[0;35m'
+NC='\033[0m'
+
+show_help() {
+    cat << 'EOF'
+Check Status - Enhanced multi-repo status
+
+Usage: ./check-status.sh [repos]
+
+Arguments:
+  repos    Which repos to check (default: all)
+           Options: api, ui, all
+
+Features:
+  - Color-coded status output
+  - Shows uncommitted changes
+  - Shows unpushed commits
+  - Shows branch sync status
+  - Summary of all repos
+  - Highlights issues requiring attention
+  - Worktree-aware
+
+Examples:
+  # Check all repos
+  ./check-status.sh
+
+  # Check specific repo
+  ./check-status.sh api
+
+EOF
+}
+
+REPOS="all"
+
+# Parse arguments
+for arg in "$@"; do
+    case $arg in
+        -h|--help)
+            show_help
+            exit 0
+            ;;
+        api|ui|all)
+            REPOS="$arg"
+            ;;
+        *)
+            echo "❌ Unknown argument: $arg"
+            show_help
+            exit 1
+            ;;
+    esac
+done
+
+# Detect if we're in a worktree
+CURRENT_DIR=$(pwd)
+if [[ "$CURRENT_DIR" == *"/worktrees/"* ]]; then
+    WORKTREE_NAME=$(echo "$CURRENT_DIR" | sed -E 's|.*/worktrees/([^/]+).*|\1|')
+    REPO_BASE="$PROJECT_ROOT/worktrees/$WORKTREE_NAME"
+    echo -e "${CYAN}📂 Worktree: $WORKTREE_NAME${NC}"
+else
+    REPO_BASE="$PROJECT_ROOT"
+    echo -e "${CYAN}📂 Main checkout${NC}"
+fi
+
+declare -a CLEAN_REPOS=()
+declare -a DIRTY_REPOS=()
+declare -a AHEAD_REPOS=()
+declare -a BEHIND_REPOS=()
+
+# Check status of a repo
+check_repo_status() {
+    local repo_path=$1
+    local repo_name=$2
+
+    if [ ! -d "$repo_path" ]; then
+        return
+    fi
+
+    cd "$repo_path"
+
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}📦 $repo_name${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+    # Get current branch
+    CURRENT_BRANCH=$(git branch --show-current)
+
+    if [ -z "$CURRENT_BRANCH" ]; then
+        echo -e "   ${RED}⚠️  Detached HEAD${NC}"
+        return
+    fi
+
+    echo -e "   Branch: ${CYAN}$CURRENT_BRANCH${NC}"
+
+    # Check for uncommitted changes
+    if ! git diff-index --quiet HEAD -- 2>/dev/null; then
+        echo -e "   Status: ${YELLOW}⚠️  Uncommitted changes${NC}"
+        DIRTY_REPOS+=("$repo_name")
+
+        # Show what's changed
+        MODIFIED=$(git diff --name-only | wc -l | tr -d ' ')
+        STAGED=$(git diff --cached --name-only | wc -l | tr -d ' ')
+
+        if [ "$STAGED" -gt 0 ]; then
+            echo -e "   ${GREEN}Staged: $STAGED files${NC}"
+        fi
+        if [ "$MODIFIED" -gt 0 ]; then
+            echo -e "   ${YELLOW}Modified: $MODIFIED files${NC}"
+        fi
+
+        # Show short status
+        echo ""
+        git status --short | sed 's/^/   /'
+    else
+        echo -e "   Status: ${GREEN}✓ Clean${NC}"
+        CLEAN_REPOS+=("$repo_name")
+    fi
+
+    # Check remote tracking
+    UPSTREAM=$(git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null || echo "none")
+
+    if [ "$UPSTREAM" = "none" ]; then
+        echo -e "   Remote: ${YELLOW}⚠️  Not tracking remote${NC}"
+    else
+        echo -e "   Remote: ${CYAN}$UPSTREAM${NC}"
+
+        # Fetch to get latest remote info
+        git fetch origin "$CURRENT_BRANCH" --quiet 2>/dev/null || true
+
+        # Check sync status
+        LOCAL=$(git rev-parse @ 2>/dev/null)
+        REMOTE=$(git rev-parse @{u} 2>/dev/null || echo "none")
+
+        if [ "$REMOTE" = "none" ]; then
+            echo -e "   Sync:   ${YELLOW}⚠️  No remote branch${NC}"
+        elif [ "$LOCAL" = "$REMOTE" ]; then
+            echo -e "   Sync:   ${GREEN}✓ Up to date${NC}"
+        else
+            AHEAD=$(git rev-list --count @{u}..HEAD 2>/dev/null || echo "0")
+            BEHIND=$(git rev-list --count HEAD..@{u} 2>/dev/null || echo "0")
+
+            if [ "$AHEAD" -gt 0 ] && [ "$BEHIND" -gt 0 ]; then
+                echo -e "   Sync:   ${RED}⚠️  Diverged ($AHEAD ahead, $BEHIND behind)${NC}"
+            elif [ "$AHEAD" -gt 0 ]; then
+                echo -e "   Sync:   ${YELLOW}⬆️  $AHEAD commit(s) ahead${NC}"
+                AHEAD_REPOS+=("$repo_name ($AHEAD ahead)")
+            elif [ "$BEHIND" -gt 0 ]; then
+                echo -e "   Sync:   ${YELLOW}⬇️  $BEHIND commit(s) behind${NC}"
+                BEHIND_REPOS+=("$repo_name ($BEHIND behind)")
+            fi
+        fi
+    fi
+
+    # Show last commit
+    LAST_COMMIT=$(git log -1 --format="%h - %s" 2>/dev/null)
+    echo -e "   Last:   ${CYAN}$LAST_COMMIT${NC}"
+}
+
+echo ""
+echo "🔍 Checking repository status..."
+echo "   Repos: $REPOS"
+
+# Check repos
+case "$REPOS" in
+    api)
+        check_repo_status "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
+        ;;
+    ui)
+        check_repo_status "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
+        ;;
+    all)
+        check_repo_status "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
+        check_repo_status "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
+        ;;
+esac
+
+# Summary
+echo ""
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo "📊 Summary"
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+if [ ${#CLEAN_REPOS[@]} -gt 0 ]; then
+    echo ""
+    echo -e "${GREEN}✓ Clean (${#CLEAN_REPOS[@]}):${NC}"
+    for repo in "${CLEAN_REPOS[@]}"; do
+        echo -e "   ${GREEN}✓${NC} $repo"
+    done
+fi
+
+if [ ${#DIRTY_REPOS[@]} -gt 0 ]; then
+    echo ""
+    echo -e "${YELLOW}⚠️  Uncommitted Changes (${#DIRTY_REPOS[@]}):${NC}"
+    for repo in "${DIRTY_REPOS[@]}"; do
+        echo -e "   ${YELLOW}•${NC} $repo"
+    done
+fi
+
+if [ ${#AHEAD_REPOS[@]} -gt 0 ]; then
+    echo ""
+    echo -e "${YELLOW}⬆️  Ahead of Remote (${#AHEAD_REPOS[@]}):${NC}"
+    for repo in "${AHEAD_REPOS[@]}"; do
+        echo -e "   ${YELLOW}⬆${NC} $repo"
+    done
+    echo -e "   ${CYAN}Tip: Run ./scripts/commit-and-push.sh or git push${NC}"
+fi
+
+if [ ${#BEHIND_REPOS[@]} -gt 0 ]; then
+    echo ""
+    echo -e "${YELLOW}⬇️  Behind Remote (${#BEHIND_REPOS[@]}):${NC}"
+    for repo in "${BEHIND_REPOS[@]}"; do
+        echo -e "   ${YELLOW}⬇${NC} $repo"
+    done
+    echo -e "   ${CYAN}Tip: Run git pull to update${NC}"
+fi
+
+echo ""
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+TOTAL_REPOS=$((${#CLEAN_REPOS[@]} + ${#DIRTY_REPOS[@]}))
+
+if [ ${#DIRTY_REPOS[@]} -eq 0 ] && [ ${#AHEAD_REPOS[@]} -eq 0 ] && [ ${#BEHIND_REPOS[@]} -eq 0 ]; then
+    echo -e "${GREEN}✅ All repositories are clean and in sync!${NC}"
+else
+    echo -e "${YELLOW}⚠️  ${#DIRTY_REPOS[@]} repo(s) with changes, ${#AHEAD_REPOS[@]} ahead, ${#BEHIND_REPOS[@]} behind${NC}"
+fi
+
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"