@runmist/frameworks 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Chavez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @bitclaw/frameworks
+
+Framework, ORM, runtime, and monorepo detection for deployment pipelines. Built on Bun.
+
+## Features
+
+- **Framework detection** Identifies Next.js, Remix, Astro, SvelteKit, Nuxt, and more from `package.json` deps
+- **ORM detection** Detects Prisma, Drizzle, Sequelize, TypeORM, Mongoose, and others
+- **Runtime detection** Identifies Bun vs Node.js with version resolution
+- **Monorepo detection** Detects Turborepo, Nx, PNPM workspaces, Bun workspaces, Lerna
+- **Repo analysis** Full `analyzeRepo` combining all detections in one pass
+- **Presets** Deployment presets per framework (build command, output dir, install command)
+
+## Installation
+
+```bash
+bun add @bitclaw/frameworks
+```
+
+## Quick Start
+
+```typescript
+import { analyzeRepo } from '@bitclaw/frameworks'
+
+const result = await analyzeRepo('/path/to/repo')
+console.log(result)
+// {
+//   framework: { name: 'nextjs', confidence: 'high' },
+//   orm: { name: 'prisma' },
+//   runtime: { name: 'bun', version: '1.3.0' },
+//   monorepo: null,
+//   packageManager: 'bun'
+// }
+```
+
+## API
+
+```typescript
+analyzeRepo(dir)                   // → Promise<RepoDetectionResult>
+detectFramework(packageJson)       // → DetectedApp | null
+detectOrm(packageJson)             // → OrmPreset | null
+detectRuntime(dir)                 // → Promise<{ name, version }>
+detectMonorepo(dir)                // → Promise<MonorepoInfo | null>
+detectPackageManager(dir)          // → Promise<'bun' | 'npm' | 'pnpm' | 'yarn'>
+getPreset(frameworkName)           // → FrameworkPreset | null
+getOrmPreset(ormName)              // → OrmPreset | null
+```
+
+## Testing
+
+```bash
+bun test
+```

package/dist/analyze-repo.d.ts

@@ -0,0 +1,10 @@
+import type { RepoDetectionResult } from './types';
+/**
+ * Analyze a repository's file tree and package.json contents to detect
+ * monorepo structure, frameworks, and runtimes.
+ *
+ * @param filePaths - All file paths in the repo (from git tree API)
+ * @param packageJsonContents - Map of file path to parsed package.json content string
+ */
+export declare function analyzeRepo(filePaths: string[], packageJsonContents: Map<string, string>): RepoDetectionResult;
+//# sourceMappingURL=analyze-repo.d.ts.map

package/dist/analyze-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-repo.d.ts","sourceRoot":"","sources":["../src/analyze-repo.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EAAE,EACnB,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,mBAAmB,CAsErB"}

package/dist/analyze-repo.js

@@ -0,0 +1,80 @@
+import { detectFramework } from './detect-framework';
+import { detectMonorepo } from './detect-monorepo';
+import { detectOrm } from './detect-orm';
+import { detectPackageManager, detectRuntime } from './detect-runtime';
+/**
+ * Analyze a repository's file tree and package.json contents to detect
+ * monorepo structure, frameworks, and runtimes.
+ *
+ * @param filePaths - All file paths in the repo (from git tree API)
+ * @param packageJsonContents - Map of file path to parsed package.json content string
+ */
+export function analyzeRepo(filePaths, packageJsonContents) {
+    const packageManager = detectPackageManager(filePaths);
+    const monorepo = detectMonorepo(filePaths);
+    // Detect root-level framework
+    let rootFramework = null;
+    let rootRuntime = null;
+    let rootParsed = null;
+    const rootPkgJson = packageJsonContents.get('package.json');
+    if (rootPkgJson) {
+        try {
+            rootParsed = JSON.parse(rootPkgJson);
+            rootFramework = detectFramework(rootParsed);
+            rootRuntime = detectRuntime(rootFramework, filePaths);
+        }
+        catch {
+            // Invalid JSON, skip
+        }
+    }
+    if (!monorepo.isMonorepo) {
+        // Single-app repo
+        const apps = [];
+        if (rootFramework) {
+            apps.push({
+                name: '.',
+                path: '.',
+                framework: rootFramework,
+                runtime: rootRuntime,
+                orm: detectOrm(rootParsed ?? {})
+            });
+        }
+        return {
+            isMonorepo: false,
+            apps,
+            rootFramework,
+            rootRuntime,
+            packageManager
+        };
+    }
+    // Monorepo: analyze each app directory
+    const apps = [];
+    for (const appDir of monorepo.appDirs) {
+        const pkgPath = `apps/${appDir}/package.json`;
+        const pkgContent = packageJsonContents.get(pkgPath);
+        if (!pkgContent)
+            continue;
+        try {
+            const parsed = JSON.parse(pkgContent);
+            const framework = detectFramework(parsed);
+            const runtime = detectRuntime(framework, filePaths);
+            apps.push({
+                name: appDir,
+                path: `apps/${appDir}`,
+                framework,
+                runtime,
+                orm: detectOrm(parsed)
+            });
+        }
+        catch {
+            // Invalid JSON, skip this app
+        }
+    }
+    return {
+        isMonorepo: true,
+        apps,
+        rootFramework,
+        rootRuntime,
+        packageManager
+    };
+}

