wogiflow 2.4.2 → 2.4.4

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-calibration.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+
+/**
+ * Wogi Flow - Eval Calibration
+ *
+ * Stores and retrieves calibrated eval examples for anchoring judge scores.
+ * Prevents score drift by providing few-shot examples of what high and low
+ * scores look like in practice.
+ *
+ * Based on Anthropic's harness design research finding that "few-shot examples
+ * with detailed score breakdowns calibrated evaluator judgment, reducing score
+ * drift across iterations."
+ *
+ * Usage:
+ *   node flow-eval-calibration.js save <taskId> <quality>  — save as calibration example
+ *   node flow-eval-calibration.js get                       — get calibration examples for prompt injection
+ *   node flow-eval-calibration.js list                      — list all calibration examples
+ */
+
+const path = require('node:path');
+const fs = require('node:fs');
+const { PATHS, safeJsonParse, writeJson } = require('./flow-utils');
+
+// ============================================================
+// Constants
+// ============================================================
+
+const CALIBRATION_PATH = path.join(PATHS.state, 'eval-calibration.json');
+const MAX_EXAMPLES_PER_QUALITY = 3; // Keep 3 high, 3 low
+
+// ============================================================
+// Storage
+// ============================================================
+
+/**
+ * Load calibration data
+ * @returns {Object} { high: [], low: [], lastUpdated }
+ */
+function loadCalibration() {
+  return safeJsonParse(CALIBRATION_PATH, {
+    high: [],
+    low: [],
+    lastUpdated: null
+  });
+}
+
+/**
+ * Save a completed eval as a calibration example.
+ * Called after /wogi-eval produces scores.
+ *
+ * @param {Object} params
+ * @param {string} params.taskId — the task that was evaluated
+ * @param {string} params.quality — "high" or "low"
+ * @param {Object} params.scores — { completeness, accuracy, workflowCompliance, tokenEfficiency, quality }
+ * @param {string} params.specSummary — brief spec description (first 500 chars)
+ * @param {string} params.diffSummary — brief diff description (file count, line count)
+ * @param {string} params.notes — judge's justification notes
+ */
+function saveCalibrationExample(params) {
+  const { taskId, quality, scores, specSummary, diffSummary, notes } = params;
+
+  if (quality !== 'high' && quality !== 'low') {
+    throw new Error('Quality must be "high" or "low"');
+  }
+
+  const cal = loadCalibration();
+  const example = {
+    taskId,
+    scores,
+    specSummary: (specSummary || '').slice(0, 500),
+    diffSummary: (diffSummary || '').slice(0, 200),
+    notes: (notes || '').slice(0, 500),
+    savedAt: new Date().toISOString()
+  };
+
+  cal[quality].unshift(example);
+
+  // Keep only MAX_EXAMPLES_PER_QUALITY
+  if (cal[quality].length > MAX_EXAMPLES_PER_QUALITY) {
+    cal[quality] = cal[quality].slice(0, MAX_EXAMPLES_PER_QUALITY);
+  }
+
+  cal.lastUpdated = new Date().toISOString();
+  writeJson(CALIBRATION_PATH, cal);
+
+  return example;
+}
+
+/**
+ * Auto-classify and save an eval result as calibration.
+ * High = average score >= 8. Low = average score <= 4.
+ *
+ * @param {Object} evalResult — from flow-eval.js
+ * @returns {Object|null} saved example or null if score is in the middle range
+ */
+function autoSaveFromEval(evalResult) {
+  if (!evalResult || !evalResult.scores) return null;
+
+  const scores = evalResult.scores;
+  const values = Object.values(scores).filter(v => typeof v === 'number');
+  if (values.length === 0) return null;
+
+  const avg = values.reduce((sum, v) => sum + v, 0) / values.length;
+
+  let quality = null;
+  if (avg >= 8) quality = 'high';
+  else if (avg <= 4) quality = 'low';
+  else return null; // Middle range — not a good calibration anchor
+
+  return saveCalibrationExample({
+    taskId: evalResult.taskId,
+    quality,
+    scores,
+    specSummary: evalResult.specSummary || '',
+    diffSummary: evalResult.diffSummary || '',
+    notes: evalResult.notes || ''
+  });
+}
+
+// ============================================================
+// Retrieval (for prompt injection)
+// ============================================================
+
+/**
+ * Get calibration examples formatted for injection into judge/evaluator prompts.
+ * Returns 1 high + 1 low example (if available).
+ *
+ * @returns {string} formatted calibration text, or empty string if no examples
+ */
+function getCalibrationPrompt() {
+  const cal = loadCalibration();
+  const parts = [];
+
+  if (cal.high.length > 0) {
+    const ex = cal.high[0];
+    parts.push(`## Calibration Example: HIGH QUALITY (reference)
+
+**Task**: ${ex.taskId}
+**Spec**: ${ex.specSummary}
+**Scores**: completeness=${ex.scores.completeness}, accuracy=${ex.scores.accuracy}, workflowCompliance=${ex.scores.workflowCompliance}, tokenEfficiency=${ex.scores.tokenEfficiency}, quality=${ex.scores.quality}
+**Why this scored high**: ${ex.notes}`);
+  }
+
+  if (cal.low.length > 0) {
+    const ex = cal.low[0];
+    parts.push(`## Calibration Example: LOW QUALITY (reference)
+
+**Task**: ${ex.taskId}
+**Spec**: ${ex.specSummary}
+**Scores**: completeness=${ex.scores.completeness}, accuracy=${ex.scores.accuracy}, workflowCompliance=${ex.scores.workflowCompliance}, tokenEfficiency=${ex.scores.tokenEfficiency}, quality=${ex.scores.quality}
+**Why this scored low**: ${ex.notes}`);
+  }
+
+  if (parts.length === 0) return '';
+
+  return `
+## Score Calibration (anchoring examples)
+
+Use these real examples to calibrate your scoring. They represent the extremes of the scale — most tasks should score between these.
+
+${parts.join('\n\n')}
+
+---
+`;
+}
+
+/**
+ * Get calibration examples as structured data
+ * @returns {{ high: Object|null, low: Object|null }}
+ */
+function getCalibrationExamples() {
+  const cal = loadCalibration();
+  return {
+    high: cal.high[0] || null,
+    low: cal.low[0] || null
+  };
+}
+
+// ============================================================
+// CLI
+// ============================================================
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'save': {
+      const taskId = args[1];
+      const quality = args[2];
+      if (!taskId || !quality) {
+        console.error('Usage: flow-eval-calibration.js save <taskId> <high|low>');
+        process.exit(1);
+      }
+      // Read scores from stdin or eval results
+      const evalsDir = path.join(PATHS.workflow, 'evals');
+      const evalFiles = fs.existsSync(evalsDir) ? fs.readdirSync(evalsDir).filter(f => f.includes(taskId)) : [];
+      if (evalFiles.length === 0) {
+        console.error(`No eval results found for task ${taskId}`);
+        process.exit(1);
+      }
+      const evalResult = safeJsonParse(path.join(evalsDir, evalFiles[0]), null);
+      if (evalResult) {
+        const saved = saveCalibrationExample({
+          taskId,
+          quality,
+          scores: evalResult.aggregated || evalResult.scores || {},
+          specSummary: evalResult.spec?.substring(0, 500) || '',
+          diffSummary: `${(evalResult.changedFiles || []).length} files changed`,
+          notes: evalResult.notes || evalResult.aggregated?.notes || ''
+        });
+        console.log(`Saved ${quality} calibration example: ${saved.taskId}`);
+      }
+      break;
+    }
+
+    case 'get':
+      console.log(getCalibrationPrompt() || 'No calibration examples yet.');
+      break;
+
+    case 'list': {
+      const cal = loadCalibration();
+      console.log(`High examples: ${cal.high.length}`);
+      for (const ex of cal.high) {
+        const values = Object.values(ex.scores).filter(v => typeof v === 'number');
+        const avg = values.length > 0 ? values.reduce((s, v) => s + v, 0) / values.length : 0;
+        console.log(`  ${ex.taskId} — avg ${avg.toFixed(1)} (${ex.savedAt})`);
+      }
+      console.log(`Low examples: ${cal.low.length}`);
+      for (const ex of cal.low) {
+        const values = Object.values(ex.scores).filter(v => typeof v === 'number');
+        const avg = values.length > 0 ? values.reduce((s, v) => s + v, 0) / values.length : 0;
+        console.log(`  ${ex.taskId} — avg ${avg.toFixed(1)} (${ex.savedAt})`);
+      }
+      break;
+    }
+
+    default:
+      console.log('Usage: flow-eval-calibration.js <save|get|list>');
+  }
+}
+
+// ============================================================
+// Exports
+// ============================================================
+
+module.exports = {
+  loadCalibration,
+  saveCalibrationExample,
+  autoSaveFromEval,
+  getCalibrationPrompt,
+  getCalibrationExamples
+};
+
+if (require.main === module) {
+  main();
+}

