aidoc-kit 0.1.0

package/dist/core/transformer.js

@@ -0,0 +1,219 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAiDocBlock = generateAiDocBlock;
+exports.applyRules = applyRules;
+const ts = __importStar(require("typescript"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ─── Writer — generate @ai-* block for undocumented files ─────────────────
+function generateAiDocBlock(filePath, cascadeDeps = [], config = {}) {
+    let source;
+    try {
+        source = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+    const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true);
+    const runtime = detectRuntime(source);
+    const imports = extractImports(sourceFile);
+    const agent = inferAgent(imports, filePath, config.agents ?? {});
+    const exports = extractExports(sourceFile);
+    const validateCmd = config.validate ?? 'npm run typecheck';
+    const exportList = exports.length > 0 ? exports.join(', ') : (0, node_path_1.basename)(filePath);
+    const importedIn = cascadeDeps.length > 0
+        ? `Importé dans : ${cascadeDeps.slice(0, 3).join(', ')}`
+        : '';
+    const cascadeLines = cascadeDeps.length > 0
+        ? cascadeDeps.map(f => ` * → ${f}`).join('\n')
+        : ' * (aucun détecté)';
+    return `/**
+ * @ai-agent ${agent}
+ * @ai-runtime ${runtime}
+ *
+ * @ai-context
+ * [GÉNÉRÉ] Ce fichier exporte : ${exportList}
+ * ${importedIn}
+ *
+ * @ai-when-modifying
+ * 1. Vérifier les fichiers en cascade ci-dessous avant de modifier
+ * 2. Après modification, indiquer au développeur de lancer @ai-validate
+ * 3. Si tu n'as pas accès au terminal, signaler la commande à exécuter
+ *
+ * @ai-cascade
+${cascadeLines}
+ *
+ * @ai-validate
+ * ${validateCmd}
+ */`;
+}
+// ─── Transformer — apply rules to a file ──────────────────────────────────
+function applyRules(filePath, rules) {
+    let source;
+    try {
+        source = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+    }
+    catch {
+        return { changed: false, source: '' };
+    }
+    const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true);
+    const edits = [];
+    ts.forEachChild(sourceFile, function visit(node) {
+        for (const rule of rules) {
+            if (rule.match(node, sourceFile)) {
+                const replacement = rule.replace(node, sourceFile);
+                if (replacement !== null) {
+                    edits.push({ start: node.getStart(sourceFile), end: node.getEnd(), replacement });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    });
+    if (edits.length === 0)
+        return { changed: false, source };
+    // Apply in reverse order to preserve character positions
+    edits.sort((a, b) => b.start - a.start);
+    let result = source;
+    for (const edit of edits) {
+        result = result.slice(0, edit.start) + edit.replacement + result.slice(edit.end);
+    }
+    return { changed: true, source: result };
+}
+// ─── AST helpers ──────────────────────────────────────────────────────────
+function extractImports(sourceFile) {
+    const imports = [];
+    ts.forEachChild(sourceFile, node => {
+        if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
+            imports.push(node.moduleSpecifier.text);
+        }
+    });
+    return imports;
+}
+function extractExports(sourceFile) {
+    const exports = [];
+    ts.forEachChild(sourceFile, node => {
+        const hasExport = (n) => n.modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+        if ((ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node)) && hasExport(node)) {
+            if (node.name)
+                exports.push(node.name.text);
+        }
+        else if (ts.isVariableStatement(node) && hasExport(node)) {
+            node.declarationList.declarations.forEach(d => {
+                if (ts.isIdentifier(d.name))
+                    exports.push(d.name.text);
+            });
+        }
+        else if (ts.isTypeAliasDeclaration(node) && hasExport(node)) {
+            exports.push(node.name.text);
+        }
+        else if (ts.isInterfaceDeclaration(node) && hasExport(node)) {
+            exports.push(node.name.text);
+        }
+    });
+    return exports;
+}
+/** Infer the responsible agent from import paths and file location */
+function inferAgent(imports, filePath, customRules = {}) {
+    const importStr = imports.join(' ');
+    // 1. Custom rules from aidoc.config — checked first so projects can override
+    for (const [substring, agent] of Object.entries(customRules)) {
+        if (importStr.includes(substring) || filePath.includes(substring))
+            return agent;
+    }
+    // 2. Built-in import-based rules (most specific first)
+    if (/firebase-admin/.test(importStr))
+        return 'firebase-admin-expert';
+    if (/firebase\/auth/.test(importStr))
+        return 'auth-expert';
+    if (/firebase/.test(importStr))
+        return 'firebase-expert';
+    if (/next-auth|next\/auth/.test(importStr))
+        return 'auth-expert';
+    if (/stripe/.test(importStr))
+        return 'billing-expert';
+    if (/prisma|drizzle|sequelize|mongoose/.test(importStr))
+        return 'db-expert';
+    if (/@tanstack\/react-query|react-query|swr/.test(importStr))
+        return 'data-fetching-expert';
+    if (/zustand/.test(importStr))
+        return 'state-expert';
+    if (/react-hook-form/.test(importStr))
+        return 'forms-expert';
+    if (/next\/navigation|next\/router/.test(importStr))
+        return 'routing-expert';
+    if (/next\/image|next\/link/.test(importStr))
+        return 'ui-expert';
+    if (/context|provider/i.test(importStr))
+        return 'context-expert';
+    // 3. File path heuristics
+    if (/\/store\//i.test(filePath))
+        return 'state-expert';
+    if (/\/auth\//i.test(filePath))
+        return 'auth-expert';
+    if (/\/hooks\//i.test(filePath))
+        return 'hooks-expert';
+    if (/\/api\//i.test(filePath))
+        return 'api-expert';
+    if (/\/components?\//i.test(filePath))
+        return 'ui-expert';
+    if (/\/lib\//i.test(filePath) || /\/utils?\//i.test(filePath))
+        return 'utils-expert';
+    if (/\/types?\.?/i.test(filePath))
+        return 'types-expert';
+    return 'general-expert';
+}
+// ─── Runtime detection ─────────────────────────────────────────────────────
+/**
+ * Detect the execution environment from source code.
+ * Explicit directives (`'use client'`, `'use server'`) take priority,
+ * then heuristics (React hooks → CLIENT, firebase-admin imports → SERVER).
+ */
+function detectRuntime(source) {
+    // Only inspect the file head for the directives to avoid false positives inside strings
+    const head = source.slice(0, 300);
+    if (/^\s*(?:\/\/[^\n]*\n\s*)*['"]use client['"]/.test(head))
+        return 'CLIENT UNIQUEMENT';
+    if (/^\s*(?:\/\/[^\n]*\n\s*)*['"]use server['"]/.test(head))
+        return 'SERVER UNIQUEMENT';
+    // Heuristics on full source
+    if (/['"]firebase-admin['"]/.test(source))
+        return 'SERVER UNIQUEMENT';
+    if (/\buseState\b|\buseEffect\b|\buseRef\b|\buseReducer\b|\buseCallback\b|\buseMemo\b/.test(source)) {
+        return 'CLIENT UNIQUEMENT';
+    }
+    return 'UNIVERSEL';
+}
+//# sourceMappingURL=transformer.js.map

package/dist/core/transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.js","sourceRoot":"","sources":["../../src/core/transformer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,gDA+CC;AAID,gCAoCC;AA9FD,+CAAgC;AAChC,qCAAqD;AACrD,yCAAoC;AAGpC,6EAA6E;AAE7E,SAAgB,kBAAkB,CAChC,QAAgB,EAChB,cAAwB,EAAE,EAC1B,SAAsB,EAAE;IAExB,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEtF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;IAChE,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,IAAI,mBAAmB,CAAA;IAE1D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,oBAAQ,EAAC,QAAQ,CAAC,CAAA;IAC/E,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,kBAAkB,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACxD,CAAC,CAAC,EAAE,CAAA;IACN,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;QACzC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,oBAAoB,CAAA;IAExB,OAAO;eACM,KAAK;iBACH,OAAO;;;mCAGW,UAAU;KACxC,UAAU;;;;;;;;EAQb,YAAY;;;KAGT,WAAW;IACZ,CAAA;AACJ,CAAC;AAED,6EAA6E;AAE7E,SAAgB,UAAU,CACxB,QAAgB,EAChB,KAAa;IAEb,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACtF,MAAM,KAAK,GAA+D,EAAE,CAAA;IAE5E,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,SAAS,KAAK,CAAC,IAAI;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;gBACjC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;gBAClD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAA;gBACnF,CAAC;YACH,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAEzD,yDAAyD;IACzD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;IACvC,IAAI,MAAM,GAAG,MAAM,CAAA;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC1C,CAAC;AAED,6EAA6E;AAE7E,SAAS,cAAc,CAAC,UAAyB;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;QACjC,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC;IACH,CAAC,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,UAAyB;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;QACjC,MAAM,SAAS,GAAG,CAAC,CAAU,EAAE,EAAE,CAC9B,CAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAAA;QAE9F,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACvF,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,CAAC;aAAM,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBAC5C,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACxD,CAAC,CAAC,CAAA;QACJ,CAAC;aAAM,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;aAAM,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,sEAAsE;AACtE,SAAS,UAAU,CACjB,OAAiB,EACjB,QAAgB,EAChB,cAAsC,EAAE;IAExC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEnC,6EAA6E;IAC7E,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAA;IACjF,CAAC;IAED,uDAAuD;IACvD,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,uBAAuB,CAAA;IACpE,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,aAAa,CAAA;IAC1D,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,iBAAiB,CAAA;IACxD,IAAI,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,aAAa,CAAA;IAChE,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,gBAAgB,CAAA;IACrD,IAAI,mCAAmC,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,WAAW,CAAA;IAC3E,IAAI,wCAAwC,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,sBAAsB,CAAA;IAC3F,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,cAAc,CAAA;IACpD,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,cAAc,CAAA;IAC5D,IAAI,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAC5E,IAAI,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,WAAW,CAAA;IAChE,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAEhE,0BAA0B;IAC1B,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,cAAc,CAAA;IACtD,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAA;IACpD,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,cAAc,CAAA;IACtD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAA;IAClD,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAA;IACzD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,cAAc,CAAA;IACpF,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,cAAc,CAAA;IAExD,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,wFAAwF;IACxF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAEjC,IAAI,4CAA4C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,mBAAmB,CAAA;IACvF,IAAI,4CAA4C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,mBAAmB,CAAA;IAEvF,4BAA4B;IAC5B,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,mBAAmB,CAAA;IACrE,IAAI,kFAAkF,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpG,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/core/writer.d.ts

@@ -0,0 +1,5 @@
+import type { ScanResult } from '../types';
+export declare function writeKnowledgeBase(result: ScanResult, projectRoot: string): void;
+export declare function writeAgentsMd(result: ScanResult, projectRoot: string): void;
+export declare function writeDocBlock(filePath: string, docBlock: string): void;
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/core/writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA6B,UAAU,EAAE,MAAM,UAAU,CAAA;AAIrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAKhF;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA2D3E;AAID,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAItE"}

package/dist/core/writer.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeKnowledgeBase = writeKnowledgeBase;
+exports.writeAgentsMd = writeAgentsMd;
+exports.writeDocBlock = writeDocBlock;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ─── Knowledge base ────────────────────────────────────────────────────────
+function writeKnowledgeBase(result, projectRoot) {
+    const outDir = (0, node_path_1.join)(projectRoot, '.codemod');
+    (0, node_fs_1.mkdirSync)(outDir, { recursive: true });
+    const kb = buildKnowledgeBase(result.docs);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outDir, 'ai-knowledge-base.json'), JSON.stringify(kb, null, 2), 'utf-8');
+}
+// ─── AGENTS.md ─────────────────────────────────────────────────────────────
+function writeAgentsMd(result, projectRoot) {
+    const kb = buildKnowledgeBase(result.docs);
+    const lines = [
+        '# AGENTS',
+        '',
+        `> Généré par aidoc-kit le ${new Date().toISOString().slice(0, 10)}`,
+        `> ${result.totalScanned} fichiers scannés — ${result.docs.length} avec docs @ai-*`,
+        '',
+        '## Agents et leurs domaines',
+        '',
+    ];
+    for (const [agent, info] of Object.entries(kb.agents)) {
+        lines.push(`### ${agent}`, '');
+        lines.push(`**Fichiers :** ${info.owns.length}`);
+        info.owns.slice(0, 10).forEach(f => lines.push(`- \`${f}\``));
+        if (info.owns.length > 10)
+            lines.push(`- *(+ ${info.owns.length - 10} autres)*`);
+        if (info.consultedBy.length > 0) {
+            lines.push('', `**Consulté par :** ${info.consultedBy.join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (Object.keys(kb.runtimeMap).length > 0) {
+        lines.push('## Runtime Map', '');
+        for (const [runtime, files] of Object.entries(kb.runtimeMap)) {
+            lines.push(`### ${runtime} (${files.length} fichiers)`, '');
+            files.slice(0, 5).forEach(f => lines.push(`- \`${f}\``));
+            if (files.length > 5)
+                lines.push(`- *(+ ${files.length - 5} autres)*`);
+            lines.push('');
+        }
+    }
+    if (result.filesWithoutDocs.length > 0) {
+        lines.push('## Fichiers sans documentation @ai-*', '', `${result.filesWithoutDocs.length} fichier(s) sans bloc \`@ai-*\` détecté(s).`, 'Lancer `npx aidoc-kit scan --write` pour générer les blocs manquants.', '');
+    }
+    lines.push('## Fichiers volumineux — lire le chunk avant de modifier', '', 'Les fichiers de plus de 150 lignes ont un résumé structuré dans `.codemod/chunks/`.', 'Avant de modifier un fichier volumineux, **lire le fichier `.md` correspondant** dans ce dossier.', 'Ne pas tenter de lire le fichier source en entier — utiliser le chunk.', '', 'Exemple : avant de modifier `src/contexts/auth-context.tsx`', '→ Lire `.codemod/chunks/src/contexts/auth-context.tsx.md`', '', '> Les chunks sont générés et maintenus par le développeur via `npx aidoc-kit chunk`.', '> Si un chunk est manquant, demander au développeur de lancer cette commande.', '');
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(projectRoot, 'AGENTS.md'), lines.join('\n'), 'utf-8');
+}
+// ─── Prepend doc block to a file ──────────────────────────────────────────
+function writeDocBlock(filePath, docBlock) {
+    const existing = (0, node_fs_1.readFileSync)(filePath, 'utf-8');
+    if (existing.includes('@ai-agent'))
+        return; // already documented
+    (0, node_fs_1.writeFileSync)(filePath, docBlock + '\n' + existing, 'utf-8');
+}
+// ─── Builder ────────────────────────────────────────────────────────────────
+function buildKnowledgeBase(docs) {
+    const agents = {};
+    const cascadeGraph = {};
+    const runtimeMap = {};
+    const validationCommands = {};
+    for (const doc of docs) {
+        // Agent ownership
+        if (!agents[doc.agent])
+            agents[doc.agent] = { owns: [], consultedBy: [] };
+        agents[doc.agent].owns.push(doc.file);
+        // Related agents get a "consultedBy" entry
+        for (const rel of doc.related) {
+            if (!rel)
+                continue;
+            if (!agents[rel])
+                agents[rel] = { owns: [], consultedBy: [] };
+            if (!agents[rel].consultedBy.includes(doc.agent)) {
+                agents[rel].consultedBy.push(doc.agent);
+            }
+        }
+        // Cascade graph
+        if (doc.cascade.length > 0)
+            cascadeGraph[doc.file] = doc.cascade;
+        // Runtime map
+        const rt = doc.runtime || 'UNIVERSEL';
+        if (!runtimeMap[rt])
+            runtimeMap[rt] = [];
+        runtimeMap[rt].push(doc.file);
+        // Validation commands
+        if (doc.validate) {
+            if (!validationCommands[doc.validate])
+                validationCommands[doc.validate] = [];
+            validationCommands[doc.validate].push(doc.file);
+        }
+    }
+    return { generatedAt: new Date().toISOString(), agents, cascadeGraph, runtimeMap, validationCommands };
+}
+//# sourceMappingURL=writer.js.map

package/dist/core/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/core/writer.ts"],"names":[],"mappings":";;AAMA,gDAKC;AAID,sCA2DC;AAID,sCAIC;AAlFD,qCAAgE;AAChE,yCAAgC;AAGhC,8EAA8E;AAE9E,SAAgB,kBAAkB,CAAC,MAAkB,EAAE,WAAmB;IACxE,MAAM,MAAM,GAAG,IAAA,gBAAI,EAAC,WAAW,EAAE,UAAU,CAAC,CAAA;IAC5C,IAAA,mBAAS,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACtC,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1C,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,MAAM,EAAE,wBAAwB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AAC7F,CAAC;AAED,8EAA8E;AAE9E,SAAgB,aAAa,CAAC,MAAkB,EAAE,WAAmB;IACnE,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAa;QACtB,UAAU;QACV,EAAE;QACF,6BAA6B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QACpE,KAAK,MAAM,CAAC,YAAY,uBAAuB,MAAM,CAAC,IAAI,CAAC,MAAM,kBAAkB;QACnF,EAAE;QACF,6BAA6B;QAC7B,EAAE;KACH,CAAA;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9B,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QAC7D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,WAAW,CAAC,CAAA;QAChF,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sBAAsB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACrE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;QAChC,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,KAAK,CAAC,MAAM,YAAY,EAAE,EAAE,CAAC,CAAA;YAC3D,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YACxD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,GAAG,CAAC,WAAW,CAAC,CAAA;YACtE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CACR,sCAAsC,EACtC,EAAE,EACF,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,6CAA6C,EAC9E,uEAAuE,EACvE,EAAE,CACH,CAAA;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,0DAA0D,EAC1D,EAAE,EACF,qFAAqF,EACrF,mGAAmG,EACnG,wEAAwE,EACxE,EAAE,EACF,6DAA6D,EAC7D,2DAA2D,EAC3D,EAAE,EACF,sFAAsF,EACtF,+EAA+E,EAC/E,EAAE,CACH,CAAA;IAED,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,WAAW,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;AAC1E,CAAC;AAED,6EAA6E;AAE7E,SAAgB,aAAa,CAAC,QAAgB,EAAE,QAAgB;IAC9D,MAAM,QAAQ,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAChD,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAM,CAAC,qBAAqB;IAChE,IAAA,uBAAa,EAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAA;AAC9D,CAAC;AAED,+EAA+E;AAE/E,SAAS,kBAAkB,CAAC,IAAkB;IAC5C,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,MAAM,YAAY,GAA6B,EAAE,CAAA;IACjD,MAAM,UAAU,GAA6B,EAAE,CAAA;IAC/C,MAAM,kBAAkB,GAA6B,EAAE,CAAA;IAEvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,kBAAkB;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;QACzE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAErC,2CAA2C;QAC3C,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;YAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAA;QAEhE,cAAc;QACd,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,IAAI,WAAW,CAAA;QACrC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAA;QACxC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE7B,sBAAsB;QACtB,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAA;YAC5E,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAA;AACxG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { scanProject, extractAiDocs, buildReverseImportMap } from './core/scanner';
+export { generateAiDocBlock, applyRules } from './core/transformer';
+export { writeKnowledgeBase, writeAgentsMd, writeDocBlock } from './core/writer';
+export { loadConfig, isIgnored } from './core/config';
+export { defaultRules, removeConsoleLogs, replaceAnyWithUnknown } from './rules/index';
+export type { AiDocBlock, Rule, ScanResult, KnowledgeBase, AidocConfig } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAChF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACtF,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceAnyWithUnknown = exports.removeConsoleLogs = exports.defaultRules = exports.isIgnored = exports.loadConfig = exports.writeDocBlock = exports.writeAgentsMd = exports.writeKnowledgeBase = exports.applyRules = exports.generateAiDocBlock = exports.buildReverseImportMap = exports.extractAiDocs = exports.scanProject = void 0;
+// Programmatic API — import aidoc-kit as a module
+var scanner_1 = require("./core/scanner");
+Object.defineProperty(exports, "scanProject", { enumerable: true, get: function () { return scanner_1.scanProject; } });
+Object.defineProperty(exports, "extractAiDocs", { enumerable: true, get: function () { return scanner_1.extractAiDocs; } });
+Object.defineProperty(exports, "buildReverseImportMap", { enumerable: true, get: function () { return scanner_1.buildReverseImportMap; } });
+var transformer_1 = require("./core/transformer");
+Object.defineProperty(exports, "generateAiDocBlock", { enumerable: true, get: function () { return transformer_1.generateAiDocBlock; } });
+Object.defineProperty(exports, "applyRules", { enumerable: true, get: function () { return transformer_1.applyRules; } });
+var writer_1 = require("./core/writer");
+Object.defineProperty(exports, "writeKnowledgeBase", { enumerable: true, get: function () { return writer_1.writeKnowledgeBase; } });
+Object.defineProperty(exports, "writeAgentsMd", { enumerable: true, get: function () { return writer_1.writeAgentsMd; } });
+Object.defineProperty(exports, "writeDocBlock", { enumerable: true, get: function () { return writer_1.writeDocBlock; } });
+var config_1 = require("./core/config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+Object.defineProperty(exports, "isIgnored", { enumerable: true, get: function () { return config_1.isIgnored; } });
+var index_1 = require("./rules/index");
+Object.defineProperty(exports, "defaultRules", { enumerable: true, get: function () { return index_1.defaultRules; } });
+Object.defineProperty(exports, "removeConsoleLogs", { enumerable: true, get: function () { return index_1.removeConsoleLogs; } });
+Object.defineProperty(exports, "replaceAnyWithUnknown", { enumerable: true, get: function () { return index_1.replaceAnyWithUnknown; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,kDAAkD;AAClD,0CAAkF;AAAzE,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AAC1D,kDAAmE;AAA1D,iHAAA,kBAAkB,OAAA;AAAE,yGAAA,UAAU,OAAA;AACvC,wCAAgF;AAAvE,4GAAA,kBAAkB,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,uGAAA,aAAa,OAAA;AACzD,wCAAqD;AAA5C,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAC9B,uCAAsF;AAA7E,qGAAA,YAAY,OAAA;AAAE,0GAAA,iBAAiB,OAAA;AAAE,8GAAA,qBAAqB,OAAA"}

package/dist/rules/index.d.ts

@@ -0,0 +1,7 @@
+import type { Rule } from '../types';
+/** Remove bare `console.log(...)` expression statements */
+export declare const removeConsoleLogs: Rule;
+/** Replace `any` type annotations with `unknown` */
+export declare const replaceAnyWithUnknown: Rule;
+export declare const defaultRules: Rule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,EAAE,IAgB/B,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,IAKnC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,IAAI,EAA+C,CAAA"}

package/dist/rules/index.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultRules = exports.replaceAnyWithUnknown = exports.removeConsoleLogs = void 0;
+const ts = __importStar(require("typescript"));
+/** Remove bare `console.log(...)` expression statements */
+exports.removeConsoleLogs = {
+    name: 'remove-console-logs',
+    description: 'Supprime les appels console.log',
+    match: (node, sourceFile) => {
+        if (!ts.isExpressionStatement(node))
+            return false;
+        const expr = node.expression;
+        if (!ts.isCallExpression(expr))
+            return false;
+        const access = expr.expression;
+        return (ts.isPropertyAccessExpression(access) &&
+            ts.isIdentifier(access.expression) &&
+            access.expression.text === 'console' &&
+            access.name.text === 'log');
+    },
+    replace: () => '',
+};
+/** Replace `any` type annotations with `unknown` */
+exports.replaceAnyWithUnknown = {
+    name: 'replace-any-with-unknown',
+    description: 'Remplace les annotations `any` par `unknown`',
+    match: (node) => node.kind === ts.SyntaxKind.AnyKeyword,
+    replace: () => 'unknown',
+};
+exports.defaultRules = [exports.removeConsoleLogs, exports.replaceAnyWithUnknown];
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAgC;AAGhC,2DAA2D;AAC9C,QAAA,iBAAiB,GAAS;IACrC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,iCAAiC;IAC9C,KAAK,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;QAC1B,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAA;QAC5B,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAA;QAC9B,OAAO,CACL,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;YACrC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC;YAClC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS;YACpC,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAC3B,CAAA;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;CAClB,CAAA;AAED,oDAAoD;AACvC,QAAA,qBAAqB,GAAS;IACzC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,8CAA8C;IAC3D,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,UAAU;IACvD,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;CACzB,CAAA;AAEY,QAAA,YAAY,GAAW,CAAC,yBAAiB,EAAE,6BAAqB,CAAC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+import type * as ts from 'typescript';
+export interface AiDocBlock {
+    /** Relative path from project root */
+    file: string;
+    /** @ai-agent */
+    agent: string;
+    /** @ai-agents-related — comma-separated agent names */
+    related: string[];
+    /** @ai-runtime — e.g. "CLIENT UNIQUEMENT", "SERVER UNIQUEMENT", "UNIVERSEL" */
+    runtime: string;
+    /** @ai-context — free-form description */
+    context: string;
+    /** @ai-when-modifying — ordered rules */
+    whenModifying: string[];
+    /** @ai-cascade — files affected when this one changes */
+    cascade: string[];
+    /** @ai-validate — command to run after edits */
+    validate: string;
+    /** @ai-never — hard prohibitions */
+    neverDo: string[];
+    /** @ai-pattern — embedded code snippets */
+    patterns: string[];
+}
+export interface Rule {
+    name: string;
+    description?: string;
+    match: (node: ts.Node, sourceFile: ts.SourceFile) => boolean;
+    replace: (node: ts.Node, sourceFile: ts.SourceFile) => string | null;
+}
+export interface ScanResult {
+    /** Files that already have @ai-* blocks */
+    docs: AiDocBlock[];
+    /** Relative paths of files without any @ai-* block */
+    filesWithoutDocs: string[];
+    totalScanned: number;
+}
+export interface AidocConfig {
+    /**
+     * Custom import-substring → agent-name mappings.
+     * Checked before built-in rules.
+     * @example { '@/lib/permissions': 'permissions-expert', 'stripe': 'billing-expert' }
+     */
+    agents?: Record<string, string>;
+    /**
+     * Glob-style patterns for files to ignore during scan.
+     * Supports prefix patterns (`src/generated/`), suffix patterns (`*.test.ts`)
+     * and exact relative paths.
+     * @example ['src/generated/', '*.test.ts', 'src/foo/bar.ts']
+     */
+    ignore?: string[];
+    /**
+     * Default @ai-validate command written into generated blocks.
+     * @default 'npm run typecheck'
+     */
+    validate?: string;
+}
+export interface KnowledgeBase {
+    generatedAt: string;
+    agents: Record<string, {
+        owns: string[];
+        consultedBy: string[];
+    }>;
+    cascadeGraph: Record<string, string[]>;
+    runtimeMap: Record<string, string[]>;
+    validationCommands: Record<string, string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAIrC,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAID,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,OAAO,CAAA;IAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,MAAM,GAAG,IAAI,CAAA;CACrE;AAID,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;CACrB;AAID,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAID,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACrB,IAAI,EAAE,MAAM,EAAE,CAAA;QACd,WAAW,EAAE,MAAM,EAAE,CAAA;KACtB,CAAC,CAAA;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACpC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7C"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "aidoc-kit",
+  "version": "0.1.0",
+  "description": "AI-native documentation scanner for JS/TS projects",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "aidoc-kit": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test dist/**/*.test.js 2>/dev/null || echo 'No tests yet — build passed'",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai",
+    "documentation",
+    "codemod",
+    "typescript",
+    "ast",
+    "agents",
+    "copilot",
+    "llm",
+    "jsdoc",
+    "knowledge-base"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Clemsrec/aidoc-kit.git"
+  },
+  "homepage": "https://github.com/Clemsrec/aidoc-kit#readme",
+  "bugs": {
+    "url": "https://github.com/Clemsrec/aidoc-kit/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}