package/dist/detect-framework.d.ts

@@ -0,0 +1,7 @@
+type PackageJson = {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+};
+export declare function detectFramework(packageJson: PackageJson): string | null;
+export {};
+//# sourceMappingURL=detect-framework.d.ts.map

package/dist/detect-framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-framework.d.ts","sourceRoot":"","sources":["../src/detect-framework.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAgCF,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkBvE"}

package/dist/detect-framework.js

@@ -0,0 +1,37 @@
+/**
+ * Ordered by specificity: meta-frameworks first, then base tools last.
+ * Higher-specificity frameworks supersede lower ones (e.g. TanStack Start supersedes Nitro and Vite).
+ */
+const DETECTION_RULES = [
+    { id: 'tanstack-start', matchPackages: ['@tanstack/react-start'] },
+    { id: 'nextjs', matchPackages: ['next'] },
+    { id: 'nuxt', matchPackages: ['nuxt', 'nuxt3'] },
+    { id: 'sveltekit', matchPackages: ['@sveltejs/kit'] },
+    { id: 'astro', matchPackages: ['astro'] },
+    {
+        id: 'react-router',
+        matchPackages: ['@react-router/dev', '@remix-run/dev']
+    },
+    { id: 'nitro', matchPackages: ['nitropack', 'nitro'] },
+    { id: 'hono', matchPackages: ['hono'] },
+    { id: 'elysia', matchPackages: ['elysia'] },
+    { id: 'express', matchPackages: ['express'] },
+    { id: 'fastify', matchPackages: ['fastify'] },
+    { id: 'vite', matchPackages: ['vite'], devOnly: true }
+];
+export function detectFramework(packageJson) {
+    const deps = packageJson.dependencies ?? {};
+    const devDeps = packageJson.devDependencies ?? {};
+    for (const rule of DETECTION_RULES) {
+        const hasDep = rule.matchPackages.some(pkg => {
+            if (rule.devOnly) {
+                return pkg in devDeps;
+            }
+            return pkg in deps || pkg in devDeps;
+        });
+        if (hasDep) {
+            return rule.id;
+        }
+    }
+    return null;
+}

package/dist/detect-monorepo.d.ts

@@ -0,0 +1,3 @@
+import type { MonorepoInfo } from './types';
+export declare function detectMonorepo(filePaths: string[]): MonorepoInfo;
+//# sourceMappingURL=detect-monorepo.d.ts.map

package/dist/detect-monorepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-monorepo.d.ts","sourceRoot":"","sources":["../src/detect-monorepo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAW5C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,CAkBhE"}

package/dist/detect-monorepo.js

