@pennyfarthing/core 7.0.2 → 7.4.1

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/{utils → misc}/check-status.sh

@@ -11,10 +11,6 @@ elif [ -f ../.env ]; then
     set -a; source ../.env; set +a
 fi
 
-# Find project root
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/find-root.sh"
-
 # Colors
 RED='\033[0;31m'
 GREEN='\033[0;32m'
@@ -186,14 +182,14 @@ echo "   Repos: $REPOS"
 # Check repos
 case "$REPOS" in
     api)
-        check_repo_status "$REPO_BASE/conductor-api" "conductor-api"
+        check_repo_status "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
         ;;
     ui)
-        check_repo_status "$REPO_BASE/conductor-ui" "conductor-ui"
+        check_repo_status "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
         ;;
     all)
-        check_repo_status "$REPO_BASE/conductor-api" "conductor-api"
-        check_repo_status "$REPO_BASE/conductor-ui" "conductor-ui"
+        check_repo_status "$REPO_BASE/Pennyfarthing-api" "Pennyfarthing-api"
+        check_repo_status "$REPO_BASE/Pennyfarthing-ui" "Pennyfarthing-ui"
         ;;
 esac
 

package/pennyfarthing-dist/scripts/{doctor-dogfood.sh → misc/doctor-dogfood.sh}

@@ -184,7 +184,7 @@ if [[ -L "scripts" ]]; then
     ok "scripts -> $TARGET"
 elif [[ -d "scripts" ]]; then
     # Check if contents are symlinks to pennyfarthing-dist
-    if [[ -L "scripts/agent-session.sh" ]]; then
+    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"
@@ -354,13 +354,10 @@ else
     warn ".claude/settings.local.json missing"
 fi
 
-# Check persona config (priority: .pennyfarthing/ > .claude/local > .claude/shared)
+# 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.local.yaml" ]]; then
-    THEME=$(grep "^theme:" ".claude/persona-config.local.yaml" | awk '{print $2}')
-    ok "Theme: ${THEME:-unknown} (.claude/ local)"
 elif [[ -f ".claude/persona-config.yaml" ]]; then
     THEME=$(grep "^theme:" ".claude/persona-config.yaml" | awk '{print $2}')
     ok "Theme: ${THEME:-unknown} (.claude/ shared)"

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

