@pennyfarthing/core 7.9.0 → 7.9.2

package/pennyfarthing-dist/scripts/misc/generate-skill-docs.sh

@@ -1,110 +0,0 @@
-#!/usr/bin/env bash
-#
-# generate-skill-docs.sh - Generate SKILLS.md from skill-registry.yaml
-#
-# Usage: generate-skill-docs.sh [options]
-#
-# Options:
-#   --registry <path>   Path to skill-registry.yaml
-#   --output <path>     Path to write output (default: docs/SKILLS.md)
-#   --dry-run           Print output instead of writing file
-#   --help, -h          Show this help
-#
-# Examples:
-#   generate-skill-docs.sh
-#   generate-skill-docs.sh --dry-run
-#   generate-skill-docs.sh --registry ./custom-registry.yaml
-
-set -euo pipefail
-
-# Find project root (directory containing .pennyfarthing/)
-find_project_root() {
-  local dir="$PWD"
-  while [[ ! -d "$dir/.pennyfarthing" ]] && [[ "$dir" != "/" ]]; do
-    dir="$(dirname "$dir")"
-  done
-  if [[ -d "$dir/.pennyfarthing" ]]; then
-    echo "$dir"
-  else
-    echo ""
-  fi
-}
-
-PROJECT_ROOT="$(find_project_root)"
-if [[ -z "$PROJECT_ROOT" ]]; then
-  echo "Error: Cannot find project root (no .pennyfarthing directory found)" >&2
-  exit 1
-fi
-
-# Default paths
-REGISTRY_PATH="${PROJECT_ROOT}/pennyfarthing-dist/skills/skill-registry.yaml"
-OUTPUT_PATH="${PROJECT_ROOT}/docs/SKILLS.md"
-DRY_RUN=false
-
-# Parse arguments
-show_help() {
-  cat <<EOF
-Usage: generate-skill-docs.sh [options]
-
-Generate SKILLS.md documentation from skill-registry.yaml.
-
-Options:
-  --registry <path>   Path to skill-registry.yaml (default: pennyfarthing-dist/skills/skill-registry.yaml)
-  --output <path>     Path to write output (default: docs/SKILLS.md)
-  --dry-run           Print output instead of writing file
-  --help, -h          Show this help
-
-Examples:
-  generate-skill-docs.sh
-  generate-skill-docs.sh --dry-run
-  generate-skill-docs.sh --registry ./custom-registry.yaml --output ./SKILLS.md
-EOF
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --help|-h)
-      show_help
-      exit 0
-      ;;
-    --registry)
-      REGISTRY_PATH="$2"
-      shift 2
-      ;;
-    --output)
-      OUTPUT_PATH="$2"
-      shift 2
-      ;;
-    --dry-run)
-      DRY_RUN=true
-      shift
-      ;;
-    *)
-      echo "Unknown option: $1" >&2
-      echo "Use --help for usage information" >&2
-      exit 1
-      ;;
-  esac
-done
-
-# Check registry exists
-if [[ ! -f "$REGISTRY_PATH" ]]; then
-  echo "Error: Registry not found: $REGISTRY_PATH" >&2
-  exit 1
-fi
-
-# Build the TypeScript module if needed
-DIST_FILE="${PROJECT_ROOT}/packages/shared/dist/generate-skill-docs.js"
-if [[ ! -f "$DIST_FILE" ]]; then
-  echo "Building shared package..." >&2
-  (cd "${PROJECT_ROOT}/packages/shared" && npm run build) >&2
-fi
-
-# Run the generator
-if $DRY_RUN; then
-  node "$DIST_FILE" --registry "$REGISTRY_PATH" --dry-run
-else
-  # Ensure output directory exists
-  mkdir -p "$(dirname "$OUTPUT_PATH")"
-  node "$DIST_FILE" --registry "$REGISTRY_PATH" --output "$OUTPUT_PATH"
-fi

package/pennyfarthing-dist/scripts/misc/log-skill-usage.sh

