@pennyfarthing/core 9.2.0 → 9.3.0

package/pennyfarthing-dist/scripts/misc/add_short_names.py

@@ -1,226 +0,0 @@
-#!/usr/bin/env python3
-"""
-add_short_names.py - Pre-generate shortName field for theme characters
-
-Finds the shortest unique identifier that distinguishes each character.
-
-Usage:
-  python add_short_names.py                    # Dry run - show what would change
-  python add_short_names.py --write            # Actually write changes
-  python add_short_names.py --theme discworld  # Only process one theme
-"""
-
-import argparse
-import re
-import sys
-from pathlib import Path
-
-try:
-    import yaml
-except ImportError:
-    print("Error: PyYAML required. Install with: pip install pyyaml", file=sys.stderr)
-    sys.exit(1)
-
-
-def find_project_root() -> Path:
-    """Find project root by looking for .pennyfarthing directory."""
-    current = Path.cwd()
-    while current != current.parent:
-        if (current / ".pennyfarthing").is_dir():
-            return current
-        current = current.parent
-    return Path.cwd()
-
-
-# Common titles/prefixes to strip for comparison
-SKIP_PREFIXES = {
-    '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',
-    'uncle', 'aunt', 'brother', 'sister', 'father', 'mother', 'friar',
-    'avatar', 'agent', 'detective', 'officer', 'private', 'corporal',
-    'chancellor', 'ambassador', 'senator', 'governor', 'minister',
-    'master', 'young', 'old', 'elder', 'reverend', 'bishop', 'cardinal'
-}
-
-# Words that make poor short names on their own
-POOR_SHORT_NAMES = {
-    'big', 'little', 'old', 'young', 'true', 'false', 'good', 'bad',
-    'thought', 'ministry', 'situation', 'room', 'place', 'house',
-    'superintendent', 'commander', 'speaker', 'council',
-    'mode', 'narrator', 'chronicler',
-    'h.m.', 'j.f.', 'a.w.', 'e.b.', 'l.'
-}
-
-# Names that should use the full form (iconic two-word names)
-USE_FULL_NAME = {'big brother', 'sun tzu'}
-
-
-def extract_nickname(name: str) -> str | None:
-    """Extract quoted nickname from character name if present."""
-    match = re.search(r'["\']([^"\']+)["\']', name)
-    if match:
-        nickname = match.group(1).strip()
-        if nickname and ' ' not in nickname:
-            return nickname
-    return None
-
-
-def clean_name(name: str) -> str:
-    """Clean character name by removing parenthetical annotations and slash alternatives."""
-    cleaned = re.sub(r'\s*\([^)]+\)\s*', ' ', name).strip()
-    cleaned = re.sub(r'\b\w+/(\w+)\s', r'\1 ', cleaned)
-    cleaned = re.sub(r'\s*["\'][^"\']+["\']\s*', ' ', cleaned).strip()
-    cleaned = re.sub(r'\s+', ' ', cleaned).strip()
-    return cleaned
-
-
-def tokenize(name: str) -> list[str]:
-    """Tokenize a name into meaningful parts."""
-    cleaned = clean_name(name)
-    words = [w for w in cleaned.split() if w]
-
-    filtered = [
-        w for w in words
-        if w.lower() not in SKIP_PREFIXES
-        and not re.match(r'^[A-Z]\.$', w)
-        and not re.match(r'^[IVXLCDM]+$', w)
-    ]
-
-    return filtered if filtered else words
-
-
-def compute_short_names(agents: dict) -> dict[str, str]:
-    """Compute display name map for all characters in a theme."""
-    characters = [
-        a['character'] for a in agents.values()
-        if a and a.get('character')
-    ]
-
-    def is_unique(candidate: str, except_for: str) -> bool:
-        candidate_lower = candidate.lower()
-        for char in characters:
-            if char == except_for:
-                continue
-            tokens = tokenize(char)
-            if any(t.lower() == candidate_lower for t in tokens):
-                return False
-        return True
-
-    def is_good_short_name(candidate: str) -> bool:
-        return candidate.lower() not in POOR_SHORT_NAMES and len(candidate) > 1
-
-    def find_short_name(full_name: str) -> str:
-        cleaned = clean_name(full_name)
-
-        if cleaned.lower() in USE_FULL_NAME:
-            return cleaned
-
-        nickname = extract_nickname(full_name)
-        if nickname and is_good_short_name(nickname):
-            return nickname
-
-        tokens = tokenize(full_name)
-
-        if not tokens:
-            return cleaned
-
-        if len(tokens) == 1:
-            return tokens[0]
-
-        # Strategy 1: First token (if good and unique)
-        if is_good_short_name(tokens[0]) and is_unique(tokens[0], full_name):
-            return tokens[0]
-
-        # Strategy 2: Last token (surname, if good and unique)
-        last_token = tokens[-1]
-        if is_good_short_name(last_token) and is_unique(last_token, full_name):
-            return last_token
-
-        # Strategy 3: First + Last
-        if len(tokens) >= 2:
-            first_last = f"{tokens[0]} {last_token}"
-            if is_unique(first_last, full_name):
-                return first_last
-
-        return clean_name(full_name)
-
-    return {char: find_short_name(char) for char in characters}
-
-
-def process_theme(filepath: Path, dry_run: bool = True) -> dict:
-    """Process a single theme file."""
-    content = filepath.read_text()
-    theme = yaml.safe_load(content)
-
-    if not theme or 'agents' not in theme:
-        print(f"  Skipping {filepath.name} - no agents found")
-        return {'changes': 0, 'filename': filepath.name}
-
-    short_names = compute_short_names(theme['agents'])
-    changes = 0
-
-    for role, agent in theme['agents'].items():
-        if not agent or 'character' not in agent:
-            continue
-
-        short_name = short_names.get(agent['character'])
-        existing = agent.get('shortName')
-
-        if short_name and short_name != existing:
-            if dry_run:
-                existing_note = f' (was: "{existing}")' if existing else ''
-                print(f'  {role}: "{agent["character"]}" -> "{short_name}"{existing_note}')
-            agent['shortName'] = short_name
-            changes += 1
-
-    if not dry_run and changes > 0:
-        with open(filepath, 'w') as f:
-            yaml.dump(theme, f, default_flow_style=False, allow_unicode=True, width=1000)
-        print(f"  Wrote {changes} changes to {filepath.name}")
-
-    return {'changes': changes, 'filename': filepath.name}
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Pre-generate shortName field for theme characters"
-    )
-    parser.add_argument('--write', action='store_true',
-                        help='Actually write changes (default: dry run)')
-    parser.add_argument('--theme', type=str,
-                        help='Only process one theme')
-    args = parser.parse_args()
-
-    dry_run = not args.write
-
-    project_root = find_project_root()
-    themes_dir = project_root / 'pennyfarthing-dist' / 'personas' / 'themes'
-
-    print('DRY RUN - No files will be modified\n' if dry_run else 'WRITING CHANGES\n')
-
-    files = sorted(themes_dir.glob('*.yaml'))
-    if args.theme:
-        theme_file = f"{args.theme}.yaml" if not args.theme.endswith('.yaml') else args.theme
-        files = [f for f in files if f.name == theme_file]
-
-    total_changes = 0
-    for file in files:
-        print(f"\n{file.name}:")
-        result = process_theme(file, dry_run)
-        total_changes += result['changes']
-        if result['changes'] == 0:
-            print('  (no changes needed)')
-
-    print(f"\n{'=' * 50}")
-    print(f"Total: {total_changes} changes across {len(files)} themes")
-    if dry_run and total_changes > 0:
-        print("\nRun with --write to apply changes")
-
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

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

@@ -1,77 +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
-
-# Self-locate and set up PROJECT_ROOT
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
-source "$SCRIPT_DIR/../lib/find-root.sh"
-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}"