autodocs-engine 0.5.0

package/dist/command-extractor.js

@@ -0,0 +1,276 @@
+// src/command-extractor.ts — Module 6: Command Extractor
+// Errata applied: E-29 (auto-detect monorepo root)
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { resolve, join, dirname, relative } from "node:path";
+const CATEGORY_PATTERNS = {
+    build: ["build", "compile", "transpile"],
+    test: ["test:unit", "test", "jest", "vitest"],
+    lint: ["lint", "eslint"],
+    start: ["start", "dev", "serve"],
+};
+const OTHER_PATTERNS = {
+    typecheck: ["typecheck", "type-check", "tsc"],
+    format: ["format", "prettier"],
+};
+/**
+ * Extract build/test/lint/start commands from package.json scripts.
+ */
+export function extractCommands(packageDir, rootDir, warnings = []) {
+    const absPackageDir = resolve(packageDir);
+    // E-29: Auto-detect monorepo root if not provided
+    const resolvedRoot = rootDir ? resolve(rootDir) : autoDetectRoot(absPackageDir);
+    const pm = detectPackageManager(resolvedRoot ?? absPackageDir);
+    const pkgScripts = readScripts(absPackageDir);
+    const rootScripts = resolvedRoot && resolvedRoot !== absPackageDir
+        ? readScripts(resolvedRoot)
+        : {};
+    const commands = {
+        packageManager: pm,
+        other: [],
+    };
+    // Map primary categories
+    for (const [category, patterns] of Object.entries(CATEGORY_PATTERNS)) {
+        const cmd = resolveCommand(category, patterns, pkgScripts, rootScripts, pm, absPackageDir);
+        if (cmd) {
+            if (category === "build")
+                commands.build = cmd;
+            else if (category === "test")
+                commands.test = cmd;
+            else if (category === "lint")
+                commands.lint = cmd;
+            else if (category === "start")
+                commands.start = cmd;
+        }
+    }
+    // Map "other" categories
+    for (const [category, patterns] of Object.entries(OTHER_PATTERNS)) {
+        const cmd = resolveCommand(category, patterns, pkgScripts, rootScripts, pm, absPackageDir);
+        if (cmd) {
+            commands.other.push(cmd);
+        }
+    }
+    return commands;
+}
+function resolveCommand(category, patterns, pkgScripts, rootScripts, pm, packageDir) {
+    const pkgMatch = findScript(pkgScripts, patterns);
+    const rootMatch = findScript(rootScripts, patterns);
+    if (rootMatch && pkgMatch && pkgScripts[pkgMatch]?.includes("../")) {
+        // Package delegates to root → root is primary
+        const cmd = {
+            run: formatRun(pm, rootMatch),
+            source: `root package.json scripts.${rootMatch}`,
+        };
+        cmd.variants = [{ name: "package-level", run: formatRun(pm, pkgMatch) }];
+        addVariants(cmd, rootMatch, rootScripts, pm);
+        return cmd;
+    }
+    else if (pkgMatch) {
+        const cmd = {
+            run: formatRun(pm, pkgMatch),
+            source: `package.json scripts.${pkgMatch}`,
+        };
+        addVariants(cmd, pkgMatch, pkgScripts, pm);
+        return cmd;
+    }
+    else if (rootMatch) {
+        const cmd = {
+            run: formatRun(pm, rootMatch),
+            source: `root package.json scripts.${rootMatch}`,
+        };
+        addVariants(cmd, rootMatch, rootScripts, pm);
+        return cmd;
+    }
+    return undefined;
+}
+function detectPackageManager(dir) {
+    if (existsSync(join(dir, "bun.lockb")))
+        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";
+    // Check packageManager field
+    try {
+        const pkgJson = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+        if (typeof pkgJson.packageManager === "string") {
+            if (pkgJson.packageManager.startsWith("yarn"))
+                return "yarn";
+            if (pkgJson.packageManager.startsWith("pnpm"))
+                return "pnpm";
+            if (pkgJson.packageManager.startsWith("bun"))
+                return "bun";
+        }
+    }
+    catch {
+        // No package.json
+    }
+    return "npm";
+}
+function readScripts(dir) {
+    try {
+        const pkgJson = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+        return pkgJson.scripts ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function findScript(scripts, patterns) {
+    for (const pattern of patterns) {
+        if (pattern in scripts)
+            return pattern;
+    }
+    return undefined;
+}
+function formatRun(pm, script) {
+    switch (pm) {
+        case "yarn":
+            return `yarn ${script}`;
+        case "pnpm":
+            return `pnpm ${script}`;
+        case "bun":
+            return `bun run ${script}`;
+        case "npm":
+        default:
+            return `npm run ${script}`;
+    }
+}
+function addVariants(cmd, primary, scripts, pm) {
+    const prefix = primary + ":";
+    const variants = cmd.variants ?? [];
+    for (const key of Object.keys(scripts)) {
+        if (key.startsWith(prefix) && key !== primary) {
+            const suffix = key.slice(prefix.length);
+            variants.push({ name: suffix, run: formatRun(pm, key) });
+        }
+    }
+    if (variants.length > 0)
+        cmd.variants = variants;
+}
+/**
+ * E-29: Walk up from packageDir looking for monorepo root.
+ */
+function autoDetectRoot(packageDir) {
+    let dir = dirname(packageDir);
+    const root = resolve("/");
+    while (dir !== root) {
+        try {
+            const pkgJsonPath = join(dir, "package.json");
+            if (existsSync(pkgJsonPath)) {
+                const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+                if (pkgJson.workspaces)
+                    return dir;
+            }
+            if (existsSync(join(dir, "pnpm-workspace.yaml")))
+                return dir;
+        }
+        catch {
+            // Skip
+        }
+        dir = dirname(dir);
+    }
+    return undefined;
+}
+// ─── W3-1: Workspace-wide command scanning ──────────────────────────────────
+const OPERATIONAL_PATTERNS = [
+    // Database
+    /^db[:\-]/, /^migrate/, /^seed/,
+    // Workers/queues
+    /^dev[:\-](worker|listener|queue)/, /^sync[:\-]/, /^worker/,
+    // Deployment
+    /^deploy/, /^release/,
+    // Code generation
+    /^generate/, /^codegen/,
+    // Email
+    /^email/,
+];
+/**
+ * W3-1: Scan ALL package.json files in the workspace for operational commands.
+ * Finds commands matching operational patterns (db:*, sync:*, worker*, deploy*, generate*).
+ */
+export function scanWorkspaceCommands(rootDir, warnings = [], analyzedPackageNames) {
+    const absRoot = resolve(rootDir);
+    const pm = detectPackageManager(absRoot);
+    const commands = [];
+    const seen = new Set();
+    const packageJsonPaths = findAllPackageJsons(absRoot);
+    for (const pkgJsonPath of packageJsonPaths) {
+        try {
+            const content = readFileSync(pkgJsonPath, "utf-8");
+            const pkgJson = JSON.parse(content);
+            const scripts = pkgJson.scripts ?? {};
+            const pkgName = pkgJson.name ?? relative(absRoot, dirname(pkgJsonPath));
+            const pkgRelPath = relative(absRoot, dirname(pkgJsonPath)) || ".";
+            for (const [scriptName, scriptValue] of Object.entries(scripts)) {
+                if (typeof scriptValue !== "string")
+                    continue;
+                if (!OPERATIONAL_PATTERNS.some((p) => p.test(scriptName)))
+                    continue;
+                // Deduplicate by script name + command value
+                const dedupeKey = `${scriptName}:${scriptValue}`;
+                if (seen.has(dedupeKey))
+                    continue;
+                seen.add(dedupeKey);
+                const category = categorizeScript(scriptName);
+                commands.push({
+                    run: formatRun(pm, scriptName),
+                    scriptName,
+                    packageName: pkgName,
+                    packagePath: pkgRelPath,
+                    category,
+                });
+            }
+        }
+        catch {
+            // Skip malformed package.json
+        }
+    }
+    return commands;
+}
+function categorizeScript(name) {
+    if (/^db[:\-]|^migrate|^seed/.test(name))
+        return "database";
+    if (/^dev[:\-](worker|listener|queue)|^sync[:\-]|^worker/.test(name))
+        return "workers";
+    if (/^deploy|^release/.test(name))
+        return "deployment";
+    if (/^generate|^codegen/.test(name))
+        return "codegen";
+    if (/^email/.test(name))
+        return "email";
+    return "operational";
+}
+/**
+ * Find all package.json files in a workspace, excluding node_modules and dist.
+ */
+function findAllPackageJsons(rootDir) {
+    const results = [];
+    function walk(dir, depth) {
+        if (depth > 6)
+            return; // Prevent deep recursion
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name === "node_modules" || entry.name === "dist" ||
+                    entry.name === ".git" || entry.name === "build" ||
+                    entry.name === "out" || entry.name === "coverage")
+                    continue;
+                const fullPath = join(dir, entry.name);
+                if (entry.isFile() && entry.name === "package.json") {
+                    results.push(fullPath);
+                }
+                else if (entry.isDirectory()) {
+                    walk(fullPath, depth + 1);
+                }
+            }
+        }
+        catch {
+            // Skip unreadable dirs
+        }
+    }
+    walk(rootDir, 0);
+    return results;
+}
+//# sourceMappingURL=command-extractor.js.map

