fileflows 1.0.3 → 1.0.5

package/dist/lib/otherFileParser.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOtherFile = parseOtherFile;
+const localVars = __importStar(require("../config/localVars"));
+function parseOtherFile(content, relPath, ext) {
+    const lines = content.split('\n');
+    switch (ext) {
+        case 'json': {
+            try {
+                const parsed = JSON.parse(content);
+                const keys = Object.keys(parsed);
+                const summary = [parsed.name || parsed.title || 'JSON Configuration'].filter(Boolean);
+                return {
+                    Keys: keys.slice(0, localVars.MAX_JSON_KEYS),
+                    Summary: summary
+                };
+            }
+            catch {
+                return { Keys: [], Summary: ['Malformed JSON'] };
+            }
+        }
+        case 'md': {
+            const headings = lines
+                .filter(l => l.startsWith('#'))
+                .map(l => l.replace(/^#+ /, ''))
+                .slice(0, 5);
+            const firstHeading = headings[0];
+            return {
+                Headings: headings,
+                Summary: firstHeading ? [firstHeading] : []
+            };
+        }
+        case 'yml':
+        case 'yaml': {
+            const yamlKeys = lines
+                .filter(line => /^[a-zA-Z0-9_]+:/.test(line))
+                .slice(0, localVars.MAX_YAML_KEYS)
+                .map(line => line.split(':')[0]);
+            const yamlName = lines.find(line => line.includes('name:'))?.split(':')[1]?.trim() || 'YAML Configuration';
+            return {
+                Keys: yamlKeys,
+                Summary: [yamlName]
+            };
+        }
+        case 'env': {
+            return {
+                Vars: lines
+                    .filter(line => line.includes('='))
+                    .map(line => line.split('=')[0])
+            };
+        }
+        case 'graphql': {
+            const types = lines
+                .filter(line => /^(query|mutation|type)\s+/.test(line))
+                .map(line => line.trim().split(/\s+/)[1])
+                .filter(Boolean);
+            return {
+                Types: types,
+                Summary: ['GraphQL Schema']
+            };
+        }
+        case 'sh': {
+            const commands = lines
+                .filter(line => line.trim() && !line.startsWith('#'))
+                .slice(0, localVars.MAX_SHELL_COMMANDS)
+                .map(line => line.trim().split(/\s+/)[0])
+                .filter(cmd => cmd && !cmd.includes('='));
+            const scriptPurpose = content.includes('deploy') ? 'deployment' : 'shell script';
+            return {
+                Commands: [...new Set(commands)],
+                Summary: [scriptPurpose]
+            };
+        }
+        case 'html': {
+            const tagLines = lines.filter(line => line.includes('<') && !line.includes('</'));
+            const tags = [];
+            for (const line of tagLines) {
+                const matches = line.match(/<([a-zA-Z][a-zA-Z0-9]*)/g);
+                if (matches) {
+                    matches.forEach(match => {
+                        const tagName = match.substring(1).toLowerCase();
+                        if (tagName && !tags.includes(tagName)) {
+                            tags.push(tagName);
+                        }
+                    });
+                }
+            }
+            const titleMatch = content.match(/<title[^>]*>(.*?)<\/title>/is);
+            const title = titleMatch ? titleMatch[1].trim() : 'HTML Document';
+            return {
+                Tags: tags.slice(0, localVars.MAX_HTML_TAGS),
+                Summary: [title]
+            };
+        }
+        default:
+            return { Summary: ['Unknown file type'] };
+    }
+}

package/index.mjs

@@ -0,0 +1,2 @@
+export * from './dist/index.js';
+export { default } from './dist/index.js';

package/package.json

@@ -1,16 +1,22 @@
 {
   "name": "fileflows",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "CLI tool for deploying data workflow analysis documentation",
-  "main": "cli.js",
+  "main": "index.mjs",
+  "exports": {
+    ".": "./index.mjs",
+    "./cli": "./cli.mjs"
+  },
   "bin": {
-    "fileflows": "./cli.js"
+    "fileflows": "./cli.mjs"
   },
   "scripts": {
-    "generate": "node cli.js",
-    "help": "node cli.js --help",
-    "test": "node qtests-runner.js",
-    "start": "node bin/cli.js"
+    "build": "tsc",
+    "generate": "node cli.mjs",
+    "help": "node cli.mjs --help",
+    "test": "node --experimental-vm-modules qtests-runner.mjs",
+    "start": "node cli.mjs",
+    "pretest": "node scripts/clean-dist.mjs && node scripts/clean-bun-cache.mjs && node scripts/ensure-runner.mjs"
   },
   "keywords": [
     "file-analysis",
@@ -41,8 +47,7 @@
     "node": ">=16.0.0"
   },
   "files": [
-    "bin/",
-    "lib/",
+    "dist/",
     "config/",
     "contexts/",
     "features/",
@@ -54,20 +59,32 @@
   "dependencies": {
     "@babel/parser": "^7.28.3",
     "@babel/traverse": "^7.28.3",
-    "qerrors": "^1.2.6",
+    "qerrors": "^1.2.7",
+    "qgenutils": "^1.0.3",
     "winston": "^3.17.0",
     "winston-daily-rotate-file": "^5.0.0"
   },
   "devDependencies": {
-    "agentsqripts": "^1.0.8",
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@bijikyu/csup": "^1.0.2",
+    "@openai/codex": "^0.77.0",
+    "@types/node": "^20.0.0",
+    "agentsqripts": "^1.1.0",
     "arqitect": "^1.0.7",
-    "commoncontext": "^1.0.1",
+    "babel-jest": "^30.2.0",
+    "commoncontext": "^1.0.3",
+    "fileflows": "^1.0.3",
+    "jest": "^30.2.0",
     "loqatevars": "^1.0.6",
     "madge": "^8.0.0",
-    "npmcontext": "^1.0.1",
-    "qtests": "^1.1.9",
+    "npmcontext": "^1.0.4",
+    "opencode-ai": "1.0.204",
+    "qtests": "^2.0.0",
     "quantumagent": "^1.0.5",
     "repomix": "^1.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.6.3",
     "unqommented": "^1.1.0"
   }
 }

package/scripts/broadcast.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# USAGE:
+# ./broadcast.sh "your message here"
+SESSION="codex-swarm"
+MESSAGE="$*"
+
+if [[ -z "$MESSAGE" ]]; then
+  echo "Usage: $0 \"message to broadcast\""
+  exit 1
+fi
+
+if ! tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "❌ Tmux session '$SESSION' is not running."
+  exit 1
+fi
+
+tmux list-windows -t "$SESSION" -F "#{window_name}" 2>/dev/null | while read -r WINDOW_NAME; do
+  if [[ -z "$WINDOW_NAME" ]]; then
+    continue
+  fi
+  if [[ "$WINDOW_NAME" == "root" ]]; then
+    continue
+  fi
+  tmux send-keys -t "$SESSION:$WINDOW_NAME" "$MESSAGE" C-m
+  echo "📣 Sent to $WINDOW_NAME → $MESSAGE"
+done

package/scripts/clean-bun-cache.mjs

@@ -0,0 +1,14 @@
+// scripts/clean-bun-cache.mjs
+// Remove Bun's install cache to avoid Jest haste-map module collisions.
+import fs from 'fs';
+import path from 'path';
+
+const cacheDir = path.join(process.cwd(), '.cache', '.bun', 'install', 'cache');
+
+if (fs.existsSync(cacheDir)) {
+  try {
+    fs.rmSync(cacheDir, { recursive: true, force: true });
+  } catch (error) {
+    // Intentionally ignore cleanup failures; Bun cache is optional for our test runs.
+  }
+}

package/scripts/clean-dist.mjs

@@ -0,0 +1,7 @@
+// scripts/clean-dist.mjs
+// Remove compiled test files and __mocks__ from dist/ to prevent duplicate mock warnings.
+import fs from 'fs';
+import path from 'path';
+function rmDirSafe(p){try{fs.rmSync(p,{recursive:true,force:true})}catch{}}
+function cleanDist(root){const dist=path.join(root,'dist');try{if(!fs.existsSync(dist))return;}catch{return;}const stack=[dist];while(stack.length){const dir=stack.pop();let entries=[];try{entries=fs.readdirSync(dir,{withFileTypes:true})}catch{continue}for(const ent of entries){const full=path.join(dir,ent.name);if(ent.isDirectory()){if(ent.name==='__mocks__'){rmDirSafe(full);continue}stack.push(full);continue}if(!ent.isFile())continue;if(/\.(test|spec)\.[cm]?jsx?$/.test(ent.name)||/GeneratedTest/.test(ent.name)){try{fs.rmSync(full,{force:true})}catch{}}}}}
+cleanDist(process.cwd());

package/scripts/ensure-runner.mjs

@@ -0,0 +1,9 @@
+// Ensures qtests-runner.mjs exists at project root by copying a valid shipped template.
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const cwd = process.cwd();
+function isValid(content){try{return /runCLI/.test(content) && /API Mode/.test(content);}catch{return false;}}
+try{const target=path.join(cwd,'qtests-runner.mjs');if(!fs.existsSync(target)){const candidates=[path.join(cwd,'lib','templates','qtests-runner.mjs.template'),path.join(cwd,'templates','qtests-runner.mjs.template'),path.join(cwd,'node_modules','qtests','lib','templates','qtests-runner.mjs.template'),path.join(cwd,'node_modules','qtests','templates','qtests-runner.mjs.template')];let content=null;for(const p of candidates){try{if(fs.existsSync(p)){const c=fs.readFileSync(p,'utf8');if(isValid(c)){content=c;break;}}}catch{}}if(!content){/* silent no-op */}else{fs.writeFileSync(target,content,'utf8');}}}catch{/* silent */}

package/scripts/kill-agent.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# USAGE:
+# ./kill-agent.sh agent-name
+
+SESSION="codex-swarm"
+NAME="$1"
+
+if [[ -z "$NAME" ]]; then
+  echo "Usage: $0 agent-name"
+  exit 1
+fi
+
+if ! tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "❌ Tmux session '$SESSION' is not running."
+  exit 1
+fi
+
+if ! tmux list-windows -t "$SESSION" -F "#{window_name}" 2>/dev/null | grep -Fxq "$NAME"; then
+  echo "❌ Agent '$NAME' window not found in session '$SESSION'."
+  exit 1
+fi
+
+tmux kill-window -t "$SESSION:$NAME"
+echo "🛑 Agent '$NAME' stopped."

package/scripts/kill-all-agents.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# USAGE:
+# ./kill-all-agents.sh [--purge-logs]
+
+SESSION="codex-swarm"
+LOG_DIR="./logs"
+PURGE_FLAG="$1"
+
+case "$PURGE_FLAG" in
+  "") PURGE_LOGS=false ;;
+  "--purge-logs") PURGE_LOGS=true ;;
+  *) echo "Usage: $0 [--purge-logs]" ; exit 1 ;;
+esac
+
+if ! tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "❌ Tmux session '$SESSION' is not running."
+  exit 1
+fi
+
+tmux kill-session -t "$SESSION"
+
+if $PURGE_LOGS; then
+  if [[ -d "$LOG_DIR" ]]; then
+    find "$LOG_DIR" -maxdepth 1 -type f -name "*.log" -exec rm -f {} +
+    echo "🗑️ Cleared logs in $LOG_DIR."
+  else
+    echo "ℹ️ Log directory '$LOG_DIR' not found; nothing to purge."
+  fi
+fi
+
+echo "🧹 All agents stopped; tmux session '$SESSION' terminated."

