@nebutra/next-unicorn-skill 1.0.6 → 1.0.7

package/SKILL.md

@@ -2,10 +2,12 @@
 name: analyze-and-recommend-third-party-optimizations
 description: >-
   Scan a codebase to identify hand-rolled implementations that should be replaced
-  by third-party libraries, and identify missing capabilities the project should
-  have. Produce structured migration plans with Context7-verified recommendations.
+  by third-party libraries, identify missing capabilities, and detect code
+  organization issues (directory structure, naming, circular deps, barrel bloat).
+  Produce structured migration plans with Context7-verified recommendations.
   Use when analyzing technical debt, auditing dependency health, reviewing
-  hand-rolled code, planning library migrations, or assessing capability gaps.
+  hand-rolled code, planning library migrations, assessing capability gaps,
+  or auditing project structure and module organization.
 ---
 
 # Analyze and Recommend Third-Party Optimizations
@@ -13,10 +15,11 @@ description: >-
 ## Architecture
 
 ```
-Scanner (deterministic)     →  AI Agent (generative)           →  Pipeline (deterministic)
-Regex patterns detect          1. Recommend replacements           Score, plan, audit,
-hand-rolled code               2. Identify capability gaps         filter, serialize
-                               using knowledge + Context7
+Scanner (deterministic)          →  AI Agent (generative)           →  Pipeline (deterministic)
+1. Regex: detect hand-rolled code   1. Recommend library replacements    Score, plan, audit,
+2. FS: detect code org issues       2. Identify capability gaps          filter, serialize
+   (god-dirs, circular deps,        3. Recommend org patterns + tooling
+    naming, barrel bloat)            using knowledge + Context7
 ```
 
 **Design constraints**:
