specforge-mcp 0.1.0

package/dist/engine/dynamic-migration-detector/plan-generator.js

@@ -0,0 +1,168 @@
+/** Map risk → estimated effort. */
+function estimateEffort(migration) {
+    if (migration.risk === 'critical' || migration.risk === 'high') {
+        return 'days';
+    }
+    const gap = migration.latestMajor - migration.currentMajor;
+    if (gap >= 3) {
+        return 'weeks';
+    }
+    return 'hours';
+}
+/** Generic steps applicable to any ecosystem upgrade. */
+function baseSteps(migration) {
+    const { package: pkg, currentMajor, latestMajor } = migration;
+    return [
+        `Review ${pkg} v${String(latestMajor)} migration guide / changelog`,
+        `Create a dedicated branch: upgrade/${pkg}-v${String(latestMajor)}`,
+        `Update ${pkg} from v${String(currentMajor)} to v${String(latestMajor)} in the manifest`,
+        `Run the test suite — fix all failures before merging`,
+        `Update CI/CD pipelines if needed`,
+        `Perform smoke testing in a staging environment`,
+        `Merge and monitor for regressions`,
+    ];
+}
+/** npm-specific steps. */
+function npmSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Run \`npm audit\` after upgrading to check for new advisories`,
+        `Check for deprecated APIs using \`npx depcheck\``,
+    ];
+}
+/** pypi-specific steps. */
+function pypiSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Update pyproject.toml / requirements.txt constraints`,
+        `Run \`pip-audit\` to verify no new security issues`,
+        `Check type stubs (py.typed) compatibility`,
+    ];
+}
+/** cargo-specific steps. */
+function cargoSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Run \`cargo update ${migration.package}\` to bump Cargo.lock`,
+        `Run \`cargo clippy\` and fix all new warnings`,
+        `Run \`cargo audit\` to check for advisories`,
+    ];
+}
+/** go-specific steps. */
+function goSteps(migration) {
+    const { package: pkg, latestMajor } = migration;
+    return [
+        ...baseSteps(migration),
+        `Update import paths to include /v${String(latestMajor)} suffix if required by the module`,
+        `Run \`go mod tidy\` after updating go.mod`,
+        `Run \`go vet ./...\` and fix all issues`,
+        `Verify compatibility with \`govulncheck\` for module: ${pkg}`,
+    ];
+}
+/** maven-specific steps. */
+function mavenSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Update version in pom.xml / build.gradle`,
+        `Run \`mvn dependency:analyze\` to check for unused or missing deps`,
+        `Run \`./gradlew dependencyInsight\` for transitive conflicts`,
+    ];
+}
+/** composer-specific steps. */
+function composerSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Run \`composer update ${migration.package}\``,
+        `Run \`composer audit\` to check for security advisories`,
+        `Verify PHP version compatibility for the new major`,
+    ];
+}
+/** rubygems-specific steps. */
+function rubygemsSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Update version constraint in Gemfile for ${migration.package}`,
+        `Run \`bundle update ${migration.package}\` to resolve dependencies`,
+        `Run \`bundle exec rubocop\` and fix new offenses`,
+        `Check for deprecation warnings in the test output`,
+    ];
+}
+/** nuget-specific steps. */
+function nugetSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Update <PackageReference> Version in .csproj for ${migration.package}`,
+        `Run \`dotnet restore\` to fetch the new version`,
+        `Run \`dotnet build\` and fix compilation errors`,
+        `Run \`dotnet test\` — fix all broken tests before merging`,
+    ];
+}
+/** pub-specific steps (Dart/Flutter). */
+function pubSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Update version constraint in pubspec.yaml for ${migration.package}`,
+        `Run \`flutter pub upgrade ${migration.package}\``,
+        `Run \`dart analyze\` and fix all warnings`,
+        `Run \`flutter test\` to verify no widget regressions`,
+    ];
+}
+/** swiftpm-specific steps. */
+function swiftpmSteps(migration) {
+    return [
+        ...baseSteps(migration),
+        `Update .package(url:, from:) or .upToNextMajor in Package.swift for ${migration.package}`,
+        `Run \`swift package update\` to resolve dependencies`,
+        `Run \`swift build\` and fix compilation errors`,
+        `Run \`swift test\` — fix all failing tests before merging`,
+    ];
+}
+/** Generate ecosystem-appropriate checklist steps. */
+function generateSteps(migration) {
+    const ecosystem = migration.ecosystem;
+    switch (ecosystem) {
+        case 'npm':
+            return npmSteps(migration);
+        case 'pypi':
+            return pypiSteps(migration);
+        case 'cargo':
+            return cargoSteps(migration);
+        case 'go':
+            return goSteps(migration);
+        case 'maven':
+            return mavenSteps(migration);
+        case 'composer':
+            return composerSteps(migration);
+        case 'rubygems':
+            return rubygemsSteps(migration);
+        case 'nuget':
+            return nugetSteps(migration);
+        case 'pub':
+            return pubSteps(migration);
+        case 'swiftpm':
+            return swiftpmSteps(migration);
+    }
+}
+/** Find direct dependents in catalog that reference the same package. */
+function findTransitiveDependents(catalog, migration) {
+    // Scan all customPolicies for entries that depend on the same package
+    const dependents = [];
+    for (const policy of catalog.customPolicies) {
+        if (policy.package !== migration.package && policy.ecosystem === migration.ecosystem) {
+            // In a real implementation this would parse lock files; for now surface custom policy packages
+            // that are in the same ecosystem as potential peers requiring attention.
+            dependents.push(`${policy.ecosystem}/${policy.package}`);
+        }
+    }
+    return dependents;
+}
+/** Generate a full DynamicMigrationPlan for a PendingMigration. */
+export function generateMigrationPlan(migration, catalog) {
+    return {
+        migration,
+        steps: generateSteps(migration),
+        transitiveDependents: findTransitiveDependents(catalog, migration),
+        estimatedEffort: estimateEffort(migration),
+    };
+}
+//# sourceMappingURL=plan-generator.js.map

