aidoc-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clément Tournier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,231 @@
+# aidoc-kit
+
+> AI-native documentation scanner for JS/TS projects
+
+[![npm version](https://badge.fury.io/js/aidoc-kit.svg)](https://www.npmjs.com/package/aidoc-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](tsconfig.json)
+
+## The problem
+
+When AI agents (GitHub Copilot, Cursor, Claude) work on large Next.js projects with 200–400 files, they lose context between sessions. They re-discover architecture, miss existing conventions, and break established patterns.
+
+## How it works
+
+1. **Scan** — aidoc-kit reads your entire project via TypeScript's native AST compiler
+2. **Generate** — it creates `@ai-*` doc blocks on every file and builds a reverse dependency graph
+3. **Agents understand** — Copilot and any AI agent reads `.codemod/` and `AGENTS.md` to instantly understand your project without reading 400 files
+
+## Installation
+
+```bash
+npm install -D aidoc-kit
+# or run directly without installing:
+npx aidoc-kit scan
+```
+
+## Quick start
+
+```bash
+# In any JS/TS project root:
+npx aidoc-kit scan
+
+# Output:
+# ✓ 47 fichiers scannés
+# ✓ 12 fichiers avec blocs @ai-*
+# ✗ 35 fichiers sans docs
+#
+# ✓ .codemod/ai-knowledge-base.json mis à jour
+# ✓ AGENTS.md mis à jour
+
+# Preview generated blocks without writing anything:
+npx aidoc-kit scan --dry
+
+# Write missing blocks to files (asks confirmation):
+npx aidoc-kit scan --write
+```
+
+## What gets generated
+
+### On each file (auto-generated block)
+
+```typescript
+/**
+ * @ai-agent auth-expert
+ * @ai-runtime CLIENT UNIQUEMENT
+ *
+ * @ai-context
+ * [GÉNÉRÉ] Ce fichier exporte : AuthProvider, useAuthContext
+ * Importé dans : src/app/layout.tsx, src/hooks/use-auth.ts
+ *
+ * @ai-when-modifying
+ * 1. Vérifier les fichiers en cascade ci-dessous
+ * 2. Lancer @ai-validate après toute modification
+ *
+ * @ai-cascade
+ * → src/hooks/use-auth.ts
+ * → src/lib/types.ts
+ *
+ * @ai-validate
+ * npm run typecheck
+ */
+```
+
+### At project root
+
+- `AGENTS.md` — entry point for any AI agent working on the project
+- `.codemod/ai-knowledge-base.json` — full indexed knowledge base (agents, cascade graph, runtime map)
+
+## Supported `@ai-*` tags
+
+| Tag | Description |
+|-----|-------------|
+| `@ai-agent` | Domain expert responsible for this file |
+| `@ai-agents-related` | Other agents to consult when modifying |
+| `@ai-runtime` | `CLIENT UNIQUEMENT` / `SERVER UNIQUEMENT` / `UNIVERSEL` |
+| `@ai-context` | What this file does and exposes |
+| `@ai-when-modifying` | Rules to follow when editing |
+| `@ai-always` | Invariants that must always be respected |
+| `@ai-never` | Absolute prohibitions |
+| `@ai-pattern` | Correct usage code example |
+| `@ai-cascade` | Files that must be checked after modifying this one |
+| `@ai-validate` | Command to run after modifications |
+
+## Runtime auto-detection
+
+aidoc-kit detects the execution environment automatically:
+
+| Signal | Runtime |
+|--------|---------|
+| `'use client'` directive | `CLIENT UNIQUEMENT` |
+| `'use server'` directive | `SERVER UNIQUEMENT` |
+| `firebase-admin` import | `SERVER UNIQUEMENT` |
+| `useState` / `useEffect` usage | `CLIENT UNIQUEMENT` |
+| None of the above | `UNIVERSEL` |
+
+## Agent inference
+
+The responsible agent is inferred from imports and file path, in priority order:
+
+1. **Custom rules** from `aidoc.config.js` — your project-specific mappings
+2. **Built-in rules** — `firebase-admin` → `firebase-admin-expert`, `stripe` → `billing-expert`, `@tanstack/react-query` → `data-fetching-expert`, `zustand` → `state-expert`, `react-hook-form` → `forms-expert`, …
+3. **Path heuristics** — `/hooks/` → `hooks-expert`, `/api/` → `api-expert`, `/components/` → `ui-expert`, …
+
+## Configuration
+
+Create `aidoc.config.js` at your project root:
+
+```js
+// aidoc.config.js
+module.exports = {
+  agents: {
+    'firebase-admin': 'firebase-admin-expert',
+    'stripe': 'billing-expert',
+    '@/lib/permissions': 'permissions-expert',
+  },
+  ignore: ['src/generated/', '*.test.ts', '*.spec.ts'],
+  validate: 'npm run typecheck',
+}
+```
+
+Or as JSON:
+
+```json
+{
+  "agents": { "stripe": "billing-expert" },
+  "ignore": ["src/generated/"],
+  "validate": "npm run typecheck"
+}
+```
+
+## Large file chunking
+
+AI agents often truncate large files — reading only the first 50-100 lines of a 500-line file. `aidoc-kit chunk` solves this by pre-summarising every file over 150 lines into a structured Markdown file inside `.codemod/chunks/`.
+
+```bash
+npx aidoc-kit chunk
+# 📦 src/contexts/auth-context.tsx (320 lignes)
+# 📦 src/lib/firebase.ts (210 lignes)
+#
+# ✓ 2 fichier(s) chunkés → .codemod/chunks/
+```
+
+Each generated chunk looks like:
+
+```markdown
+# Chunk — src/contexts/auth-context.tsx
+> 320 lignes — généré par aidoc-kit chunk
+
+## Exports publics
+- `AuthProvider` (function) — ligne 45
+- `AuthContextType` (interface) — ligne 12
+- `useAuthContext` (const) — ligne 89
+
+## Imports critiques
+- firebase/auth (getAuth, onAuthStateChanged, signInWithEmailAndPassword)
+- react (createContext, useContext, useState, useEffect)
+- @/lib/types (User, UserRole)
+
+## Structure du fichier
+- L. 1-50 : imports
+- L. 51-100 : types et interfaces
+- L. 101-150 : hooks React
+- L. 151-200 : fonctions asynchrones
+- L. 201-320 : rendu JSX
+
+## Fonctions et méthodes
+| Nom | Lignes | Paramètres | Retour |
+|-----|--------|------------|--------|
+| AuthProvider | 45-180 | children: ReactNode | JSX.Element |
+| useAuthContext | 181-200 | — | AuthContextType |
+
+## Importé par
+- `src/app/layout.tsx`
+- `src/hooks/use-auth.ts`
+```
+
+Tell your AI agent: *"Read `.codemod/chunks/` before modifying any large file."*
+
+## CLI reference
+
+```
+aidoc-kit — AI-native documentation toolkit
+
+Commands:
+  scan   Scan a project and build the knowledge base
+         --path <dir>   Project root (default: .)
+         --write        Write missing @ai-* blocks (interactive confirmation)
+         --dry          Preview generated blocks without writing anything
+
+  chunk  Summarise large files (≥150 lines) into .codemod/chunks/*.md
+         --path <dir>   Project root (default: .)
+
+  run    Apply transformation rules
+         --path <dir>   Project root (default: .)
+         --dry          Preview changes without writing
+```
+
+## Reverse dependency graph
+
+One of aidoc-kit's core features is the **reverse import map**: for every file, it resolves which other files import it (via the TypeScript AST, not text search). This powers the accurate `@ai-cascade` section — when you touch `types.ts`, the agent knows exactly which 4 files depend on it.
+
+## Why zero dependencies?
+
+aidoc-kit uses only Node.js built-ins + the TypeScript compiler already installed in every TypeScript project. No extra packages, no version conflicts, no supply chain risk.
+
+## Roadmap
+
+- [ ] VS Code extension with `@ai-*` tag highlighting and hover docs
+- [ ] MCP server to expose scan/transform as AI agent tools
+- [ ] `--watch` mode (rebuild knowledge base on save)
+- [ ] Public rules registry for popular lib migrations (Next.js, Firebase, Stripe)
+- [ ] CI/CD integration to validate `@ai-*` coverage on each PR
+- [ ] HTML visual report of the dependency graph
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Author
+
+Made by [Clément Tournier](https://github.com/Clemsrec)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_readline_1 = require("node:readline");
+const node_path_1 = require("node:path");
+const scanner_1 = require("./core/scanner");
+const transformer_1 = require("./core/transformer");
+const writer_1 = require("./core/writer");
+const chunker_1 = require("./core/chunker");
+const config_1 = require("./core/config");
+const index_1 = require("./rules/index");
+// ─── Arg helpers ───────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const command = args[0];
+function getFlag(flag) {
+    const idx = args.indexOf(flag);
+    return idx !== -1 ? args[idx + 1] : undefined;
+}
+function hasFlag(flag) {
+    return args.includes(flag);
+}
+// ─── Confirmation prompt ───────────────────────────────────────────────────
+function confirm(message) {
+    // Non-interactive (piped input, CI) → proceed without prompt
+    if (!process.stdin.isTTY)
+        return Promise.resolve(true);
+    return new Promise(resolve => {
+        const rl = (0, node_readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+        rl.question(`${message} (y/n) `, answer => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}
+// ─── scan ──────────────────────────────────────────────────────────────────
+async function cmdScan() {
+    const projectRoot = (0, node_path_1.resolve)(getFlag('--path') ?? '.');
+    const write = hasFlag('--write');
+    const dry = hasFlag('--dry');
+    const config = (0, config_1.loadConfig)(projectRoot);
+    console.log(`\naidoc-kit scan → ${projectRoot}\n`);
+    const result = (0, scanner_1.scanProject)(projectRoot);
+    // Filter out files matching config.ignore patterns
+    const ignorePatterns = config.ignore ?? [];
+    const filteredWithoutDocs = ignorePatterns.length > 0
+        ? result.filesWithoutDocs.filter(f => !(0, config_1.isIgnored)(f, ignorePatterns))
+        : result.filesWithoutDocs;
+    console.log(`✓ ${result.totalScanned} fichiers scannés`);
+    console.log(`✓ ${result.docs.length} fichiers avec blocs @ai-*`);
+    console.log(`✗ ${filteredWithoutDocs.length} fichiers sans docs${ignorePatterns.length > 0 ? ' (après filtres ignore)' : ''}\n`);
+    if (filteredWithoutDocs.length > 0 && (write || dry)) {
+        // Build reverse import map once for all files
+        const allAbsFiles = [
+            ...result.docs.map(d => (0, node_path_1.resolve)(projectRoot, d.file)),
+            ...filteredWithoutDocs.map(f => (0, node_path_1.resolve)(projectRoot, f)),
+        ];
+        const reverseMap = (0, scanner_1.buildReverseImportMap)(allAbsFiles);
+        if (dry) {
+            console.log('Aperçu des blocs générés :');
+            for (const relFile of filteredWithoutDocs) {
+                const absFile = (0, node_path_1.resolve)(projectRoot, relFile);
+                const importers = (reverseMap.get(absFile) ?? []).map(f => (0, node_path_1.relative)(projectRoot, f));
+                const block = (0, transformer_1.generateAiDocBlock)(absFile, importers, config);
+                if (block)
+                    console.log(`\n── ${relFile} ──\n${block}`);
+            }
+            console.log();
+        }
+        else {
+            // Ask confirmation before writing
+            const ok = await confirm(`→ Écrire les blocs @ai-* dans ${filteredWithoutDocs.length} fichier(s) ?`);
+            if (!ok) {
+                console.log('Annulé.');
+                return;
+            }
+            console.log();
+            for (const relFile of filteredWithoutDocs) {
+                const absFile = (0, node_path_1.resolve)(projectRoot, relFile);
+                const importers = (reverseMap.get(absFile) ?? []).map(f => (0, node_path_1.relative)(projectRoot, f));
+                const block = (0, transformer_1.generateAiDocBlock)(absFile, importers, config);
+                if (!block)
+                    continue;
+                (0, writer_1.writeDocBlock)(absFile, block);
+                console.log(`  ✓ ${relFile}`);
+            }
+            console.log();
+        }
+    }
+    if (!dry) {
+        (0, writer_1.writeKnowledgeBase)(result, projectRoot);
+        (0, writer_1.writeAgentsMd)(result, projectRoot);
+        console.log('✓ .codemod/ai-knowledge-base.json mis à jour');
+        console.log('✓ AGENTS.md mis à jour');
+    }
+}
+// ─── run ───────────────────────────────────────────────────────────────────
+function cmdRun() {
+    const projectRoot = (0, node_path_1.resolve)(getFlag('--path') ?? '.');
+    const dry = hasFlag('--dry');
+    console.log(`\naidoc-kit run → ${projectRoot}\n`);
+    const result = (0, scanner_1.scanProject)(projectRoot);
+    let changedCount = 0;
+    for (const doc of result.docs) {
+        const absFile = (0, node_path_1.resolve)(projectRoot, doc.file);
+        const { changed, source } = (0, transformer_1.applyRules)(absFile, index_1.defaultRules);
+        if (changed) {
+            if (!dry)
+                (0, node_fs_1.writeFileSync)(absFile, source, 'utf-8');
+            console.log(`  ${dry ? '[dry]' : '✓'} ${doc.file}`);
+            changedCount++;
+        }
+    }
+    if (changedCount === 0) {
+        console.log('Aucune transformation à appliquer.');
+    }
+    else {
+        console.log(`\n${dry ? '[dry]' : '✓'} ${changedCount} fichier(s) transformé(s)`);
+    }
+}
+// ─── chunk ────────────────────────────────────────────────────────────────
+async function cmdChunk() {
+    const projectRoot = (0, node_path_1.resolve)(getFlag('--path') ?? '.');
+    console.log(`\naidoc-kit chunk → ${projectRoot}\n`);
+    const allFiles = (0, scanner_1.walkDir)(projectRoot);
+    const reverseMap = (0, scanner_1.buildReverseImportMap)(allFiles);
+    const codemodDir = (0, node_path_1.join)(projectRoot, '.codemod');
+    let chunked = 0;
+    for (const filePath of allFiles) {
+        const importedBy = reverseMap.get(filePath) ?? [];
+        const chunk = (0, chunker_1.chunkFile)(filePath, importedBy, projectRoot);
+        if (chunk) {
+            (0, chunker_1.writeChunk)(chunk, codemodDir);
+            console.log(`  📦 ${chunk.filePath} (${chunk.totalLines} lignes)`);
+            chunked++;
+        }
+    }
+    if (chunked === 0) {
+        console.log(`Aucun fichier ne dépasse le seuil (150 lignes). Chunking non nécessaire.`);
+    }
+    else {
+        console.log(`\n✓ ${chunked} fichier(s) chunkés → .codemod/chunks/`);
+        console.log('💡 Dis à ton agent : "Lis .codemod/chunks/ avant de modifier un gros fichier"');
+    }
+}
+// ─── help ──────────────────────────────────────────────────────────────────
+function printHelp() {
+    console.log(`
+aidoc-kit — AI-native documentation toolkit
+
+Commandes :
+  scan   Scanner un projet et construire la knowledge base
+         --path <dir>   Dossier racine (défaut: .)
+         --write        Écrire les blocs @ai-* manquants (confirmation interactive)
+         --dry          Afficher les blocs générés sans modifier les fichiers
+
+  run    Appliquer les règles de transformation
+         --path <dir>   Dossier racine (défaut: .)
+         --dry          Afficher les changements sans modifier les fichiers
+
+Config :
+  Créer un fichier aidoc.config.js (ou .json) à la racine du projet :
+
+    module.exports = {
+      agents: { '@/lib/permissions': 'permissions-expert', 'stripe': 'billing-expert' },
+      ignore: ['src/generated/**', '**/*.test.ts'],
+      validate: 'npm run typecheck',
+    }
+
+Exemples :
+  npx aidoc-kit scan
+  npx aidoc-kit scan --path ./src --dry
+  npx aidoc-kit scan --write
+  npx aidoc-kit run --dry
+  npx aidoc-kit chunk
+  npx aidoc-kit chunk --path ./src
+`);
+}
+// ─── Dispatch ─────────────────────────────────────────────────────────────
+switch (command) {
+    case 'scan':
+        cmdScan().catch((err) => {
+            console.error(err);
+            process.exit(1);
+        });
+        break;
+    case 'run':
+        cmdRun();
+        break;
+    case 'chunk':
+        cmdChunk().catch((err) => {
+            console.error(err);
+            process.exit(1);
+        });
+        break;
+    default:
+        printHelp();
+        break;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/chunker.d.ts

@@ -0,0 +1,41 @@
+export interface FileChunk {
+    filePath: string;
+    totalLines: number;
+    exports: ExportInfo[];
+    imports: ImportInfo[];
+    functions: FunctionInfo[];
+    structure: StructureBlock[];
+    importedBy: string[];
+}
+interface ExportInfo {
+    name: string;
+    kind: 'function' | 'interface' | 'type' | 'const' | 'class';
+    line: number;
+}
+interface ImportInfo {
+    from: string;
+    names: string[];
+}
+interface FunctionInfo {
+    name: string;
+    startLine: number;
+    endLine: number;
+    params: string;
+    returnType: string;
+}
+interface StructureBlock {
+    description: string;
+    startLine: number;
+    endLine: number;
+}
+/**
+ * Parse a source file and return a structured chunk summary.
+ * Returns null if the file has fewer lines than CHUNK_THRESHOLD.
+ */
+export declare function chunkFile(filePath: string, importedBy: string[], rootDir: string): FileChunk | null;
+/**
+ * Serialise a FileChunk to a Markdown file under `<outputDir>/chunks/<filePath>.md`.
+ */
+export declare function writeChunk(chunk: FileChunk, outputDir: string): void;
+export {};
+//# sourceMappingURL=chunker.d.ts.map

package/dist/core/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/core/chunker.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,SAAS,EAAE,YAAY,EAAE,CAAA;IACzB,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;IAC3D,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAyGlB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAqDpE"}