package/dist/command-extractor.js.map

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

package/dist/config-analyzer.d.ts

@@ -0,0 +1,5 @@
+import type { ConfigAnalysis, Warning } from "./types.js";
+/**
+ * Analyze config files in a package directory (and optionally its monorepo root).
+ */
+export declare function analyzeConfig(packageDir: string, rootDir?: string, warnings?: Warning[]): ConfigAnalysis;

package/dist/config-analyzer.js

@@ -0,0 +1,364 @@
+// src/config-analyzer.ts — Improvement 1: Config File Analysis
+// Parses turbo.json, biome.json, tsconfig.json, eslint config, prettier config,
+// justfile, Makefile, nx.json, .env.example to extract actionable settings.
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Analyze config files in a package directory (and optionally its monorepo root).
+ */
+export function analyzeConfig(packageDir, rootDir, warnings = []) {
+    const result = {};
+    // TypeScript config (package-level first, then root)
+    result.typescript = parseTypeScriptConfig(packageDir, rootDir, warnings);
+    // Build tool (root-level: turbo.json, nx.json)
+    result.buildTool = detectBuildTool(packageDir, rootDir, warnings);
+    // Linter
+    result.linter = detectLinter(packageDir, rootDir, warnings);
+    // Formatter
+    result.formatter = detectFormatter(packageDir, rootDir, warnings);
+    // Task runner (justfile, Makefile)
+    result.taskRunner = detectTaskRunner(packageDir, rootDir, warnings);
+    // Environment variables
+    result.envVars = detectEnvVars(packageDir, rootDir);
+    return result;
+}
+// ─── TypeScript Config ──────────────────────────────────────────────────────
+function parseTypeScriptConfig(packageDir, rootDir, warnings = []) {
+    // Try package-level first, then root
+    const candidates = [
+        join(packageDir, "tsconfig.json"),
+        ...(rootDir ? [join(rootDir, "tsconfig.json")] : []),
+    ];
+    for (const configPath of candidates) {
+        if (!existsSync(configPath))
+            continue;
+        try {
+            const raw = readFileSync(configPath, "utf-8");
+            // Strip single-line and multi-line comments for JSONC support
+            const cleaned = stripJsonComments(raw);
+            const config = JSON.parse(cleaned);
+            const co = config.compilerOptions ?? {};
+            return {
+                strict: co.strict ?? false,
+                target: co.target ?? "unknown",
+                module: co.module ?? "unknown",
+                moduleResolution: co.moduleResolution ?? "unknown",
+                paths: co.paths ?? undefined,
+                jsx: co.jsx ?? undefined,
+            };
+        }
+        catch {
+            warnings.push({
+                level: "warn",
+                module: "config-analyzer",
+                message: `Failed to parse ${configPath}`,
+            });
+        }
+    }
+    return undefined;
+}
+// ─── Build Tool ─────────────────────────────────────────────────────────────
+function detectBuildTool(packageDir, rootDir, warnings = []) {
+    // Check turbo.json (root or package)
+    const turboLocations = [
+        ...(rootDir ? [join(rootDir, "turbo.json")] : []),
+        join(packageDir, "turbo.json"),
+    ];
+    for (const turboPath of turboLocations) {
+        if (!existsSync(turboPath))
+            continue;
+        try {
+            const raw = readFileSync(turboPath, "utf-8");
+            const cleaned = stripJsonComments(raw);
+            const config = JSON.parse(cleaned);
+            // Turbo v2: tasks is top-level object with task names as keys
+            // Turbo v1: pipeline is top-level object with task names as keys
+            const tasksObj = config.tasks ?? config.pipeline ?? {};
+            const taskNames = Object.keys(tasksObj).map((t) => t.replace(/^\/\/.*/, "").trim()).filter(Boolean);
+            return {
+                name: "turbo",
+                taskNames,
+                configFile: turboPath.startsWith(rootDir ?? "") ? "turbo.json" : turboPath,
+            };
+        }
+        catch {
+            warnings.push({
+                level: "warn",
+                module: "config-analyzer",
+                message: `Failed to parse turbo.json at ${turboPath}`,
+            });
+        }
+    }
+    // Check nx.json
+    const nxLocations = [
+        ...(rootDir ? [join(rootDir, "nx.json")] : []),
+        join(packageDir, "nx.json"),
+    ];
+    for (const nxPath of nxLocations) {
+        if (!existsSync(nxPath))
+            continue;
+        try {
+            const raw = readFileSync(nxPath, "utf-8");
+            const config = JSON.parse(raw);
+            const taskNames = [];
+            // Nx: targetDefaults has task names as keys
+            if (config.targetDefaults) {
+                taskNames.push(...Object.keys(config.targetDefaults));
+            }
+            // Nx: tasksRunnerOptions may define tasks
+            if (config.tasksRunnerOptions) {
+                // The runner itself doesn't list tasks, but its presence confirms Nx
+            }
+            return {
+                name: "nx",
+                taskNames,
+                configFile: "nx.json",
+            };
+        }
+        catch {
+            warnings.push({
+                level: "warn",
+                module: "config-analyzer",
+                message: `Failed to parse nx.json at ${nxPath}`,
+            });
+        }
+    }
+    // Check for lerna.json
+    const lernaLocations = [
+        ...(rootDir ? [join(rootDir, "lerna.json")] : []),
+        join(packageDir, "lerna.json"),
+    ];
+    for (const lernaPath of lernaLocations) {
+        if (existsSync(lernaPath)) {
+            return {
+                name: "lerna",
+                taskNames: [],
+                configFile: "lerna.json",
+            };
+        }
+    }
+    return undefined;
+}
+// ─── Linter ─────────────────────────────────────────────────────────────────
+function detectLinterIn(dir) {
+    // Biome
+    for (const name of ["biome.json", "biome.jsonc"]) {
+        if (existsSync(join(dir, name))) {
+            return { name: "biome", configFile: name };
+        }
+    }
+    // ESLint
+    const eslintFiles = [
+        "eslint.config.js", "eslint.config.mjs", "eslint.config.cjs", "eslint.config.ts",
+        ".eslintrc.json", ".eslintrc.js", ".eslintrc.cjs", ".eslintrc.yaml", ".eslintrc.yml", ".eslintrc",
+    ];
+    for (const name of eslintFiles) {
+        if (existsSync(join(dir, name))) {
+            return { name: "eslint", configFile: name };
+        }
+    }
+    return undefined;
+}
+function detectLinter(packageDir, rootDir, _warnings = []) {
+    // Check package dir FIRST — package-level config takes priority
+    const pkgResult = detectLinterIn(packageDir);
+    if (pkgResult)
+        return pkgResult;
+    // Fall back to root
+    if (rootDir) {
+        return detectLinterIn(rootDir);
+    }
+    return undefined;
+}
+// ─── Formatter ──────────────────────────────────────────────────────────────
+function detectFormatterIn(dir) {
+    // Biome
+    for (const name of ["biome.json", "biome.jsonc"]) {
+        if (existsSync(join(dir, name))) {
+            try {
+                const raw = readFileSync(join(dir, name), "utf-8");
+                const cleaned = stripJsonComments(raw);
+                const config = JSON.parse(cleaned);
+                if (config.formatter?.enabled !== false) {
+                    return { name: "biome", configFile: name };
+                }
+            }
+            catch {
+                return { name: "biome", configFile: name };
+            }
+        }
+    }
+    // Prettier
+    const prettierFiles = [
+        ".prettierrc", ".prettierrc.json", ".prettierrc.js", ".prettierrc.cjs", ".prettierrc.mjs",
+        ".prettierrc.yaml", ".prettierrc.yml", ".prettierrc.toml",
+        "prettier.config.js", "prettier.config.mjs", "prettier.config.cjs",
+    ];
+    for (const name of prettierFiles) {
+        if (existsSync(join(dir, name))) {
+            return { name: "prettier", configFile: name };
+        }
+    }
+    return undefined;
+}
+function detectFormatter(packageDir, rootDir, _warnings = []) {
+    // Check package dir FIRST — package-level config takes priority
+    const pkgResult = detectFormatterIn(packageDir);
+    if (pkgResult)
+        return pkgResult;
+    // Fall back to root
+    if (rootDir) {
+        return detectFormatterIn(rootDir);
+    }
+    return undefined;
+}
+// ─── Task Runner ────────────────────────────────────────────────────────────
+function detectTaskRunner(packageDir, rootDir, _warnings = []) {
+    const dirs = rootDir ? [packageDir, rootDir] : [packageDir];
+    for (const dir of dirs) {
+        // Justfile
+        for (const name of ["justfile", "Justfile", ".justfile"]) {
+            const path = join(dir, name);
+            if (!existsSync(path))
+                continue;
+            try {
+                const content = readFileSync(path, "utf-8");
+                const targets = parseJustfileTargets(content);
+                return { name: "just", targets, configFile: name };
+            }
+            catch {
+                return { name: "just", targets: [], configFile: name };
+            }
+        }
+    }
+    for (const dir of dirs) {
+        // Makefile
+        for (const name of ["Makefile", "makefile", "GNUmakefile"]) {
+            const path = join(dir, name);
+            if (!existsSync(path))
+                continue;
+            try {
+                const content = readFileSync(path, "utf-8");
+                const targets = parseMakefileTargets(content);
+                return { name: "make", targets, configFile: name };
+            }
+            catch {
+                return { name: "make", targets: [], configFile: name };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse justfile target names. Targets are lines like "target-name:" at the start of a line.
+ */
+function parseJustfileTargets(content) {
+    const targets = [];
+    for (const line of content.split("\n")) {
+        // Justfile recipe: name starts at column 0, followed by optional params and ":"
+        const match = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*)\s*(?:\(.*?\))?\s*:/);
+        if (match && !line.startsWith("#") && !line.startsWith(" ") && !line.startsWith("\t")) {
+            targets.push(match[1]);
+        }
+    }
+    return targets;
+}
+/**
+ * Parse Makefile target names. Targets are lines like "target:" at the start of a line.
+ */
+function parseMakefileTargets(content) {
+    const targets = [];
+    for (const line of content.split("\n")) {
+        // Makefile target: starts at column 0, name followed by ":"
+        const match = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*)\s*:/);
+        if (match && !line.startsWith("\t") && !line.startsWith("#") && !match[1].startsWith(".")) {
+            targets.push(match[1]);
+        }
+    }
+    return targets;
+}
+// ─── Environment Variables ──────────────────────────────────────────────────
+function detectEnvVars(packageDir, rootDir) {
+    const dirs = rootDir ? [packageDir, rootDir] : [packageDir];
+    const envFiles = [".env.example", ".env.sample", ".env.template", ".env.local.example"];
+    for (const dir of dirs) {
+        for (const name of envFiles) {
+            const path = join(dir, name);
+            if (!existsSync(path))
+                continue;
+            try {
+                const content = readFileSync(path, "utf-8");
+                const vars = [];
+                for (const line of content.split("\n")) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed.startsWith("#"))
+                        continue;
+                    const match = trimmed.match(/^([A-Z_][A-Z0-9_]*)\s*=/);
+                    if (match)
+                        vars.push(match[1]);
+                }
+                if (vars.length > 0)
+                    return vars;
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    return undefined;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Strip single-line (//) and multi-line comments from JSON (JSONC support).
+ */
+function stripJsonComments(json) {
+    let result = "";
+    let inString = false;
+    let inSingleComment = false;
+    let inMultiComment = false;
+    for (let i = 0; i < json.length; i++) {
+        const ch = json[i];
+        const next = json[i + 1];
+        if (inSingleComment) {
+            if (ch === "\n") {
+                inSingleComment = false;
+                result += ch;
+            }
+            continue;
+        }
+        if (inMultiComment) {
+            if (ch === "*" && next === "/") {
+                inMultiComment = false;
+                i++;
+            }
+            continue;
+        }
+        if (inString) {
+            result += ch;
+            if (ch === "\\" && i + 1 < json.length) {
+                result += json[++i];
+            }
+            else if (ch === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            result += ch;
+        }
+        else if (ch === "/" && next === "/") {
+            inSingleComment = true;
+            i++;
+        }
+        else if (ch === "/" && next === "*") {
+            inMultiComment = true;
+            i++;
+        }
+        else {
+            result += ch;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config-analyzer.js.map