wogiflow 2.4.2 → 2.4.3

package/scripts/hooks/entry/shared/hook-runner.js

@@ -0,0 +1,99 @@
+/**
+ * Wogi Flow - Shared Hook Runner
+ *
+ * Wraps the common boilerplate shared across hook entry files:
+ * stdin reading, JSON parsing, adapter invocation, error handling, output formatting.
+ *
+ * Usage:
+ *   const { runHook } = require('../shared/hook-runner');
+ *   runHook('SessionEnd', async ({ input, parsedInput }) => {
+ *     const result = handleSessionEnd(parsedInput);
+ *     return result;
+ *   }, { failMode: 'silent' });
+ *
+ * @param {string} eventName - Hook event name (e.g., 'SessionEnd', 'PostCompact')
+ * @param {Function} handler - Async function receiving { input, parsedInput, raw }
+ *   Must return a result object for claudeCodeAdapter.transformResult()
+ * @param {object} [options]
+ * @param {'silent'|'warn'|'block'} [options.failMode='silent']
+ *   - 'silent': swallow errors, output { continue: true }
+ *   - 'warn': log to stderr, output { continue: true }
+ *   - 'block': log to stderr, output deny/block result
+ * @param {boolean} [options.useStdoutWrite=false] - Use process.stdout.write instead of console.log
+ * @param {boolean} [options.skipAdapter=false] - If true, handler returns raw output (no adapter transform)
+ * @param {object} [options.failOutput] - Custom error output object (overrides default error response)
+ */
+
+const { readHookInput } = require('./read-stdin');
+const { claudeCodeAdapter } = require('../../adapters/claude-code');
+
+async function runHook(eventName, handler, { failMode = 'silent', useStdoutWrite = false, skipAdapter = false, failOutput = null } = {}) {
+  const write = useStdoutWrite
+    ? (data) => process.stdout.write(data)
+    : (data) => console.log(data);
+
+  process.stdin.setEncoding('utf8');
+
+  try {
+    const { input, raw } = await readHookInput();
+    const parsedInput = input ? claudeCodeAdapter.parseInput(input) : {};
+
+    const result = await handler({ input: input ?? {}, parsedInput, raw });
+
+    // Handler can return { __raw: true, ...payload } to bypass adapter transform
+    if (result && result.__raw) {
+      const { __raw, ...payload } = result;
+      write(JSON.stringify(payload));
+    } else if (skipAdapter) {
+      write(JSON.stringify(result));
+    } else {
+      const output = claudeCodeAdapter.transformResult(eventName, result);
+      write(JSON.stringify(output));
+    }
+    process.exit(0);
+  } catch (err) {
+    const errorOutput = failOutput ?? { continue: true };
+
+    if (failMode === 'silent') {
+      // Swallow error, allow through
+      write(JSON.stringify(errorOutput));
+      process.exit(0);
+    } else if (failMode === 'warn') {
+      // Log error, allow through
+      if (process.env.DEBUG) {
+        console.error(`[${eventName}] Hook error: ${err.message}`);
+      }
+      try {
+        const { logHookError } = require('../../../flow-hook-errors');
+        logHookError(eventName, err, { failMode: 'open', operation: eventName.toLowerCase() });
+      } catch (_logErr) {
+        console.error(`[WogiFlow] ${eventName} hook error: ${err.message}`);
+      }
+      write(JSON.stringify(errorOutput));
+      process.exit(0);
+    } else if (failMode === 'block') {
+      // Log error, deny/block
+      if (process.env.DEBUG) {
+        console.error(`[${eventName}] Hook error (blocking): ${err.message}`);
+      } else {
+        console.error(`[Wogi Flow Hook] Validation error occurred`);
+      }
+      const blockOutput = failOutput ?? {
+        continue: true,
+        hookSpecificOutput: {
+          hookEventName: eventName,
+          permissionDecision: 'deny',
+          permissionDecisionReason: `WogiFlow ${eventName} validation error. Please check your setup or use /wogi-start.`
+        }
+      };
+      write(JSON.stringify(blockOutput));
+      process.exit(0);
+    } else {
+      // Unknown failMode — default to silent behavior
+      write(JSON.stringify(errorOutput));
+      process.exit(0);
+    }
+  }
+}
+
+module.exports = { runHook };

