odd-studio 3.3.7 → 3.3.9

package/README.md

@@ -27,22 +27,19 @@ ODD Studio is the companion tool to **The ODD Way to Build Software with Agentic
 Add the following into Terminal inside your project folder, NOT your system root folder.
 
 ```bash
-npx odd-studio init my-project
-cd my-project
+npx odd-studio init
 ```
 
 ### For OpenCode (with Ollama / local models)
 
 ```bash
-npx odd-studio init my-project --agent opencode
-cd my-project
+npx odd-studio init --agent opencode
 ```
 
 ### For Codex
 
 ```bash
-npx odd-studio init my-project --agent codex
-cd my-project
+npx odd-studio init --agent codex
 ```
 
 In Codex, start ODD with a natural-language kickoff such as `use ODD`, `start ODD`, or `begin ODD`.
@@ -58,15 +55,13 @@ npx odd-studio upgrade --agent codex
 ### For Claude Code and OpenCode on the same machine
 
 ```bash
-npx odd-studio init my-project --agent both
-cd my-project
+npx odd-studio init --agent both
 ```
 
 ### For every supported agent on the same machine
 
 ```bash
-npx odd-studio init my-project --agent all
-cd my-project
+npx odd-studio init --agent all
 ```
 
 Everything is installed into your project folder. Nothing is written to your home directory or installed globally.
@@ -228,7 +223,7 @@ The AI proposes the stack based on your outcomes. You approve it based on conseq
 
 ## Project structure
 
-After `npx odd-studio init my-project`, your project looks like this:
+After `npx odd-studio init`, your project looks like this:
 
 ```
 my-project/
@@ -325,7 +320,6 @@ npx odd-studio export                    # Instructions for exporting the Sessio
 Run from inside your existing ODD project:
 
 ```bash
-cd my-project
 npx odd-studio@latest upgrade
 ```
 

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.7
+const pkg = require('../package.json'); // v3.3.9
 
 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.7",
+  "version": "3.3.9",
   "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

@@ -331,6 +331,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
 # ─────────────────────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odd-studio",
-  "version": "3.3.7",
+  "version": "3.3.9",
   "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.7"
+version: "3.3.9"
 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.7.
+Welcome to ODD Studio v3.3.9.
 
 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.7.
+Welcome back to ODD Studio v3.3.9.
 
 **Project:** [project.name]
 **Current Phase:** [state.currentPhase]