@planu/cli 0.24.0 → 0.25.0

package/dist/engine/ai-cost-estimator/token-estimator.js

@@ -0,0 +1,194 @@
+// engine/ai-cost-estimator/token-estimator.ts — Token count estimation logic.
+// Calculates input tokens (spec + codebase + tools) and output tokens (code generation).
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants (overridden by config)
+// ---------------------------------------------------------------------------
+const DEFAULT_TOOL_DEFINITIONS_TOKENS = 4000;
+const DEFAULT_CHARS_PER_TOKEN = 3.5;
+const DEFAULT_AVG_LOC_CHARS = 45;
+const DEFAULT_LOC_PER_AC = 50;
+// ---------------------------------------------------------------------------
+// Language detection
+// ---------------------------------------------------------------------------
+const LANGUAGE_FILE_EXTENSIONS = {
+    typescript: ['.ts', '.tsx'],
+    javascript: ['.js', '.jsx', '.mjs', '.cjs'],
+    python: ['.py'],
+    go: ['.go'],
+    rust: ['.rs'],
+    java: ['.java'],
+    kotlin: ['.kt', '.kts'],
+    swift: ['.swift'],
+    ruby: ['.rb'],
+    php: ['.php'],
+    csharp: ['.cs'],
+    dart: ['.dart'],
+};
+const LANGUAGE_CONFIG_FILES = {
+    typescript: ['tsconfig.json', 'package.json'],
+    python: ['pyproject.toml', 'setup.cfg', 'setup.py', 'requirements.txt'],
+    go: ['go.mod'],
+    rust: ['Cargo.toml'],
+    java: ['pom.xml', 'build.gradle'],
+    kotlin: ['build.gradle.kts'],
+    swift: ['Package.swift'],
+    ruby: ['Gemfile'],
+    php: ['composer.json'],
+    csharp: ['.csproj'],
+    dart: ['pubspec.yaml'],
+};
+/**
+ * Detects the primary programming language of a project by checking config files.
+ * Falls back to scanning source file extensions.
+ */
+export async function detectProjectLanguage(projectPath) {
+    // Check config file markers first (most reliable)
+    for (const [lang, markers] of Object.entries(LANGUAGE_CONFIG_FILES)) {
+        for (const marker of markers) {
+            try {
+                await stat(join(projectPath, marker));
+                return lang;
+            }
+            catch {
+                // File does not exist, continue
+            }
+        }
+    }
+    return 'default';
+}
+// ---------------------------------------------------------------------------
+// Codebase scanning
+// ---------------------------------------------------------------------------
+const MAX_SCAN_DEPTH = 5;
+const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '__pycache__', '.next']);
+/** Recursively counts total characters in source files up to a given depth. */
+async function countCodebaseChars(dirPath, depth) {
+    if (depth > MAX_SCAN_DEPTH) {
+        return 0;
+    }
+    let totalChars = 0;
+    let entries;
+    try {
+        entries = await readdir(dirPath, { withFileTypes: true, encoding: 'utf-8' });
+    }
+    catch {
+        return 0;
+    }
+    for (const entry of entries) {
+        const entryName = entry.name;
+        if (EXCLUDED_DIRS.has(entryName)) {
+            continue;
+        }
+        const fullPath = join(dirPath, entryName);
+        if (entry.isDirectory()) {
+            totalChars += await countCodebaseChars(fullPath, depth + 1);
+        }
+        else if (entry.isFile() && isSourceFile(entryName)) {
+            try {
+                const content = await readFile(fullPath, 'utf-8');
+                totalChars += content.length;
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    return totalChars;
+}
+/** Returns true if the file extension is a known source file type. */
+function isSourceFile(filename) {
+    const ext = filename.slice(filename.lastIndexOf('.'));
+    const allExtensions = Object.values(LANGUAGE_FILE_EXTENSIONS).flat();
+    return allExtensions.includes(ext);
+}
+// ---------------------------------------------------------------------------
+// Input token estimation
+// ---------------------------------------------------------------------------
+/**
+ * Estimates input tokens for an AI agent session based on three components:
+ * 1. Spec content (HU.md + FICHA-TECNICA.md)
+ * 2. Codebase context (if projectPath is provided)
+ * 3. MCP tool definitions overhead (fixed constant)
+ */
+export async function estimateInputTokens(specContent, projectPath, config) {
+    const charsPerToken = config.constants.charsPerToken || DEFAULT_CHARS_PER_TOKEN;
+    const toolDefinitionsTokens = config.constants.toolDefinitionsOverheadTokens || DEFAULT_TOOL_DEFINITIONS_TOKENS;
+    // 1. Spec content tokens
+    const specContentTokens = Math.ceil(specContent.length / charsPerToken);
+    // 2. Codebase context tokens (optional)
+    let codebaseContextTokens = 0;
+    if (projectPath) {
+        const codebaseChars = await countCodebaseChars(projectPath, 0);
+        codebaseContextTokens = Math.ceil(codebaseChars / charsPerToken);
+    }
+    const inputTokens = specContentTokens + codebaseContextTokens + toolDefinitionsTokens;
+    return {
+        inputTokens,
+        specContentTokens,
+        codebaseContextTokens,
+        toolDefinitionsTokens,
+    };
+}
+// ---------------------------------------------------------------------------
+// Output token estimation
+// ---------------------------------------------------------------------------
+/**
+ * Estimates output tokens (code to be generated) for a spec.
+ *
+ * Priority:
+ * 1. Use LOC from existing estimate if available
+ * 2. Fallback: number of ACs × DEFAULT_LOC_PER_AC
+ * 3. Calibrate with usage.json average if available
+ */
+export function estimateOutputTokens(locToGenerate, language, config, usageAvgTokensPerCall) {
+    const avgLOCChars = config.constants.avgLOCChars || DEFAULT_AVG_LOC_CHARS;
+    // Look up the language token ratio from config
+    const ratioKey = language.toLowerCase();
+    const tokensPerChar = config.languageTokenRatios[ratioKey] ??
+        config.languageTokenRatios.default ??
+        DEFAULT_CHARS_PER_TOKEN;
+    // Base estimate: LOC × chars/LOC × tokens/char
+    let outputTokens = Math.ceil(locToGenerate * avgLOCChars * tokensPerChar);
+    // Calibrate with usage data if available
+    if (usageAvgTokensPerCall !== undefined && usageAvgTokensPerCall > 0) {
+        // Blend: 70% formula estimate, 30% historical calibration
+        outputTokens = Math.ceil(outputTokens * 0.7 + usageAvgTokensPerCall * 0.3);
+    }
+    return outputTokens;
+}
+/**
+ * Estimates LOC to generate based on the number of acceptance criteria.
+ * Used as a fallback when no existing estimate is available.
+ */
+export function estimateLocFromAcCount(acCount) {
+    return acCount * DEFAULT_LOC_PER_AC;
+}
+// ---------------------------------------------------------------------------
+// Full token estimate
+// ---------------------------------------------------------------------------
+/**
+ * Produces a complete TokenEstimate for a spec.
+ */
+export async function buildTokenEstimate(specContent, locToGenerate, acCount, projectPath, config, usageAvgTokensPerCall) {
+    // Detect language for token ratio lookup
+    const language = projectPath ? await detectProjectLanguage(projectPath) : 'default';
+    // Estimate input components
+    const { inputTokens, specContentTokens, codebaseContextTokens, toolDefinitionsTokens } = await estimateInputTokens(specContent, projectPath, config);
+    // Use provided LOC or fallback to AC-based estimate
+    const effectiveLOC = locToGenerate > 0 ? locToGenerate : estimateLocFromAcCount(acCount);
+    // Estimate output tokens
+    const outputTokens = estimateOutputTokens(effectiveLOC, language, config, usageAvgTokensPerCall);
+    return {
+        inputTokens,
+        outputTokens,
+        specContentTokens,
+        codebaseContextTokens,
+        toolDefinitionsTokens,
+        locToGenerate: effectiveLOC,
+        language,
+        calibratedFromUsage: usageAvgTokensPerCall !== undefined && usageAvgTokensPerCall > 0,
+    };
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/engine/ai-cost-estimator/token-estimator.js.map

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

package/dist/engine/ci-generator/context-builders.d.ts

@@ -0,0 +1,4 @@
+import type { CIEcosystem, CIStackContext } from '../../types/index.js';
+/** Build a CIStackContext for the detected ecosystem. */
+export declare function buildContextForEcosystem(ecosystem: CIEcosystem, projectPath: string, hasDocker: boolean): Promise<CIStackContext>;
+//# sourceMappingURL=context-builders.d.ts.map

package/dist/engine/ci-generator/context-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builders.d.ts","sourceRoot":"","sources":["../../../src/engine/ci-generator/context-builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA6HxE,yDAAyD;AACzD,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,WAAW,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,cAAc,CAAC,CA0BzB"}

package/dist/engine/ci-generator/context-builders.js

@@ -0,0 +1,129 @@
+// ci-generator/context-builders.ts — Build CIStackContext per ecosystem (SPEC-066)
+import { detectNodePackageManager, detectNodeVersion, buildNodeCommands, detectPythonPackageManager, detectPythonVersion, detectGoVersion, detectRustChannel, detectJavaVersion, detectJavaBuildTool, } from './stack-detector.js';
+/** Build context for Node.js/TypeScript projects. */
+async function buildNodeContext(projectPath, hasDocker) {
+    const pm = await detectNodePackageManager(projectPath);
+    const nodeVersion = await detectNodeVersion(projectPath);
+    const cmds = buildNodeCommands(pm);
+    return {
+        ecosystem: 'nodejs',
+        language: 'typescript',
+        packageManager: pm,
+        testCommand: cmds.test,
+        lintCommand: cmds.lint,
+        buildCommand: cmds.build,
+        hasDocker,
+        nodeVersion,
+    };
+}
+/** Build context for Python projects. */
+async function buildPythonContext(projectPath, hasDocker) {
+    const pm = await detectPythonPackageManager(projectPath);
+    const pythonVersion = await detectPythonVersion(projectPath);
+    const lintCmd = pm === 'uv' ? 'uv run ruff check .' : 'ruff check .';
+    const testCmd = pm === 'poetry' ? 'poetry run pytest' : pm === 'uv' ? 'uv run pytest' : 'pytest';
+    const buildCmd = pm === 'poetry' ? 'poetry build' : pm === 'uv' ? 'uv build' : 'python -m build';
+    return {
+        ecosystem: 'python',
+        language: 'python',
+        packageManager: pm,
+        testCommand: testCmd,
+        lintCommand: lintCmd,
+        buildCommand: buildCmd,
+        hasDocker,
+        pythonVersion,
+    };
+}
+/** Build context for JVM-based projects (Java/Kotlin). */
+async function buildJvmContext(ecosystem, projectPath, hasDocker) {
+    const javaVersion = await detectJavaVersion(projectPath);
+    const javaBuildTool = await detectJavaBuildTool(projectPath);
+    const isMaven = javaBuildTool === 'maven';
+    return {
+        ecosystem,
+        language: ecosystem,
+        packageManager: javaBuildTool,
+        testCommand: isMaven ? 'mvn test' : './gradlew test',
+        lintCommand: isMaven ? 'mvn checkstyle:check' : './gradlew checkstyleMain',
+        buildCommand: isMaven ? 'mvn package -DskipTests' : './gradlew build -x test',
+        hasDocker,
+        javaVersion,
+        javaDistribution: 'temurin',
+        javaBuildTool,
+    };
+}
+// -- Static ecosystem configs (no async detection needed) ---------------------
+const STATIC_ECOSYSTEMS = {
+    go: ['go', 'go mod', 'go test ./...', 'golangci-lint run', 'go build ./...'],
+    rust: ['rust', 'cargo', 'cargo test', 'cargo clippy -- -D warnings', 'cargo build --release'],
+    ruby: ['ruby', 'bundler', 'bundle exec rspec', 'bundle exec rubocop', 'gem build *.gemspec'],
+    php: [
+        'php',
+        'composer',
+        'vendor/bin/phpunit',
+        'vendor/bin/phpstan analyse',
+        'composer install --no-dev --optimize-autoloader',
+    ],
+    dart: ['dart', 'pub', 'flutter test', 'dart analyze', 'flutter build'],
+    dotnet: [
+        'csharp',
+        'nuget',
+        'dotnet test',
+        'dotnet format --verify-no-changes',
+        'dotnet build --configuration Release',
+    ],
+    unknown: [
+        'unknown',
+        'unknown',
+        'echo "No test command configured"',
+        'echo "No lint command configured"',
+        'echo "No build command configured"',
+    ],
+};
+function buildStaticContext(ecosystem, hasDocker) {
+    const cfg = STATIC_ECOSYSTEMS[ecosystem];
+    /* v8 ignore next 5 */
+    const lang = cfg?.[0] ?? 'unknown';
+    const pm = cfg?.[1] ?? 'unknown';
+    const test = cfg?.[2] ?? 'echo "No test command configured"';
+    const lint = cfg?.[3] ?? 'echo "No lint command configured"';
+    const build = cfg?.[4] ?? 'echo "No build command configured"';
+    return {
+        ecosystem,
+        language: lang,
+        packageManager: pm,
+        testCommand: test,
+        lintCommand: lint,
+        buildCommand: build,
+        hasDocker,
+    };
+}
+/** Build a CIStackContext for the detected ecosystem. */
+export async function buildContextForEcosystem(ecosystem, projectPath, hasDocker) {
+    switch (ecosystem) {
+        case 'nodejs':
+            return buildNodeContext(projectPath, hasDocker);
+        case 'python':
+            return buildPythonContext(projectPath, hasDocker);
+        case 'go':
+            return {
+                ...buildStaticContext(ecosystem, hasDocker),
+                goVersion: await detectGoVersion(projectPath),
+            };
+        case 'rust':
+            return {
+                ...buildStaticContext(ecosystem, hasDocker),
+                rustChannel: await detectRustChannel(projectPath),
+            };
+        case 'java':
+        case 'kotlin':
+            return buildJvmContext(ecosystem, projectPath, hasDocker);
+        case 'ruby':
+        case 'php':
+        case 'dart':
+        case 'dotnet':
+        case 'unknown':
+            return buildStaticContext(ecosystem, hasDocker);
+    }
+}
+//# sourceMappingURL=context-builders.js.map

package/dist/engine/ci-generator/context-builders.js.map

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

package/dist/engine/ci-generator/index.d.ts

@@ -0,0 +1,7 @@
+import type { GenerateCIInput, GenerateCIResult } from '../../types/index.js';
+/**
+ * Generate a GitHub Actions CI workflow for a project.
+ * Detects the project stack and generates a valid workflow YAML.
+ */
+export declare function generateCI(input: GenerateCIInput): Promise<GenerateCIResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/ci-generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/ci-generator/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAS9B;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+ClF"}

package/dist/engine/ci-generator/index.js

@@ -0,0 +1,44 @@
+// ci-generator/index.ts — Public API for the CI workflow generator (SPEC-066)
+import { detectCIStack } from './stack-detector.js';
+import { buildWorkflow, serializeWorkflow } from './yaml-builder.js';
+const DEFAULT_JOBS = ['lint', 'test', 'build'];
+const DEFAULT_TRIGGERS = ['push', 'pull_request'];
+const DEFAULT_WORKFLOW_NAME = 'CI';
+/**
+ * Generate a GitHub Actions CI workflow for a project.
+ * Detects the project stack and generates a valid workflow YAML.
+ */
+export async function generateCI(input) {
+    const { projectPath, jobs = DEFAULT_JOBS, triggers = DEFAULT_TRIGGERS, nodeVersion, pythonVersion, goVersion, rustChannel, javaVersion, workflowName = DEFAULT_WORKFLOW_NAME, } = input;
+    // Detect stack from project files, create a mutable copy
+    const detected = await detectCIStack(projectPath);
+    const stackContext = { ...detected };
+    // Override detected versions with explicit user inputs
+    if (nodeVersion !== undefined) {
+        stackContext.nodeVersion = nodeVersion;
+    }
+    if (pythonVersion !== undefined) {
+        stackContext.pythonVersion = pythonVersion;
+    }
+    if (goVersion !== undefined) {
+        stackContext.goVersion = goVersion;
+    }
+    if (rustChannel !== undefined) {
+        stackContext.rustChannel = rustChannel;
+    }
+    if (javaVersion !== undefined) {
+        stackContext.javaVersion = javaVersion;
+    }
+    // Build the workflow model
+    const workflow = buildWorkflow(stackContext, jobs, triggers, workflowName);
+    // Serialize to YAML
+    const yamlContent = serializeWorkflow(workflow);
+    return {
+        ecosystem: stackContext.ecosystem,
+        workflowPath: workflow.filename,
+        yamlContent,
+        jobs,
+        stackContext,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/ci-generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/ci-generator/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAS9E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,YAAY,GAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,MAAM,gBAAgB,GAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACpE,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,EACJ,WAAW,EACX,IAAI,GAAG,YAAY,EACnB,QAAQ,GAAG,gBAAgB,EAC3B,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,GAAG,qBAAqB,GACrC,GAAG,KAAK,CAAC;IAEV,yDAAyD;IACzD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAErC,uDAAuD;IACvD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,YAAY,CAAC,WAAW,GAAG,WAAW,CAAC;IACzC,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,YAAY,CAAC,aAAa,GAAG,aAAa,CAAC;IAC7C,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,YAAY,CAAC,SAAS,GAAG,SAAS,CAAC;IACrC,CAAC;IACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,YAAY,CAAC,WAAW,GAAG,WAAW,CAAC;IACzC,CAAC;IACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,YAAY,CAAC,WAAW,GAAG,WAAW,CAAC;IACzC,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE3E,oBAAoB;IACpB,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO;QACL,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,YAAY,EAAE,QAAQ,CAAC,QAAQ;QAC/B,WAAW;QACX,IAAI;QACJ,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/engine/ci-generator/stack-detector.d.ts

@@ -0,0 +1,21 @@
+import type { CIStackContext, JavaBuildTool } from '../../types/index.js';
+export declare function detectNodePackageManager(projectPath: string): Promise<string>;
+export declare function detectNodeVersion(projectPath: string): Promise<string>;
+export declare function buildNodeCommands(pm: string): {
+    install: string;
+    lint: string;
+    test: string;
+    build: string;
+};
+export declare function detectPythonPackageManager(projectPath: string): Promise<string>;
+export declare function detectPythonVersion(projectPath: string): Promise<string>;
+export declare function detectGoVersion(projectPath: string): Promise<string>;
+export declare function detectRustChannel(projectPath: string): Promise<string>;
+export declare function detectJavaVersion(projectPath: string): Promise<string>;
+export declare function detectJavaBuildTool(projectPath: string): Promise<JavaBuildTool>;
+/**
+ * Detect the full stack context of a project for CI generation.
+ * Reads config files to determine ecosystem, package manager, versions, and commands.
+ */
+export declare function detectCIStack(projectPath: string): Promise<CIStackContext>;
+//# sourceMappingURL=stack-detector.d.ts.map

package/dist/engine/ci-generator/stack-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/ci-generator/stack-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAe,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA4EvF,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWnF;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB5E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAWA;AAID,wBAAsB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASrF;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9E;AAID,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E;AAID,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5E;AAID,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB5E;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAKrF;AAcD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAIhF"}

package/dist/engine/ci-generator/stack-detector.js

@@ -0,0 +1,203 @@
+// ci-generator/stack-detector.ts — Detect project stack for CI generation (SPEC-066)
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { buildContextForEcosystem } from './context-builders.js';
+// -- File existence helper ---------------------------------------------------
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readTextSafe(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+async function readJsonSafe(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+// -- Ecosystem detection -----------------------------------------------------
+async function detectEcosystem(projectPath) {
+    if (await fileExists(join(projectPath, 'go.mod'))) {
+        return 'go';
+    }
+    if (await fileExists(join(projectPath, 'Cargo.toml'))) {
+        return 'rust';
+    }
+    if (await fileExists(join(projectPath, 'pom.xml'))) {
+        return 'java';
+    }
+    if (await fileExists(join(projectPath, 'build.gradle'))) {
+        return 'java';
+    }
+    if (await fileExists(join(projectPath, 'build.gradle.kts'))) {
+        return 'kotlin';
+    }
+    if (await fileExists(join(projectPath, 'Gemfile'))) {
+        return 'ruby';
+    }
+    if (await fileExists(join(projectPath, 'composer.json'))) {
+        return 'php';
+    }
+    if (await fileExists(join(projectPath, 'pubspec.yaml'))) {
+        return 'dart';
+    }
+    if (await fileExists(join(projectPath, 'package.json'))) {
+        return 'nodejs';
+    }
+    if ((await fileExists(join(projectPath, 'pyproject.toml'))) ||
+        (await fileExists(join(projectPath, 'requirements.txt'))) ||
+        (await fileExists(join(projectPath, 'setup.py')))) {
+        return 'python';
+    }
+    if (await fileExists(join(projectPath, 'global.json'))) {
+        return 'dotnet';
+    }
+    return 'unknown';
+}
+// -- Node.js helpers ---------------------------------------------------------
+export async function detectNodePackageManager(projectPath) {
+    if (await fileExists(join(projectPath, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if (await fileExists(join(projectPath, 'bun.lockb'))) {
+        return 'bun';
+    }
+    if (await fileExists(join(projectPath, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    return 'npm';
+}
+export async function detectNodeVersion(projectPath) {
+    const nvmrc = await readTextSafe(join(projectPath, '.nvmrc'));
+    if (nvmrc.trim()) {
+        return nvmrc.trim();
+    }
+    const nodeVer = await readTextSafe(join(projectPath, '.node-version'));
+    if (nodeVer.trim()) {
+        return nodeVer.trim();
+    }
+    const pkg = await readJsonSafe(join(projectPath, 'package.json'));
+    if (pkg) {
+        const engines = pkg.engines;
+        if (engines?.node) {
+            const match = /(\d+)/.exec(engines.node);
+            return match?.[1] ?? '20';
+        }
+    }
+    return '20';
+}
+export function buildNodeCommands(pm) {
+    const run = pm === 'npm' ? 'npm run' : pm === 'bun' ? 'bun run' : `${pm} run`;
+    const install = pm === 'pnpm'
+        ? 'pnpm install --frozen-lockfile'
+        : pm === 'yarn'
+            ? 'yarn install --frozen-lockfile'
+            : pm === 'bun'
+                ? 'bun install --frozen-lockfile'
+                : 'npm ci';
+    return { install, lint: `${run} lint`, test: `${run} test`, build: `${run} build` };
+}
+// -- Python helpers ----------------------------------------------------------
+export async function detectPythonPackageManager(projectPath) {
+    const pyproject = await readTextSafe(join(projectPath, 'pyproject.toml'));
+    if (pyproject.includes('[tool.poetry]')) {
+        return 'poetry';
+    }
+    if (await fileExists(join(projectPath, 'uv.lock'))) {
+        return 'uv';
+    }
+    return 'pip';
+}
+export async function detectPythonVersion(projectPath) {
+    const pyVer = await readTextSafe(join(projectPath, '.python-version'));
+    if (pyVer.trim()) {
+        return pyVer.trim();
+    }
+    const pyproject = await readTextSafe(join(projectPath, 'pyproject.toml'));
+    if (pyproject) {
+        const match = /requires-python\s*=\s*"([^"]+)"/.exec(pyproject);
+        if (match?.[1]) {
+            const verMatch = /(\d+\.\d+)/.exec(match[1]);
+            return verMatch?.[1] ?? '3.11';
+        }
+    }
+    return '3.11';
+}
+// -- Go helpers --------------------------------------------------------------
+export async function detectGoVersion(projectPath) {
+    const goMod = await readTextSafe(join(projectPath, 'go.mod'));
+    const match = /^go\s+(\S+)/m.exec(goMod);
+    return match?.[1] ?? '1.22';
+}
+// -- Rust helpers ------------------------------------------------------------
+export async function detectRustChannel(projectPath) {
+    const toolchain = await readTextSafe(join(projectPath, 'rust-toolchain.toml'));
+    if (toolchain) {
+        const match = /channel\s*=\s*"([^"]+)"/.exec(toolchain);
+        if (match?.[1]) {
+            return match[1];
+        }
+    }
+    const toolchainFile = await readTextSafe(join(projectPath, 'rust-toolchain'));
+    if (toolchainFile.trim()) {
+        return toolchainFile.trim();
+    }
+    return 'stable';
+}
+// -- Java helpers ------------------------------------------------------------
+export async function detectJavaVersion(projectPath) {
+    const pom = await readTextSafe(join(projectPath, 'pom.xml'));
+    if (pom) {
+        const match = /<java.version>([^<]+)</.exec(pom) ?? /<maven.compiler.source>([^<]+)</.exec(pom);
+        if (match?.[1]) {
+            return match[1];
+        }
+    }
+    for (const gradleFile of ['build.gradle.kts', 'build.gradle']) {
+        const gradle = await readTextSafe(join(projectPath, gradleFile));
+        if (gradle) {
+            const match = /(?:sourceCompatibility|jvmTarget)\s*[=:]\s*['"]?(\S+?)['"]?\s/m.exec(gradle);
+            if (match?.[1]) {
+                return match[1];
+            }
+        }
+    }
+    return '21';
+}
+export async function detectJavaBuildTool(projectPath) {
+    if (await fileExists(join(projectPath, 'pom.xml'))) {
+        return 'maven';
+    }
+    return 'gradle';
+}
+// -- Docker detection --------------------------------------------------------
+async function detectHasDocker(projectPath) {
+    return ((await fileExists(join(projectPath, 'Dockerfile'))) ||
+        (await fileExists(join(projectPath, 'docker-compose.yml'))) ||
+        (await fileExists(join(projectPath, 'docker-compose.yaml'))));
+}
+// -- Main export -------------------------------------------------------------
+/**
+ * Detect the full stack context of a project for CI generation.
+ * Reads config files to determine ecosystem, package manager, versions, and commands.
+ */
+export async function detectCIStack(projectPath) {
+    const ecosystem = await detectEcosystem(projectPath);
+    const hasDocker = await detectHasDocker(projectPath);
+    return buildContextForEcosystem(ecosystem, projectPath, hasDocker);
+}
+//# sourceMappingURL=stack-detector.js.map