autogit-tool 1.0.0

package/dist/services/insights.js

@@ -0,0 +1,140 @@
+import { getProvider } from '../ai/provider.js';
+import { insightsPrompt } from '../ai/prompts.js';
+import { logger, spinner } from '../utils/logger.js';
+export async function generateInsights(analysis, scan, useAI) {
+    if (useAI) {
+        const spin = spinner('Analyzing project insights...').start();
+        try {
+            const provider = getProvider();
+            const prompt = insightsPrompt(analysis);
+            const messages = [
+                { role: 'system', content: 'You are a senior software engineer providing constructive project analysis. Always return valid JSON.' },
+                { role: 'user', content: prompt },
+            ];
+            const response = await provider.generate(messages, { temperature: 0.3 });
+            let content = response.content.trim();
+            // Strip markdown fencing
+            if (content.startsWith('```json')) {
+                content = content.slice(7);
+            }
+            else if (content.startsWith('```')) {
+                content = content.slice(3);
+            }
+            if (content.endsWith('```')) {
+                content = content.slice(0, -3);
+            }
+            const data = JSON.parse(content.trim());
+            spin.succeed('Project insights generated');
+            return {
+                documentationScore: data.documentation_score || { score: 5, reason: 'Unable to assess' },
+                codeQualityScore: data.code_quality_score || { score: 5, reason: 'Unable to assess' },
+                maintainabilityScore: data.maintainability_score || { score: 5, reason: 'Unable to assess' },
+                suggestions: data.suggestions || [],
+                performanceRecommendations: data.performance_recommendations || [],
+                securityObservations: data.security_observations || [],
+                missingTests: data.missing_tests || [],
+                missingDocumentation: data.missing_documentation || [],
+                todoSummary: data.todo_summary || [],
+            };
+        }
+        catch (error) {
+            spin.fail('AI insights generation failed');
+            logger.warn(`Using static analysis: ${error.message}`);
+        }
+    }
+    // Static analysis fallback
+    return generateStaticInsights(analysis, scan);
+}
+function generateStaticInsights(analysis, scan) {
+    const insights = {
+        documentationScore: { score: 0, reason: '' },
+        codeQualityScore: { score: 0, reason: '' },
+        maintainabilityScore: { score: 0, reason: '' },
+        suggestions: [],
+        performanceRecommendations: [],
+        securityObservations: [],
+        missingTests: [],
+        missingDocumentation: [],
+        todoSummary: [],
+    };
+    // Documentation score
+    let docScore = 0;
+    if (analysis.hasReadme)
+        docScore += 3;
+    if (scan.files.some(f => f.name === 'CONTRIBUTING.md'))
+        docScore += 2;
+    if (scan.files.some(f => f.name === 'CHANGELOG.md'))
+        docScore += 2;
+    if (analysis.license)
+        docScore += 1;
+    if (analysis.envVars.length > 0)
+        docScore += 1;
+    if (scan.files.some(f => f.name.includes('API')))
+        docScore += 1;
+    insights.documentationScore = {
+        score: Math.min(docScore, 10),
+        reason: docScore >= 7 ? 'Well documented' : docScore >= 4 ? 'Basic documentation present' : 'Needs more documentation',
+    };
+    // Code quality score (based on tooling)
+    let qualityScore = 5; // base
+    if (analysis.testFramework)
+        qualityScore += 2;
+    if (analysis.cicd.length > 0)
+        qualityScore += 1;
+    if (scan.files.some(f => f.name.includes('lint') || f.name.includes('eslint') || f.name.includes('prettier')))
+        qualityScore += 1;
+    if (scan.files.some(f => f.name.includes('.editorconfig')))
+        qualityScore += 1;
+    insights.codeQualityScore = {
+        score: Math.min(qualityScore, 10),
+        reason: qualityScore >= 8 ? 'Strong quality tooling' : qualityScore >= 5 ? 'Adequate' : 'Consider adding linting and tests',
+    };
+    // Maintainability
+    let maintScore = 5;
+    if (analysis.architecture !== 'unknown')
+        maintScore += 1;
+    if (scan.directories.length > 3)
+        maintScore += 1; // structured project
+    if (analysis.buildSystem)
+        maintScore += 1;
+    const avgFileSize = scan.totalSize / Math.max(scan.totalFiles, 1);
+    if (avgFileSize < 10000)
+        maintScore += 1; // small files
+    if (analysis.languages.length <= 3)
+        maintScore += 1; // focused tech stack
+    insights.maintainabilityScore = {
+        score: Math.min(maintScore, 10),
+        reason: maintScore >= 8 ? 'Highly maintainable' : maintScore >= 5 ? 'Moderate maintainability' : 'Consider restructuring',
+    };
+    // Suggestions
+    if (!analysis.hasReadme)
+        insights.suggestions.push('Add a README.md');
+    if (!analysis.testFramework)
+        insights.suggestions.push('Add a testing framework');
+    if (analysis.cicd.length === 0)
+        insights.suggestions.push('Set up CI/CD pipeline');
+    if (!analysis.license)
+        insights.suggestions.push('Add a LICENSE file');
+    if (analysis.envVars.length > 0 && !scan.files.some(f => f.name === '.env.example')) {
+        insights.suggestions.push('Add .env.example for environment variable documentation');
+    }
+    // Missing documentation
+    if (!analysis.hasReadme)
+        insights.missingDocumentation.push('README.md');
+    if (!scan.files.some(f => f.name === 'CONTRIBUTING.md'))
+        insights.missingDocumentation.push('CONTRIBUTING.md');
+    if (!scan.files.some(f => f.name === 'CHANGELOG.md'))
+        insights.missingDocumentation.push('CHANGELOG.md');
+    if (analysis.apis.length > 0 && !scan.files.some(f => f.name.includes('API'))) {
+        insights.missingDocumentation.push('API documentation');
+    }
+    // Security
+    if (scan.files.some(f => f.name === '.env')) {
+        insights.securityObservations.push('Ensure .env is in .gitignore');
+    }
+    if (!scan.files.some(f => f.name === '.gitignore')) {
+        insights.securityObservations.push('Add .gitignore to prevent committing sensitive files');
+    }
+    return insights;
+}
+//# sourceMappingURL=insights.js.map

