@pennyfarthing/core 7.6.1 → 7.8.0

package/pennyfarthing-dist/scripts/jira/jira-sync.mjs

@@ -1,198 +0,0 @@
-#!/usr/bin/env node
-/**
- * jira-sync.mjs - Sync Pennyfarthing Epic to Jira
- *
- * Usage: node jira-sync.mjs <epic_number> [--dry-run] [--transition] [--points]
- *
- * Options:
- *   --dry-run      Show what would be done without making changes
- *   --transition   Transition Jira issues to match Pennyfarthing status
- *   --points       Sync story points from Pennyfarthing to Jira
- */
-
-import {
-  checkDependencies,
-  findProjectRoot,
-  loadSprintFile,
-  findEpic,
-  extractJiraKey,
-  mapStatusToJira,
-  getIssueJson,
-  getJiraField,
-  moveIssue,
-  getStoryPoints,
-  syncStoryPoints,
-  parseArgs,
-  success,
-  info,
-  warn,
-  error,
-  JIRA_URL
-} from './jira-lib.mjs';
-
-// Parse arguments
-const args = parseArgs(process.argv, {
-  'dry-run': { type: 'boolean' },
-  'transition': { type: 'boolean' },
-  'points': { type: 'boolean' },
-  'with-comments': { type: 'boolean' } // Deprecated, ignored
-});
-
-const epicNum = args._positional[0];
-const dryRun = args['dry-run'] || false;
-const doTransition = args.transition || false;
-const syncPoints = args.points || false;
-
-// Show usage if no epic provided
-if (!epicNum) {
-  error('Epic number required');
-  console.log(`
-Usage: jira-sync.mjs <epic_number> [--dry-run] [--transition] [--points]
-
-Examples:
-  jira-sync.mjs 35                     # Show sync status for epic 35
-  jira-sync.mjs 35 --dry-run           # Show what would be done
-  jira-sync.mjs 35 --transition        # Sync status to Jira
-  jira-sync.mjs 35 --transition --points  # Sync status and story points
-`);
-  process.exit(2);
-}
-
-// Check dependencies
-if (!checkDependencies()) {
-  process.exit(2);
-}
-
-// Find project root and load sprint data
-let projectRoot;
-let sprintData;
-
-try {
-  projectRoot = findProjectRoot();
-  sprintData = loadSprintFile(projectRoot);
-} catch (err) {
-  error(err.message);
-  process.exit(1);
-}
-
-// Find epic
-const epic = findEpic(sprintData, epicNum);
-if (!epic) {
-  error(`Epic ${epicNum} not found in sprint file`);
-  process.exit(1);
-}
-
-// Display header
-console.log('');
-info('==========================================');
-info(`Epic ${epicNum}: ${epic.title}`);
-if (epic.jira) info(`Jira: ${epic.jira}`);
-info('==========================================');
-console.log('');
-
-if (dryRun) {
-  warn('[DRY-RUN MODE] No changes will be made');
-  console.log('');
-}
-
-// Get stories
-const stories = epic.stories || [];
-if (stories.length === 0) {
-  warn(`No stories found in epic ${epicNum}`);
-  process.exit(0);
-}
-
-info(`Found ${stories.length} stories to process`);
-console.log('');
-
-// Process each story
-let synced = 0;
-let skipped = 0;
-let errors = 0;
-
-for (const story of stories) {
-  const storyKey = story.id;
-  const storyTitle = story.title || 'Untitled';
-  const storyStatus = story.status || 'backlog';
-  const storyJira = story.jira;
-  const storyPoints = story.points;
-
-  console.log('---');
-  info(`Story ${storyKey}: ${storyTitle}`);
-  console.log(`  Status: ${storyStatus}`);
-
-  // Check if synced to Jira
-  if (!storyJira || storyJira === 'null') {
-    warn('  Not synced to Jira - skipping');
-    skipped++;
-    continue;
-  }
-
-  // Extract Jira key
-  const jiraKey = extractJiraKey(storyJira);
-  console.log(`  Jira: ${jiraKey}`);
-
-  if (dryRun) {
-    const actions = [];
-    if (doTransition) actions.push('transition');
-    if (syncPoints) actions.push('sync points');
-    warn(`  [DRY-RUN] Would sync: ${actions.length > 0 ? actions.join(', ') : 'view only'}`);
-    synced++;
-    continue;
-  }
-
-  // Fetch current Jira state
-  const issueJson = getIssueJson(jiraKey);
-  if (!issueJson) {
-    warn(`  Could not fetch Jira issue ${jiraKey}`);
-    errors++;
-    continue;
-  }
-
-  const jiraStatus = getJiraField(issueJson, 'fields.status.name', 'Unknown');
-  const jiraPoints = getStoryPoints(jiraKey, issueJson);
-  const targetStatus = mapStatusToJira(storyStatus);
-
-  console.log(`  Jira Status: ${jiraStatus} (target: ${targetStatus})`);
-  if (storyPoints) console.log(`  Points: Pennyfarthing=${storyPoints}, Jira=${jiraPoints || 'unset'}`);
-
-  // Transition if requested
-  if (doTransition) {
-    if (jiraStatus === targetStatus) {
-      success(`  Already at correct status: ${jiraStatus}`);
-    } else {
-      info(`  Transitioning: ${jiraStatus} -> ${targetStatus}`);
-      const result = moveIssue(jiraKey, targetStatus);
-      if (result.success) {
-        success(`  Transitioned to ${targetStatus}`);
-      } else {
-        warn(`  Could not transition (may not be available from current state)`);
-      }
-    }
-  }
-
-  // Sync points if requested
-  if (syncPoints && storyPoints) {
-    info(`  Syncing story points: ${jiraPoints || 'unset'} -> ${storyPoints}`);
-    const result = await syncStoryPoints(jiraKey, storyPoints, { currentJiraPoints: jiraPoints });
-    if (result.success) {
-      if (result.alreadySynced) {
-        success(`  Story points already synced: ${storyPoints}`);
-      } else {
-        success(`  Story points synced: ${storyPoints}`);
-      }
-    } else {
-      warn(`  Could not sync story points: ${result.reason}`);
-    }
-  }
-
-  synced++;
-}
-
-// Summary
-console.log('');
-console.log('==========================================');
-success(`Summary: ${synced} synced, ${skipped} skipped, ${errors} errors`);
-console.log('==========================================');
-
-process.exit(errors > 0 ? 1 : 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');
-}