@ankh-studio/ai-enablement 1.0.0

package/dist/scanners/copilot-feature-scanner.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copilot Feature Scanner
+ *
+ * Scans repository for GitHub Copilot integration features:
+ * - Copilot instructions (.github/copilot-instructions.md)
+ * - CODEOWNERS file
+ * - Copilot-compatible documentation
+ * - AI-friendly code patterns
+ */
+export interface CopilotFeatureAnalysis {
+    githubFeatures: {
+        copilotInstructions: {
+            found: boolean;
+            path?: string;
+            content?: string;
+            quality: "excellent" | "good" | "basic" | "missing";
+        };
+        codeowners: {
+            found: boolean;
+            path?: string;
+            content?: string;
+            coverage: "comprehensive" | "partial" | "minimal" | "missing";
+        };
+        issueTemplates: {
+            found: boolean;
+            count: number;
+            aiFriendly: boolean;
+        };
+        prTemplates: {
+            found: boolean;
+            aiFriendly: boolean;
+        };
+    };
+    codePatterns: {
+        aiFriendlyComments: number;
+        documentationCoverage: number;
+        typeScriptUsage: boolean;
+        testCoverage: boolean;
+    };
+    recommendations: string[];
+}
+export declare class CopilotFeatureScanner {
+    private git;
+    scan(repoPath: string): Promise<CopilotFeatureAnalysis>;
+    private scanCopilotInstructions;
+    private scanCodeowners;
+    private scanTemplates;
+    private scanTemplateDirectory;
+    private scanCodePatterns;
+    private evaluateInstructionQuality;
+    private evaluateCodeownersCoverage;
+    private isAiFriendlyTemplate;
+    private generateRecommendations;
+}
+//# sourceMappingURL=copilot-feature-scanner.d.ts.map

package/dist/scanners/copilot-feature-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-feature-scanner.d.ts","sourceRoot":"","sources":["../../src/scanners/copilot-feature-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE;QACd,mBAAmB,EAAE;YACnB,KAAK,EAAE,OAAO,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;SACrD,CAAC;QACF,UAAU,EAAE;YACV,KAAK,EAAE,OAAO,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;SAC/D,CAAC;QACF,cAAc,EAAE;YACd,KAAK,EAAE,OAAO,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;QACF,WAAW,EAAE;YACX,KAAK,EAAE,OAAO,CAAC;YACf,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;KACH,CAAC;IACF,YAAY,EAAE;QACZ,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,eAAe,EAAE,OAAO,CAAC;QACzB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,GAAG,CAAe;IAEpB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAuC/C,uBAAuB;YA6BvB,cAAc;YA6Bd,aAAa;YAwCb,qBAAqB;YAOrB,gBAAgB;IAiD9B,OAAO,CAAC,0BAA0B;IAqBlC,OAAO,CAAC,0BAA0B;IAiBlC,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,uBAAuB;CAmDhC"}