@@ -0,0 +1,23 @@
+const MONOREPO_INDICATORS = [
+    'pnpm-workspace.yaml',
+    'turbo.json',
+    'lerna.json',
+    'nx.json'
+];
+const APP_DIR_PATTERN = /^apps\/([^/]+)\/package\.json$/;
+export function detectMonorepo(filePaths) {
+    const hasIndicator = filePaths.some(p => MONOREPO_INDICATORS.includes(p));
+    // Also check for workspaces in root package.json (handled by caller via packageJsonContents)
+    // Here we just detect via file-based indicators
+    const appDirs = [];
+    for (const fp of filePaths) {
+        const match = APP_DIR_PATTERN.exec(fp);
+        if (match?.[1]) {
+            appDirs.push(match[1]);
+        }
+    }
+    return {
+        isMonorepo: hasIndicator && appDirs.length > 0,
+        appDirs
+    };
+}

package/dist/detect-orm.d.ts

@@ -0,0 +1,8 @@
+import type { OrmPresetId } from './types';
+type PackageJson = {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+};
+export declare function detectOrm(packageJson: PackageJson): OrmPresetId;
+export {};
+//# sourceMappingURL=detect-orm.d.ts.map

package/dist/detect-orm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-orm.d.ts","sourceRoot":"","sources":["../src/detect-orm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,KAAK,WAAW,GAAG;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAEF,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAc/D"}

package/dist/detect-orm.js

@@ -0,0 +1,19 @@
+export function detectOrm(packageJson) {
+    const deps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies
+    };
+    if (deps.prisma || deps['@prisma/client'])
+        return 'prisma';
+    if (deps['drizzle-orm'])
+        return 'drizzle';
+    if (deps.typeorm)
+        return 'typeorm';
+    if (deps.knex)
+        return 'knex';
+    if (deps['@mikro-orm/core'] || deps['mikro-orm'])
+        return 'mikro-orm';
+    if (deps.sequelize)
+        return 'sequelize';
+    return 'none';
+}

package/dist/detect-runtime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Detect the runtime for a given framework.
+ * Uses the framework preset's default runtime.
+ */
+export declare function detectRuntime(detectedFramework: string | null, _filePaths: string[]): 'bun' | 'node' | null;
+/**
+ * Detect the package manager from lockfiles in the file tree.
+ * Checks root-level lockfiles only.
+ */
+export declare function detectPackageManager(filePaths: string[]): 'bun' | 'npm' | 'yarn' | 'pnpm' | null;
+//# sourceMappingURL=detect-runtime.d.ts.map

package/dist/detect-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-runtime.d.ts","sourceRoot":"","sources":["../src/detect-runtime.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,UAAU,EAAE,MAAM,EAAE,GACnB,KAAK,GAAG,MAAM,GAAG,IAAI,CAIvB;AAUD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,GAClB,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxC"}

package/dist/detect-runtime.js