package/dist/services/insights.js.map

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

package/dist/services/readme-manager.d.ts

@@ -0,0 +1,11 @@
+import type { ProjectAnalysis } from '../scanner/project-analyzer.js';
+export interface ReadmeResult {
+    content: string;
+    isNew: boolean;
+    diff: string | null;
+    path: string;
+}
+export declare function generateReadme(rootDir: string, analysis: ProjectAnalysis, useAI: boolean): Promise<ReadmeResult>;
+export declare function writeReadme(result: ReadmeResult): void;
+export declare function displayDiff(diff: string): void;
+//# sourceMappingURL=readme-manager.d.ts.map

package/dist/services/readme-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-manager.d.ts","sourceRoot":"","sources":["../../src/services/readme-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKtE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAyDvB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAa9C"}

package/dist/services/readme-manager.js

@@ -0,0 +1,180 @@
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { createPatch } from 'diff';
+import chalk from 'chalk';
+import { getProvider } from '../ai/provider.js';
+import { readmeGenerationPrompt } from '../ai/prompts.js';
+import { logger, spinner } from '../utils/logger.js';
+export async function generateReadme(rootDir, analysis, useAI) {
+    const readmePath = analysis.readmePath || join(rootDir, 'README.md');
+    const existingContent = existsSync(readmePath) ? readFileSync(readmePath, 'utf-8') : null;
+    let newContent;
+    if (useAI) {
+        const spin = spinner('Generating README with AI...').start();
+        try {
+            const provider = getProvider();
+            const prompt = readmeGenerationPrompt(analysis, existingContent || undefined);
+            const messages = [
+                { role: 'system', content: 'You are a professional technical documentation writer.' },
+                { role: 'user', content: prompt },
+            ];
+            const response = await provider.generate(messages, { temperature: 0.5 });
+            newContent = response.content.trim();
+            // Clean up any markdown fencing the AI might have added
+            if (newContent.startsWith('```markdown')) {
+                newContent = newContent.slice('```markdown'.length);
+            }
+            if (newContent.startsWith('```md')) {
+                newContent = newContent.slice('```md'.length);
+            }
+            if (newContent.startsWith('```')) {
+                newContent = newContent.slice(3);
+            }
+            if (newContent.endsWith('```')) {
+                newContent = newContent.slice(0, -3);
+            }
+            newContent = newContent.trim();
+            spin.succeed('README generated with AI');
+        }
+        catch (error) {
+            spin.fail('AI generation failed');
+            logger.warn(`Falling back to template: ${error.message}`);
+            newContent = generateTemplateReadme(analysis);
+        }
+    }
+    else {
+        newContent = generateTemplateReadme(analysis);
+    }
+    // Generate diff
+    let diff = null;
+    if (existingContent) {
+        diff = createPatch('README.md', existingContent, newContent, 'existing', 'proposed');
+    }
+    return {
+        content: newContent,
+        isNew: !existingContent,
+        diff,
+        path: readmePath,
+    };
+}
+export function writeReadme(result) {
+    writeFileSync(result.path, result.content, 'utf-8');
+}
+export function displayDiff(diff) {
+    const lines = diff.split('\n');
+    for (const line of lines) {
+        if (line.startsWith('+') && !line.startsWith('+++')) {
+            console.log(chalk.green(line));
+        }
+        else if (line.startsWith('-') && !line.startsWith('---')) {
+            console.log(chalk.red(line));
+        }
+        else if (line.startsWith('@@')) {
+            console.log(chalk.cyan(line));
+        }
+        else {
+            console.log(chalk.gray(line));
+        }
+    }
+}
+function generateTemplateReadme(analysis) {
+    const sections = [];
+    // Title
+    sections.push(`# ${analysis.name}\n`);
+    // Description
+    if (analysis.description) {
+        sections.push(`${analysis.description}\n`);
+    }
+    // Tech Stack
+    const techStack = [];
+    if (analysis.languages.length)
+        techStack.push(...analysis.languages);
+    if (analysis.frameworks.length)
+        techStack.push(...analysis.frameworks);
+    if (techStack.length) {
+        sections.push(`## Tech Stack\n`);
+        sections.push(techStack.map(t => `- ${t}`).join('\n') + '\n');
+    }
+    // Features
+    if (analysis.features.length) {
+        sections.push(`## Features\n`);
+        sections.push(analysis.features.map(f => `- ${f}`).join('\n') + '\n');
+    }
+    // Installation
+    sections.push(`## Installation\n`);
+    if (analysis.packageManager === 'npm' || analysis.packageManager === 'yarn' || analysis.packageManager === 'pnpm' || analysis.packageManager === 'bun') {
+        const pm = analysis.packageManager;
+        const installCmd = pm === 'yarn' ? 'yarn' : pm === 'pnpm' ? 'pnpm install' : pm === 'bun' ? 'bun install' : 'npm install';
+        sections.push('```bash');
+        sections.push(`# Clone the repository`);
+        sections.push(`git clone https://github.com/USERNAME/${analysis.name}.git`);
+        sections.push(`cd ${analysis.name}`);
+        sections.push('');
+        sections.push(`# Install dependencies`);
+        sections.push(installCmd);
+        sections.push('```\n');
+    }
+    else if (analysis.packageManager === 'cargo') {
+        sections.push('```bash');
+        sections.push(`git clone https://github.com/USERNAME/${analysis.name}.git`);
+        sections.push(`cd ${analysis.name}`);
+        sections.push(`cargo build --release`);
+        sections.push('```\n');
+    }
+    else if (analysis.packageManager?.includes('pip')) {
+        sections.push('```bash');
+        sections.push(`git clone https://github.com/USERNAME/${analysis.name}.git`);
+        sections.push(`cd ${analysis.name}`);
+        sections.push(`pip install -r requirements.txt`);
+        sections.push('```\n');
+    }
+    else {
+        sections.push('```bash');
+        sections.push(`git clone https://github.com/USERNAME/${analysis.name}.git`);
+        sections.push(`cd ${analysis.name}`);
+        sections.push('```\n');
+    }
+    // Environment Variables
+    if (analysis.envVars.length) {
+        sections.push(`## Configuration\n`);
+        sections.push('Create a `.env` file in the root directory:\n');
+        sections.push('```env');
+        for (const v of analysis.envVars) {
+            sections.push(`${v}=`);
+        }
+        sections.push('```\n');
+    }
+    // Usage
+    sections.push(`## Usage\n`);
+    if (analysis.packageManager === 'npm') {
+        sections.push('```bash\nnpm start\n```\n');
+    }
+    else if (analysis.packageManager === 'yarn') {
+        sections.push('```bash\nyarn start\n```\n');
+    }
+    else if (analysis.packageManager === 'pnpm') {
+        sections.push('```bash\npnpm start\n```\n');
+    }
+    else if (analysis.packageManager === 'bun') {
+        sections.push('```bash\nbun start\n```\n');
+    }
+    else if (analysis.packageManager === 'cargo') {
+        sections.push('```bash\ncargo run\n```\n');
+    }
+    else if (analysis.packageManager?.includes('pip')) {
+        sections.push('```bash\npython main.py\n```\n');
+    }
+    else {
+        sections.push('*Add usage instructions here.*\n');
+    }
+    // Contributing
+    sections.push(`## Contributing\n`);
+    sections.push(`Contributions are welcome! Please feel free to submit a Pull Request.\n`);
+    // License
+    if (analysis.license) {
+        sections.push(`## License\n`);
+        sections.push(`This project is licensed under the ${analysis.license} License.\n`);
+    }
+    return sections.join('\n');
+}
+//# sourceMappingURL=readme-manager.js.map