@@ -0,0 +1,474 @@
+#!/usr/bin/env node
+/**
+ * migrate-bmad-workflow.mjs - Migrate BMAD workflows to Pennyfarthing format
+ *
+ * Story MSSCI-12132: BMAD to Pennyfarthing migration script
+ *
+ * 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: node migrate-bmad-workflow.mjs [--dry-run] <source-dir> [target-dir]
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// =============================================================================
+// Colors
+// =============================================================================
+
+const colors = {
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  blue: (s) => `\x1b[34m${s}\x1b[0m`,
+};
+
+const log = {
+  info: (msg) => console.log(`${colors.blue('INFO')}: ${msg}`),
+  success: (msg) => console.log(`${colors.green('SUCCESS')}: ${msg}`),
+  warn: (msg) => console.log(`${colors.yellow('WARN')}: ${msg}`),
+  error: (msg) => console.error(`${colors.red('ERROR')}: ${msg}`),
+};
+
+// =============================================================================
+// YAML Frontmatter Parsing
+// =============================================================================
+
+/**
+ * Extract YAML frontmatter from markdown content
+ * Returns { frontmatter: object, content: string }
+ */
+function extractFrontmatter(content) {
+  const lines = content.split('\n');
+
+  // Check for opening ---
+  if (lines[0]?.trim() !== '---') {
+    return { frontmatter: {}, content };
+  }
+
+  // Find closing ---
+  let endIndex = -1;
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i].trim() === '---') {
+      endIndex = i;
+      break;
+    }
+  }
+
+  if (endIndex === -1) {
+    return { frontmatter: {}, content };
+  }
+
+  // Parse frontmatter as simple key-value pairs
+  const frontmatterLines = lines.slice(1, endIndex);
+  const frontmatter = {};
+
+  for (const line of frontmatterLines) {
+    const match = line.match(/^([a-zA-Z_][a-zA-Z0-9_]*):\s*(.*)$/);
+    if (match) {
+      let [, key, value] = match;
+      // Remove quotes
+      value = value.replace(/^['"]|['"]$/g, '').trim();
+      frontmatter[key] = value;
+    }
+  }
+
+  // Rest of content
+  const restContent = lines.slice(endIndex + 1).join('\n');
+
+  return { frontmatter, content: restContent };
+}
+
+// =============================================================================
+// Variable Conversion
+// =============================================================================
+
+/**
+ * Convert BMAD-style dashed variables to Pennyfarthing underscore style
+ * {var-name} → {var_name}
+ */
+function convertVariables(text) {
+  // Repeatedly convert dashed variables until none remain
+  // This handles multi-segment variables like {user-skill-level}
+  let result = text;
+  let prev;
+
+  do {
+    prev = result;
+    result = result.replace(/\{([a-zA-Z0-9_]+)-([a-zA-Z0-9_-]+)\}/g, (match, p1, p2) => {
+      // Convert all dashes in p2 to underscores
+      const converted = p2.replace(/-/g, '_');
+      return `{${p1}_${converted}}`;
+    });
+  } while (result !== prev);
+
+  return result;
+}
+
+// =============================================================================
+// Directory Helpers
+// =============================================================================
+
+/**
+ * Check if workflow is tri-modal (has steps-c, steps-v, or steps-e)
+ */
+function isTrimodal(sourceDir) {
+  return (
+    fs.existsSync(path.join(sourceDir, 'steps-c')) ||
+    fs.existsSync(path.join(sourceDir, 'steps-v')) ||
+    fs.existsSync(path.join(sourceDir, 'steps-e'))
+  );
+}
+
+/**
+ * Get step directories to process
+ */
+function getStepDirectories(sourceDir) {
+  const dirs = [];
+
+  if (isTrimodal(sourceDir)) {
+    for (const dir of ['steps-c', 'steps-v', 'steps-e']) {
+      if (fs.existsSync(path.join(sourceDir, dir))) {
+        dirs.push(dir);
+      }
+    }
+  } else if (fs.existsSync(path.join(sourceDir, 'steps'))) {
+    dirs.push('steps');
+  }
+
+  return dirs;
+}
+
+/**
+ * Get supporting directories (templates, data, etc.)
+ */
+function getSupportingDirectories(sourceDir) {
+  const dirs = [];
+
+  for (const dir of ['templates', 'data', 'assets']) {
+    if (fs.existsSync(path.join(sourceDir, dir))) {
+      dirs.push(dir);
+    }
+  }
+
+  return dirs;
+}
+
+/**
+ * Get root-level template files (e.g., project-context-template.md)
+ */
+function getRootTemplateFiles(sourceDir) {
+  const files = [];
+
+  try {
+    const entries = fs.readdirSync(sourceDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name.includes('-template') && entry.name.endsWith('.md')) {
+        files.push(entry.name);
+      }
+    }
+  } catch {
+    // Ignore errors
+  }
+
+  return files;
+}
+
+/**
+ * Recursively copy directory with file transformation
+ */
+function copyDirWithTransform(srcDir, destDir, transform, dryRun) {
+  if (!fs.existsSync(srcDir)) return;
+
+  if (!dryRun) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name);
+    const destPath = path.join(destDir, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirWithTransform(srcPath, destPath, transform, dryRun);
+    } else if (entry.isFile()) {
+      if (dryRun) {
+        const content = fs.readFileSync(srcPath, 'utf-8');
+        const transformed = transform(content, srcPath);
+        if (content !== transformed) {
+          log.info(`[DRY-RUN] Would convert variables in: ${path.relative(process.cwd(), srcPath)}`);
+        }
+      } else {
+        const content = fs.readFileSync(srcPath, 'utf-8');
+        const transformed = transform(content, srcPath);
+        fs.writeFileSync(destPath, transformed, 'utf-8');
+        log.success(`Copied: ${path.relative(destDir, destPath)}`);
+      }
+    }
+  }
+}
+
+// =============================================================================
+// Workflow Generation
+// =============================================================================
+
+/**
+ * Generate workflow.yaml content
+ */
+function generateWorkflowYaml(name, description, trimodal) {
+  const convertedDesc = convertVariables(description);
+
+  let stepConfig;
+  let modesConfig = '';
+
+  if (trimodal) {
+    stepConfig = `    path: ./steps-c/
+    pattern: step-*.md`;
+    modesConfig = `
+  # Tri-modal workflow paths
+  modes:
+    create: ./steps-c/
+    validate: ./steps-v/
+    edit: ./steps-e/`;
+  } else {
+    stepConfig = `    path: ./steps/
+    pattern: step-*.md`;
+  }
+
+  return `# ${name} Workflow - Migrated from BMAD format
+# Generated by migrate-bmad-workflow.mjs
+
+workflow:
+  name: ${name}
+  description: ${convertedDesc}
+  version: "1.0.0"
+  type: stepped
+
+  # Step configuration
+  steps:
+${stepConfig}
+${modesConfig}
+  # 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]
+`;
+}
+
+// =============================================================================
+// Main
+// =============================================================================
+
+function showHelp() {
+  console.log(`
+Usage: migrate-bmad-workflow.mjs [--dry-run] <source-dir> [target-dir]
+
+Migrate BMAD workflows to Pennyfarthing stepped workflow format.
+
+Arguments:
+  source-dir   Path to BMAD workflow directory (must contain workflow.md)
+  target-dir   Path to output directory (default: current directory)
+
+Options:
+  --dry-run    Show what would be done without making changes
+  -h, --help   Show this help message
+
+Examples:
+  # Migrate PRD workflow to ./prd/
+  migrate-bmad-workflow.mjs ~/BMAD-METHOD/workflows/prd ./prd
+
+  # Preview migration without writing files
+  migrate-bmad-workflow.mjs --dry-run ~/BMAD-METHOD/workflows/prd ./prd
+`);
+}
+
+function main() {
+  const args = process.argv.slice(2);
+
+  // Parse flags
+  let dryRun = false;
+  const positional = [];
+
+  for (const arg of args) {
+    if (arg === '--dry-run') {
+      dryRun = true;
+    } else if (arg === '-h' || arg === '--help') {
+      showHelp();
+      process.exit(0);
+    } else if (!arg.startsWith('-')) {
+      positional.push(arg);
+    } else {
+      log.error(`Unknown option: ${arg}`);
+      process.exit(1);
+    }
+  }
+
+  // Validate arguments
+  const [sourceDir, targetDir = '.'] = positional;
+
+  if (!sourceDir) {
+    log.error('Source directory required');
+    showHelp();
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(sourceDir)) {
+    log.error(`Source directory not found: ${sourceDir}`);
+    process.exit(1);
+  }
+
+  const workflowMdPath = path.join(sourceDir, 'workflow.md');
+  if (!fs.existsSync(workflowMdPath)) {
+    log.error(`workflow.md not found in ${sourceDir}`);
+    process.exit(1);
+  }
+
+  // Header
+  log.info('BMAD Workflow Migration');
+  log.info('=======================');
+  log.info(`Source: ${sourceDir}`);
+  log.info(`Target: ${targetDir}`);
+
+  if (dryRun) {
+    log.warn('DRY-RUN MODE - No changes will be made');
+  }
+
+  console.log('');
+
+  // Parse workflow.md
+  const workflowContent = fs.readFileSync(workflowMdPath, 'utf-8');
+  const { frontmatter } = extractFrontmatter(workflowContent);
+
+  const name = frontmatter.name;
+  const description = frontmatter.description || '';
+
+  if (!name) {
+    log.error('Could not extract workflow name from workflow.md');
+    process.exit(1);
+  }
+
+  log.info(`Parsed workflow: ${name}`);
+  log.info(`Description: ${description}`);
+
+  console.log('');
+
+  // Create target directory
+  if (!dryRun) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+
+  // Generate workflow.yaml
+  log.info('Generating workflow.yaml');
+
+  const trimodal = isTrimodal(sourceDir);
+  const workflowYaml = generateWorkflowYaml(name, description, trimodal);
+
+  if (dryRun) {
+    log.info('[DRY-RUN] Would create: workflow.yaml');
+  } else {
+    fs.writeFileSync(path.join(targetDir, 'workflow.yaml'), workflowYaml, 'utf-8');
+    log.success('Created workflow.yaml');
+  }
+
+  console.log('');
+
+  // Copy step directories
+  const stepDirs = getStepDirectories(sourceDir);
+
+  for (const dir of stepDirs) {
+    log.info(`Processing step directory: ${dir}`);
+
+    if (dryRun) {
+      log.info(`[DRY-RUN] Would copy and transform: ${dir}/`);
+    }
+
+    copyDirWithTransform(
+      path.join(sourceDir, dir),
+      path.join(targetDir, dir),
+      (content, filePath) => {
+        // Only convert variables in markdown files
+        if (filePath.endsWith('.md')) {
+          return convertVariables(content);
+        }
+        return content;
+      },
+      dryRun
+    );
+  }
+
+  console.log('');
+
+  // Copy supporting directories
+  const supportDirs = getSupportingDirectories(sourceDir);
+
+  for (const dir of supportDirs) {
+    log.info(`Processing supporting directory: ${dir}`);
+
+    if (dryRun) {
+      log.info(`[DRY-RUN] Would copy: ${dir}/`);
+    }
+
+    copyDirWithTransform(
+      path.join(sourceDir, dir),
+      path.join(targetDir, dir),
+      (content, filePath) => {
+        if (filePath.endsWith('.md')) {
+          return convertVariables(content);
+        }
+        return content;
+      },
+      dryRun
+    );
+  }
+
+  console.log('');
+
+  // Copy root-level template files
+  const templateFiles = getRootTemplateFiles(sourceDir);
+
+  for (const file of templateFiles) {
+    log.info(`Processing root template file: ${file}`);
+
+    const srcPath = path.join(sourceDir, file);
+    const destPath = path.join(targetDir, file);
+
+    if (dryRun) {
+      log.info(`[DRY-RUN] Would copy: ${file}`);
+    } else {
+      const content = fs.readFileSync(srcPath, 'utf-8');
+      const transformed = convertVariables(content);
+      fs.writeFileSync(destPath, transformed, 'utf-8');
+      log.success(`Copied: ${file}`);
+    }
+  }
+
+  console.log('');
+
+  if (dryRun) {
+    log.info('DRY-RUN complete. No files were modified.');
+  } else {
+    log.success('Migration complete!');
+    log.info(`Output directory: ${targetDir}`);
+  }
+}
+
+main();

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

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# migrate-bmad-workflow.sh - Thin wrapper for migrate-bmad-workflow.mjs
+#
+# Usage: ./scripts/migrate-bmad-workflow.sh [--dry-run] <source-dir> [target-dir]
+#
+# Delegates to Node script for cleaner YAML parsing and variable conversion.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+exec node "${SCRIPT_DIR}/migrate-bmad-workflow.mjs" "$@"

