odd-studio 3.3.8 → 3.4.0

package/bin/odd-studio.js

@@ -15,7 +15,7 @@ import { registerUninstall } from './commands/uninstall.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const require = createRequire(import.meta.url);
-const pkg = require('../package.json'); // v3.3.8
+const pkg = require('../package.json'); // v3.4.0
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const deps = { PACKAGE_ROOT, print };

package/codex-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "odd-studio",
-  "version": "3.3.8",
+  "version": "3.4.0",
   "description": "Outcome-Driven Development planning and build harness for domain experts building serious software with AI.",
   "author": {
     "name": "ODD Studio"

package/hooks/odd-studio.sh

@@ -165,7 +165,13 @@ swarm-write)
   fi
 
   # Gate 2: Agent token must exist (short-lived, created by Task agents)
+  # Exception: allow the main conversation to write config/infrastructure files
+  # (package.json, .env, drizzle.config, tsconfig, etc.) during project setup
   if ! marker_valid ".odd/.odd-flow-agent-token" 120; then
+    # Allow config and infrastructure files without agent token
+    if echo "$FILE_PATH" | grep -qE '(package\.json|\.env|tsconfig|next\.config|postcss\.config|tailwind\.config|drizzle\.config|vitest\.config|eslint\.config|\.gitignore|docker-compose|Dockerfile|vercel\.config|vercel\.ts)'; then
+      exit 0
+    fi
     echo "ODD STUDIO [swarm-write]: Source writes blocked — no agent token." >&2
     echo "Source code must be written by Task agents, not the main conversation." >&2
     echo "Task agents run: touch .odd/.odd-flow-agent-token before writing." >&2
@@ -225,7 +231,7 @@ confirm-gate)
   NEW_CONTENT=$(echo "$INPUT" | jq -r '.tool_input.new_string // .tool_input.content // empty')
   echo "$NEW_CONTENT" | grep -qE '"briefConfirmed"\s*:\s*true' || exit 0
 
-  if [ ! -f ".odd/.odd-flow-brief-stored" ]; then
+  if [ ! -f ".odd/.odd-flow-brief-stored" ] && [ ! -f ".odd/.odd-flow-state-ready" ]; then
     echo "ODD STUDIO [confirm-gate]: Brief not stored in odd-flow memory. Store it first." >&2
     exit 2
   fi
@@ -331,6 +337,47 @@ session-save)
   exit 0
   ;;
 
+# ─────────────────────────────────────────────────────────────────────────────
+# PostToolUse: Write|Edit state.json — blocks phase transition without Steps 9, 9b, 9d
+# ─────────────────────────────────────────────────────────────────────────────
+plan-complete-gate)
+  [ "$TOOL_NAME" = "Write" ] || [ "$TOOL_NAME" = "Edit" ] || exit 0
+
+  # Only intercept writes to state.json
+  echo "$FILE_PATH" | grep -q 'state\.json' || exit 0
+
+  # Check if new content changes currentPhase to "build"
+  NEW_CONTENT=$(echo "$INPUT" | jq -r '.tool_input.new_string // .tool_input.content // empty')
+  echo "$NEW_CONTENT" | grep -qE '"currentPhase"[[:space:]]*:[[:space:]]*"build"' || exit 0
+
+  # Verify all planning steps are complete
+  TECH_STACK=$(echo "$NEW_CONTENT" | grep -oE '"techStackDecided"[[:space:]]*:[[:space:]]*(true|false)' | grep -c 'true' || echo 0)
+  DESIGN=$(echo "$NEW_CONTENT" | grep -oE '"designApproachDecided"[[:space:]]*:[[:space:]]*(true|false)' | grep -c 'true' || echo 0)
+  ARCH_DOC=$(echo "$NEW_CONTENT" | grep -oE '"architectureDocGenerated"[[:space:]]*:[[:space:]]*(true|false)' | grep -c 'true' || echo 0)
+
+  if [ "$TECH_STACK" -eq 0 ] || [ "$DESIGN" -eq 0 ] || [ "$ARCH_DOC" -eq 0 ]; then
+    echo "" >&2
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" >&2
+    echo "ODD STUDIO [plan-complete-gate]: PHASE TRANSITION BLOCKED" >&2
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" >&2
+    echo "" >&2
+    echo "  Cannot transition to build phase without completing planning:" >&2
+    echo "" >&2
+    [ "$TECH_STACK" -eq 0 ] && echo "  ❌ Step 9:  Technical architecture not decided (techStackDecided)" >&2
+    [ "$DESIGN" -eq 0 ] && echo "  ❌ Step 9b: Design approach not decided (designApproachDecided)" >&2
+    [ "$ARCH_DOC" -eq 0 ] && echo "  ❌ Step 9d: Architecture docs not generated (architectureDocGenerated)" >&2
+    echo "" >&2
+    echo "  Run *plan to continue with Rachel (Step 9, 9b, 9d)." >&2
+    echo "" >&2
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" >&2
+    echo "" >&2
+    exit 2
+  fi
+
+  # All checks passed — allow the transition
+  exit 0
+  ;;
+
 # ─────────────────────────────────────────────────────────────────────────────
 # PostToolUse: mcp__odd-flow__memory_store — creates ready marker
 # ─────────────────────────────────────────────────────────────────────────────