package/scripts/list-agents.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+LOG_DIR="./logs"
+SESSION="codex-swarm"
+
+echo "🔍 Listing active Codex agents..."
+
+echo "📜 Logs:"
+if [[ -d "$LOG_DIR" ]]; then
+  find "$LOG_DIR" -maxdepth 1 -type f -name "*.log" 2>/dev/null || echo "  (none)"
+else
+  echo "  (none)"
+fi
+
+echo ""
+echo "🪟 Tmux windows in session '$SESSION':"
+tmux list-windows -t "$SESSION" 2>/dev/null || echo "  (tmux session not running)"

package/scripts/send-to-agent.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# USAGE:
+# ./send-to-agent.sh agent-name "your prompt here"
+
+NAME="$1"
+shift
+MESSAGE="$*"
+SESSION="codex-swarm"
+WINDOW="$SESSION:$NAME"
+
+if [ -z "$NAME" ] || [ -z "$MESSAGE" ]; then
+  echo "Usage: $0 agent-name \"message to send\""
+  exit 1
+fi
+
+if ! tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "❌ Tmux session '$SESSION' is not running."
+  exit 1
+fi
+
+if ! tmux list-windows -t "$SESSION" -F "#{window_name}" 2>/dev/null | grep -Fxq "$NAME"; then
+  echo "❌ Agent '$NAME' window not found in session '$SESSION'."
+  exit 1
+fi
+
+tmux send-keys -t "$WINDOW" "$MESSAGE" C-m
+tmux send-keys -t "$WINDOW" C-m
+echo "✅ Sent to $NAME → $MESSAGE"

