wogiflow 1.0.41 → 1.0.42

package/package.json

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

package/scripts/flow-bug.js

@@ -27,6 +27,8 @@ const {
   outputJson,
   getConfig,
   getConfigValue,
+  safeJsonParse,
+  withLock,
   color,
   success,
   warn,
@@ -126,7 +128,7 @@ ${discoveredFrom ? `- Discovered while working on: ${discoveredFrom}` : ''}
 /**
  * Main function
  */
-function main() {
+async function main() {
   const { flags, positional } = parseFlags(process.argv.slice(2));
 
   // Handle help
@@ -215,12 +217,52 @@ Examples:
   const content = createBugContent(bug);
   writeFile(bugPath, content);
 
+  // v4.2: Add bug to ready.json so it can be started with /wogi-start
+  let addedToReady = false;
+  try {
+    await withLock(PATHS.ready, async () => {
+      const ready = safeJsonParse(PATHS.ready, { ready: [], inProgress: [], completed: [] });
+
+      // Check if already exists (duplicate prevention)
+      const exists = ready.ready?.some(t => t.id === id) ||
+                     ready.inProgress?.some(t => t.id === id) ||
+                     ready.completed?.some(t => t.id === id);
+
+      if (!exists) {
+        if (!Array.isArray(ready.ready)) {
+          ready.ready = [];
+        }
+
+        ready.ready.push({
+          id,
+          title,
+          type: 'bug',
+          priority,
+          severity,
+          discoveredFrom,
+          status: 'ready',
+          createdAt,
+          specPath: bugPath
+        });
+
+        fs.writeFileSync(PATHS.ready, JSON.stringify(ready, null, 2), 'utf-8');
+        addedToReady = true;
+      }
+    });
+  } catch (lockErr) {
+    // Non-fatal: bug file was created, just couldn't add to ready.json
+    if (process.env.DEBUG) {
+      console.error(`[DEBUG] Could not add to ready.json: ${lockErr.message}`);
+    }
+  }
+
   // Output result
   if (flags.json) {
     outputJson({
       success: true,
       bug,
-      file: bugPath
+      file: bugPath,
+      addedToReady
     });
   } else {
     console.log('');
@@ -234,6 +276,12 @@ Examples:
       console.log(`Discovered from: ${color('yellow', discoveredFrom)}`);
     }
 
+    if (addedToReady) {
+      console.log('');
+      console.log(color('green', `✓ Added to ready.json`));
+      console.log(`Start with: ${color('cyan', `/wogi-start ${id}`)}`);
+    }
+
     console.log('');
     info('Edit the file to add description, steps to reproduce, etc.');
   }
@@ -241,7 +289,10 @@ Examples:
 
 // Run only when executed directly
 if (require.main === module) {
-  main();
+  main().catch(err => {
+    error(err.message);
+    process.exit(1);
+  });
 }
 
 module.exports = { main, createBugContent, getCurrentTask };

package/scripts/flow-start.js

@@ -156,17 +156,79 @@ function getRegistrySummary(registryPath, type) {
   return null;
 }
 
+/**
+ * Triage a request that isn't a task ID
+ * Outputs classification context for the agent (Claude) to decide what to do
+ * @param {string} prompt - The user's request
+ */
+function triageRequest(prompt) {
+  console.log('');
+  console.log(color('cyan', '━'.repeat(60)));
+  console.log(color('cyan', '  REQUEST TRIAGE'));
+  console.log(color('cyan', '━'.repeat(60)));
+  console.log('');
+  console.log(`Request: "${prompt}"`);
+  console.log('');
+  console.log(color('yellow', 'Decide based on your understanding:'));
+  console.log('');
+  console.log(color('green', 'OPERATIONAL') + ' (execute directly, no task needed):');
+  console.log('  - Version control: push, pull, fetch, merge, commit');
+  console.log('  - Publishing: deploy, publish to any platform');
+  console.log('  - Build/CI: run tests, build, lint, format');
+  console.log('  - Maintenance: update deps, bump version');
+  console.log('  - Reviews: code review, check something');
+  console.log('');
+  console.log(color('yellow', 'SMALL FIX') + ' (execute + log for learning):');
+  console.log('  - Trivial changes: typo, color, text');
+  console.log('  - Single line changes');
+  console.log('  - No behavioral change');
+  console.log('');
+  console.log(color('red', 'IMPLEMENTATION') + ' (create task first):');
+  console.log('  - New features: add, create, build');
+  console.log('  - Bug fixes: fix errors, resolve issues');
+  console.log('  - Refactoring: restructure, reorganize');
+  console.log('');
+  console.log(color('cyan', '━'.repeat(60)));
+  console.log('');
+  console.log(color('dim', 'Based on your classification:'));
+  console.log(`  ${color('green', 'OPERATIONAL')} → Proceed with the request directly`);
+  console.log(`  ${color('yellow', 'SMALL FIX')} → Execute, then add to request-log.md with #quick-fix tag`);
+  console.log(`  ${color('red', 'IMPLEMENTATION')} → Use /wogi-bug or /wogi-story first`);
+  console.log('');
+
+  // Return triage mode indicator for programmatic use
+  return {
+    triageMode: true,
+    prompt,
+    awaitingClassification: true
+  };
+}
+
 async function main() {
-  const taskId = process.argv[2];
+  const taskIdArg = process.argv[2];
   const forceResume = process.argv.includes('--force-resume');
   const skipSuspensionCheck = process.argv.includes('--skip-suspension');
   const usePhasedMode = process.argv.includes('--phased');
 
-  if (!taskId) {
+  if (!taskIdArg) {
     console.log('Usage: flow start <task-id> [--force-resume] [--skip-suspension] [--phased]');
+    console.log('       flow start "<request>" - Triage a request (agent decides)');
     process.exit(1);
   }
 
+  // v4.2: Check if this is a quoted request or non-task-ID input
+  // Task IDs match pattern: wf-XXXXXXXX (hex hash)
+  const isTaskId = /^wf-[a-f0-9]+$/i.test(taskIdArg);
+
+  if (!isTaskId) {
+    // This is a quoted request, not a task ID - run triage
+    const prompt = taskIdArg.replace(/^["']|["']$/g, ''); // Remove surrounding quotes if any
+    triageRequest(prompt);
+    process.exit(0);
+  }
+
+  const taskId = taskIdArg;
+
   // v1.7.0: Check for session resume context
   const config = getConfig();
   if (config.sessionState?.autoRestore !== false) {

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

@@ -278,15 +278,41 @@ function checkImplementationGate(options = {}) {
     };
   }
 
-  // Route through /wogi-start instead of blocking
-  // /wogi-start will intelligently decide: execute directly (operational) or create story (implementation)
+  // v4.2: Block and route through /wogi-start
+  // /wogi-start will triage: operational (execute directly), small fix (execute + log), or implementation (create task)
+  const config = getConfig();
+  const mode = config.hooks?.rules?.implementationGate?.mode || 'block';
+
+  if (mode === 'off') {
+    return {
+      allowed: true,
+      blocked: false,
+      message: null,
+      reason: 'gate_mode_off'
+    };
+  }
+
+  if (mode === 'warn') {
+    return {
+      allowed: true,
+      blocked: false,
+      message: generateRoutingMessage(prompt),
+      reason: 'route_to_wogi_start',
+      confidence,
+      suggestedAction: 'wogi-start',
+      matches
+    };
+  }
+
+  // Default: mode === 'block' - strict enforcement
   return {
-    allowed: true,
-    blocked: false,
-    message: generateRoutingMessage(prompt),
+    allowed: false,
+    blocked: true,
+    message: generateBlockingMessage(prompt),
     reason: 'route_to_wogi_start',
     confidence,
     suggestedAction: 'wogi-start',
+    suggestedCommand: `/wogi-start "${truncatePrompt(prompt)}"`,
     matches
   };
 }
@@ -323,6 +349,22 @@ function generateBlockMessage(prompt) {
   return generateRoutingMessage(prompt);
 }
 
+/**
+ * Generate blocking message (v4.2 strict enforcement)
+ * This message appears when implementation is detected without active task
+ */
+function generateBlockingMessage(prompt) {
+  return `Implementation request detected without active task.
+
+To proceed, run:
+  /wogi-start "${truncatePrompt(prompt)}"
+
+WogiFlow will triage and decide:
+- If operational (git/npm/deploy) → execute directly
+- If small fix → execute + log for learning
+- If larger task → create story/bug first`;
+}
+
 module.exports = {
   isImplementationGateEnabled,
   isSoftModeEnabled,
@@ -333,6 +375,7 @@ module.exports = {
   generateWarningMessage,
   generateRoutingMessage,
   generateBlockMessage,
+  generateBlockingMessage,
   truncatePrompt,
   IMPLEMENTATION_PATTERNS,
   EXPLORATION_PATTERNS