package/dist/engine/dynamic-migration-detector/plan-generator.js.map

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

package/dist/engine/dynamic-migration-detector/risk-assessor.d.ts

@@ -0,0 +1,8 @@
+import type { DynamicMigrationRisk, DynamicMigrationWindow, MigrationEcosystem, MigrationPoliciesCatalog } from '../../types/index.js';
+/** Assess risk for a pending migration. Returns risk, reason, and migration window. */
+export declare function assessMigrationRisk(catalog: MigrationPoliciesCatalog, ecosystem: MigrationEcosystem, pkg: string, currentMajor: number, latestMajor: number, now?: Date): {
+    risk: DynamicMigrationRisk;
+    reason: string;
+    migrationWindow: DynamicMigrationWindow;
+};
+//# sourceMappingURL=risk-assessor.d.ts.map

package/dist/engine/dynamic-migration-detector/risk-assessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-assessor.d.ts","sourceRoot":"","sources":["../../../src/engine/dynamic-migration-detector/risk-assessor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AA2D9B,uFAAuF;AACvF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,EACjC,SAAS,EAAE,kBAAkB,EAC7B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,IAAiB,GACrB;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,sBAAsB,CAAA;CAAE,CAuDzF"}

package/dist/engine/dynamic-migration-detector/risk-assessor.js