package/scripts/spawn-agent.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+# USAGE:
+# ./spawn-agent.sh agent-name /path/to/dir [codex args...]
+
+SESSION="codex-swarm"
+NAME="$1"
+DIR="$2"
+shift 2
+CODEX_ARGS=("$@")
+
+if [[ -z "$NAME" || -z "$DIR" ]]; then
+  echo "Usage: $0 <agent-name> <working-directory> [codex args...]"
+  exit 1
+fi
+
+if [[ ! -d "$DIR" ]]; then
+  echo "❌ Working directory '$DIR' does not exist."
+  exit 1
+fi
+
+LOG_DIR="./logs"
+mkdir -p "$LOG_DIR"
+
+CODEX_CMD=(npx codex)
+
+if [[ ${#CODEX_ARGS[@]} -eq 0 ]]; then
+  CODEX_CMD+=(--full-auto --ask-for-approval never)
+else
+  ASK_FLAG_PRESENT=false
+  for ARG_INDEX in "${!CODEX_ARGS[@]}"; do
+    CURRENT_ARG="${CODEX_ARGS[$ARG_INDEX]}"
+    if [[ "$CURRENT_ARG" == "--ask-for-approval" || "$CURRENT_ARG" == "-a" ]]; then
+      ASK_FLAG_PRESENT=true
+      break
+    fi
+  done
+
+  CODEX_CMD+=("${CODEX_ARGS[@]}")
+
+  if [[ "$ASK_FLAG_PRESENT" == false ]]; then
+    CODEX_CMD+=(--ask-for-approval never)
+  fi
+fi
+
+printf -v CODEX_CMD_STR '%q ' "${CODEX_CMD[@]}"
+CODEX_CMD_STR="${CODEX_CMD_STR% }"
+printf -v WINDOW_CMD 'cd %q && %s' "$DIR" "$CODEX_CMD_STR"
+
+STDOUT_LOG="$LOG_DIR/${NAME}.log"
+
+tmux kill-window -t "$SESSION:$NAME" 2>/dev/null
+
+if ! tmux has-session -t "$SESSION" 2>/dev/null; then
+  tmux new-session -d -s "$SESSION" -n root
+fi
+
+tmux new-window -d -t "$SESSION" -n "$NAME" "$WINDOW_CMD"
+tmux pipe-pane -o -t "$SESSION:$NAME" "cat >> \"$STDOUT_LOG\""
+
+echo "Agent '$NAME' spawned in tmux session '$SESSION'."
+echo "  Send messages with: ./send-to-agent.sh $NAME \"<message>\""
+echo "  Output log: $STDOUT_LOG"

package/cli.js

@@ -1,81 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI tool for generating FILE_FLOWS.md
- * Analyzes project files and creates documentation showing data flow relationships
- * Following NPM architecture guidelines with modular structure
- * Refactored: Global const declarations moved to config/localVars.js
- */
-
-/**
- * CLI usage display functionality
- * Shows help information for the CLI tool
- */
-function showUsage() {
-  console.log(`Usage: node cli.js [options]`);
-  console.log(``);
-  console.log(`Options:`);
-  console.log(`  --dir <path>     Directory to analyze (default: current directory)`);
-  console.log(`  --output <file>  Output file path (default: FILE_FLOWS.md)`);
-  console.log(`  --help, -h       Show this help message`);
-  console.log(``);
-  console.log(`Examples:`);
-  console.log(`  node cli.js                    # Analyze current directory`);
-  console.log(`  node cli.js --dir ./src        # Analyze src directory`);
-  console.log(`  node cli.js --output flows.md  # Custom output file`);
-}
-
-/**
- * Main CLI logic
- * Parses arguments and executes file flows generation
- */
-async function main() {
-  const localVars = require(`./config/localVars`);
-  const { generateFileFlows } = localVars.getDependencies();
-  
-  const args = process.argv.slice(2);
-  let rootDir = localVars.DEFAULT_ROOT_DIR;
-  let outputFile = null;
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    
-    if (arg === `--help` || arg === `-h`) {
-      showUsage();
-      process.exit(0);
-    } else if (arg === `--dir`) {
-      if (i + 1 < args.length) {
-        rootDir = args[++i];
-      } else {
-        console.error(`Error: --dir requires a directory path`);
-        process.exit(1);
-      }
-    } else if (arg === `--output`) {
-      if (i + 1 < args.length) {
-        outputFile = args[++i];
-      } else {
-        console.error(`Error: --output requires a file path`);
-        process.exit(1);
-      }
-    } else {
-      console.error(`Error: Unknown argument '${arg}'`);
-      showUsage();
-      process.exit(1);
-    }
-  }
-
-  try {
-    console.log(`🚀 Generating FILE_FLOWS.md...`);
-    await generateFileFlows(rootDir, outputFile);
-    console.log(`🎉 Generation complete!`);
-  } catch (error) {
-    console.error(`❌ Error:`, error.message);
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-if (require.main === module) {
-  main().catch(console.error);
-}
-
-module.exports = { showUsage, main };

package/config/localVars.test.js

@@ -1,37 +0,0 @@
-// Auto-generated unit test for localVars.js - optimized for speed
-const mod = require('./localVars.js');
-
-describe('localVars.js', () => {
-  test('CODE_EXTENSIONS works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.CODE_EXTENSIONS).toBeDefined();
-  });
-  test('ALL_EXTENSIONS works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.ALL_EXTENSIONS).toBeDefined();
-  });
-  test('DEFAULT_ROOT_DIR works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.DEFAULT_ROOT_DIR).toBeDefined();
-  });
-  test('DEFAULT_OUTPUT_FILE works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.DEFAULT_OUTPUT_FILE).toBeDefined();
-  });
-  test('IGNORE_PATTERNS works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.IGNORE_PATTERNS).toBeDefined();
-  });
-  test('MAX_JSON_KEYS works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.MAX_JSON_KEYS).toBeDefined();
-  });
-  test('MAX_YAML_KEYS works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.MAX_YAML_KEYS).toBeDefined();
-  });
-  test('MAX_SHELL_COMMANDS works', async () => {
-    // Fast assertion - TODO: implement specific test logic
-    expect(typeof mod.MAX_SHELL_COMMANDS).toBeDefined();
-  });
-});