package/dist/services/readme-manager.js.map

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

package/dist/services/resume-manager.d.ts

@@ -0,0 +1,29 @@
+import type { ProjectAnalysis } from '../scanner/project-analyzer.js';
+export interface ResumeConfig {
+    path: string;
+    ownerName: string;
+    ownerEmail: string;
+}
+export interface ResumeUpdateResult {
+    updated: boolean;
+    newEntry: string;
+    backupPath?: string;
+}
+/**
+ * Generate a LaTeX project entry from project analysis.
+ * Returns the full \resumeProjectHeading + \resumeItemListStart/End block.
+ */
+export declare function generateLatexProjectEntry(analysis: ProjectAnalysis, useAI: boolean, ownerName: string): Promise<string>;
+/**
+ * Update a LaTeX resume by inserting a new project entry into the Projects section.
+ * Creates a backup before modifying.
+ */
+export declare function updateLatexResume(resumePath: string, newProjectEntry: string): ResumeUpdateResult;
+/**
+ * Export resume PDF (if pdflatex is available) to ~/Documents/resume/
+ */
+export declare function exportResumePDF(texPath: string): Promise<{
+    exported: boolean;
+    pdfPath?: string;
+}>;
+//# sourceMappingURL=resume-manager.d.ts.map

package/dist/services/resume-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-manager.d.ts","sourceRoot":"","sources":["../../src/services/resume-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAItE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,kBAAkB,CAyCpB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2CvG"}

