specweave 0.32.2 → 0.32.5

package/dist/src/core/living-docs/governance/ecosystem-detector.js

@@ -0,0 +1,325 @@
+/**
+ * Ecosystem Detector - Multi-technology ecosystem detection for polyglot codebases
+ *
+ * Detects all technology ecosystems present in a project by scanning for
+ * marker files (package.json, go.mod, pyproject.toml, etc.) and config files.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { promisify } from 'util';
+import { consoleLogger } from '../../../utils/logger.js';
+const readdir = promisify(fs.readdir);
+const stat = promisify(fs.stat);
+const readFile = promisify(fs.readFile);
+const ECOSYSTEM_DEFINITIONS = {
+    typescript: {
+        markers: ['package.json', 'tsconfig.json'],
+        configFiles: [
+            '.eslintrc.json',
+            '.eslintrc.js',
+            '.eslintrc.cjs',
+            '.eslintrc.yml',
+            'eslint.config.js',
+            'eslint.config.mjs',
+            '.prettierrc',
+            '.prettierrc.json',
+            '.prettierrc.js',
+            'prettier.config.js',
+            'tsconfig.json',
+            'tsconfig.base.json',
+            'biome.json',
+        ],
+    },
+    python: {
+        markers: ['requirements.txt', 'pyproject.toml', 'setup.py', 'Pipfile', 'poetry.lock'],
+        configFiles: [
+            'pyproject.toml',
+            '.pylintrc',
+            'setup.cfg',
+            '.flake8',
+            'ruff.toml',
+            '.ruff.toml',
+            'mypy.ini',
+            '.mypy.ini',
+            'pyrightconfig.json',
+            '.python-version',
+            'tox.ini',
+        ],
+    },
+    go: {
+        markers: ['go.mod'],
+        configFiles: ['go.mod', 'go.sum', '.golangci.yml', '.golangci.yaml', 'staticcheck.conf'],
+    },
+    java: {
+        markers: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
+        configFiles: [
+            'pom.xml',
+            'build.gradle',
+            'build.gradle.kts',
+            'checkstyle.xml',
+            'checkstyle/checkstyle.xml',
+            'pmd.xml',
+            'pmd/pmd.xml',
+            'spotbugs.xml',
+            'spotbugs-exclude.xml',
+            '.editorconfig',
+        ],
+    },
+    kotlin: {
+        markers: ['build.gradle.kts'],
+        configFiles: ['build.gradle.kts', 'detekt.yml', '.editorconfig'],
+    },
+    dotnet: {
+        markers: [],
+        configFiles: ['.editorconfig', 'StyleCop.json', 'Directory.Build.props', '.globalconfig'],
+        globPatterns: ['*.csproj', '*.sln', '*.fsproj'],
+    },
+    rust: {
+        markers: ['Cargo.toml'],
+        configFiles: ['Cargo.toml', 'rustfmt.toml', '.rustfmt.toml', 'clippy.toml', '.clippy.toml'],
+    },
+};
+const FRONTEND_FRAMEWORKS = {
+    react: {
+        dependencies: ['react', 'react-dom', 'next', 'gatsby', '@remix-run/react'],
+        configFiles: [],
+        eslintPlugins: ['plugin:react/', 'plugin:react-hooks/'],
+    },
+    angular: {
+        dependencies: ['@angular/core', '@angular/cli'],
+        configFiles: ['angular.json', '.angular.json'],
+        eslintPlugins: ['plugin:@angular-eslint/'],
+    },
+    vue: {
+        dependencies: ['vue', 'nuxt', '@nuxt/'],
+        configFiles: ['vue.config.js', 'nuxt.config.js', 'nuxt.config.ts'],
+        eslintPlugins: ['plugin:vue/'],
+    },
+};
+export class EcosystemDetector {
+    constructor(options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+        this.maxDepth = options.maxDepth ?? 3;
+    }
+    async detectEcosystems(projectPath) {
+        const ecosystems = [];
+        this.logger.debug(`Scanning for ecosystems in: ${projectPath}`);
+        // Detect backend ecosystems
+        for (const [name, definition] of Object.entries(ECOSYSTEM_DEFINITIONS)) {
+            const result = await this.detectEcosystem(projectPath, name, definition);
+            if (result) {
+                ecosystems.push(result);
+            }
+        }
+        // Detect frontend frameworks (requires package.json)
+        const frontendEcosystems = await this.detectFrontendFrameworks(projectPath);
+        ecosystems.push(...frontendEcosystems);
+        this.logger.info(`Detected ${ecosystems.length} ecosystem(s)`);
+        return ecosystems;
+    }
+    async detectEcosystem(projectPath, name, definition) {
+        let detectedFrom = null;
+        let confidence = 'low';
+        // Check markers first
+        for (const marker of definition.markers) {
+            const markerPath = path.join(projectPath, marker);
+            if (await this.fileExists(markerPath)) {
+                detectedFrom = marker;
+                confidence = 'high';
+                break;
+            }
+        }
+        // Check glob patterns (for .NET projects)
+        if (!detectedFrom && definition.globPatterns) {
+            for (const pattern of definition.globPatterns) {
+                const found = await this.findByGlobPattern(projectPath, pattern);
+                if (found) {
+                    detectedFrom = found;
+                    confidence = 'high';
+                    break;
+                }
+            }
+        }
+        if (!detectedFrom) {
+            return null;
+        }
+        // Find all config files
+        const configFiles = [];
+        for (const configFile of definition.configFiles) {
+            const configPath = path.join(projectPath, configFile);
+            if (await this.fileExists(configPath)) {
+                configFiles.push(configFile);
+            }
+        }
+        // Get version if possible
+        const version = await this.extractVersion(projectPath, name, detectedFrom);
+        return {
+            name,
+            confidence,
+            detectedFrom,
+            configFiles,
+            version,
+        };
+    }
+    async detectFrontendFrameworks(projectPath) {
+        const packageJsonPath = path.join(projectPath, 'package.json');
+        if (!(await this.fileExists(packageJsonPath))) {
+            return [];
+        }
+        let packageJson;
+        try {
+            const content = await readFile(packageJsonPath, 'utf-8');
+            packageJson = JSON.parse(content);
+        }
+        catch {
+            return [];
+        }
+        const allDeps = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        };
+        const ecosystems = [];
+        for (const [framework, definition] of Object.entries(FRONTEND_FRAMEWORKS)) {
+            const matchedDep = definition.dependencies.find((dep) => Object.keys(allDeps).some((key) => key === dep || key.startsWith(dep)));
+            if (matchedDep) {
+                const configFiles = await this.findFrontendConfigFiles(projectPath, definition.configFiles);
+                // Get ESLint plugins from eslint config if present
+                const eslintPlugins = await this.detectEslintPlugins(projectPath, definition.eslintPlugins);
+                const version = allDeps[matchedDep];
+                ecosystems.push({
+                    name: framework,
+                    confidence: 'high',
+                    detectedFrom: `package.json (${matchedDep})`,
+                    configFiles: [...configFiles, ...(eslintPlugins.length > 0 ? ['.eslintrc'] : [])],
+                    version: version?.replace(/[\^~]/, ''),
+                });
+            }
+        }
+        return ecosystems;
+    }
+    async findFrontendConfigFiles(projectPath, configFiles) {
+        const found = [];
+        for (const configFile of configFiles) {
+            if (await this.fileExists(path.join(projectPath, configFile))) {
+                found.push(configFile);
+            }
+        }
+        return found;
+    }
+    async detectEslintPlugins(projectPath, plugins) {
+        const eslintConfigs = [
+            '.eslintrc.json',
+            '.eslintrc.js',
+            '.eslintrc.cjs',
+            '.eslintrc.yml',
+            'eslint.config.js',
+            'eslint.config.mjs',
+        ];
+        for (const config of eslintConfigs) {
+            const configPath = path.join(projectPath, config);
+            if (await this.fileExists(configPath)) {
+                try {
+                    const content = await readFile(configPath, 'utf-8');
+                    return plugins.filter((plugin) => content.includes(plugin));
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        return [];
+    }
+    async extractVersion(projectPath, ecosystem, detectedFrom) {
+        try {
+            switch (ecosystem) {
+                case 'typescript': {
+                    const packagePath = path.join(projectPath, 'package.json');
+                    const content = await readFile(packagePath, 'utf-8');
+                    const pkg = JSON.parse(content);
+                    return (pkg.devDependencies?.typescript ||
+                        pkg.dependencies?.typescript)?.replace(/[\^~]/, '');
+                }
+                case 'python': {
+                    const pythonVersionPath = path.join(projectPath, '.python-version');
+                    if (await this.fileExists(pythonVersionPath)) {
+                        const version = await readFile(pythonVersionPath, 'utf-8');
+                        return version.trim();
+                    }
+                    // Try pyproject.toml
+                    const pyprojectPath = path.join(projectPath, 'pyproject.toml');
+                    if (await this.fileExists(pyprojectPath)) {
+                        const content = await readFile(pyprojectPath, 'utf-8');
+                        const match = content.match(/python\s*=\s*"([^"]+)"/);
+                        return match?.[1];
+                    }
+                    break;
+                }
+                case 'go': {
+                    const goModPath = path.join(projectPath, 'go.mod');
+                    const content = await readFile(goModPath, 'utf-8');
+                    const match = content.match(/^go\s+(\d+\.\d+(?:\.\d+)?)/m);
+                    return match?.[1];
+                }
+                case 'java': {
+                    // Check pom.xml for Java version
+                    const pomPath = path.join(projectPath, 'pom.xml');
+                    if (await this.fileExists(pomPath)) {
+                        const content = await readFile(pomPath, 'utf-8');
+                        const match = content.match(/<java\.version>([^<]+)<\/java\.version>/);
+                        return match?.[1];
+                    }
+                    break;
+                }
+                case 'rust': {
+                    const cargoPath = path.join(projectPath, 'Cargo.toml');
+                    const content = await readFile(cargoPath, 'utf-8');
+                    const match = content.match(/rust-version\s*=\s*"([^"]+)"/);
+                    return match?.[1];
+                }
+                case 'dotnet': {
+                    // Check .csproj for TargetFramework
+                    const files = await readdir(projectPath);
+                    const csproj = files.find((f) => f.endsWith('.csproj'));
+                    if (csproj) {
+                        const content = await readFile(path.join(projectPath, csproj), 'utf-8');
+                        const match = content.match(/<TargetFramework>([^<]+)<\/TargetFramework>/);
+                        return match?.[1];
+                    }
+                    break;
+                }
+            }
+        }
+        catch {
+            // Version extraction is optional, don't fail on errors
+        }
+        return undefined;
+    }
+    async fileExists(filePath) {
+        try {
+            await stat(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async findByGlobPattern(projectPath, pattern) {
+        try {
+            const files = await readdir(projectPath);
+            const regex = new RegExp('^' + pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$');
+            const match = files.find((f) => regex.test(f));
+            return match || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Convenience function for quick ecosystem detection
+ */
+export async function detectEcosystems(projectPath, options) {
+    const detector = new EcosystemDetector(options);
+    return detector.detectEcosystems(projectPath);
+}
+//# sourceMappingURL=ecosystem-detector.js.map