package/scripts/hooks/entry/shared/read-stdin.js

@@ -1,5 +1,3 @@
-'use strict';
-
 const { safeJsonParseString } = require('../../../flow-utils');
 
 const MAX_STDIN_SIZE = 100 * 1024;

package/scripts/registries/api-registry.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * API Registry Plugin
  *

package/scripts/registries/component-registry.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Component Registry Plugin
  *
@@ -16,14 +14,12 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { getProjectRoot, getConfig, color, success, warn } = require('../flow-utils');
+const { getProjectRoot, getConfig, color, success, warn, PATHS } = require('../flow-utils');
 const { RegistryPlugin } = require('../flow-registry-manager');
 const { BaseScanner, PROJECT_ROOT } = require('../flow-scanner-base');
 const { info } = require('../flow-output');
 
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const STATE_DIR = path.join(WORKFLOW_DIR, 'state');
-const INDEX_PATH = path.join(STATE_DIR, 'component-index.json');
+const INDEX_PATH = path.join(PATHS.state, 'component-index.json');
 
 // ============================================================
 // Component Scanner (extends BaseScanner for directory walking)
@@ -284,13 +280,13 @@ class ComponentScanner extends BaseScanner {
 
   save() {
     this.prune();
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(PATHS.state, { recursive: true });
     fs.writeFileSync(INDEX_PATH, JSON.stringify(this.registry, null, 2));
     success(`Saved to ${path.relative(PROJECT_ROOT, INDEX_PATH)}`);
   }
 
   generateMap() {
-    const MAP_PATH = path.join(STATE_DIR, 'app-map.md');
+    const MAP_PATH = PATHS.appMap;
 
     // Check if app-map.md exists and has content
     let existing = '';
@@ -381,7 +377,7 @@ class ComponentScanner extends BaseScanner {
    */
   _mergeIntoAppMap(mapPath, existing) {
     // Path containment check (defense-in-depth)
-    if (!mapPath.startsWith(STATE_DIR)) {
+    if (!mapPath.startsWith(PATHS.state)) {
       warn('Write target outside state directory — skipping merge');
       return;
     }

package/scripts/registries/contract-scanner.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Contract Surface Scanner
  *
@@ -20,6 +18,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { execSync } = require('node:child_process');
+const { safeJsonParse } = require('../flow-io');
 
 const CONTRACT_SURFACE_VERSION = '1.0.0';
 
@@ -598,13 +597,7 @@ function detectProjectType(projectRoot) {
   }
 
   // Read package.json for dependency analysis
-  let pkg = {};
-  try {
-    const pkgContent = fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf-8');
-    pkg = JSON.parse(pkgContent);
-  } catch (err) {
-    // No package.json or invalid JSON
-  }
+  const pkg = safeJsonParse(path.join(projectRoot, 'package.json'), {});
 
   const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
 

package/scripts/registries/function-registry.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Function Registry Plugin
  *

package/scripts/registries/schema-registry.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Schema/Model Registry Plugin
  *
@@ -14,12 +12,10 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { RegistryPlugin } = require('../flow-registry-manager');
-const { getProjectRoot, safeJsonParse: safeJsonParseFile } = require('../flow-utils');
+const { getProjectRoot, safeJsonParse: safeJsonParseFile, PATHS } = require('../flow-utils');
 
-const PROJECT_ROOT = getProjectRoot();
-const STATE_DIR = path.join(PROJECT_ROOT, '.workflow', 'state');
-const INDEX_PATH = path.join(STATE_DIR, 'schema-index.json');
-const MAP_PATH = path.join(STATE_DIR, 'schema-map.md');
+const INDEX_PATH = path.join(PATHS.state, 'schema-index.json');
+const MAP_PATH = path.join(PATHS.state, 'schema-map.md');
 
 class SchemaRegistry extends RegistryPlugin {
   static id = 'schemas';
@@ -44,7 +40,7 @@ class SchemaRegistry extends RegistryPlugin {
     if (stack.orm) return true;
 
     // Check package.json for ORM packages
-    const pkgPath = path.join(PROJECT_ROOT, 'package.json');
+    const pkgPath = path.join(PATHS.root, 'package.json');
     if (fs.existsSync(pkgPath)) {
       try {
         const pkg = safeJsonParseFile(pkgPath, {});
@@ -57,7 +53,7 @@ class SchemaRegistry extends RegistryPlugin {
     }
 
     // Check for Django models (manage.py + models.py)
-    if (fs.existsSync(path.join(PROJECT_ROOT, 'manage.py'))) return true;
+    if (fs.existsSync(path.join(PATHS.root, 'manage.py'))) return true;
 
     return false;
   }
@@ -90,11 +86,11 @@ class SchemaRegistry extends RegistryPlugin {
     const before = this.models.length;
     this.models = this.models.filter(m => {
       if (!m.file) return true;
-      return fs.existsSync(path.join(PROJECT_ROOT, m.file));
+      return fs.existsSync(path.join(PATHS.root, m.file));
     });
     this.enums = this.enums.filter(e => {
       if (!e.file) return true;
-      return fs.existsSync(path.join(PROJECT_ROOT, e.file));
+      return fs.existsSync(path.join(PATHS.root, e.file));
     });
     const removed = before - this.models.length;
     if (removed > 0) {
@@ -106,7 +102,7 @@ class SchemaRegistry extends RegistryPlugin {
 
   save() {
     const index = this._buildIndex();
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(PATHS.state, { recursive: true });
     fs.writeFileSync(INDEX_PATH, JSON.stringify(index, null, 2));
   }
 
@@ -166,7 +162,7 @@ class SchemaRegistry extends RegistryPlugin {
 
     lines.push(`---\n*Auto-generated by Schema Registry — ${getTodayDate()}*\n`);
 
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(PATHS.state, { recursive: true });
     fs.writeFileSync(MAP_PATH, lines.join('\n'));
   }
 
@@ -179,8 +175,8 @@ class SchemaRegistry extends RegistryPlugin {
   // ============================================================
 
   _scanPrisma() {
-    const schemaDir = path.join(PROJECT_ROOT, 'prisma', 'schema');
-    const singleFile = path.join(PROJECT_ROOT, 'prisma', 'schema.prisma');
+    const schemaDir = path.join(PATHS.root, 'prisma', 'schema');
+    const singleFile = path.join(PATHS.root, 'prisma', 'schema.prisma');
 
     let files = [];
 
@@ -199,7 +195,7 @@ class SchemaRegistry extends RegistryPlugin {
     for (const file of files) {
       try {
         const content = fs.readFileSync(file, 'utf-8');
-        const relPath = path.relative(PROJECT_ROOT, file);
+        const relPath = path.relative(PATHS.root, file);
         this._parsePrismaFile(content, relPath);
       } catch (err) {
         // Skip unreadable files
@@ -327,7 +323,7 @@ class SchemaRegistry extends RegistryPlugin {
     const entityFiles = [];
 
     for (const dir of searchDirs) {
-      const fullDir = path.join(PROJECT_ROOT, dir);
+      const fullDir = path.join(PATHS.root, dir);
       if (fs.existsSync(fullDir)) {
         this._findTypeORMEntities(fullDir, entityFiles);
       }
@@ -340,7 +336,7 @@ class SchemaRegistry extends RegistryPlugin {
         // Use cached content from discovery phase to avoid N+1 reads
         const filePath = typeof entry === 'string' ? entry : entry.path;
         const content = typeof entry === 'string' ? fs.readFileSync(entry, 'utf-8') : entry.content;
-        const relPath = path.relative(PROJECT_ROOT, filePath);
+        const relPath = path.relative(PATHS.root, filePath);
         this._parseTypeORMFile(content, relPath);
       } catch (_err) {
         // Skip unreadable files

package/scripts/registries/service-registry.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Architecture/Service Registry Plugin
  *
@@ -15,12 +13,10 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { RegistryPlugin } = require('../flow-registry-manager');
-const { getProjectRoot, safeJsonParse: safeJsonParseFile } = require('../flow-utils');
+const { getProjectRoot, safeJsonParse: safeJsonParseFile, PATHS } = require('../flow-utils');
 
-const PROJECT_ROOT = getProjectRoot();
-const STATE_DIR = path.join(PROJECT_ROOT, '.workflow', 'state');
-const INDEX_PATH = path.join(STATE_DIR, 'service-index.json');
-const MAP_PATH = path.join(STATE_DIR, 'service-map.md');
+const INDEX_PATH = path.join(PATHS.state, 'service-index.json');
+const MAP_PATH = path.join(PATHS.state, 'service-map.md');
 
 // Decorator/annotation patterns per framework
 const NESTJS_PATTERNS = {
@@ -62,7 +58,7 @@ class ServiceRegistry extends RegistryPlugin {
 
   _getPackageJson() {
     if (this._cachedPkg !== undefined) return this._cachedPkg;
-    const pkgPath = path.join(PROJECT_ROOT, 'package.json');
+    const pkgPath = path.join(PATHS.root, 'package.json');
     try {
       this._cachedPkg = safeJsonParseFile(pkgPath, {});
     } catch (_err) {
@@ -94,10 +90,10 @@ class ServiceRegistry extends RegistryPlugin {
     }
 
     // Check for Django (manage.py)
-    if (fs.existsSync(path.join(PROJECT_ROOT, 'manage.py'))) return true;
+    if (fs.existsSync(path.join(PATHS.root, 'manage.py'))) return true;
 
     // Check for Go (go.mod with net/http)
-    const goModPath = path.join(PROJECT_ROOT, 'go.mod');
+    const goModPath = path.join(PATHS.root, 'go.mod');
     if (fs.existsSync(goModPath)) return true;
 
     return false;
@@ -147,7 +143,7 @@ class ServiceRegistry extends RegistryPlugin {
       const before = arr.length;
       const pruned = arr.filter(item => {
         if (!item.file) return true;
-        return fs.existsSync(path.join(PROJECT_ROOT, item.file));
+        return fs.existsSync(path.join(PATHS.root, item.file));
       });
       removed += before - pruned.length;
       arr.length = 0;
@@ -163,7 +159,7 @@ class ServiceRegistry extends RegistryPlugin {
 
   save() {
     const index = this._buildIndex();
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(PATHS.state, { recursive: true });
     fs.writeFileSync(INDEX_PATH, JSON.stringify(index, null, 2));
   }
 
@@ -237,7 +233,7 @@ class ServiceRegistry extends RegistryPlugin {
 
     lines.push(`---\n*Auto-generated by Service Registry — ${getTodayDate()}*\n`);
 
-    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.mkdirSync(PATHS.state, { recursive: true });
     fs.writeFileSync(MAP_PATH, lines.join('\n'));
   }
 
@@ -261,8 +257,8 @@ class ServiceRegistry extends RegistryPlugin {
       // ignore
     }
 
-    if (fs.existsSync(path.join(PROJECT_ROOT, 'manage.py'))) return 'django';
-    if (fs.existsSync(path.join(PROJECT_ROOT, 'go.mod'))) return 'go';
+    if (fs.existsSync(path.join(PATHS.root, 'manage.py'))) return 'django';
+    if (fs.existsSync(path.join(PATHS.root, 'go.mod'))) return 'go';
 
     return null;
   }
@@ -275,7 +271,7 @@ class ServiceRegistry extends RegistryPlugin {
     const searchDirs = ['src', 'apps', 'libs'];
 
     for (const dir of searchDirs) {
-      const fullDir = path.join(PROJECT_ROOT, dir);
+      const fullDir = path.join(PATHS.root, dir);
       if (fs.existsSync(fullDir)) {
         this._findNestJSFiles(fullDir);
       }
@@ -291,7 +287,7 @@ class ServiceRegistry extends RegistryPlugin {
         const fullPath = path.resolve(dir, entry.name);
 
         // Ensure resolved path stays within project root
-        if (!fullPath.startsWith(PROJECT_ROOT)) continue;
+        if (!fullPath.startsWith(PATHS.root)) continue;
 
         if (entry.isDirectory()) {
           this._findNestJSFiles(fullPath, depth + 1);
@@ -301,7 +297,7 @@ class ServiceRegistry extends RegistryPlugin {
                    !entry.name.endsWith('.d.ts')) {
           try {
             const content = fs.readFileSync(fullPath, 'utf-8');
-            const relPath = path.relative(PROJECT_ROOT, fullPath);
+            const relPath = path.relative(PATHS.root, fullPath);
 
             if (content.includes('@Controller')) {
               this._parseNestJSController(content, relPath);
@@ -430,7 +426,7 @@ class ServiceRegistry extends RegistryPlugin {
     const searchDirs = ['src', 'routes', 'middleware', 'src/routes', 'src/middleware', 'lib', 'app', 'app/routes', 'app/api', 'server', 'api'];
 
     for (const dir of searchDirs) {
-      const fullDir = path.join(PROJECT_ROOT, dir);
+      const fullDir = path.join(PATHS.root, dir);
       if (fs.existsSync(fullDir)) {
         this._findExpressFiles(fullDir);
       }
@@ -446,14 +442,14 @@ class ServiceRegistry extends RegistryPlugin {
         const fullPath = path.resolve(dir, entry.name);
 
         // Ensure resolved path stays within project root
-        if (!fullPath.startsWith(PROJECT_ROOT)) continue;
+        if (!fullPath.startsWith(PATHS.root)) continue;
 
         if (entry.isDirectory()) {
           this._findExpressFiles(fullPath, depth + 1);
         } else if (entry.name.endsWith('.ts') || entry.name.endsWith('.js')) {
           try {
             const content = fs.readFileSync(fullPath, 'utf-8');
-            const relPath = path.relative(PROJECT_ROOT, fullPath);
+            const relPath = path.relative(PATHS.root, fullPath);
 
             // Detect route handlers
             if (content.match(/router\.(get|post|put|patch|delete)\s*\(/i) ||
@@ -506,7 +502,7 @@ class ServiceRegistry extends RegistryPlugin {
 
   _scanDjango() {
     // Find all apps by looking for views.py files
-    this._findDjangoFiles(PROJECT_ROOT, 0);
+    this._findDjangoFiles(PATHS.root, 0);
   }
 
   _findDjangoFiles(dir, depth) {
@@ -518,14 +514,14 @@ class ServiceRegistry extends RegistryPlugin {
         const fullPath = path.resolve(dir, entry.name);
 
         // Ensure resolved path stays within project root
-        if (!fullPath.startsWith(PROJECT_ROOT)) continue;
+        if (!fullPath.startsWith(PATHS.root)) continue;
 
         if (entry.isDirectory()) {
           this._findDjangoFiles(fullPath, depth + 1);
         } else if (entry.name === 'views.py' || entry.name === 'serializers.py') {
           try {
             const content = fs.readFileSync(fullPath, 'utf-8');
-            const relPath = path.relative(PROJECT_ROOT, fullPath);
+            const relPath = path.relative(PATHS.root, fullPath);
             this._parseDjangoFile(content, relPath);
           } catch (err) {
             // Skip
@@ -570,7 +566,7 @@ class ServiceRegistry extends RegistryPlugin {
   // ============================================================
 
   _scanGo() {
-    this._findGoHandlers(PROJECT_ROOT, 0);
+    this._findGoHandlers(PATHS.root, 0);
   }
 
   _findGoHandlers(dir, depth) {
@@ -582,7 +578,7 @@ class ServiceRegistry extends RegistryPlugin {
         const fullPath = path.resolve(dir, entry.name);
 
         // Ensure resolved path stays within project root
-        if (!fullPath.startsWith(PROJECT_ROOT)) continue;
+        if (!fullPath.startsWith(PATHS.root)) continue;
 
         if (entry.isDirectory()) {
           this._findGoHandlers(fullPath, depth + 1);
@@ -590,7 +586,7 @@ class ServiceRegistry extends RegistryPlugin {
           try {
             const content = fs.readFileSync(fullPath, 'utf-8');
             if (content.includes('http.Handler') || content.includes('HandleFunc') || content.includes('gin.Context')) {
-              const relPath = path.relative(PROJECT_ROOT, fullPath);
+              const relPath = path.relative(PATHS.root, fullPath);
               this._parseGoFile(content, relPath);
             }
           } catch (err) {