@@ -1,74 +0,0 @@
-#!/usr/bin/env zsh
-# Log skill invocations to .session/skill-usage.log
-# Usage: log-skill-usage.sh <skill-name> [agent-name] [session-id]
-#
-# Creates JSON Lines entries in .session/skill-usage.log:
-#   {"ts":"2026-01-11T10:30:45Z","skill":"testing","agent":"dev","session":"abc123"}
-#
-# Environment:
-#   PROJECT_ROOT - Set by run.sh bootstrap (required)
-
-set -euo pipefail
-
-# --- Configuration ---
-SCRIPT_DIR="${0:A:h}"
-source "${SCRIPT_DIR}/common.sh" 2>/dev/null || true
-
-# --- Argument parsing ---
-SKILL_NAME="${1:-}"
-AGENT_NAME="${2:-unknown}"
-SESSION_ID="${3:-}"
-
-if [[ -z "$SKILL_NAME" ]]; then
-    echo "Usage: log-skill-usage.sh <skill-name> [agent-name] [session-id]" >&2
-    exit 1
-fi
-
-# --- Find project root ---
-if [[ -z "${PROJECT_ROOT:-}" ]]; then
-    # Fallback: find project root ourselves
-    dir="$PWD"
-    while [[ ! -d "$dir/.pennyfarthing" ]] && [[ "$dir" != "/" ]]; do
-        dir="$(dirname "$dir")"
-    done
-    if [[ -d "$dir/.pennyfarthing" ]]; then
-        PROJECT_ROOT="$dir"
-    else
-        echo "Error: Could not find project root" >&2
-        exit 1
-    fi
-fi
-
-# --- Ensure session directory exists ---
-SESSION_DIR="$PROJECT_ROOT/.session"
-mkdir -p "$SESSION_DIR"
-
-LOG_FILE="$SESSION_DIR/skill-usage.log"
-
-# --- Build JSON entry ---
-TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-# Auto-detect session ID from active agent sessions if not provided
-if [[ -z "$SESSION_ID" ]]; then
-    if [[ -d "$SESSION_DIR/agents" ]]; then
-        # Use the most recent session file
-        SESSION_FILE=$(ls -t "$SESSION_DIR/agents/" 2>/dev/null | head -1)
-        if [[ -n "$SESSION_FILE" ]]; then
-            SESSION_ID="${SESSION_FILE}"
-        fi
-    fi
-fi
-
-# Use jq for proper JSON escaping
-JSON_ENTRY=$(jq -nc \
-    --arg ts "$TIMESTAMP" \
-    --arg skill "$SKILL_NAME" \
-    --arg agent "$AGENT_NAME" \
-    --arg session "${SESSION_ID:-none}" \
-    '{ts: $ts, skill: $skill, agent: $agent, session: $session}')
-
-# --- Append to log ---
-echo "$JSON_ENTRY" >> "$LOG_FILE"
-
-# Silent success (don't interfere with skill output)
-exit 0

package/pennyfarthing-dist/scripts/misc/migrate-bmad-workflow.sh

@@ -1,10 +0,0 @@
-#!/usr/bin/env bash
-# migrate-bmad-workflow.sh - Migrate BMAD workflows to Pennyfarthing format
-#
-# Usage: ./scripts/migrate-bmad-workflow.sh [--dry-run] <source-dir> [target-dir]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-exec python3 "$SCRIPT_DIR/migrate_bmad_workflow.py" "$@"

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

