@ragul1233332/docpilot 0.1.0

package/dist/cli/commands/score.js

@@ -0,0 +1,153 @@
+import path from 'node:path';
+import { loadConfig, setCachedConfig } from '../../config/index.js';
+import { readFileSafe } from '../../utils/files.js';
+import { logSection, logWarning, logInfo, formatKeyValue } from '../../utils/logger.js';
+// ============================================================================
+// DocPilot — `score` Command (README Quality Scoring)
+// ============================================================================
+export function registerScoreCommand(program) {
+    program
+        .command('score')
+        .description('Score README quality (0-100) and identify missing sections')
+        .action(async () => {
+        const cwd = process.cwd();
+        const config = await loadConfig(cwd);
+        setCachedConfig(config);
+        const readmePath = path.resolve(cwd, config.readme.outputPath);
+        const content = await readFileSafe(readmePath);
+        if (!content) {
+            logWarning('No README found to score.');
+            return;
+        }
+        const score = scoreReadme(content);
+        logSection('README Score');
+        const grade = score.total >= 90 ? 'A' : score.total >= 80 ? 'B' : score.total >= 70 ? 'C' : score.total >= 60 ? 'D' : 'F';
+        console.log(formatKeyValue('Overall Score', `${score.total}/100 (Grade: ${grade})`));
+        console.log('');
+        // Category scores
+        for (const category of score.categories) {
+            const icon = category.score >= 80 ? '✓' : category.score >= 50 ? '⚠' : '✗';
+            console.log(`  ${icon} ${category.name}: ${category.score}/100`);
+        }
+        // Missing sections
+        if (score.missing.length > 0) {
+            console.log('');
+            logWarning('Missing or incomplete:');
+            for (const item of score.missing) {
+                console.log(`  • ${item}`);
+            }
+        }
+        if (score.suggestions.length > 0) {
+            console.log('');
+            logInfo('Suggestions:');
+            for (const s of score.suggestions) {
+                console.log(`  • ${s}`);
+            }
+        }
+    });
+}
+export function scoreReadme(content) {
+    const categories = [];
+    const missing = [];
+    const suggestions = [];
+    const checks = [
+        {
+            name: 'Project Name & Description',
+            check: (c) => ({
+                score: c.includes('# ') ? 100 : 0,
+                missing: c.includes('# ') ? [] : ['Project title (#)'],
+                suggestions: [],
+            }),
+        },
+        {
+            name: 'Installation Guide',
+            check: (c) => ({
+                score: /install/i.test(c) ? 100 : 0,
+                missing: /install/i.test(c) ? [] : ['Installation section'],
+                suggestions: ['Add installation steps'],
+            }),
+        },
+        {
+            name: 'Usage Example',
+            check: (c) => ({
+                score: /usage|example|quick start|getting started/i.test(c) ? 100 : 0,
+                missing: /usage|example|quick start|getting started/i.test(c) ? [] : ['Usage examples'],
+                suggestions: ['Add usage examples or quick start guide'],
+            }),
+        },
+        {
+            name: 'API Documentation',
+            check: (c) => ({
+                score: /api|endpoint|route/i.test(c) ? 100 : 50,
+                missing: /api|endpoint|route/i.test(c) ? [] : ['API documentation'],
+                suggestions: ['Document API endpoints if applicable'],
+            }),
+        },
+        {
+            name: 'Environment Variables',
+            check: (c) => ({
+                score: /environment|env|\.env/i.test(c) ? 100 : 50,
+                missing: /environment|env|\.env/i.test(c) ? [] : ['Environment variables documentation'],
+                suggestions: ['Document required environment variables'],
+            }),
+        },
+        {
+            name: 'Contributing Guide',
+            check: (c) => ({
+                score: /contributing|contribute/i.test(c) ? 100 : 50,
+                missing: /contributing|contribute/i.test(c) ? [] : ['Contributing section'],
+                suggestions: ['Add a contributing guide'],
+            }),
+        },
+        {
+            name: 'License',
+            check: (c) => ({
+                score: /license|mit|apache|gpl/i.test(c) ? 100 : 50,
+                missing: /license|mit|apache|gpl/i.test(c) ? [] : ['License information'],
+                suggestions: ['Add license information'],
+            }),
+        },
+        {
+            name: 'Badges',
+            check: (c) => ({
+                score: /https:\/\/img\.shields\.io|badge/i.test(c) ? 100 : 50,
+                missing: /https:\/\/img\.shields\.io|badge/i.test(c) ? [] : ['Project badges'],
+                suggestions: ['Add badges (build status, version, license)'],
+            }),
+        },
+        {
+            name: 'Code Blocks',
+            check: (c) => {
+                const codeBlocks = (c.match(/```/g) || []).length / 2;
+                return {
+                    score: codeBlocks >= 2 ? 100 : codeBlocks >= 1 ? 60 : 0,
+                    missing: codeBlocks >= 1 ? [] : ['Code examples'],
+                    suggestions: ['Add code examples to illustrate usage'],
+                };
+            },
+        },
+        {
+            name: 'Table of Contents',
+            check: (c) => ({
+                score: /table of contents|toc|## .+[\s\S]*## /i.test(c) ? 100 : 50,
+                missing: /table of contents|toc/i.test(c) ? [] : ['Table of Contents (optional)'],
+                suggestions: ['Consider adding a table of contents for longer READMEs'],
+            }),
+        },
+    ];
+    for (const check of checks) {
+        const result = check.check(content);
+        const weight = 10; // each category contributes up to 10 points
+        categories.push({ name: check.name, score: result.score });
+        missing.push(...result.missing);
+        suggestions.push(...result.suggestions);
+    }
+    const total = Math.round(categories.reduce((sum, c) => sum + c.score, 0) / categories.length);
+    return {
+        total,
+        categories,
+        missing: [...new Set(missing)],
+        suggestions: [...new Set(suggestions)],
+    };
+}
+//# sourceMappingURL=score.js.map

package/dist/cli/commands/score.js.map

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

package/dist/cli/commands/suggest.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerSuggestCommand(program: Command): void;
+//# sourceMappingURL=suggest.d.ts.map

package/dist/cli/commands/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgC7D"}

package/dist/cli/commands/suggest.js

@@ -0,0 +1,72 @@
+import path from 'node:path';
+import { loadConfig, setCachedConfig } from '../../config/index.js';
+import { readFileSafe } from '../../utils/files.js';
+import { logSection, logInfo, formatKeyValue } from '../../utils/logger.js';
+// ============================================================================
+// DocPilot — `suggest` Command (AI Improvement Suggestions)
+// ============================================================================
+export function registerSuggestCommand(program) {
+    program
+        .command('suggest')
+        .description('Get AI-powered improvement suggestions for your README')
+        .action(async () => {
+        const cwd = process.cwd();
+        const config = await loadConfig(cwd);
+        setCachedConfig(config);
+        const readmePath = path.resolve(cwd, config.readme.outputPath);
+        const content = await readFileSafe(readmePath);
+        if (!content) {
+            logInfo('No README found to analyze.');
+            return;
+        }
+        logSection('README Improvement Suggestions');
+        const suggestions = analyzeReadme(content);
+        if (suggestions.length === 0) {
+            logInfo('Your README looks great! No major suggestions.');
+            return;
+        }
+        for (const suggestion of suggestions) {
+            console.log(formatKeyValue(suggestion.category, suggestion.suggestion));
+        }
+        console.log('');
+        logInfo('Tip: Use `docp generate --sections <section> --no-ai` to regenerate specific sections.');
+    });
+}
+function analyzeReadme(content) {
+    const suggestions = [];
+    if (!content.match(/#\s.+/)) {
+        suggestions.push({ category: 'Title', suggestion: 'Add a project title using # heading' });
+    }
+    if (!content.match(/##\s+(overview|introduction|about)/i)) {
+        suggestions.push({ category: 'Overview', suggestion: 'Add an Overview section explaining what the project does' });
+    }
+    if (!content.match(/##\s+(installation|setup|getting started)/i)) {
+        suggestions.push({ category: 'Installation', suggestion: 'Add Installation instructions for developers' });
+    }
+    if (!content.match(/##\s+(usage|examples|quick start)/i)) {
+        suggestions.push({ category: 'Usage', suggestion: 'Add Usage examples to help users get started quickly' });
+    }
+    if (!content.match(/##\s+(api|endpoints|reference)/i)) {
+        suggestions.push({ category: 'API Reference', suggestion: 'Document your API endpoints with request/response examples' });
+    }
+    if (!content.match(/##\s+(env|environment|configuration)/i)) {
+        suggestions.push({ category: 'Configuration', suggestion: 'List required environment variables and configuration options' });
+    }
+    if (!content.match(/##\s+(contributing|contribute)/i)) {
+        suggestions.push({ category: 'Contributing', suggestion: 'Add a Contributing guide to attract contributors' });
+    }
+    if (!content.match(/##\s+(license|mit|apache)/i)) {
+        suggestions.push({ category: 'License', suggestion: 'Specify the project license' });
+    }
+    if (!content.match(/https:\/\/img\.shields\.io|badge/i)) {
+        suggestions.push({ category: 'Badges', suggestion: 'Add status badges (CI, version, coverage) for credibility' });
+    }
+    if (!content.match(/```/)) {
+        suggestions.push({ category: 'Code Blocks', suggestion: 'Use code blocks (```) for commands and code examples' });
+    }
+    if (content.length < 300) {
+        suggestions.push({ category: 'Length', suggestion: 'Your README is very short. Consider adding more detail.' });
+    }
+    return suggestions;
+}
+//# sourceMappingURL=suggest.js.map

package/dist/cli/commands/suggest.js.map

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

package/dist/cli/commands/sync.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerSyncCommand(program: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cli/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqF1D"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,120 @@
+import path from 'node:path';
+import { loadConfig, setCachedConfig } from '../../config/index.js';
+import { DocPilotRegistry } from '../../core/registry.js';
+import { registerDefaultScanners } from '../../scanners/index.js';
+import { readFileSafe } from '../../utils/files.js';
+import { createSpinner, logSuccess, logInfo } from '../../utils/logger.js';
+import { generateTechStack } from '../../generators/sections/tech-stack.js';
+import { generateEnvVars } from '../../generators/sections/env-vars.js';
+import { writeFileSafe } from '../../utils/files.js';
+import { resolveAIProvider } from '../../ai/provider.js';
+import { parseReadme, updateSectionInReadme } from '../../utils/markdown.js';
+// ============================================================================
+// DocPilot — `sync` Command
+// ============================================================================
+export function registerSyncCommand(program) {
+    program
+        .command('sync')
+        .description('Sync README with current project state (update sections that changed)')
+        .option('--dry-run', 'Show what would change without making changes', false)
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const config = await loadConfig(cwd);
+        setCachedConfig(config);
+        const aiProvider = await resolveAIProvider();
+        // Scan project
+        const spinner = createSpinner('Scanning project...');
+        spinner.start();
+        const registry = new DocPilotRegistry();
+        registerDefaultScanners(registry);
+        const projectCtx = await buildProjectContext(cwd);
+        await registry.runScanners(projectCtx);
+        spinner.succeed('Scan complete');
+        // Read existing README
+        const readmePath = path.resolve(cwd, config.readme.outputPath);
+        const existingContent = await readFileSafe(readmePath);
+        if (!existingContent) {
+            logInfo('No existing README found. Run `docp generate` to create one.');
+            return;
+        }
+        // Parse existing README into sections
+        const doc = parseReadme(existingContent);
+        const scanResult = aggregateForSync(projectCtx);
+        if (!doc.hasDocpilotMarkers) {
+            logInfo('README does not have DocPilot markers. Run `docp generate` to add them.');
+            return;
+        }
+        // Find sections that need updating
+        const sectionsToUpdate = [];
+        const techStackSection = doc.sections.find(s => s.id === 'tech-stack');
+        if (techStackSection) {
+            const newContent = await generateTechStack({ scanResult, aiProvider, config: config }, projectCtx);
+            sectionsToUpdate.push({ id: 'tech-stack', content: newContent.content, title: 'Tech Stack' });
+        }
+        const envSection = doc.sections.find(s => s.id === 'env-vars');
+        if (envSection) {
+            const newContent = await generateEnvVars({ scanResult, aiProvider, config: config }, projectCtx);
+            sectionsToUpdate.push({ id: 'env-vars', content: newContent.content, title: 'Environment Variables' });
+        }
+        if (sectionsToUpdate.length === 0) {
+            logInfo('No sections need updating. README is up to date.');
+            return;
+        }
+        // Apply updates
+        let updatedContent = existingContent;
+        for (const update of sectionsToUpdate) {
+            updatedContent = updateSectionInReadme(updatedContent, update.id, update.content);
+        }
+        if (options.dryRun) {
+            logInfo('Dry run — changes would be:');
+            for (const update of sectionsToUpdate) {
+                logInfo(`  Update "${update.id}" section`);
+            }
+            return;
+        }
+        await writeFileSafe(readmePath, updatedContent);
+        logSuccess(`README synced — ${sectionsToUpdate.length} section(s) updated`);
+    });
+}
+async function buildProjectContext(rootPath) {
+    const pkgContent = await readFileSafe(path.join(rootPath, 'package.json'));
+    let packageJson = null;
+    if (pkgContent) {
+        try {
+            packageJson = JSON.parse(pkgContent);
+        }
+        catch { /* ignore */ }
+    }
+    return {
+        rootPath,
+        packageJson,
+        gitInfo: null,
+        configFiles: [],
+        envVars: [],
+        folderTree: null,
+        scripts: [],
+        detectedFrameworks: [],
+        routes: [],
+        dockerInfo: null,
+        ciInfo: null,
+        rawScanResults: new Map(),
+        scanTimestamp: new Date(),
+    };
+}
+function aggregateForSync(ctx) {
+    const frameworkData = ctx.rawScanResults.get('framework')?.data ?? { frameworks: [] };
+    return {
+        projectType: 'Unknown',
+        frameworks: frameworkData.frameworks ?? [],
+        dependencies: { production: [], development: [], peer: [], optional: [] },
+        envVars: [],
+        scripts: [],
+        folderTree: null,
+        routes: [],
+        git: null,
+        configFiles: [],
+        docker: null,
+        ci: null,
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/commands/sync.js.map

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

package/dist/cli/commands/watch.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerWatchCommand(program: Command): void;
+//# sourceMappingURL=watch.d.ts.map

package/dist/cli/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D3D"}

package/dist/cli/commands/watch.js

@@ -0,0 +1,63 @@
+import path from 'node:path';
+import chokidar from 'chokidar';
+import { execa } from 'execa';
+import { loadConfig, setCachedConfig } from '../../config/index.js';
+import { logInfo, logSection } from '../../utils/logger.js';
+// ============================================================================
+// DocPilot — `watch` Command
+// ============================================================================
+export function registerWatchCommand(program) {
+    program
+        .command('watch')
+        .description('Watch project for changes and auto-update README')
+        .option('--debounce <ms>', 'Debounce interval in milliseconds', (v) => parseInt(v), 2000)
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const config = await loadConfig(cwd);
+        setCachedConfig(config);
+        const debounceMs = options.debounce ?? config.sync.debounceMs;
+        const watchPaths = config.sync.watchPaths.map(p => path.resolve(cwd, p));
+        const ignorePaths = config.sync.ignorePaths.map(p => `**/${p}/**`);
+        logSection('DocPilot Watch Mode');
+        logInfo(`Watching for changes in ${cwd}`);
+        logInfo(`Debounce: ${debounceMs}ms`);
+        logInfo('Press Ctrl+C to stop');
+        console.log('');
+        // Debounce mechanism
+        let timeoutId = null;
+        const watcher = chokidar.watch(watchPaths, {
+            ignored: [...ignorePaths, '**/node_modules/**', '**/.git/**', '**/dist/**'],
+            persistent: true,
+            ignoreInitial: true,
+        });
+        watcher.on('change', async (filePath) => {
+            const relativePath = path.relative(cwd, filePath);
+            logInfo(`Change detected: ${relativePath}`);
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            timeoutId = setTimeout(async () => {
+                logInfo('Syncing README...');
+                try {
+                    await execa('npx', ['docp', 'sync'], { cwd, stdio: 'inherit' });
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    logInfo(`Sync error: ${message}`);
+                }
+            }, debounceMs);
+        });
+        watcher.on('error', (error) => {
+            const msg = error instanceof Error ? error.message : String(error);
+            logInfo(`Watch error: ${msg}`);
+        });
+        // Handle process exit
+        process.on('SIGINT', () => {
+            logInfo('Stopping watch mode...');
+            watcher.close();
+            process.exit(0);
+        });
+        // Keep the process alive
+        await new Promise(() => { });
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/commands/watch.js.map

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

package/dist/cli/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAeA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB5C"}

package/dist/cli/index.js

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+// ============================================================================
+// DocPilot — CLI Program Definition
+// ============================================================================
+import { registerScanCommand } from './commands/scan.js';
+import { registerGenerateCommand } from './commands/generate.js';
+import { registerSyncCommand } from './commands/sync.js';
+import { registerDoctorCommand } from './commands/doctor.js';
+import { registerScoreCommand } from './commands/score.js';
+import { registerSuggestCommand } from './commands/suggest.js';
+import { registerChangelogCommand } from './commands/changelog.js';
+import { registerWatchCommand } from './commands/watch.js';
+export async function runCLI() {
+    const program = new Command();
+    program
+        .name('docp')
+        .description('AI-powered README Engineering Toolkit')
+        .version('0.1.0')
+        .option('--debug', 'Enable debug output', false);
+    // Register all commands
+    registerScanCommand(program);
+    registerGenerateCommand(program);
+    registerSyncCommand(program);
+    registerDoctorCommand(program);
+    registerScoreCommand(program);
+    registerSuggestCommand(program);
+    registerChangelogCommand(program);
+    registerWatchCommand(program);
+    // Show help if no command given
+    if (process.argv.length < 3) {
+        program.help();
+    }
+    await program.parseAsync(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,uCAAuC,CAAC;SACpD,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,SAAS,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAEnD,wBAAwB;IACxB,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE9B,gCAAgC;IAChC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+import type { DocPilotConfig } from '../core/types.js';
+export declare function loadConfig(cwd: string): Promise<DocPilotConfig>;
+export declare function getCachedConfig(): DocPilotConfig;
+export declare function setCachedConfig(config: DocPilotConfig): void;
+export declare function initConfig(cwd: string): Promise<string>;
+export declare function resolveAIProviderFromEnv(): 'openai' | 'anthropic' | 'template' | 'auto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAUvD,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAarE;AAED,wBAAgB,eAAe,IAAI,cAAc,CAGhD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE5D;AA0BD,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7D;AAED,wBAAgB,wBAAwB,IAAI,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAOvF"}

package/dist/config/index.js

@@ -0,0 +1,76 @@
+import path from 'node:path';
+import { DEFAULT_CONFIG } from '../core/constants.js';
+import { DocPilotConfigSchema } from '../core/schemas.js';
+import { ConfigError } from '../core/errors.js';
+import { findConfigFile, readJsonSafe, writeFileSafe } from '../utils/files.js';
+// ============================================================================
+// DocPilot — Configuration Management
+// ============================================================================
+let cachedConfig = null;
+export async function loadConfig(cwd) {
+    const configPath = await findConfigFile(cwd);
+    if (!configPath) {
+        return mergeConfig(DEFAULT_CONFIG, {});
+    }
+    const rawConfig = await readJsonSafe(configPath);
+    if (!rawConfig) {
+        throw new ConfigError(`Invalid config file at ${configPath}`);
+    }
+    return mergeConfig(DEFAULT_CONFIG, rawConfig);
+}
+export function getCachedConfig() {
+    if (!cachedConfig)
+        throw new ConfigError('Config not loaded. Call loadConfig() first.');
+    return cachedConfig;
+}
+export function setCachedConfig(config) {
+    cachedConfig = config;
+}
+function mergeConfig(defaults, overrides) {
+    const merged = {
+        ...defaults,
+        ...overrides,
+        project: { ...defaults.project, ...(overrides.project ?? {}) },
+        ai: { ...defaults.ai, ...(overrides.ai ?? {}) },
+        readme: {
+            ...defaults.readme,
+            ...(overrides.readme ?? {}),
+            sections: overrides.readme?.sections
+                ? overrides.readme.sections
+                : defaults.readme.sections,
+        },
+        sync: { ...defaults.sync, ...(overrides.sync ?? {}) },
+    };
+    const parsed = DocPilotConfigSchema.safeParse(merged);
+    if (!parsed.success) {
+        throw new ConfigError(`Config validation failed: ${parsed.error.message}`);
+    }
+    return parsed.data;
+}
+export async function initConfig(cwd) {
+    const configPath = path.join(cwd, '.docpilotrc.json');
+    const config = {
+        ...DEFAULT_CONFIG,
+        project: {
+            name: path.basename(cwd),
+            description: '',
+            type: 'auto',
+        },
+    };
+    await writeFileSafe(configPath, JSON.stringify(config, null, 2));
+    return configPath;
+}
+export function resolveAIProviderFromEnv() {
+    if (process.env.DOCPILOT_AI_PROVIDER === 'anthropic')
+        return 'anthropic';
+    if (process.env.DOCPILOT_AI_PROVIDER === 'openai')
+        return 'openai';
+    if (process.env.DOCPILOT_AI_PROVIDER === 'template')
+        return 'template';
+    if (process.env.ANTHROPIC_API_KEY || process.env.DOCPILOT_ANTHROPIC_API_KEY)
+        return 'anthropic';
+    if (process.env.OPENAI_API_KEY || process.env.DOCPILOT_OPENAI_API_KEY)
+        return 'openai';
+    return 'template';
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,22 @@
+import type { SectionConfig, DocPilotConfig } from './types.js';
+export declare const CLI_NAME = "docp";
+export declare const CLI_FULL_NAME = "docpilot";
+export declare const MARKER_PREFIX = "docpilot";
+export declare const DEFAULT_OUTPUT_PATH = "README.md";
+export declare const SECTION_DEFINITIONS: SectionDefinition[];
+export interface SectionDefinition {
+    id: string;
+    title: string;
+    level: number;
+    order: number;
+    defaultEnabled: boolean;
+    aiGenerated: boolean;
+}
+export declare const DEFAULT_SECTIONS: SectionConfig[];
+export declare const DEFAULT_CONFIG: DocPilotConfig;
+export declare const IGNORE_DIRS: Set<string>;
+export declare const FRAMEWORK_PATTERNS: Record<string, {
+    category: string;
+    name: string;
+}>;
+//# sourceMappingURL=constants.d.ts.map