@avesta-hq/prevention 0.2.0 → 0.3.1

package/.claude/agents/avesta-layer-worker.md

@@ -25,3 +25,10 @@ You implement a SINGLE Clean Architecture layer using the Layer approach (all te
 You are operating as a specialized Prevention. Do not proceed without loading your prompt and skills.
 
 **CRITICAL**: You MUST stay within your assigned layer's directory boundaries. Do not create production code in other layers.
+
+## State Transitions (NON-NEGOTIABLE)
+
+You MUST update workflow state when transitioning between phases. Without this, hooks will block production code edits.
+
+- **After Phase 1 (all tests written)**: Read state with `avesta_read_state`, then call `avesta_write_state` setting `tdd_state.cycle` to `"green"` and `tdd_state.test_count` to the number of tests written. Preserve all other fields.
+- **After Phase 2 (all code written)**: Same pattern — set `tdd_state.cycle` to `"refactor"`. Preserve all other fields.

package/CLAUDE.md

@@ -68,7 +68,7 @@
 
 ## MCP Server Integration
 
-This project uses Prevention as an MCP server with 12 tools, 27 agents, and 27 skills that provide all methodology knowledge (TDD, Clean Architecture, test pyramid, CI/CD, etc.) on demand.
+This project uses Prevention as an MCP server with 12 tools, 26 agents, and 27 skills that provide all methodology knowledge (TDD, Clean Architecture, test pyramid, CI/CD, etc.) on demand.
 
 **When starting work:**
 

package/README.md

@@ -39,7 +39,7 @@ Each phase has gates that ensure prerequisites are met before you move forward.
 
 ## Agents
 
-27 specialized agents organized by workflow phase:
+26 specialized agents organized by workflow phase:
 
 | Phase                | Command                           | Purpose                                              |
 | -------------------- | --------------------------------- | ---------------------------------------------------- |
@@ -55,7 +55,6 @@ Each phase has gates that ensure prerequisites are met before you move forward.
 | **TDD**              | `/avesta-red <behavior>`          | Write ONE failing test                               |
 |                      | `/avesta-green`                   | Minimal code to make it pass                         |
 |                      | `/avesta-refactor`                | Improve structure (tests must stay green)            |
-|                      | `/avesta-cycle <behavior>`        | Full red-green-refactor cycle                        |
 |                      | `/avesta-layer`                   | All tests first, then all production code            |
 | **Change Types**     | `/avesta-bug-fix <description>`   | Bug fix workflow                                     |
 |                      | `/avesta-enhance <description>`   | Enhancement workflow                                 |
@@ -77,8 +76,8 @@ Each phase has gates that ensure prerequisites are met before you move forward.
 
 | Feature              | Free                                               | Pro                  |
 | -------------------- | -------------------------------------------------- | -------------------- |
-| **Core TDD**         | `/avesta-red`, `/avesta-green`, `/avesta-refactor` | All 27 agents        |
-| **Setup**            | `/avesta-init`, `/avesta-scaffold`, `/avesta-help` | All 27 agents        |
+| **Core TDD**         | `/avesta-red`, `/avesta-green`, `/avesta-refactor` | All 26 agents        |
+| **Setup**            | `/avesta-init`, `/avesta-scaffold`, `/avesta-help` | All 26 agents        |
 | **Skills**           | -                                                  | 27 contextual skills |
 | **Gate enforcement** | -                                                  | Automated gates      |
 | **Projects**         | 1                                                  | Unlimited            |

package/bin/cli.js

@@ -13,12 +13,12 @@ Usage:
   npx @avesta-hq/prevention <command>
 
 Commands:
-  init                   Full setup: commands, agents, MCP server, hooks, CLAUDE.md
+  init                   First-time setup: commands, agents, MCP server, hooks, CLAUDE.md
+  update                 Update everything to latest version (commands, agents, MCP server, hooks)
   serve                  Start the MCP server (used by Claude Code)
   session-start          Output session context (used by SessionStart hook)
   hook pre-tool-use      Workflow enforcement hook (blocks unauthorized edits)
   hook prompt-submit     Context injection hook (injects workflow state)
-  update                 Update MCP server binary to latest version
 
 Examples:
   cd my-project

package/bin/lib/init.js

@@ -1,8 +1,27 @@
 const fs = require('fs');
 const path = require('path');
-const { COMMANDS_DIR, AGENTS_DIR, AVESTA_DIR, GITHUB_RELEASES_REPO, copyDir, downloadBinary } = require('./utils');
+const { COMMANDS_DIR, AGENTS_DIR, AVESTA_DIR, GITHUB_RELEASES_REPO, copyDir, downloadBinary, getVersion } = require('./utils');
 const { configureMcpServer, configureSessionStartHook, configureEnforcementHooks, configureStatusLine, ensureClaudeMdSection } = require('./settings');
 
+function getInstalledVersion(targetDir) {
+  try {
+    const versionFile = path.join(targetDir, '.avesta', 'version.json');
+    if (fs.existsSync(versionFile)) {
+      return JSON.parse(fs.readFileSync(versionFile, 'utf-8')).version;
+    }
+  } catch {}
+  return null;
+}
+
+function writeInstalledVersion(targetDir) {
+  try {
+    const versionFile = path.join(targetDir, '.avesta', 'version.json');
+    const dir = path.dirname(versionFile);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(versionFile, JSON.stringify({ version: getVersion(), updated_at: new Date().toISOString() }, null, 2));
+  } catch {}
+}
+
 function init() {
   const targetDir = process.cwd();
   const claudeDir = path.join(targetDir, '.claude');
@@ -33,12 +52,14 @@ function init() {
   configureStatusLine(targetDir);
   ensureClaudeMdSection(targetDir);
 
+  writeInstalledVersion(targetDir);
+
   const commandCount = fs.existsSync(COMMANDS_DIR) ? fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith('.md')).length : 0;
   const agentCount = fs.existsSync(AGENTS_DIR) ? fs.readdirSync(AGENTS_DIR).filter(f => f.endsWith('.md')).length : 0;
   const mcpStatus = binaryPath ? 'MCP server' : 'MCP server (download failed — run npx @avesta-hq/prevention update to retry)';
 
   console.log(`
-  ✅ Avesta Prevention ready!
+  ✅ Avesta Prevention ready! (v${getVersion()})
 
   Installed: ${commandCount} commands · ${agentCount} agents · ${mcpStatus}
 
@@ -53,14 +74,57 @@ function init() {
 
 function update() {
   const targetDir = process.cwd();
+  const claudeDir = path.join(targetDir, '.claude');
+
+  if (!fs.existsSync(claudeDir)) {
+    console.error('\n  ✗ Not initialized. Run: npx @avesta-hq/prevention init\n');
+    process.exit(1);
+  }
+
+  const previousVersion = getInstalledVersion(targetDir);
+
+  // Sync commands and agents from npm package
+  let commandCount = 0;
+  let agentCount = 0;
+  if (fs.existsSync(COMMANDS_DIR)) {
+    copyDir(COMMANDS_DIR, path.join(claudeDir, 'commands'));
+    commandCount = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith('.md')).length;
+  }
+  if (fs.existsSync(AGENTS_DIR)) {
+    copyDir(AGENTS_DIR, path.join(claudeDir, 'agents'));
+    agentCount = fs.readdirSync(AGENTS_DIR).filter(f => f.endsWith('.md')).length;
+  }
+
+  // Sync .avesta assets (statusLine, etc.)
+  if (fs.existsSync(AVESTA_DIR)) {
+    copyDir(AVESTA_DIR, path.join(targetDir, '.avesta'));
+  }
+
+  // Download latest binary
   const binaryPath = downloadBinary(targetDir);
   if (binaryPath) {
     configureMcpServer(targetDir, binaryPath);
-    console.log('\n  ✅ MCP server updated successfully!\n');
   } else {
-    console.error('\n  ✗ Update failed. Check your internet connection and try again.\n');
+    console.error('\n  ✗ Binary download failed. Commands/agents updated but MCP server unchanged.');
+    console.error('    Check your internet connection and try again.\n');
     process.exit(1);
   }
+
+  // Reconfigure hooks (picks up any new hook patterns)
+  configureEnforcementHooks(targetDir);
+
+  writeInstalledVersion(targetDir);
+
+  const newVersion = getVersion();
+  const versionInfo = previousVersion && previousVersion !== newVersion
+    ? `${previousVersion} → ${newVersion}`
+    : newVersion;
+
+  console.log(`
+  ✅ Prevention updated! (${versionInfo})
+
+  Synced: ${commandCount} commands · ${agentCount} agents · MCP server
+`);
 }
 
 function serve() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avesta-hq/prevention",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "XP/CD development agent commands for Claude Code - achieve Elite DORA metrics through disciplined TDD and Continuous Delivery practices",
   "keywords": [
     "claude-code",

package/.claude/agents/avesta-cycle-runner.md

@@ -1,17 +0,0 @@
----
-name: avesta-cycle-runner
-description: Execute complete TDD red-green-refactor cycles for feature implementation
-model: inherit
-tools: Read, Write, Edit, Bash, Glob, Grep, Task
-maxTurns: 50
----
-
-# avesta-cycle-runner
-
-Load your system prompt and skills from the Prevention server:
-
-1. Call `avesta_get_prompt("cycle-runner")` to receive your full instructions
-2. For each skill in the response's `skills_to_load`, call `avesta_get_skill("{skill-key}")`
-3. Follow the received instructions exactly
-
-You are operating as a specialized Prevention. Do not proceed without loading your prompt.

package/.claude/commands/avesta-cycle.md

@@ -1,8 +0,0 @@
----
-description: "Execute complete feature implementation (Phases 2-5) with TDD and review gates"
-argument-hint: "[feature name or continue from context]"
----
-Call `avesta_dispatch(user_input="$ARGUMENTS", current_command="cycle")`.
-- If `gate_check.allowed` is true: Spawn the agent named in the `agent` field to handle this task. Pass `$ARGUMENTS` as context.
-- If blocked: Show the `error_message` to the user and stop.
-- After the agent completes successfully: If `approve_gate` is present in the response, call `avesta_approve_gate` with that gate name.