autodocs-engine 0.5.0

package/dist/types.d.ts

@@ -0,0 +1,428 @@
+export interface StructuredAnalysis {
+    meta: AnalysisMeta;
+    packages: PackageAnalysis[];
+    crossPackage?: CrossPackageAnalysis;
+    warnings: Warning[];
+}
+export interface AnalysisMeta {
+    engineVersion: string;
+    analyzedAt: string;
+    rootDir: string;
+    config: PublicConfig;
+    timingMs: number;
+}
+export type PublicConfig = Omit<ResolvedConfig, "llm"> & {
+    llm: Omit<ResolvedConfig["llm"], "apiKey">;
+};
+export interface ResolvedConfig {
+    packages: string[];
+    exclude: string[];
+    rootDir?: string;
+    output: {
+        format: OutputFormat;
+        dir: string;
+    };
+    llm: {
+        provider: "anthropic" | "openai" | "local";
+        model: string;
+        apiKey?: string;
+        baseUrl?: string;
+        maxOutputTokens: number;
+    };
+    conventions: {
+        disable: string[];
+    };
+    maxPublicAPIEntries: number;
+    verbose: boolean;
+    metaToolThreshold: number;
+    noMetaTool: boolean;
+}
+export type OutputFormat = "json" | "agents.md" | "claude.md" | "cursorrules";
+export interface Warning {
+    level: "info" | "warn" | "error";
+    module: string;
+    message: string;
+    file?: string;
+}
+export interface PackageAnalysis {
+    name: string;
+    version: string;
+    description: string;
+    relativePath: string;
+    files: FileInventory;
+    publicAPI: PublicAPIEntry[];
+    conventions: Convention[];
+    commands: CommandSet;
+    architecture: PackageArchitecture;
+    dependencies: DependencySummary;
+    role: PackageRole;
+    antiPatterns: AntiPattern[];
+    contributionPatterns: ContributionPattern[];
+    configAnalysis?: ConfigAnalysis;
+    dependencyInsights?: DependencyInsights;
+    existingDocs?: ExistingDocs;
+    callGraph?: CallGraphEdge[];
+    importChain?: FileImportEdge[];
+    gitHistory?: GitHistoryAnalysis;
+    patternFingerprints?: PatternFingerprint[];
+    examples?: UsageExample[];
+    isMetaTool?: boolean;
+    metaToolInfo?: {
+        signal: "peer-dependencies" | "dep-placement" | "family-count";
+        supportedFamilies: string[];
+        coreFamilies: string[];
+    };
+}
+export interface ConfigAnalysis {
+    typescript?: {
+        strict: boolean;
+        target: string;
+        module: string;
+        moduleResolution: string;
+        paths?: Record<string, string[]>;
+        jsx?: string;
+    };
+    buildTool?: {
+        name: "turbo" | "nx" | "lerna" | "none";
+        taskNames: string[];
+        configFile: string;
+    };
+    linter?: {
+        name: "eslint" | "biome" | "none";
+        configFile: string;
+    };
+    formatter?: {
+        name: "prettier" | "biome" | "none";
+        configFile: string;
+    };
+    taskRunner?: {
+        name: "just" | "make" | "none";
+        targets: string[];
+        configFile: string;
+    };
+    envVars?: string[];
+}
+export interface DependencyInsights {
+    runtime: {
+        name: string;
+        version: string;
+    }[];
+    frameworks: {
+        name: string;
+        version: string;
+        guidance?: string;
+    }[];
+    testFramework?: {
+        name: string;
+        version: string;
+    };
+    bundler?: {
+        name: string;
+        version: string;
+    };
+}
+export interface ExistingDocs {
+    hasReadme: boolean;
+    hasAgentsMd: boolean;
+    hasClaudeMd: boolean;
+    hasCursorrules: boolean;
+    hasContributing: boolean;
+    agentsMdPath?: string;
+    claudeMdPath?: string;
+}
+export interface CallReference {
+    callerName: string;
+    calleeName: string;
+    calleeModule: string;
+    isInternal: boolean;
+}
+export interface CallGraphEdge {
+    from: string;
+    to: string;
+    fromFile: string;
+    toFile: string;
+}
+export interface FileImportEdge {
+    importer: string;
+    source: string;
+    symbolCount: number;
+    symbols: string[];
+}
+export interface CoChangeEdge {
+    file1: string;
+    file2: string;
+    coChangeCount: number;
+    file1Commits: number;
+    file2Commits: number;
+    jaccard: number;
+    lastCoChangeTimestamp: number;
+}
+export interface GitHistoryAnalysis {
+    coChangeEdges: CoChangeEdge[];
+    totalCommitsAnalyzed: number;
+    commitsFilteredBySize: number;
+    historySpanDays: number;
+}
+export interface PackageRole {
+    summary: string;
+    purpose: string;
+    whenToUse: string;
+    inferredFrom: string[];
+}
+export interface AntiPattern {
+    rule: string;
+    reason: string;
+    confidence: "high" | "medium";
+    derivedFrom: string;
+    impact?: RuleImpact;
+}
+export interface ContributionPattern {
+    type: string;
+    directory: string;
+    filePattern: string;
+    testPattern?: string;
+    exampleFile: string;
+    steps: string[];
+    commonImports?: {
+        specifier: string;
+        symbols: string[];
+        coverage: number;
+    }[];
+    exportSuffix?: string;
+    registrationFile?: string;
+}
+export interface FileInventory {
+    total: number;
+    byTier: {
+        tier1: {
+            count: number;
+            lines: number;
+            files: string[];
+        };
+        tier2: {
+            count: number;
+            lines: number;
+            files: string[];
+        };
+        tier3: {
+            count: number;
+            lines: number;
+        };
+    };
+    byExtension: Record<string, number>;
+}
+export interface PublicAPIEntry {
+    name: string;
+    kind: SymbolKind;
+    sourceFile: string;
+    signature?: string;
+    isTypeOnly: boolean;
+    description?: string;
+    importCount?: number;
+}
+export type SymbolKind = "function" | "hook" | "component" | "type" | "interface" | "class" | "enum" | "const" | "namespace" | "unknown";
+export interface ConventionConfidence {
+    matched: number;
+    total: number;
+    percentage: number;
+    description: string;
+}
+export type RuleImpact = "high" | "medium" | "low";
+export interface Convention {
+    category: ConventionCategory;
+    name: string;
+    description: string;
+    confidence: ConventionConfidence;
+    examples: string[];
+    impact?: RuleImpact;
+    source?: string;
+}
+export type ConventionCategory = "file-naming" | "hooks" | "testing" | "ecosystem";
+export interface CommandSet {
+    packageManager: "npm" | "yarn" | "pnpm" | "bun" | "unknown";
+    build?: Command;
+    test?: Command;
+    lint?: Command;
+    start?: Command;
+    other: Command[];
+}
+export interface Command {
+    run: string;
+    source: string;
+    variants?: {
+        name: string;
+        run: string;
+    }[];
+}
+export interface WorkspaceCommand {
+    run: string;
+    scriptName: string;
+    packageName: string;
+    packagePath: string;
+    category: string;
+}
+export interface WorkflowRule {
+    trigger: string;
+    action: string;
+    source: string;
+    impact: "high";
+}
+export interface DirectoryInfo {
+    path: string;
+    purpose: string;
+    fileCount: number;
+    exports: string[];
+    pattern?: string;
+}
+export interface PackageArchitecture {
+    entryPoint: string;
+    directories: DirectoryInfo[];
+    packageType: "react-components" | "hooks" | "library" | "cli" | "server" | "web-application" | "api-server" | "mixed" | "unknown";
+    hasJSX: boolean;
+}
+export interface DependencySummary {
+    internal: string[];
+    external: {
+        name: string;
+        importCount: number;
+    }[];
+    totalUniqueDependencies: number;
+}
+export interface CrossPackageAnalysis {
+    dependencyGraph: PackageDependency[];
+    sharedConventions: Convention[];
+    divergentConventions: {
+        convention: string;
+        packages: {
+            name: string;
+            value: string;
+        }[];
+    }[];
+    rootCommands?: CommandSet;
+    sharedAntiPatterns: AntiPattern[];
+    workspaceCommands?: WorkspaceCommand[];
+    workflowRules?: WorkflowRule[];
+    mermaidDiagram?: string;
+}
+export interface PackageDependency {
+    from: string;
+    to: string;
+    isDevOnly: boolean;
+}
+export interface ParsedFile {
+    relativePath: string;
+    exports: ExportEntry[];
+    imports: ImportEntry[];
+    contentSignals: ContentSignals;
+    lineCount: number;
+    isTestFile: boolean;
+    isGeneratedFile: boolean;
+    hasJSX: boolean;
+    hasCJS: boolean;
+    hasSyntaxErrors: boolean;
+    callReferences: CallReference[];
+}
+export interface ExportEntry {
+    name: string;
+    localName?: string;
+    kind: SymbolKind;
+    isReExport: boolean;
+    isTypeOnly: boolean;
+    reExportSource?: string;
+    signature?: string;
+    jsDocComment?: string;
+}
+export interface ImportEntry {
+    moduleSpecifier: string;
+    importedNames: string[];
+    isTypeOnly: boolean;
+    isDynamic: boolean;
+}
+export interface ContentSignals {
+    tryCatchCount: number;
+    useMemoCount: number;
+    useCallbackCount: number;
+    useEffectCount: number;
+    useStateCount: number;
+    useQueryCount: number;
+    useMutationCount: number;
+    jestMockCount: number;
+    hasDisplayName: boolean;
+    hasErrorBoundary: boolean;
+}
+export interface SymbolGraph {
+    barrelFile?: string;
+    barrelExports: ResolvedExport[];
+    allExports: Map<string, ExportEntry[]>;
+    importGraph: Map<string, ImportEntry[]>;
+    barrelSourceFiles: Set<string>;
+    callGraph: CallGraphEdge[];
+}
+export interface ResolvedExport extends ExportEntry {
+    definedIn: string;
+}
+export type TierInfo = {
+    tier: 1 | 2 | 3;
+    reason: string;
+};
+export interface DetectorContext {
+    dependencies?: DependencyInsights;
+    config?: ConfigAnalysis;
+    rootDevDeps?: Record<string, string>;
+}
+export type ConventionDetector = (files: ParsedFile[], tiers: Map<string, TierInfo>, warnings: Warning[], context?: DetectorContext) => Convention[];
+export declare class FileNotFoundError extends Error {
+    readonly filePath: string;
+    constructor(filePath: string, cause?: Error);
+}
+export declare class LLMError extends Error {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+export interface ValidationResult {
+    isValid: boolean;
+    issues: ValidationIssue[];
+    correctionPrompt?: string;
+}
+export interface ValidationIssue {
+    severity: "error" | "warning";
+    type: "hallucinated_technology" | "version_mismatch" | "unknown_symbol" | "budget_exceeded" | "command_mismatch" | "meaningless_title" | "unused_framework" | "under_minimum_length";
+    message: string;
+    line?: number;
+    suggestion?: string;
+}
+export interface PatternFingerprint {
+    exportName: string;
+    sourceFile: string;
+    parameterShape: string;
+    returnShape: string;
+    internalCalls: string[];
+    errorPattern: string;
+    asyncPattern: string;
+    complexity: "simple" | "moderate" | "complex";
+    summary: string;
+}
+export interface UsageExample {
+    exportName: string;
+    testFile: string;
+    snippet: string;
+    context: string;
+}
+export interface AnalysisDiff {
+    newExports: string[];
+    removedExports: string[];
+    changedConventions: string[];
+    newConventions: string[];
+    commandsChanged: boolean;
+    dependencyChanges: {
+        added: string[];
+        removed: string[];
+        majorVersionChanged: string[];
+    };
+    summary: string;
+    needsUpdate: boolean;
+}
+export declare const ENGINE_VERSION = "0.5.0";
+export declare const DEFAULT_EXCLUDE_DIRS: readonly ["node_modules", "dist", "lib", "build", "out", "coverage", "__mocks__", ".git", "generated-touchdown", "fixtures", "__fixtures__", "e2e", "examples", "playground"];
+export declare const SOURCE_EXTENSIONS: RegExp;
+export declare const DTS_EXTENSION: RegExp;

package/dist/types.js

@@ -0,0 +1,42 @@
+// src/types.ts — ALL shared types for the Codebase Intelligence Engine
+// Incorporates errata E-6 through E-13, E-39
+// ─── Errors ──────────────────────────────────────────────────────────────────
+export class FileNotFoundError extends Error {
+    filePath;
+    constructor(filePath, cause) {
+        super(`File not found: ${filePath}`);
+        this.filePath = filePath;
+        this.name = "FileNotFoundError";
+        if (cause)
+            this.cause = cause;
+    }
+}
+export class LLMError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "LLMError";
+    }
+}
+// ─── Constants ───────────────────────────────────────────────────────────────
+export const ENGINE_VERSION = "0.5.0";
+export const DEFAULT_EXCLUDE_DIRS = [
+    "node_modules",
+    "dist",
+    "lib",
+    "build",
+    "out",
+    "coverage",
+    "__mocks__",
+    ".git",
+    "generated-touchdown",
+    "fixtures",
+    "__fixtures__",
+    "e2e",
+    "examples",
+    "playground",
+];
+export const SOURCE_EXTENSIONS = /\.(ts|tsx|js|jsx)$/;
+export const DTS_EXTENSION = /\.d\.(ts|tsx)$/;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,6CAA6C;AA8b7C,gFAAgF;AAEhF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IADlB,YACkB,QAAgB,EAChC,KAAa;QAEb,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAHrB,aAAQ,GAAR,QAAQ,CAAQ;QAIhC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IAFlB,YACE,OAAe,EACC,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AA0DD,gFAAgF;AAEhF,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,MAAM;IACN,KAAK;IACL,OAAO;IACP,KAAK;IACL,UAAU;IACV,WAAW;IACX,MAAM;IACN,qBAAqB;IACrB,UAAU;IACV,cAAc;IACd,KAAK;IACL,UAAU;IACV,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC"}