package/dist/src/core/living-docs/governance/ecosystem-detector.js.map

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

package/dist/src/core/living-docs/governance/frontend-standards-parser.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Frontend Standards Parser - Detect and parse React/Angular/Vue coding standards
+ *
+ * Detects framework from package.json, parses ESLint plugins, and extracts conventions
+ */
+import { Logger } from '../../../utils/logger.js';
+export type FrontendFramework = 'react' | 'angular' | 'vue' | 'svelte' | 'none';
+export interface FrontendStandards {
+    framework: FrontendFramework;
+    frameworkVersion?: string;
+    stateManagement?: StateManagementConfig;
+    cssMethodology?: CssMethodologyConfig;
+    testing: TestingConfig;
+    bundler?: BundlerConfig;
+    eslintPlugins: string[];
+    componentNaming: ComponentNamingConfig;
+    hooks?: HooksConfig;
+    routing?: RoutingConfig;
+    warnings: string[];
+}
+export interface StateManagementConfig {
+    name: string;
+    version?: string;
+}
+export interface CssMethodologyConfig {
+    name: string;
+    details?: string;
+}
+export interface TestingConfig {
+    frameworks: string[];
+    e2e?: string;
+    coverage?: boolean;
+}
+export interface BundlerConfig {
+    name: string;
+    version?: string;
+}
+export interface ComponentNamingConfig {
+    convention: 'PascalCase' | 'kebab-case' | 'camelCase';
+    fileExtension: string;
+    folderStructure?: string;
+}
+export interface HooksConfig {
+    enabled: boolean;
+    customHooksPattern?: string;
+}
+export interface RoutingConfig {
+    library: string;
+    version?: string;
+}
+export interface FrontendStandardsParserOptions {
+    logger?: Logger;
+}
+export declare class FrontendStandardsParser {
+    private logger;
+    constructor(options?: FrontendStandardsParserOptions);
+    parse(projectPath: string): Promise<FrontendStandards>;
+    private detectFramework;
+    private setFrameworkDefaults;
+    private detectStateManagement;
+    private detectCssMethodology;
+    private detectTesting;
+    private detectBundler;
+    private detectRouting;
+    private detectEslintPlugins;
+    private parseAngularConfig;
+    private parseVueConfig;
+    private fileExists;
+}
+/**
+ * Convenience function for quick frontend standards parsing
+ */
+export declare function parseFrontendStandards(projectPath: string, options?: FrontendStandardsParserOptions): Promise<FrontendStandards>;
+//# sourceMappingURL=frontend-standards-parser.d.ts.map

package/dist/src/core/living-docs/governance/frontend-standards-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-standards-parser.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/governance/frontend-standards-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,MAAM,EAAiB,MAAM,0BAA0B,CAAC;AAKjE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,qBAAqB,CAAC;IACvC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0DD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,8BAAmC;IAIlD,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2E5D,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,oBAAoB;IAwC5B,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;YA4BP,mBAAmB;YA8DnB,kBAAkB;YAqClB,cAAc;YA0Bd,UAAU;CAQzB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}