@pennyfarthing/core 7.4.1 → 7.5.0

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

@@ -1,264 +0,0 @@
-#!/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

@@ -1,91 +0,0 @@
-#!/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

@@ -1,247 +0,0 @@
-#!/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}"