specforge-mcp 0.1.0

package/dist/engine/analyzer-db.js

@@ -0,0 +1,137 @@
+// SpecForge — DB Engine Detection (SPEC-025)
+// Detects database engine from project dependencies and generates adapted SQL syntax
+import { readFile } from 'node:fs/promises';
+import { collectDependencies } from './detection-utils.js';
+// === Registry loading ===
+let registryCache = null;
+/** Resets the in-memory cache — used in tests to force reload */
+export function resetDbRegistryCache() {
+    registryCache = null;
+}
+async function loadDbRegistry() {
+    if (registryCache) {
+        return registryCache;
+    }
+    try {
+        const configPath = new URL('../config/db-engines.json', import.meta.url);
+        const content = await readFile(configPath, 'utf-8');
+        registryCache = JSON.parse(content);
+        return registryCache;
+    }
+    catch {
+        return {
+            engines: {},
+            sqlSyntax: { createTable: {}, primaryKeyConstraint: {}, autoTimestamps: {} },
+        };
+    }
+}
+// === DB Engine detection ===
+export async function detectDBEngine(projectPath) {
+    const registry = await loadDbRegistry();
+    const deps = await collectDependencies(projectPath);
+    for (const [engineKey, engine] of Object.entries(registry.engines)) {
+        const allDeps = [...engine.detectionDeps, ...(engine.prismaDeps ?? [])];
+        for (const dep of allDeps) {
+            if (deps.has(dep)) {
+                return {
+                    engine: engineKey,
+                    detectedFrom: dep,
+                    features: engine.features,
+                    securityRules: engine.securityRules,
+                };
+            }
+        }
+    }
+    return null;
+}
+// === SQL syntax adapters ===
+export function getSQLSyntaxForEngine(engine) {
+    const defaults = {
+        createTable: 'CREATE TABLE IF NOT EXISTS',
+        primaryKey: 'PRIMARY KEY',
+        autoTimestamp: 'DEFAULT now()',
+        idType: 'uuid DEFAULT gen_random_uuid()',
+        jsonType: 'jsonb',
+        autoIncrement: 'GENERATED ALWAYS AS IDENTITY',
+    };
+    switch (engine) {
+        case 'supabase':
+        case 'postgresql':
+            return {
+                createTable: 'CREATE TABLE IF NOT EXISTS',
+                primaryKey: 'PRIMARY KEY',
+                autoTimestamp: 'DEFAULT now()',
+                idType: 'uuid DEFAULT gen_random_uuid()',
+                jsonType: 'jsonb',
+                autoIncrement: 'GENERATED ALWAYS AS IDENTITY',
+            };
+        case 'mysql':
+            return {
+                createTable: 'CREATE TABLE IF NOT EXISTS',
+                primaryKey: 'PRIMARY KEY',
+                autoTimestamp: 'DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP',
+                idType: 'CHAR(36) DEFAULT (UUID())',
+                jsonType: 'JSON',
+                autoIncrement: 'AUTO_INCREMENT',
+            };
+        case 'sqlite':
+            return {
+                createTable: 'CREATE TABLE IF NOT EXISTS',
+                primaryKey: 'PRIMARY KEY',
+                autoTimestamp: "DEFAULT (datetime('now'))",
+                idType: 'TEXT DEFAULT (lower(hex(randomblob(16))))',
+                jsonType: 'TEXT',
+                autoIncrement: 'AUTOINCREMENT',
+            };
+        case 'mongodb':
+            return {
+                createTable: 'db.createCollection',
+                primaryKey: '_id',
+                autoTimestamp: 'ISODate()',
+                idType: 'ObjectId',
+                jsonType: 'BSON',
+                autoIncrement: 'ObjectId()',
+            };
+        case 'firebase':
+            return {
+                createTable: '// Firestore collection (no DDL)',
+                primaryKey: 'document.id',
+                autoTimestamp: 'FieldValue.serverTimestamp()',
+                idType: 'string (auto-generated)',
+                jsonType: 'Map<string, any>',
+                autoIncrement: 'Firestore auto-ID',
+            };
+        default:
+            return defaults;
+    }
+}
+// === Firestore security rules generation ===
+export function generateFirestoreRules(collections) {
+    const rules = [
+        "rules_version = '2';",
+        'service cloud.firestore {',
+        '  match /databases/{database}/documents {',
+    ];
+    for (const collection of collections) {
+        rules.push(`    match /${collection}/{document=**} {`, `      allow read: if request.auth != null;`, `      allow write: if request.auth != null && request.auth.uid == resource.data.userId;`, `    }`);
+    }
+    rules.push('  }', '}');
+    return rules.join('\n');
+}
+// === MongoDB schema generation ===
+export function generateMongoSchema(collections) {
+    const lines = ['// MongoDB Collection Schemas', ''];
+    for (const collection of collections) {
+        lines.push(`// ${collection} collection`, `db.createCollection("${collection}", {`, `  validator: {`, `    $jsonSchema: {`, `      bsonType: "object",`, `      required: ["_id", "createdAt", "updatedAt"],`, `      properties: {`, `        _id: { bsonType: "objectId", description: "Primary key" },`, `        createdAt: { bsonType: "date", description: "Creation timestamp" },`, `        updatedAt: { bsonType: "date", description: "Last update timestamp" }`, `      }`, `    }`, `  }`, `});`, ``, `db.${collection}.createIndex({ createdAt: -1 });`, ``);
+    }
+    return lines.join('\n');
+}
+// === Supabase RLS helper ===
+export function generateSupabaseRLS(tables) {
+    const lines = ['-- Supabase RLS Policies', ''];
+    for (const table of tables) {
+        lines.push(`-- Enable RLS on ${table}`, `ALTER TABLE ${table} ENABLE ROW LEVEL SECURITY;`, ``, `-- Allow authenticated users to read`, `CREATE POLICY "${table}_select_authenticated"`, `  ON ${table} FOR SELECT`, `  USING (auth.role() = 'authenticated');`, ``, `-- Allow users to manage their own records`, `CREATE POLICY "${table}_all_owner"`, `  ON ${table} FOR ALL`, `  USING (auth.uid() = user_id)`, `  WITH CHECK (auth.uid() = user_id);`, ``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=analyzer-db.js.map

package/dist/engine/analyzer-db.js.map

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

package/dist/engine/analyzer-detectors.d.ts

@@ -0,0 +1,7 @@
+import type { LintingAnalysis } from '../types/index.js';
+export declare function analyzeLinting(projectPath: string): Promise<LintingAnalysis>;
+export declare function detectConventions(projectPath: string): Promise<Record<string, string>>;
+export declare function detectEnvironments(projectPath: string): Promise<string[]>;
+export declare function detectExternalServices(projectPath: string): Promise<string[]>;
+export declare function detectTooling(projectPath: string): Promise<Record<string, string>>;
+//# sourceMappingURL=analyzer-detectors.d.ts.map

package/dist/engine/analyzer-detectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-detectors.d.ts","sourceRoot":"","sources":["../../src/engine/analyzer-detectors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAElF;AAID,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiG5F;AAID,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB/E;AAID,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCnF;AAID,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgExF"}

package/dist/engine/analyzer-detectors.js

@@ -0,0 +1,232 @@
+// SpecForge — Analyzer: Linting, Conventions, Environments, Tooling, External Services
+// Internal helpers extracted from analyzer.ts to keep file sizes manageable.
+import { fileExists, hasAnyFile, collectDependencies } from './detection-utils.js';
+import { analyzeLintingEnhanced } from './analyzer-linting.js';
+// === Linting Analysis — delegates to enhanced module (SPEC-025) ===
+export async function analyzeLinting(projectPath) {
+    return analyzeLintingEnhanced(projectPath);
+}
+// === Convention Detection ===
+export async function detectConventions(projectPath) {
+    const conventions = {};
+    // AI agent configs — detect all major AI coding platforms
+    if (await fileExists(projectPath, 'CLAUDE.md')) {
+        conventions['ai-rules'] = 'CLAUDE.md';
+    }
+    if (await fileExists(projectPath, '.cursorrules')) {
+        conventions['cursor-rules'] = '.cursorrules';
+    }
+    if (await fileExists(projectPath, '.windsurfrules')) {
+        conventions['windsurf-rules'] = '.windsurfrules';
+    }
+    if (await fileExists(projectPath, '.clinerules')) {
+        conventions['cline-rules'] = '.clinerules';
+    }
+    if (await fileExists(projectPath, '.github/copilot-instructions.md')) {
+        conventions['copilot-rules'] = '.github/copilot-instructions.md';
+    }
+    if (await fileExists(projectPath, 'AGENTS.md')) {
+        conventions['codex-rules'] = 'AGENTS.md';
+    }
+    if (await fileExists(projectPath, 'devin.md')) {
+        conventions['devin-rules'] = 'devin.md';
+    }
+    if (await hasAnyFile(projectPath, ['.continue/config.json', '.continuerc.json'])) {
+        conventions['continue-rules'] = '.continue/config.json';
+    }
+    if (await hasAnyFile(projectPath, ['.aider.conf.yml'])) {
+        conventions['aider-rules'] = '.aider.conf.yml';
+    }
+    if (await hasAnyFile(projectPath, ['.gemini/settings.json', '.idx/dev.nix'])) {
+        conventions['gemini-rules'] = '.gemini/settings.json';
+    }
+    if (await hasAnyFile(projectPath, ['.amazonq/rules.md', '.amazonq/settings.json'])) {
+        conventions['amazon-q-rules'] = '.amazonq/rules.md';
+    }
+    if (await fileExists(projectPath, '.junie/guidelines.md')) {
+        conventions['junie-rules'] = '.junie/guidelines.md';
+    }
+    if (await fileExists(projectPath, '.sourcegraph/cody.json')) {
+        conventions['cody-rules'] = '.sourcegraph/cody.json';
+    }
+    if (await fileExists(projectPath, '.replit')) {
+        conventions['replit-rules'] = '.replit';
+    }
+    if (await hasAnyFile(projectPath, ['.zed/settings.json'])) {
+        conventions['zed-rules'] = '.zed/settings.json';
+    }
+    if (await hasAnyFile(projectPath, ['.augment/config.json', '.augmentignore'])) {
+        conventions['augment-rules'] = '.augment/config.json';
+    }
+    if (await fileExists(projectPath, '.qodo/config.json')) {
+        conventions['qodo-rules'] = '.qodo/config.json';
+    }
+    if (await fileExists(projectPath, '.kilocode/rules')) {
+        conventions['kilo-code-rules'] = '.kilocode/rules';
+    }
+    if (await fileExists(projectPath, '.tabnine/config.json')) {
+        conventions['tabnine-rules'] = '.tabnine/config.json';
+    }
+    if (await hasAnyFile(projectPath, ['.agent/rules/*', '.agent/workflows/*'])) {
+        conventions['antigravity-rules'] = '.agent/rules/';
+    }
+    if (await fileExists(projectPath, 'GEMINI.md')) {
+        // GEMINI.md is used by both Antigravity and Gemini CLI
+        conventions['antigravity-rules'] ??= 'GEMINI.md';
+        conventions['gemini-rules'] = 'GEMINI.md';
+    }
+    // Editor config
+    if (await fileExists(projectPath, '.editorconfig')) {
+        conventions['editor-config'] = '.editorconfig';
+    }
+    // Commit conventions
+    if (await hasAnyFile(projectPath, ['commitlint.config.*', '.commitlintrc*'])) {
+        conventions['commit-convention'] = 'conventional-commits';
+    }
+    // Git hooks
+    if (await fileExists(projectPath, '.husky')) {
+        conventions['git-hooks'] = 'husky';
+    }
+    if (await hasAnyFile(projectPath, ['.lefthook.yml', 'lefthook.yml'])) {
+        conventions['git-hooks'] = 'lefthook';
+    }
+    if (await hasAnyFile(projectPath, ['.pre-commit-config.yaml'])) {
+        conventions['git-hooks'] = 'pre-commit';
+    }
+    // Lint-staged
+    if (await hasAnyFile(projectPath, ['.lintstagedrc*', 'lint-staged.config.*'])) {
+        conventions['lint-staged'] = 'lint-staged';
+    }
+    return conventions;
+}
+// === Environment Detection ===
+export async function detectEnvironments(projectPath) {
+    const environments = ['development'];
+    if (await hasAnyFile(projectPath, ['.env.staging', '.env.test', '.env.production'])) {
+        if (await fileExists(projectPath, '.env.staging')) {
+            environments.push('staging');
+        }
+        if (await fileExists(projectPath, '.env.test')) {
+            environments.push('test');
+        }
+        if (await fileExists(projectPath, '.env.production')) {
+            environments.push('production');
+        }
+    }
+    else {
+        environments.push('staging', 'production');
+    }
+    return environments;
+}
+// === External Services Detection ===
+export async function detectExternalServices(projectPath) {
+    const services = new Set();
+    const deps = await collectDependencies(projectPath);
+    const serviceMap = {
+        stripe: ['stripe', '@stripe/stripe-js'],
+        aws: ['aws-sdk', '@aws-sdk/client-s3', '@aws-sdk/client-ses'],
+        'google-cloud': ['@google-cloud/storage', '@google-cloud/pubsub', '@google-cloud/firestore'],
+        azure: ['@azure/storage-blob', '@azure/cosmos'],
+        supabase: ['@supabase/supabase-js', '@supabase/ssr'],
+        firebase: ['firebase', 'firebase-admin'],
+        twilio: ['twilio'],
+        sendgrid: ['@sendgrid/mail'],
+        resend: ['resend'],
+        cloudflare: ['@cloudflare/workers-types', 'wrangler'],
+        vercel: ['@vercel/analytics', '@vercel/og'],
+        sentry: ['@sentry/node', '@sentry/nextjs', '@sentry/react'],
+        datadog: ['dd-trace'],
+        'new-relic': ['newrelic'],
+        redis: ['redis', 'ioredis'],
+        elasticsearch: ['@elastic/elasticsearch'],
+        algolia: ['algoliasearch'],
+        openai: ['openai'],
+        anthropic: ['@anthropic-ai/sdk'],
+        auth0: ['@auth0/nextjs-auth0', 'auth0'],
+        clerk: ['@clerk/nextjs', '@clerk/clerk-sdk-node'],
+    };
+    for (const [service, packages] of Object.entries(serviceMap)) {
+        for (const pkg of packages) {
+            if (deps.has(pkg)) {
+                services.add(service);
+                break;
+            }
+        }
+    }
+    return [...services];
+}
+// === Tooling Detection ===
+export async function detectTooling(projectPath) {
+    const tooling = {};
+    // CI/CD
+    if (await hasAnyFile(projectPath, ['.github/workflows/*'])) {
+        tooling.ci = 'github-actions';
+    }
+    else if (await fileExists(projectPath, '.gitlab-ci.yml')) {
+        tooling.ci = 'gitlab-ci';
+    }
+    else if (await fileExists(projectPath, 'Jenkinsfile')) {
+        tooling.ci = 'jenkins';
+    }
+    else if (await hasAnyFile(projectPath, ['.circleci/config.yml'])) {
+        tooling.ci = 'circleci';
+    }
+    // Containers
+    if (await fileExists(projectPath, 'Dockerfile')) {
+        tooling.container = 'docker';
+    }
+    if (await hasAnyFile(projectPath, ['docker-compose.yml', 'docker-compose.yaml'])) {
+        tooling.orchestration = 'docker-compose';
+    }
+    if (await hasAnyFile(projectPath, ['k8s/**/*', 'kubernetes/**/*'])) {
+        tooling.orchestration = 'kubernetes';
+    }
+    // Build tools / task runners
+    if (await fileExists(projectPath, 'turbo.json')) {
+        tooling.monorepo = 'turborepo';
+    }
+    else if (await fileExists(projectPath, 'nx.json')) {
+        tooling.monorepo = 'nx';
+    }
+    else if (await fileExists(projectPath, 'lerna.json')) {
+        tooling.monorepo = 'lerna';
+    }
+    // Bundlers
+    const deps = await collectDependencies(projectPath);
+    if (deps.has('vite')) {
+        tooling.bundler = 'vite';
+    }
+    else if (deps.has('webpack')) {
+        tooling.bundler = 'webpack';
+    }
+    else if (deps.has('esbuild')) {
+        tooling.bundler = 'esbuild';
+    }
+    else if (deps.has('rollup')) {
+        tooling.bundler = 'rollup';
+    }
+    else if (deps.has('tsup')) {
+        tooling.bundler = 'tsup';
+    }
+    else if (deps.has('turbopack')) {
+        tooling.bundler = 'turbopack';
+    }
+    // Testing
+    if (deps.has('vitest')) {
+        tooling.testing = 'vitest';
+    }
+    else if (deps.has('jest')) {
+        tooling.testing = 'jest';
+    }
+    else if (deps.has('mocha')) {
+        tooling.testing = 'mocha';
+    }
+    else if (await fileExists(projectPath, 'pytest.ini')) {
+        tooling.testing = 'pytest';
+    }
+    else if (await fileExists(projectPath, 'Cargo.toml')) {
+        tooling.testing = 'cargo-test';
+    }
+    return tooling;
+}
+//# sourceMappingURL=analyzer-detectors.js.map

package/dist/engine/analyzer-detectors.js.map

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

package/dist/engine/analyzer-env-scanner/env-example.d.ts

@@ -0,0 +1,6 @@
+import type { EnvVarScan, EnvScanResult } from '../../types/env.js';
+/** Resets the in-memory cache — used in tests to force reload */
+export declare function resetEnvPatternsCache(): void;
+export declare function generateEnvExampleContent(variables: EnvVarScan[]): string;
+export declare function scanEnvVars(projectPath: string): Promise<EnvScanResult>;
+//# sourceMappingURL=env-example.d.ts.map

package/dist/engine/analyzer-env-scanner/env-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-example.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer-env-scanner/env-example.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAKd,MAAM,oBAAoB,CAAC;AAO5B,iEAAiE;AACjE,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAyDD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CA+BzE;AA8ED,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4D7E"}

package/dist/engine/analyzer-env-scanner/env-example.js

@@ -0,0 +1,212 @@
+// SpecForge — Env Var Scanner: .env.example generation and service info (SPEC-025)
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { scanDirectory, scanFileForEnvVars, scanFileForSecrets } from './scanner.js';
+// === Registry loading ===
+let patternsCache = null;
+/** Resets the in-memory cache — used in tests to force reload */
+export function resetEnvPatternsCache() {
+    patternsCache = null;
+}
+async function loadEnvPatterns() {
+    if (patternsCache) {
+        return patternsCache;
+    }
+    try {
+        const configPath = new URL('../../config/env-patterns.json', import.meta.url);
+        const content = await readFile(configPath, 'utf-8');
+        patternsCache = JSON.parse(content);
+        return patternsCache;
+    }
+    catch {
+        return { detectionPatterns: {}, secretPatterns: [], services: {} };
+    }
+}
+// === Service info inference ===
+function inferServiceInfo(varName, services) {
+    for (const [, service] of Object.entries(services)) {
+        if (service.prefix.some((p) => varName.startsWith(p.replace('_', '')))) {
+            const varEntry = service.vars[varName];
+            if (varEntry) {
+                return {
+                    description: varEntry.description,
+                    format: varEntry.format,
+                    howToObtain: varEntry.howToObtain,
+                    estimatedTime: varEntry.estimatedTime,
+                    isSecret: varEntry.isSecret ?? false,
+                    dashboardUrl: service.dashboardUrl,
+                };
+            }
+        }
+    }
+    // Generic inference
+    const upper = varName.toUpperCase();
+    const isSecret = upper.includes('KEY') ||
+        upper.includes('SECRET') ||
+        upper.includes('TOKEN') ||
+        upper.includes('PASSWORD') ||
+        upper.includes('PASS');
+    return {
+        description: `Environment variable: ${varName}`,
+        format: 'string',
+        howToObtain: 'Check your service provider documentation',
+        estimatedTime: '5 minutes',
+        isSecret,
+        dashboardUrl: null,
+    };
+}
+export function generateEnvExampleContent(variables) {
+    const lines = [
+        '# Auto-generated .env.example by SpecForge',
+        '# Fill in the values below. Never commit .env with real values!',
+        '',
+    ];
+    // Group by service
+    const grouped = new Map();
+    for (const v of variables) {
+        const service = inferServiceFromName(v.name);
+        const group = grouped.get(service) ?? [];
+        group.push(v);
+        grouped.set(service, group);
+    }
+    for (const [service, vars] of grouped) {
+        lines.push(`# === ${service.toUpperCase()} ===`);
+        for (const v of vars) {
+            if (v.description) {
+                lines.push(`# ${v.description}`);
+            }
+            if (v.howToObtain) {
+                lines.push(`# How to get: ${v.howToObtain}`);
+            }
+            lines.push(`${v.name}=`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+function inferServiceFromName(name) {
+    const upper = name.toUpperCase();
+    if (upper.includes('SUPABASE')) {
+        return 'supabase';
+    }
+    if (upper.includes('STRIPE')) {
+        return 'stripe';
+    }
+    if (upper.includes('FIREBASE')) {
+        return 'firebase';
+    }
+    if (upper.includes('AWS')) {
+        return 'aws';
+    }
+    if (upper.includes('DATABASE') ||
+        upper.includes('DB_') ||
+        upper.includes('POSTGRES') ||
+        upper.includes('MYSQL') ||
+        upper.includes('MONGO')) {
+        return 'database';
+    }
+    if (upper.includes('REDIS')) {
+        return 'redis';
+    }
+    if (upper.includes('OPENAI') || upper.includes('ANTHROPIC') || upper.includes('CLAUDE')) {
+        return 'ai';
+    }
+    if (upper.includes('GITHUB') || upper.includes('GITLAB')) {
+        return 'git';
+    }
+    return 'app';
+}
+// === Main scan function helpers ===
+function buildPatternRegexes(detectionPatterns) {
+    const all = [];
+    for (const patterns of Object.values(detectionPatterns)) {
+        for (const p of patterns) {
+            try {
+                all.push(new RegExp(p, 'g'));
+            }
+            catch {
+                // Invalid regex
+            }
+        }
+    }
+    return all;
+}
+async function readExampleVars(projectPath) {
+    const vars = new Set();
+    for (const exampleFile of ['.env.example', '.env.local.example', '.env.sample']) {
+        try {
+            const content = await readFile(join(projectPath, exampleFile), 'utf-8');
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#')) {
+                    continue;
+                }
+                const eqIdx = trimmed.indexOf('=');
+                if (eqIdx !== -1) {
+                    vars.add(trimmed.substring(0, eqIdx).trim());
+                }
+            }
+            return { vars, exists: true };
+        }
+        catch {
+            // File doesn't exist — try next
+        }
+    }
+    return { vars, exists: false };
+}
+export async function scanEnvVars(projectPath) {
+    const config = await loadEnvPatterns();
+    const allPatterns = buildPatternRegexes(config.detectionPatterns);
+    const secretRegexes = config.secretPatterns.flatMap((p) => {
+        try {
+            return [new RegExp(p, 'g')];
+        }
+        catch {
+            return [];
+        }
+    });
+    // Scan source files
+    const sourceFiles = [];
+    await scanDirectory(projectPath, sourceFiles);
+    const foundVarMap = new Map();
+    const hardcodedSecrets = [];
+    for (const file of sourceFiles) {
+        const vars = await scanFileForEnvVars(file, allPatterns);
+        for (const v of vars) {
+            if (!foundVarMap.has(v.name)) {
+                foundVarMap.set(v.name, v);
+            }
+        }
+        const secrets = await scanFileForSecrets(file, secretRegexes, projectPath);
+        hardcodedSecrets.push(...secrets);
+    }
+    const { vars: exampleVars, exists: envExampleExists } = await readExampleVars(projectPath);
+    const allVarNames = new Set([...foundVarMap.keys(), ...exampleVars]);
+    const variables = [];
+    for (const varName of allVarNames) {
+        const inCode = foundVarMap.has(varName);
+        const inExample = exampleVars.has(varName);
+        const info = inferServiceInfo(varName, config.services);
+        variables.push({
+            name: varName,
+            source: inCode && inExample ? 'both' : inCode ? 'code' : 'env-example',
+            description: info.description ?? '',
+            howToObtain: info.howToObtain ?? '',
+            dashboardUrl: info.dashboardUrl ?? null,
+            expectedFormat: info.format ?? 'string',
+            estimatedTime: info.estimatedTime ?? '5 minutes',
+            isSecret: info.isSecret ?? false,
+        });
+    }
+    const missingInExample = [...foundVarMap.keys()].filter((v) => !exampleVars.has(v));
+    let gitignoreCoversEnv = false;
+    try {
+        const gitignore = await readFile(join(projectPath, '.gitignore'), 'utf-8');
+        gitignoreCoversEnv = gitignore.includes('.env');
+    }
+    catch {
+        // File doesn't exist — gitignore doesn't cover .env
+    }
+    return { variables, missingInExample, hardcodedSecrets, gitignoreCoversEnv, envExampleExists };
+}
+//# sourceMappingURL=env-example.js.map

package/dist/engine/analyzer-env-scanner/env-example.js.map

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

package/dist/engine/analyzer-env-scanner/scanner.d.ts

@@ -0,0 +1,8 @@
+import type { SecretDetection, ScannedVar } from '../../types/env.js';
+export declare const SCAN_EXTENSIONS: Set<string>;
+export declare const IGNORE_DIRS: Set<string>;
+export declare function scanDirectory(dirPath: string, files: string[], depth?: number): Promise<void>;
+export declare function scanFileForEnvVars(filePath: string, patterns: RegExp[]): Promise<ScannedVar[]>;
+export declare function scanFileForSecrets(filePath: string, secretPatterns: RegExp[], projectPath: string): Promise<SecretDetection[]>;
+export declare function extractVarNameFromLine(line: string): string;
+//# sourceMappingURL=scanner.d.ts.map