faf-cli 4.2.2 → 4.3.0

package/dist/github/current-score-calculator.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * 🏆 Current Score Calculator
+ *
+ * Calculates AI-readiness score for repos AS THEY ARE (before FAF enhancement)
+ *
+ * Strategy:
+ * - Check if .faf exists → score it
+ * - No .faf → calculate baseline from README + package.json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateCurrentScore = calculateCurrentScore;
+const github_extractor_1 = require("./github-extractor");
+/**
+ * Calculate current score (repo as-is, before FAF generation)
+ */
+async function calculateCurrentScore(metadata, files) {
+    // Check if repo has existing .faf file
+    const hasFaf = files.some(f => f.path === 'project.faf' ||
+        f.path === '.faf' ||
+        f.path.endsWith('.faf'));
+    if (hasFaf) {
+        // Repo has .faf - score it
+        try {
+            const fafFile = files.find(f => f.path === 'project.faf' || f.path === '.faf');
+            if (fafFile) {
+                const fafContent = await (0, github_extractor_1.fetchGitHubFileContent)(metadata.owner, metadata.repo, fafFile.path, metadata.defaultBranch || 'main');
+                if (fafContent) {
+                    return scoreFafContent(fafContent);
+                }
+            }
+        }
+        catch (error) {
+            // Fallback to baseline if can't fetch .faf
+            console.error('Failed to fetch existing .faf:', error);
+        }
+    }
+    // No .faf file - calculate baseline score from available data
+    return calculateBaselineScore(metadata, files);
+}
+/**
+ * Score existing .faf content (simplified version)
+ */
+function scoreFafContent(fafContent) {
+    let score = 0;
+    // Basic presence checks (10 points each, max 60)
+    const checks = [
+        { pattern: /project:/i, points: 10 },
+        { pattern: /stack:/i, points: 10 },
+        { pattern: /human_context:/i, points: 10 },
+        { pattern: /ai_instructions:/i, points: 10 },
+        { pattern: /what:/i, points: 10 },
+        { pattern: /why:/i, points: 10 },
+    ];
+    for (const check of checks) {
+        if (check.pattern.test(fafContent)) {
+            score += check.points;
+        }
+    }
+    // Quality indicators (5 points each, max 40)
+    const qualityChecks = [
+        { pattern: /name:\s*\S+/, points: 5 },
+        { pattern: /goal:\s*\S+/, points: 5 },
+        { pattern: /main_language:\s*\S+/, points: 5 },
+        { pattern: /type:\s*\S+/, points: 5 },
+        { pattern: /who:\s*\S+/, points: 5 },
+        { pattern: /where:\s*\S+/, points: 5 },
+        { pattern: /when:\s*\S+/, points: 5 },
+        { pattern: /how:\s*\S+/, points: 5 },
+    ];
+    for (const check of qualityChecks) {
+        if (check.pattern.test(fafContent)) {
+            score += check.points;
+        }
+    }
+    return Math.min(score, 100);
+}
+/**
+ * Calculate baseline score from README + package.json (no .faf)
+ */
+function calculateBaselineScore(metadata, files) {
+    let score = 0;
+    // Has README (+10)
+    if (metadata.readme || files.some(f => f.path.toLowerCase().includes('readme'))) {
+        score += 10;
+    }
+    // Has package.json (+10)
+    if (metadata.hasPackageJson) {
+        score += 10;
+    }
+    // Has description (+5)
+    if (metadata.description && metadata.description.length > 20) {
+        score += 5;
+    }
+    // Has topics/tags (+5)
+    if (metadata.topics && metadata.topics.length > 0) {
+        score += 5;
+    }
+    // Popular repo (+5 for 1K+ stars)
+    const stars = parseInt(metadata.stars || '0');
+    if (stars >= 1000) {
+        score += 5;
+    }
+    // Has license (+5)
+    if (metadata.license) {
+        score += 5;
+    }
+    // Recently updated (+5 for < 90 days)
+    if (metadata.lastUpdated) {
+        const lastUpdate = new Date(metadata.lastUpdated);
+        const now = new Date();
+        const daysSinceUpdate = (now.getTime() - lastUpdate.getTime()) / (1000 * 60 * 60 * 24);
+        if (daysSinceUpdate < 90) {
+            score += 5;
+        }
+    }
+    // Has multiple languages (+5)
+    if (metadata.languages && metadata.languages.length > 1) {
+        score += 5;
+    }
+    // Baseline repos typically score 20-50%
+    // This is intentionally low to show FAF's value
+    return Math.min(score, 50);
+}
+//# sourceMappingURL=current-score-calculator.js.map

package/dist/github/current-score-calculator.js.map

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

package/dist/github/faf-git-generator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 🏆 Enhanced FAF Generation for `faf git`
+ *
+ * Generates 90%+ AI-ready .faf files from GitHub repos WITHOUT cloning
+ *
+ * Strategy:
+ * 1. Fetch README.md → Extract 6 Ws (+30%)
+ * 2. Fetch package.json → Deep stack analysis (+15%)
+ * 3. Full FAF schema → Match faf-cli init (+20%)
+ * 4. Smart defaults → AI instructions, project type (+15%)
+ * 5. Enhanced scoring → Championship grade (+10%)
+ */
+import type { GitHubMetadata } from './github-extractor';
+export interface Enhanced6Ws {
+    who: string;
+    what: string;
+    why: string;
+    where: string;
+    when: string;
+    how: string;
+    confidence: number;
+}
+/**
+ * Extract 6 Ws from README content (simplified version for git command)
+ */
+export declare function extract6WsFromReadme(readme: string, metadata: GitHubMetadata): Enhanced6Ws;
+/**
+ * Enhanced stack detection from package.json
+ */
+export interface StackAnalysis {
+    frontend?: string;
+    backend?: string;
+    database?: string;
+    testing?: string;
+    buildTool?: string;
+    runtime?: string;
+    language?: string;
+    hosting?: string;
+    frameworks: string[];
+}
+/**
+ * Extract stack from GH API languages array
+ * This is the SOURCE OF TRUTH from GitHub - trust it!
+ */
+export declare function extractFromLanguages(metadata: GitHubMetadata): StackAnalysis;
+export declare function analyzePackageJson(packageJson: any, metadata: GitHubMetadata): StackAnalysis;
+/**
+ * Calculate enhanced quality score (targeting 90%+)
+ */
+export declare function calculateEnhancedScore(metadata: GitHubMetadata, has6Ws: boolean, hasPackageJson: boolean, hasReadme: boolean): number;
+/**
+ * Generate full FAF structure (matching faf-cli init output)
+ */
+export declare function generateEnhancedFaf(metadata: GitHubMetadata, files: any[]): Promise<{
+    content: string;
+    score: number;
+}>;
+//# sourceMappingURL=faf-git-generator.d.ts.map

package/dist/github/faf-git-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faf-git-generator.d.ts","sourceRoot":"","sources":["../../src/github/faf-git-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,WAAW,CA+E1F;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,CAyD5E;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,GAAG,aAAa,CAuD5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,OAAO,GACjB,MAAM,CAuCR;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,GAAG,EAAE,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAkP7C"}