@@ -1,319 +0,0 @@
-#!/usr/bin/env python3
-"""
-migrate_bmad_workflow.py - Migrate BMAD workflows to Pennyfarthing format
-
-Converts BMAD workflow format to Pennyfarthing stepped workflow format:
-- Parses BMAD workflow.md with YAML frontmatter
-- Extracts step files and their frontmatter
-- Converts variable syntax ({var-name} -> {var_name})
-- Generates workflow.yaml with Pennyfarthing schema
-- Preserves tri-modal structure (steps-c, steps-v, steps-e)
-
-Usage: python migrate_bmad_workflow.py [--dry-run] <source-dir> [target-dir]
-"""
-
-import argparse
-import re
-import shutil
-import sys
-from pathlib import Path
-
-
-class Colors:
-    RED = '\033[31m'
-    GREEN = '\033[32m'
-    YELLOW = '\033[33m'
-    BLUE = '\033[34m'
-    NC = '\033[0m'
-
-
-def log_info(msg: str) -> None:
-    print(f"{Colors.BLUE}INFO{Colors.NC}: {msg}")
-
-
-def log_success(msg: str) -> None:
-    print(f"{Colors.GREEN}SUCCESS{Colors.NC}: {msg}")
-
-
-def log_warn(msg: str) -> None:
-    print(f"{Colors.YELLOW}WARN{Colors.NC}: {msg}")
-
-
-def log_error(msg: str) -> None:
-    print(f"{Colors.RED}ERROR{Colors.NC}: {msg}", file=sys.stderr)
-
-
-def extract_frontmatter(content: str) -> tuple[dict, str]:
-    """Extract YAML frontmatter from markdown content."""
-    lines = content.split('\n')
-
-    if not lines or lines[0].strip() != '---':
-        return {}, content
-
-    end_index = -1
-    for i, line in enumerate(lines[1:], 1):
-        if line.strip() == '---':
-            end_index = i
-            break
-
-    if end_index == -1:
-        return {}, content
-
-    frontmatter = {}
-    for line in lines[1:end_index]:
-        match = re.match(r'^([a-zA-Z_][a-zA-Z0-9_]*):\s*(.*)$', line)
-        if match:
-            key, value = match.groups()
-            value = value.strip().strip('"\'')
-            frontmatter[key] = value
-
-    rest_content = '\n'.join(lines[end_index + 1:])
-    return frontmatter, rest_content
-
-
-def convert_variables(text: str) -> str:
-    """Convert BMAD-style dashed variables to Pennyfarthing underscore style."""
-    result = text
-    prev = None
-
-    while result != prev:
-        prev = result
-        result = re.sub(
-            r'\{([a-zA-Z0-9_]+)-([a-zA-Z0-9_-]+)\}',
-            lambda m: '{' + m.group(1) + '_' + m.group(2).replace('-', '_') + '}',
-            result
-        )
-
-    return result
-
-
-def is_trimodal(source_dir: Path) -> bool:
-    """Check if workflow is tri-modal (has steps-c, steps-v, or steps-e)."""
-    return any(
-        (source_dir / d).exists()
-        for d in ['steps-c', 'steps-v', 'steps-e']
-    )
-
-
-def get_step_directories(source_dir: Path) -> list[str]:
-    """Get step directories to process."""
-    if is_trimodal(source_dir):
-        return [d for d in ['steps-c', 'steps-v', 'steps-e']
-                if (source_dir / d).exists()]
-    elif (source_dir / 'steps').exists():
-        return ['steps']
-    return []
-
-
-def get_supporting_directories(source_dir: Path) -> list[str]:
-    """Get supporting directories (templates, data, etc.)."""
-    return [d for d in ['templates', 'data', 'assets']
-            if (source_dir / d).exists()]
-
-
-def get_root_template_files(source_dir: Path) -> list[str]:
-    """Get root-level template files."""
-    return [f.name for f in source_dir.iterdir()
-            if f.is_file() and '-template' in f.name and f.suffix == '.md']
-
-
-def copy_dir_with_transform(src_dir: Path, dest_dir: Path,
-                            transform: callable, dry_run: bool) -> None:
-    """Recursively copy directory with file transformation."""
-    if not src_dir.exists():
-        return
-
-    if not dry_run:
-        dest_dir.mkdir(parents=True, exist_ok=True)
-
-    for entry in src_dir.iterdir():
-        dest_path = dest_dir / entry.name
-
-        if entry.is_dir():
-            copy_dir_with_transform(entry, dest_path, transform, dry_run)
-        elif entry.is_file():
-            content = entry.read_text()
-            transformed = transform(content, entry)
-
-            if dry_run:
-                if content != transformed:
-                    log_info(f"[DRY-RUN] Would convert variables in: {entry}")
-            else:
-                dest_path.write_text(transformed)
-                log_success(f"Copied: {dest_path.name}")
-
-
-def generate_workflow_yaml(name: str, description: str, trimodal: bool) -> str:
-    """Generate workflow.yaml content."""
-    converted_desc = convert_variables(description)
-
-    if trimodal:
-        step_config = """    path: ./steps-c/
-    pattern: step-*.md"""
-        modes_config = """
-  # Tri-modal workflow paths
-  modes:
-    create: ./steps-c/
-    validate: ./steps-v/
-    edit: ./steps-e/"""
-    else:
-        step_config = """    path: ./steps/
-    pattern: step-*.md"""
-        modes_config = ""
-
-    return f"""# {name} Workflow - Migrated from BMAD format
-# Generated by migrate_bmad_workflow.py
-
-workflow:
-  name: {name}
-  description: {converted_desc}
-  version: "1.0.0"
-  type: stepped
-
-  # Step configuration
-  steps:
-{step_config}
-{modes_config}
-  # Variables available in step files
-  variables:
-    project_root: .
-    planning_artifacts: ./artifacts
-    output_file: artifacts/{name}.md
-
-  # Agent assignment (customize as needed)
-  agent: architect
-
-  # Triggers - when to suggest this workflow
-  triggers:
-    types: [{name}]
-    tags: [{name}, stepped]
-"""
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Migrate BMAD workflows to Pennyfarthing stepped workflow format"
-    )
-    parser.add_argument('--dry-run', action='store_true',
-                        help='Show what would be done without making changes')
-    parser.add_argument('source_dir', type=Path,
-                        help='Path to BMAD workflow directory (must contain workflow.md)')
-    parser.add_argument('target_dir', type=Path, nargs='?', default=Path('.'),
-                        help='Path to output directory (default: current directory)')
-    args = parser.parse_args()
-
-    source_dir = args.source_dir.resolve()
-    target_dir = args.target_dir.resolve()
-    dry_run = args.dry_run
-
-    if not source_dir.exists():
-        log_error(f"Source directory not found: {source_dir}")
-        return 1
-
-    workflow_md = source_dir / 'workflow.md'
-    if not workflow_md.exists():
-        log_error(f"workflow.md not found in {source_dir}")
-        return 1
-
-    log_info('BMAD Workflow Migration')
-    log_info('=======================')
-    log_info(f'Source: {source_dir}')
-    log_info(f'Target: {target_dir}')
-
-    if dry_run:
-        log_warn('DRY-RUN MODE - No changes will be made')
-
-    print('')
-
-    # Parse workflow.md
-    content = workflow_md.read_text()
-    frontmatter, _ = extract_frontmatter(content)
-
-    name = frontmatter.get('name')
-    description = frontmatter.get('description', '')
-
-    if not name:
-        log_error('Could not extract workflow name from workflow.md')
-        return 1
-
-    log_info(f'Parsed workflow: {name}')
-    log_info(f'Description: {description}')
-    print('')
-
-    # Create target directory
-    if not dry_run:
-        target_dir.mkdir(parents=True, exist_ok=True)
-
-    # Generate workflow.yaml
-    log_info('Generating workflow.yaml')
-    trimodal = is_trimodal(source_dir)
-    workflow_yaml = generate_workflow_yaml(name, description, trimodal)
-
-    if dry_run:
-        log_info('[DRY-RUN] Would create: workflow.yaml')
-    else:
-        (target_dir / 'workflow.yaml').write_text(workflow_yaml)
-        log_success('Created workflow.yaml')
-
-    print('')
-
-    # Copy step directories
-    def md_transform(content: str, filepath: Path) -> str:
-        if filepath.suffix == '.md':
-            return convert_variables(content)
-        return content
-
-    for dir_name in get_step_directories(source_dir):
-        log_info(f'Processing step directory: {dir_name}')
-        if dry_run:
-            log_info(f'[DRY-RUN] Would copy and transform: {dir_name}/')
-        copy_dir_with_transform(
-            source_dir / dir_name,
-            target_dir / dir_name,
-            md_transform,
-            dry_run
-        )
-
-    print('')
-
-    # Copy supporting directories
-    for dir_name in get_supporting_directories(source_dir):
-        log_info(f'Processing supporting directory: {dir_name}')
-        if dry_run:
-            log_info(f'[DRY-RUN] Would copy: {dir_name}/')
-        copy_dir_with_transform(
-            source_dir / dir_name,
-            target_dir / dir_name,
-            md_transform,
-            dry_run
-        )
-
-    print('')
-
-    # Copy root-level template files
-    for filename in get_root_template_files(source_dir):
-        log_info(f'Processing root template file: {filename}')
-        src_path = source_dir / filename
-        dest_path = target_dir / filename
-
-        if dry_run:
-            log_info(f'[DRY-RUN] Would copy: {filename}')
-        else:
-            content = src_path.read_text()
-            transformed = convert_variables(content)
-            dest_path.write_text(transformed)
-            log_success(f'Copied: {filename}')
-
-    print('')
-
-    if dry_run:
-        log_info('DRY-RUN complete. No files were modified.')
-    else:
-        log_success('Migration complete!')
-        log_info(f'Output directory: {target_dir}')
-
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/pennyfarthing-dist/scripts/misc/repo-scan.sh