package/pennyfarthing-dist/scripts/{repo-utils.sh → misc/repo-utils.sh}

@@ -541,7 +541,7 @@ run_tests_of_type() {
 # ============================================================================
 
 # Filter repos by a list (for story-scoped operations)
-# Usage: filter_repos "conductor-api,conductor-ui" or "all" or "api"
+# Usage: filter_repos "Pennyfarthing-api,Pennyfarthing-ui" or "all" or "api"
 filter_repos() {
     local filter="$1"
     load_repos_config
@@ -603,7 +603,7 @@ show_config() {
 # ============================================================================
 
 # Get test environment variables for a repo (as KEY=VALUE lines)
-# Usage: eval "$(get_test_env "conductor-api")"
+# Usage: eval "$(get_test_env "Pennyfarthing-api")"
 get_test_env() {
     local name="$1"
     load_repos_config

package/pennyfarthing-dist/scripts/{statusline.sh → misc/statusline.sh}

@@ -10,11 +10,6 @@ if ! echo "$input" | jq -e . >/dev/null 2>&1; then
     exit 0
 fi
 
-# Use CLAUDE_PROJECT_DIR if set, otherwise find via .claude/ marker
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-}"
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/utils/find-root.sh"
-
 # Extract fields - use cwd for display only, PROJECT_ROOT for file lookups
 cwd=$(echo "$input" | jq -r '.workspace.current_dir // empty' 2>/dev/null)
 dir_name=$(basename "$cwd" 2>/dev/null || echo "?")
@@ -96,8 +91,8 @@ fi
 
 # Get character name from theme for current agent
 config_file=""
-if [ -f "$PROJECT_ROOT/.claude/persona-config.local.yaml" ]; then
-    config_file="$PROJECT_ROOT/.claude/persona-config.local.yaml"
+if [ -f "$PROJECT_ROOT/.pennyfarthing/config.local.yaml" ]; then
+    config_file="$PROJECT_ROOT/.pennyfarthing/config.local.yaml"
 elif [ -f "$PROJECT_ROOT/.claude/persona-config.yaml" ]; then
     config_file="$PROJECT_ROOT/.claude/persona-config.yaml"
 fi