autodocs-engine 0.5.0

package/dist/bin/init.js

@@ -0,0 +1,268 @@
+// src/bin/init.ts — Zero-config init command
+// Auto-detects project structure and generates AGENTS.md on first try.
+import { resolve, join, relative, dirname } from "node:path";
+import { existsSync, readFileSync, readdirSync, writeFileSync, mkdirSync } from "node:fs";
+import { analyze, formatDeterministic, formatHierarchicalDeterministic } from "../index.js";
+// ─── Main ────────────────────────────────────────────────────────────────────
+export async function runInit() {
+    const cwd = process.cwd();
+    // Step 1: Detect project structure
+    const project = detectProjectStructure(cwd);
+    stderr("");
+    stderr(`  Detected: ${project.isMonorepo ? `monorepo (${project.workspaceSource})` : "single package"}`);
+    if (project.isMonorepo) {
+        const relPkgs = project.packages.map((p) => relative(cwd, p));
+        stderr(`  Packages: ${relPkgs.join(", ")} (${project.packages.length} found)`);
+    }
+    stderr(`  Package manager: ${project.packageManager}`);
+    // Step 2: Check API key
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    const format = apiKey ? "agents.md" : "json";
+    stderr(`  API key: ${apiKey ? "set" : "not set (will generate JSON only)"}`);
+    stderr("");
+    // Step 3: Analyze
+    stderr(`  Analyzing ${project.packages.length} package(s)...`);
+    const analysisStart = performance.now();
+    const analysis = await analyze({
+        packages: project.packages,
+        rootDir: project.root,
+        output: { format, dir: "." },
+        llm: {
+            provider: "anthropic",
+            model: process.env.AUTODOCS_LLM_MODEL ?? "claude-sonnet-4-20250514",
+            maxOutputTokens: 4096,
+            apiKey,
+        },
+    });
+    const analysisMs = Math.round(performance.now() - analysisStart);
+    stderr(`  Analysis complete (${(analysisMs / 1000).toFixed(1)}s)`);
+    // Step 4: Generate and write output
+    if (!apiKey) {
+        const outPath = resolve(cwd, "autodocs-analysis.json");
+        writeFileSafe(outPath, JSON.stringify(analysis, mapReplacer, 2));
+        stderr(`\n  Written: ${relative(cwd, outPath)}`);
+        stderr(`\n  To generate AGENTS.md, set ANTHROPIC_API_KEY and run again.`);
+        return;
+    }
+    const llmConfig = {
+        output: { format: "agents.md", dir: "." },
+        llm: {
+            provider: "anthropic",
+            model: process.env.AUTODOCS_LLM_MODEL ?? "claude-sonnet-4-20250514",
+            maxOutputTokens: 4096,
+            apiKey,
+        },
+    };
+    if (project.isMonorepo && project.packages.length > 1) {
+        stderr(`  Generating AGENTS.md (hierarchical)...`);
+        const genStart = performance.now();
+        const result = await formatHierarchicalDeterministic(analysis, llmConfig);
+        stderr(`  Generation complete (${((performance.now() - genStart) / 1000).toFixed(1)}s)`);
+        const rootPath = resolve(cwd, "AGENTS.md");
+        writeFileSafe(rootPath, result.root);
+        stderr(`\n  Written:`);
+        stderr(`    ./AGENTS.md (root, ${result.root.split("\n").length} lines)`);
+        const pkgsDir = resolve(cwd, "packages");
+        for (const pkg of result.packages) {
+            const pkgPath = join(pkgsDir, pkg.filename);
+            writeFileSafe(pkgPath, pkg.content);
+            stderr(`    ./packages/${pkg.filename} (${pkg.content.split("\n").length} lines)`);
+        }
+    }
+    else {
+        stderr(`  Generating AGENTS.md...`);
+        const genStart = performance.now();
+        const content = await formatDeterministic(analysis, llmConfig, project.root);
+        stderr(`  Generation complete (${((performance.now() - genStart) / 1000).toFixed(1)}s)`);
+        const outPath = resolve(cwd, "AGENTS.md");
+        writeFileSafe(outPath, content);
+        stderr(`\n  Written: ./AGENTS.md (${content.split("\n").length} lines)`);
+    }
+}
+// ─── Project Detection ───────────────────────────────────────────────────────
+/** Exported for testing. */
+export function detectProjectStructure(cwd) {
+    const absCwd = resolve(cwd);
+    // Must have package.json
+    const pkgJsonPath = join(absCwd, "package.json");
+    if (!existsSync(pkgJsonPath)) {
+        throw new Error("No package.json found in current directory.\n" +
+            "Run this command from your project root (where package.json is).");
+    }
+    let pkgJson;
+    try {
+        pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+    }
+    catch {
+        throw new Error("Failed to parse package.json.");
+    }
+    // Detect package manager from lockfiles
+    const packageManager = detectPM(absCwd);
+    // Check for monorepo signals
+    // Signal 1: package.json workspaces field
+    if (Array.isArray(pkgJson.workspaces)) {
+        const packages = discoverWorkspacePackages(absCwd, pkgJson.workspaces);
+        if (packages.length > 0) {
+            return { isMonorepo: true, workspaceSource: "npm/yarn workspaces", root: absCwd, packages, packageManager };
+        }
+    }
+    // Signal 1b: yarn workspaces as object { packages: [...] }
+    if (pkgJson.workspaces && typeof pkgJson.workspaces === "object" && !Array.isArray(pkgJson.workspaces)) {
+        const ws = pkgJson.workspaces;
+        if (Array.isArray(ws.packages)) {
+            const packages = discoverWorkspacePackages(absCwd, ws.packages);
+            if (packages.length > 0) {
+                return { isMonorepo: true, workspaceSource: "yarn workspaces", root: absCwd, packages, packageManager };
+            }
+        }
+    }
+    // Signal 2: pnpm-workspace.yaml
+    const pnpmWsPath = join(absCwd, "pnpm-workspace.yaml");
+    if (existsSync(pnpmWsPath)) {
+        const globs = parsePnpmWorkspaceYaml(pnpmWsPath);
+        if (globs.length > 0) {
+            const packages = discoverWorkspacePackages(absCwd, globs);
+            if (packages.length > 0) {
+                return { isMonorepo: true, workspaceSource: "pnpm workspaces", root: absCwd, packages, packageManager };
+            }
+        }
+    }
+    // Single package
+    return { isMonorepo: false, root: absCwd, packages: [absCwd], packageManager };
+}
+// ─── Workspace Discovery ─────────────────────────────────────────────────────
+/**
+ * Discover workspace package directories from glob patterns.
+ * Handles common patterns: "packages/*", "apps/*", "libs/**".
+ */
+function discoverWorkspacePackages(root, globs) {
+    const packages = [];
+    const seen = new Set();
+    for (const glob of globs) {
+        // Strip trailing / if present
+        const cleanGlob = glob.replace(/\/+$/, "");
+        // Common patterns: "packages/*", "apps/*", "libs/**"
+        // Split into base directory and wildcard
+        const starIdx = cleanGlob.indexOf("*");
+        if (starIdx === -1) {
+            // No wildcard — treat as literal directory
+            const dir = resolve(root, cleanGlob);
+            if (existsSync(join(dir, "package.json")) && !seen.has(dir)) {
+                seen.add(dir);
+                packages.push(dir);
+            }
+            continue;
+        }
+        const baseDir = resolve(root, cleanGlob.slice(0, starIdx).replace(/\/+$/, ""));
+        if (!existsSync(baseDir))
+            continue;
+        const isRecursive = cleanGlob.includes("**");
+        if (isRecursive) {
+            walkForPackages(baseDir, packages, seen);
+        }
+        else {
+            // Single-level wildcard: list immediate subdirectories
+            try {
+                const entries = readdirSync(baseDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory())
+                        continue;
+                    if (entry.name === "node_modules" || entry.name.startsWith("."))
+                        continue;
+                    const dir = join(baseDir, entry.name);
+                    if (existsSync(join(dir, "package.json")) && !seen.has(dir)) {
+                        seen.add(dir);
+                        packages.push(dir);
+                    }
+                }
+            }
+            catch {
+                // Can't read directory
+            }
+        }
+    }
+    return packages.sort();
+}
+/** Recursively find directories containing package.json. */
+function walkForPackages(dir, results, seen, depth = 0) {
+    if (depth > 4)
+        return;
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            const subdir = join(dir, entry.name);
+            if (existsSync(join(subdir, "package.json")) && !seen.has(subdir)) {
+                seen.add(subdir);
+                results.push(subdir);
+            }
+            walkForPackages(subdir, results, seen, depth + 1);
+        }
+    }
+    catch {
+        // Can't read directory
+    }
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Simple YAML parser for pnpm-workspace.yaml — only reads the `packages:` field. */
+function parsePnpmWorkspaceYaml(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const globs = [];
+        let inPackages = false;
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed === "packages:" || trimmed === "packages: ") {
+                inPackages = true;
+                continue;
+            }
+            if (inPackages) {
+                if (trimmed.startsWith("- ")) {
+                    // Strip "- " prefix and optional quotes
+                    const value = trimmed.slice(2).trim().replace(/^['"]|['"]$/g, "");
+                    if (value && !value.startsWith("!")) {
+                        globs.push(value);
+                    }
+                }
+                else if (trimmed && !trimmed.startsWith("#")) {
+                    // Non-list line — end of packages section
+                    break;
+                }
+            }
+        }
+        return globs;
+    }
+    catch {
+        return [];
+    }
+}
+/** Detect package manager from lockfiles. */
+function detectPM(dir) {
+    if (existsSync(join(dir, "bun.lockb")) || existsSync(join(dir, "bun.lock")))
+        return "bun";
+    if (existsSync(join(dir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(dir, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(dir, "package-lock.json")))
+        return "npm";
+    return "npm";
+}
+function stderr(msg) {
+    process.stderr.write(msg + "\n");
+}
+function writeFileSafe(filePath, content) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, content);
+}
+function mapReplacer(_key, value) {
+    if (value instanceof Map)
+        return Object.fromEntries(value);
+    if (value instanceof Set)
+        return [...value];
+    return value;
+}
+//# sourceMappingURL=init.js.map

