@ankh-studio/ai-enablement 1.0.0

package/dist/collectors/evidence-collector.js

@@ -0,0 +1,386 @@
+"use strict";
+/**
+ * Evidence Collector
+ *
+ * Collects structured evidence from repository for AI readiness assessment
+ * including metrics, patterns, and contextual information
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvidenceCollector = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+class EvidenceCollector {
+    async collect(repoPath) {
+        const evidence = {
+            structure: {
+                hasReadme: false,
+                hasLicense: false,
+                hasChangelog: false,
+                hasContributing: false,
+                hasDocs: false,
+                directoryDepth: 0,
+                fileCount: 0,
+            },
+            configuration: {
+                hasGitignore: false,
+                hasEditorconfig: false,
+                hasPrettier: false,
+                hasEslint: false,
+                hasTypeScript: false,
+                hasTests: false,
+                hasCi: false,
+            },
+            patterns: {
+                commitMessageQuality: "none",
+                branchProtection: false,
+                prTemplates: false,
+                issueTemplates: false,
+                documentationCoverage: 0,
+                codeComplexity: "unknown",
+            },
+            metrics: {
+                linesOfCode: 0,
+                testCoverage: 0,
+                documentationRatio: 0,
+                dependencyHealth: "fair",
+            },
+        };
+        try {
+            // Collect structure evidence
+            await this.collectStructureEvidence(repoPath, evidence);
+            // Collect configuration evidence
+            await this.collectConfigurationEvidence(repoPath, evidence);
+            // Collect pattern evidence
+            await this.collectPatternEvidence(repoPath, evidence);
+            // Collect metrics evidence
+            await this.collectMetricsEvidence(repoPath, evidence);
+        }
+        catch (error) {
+            console.warn(`Warning: Could not complete evidence collection: ${error}`);
+        }
+        return evidence;
+    }
+    async collectStructureEvidence(repoPath, evidence) {
+        const structureFiles = [
+            { path: "README.md", prop: "hasReadme" },
+            { path: "README", prop: "hasReadme" },
+            { path: "LICENSE", prop: "hasLicense" },
+            { path: "CHANGELOG.md", prop: "hasChangelog" },
+            { path: "CONTRIBUTING.md", prop: "hasContributing" },
+            { path: "docs/", prop: "hasDocs" },
+            { path: "doc/", prop: "hasDocs" },
+        ];
+        for (const { path, prop } of structureFiles) {
+            const fullPath = (0, path_1.join)(repoPath, path);
+            try {
+                if (path.endsWith("/")) {
+                    // Directory check
+                    await this.access(fullPath, promises_1.constants.F_OK);
+                    evidence.structure[prop] = true;
+                }
+                else {
+                    // File check
+                    await this.access(fullPath, promises_1.constants.R_OK);
+                    evidence.structure[prop] = true;
+                }
+            }
+            catch {
+                // File doesn't exist, keep default false
+            }
+        }
+        // Calculate directory depth and file count
+        const { depth, count } = await this.analyzeDirectoryStructure(repoPath);
+        evidence.structure.directoryDepth = depth;
+        evidence.structure.fileCount = count;
+    }
+    async collectConfigurationEvidence(repoPath, evidence) {
+        const configFiles = [
+            { path: ".gitignore", prop: "hasGitignore" },
+            { path: ".editorconfig", prop: "hasEditorconfig" },
+            { path: ".prettierrc", prop: "hasPrettier" },
+            { path: "prettier.config.js", prop: "hasPrettier" },
+            { path: ".eslintrc.json", prop: "hasEslint" },
+            { path: ".eslintrc.js", prop: "hasEslint" },
+            { path: "tsconfig.json", prop: "hasTypeScript" },
+            { path: "jest.config.js", prop: "hasTests" },
+            { path: "jest.config.json", prop: "hasTests" },
+            { path: "vitest.config.ts", prop: "hasTests" },
+            { path: ".github/workflows/", prop: "hasCi" },
+            { path: ".gitlab-ci.yml", prop: "hasCi" },
+        ];
+        for (const { path, prop } of configFiles) {
+            const fullPath = (0, path_1.join)(repoPath, path);
+            try {
+                if (path.endsWith("/")) {
+                    await this.access(fullPath, promises_1.constants.F_OK);
+                    evidence.configuration[prop] = true;
+                }
+                else {
+                    await this.access(fullPath, promises_1.constants.R_OK);
+                    evidence.configuration[prop] = true;
+                }
+            }
+            catch {
+                // File doesn't exist, keep default false
+            }
+        }
+    }
+    async collectPatternEvidence(repoPath, evidence) {
+        const githubDir = (0, path_1.join)(repoPath, ".github");
+        try {
+            // Check for GitHub patterns
+            await this.access(githubDir, promises_1.constants.F_OK);
+            // PR templates
+            const prTemplatePaths = [
+                (0, path_1.join)(githubDir, "pull_request_template.md"),
+                (0, path_1.join)(githubDir, "PULL_REQUEST_TEMPLATE.md"),
+            ];
+            for (const path of prTemplatePaths) {
+                try {
+                    await this.access(path, promises_1.constants.R_OK);
+                    evidence.patterns.prTemplates = true;
+                    break;
+                }
+                catch {
+                    // Template doesn't exist
+                }
+            }
+            // Issue templates
+            const issueTemplateDir = (0, path_1.join)(githubDir, "ISSUE_TEMPLATE");
+            try {
+                const files = await this.readdir(issueTemplateDir);
+                evidence.patterns.issueTemplates = files.length > 0;
+            }
+            catch {
+                // Directory doesn't exist
+            }
+            // Branch protection (would require git API, set default)
+            evidence.patterns.branchProtection = false;
+            // Documentation coverage estimation
+            evidence.patterns.documentationCoverage =
+                await this.calculateDocumentationCoverage(repoPath);
+            // Code complexity estimation
+            evidence.patterns.codeComplexity =
+                await this.estimateCodeComplexity(repoPath);
+        }
+        catch (error) {
+            console.warn(`Warning: Could not analyze GitHub patterns: ${error}`);
+        }
+    }
+    async collectMetricsEvidence(repoPath, evidence) {
+        // Lines of code estimation
+        evidence.metrics.linesOfCode = await this.countLinesOfCode(repoPath);
+        // Test coverage estimation (would need test runner integration)
+        evidence.metrics.testCoverage = evidence.configuration.hasTests ? 50 : 0; // Placeholder
+        // Documentation ratio
+        const docFiles = await this.countDocumentationFiles(repoPath);
+        const totalFiles = evidence.structure.fileCount;
+        evidence.metrics.documentationRatio =
+            totalFiles > 0 ? (docFiles / totalFiles) * 100 : 0;
+        // Dependency health (would need security audit)
+        evidence.metrics.dependencyHealth = "fair"; // Placeholder
+    }
+    async analyzeDirectoryStructure(repoPath) {
+        let maxDepth = 0;
+        let fileCount = 0;
+        const scanDirectory = async (dir, currentDepth) => {
+            maxDepth = Math.max(maxDepth, currentDepth);
+            try {
+                const entries = await this.readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = (0, path_1.join)(dir, entry.name);
+                    if (entry.isDirectory() &&
+                        !entry.name.startsWith(".") &&
+                        entry.name !== "node_modules") {
+                        await scanDirectory(fullPath, currentDepth + 1);
+                    }
+                    else if (entry.isFile()) {
+                        fileCount++;
+                    }
+                }
+            }
+            catch (error) {
+                // Directory access denied, skip
+            }
+        };
+        await scanDirectory(repoPath, 0);
+        return { depth: maxDepth, count: fileCount };
+    }
+    async calculateDocumentationCoverage(repoPath) {
+        let docFiles = 0;
+        let codeFiles = 0;
+        const scanFiles = async (dir) => {
+            try {
+                const entries = await this.readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = (0, path_1.join)(dir, entry.name);
+                    if (entry.isDirectory() &&
+                        !entry.name.startsWith(".") &&
+                        entry.name !== "node_modules") {
+                        await scanFiles(fullPath);
+                    }
+                    else if (entry.isFile()) {
+                        const ext = (0, path_1.extname)(entry.name).toLowerCase();
+                        const name = entry.name.toLowerCase();
+                        if ([".md", ".txt", ".rst", ".adoc"].includes(ext) ||
+                            name.includes("readme")) {
+                            docFiles++;
+                        }
+                        else if ([
+                            ".js",
+                            ".ts",
+                            ".jsx",
+                            ".tsx",
+                            ".py",
+                            ".java",
+                            ".cpp",
+                            ".c",
+                            ".go",
+                            ".rs",
+                        ].includes(ext)) {
+                            codeFiles++;
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Directory access denied, skip
+            }
+        };
+        await scanFiles(repoPath);
+        if (codeFiles === 0)
+            return 0;
+        return Math.min((docFiles / codeFiles) * 100, 100);
+    }
+    async estimateCodeComplexity(repoPath) {
+        // Simple heuristic based on file structure and dependencies
+        let complexityScore = 0;
+        try {
+            const packageJsonPath = (0, path_1.join)(repoPath, "package.json");
+            await this.access(packageJsonPath, promises_1.constants.R_OK);
+            const content = await this.readFile(packageJsonPath, "utf-8");
+            const packageJson = JSON.parse(content);
+            const depCount = Object.keys({
+                ...packageJson.dependencies,
+                ...packageJson.devDependencies,
+            }).length;
+            if (depCount > 50)
+                complexityScore += 2;
+            else if (depCount > 20)
+                complexityScore += 1;
+            // Check for complex patterns
+            if (await this.exists((0, path_1.join)(repoPath, "src/")))
+                complexityScore += 1;
+            if (await this.exists((0, path_1.join)(repoPath, "lib/")))
+                complexityScore += 1;
+            if (await this.exists((0, path_1.join)(repoPath, "packages/")))
+                complexityScore += 2; // Monorepo
+        }
+        catch (error) {
+            return "unknown";
+        }
+        if (complexityScore >= 4)
+            return "high";
+        if (complexityScore >= 2)
+            return "medium";
+        return "low";
+    }
+    async countLinesOfCode(repoPath) {
+        let totalLines = 0;
+        const countLines = async (dir) => {
+            try {
+                const entries = await this.readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = (0, path_1.join)(dir, entry.name);
+                    if (entry.isDirectory() &&
+                        !entry.name.startsWith(".") &&
+                        entry.name !== "node_modules") {
+                        await countLines(fullPath);
+                    }
+                    else if (entry.isFile()) {
+                        const ext = (0, path_1.extname)(entry.name).toLowerCase();
+                        if ([
+                            ".js",
+                            ".ts",
+                            ".jsx",
+                            ".tsx",
+                            ".py",
+                            ".java",
+                            ".cpp",
+                            ".c",
+                            ".go",
+                            ".rs",
+                        ].includes(ext)) {
+                            try {
+                                const content = await this.readFile(fullPath, "utf-8");
+                                totalLines += content.split("\n").length;
+                            }
+                            catch {
+                                // File read error, skip
+                            }
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Directory access denied, skip
+            }
+        };
+        await countLines(repoPath);
+        return totalLines;
+    }
+    async countDocumentationFiles(repoPath) {
+        let count = 0;
+        const countDocs = async (dir) => {
+            try {
+                const entries = await this.readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = (0, path_1.join)(dir, entry.name);
+                    if (entry.isDirectory() &&
+                        !entry.name.startsWith(".") &&
+                        entry.name !== "node_modules") {
+                        await countDocs(fullPath);
+                    }
+                    else if (entry.isFile()) {
+                        const ext = (0, path_1.extname)(entry.name).toLowerCase();
+                        const name = entry.name.toLowerCase();
+                        if ([".md", ".txt", ".rst", ".adoc"].includes(ext) ||
+                            name.includes("readme")) {
+                            count++;
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Directory access denied, skip
+            }
+        };
+        await countDocs(repoPath);
+        return count;
+    }
+    async access(path, mode) {
+        return (0, promises_1.access)(path, mode || promises_1.constants.R_OK);
+    }
+    async readFile(path, encoding) {
+        return (0, promises_1.readFile)(path, { encoding: encoding });
+    }
+    async readdir(path, options) {
+        if (options) {
+            return (0, promises_1.readdir)(path, options);
+        }
+        else {
+            return (0, promises_1.readdir)(path);
+        }
+    }
+    async exists(path) {
+        try {
+            await this.access(path, promises_1.constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.EvidenceCollector = EvidenceCollector;
+//# sourceMappingURL=evidence-collector.js.map

package/dist/collectors/evidence-collector.js.map

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

package/dist/core/assessment-engine.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Core Assessment Engine - Spec-Driven AI Development
+ *
+ * This is the main orchestrator that combines:
+ * 1. Repository scanning (existing)
+ * 2. Tech stack analysis (existing)
+ * 3. AI readiness scoring (new)
+ * 4. Evidence-based recommendations (new)
+ * 5. ADR generation (existing)
+ */
+import { CopilotFeatureAnalysis } from "../scanners/copilot-feature-scanner";
+import { PersonaResponse, PersonaType } from "../types/persona";
+export interface AssessmentConfig {
+    repoPath: string;
+    githubUrl?: string;
+    outputPath?: string;
+    includeRecommendations?: boolean;
+    generateADR?: boolean;
+    outputFormat?: "json" | "adr" | "markdown";
+    persona?: PersonaType;
+    targetAudience?: "individual" | "team" | "organization";
+    enableLLMCoalescing?: boolean;
+    enableAdversarialValidation?: boolean;
+}
+export interface AssessmentResult {
+    metadata: {
+        timestamp: string;
+        repository: string;
+        version: string;
+        duration: number;
+    };
+    analysis: {
+        copilotFeatures: CopilotFeatureAnalysis;
+        techStack: any;
+        evidence: any;
+    };
+    scores: {
+        repoReadiness: number;
+        teamReadiness: number;
+        orgReadiness: number;
+        overallMaturity: number;
+        confidence: "high" | "medium" | "low";
+    };
+    recommendations: Recommendation[];
+    personaInsights?: PersonaResponse;
+    adr?: string;
+}
+export interface Recommendation {
+    id: string;
+    title: string;
+    description: string;
+    priority: "high" | "medium" | "low";
+    category: "foundation" | "security" | "workflow" | "ai" | "governance";
+    effort: "small" | "medium" | "large";
+    timeframe: string;
+    dependencies: string[];
+    evidence: string[];
+}
+export declare class AssessmentEngine {
+    private scanner;
+    private techAnalyzer;
+    private scorer;
+    private adrGenerator;
+    private evidenceCollector;
+    private config;
+    constructor(config: AssessmentConfig);
+    execute(): Promise<AssessmentResult>;
+    private generateRecommendations;
+    private extractEvidence;
+    private generatePersonaInsights;
+    saveResults(result: AssessmentResult): Promise<void>;
+    private generateMarkdownReport;
+    private getScoreStatus;
+    private getMaturityStatus;
+}
+//# sourceMappingURL=assessment-engine.d.ts.map

package/dist/core/assessment-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-engine.d.ts","sourceRoot":"","sources":["../../src/core/assessment-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EACL,sBAAsB,EAEvB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAkB,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAC3C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,cAAc,CAAC;IACxD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,eAAe,EAAE,sBAAsB,CAAC;QACxC,SAAS,EAAE,GAAG,CAAC;QACf,QAAQ,EAAE,GAAG,CAAC;KACf,CAAC;IACF,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;KACvC,CAAC;IACF,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,GAAG,YAAY,CAAC;IACvE,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAmB9B,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAuF5B,uBAAuB;IA6ErC,OAAO,CAAC,eAAe;YAaT,uBAAuB;IA+B/B,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1D,OAAO,CAAC,sBAAsB;IAoC9B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;CAM1B"}