jettypod 4.1.2 → 4.1.4

package/prototypes/2025-01-11-production-mode-guided.js

@@ -1,217 +0,0 @@
-// Prototype: Production Mode Skill - Option 3 (Guided Production Discovery)
-// Created: 2025-01-11
-// Purpose: Demonstrate educational, context-aware production planning
-// Decision: [to be filled after testing]
-
-/**
- * PROTOTYPE: Guided Production Discovery
- *
- * Deep questionnaire → Context-specific scenarios → Educational implementation
- * Highly tailored, teaches production best practices, requires user expertise
- */
-
-const readline = require('readline');
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-function question(prompt) {
-  return new Promise(resolve => rl.question(prompt, resolve));
-}
-
-function sleep(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-async function guidedProductionMode() {
-  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('🎓 Production Mode: Guided Discovery');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('Starting work on: #1715 Implement audit logging for external transitions\n');
-
-  await sleep(500);
-  console.log('Let\'s ensure this feature is production-ready for YOUR deployment context.\n');
-  console.log('I\'ll ask some questions to tailor production scenarios to your needs.\n');
-
-  await sleep(300);
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('📋 Deployment Context');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  const env = await question('1. Where will this run? (local/cloud/on-prem/hybrid): ');
-  console.log(`   ✓ ${env}\n`);
-
-  const users = await question('2. Expected number of users? (1-10/10-100/100-1000/1000+): ');
-  console.log(`   ✓ ${users}\n`);
-
-  const data = await question('3. Does this handle sensitive data? (yes/no): ');
-  console.log(`   ✓ ${data}\n`);
-
-  const compliance = await question('4. Any compliance requirements? (GDPR/SOC2/HIPAA/none): ');
-  console.log(`   ✓ ${compliance}\n`);
-
-  await sleep(300);
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('🔒 Security Concerns');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('For audit logging, we should consider:\n');
-  console.log('**Authentication & Authorization:**');
-  console.log('  • Should we log who triggered the transition?');
-  console.log('  • Should we verify permissions before logging?\n');
-
-  const auth = await question('Include authentication scenarios? (yes/no): ');
-  console.log(`   ✓ ${auth}\n`);
-
-  console.log('**Data Protection:**');
-  console.log('  • Project names might contain sensitive info');
-  console.log('  • User IDs need protection under ' + compliance + '\n');
-
-  const protection = await question('Add data sanitization scenarios? (yes/no): ');
-  console.log(`   ✓ ${protection}\n`);
-
-  console.log('**Audit Trail Security:**');
-  console.log('  • Logs should be tamper-proof');
-  console.log('  • Need integrity verification\n');
-
-  const integrity = await question('Add integrity verification scenarios? (yes/no): ');
-  console.log(`   ✓ ${integrity}\n`);
-
-  await sleep(300);
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('⚡ Performance & Scale');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('Based on ' + users + ' users:\n');
-  console.log('**Expected Load:**');
-  console.log('  • Estimated: 50 transitions/hour peak');
-  console.log('  • Log writes: async, buffered\n');
-
-  const perf = await question('Add performance benchmarks? (yes/no): ');
-  console.log(`   ✓ ${perf}\n`);
-
-  console.log('**Storage:**');
-  console.log('  • Estimated log size: 500KB/day');
-  console.log('  • Need rotation after 10MB\n');
-
-  const rotation = await question('Add log rotation scenarios? (yes/no): ');
-  console.log(`   ✓ ${rotation}\n`);
-
-  await sleep(300);
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('📜 Compliance & Governance');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  if (compliance !== 'none') {
-    console.log(`**${compliance} Requirements:**\n`);
-
-    if (compliance === 'GDPR') {
-      console.log('  • Right to be forgotten (data deletion)');
-      console.log('  • Data retention limits (90 days recommended)');
-      console.log('  • Export in machine-readable format\n');
-    } else if (compliance === 'SOC2') {
-      console.log('  • Audit log immutability');
-      console.log('  • Access control logging');
-      console.log('  • Retention for compliance period\n');
-    }
-
-    const complianceScenarios = await question('Add ' + compliance + ' compliance scenarios? (yes/no): ');
-    console.log(`   ✓ ${complianceScenarios}\n`);
-  }
-
-  await sleep(500);
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('📊 Production Scenarios Summary');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('Based on your context, here are the scenarios:\n');
-  console.log('**Security (4 scenarios):**');
-  console.log('  ✓ Audit logging with authentication');
-  console.log('  ✓ Data sanitization for ' + compliance);
-  console.log('  ✓ Tamper-proof log integrity');
-  console.log('  ✓ Unauthorized access prevention\n');
-
-  console.log('**Scale (3 scenarios):**');
-  console.log('  ✓ Performance: 50 transitions/hour');
-  console.log('  ✓ Log rotation at 10MB');
-  console.log('  ✓ Memory usage under load\n');
-
-  console.log('**Compliance (2 scenarios):**');
-  console.log('  ✓ ' + compliance + ' data retention');
-  console.log('  ✓ Audit log export\n');
-
-  const confirm = await question('Proceed with these 9 scenarios? (yes/adjust): ');
-
-  if (confirm.toLowerCase() === 'yes') {
-    console.log('\n✅ Scenarios confirmed\n');
-
-    await sleep(300);
-    console.log('Adding scenarios to features/simplify-external-transition.feature...');
-    await sleep(300);
-    console.log('✅ 9 production scenarios added\n');
-
-    await sleep(500);
-    console.log('Now implementing each scenario with explanations...\n');
-
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('📚 Implementation (with education)');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-    await sleep(300);
-    console.log('[1/9] Audit logging with authentication\n');
-    console.log('**Why this matters:**');
-    console.log('  For ' + compliance + ', you need to know WHO made state changes.\n');
-    console.log('**Implementation approach:**');
-    console.log('  • Capture process.env.USER or Git config');
-    console.log('  • Include timestamp (ISO 8601)');
-    console.log('  • Record transition type and details\n');
-    await sleep(500);
-    console.log('  ✓ Implemented logTransition(user, event, metadata)');
-    console.log('  🧪 Running tests... ✅ Passing\n');
-
-    await sleep(300);
-    console.log('[2/9] Data sanitization for ' + compliance + '\n');
-    console.log('**Why this matters:**');
-    console.log('  User IDs and project names might contain PII.\n');
-    console.log('**Implementation approach:**');
-    console.log('  • Hash user identifiers');
-    console.log('  • Redact project name substrings matching PII patterns');
-    console.log('  • Keep enough data for debugging\n');
-    await sleep(500);
-    console.log('  ✓ Implemented sanitizeData(data)');
-    console.log('  🧪 Running tests... ✅ Passing\n');
-
-    // Abbreviated for brevity - would continue for all 9 scenarios
-
-    console.log('[... 7 more scenarios implemented with explanations ...]\n');
-
-    await sleep(500);
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('🎉 Production Implementation Complete!');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-    console.log('✅ 9 scenarios passing');
-    console.log('✅ Production-ready for ' + env + ' deployment');
-    console.log('✅ ' + compliance + ' compliant');
-    console.log('✅ Scaled for ' + users + ' users\n');
-
-    console.log('**What you learned:**');
-    console.log('  • How ' + compliance + ' applies to audit logging');
-    console.log('  • Why async logging matters at your scale');
-    console.log('  • Tamper-proof storage techniques');
-    console.log('  • Production-grade error handling\n');
-  }
-
-  console.log('**UX NOTES:**');
-  console.log('  • Highly educational - teaches WHY, not just WHAT');
-  console.log('  • Tailored to actual deployment context');
-  console.log('  • Takes longer but builds expertise');
-  console.log('  • Best for teams learning production practices');
-  console.log('  • Requires user to know their deployment environment\n');
-
-  rl.close();
-}
-
-guidedProductionMode();

package/prototypes/2025-01-11-production-mode-smart-context.js

@@ -1,347 +0,0 @@
-// Prototype: Production Mode Skill - Smart Context Awareness
-// Created: 2025-01-11
-// Purpose: Demonstrate how skill handles different starting contexts
-// Decision: [to be filled after testing]
-
-/**
- * PROTOTYPE: Context-Aware Production Mode
- *
- * Intelligently detects which scenario we're in and adapts:
- * - Scenario A: Fresh from stable (hot context, scenarios exist)
- * - Scenario B: Gap in time (cold context, re-validate)
- * - Scenario C: Post external-transition (new infrastructure requirements)
- */
-
-const readline = require('readline');
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-function question(prompt) {
-  return new Promise(resolve => rl.question(prompt, resolve));
-}
-
-function sleep(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-async function detectContext() {
-  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('🔍 Context Detection Phase');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  await sleep(300);
-  console.log('Analyzing current state...\n');
-
-  // Simulated checks
-  const hasScenarios = true; // Check if production scenarios exist in .feature file
-  const hasChores = true; // Check if production chores exist in database
-  const projectState = 'external'; // Check .jettypod/config.json
-  const hasProductionStandards = true; // Check if .jettypod/production-standards.md exists
-  const lastStableChoreCompleted = '2025-01-10'; // When was last stable chore done?
-  const externalTransitionDate = '2025-01-11'; // When did external transition happen?
-
-  await sleep(500);
-
-  console.log('📊 Context Analysis:\n');
-  console.log(`  Production scenarios exist: ${hasScenarios ? '✓' : '✗'}`);
-  console.log(`  Production chores exist: ${hasChores ? '✓' : '✗'}`);
-  console.log(`  Project state: ${projectState}`);
-  console.log(`  Production standards doc: ${hasProductionStandards ? '✓' : '✗'}`);
-  console.log(`  Last stable chore: ${lastStableChoreCompleted}`);
-  console.log(`  External transition: ${externalTransitionDate}\n`);
-
-  await sleep(500);
-
-  // Determine scenario
-  const timeSinceStable = 1; // days (simplified)
-  const transitionedAfterStable = externalTransitionDate > lastStableChoreCompleted;
-
-  let scenario;
-  if (hasScenarios && hasChores && timeSinceStable <= 1 && !transitionedAfterStable) {
-    scenario = 'A';
-  } else if (hasScenarios && hasChores && (timeSinceStable > 1 || transitionedAfterStable)) {
-    scenario = 'B';
-  } else {
-    scenario = 'C';
-  }
-
-  console.log(`🎯 Detected Scenario: ${scenario}\n`);
-
-  return { scenario, hasProductionStandards, projectState, hasScenarios, hasChores };
-}
-
-async function scenarioA() {
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('🚀 Scenario A: Fresh from Stable Mode');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('**Context:**');
-  console.log('  • Just completed stable mode');
-  console.log('  • Production scenarios were proposed and confirmed');
-  console.log('  • Production chores already created');
-  console.log('  • Hot context - everything is fresh\n');
-
-  await sleep(500);
-
-  console.log('📋 Loading existing production scenarios...\n');
-  await sleep(300);
-
-  console.log('Found 5 production scenarios:');
-  console.log('  1. Audit logging for state transitions (Security)');
-  console.log('  2. Performance with 1000+ work items (Scale)');
-  console.log('  3. Concurrent transition prevention (Security)');
-  console.log('  4. State transition compliance records (Compliance)');
-  console.log('  5. Idempotent infrastructure creation (Scale)\n');
-
-  await sleep(500);
-
-  console.log('✅ Quick validation against production standards...\n');
-  await sleep(300);
-
-  console.log('  ✓ Security: Audit logging ✓ covered');
-  console.log('  ✓ Security: Data sanitization ⚠️  missing');
-  console.log('  ✓ Performance: < 5s benchmark ✓ covered');
-  console.log('  ✓ Scale: Concurrency control ✓ covered');
-  console.log('  ✓ Compliance: Data retention ✓ covered');
-  console.log('  ✓ Compliance: Tamper-proof logs ⚠️  missing\n');
-
-  await sleep(300);
-
-  console.log('💡 Recommendation: Add 2 scenarios\n');
-  console.log('**Scenario 6: Data sanitization in audit logs**');
-  console.log('  - Mask PII, tokens, API keys');
-  console.log('  - Required by production standards\n');
-
-  console.log('**Scenario 7: Tamper-proof log storage**');
-  console.log('  - Append-only, read-only after write');
-  console.log('  - Required for compliance\n');
-
-  const response = await question('Add these scenarios? (yes/no): ');
-
-  if (response.toLowerCase() === 'yes') {
-    console.log('\n✅ Added 2 scenarios to feature file');
-    console.log('✅ Created 2 new production chores\n');
-
-    await sleep(300);
-    console.log('📊 Updated production chore list:\n');
-    console.log('  #1715: Implement audit logging (ready)');
-    console.log('  #1716: Optimize performance for large projects (ready)');
-    console.log('  #1717: Add concurrency control (ready)');
-    console.log('  #1718: Create state transition records (ready)');
-    console.log('  #1719: Ensure idempotency (ready)');
-    console.log('  #1720: Add data sanitization (new) ⭐');
-    console.log('  #1721: Implement tamper-proof storage (new) ⭐\n');
-
-    console.log('**Workflow:** Start implementing chores');
-    console.log('  → jettypod work start 1715\n');
-  }
-}
-
-async function scenarioB() {
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('🔄 Scenario B: Gap in Time (Re-validation)');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('**Context:**');
-  console.log('  • Stable mode completed 30 days ago');
-  console.log('  • Project transitioned to external 5 days ago');
-  console.log('  • Production scenarios exist but might be outdated');
-  console.log('  • Need to check what changed\n');
-
-  await sleep(500);
-
-  console.log('🔍 Checking for changes since stable mode...\n');
-  await sleep(300);
-
-  console.log('**Changes detected:**\n');
-  console.log('  ⚠️  Project state: internal → external');
-  console.log('     Impact: New infrastructure requirements');
-  console.log('     Source: .jettypod/production-standards.md (updated 5 days ago)\n');
-
-  console.log('  ⚠️  Infrastructure epic created (#899)');
-  console.log('     Impact: Deployment, monitoring, security patterns now defined');
-  console.log('     Source: Infrastructure Readiness epic\n');
-
-  console.log('  ℹ️  Production standards updated');
-  console.log('     New requirements: TLS/HTTPS, secrets management, health checks\n');
-
-  await sleep(500);
-
-  console.log('📋 Re-validating existing production scenarios...\n');
-  await sleep(300);
-
-  console.log('Existing scenarios:');
-  console.log('  1. Audit logging ✓ still valid');
-  console.log('  2. Performance benchmarks ✓ still valid');
-  console.log('  3. Concurrency control ✓ still valid');
-  console.log('  4. State transition records ✓ still valid');
-  console.log('  5. Idempotent operations ✓ still valid\n');
-
-  await sleep(300);
-
-  console.log('💡 New scenarios needed (from production standards):\n');
-  console.log('**Scenario 6: Secrets management**');
-  console.log('  - No hardcoded secrets in code');
-  console.log('  - Use environment variables or vault');
-  console.log('  - Required for external deployment\n');
-
-  console.log('**Scenario 7: Health check endpoint**');
-  console.log('  - /health returns service status');
-  console.log('  - Required for monitoring (Infrastructure epic)\n');
-
-  console.log('**Scenario 8: TLS/HTTPS for external access**');
-  console.log('  - All endpoints use HTTPS');
-  console.log('  - Required for external state\n');
-
-  const response = await question('Add infrastructure-related scenarios? (yes/adjust): ');
-
-  if (response.toLowerCase() === 'yes') {
-    console.log('\n✅ Added 3 infrastructure scenarios');
-    console.log('✅ Created 3 new production chores');
-    console.log('✅ Updated existing chores with infrastructure patterns\n');
-
-    console.log('**Workflow:** Review changes, then start implementing');
-    console.log('  → Review updated scenarios in feature file');
-    console.log('  → jettypod work start 1715\n');
-  }
-}
-
-async function scenarioC() {
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('🆕 Scenario C: Post External-Transition');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('**Context:**');
-  console.log('  • No production scenarios exist');
-  console.log('  • Feature was in stable mode (internal project)');
-  console.log('  • Project recently transitioned to external');
-  console.log('  • Need to generate production scenarios from scratch\n');
-
-  await sleep(500);
-
-  console.log('📚 Loading production standards...\n');
-  await sleep(300);
-
-  console.log('Found: .jettypod/production-standards.md\n');
-  console.log('Standards defined:');
-  console.log('  • Security: Audit logging, data protection, auth validation');
-  console.log('  • Performance: < 5s, < 100MB, 1000+ users');
-  console.log('  • Scale: Concurrency, idempotency, log rotation');
-  console.log('  • Compliance: 90-day retention, export, GDPR');
-  console.log('  • Infrastructure: Deployment, monitoring, security, backups\n');
-
-  await sleep(500);
-
-  console.log('🔍 Analyzing feature implementation...\n');
-  await sleep(300);
-
-  console.log('Feature: Simplify External Transition Command\n');
-  console.log('Implementation files:');
-  console.log('  • jettypod.js (external command)');
-  console.log('  • lib/config.js (state management)');
-  console.log('  • features/work-tracking/index.js (work item creation)\n');
-
-  await sleep(300);
-
-  console.log('Relevant production concerns:\n');
-  console.log('  ✓ State transitions → Audit logging needed');
-  console.log('  ✓ Creates work items → Performance/scale needed');
-  console.log('  ✓ Modifies config → Concurrency control needed');
-  console.log('  ✓ External deployment → Infrastructure scenarios needed\n');
-
-  await sleep(500);
-
-  console.log('💡 Proposing production scenarios based on standards:\n');
-
-  console.log('**Security (3 scenarios):**');
-  console.log('  1. Audit logging for external transitions');
-  console.log('  2. Validate permissions before state change');
-  console.log('  3. Data sanitization in logs\n');
-
-  console.log('**Performance & Scale (3 scenarios):**');
-  console.log('  4. Performance with 1000+ work items (< 5s)');
-  console.log('  5. Concurrency control for state changes');
-  console.log('  6. Idempotent external transition\n');
-
-  console.log('**Compliance (2 scenarios):**');
-  console.log('  7. State transition audit trail (90-day retention)');
-  console.log('  8. Export audit logs (JSON/CSV)\n');
-
-  console.log('**Infrastructure (3 scenarios):**');
-  console.log('  9. Health check endpoint');
-  console.log('  10. Secrets management (no hardcoded values)');
-  console.log('  11. TLS/HTTPS for all endpoints\n');
-
-  const response = await question('Create these 11 production scenarios? (yes/adjust): ');
-
-  if (response.toLowerCase() === 'yes') {
-    console.log('\n✅ Created feature file with 11 production scenarios');
-    console.log('✅ Created step definitions for all scenarios');
-    console.log('✅ Created 11 production chores with implementation guidance\n');
-
-    console.log('**Workflow:** Start implementing chores');
-    console.log('  → jettypod work start [first-chore-id]\n');
-  }
-}
-
-async function smartContextMode() {
-  const context = await detectContext();
-
-  if (context.scenario === 'A') {
-    await scenarioA();
-  } else if (context.scenario === 'B') {
-    await scenarioB();
-  } else {
-    await scenarioC();
-  }
-
-  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('💡 Key Design Points');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
-
-  console.log('**1. Production Standards as Source of Truth**');
-  console.log('   • Created by external-transition skill');
-  console.log('   • Defines what "production ready" means');
-  console.log('   • Referenced by production-mode skill\n');
-
-  console.log('**2. Context Detection is Automatic**');
-  console.log('   • Checks scenario file, chores, project state');
-  console.log('   • Detects time gaps and state changes');
-  console.log('   • Adapts workflow accordingly\n');
-
-  console.log('**3. Intelligent Validation**');
-  console.log('   • Scenario A: Quick validation, fill gaps');
-  console.log('   • Scenario B: Re-validate, add new requirements');
-  console.log('   • Scenario C: Generate from standards\n');
-
-  console.log('**4. Infrastructure Integration**');
-  console.log('   • References Infrastructure Readiness epic');
-  console.log('   • Uses deployment patterns from standards');
-  console.log('   • Ensures consistency across features\n');
-
-  rl.close();
-}
-
-// Simulate different scenarios
-async function demo() {
-  console.log('\n🎮 Production Mode Skill - Smart Context Demo\n');
-  console.log('This prototype shows how the skill detects and handles different contexts.\n');
-
-  const scenario = await question('Which scenario to simulate? (A/B/C or auto): ');
-
-  if (scenario.toUpperCase() === 'A') {
-    await scenarioA();
-  } else if (scenario.toUpperCase() === 'B') {
-    await scenarioB();
-  } else if (scenario.toUpperCase() === 'C') {
-    await scenarioC();
-  } else {
-    await smartContextMode();
-  }
-
-  rl.close();
-}
-
-demo();