@aionlabsai/aion 0.2.15 → 0.2.17

package/dist/infra/cloud-analyzer.js

@@ -0,0 +1,209 @@
+import { spawnSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+// ── Provider detection ────────────────────────────────────────────────────────
+export function detectProviders() {
+    const detected = [];
+    if (process.env['AWS_ACCESS_KEY_ID'] || process.env['AWS_PROFILE'])
+        detected.push('aws');
+    if (process.env['AZURE_SUBSCRIPTION_ID'] || process.env['AZURE_TENANT_ID'])
+        detected.push('azure');
+    if (process.env['GOOGLE_APPLICATION_CREDENTIALS'] || process.env['GOOGLE_CLOUD_PROJECT'])
+        detected.push('gcp');
+    return detected;
+}
+function cli(cmd, args, timeout = 15000) {
+    const r = spawnSync(cmd, args, { encoding: 'utf8', timeout });
+    return { ok: r.status === 0, stdout: r.stdout ?? '' };
+}
+// ── AWS (read-only) ───────────────────────────────────────────────────────────
+function readAws() {
+    const check = cli('aws', ['sts', 'get-caller-identity', '--output', 'json']);
+    if (!check.ok)
+        return { ok: false, resources: [] };
+    const resources = [];
+    // EC2 instances
+    const ec2 = cli('aws', ['ec2', 'describe-instances', '--query',
+        'Reservations[].Instances[].[InstanceId,State.Name,InstanceType]', '--output', 'json']);
+    if (ec2.ok) {
+        try {
+            const items = JSON.parse(ec2.stdout);
+            items.forEach(([id, state, type]) => resources.push({ type: 'EC2', name: `${id} (${type})`, status: state }));
+        }
+        catch { /* skip */ }
+    }
+    // RDS
+    const rds = cli('aws', ['rds', 'describe-db-instances', '--query',
+        'DBInstances[].[DBInstanceIdentifier,DBInstanceStatus,Engine]', '--output', 'json']);
+    if (rds.ok) {
+        try {
+            const items = JSON.parse(rds.stdout);
+            items.forEach(([id, status, engine]) => resources.push({ type: 'RDS', name: `${id} (${engine})`, status }));
+        }
+        catch { /* skip */ }
+    }
+    // S3 buckets
+    const s3 = cli('aws', ['s3api', 'list-buckets', '--query', 'Buckets[].Name', '--output', 'json']);
+    if (s3.ok) {
+        try {
+            const names = JSON.parse(s3.stdout);
+            names.forEach((n) => resources.push({ type: 'S3', name: n }));
+        }
+        catch { /* skip */ }
+    }
+    // Lambda
+    const lambda = cli('aws', ['lambda', 'list-functions', '--query',
+        'Functions[].[FunctionName,Runtime,State]', '--output', 'json']);
+    if (lambda.ok) {
+        try {
+            const items = JSON.parse(lambda.stdout);
+            items.forEach(([name, runtime, state]) => resources.push({ type: 'Lambda', name: `${name} (${runtime})`, status: state }));
+        }
+        catch { /* skip */ }
+    }
+    return { ok: true, resources };
+}
+// ── Azure (read-only) ─────────────────────────────────────────────────────────
+function readAzure() {
+    const check = cli('az', ['account', 'show', '--output', 'json']);
+    if (!check.ok)
+        return { ok: false, resources: [] };
+    const resources = [];
+    // VMs
+    const vms = cli('az', ['vm', 'list', '--output', 'json', '--query', '[].{name:name,status:provisioningState,location:location}']);
+    if (vms.ok) {
+        try {
+            const items = JSON.parse(vms.stdout);
+            items.forEach((vm) => resources.push({ type: 'VM', name: vm.name, region: vm.location, status: vm.status }));
+        }
+        catch { /* skip */ }
+    }
+    // AKS
+    const aks = cli('az', ['aks', 'list', '--output', 'json', '--query', '[].{name:name,location:location}']);
+    if (aks.ok) {
+        try {
+            const items = JSON.parse(aks.stdout);
+            items.forEach((c) => resources.push({ type: 'AKS', name: c.name, region: c.location }));
+        }
+        catch { /* skip */ }
+    }
+    // Databases
+    const sql = cli('az', ['sql', 'server', 'list', '--output', 'json', '--query', '[].{name:name,location:location}']);
+    if (sql.ok) {
+        try {
+            const items = JSON.parse(sql.stdout);
+            items.forEach((s) => resources.push({ type: 'SQL', name: s.name, region: s.location }));
+        }
+        catch { /* skip */ }
+    }
+    return { ok: true, resources };
+}
+// ── GCP (read-only) ───────────────────────────────────────────────────────────
+function readGcp() {
+    const check = cli('gcloud', ['auth', 'print-access-token'], 5000);
+    if (!check.ok)
+        return { ok: false, resources: [] };
+    const resources = [];
+    const project = process.env['GOOGLE_CLOUD_PROJECT'] ?? '';
+    // Compute instances
+    const gce = cli('gcloud', ['compute', 'instances', 'list', '--format=json', ...(project ? ['--project', project] : [])]);
+    if (gce.ok) {
+        try {
+            const items = JSON.parse(gce.stdout);
+            items.forEach((i) => resources.push({ type: 'GCE', name: i.name, region: i.zone, status: i.status }));
+        }
+        catch { /* skip */ }
+    }
+    // Cloud SQL
+    const sql = cli('gcloud', ['sql', 'instances', 'list', '--format=json', ...(project ? ['--project', project] : [])]);
+    if (sql.ok) {
+        try {
+            const items = JSON.parse(sql.stdout);
+            items.forEach((i) => resources.push({ type: 'CloudSQL', name: i.name, region: i.region, status: i.state }));
+        }
+        catch { /* skip */ }
+    }
+    return { ok: true, resources };
+}
+// ── Gap detection ─────────────────────────────────────────────────────────────
+function detectGaps(cwd, resources) {
+    const gaps = [];
+    const resourceTypes = new Set(resources.map((r) => r.type.toLowerCase()));
+    // Read project signals
+    let envContent = '';
+    for (const f of ['.env.example', '.env.sample', '.env']) {
+        try {
+            envContent += readFileSync(join(cwd, f), 'utf8');
+        }
+        catch { /* ok */ }
+    }
+    // Check sbom for common services
+    const sbomPath = join(cwd, '.ai-runtime', 'sbom.json');
+    let deps = [];
+    if (existsSync(sbomPath)) {
+        try {
+            deps = Object.keys(JSON.parse(readFileSync(sbomPath, 'utf8')).packages ?? {});
+        }
+        catch { /* ok */ }
+    }
+    // Check IaC files
+    const hasIac = ['terraform', 'serverless.yml', 'docker-compose.yml', 'k8s', 'helm'].some((f) => existsSync(join(cwd, f)));
+    if (!hasIac) {
+        gaps.push({ severity: 'medium', category: 'missing-service', description: 'No IaC files detected', detail: 'No terraform/, serverless.yml, docker-compose.yml, or k8s/ found — infrastructure is not version-controlled' });
+    }
+    // DB dependency but no DB resource in cloud
+    const hasDbDep = deps.some((d) => /pg|mysql|mongo|redis|sqlite|prisma|sequelize|typeorm/i.test(d)) ||
+        /DATABASE_URL|REDIS_URL|MONGO_URI|DB_HOST/i.test(envContent);
+    const hasDbResource = resourceTypes.has('rds') || resourceTypes.has('sql') || resourceTypes.has('cloudsql') || resourceTypes.has('cosmos');
+    if (hasDbDep && !hasDbResource) {
+        gaps.push({ severity: 'high', category: 'missing-service', description: 'Database dependency with no managed DB resource', detail: 'Project uses a database client but no managed database found in cloud account' });
+    }
+    // S3/storage usage but no bucket
+    const hasStorageDep = deps.some((d) => /aws-sdk|@aws-sdk\/client-s3|googleapis|azure-storage/i.test(d)) ||
+        /S3_BUCKET|STORAGE_BUCKET|BLOB_CONTAINER/i.test(envContent);
+    const hasStorage = resourceTypes.has('s3') || resourceTypes.has('blob') || resourceTypes.has('gcs');
+    if (hasStorageDep && !hasStorage) {
+        gaps.push({ severity: 'high', category: 'missing-service', description: 'Storage SDK used but no bucket/container found', detail: 'Project imports cloud storage SDK but no bucket or container visible in cloud account' });
+    }
+    // No compute at all
+    const hasCompute = resourceTypes.has('ec2') || resourceTypes.has('vm') || resourceTypes.has('gce') ||
+        resourceTypes.has('lambda') || resourceTypes.has('aks') || resourceTypes.has('gke');
+    if (resources.length > 0 && !hasCompute) {
+        gaps.push({ severity: 'medium', category: 'missing-service', description: 'No compute resources visible', detail: 'Cloud account has resources but no compute instances, containers, or functions found' });
+    }
+    // Secrets in env but not likely in secrets manager
+    const secretVars = (envContent.match(/^[A-Z_]+_(?:KEY|SECRET|TOKEN|PASSWORD|CREDENTIAL)=.+/gm) ?? []);
+    if (secretVars.length > 3) {
+        gaps.push({ severity: 'medium', category: 'config-mismatch', description: `${secretVars.length} secret-like env vars in .env.example`, detail: 'Consider moving secrets to AWS Secrets Manager / Azure Key Vault / GCP Secret Manager' });
+    }
+    return gaps;
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+export function analyzeCloud(cwd, provider) {
+    let result;
+    if (provider === 'aws')
+        result = readAws();
+    else if (provider === 'azure')
+        result = readAzure();
+    else
+        result = readGcp();
+    if (!result.ok) {
+        return {
+            provider,
+            authenticated: false,
+            resources: [],
+            gaps: [],
+            summary: `Not authenticated — configure credentials for ${provider.toUpperCase()} CLI`,
+        };
+    }
+    const gaps = detectGaps(cwd, result.resources);
+    const highCount = gaps.filter((g) => g.severity === 'high').length;
+    return {
+        provider,
+        authenticated: true,
+        resources: result.resources,
+        gaps,
+        summary: `${result.resources.length} resources found, ${gaps.length} gaps${highCount > 0 ? ` (${highCount} critical)` : ''}`,
+    };
+}
+//# sourceMappingURL=cloud-analyzer.js.map

package/dist/infra/cloud-analyzer.js.map

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

package/dist/infra/dep-graph-db.d.ts

@@ -0,0 +1,24 @@
+import type { DepGraph } from './dep-graph.js';
+interface StoredGraph {
+    nodes: Array<{
+        file: string;
+        loc: number;
+        exports: string[];
+    }>;
+    edges: Array<[string, string]>;
+    builtAt: number;
+}
+export declare function saveDepGraph(cwd: string, graph: DepGraph): void;
+export declare function loadDepGraph(cwd: string): StoredGraph | null;
+export declare function isDepGraphCached(cwd: string): boolean;
+export interface ImpactResult {
+    changedFile: string;
+    directImporters: string[];
+    transitiveFiles: string[];
+    totalImpact: number;
+    hotspotOverlap: string[];
+}
+export declare function computeImpact(graph: StoredGraph, changedFile: string, hotspotFiles?: string[]): ImpactResult;
+export declare function formatImpactReport(result: ImpactResult): string;
+export {};
+//# sourceMappingURL=dep-graph-db.d.ts.map

package/dist/infra/dep-graph-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-graph-db.d.ts","sourceRoot":"","sources":["../../src/infra/dep-graph-db.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM/C,UAAU,WAAW;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/D,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAW/D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAM5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,YAAY,CAkChH;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA2B/D"}

package/dist/infra/dep-graph-db.js

@@ -0,0 +1,94 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+function storedPath(cwd) {
+    return join(cwd, '.ai-runtime', 'dep-graph.json');
+}
+export function saveDepGraph(cwd, graph) {
+    const nodes = [...graph.nodes.values()].map((n) => ({
+        file: n.file, loc: n.loc, exports: n.exports,
+    }));
+    const edges = [];
+    for (const node of graph.nodes.values()) {
+        for (const imp of node.imports)
+            edges.push([node.file, imp]);
+    }
+    const stored = { nodes, edges, builtAt: Date.now() };
+    mkdirSync(join(cwd, '.ai-runtime'), { recursive: true });
+    writeFileSync(storedPath(cwd), JSON.stringify(stored), 'utf8');
+}
+export function loadDepGraph(cwd) {
+    try {
+        const raw = JSON.parse(readFileSync(storedPath(cwd), 'utf8'));
+        if (Date.now() - raw.builtAt > CACHE_TTL_MS)
+            return null; // stale
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+export function isDepGraphCached(cwd) {
+    return existsSync(storedPath(cwd));
+}
+export function computeImpact(graph, changedFile, hotspotFiles = []) {
+    // Build reverse adjacency: file → files that import it
+    const reverseEdges = new Map();
+    for (const [from, to] of graph.edges) {
+        const list = reverseEdges.get(to) ?? [];
+        list.push(from);
+        reverseEdges.set(to, list);
+    }
+    const directImporters = reverseEdges.get(changedFile) ?? [];
+    // BFS for transitive impact
+    const visited = new Set();
+    const queue = [...directImporters];
+    while (queue.length) {
+        const cur = queue.shift();
+        if (visited.has(cur))
+            continue;
+        visited.add(cur);
+        for (const importer of reverseEdges.get(cur) ?? []) {
+            if (!visited.has(importer))
+                queue.push(importer);
+        }
+    }
+    const transitiveFiles = [...visited].filter((f) => !directImporters.includes(f)).sort();
+    const hotspotSet = new Set(hotspotFiles);
+    const hotspotOverlap = [...visited].filter((f) => hotspotSet.has(f)).sort();
+    return {
+        changedFile,
+        directImporters: directImporters.sort(),
+        transitiveFiles,
+        totalImpact: visited.size,
+        hotspotOverlap,
+    };
+}
+export function formatImpactReport(result) {
+    const lines = [];
+    lines.push(`Impact analysis: ${result.changedFile}`);
+    lines.push(`Total affected: ${result.totalImpact} file(s)\n`);
+    if (result.directImporters.length === 0) {
+        lines.push('No files import this module directly.');
+        return lines.join('\n');
+    }
+    lines.push(`Direct importers (${result.directImporters.length}):`);
+    for (const f of result.directImporters)
+        lines.push(`  → ${f}`);
+    if (result.transitiveFiles.length > 0) {
+        lines.push(`\nTransitive impact (${result.transitiveFiles.length} more):`);
+        for (const f of result.transitiveFiles.slice(0, 20))
+            lines.push(`  ↪ ${f}`);
+        if (result.transitiveFiles.length > 20)
+            lines.push(`  ... and ${result.transitiveFiles.length - 20} more`);
+    }
+    if (result.hotspotOverlap.length > 0) {
+        lines.push(`\nHotspot overlap (${result.hotspotOverlap.length} high-risk files also affected):`);
+        for (const f of result.hotspotOverlap)
+            lines.push(`  ⚠ ${f}`);
+    }
+    const risk = result.totalImpact > 20 ? 'HIGH' : result.totalImpact > 5 ? 'MEDIUM' : 'LOW';
+    lines.push(`\nRisk: ${risk}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=dep-graph-db.js.map

package/dist/infra/dep-graph-db.js.map

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

package/dist/infra/docs-analyzer.d.ts

@@ -0,0 +1,15 @@
+export interface DocGap {
+    type: 'missing-file' | 'missing-section' | 'undocumented-export' | 'missing-docstring';
+    severity: 'high' | 'medium' | 'low';
+    file?: string;
+    description: string;
+    suggestion: string;
+}
+export interface DocsReport {
+    gaps: DocGap[];
+    score: number;
+    existingDocs: string[];
+    summary: string;
+}
+export declare function analyzeProjectDocs(cwd: string): DocsReport;
+//# sourceMappingURL=docs-analyzer.d.ts.map

package/dist/infra/docs-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-analyzer.d.ts","sourceRoot":"","sources":["../../src/infra/docs-analyzer.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,mBAAmB,CAAC;IACvF,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqFD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA+C1D"}

package/dist/infra/docs-analyzer.js

@@ -0,0 +1,136 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { join, relative, extname } from 'path';
+import { IGNORE_DIRS, SOURCE_EXTS } from '../cli/cli-utils.js';
+// ── Required files ────────────────────────────────────────────────────────────
+const REQUIRED_FILES = [
+    { file: 'README.md', severity: 'high', suggestion: 'Create README.md with install, usage, and configuration sections' },
+    { file: 'CHANGELOG.md', severity: 'low', suggestion: 'Create CHANGELOG.md to track version history' },
+    { file: 'CONTRIBUTING.md', severity: 'low', suggestion: 'Create CONTRIBUTING.md with development setup and PR guidelines' },
+    { file: '.env.example', severity: 'medium', suggestion: 'Create .env.example listing all required environment variables' },
+];
+const README_SECTIONS = [
+    { pattern: /#+\s*(install|installation|getting.?started)/i, label: 'Installation', severity: 'high' },
+    { pattern: /#+\s*(usage|quick.?start|example)/i, label: 'Usage', severity: 'high' },
+    { pattern: /#+\s*(config|configuration|environment|env)/i, label: 'Configuration', severity: 'medium' },
+    { pattern: /#+\s*(api|endpoints|routes)/i, label: 'API reference', severity: 'low' },
+    { pattern: /#+\s*(contribut|development|dev.?setup)/i, label: 'Contributing', severity: 'low' },
+];
+// ── JSDoc / docstring detection ───────────────────────────────────────────────
+function hasDocstring(content, exportLine, lines) {
+    // Check the line above for JSDoc /** or Python docstring """
+    const above = lines[exportLine - 2] ?? '';
+    const twoAbove = lines[exportLine - 3] ?? '';
+    return above.trim().startsWith('*') ||
+        above.trim().startsWith('*/') ||
+        twoAbove.trim().startsWith('/**') ||
+        above.trim().startsWith('"""') ||
+        above.trim().startsWith("'''");
+}
+const EXPORT_RE = /^export\s+(function|class|const|interface|type|enum|async function)\s+([A-Za-z_]\w*)/;
+const PY_DEF_RE = /^(?:def|class|async def)\s+([A-Za-z_]\w*)/;
+function findUndocumentedExports(cwd, file) {
+    const gaps = [];
+    let content;
+    try {
+        content = readFileSync(join(cwd, file), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split('\n');
+    const ext = extname(file);
+    const isPy = ext === '.py';
+    lines.forEach((line, i) => {
+        const m = isPy ? PY_DEF_RE.exec(line.trim()) : EXPORT_RE.exec(line);
+        if (!m)
+            return;
+        const name = isPy ? m[1] : m[2];
+        if (!name || name.startsWith('_'))
+            return; // skip private
+        if (!hasDocstring(content, i, lines)) {
+            gaps.push({
+                type: 'missing-docstring',
+                severity: 'low',
+                file,
+                description: `${isPy ? 'def' : 'export'} \`${name}\` has no docstring`,
+                suggestion: `Add JSDoc/docstring above \`${name}\` in ${file}`,
+            });
+        }
+    });
+    return gaps.slice(0, 5); // max 5 per file to avoid noise
+}
+// ── Walker ────────────────────────────────────────────────────────────────────
+function walkSrc(cwd) {
+    const files = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (IGNORE_DIRS.has(entry) || entry.startsWith('.'))
+                continue;
+            const full = join(dir, entry);
+            try {
+                if (statSync(full).isDirectory()) {
+                    walk(full);
+                    continue;
+                }
+                if (SOURCE_EXTS.includes(extname(entry)))
+                    files.push(relative(cwd, full));
+            }
+            catch { /* skip */ }
+        }
+    };
+    walk(cwd);
+    return files;
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+export function analyzeProjectDocs(cwd) {
+    const gaps = [];
+    const existingDocs = [];
+    // 1. Required files
+    for (const { file, severity, suggestion } of REQUIRED_FILES) {
+        if (existsSync(join(cwd, file))) {
+            existingDocs.push(file);
+        }
+        else {
+            gaps.push({ type: 'missing-file', severity, description: `Missing ${file}`, suggestion, file });
+        }
+    }
+    // 2. README sections
+    const readmePath = join(cwd, 'README.md');
+    if (existsSync(readmePath)) {
+        const readme = readFileSync(readmePath, 'utf8');
+        for (const { pattern, label, severity } of README_SECTIONS) {
+            if (!pattern.test(readme)) {
+                gaps.push({
+                    type: 'missing-section',
+                    severity,
+                    file: 'README.md',
+                    description: `README.md missing "${label}" section`,
+                    suggestion: `Add a ## ${label} section to README.md`,
+                });
+            }
+        }
+    }
+    // 3. Undocumented exports (sample: top 20 files by path depth)
+    const srcFiles = walkSrc(cwd).slice(0, 20);
+    for (const file of srcFiles) {
+        if (/\.(test|spec)\./.test(file))
+            continue;
+        gaps.push(...findUndocumentedExports(cwd, file));
+    }
+    // Score: start at 100, deduct per gap
+    const deductions = { high: 20, medium: 10, low: 3 };
+    const score = Math.max(0, 100 - gaps.reduce((s, g) => s + deductions[g.severity], 0));
+    const highCount = gaps.filter((g) => g.severity === 'high').length;
+    const summary = highCount > 0
+        ? `${gaps.length} documentation gaps found (${highCount} critical)`
+        : `${gaps.length} documentation gaps found`;
+    return { gaps, score, existingDocs, summary };
+}
+//# sourceMappingURL=docs-analyzer.js.map

package/dist/infra/docs-analyzer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aionlabsai/aion",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "Multi-agent AI engineering runtime — audit, fix, graph, analyze",
   "type": "module",
   "bin": {