@@ -1,141 +0,0 @@
-#!/usr/bin/env zsh
-# Pennyfarthing Repo Scanning Utilities
-# Provides functions for scanning git status and PRs across repos
-#
-# Usage: source scripts/utils/repo-scan.sh
-#
-# Functions:
-#   scan_repo_git_status REPO  - Get git status for a repo (repo|branch|uncommitted|ahead)
-#   scan_all_repos_status      - Get git status for all configured repos
-#   check_repo_pr REPO BRANCH  - Check for open PR on branch (returns URL or "none")
-
-# Don't exit on error - we want to handle errors gracefully
-set +e
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_ROOT="${PROJECT_ROOT:-$(cd "$SCRIPT_DIR/../.." && pwd)}"
-
-# Source repo-utils for multi-repo iteration
-source "$CLAUDE_PROJECT_DIR/scripts/repo-utils.sh" 2>/dev/null || true
-
-# ============================================================================
-# Git Status Functions
-# ============================================================================
-
-# Scan git status for a single repo
-# Returns: repo|branch|uncommitted_count|ahead_count
-scan_repo_git_status() {
-    local repo="$1"
-    local repo_path
-
-    # Handle both repo name (from config) and direct path
-    if [[ -d "$CLAUDE_PROJECT_DIR/$repo" ]]; then
-        repo_path="$CLAUDE_PROJECT_DIR/$repo"
-    elif declare -f get_repo_path &>/dev/null; then
-        repo_path=$(get_repo_full_path "$repo" 2>/dev/null)
-    else
-        repo_path="$CLAUDE_PROJECT_DIR/$repo"
-    fi
-
-    # If repo path doesn't exist, try PROJECT_ROOT itself (for pennyfarthing)
-    if [[ ! -d "$repo_path/.git" && -d "$CLAUDE_PROJECT_DIR/.git" && "$repo" == "pennyfarthing" ]]; then
-        repo_path="$CLAUDE_PROJECT_DIR"
-    fi
-
-    if [[ ! -d "$repo_path" ]]; then
-        echo "$repo|||"
-        return 1
-    fi
-
-    local branch uncommitted ahead
-
-    # Get current branch
-    branch=$(git -C "$repo_path" branch --show-current 2>/dev/null || echo "")
-
-    # Count uncommitted changes (staged + unstaged + untracked)
-    uncommitted=$(git -C "$repo_path" status --porcelain 2>/dev/null | wc -l | tr -d ' ')
-
-    # Count commits ahead of upstream
-    ahead=$(git -C "$repo_path" rev-list --count @{u}..HEAD 2>/dev/null || echo "0")
-
-    echo "$repo|$branch|$uncommitted|$ahead"
-}
-
-# Scan git status for all configured repos
-# Returns: one line per repo in scan_repo_git_status format
-scan_all_repos_status() {
-    # If repo-utils is available, use it
-    if declare -f get_repos &>/dev/null; then
-        for repo in $(get_repos); do
-            scan_repo_git_status "$repo"
-        done
-    else
-        # Fallback: scan common repo patterns
-        for dir in "$CLAUDE_PROJECT_DIR"/*; do
-            if [[ -d "$dir/.git" ]]; then
-                local repo_name
-                repo_name=$(basename "$dir")
-                scan_repo_git_status "$repo_name"
-            fi
-        done
-
-        # Also check PROJECT_ROOT itself
-        if [[ -d "$CLAUDE_PROJECT_DIR/.git" ]]; then
-            local root_name
-            root_name=$(basename "$CLAUDE_PROJECT_DIR")
-            scan_repo_git_status "$root_name"
-        fi
-    fi
-}
-
-# ============================================================================
-# PR Functions
-# ============================================================================
-
-# Check for open PR on a branch
-# Returns: PR URL or "none"
-check_repo_pr() {
-    local repo="$1"
-    local branch="$2"
-    local repo_path
-
-    # Handle both repo name (from config) and direct path
-    if [[ -d "$CLAUDE_PROJECT_DIR/$repo" ]]; then
-        repo_path="$CLAUDE_PROJECT_DIR/$repo"
-    elif declare -f get_repo_path &>/dev/null; then
-        repo_path=$(get_repo_full_path "$repo" 2>/dev/null)
-    else
-        repo_path="$CLAUDE_PROJECT_DIR/$repo"
-    fi
-
-    # If repo path doesn't exist, try PROJECT_ROOT itself
-    if [[ ! -d "$repo_path/.git" && -d "$CLAUDE_PROJECT_DIR/.git" && "$repo" == "pennyfarthing" ]]; then
-        repo_path="$CLAUDE_PROJECT_DIR"
-    fi
-
-    if [[ ! -d "$repo_path" ]]; then
-        echo "none"
-        return 0
-    fi
-
-    # Check if branch exists
-    if ! git -C "$repo_path" rev-parse --verify "$branch" &>/dev/null; then
-        echo "none"
-        return 0
-    fi
-
-    # Check for open PR using gh CLI
-    if command -v gh &>/dev/null; then
-        local pr_url
-        pr_url=$(cd "$repo_path" && gh pr view "$branch" --json url -q .url 2>/dev/null || echo "")
-        if [[ -n "$pr_url" ]]; then
-            echo "$pr_url"
-        else
-            echo "none"
-        fi
-    else
-        echo "none"
-    fi
-
-    return 0
-}