pi-harness-runtime 0.10.12 → 0.10.13

package/packages/django-plugin/dist/analyzer.js

@@ -0,0 +1,249 @@
+/**
+ * Django Analyzer (RFC-0064)
+ *
+ * Deep analysis of Django workspaces via filesystem inspection.
+ */
+import { existsSync } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+// --- Detection ---------------------------------------------------------------
+function isDjangoWorkspace(root) {
+    return (existsSync(join(root, "manage.py")) ||
+        (existsSync(join(root, "settings.py")) &&
+            existsSync(join(root, "requirements.txt"))) ||
+        (existsSync(join(root, "requirements.txt")) &&
+            existsSync(join(root, "manage.py"))));
+}
+// --- Version ----------------------------------------------------------------
+async function detectVersion(root) {
+    try {
+        const content = await readFile(join(root, "requirements.txt"), "utf-8");
+        const match = content.match(/Django[=<>~!^]*((\d+)\.\d+(?:\.\d+)?)/i);
+        if (match)
+            return match[1];
+    }
+    catch {
+        /* ignore */
+    }
+    // Check setup.py or pyproject.toml
+    for (const cfg of ["setup.py", "pyproject.toml"]) {
+        const cfgPath = join(root, cfg);
+        if (existsSync(cfgPath)) {
+            try {
+                const content = await readFile(cfgPath, "utf-8");
+                const match = content.match(/django[=<>~!^\s]*(\d+\.\d+(?:\.\d+)?)/i);
+                if (match)
+                    return match[1];
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    return undefined;
+}
+// --- Settings Parser ---------------------------------------------------------
+async function parseSettings(root) {
+    const installedApps = [];
+    const middleware = [];
+    const candidates = [
+        join(root, "settings.py"),
+        join(root, "core", "settings.py"),
+        join(root, "config", "settings.py"),
+    ];
+    for (const settingsPath of candidates) {
+        if (!existsSync(settingsPath))
+            continue;
+        try {
+            const content = await readFile(settingsPath, "utf-8");
+            // Parse INSTALLED_APPS = [ ... ]
+            const installedMatch = content.match(/INSTALLED_APPS\s*=\s*\[([\s\S]*?)\]/m);
+            if (installedMatch) {
+                const listContent = installedMatch[1];
+                // Match quoted strings and identifiers
+                const appMatches = listContent.matchAll(/(?:^|\s|,)\s*['"]?([a-zA-Z_][a-zA-Z0-9_]*(?:\.[a-zA-Z_][a-zA-Z0-9_]*)*)['"]?/g);
+                for (const m of appMatches) {
+                    const app = m[1].trim();
+                    if (app && !app.startsWith("#")) {
+                        installedApps.push(app);
+                    }
+                }
+            }
+            // Parse MIDDLEWARE = [ ... ]
+            const middlewareMatch = content.match(/MIDDLEWARE\s*=\s*\[([\s\S]*?)\]/m);
+            if (middlewareMatch) {
+                const listContent = middlewareMatch[1];
+                const mwMatches = listContent.matchAll(/(?:^|\s|,)\s*['"]?([a-zA-Z_][a-zA-Z0-9_.]*)['"]?/g);
+                for (const m of mwMatches) {
+                    const mw = m[1].trim();
+                    if (mw && !mw.startsWith("#")) {
+                        middleware.push(mw);
+                    }
+                }
+            }
+            if (installedApps.length > 0)
+                break;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return { installedApps, middleware };
+}
+// --- Django App Scanner -----------------------------------------------------
+async function scanDjangoApps(root) {
+    const apps = [];
+    // Django project apps can be:
+    // 1. Top-level directories with models.py
+    // 2. Apps in an "apps/" directory
+    const searchDirs = [root, join(root, "apps")];
+    const seen = new Set();
+    for (const searchDir of searchDirs) {
+        if (!existsSync(searchDir))
+            continue;
+        let entries = [];
+        try {
+            entries = await readdir(searchDir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.startsWith(".") || entry.startsWith("_"))
+                continue;
+            const appPath = join(searchDir, entry);
+            let isDir = false;
+            try {
+                isDir = (await import("node:fs/promises").then((m) => m.stat(appPath))).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (!isDir)
+                continue;
+            if (seen.has(entry))
+                continue;
+            seen.add(entry);
+            const modelsPath = join(appPath, "models.py");
+            const adminPath = join(appPath, "admin.py");
+            const migrationsDir = join(appPath, "migrations");
+            let modelCount = 0;
+            if (existsSync(modelsPath)) {
+                try {
+                    const modelsContent = await readFile(modelsPath, "utf-8");
+                    // Count class definitions that inherit from models.Model
+                    const match1 = modelsContent.match(/^class\s+\w+\s*\([^)]*models?\.[Mm]odel[^)]*\)/gm);
+                    modelCount = (match1 ?? []).length;
+                    // Also count class definitions (conservative)
+                    const match2 = modelsContent.match(/class\s+\w+\s*\(/g);
+                    modelCount = Math.max(modelCount, (match2 ?? []).length);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            apps.push({
+                name: entry,
+                path: appPath,
+                modelCount,
+                hasAdmin: existsSync(adminPath),
+                hasMigrations: existsSync(migrationsDir),
+            });
+        }
+    }
+    return apps;
+}
+// --- Management Commands ----------------------------------------------------
+async function findManagementCommands(root) {
+    const commands = [];
+    // Simple recursive scan for management/commands directories
+    const searchDirs = [];
+    try {
+        const entries = await readdir(root);
+        for (const entry of entries) {
+            if (entry.startsWith("."))
+                continue;
+            const managementDir = join(root, entry, "management", "commands");
+            if (existsSync(managementDir)) {
+                searchDirs.push(managementDir);
+            }
+            const appsMgmt = join(root, "apps", entry, "management", "commands");
+            if (existsSync(appsMgmt)) {
+                searchDirs.push(appsMgmt);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    for (const cmdDir of searchDirs) {
+        try {
+            const cmdEntries = await readdir(cmdDir);
+            for (const cmd of cmdEntries) {
+                if (cmd.startsWith("_") || !cmd.endsWith(".py"))
+                    continue;
+                commands.push(cmd.replace(/\.py$/, ""));
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [...new Set(commands)];
+}
+// --- Requirements -----------------------------------------------------------
+async function parseRequirements(root) {
+    const reqPath = join(root, "requirements.txt");
+    if (!existsSync(reqPath))
+        return [];
+    try {
+        const content = await readFile(reqPath, "utf-8");
+        return content
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l && !l.startsWith("#") && !l.startsWith("-"))
+            .map((l) => l.split(/[=<>~!^]/)[0].trim());
+    }
+    catch {
+        return [];
+    }
+}
+// --- Main Analyzer ---------------------------------------------------------
+export async function analyzeDjango(root) {
+    if (!isDjangoWorkspace(root))
+        return null;
+    const [version, settings, requirements] = await Promise.all([
+        detectVersion(root),
+        parseSettings(root),
+        parseRequirements(root),
+    ]);
+    const apps = await scanDjangoApps(root);
+    const managementCommands = await findManagementCommands(root);
+    const drfEnabled = requirements.some((r) => r.toLowerCase().includes("djangorestframework")) ||
+        settings.installedApps.some((a) => a.includes("rest_framework"));
+    // Config files
+    const configs = [];
+    for (const cfg of ["settings.py", "urls.py", "wsgi.py", "manage.py"]) {
+        const p = join(root, cfg);
+        if (existsSync(p)) {
+            configs.push({ name: cfg, path: p });
+        }
+    }
+    return {
+        framework: {
+            id: "django",
+            name: "Django",
+            category: "fullstack",
+            description: "Python web framework for perfectionists with deadlines",
+            tags: ["python", "fullstack", "orm"],
+        },
+        version,
+        apps,
+        managementCommands,
+        middleware: settings.middleware,
+        drfEnabled,
+        requirements,
+        configs,
+    };
+}
+//# sourceMappingURL=analyzer.js.map

package/packages/django-plugin/dist/analyzer.js.map

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

package/packages/django-plugin/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Django Plugin — Main Entry (RFC-0064)
+ */
+import type { FrameworkExtension } from "../../framework-plugin-sdk/src/types.js";
+export type { DjangoAnalysis, DjangoApp, ConfigFile } from "./types.js";
+export declare function analyzeDjangoWorkspace(root: string): Promise<import("./types.js").DjangoAnalysis | null>;
+export declare function createDjangoPlugin(): FrameworkExtension;
+//# sourceMappingURL=index.d.ts.map

package/packages/django-plugin/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAGlF,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAuBvD"}

package/packages/django-plugin/dist/index.js

@@ -0,0 +1,30 @@
+/**
+ * Django Plugin — Main Entry (RFC-0064)
+ */
+import { analyzeDjango } from "./analyzer.js";
+export async function analyzeDjangoWorkspace(root) {
+    return analyzeDjango(root);
+}
+export function createDjangoPlugin() {
+    return {
+        capability: "framework",
+        name: "Django Framework Plugin",
+        detector: {
+            detect: async (root) => {
+                const r = root;
+                const { existsSync } = await import("node:fs");
+                return (existsSync(`${r}/manage.py`) ||
+                    (existsSync(`${r}/settings.py`) &&
+                        existsSync(`${r}/requirements.txt`)));
+            },
+            signals: [
+                { type: "file", pattern: "manage.py", weight: 0.6 },
+                { type: "file", pattern: "settings.py", weight: 0.4 },
+                { type: "package", pattern: "django", weight: 0.5 },
+                { type: "directory", pattern: "migrations", weight: 0.3 },
+            ],
+        },
+        config: {},
+    };
+}
+//# sourceMappingURL=index.js.map

package/packages/django-plugin/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,IAAY;IAEZ,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,OAAO;QACN,UAAU,EAAE,WAAW;QACvB,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE;YACT,MAAM,EAAE,KAAK,EAAE,IAAa,EAAoB,EAAE;gBACjD,MAAM,CAAC,GAAG,IAAc,CAAC;gBACzB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/C,OAAO,CACN,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC;oBAC5B,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC;wBAC9B,UAAU,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CACrC,CAAC;YACH,CAAC;YACD,OAAO,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE;gBACnD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;gBACrD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE;gBACnD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE;aACzD;SACD;QACD,MAAM,EAAE,EAAE;KACV,CAAC;AACH,CAAC"}

package/packages/django-plugin/dist/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Django Plugin — Types (RFC-0064)
+ */
+export interface DjangoAnalysis {
+    framework: FrameworkInfo;
+    version?: string;
+    apps: DjangoApp[];
+    managementCommands: string[];
+    middleware: string[];
+    drfEnabled: boolean;
+    requirements: string[];
+    configs: ConfigFile[];
+}
+export interface FrameworkInfo {
+    id: string;
+    name: string;
+    category: string;
+    description: string;
+    tags: string[];
+}
+export interface DjangoApp {
+    name: string;
+    path: string;
+    modelCount: number;
+    hasAdmin: boolean;
+    hasMigrations: boolean;
+}
+export interface ConfigFile {
+    name: string;
+    path: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/django-plugin/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb"}

package/packages/django-plugin/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Django Plugin — Types (RFC-0064)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/django-plugin/dist/types.js.map

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

package/packages/doc-generator/dist/detector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Doc Generator — Project Detection (RFC-0014)
+ */
+import type { ProjectDetection } from "./types.js";
+/** Detect project type from a list of file paths. */
+export declare function detectProjectType(filePaths: string[]): ProjectDetection;
+/** Parse signals from a directory listing. */
+export declare function parseSignals(entries: string[]): string[];
+//# sourceMappingURL=detector.d.ts.map

package/packages/doc-generator/dist/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiEhE,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAqCvE;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAExD"}

package/packages/doc-generator/dist/detector.js

@@ -0,0 +1,98 @@
+/**
+ * Doc Generator — Project Detection (RFC-0014)
+ */
+const SIGNALS = {
+    frappe_erpnext: [
+        { pattern: /frappe-bench|hooks\.py/, weight: 0.3 },
+        { pattern: /doctype[/\\]/, weight: 0.4 },
+        { pattern: /\bapps\/[^/]+\/[^/]+\.py\b/, weight: 0.2 },
+    ],
+    frappe_spa: [
+        { pattern: /frappe-bench\/apps\/[^/]+\/frontend/, weight: 0.4 },
+        { pattern: /vite\.config\./, weight: 0.3 },
+        { pattern: /frappe\.call|frappe\.ui\./, weight: 0.3 },
+    ],
+    nextjs: [
+        { pattern: /next\.config\./, weight: 0.4 },
+        { pattern: /\/(app|pages)\/[^/]+\.(tsx|jsx|ts|js)/, weight: 0.3 },
+        { pattern: /"next"|'next'/, weight: 0.2 },
+    ],
+    react_vite: [
+        { pattern: /vite\.config\.(ts|js|mjs)/, weight: 0.4 },
+        { pattern: /src\/main\.(tsx|jsx)/, weight: 0.3 },
+        { pattern: /index\.html/, weight: 0.2 },
+    ],
+    django: [
+        { pattern: /manage\.py/, weight: 0.4 },
+        { pattern: /settings\.py/, weight: 0.3 },
+        { pattern: /models?\.py/, weight: 0.2 },
+    ],
+    laravel: [
+        { pattern: /artisan/, weight: 0.4 },
+        { pattern: /database\/seeders/, weight: 0.3 },
+        { pattern: /composer\.json/, weight: 0.2 },
+    ],
+    generic_web: [
+        { pattern: /package\.json/, weight: 0.2 },
+        { pattern: /index\.(html?|js|ts)/, weight: 0.2 },
+    ],
+    unknown: [],
+};
+const SEED_STRATEGIES = {
+    frappe_erpnext: "frappe_doc_insert",
+    frappe_spa: "frappe_fixtures",
+    nextjs: "nextjs_factory",
+    react_vite: "vite_seed",
+    django: "django_migrations",
+    laravel: "laravel_seeders",
+    generic_web: "generic_faker",
+    unknown: "generic_faker",
+};
+const E2E_STRATEGIES = {
+    frappe_erpnext: "bench_site_browser_flow",
+    frappe_spa: "api_plus_spa_flow",
+    nextjs: "nextjs_dev_server_flow",
+    react_vite: "vite_dev_server_flow",
+    django: "django_test_client_flow",
+    laravel: "laravel_dusk_flow",
+    generic_web: "playwright_generic_flow",
+    unknown: "playwright_generic_flow",
+};
+/** Detect project type from a list of file paths. */
+export function detectProjectType(filePaths) {
+    const scores = {
+        frappe_erpnext: 0,
+        frappe_spa: 0,
+        nextjs: 0,
+        react_vite: 0,
+        django: 0,
+        laravel: 0,
+        generic_web: 0,
+        unknown: 0,
+    };
+    const signals = [];
+    for (const filePath of filePaths) {
+        for (const [pType, pSignals] of Object.entries(SIGNALS)) {
+            for (const { pattern, weight } of pSignals) {
+                if (pattern.test(filePath)) {
+                    scores[pType] += weight;
+                    signals.push(filePath);
+                }
+            }
+        }
+    }
+    const best = Object.entries(scores).sort((a, b) => b[1] - a[1])[0];
+    const projectType = best[1] > 0 ? best[0] : "unknown";
+    return {
+        projectType,
+        confidence: Math.min(best[1], 1),
+        signals: [...new Set(signals)],
+        recommendedSeedStrategy: SEED_STRATEGIES[projectType],
+        recommendedE2EStrategy: E2E_STRATEGIES[projectType],
+    };
+}
+/** Parse signals from a directory listing. */
+export function parseSignals(entries) {
+    return entries.filter((e) => /[./]/.test(e));
+}
+//# sourceMappingURL=detector.js.map

package/packages/doc-generator/dist/detector.js.map

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

package/packages/doc-generator/dist/docs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Doc Generator — Documentation Generation (RFC-0014)
+ */
+import type { DetectedSymbol, GeneratedDocs, SourceFile } from "./types.js";
+/** Detect exported symbols in a source file. */
+export declare function detectSymbols(source: SourceFile): DetectedSymbol[];
+/** Generate documentation for a list of source files. */
+export declare function generateDocs(sources: SourceFile[], projectSignals: string[]): GeneratedDocs;
+//# sourceMappingURL=docs.d.ts.map

package/packages/doc-generator/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,cAAc,EACd,aAAa,EAEb,UAAU,EACV,MAAM,YAAY,CAAC;AAGpB,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,EAAE,CAoElE;AA+BD,yDAAyD;AACzD,wBAAgB,YAAY,CAC3B,OAAO,EAAE,UAAU,EAAE,EACrB,cAAc,EAAE,MAAM,EAAE,GACtB,aAAa,CAyCf"}

package/packages/doc-generator/dist/docs.js

@@ -0,0 +1,132 @@
+/**
+ * Doc Generator — Documentation Generation (RFC-0014)
+ */
+import { detectProjectType } from "./detector.js";
+/** Detect exported symbols in a source file. */
+export function detectSymbols(source) {
+    const symbols = [];
+    const lines = source.content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        const fnMatch = trimmed.match(/^(?:async\s+)?(?:export\s+)?function\s+(\w+)\s*\(([^)]*)\)/);
+        if (fnMatch) {
+            symbols.push({
+                name: fnMatch[1],
+                kind: "function",
+                signature: `${fnMatch[1]}(${fnMatch[2]})`,
+                docComment: getDocComment(lines, i),
+                file: source.path,
+                line: i + 1,
+            });
+        }
+        const classMatch = trimmed.match(/^(?:export\s+)?class\s+(\w+)/);
+        if (classMatch) {
+            symbols.push({
+                name: classMatch[1],
+                kind: "class",
+                docComment: getDocComment(lines, i),
+                file: source.path,
+                line: i + 1,
+            });
+        }
+        const ifaceMatch = trimmed.match(/^export\s+interface\s+(\w+)/);
+        if (ifaceMatch) {
+            symbols.push({
+                name: ifaceMatch[1],
+                kind: "interface",
+                docComment: getDocComment(lines, i),
+                file: source.path,
+                line: i + 1,
+            });
+        }
+        const typeMatch = trimmed.match(/^export\s+type\s+(\w+)/);
+        if (typeMatch) {
+            symbols.push({
+                name: typeMatch[1],
+                kind: "type",
+                docComment: getDocComment(lines, i),
+                file: source.path,
+                line: i + 1,
+            });
+        }
+        const constMatch = trimmed.match(/^export\s+const\s+(\w+)/);
+        if (constMatch) {
+            symbols.push({
+                name: constMatch[1],
+                kind: "constant",
+                docComment: getDocComment(lines, i),
+                file: source.path,
+                line: i + 1,
+            });
+        }
+    }
+    return symbols;
+}
+function getDocComment(lines, index) {
+    for (let j = Math.max(0, index - 5); j < index; j++) {
+        const prev = lines[j].trim();
+        if (prev.startsWith("/**") || prev.startsWith("///")) {
+            const endIdx = lines
+                .slice(j + 1, index)
+                .findIndex((l) => l.includes("*/"));
+            if (endIdx >= 0) {
+                const doc = lines.slice(j, j + endIdx + 2).join("\n");
+                return doc.replace(/\/\*\*|\*\/|[\s*]/g, "").trim();
+            }
+        }
+    }
+    return undefined;
+}
+function summarizeSymbols(symbols) {
+    const counts = {};
+    for (const s of symbols)
+        counts[s.kind] = (counts[s.kind] ?? 0) + 1;
+    return Object.entries(counts)
+        .map(([k, v]) => `${v} ${k}(s)`)
+        .join(", ");
+}
+function formatSymbol(s) {
+    const sig = s.signature ? `${s.name}${s.signature}` : s.name;
+    return `- ${sig} (${s.file}:${s.line})`;
+}
+/** Generate documentation for a list of source files. */
+export function generateDocs(sources, projectSignals) {
+    const detection = detectProjectType(projectSignals);
+    const allSymbols = sources.flatMap(detectSymbols);
+    const sections = [
+        {
+            heading: "Overview",
+            level: 1,
+            content: `Project type: ${detection.projectType} (confidence: ${(detection.confidence * 100).toFixed(0)}%)\nSignals: ${detection.signals.join(", ") || "none"}`,
+        },
+        {
+            heading: "Exports",
+            level: 1,
+            content: `Total exports: ${allSymbols.length}\n${summarizeSymbols(allSymbols)}`,
+        },
+        {
+            heading: "Functions",
+            level: 2,
+            content: allSymbols
+                .filter((s) => s.kind === "function")
+                .map(formatSymbol)
+                .join("\n") || "No functions found.",
+        },
+        {
+            heading: "Types & Interfaces",
+            level: 2,
+            content: allSymbols
+                .filter((s) => s.kind === "type" || s.kind === "interface")
+                .map(formatSymbol)
+                .join("\n") || "No types found.",
+        },
+    ];
+    return {
+        title: "Generated Documentation",
+        sections,
+        symbols: allSymbols,
+        projectType: detection.projectType,
+    };
+}
+//# sourceMappingURL=docs.js.map

package/packages/doc-generator/dist/docs.js.map

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

package/packages/doc-generator/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Doc Generator — Main Entry (RFC-0014)
+ */
+export { detectProjectType, parseSignals } from "./detector.js";
+export { detectSymbols, generateDocs } from "./docs.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/doc-generator/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACxD,mBAAmB,YAAY,CAAC"}

package/packages/doc-generator/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * Doc Generator — Main Entry (RFC-0014)
+ */
+export { detectProjectType, parseSignals } from "./detector.js";
+export { detectSymbols, generateDocs } from "./docs.js";
+//# sourceMappingURL=index.js.map