package/dist/bin/init.js.map

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

package/dist/bin/serve.d.ts

@@ -0,0 +1,4 @@
+export declare function runServe(args: {
+    path?: string;
+    verbose?: boolean;
+}): Promise<void>;

package/dist/bin/serve.js

@@ -0,0 +1,29 @@
+// src/bin/serve.ts — CLI entry point for MCP server
+// Usage: autodocs-engine serve [path] [--verbose]
+import { resolve } from "node:path";
+export async function runServe(args) {
+    const projectPath = resolve(args.path ?? ".");
+    // Lazy-load MCP dependencies — users who don't use serve don't pay the cost
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const { createAutodocsServer } = await import("../mcp/server.js");
+    const verbose = args.verbose ?? Boolean(process.env.AUTODOCS_DEBUG);
+    const { server, cache } = createAutodocsServer(projectPath, { verbose });
+    const transport = new StdioServerTransport();
+    // Connect first — handshake must complete before heavy analysis work
+    await server.connect(transport);
+    process.stderr.write(`[autodocs] MCP server ready (project: ${projectPath})\n`);
+    // Defer warmup to next tick — ensures the MCP handshake response is fully
+    // flushed before synchronous AST parsing blocks the event loop.
+    // Without this, large repos block the transport and Claude Code times out.
+    setTimeout(() => cache.warm(), 100);
+    // Signal handlers for clean shutdown
+    process.on("SIGTERM", () => {
+        process.stderr.write("[autodocs] Shutting down\n");
+        process.exit(0);
+    });
+    process.on("SIGINT", () => {
+        process.stderr.write("[autodocs] Interrupted\n");
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/bin/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/bin/serve.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,kDAAkD;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAA0C;IACvE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAE9C,4EAA4E;IAC5E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3F,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACpE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,qEAAqE;IACrE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,WAAW,KAAK,CAAC,CAAC;IAEhF,0EAA0E;IAC1E,gEAAgE;IAChE,2EAA2E;IAC3E,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAEpC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/budget-validator.d.ts

@@ -0,0 +1,22 @@
+export interface BudgetReport {
+    lineCount: number;
+    ruleCount: number;
+    budgetPercentage: number;
+    styleRules: StyleRuleWarning[];
+    overBudget: boolean;
+    summary: string;
+}
+export interface StyleRuleWarning {
+    line: number;
+    text: string;
+    suggestion: string;
+}
+/**
+ * Validate the instruction budget of generated content.
+ * Returns a report with rule count, budget usage, and style rule warnings.
+ */
+export declare function validateBudget(content: string): BudgetReport;
+/**
+ * Format budget report for verbose console output.
+ */
+export declare function formatBudgetReport(report: BudgetReport): string;

package/dist/budget-validator.js

@@ -0,0 +1,119 @@
+// src/budget-validator.ts — Instruction Budget Validator
+// After generation, counts rules and warns if the output exceeds the AI instruction budget.
+// Research: AI tools follow ~150-200 instructions max. Claude system prompt uses ~50.
+// Budget for AGENTS.md: ~100 actionable rules.
+// W5-B2: Increased from 100 — modern LLMs handle 150+ instructions reliably
+const MAX_RULES = 120;
+// Patterns that indicate an actionable rule/instruction line
+const RULE_PATTERNS = [
+    /^[-*]\s+\*?\*?(?:Do|Use|After|When|Always|Never|Run|Create|Add|Set|Include|Ensure|Check|Avoid)/i,
+    /^[-*]\s+`[a-z]/i, // Bullet with a command
+    /^\|\s*[^|]+\s*\|/, // Table row (non-header)
+    /^#{1,4}\s+(?:DO|DO NOT|Rules)/i, // Section headers that are directive
+];
+// Patterns that indicate a style rule (should be handled by linter)
+const STYLE_PATTERNS = [
+    { pattern: /kebab[- ]?case/i, suggestion: "Enforce via ESLint naming convention rule" },
+    { pattern: /camel[- ]?case/i, suggestion: "Enforce via ESLint naming convention rule" },
+    { pattern: /pascal[- ]?case/i, suggestion: "Enforce via ESLint naming convention rule" },
+    { pattern: /named exports?/i, suggestion: "Enforce via eslint-plugin-import no-default-export rule" },
+    { pattern: /default exports?/i, suggestion: "Enforce via eslint-plugin-import no-default-export rule" },
+    { pattern: /barrel exports?/i, suggestion: "Enforce via eslint-plugin-import no-internal-modules rule" },
+    { pattern: /semicolons?\b/i, suggestion: "Enforce via Prettier or ESLint semi rule" },
+    { pattern: /trailing comma/i, suggestion: "Enforce via Prettier trailingComma option" },
+    { pattern: /single quotes?/i, suggestion: "Enforce via Prettier singleQuote option" },
+    { pattern: /double quotes?/i, suggestion: "Enforce via Prettier singleQuote option" },
+    { pattern: /import order/i, suggestion: "Enforce via eslint-plugin-import order rule" },
+    { pattern: /import style/i, suggestion: "Enforce via eslint-plugin-import rules" },
+    { pattern: /sort.?imports/i, suggestion: "Enforce via eslint-plugin-import order rule" },
+    { pattern: /file.?naming/i, suggestion: "Enforce via eslint-plugin-unicorn filename-case rule" },
+    { pattern: /indentation|indent with/i, suggestion: "Enforce via Prettier or ESLint indent rule" },
+    { pattern: /line length|max.?len/i, suggestion: "Enforce via Prettier printWidth option" },
+];
+/**
+ * Validate the instruction budget of generated content.
+ * Returns a report with rule count, budget usage, and style rule warnings.
+ */
+export function validateBudget(content) {
+    const lines = content.split("\n");
+    const lineCount = lines.length;
+    let ruleCount = 0;
+    const styleRules = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        // Count actionable rules
+        if (isActionableLine(line)) {
+            ruleCount++;
+        }
+        // Detect style rules
+        for (const { pattern, suggestion } of STYLE_PATTERNS) {
+            if (pattern.test(line)) {
+                styleRules.push({
+                    line: i + 1,
+                    text: line.slice(0, 120),
+                    suggestion,
+                });
+                break; // One warning per line
+            }
+        }
+    }
+    const budgetPercentage = Math.round((ruleCount / MAX_RULES) * 100);
+    const overBudget = ruleCount > MAX_RULES;
+    const parts = [
+        `${lineCount} lines, ${ruleCount} actionable rules (${budgetPercentage}% of ${MAX_RULES} budget)`,
+    ];
+    if (overBudget) {
+        parts.push(`WARNING: Exceeds instruction budget by ${ruleCount - MAX_RULES} rules. AI performance may degrade.`);
+    }
+    if (styleRules.length > 0) {
+        parts.push(`${styleRules.length} style rule(s) detected — consider moving to linter config.`);
+    }
+    return {
+        lineCount,
+        ruleCount,
+        budgetPercentage,
+        styleRules,
+        overBudget,
+        summary: parts.join(" | "),
+    };
+}
+/**
+ * Check if a line represents an actionable instruction for AI.
+ */
+function isActionableLine(line) {
+    // Skip markdown headers, blank lines, horizontal rules, and pure-header table rows
+    if (line.startsWith("#") && !/^#{1,4}\s+(?:DO|DO NOT)/i.test(line))
+        return false;
+    if (line.startsWith("---") || line.startsWith("==="))
+        return false;
+    if (/^\|[\s:-]+(\|[\s:-]+)*\|$/.test(line))
+        return false; // Table separator row (multi-column)
+    if (line.startsWith("_") && line.endsWith("_"))
+        return false; // Italicized placeholder text
+    if (line.startsWith(">"))
+        return false; // Blockquotes (explanatory)
+    return RULE_PATTERNS.some((p) => p.test(line));
+}
+/**
+ * Format budget report for verbose console output.
+ */
+export function formatBudgetReport(report) {
+    const lines = [];
+    lines.push(`[BUDGET] ${report.summary}`);
+    if (report.overBudget) {
+        lines.push(`[BUDGET] ⚠ Over budget: ${report.ruleCount} rules exceeds max ${MAX_RULES}`);
+    }
+    if (report.styleRules.length > 0) {
+        lines.push(`[BUDGET] Style rules that should be in linter config:`);
+        for (const sr of report.styleRules.slice(0, 5)) {
+            lines.push(`[BUDGET]   Line ${sr.line}: "${sr.text}" → ${sr.suggestion}`);
+        }
+        if (report.styleRules.length > 5) {
+            lines.push(`[BUDGET]   ... and ${report.styleRules.length - 5} more`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=budget-validator.js.map

package/dist/budget-validator.js.map

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

package/dist/command-extractor.d.ts

@@ -0,0 +1,10 @@
+import type { CommandSet, Warning, WorkspaceCommand } from "./types.js";
+/**
+ * Extract build/test/lint/start commands from package.json scripts.
+ */
+export declare function extractCommands(packageDir: string, rootDir?: string, warnings?: Warning[]): CommandSet;
+/**
+ * W3-1: Scan ALL package.json files in the workspace for operational commands.
+ * Finds commands matching operational patterns (db:*, sync:*, worker*, deploy*, generate*).
+ */
+export declare function scanWorkspaceCommands(rootDir: string, warnings?: Warning[], analyzedPackageNames?: Set<string>): WorkspaceCommand[];