pgserve 2.1.2 → 2.2.0

package/.genie/scripts/helpers/bullet-counter.js

@@ -1,194 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Bullet Counter Updater
- *
- * Find and update helpful/harmful counters for learning bullets.
- *
- * Usage:
- *   genie helper bullet-counter ID --helpful
- *   genie helper bullet-counter ID --harmful
- *   genie helper bullet-counter ID (show current counters)
- */
-
-const fs = require('fs');
-const path = require('path');
-const { exec } = require('child_process');
-const { promisify } = require('util');
-
-const execAsync = promisify(exec);
-
-/**
- * Find bullet by ID across all markdown files
- * Returns: { file, line, content, helpful, harmful }
- */
-function findBullet(id) {
-  const searchPath = path.join(process.cwd(), '.genie');
-
-  // Use ripgrep to find the bullet
-  const pattern = `^- \\[${id}\\] helpful=(\\d+) harmful=(\\d+):`;
-
-  try {
-    const { execSync } = require('child_process');
-    const result = execSync(
-      `rg -n "${pattern}" "${searchPath}"`,
-      { encoding: 'utf-8' }
-    ).trim();
-
-    if (!result) {
-      return null;
-    }
-
-    // Parse result: file:line:content
-    const match = result.match(/^([^:]+):(\d+):(.+)$/);
-    if (!match) {
-      return null;
-    }
-
-    const [, file, lineNum, content] = match;
-
-    // Extract counters from content
-    const counterMatch = content.match(/helpful=(\d+) harmful=(\d+)/);
-    if (!counterMatch) {
-      return null;
-    }
-
-    return {
-      file: file,
-      line: parseInt(lineNum, 10),
-      content: content,
-      helpful: parseInt(counterMatch[1], 10),
-      harmful: parseInt(counterMatch[2], 10)
-    };
-  } catch (err) {
-    // rg returns exit code 1 when no matches found
-    if (err.status === 1) {
-      return null;
-    }
-    throw err;
-  }
-}
-
-/**
- * Update bullet counter in file
- */
-function updateBulletCounter(bullet, incrementHelpful, incrementHarmful) {
-  const newHelpful = bullet.helpful + (incrementHelpful ? 1 : 0);
-  const newHarmful = bullet.harmful + (incrementHarmful ? 1 : 0);
-
-  // Read file
-  const content = fs.readFileSync(bullet.file, 'utf-8');
-  const lines = content.split('\n');
-
-  // Update the line (1-indexed to 0-indexed)
-  const lineIndex = bullet.line - 1;
-  const oldLine = lines[lineIndex];
-
-  // Replace counters in the line
-  const newLine = oldLine.replace(
-    /helpful=(\d+) harmful=(\d+)/,
-    `helpful=${newHelpful} harmful=${newHarmful}`
-  );
-
-  if (oldLine === newLine) {
-    console.error('Warning: No change detected');
-    return bullet;
-  }
-
-  // Write updated content
-  lines[lineIndex] = newLine;
-  fs.writeFileSync(bullet.file, lines.join('\n'));
-
-  return {
-    ...bullet,
-    content: newLine,
-    helpful: newHelpful,
-    harmful: newHarmful
-  };
-}
-
-/**
- * Display bullet info
- */
-function displayBullet(bullet) {
-  console.log(JSON.stringify({
-    file: path.relative(process.cwd(), bullet.file),
-    line: bullet.line,
-    helpful: bullet.helpful,
-    harmful: bullet.harmful,
-    content: bullet.content.trim()
-  }, null, 2));
-}
-
-/**
- * Main CLI
- */
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Help
-  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.log('Usage:');
-    console.log('  genie helper bullet-counter ID');
-    console.log('    Show current counters for bullet');
-    console.log('');
-    console.log('  genie helper bullet-counter ID --helpful');
-    console.log('    Increment helpful counter');
-    console.log('');
-    console.log('  genie helper bullet-counter ID --harmful');
-    console.log('    Increment harmful counter');
-    console.log('');
-    console.log('Examples:');
-    console.log('  $ genie helper bullet-counter learn-042');
-    console.log('  {');
-    console.log('    "file": ".genie/spells/learn.md",');
-    console.log('    "line": 356,');
-    console.log('    "helpful": 5,');
-    console.log('    "harmful": 0');
-    console.log('  }');
-    console.log('');
-    console.log('  $ genie helper bullet-counter learn-042 --helpful');
-    console.log('  Updated: helpful=6 harmful=0');
-    return;
-  }
-
-  const id = args[0];
-  const incrementHelpful = args.includes('--helpful');
-  const incrementHarmful = args.includes('--harmful');
-
-  if (!id) {
-    console.error('Error: Bullet ID required');
-    console.error('Usage: genie helper bullet-counter ID [--helpful|--harmful]');
-    process.exit(1);
-  }
-
-  // Find bullet
-  const bullet = findBullet(id);
-
-  if (!bullet) {
-    console.error(`Error: Bullet [${id}] not found`);
-    console.error('');
-    console.error('Searched in: .genie/');
-    console.error('Pattern: - [ID] helpful=N harmful=M: content');
-    console.error('');
-    console.error('Tip: Use "genie helper bullet-find" to search for bullets');
-    process.exit(1);
-  }
-
-  // Show current state
-  if (!incrementHelpful && !incrementHarmful) {
-    displayBullet(bullet);
-    return;
-  }
-
-  // Update counter
-  const updated = updateBulletCounter(bullet, incrementHelpful, incrementHarmful);
-
-  console.log(`Updated: helpful=${updated.helpful} harmful=${updated.harmful}`);
-  console.log(`File: ${path.relative(process.cwd(), updated.file)}:${updated.line}`);
-}
-
-main().catch(err => {
-  console.error('ERROR:', err.message);
-  process.exit(1);
-});

