@malikasadjaved/readme-ai 1.0.0

package/dist/analyzers/file-scanner.js

@@ -0,0 +1,103 @@
+import { readFileContent } from '../utils/file-utils.js';
+import { generateTree } from '../utils/file-utils.js';
+import { calculateLanguageStats, isTestFile, FRAMEWORK_INDICATORS, } from '../utils/language-detector.js';
+export async function scanFiles(repoContent) {
+    const { files } = repoContent;
+    const filePaths = files.map(f => f.path);
+    const languages = calculateLanguageStats(filePaths);
+    const frameworks = await detectFrameworks(repoContent);
+    const hasTests = files.some(f => f.isTest || isTestFile(f.path));
+    const hasDocker = files.some(f => {
+        const name = f.path.split('/').pop() || '';
+        return name === 'Dockerfile' || name.startsWith('docker-compose');
+    });
+    const hasCICD = files.some(f => f.path.includes('.github/workflows/') ||
+        f.path.includes('.gitlab-ci') ||
+        f.path.includes('.circleci/') ||
+        f.path.includes('Jenkinsfile'));
+    const hasLicense = await detectLicense(repoContent);
+    const entryPoints = files.filter(f => f.isEntryPoint).map(f => f.path);
+    const configFiles = files.filter(f => f.isConfig).map(f => f.path);
+    const directoryTree = generateTree(filePaths, 3);
+    // Key files: entry points + src/ files (non-test, non-config), limited to 30
+    const keyFiles = files
+        .filter(f => !f.isTest && !f.isConfig)
+        .sort((a, b) => {
+        if (a.isEntryPoint && !b.isEntryPoint)
+            return -1;
+        if (!a.isEntryPoint && b.isEntryPoint)
+            return 1;
+        return a.path.split('/').length - b.path.split('/').length;
+    })
+        .slice(0, 30);
+    return {
+        totalFiles: files.length,
+        languages,
+        frameworks,
+        hasTests,
+        hasDocker,
+        hasCICD,
+        hasLicense,
+        entryPoints,
+        configFiles,
+        directoryTree,
+        keyFiles,
+    };
+}
+async function detectFrameworks(repo) {
+    const detected = [];
+    const filePaths = new Set(repo.files.map(f => f.path.split('/').pop() || ''));
+    const allPaths = new Set(repo.files.map(f => f.path));
+    // Get dependencies from package.json
+    const deps = new Set();
+    if (repo.packageJson) {
+        const pkg = repo.packageJson;
+        const allDeps = {
+            ...(pkg.dependencies || {}),
+            ...(pkg.devDependencies || {}),
+        };
+        Object.keys(allDeps).forEach(d => deps.add(d));
+    }
+    for (const [framework, indicators] of Object.entries(FRAMEWORK_INDICATORS)) {
+        // Check dependency names
+        if (indicators.deps?.some(d => deps.has(d))) {
+            detected.push(framework);
+            continue;
+        }
+        // Check file existence
+        if (indicators.files?.some(f => filePaths.has(f) || allPaths.has(f))) {
+            detected.push(framework);
+            continue;
+        }
+    }
+    return detected;
+}
+async function detectLicense(repo) {
+    if (repo.githubMeta?.license) {
+        return repo.githubMeta.license;
+    }
+    const licenseFile = repo.files.find(f => {
+        const name = (f.path.split('/').pop() || '').toLowerCase();
+        return name === 'license' || name === 'license.md' || name === 'license.txt';
+    });
+    if (!licenseFile)
+        return null;
+    try {
+        const content = await readFileContent(licenseFile.absolutePath);
+        if (content.includes('MIT License'))
+            return 'MIT';
+        if (content.includes('Apache License'))
+            return 'Apache-2.0';
+        if (content.includes('GNU GENERAL PUBLIC LICENSE'))
+            return 'GPL-3.0';
+        if (content.includes('BSD'))
+            return 'BSD-3-Clause';
+        if (content.includes('ISC License'))
+            return 'ISC';
+        return 'Custom';
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/analyzers/file-scanner.js.map

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

package/dist/analyzers/index.d.ts

@@ -0,0 +1,7 @@
+export { fetchRepo, type RepoContent, type FileEntry } from './repo-fetcher.js';
+export { scanFiles, type ScanResult } from './file-scanner.js';
+export { analyzeDependencies, type DependencyAnalysis } from './dependency-analyzer.js';
+export { analyzeCode, type CodeAnalysis, type ExportInfo, type FunctionInfo, type Endpoint, type CLICommand } from './code-analyzer.js';
+export { generateBadges, formatBadgeRow, type Badge } from './badge-generator.js';
+export { buildDiagram, type DiagramResult } from './diagram-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxI,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/analyzers/index.js

@@ -0,0 +1,7 @@
+export { fetchRepo } from './repo-fetcher.js';
+export { scanFiles } from './file-scanner.js';
+export { analyzeDependencies } from './dependency-analyzer.js';
+export { analyzeCode } from './code-analyzer.js';
+export { generateBadges, formatBadgeRow } from './badge-generator.js';
+export { buildDiagram } from './diagram-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/analyzers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAmB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAA2B,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,WAAW,EAAyF,MAAM,oBAAoB,CAAC;AACxI,OAAO,EAAE,cAAc,EAAE,cAAc,EAAc,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAsB,MAAM,sBAAsB,CAAC"}

package/dist/analyzers/repo-fetcher.d.ts

@@ -0,0 +1,22 @@
+import { type GitHubMeta } from '../utils/github-api.js';
+export interface FileEntry {
+    path: string;
+    absolutePath: string;
+    language: string;
+    size: number;
+    isEntryPoint: boolean;
+    isConfig: boolean;
+    isTest: boolean;
+}
+export interface RepoContent {
+    path: string;
+    isRemote: boolean;
+    files: FileEntry[];
+    packageJson?: Record<string, unknown>;
+    pythonRequirements?: string;
+    cargoToml?: string;
+    goMod?: string;
+    githubMeta?: GitHubMeta;
+}
+export declare function fetchRepo(input: string): Promise<RepoContent>;
+//# sourceMappingURL=repo-fetcher.d.ts.map

package/dist/analyzers/repo-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-fetcher.d.ts","sourceRoot":"","sources":["../../src/analyzers/repo-fetcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAehC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAWD,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAMnE"}

package/dist/analyzers/repo-fetcher.js

@@ -0,0 +1,134 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import { parseGitHubURL, fetchGitHubMeta, fetchGitHubTree, fetchGitHubFileContent, } from '../utils/github-api.js';
+import { globFiles, loadIgnorePatterns, readFileContent, fileExists, getFileExtension, } from '../utils/file-utils.js';
+import { detectLanguage, isConfigFile, isTestFile, isEntryPoint, } from '../utils/language-detector.js';
+const MAX_REMOTE_FILES = 100;
+const SOURCE_EXTENSIONS = new Set([
+    'ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs',
+    'py', 'rs', 'go', 'java', 'kt', 'swift',
+    'rb', 'php', 'cs', 'cpp', 'c', 'h',
+    'vue', 'svelte', 'dart', 'ex', 'exs',
+    'scala', 'lua', 'r', 'zig', 'sh',
+]);
+export async function fetchRepo(input) {
+    const github = parseGitHubURL(input);
+    if (github) {
+        return fetchRemoteRepo(github.owner, github.repo, github.branch);
+    }
+    return fetchLocalRepo(path.resolve(input));
+}
+async function fetchLocalRepo(repoPath) {
+    const stat = await fs.stat(repoPath);
+    if (!stat.isDirectory()) {
+        throw new Error(`Not a directory: ${repoPath}`);
+    }
+    const ignores = await loadIgnorePatterns(repoPath);
+    const relativePaths = await globFiles(repoPath, ignores);
+    const files = relativePaths.map(relPath => {
+        const absPath = path.join(repoPath, relPath);
+        return {
+            path: relPath,
+            absolutePath: absPath,
+            language: detectLanguage(relPath),
+            size: 0,
+            isEntryPoint: isEntryPoint(relPath),
+            isConfig: isConfigFile(relPath),
+            isTest: isTestFile(relPath),
+        };
+    });
+    const result = { path: repoPath, isRemote: false, files };
+    const pkgPath = path.join(repoPath, 'package.json');
+    if (await fileExists(pkgPath)) {
+        try {
+            result.packageJson = JSON.parse(await readFileContent(pkgPath));
+        }
+        catch { /* ignore parse errors */ }
+    }
+    const reqPath = path.join(repoPath, 'requirements.txt');
+    if (await fileExists(reqPath)) {
+        result.pythonRequirements = await readFileContent(reqPath);
+    }
+    const cargoPath = path.join(repoPath, 'Cargo.toml');
+    if (await fileExists(cargoPath)) {
+        result.cargoToml = await readFileContent(cargoPath);
+    }
+    const goModPath = path.join(repoPath, 'go.mod');
+    if (await fileExists(goModPath)) {
+        result.goMod = await readFileContent(goModPath);
+    }
+    return result;
+}
+async function fetchRemoteRepo(owner, repo, branch) {
+    const githubMeta = await fetchGitHubMeta(owner, repo);
+    const treeEntries = await fetchGitHubTree(owner, repo, branch);
+    const tmpDir = path.join(os.tmpdir(), `readme-ai-${owner}-${repo}-${Date.now()}`);
+    await fs.mkdir(tmpDir, { recursive: true });
+    // Filter to source files and important configs, limit count
+    const prioritized = treeEntries
+        .filter(entry => {
+        const ext = getFileExtension(entry.path);
+        const name = entry.path.split('/').pop() || '';
+        return SOURCE_EXTENSIONS.has(ext) ||
+            name === 'package.json' ||
+            name === 'requirements.txt' ||
+            name === 'Cargo.toml' ||
+            name === 'go.mod' ||
+            name === 'pyproject.toml' ||
+            name === 'Dockerfile' ||
+            name === 'Makefile';
+    })
+        .sort((a, b) => {
+        // Prioritize entry points and configs
+        const aEntry = isEntryPoint(a.path) ? 0 : 1;
+        const bEntry = isEntryPoint(b.path) ? 0 : 1;
+        if (aEntry !== bEntry)
+            return aEntry - bEntry;
+        // Then by path depth (shallower first)
+        return a.path.split('/').length - b.path.split('/').length;
+    })
+        .slice(0, MAX_REMOTE_FILES);
+    // Download files in parallel batches
+    const batchSize = 10;
+    for (let i = 0; i < prioritized.length; i += batchSize) {
+        const batch = prioritized.slice(i, i + batchSize);
+        await Promise.all(batch.map(async (entry) => {
+            try {
+                const content = await fetchGitHubFileContent(owner, repo, entry.path, branch);
+                const filePath = path.join(tmpDir, entry.path);
+                await fs.mkdir(path.dirname(filePath), { recursive: true });
+                await fs.writeFile(filePath, content, 'utf-8');
+            }
+            catch {
+                // Skip files that fail to download
+            }
+        }));
+    }
+    const files = prioritized.map(entry => ({
+        path: entry.path,
+        absolutePath: path.join(tmpDir, entry.path),
+        language: detectLanguage(entry.path),
+        size: entry.size,
+        isEntryPoint: isEntryPoint(entry.path),
+        isConfig: isConfigFile(entry.path),
+        isTest: isTestFile(entry.path),
+    }));
+    const result = {
+        path: tmpDir,
+        isRemote: true,
+        files,
+        githubMeta,
+    };
+    // Parse package.json if downloaded
+    const pkgFile = files.find(f => f.path === 'package.json');
+    if (pkgFile) {
+        try {
+            const content = await readFileContent(pkgFile.absolutePath);
+            result.packageJson = JSON.parse(content);
+        }
+        catch { /* ignore */ }
+    }
+    return result;
+}
+//# sourceMappingURL=repo-fetcher.js.map

package/dist/analyzers/repo-fetcher.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function runCLI(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,kBAwD3B"}

package/dist/cli.js

@@ -0,0 +1,54 @@
+import chalk from 'chalk';
+import { input, select, checkbox } from '@inquirer/prompts';
+import { runGenerate } from './commands/generate.js';
+export async function runCLI() {
+    console.log(chalk.cyan.bold('\n✨ readme-ai — Let\'s generate your README\n'));
+    const repoPath = await input({
+        message: 'Path to your project (or GitHub URL):',
+        default: '.',
+    });
+    const provider = await select({
+        message: 'Choose your AI provider:',
+        choices: [
+            { name: '🟣 Claude (Anthropic) — Recommended', value: 'anthropic' },
+            { name: '🟢 GPT-4o-mini (OpenAI)', value: 'openai' },
+            { name: '🔵 Gemini Flash (Google)', value: 'gemini' },
+            { name: '⚪ Ollama (100% local, free)', value: 'ollama' },
+        ],
+    });
+    const theme = await select({
+        message: 'Choose README theme:',
+        choices: [
+            { name: '📄 Default — Clean & professional', value: 'default' },
+            { name: '⚡ Modern — Emoji-rich with colorful badges', value: 'modern' },
+            { name: '🖤 Hacker — Terminal/dark ASCII aesthetic', value: 'hacker' },
+            { name: '🪶 Minimal — No emojis, pure markdown', value: 'minimal' },
+            { name: '🎓 Academic — Formal, citation style', value: 'academic' },
+        ],
+    });
+    const options = await checkbox({
+        message: 'What to include:',
+        choices: [
+            { name: '🏗️  Architecture diagram (Mermaid)', value: 'diagram', checked: true },
+            { name: '🏷️  Auto-generated badges', value: 'badges', checked: true },
+            { name: '📚 API documentation', value: 'apiDocs', checked: true },
+            { name: '🔄 GitHub Action for auto-updates', value: 'action', checked: false },
+        ],
+    });
+    const context = await input({
+        message: 'Any additional context for the AI? (optional):',
+        default: '',
+    });
+    const optionsSet = new Set(options);
+    await runGenerate({
+        repo: repoPath,
+        provider,
+        theme,
+        context: context || undefined,
+        diagram: optionsSet.has('diagram'),
+        badges: optionsSet.has('badges'),
+        apiDocs: optionsSet.has('apiDocs'),
+        action: optionsSet.has('action'),
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC,CAAC;IAE9E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;QAC3B,OAAO,EAAE,uCAAuC;QAChD,OAAO,EAAE,GAAG;KACb,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;QAC5B,OAAO,EAAE,0BAA0B;QACnC,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,qCAAqC,EAAE,KAAK,EAAE,WAAW,EAAE;YACnE,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,QAAQ,EAAE;YACpD,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,QAAQ,EAAE;YACrD,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;SACzD;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;QACzB,OAAO,EAAE,sBAAsB;QAC/B,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,mCAAmC,EAAE,KAAK,EAAE,SAAS,EAAE;YAC/D,EAAE,IAAI,EAAE,4CAA4C,EAAE,KAAK,EAAE,QAAQ,EAAE;YACvE,EAAE,IAAI,EAAE,2CAA2C,EAAE,KAAK,EAAE,QAAQ,EAAE;YACtE,EAAE,IAAI,EAAE,uCAAuC,EAAE,KAAK,EAAE,SAAS,EAAE;YACnE,EAAE,IAAI,EAAE,sCAAsC,EAAE,KAAK,EAAE,UAAU,EAAE;SACpE;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC7B,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,qCAAqC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YAChF,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACtE,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;YACjE,EAAE,IAAI,EAAE,mCAAmC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;SAC/E;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC;QAC1B,OAAO,EAAE,gDAAgD;QACzD,OAAO,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAEpC,MAAM,WAAW,CAAC;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,KAAK;QACL,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;QAChC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,17 @@
+export interface GenerateOptions {
+    repo: string;
+    output?: string;
+    provider?: string;
+    model?: string;
+    theme?: string;
+    diagram?: boolean;
+    badges?: boolean;
+    apiDocs?: boolean;
+    interactive?: boolean;
+    action?: boolean;
+    overwrite?: boolean;
+    dryRun?: boolean;
+    context?: string;
+}
+export declare function runGenerate(opts: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,iBAiJtD"}

package/dist/commands/generate.js

@@ -0,0 +1,189 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import chalk from 'chalk';
+import ora from 'ora';
+import { confirm } from '@inquirer/prompts';
+import { fetchRepo } from '../analyzers/repo-fetcher.js';
+import { scanFiles } from '../analyzers/file-scanner.js';
+import { analyzeDependencies } from '../analyzers/dependency-analyzer.js';
+import { analyzeCode } from '../analyzers/code-analyzer.js';
+import { generateBadges, formatBadgeRow } from '../analyzers/badge-generator.js';
+import { buildDiagram } from '../analyzers/diagram-builder.js';
+import { createProvider } from '../providers/index.js';
+import { generateOverview } from '../generators/overview.js';
+import { generateInstallSection } from '../generators/install.js';
+import { generateUsageSection, generateAPIDocs } from '../generators/usage.js';
+import { generateContributing, getLicense } from '../generators/contributing.js';
+import { getTheme } from '../themes/index.js';
+import { fileExists } from '../utils/file-utils.js';
+export async function runGenerate(opts) {
+    const spinner = ora();
+    const startTime = Date.now();
+    try {
+        // ─── PHASE 1: FETCH ──────────────────────────────────────────────
+        spinner.start('Fetching repository...');
+        const repoContent = await fetchRepo(opts.repo);
+        spinner.succeed(`Repository loaded: ${repoContent.files.length} files`);
+        // ─── PHASE 2: ANALYZE ────────────────────────────────────────────
+        spinner.start('Scanning file structure...');
+        const scan = await scanFiles(repoContent);
+        const langInfo = scan.languages[0]?.name || 'Unknown';
+        const fwInfo = scan.frameworks.length > 0 ? ` with ${scan.frameworks.join(', ')}` : '';
+        spinner.succeed(`Detected: ${langInfo} project${fwInfo}`);
+        spinner.start('Analyzing code...');
+        const codeAnalysis = await analyzeCode(scan.keyFiles);
+        spinner.succeed(`Found ${codeAnalysis.apiEndpoints.length} endpoints, ` +
+            `${codeAnalysis.mainFunctions.length} key functions`);
+        spinner.start('Analyzing dependencies...');
+        const deps = await analyzeDependencies(repoContent);
+        spinner.succeed(`Package manager: ${deps.packageManager || 'None detected'}`);
+        // ─── PHASE 3: GENERATE WITH AI ───────────────────────────────────
+        const provider = await createProvider(opts.provider || 'anthropic', opts.model);
+        spinner.start('Generating project overview with AI...');
+        const existingDescription = repoContent.packageJson
+            ? repoContent.packageJson.description
+            : repoContent.githubMeta?.description || undefined;
+        const overview = await generateOverview({
+            scan,
+            deps,
+            codeAnalysis,
+            provider,
+            existingDescription,
+            userContext: opts.context,
+        });
+        spinner.succeed('Overview generated');
+        let diagram = null;
+        if (opts.diagram !== false) {
+            spinner.start('Building architecture diagram...');
+            diagram = await buildDiagram(scan, codeAnalysis, deps, provider);
+            spinner.succeed('Architecture diagram created');
+        }
+        spinner.start('Generating installation instructions...');
+        const installSection = generateInstallSection(deps, scan);
+        spinner.succeed('Installation section ready');
+        spinner.start('Generating usage examples...');
+        const usageSection = await generateUsageSection({ codeAnalysis, scan, deps, provider });
+        spinner.succeed(`${usageSection.examples.length} usage examples generated`);
+        let apiDocs = null;
+        if (opts.apiDocs !== false && codeAnalysis.exports.length > 0) {
+            spinner.start('Generating API documentation...');
+            apiDocs = await generateAPIDocs({ codeAnalysis, provider });
+            spinner.succeed(`API docs generated for ${apiDocs.entries.length} exports`);
+        }
+        // ─── PHASE 4: RENDER ─────────────────────────────────────────────
+        let badgeRow = '';
+        if (opts.badges !== false) {
+            spinner.start('Generating badges...');
+            const badges = generateBadges(scan, deps, repoContent.githubMeta);
+            badgeRow = formatBadgeRow(badges);
+            spinner.succeed(`${badges.length} badges generated`);
+        }
+        const themeName = opts.theme || 'default';
+        spinner.start(`Rendering ${themeName} theme...`);
+        const theme = getTheme(themeName);
+        const projectName = getProjectName(repoContent);
+        const readme = theme.render({
+            projectName,
+            tagline: overview.tagline,
+            badgeRow,
+            description: overview.description,
+            diagram,
+            keyFeatures: overview.keyFeatures,
+            useCases: overview.useCases,
+            installSection,
+            usageSection,
+            apiDocs,
+            contributingSection: generateContributing(scan, deps),
+            license: getLicense(scan),
+            directoryTree: scan.directoryTree,
+        });
+        spinner.succeed('README rendered');
+        // ─── PHASE 5: OUTPUT ─────────────────────────────────────────────
+        if (opts.dryRun) {
+            console.log('\n' + readme);
+            return;
+        }
+        const outputFile = opts.output || 'README.md';
+        const outputPath = path.resolve(repoContent.isRemote ? '.' : repoContent.path, outputFile);
+        if (await fileExists(outputPath) && !opts.overwrite) {
+            const shouldOverwrite = await confirm({
+                message: `${outputFile} already exists. Overwrite?`,
+            });
+            if (!shouldOverwrite) {
+                console.log(chalk.yellow('Aborted.'));
+                return;
+            }
+        }
+        await fs.writeFile(outputPath, readme, 'utf-8');
+        const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+        const sizeKB = (Buffer.byteLength(readme) / 1024).toFixed(1);
+        console.log(`
+${chalk.green('✓')} README generated successfully!
+
+  ${chalk.bold('Output:')}  ${outputPath}
+  ${chalk.bold('Theme:')}   ${themeName}
+  ${chalk.bold('Size:')}    ${sizeKB} KB
+  ${chalk.bold('Time:')}    ${elapsed}s
+
+  ${chalk.dim('Preview: https://markdownlivepreview.com')}
+`);
+        // Optionally generate GitHub Action
+        if (opts.action) {
+            await generateGitHubAction(repoContent.isRemote ? '.' : repoContent.path);
+            console.log(`${chalk.green('✓')} GitHub Action created: .github/workflows/readme-update.yml`);
+        }
+    }
+    catch (error) {
+        spinner.fail(error.message);
+        process.exit(1);
+    }
+}
+function getProjectName(repo) {
+    if (repo.githubMeta)
+        return repo.githubMeta.repo;
+    if (repo.packageJson?.name)
+        return repo.packageJson.name;
+    return path.basename(path.resolve(repo.path));
+}
+async function generateGitHubAction(repoPath) {
+    const actionContent = `# .github/workflows/readme-update.yml
+# Generated by readme-ai — https://github.com/malikasadjaved/readme-ai
+# This action auto-regenerates your README on every push to main
+
+name: Update README
+
+on:
+  push:
+    branches: [main, master]
+    paths-ignore:
+      - 'README.md'
+
+jobs:
+  update-readme:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate README
+        run: npx readme-ai@latest --overwrite
+        env:
+          ANTHROPIC_API_KEY: \${{ secrets.ANTHROPIC_API_KEY }}
+
+      - name: Commit updated README
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: 'docs: auto-update README [skip ci]'
+          file_pattern: README.md
+`;
+    const actionDir = path.join(repoPath, '.github', 'workflows');
+    await fs.mkdir(actionDir, { recursive: true });
+    await fs.writeFile(path.join(actionDir, 'readme-update.yml'), actionContent, 'utf-8');
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import Conf from 'conf';
+export interface ReadmeAIConfig {
+    provider: 'anthropic' | 'openai' | 'gemini' | 'ollama';
+    model?: string;
+    anthropic_api_key?: string;
+    openai_api_key?: string;
+    gemini_api_key?: string;
+    ollama_url?: string;
+    github_token?: string;
+    default_theme?: string;
+    default_output?: string;
+}
+export declare const config: Conf<ReadmeAIConfig>;
+export declare function getAPIKey(provider: string): string | undefined;
+export declare function getGitHubToken(): string | undefined;
+export declare function getOllamaURL(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,MAAM,sBAOjB,CAAC;AAEH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW9D;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}