wogiflow 1.5.3 → 1.5.5

package/.workflow/templates/claude-md.hbs

@@ -305,6 +305,25 @@ You: [edits header.tsx]  ← Tracked properly
 ```
 
 **When in doubt, use `/wogi-start`.** It will route appropriately.
+
+### When a Tool Call Is Blocked by the Routing Gate
+
+If you attempt to use Bash or EnterPlanMode and receive a "BLOCKED" denial from WogiFlow's routing gate, here is the ONLY correct response:
+
+1. **Invoke `/wogi-start`** immediately with the user's original request:
+   ```
+   Skill(skill="wogi-start", args="<the user's original request>")
+   ```
+2. `/wogi-start` will classify the request and clear the routing gate
+3. After `/wogi-start` routes the request, you can use Bash/EnterPlanMode normally
+
+**NEVER do these when blocked:**
+- Suggest the user run commands manually in their terminal
+- Try alternative tools to work around the block
+- Explain the block to the user and ask them what to do
+- Give up and say "I can't do that"
+
+The routing gate exists because EVERY request must be classified by `/wogi-start` first. The block is not an error — it's a reminder that you skipped a mandatory step. Fix it by invoking `/wogi-start`.
 {{/if}}
 
 ## Session Startup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wogiflow",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "description": "AI-powered development workflow management system with multi-model support",
   "main": "lib/index.js",
   "bin": {

package/scripts/hooks/core/routing-gate.js

@@ -188,11 +188,21 @@ function checkRoutingGate(toolName) {
   }
 
   // Block: routing is pending and no active task
+  // NOTE: This message is shown to the AI as permissionDecisionReason.
+  // It must be prescriptive enough that the AI invokes /wogi-start instead of
+  // trying workarounds or suggesting the user run commands manually.
   return {
     allowed: false,
     blocked: true,
     reason: 'routing_pending',
-    message: 'Route through a /wogi-* command first. Use /wogi-start to route your request.'
+    message: [
+      'BLOCKED: You must route through /wogi-start before using Bash or EnterPlanMode.',
+      'ACTION REQUIRED: Invoke the Skill tool with skill="wogi-start" and pass the user\'s request as args.',
+      'Example: Skill(skill="wogi-start", args="<the user\'s original request>")',
+      '/wogi-start will classify the request (operational, exploration, implementation) and unblock the appropriate tools.',
+      'Do NOT suggest the user run commands manually in their terminal.',
+      'Do NOT try alternative approaches to bypass this gate.'
+    ].join(' ')
   };
 }
 

package/scripts/hooks/entry/claude-code/user-prompt-submit.js

@@ -119,13 +119,22 @@ async function main() {
     // v6.0: Set routing-pending flag for routing gate enforcement
     // This blocks Bash calls until a /wogi-* skill is invoked
     // Skipped when an active task exists (follow-ups during tracked work are allowed)
-    try {
-      setRoutingPending();
-    } catch (err) {
-      // Non-blocking - don't fail the hook if routing gate fails (fail-open)
-      if (process.env.DEBUG) {
-        console.error(`[Hook] Routing gate set failed: ${err.message}`);
+    // v6.1: Also skip when the prompt IS a /wogi-* command — the user is already routing.
+    // When users type "/wogi-start ..." directly, Claude Code expands the skill inline
+    // (not through the Skill tool), so clearRoutingPending() in PreToolUse never fires.
+    // Setting the flag here would create an uncleable block.
+    const isWogiCommand = typeof prompt === 'string' && /^\/(wogi-\S+)/i.test(prompt.trim());
+    if (!isWogiCommand) {
+      try {
+        setRoutingPending();
+      } catch (err) {
+        // Non-blocking - don't fail the hook if routing gate fails (fail-open)
+        if (process.env.DEBUG) {
+          console.error(`[Hook] Routing gate set failed: ${err.message}`);
+        }
       }
+    } else if (process.env.DEBUG) {
+      console.error(`[Hook] Skipping routing flag — prompt is a /wogi-* command`);
     }
 
     // Check research gate first (before implementation gate)

package/scripts/postinstall.js

@@ -270,6 +270,24 @@ function copyScriptsFromPackage() {
   }
 }
 
+/**
+ * Copy WogiFlow-managed .workflow/ subdirectories from package to project
+ * These are package-owned (bridges, templates, agents) and always overwritten on update.
+ * Without this, `npx flow bridge sync` fails because .workflow/bridges/ doesn't exist.
+ */
+function copyWorkflowManagedDirs() {
+  const managedDirs = ['bridges', 'templates', 'agents'];
+
+  for (const subdir of managedDirs) {
+    const src = path.join(PACKAGE_ROOT, '.workflow', subdir);
+    const dest = path.join(WORKFLOW_DIR, subdir);
+
+    if (fs.existsSync(src)) {
+      copyDir(src, dest, false);
+    }
+  }
+}
+
 /**
  * Check if we should be completely silent (CI only)
  */
@@ -301,6 +319,11 @@ function main() {
   // This ensures scripts are updated when running npm install/update
   copyScriptsFromPackage();
 
+  // Copy WogiFlow-managed .workflow/ subdirectories (bridges, templates, agents)
+  // These are needed for bridge sync, CLAUDE.md generation, and agent definitions.
+  // Always overwrite — these are package-managed, not user-customizable.
+  copyWorkflowManagedDirs();
+
   // Create marker for AI to detect (unless already initialized)
   createPendingSetupMarker();