@@ -0,0 +1,91 @@
+/** Number of milliseconds in one month (approximate). */
+const MS_PER_MONTH = 30 * 24 * 60 * 60 * 1000;
+/** Check if a package major is EOL per catalog. */
+function isEol(catalog, ecosystem, pkg, major) {
+    const ecoEntry = catalog.ecosystems[ecosystem];
+    if (!ecoEntry?.eolPackages) {
+        return false;
+    }
+    return ecoEntry.eolPackages.some((e) => e.name === pkg && e.major === major);
+}
+/** Check if a package has known security CVEs in catalog. */
+function hasSecurityRisk(catalog, ecosystem, pkg) {
+    const ecoEntry = catalog.ecosystems[ecosystem];
+    if (!ecoEntry?.securityRiskPackages) {
+        return false;
+    }
+    return ecoEntry.securityRiskPackages.includes(pkg);
+}
+/** Determine how many months ago a stable release date occurred. Returns null if no date given. */
+function monthsAgo(isoDate, now) {
+    if (!isoDate) {
+        return null;
+    }
+    const releaseDate = new Date(isoDate);
+    if (isNaN(releaseDate.getTime())) {
+        return null;
+    }
+    return (now.getTime() - releaseDate.getTime()) / MS_PER_MONTH;
+}
+/** Get the EOL date string for a specific package major, if present. */
+function getEolDate(catalog, ecosystem, pkg, major) {
+    const ecoEntry = catalog.ecosystems[ecosystem];
+    if (!ecoEntry?.eolPackages) {
+        return undefined;
+    }
+    const found = ecoEntry.eolPackages.find((e) => e.name === pkg && e.major === major);
+    return found?.eolDate;
+}
+/** Assess risk for a pending migration. Returns risk, reason, and migration window. */
+export function assessMigrationRisk(catalog, ecosystem, pkg, currentMajor, latestMajor, now = new Date()) {
+    const thresholds = catalog.riskThresholds;
+    // C6: security risk → critical
+    if (hasSecurityRisk(catalog, ecosystem, pkg)) {
+        return {
+            risk: 'critical',
+            reason: `${pkg} v${String(currentMajor)} has known security CVEs — upgrade to v${String(latestMajor)} immediately`,
+            migrationWindow: 'immediate',
+        };
+    }
+    // C7: current major is EOL → high
+    if (isEol(catalog, ecosystem, pkg, currentMajor)) {
+        const eolDate = getEolDate(catalog, ecosystem, pkg, currentMajor);
+        const dateLabel = eolDate ? ` (EOL since ${eolDate})` : '';
+        return {
+            risk: 'high',
+            reason: `${pkg} v${String(currentMajor)} is end-of-life${dateLabel} — no security patches`,
+            migrationWindow: 'next-sprint',
+        };
+    }
+    // C8/C9: use latest-major EOL date as proxy for stable release date
+    // We use the EOL date of (latestMajor-1) as the rough release window for latestMajor
+    // If no date info, default to medium
+    const prevMajorEolDate = getEolDate(catalog, ecosystem, pkg, latestMajor - 1);
+    const age = monthsAgo(prevMajorEolDate, now);
+    if (age !== null) {
+        // C9: latest major released <3 months ago → low (wait-and-see)
+        if (age < thresholds.newReleaseMonthsForLow) {
+            return {
+                risk: 'low',
+                reason: `${pkg} v${String(latestMajor)} was released recently — wait for ecosystem to stabilise`,
+                migrationWindow: 'backlog',
+            };
+        }
+        // C8: latest major has been stable >6 months → medium
+        if (age >= thresholds.stableMonthsForMedium) {
+            return {
+                risk: 'medium',
+                reason: `${pkg} v${String(latestMajor)} has been stable for ${Math.floor(age)} months — plan upgrade`,
+                migrationWindow: 'backlog',
+            };
+        }
+    }
+    // Default: medium when version gap exists but no date metadata
+    const gap = latestMajor - currentMajor;
+    return {
+        risk: 'medium',
+        reason: `${pkg} is ${String(gap)} major version(s) behind (v${String(currentMajor)} → v${String(latestMajor)})`,
+        migrationWindow: 'backlog',
+    };
+}
+//# sourceMappingURL=risk-assessor.js.map

package/dist/engine/dynamic-migration-detector/risk-assessor.js.map

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

package/dist/engine/dynamic-migration-detector.d.ts

@@ -0,0 +1,9 @@
+import type { PendingMigration, DynamicMigrationPlan, DynamicMigrationResult } from '../types/index.js';
+export type { PendingMigration, DynamicMigrationPlan, DynamicMigrationResult };
+export { generateMigrationPlan } from './dynamic-migration-detector/plan-generator.js';
+/**
+ * Detect all pending major version migrations across all supported ecosystems.
+ * Uses the bundled migration-policies-catalog.json — no live API calls.
+ */
+export declare function detectPendingMajorMigrations(projectPath: string): Promise<DynamicMigrationResult>;
+//# sourceMappingURL=dynamic-migration-detector.d.ts.map