package/dist/scanners/copilot-feature-scanner.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Copilot Feature Scanner
+ *
+ * Scans repository for GitHub Copilot integration features:
+ * - Copilot instructions (.github/copilot-instructions.md)
+ * - CODEOWNERS file
+ * - Copilot-compatible documentation
+ * - AI-friendly code patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopilotFeatureScanner = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const simple_git_1 = require("simple-git");
+class CopilotFeatureScanner {
+    constructor() {
+        this.git = (0, simple_git_1.simpleGit)();
+    }
+    async scan(repoPath) {
+        const analysis = {
+            githubFeatures: {
+                copilotInstructions: { found: false, quality: "missing" },
+                codeowners: { found: false, coverage: "missing" },
+                issueTemplates: { found: false, count: 0, aiFriendly: false },
+                prTemplates: { found: false, aiFriendly: false },
+            },
+            codePatterns: {
+                aiFriendlyComments: 0,
+                documentationCoverage: 0,
+                typeScriptUsage: false,
+                testCoverage: false,
+            },
+            recommendations: [],
+        };
+        try {
+            await this.git.cwd(repoPath);
+            // Scan GitHub features
+            await this.scanCopilotInstructions(repoPath, analysis);
+            await this.scanCodeowners(repoPath, analysis);
+            await this.scanTemplates(repoPath, analysis);
+            // Scan code patterns
+            await this.scanCodePatterns(repoPath, analysis);
+            // Generate recommendations
+            this.generateRecommendations(analysis);
+        }
+        catch (error) {
+            console.warn(`Warning: Could not complete Copilot feature scan: ${error}`);
+        }
+        return analysis;
+    }
+    async scanCopilotInstructions(repoPath, analysis) {
+        const instructionPaths = [
+            ".github/copilot-instructions.md",
+            ".github/copilot-instructions.txt",
+            ".github/COPYLOIT_INSTRUCTIONS.md",
+        ];
+        for (const path of instructionPaths) {
+            const fullPath = (0, path_1.join)(repoPath, path);
+            try {
+                await (0, promises_1.access)(fullPath, promises_1.constants.R_OK);
+                const content = await (0, promises_1.readFile)(fullPath, "utf-8");
+                analysis.githubFeatures.copilotInstructions = {
+                    found: true,
+                    path,
+                    content,
+                    quality: this.evaluateInstructionQuality(content),
+                };
+                break;
+            }
+            catch {
+                // File doesn't exist, try next path
+            }
+        }
+    }
+    async scanCodeowners(repoPath, analysis) {
+        const codeownersPaths = [
+            ".github/CODEOWNERS",
+            "CODEOWNERS",
+            "docs/CODEOWNERS",
+        ];
+        for (const path of codeownersPaths) {
+            const fullPath = (0, path_1.join)(repoPath, path);
+            try {
+                await (0, promises_1.access)(fullPath, promises_1.constants.R_OK);
+                const content = await (0, promises_1.readFile)(fullPath, "utf-8");
+                analysis.githubFeatures.codeowners = {
+                    found: true,
+                    path,
+                    content,
+                    coverage: this.evaluateCodeownersCoverage(content),
+                };
+                break;
+            }
+            catch {
+                // File doesn't exist, try next path
+            }
+        }
+    }
+    async scanTemplates(repoPath, analysis) {
+        try {
+            // Scan issue templates
+            const issueTemplates = await this.scanTemplateDirectory();
+            analysis.githubFeatures.issueTemplates = {
+                found: issueTemplates.length > 0,
+                count: issueTemplates.length,
+                aiFriendly: issueTemplates.some((template) => this.isAiFriendlyTemplate(template)),
+            };
+            // Scan PR templates
+            const prTemplatePaths = [
+                ".github/pull_request_template.md",
+                ".github/PULL_REQUEST_TEMPLATE.md",
+            ];
+            for (const path of prTemplatePaths) {
+                const fullPath = (0, path_1.join)(repoPath, path);
+                try {
+                    await (0, promises_1.access)(fullPath, promises_1.constants.R_OK);
+                    const content = await (0, promises_1.readFile)(fullPath, "utf-8");
+                    analysis.githubFeatures.prTemplates = {
+                        found: true,
+                        aiFriendly: this.isAiFriendlyTemplate(content),
+                    };
+                    break;
+                }
+                catch {
+                    // File doesn't exist
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Warning: Could not scan templates: ${error}`);
+        }
+    }
+    async scanTemplateDirectory() {
+        const templates = [];
+        // This would require fs.readdir, but for now return empty
+        // Implementation would scan directory and read template files
+        return templates;
+    }
+    async scanCodePatterns(repoPath, analysis) {
+        try {
+            // Check for TypeScript usage
+            const tsconfigPath = (0, path_1.join)(repoPath, "tsconfig.json");
+            try {
+                await (0, promises_1.access)(tsconfigPath, promises_1.constants.R_OK);
+                analysis.codePatterns.typeScriptUsage = true;
+            }
+            catch {
+                analysis.codePatterns.typeScriptUsage = false;
+            }
+            // Check for test setup
+            const testIndicators = [
+                "jest.config.js",
+                "jest.config.json",
+                "vitest.config.ts",
+                "test/",
+                "tests/",
+                "__tests__/",
+            ];
+            for (const indicator of testIndicators) {
+                const indicatorPath = (0, path_1.join)(repoPath, indicator);
+                try {
+                    await (0, promises_1.access)(indicatorPath, indicator.endsWith("/") ? promises_1.constants.F_OK : promises_1.constants.R_OK);
+                    analysis.codePatterns.testCoverage = true;
+                    break;
+                }
+                catch {
+                    // Continue checking
+                }
+            }
+            // In a full implementation, we would scan source files for:
+            // - AI-friendly comments
+            // - Documentation coverage
+            // For now, set reasonable defaults
+            analysis.codePatterns.aiFriendlyComments = 5;
+            analysis.codePatterns.documentationCoverage = 60;
+        }
+        catch (error) {
+            console.warn(`Warning: Could not scan code patterns: ${error}`);
+        }
+    }
+    evaluateInstructionQuality(content) {
+        if (!content || content.trim().length === 0)
+            return "missing";
+        const lines = content.split("\n").length;
+        const hasSections = content.includes("#") || content.includes("##");
+        const hasExamples = content.includes("example") || content.includes("Example");
+        const hasSpecificGuidelines = content.includes("should") ||
+            content.includes("must") ||
+            content.includes("avoid");
+        if (lines > 20 && hasSections && hasExamples && hasSpecificGuidelines)
+            return "excellent";
+        if (lines > 10 && hasSections && hasSpecificGuidelines)
+            return "good";
+        if (lines > 3)
+            return "basic";
+        return "missing";
+    }
+    evaluateCodeownersCoverage(content) {
+        if (!content || content.trim().length === 0)
+            return "missing";
+        const lines = content
+            .split("\n")
+            .filter((line) => !line.startsWith("#") && line.trim().length > 0).length;
+        const hasWildcards = content.includes("*");
+        const hasSpecificFiles = content.includes("/") && !content.includes("*/");
+        if (lines > 5 && hasSpecificFiles)
+            return "comprehensive";
+        if (lines > 2 && (hasWildcards || hasSpecificFiles))
+            return "partial";
+        if (lines > 0)
+            return "minimal";
+        return "missing";
+    }
+    isAiFriendlyTemplate(content) {
+        const aiFriendlyKeywords = [
+            "steps to reproduce",
+            "expected behavior",
+            "actual behavior",
+            "environment",
+            "context",
+            "acceptance criteria",
+            "testing",
+            "reproduction",
+        ];
+        const lowerContent = content.toLowerCase();
+        return aiFriendlyKeywords.some((keyword) => lowerContent.includes(keyword));
+    }
+    generateRecommendations(analysis) {
+        const recommendations = [];
+        if (!analysis.githubFeatures.copilotInstructions.found) {
+            recommendations.push("Add .github/copilot-instructions.md to guide AI assistance");
+        }
+        else if (analysis.githubFeatures.copilotInstructions.quality === "basic") {
+            recommendations.push("Enhance copilot-instructions.md with more detailed guidance and examples");
+        }
+        if (!analysis.githubFeatures.codeowners.found) {
+            recommendations.push("Add CODEOWNERS file to define code ownership and improve review processes");
+        }
+        else if (analysis.githubFeatures.codeowners.coverage === "minimal") {
+            recommendations.push("Expand CODEOWNERS coverage for better security and governance");
+        }
+        if (!analysis.githubFeatures.issueTemplates.found) {
+            recommendations.push("Create issue templates with AI-friendly structure for better bug reports");
+        }
+        if (!analysis.githubFeatures.prTemplates.found) {
+            recommendations.push("Add PR template to guide contributors and improve AI assistance");
+        }
+        if (!analysis.codePatterns.typeScriptUsage) {
+            recommendations.push("Consider adopting TypeScript for better AI code understanding");
+        }
+        if (!analysis.codePatterns.testCoverage) {
+            recommendations.push("Add testing framework to improve code quality and AI assistance");
+        }
+        analysis.recommendations = recommendations;
+    }
+}
+exports.CopilotFeatureScanner = CopilotFeatureScanner;
+//# sourceMappingURL=copilot-feature-scanner.js.map

package/dist/scanners/copilot-feature-scanner.js.map

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

package/dist/scorers/readiness-scorer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Readiness Scorer
+ *
+ * Calculates deterministic readiness scores for repository, team, and organization
+ * based on collected evidence and analysis data
+ */
+import { TechStackAnalysis } from "../analyzers/tech-stack-analyzer";
+import { EvidenceData } from "../collectors/evidence-collector";
+import { CopilotFeatureAnalysis } from "../scanners/copilot-feature-scanner";
+export interface ReadinessScores {
+    repoReadiness: number;
+    teamReadiness: number;
+    orgReadiness: number;
+    overallMaturity: number;
+    confidence: "high" | "medium" | "low";
+    breakdown: {
+        foundation: number;
+        security: number;
+        workflow: number;
+        ai: number;
+        governance: number;
+    };
+}
+export interface ScoringContext {
+    copilotFeatures: CopilotFeatureAnalysis;
+    techStack: TechStackAnalysis;
+    evidence: EvidenceData;
+}
+export declare class ReadinessScorer {
+    calculate(context: ScoringContext): Promise<ReadinessScores>;
+    private calculateFoundationScore;
+    private calculateSecurityScore;
+    private calculateWorkflowScore;
+    private calculateAIScore;
+    private calculateGovernanceScore;
+    private calculateRepoReadiness;
+    private calculateTeamReadiness;
+    private calculateOrgReadiness;
+    private calculateOverallMaturity;
+    private calculateConfidence;
+}
+//# sourceMappingURL=readiness-scorer.d.ts.map

package/dist/scorers/readiness-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-scorer.d.ts","sourceRoot":"","sources":["../../src/scorers/readiness-scorer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,sBAAsB,CAAC;IACxC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,qBAAa,eAAe;IACpB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA+ClE,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,sBAAsB;IA+B9B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,sBAAsB;IAqB9B,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,wBAAwB;IAkBhC,OAAO,CAAC,mBAAmB;CAuB5B"}

package/dist/scorers/readiness-scorer.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * Readiness Scorer
+ *
+ * Calculates deterministic readiness scores for repository, team, and organization
+ * based on collected evidence and analysis data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadinessScorer = void 0;
+class ReadinessScorer {
+    async calculate(context) {
+        const { copilotFeatures, techStack, evidence } = context;
+        // Calculate component scores
+        const foundation = this.calculateFoundationScore(evidence, techStack);
+        const security = this.calculateSecurityScore(copilotFeatures, evidence);
+        const workflow = this.calculateWorkflowScore(copilotFeatures, evidence);
+        const ai = this.calculateAIScore(copilotFeatures, techStack);
+        const governance = this.calculateGovernanceScore(evidence, copilotFeatures);
+        // Calculate overall readiness scores
+        const repoReadiness = this.calculateRepoReadiness(foundation, security, workflow, ai, governance);
+        const teamReadiness = this.calculateTeamReadiness(workflow, ai, governance);
+        const orgReadiness = this.calculateOrgReadiness(governance, security);
+        // Calculate overall maturity (1-8 scale)
+        const overallMaturity = this.calculateOverallMaturity(repoReadiness, teamReadiness, orgReadiness);
+        // Determine confidence level
+        const confidence = this.calculateConfidence(evidence);
+        return {
+            repoReadiness,
+            teamReadiness,
+            orgReadiness,
+            overallMaturity,
+            confidence,
+            breakdown: {
+                foundation,
+                security,
+                workflow,
+                ai,
+                governance,
+            },
+        };
+    }
+    calculateFoundationScore(evidence, techStack) {
+        let score = 0;
+        const maxScore = 100;
+        // Basic documentation (20 points)
+        if (evidence.structure.hasReadme)
+            score += 10;
+        if (evidence.structure.hasLicense)
+            score += 5;
+        if (evidence.structure.hasContributing)
+            score += 5;
+        // Configuration files (25 points)
+        if (evidence.configuration.hasGitignore)
+            score += 5;
+        if (evidence.configuration.hasEditorconfig)
+            score += 5;
+        if (evidence.configuration.hasPrettier)
+            score += 5;
+        if (evidence.configuration.hasEslint)
+            score += 5;
+        if (evidence.configuration.hasTypeScript)
+            score += 5;
+        // Development setup (25 points)
+        if (evidence.configuration.hasTests)
+            score += 10;
+        if (evidence.configuration.hasCi)
+            score += 10;
+        if (techStack.infrastructure.packageManager !== "unknown")
+            score += 5;
+        // Code quality (30 points)
+        if (techStack.aiReadiness.modernFramework)
+            score += 10;
+        if (techStack.aiReadiness.typescriptUsage)
+            score += 10;
+        if (evidence.patterns.codeComplexity !== "high")
+            score += 10;
+        return Math.min(score, maxScore);
+    }
+    calculateSecurityScore(copilotFeatures, evidence) {
+        let score = 0;
+        const maxScore = 100;
+        // Code ownership (30 points)
+        if (copilotFeatures.githubFeatures.codeowners.found) {
+            const coverage = copilotFeatures.githubFeatures.codeowners.coverage;
+            if (coverage === "comprehensive")
+                score += 30;
+            else if (coverage === "partial")
+                score += 20;
+            else if (coverage === "minimal")
+                score += 10;
+        }
+        // Branch protection (25 points) - would need git API
+        if (copilotFeatures.githubFeatures.codeowners.found)
+            score += 15; // Proxy for security awareness
+        if (evidence.configuration.hasCi)
+            score += 10;
+        // Dependency security (25 points)
+        if (evidence.metrics.dependencyHealth === "excellent")
+            score += 25;
+        else if (evidence.metrics.dependencyHealth === "good")
+            score += 20;
+        else if (evidence.metrics.dependencyHealth === "fair")
+            score += 10;
+        // Security patterns (20 points)
+        if (evidence.structure.hasLicense)
+            score += 10;
+        if (evidence.configuration.hasEslint)
+            score += 10;
+        return Math.min(score, maxScore);
+    }
+    calculateWorkflowScore(copilotFeatures, evidence) {
+        let score = 0;
+        const maxScore = 100;
+        // Templates and automation (30 points)
+        if (copilotFeatures.githubFeatures.prTemplates.found)
+            score += 15;
+        if (copilotFeatures.githubFeatures.issueTemplates.found)
+            score += 15;
+        // CI/CD setup (25 points)
+        if (evidence.configuration.hasCi)
+            score += 25;
+        // Testing infrastructure (25 points)
+        if (evidence.configuration.hasTests)
+            score += 15;
+        if (evidence.configuration.hasTests)
+            score += 10; // Use evidence instead of techStack
+        // Documentation and collaboration (20 points)
+        if (evidence.structure.hasContributing)
+            score += 10;
+        if (evidence.patterns.documentationCoverage > 20)
+            score += 10;
+        return Math.min(score, maxScore);
+    }
+    calculateAIScore(copilotFeatures, techStack) {
+        let score = 0;
+        const maxScore = 100;
+        // Copilot integration (35 points)
+        if (copilotFeatures.githubFeatures.copilotInstructions.found) {
+            const quality = copilotFeatures.githubFeatures.copilotInstructions.quality;
+            if (quality === "excellent")
+                score += 35;
+            else if (quality === "good")
+                score += 25;
+            else if (quality === "basic")
+                score += 15;
+        }
+        // AI-friendly tech stack (30 points)
+        if (techStack.aiReadiness.typescriptUsage)
+            score += 15;
+        if (techStack.aiReadiness.modernFramework)
+            score += 10;
+        if (techStack.aiReadiness.testCoverage)
+            score += 5;
+        // AI dependencies (20 points)
+        const aiDeps = techStack.dependencies.aiRelated.length;
+        if (aiDeps > 0)
+            score += Math.min(aiDeps * 10, 20);
+        // Code patterns (15 points)
+        if (copilotFeatures.codePatterns.aiFriendlyComments > 5)
+            score += 10;
+        if (copilotFeatures.codePatterns.documentationCoverage > 50)
+            score += 5;
+        return Math.min(score, maxScore);
+    }
+    calculateGovernanceScore(evidence, copilotFeatures) {
+        let score = 0;
+        const maxScore = 100;
+        // Project governance (30 points)
+        if (evidence.structure.hasContributing)
+            score += 15;
+        if (evidence.structure.hasChangelog)
+            score += 10;
+        if (evidence.structure.hasLicense)
+            score += 5;
+        // Code review processes (25 points)
+        if (copilotFeatures.githubFeatures.codeowners.found)
+            score += 15;
+        if (copilotFeatures.githubFeatures.prTemplates.found)
+            score += 10;
+        // Issue tracking (25 points)
+        if (copilotFeatures.githubFeatures.issueTemplates.found)
+            score += 15;
+        if (copilotFeatures.githubFeatures.issueTemplates.aiFriendly)
+            score += 10;
+        // Documentation standards (20 points)
+        if (evidence.structure.hasDocs)
+            score += 10;
+        if (evidence.patterns.documentationCoverage > 30)
+            score += 10;
+        return Math.min(score, maxScore);
+    }
+    calculateRepoReadiness(foundation, security, workflow, ai, governance) {
+        // Weighted average: Foundation (30%), Security (25%), Workflow (20%), AI (15%), Governance (10%)
+        const weights = {
+            foundation: 0.3,
+            security: 0.25,
+            workflow: 0.2,
+            ai: 0.15,
+            governance: 0.1,
+        };
+        const weightedScore = foundation * weights.foundation +
+            security * weights.security +
+            workflow * weights.workflow +
+            ai * weights.ai +
+            governance * weights.governance;
+        return Math.round(weightedScore);
+    }
+    calculateTeamReadiness(workflow, ai, governance) {
+        // Team readiness focuses on workflow, AI adoption, and governance
+        // Weighted average: Workflow (40%), AI (35%), Governance (25%)
+        const weights = {
+            workflow: 0.4,
+            ai: 0.35,
+            governance: 0.25,
+        };
+        const weightedScore = workflow * weights.workflow +
+            ai * weights.ai +
+            governance * weights.governance;
+        return Math.round(weightedScore);
+    }
+    calculateOrgReadiness(governance, security) {
+        // Organization readiness focuses on governance and security
+        // Weighted average: Governance (60%), Security (40%)
+        const weights = {
+            governance: 0.6,
+            security: 0.4,
+        };
+        const weightedScore = governance * weights.governance + security * weights.security;
+        return Math.round(weightedScore);
+    }
+    calculateOverallMaturity(repoReadiness, teamReadiness, orgReadiness) {
+        // Convert 0-100 scores to 1-8 maturity scale
+        const averageReadiness = (repoReadiness + teamReadiness + orgReadiness) / 3;
+        if (averageReadiness >= 90)
+            return 8; // Advanced
+        if (averageReadiness >= 80)
+            return 7; // Advanced
+        if (averageReadiness >= 70)
+            return 6; // Developing
+        if (averageReadiness >= 60)
+            return 5; // Developing
+        if (averageReadiness >= 50)
+            return 4; // Basic
+        if (averageReadiness >= 40)
+            return 3; // Basic
+        if (averageReadiness >= 25)
+            return 2; // Initial
+        return 1; // Initial
+    }
+    calculateConfidence(evidence) {
+        let confidenceFactors = 0;
+        const totalFactors = 8;
+        // Check if we have sufficient data for confident scoring
+        if (evidence.structure.fileCount > 0)
+            confidenceFactors++;
+        if (evidence.structure.hasReadme)
+            confidenceFactors++;
+        if (evidence.configuration.hasGitignore)
+            confidenceFactors++;
+        if (evidence.configuration.hasTypeScript || evidence.configuration.hasTests)
+            confidenceFactors++;
+        if (evidence.patterns.documentationCoverage > 0)
+            confidenceFactors++;
+        if (evidence.metrics.linesOfCode > 0)
+            confidenceFactors++;
+        if (evidence.metrics.dependencyHealth !== "fair")
+            confidenceFactors++;
+        if (evidence.structure.directoryDepth > 0)
+            confidenceFactors++;
+        const confidenceRatio = confidenceFactors / totalFactors;
+        if (confidenceRatio >= 0.8)
+            return "high";
+        if (confidenceRatio >= 0.5)
+            return "medium";
+        return "low";
+    }
+}
+exports.ReadinessScorer = ReadinessScorer;
+//# sourceMappingURL=readiness-scorer.js.map