@ragul1233332/docpilot 0.1.0

package/dist/core/schemas.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+// ============================================================================
+// DocPilot — Zod Validation Schemas
+// ============================================================================
+const SectionConfigSchema = z.object({
+    id: z.string().min(1),
+    enabled: z.boolean().default(true),
+    order: z.number().int().min(0).max(999),
+    customTitle: z.string().optional(),
+    aiGenerated: z.boolean().default(false),
+});
+export const DocPilotConfigSchema = z.object({
+    version: z.literal('1').default('1'),
+    project: z.object({
+        name: z.string().default(''),
+        description: z.string().default(''),
+        type: z.enum(['auto', 'library', 'application', 'cli']).default('auto'),
+    }).default({}),
+    ai: z.object({
+        provider: z.enum(['openai', 'anthropic', 'template', 'auto']).default('auto'),
+        model: z.string().optional(),
+        temperature: z.number().min(0).max(2).default(0.3),
+    }).default({}),
+    readme: z.object({
+        outputPath: z.string().default('README.md'),
+        sections: z.array(SectionConfigSchema).default([]),
+        badges: z.boolean().default(true),
+        markers: z.boolean().default(true),
+    }).default({}),
+    sync: z.object({
+        enabled: z.boolean().default(true),
+        watchPaths: z.array(z.string()).default(['src/**', 'package.json', 'tsconfig.json']),
+        ignorePaths: z.array(z.string()).default(['node_modules', 'dist', '.git', 'coverage']),
+        debounceMs: z.number().int().min(100).max(30000).default(2000),
+    }).default({}),
+});
+export const AIConfigSchema = z.object({
+    provider: z.enum(['openai', 'anthropic', 'template', 'auto']).default('auto'),
+    apiKey: z.string().optional(),
+    model: z.string().optional(),
+    temperature: z.number().min(0).max(2).default(0.3),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/core/schemas.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,246 @@
+export interface ProjectContext {
+    rootPath: string;
+    packageJson: PackageJsonInfo | null;
+    gitInfo: GitInfo | null;
+    configFiles: ConfigFileInfo[];
+    envVars: EnvVarInfo[];
+    folderTree: FolderTreeNode | null;
+    scripts: ScriptInfo[];
+    detectedFrameworks: FrameworkInfo[];
+    routes: RouteInfo[];
+    dockerInfo: DockerInfo | null;
+    ciInfo: CiInfo | null;
+    rawScanResults: Map<string, ScanResult>;
+    scanTimestamp: Date;
+}
+export interface IScanner {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly priority: number;
+    readonly dependencies: string[];
+    isApplicable(context: PartialProjectContext): boolean | Promise<boolean>;
+    scan(context: ProjectContext): Promise<ScanResult>;
+}
+export type PartialProjectContext = Partial<ProjectContext>;
+export interface ScanResult {
+    scannerId: string;
+    data: unknown;
+    confidence: number;
+    timestamp: Date;
+    errors?: string[];
+}
+export interface ISectionGenerator {
+    readonly id: string;
+    readonly sectionTitle: string;
+    readonly headingLevel: number;
+    readonly order: number;
+    readonly scannerDependencies: string[];
+    readonly defaultEnabled: boolean;
+    readonly aiGenerated: boolean;
+    generate(context: ProjectContext, aiProvider?: IAIProvider | null): Promise<string>;
+    isApplicable(context: ProjectContext): boolean;
+}
+export interface IAIProvider {
+    readonly name: string;
+    readonly available: boolean;
+    generateText(request: AIGenerationRequest): Promise<AIGenerationResponse>;
+}
+export interface AIGenerationRequest {
+    systemPrompt: string;
+    userPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface AIGenerationResponse {
+    content: string;
+    finishReason: 'stop' | 'length' | 'error';
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+    };
+}
+export interface ReadmeSection {
+    id: string;
+    title: string;
+    headingLevel: number;
+    content: string;
+    raw: string;
+    startMarker: string;
+    endMarker: string;
+    hasMarkers: boolean;
+    order: number;
+    status: 'existing' | 'new' | 'modified' | 'removed' | 'unchanged';
+}
+export interface ReadmeDocument {
+    preamble: string;
+    sections: ReadmeSection[];
+    postamble: string;
+    rawContent: string;
+    hasDocpilotMarkers: boolean;
+}
+export interface SectionDiff {
+    sectionId: string;
+    status: 'unchanged' | 'regenerate' | 'insert' | 'remove';
+    reason: string;
+    oldContent?: string;
+    newContent?: string;
+}
+export interface ProjectSnapshot {
+    hash: string;
+    data: {
+        dependencies: Record<string, string>;
+        devDependencies: Record<string, string>;
+        envVars: string[];
+        apiRoutes: RouteInfo[];
+        files: string[];
+        gitInfo?: GitInfo;
+    };
+}
+export interface DocPilotConfig {
+    version: '1';
+    project: {
+        name: string;
+        description: string;
+        type: 'auto' | 'library' | 'application' | 'cli';
+    };
+    ai: {
+        provider: 'openai' | 'anthropic' | 'template' | 'auto';
+        model?: string;
+        temperature: number;
+    };
+    readme: {
+        outputPath: string;
+        sections: SectionConfig[];
+        badges: boolean;
+        markers: boolean;
+    };
+    sync: {
+        enabled: boolean;
+        watchPaths: string[];
+        ignorePaths: string[];
+        debounceMs: number;
+    };
+}
+export interface SectionConfig {
+    id: string;
+    enabled: boolean;
+    order: number;
+    customTitle?: string;
+    aiGenerated: boolean;
+}
+export interface FrameworkInfo {
+    name: string;
+    version?: string;
+    category: FrameworkCategory;
+    confidence: number;
+    evidence: string[];
+}
+export type FrameworkCategory = 'frontend-framework' | 'backend-framework' | 'meta-framework' | 'database' | 'orm' | 'auth' | 'payments' | 'styling' | 'state-management' | 'testing' | 'linting' | 'bundler' | 'runtime' | 'ui-library' | 'css-framework' | 'cloud' | 'ci-cd' | 'monitoring' | 'messaging' | 'language';
+export interface PackageJsonInfo {
+    name: string;
+    version: string;
+    description?: string;
+    private?: boolean;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    optionalDependencies: Record<string, string>;
+    scripts: Record<string, string>;
+    engines?: Record<string, string>;
+    license?: string;
+    author?: string;
+    repository?: string;
+}
+export interface GitInfo {
+    currentBranch: string;
+    totalCommits: number;
+    lastCommitDate?: string;
+    lastCommitMessage?: string;
+    recentCommits: GitCommit[];
+    contributors: string[];
+    repositoryUrl?: string;
+    isInitialized: boolean;
+}
+export interface GitCommit {
+    hash: string;
+    author: string;
+    date: Date;
+    message: string;
+    type?: 'feat' | 'fix' | 'chore' | 'docs' | 'refactor' | 'test' | 'style';
+}
+export interface EnvVarInfo {
+    name: string;
+    detectedValue?: string;
+    description?: string;
+    required: boolean;
+    source: 'env-file' | 'code-reference' | 'docker-compose';
+}
+export interface RouteInfo {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+    path: string;
+    handler?: string;
+    sourceFile?: string;
+}
+export interface ScriptInfo {
+    name: string;
+    command: string;
+    type: 'npm' | 'make' | 'pip' | 'custom';
+    description?: string;
+}
+export interface ConfigFileInfo {
+    path: string;
+    type: string;
+    detectedFeatures: string[];
+}
+export interface DockerInfo {
+    hasDockerfile: boolean;
+    hasDockerCompose: boolean;
+    services: string[];
+    baseImage?: string;
+}
+export interface CiInfo {
+    provider: 'github-actions' | 'gitlab-ci' | 'circle-ci' | 'travis' | 'jenkins' | 'other';
+    configPath: string;
+    detectedJobs: string[];
+}
+export interface FolderTreeNode {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    children?: FolderTreeNode[];
+}
+export interface AggregatedScanResult {
+    projectType: string;
+    frameworks: FrameworkInfo[];
+    dependencies: {
+        production: Array<{
+            name: string;
+            version: string;
+            category?: string;
+        }>;
+        development: Array<{
+            name: string;
+            version: string;
+            category?: string;
+        }>;
+        peer: Array<{
+            name: string;
+            version: string;
+        }>;
+        optional: Array<{
+            name: string;
+            version: string;
+        }>;
+    };
+    envVars: EnvVarInfo[];
+    scripts: ScriptInfo[];
+    folderTree: FolderTreeNode | null;
+    routes: RouteInfo[];
+    git: GitInfo | null;
+    configFiles: ConfigFileInfo[];
+    docker: DockerInfo | null;
+    ci: CiInfo | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// DocPilot — Core Type Definitions
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E"}

package/dist/generators/index.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectContext, IAIProvider, DocPilotConfig } from '../core/types.js';
+export declare function generateReadme(projectCtx: ProjectContext, config: DocPilotConfig, aiProvider?: IAIProvider | null): Promise<string>;
+export declare function writeReadme(readmeContent: string, outputPath: string): Promise<void>;
+export declare function updateReadmeFromDiff(readmePath: string, sectionsToUpdate: Array<{
+    id: string;
+    content: string;
+    title: string;
+}>, _config: DocPilotConfig): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAwB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAqC1G,wBAAsB,cAAc,CAClC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,cAAc,EACtB,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI,GAC9B,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAED,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACvE,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/generators/index.js

@@ -0,0 +1,181 @@
+import { createSection, assembleReadme, parseReadme, generateBadges } from '../utils/markdown.js';
+import { readFileSafe, writeFileSafe } from '../utils/files.js';
+import { createSpinner, logSuccess } from '../utils/logger.js';
+import { generateOverview } from './sections/overview.js';
+import { generateFeatures } from './sections/features.js';
+import { generateTechStack } from './sections/tech-stack.js';
+import { generateInstallation } from './sections/installation.js';
+import { generateFolderTree } from './sections/folder-tree.js';
+import { generateScripts } from './sections/scripts.js';
+import { generateEnvVars } from './sections/env-vars.js';
+import { generateApiDocs } from './sections/api-docs.js';
+import { generateDeployment } from './sections/deployment.js';
+import { generateContributing } from './sections/contributing.js';
+import { generateLicense } from './sections/license.js';
+// ============================================================================
+// DocPilot — README Generator Orchestrator
+// ============================================================================
+const SECTION_GENERATORS = {
+    'overview': generateOverview,
+    'features': generateFeatures,
+    'tech-stack': generateTechStack,
+    'installation': generateInstallation,
+    'folder-structure': generateFolderTree,
+    'scripts': generateScripts,
+    'env-vars': generateEnvVars,
+    'api-reference': generateApiDocs,
+    'deployment': generateDeployment,
+    'contributing': generateContributing,
+    'license': generateLicense,
+};
+export async function generateReadme(projectCtx, config, aiProvider) {
+    const spinner = createSpinner('Generating README...');
+    spinner.start();
+    const scanResult = aggregateScanResults(projectCtx);
+    // Determine which sections to include
+    const enabledSections = config.readme.sections
+        .filter(s => s.enabled)
+        .sort((a, b) => a.order - b.order);
+    const results = [];
+    for (const sectionConfig of enabledSections) {
+        const generator = SECTION_GENERATORS[sectionConfig.id];
+        if (!generator)
+            continue;
+        const sectionSpinner = createSpinner(`  Generating ${sectionConfig.id}...`);
+        sectionSpinner.start();
+        try {
+            const result = await generator({ scanResult, aiProvider, config: config }, projectCtx);
+            results.push(result);
+            sectionSpinner.succeed();
+        }
+        catch (error) {
+            sectionSpinner.fail();
+            const message = error instanceof Error ? error.message : String(error);
+            results.push({
+                id: sectionConfig.id,
+                title: sectionConfig.customTitle || sectionConfig.id,
+                content: `> Section generation failed: ${message}`,
+                order: sectionConfig.order,
+            });
+        }
+    }
+    // Build title and badges
+    const projectName = projectCtx.packageJson?.name || 'My Project';
+    const badges = config.readme.badges
+        ? generateBadges(scanResult.frameworks)
+        : '';
+    // Assemble README
+    const preamble = [
+        `# ${projectName}`,
+        '',
+        projectCtx.packageJson?.description || '',
+        '',
+        badges,
+        '',
+    ].filter(Boolean).join('\n');
+    // Check if README already exists and merge sections
+    let readmeDoc = parseReadme('');
+    for (const result of results.sort((a, b) => a.order - b.order)) {
+        const section = createSection(result.id, result.title, result.content);
+        readmeDoc.sections.push(section);
+    }
+    readmeDoc.preamble = preamble;
+    const fullReadme = assembleReadme(readmeDoc);
+    spinner.succeed();
+    return fullReadme;
+}
+export async function writeReadme(readmeContent, outputPath) {
+    await writeFileSafe(outputPath, readmeContent);
+    logSuccess(`README written to ${outputPath}`);
+}
+export async function updateReadmeFromDiff(readmePath, sectionsToUpdate, _config) {
+    const existingContent = await readFileSafe(readmePath);
+    const baseContent = existingContent || '# Project\n';
+    let doc = parseReadme(baseContent);
+    for (const update of sectionsToUpdate) {
+        const existing = doc.sections.find(s => s.id === update.id);
+        if (existing) {
+            existing.content = update.content;
+            existing.title = update.title;
+            existing.status = 'modified';
+        }
+        else {
+            const section = createSection(update.id, update.title, update.content);
+            doc.sections.push(section);
+        }
+    }
+    return assembleReadme(doc);
+}
+function aggregateScanResults(ctx) {
+    const frameworkData = ctx.rawScanResults.get('framework')?.data ?? { frameworks: [] };
+    const packageData = ctx.packageJson;
+    const envData = ctx.rawScanResults.get('env-vars')?.data ?? { envVars: [] };
+    const scriptData = ctx.rawScanResults.get('scripts')?.data ?? { scripts: [] };
+    const gitData = ctx.gitInfo;
+    const treeData = ctx.rawScanResults.get('folder-tree')?.data ?? { tree: null };
+    const configData = ctx.rawScanResults.get('config-file')?.data ?? { configFiles: [] };
+    const deps = packageData?.dependencies ?? {};
+    const devDeps = packageData?.devDependencies ?? {};
+    // Categorize production deps
+    const production = Object.entries(deps).map(([name, version]) => ({
+        name,
+        version,
+        category: categorizeDep(name),
+    }));
+    const development = Object.entries(devDeps).map(([name, version]) => ({
+        name,
+        version,
+        category: categorizeDep(name),
+    }));
+    const peer = Object.entries(packageData?.peerDependencies ?? {}).map(([name, version]) => ({ name, version }));
+    const optional = Object.entries(packageData?.optionalDependencies ?? {}).map(([name, version]) => ({ name, version }));
+    // Infer project type (exclude testing/linting/bundler/dev tools)
+    const frameworks = frameworkData.frameworks ?? [];
+    const projectFrameworks = frameworks.filter((f) => !['testing', 'linting', 'bundler', 'monitoring'].includes(f.category));
+    let projectType = 'Unknown';
+    if (projectFrameworks.some((f) => f.name === 'Next.js'))
+        projectType = 'Next.js Application';
+    else if (projectFrameworks.some((f) => f.name === 'Express'))
+        projectType = 'Express API';
+    else if (projectFrameworks.some((f) => f.name === 'React'))
+        projectType = 'React Application';
+    else if (projectFrameworks.some((f) => f.category === 'backend-framework'))
+        projectType = 'Backend Service';
+    else if (projectFrameworks.some((f) => f.category === 'frontend-framework'))
+        projectType = 'Frontend Application';
+    else if (projectFrameworks.length > 0)
+        projectType = `${projectFrameworks[0]?.name} Project`;
+    else if (frameworks.length > 0)
+        projectType = 'Software Project';
+    else if (packageData)
+        projectType = 'Node.js Package';
+    return {
+        projectType,
+        frameworks,
+        dependencies: { production, development, peer, optional },
+        envVars: envData.envVars ?? [],
+        scripts: scriptData.scripts ?? [],
+        folderTree: treeData.tree,
+        routes: ctx.routes,
+        git: gitData,
+        configFiles: configData.configFiles ?? [],
+        docker: ctx.dockerInfo,
+        ci: ctx.ciInfo,
+    };
+}
+function categorizeDep(name) {
+    const cats = {
+        react: 'frontend', vue: 'frontend', angular: 'frontend', svelte: 'frontend',
+        next: 'framework', express: 'backend', fastify: 'backend', koa: 'backend',
+        prisma: 'database', mongoose: 'database', sequelize: 'database',
+        zod: 'validation', joi: 'validation', yup: 'validation',
+        vitest: 'testing', jest: 'testing', mocha: 'testing', cypress: 'testing',
+        eslint: 'linting', prettier: 'formatting',
+        vite: 'bundler', webpack: 'bundler', rollup: 'bundler', esbuild: 'bundler',
+        axios: 'http', 'node-fetch': 'http', 'got': 'http',
+        stripe: 'payments', 'react-hook-form': 'forms', 'formik': 'forms',
+        datefns: 'utilities', 'lodash': 'utilities', 'dayjs': 'utilities',
+    };
+    return cats[name];
+}
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

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

package/dist/generators/sections/api-docs.d.ts

@@ -0,0 +1,3 @@
+import type { SectionContext, SectionResult } from './types.js';
+export declare function generateApiDocs(context: SectionContext, _projectCtx: any): Promise<SectionResult>;
+//# sourceMappingURL=api-docs.d.ts.map

package/dist/generators/sections/api-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs.d.ts","sourceRoot":"","sources":["../../../src/generators/sections/api-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhE,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,aAAa,CAAC,CAuCxB"}

package/dist/generators/sections/api-docs.js

@@ -0,0 +1,39 @@
+import { buildUserPrompt, SYSTEM_PROMPTS } from '../../ai/prompts.js';
+export async function generateApiDocs(context, _projectCtx) {
+    const { scanResult, aiProvider } = context;
+    const routes = scanResult.routes;
+    let content;
+    if (routes.length === 0) {
+        return {
+            id: 'api-reference',
+            title: 'API Reference',
+            content: 'No API routes detected.',
+            order: 80,
+        };
+    }
+    if (aiProvider?.available) {
+        const data = {
+            routes: routes.map(r => ({ method: r.method, path: r.path, handler: r.handler })),
+        };
+        const response = await aiProvider.generateText({
+            systemPrompt: SYSTEM_PROMPTS.apiReference ?? '',
+            userPrompt: buildUserPrompt('api-reference', data),
+            temperature: 0.2,
+        });
+        content = response.content;
+    }
+    else {
+        const table = ['| Method | Path | Description |', '|--------|------|-------------|'];
+        for (const route of routes) {
+            table.push(`| ${route.method} | \`${route.path}\` | ${route.handler || '-'} |`);
+        }
+        content = table.join('\n');
+    }
+    return {
+        id: 'api-reference',
+        title: 'API Reference',
+        content,
+        order: 80,
+    };
+}
+//# sourceMappingURL=api-docs.js.map

package/dist/generators/sections/api-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs.js","sourceRoot":"","sources":["../../../src/generators/sections/api-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,WAAgB;IAEhB,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IACjC,IAAI,OAAe,CAAC;IAEpB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,EAAE,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG;YACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SAClF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC;YAC7C,YAAY,EAAE,cAAc,CAAC,YAAY,IAAI,EAAE;YAC/C,UAAU,EAAE,eAAe,CAAC,eAAe,EAAE,IAA0C,CAAC;YACxF,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAa,CAAC,iCAAiC,EAAE,iCAAiC,CAAC,CAAC;QAC/F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,OAAO;QACP,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC"}

package/dist/generators/sections/contributing.d.ts

@@ -0,0 +1,3 @@
+import type { SectionContext, SectionResult } from './types.js';
+export declare function generateContributing(context: SectionContext, _projectCtx: any): Promise<SectionResult>;
+//# sourceMappingURL=contributing.d.ts.map

package/dist/generators/sections/contributing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributing.d.ts","sourceRoot":"","sources":["../../../src/generators/sections/contributing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhE,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,aAAa,CAAC,CAqBxB"}

package/dist/generators/sections/contributing.js

@@ -0,0 +1,24 @@
+import { buildFallbackContent } from '../../ai/prompts.js';
+import { buildUserPrompt, SYSTEM_PROMPTS } from '../../ai/prompts.js';
+export async function generateContributing(context, _projectCtx) {
+    const { aiProvider } = context;
+    let content;
+    if (aiProvider?.available) {
+        const response = await aiProvider.generateText({
+            systemPrompt: SYSTEM_PROMPTS.contributing ?? '',
+            userPrompt: buildUserPrompt('contributing', {}),
+            temperature: 0.3,
+        });
+        content = response.content;
+    }
+    else {
+        content = buildFallbackContent('contributing', {});
+    }
+    return {
+        id: 'contributing',
+        title: 'Contributing',
+        content,
+        order: 100,
+    };
+}
+//# sourceMappingURL=contributing.js.map

package/dist/generators/sections/contributing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributing.js","sourceRoot":"","sources":["../../../src/generators/sections/contributing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAuB,EACvB,WAAgB;IAEhB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC/B,IAAI,OAAe,CAAC;IAEpB,IAAI,UAAU,EAAE,SAAS,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC;YAC7C,YAAY,EAAE,cAAc,CAAC,YAAY,IAAI,EAAE;YAC/C,UAAU,EAAE,eAAe,CAAC,cAAc,EAAE,EAAE,CAAC;YAC/C,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,oBAAoB,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,OAAO;QACP,KAAK,EAAE,GAAG;KACX,CAAC;AACJ,CAAC"}

package/dist/generators/sections/deployment.d.ts

@@ -0,0 +1,3 @@
+import type { SectionContext, SectionResult } from './types.js';
+export declare function generateDeployment(context: SectionContext, _projectCtx: any): Promise<SectionResult>;
+//# sourceMappingURL=deployment.d.ts.map

package/dist/generators/sections/deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../../src/generators/sections/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,aAAa,CAAC,CAiCxB"}