jettypod 4.1.2 → 4.1.4

package/.github/workflows/test-safety.yml

@@ -1,85 +0,0 @@
-name: Test Safety Verification
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  test-safety:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - uses: actions/checkout@v3
-    
-    - name: Setup Node.js
-      uses: actions/setup-node@v3
-      with:
-        node-version: '18'
-        
-    - name: Install dependencies
-      run: npm install
-      
-    - name: Create production snapshot
-      run: |
-        echo "Creating MD5 checksums of all production files..."
-        find . -type f \( -name "*.json" -o -name "*.js" -o -name "*.md" \) \
-          -not -path "./node_modules/*" \
-          -not -path "./.git/*" \
-          -not -path "./tmp/*" \
-          | xargs md5sum > before-tests.md5
-        
-        echo "Recording package.json state..."
-        cp package.json package.json.backup
-        
-        echo "Recording directory structure..."
-        ls -la > before-tests-ls.txt
-        
-    - name: Run tests
-      run: npm test
-      continue-on-error: true
-      
-    - name: Verify no production changes
-      run: |
-        echo "Checking for file modifications..."
-        find . -type f \( -name "*.json" -o -name "*.js" -o -name "*.md" \) \
-          -not -path "./node_modules/*" \
-          -not -path "./.git/*" \
-          -not -path "./tmp/*" \
-          | xargs md5sum > after-tests.md5
-        
-        echo "Comparing checksums..."
-        if ! diff before-tests.md5 after-tests.md5; then
-          echo "❌ CRITICAL: Tests modified production files!"
-          echo "Modified files:"
-          diff before-tests.md5 after-tests.md5 | grep "^[<>]"
-          exit 1
-        fi
-        
-        echo "Checking package.json..."
-        if ! diff package.json.backup package.json; then
-          echo "❌ CRITICAL: package.json was modified!"
-          diff package.json.backup package.json
-          exit 1
-        fi
-        
-        echo "Checking for leaked test files..."
-        ls -la > after-tests-ls.txt
-        NEW_FILES=$(diff before-tests-ls.txt after-tests-ls.txt | grep "^>" | grep -E "(temp_|actual_|main|server|utils|Calculator|helper|app)" || true)
-        if [ ! -z "$NEW_FILES" ]; then
-          echo "❌ CRITICAL: Tests leaked files to production!"
-          echo "$NEW_FILES"
-          exit 1
-        fi
-        
-        echo "✅ All safety checks passed - production directory unchanged"
-        
-    - name: Check for temp directory cleanup
-      run: |
-        echo "Checking /tmp for leaked test directories..."
-        LEAKED_DIRS=$(ls -la /tmp | grep "devpod-test-" || true)
-        if [ ! -z "$LEAKED_DIRS" ]; then
-          echo "⚠️ WARNING: Test directories not cleaned up in /tmp:"
-          echo "$LEAKED_DIRS"
-        fi

package/.jettypod/config.json

@@ -1,5 +0,0 @@
-{
-  "name": "jettypod-source",
-  "mode": "discovery",
-  "project_state": "internal"
-}

package/.jettypod/current-work.json

@@ -1,10 +0,0 @@
-{
-  "id": 2,
-  "title": "Test Epic",
-  "type": "epic",
-  "status": "backlog",
-  "parent_id": null,
-  "parent_title": null,
-  "epic_id": null,
-  "epic_title": null
-}

package/.jettypod/hooks/README.md