@@ -34,11 +37,16 @@ Parse and validate `InputSchema` JSON via Zod. Read `src/schemas/input.schema.ts
 Run `scanCodebase(input)`. The scanner:
 
 1. Detect workspace roots for monorepo support
-2. Match code against 20+ domain patterns (i18n, auth, state-management, etc.)
-3. Record each detection with: file path, line range, pattern category, confidence score, domain
-4. Return `ScanResult` with detections and workspace info
+2. Match code against 30+ domain patterns (i18n, auth, state-management, code-organization, etc.)
+3. Run structural analysis: design system layers (monorepo), code organization (all projects)
+4. Record each detection with: file path, line range, pattern category, confidence score, domain
+5. Return `ScanResult` with:
+   - `detections` — hand-rolled code patterns found
+   - `structuralFindings` — architectural + code organization issues
+   - `codeOrganizationStats` — project-wide metrics (file counts, naming conventions, circular dep count)
+   - `workspaces` — monorepo workspace info
 
-Detections contain no library suggestions — only what was detected and where.
+Detections and findings contain no recommendations — only facts. The AI agent interprets them.
 
 ### Step 2.5: Gap Analysis (AI Agent)
 
@@ -60,6 +68,98 @@ Provide each gap as a `GapRecommendation`. Read `src/index.ts` for the interface
 - **No existing frontend**: Scaffold from reference repos. Read `references/design-system-sources.md` for curated sources and sparse-checkout workflow.
 - **Existing frontend without formal design system**: First extract the spec (audit → tokens → classify → document) via `references/design-system-extraction.md`, then implement the architecture via `references/design-system-sources.md`.
 
+### Step 2.7: Code Organization Analysis
+
+#### Phase A — Deterministic: Collect facts (MUST use tools, DO NOT estimate)
+
+You cannot infer file counts, naming conventions, or import cycles from knowledge. You MUST read the filesystem.
+
+**If using the npm library** — `scanResult.structuralFindings` and `scanResult.codeOrganizationStats` already contain all findings. Skip to Phase B.
+
+**If not using the npm library** — run these shell commands to collect facts:
+
+```bash
+# 1. God directories: find directories with >15 source files
+find src -type d -exec sh -c 'count=$(find "$1" -maxdepth 1 -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" \) | wc -l); [ "$count" -gt 15 ] && echo "$1: $count files"' _ {} \;
+
+# 2. Mixed naming: list filenames per directory for manual inspection
+ls -1 src/components/  # check if kebab-case and camelCase are mixed
+
+# 3. Deep nesting: find directories >5 levels deep from src/
+find src -mindepth 6 -type d
+
+# 4. Barrel bloat: count re-exports in index files
+grep -c "export.*from" src/**/index.ts
+
+# 5. Catch-all directories: count files in utils/helpers/shared
+find src/utils src/helpers src/shared src/common src/lib -maxdepth 1 -type f 2>/dev/null | wc -l
+
+# 6. Circular dependencies: use npx if madge is not installed
+npx madge --circular --extensions ts,tsx src/
+
+# 7. Deep relative imports: find ../../../ patterns
+grep -rn "from ['\"]\.\.\/\.\.\/\.\.\/" src/ --include="*.ts" --include="*.tsx"
+```
+
+Record each finding with: **directory/file path, count, type**. These are facts.
+
+#### Phase B — Generative: Recommend solutions (use your knowledge + Context7)
+
+For each finding from Phase A, apply the decision tree below. **Do NOT recommend tools without Context7 verification.**
+
+| Finding type | You MUST do | You MUST NOT do |
+|---|---|---|
+| `god-directory` | Read the files in that dir, group by domain, recommend split. Reference: Next.js App Router colocation, Linear feature-packages. | Guess file count. Say "probably too many files." |
+| `mixed-naming-convention` | Check project framework → pick ONE convention. Next.js pages=kebab, React components=PascalCase, utils=camelCase. | Recommend "both are fine." Must pick one. |
+| `deep-nesting` | Recommend `@/` path aliases. Read `tsconfig.json` to check if paths already exist. Generate the config change. | Say "consider flattening" without generating the actual config. |
+| `barrel-bloat` | Recommend direct imports or namespace imports. Context7 verify `knip` for dead export detection. | Ignore it. Barrel bloat causes tree-shaking failures. |
+| `catch-all-directory` | Read the actual files, group by domain (date, string, validation, etc.), recommend specific directory structure. | Say "split by concern" without reading what's actually in the files. |
+| `circular-dependency` | Read the files in the cycle, understand WHY they import each other, recommend dependency inversion or extract shared module. Context7 verify `eslint-plugin-import`. | Just say "remove circular deps." Must explain the refactoring. |
+| `org-deep-relative-import` | Same as `deep-nesting` — recommend path aliases. | Skip it. |
+| `org-barrel-reexport-wildcard` | Recommend named re-exports `export { X } from` instead of `export *`. Explain namespace pollution risk. | Ignore it. |
+| `org-catch-all-utils-import` | Same as `catch-all-directory` — recommend domain-specific modules. | Skip it. |
+
+#### Phase B examples
+
+**Example 1 — god-directory finding**:
+```
+Fact: src/components/ has 23 source files
+```
+Read those 23 files. You find: Button, Card, Modal, Table, Form, Input, Select, Checkbox...
+
+Recommend:
+```
+src/components/
+├── ui/          ← primitives (Button, Input, Select, Checkbox)
+├── data/        ← data display (Table, Card, DataGrid)
+├── overlay/     ← overlays (Modal, Dialog, Drawer, Tooltip)
+└── form/        ← form elements (Form, FormField, FormError)
+```
+Reference: shadcn/ui organizes by interaction type. Radix UI uses similar grouping.
+
+**Example 2 — circular-dependency finding**:
+```
+Fact: src/auth/session.ts → src/db/user.ts → src/auth/session.ts
+```
+Read both files. You find: `session.ts` imports `getUserById`, `user.ts` imports `getSession` for auth checks.
+
+Recommend: Extract `src/auth/types.ts` with shared interfaces. Both files import from types instead of each other. Context7 verify `eslint-plugin-import/no-cycle`.
+
+**Example 3 — mixed-naming finding**:
+```
+Fact: src/utils/ has kebab-case (5 files) + camelCase (3 files)
+```
+Check package.json → framework is Next.js → convention is kebab-case for files.
+
+Recommend: Rename the 3 camelCase files. Context7 verify `eslint-plugin-unicorn/filename-case` for CI enforcement.
+
+#### Skip rules
+
+Skip a code organization finding if:
+- Directory is in `tests/`, `__tests__/`, `__mocks__/`, `fixtures/`, `generated/`, `.storybook/`
+- File is auto-generated (has `// @generated` or `/* eslint-disable */` at top)
+- Directory has <3 files (too few to judge naming convention)
+
 ### Step 3: Recommend Solutions (AI Agent)
 
 For each scanner detection, recommend a **solution**. Consider:
@@ -94,6 +194,14 @@ The pipeline handles these automatically:
 - **Step 9**: Auto-update existing dependencies (`registryClient`)
 - **Step 10**: PR auto-creation via GitHub/GitLab (`platformClient` + `gitOps`)
 
+## MCP Integration
+
+Prefer MCP tools when available; fall back to shell commands if not.
+
+- **Context7 MCP** (required) — `resolve-library-id` + `query-docs` for library verification
+- **GitHub MCP** (preferred for PRs) — structured PR create/update/query; fallback: `gh` CLI
+- **Git MCP / GitKraken MCP** (preferred for scaffold) — structured repo browse/sparse-checkout; fallback: `git` CLI
+
 ## Output
 
 Single `OutputSchema` JSON containing:

package/dist/analyzer/code-organization-analyzer.d.ts

@@ -0,0 +1,26 @@
+import type { StructuralFinding } from './structure-analyzer.js';
+export interface CodeOrganizationAnalysis {
+    findings: StructuralFinding[];
+    stats: {
+        totalSourceFiles: number;
+        maxDirectoryDepth: number;
+        /** Naming convention distribution: kebab → count, camelCase → count, etc. */
+        namingConventions: Record<string, number>;
+        circularDependencyCount: number;
+    };
+}
+/**
+ * Analyze project code organization for structural issues.
+ *
+ * Deterministic filesystem analysis that Claude cannot replicate:
+ * - Counts files per directory (god directories)
+ * - Reads filenames to check naming conventions
+ * - Measures directory nesting depth
+ * - Counts re-exports in barrel files
+ * - Builds import graph to detect circular dependencies
+ *
+ * Recommendations (which pattern to adopt, which tools to use)
+ * are the AI agent's responsibility.
+ */
+export declare function analyzeCodeOrganization(repoPath: string): CodeOrganizationAnalysis;
+//# sourceMappingURL=code-organization-analyzer.d.ts.map

package/dist/analyzer/code-organization-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-organization-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/code-organization-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAMjE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,KAAK,EAAE;QACL,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,6EAA6E;QAC7E,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAuND;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAmMlF"}

package/dist/analyzer/code-organization-analyzer.js