@@ -0,0 +1,30 @@
+import { getPreset } from './presets';
+/**
+ * Detect the runtime for a given framework.
+ * Uses the framework preset's default runtime.
+ */
+export function detectRuntime(detectedFramework, _filePaths) {
+    if (!detectedFramework)
+        return null;
+    const preset = getPreset(detectedFramework);
+    return preset?.runtime ?? null;
+}
+const LOCKFILE_MAP = {
+    'bun.lockb': 'bun',
+    'bun.lock': 'bun',
+    'package-lock.json': 'npm',
+    'yarn.lock': 'yarn',
+    'pnpm-lock.yaml': 'pnpm'
+};
+/**
+ * Detect the package manager from lockfiles in the file tree.
+ * Checks root-level lockfiles only.
+ */
+export function detectPackageManager(filePaths) {
+    for (const fp of filePaths) {
+        const pm = LOCKFILE_MAP[fp];
+        if (pm)
+            return pm;
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { analyzeRepo } from './analyze-repo';
+export { detectFramework } from './detect-framework';
+export { detectMonorepo } from './detect-monorepo';
+export { detectOrm } from './detect-orm';
+export { detectPackageManager, detectRuntime } from './detect-runtime';
+export { getOrmPreset, ORM_PRESET_OPTIONS, ORM_PRESETS } from './orm-presets';
+export { FRAMEWORK_PRESET_OPTIONS, FRAMEWORK_PRESETS, getPreset } from './presets';
+export type { BunVersion, NodeVersion } from './runtime-versions';
+export { BUN_VERSIONS, DEFAULT_BUN_VERSION, DEFAULT_NODE_VERSION, NODE_VERSIONS } from './runtime-versions';
+export type { DeployHookId, DetectedApp, FrameworkPreset, MonorepoInfo, OrmPreset, OrmPresetId, RepoDetectionResult } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,SAAS,EACV,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACpB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { analyzeRepo } from './analyze-repo';
+export { detectFramework } from './detect-framework';
+export { detectMonorepo } from './detect-monorepo';
+export { detectOrm } from './detect-orm';
+export { detectPackageManager, detectRuntime } from './detect-runtime';
+export { getOrmPreset, ORM_PRESET_OPTIONS, ORM_PRESETS } from './orm-presets';
+export { FRAMEWORK_PRESET_OPTIONS, FRAMEWORK_PRESETS, getPreset } from './presets';
+export { BUN_VERSIONS, DEFAULT_BUN_VERSION, DEFAULT_NODE_VERSION, NODE_VERSIONS } from './runtime-versions';

package/dist/orm-presets.d.ts

@@ -0,0 +1,9 @@
+import type { OrmPreset } from './types';
+export declare const ORM_PRESETS: OrmPreset[];
+export declare function getOrmPreset(id: string): OrmPreset | undefined;
+export declare const ORM_PRESET_OPTIONS: {
+    value: import("./types").OrmPresetId;
+    label: string;
+    description: string;
+}[];
+//# sourceMappingURL=orm-presets.d.ts.map

package/dist/orm-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orm-presets.d.ts","sourceRoot":"","sources":["../src/orm-presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,SAAS,EAyDlC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE9D;AAED,eAAO,MAAM,kBAAkB;;;;GAI5B,CAAC"}

package/dist/orm-presets.js

@@ -0,0 +1,66 @@
+export const ORM_PRESETS = [
+    {
+        id: 'none',
+        name: 'None',
+        description: 'No ORM — manage migrations manually'
+    },
+    {
+        id: 'prisma',
+        name: 'Prisma',
+        description: 'Type-safe ORM with auto-generated client',
+        hooks: {
+            'after-install': [
+                'PRISMA_SCHEMA_DISABLE_ADVISORY_LOCK=1 npx prisma generate',
+                'PRISMA_SCHEMA_DISABLE_ADVISORY_LOCK=1 npx prisma migrate deploy'
+            ]
+        }
+    },
+    {
+        id: 'drizzle',
+        name: 'Drizzle',
+        description: 'Lightweight TypeScript ORM',
+        hooks: {
+            'after-install': ['npx drizzle-kit migrate']
+        }
+    },
+    {
+        id: 'knex',
+        name: 'Knex.js',
+        description: 'SQL query builder with migrations',
+        hooks: {
+            'after-install': ['npx knex migrate:latest']
+        }
+    },
+    {
+        id: 'typeorm',
+        name: 'TypeORM',
+        description: 'ORM for TypeScript and JavaScript',
+        hooks: {
+            'after-install': ['npx typeorm migration:run -d ./data-source.ts']
+        }
+    },
+    {
+        id: 'mikro-orm',
+        name: 'MikroORM',
+        description: 'TypeScript ORM with unit of work',
+        hooks: {
+            'after-install': ['npx mikro-orm migration:up']
+        }
+    },
+    {
+        id: 'sequelize',
+        name: 'Sequelize',
+        description: 'Promise-based Node.js ORM',
+        hooks: {
+            'after-install': ['npx sequelize-cli db:migrate']
+        }
+    }
+];
+export function getOrmPreset(id) {
+    return ORM_PRESETS.find(p => p.id === id);
+}
+export const ORM_PRESET_OPTIONS = ORM_PRESETS.map(p => ({
+    value: p.id,
+    label: p.name,
+    description: p.description
+}));

package/dist/presets.d.ts

@@ -0,0 +1,10 @@
+import type { FrameworkPreset } from './types';
+export declare const FRAMEWORK_PRESETS: FrameworkPreset[];
+export declare function getPreset(id: string): FrameworkPreset | undefined;
+/** Pre-computed combobox items -- avoids re-creating on every render. */
+export declare const FRAMEWORK_PRESET_OPTIONS: {
+    value: string;
+    label: string;
+    description: string;
+}[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAgJ9C,CAAC;AAEF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjE;AAED,yEAAyE;AACzE,eAAO,MAAM,wBAAwB;;;;GAIlC,CAAC"}

package/dist/presets.js

@@ -0,0 +1,154 @@
+export const FRAMEWORK_PRESETS = [
+    {
+        id: 'tanstack-start',
+        name: 'TanStack Start',
+        description: 'TanStack Start with Nitro',
+        runtime: 'bun',
+        installCommand: 'bun install --frozen-lockfile',
+        buildCommand: 'bun run build',
+        startCommand: 'bun .output/server/index.mjs',
+        outputDirectory: '.output/public',
+        staticUrlPath: '/assets/*'
+    },
+    {
+        id: 'nitro',
+        name: 'Nitro',
+        description: 'UnJS Nitro server framework',
+        runtime: 'bun',
+        installCommand: 'bun install --frozen-lockfile',
+        buildCommand: 'bun run build',
+        startCommand: 'bun .output/server/index.mjs',
+        outputDirectory: '.output/public',
+        staticUrlPath: '/assets/*'
+    },
+    {
+        id: 'react-router',
+        name: 'React Router',
+        description: 'React Router v7 / Remix',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node index.js',
+        outputDirectory: 'build/client',
+        staticUrlPath: '/build/*'
+    },
+    {
+        id: 'nextjs',
+        name: 'Next.js',
+        description: 'React framework by Vercel',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node server.js',
+        outputDirectory: '.next',
+        staticUrlPath: '/_next/*'
+    },
+    {
+        id: 'nuxt',
+        name: 'Nuxt',
+        description: 'Vue.js full-stack framework',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node .output/server/index.mjs',
+        outputDirectory: '.output/public',
+        staticUrlPath: '/_nuxt/*'
+    },
+    {
+        id: 'sveltekit',
+        name: 'SvelteKit',
+        description: 'Svelte app framework',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node build/index.js',
+        outputDirectory: 'build/client',
+        staticUrlPath: '/_app/immutable/*'
+    },
+    {
+        id: 'astro',
+        name: 'Astro',
+        description: 'Content-focused web framework',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node ./dist/server/entry.mjs',
+        outputDirectory: 'dist/client',
+        staticUrlPath: '/_astro/*'
+    },
+    {
+        id: 'vite',
+        name: 'Vite',
+        description: 'Frontend build tool',
+        runtime: 'bun',
+        installCommand: 'bun install --frozen-lockfile',
+        buildCommand: 'bun run build',
+        startCommand: 'bun run preview',
+        outputDirectory: 'dist',
+        staticUrlPath: '/assets/*'
+    },
+    {
+        id: 'hono',
+        name: 'Hono',
+        description: 'Lightweight web framework',
+        runtime: 'bun',
+        installCommand: 'bun install --frozen-lockfile',
+        buildCommand: 'bun run build',
+        startCommand: 'bun run start',
+        outputDirectory: 'dist',
+        staticUrlPath: null
+    },
+    {
+        id: 'elysia',
+        name: 'Elysia',
+        description: 'Bun-first web framework',
+        runtime: 'bun',
+        installCommand: 'bun install --frozen-lockfile',
+        buildCommand: 'bun run build',
+        startCommand: 'bun run start',
+        outputDirectory: 'dist',
+        staticUrlPath: null
+    },
+    {
+        id: 'express',
+        name: 'Express',
+        description: 'Node.js web framework',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node dist/index.js',
+        outputDirectory: 'dist',
+        staticUrlPath: null
+    },
+    {
+        id: 'fastify',
+        name: 'Fastify',
+        description: 'Fast Node.js web framework',
+        runtime: 'node',
+        installCommand: 'npm install',
+        buildCommand: 'npm run build',
+        startCommand: 'node dist/index.js',
+        outputDirectory: 'dist',
+        staticUrlPath: null
+    },
+    {
+        id: 'other',
+        name: 'Other',
+        description: 'Custom application',
+        runtime: 'bun',
+        installCommand: 'bun install',
+        buildCommand: 'bun run build',
+        startCommand: 'bun run start',
+        outputDirectory: 'dist',
+        staticUrlPath: null
+    }
+];
+export function getPreset(id) {
+    return FRAMEWORK_PRESETS.find(p => p.id === id);
+}
+/** Pre-computed combobox items -- avoids re-creating on every render. */
+export const FRAMEWORK_PRESET_OPTIONS = FRAMEWORK_PRESETS.map(p => ({
+    value: p.id,
+    label: p.name,
+    description: p.description
+}));

package/dist/runtime-versions.d.ts

@@ -0,0 +1,7 @@
+export declare const NODE_VERSIONS: readonly ["22.x", "20.x", "18.x"];
+export declare const DEFAULT_NODE_VERSION = "22.x";
+export declare const BUN_VERSIONS: readonly ["latest", "1.3", "1.2", "1.1"];
+export declare const DEFAULT_BUN_VERSION = "latest";
+export type NodeVersion = (typeof NODE_VERSIONS)[number];
+export type BunVersion = (typeof BUN_VERSIONS)[number];
+//# sourceMappingURL=runtime-versions.d.ts.map

package/dist/runtime-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-versions.d.ts","sourceRoot":"","sources":["../src/runtime-versions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAI3C,eAAO,MAAM,YAAY,0CAA2C,CAAC;AACrE,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/runtime-versions.js

@@ -0,0 +1,6 @@
+export const NODE_VERSIONS = ['22.x', '20.x', '18.x'];
+export const DEFAULT_NODE_VERSION = '22.x';
+// Bun versions — "latest" installs whatever is current at deploy time
+// Pinned versions (1.3, 1.2, 1.1) resolve to latest patch via the official installer
+export const BUN_VERSIONS = ['latest', '1.3', '1.2', '1.1'];
+export const DEFAULT_BUN_VERSION = 'latest';

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export type DeployHookId = 'after-install' | 'before-activate' | 'after-activate' | 'on-fail';
+export type OrmPresetId = 'prisma' | 'drizzle' | 'knex' | 'typeorm' | 'mikro-orm' | 'sequelize' | 'none';
+export type OrmPreset = {
+    id: OrmPresetId;
+    name: string;
+    description: string;
+    hooks?: Partial<Record<DeployHookId, string[]>>;
+};
+export type FrameworkPreset = {
+    id: string;
+    name: string;
+    description: string;
+    runtime: 'bun' | 'node';
+    installCommand: string;
+    buildCommand: string;
+    startCommand: string;
+    outputDirectory: string;
+    /** Caddy URL path for static asset interception (e.g. "/build/*", "/assets/*"). Null for API-only frameworks. */
+    staticUrlPath: string | null;
+    /** Deploy hook commands keyed by hook point in the pipeline */
+    hooks?: Partial<Record<DeployHookId, string[]>>;
+};
+export type DetectedApp = {
+    name: string;
+    path: string;
+    framework: string | null;
+    runtime: 'bun' | 'node' | null;
+    orm: OrmPresetId;
+};
+export type MonorepoInfo = {
+    isMonorepo: boolean;
+    appDirs: string[];
+};
+export type RepoDetectionResult = {
+    isMonorepo: boolean;
+    apps: DetectedApp[];
+    rootFramework: string | null;
+    rootRuntime: 'bun' | 'node' | null;
+    packageManager: 'bun' | 'npm' | 'yarn' | 'pnpm' | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,GACT,WAAW,GACX,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iHAAiH;IACjH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACxD,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@runmist/frameworks",
+  "version": "1.1.0",
+  "description": "Framework, ORM, runtime, and monorepo detection for deployment pipelines",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "knip": "knip",
+    "prepublishOnly": "npm run build && npm test",
+    "publish:dev": "npm run build && npm publish --tag dev --access public",
+    "publish:patch": "npm whoami && npm version patch && git push --follow-tags && npm publish --access public",
+    "publish:minor": "npm whoami && npm version minor && git push --follow-tags && npm publish --access public",
+    "publish:major": "npm whoami && npm version major && git push --follow-tags && npm publish --access public"
+  },
+  "keywords": [
+    "framework-detection",
+    "orm",
+    "monorepo",
+    "runtime",
+    "deploy",
+    "analysis"
+  ],
+  "author": "bitclaw",
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "knip": "^6.12.1",
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  }
+}