package/dist/engine/dynamic-migration-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-migration-detector.d.ts","sourceRoot":"","sources":["../../src/engine/dynamic-migration-detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAuB3B,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,CAAC;AAG/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAmFvF;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,CAAC,CAgCjC"}

package/dist/engine/dynamic-migration-detector.js

@@ -0,0 +1,106 @@
+import { loadBuiltinCatalog, loadCustomCatalog, mergeCatalogPolicies, getLatestKnownMajor, } from './dynamic-migration-detector/catalog-loader.js';
+import { assessMigrationRisk } from './dynamic-migration-detector/risk-assessor.js';
+import { readNpmManifest, readPypiManifest, readCargoManifest, readGoManifest, readMavenManifest, readComposerManifest, } from './dynamic-migration-detector/manifest-readers.js';
+import { readRubygemsManifest, readNugetManifest, readPubManifest, readSwiftPMManifest, } from './dynamic-migration-detector/manifest-readers-extended.js';
+// Re-export plan generator for callers that need it directly.
+export { generateMigrationPlan } from './dynamic-migration-detector/plan-generator.js';
+/** Detect pending major migrations for one ecosystem using its manifest map. */
+async function detectForEcosystem(projectPath, ecosystem, catalog) {
+    let manifestMap;
+    switch (ecosystem) {
+        case 'npm':
+            manifestMap = await readNpmManifest(projectPath);
+            break;
+        case 'pypi':
+            manifestMap = await readPypiManifest(projectPath);
+            break;
+        case 'cargo':
+            manifestMap = await readCargoManifest(projectPath);
+            break;
+        case 'go':
+            manifestMap = await readGoManifest(projectPath);
+            break;
+        case 'maven':
+            manifestMap = await readMavenManifest(projectPath);
+            break;
+        case 'composer':
+            manifestMap = await readComposerManifest(projectPath);
+            break;
+        case 'rubygems':
+            manifestMap = await readRubygemsManifest(projectPath);
+            break;
+        case 'nuget':
+            manifestMap = await readNugetManifest(projectPath);
+            break;
+        case 'pub':
+            manifestMap = await readPubManifest(projectPath);
+            break;
+        case 'swiftpm':
+            manifestMap = await readSwiftPMManifest(projectPath);
+            break;
+    }
+    const pending = [];
+    for (const [pkg, currentMajor] of manifestMap) {
+        const latestMajor = getLatestKnownMajor(catalog, ecosystem, pkg);
+        if (latestMajor === null || latestMajor <= currentMajor) {
+            continue;
+        }
+        const { risk, reason, migrationWindow } = assessMigrationRisk(catalog, ecosystem, pkg, currentMajor, latestMajor);
+        pending.push({
+            ecosystem,
+            package: pkg,
+            currentMajor,
+            latestMajor,
+            risk,
+            reason,
+            migrationWindow,
+        });
+    }
+    return pending;
+}
+/** Build a human-readable summary string. */
+function buildSummary(pending) {
+    if (pending.length === 0) {
+        return 'No pending major version migrations detected.';
+    }
+    const criticalCount = pending.filter((p) => p.risk === 'critical').length;
+    const highCount = pending.filter((p) => p.risk === 'high').length;
+    const parts = [
+        `${String(pending.length)} pending migration(s)`,
+        criticalCount > 0 ? `${String(criticalCount)} critical` : null,
+        highCount > 0 ? `${String(highCount)} high` : null,
+    ].filter((p) => p !== null);
+    return parts.join(', ') + '.';
+}
+/**
+ * Detect all pending major version migrations across all supported ecosystems.
+ * Uses the bundled migration-policies-catalog.json — no live API calls.
+ */
+export async function detectPendingMajorMigrations(projectPath) {
+    const builtinCatalog = loadBuiltinCatalog();
+    const customPolicies = await loadCustomCatalog(projectPath);
+    const catalog = mergeCatalogPolicies(builtinCatalog, customPolicies);
+    const ecosystems = [
+        'npm',
+        'pypi',
+        'cargo',
+        'go',
+        'maven',
+        'composer',
+        'rubygems',
+        'nuget',
+        'pub',
+        'swiftpm',
+    ];
+    const results = await Promise.all(ecosystems.map((eco) => detectForEcosystem(projectPath, eco, catalog)));
+    const pending = results.flat();
+    const criticalCount = pending.filter((p) => p.risk === 'critical').length;
+    return {
+        projectPath,
+        pending,
+        totalPending: pending.length,
+        criticalCount,
+        summary: buildSummary(pending),
+    };
+}
+//# sourceMappingURL=dynamic-migration-detector.js.map