package/dist/services/resume-manager.js

@@ -0,0 +1,186 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { getProvider } from '../ai/provider.js';
+import { logger, spinner } from '../utils/logger.js';
+/**
+ * Generate a LaTeX project entry from project analysis.
+ * Returns the full \resumeProjectHeading + \resumeItemListStart/End block.
+ */
+export async function generateLatexProjectEntry(analysis, useAI, ownerName) {
+    if (!useAI) {
+        return generateTemplateEntry(analysis);
+    }
+    const spin = spinner('Generating resume entry with AI...').start();
+    try {
+        const provider = getProvider();
+        const prompt = buildResumePrompt(analysis, ownerName);
+        const messages = [
+            { role: 'system', content: 'You are a professional resume writer specializing in technical resumes for software engineers.' },
+            { role: 'user', content: prompt },
+        ];
+        const response = await provider.generate(messages, { temperature: 0.6, maxTokens: 800 });
+        let entry = response.content.trim();
+        // Strip markdown fencing if present
+        entry = entry.replace(/^```(?:latex|tex)?\n?/i, '').replace(/\n?```$/i, '').trim();
+        spin.succeed('Resume entry generated');
+        return entry;
+    }
+    catch (error) {
+        spin.fail('AI generation failed');
+        logger.warn(`Falling back to template: ${error.message}`);
+        return generateTemplateEntry(analysis);
+    }
+}
+/**
+ * Update a LaTeX resume by inserting a new project entry into the Projects section.
+ * Creates a backup before modifying.
+ */
+export function updateLatexResume(resumePath, newProjectEntry) {
+    if (!existsSync(resumePath)) {
+        throw new Error(`Resume file not found: ${resumePath}`);
+    }
+    const content = readFileSync(resumePath, 'utf-8');
+    // Find the Projects section
+    const projectsSectionMatch = content.match(/\\section\{Projects\}([\s\S]*?)(?=\\section\{|\\end\{document\})/i);
+    if (!projectsSectionMatch) {
+        throw new Error('Could not find \\section{Projects} in resume');
+    }
+    const projectsSection = projectsSectionMatch[0];
+    const projectsStart = projectsSectionMatch.index;
+    // Find the \resumeSubHeadingListStart after Projects section
+    const listStartMatch = projectsSection.match(/\\resumeSubHeadingListStart/);
+    if (!listStartMatch) {
+        throw new Error('Could not find \\resumeSubHeadingListStart in Projects section');
+    }
+    // Insert the new entry right after \resumeSubHeadingListStart
+    const insertPos = projectsStart + listStartMatch.index + listStartMatch[0].length;
+    const updatedContent = content.slice(0, insertPos) +
+        '\n\n' + newProjectEntry +
+        content.slice(insertPos);
+    // Create backup
+    const backupPath = resumePath.replace(/\.tex$/i, `.backup-${Date.now()}.tex`);
+    writeFileSync(backupPath, content, 'utf-8');
+    // Write updated resume
+    writeFileSync(resumePath, updatedContent, 'utf-8');
+    return {
+        updated: true,
+        newEntry: newProjectEntry,
+        backupPath,
+    };
+}
+/**
+ * Export resume PDF (if pdflatex is available) to ~/Documents/resume/
+ */
+export async function exportResumePDF(texPath) {
+    const docsDir = join(homedir(), 'Documents', 'resume');
+    if (!existsSync(docsDir)) {
+        mkdirSync(docsDir, { recursive: true });
+    }
+    // Check if pdflatex is available
+    try {
+        const { execSync } = await import('child_process');
+        execSync('pdflatex --version', { stdio: 'ignore' });
+    }
+    catch {
+        return { exported: false };
+    }
+    // Compile LaTeX to PDF in the resume directory
+    const texDir = dirname(texPath);
+    const texBasename = texPath.split(/[/\\]/).pop().replace(/\.tex$/i, '');
+    try {
+        const { execSync } = await import('child_process');
+        // Run pdflatex twice (for proper references)
+        execSync(`pdflatex -interaction=nonstopmode "${texBasename}.tex"`, {
+            cwd: texDir,
+            stdio: 'ignore',
+        });
+        execSync(`pdflatex -interaction=nonstopmode "${texBasename}.tex"`, {
+            cwd: texDir,
+            stdio: 'ignore',
+        });
+        // Copy PDF to Documents/resume
+        const generatedPDF = join(texDir, `${texBasename}.pdf`);
+        if (existsSync(generatedPDF)) {
+            const destPDF = join(docsDir, `${texBasename}.pdf`);
+            const fs = await import('fs');
+            fs.copyFileSync(generatedPDF, destPDF);
+            return { exported: true, pdfPath: destPDF };
+        }
+    }
+    catch {
+        return { exported: false };
+    }
+    return { exported: false };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildResumePrompt(analysis, ownerName) {
+    const techStack = [...analysis.languages, ...analysis.frameworks, ...analysis.libraries].join(', ');
+    const features = analysis.features.length > 0 ? analysis.features.slice(0, 5).join('; ') : 'Core functionality implemented';
+    return `Generate a LaTeX resume project entry for ${ownerName}'s technical resume.
+
+PROJECT DETAILS:
+- Name: ${analysis.name}
+- Tech Stack: ${techStack}
+- Architecture: ${analysis.architecture}
+- Description: ${analysis.description || 'A software project'}
+- Key Features: ${features}
+${analysis.database.length > 0 ? `- Database: ${analysis.database.join(', ')}` : ''}
+${analysis.deployment.length > 0 ? `- Deployment: ${analysis.deployment.join(', ')}` : ''}
+
+INSTRUCTIONS:
+1. Use this LaTeX structure:
+   \\resumeProjectHeading
+       {\\textbf{Project Name} $|$ \\emph{Category/Type}}{}
+       \\resumeItemListStart
+         \\resumeItem{Bullet point 1}
+         \\resumeItem{Bullet point 2}
+         \\resumeItem{Bullet point 3}
+         \\resumeItem{\\textbf{Tech Stack:} technologies used}
+       \\resumeItemListEnd
+
+2. Write 3-4 bullet points using strong action verbs (Built, Developed, Engineered, Implemented, Designed).
+3. Focus on: what was built, technical depth, impact/scale, architectural decisions.
+4. Last bullet should be: \\textbf{Tech Stack:} [list all technologies]
+5. Keep bullets concise but technical (1-2 lines each).
+6. Do NOT add extra commentary or explanations — return ONLY the LaTeX code.
+
+Generate the entry now:`;
+}
+function generateTemplateEntry(analysis) {
+    const techStack = [...analysis.languages, ...analysis.frameworks, ...analysis.libraries]
+        .slice(0, 10)
+        .join(', ');
+    const projectType = analysis.frameworks.length > 0
+        ? `${analysis.frameworks[0]} Project`
+        : analysis.languages[0]
+            ? `${analysis.languages[0]} Project`
+            : 'Software Project';
+    const bullets = [];
+    // Bullet 1: What was built
+    if (analysis.description) {
+        bullets.push(`Built ${analysis.name} — ${analysis.description.toLowerCase()}.`);
+    }
+    else {
+        bullets.push(`Developed ${analysis.name}, a ${analysis.architecture.toLowerCase()} application.`);
+    }
+    // Bullet 2: Technical detail (architecture or key feature)
+    if (analysis.features.length > 0) {
+        bullets.push(`Implemented ${analysis.features[0].toLowerCase()}.`);
+    }
+    else if (analysis.database.length > 0) {
+        bullets.push(`Designed system architecture with ${analysis.database[0]} database integration.`);
+    }
+    else {
+        bullets.push(`Engineered modular ${analysis.architecture.toLowerCase()} with focus on maintainability.`);
+    }
+    // Bullet 3: Tech stack
+    bullets.push(`\\textbf{Tech Stack:} ${techStack}.`);
+    const bulletItems = bullets.map(b => `        \\resumeItem{${b}}`).join('\n');
+    return `      \\resumeProjectHeading
+          {\\textbf{${analysis.name}} $|$ \\emph{${projectType}}}{}
+          \\resumeItemListStart
+${bulletItems}
+          \\resumeItemListEnd`;
+}
+//# sourceMappingURL=resume-manager.js.map

package/dist/services/resume-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-manager.js","sourceRoot":"","sources":["../../src/services/resume-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAcrD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,QAAyB,EACzB,KAAc,EACd,SAAiB;IAEjB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC,KAAK,EAAE,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAgB;YAC5B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gGAAgG,EAAE;YAC7H,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACzF,IAAI,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpC,oCAAoC;QACpC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAEnF,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,eAAuB;IAEvB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAElD,4BAA4B;IAC5B,MAAM,oBAAoB,GAAG,OAAO,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAChH,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,eAAe,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAM,CAAC;IAElD,6DAA6D;IAC7D,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC5E,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC,KAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,MAAM,cAAc,GAClB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QAC3B,MAAM,GAAG,eAAe;QACxB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE3B,gBAAgB;IAChB,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9E,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,uBAAuB;IACvB,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,eAAe;QACzB,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,QAAQ,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,+CAA+C;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,6CAA6C;QAC7C,QAAQ,CAAC,sCAAsC,WAAW,OAAO,EAAE;YACjE,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,QAAQ,CAAC,sCAAsC,WAAW,OAAO,EAAE;YACjE,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,MAAM,CAAC,CAAC;QACxD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,WAAW,MAAM,CAAC,CAAC;YACpD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACvC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,iFAAiF;AAEjF,SAAS,iBAAiB,CAAC,QAAyB,EAAE,SAAiB;IACrE,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC;IAE5H,OAAO,6CAA6C,SAAS;;;UAGrD,QAAQ,CAAC,IAAI;gBACP,SAAS;kBACP,QAAQ,CAAC,YAAY;iBACtB,QAAQ,CAAC,WAAW,IAAI,oBAAoB;kBAC3C,QAAQ;EACxB,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EACjF,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;wBAmBjE,CAAC;AACzB,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAyB;IACtD,MAAM,SAAS,GAAG,CAAC,GAAG,QAAQ,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC;SACrF,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAChD,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;QACrC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YACvB,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YACpC,CAAC,CAAC,kBAAkB,CAAC;IAEvB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,2BAA2B;IAC3B,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACpG,CAAC;IAED,2DAA2D;IAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,qCAAqC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;IAClG,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC;IAC3G,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,IAAI,CAAC,yBAAyB,SAAS,GAAG,CAAC,CAAC;IAEpD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9E,OAAO;sBACa,QAAQ,CAAC,IAAI,gBAAgB,WAAW;;EAE5D,WAAW;8BACiB,CAAC;AAC/B,CAAC"}

package/dist/services/social-generator.d.ts

@@ -0,0 +1,14 @@
+import type { ProjectAnalysis } from '../scanner/project-analyzer.js';
+export interface SocialContent {
+    linkedin: {
+        short: string;
+        medium: string;
+        long: string;
+    };
+    twitter: string;
+    devto: string;
+    resumeBullet: string;
+    portfolioDescription: string;
+}
+export declare function generateSocialContent(analysis: ProjectAnalysis, useAI: boolean): Promise<SocialContent>;
+//# sourceMappingURL=social-generator.d.ts.map

package/dist/services/social-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-generator.d.ts","sourceRoot":"","sources":["../../src/services/social-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,aAAa,CAAC,CAyCxB"}