wogiflow 2.4.2 → 2.4.3

package/scripts/flow-entropy-monitor.js

@@ -19,14 +19,12 @@ const path = require('node:path');
 const memoryDb = require('./flow-memory-db');
 const { getConfig } = require('./flow-config-loader');
 const { color } = require('./flow-output');
-const { getProjectRoot } = require('./flow-paths');
+const { getProjectRoot, PATHS } = require('./flow-paths');
 
 // ============================================================
 // Configuration
 // ============================================================
 
-const PROJECT_ROOT = getProjectRoot();
-
 // ============================================================
 // Output Formatting
 // ============================================================

package/scripts/flow-eval.js

@@ -35,7 +35,7 @@ const {
 // Constants
 // ============================================================
 
-const EVALS_DIR = path.join(PATHS.root, '.workflow', 'evals');
+const EVALS_DIR = PATHS.evals;
 
 // ============================================================
 // Core Functions
@@ -171,13 +171,13 @@ function getTaskDiff(taskId, taskRecord) {
 function findSpecFile(taskId) {
   // Check common locations
   const candidates = [
-    path.join(PATHS.root, '.workflow', 'specs', `${taskId}.md`),
-    path.join(PATHS.root, '.workflow', 'changes', `${taskId}.md`)
+    path.join(PATHS.specs, `${taskId}.md`),
+    path.join(PATHS.changes, `${taskId}.md`)
   ];
 
   // Also search subdirectories of changes/
   try {
-    const changesDir = path.join(PATHS.root, '.workflow', 'changes');
+    const changesDir = PATHS.changes;
     if (fs.existsSync(changesDir)) {
       const entries = fs.readdirSync(changesDir, { withFileTypes: true });
       for (const entry of entries) {
@@ -202,7 +202,7 @@ function findSpecFile(taskId) {
 
   // Check ready.json for specPath
   try {
-    const ready = readJson(path.join(PATHS.state, 'ready.json'), {});
+    const ready = readJson(PATHS.ready, {});
     const allTasks = [
       ...(ready.inProgress || []),
       ...(ready.ready || []),

package/scripts/flow-extraction-review.js

@@ -23,6 +23,7 @@ const REVIEW_FILE = path.join(TMP_DIR, 'review-session.json');
 
 // Colors
 const { colors: c } = require('./flow-output');
+const { PATHS } = require('./flow-utils');
 
 // =============================================================================
 // REVIEW SESSION MANAGEMENT

package/scripts/flow-failure-categories.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * Wogi Flow - Centralized Failure Categories
  *

package/scripts/flow-figma-confirm.js

@@ -13,12 +13,10 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const readline = require('node:readline');
-const { getProjectRoot, colors: c, readJson } = require('./flow-utils');
+const readline = require('node:readline/promises');
+const { getProjectRoot, colors: c, readJson, PATHS } = require('./flow-utils');
 
-const PROJECT_ROOT = getProjectRoot();
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const DECISIONS_PATH = path.join(WORKFLOW_DIR, 'state', 'figma-decisions.json');
+const DECISIONS_PATH = path.join(PATHS.workflow, 'state', 'figma-decisions.json');
 
 const sym = {
   check: '✅',
@@ -252,9 +250,7 @@ Let's go through each component:
   }
 
   prompt(question) {
-    return new Promise(resolve => {
-      this.rl.question(question, resolve);
-    });
+    return this.rl.question(question);
   }
 
   printSummary() {
@@ -295,7 +291,7 @@ ${c.bold}CONFIRMATION SUMMARY${c.reset}
       decisions: this.decisions
     }, null, 2));
 
-    console.log(`${c.dim}Decisions saved to: ${path.relative(PROJECT_ROOT, DECISIONS_PATH)}${c.reset}`);
+    console.log(`${c.dim}Decisions saved to: ${path.relative(PATHS.root, DECISIONS_PATH)}${c.reset}`);
   }
 }
 

package/scripts/flow-figma-generate.js

@@ -25,14 +25,12 @@ const { getProjectRoot,
   getConfig,
   addRequestLogEntry,
   addAppMapComponent,
-  readJson
+  readJson, PATHS
 } = require('./flow-utils')
 const { error, info } = require('./flow-output');;
 
-const PROJECT_ROOT = getProjectRoot();
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const DECISIONS_PATH = path.join(WORKFLOW_DIR, 'state', 'figma-decisions.json');
-const REGISTRY_PATH = path.join(WORKFLOW_DIR, 'state', 'component-registry.json');
+const DECISIONS_PATH = path.join(PATHS.workflow, 'state', 'figma-decisions.json');
+const REGISTRY_PATH = path.join(PATHS.workflow, 'state', 'component-registry.json');
 
 // ============================================================
 // Framework-Specific Templates
@@ -231,7 +229,7 @@ export class {{name}}Component {
 class CodeGenerator {
   constructor(decisions, options = {}) {
     this.decisions = Array.isArray(decisions) ? decisions : decisions.decisions || [];
-    this.framework = options.framework || detectFramework(PROJECT_ROOT);
+    this.framework = options.framework || detectFramework(PATHS.root);
     this.templates = FRAMEWORK_TEMPLATES[this.framework] || FRAMEWORK_TEMPLATES.react;
     this.registry = this.loadRegistry();
 
@@ -497,7 +495,7 @@ ${this.formatCSSPropertiesForPrompt(figma.css)}
 
   _detectSourceRoot() {
     for (const dir of ['src', 'app', 'lib']) {
-      if (fs.existsSync(path.join(PROJECT_ROOT, dir))) return dir;
+      if (fs.existsSync(path.join(PATHS.root, dir))) return dir;
     }
     return '.';
   }
@@ -633,9 +631,9 @@ Framework: ${output.framework}
   }
 
   // Save output
-  const outputPath = path.join(WORKFLOW_DIR, 'state', 'figma-output.json');
+  const outputPath = path.join(PATHS.workflow, 'state', 'figma-output.json');
   fs.writeFileSync(outputPath, JSON.stringify(output, null, 2));
-  info(`� Full output saved to: ${path.relative(PROJECT_ROOT, outputPath)}`);
+  info(`� Full output saved to: ${path.relative(PATHS.root, outputPath)}`);
 
   // Print prompts for new components
   if (output.prompts.length > 0) {
@@ -668,7 +666,7 @@ ${'─'.repeat(70)}
       tags: ['#figma', ...componentNames.slice(0, 3).map(n => `#component:${n}`)],
       request: 'Figma design analysis and code generation',
       result: `Generated: ${summary.join(', ')}`,
-      files: [path.relative(PROJECT_ROOT, outputPath)]
+      files: [path.relative(PATHS.root, outputPath)]
     });
 
     console.log('\n📝 Logged to request-log.md');

package/scripts/flow-figma-index.js

@@ -16,12 +16,10 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { getProjectRoot, readJson } = require('./flow-utils');
+const { getProjectRoot, readJson, PATHS } = require('./flow-utils');
 const { success: printSuccess, error: printError, info: printInfo } = require('./flow-output');
 
-const PROJECT_ROOT = getProjectRoot();
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const REGISTRY_PATH = path.join(WORKFLOW_DIR, 'state', 'component-registry.json');
+const REGISTRY_PATH = path.join(PATHS.workflow, 'state', 'component-registry.json');
 
 // ============================================================
 // Configuration
@@ -97,11 +95,11 @@ function detectFramework(projectRoot) {
 class ComponentScanner {
   constructor(config = {}) {
     this.config = { ...DEFAULT_CONFIG, ...config };
-    this.framework = detectFramework(PROJECT_ROOT);
+    this.framework = detectFramework(PATHS.root);
     this.registry = {
       version: '1.0.0',
       scannedAt: null,
-      projectRoot: PROJECT_ROOT,
+      projectRoot: PATHS.root,
       framework: this.framework,
       components: [],
       tokens: {
@@ -136,7 +134,7 @@ class ComponentScanner {
       return null;
     }
 
-    console.log(`   Component directory: ${path.relative(PROJECT_ROOT, componentDir)}`);
+    console.log(`   Component directory: ${path.relative(PATHS.root, componentDir)}`);
     console.log(`   Parser: ${this.parser ? 'Babel AST' : 'Regex-based'}`);
 
     // Scan for tokens first
@@ -154,14 +152,14 @@ class ComponentScanner {
     this.saveRegistry();
 
     printSuccess(`Found ${this.registry.components.length} components`);
-    console.log(`📄 Registry saved to: ${path.relative(PROJECT_ROOT, REGISTRY_PATH)}`);
+    console.log(`📄 Registry saved to: ${path.relative(PATHS.root, REGISTRY_PATH)}`);
 
     return this.registry;
   }
 
   findComponentDir() {
     for (const dir of this.config.componentDirs) {
-      const fullPath = path.join(PROJECT_ROOT, dir);
+      const fullPath = path.join(PATHS.root, dir);
       if (fs.existsSync(fullPath)) {
         return fullPath;
       }
@@ -173,7 +171,7 @@ class ComponentScanner {
     console.log('\n📊 Scanning design tokens...');
 
     for (const tokenSource of this.config.tokenSources) {
-      const fullPath = path.join(PROJECT_ROOT, tokenSource);
+      const fullPath = path.join(PATHS.root, tokenSource);
       if (fs.existsSync(fullPath)) {
         console.log(`   Found: ${tokenSource}`);
         await this.parseTokenFile(fullPath);

package/scripts/flow-figma-match.js

@@ -14,12 +14,10 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { getProjectRoot, safeJsonParse, safeJsonParseString } = require('./flow-utils')
+const { getProjectRoot, safeJsonParse, safeJsonParseString, PATHS } = require('./flow-utils')
 const { error } = require('./flow-output');;
 
-const PROJECT_ROOT = getProjectRoot();
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const REGISTRY_PATH = path.join(WORKFLOW_DIR, 'state', 'component-registry.json');
+const REGISTRY_PATH = path.join(PATHS.workflow, 'state', 'component-registry.json');
 
 // ============================================================
 // Matching Configuration
@@ -553,7 +551,7 @@ async function main() {
 
   if (figmaRegistryIndex !== -1) {
     // Use the Figma-sourced multi-page registry
-    const figmaRegistryPath = path.join(WORKFLOW_DIR, 'state', 'figma-component-registry.json');
+    const figmaRegistryPath = path.join(PATHS.workflow, 'state', 'figma-component-registry.json');
     if (!fs.existsSync(figmaRegistryPath)) {
       error('Figma component registry not found.');
       console.error('   Run the multi-page scan first.');

package/scripts/flow-figma-mcp-server.js

@@ -31,11 +31,9 @@ const { ComponentScanner } = require('./flow-figma-index');
 const { FigmaExtractor } = require('./flow-figma-extract');
 const { SimilarityMatcher, MATCH_CONFIG } = require('./flow-figma-match');
 const { CodeGenerator } = require('./flow-figma-generate');
-const { getProjectRoot, readJson } = require('./flow-utils');
+const { getProjectRoot, readJson, PATHS } = require('./flow-utils');
 
-const PROJECT_ROOT = getProjectRoot();
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const REGISTRY_PATH = path.join(WORKFLOW_DIR, 'state', 'component-registry.json');
+const REGISTRY_PATH = path.join(PATHS.workflow, 'state', 'component-registry.json');
 
 // ============================================================
 // Tool Definitions

package/scripts/flow-figma-orchestrator.js

@@ -20,13 +20,12 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { getProjectRoot, writeJson, readJson } = require('./flow-utils');
+const { getProjectRoot, writeJson, readJson, PATHS } = require('./flow-utils');
 const { FigmaExtractor } = require('./flow-figma-extract');
 const { FigmaComponentRegistry } = require('./flow-figma-registry');
 const { FigmaStateAnalyzer } = require('./flow-figma-state-analyzer');
 
-const PROJECT_ROOT = getProjectRoot();
-const ORCHESTRATOR_STATE_PATH = path.join(PROJECT_ROOT, '.workflow', 'state', 'figma-orchestrator-state.json');
+const ORCHESTRATOR_STATE_PATH = path.join(PATHS.state, 'figma-orchestrator-state.json');
 
 // ============================================================
 // Orchestrator

package/scripts/flow-figma-registry.js

@@ -15,11 +15,10 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { getProjectRoot, readJson, writeJson } = require('./flow-utils');
+const { getProjectRoot, readJson, writeJson, PATHS } = require('./flow-utils');
 const { SimilarityMatcher, MATCH_CONFIG } = require('./flow-figma-match');
 
-const PROJECT_ROOT = getProjectRoot();
-const REGISTRY_PATH = path.join(PROJECT_ROOT, '.workflow', 'state', 'figma-component-registry.json');
+const REGISTRY_PATH = path.join(PATHS.state, 'figma-component-registry.json');
 
 // ============================================================
 // Registry Data Structure

package/scripts/flow-framework-resolver.js

@@ -1,5 +1,3 @@
-'use strict';
-
 /**
  * flow-framework-resolver.js
  *

package/scripts/flow-function-index.js

@@ -15,7 +15,7 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { getProjectRoot, getConfig, color, success, warn, error, safeJsonParse } = require('./flow-utils');
+const { getProjectRoot, getConfig, color, success, warn, error, safeJsonParse, PATHS } = require('./flow-utils');
 const {
   findSimilarItems,
   generateAIDecisionPrompt,
@@ -24,10 +24,8 @@ const {
 } = require('./flow-semantic-match');
 const { BaseScanner, PROJECT_ROOT } = require('./flow-scanner-base');
 
-const WORKFLOW_DIR = path.join(PROJECT_ROOT, '.workflow');
-const STATE_DIR = path.join(WORKFLOW_DIR, 'state');
-const INDEX_PATH = path.join(STATE_DIR, 'function-index.json');
-const MAP_PATH = path.join(STATE_DIR, 'function-map.md');
+const INDEX_PATH = path.join(PATHS.state, 'function-index.json');
+const MAP_PATH = path.join(PATHS.state, 'function-map.md');
 
 // ============================================================
 // Configuration
@@ -344,7 +342,7 @@ class FunctionScanner 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)}`);
   }

package/scripts/flow-gate-confidence.js

@@ -36,7 +36,7 @@ const {
   outputJson,
   printHeader,
   printSection,
-  safeJsonParse
+  safeJsonParse, PATHS
 } = require('./flow-utils');
 
 // ============================================================
@@ -178,7 +178,7 @@ const DEFAULT_GATE_CONFIG = {
 // State
 // ============================================================
 
-const STATE_PATH = path.join(PROJECT_ROOT, '.workflow', 'state', 'gate-confidence.json');
+const STATE_PATH = path.join(PATHS.state, 'gate-confidence.json');
 
 /**
  * Get default confidence state.

package/scripts/flow-gitignore.js

@@ -14,8 +14,6 @@
  * - Declarative: RUNTIME_ARTIFACT_MAP defines all mappings
  */
 
-'use strict';
-
 const fs = require('node:fs');
 const path = require('node:path');
 const { getConfig } = require('./flow-config-loader');

package/scripts/flow-guided-edit.js

@@ -35,7 +35,6 @@ const {
 } = require('./flow-utils')
 const { color, success, warn, error } = require('./flow-output');;
 
-const PROJECT_ROOT = getProjectRoot();
 const SESSION_FILE = path.join(PATHS.state, 'guided-edit-session.json');
 
 // ============================================================
@@ -141,14 +140,14 @@ function findAffectedFiles(search, options = {}) {
 
   // Try options first
   if (options.srcDir) {
-    srcDir = path.isAbsolute(options.srcDir) ? options.srcDir : path.join(PROJECT_ROOT, options.srcDir);
+    srcDir = path.isAbsolute(options.srcDir) ? options.srcDir : path.join(PATHS.root, options.srcDir);
   }
 
   // Try config
   if (!srcDir || !fs.existsSync(srcDir)) {
     const configSrcDir = config.guidedEdit?.srcDir;
     if (configSrcDir) {
-      const resolved = path.isAbsolute(configSrcDir) ? configSrcDir : path.join(PROJECT_ROOT, configSrcDir);
+      const resolved = path.isAbsolute(configSrcDir) ? configSrcDir : path.join(PATHS.root, configSrcDir);
       if (fs.existsSync(resolved)) {
         srcDir = resolved;
       }
@@ -157,8 +156,8 @@ function findAffectedFiles(search, options = {}) {
 
   // Fallback to src/ or project root
   if (!srcDir || !fs.existsSync(srcDir)) {
-    const defaultSrc = path.join(PROJECT_ROOT, 'src');
-    srcDir = fs.existsSync(defaultSrc) ? defaultSrc : PROJECT_ROOT;
+    const defaultSrc = path.join(PATHS.root, 'src');
+    srcDir = fs.existsSync(defaultSrc) ? defaultSrc : PATHS.root;
   }
 
   const extensions = options.extensions || config.guidedEdit?.extensions || ['ts', 'tsx', 'js', 'jsx', 'vue', 'svelte'];
@@ -190,7 +189,7 @@ function findAffectedFiles(search, options = {}) {
         }
 
         results.push({
-          path: path.relative(PROJECT_ROOT, file),
+          path: path.relative(PATHS.root, file),
           absolutePath: file,
           matchCount: matches.length,
           matches: matches.slice(0, 5), // First 5 matches

package/scripts/flow-health.js

@@ -267,9 +267,9 @@ function main() {
   printSection('Checking universal structure...');
 
   const universalDirs = [
-    { path: path.join(PROJECT_ROOT, '.workflow', 'models'), name: '.workflow/models' },
-    { path: path.join(PROJECT_ROOT, '.workflow', 'bridges'), name: '.workflow/bridges' },
-    { path: path.join(PROJECT_ROOT, '.workflow', 'templates'), name: '.workflow/templates' },
+    { path: PATHS.modelsDir, name: '.workflow/models' },
+    { path: PATHS.bridges, name: '.workflow/bridges' },
+    { path: PATHS.templates, name: '.workflow/templates' },
   ];
 
   for (const dir of universalDirs) {
@@ -282,7 +282,7 @@ function main() {
   }
 
   // Check model registry
-  const registryPath = path.join(PROJECT_ROOT, '.workflow', 'models', 'registry.json');
+  const registryPath = path.join(PATHS.workflow, 'models', 'registry.json');
   if (fileExists(registryPath)) {
     const result = validateJson(registryPath);
     if (result.valid) {
@@ -376,8 +376,7 @@ function main() {
 
       if (fileExists(tsconfigPath)) {
         try {
-          const tsconfigContent = fs.readFileSync(tsconfigPath, 'utf-8');
-          const tsconfig = JSON.parse(tsconfigContent);
+          const tsconfig = safeJsonParse(tsconfigPath, {});
           const hasProjectRefs = Array.isArray(tsconfig.references) && tsconfig.references.length > 0;
           const hasEmptyFiles = Array.isArray(tsconfig.files) && tsconfig.files.length === 0;
           const isProjectRefsMode = hasProjectRefs && hasEmptyFiles;

package/scripts/flow-hook-errors.js

@@ -153,6 +153,12 @@ function formatHookError(hookName, err, options = {}) {
  */
 function logHookError(hookName, err, options = {}) {
   const formatted = formatHookError(hookName, err, options);
+  // Debug env var hierarchy:
+  //   DEBUG           — General-purpose debug flag (used across ~30 scripts for verbose logging)
+  //   WOGIFLOW_DEBUG  — WogiFlow-specific debug flag (equivalent to DEBUG but namespaced)
+  //   DEBUG_LSP       — LSP-only debug flag (used exclusively in flow-lsp.js for LSP protocol debugging)
+  // DEBUG and WOGIFLOW_DEBUG are interchangeable; either enables verbose error output.
+  // DEBUG_LSP is independent — it controls only LSP stderr/parse-error logging.
   const isDebug = process.env.DEBUG || process.env.WOGIFLOW_DEBUG;
 
   if (isDebug) {