package/.genie/scripts/helpers/bullet-find.js

@@ -1,289 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Bullet Retrieval Tool
- *
- * Find and query structured learning bullets.
- *
- * Usage:
- *   genie helper bullet-find ID
- *   genie helper bullet-find --top-helpful --limit=10
- *   genie helper bullet-find --top-harmful --limit=10
- *   genie helper bullet-find --file=learn.md --section="Section"
- *   genie helper bullet-find --search="keyword"
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-/**
- * Parse bullet line into structured data
- */
-function parseBullet(line, file, lineNum) {
-  const match = line.match(/^- \[([a-z]+-\d{3})\] helpful=(\d+) harmful=(\d+): (.+)$/);
-
-  if (!match) {
-    return null;
-  }
-
-  return {
-    id: match[1],
-    helpful: parseInt(match[2], 10),
-    harmful: parseInt(match[3], 10),
-    content: match[4],
-    file: path.relative(process.cwd(), file),
-    line: lineNum
-  };
-}
-
-/**
- * Find bullet by ID
- */
-function findById(id) {
-  try {
-    const result = execSync(
-      `rg -n "^- \\[${id}\\]" .genie/`,
-      { encoding: 'utf-8', cwd: process.cwd() }
-    ).trim();
-
-    if (!result) {
-      return null;
-    }
-
-    // Parse: file:line:content
-    const match = result.match(/^([^:]+):(\d+):(.+)$/);
-    if (!match) {
-      return null;
-    }
-
-    const [, file, lineNum, content] = match;
-    return parseBullet(content, file, parseInt(lineNum, 10));
-  } catch (err) {
-    if (err.status === 1) {
-      return null; // Not found
-    }
-    throw err;
-  }
-}
-
-/**
- * Find all bullets in framework
- */
-function findAllBullets() {
-  try {
-    const result = execSync(
-      'rg -n "^- \\[[a-z]+-\\d{3}\\] helpful=\\d+ harmful=\\d+:" .genie/',
-      { encoding: 'utf-8', cwd: process.cwd() }
-    ).trim();
-
-    if (!result) {
-      return [];
-    }
-
-    const lines = result.split('\n');
-    const bullets = [];
-
-    for (const line of lines) {
-      const match = line.match(/^([^:]+):(\d+):(.+)$/);
-      if (match) {
-        const [, file, lineNum, content] = match;
-        const bullet = parseBullet(content, file, parseInt(lineNum, 10));
-        if (bullet) {
-          bullets.push(bullet);
-        }
-      }
-    }
-
-    return bullets;
-  } catch (err) {
-    if (err.status === 1) {
-      return []; // None found
-    }
-    throw err;
-  }
-}
-
-/**
- * Find bullets in specific file
- */
-function findInFile(filePath) {
-  const fullPath = path.resolve(process.cwd(), filePath);
-
-  if (!fs.existsSync(fullPath)) {
-    return [];
-  }
-
-  try {
-    const result = execSync(
-      `rg -n "^- \\[[a-z]+-\\d{3}\\] helpful=\\d+ harmful=\\d+:" "${fullPath}"`,
-      { encoding: 'utf-8' }
-    ).trim();
-
-    if (!result) {
-      return [];
-    }
-
-    const lines = result.split('\n');
-    const bullets = [];
-
-    for (const line of lines) {
-      // When rg searches a single file, output is "line:content" not "file:line:content"
-      const match = line.match(/^(\d+):(.+)$/);
-      if (match) {
-        const [, lineNum, content] = match;
-        const bullet = parseBullet(content, fullPath, parseInt(lineNum, 10));
-        if (bullet) {
-          bullets.push(bullet);
-        }
-      }
-    }
-
-    return bullets;
-  } catch (err) {
-    if (err.status === 1) {
-      return []; // None found
-    }
-    throw err;
-  }
-}
-
-/**
- * Search bullets by content keyword
- */
-function searchByKeyword(keyword) {
-  const allBullets = findAllBullets();
-  return allBullets.filter(b =>
-    b.content.toLowerCase().includes(keyword.toLowerCase()) ||
-    b.id.includes(keyword)
-  );
-}
-
-/**
- * Get top N bullets by helpful count
- */
-function getTopHelpful(limit = 10) {
-  const bullets = findAllBullets();
-  bullets.sort((a, b) => b.helpful - a.helpful);
-  return bullets.slice(0, limit);
-}
-
-/**
- * Get top N bullets by harmful count
- */
-function getTopHarmful(limit = 10) {
-  const bullets = findAllBullets();
-  bullets.sort((a, b) => b.harmful - a.harmful);
-  return bullets.slice(0, limit);
-}
-
-/**
- * Display bullets
- */
-function displayBullets(bullets, title = null) {
-  if (title) {
-    console.log(`\n${title}\n${'='.repeat(title.length)}\n`);
-  }
-
-  if (bullets.length === 0) {
-    console.log('No bullets found');
-    return;
-  }
-
-  for (const bullet of bullets) {
-    console.log(`[${bullet.id}] helpful=${bullet.helpful} harmful=${bullet.harmful}`);
-    console.log(`  ${bullet.file}:${bullet.line}`);
-    console.log(`  ${bullet.content.substring(0, 100)}${bullet.content.length > 100 ? '...' : ''}`);
-    console.log('');
-  }
-
-  console.log(`Total: ${bullets.length} bullet(s)`);
-}
-
-/**
- * Main CLI
- */
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Help
-  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.log('Usage:');
-    console.log('  genie helper bullet-find ID');
-    console.log('    Find specific bullet by ID');
-    console.log('');
-    console.log('  genie helper bullet-find --top-helpful --limit=10');
-    console.log('    Find top 10 most helpful bullets');
-    console.log('');
-    console.log('  genie helper bullet-find --top-harmful --limit=10');
-    console.log('    Find top 10 most harmful bullets');
-    console.log('');
-    console.log('  genie helper bullet-find --file=file.md');
-    console.log('    Find all bullets in specific file');
-    console.log('');
-    console.log('  genie helper bullet-find --search="keyword"');
-    console.log('    Search bullets by content');
-    console.log('');
-    console.log('Examples:');
-    console.log('  $ genie helper bullet-find learn-042');
-    console.log('  $ genie helper bullet-find --top-helpful --limit=5');
-    console.log('  $ genie helper bullet-find --search="delegate"');
-    return;
-  }
-
-  // Find by ID
-  if (args[0] && !args[0].startsWith('--')) {
-    const bullet = findById(args[0]);
-    if (!bullet) {
-      console.error(`Error: Bullet [${args[0]}] not found`);
-      process.exit(1);
-    }
-    displayBullets([bullet]);
-    return;
-  }
-
-  // Top helpful
-  if (args.includes('--top-helpful')) {
-    const limitArg = args.find(a => a.startsWith('--limit='));
-    const limit = limitArg ? parseInt(limitArg.split('=')[1], 10) : 10;
-    const bullets = getTopHelpful(limit);
-    displayBullets(bullets, `Top ${limit} Most Helpful Bullets`);
-    return;
-  }
-
-  // Top harmful
-  if (args.includes('--top-harmful')) {
-    const limitArg = args.find(a => a.startsWith('--limit='));
-    const limit = limitArg ? parseInt(limitArg.split('=')[1], 10) : 10;
-    const bullets = getTopHarmful(limit);
-    displayBullets(bullets, `Top ${limit} Most Harmful Bullets`);
-    return;
-  }
-
-  // Find in file
-  const fileArg = args.find(a => a.startsWith('--file='));
-  if (fileArg) {
-    const filePath = fileArg.split('=')[1];
-    const bullets = findInFile(filePath);
-    displayBullets(bullets, `Bullets in ${filePath}`);
-    return;
-  }
-
-  // Search by keyword
-  const searchArg = args.find(a => a.startsWith('--search='));
-  if (searchArg) {
-    const keyword = searchArg.split('=')[1];
-    const bullets = searchByKeyword(keyword);
-    displayBullets(bullets, `Search results for "${keyword}"`);
-    return;
-  }
-
-  console.error('Error: No valid operation specified');
-  console.error('Use --help to see available options');
-  process.exit(1);
-}
-
-main().catch(err => {
-  console.error('ERROR:', err.message);
-  process.exit(1);
-});