package/dist/engine/dynamic-migration-detector.js.map

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

package/dist/engine/edge-db-detector.d.ts

@@ -0,0 +1,7 @@
+import type { EdgeDbDetectionResult } from '../types/index.js';
+/**
+ * Detect edge-native database patterns (Turso/libSQL and Cloudflare D1) in a project.
+ * Covers SPEC-052 criteria S1-C1, S1-C2, S1-C3, S4-C11.
+ */
+export declare function detectEdgeDb(projectPath: string): Promise<EdgeDbDetectionResult>;
+//# sourceMappingURL=edge-db-detector.d.ts.map

package/dist/engine/edge-db-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-db-detector.d.ts","sourceRoot":"","sources":["../../src/engine/edge-db-detector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAsJ3B;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqBtF"}

package/dist/engine/edge-db-detector.js

@@ -0,0 +1,150 @@
+// engine/edge-db-detector.ts — SPEC-052
+// Detects edge-native SQLite usage: Turso (libSQL) and Cloudflare D1.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+// === Source file glob ignore list ===
+const SOURCE_GLOB_IGNORE = ['node_modules/**', 'dist/**', 'build/**', '.git/**', 'coverage/**'];
+// === Helpers ===
+async function readFileOrNull(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+async function readEdgeDbPackageDeps(projectPath) {
+    const content = await readFileOrNull(join(projectPath, 'package.json'));
+    if (!content) {
+        return null;
+    }
+    try {
+        const pkg = JSON.parse(content);
+        return {
+            deps: pkg.dependencies ?? {},
+            devDeps: pkg.devDependencies ?? {},
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function globSourceFiles(projectPath) {
+    try {
+        return await glob('**/*.{ts,js,mts,mjs,tsx,jsx}', {
+            cwd: projectPath,
+            nodir: true,
+            maxDepth: 4,
+            ignore: SOURCE_GLOB_IGNORE,
+        });
+    }
+    catch {
+        return [];
+    }
+}
+// === S1-C1: Turso detection via @libsql/client ===
+async function detectTurso(projectPath) {
+    const pkgDeps = await readEdgeDbPackageDeps(projectPath);
+    if (!pkgDeps) {
+        return false;
+    }
+    return '@libsql/client' in pkgDeps.deps || '@libsql/client' in pkgDeps.devDeps;
+}
+// === S1-C2: Cloudflare D1 detection ===
+async function detectCloudflareD1(projectPath) {
+    const pkgDeps = await readEdgeDbPackageDeps(projectPath);
+    if (!pkgDeps) {
+        return false;
+    }
+    const hasWorkersTypes = '@cloudflare/workers-types' in pkgDeps.deps || '@cloudflare/workers-types' in pkgDeps.devDeps;
+    if (!hasWorkersTypes) {
+        return false;
+    }
+    // Also require D1Database usage in source files
+    const hasD1Usage = await detectD1DatabaseInSource(projectPath);
+    return hasD1Usage;
+}
+async function detectD1DatabaseInSource(projectPath) {
+    const files = await globSourceFiles(projectPath);
+    for (const file of files.slice(0, 40)) {
+        const content = await readFileOrNull(join(projectPath, file));
+        if (content?.includes('D1Database')) {
+            return true;
+        }
+    }
+    return false;
+}
+// === S1-C3: Embedded replica detection via createClient({ syncUrl }) ===
+async function detectEmbeddedReplica(projectPath) {
+    const files = await globSourceFiles(projectPath);
+    for (const file of files.slice(0, 40)) {
+        const content = await readFileOrNull(join(projectPath, file));
+        if (!content) {
+            continue;
+        }
+        if (hasEmbeddedReplicaSignal(content)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns true when the content shows createClient called with both url and syncUrl,
+ * which is the Turso embedded-replica pattern.
+ */
+function hasEmbeddedReplicaSignal(content) {
+    // Match createClient({ ... syncUrl ... }) — presence of syncUrl key is the signal
+    return /createClient\s*\(\s*\{[^}]*syncUrl/.test(content);
+}
+// === S4-C11: D1 migrations detection in wrangler.toml ===
+async function detectD1Migrations(projectPath) {
+    const content = await readFileOrNull(join(projectPath, 'wrangler.toml'));
+    if (!content) {
+        return false;
+    }
+    return content.includes('migrations_dir');
+}
+// === TursoMode resolution ===
+async function resolveTursoMode(projectPath, isEmbeddedReplica) {
+    if (isEmbeddedReplica) {
+        return 'embedded-replica';
+    }
+    // Check for local dev signals: createClient({ url: ':memory:' }) or url: 'file:...'
+    const files = await globSourceFiles(projectPath);
+    for (const file of files.slice(0, 40)) {
+        const content = await readFileOrNull(join(projectPath, file));
+        if (!content) {
+            continue;
+        }
+        if (/createClient\s*\(\s*\{[^}]*url\s*:\s*['"](:memory:|file:)/.test(content)) {
+            return 'local';
+        }
+    }
+    return 'remote';
+}
+// === Main exported function ===
+/**
+ * Detect edge-native database patterns (Turso/libSQL and Cloudflare D1) in a project.
+ * Covers SPEC-052 criteria S1-C1, S1-C2, S1-C3, S4-C11.
+ */
+export async function detectEdgeDb(projectPath) {
+    const [isTurso, isD1, isEmbeddedReplica] = await Promise.all([
+        detectTurso(projectPath),
+        detectCloudflareD1(projectPath),
+        detectEmbeddedReplica(projectPath),
+    ]);
+    if (isTurso) {
+        const tursoMode = await resolveTursoMode(projectPath, isEmbeddedReplica);
+        const edgeDb = 'turso';
+        return { edgeDb, tursoMode };
+    }
+    if (isD1) {
+        const hasD1Migrations = await detectD1Migrations(projectPath);
+        const edgeDb = 'cloudflare-d1';
+        return { edgeDb, hasD1Migrations };
+    }
+    const edgeDb = 'none';
+    return { edgeDb };
+}
+//# sourceMappingURL=edge-db-detector.js.map

package/dist/engine/edge-db-detector.js.map

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

package/dist/engine/estimator/calculations.d.ts

@@ -0,0 +1,14 @@
+import type { SpecType, SpecScope, Difficulty, Estimation, TokenStrategy, ExecutionMode, GlobalConfig } from '../../types/index.js';
+export declare function determineRecommendedModel(difficulty: Difficulty, scope: SpecScope): 'opus' | 'sonnet' | 'mixed';
+export declare function determineTokenStrategy(type: SpecType, scope: SpecScope, difficulty: Difficulty, devHours: number): TokenStrategy;
+export declare function calculateTokens(devHours: number, model: 'opus' | 'sonnet' | 'mixed', mode: ExecutionMode): {
+    tokensOpus: number;
+    tokensSonnet: number;
+};
+export declare function calculateApiCost(tokensOpus: number, tokensSonnet: number, config: GlobalConfig): number;
+/**
+ * Calculate raw estimation without historical adjustment.
+ * Useful for new projects with no history.
+ */
+export declare function calculateEstimation(type: SpecType, scope: SpecScope, difficulty: Difficulty, config?: Partial<GlobalConfig>): Estimation;
+//# sourceMappingURL=calculations.d.ts.map

package/dist/engine/estimator/calculations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../../src/engine/estimator/calculations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAc9B,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,QAAQ,GAAG,OAAO,CAQ7B;AAID,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,aAAa,CAkCf;AAID,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAClC,IAAI,EAAE,aAAa,GAClB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAsB9C;AAID,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,MAAM,CAIR;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GACjC,UAAU,CAmCZ"}