autodocs-engine 0.9.8 → 0.10.0

package/README.md

@@ -1,6 +1,6 @@
 # autodocs-engine
 
-Deterministic codebase intelligence for AI coding tools.
+Codebase intelligence for AI coding agents. Analyzes TypeScript/JavaScript codebases and serves actionable intelligence via MCP.
 
 [![npm version](https://img.shields.io/npm/v/autodocs-engine)](https://www.npmjs.com/package/autodocs-engine)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
@@ -8,172 +8,176 @@ Deterministic codebase intelligence for AI coding tools.
 
 ## What It Does
 
-Analyzes TypeScript/JavaScript codebases and extracts actionable intelligence — commands, conventions, file coupling patterns, contribution recipes, architecture — that AI coding tools need to write code that fits your project.
+Gives AI coding agents deep understanding of your codebase — not just what files exist, but how they connect, what conventions to follow, and what breaks when you change something. Combines AST analysis, git history mining, and import graph intelligence to answer questions no other tool can:
 
-Two ways to use it:
-
-1. **MCP Server** — Live codebase queries via Model Context Protocol. AI tools ask for exactly the context they need, on demand.
-2. **AGENTS.md Generator** — Static context file for universal compatibility. Works with every tool that reads AGENTS.md, CLAUDE.md, or .cursorrules.
+- **"What files should I also check when modifying `src/types.ts`?"** → Import dependents, co-change partners from git history, implicit coupling (files that change together without import relationships), and affected execution flows.
+- **"Which specific files import `Convention` from `src/types.ts`?"** → 25 files (not all 98 importers of the file — only the ones using that symbol).
+- **"What caused this test failure?"** → Ranked suspect files with confidence assessment, validated on 95 real bug-fix commits across 10 repos.
+- **"What patterns should I follow?"** → 13 convention detectors covering error handling, async patterns, state management, API patterns, hooks, testing, and more.
 
 ## Quick Start
 
 ```bash
-# Generate a focused AGENTS.md (no API key needed)
-npx autodocs-engine init
-
-# Or start the MCP server for live queries
-npx autodocs-engine serve
-```
+# MCP server for Claude Code
+claude mcp add autodocs -- npx autodocs-engine serve
 
-### MCP Server Setup (Claude Code)
+# Install Claude Code hooks (automatic search augmentation)
+npx autodocs-engine setup-hooks
 
-```bash
-claude mcp add autodocs -- npx autodocs-engine serve
+# Or generate a focused AGENTS.md (no API key needed)
+npx autodocs-engine init
 ```
 
-This gives Claude Code 13 codebase intelligence tools:
+## MCP Tools (13)
 
 | Tool | What It Returns |
 |------|----------------|
 | `get_commands` | Build, test, lint commands with exact flags |
-| `get_architecture` | Directory structure, entry points, package type |
-| `get_conventions` | DO/DON'T rules with confidence levels (filterable by category) |
-| `get_workflow_rules` | File coupling and co-change patterns (filterable by file) |
-| `get_contribution_guide` | How to add new code, with inline example snippets |
-| `get_exports` | Public API with usage examples and parameter shapes |
-| `analyze_impact` | Blast radius + importers + co-change partners for a file |
+| `get_architecture` | Directory structure, entry points, execution flows |
+| `get_conventions` | DO/DON'T rules from 13 detectors (error handling, async, state management, API patterns, hooks, testing, file naming, import ordering, frameworks, databases, data fetching, build tools) |
+| `get_workflow_rules` | File coupling and co-change patterns |
+| `get_contribution_guide` | How to add code, with inline examples and registration steps |
+| `get_exports` | Public API with resolved TypeScript types (parameter types, return types) |
+| `analyze_impact` | Blast radius: importers, callers, co-change partners |
+| `plan_change` | Full change plan: dependents, co-changes, implicit coupling, execution flows, registration/barrel updates, tests. **With optional `symbols` parameter: narrows dependents to files importing specific symbols.** |
+| `get_test_info` | Test file path + exact per-file run command |
+| `auto_register` | Exact code insertions for registration + barrel updates |
+| `review_changes` | Pattern compliance: suffix, imports, registration, barrel, tests |
+| `diagnose` | Root cause analysis with confidence level (high/medium/low), import path traces, and 7 scoring signals |
 | `list_packages` | Monorepo package inventory |
-| `plan_change` | Full change plan: dependents, co-changes, registrations, tests, checklist |
-| `get_test_info` | Test file path + exact per-file run command for any source file |
-| `auto_register` | Exact code insertions for registration files + barrel updates |
-| `review_changes` | Pattern compliance check: suffix, imports, registration, barrel, tests |
-| **`diagnose`** | **Root cause analysis: traces test failures to suspect files via import graph, git co-change, and call graph** |
-
-## Why Minimal Mode?
 
-Research shows comprehensive context files can actually **hurt** AI performance:
+Every tool response includes **next-step hints** guiding the agent to the logical next action.
 
-- LLM-generated AGENTS.md: **-0.5% to -2%** accuracy ([arxiv 2602.11988](https://arxiv.org/abs/2602.11988))
-- Developer-written focused AGENTS.md: **+4%** accuracy, **-29% runtime** ([arxiv 2601.20404](https://arxiv.org/abs/2601.20404))
+## What Makes It Different
 
-The difference: developer-written files are short, focused, and only include what the AI can't figure out on its own. That's exactly what `--minimal` generates.
+### Git Co-Change Intelligence
+Mines commit history using Jaccard similarity to find files that frequently change together. Produces workflow rules ("when modifying X, also check Y") and **implicit coupling** — file pairs that co-change but have no import relationship. This catches the "forgotten file" that static analysis misses.
 
-**Minimal mode** (~200-450 tokens) includes only:
-- Exact commands with flags (proven to help, never hurts)
-- Workflow rules from git co-change analysis (patterns the AI can't discover from code)
-- High-confidence conventions (only if ≥95% consistent and non-obvious)
-- Non-obvious directories (with "non-exhaustive" qualifier to prevent anchoring)
-
-**Full mode** (~1,500-2,500 tokens) adds public API, dependency graphs, all conventions, and architecture details. Use `--full` when you need comprehensive documentation.
-
-## How It Works
+### Convention Detection (13 Detectors)
+Extracts real coding patterns from AST analysis, not configured rules:
+- Error handling: custom error classes, Result/Either patterns, typed error hierarchies
+- Async patterns: Promise.all usage, sequential-await-in-loops detection, AbortController
+- State management: Redux, Zustand, Jotai, MobX, Signals, Context API (reports all, not just dominant)
+- API patterns: Express, Fastify, Hono, NestJS, tRPC, GraphQL (framework-aware, not directory heuristics)
+- Plus: hooks, testing, file naming, import ordering, web frameworks, databases, data fetching, build tools
 
-Unlike tools that dump code into an LLM or pack everything into one file, autodocs-engine uses deterministic static analysis:
+### Symbol-Level Filtering
+```
+plan_change({ files: ["src/types.ts"], symbols: ["Convention"] })
+```
+Narrows 98 dependents to 25 — only files that actually import `Convention`. Every other tool shows all dependents regardless of which symbol you're changing.
 
-1. **Parse** — AST analysis via TypeScript Compiler API
-2. **Detect** — 9 convention detectors (naming, hooks, testing, import ordering, frameworks, etc.)
-3. **Extract** — Commands from package.json, turbo.json, biome.json, and 10+ config formats
-4. **Graph** — Call graph, import chains, and git co-change analysis (Jaccard similarity)
-5. **Score** — Inferability scoring decides what's worth including vs. what the AI already knows
-6. **Generate** — 14/16 sections are deterministic (no LLM). Only architecture summary and domain terms use optional micro-LLM calls.
+### Type-Aware Analysis
+Opt-in `--type-checking` creates a TypeScript Program for resolved parameter types and return types:
+```
+analyze(options: Partial<ResolvedConfig> & { packages: string[] }): Promise<StructuredAnalysis>
+```
+Not text extraction — actual TypeChecker resolution through re-export chains.
 
-**No API key needed** for minimal mode or JSON output. The analysis is pure computation.
+### Execution Flow Tracing
+Detects execution paths from entry points through the call graph:
+```
+runPipeline → analyzePackage → buildSymbolGraph → computeImpactRadius (4 steps, 4 files)
+```
+Scored by co-change confidence — flows through files that frequently change together are higher confidence.
 
-## Output Formats
+### Validated Diagnose Tool
+Tested against **95 real bug-fix commits across 10 repos**:
+- Unit-test repos: **83% recall@3** (root cause in top 3 suspects)
+- All repos: **47% recall@3**, **33% precision@1**
+- Confidence assessment based on signal quality and score discrimination
 
+### Claude Code Hooks
 ```bash
-npx autodocs-engine init                         # Focused AGENTS.md (~300 tokens, no API key)
-npx autodocs-engine init --full                  # Comprehensive AGENTS.md (needs API key)
-npx autodocs-engine analyze . --format json      # Raw analysis JSON
-npx autodocs-engine analyze . --format claude.md # CLAUDE.md format
-npx autodocs-engine analyze . --format cursorrules # .cursorrules format
+npx autodocs-engine setup-hooks
 ```
+Installs PreToolUse + PostToolUse hooks:
+- **PreToolUse**: When you grep for "validateUser", automatically shows callers, co-change partners, and execution flows alongside results
+- **PostToolUse**: After `git commit`, detects when analysis cache is stale
 
-## Monorepo Support
-
-Auto-detects workspace packages from `pnpm-workspace.yaml`, `workspaces` field in package.json, `turbo.json`, or `nx.json`:
+## Claude Code Setup
 
 ```bash
-npx autodocs-engine init    # Works for monorepos too
-```
+# Add MCP server
+claude mcp add autodocs -- npx autodocs-engine serve
 
-For explicit control:
+# Install hooks for automatic search augmentation
+npx autodocs-engine setup-hooks
+```
 
+With `--type-checking` for resolved TypeScript types:
 ```bash
-npx autodocs-engine analyze packages/app packages/hooks packages/ui \
-  --format agents.md --hierarchical --root .
+claude mcp add autodocs -- npx autodocs-engine serve --type-checking
 ```
 
-## Staleness Detection
+## AGENTS.md Generation
 
-Check if your AGENTS.md needs updating (for CI):
+For tools without MCP support:
 
 ```bash
-npx autodocs-engine check
+npx autodocs-engine init                         # Focused (~300 tokens, no API key)
+npx autodocs-engine init --full                  # Comprehensive (needs API key)
 ```
 
-Returns exit code 1 if conventions have drifted. Useful in CI pipelines to keep context files honest.
-
-## Tested On
-
-| Repo | Files | Time | Token Count (minimal) |
-|------|------:|-----:|:-----:|
-| autodocs-engine | 115 | 450ms | ~443 |
-| vitest | 1,200+ | 1.2s | ~307 |
-| nitro | 469 | 220ms | ~121 |
-| sanity | 3,746 | 1.6s | — |
-| medusa | 720 | 316ms | — |
+Research-backed: focused context files improve AI accuracy by +4% and reduce runtime by 29%. LLM-generated comprehensive files hurt by -2%.
 
-569 tests. Zero type errors. 13 MCP tools. Zero technology hallucinations across all tested repos.
+## CLI Reference
 
-## Library API
+```
+autodocs-engine init [--full]                 Generate AGENTS.md
+autodocs-engine serve [path] [options]        Start MCP server
+autodocs-engine setup-hooks                   Install Claude Code hooks
+autodocs-engine check                         Staleness detection for CI
+autodocs-engine analyze [paths...] [options]  Analyze specific packages
 
-```typescript
-import { analyze, generateMinimalAgentsMd } from 'autodocs-engine';
+Options:
+  --type-checking    Enable resolved TypeScript types (requires tsconfig.json)
+  --minimal          Focused output (<500 tokens, default for init)
+  --full             Comprehensive output (requires ANTHROPIC_API_KEY)
+  --format, -f       json | agents.md | claude.md | cursorrules
+  --verbose, -v      Timing and analysis details
+  --dry-run          Print to stdout (no file writes)
+```
 
-// Analyze (pure computation, no API key)
-const analysis = await analyze({ packages: ['./packages/my-pkg'] });
+## How It Works
 
-// Generate minimal AGENTS.md (no API key)
-const minimal = generateMinimalAgentsMd(analysis);
+18-stage analysis pipeline:
 
-// Or use the full deterministic format (optional API key for 2 LLM sections)
-import { formatDeterministic } from 'autodocs-engine';
-const full = await formatDeterministic(analysis, config);
-```
+1. **File Discovery** → git ls-files with .gitignore respect
+2. **AST Parsing** → TypeScript Compiler API for exports, imports, call references
+3. **Symbol Graph** → barrel resolution, re-export chains, call graph construction
+4. **Import Chain** → file-to-file coupling with confidence scores
+5. **Tier Classification** → public API (T1), internal (T2), test/generated (T3)
+6. **Type Enrichment** → optional ts.Program for resolved parameter/return types
+7. **Convention Extraction** → 13 detectors with structured confidence metrics
+8. **Git History Mining** → co-change mining with Jaccard similarity, adaptive thresholds
+9. **Implicit Coupling** → co-change pairs with no import relationship
+10. **Execution Flow Tracing** → entry point scoring, spine-first BFS, co-change validation
+11. **Impact Classification** → high/medium/low impact scoring on conventions
+12. **Workspace Auto-Detection** → monorepo roots expand to workspace packages
 
-## Configuration
+5 production dependencies. No native bindings, no graph database, no WASM. Installs instantly.
 
-Optional `autodocs.config.json`:
+## Stats
 
-```json
-{
-  "exclude": ["**/vendor/**", "**/generated/**"],
-  "conventions": { "disable": ["telemetry-patterns"] }
-}
-```
+- 713 tests across 53 files
+- 13 MCP tools with next-step hints
+- 13 convention detectors
+- 95-commit diagnose validation corpus (10 repos)
+- 10 execution flows detected on medium codebases
+- Zero type errors, zero technology hallucinations
 
-Most options are auto-detected. Zero config is the default.
+## Library API
 
-## CLI Reference
+```typescript
+import { analyze, generateMinimalAgentsMd } from 'autodocs-engine';
 
-```
-autodocs-engine init [--full]              Generate AGENTS.md (minimal by default, no API key)
-autodocs-engine serve [path]               Start MCP server
-autodocs-engine check                      Check if AGENTS.md needs regeneration
-autodocs-engine analyze [paths...] [options]
+const analysis = await analyze({
+  packages: ['./'],
+  typeChecking: true,  // optional: resolved TypeScript types
+});
 
-Options:
-  --full             Comprehensive output (requires ANTHROPIC_API_KEY)
-  --minimal          Focused output (<500 tokens, no API key needed — default for init)
-  --telemetry        Enable session telemetry (writes to ~/.autodocs/telemetry/)
-  --format, -f       json | agents.md | claude.md | cursorrules
-  --output, -o       Output directory (default: .)
-  --root             Monorepo root directory
-  --hierarchical     Root + per-package output
-  --merge            Preserve human-written sections when regenerating
-  --verbose, -v      Timing details
-  --dry-run          Print to stdout (no file writes)
+const agentsMd = generateMinimalAgentsMd(analysis);
 ```
 
 ## Contributing
@@ -182,11 +186,13 @@ Options:
 git clone https://github.com/msiric/autodocs-engine.git
 cd autodocs-engine
 npm install
-npm test          # 569 tests
+npm test          # 713 tests
 npm run typecheck # Zero errors
 npm run build
 ```
 
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow.
+
 ## License
 
 [MIT](LICENSE)

package/dist/anti-pattern-detector.js

@@ -23,6 +23,28 @@ const INVERSION_RULES = [
         rule: () => "Do NOT return arrays from hooks (use { value, setter } not [value, setter])",
         reason: (c) => `${c.confidence.description} return objects from hooks`,
     },
+    // Phase 1A: Error handling inversions (project-relative, not prescriptive)
+    {
+        match: /typed error class hierarchy/i,
+        rule: (c) => `Do NOT use inline new Error() for domain errors — use typed error subclasses (${c.examples?.[0] ?? "see existing error classes"})`,
+        reason: (c) => `${c.confidence.description} define typed error class hierarchies`,
+    },
+    {
+        match: /Result\/Either pattern|Custom Result type/i,
+        rule: () => "Do NOT throw exceptions for expected failures — use Result types",
+        reason: (c) => `${c.confidence.description} use Result/Either types for error handling`,
+    },
+    // Phase 1B: Async pattern inversions
+    {
+        match: /Promise\.all concurrent/i,
+        rule: () => "Do NOT await independent async operations sequentially — use Promise.all/allSettled",
+        reason: (c) => `${c.confidence.description} use Promise.all for concurrent operations`,
+    },
+    {
+        match: /Sequential await in loops/i,
+        rule: () => "Do NOT use await inside loops for independent operations — batch with Promise.all",
+        reason: (c) => `${c.confidence.description} contain sequential await in loops`,
+    },
 ];
 /**
  * Derive anti-patterns from conventions.

package/dist/anti-pattern-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"anti-pattern-detector.js","sourceRoot":"","sources":["../src/anti-pattern-detector.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0DAA0D;AAI1D,sFAAsF;AACtF,wFAAwF;AACxF,MAAM,eAAe,GAIf;IACJ;QACE,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,GAAG,EAAE,CAAC,kDAAkD;QAC9D,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,sEAAsE;KACjH;IACD;QACE,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,GAAG,EAAE,CAAC,mDAAmD;QAC/D,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,oEAAoE;KAC/G;IACD;QACE,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,GAAG,EAAE,CAAC,kFAAkF;QAC9F,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,uCAAuC;KAClF;IACD;QACE,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,GAAG,EAAE,CAAC,6EAA6E;QACzF,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,4BAA4B;KACvE;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAyB;IAC1D,MAAM,YAAY,GAAkB,EAAE,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QACvC,IAAI,GAAG,GAAG,EAAE;YAAE,SAAS,CAAC,sCAAsC;QAE9D,MAAM,UAAU,GAAsB,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAEpE,0BAA0B;QAC1B,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACzB,UAAU;oBACV,WAAW,EAAE,IAAI,CAAC,IAAI;iBACvB,CAAC,CAAC;gBACH,MAAM,CAAC,oCAAoC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,iBAA+B;IACtE,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"anti-pattern-detector.js","sourceRoot":"","sources":["../src/anti-pattern-detector.ts"],"names":[],"mappings":"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"}

package/dist/architecture-detector.js

@@ -95,42 +95,46 @@ function classifyByDependencies(packageDir) {
     }
     return undefined;
 }
+const SKIP_DIR_NAMES = new Set(["node_modules", "dist", "build", "coverage", ".git", ".next", ".turbo"]);
+const MAX_DIR_DEPTH = 2;
 function detectDirectories(parsedFiles, packageDir, publicAPI) {
     const dirs = [];
     // Look for src/ directory first
     const srcDir = join(packageDir, "src");
     const baseDir = existsSync(srcDir) ? srcDir : packageDir;
     const baseDirRel = existsSync(srcDir) ? "src" : "";
-    try {
-        const entries = readdirSync(baseDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            if (entry.name.startsWith(".") || entry.name === "node_modules")
-                continue;
-            const dirRelPath = baseDirRel ? `${baseDirRel}/${entry.name}` : entry.name;
-            const filesInDir = parsedFiles.filter((f) => f.relativePath.startsWith(`${dirRelPath}/`) && !f.isTestFile && !f.isGeneratedFile);
-            if (filesInDir.length === 0)
-                continue;
-            const purpose = DIRECTORY_PURPOSES[entry.name] ?? `Feature: ${entry.name}`;
-            // Enhancement 2: Map public exports to this directory
-            const dirExports = publicAPI.filter((e) => e.sourceFile.startsWith(`${dirRelPath}/`)).map((e) => e.name);
-            // Enhancement 2: Detect file naming pattern
-            const pattern = detectFilePattern(filesInDir.map((f) => {
-                const parts = f.relativePath.split("/");
-                return parts[parts.length - 1];
-            }));
-            dirs.push({
-                path: dirRelPath,
-                purpose,
-                fileCount: filesInDir.length,
-                exports: dirExports,
-                pattern,
-            });
+    // BFS scan to depth MAX_DIR_DEPTH — finds workspace package subdirectories in monorepos
+    const queue = [
+        { absDir: baseDir, relPath: baseDirRel, depth: 0 },
+    ];
+    while (queue.length > 0) {
+        const { absDir, relPath, depth } = queue.shift();
+        try {
+            for (const entry of readdirSync(absDir, { withFileTypes: true })) {
+                if (!entry.isDirectory())
+                    continue;
+                if (entry.name.startsWith(".") || SKIP_DIR_NAMES.has(entry.name))
+                    continue;
+                const entryRel = relPath ? `${relPath}/${entry.name}` : entry.name;
+                const filesInDir = parsedFiles.filter((f) => f.relativePath.startsWith(`${entryRel}/`) && !f.isTestFile && !f.isGeneratedFile);
+                if (filesInDir.length === 0)
+                    continue;
+                const purpose = DIRECTORY_PURPOSES[entry.name] ?? `Feature: ${entry.name}`;
+                const dirExports = publicAPI.filter((e) => e.sourceFile.startsWith(`${entryRel}/`)).map((e) => e.name);
+                const pattern = detectFilePattern(filesInDir.map((f) => {
+                    const parts = f.relativePath.split("/");
+                    return parts[parts.length - 1];
+                }));
+                dirs.push({ path: entryRel, purpose, fileCount: filesInDir.length, exports: dirExports, pattern });
+                // Queue subdirectories for next depth
+                if (depth < MAX_DIR_DEPTH) {
+                    queue.push({ absDir: join(absDir, entry.name), relPath: entryRel, depth: depth + 1 });
+                }
+            }
+        }
+        catch {
+            /* can't read directory */
         }
-    }
-    catch {
-        // Can't read directory
     }
     return dirs.sort((a, b) => b.fileCount - a.fileCount);
 }

package/dist/architecture-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"architecture-detector.js","sourceRoot":"","sources":["../src/architecture-detector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"architecture-detector.js","sourceRoot":"","sources":["../src/architecture-detector.ts"],"names":[],"mappings":"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"}

package/dist/ast-parser.js

@@ -369,6 +369,9 @@ function walkForDynamicImports(node, imports) {
 function computeContentSignals(content, sourceFile) {
     // AST-based signals (E-17)
     let tryCatchCount = 0;
+    let promiseAllCount = 0;
+    let asyncFunctionCount = 0;
+    let awaitInLoopCount = 0;
     const hookCounts = {
         useMemo: 0,
         useCallback: 0,
@@ -377,23 +380,45 @@ function computeContentSignals(content, sourceFile) {
         useQuery: 0,
         useMutation: 0,
     };
-    function walkForSignals(node) {
+    function walkForSignals(node, insideLoop = false) {
         if (ts.isTryStatement(node)) {
             tryCatchCount++;
         }
+        // Phase 1B: Async pattern signals
+        if ((ts.isFunctionDeclaration(node) || ts.isArrowFunction(node) || ts.isMethodDeclaration(node)) &&
+            node.modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword)) {
+            asyncFunctionCount++;
+        }
+        if (ts.isAwaitExpression(node) && insideLoop) {
+            awaitInLoopCount++;
+        }
+        // Track if we're inside a loop for await-in-loop detection
+        const isLoop = ts.isForStatement(node) ||
+            ts.isForOfStatement(node) ||
+            ts.isForInStatement(node) ||
+            ts.isWhileStatement(node) ||
+            ts.isDoStatement(node);
         if (ts.isCallExpression(node)) {
             let calleeName;
             if (ts.isIdentifier(node.expression)) {
                 calleeName = node.expression.text;
             }
             else if (ts.isPropertyAccessExpression(node.expression)) {
-                calleeName = node.expression.name.text;
+                // Detect Promise.all/allSettled/race
+                const obj = node.expression.expression;
+                const method = node.expression.name.text;
+                if (ts.isIdentifier(obj) &&
+                    obj.text === "Promise" &&
+                    (method === "all" || method === "allSettled" || method === "race")) {
+                    promiseAllCount++;
+                }
+                calleeName = method;
             }
             if (calleeName && calleeName in hookCounts) {
                 hookCounts[calleeName]++;
             }
         }
-        ts.forEachChild(node, walkForSignals);
+        ts.forEachChild(node, (child) => walkForSignals(child, insideLoop || isLoop));
     }
     walkForSignals(sourceFile);
     // Regex-based signals (E-17: keep — no clean AST equivalent)
@@ -408,6 +433,9 @@ function computeContentSignals(content, sourceFile) {
         useStateCount: hookCounts.useState,
         useQueryCount: hookCounts.useQuery,
         useMutationCount: hookCounts.useMutation,
+        promiseAllCount,
+        asyncFunctionCount,
+        awaitInLoopCount,
         jestMockCount,
         hasDisplayName,
         hasErrorBoundary,