@eloquence98/ctx 0.2.0 → 0.3.0

package/README.md

@@ -1,50 +1,88 @@
 # ctx
 
-Scan your codebase. Get a clean summary. Paste it to AI.
+Dump a truthful structural index of a codebase.
 
-## Usage
+No analysis. No opinions. No guessing.
 
-```bash
-# Scan current directory
-ctx .
-```
+ctx scans a directory and prints a map of folders, files, and statically detectable exported symbols. It tells you exactly what exists—nothing more, nothing less.
+
+## ⚡️ Quick Start
+
+No installation required. Run it directly with npx:
 
 ```bash
-# Scan specific folder
-ctx ./src
+npx @eloquence98/ctx ./path-to-project
 ```
 
+## 📖 What it does
+
+ctx provides a high-level map of a project. It identifies:
+
+- 📂 Folders
+- 📄 Files
+- ➡️ Exported Symbols (when statically detectable)
+
+## Example Output
+
 ```bash
-# Human-readable output
-ctx ./src --human
+src/
+├─ app.tsx → App
+├─ utils.ts → formatDate, parseCurrency
+└─ components/
+   ├─ button.tsx → Button
+   ├─ modal.tsx → Modal, ModalProps
+   └─ styles.css
 ```
 
-## Output Example
+If exports cannot be determined (e.g., non-code files or complex dynamic exports), the file is listed without symbols.
 
-```bash
-# Codebase Context
+## 🧠 Why this exists
 
-## Routes
-- /admin
-- /admin/orders
-- /client/[slug]/orders
+When working with LLMs (ChatGPT, Claude, etc.), new contributors, or legacy codebases, you don't always need the content of the files immediately; you need to understand the topology of the project first.
 
-## Components
-- navbar.tsx: Navbar
-- sidebar.tsx: Sidebar
+ctx gives you that map.
 
-## Hooks
-- useAuth
-- useFetch
+1.  Copy the output.
+2.  Paste it into an LLM context window.
+3.  Ask informed questions about the architecture before dumping raw code.
 
-## Utils
-- utils.ts: cn, formatDate
-```
+## 🚫 What it does NOT do
+
+ctx is intentionally dumb. That is why it is reliable.
 
-## That's It
+It does not:
 
-Copy. Paste to ChatGPT/Claude. Done.
+- ❌ Interpret architecture or infer domains.
+- ❌ Explain code intent.
+- ❌ Refactor or execute code.
+- ❌ Read node_modules or .git folders.
+- ❌ Read environment variables.
+
+It is not a framework detector, a dependency graph tool, or a documentation generator.
+
+## ⚙️ Configuration
+
+No configuration required.
+
+ctx automatically ignores:
+
+- node_modules
+- .git
+- Build outputs (dist, build, etc.)
+- Environment files (.env)
+- Test files (.test., .spec.)
+
+## 💡 Philosophy
+
+Don't explain the code. Show the codebase as it exists.
+
+## ⚡️ Install (optional)
+
+```bash
+npm install -g @eloquence98/ctx
+ctx ./src
+```
 
 ## License
 
-MIT
+[MIT](https://choosealicense.com/licenses/mit/)

package/dist/cli.js

@@ -2,26 +2,20 @@
 import path from "path";
 import { scan } from "./scanner.js";
 import { parse } from "./parser.js";
-import { organize } from "./organizer.js";
-import { formatAI } from "./formatters/ai.js";
-import { formatHuman } from "./formatters/human.js";
+import { format } from "./formatter.js";
 const args = process.argv.slice(2);
-const targetPath = args.find((a) => !a.startsWith("-")) || ".";
-const humanMode = args.includes("--human");
+const targetPath = args[0] || ".";
 async function main() {
     const dir = path.resolve(process.cwd(), targetPath);
-    // 1. Scan
+    // Scan
     const files = await scan(dir);
     if (files.length === 0) {
         console.log("No files found.");
         process.exit(1);
     }
-    // 2. Parse
+    // Parse
     const parsed = await Promise.all(files.map(parse));
-    // 3. Organize
-    const context = await organize(parsed, dir);
-    // 4. Format
-    const output = humanMode ? formatHuman(context) : formatAI(context);
-    console.log(output);
+    // Format and print
+    console.log(format(parsed, dir));
 }
 main().catch(console.error);

package/dist/formatter.d.ts

@@ -0,0 +1,2 @@
+import type { ParsedFile } from "./types.js";
+export declare function format(files: ParsedFile[], baseDir: string): string;

package/dist/formatter.js

@@ -0,0 +1,49 @@
+import path from "path";
+export function format(files, baseDir) {
+    // Build tree structure
+    const root = { name: path.basename(baseDir), children: new Map() };
+    for (const file of files) {
+        const rel = path.relative(baseDir, file.path);
+        const parts = rel.split(path.sep);
+        let current = root;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const isFile = i === parts.length - 1;
+            if (!current.children.has(part)) {
+                current.children.set(part, {
+                    name: part,
+                    children: new Map(),
+                    exports: isFile ? file.exports : undefined,
+                });
+            }
+            else if (isFile) {
+                current.children.get(part).exports = file.exports;
+            }
+            current = current.children.get(part);
+        }
+    }
+    // Render tree
+    const lines = [];
+    lines.push(root.name + "/");
+    renderTree(root, "", lines);
+    return lines.join("\n");
+}
+function renderTree(node, prefix, lines) {
+    const children = [...node.children.values()];
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const isLast = i === children.length - 1;
+        const connector = isLast ? "└─ " : "├─ ";
+        const extension = isLast ? "   " : "│  ";
+        // Is it a file (has exports defined) or folder?
+        const isFile = child.exports !== undefined;
+        if (isFile) {
+            const exportsStr = child.exports.length > 0 ? ` → ${child.exports.join(", ")}` : "";
+            lines.push(prefix + connector + child.name + exportsStr);
+        }
+        else {
+            lines.push(prefix + connector + child.name + "/");
+            renderTree(child, prefix + extension, lines);
+        }
+    }
+}