package/dist/workflow-rules.d.ts

@@ -0,0 +1,18 @@
+import type { WorkflowRule, WorkspaceCommand, CommandSet, ConfigAnalysis, DependencyInsights, Convention } from "./types.js";
+interface WorkflowContext {
+    workspaceCommands: WorkspaceCommand[];
+    rootCommands?: CommandSet;
+    packageCommands: {
+        packageName: string;
+        commands: CommandSet;
+    }[];
+    configAnalysis?: ConfigAnalysis;
+    allDependencyInsights: DependencyInsights[];
+    allConventions: Convention[];
+}
+/**
+ * Generate technology-specific workflow rules by matching detected technologies
+ * to discovered commands.
+ */
+export declare function generateWorkflowRules(ctx: WorkflowContext): WorkflowRule[];
+export {};

package/dist/workflow-rules.js

@@ -0,0 +1,131 @@
+// src/workflow-rules.ts — W3-2: Technology-Aware Workflow Rule Templates
+// Composes specific workflow rules from detected technology + discovered commands.
+/**
+ * Generate technology-specific workflow rules by matching detected technologies
+ * to discovered commands.
+ */
+export function generateWorkflowRules(ctx) {
+    const rules = [];
+    // Collect all frameworks and dependencies across packages
+    const allFrameworks = new Set();
+    for (const di of ctx.allDependencyInsights) {
+        for (const fw of di.frameworks) {
+            allFrameworks.add(fw.name);
+        }
+        for (const rt of di.runtime) {
+            allFrameworks.add(rt.name);
+        }
+    }
+    // Index workspace commands by category and name
+    const cmdsByCategory = new Map();
+    for (const cmd of ctx.workspaceCommands) {
+        const list = cmdsByCategory.get(cmd.category) ?? [];
+        list.push(cmd);
+        cmdsByCategory.set(cmd.category, list);
+    }
+    const cmdByScript = new Map();
+    for (const cmd of ctx.workspaceCommands) {
+        cmdByScript.set(cmd.scriptName, cmd);
+    }
+    // --- Drizzle ORM ---
+    if (allFrameworks.has("drizzle-orm")) {
+        const dbGenerate = findCmd(ctx.workspaceCommands, /^db[:\-]generate/);
+        const dbMigrate = findCmd(ctx.workspaceCommands, /^db[:\-]migrate/);
+        if (dbGenerate && dbMigrate) {
+            rules.push({
+                trigger: "After modifying database schema files",
+                action: `Run \`${dbGenerate.run}\` to create a migration, then \`${dbMigrate.run}\` to apply it`,
+                source: `Drizzle ORM detected + ${dbGenerate.scriptName}/${dbMigrate.scriptName} in ${dbGenerate.packagePath}`,
+                impact: "high",
+            });
+        }
+        const dbPush = findCmd(ctx.workspaceCommands, /^db[:\-]push/);
+        if (dbPush) {
+            rules.push({
+                trigger: "For rapid prototyping (no migration file needed)",
+                action: `Run \`${dbPush.run}\` to push schema changes directly`,
+                source: `Drizzle ORM detected + ${dbPush.scriptName} in ${dbPush.packagePath}`,
+                impact: "high",
+            });
+        }
+    }
+    // --- Prisma ---
+    if (allFrameworks.has("prisma") || allFrameworks.has("@prisma/client")) {
+        const prismaGenerate = findCmd(ctx.workspaceCommands, /^(prisma[:\-])?generate/);
+        const prismaMigrate = findCmd(ctx.workspaceCommands, /^(prisma[:\-])?migrate/);
+        if (prismaGenerate && prismaMigrate) {
+            rules.push({
+                trigger: "After modifying schema.prisma",
+                action: `Run \`${prismaGenerate.run}\` then \`${prismaMigrate.run}\``,
+                source: `Prisma detected + ${prismaGenerate.scriptName}/${prismaMigrate.scriptName}`,
+                impact: "high",
+            });
+        }
+    }
+    // --- GraphQL codegen ---
+    if (allFrameworks.has("graphql") || allFrameworks.has("@graphql-codegen/cli")) {
+        const codegen = findCmd(ctx.workspaceCommands, /^(codegen|generate[:\-]?(interfaces|types)?)/);
+        if (codegen) {
+            rules.push({
+                trigger: "After modifying .graphql files",
+                action: `Run \`${codegen.run}\` to regenerate types`,
+                source: `GraphQL detected + ${codegen.scriptName}`,
+                impact: "high",
+            });
+        }
+    }
+    // --- Turbo monorepo ---
+    if (ctx.configAnalysis?.buildTool?.name === "turbo") {
+        const pm = ctx.rootCommands?.packageManager ?? "npm";
+        rules.push({
+            trigger: "For running build/test/lint tasks",
+            action: `Use \`turbo run <task>\`, not \`${pm} run <script>\` — Turbo caches and parallelizes`,
+            source: "Turbo detected in build tool config",
+            impact: "high",
+        });
+    }
+    // --- Biome (not ESLint/Prettier) ---
+    if (ctx.configAnalysis?.linter?.name === "biome" || ctx.configAnalysis?.formatter?.name === "biome") {
+        const lintCmd = findLintCommand(ctx);
+        const cmdHint = lintCmd ? ` (\`${lintCmd}\`)` : "";
+        rules.push({
+            trigger: "For linting and formatting",
+            action: `Use Biome${cmdHint}, NOT ESLint or Prettier — they are not configured`,
+            source: "Biome detected in config analysis",
+            impact: "high",
+        });
+    }
+    // --- Test framework ---
+    const testCmd = findTestCommand(ctx);
+    if (testCmd) {
+        rules.push({
+            trigger: "After modifying source files",
+            action: `Run \`${testCmd}\` to verify changes`,
+            source: "Test framework detected",
+            impact: "high",
+        });
+    }
+    return rules;
+}
+function findCmd(commands, pattern) {
+    return commands.find((c) => pattern.test(c.scriptName));
+}
+function findLintCommand(ctx) {
+    if (ctx.rootCommands?.lint)
+        return ctx.rootCommands.lint.run;
+    for (const pc of ctx.packageCommands) {
+        if (pc.commands.lint)
+            return pc.commands.lint.run;
+    }
+    return undefined;
+}
+function findTestCommand(ctx) {
+    if (ctx.rootCommands?.test)
+        return ctx.rootCommands.test.run;
+    for (const pc of ctx.packageCommands) {
+        if (pc.commands.test)
+            return pc.commands.test.run;
+    }
+    return undefined;
+}
+//# sourceMappingURL=workflow-rules.js.map

package/dist/workflow-rules.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "autodocs-engine",
+  "version": "0.5.0",
+  "description": "Codebase intelligence engine for generating AI context files",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "autodocs-engine": "dist/bin/autodocs-engine.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/msiric/autodocs-engine"
+  },
+  "keywords": [
+    "agents-md",
+    "claude-md",
+    "cursorrules",
+    "ai-context",
+    "codebase-intelligence",
+    "typescript",
+    "ast",
+    "conventions"
+  ],
+  "homepage": "https://github.com/msiric/autodocs-engine#readme",
+  "bugs": {
+    "url": "https://github.com/msiric/autodocs-engine/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "mri": "^1.2.0",
+    "picomatch": "^4.0.0",
+    "typescript": "^5.4.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/picomatch": "^3.0.0",
+    "tsx": "^4.21.0",
+    "vitest": "^2.0.0"
+  }
+}