@@ -1,77 +0,0 @@
-# JettyPod Hooks
-
-## protect-claude-md.js
-
-**Purpose**: Prevents Claude Code from directly editing protected sections of CLAUDE.md
-
-**Status**: ✅ Shipped (integrated in jettypod init)
-
-**What it does**:
-- Intercepts Edit/Write operations via Claude Code's PreToolUse hook
-- Blocks direct edits to: `<mode>`, `<stage>`, `<current_work>`, work status
-- Returns helpful errors: "Use: jettypod speed" instead of "forbidden"
-- Allows all other CLAUDE.md edits (mission, standards, etc.)
-- Zero impact on non-CLAUDE.md files
-
-**Installation**:
-Automatically installed when you run `jettypod init`. Hook is configured in `.claude/settings.json`.
-
-**Manual installation**:
-```bash
-# Hook is already in .jettypod/hooks/
-# Just configure Claude Code:
-cat > .claude/settings.json << 'EOF'
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Edit",
-        "hooks": [{ "type": "command", "command": ".jettypod/hooks/protect-claude-md.js" }]
-      },
-      {
-        "matcher": "Write",
-        "hooks": [{ "type": "command", "command": ".jettypod/hooks/protect-claude-md.js" }]
-      }
-    ]
-  }
-}
-EOF
-```
-
-**Testing**:
-```bash
-# Run built-in tests
-node .jettypod/hooks/protect-claude-md.js test
-
-# Test with sample edit
-echo '{
-  "tool_name": "Edit",
-  "tool_input": {
-    "file_path": "CLAUDE.md",
-    "old_string": "<mode>discovery</mode>",
-    "new_string": "<mode>speed</mode>"
-  }
-}' | .jettypod/hooks/protect-claude-md.js
-```
-
-**Expected behavior**:
-When Claude tries to edit CLAUDE.md directly:
-```
-❌ Cannot change <mode> tag directly
-
-💡 Hint: Use: jettypod speed
-```
-
-**Debugging**:
-If hook isn't working:
-1. Check `.claude/settings.json` exists with hook config
-2. Verify hook is executable: `chmod +x .jettypod/hooks/protect-claude-md.js`
-3. Test hook directly (see Testing above)
-4. Check Claude Code version supports PreToolUse hooks
-
-**Known limitations**:
-- Can be bypassed with Bash redirection (`echo > CLAUDE.md`)
-- Not a concern in practice - Claude uses Edit tool by default
-- Could add Bash hook if bypass becomes common
-
-**Performance**: <10ms per edit check

package/.jettypod/hooks/protect-claude-md.js