package/.genie/scripts/helpers/bullet-id.js

@@ -1,244 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Bullet ID Generator
- *
- * Generates unique IDs for structured learning bullets.
- * Format: [prefix-NNN] where NNN is zero-padded 3-digit counter.
- *
- * Usage:
- *   genie helper bullet-id file.md
- *   genie helper bullet-id file.md --count=10
- *   genie helper bullet-id file.md --peek (show next without incrementing)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Maximum bullet ID number (supports 001-999)
-const MAX_BULLET_ID = 999;
-
-/**
- * Extract prefix from filename
- * learn.md → learn
- * orchestration-boundary-protocol.md → orchestration
- */
-function getFilePrefix(filePath) {
-  const basename = path.basename(filePath, '.md');
-
-  // For multi-word files, use first word
-  const firstWord = basename.split('-')[0];
-
-  // Lowercase for consistency
-  return firstWord.toLowerCase();
-}
-
-/**
- * Get cache directory path
- */
-function getCacheDir() {
-  const cacheDir = path.join(process.cwd(), '.genie', '.cache', 'bullet-ids');
-  if (!fs.existsSync(cacheDir)) {
-    fs.mkdirSync(cacheDir, { recursive: true });
-  }
-  return cacheDir;
-}
-
-/**
- * Get cache file path for prefix
- */
-function getCachePath(prefix) {
-  return path.join(getCacheDir(), `${prefix}.json`);
-}
-
-/**
- * Read last ID from cache
- */
-function getLastIdFromCache(prefix) {
-  const cachePath = getCachePath(prefix);
-
-  if (!fs.existsSync(cachePath)) {
-    return 0;
-  }
-
-  try {
-    const cache = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
-    return cache.lastId || 0;
-  } catch (err) {
-    console.error(`Warning: Cache read failed for ${prefix}, starting from 0`);
-    return 0;
-  }
-}
-
-/**
- * Scan file for highest existing ID
- * Handles cases where file was manually edited
- */
-function scanFileForHighestId(filePath, prefix) {
-  if (!fs.existsSync(filePath)) {
-    return 0;
-  }
-
-  try {
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const pattern = new RegExp(`\\[${prefix}-(\\d{3})\\]`, 'g');
-
-    let highest = 0;
-    let match;
-
-    while ((match = pattern.exec(content)) !== null) {
-      const idNum = parseInt(match[1], 10);
-      if (idNum > highest) {
-        highest = idNum;
-      }
-    }
-
-    return highest;
-  } catch (err) {
-    console.error(`Warning: Could not scan ${filePath}`);
-    return 0;
-  }
-}
-
-/**
- * Get next ID (reconciles cache and file scan)
- */
-function getNextId(filePath, prefix) {
-  const cachedId = getLastIdFromCache(prefix);
-  const scannedId = scanFileForHighestId(filePath, prefix);
-
-  // Use whichever is higher (handles manual edits)
-  const lastId = Math.max(cachedId, scannedId);
-
-  return lastId + 1;
-}
-
-/**
- * Save last ID to cache
- */
-function saveIdToCache(prefix, lastId) {
-  const cachePath = getCachePath(prefix);
-
-  fs.writeFileSync(cachePath, JSON.stringify({
-    prefix,
-    lastId,
-    updated: new Date().toISOString()
-  }, null, 2));
-}
-
-/**
- * Generate formatted ID
- */
-function formatId(prefix, number) {
-  const paddedNum = String(number).padStart(3, '0');
-  return `${prefix}-${paddedNum}`;
-}
-
-/**
- * Generate single ID
- */
-function generateSingleId(filePath, peek = false) {
-  const prefix = getFilePrefix(filePath);
-  const nextNum = getNextId(filePath, prefix);
-
-  if (nextNum > MAX_BULLET_ID) {
-    console.error(`ERROR: ID limit reached for ${prefix} (max ${MAX_BULLET_ID})`);
-    process.exit(1);
-  }
-
-  const id = formatId(prefix, nextNum);
-
-  // Save to cache unless peek mode
-  if (!peek) {
-    saveIdToCache(prefix, nextNum);
-  }
-
-  return id;
-}
-
-/**
- * Generate batch of IDs
- */
-function generateBatchIds(filePath, count) {
-  const prefix = getFilePrefix(filePath);
-  let nextNum = getNextId(filePath, prefix);
-
-  if (nextNum + count > MAX_BULLET_ID) {
-    console.error(`ERROR: Batch would exceed ID limit for ${prefix} (max ${MAX_BULLET_ID})`);
-    process.exit(1);
-  }
-
-  const ids = [];
-  for (let i = 0; i < count; i++) {
-    ids.push(formatId(prefix, nextNum + i));
-  }
-
-  // Save final ID to cache
-  saveIdToCache(prefix, nextNum + count - 1);
-
-  return ids;
-}
-
-/**
- * Main CLI
- */
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Help
-  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.log('Usage:');
-    console.log('  genie helper bullet-id file.md');
-    console.log('    Generate next ID for file');
-    console.log('');
-    console.log('  genie helper bullet-id file.md --count=10');
-    console.log('    Generate batch of 10 IDs');
-    console.log('');
-    console.log('  genie helper bullet-id file.md --peek');
-    console.log('    Show next ID without incrementing');
-    console.log('');
-    console.log('Examples:');
-    console.log('  $ genie helper bullet-id .genie/spells/learn.md');
-    console.log('  learn-042');
-    console.log('');
-    console.log('  $ genie helper bullet-id .genie/spells/learn.md --count=5');
-    console.log('  learn-042');
-    console.log('  learn-043');
-    console.log('  learn-044');
-    console.log('  learn-045');
-    console.log('  learn-046');
-    return;
-  }
-
-  const filePath = args[0];
-  const countArg = args.find(a => a.startsWith('--count='));
-  const peek = args.includes('--peek');
-
-  if (!filePath) {
-    console.error('Error: File path required');
-    console.error('Usage: genie helper bullet-id file.md');
-    process.exit(1);
-  }
-
-  // Batch generation
-  if (countArg) {
-    const count = parseInt(countArg.split('=')[1], 10);
-    if (isNaN(count) || count < 1) {
-      console.error('Error: Invalid count');
-      process.exit(1);
-    }
-
-    const ids = generateBatchIds(filePath, count);
-    ids.forEach(id => console.log(id));
-    return;
-  }
-
-  // Single ID generation
-  const id = generateSingleId(filePath, peek);
-  console.log(id);
-}
-
-main().catch(err => {
-  console.error('ERROR:', err.message);
-  process.exit(1);
-});