@@ -0,0 +1,389 @@
+import fs from 'node:fs';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants — thresholds for code organization heuristics
+//
+// These thresholds are informed by the directory structures of
+// Vercel (Next.js), Stripe (API docs), Linear, Supabase, shadcn/ui, Dub,
+// and other reference Silicon Valley products. They represent the point
+// where hand-rolled organization becomes unmaintainable and tools
+// (eslint-plugin-import, knip, Barrel-file analyzers) are justified.
+//
+// Claude cannot determine these values without filesystem access.
+// ---------------------------------------------------------------------------
+/** Max source files in a single directory before it becomes a "god directory" */
+const GOD_DIRECTORY_THRESHOLD = 15;
+/** Max directory nesting depth from project root (src/) */
+const MAX_NESTING_DEPTH = 5;
+/** Max re-export lines in a barrel file */
+const BARREL_BLOAT_THRESHOLD = 10;
+/** Max files in a catch-all directory (utils/, helpers/, shared/, common/, lib/) */
+const CATCH_ALL_THRESHOLD = 10;
+/** Source file extensions to consider */
+const SOURCE_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']);
+/** Directories to skip during analysis */
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '__pycache__',
+    '.venv', 'venv', 'target', 'vendor', '.turbo', 'coverage',
+]);
+/** Catch-all directory names that should be split by domain */
+const CATCH_ALL_NAMES = new Set(['utils', 'helpers', 'common', 'shared', 'lib']);
+function detectNamingConvention(filename) {
+    // Strip extension and any leading dot
+    const name = filename.replace(/\.[^.]+$/, '').replace(/^\./, '');
+    if (!name || name === 'index')
+        return 'unknown';
+    if (/^[A-Z][A-Z0-9_]+$/.test(name))
+        return 'SCREAMING_SNAKE';
+    if (/^[A-Z][a-zA-Z0-9]*$/.test(name))
+        return 'PascalCase';
+    if (/^[a-z][a-zA-Z0-9]*$/.test(name))
+        return 'camelCase';
+    if (/^[a-z][a-z0-9]*(-[a-z0-9]+)+$/.test(name))
+        return 'kebab-case';
+    if (/^[a-z][a-z0-9]*(_[a-z0-9]+)+$/.test(name))
+        return 'snake_case';
+    // Mixed patterns
+    if (name.includes('-'))
+        return 'kebab-case';
+    if (name.includes('_'))
+        return 'snake_case';
+    if (/^[A-Z]/.test(name))
+        return 'PascalCase';
+    return 'camelCase';
+}
+function* walkDirEntries(dir, repoPath) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const relativePath = path.relative(repoPath, fullPath);
+        if (entry.isDirectory()) {
+            if (!SKIP_DIRS.has(entry.name)) {
+                yield { name: entry.name, fullPath, relativePath, isDirectory: true };
+                yield* walkDirEntries(fullPath, repoPath);
+            }
+        }
+        else if (entry.isFile()) {
+            yield { name: entry.name, fullPath, relativePath, isDirectory: false };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Import graph for circular dependency detection
+// ---------------------------------------------------------------------------
+/** Regex patterns to extract import/require paths from source files */
+const IMPORT_PATTERNS = [
+    /(?:import\s+(?:[\s\S]*?\s+from\s+)?['"`])(\.{1,2}\/[^'"`\n]+)['"`]/g,
+    /(?:import\s*\(\s*['"`])(\.{1,2}\/[^'"`\n]+)['"`]/g,
+    /require\s*\(\s*['"`](\.{1,2}\/[^'"`\n]+)['"`]\s*\)/g,
+    /export\s+(?:\*|{[^}]*})\s+from\s+['"`](\.{1,2}\/[^'"`\n]+)['"`]/g,
+];
+function extractImports(filePath) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    if (content.length > 500_000)
+        return [];
+    const imports = [];
+    for (const pattern of IMPORT_PATTERNS) {
+        // Reset regex state
+        const regex = new RegExp(pattern.source, pattern.flags);
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            if (match[1])
+                imports.push(match[1]);
+        }
+    }
+    return imports;
+}
+function resolveImportPath(fromFile, importPath) {
+    const fromDir = path.dirname(fromFile);
+    let resolved = path.resolve(fromDir, importPath);
+    // Try extensions if no extension present
+    const ext = path.extname(resolved);
+    if (!ext || !SOURCE_EXTS.has(ext)) {
+        for (const tryExt of ['.ts', '.tsx', '.js', '.jsx']) {
+            if (fs.existsSync(resolved + tryExt))
+                return resolved + tryExt;
+        }
+        // Try index file
+        const indexPath = path.join(resolved, 'index');
+        for (const tryExt of ['.ts', '.tsx', '.js', '.jsx']) {
+            if (fs.existsSync(indexPath + tryExt))
+                return indexPath + tryExt;
+        }
+        return null;
+    }
+    return fs.existsSync(resolved) ? resolved : null;
+}
+/**
+ * Detect circular dependencies using DFS cycle detection.
+ * Returns arrays of file paths forming cycles.
+ */
+function detectCircularDependencies(sourceFiles, repoPath) {
+    // Build adjacency list
+    const graph = new Map();
+    for (const file of sourceFiles) {
+        const imports = extractImports(file);
+        const resolved = [];
+        for (const imp of imports) {
+            const target = resolveImportPath(file, imp);
+            if (target && sourceFiles.includes(target)) {
+                resolved.push(target);
+            }
+        }
+        graph.set(file, resolved);
+    }
+    // DFS cycle detection
+    const cycles = [];
+    const visited = new Set();
+    const onStack = new Set();
+    const pathStack = [];
+    const seen = new Set(); // deduplicate cycles
+    function dfs(node) {
+        visited.add(node);
+        onStack.add(node);
+        pathStack.push(node);
+        const neighbors = graph.get(node) ?? [];
+        for (const neighbor of neighbors) {
+            if (!visited.has(neighbor)) {
+                dfs(neighbor);
+            }
+            else if (onStack.has(neighbor)) {
+                // Found a cycle — extract it
+                const cycleStart = pathStack.indexOf(neighbor);
+                if (cycleStart >= 0) {
+                    const cycle = pathStack.slice(cycleStart).map((f) => path.relative(repoPath, f));
+                    const key = [...cycle].sort().join('|');
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        cycles.push(cycle);
+                    }
+                }
+            }
+        }
+        pathStack.pop();
+        onStack.delete(node);
+    }
+    for (const file of sourceFiles) {
+        if (!visited.has(file)) {
+            dfs(file);
+        }
+    }
+    return cycles;
+}
+// ---------------------------------------------------------------------------
+// analyzeCodeOrganization — main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Analyze project code organization for structural issues.
+ *
+ * Deterministic filesystem analysis that Claude cannot replicate:
+ * - Counts files per directory (god directories)
+ * - Reads filenames to check naming conventions
+ * - Measures directory nesting depth
+ * - Counts re-exports in barrel files
+ * - Builds import graph to detect circular dependencies
+ *
+ * Recommendations (which pattern to adopt, which tools to use)
+ * are the AI agent's responsibility.
+ */
+export function analyzeCodeOrganization(repoPath) {
+    const findings = [];
+    const allSourceFiles = [];
+    const namingConventions = {};
+    // --- Collect directory info ---
+    const dirFileCount = new Map();
+    let maxDepth = 0;
+    for (const entry of walkDirEntries(repoPath, repoPath)) {
+        if (entry.isDirectory) {
+            // Track nesting depth
+            const depth = entry.relativePath.split(path.sep).length;
+            if (depth > maxDepth)
+                maxDepth = depth;
+        }
+        else {
+            const ext = path.extname(entry.name);
+            if (!SOURCE_EXTS.has(ext))
+                continue;
+            allSourceFiles.push(entry.fullPath);
+            // Track naming convention
+            const convention = detectNamingConvention(entry.name);
+            if (convention !== 'unknown') {
+                namingConventions[convention] = (namingConventions[convention] ?? 0) + 1;
+            }
+            // Track files per directory
+            const dir = path.dirname(entry.relativePath);
+            const existing = dirFileCount.get(dir);
+            if (existing) {
+                existing.count++;
+                existing.files.push(entry.name);
+            }
+            else {
+                dirFileCount.set(dir, { count: 1, files: [entry.name] });
+            }
+        }
+    }
+    // --- Check 1: God directories ---
+    for (const [dir, info] of dirFileCount) {
+        if (info.count > GOD_DIRECTORY_THRESHOLD) {
+            findings.push({
+                type: 'god-directory',
+                domain: 'code-organization',
+                description: `Directory "${dir}" contains ${info.count} source files (threshold: ${GOD_DIRECTORY_THRESHOLD}). Split by feature or domain.`,
+                paths: [dir],
+                severity: info.count > GOD_DIRECTORY_THRESHOLD * 2 ? 'critical' : 'warning',
+                metadata: { fileCount: info.count, threshold: GOD_DIRECTORY_THRESHOLD },
+            });
+        }
+    }
+    // --- Check 2: Mixed naming conventions per directory ---
+    for (const [dir, info] of dirFileCount) {
+        if (info.files.length < 3)
+            continue; // need enough files to judge
+        const conventions = new Map();
+        for (const file of info.files) {
+            const conv = detectNamingConvention(file);
+            if (conv === 'unknown')
+                continue;
+            const list = conventions.get(conv) ?? [];
+            list.push(file);
+            conventions.set(conv, list);
+        }
+        // Filter out conventions with only 1 file (noise)
+        const significant = [...conventions.entries()].filter(([, files]) => files.length >= 2);
+        if (significant.length >= 2) {
+            const summary = significant
+                .map(([conv, files]) => `${conv} (${files.length} files)`)
+                .join(', ');
+            findings.push({
+                type: 'mixed-naming-convention',
+                domain: 'code-organization',
+                description: `Directory "${dir}" uses mixed naming conventions: ${summary}. Choose one convention and enforce it.`,
+                paths: [dir],
+                severity: 'warning',
+                metadata: {
+                    conventions: Object.fromEntries(significant.map(([k, v]) => [k, v.length])),
+                },
+            });
+        }
+    }
+    // --- Check 3: Deep nesting ---
+    for (const entry of walkDirEntries(repoPath, repoPath)) {
+        if (!entry.isDirectory)
+            continue;
+        const parts = entry.relativePath.split(path.sep);
+        // Only measure from src/ or packages/ onwards
+        const srcIdx = parts.indexOf('src');
+        const depth = srcIdx >= 0 ? parts.length - srcIdx : parts.length;
+        if (depth > MAX_NESTING_DEPTH) {
+            findings.push({
+                type: 'deep-nesting',
+                domain: 'code-organization',
+                description: `Directory "${entry.relativePath}" is ${depth} levels deep (max: ${MAX_NESTING_DEPTH}). Consider flattening or using path aliases.`,
+                paths: [entry.relativePath],
+                severity: 'warning',
+                metadata: { depth, threshold: MAX_NESTING_DEPTH },
+            });
+        }
+    }
+    // --- Check 4: Barrel bloat (index files with many re-exports) ---
+    for (const file of allSourceFiles) {
+        const basename = path.basename(file, path.extname(file));
+        if (basename !== 'index')
+            continue;
+        let content;
+        try {
+            content = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const reexportCount = (content.match(/export\s+(?:\*|{[^}]*})\s+from\s+['"`]/g) ?? []).length;
+        if (reexportCount > BARREL_BLOAT_THRESHOLD) {
+            const relativePath = path.relative(repoPath, file);
+            findings.push({
+                type: 'barrel-bloat',
+                domain: 'code-organization',
+                description: `Barrel file "${relativePath}" has ${reexportCount} re-exports (threshold: ${BARREL_BLOAT_THRESHOLD}). Consider direct imports or code-splitting.`,
+                paths: [relativePath],
+                severity: reexportCount > BARREL_BLOAT_THRESHOLD * 2 ? 'critical' : 'warning',
+                metadata: { reexportCount, threshold: BARREL_BLOAT_THRESHOLD },
+            });
+        }
+    }
+    // --- Check 5: Catch-all directories ---
+    for (const [dir, info] of dirFileCount) {
+        const dirName = path.basename(dir);
+        if (!CATCH_ALL_NAMES.has(dirName))
+            continue;
+        if (info.count > CATCH_ALL_THRESHOLD) {
+            findings.push({
+                type: 'catch-all-directory',
+                domain: 'code-organization',
+                description: `Catch-all directory "${dir}" contains ${info.count} files (threshold: ${CATCH_ALL_THRESHOLD}). Split into domain-specific modules (e.g., utils/date, utils/string, utils/validation).`,
+                paths: [dir],
+                severity: info.count > CATCH_ALL_THRESHOLD * 2 ? 'critical' : 'warning',
+                metadata: { fileCount: info.count, threshold: CATCH_ALL_THRESHOLD },
+            });
+        }
+    }
+    // --- Check 6: Mixed export styles (default + multiple named in same file) ---
+    for (const file of allSourceFiles) {
+        const basename = path.basename(file, path.extname(file));
+        if (basename === 'index')
+            continue; // barrel files are expected to have many exports
+        let content;
+        try {
+            content = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const hasDefaultExport = /export\s+default\s/.test(content);
+        const namedExportCount = (content.match(/export\s+(?:function|class|const|let|var|enum|type|interface)\s+\w/g) ?? []).length;
+        if (hasDefaultExport && namedExportCount >= 3) {
+            const relativePath = path.relative(repoPath, file);
+            findings.push({
+                type: 'god-directory', // reuse closest type — file is a "god module"
+                domain: 'code-organization',
+                description: `File "${relativePath}" mixes a default export with ${namedExportCount} named exports. One module, one responsibility — split into separate files.`,
+                paths: [relativePath],
+                severity: 'info',
+                metadata: { hasDefaultExport, namedExportCount, issue: 'mixed-export-style' },
+            });
+        }
+    }
+    // --- Check 7: Circular dependencies ---
+    const cycles = detectCircularDependencies(allSourceFiles, repoPath);
+    for (const cycle of cycles) {
+        findings.push({
+            type: 'circular-dependency',
+            domain: 'code-organization',
+            description: `Circular dependency detected: ${cycle.join(' → ')} → ${cycle[0]}`,
+            paths: cycle,
+            severity: cycle.length > 3 ? 'critical' : 'warning',
+            metadata: { cycleLength: cycle.length },
+        });
+    }
+    return {
+        findings,
+        stats: {
+            totalSourceFiles: allSourceFiles.length,
+            maxDirectoryDepth: maxDepth,
+            namingConventions,
+            circularDependencyCount: cycles.length,
+        },
+    };
+}
+//# sourceMappingURL=code-organization-analyzer.js.map

package/dist/analyzer/code-organization-analyzer.js.map

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

package/dist/analyzer/pattern-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pattern-catalog.d.ts","sourceRoot":"","sources":["../../src/analyzer/pattern-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,EAAE,gBAAgB,CAAC;IACzB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAkqBvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAExE"}
+{"version":3,"file":"pattern-catalog.d.ts","sourceRoot":"","sources":["../../src/analyzer/pattern-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,EAAE,gBAAgB,CAAC;IACzB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAmsBvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAExE"}

package/dist/analyzer/pattern-catalog.js

@@ -544,6 +544,39 @@ export function getPatternCatalog() {
         // -----------------------------------------------------------------------
         // H. Delivery / Quality / DevEx
         // -----------------------------------------------------------------------
+        // code-organization
+        {
+            id: 'org-deep-relative-import',
+            domain: 'code-organization',
+            description: 'Deep relative import path (3+ parent traversals) indicating poor module structure',
+            filePatterns: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+            codePatterns: [
+                /(?:import|from)\s+['"`]\.\.\/\.\.\/\.\.\//,
+                /require\s*\(\s*['"`]\.\.\/\.\.\/\.\.\//,
+            ],
+            confidenceBase: 0.75,
+        },
+        {
+            id: 'org-barrel-reexport-wildcard',
+            domain: 'code-organization',
+            description: 'Wildcard barrel re-export (export * from) — risks namespace pollution and circular deps',
+            filePatterns: ['**/index.ts', '**/index.tsx', '**/index.js', '**/index.jsx'],
+            codePatterns: [
+                /export\s+\*\s+from\s+['"`]/,
+            ],
+            confidenceBase: 0.65,
+        },
+        {
+            id: 'org-catch-all-utils-import',
+            domain: 'code-organization',
+            description: 'Import from catch-all utils/helpers/common directory — should be split by domain',
+            filePatterns: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+            codePatterns: [
+                /(?:import|from)\s+['"`][.\/]*(?:utils|helpers|common|shared|lib)\/(?!index)/,
+                /require\s*\(\s*['"`][.\/]*(?:utils|helpers|common|shared|lib)\//,
+            ],
+            confidenceBase: 0.5,
+        },
         // testing-strategy
         {
             id: 'test-manual-assertions',