package/scripts/flow-eval-judge.js

@@ -62,10 +62,19 @@ const DEFAULT_EVAL_CONFIG = {
 function buildJudgePrompt(params) {
   const { taskId, specContent, implementationDiff, iterations, tokenEstimate } = params;
 
+  // Inject calibration examples if available (prevents score drift)
+  let calibrationBlock = '';
+  try {
+    const { getCalibrationPrompt } = require('./flow-eval-calibration');
+    calibrationBlock = getCalibrationPrompt();
+  } catch (_err) {
+    // Calibration module not available — continue without it
+  }
+
   return `You are an expert code reviewer evaluating AI-generated implementation quality.
 
 ## Task: ${taskId}
-
+${calibrationBlock}
 ## Specification
 ${specContent}
 

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 || []),
@@ -248,6 +248,15 @@ function saveEvalResult(evalResult) {
 
   try {
     writeJson(filePath, evalResult);
+
+    // Auto-save as calibration example if scores are extreme (high or low)
+    try {
+      const { autoSaveFromEval } = require('./flow-eval-calibration');
+      autoSaveFromEval(evalResult);
+    } catch (_err) {
+      // Calibration module not available — non-critical
+    }
+
     return filePath;
   } catch (err) {
     if (process.env.DEBUG) {

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');