@@ -1,338 +0,0 @@
-#!/usr/bin/env node
-// Prototype: Enforce jettypod command usage - Balanced (Claude Code Protocol)
-// Created: 2025-10-16
-// Purpose: PreToolUse hook that blocks direct CLAUDE.md edits and suggests jettypod commands
-// Decision: Updated to match actual Claude Code hook protocol
-
-/**
- * Claude Code PreToolUse Hook
- *
- * Intercepts Edit/Write operations on CLAUDE.md and blocks
- * forbidden patterns like mode changes or current_work updates.
- *
- * Configuration (add to ~/.claude/settings.json or .claude/settings.json):
- * {
- *   "hooks": {
- *     "PreToolUse": [
- *       {
- *         "matcher": "Edit",
- *         "hooks": [
- *           {
- *             "type": "command",
- *             "command": "./prototypes/2025-10-16-enforce-jettypod-balanced-v2.js"
- *           }
- *         ]
- *       },
- *       {
- *         "matcher": "Write",
- *         "hooks": [
- *           {
- *             "type": "command",
- *             "command": "./prototypes/2025-10-16-enforce-jettypod-balanced-v2.js"
- *           }
- *         ]
- *       }
- *     ]
- *   }
- * }
- *
- * Hook Input (via stdin):
- * {
- *   "session_id": "...",
- *   "transcript_path": "...",
- *   "cwd": "...",
- *   "hook_event_name": "PreToolUse",
- *   "tool_name": "Edit" | "Write",
- *   "tool_input": {
- *     "file_path": "/path/to/CLAUDE.md",
- *     "old_string": "original content",     // Edit only
- *     "new_string": "proposed new content", // Edit only
- *     "content": "file content"             // Write only
- *   }
- * }
- *
- * Hook Output (to stdout):
- * {
- *   "hookSpecificOutput": {
- *     "hookEventName": "PreToolUse",
- *     "permissionDecision": "allow" | "deny" | "ask",
- *     "permissionDecisionReason": "Explanation"
- *   }
- * }
- */
-
-const fs = require('fs');
-
-// Read hook input from stdin
-let input = '';
-process.stdin.on('data', chunk => input += chunk);
-process.stdin.on('end', () => {
-  try {
-    const hookInput = JSON.parse(input);
-    const { tool_name, tool_input, cwd } = hookInput;
-
-    // Only check CLAUDE.md edits
-    if (!tool_input.file_path || !tool_input.file_path.endsWith('CLAUDE.md')) {
-      allowEdit();
-      return;
-    }
-
-    let oldContent, newContent;
-
-    if (tool_name === 'Edit') {
-      oldContent = tool_input.old_string;
-      newContent = tool_input.new_string;
-    } else if (tool_name === 'Write') {
-      // For Write, read the current file content (if exists) to compare
-      try {
-        oldContent = fs.readFileSync(tool_input.file_path, 'utf8');
-        newContent = tool_input.content;
-      } catch (err) {
-        // File doesn't exist yet - allow new file creation
-        allowEdit();
-        return;
-      }
-    } else {
-      // Unknown tool
-      allowEdit();
-      return;
-    }
-
-    const result = checkEdit(oldContent, newContent);
-
-    if (result.blocked) {
-      denyEdit(result.message, result.suggestion);
-    } else {
-      allowEdit();
-    }
-
-  } catch (err) {
-    // If we can't parse input, allow the edit (fail open)
-    console.error('Hook error:', err.message);
-    allowEdit();
-  }
-});
-
-/**
- * Allow the edit
- */
-function allowEdit() {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: "PreToolUse",
-      permissionDecision: "allow"
-    }
-  }));
-  process.exit(0);
-}
-
-/**
- * Deny the edit with explanation
- */
-function denyEdit(message, suggestion) {
-  const reason = `❌ ${message}\n\n💡 Hint: ${suggestion}`;
-
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: "PreToolUse",
-      permissionDecision: "deny",
-      permissionDecisionReason: reason
-    }
-  }));
-  process.exit(0);
-}
-
-/**
- * Pattern definitions for forbidden edits
- */
-const FORBIDDEN_PATTERNS = [
-  {
-    name: 'mode_change',
-    detect: (old, newStr) => {
-      const oldMode = old.match(/<mode>(\w+)<\/mode>/);
-      const newMode = newStr.match(/<mode>(\w+)<\/mode>/);
-      return oldMode && newMode && oldMode[1] !== newMode[1];
-    },
-    message: 'Cannot change <mode> tag directly',
-    suggestion: (old, newStr) => {
-      const newMode = newStr.match(/<mode>(\w+)<\/mode>/)?.[1];
-      return `Use: jettypod ${newMode}`;
-    }
-  },
-  {
-    name: 'current_work_change',
-    detect: (old, newStr) => {
-      const oldWork = old.match(/<current_work>[\s\S]*?<\/current_work>/);
-      const newWork = newStr.match(/<current_work>[\s\S]*?<\/current_work>/);
-
-      // Block if current_work section content changes
-      if (oldWork && newWork && oldWork[0] !== newWork[0]) {
-        return true;
-      }
-
-      // Block if adding/removing current_work section
-      if ((!oldWork && newWork) || (oldWork && !newWork)) {
-        return true;
-      }
-
-      return false;
-    },
-    message: 'Cannot modify <current_work> section directly',
-    suggestion: (old, newStr) => {
-      const workId = newStr.match(/Working on: \[#(\d+)\]/)?.[1];
-      if (workId) {
-        return `Use: jettypod work start ${workId}`;
-      }
-      return 'Use: jettypod work start <id> or jettypod work stop';
-    }
-  },
-  {
-    name: 'work_status_change',
-    detect: (old, newStr) => {
-      const oldStatus = old.match(/Status: (\w+)/);
-      const newStatus = newStr.match(/Status: (\w+)/);
-      return oldStatus && newStatus && oldStatus[1] !== newStatus[1];
-    },
-    message: 'Cannot change work status directly',
-    suggestion: (old, newStr) => {
-      const workId = newStr.match(/Working on: \[#(\d+)\]/)?.[1];
-      const newStatus = newStr.match(/Status: (\w+)/)?.[1];
-      if (workId && newStatus) {
-        return `Use: jettypod work status ${workId} ${newStatus}`;
-      }
-      return 'Use: jettypod work status <id> <status>';
-    }
-  },
-  {
-    name: 'stage_change',
-    detect: (old, newStr) => {
-      const oldStage = old.match(/<stage>(\w+)<\/stage>/);
-      const newStage = newStr.match(/<stage>(\w+)<\/stage>/);
-      return oldStage && newStage && oldStage[1] !== newStage[1];
-    },
-    message: 'Cannot change <stage> tag directly',
-    suggestion: (old, newStr) => {
-      const newStage = newStr.match(/<stage>(\w+)<\/stage>/)?.[1];
-      return `Use: jettypod stage ${newStage}`;
-    }
-  }
-];
-
-/**
- * Check if an edit should be blocked
- */
-function checkEdit(oldStr, newStr) {
-  for (const pattern of FORBIDDEN_PATTERNS) {
-    if (pattern.detect(oldStr, newStr)) {
-      return {
-        blocked: true,
-        pattern: pattern.name,
-        message: pattern.message,
-        suggestion: pattern.suggestion(oldStr, newStr)
-      };
-    }
-  }
-
-  return { blocked: false };
-}
-
-/**
- * Test cases (run with: node prototypes/2025-10-16-enforce-jettypod-balanced-v2.js test)
- */
-if (process.argv[2] === 'test') {
-  console.log('Running tests...\n');
-
-  const tests = [
-    {
-      name: 'Block mode change (Edit)',
-      input: {
-        tool_name: 'Edit',
-        tool_input: {
-          file_path: '/path/to/CLAUDE.md',
-          old_string: '<mode>discovery</mode>',
-          new_string: '<mode>speed</mode>'
-        }
-      },
-      shouldBlock: true
-    },
-    {
-      name: 'Block current_work addition (Edit)',
-      input: {
-        tool_name: 'Edit',
-        tool_input: {
-          file_path: '/path/to/CLAUDE.md',
-          old_string: '<project_summary>test</project_summary>',
-          new_string: '<current_work>Working on: [#75]</current_work>'
-        }
-      },
-      shouldBlock: true
-    },
-    {
-      name: 'Block status change (Edit)',
-      input: {
-        tool_name: 'Edit',
-        tool_input: {
-          file_path: '/path/to/CLAUDE.md',
-          old_string: 'Status: in_progress',
-          new_string: 'Status: done'
-        }
-      },
-      shouldBlock: true
-    },
-    {
-      name: 'Allow other edits (Edit)',
-      input: {
-        tool_name: 'Edit',
-        tool_input: {
-          file_path: '/path/to/CLAUDE.md',
-          old_string: '<mission>Old mission</mission>',
-          new_string: '<mission>New mission</mission>'
-        }
-      },
-      shouldBlock: false
-    },
-    {
-      name: 'Allow non-CLAUDE.md edits',
-      input: {
-        tool_name: 'Edit',
-        tool_input: {
-          file_path: '/path/to/src/index.js',
-          old_string: 'const x = 1',
-          new_string: 'const x = 2'
-        }
-      },
-      shouldBlock: false
-    }
-  ];
-
-  let passed = 0;
-  let failed = 0;
-
-  tests.forEach(test => {
-    const toolInput = test.input.tool_input;
-    const oldStr = toolInput.old_string || '';
-    const newStr = toolInput.new_string || '';
-
-    // Skip file check for testing
-    const isClaudeMd = toolInput.file_path.endsWith('CLAUDE.md');
-    const result = isClaudeMd ? checkEdit(oldStr, newStr) : { blocked: false };
-    const matches = result.blocked === test.shouldBlock;
-
-    if (matches) {
-      console.log(`✅ ${test.name}`);
-      if (result.blocked) {
-        console.log(`   Message: ${result.message}`);
-        console.log(`   Suggestion: ${result.suggestion}`);
-      }
-      passed++;
-    } else {
-      console.log(`❌ ${test.name}`);
-      console.log(`   Expected blocked=${test.shouldBlock}, got blocked=${result.blocked}`);
-      failed++;
-    }
-    console.log();
-  });
-
-  console.log(`Results: ${passed} passed, ${failed} failed`);
-  process.exit(failed > 0 ? 1 : 0);
-}

package/CLAUDE.md

@@ -1,49 +0,0 @@
-<claude_context project="jettypod-source">
-
-<current_work>
-Working on: [#2] Test Epic (epic)
-Status: backlog
-</current_work>
-<project_summary>
-Not yet set
-</project_summary>
-<project_state>
-internal - Internal (team only, staging/preview - no external users)
-</project_state>
-<mission>
-undefined
-</mission>
-<tech_stack>
-Node.js, Jest
-</tech_stack>
-</claude_context>
-<jettypod_essentials>
-JettyPod: Structured workflow system with skills that guide complex workflows.
-
-## ⚠️ CRITICAL: Skills are MANDATORY for workflows
-Skills auto-activate and MUST complete their full workflow:
-- epic-planning: Guides architectural decisions
-- feature-planning: Guides UX discovery + BDD scenarios
-- speed-mode: Implements happy path, THEN auto-generates stable chores
-- stable-mode: Adds error handling to speed implementation
-- external-transition: Guides launch preparation
-
-❌ DO NOT bypass skills by manually running commands halfway through
-❌ DO NOT mark work complete until skill finishes its ENTIRE workflow
-❌ DO NOT manually create chores when a skill should generate them
-✅ ALWAYS let skills complete autonomously before taking manual actions
-
-## Basic Commands (for non-workflow operations)
-jettypod work create epic "<title>"
-jettypod work create feature "<title>" --parent=<id>
-jettypod work start <id>
-jettypod work status <id> cancelled
-jettypod backlog
-
-## Advanced Commands
-For mode management, decisions, project state: docs/COMMAND_REFERENCE.md
-</jettypod_essentials>
-
-<communication_style>
-Be direct and opinionated. Skip hedging, apologies, and excessive politeness. Lead with the main point, challenge flawed ideas, give honest assessments even if unwelcome. Respond to what's literally asked, not what's "helpful". Prioritize brevity and practical utility over comprehensiveness.
-</communication_style>