package/index.js

@@ -1,13 +0,0 @@
-/**
- * Main entry point for the file-flows-cli NPM module
- * Exports public functionality following NPM architecture guidelines
- * Refactored: Global const declarations moved to config/localVars.js
- */
-
-function getMainExport() {
-  const localVars = require(`./config/localVars`);
-  const { generateFileFlows } = localVars.getDependencies();
-  return generateFileFlows;
-}
-
-module.exports = getMainExport();

package/lib/SUMMARY.md

@@ -1,53 +0,0 @@
-# lib/ Directory Summary
-
-## Overview
-Core library modules for FILE_FLOWS.md generation, following Single Responsibility Principle with one function per file.
-
-## File Roles & Data Flow
-
-### Entry Points
-- **index.js** - Main module aggregator, exports all lib functions for external use
-- **fileFlowsGenerator.js** - Primary orchestrator, coordinates analysis and output generation
-
-### Analysis Pipeline
-1. **fileClassifier.js** - Classifies files by type (Code, Configuration, Documentation, etc.)
-2. **jsParser.js** - AST parsing for JavaScript/TypeScript files, extracts functions and imports
-3. **otherFileParser.js** - Simple parsing for non-JS files (JSON, MD, etc.)
-4. **dependencyExtractor.js** - Extracts import/require dependencies from file content
-
-### Grouping & Output
-5. **dataFlowGrouper.js** - Groups files by actual data flow relationships and naming patterns
-
-## Request/Response Flows
-
-### Main Generation Flow
-```
-generateFileFlows(rootDir, outputFile)
-├── globby scan for files
-├── groupByDataFlow(files, rootDir)
-│   ├── classifyFile(filePath, ext) for each file
-│   ├── parseJSFile(filePath, content) OR parseOtherFile(filePath, content)
-│   ├── extractDependencies(content) for dependency mapping
-│   └── clustering algorithms for flow grouping
-└── markdown output generation
-```
-
-### Data Dependencies
-- **config/localVars.js** - Centralized constants (file extensions, ignore patterns, etc.)
-- **External**: globby (file discovery), @babel/parser & @babel/traverse (AST parsing)
-
-## Known Side Effects
-- **File System**: Reads all project files matching configured extensions
-- **Output**: Overwrites FILE_FLOWS.md without backup
-- **Memory**: Processes entire project file tree in memory
-- **Performance**: AST parsing scales with codebase size
-
-## Edge Cases & Caveats
-- **Large Projects**: Memory usage grows with file count and complexity
-- **Binary Files**: Ignored via gitignore patterns but may cause issues if included
-- **Circular Dependencies**: Detected but may create complex flow groups
-- **ES Modules vs CommonJS**: Mixed module systems handled via dynamic imports
-- **Parse Errors**: Individual file failures don't stop overall generation
-
-## AI Agent Task Anchors
-See individual files for specific `// 🚩AI:` markers indicating critical update points.