package/dist/parser.js

@@ -3,38 +3,26 @@ import path from "path";
 export async function parse(filePath) {
     const content = await fs.readFile(filePath, "utf-8");
     const name = path.basename(filePath);
-    const functions = [];
-    const constants = [];
-    const types = [];
-    const components = [];
-    // Export function
+    const exports = [];
+    // export function Name
     for (const match of content.matchAll(/export\s+(?:async\s+)?function\s+(\w+)/g)) {
-        const fn = match[1];
-        isPascalCase(fn) ? components.push(fn) : functions.push(fn);
+        exports.push(match[1]);
     }
-    // Export const
-    for (const match of content.matchAll(/export\s+const\s+(\w+)\s*=/g)) {
-        const n = match[1];
-        if (isPascalCase(n)) {
-            components.push(n);
-        }
-        else if (n.startsWith("use")) {
-            functions.push(n);
-        }
-        else {
-            constants.push(n);
-        }
+    // export const Name
+    for (const match of content.matchAll(/export\s+const\s+(\w+)/g)) {
+        exports.push(match[1]);
     }
-    // Types & interfaces
+    // export type/interface Name
     for (const match of content.matchAll(/export\s+(?:type|interface)\s+(\w+)/g)) {
-        types.push(match[1]);
+        exports.push(match[1]);
     }
-    return {
-        path: filePath,
-        name,
-        exports: { functions, constants, types, components },
-    };
-}
-function isPascalCase(str) {
-    return /^[A-Z][a-zA-Z0-9]*$/.test(str);
+    // export class Name
+    for (const match of content.matchAll(/export\s+class\s+(\w+)/g)) {
+        exports.push(match[1]);
+    }
+    // export default function Name / class Name
+    for (const match of content.matchAll(/export\s+default\s+(?:function|class)\s+(\w+)/g)) {
+        exports.push(match[1]);
+    }
+    return { path: filePath, name, exports };
 }

package/dist/scanner.js

@@ -1,6 +1,19 @@
 import fs from "fs/promises";
 import path from "path";
-const IGNORE = ["node_modules", ".git", "dist", ".next", "build", "__tests__"];
+const IGNORE = [
+    "node_modules",
+    ".git",
+    ".next",
+    "dist",
+    "build",
+    ".env",
+    ".env.local",
+    ".env.production",
+    "__pycache__",
+    ".vscode",
+    ".idea",
+    "coverage",
+];
 const EXTENSIONS = [".ts", ".tsx", ".js", ".jsx"];
 export async function scan(dir) {
     const files = [];
@@ -13,18 +26,21 @@ export async function scan(dir) {
             return;
         }
         for (const entry of entries) {
+            // Skip ignored
             if (IGNORE.includes(entry.name))
                 continue;
             if (entry.name.startsWith("."))
                 continue;
+            if (entry.name.includes(".test."))
+                continue;
+            if (entry.name.includes(".spec."))
+                continue;
             const full = path.join(current, entry.name);
             if (entry.isDirectory()) {
                 await walk(full);
             }
             else if (EXTENSIONS.includes(path.extname(entry.name))) {
-                if (!entry.name.includes(".test.") && !entry.name.includes(".spec.")) {
-                    files.push(full);
-                }
+                files.push(full);
             }
         }
     }

package/dist/types.d.ts

@@ -1,17 +1,9 @@
 export interface ParsedFile {
     path: string;
     name: string;
-    exports: {
-        functions: string[];
-        constants: string[];
-        types: string[];
-        components: string[];
-    };
+    exports: string[];
 }
-export interface OrganizedContext {
-    routes: string[];
-    components: ParsedFile[];
-    hooks: ParsedFile[];
-    utils: ParsedFile[];
-    other: ParsedFile[];
+export interface FolderContent {
+    folder: string;
+    files: ParsedFile[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eloquence98/ctx",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Scan your codebase. Get a clean summary. Paste it to AI.",
   "type": "module",
   "bin": {
@@ -36,4 +36,4 @@
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
   }
-}
+}

package/dist/adapters/express.d.ts

@@ -1,2 +0,0 @@
-import type { Adapter } from "./types.js";
-export declare const expressAdapter: Adapter;

package/dist/adapters/express.js

@@ -1,58 +0,0 @@
-import fs from "fs/promises";
-import path from "path";
-export const expressAdapter = {
-    name: "express",
-    async detect(dir) {
-        try {
-            const pkg = await fs.readFile(path.join(dir, "package.json"), "utf-8");
-            const parsed = JSON.parse(pkg);
-            const deps = { ...parsed.dependencies, ...parsed.devDependencies };
-            return ("express" in deps ||
-                "fastify" in deps ||
-                "koa" in deps ||
-                "hono" in deps);
-        }
-        catch {
-            return false;
-        }
-    },
-    async analyze(dir, files) {
-        const sections = new Map();
-        const folderMappings = {
-            Routes: ["routes", "routers", "api"],
-            Controllers: ["controllers", "handlers"],
-            Services: ["services"],
-            Models: ["models", "entities", "schemas"],
-            Middleware: ["middleware", "middlewares"],
-            Utils: ["utils", "helpers", "lib"],
-            Config: ["config", "configs"],
-        };
-        for (const file of files) {
-            const relativePath = path.relative(dir, file.filePath);
-            const parts = relativePath.split(path.sep);
-            let matched = false;
-            for (const [sectionName, folders] of Object.entries(folderMappings)) {
-                const folderIndex = parts.findIndex((p) => folders.includes(p.toLowerCase()));
-                if (folderIndex !== -1) {
-                    if (!sections.has(sectionName)) {
-                        sections.set(sectionName, []);
-                    }
-                    sections.get(sectionName).push(file);
-                    matched = true;
-                    break;
-                }
-            }
-            if (!matched) {
-                const folder = parts.length > 1 ? parts[0] : "_root";
-                if (!sections.has(folder)) {
-                    sections.set(folder, []);
-                }
-                sections.get(folder).push(file);
-            }
-        }
-        return {
-            projectType: "Express/Fastify",
-            sections,
-        };
-    },
-};

package/dist/adapters/index.d.ts

@@ -1,4 +0,0 @@
-import type { ProjectType } from "../detectors/index.js";
-import type { Adapter } from "./types.js";
-export declare function getAdapter(projectType: ProjectType): Adapter;
-export type { Adapter, AdapterContext } from "./types.js";

package/dist/adapters/index.js

@@ -1,16 +0,0 @@
-import { expressAdapter } from "./express.js";
-import { nextjsAdapter } from "./nextjs.js";
-import { vanillaAdapter } from "./vanilla.js";
-const adapters = {
-    nextjs: nextjsAdapter,
-    react: vanillaAdapter,
-    express: expressAdapter,
-    nestjs: expressAdapter, // Similar structure
-    vue: vanillaAdapter,
-    sveltekit: vanillaAdapter,
-    node: vanillaAdapter,
-    vanilla: vanillaAdapter,
-};
-export function getAdapter(projectType) {
-    return adapters[projectType] || vanillaAdapter;
-}

package/dist/adapters/nextjs.d.ts

@@ -1,2 +0,0 @@
-import type { Adapter } from "./types.js";
-export declare const nextjsAdapter: Adapter;

package/dist/adapters/nextjs.js

@@ -1,102 +0,0 @@
-import fs from "fs/promises";
-import path from "path";
-import { getRoutes } from "../scanner.js";
-export const nextjsAdapter = {
-    name: "nextjs",
-    async detect(dir) {
-        const configFiles = ["next.config.js", "next.config.mjs", "next.config.ts"];
-        for (const file of configFiles) {
-            try {
-                await fs.access(path.join(dir, file));
-                return true;
-            }
-            catch {
-                continue;
-            }
-        }
-        // Check package.json for next dependency
-        try {
-            const pkg = await fs.readFile(path.join(dir, "package.json"), "utf-8");
-            const parsed = JSON.parse(pkg);
-            const deps = { ...parsed.dependencies, ...parsed.devDependencies };
-            return "next" in deps;
-        }
-        catch {
-            return false;
-        }
-    },
-    async analyze(dir, files) {
-        const sections = new Map();
-        // Get routes
-        let routes = [];
-        const appDir = await findAppDirectory(dir);
-        if (appDir) {
-            routes = await getRoutes(appDir);
-        }
-        // Group by known Next.js folders
-        const folderMappings = {
-            Features: ["features", "modules", "domains"],
-            Components: ["components"],
-            Hooks: ["hooks"],
-            Lib: ["lib", "utils", "helpers", "services"],
-            API: ["api"],
-        };
-        for (const file of files) {
-            const relativePath = path.relative(dir, file.filePath);
-            const parts = relativePath.split(path.sep);
-            let matched = false;
-            for (const [sectionName, folders] of Object.entries(folderMappings)) {
-                const folderIndex = parts.findIndex((p) => folders.includes(p));
-                if (folderIndex !== -1) {
-                    const subParts = parts.slice(folderIndex + 1);
-                    if (subParts.length >= 1) {
-                        // Use subfolder name if exists, otherwise use section name
-                        const subFolder = subParts.length > 1 ? subParts[0] : "_direct";
-                        const key = subFolder === "_direct"
-                            ? sectionName
-                            : `${sectionName}/${subParts[0]}`;
-                        if (!sections.has(key)) {
-                            sections.set(key, []);
-                        }
-                        sections.get(key).push(file);
-                        matched = true;
-                        break;
-                    }
-                }
-            }
-            // If no match, group by top folder
-            if (!matched) {
-                const folder = parts.length > 1 ? parts[0] : "_root";
-                const key = `Other/${folder}`;
-                if (!sections.has(key)) {
-                    sections.set(key, []);
-                }
-                sections.get(key).push(file);
-            }
-        }
-        return {
-            projectType: "Next.js",
-            sections,
-            routes,
-        };
-    },
-};
-async function findAppDirectory(basePath) {
-    const possiblePaths = [
-        path.join(basePath, "app"),
-        path.join(basePath, "src", "app"),
-        path.join(basePath, "src/app"),
-    ];
-    for (const p of possiblePaths) {
-        try {
-            const stat = await fs.stat(p);
-            if (stat.isDirectory()) {
-                return p;
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    return null;
-}

package/dist/adapters/types.d.ts

@@ -1,11 +0,0 @@
-import type { FileExports } from "../types.js";
-export interface AdapterContext {
-    projectType: string;
-    sections: Map<string, FileExports[]>;
-    routes?: string[];
-}
-export interface Adapter {
-    name: string;
-    detect: (dir: string) => Promise<boolean>;
-    analyze: (dir: string, files: FileExports[]) => Promise<AdapterContext>;
-}

package/dist/adapters/types.js

@@ -1 +0,0 @@
-export {};

package/dist/adapters/vanilla.d.ts

@@ -1,2 +0,0 @@
-import type { Adapter } from "./types.js";
-export declare const vanillaAdapter: Adapter;

package/dist/adapters/vanilla.js

@@ -1,24 +0,0 @@
-import path from "path";
-export const vanillaAdapter = {
-    name: "vanilla",
-    async detect() {
-        // Always returns true - this is the fallback
-        return true;
-    },
-    async analyze(dir, files) {
-        const sections = new Map();
-        for (const file of files) {
-            const relativePath = path.relative(dir, file.filePath);
-            const parts = relativePath.split(path.sep);
-            const folder = parts.length > 1 ? parts[0] : "_root";
-            if (!sections.has(folder)) {
-                sections.set(folder, []);
-            }
-            sections.get(folder).push(file);
-        }
-        return {
-            projectType: "JavaScript/TypeScript",
-            sections,
-        };
-    },
-};

package/dist/config.d.ts

@@ -1,9 +0,0 @@
-import type { ScanOptions } from "./types.js";
-export declare const defaultConfig: ScanOptions;
-export declare const folderCategories: {
-    routes: string[];
-    features: string[];
-    hooks: string[];
-    lib: string[];
-    components: string[];
-};

package/dist/config.js

@@ -1,25 +0,0 @@
-export const defaultConfig = {
-    entry: "./src",
-    extensions: [".ts", ".tsx", ".js", ".jsx"],
-    ignore: [
-        "node_modules",
-        ".git",
-        ".directory",
-        "dist",
-        "build",
-        ".next",
-        "*.test.*",
-        "*.spec.*",
-        "__tests__",
-        "*.d.ts",
-        ".DS_Store",
-    ],
-    maxDepth: 10,
-};
-export const folderCategories = {
-    routes: ["app", "pages"],
-    features: ["features", "modules", "domains"],
-    hooks: ["hooks"],
-    lib: ["lib", "utils", "helpers", "services"],
-    components: ["components", "ui"],
-};

package/dist/detectors/index.d.ts

@@ -1,3 +0,0 @@
-export type ProjectType = "nextjs" | "react" | "express" | "nestjs" | "vue" | "sveltekit" | "node" | "vanilla";
-export declare function detectProject(dir: string): Promise<ProjectType>;
-export declare function getProjectLabel(type: ProjectType): string;

package/dist/detectors/index.js

@@ -1,73 +0,0 @@
-import fs from "fs/promises";
-import path from "path";
-async function readPackageJson(dir) {
-    try {
-        const content = await fs.readFile(path.join(dir, "package.json"), "utf-8");
-        return JSON.parse(content);
-    }
-    catch {
-        return null;
-    }
-}
-async function fileExists(filePath) {
-    try {
-        await fs.access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export async function detectProject(dir) {
-    const pkg = await readPackageJson(dir);
-    const deps = {
-        ...pkg?.dependencies,
-        ...pkg?.devDependencies,
-    };
-    // Check config files first (more specific)
-    const hasNextConfig = (await fileExists(path.join(dir, "next.config.js"))) ||
-        (await fileExists(path.join(dir, "next.config.mjs"))) ||
-        (await fileExists(path.join(dir, "next.config.ts")));
-    if (hasNextConfig || deps["next"]) {
-        return "nextjs";
-    }
-    // NestJS
-    if (deps["@nestjs/core"]) {
-        return "nestjs";
-    }
-    // SvelteKit
-    if (deps["@sveltejs/kit"]) {
-        return "sveltekit";
-    }
-    // Vue
-    if (deps["vue"] || deps["nuxt"]) {
-        return "vue";
-    }
-    // Express
-    if (deps["express"] || deps["fastify"] || deps["koa"] || deps["hono"]) {
-        return "express";
-    }
-    // React (without Next.js)
-    if (deps["react"] && !deps["next"]) {
-        return "react";
-    }
-    // Node.js project (has package.json but no framework)
-    if (pkg) {
-        return "node";
-    }
-    // No package.json
-    return "vanilla";
-}
-export function getProjectLabel(type) {
-    const labels = {
-        nextjs: "Next.js",
-        react: "React",
-        express: "Express/Fastify",
-        nestjs: "NestJS",
-        vue: "Vue/Nuxt",
-        sveltekit: "SvelteKit",
-        node: "Node.js",
-        vanilla: "JavaScript/TypeScript",
-    };
-    return labels[type];
-}

package/dist/formatters/ai-optimized.d.ts

@@ -1,2 +0,0 @@
-import type { AdapterContext } from "../adapters/types.js";
-export declare function formatAIOptimized(data: AdapterContext): string;

package/dist/formatters/ai-optimized.js

@@ -1,215 +0,0 @@
-export function formatAIOptimized(data) {
-    const lines = [];
-    lines.push(`# Project Context (${data.projectType})`);
-    lines.push("");
-    // 1. Routes
-    if (data.routes && data.routes.length > 0) {
-        const routeGroups = parseRouteGroups(data.routes);
-        // Filter out empty shell routes
-        const filteredGroups = new Map();
-        for (const [key, value] of routeGroups) {
-            if (value.length > 0) {
-                filteredGroups.set(key, value);
-            }
-        }
-        lines.push(`## Routes (${filteredGroups.size})`);
-        for (const [group, paths] of filteredGroups) {
-            // Max 4 routes, no "+N more"
-            const displayPaths = paths.slice(0, 4);
-            lines.push(`/${group} → ${displayPaths.join(", ")}`);
-        }
-        lines.push("");
-    }
-    // 2. Core Domains
-    const features = getSectionsByPattern(data.sections, "features");
-    if (features.size > 0) {
-        lines.push(`## Core Domains (${features.size})`);
-        for (const [name, files] of features) {
-            lines.push(formatDomainLine(name, files));
-        }
-        lines.push("");
-    }
-    // 3. Auth & Session
-    const authFiles = getAuthFiles(data.sections);
-    if (authFiles.length > 0) {
-        lines.push("## Auth & Session");
-        lines.push("sign-in, session handling, token management");
-        lines.push("");
-    }
-    // 4. Shared Lib
-    const lib = getSectionsByPattern(data.sections, "lib");
-    if (lib.size > 0 || data.sections.has("LIB") || data.sections.has("Lib")) {
-        lines.push("## Shared Lib");
-        lines.push("utils — formatting, helpers");
-        const config = getSectionsByPattern(data.sections, "config");
-        if (config.size > 0) {
-            lines.push("config — api, uploads, pricing");
-        }
-        lines.push("");
-    }
-    // 5. Hooks
-    const hooks = data.sections.get("HOOKS") || data.sections.get("Hooks");
-    if (hooks && hooks.length > 0) {
-        const hookNames = hooks
-            .flatMap((f) => f.functions)
-            .filter((n) => n.startsWith("use"));
-        lines.push(`## Hooks (${hookNames.length})`);
-        lines.push(hookNames.join(", "));
-        lines.push("");
-    }
-    // 6. UI Layer
-    const components = getSectionsByPattern(data.sections, "components");
-    if (components.size > 0) {
-        const totalComponents = countTotalFiles(components);
-        lines.push("## UI Layer");
-        const folders = [...components.keys()]
-            .map((k) => k.split("/").pop()?.toLowerCase())
-            .filter(Boolean);
-        const uniqueFolders = [...new Set(folders)];
-        lines.push(`~${totalComponents} components (${uniqueFolders.join(", ")})`);
-        lines.push("");
-    }
-    return lines.join("\n");
-}
-// === Route Parsing ===
-function parseRouteGroups(routes) {
-    const groups = new Map();
-    let currentTopLevel = "";
-    let currentDynamic = "";
-    for (const route of routes) {
-        const trimmed = route.trim();
-        // Skip group markers like (auth), (website)
-        if (trimmed.startsWith("(") && trimmed.endsWith(")")) {
-            continue;
-        }
-        // Calculate depth by counting leading spaces
-        const depth = route.search(/\S/);
-        // Top-level route
-        if (depth === 0) {
-            currentTopLevel = trimmed;
-            currentDynamic = "";
-            if (!groups.has(currentTopLevel)) {
-                groups.set(currentTopLevel, []);
-            }
-        }
-        // First-level dynamic segment like [slug]
-        else if (depth === 2 && trimmed.startsWith("[") && trimmed.endsWith("]")) {
-            currentDynamic = trimmed;
-            const dynamicKey = `${currentTopLevel}/${currentDynamic}`;
-            if (!groups.has(dynamicKey)) {
-                groups.set(dynamicKey, []);
-            }
-        }
-        // Child routes
-        else if (depth >= 2) {
-            // Skip dynamic segments and technical routes
-            if (isSkippableRoute(trimmed)) {
-                continue;
-            }
-            // Add to dynamic group if exists, otherwise to top level
-            if (currentDynamic && depth > 2) {
-                const dynamicKey = `${currentTopLevel}/${currentDynamic}`;
-                const children = groups.get(dynamicKey);
-                if (children && !children.includes(trimmed)) {
-                    children.push(trimmed);
-                }
-            }
-            else if (currentTopLevel) {
-                const children = groups.get(currentTopLevel);
-                if (children && !children.includes(trimmed)) {
-                    children.push(trimmed);
-                }
-            }
-        }
-    }
-    // Clean up empty groups and dynamic groups with no children
-    const cleaned = new Map();
-    for (const [key, value] of groups) {
-        // Keep if has children OR is a standalone route
-        if (value.length > 0 || !key.includes("/")) {
-            cleaned.set(key, value);
-        }
-    }
-    return cleaned;
-}
-function isSkippableRoute(route) {
-    const skipPatterns = [
-        "[",
-        "]",
-        "error",
-        "sync",
-        "verify-email",
-        "success",
-        "...nextauth",
-    ];
-    const lower = route.toLowerCase();
-    return skipPatterns.some((p) => lower.includes(p));
-}
-// === Section Helpers ===
-function getSectionsByPattern(sections, pattern) {
-    const result = new Map();
-    for (const [key, value] of sections) {
-        if (key.toLowerCase().includes(pattern.toLowerCase())) {
-            result.set(key, value);
-        }
-    }
-    return result;
-}
-function getAuthFiles(sections) {
-    for (const [key, value] of sections) {
-        if (key.toLowerCase().includes("auth")) {
-            return value;
-        }
-    }
-    return [];
-}
-function countTotalFiles(sections) {
-    let count = 0;
-    for (const files of sections.values()) {
-        count += files.length;
-    }
-    return count;
-}
-// === Domain Formatting ===
-function formatDomainLine(name, files) {
-    const cleanName = name
-        .replace(/features\//i, "")
-        .replace(/FEATURES\//i, "")
-        .toLowerCase();
-    const actionFiles = files.filter((f) => f.fileName.includes("action") || f.fileName.includes("actions"));
-    const actionCount = actionFiles.reduce((sum, f) => sum + f.functions.length, 0);
-    const intent = getIntent(cleanName, files);
-    return `${cleanName} — ${intent} (${actionCount} actions)`;
-}
-function getIntent(domain, files) {
-    const allFunctions = files
-        .flatMap((f) => f.functions)
-        .join(" ")
-        .toLowerCase();
-    // Domain-specific intent mapping
-    if (domain === "users") {
-        return "authenticate, edit profile, manage credentials";
-    }
-    if (domain === "orders") {
-        return "create/edit/cancel";
-    }
-    if (domain === "estimates") {
-        return "create/edit/convert";
-    }
-    if (domain === "files") {
-        return "upload/download";
-    }
-    // Fallback: derive from function names
-    const intents = [];
-    if (allFunctions.includes("create"))
-        intents.push("create");
-    if (allFunctions.includes("edit") || allFunctions.includes("update")) {
-        intents.push("edit");
-    }
-    if (allFunctions.includes("delete") || allFunctions.includes("cancel")) {
-        intents.push("cancel");
-    }
-    if (intents.length === 0)
-        return "manage";
-    return intents.slice(0, 3).join("/");
-}

package/dist/formatters/ai.d.ts

@@ -1,2 +0,0 @@
-import type { OrganizedContext } from "../types.js";
-export declare function formatAI(ctx: OrganizedContext): string;

package/dist/formatters/ai.js

@@ -1,51 +0,0 @@
-export function formatAI(ctx) {
-    const lines = ["# Codebase Context", ""];
-    if (ctx.routes.length) {
-        lines.push("## Routes", ...ctx.routes.map((r) => `- ${r}`), "");
-    }
-    if (ctx.components.length) {
-        lines.push("## Components");
-        for (const f of ctx.components) {
-            const exp = f.exports.components.join(", ");
-            if (exp) {
-                lines.push(`- ${f.name}: ${exp}`);
-            }
-        }
-        lines.push("");
-    }
-    if (ctx.hooks.length) {
-        lines.push("## Hooks");
-        for (const f of ctx.hooks) {
-            const hookFns = f.exports.functions.filter((fn) => fn.startsWith("use"));
-            if (hookFns.length) {
-                lines.push(`- ${hookFns.join(", ")}`);
-            }
-        }
-        lines.push("");
-    }
-    if (ctx.utils.length) {
-        lines.push("## Utils");
-        for (const f of ctx.utils) {
-            const exp = [...f.exports.functions, ...f.exports.constants].join(", ");
-            if (exp) {
-                lines.push(`- ${f.name}: ${exp}`);
-            }
-        }
-        lines.push("");
-    }
-    if (ctx.other.length) {
-        lines.push("## Other");
-        for (const f of ctx.other) {
-            const exp = [
-                ...f.exports.functions,
-                ...f.exports.constants,
-                ...f.exports.components,
-            ].join(", ");
-            if (exp) {
-                lines.push(`- ${f.name}: ${exp}`);
-            }
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-}

package/dist/formatters/human.d.ts

@@ -1,2 +0,0 @@
-import type { OrganizedContext } from "../types.js";
-export declare function formatHuman(ctx: OrganizedContext): string;

package/dist/formatters/human.js

@@ -1,53 +0,0 @@
-export function formatHuman(ctx) {
-    const lines = [
-        "╭─────────────────────────────────────╮",
-        "│         CODEBASE OVERVIEW           │",
-        "╰─────────────────────────────────────╯",
-        "",
-    ];
-    if (ctx.routes.length) {
-        lines.push("📍 ROUTES", "");
-        for (const r of ctx.routes) {
-            lines.push(`   ${r}`);
-        }
-        lines.push("");
-    }
-    if (ctx.components.length) {
-        lines.push(`🧩 COMPONENTS (${ctx.components.length} files)`, "");
-        for (const f of ctx.components.slice(0, 10)) {
-            if (f.exports.components.length) {
-                lines.push(`   ${f.name}`);
-                for (const c of f.exports.components.slice(0, 3)) {
-                    lines.push(`      └─ ${c}`);
-                }
-            }
-        }
-        if (ctx.components.length > 10) {
-            lines.push(`   ... and ${ctx.components.length - 10} more`);
-        }
-        lines.push("");
-    }
-    if (ctx.hooks.length) {
-        const allHooks = ctx.hooks.flatMap((f) => f.exports.functions.filter((fn) => fn.startsWith("use")));
-        if (allHooks.length) {
-            lines.push(`🪝 HOOKS (${allHooks.length})`, "");
-            for (const hook of allHooks) {
-                lines.push(`   • ${hook}()`);
-            }
-            lines.push("");
-        }
-    }
-    if (ctx.utils.length) {
-        lines.push(`🔧 UTILITIES`, "");
-        for (const f of ctx.utils.slice(0, 10)) {
-            if (f.exports.functions.length) {
-                lines.push(`   ${f.name}`);
-                for (const fn of f.exports.functions.slice(0, 3)) {
-                    lines.push(`      • ${fn}()`);
-                }
-            }
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-}

package/dist/formatters/index.d.ts

@@ -1,2 +0,0 @@
-export { formatAI } from "./ai.js";
-export { formatHuman } from "./human.js";

package/dist/formatters/index.js

@@ -1,2 +0,0 @@
-export { formatAI } from "./ai.js";
-export { formatHuman } from "./human.js";

package/dist/formatters/markdown.d.ts

@@ -1,2 +0,0 @@
-import type { AdapterContext } from "../adapters/types.js";
-export declare function formatMarkdown(data: AdapterContext): string;

package/dist/formatters/markdown.js

@@ -1,77 +0,0 @@
-export function formatMarkdown(data) {
-    let output = "";
-    // Project type header
-    output += `📦 Project: ${data.projectType}\n\n`;
-    // Routes section (if exists)
-    if (data.routes && data.routes.length > 0) {
-        output += `=== ROUTES ===\n\n`;
-        for (const route of data.routes) {
-            output += `${route}\n`;
-        }
-        output += "\n";
-    }
-    // All sections
-    for (const [sectionName, files] of data.sections) {
-        if (sectionName === "_root")
-            continue;
-        if (files.length === 0)
-            continue;
-        // Check if any file has exports
-        const hasExports = files.some((f) => f.functions.length > 0 ||
-            f.constants.length > 0 ||
-            f.types.length > 0 ||
-            f.interfaces.length > 0 ||
-            f.classes.length > 0);
-        if (!hasExports)
-            continue;
-        output += `=== ${sectionName.toUpperCase()} ===\n\n`;
-        for (const file of files) {
-            output += formatFile(file);
-        }
-        output += "\n";
-    }
-    // Root files last
-    const rootFiles = data.sections.get("_root");
-    if (rootFiles && rootFiles.length > 0) {
-        const hasRootExports = rootFiles.some((f) => f.functions.length > 0 ||
-            f.constants.length > 0 ||
-            f.types.length > 0 ||
-            f.interfaces.length > 0 ||
-            f.classes.length > 0);
-        if (hasRootExports) {
-            output += `=== ROOT FILES ===\n\n`;
-            for (const file of rootFiles) {
-                output += formatFile(file);
-            }
-            output += "\n";
-        }
-    }
-    output += `=== DONE ===\n`;
-    return output;
-}
-function formatFile(file) {
-    const hasExports = file.functions.length > 0 ||
-        file.constants.length > 0 ||
-        file.types.length > 0 ||
-        file.interfaces.length > 0 ||
-        file.classes.length > 0;
-    if (!hasExports)
-        return "";
-    let output = `${file.fileName}\n`;
-    for (const fn of file.functions) {
-        output += `• function: ${fn}\n`;
-    }
-    for (const constant of file.constants) {
-        output += `• constant: ${constant}\n`;
-    }
-    for (const type of file.types) {
-        output += `• type: ${type}\n`;
-    }
-    for (const iface of file.interfaces) {
-        output += `• interface: ${iface}\n`;
-    }
-    for (const cls of file.classes) {
-        output += `• class: ${cls}\n`;
-    }
-    return output;
-}

package/dist/formatters/raw.d.ts

@@ -1,2 +0,0 @@
-import type { AdapterContext } from "../adapters/types.js";
-export declare function formatRaw(data: AdapterContext): string;

package/dist/formatters/raw.js

@@ -1,47 +0,0 @@
-export function formatRaw(data) {
-    const lines = [];
-    lines.push(`# ${data.projectType} Project Context`);
-    lines.push("");
-    // Routes
-    if (data.routes && data.routes.length > 0) {
-        lines.push("## Routes");
-        lines.push("");
-        for (const route of data.routes) {
-            lines.push(`- ${route}`);
-        }
-        lines.push("");
-    }
-    // Sections
-    for (const [sectionName, files] of data.sections) {
-        if (sectionName === "_root")
-            continue;
-        if (files.length === 0)
-            continue;
-        lines.push(`## ${sectionName}`);
-        lines.push("");
-        for (const file of files) {
-            const exports = getExportsSummary(file);
-            if (exports) {
-                lines.push(`- ${file.fileName}: ${exports}`);
-            }
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-}
-function getExportsSummary(file) {
-    const parts = [];
-    if (file.functions.length > 0) {
-        parts.push(file.functions.map((f) => `${f}()`).join(", "));
-    }
-    if (file.constants.length > 0) {
-        parts.push(file.constants.join(", "));
-    }
-    if (file.types.length > 0) {
-        parts.push(file.types.map((t) => `type ${t}`).join(", "));
-    }
-    if (file.interfaces.length > 0) {
-        parts.push(file.interfaces.map((i) => `interface ${i}`).join(", "));
-    }
-    return parts.join(" | ");
-}

package/dist/organizer.d.ts

@@ -1,2 +0,0 @@
-import type { ParsedFile, OrganizedContext } from "./types.js";
-export declare function organize(files: ParsedFile[], baseDir: string): Promise<OrganizedContext>;

package/dist/organizer.js

@@ -1,70 +0,0 @@
-import path from "path";
-import fs from "fs/promises";
-export async function organize(files, baseDir) {
-    const routes = await getRoutes(baseDir);
-    const components = [];
-    const hooks = [];
-    const utils = [];
-    const other = [];
-    for (const file of files) {
-        const rel = file.path.toLowerCase();
-        const hasHooks = file.exports.functions.some((fn) => fn.startsWith("use"));
-        if (hasHooks || file.name.startsWith("use") || rel.includes("/hooks/")) {
-            hooks.push(file);
-        }
-        else if (rel.includes("/components/") || rel.includes("/ui/")) {
-            components.push(file);
-        }
-        else if (rel.includes("/lib/") ||
-            rel.includes("/utils/") ||
-            rel.includes("/helpers/")) {
-            utils.push(file);
-        }
-        else if (!rel.includes("/app/") && !rel.includes("/pages/")) {
-            other.push(file);
-        }
-    }
-    return { routes, components, hooks, utils, other };
-}
-async function getRoutes(baseDir) {
-    const possibleDirs = [
-        path.join(baseDir, "app"),
-        path.join(baseDir, "src", "app"),
-        path.join(baseDir, "pages"),
-        path.join(baseDir, "src", "pages"),
-    ];
-    for (const dir of possibleDirs) {
-        try {
-            await fs.access(dir);
-            return walkRoutes(dir, "");
-        }
-        catch {
-            continue;
-        }
-    }
-    return [];
-}
-async function walkRoutes(dir, prefix) {
-    const routes = [];
-    let entries;
-    try {
-        entries = await fs.readdir(dir, { withFileTypes: true });
-    }
-    catch {
-        return routes;
-    }
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        if (entry.name.startsWith("_"))
-            continue;
-        if (entry.name.startsWith("("))
-            continue;
-        if (entry.name === "api")
-            continue;
-        const route = prefix + "/" + entry.name;
-        routes.push(route);
-        routes.push(...(await walkRoutes(path.join(dir, entry.name), route)));
-    }
-    return routes;
-}