@@ -339,13 +386,20 @@ store-validate)
   [ "$CURRENT_PHASE" = "build" ] || exit 0
 
   KEY=$(echo "$INPUT" | jq -r '.tool_input.key // empty')
-  [ "$KEY" = "odd-project-state" ] || exit 0
 
   SUCCESS=$(echo "$INPUT" | jq -r '.tool_response.success // false' 2>/dev/null || echo "false")
   [ "$SUCCESS" = "true" ] || exit 0
 
-  touch .odd/.odd-flow-state-ready 2>/dev/null
-  rm -f .odd/.odd-flow-state-dirty 2>/dev/null
+  # Create the right marker based on what was stored
+  case "$KEY" in
+    odd-project-state)
+      touch .odd/.odd-flow-state-ready 2>/dev/null
+      rm -f .odd/.odd-flow-state-dirty 2>/dev/null
+      ;;
+    odd-session-brief-*)
+      touch .odd/.odd-flow-brief-stored 2>/dev/null
+      ;;
+  esac
   exit 0
   ;;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odd-studio",
-  "version": "3.3.8",
+  "version": "3.4.0",
   "description": "Outcome-Driven Development for AI coding agents — a planning and build harness for domain experts building serious software with AI. Works with Claude Code, OpenCode, and Codex.",
   "keywords": [
     "claude-code",

package/scripts/setup-hooks.js

@@ -50,6 +50,20 @@ const GATES = [
     ],
   },
   // ── PostToolUse ─────────────────────────────────────────────────────────
+  {
+    event: 'PostToolUse',
+    matcher: 'Write',
+    gates: [
+      { name: 'plan-complete-gate', timeout: 5, status: 'ODD plan complete gate...' },
+    ],
+  },
+  {
+    event: 'PostToolUse',
+    matcher: 'Edit',
+    gates: [
+      { name: 'plan-complete-gate', timeout: 5, status: 'ODD plan complete gate...' },
+    ],
+  },
   {
     event: 'PostToolUse',
     matcher: 'Bash',

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "odd"
-version: "3.3.8"
+version: "3.4.0"
 description: "Outcome-Driven Development planning and build coach. Use /odd to start or resume an ODD project — building personas, writing outcomes, mapping contracts, creating a Master Implementation Plan, and directing a odd-flow-powered build. Designed for domain experts who are not developers. Works with Claude Code, OpenCode, and Codex."
 metadata:
   priority: 10
@@ -96,7 +96,7 @@ Display this when no existing state is found:
 
 ---
 
-Welcome to ODD Studio v3.3.8.
+Welcome to ODD Studio v3.4.0.
 
 You are about to plan and build something real — using a methodology called Outcome-Driven Development. Before we write a single line of code, we are going to get precise about three things:
 
@@ -120,7 +120,7 @@ Display this when existing state is found. Replace the bracketed values with act
 
 ---
 
-Welcome back to ODD Studio v3.3.8.
+Welcome back to ODD Studio v3.4.0.
 
 **Project:** [project.name]
 **Current Phase:** [state.currentPhase]