@agentuity/cli 2.0.11 → 3.0.0-alpha.1

package/dist/cmd/build/adapters/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Build adapter types.
+ *
+ * Adapters know how to build a specific framework and package the result.
+ * They receive a DetectedFramework and produce a BuildResult.
+ */
+import type { DetectedFramework, PackageJsonData } from '../detect/types';
+import type { Logger, DeployOptions } from '../../../types';
+import type { BuildReportCollector } from '../../../build-report';
+/**
+ * Result of a successful build.
+ */
+export interface BuildResult {
+    /** Absolute path to the build output directory */
+    outputDir: string;
+    /** The start command to run the application */
+    startCommand?: string;
+    /** Server entrypoint file (relative to outputDir) */
+    serverEntry?: string;
+    /** Static/CDN assets directory (absolute path), for CDN upload enumeration */
+    staticDir?: string;
+    /** Port the app listens on */
+    port?: number;
+    /** Build duration in milliseconds */
+    duration: number;
+    /** Human-readable build log lines */
+    logs: string[];
+}
+/**
+ * Options passed to a build adapter.
+ */
+export interface BuildAdapterOptions {
+    /** Absolute path to the project root */
+    projectDir: string;
+    /** Detected framework info */
+    framework: DetectedFramework;
+    /** Parsed package.json */
+    packageJson: PackageJsonData;
+    /** Absolute path to write build output */
+    outputDir: string;
+    /** Logger instance */
+    logger: Logger;
+    /** Build report collector for structured error reporting */
+    collector?: BuildReportCollector;
+    /** Development mode (less minification, inline sourcemaps) */
+    dev?: boolean;
+    /** Project ID (for Agentuity metadata) */
+    projectId?: string;
+    /** Org ID (for Agentuity metadata) */
+    orgId?: string;
+    /** Region (for Agentuity metadata) */
+    region?: string;
+    /** Deployment ID (for Agentuity metadata) */
+    deploymentId?: string;
+    /** Deployment options from CLI (git info, trigger, etc.) */
+    deploymentOptions?: DeployOptions;
+    /** Deployment config from agentuity.json (resources, mode, dependencies, domains) */
+    deploymentConfig?: Record<string, unknown>;
+}
+/**
+ * A build adapter that knows how to build a specific framework.
+ */
+export interface BuildAdapter {
+    /** Framework this adapter handles */
+    name: string;
+    /**
+     * Run the build for this framework.
+     */
+    build(options: BuildAdapterOptions): Promise<BuildResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cmd/build/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cmd/build/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAElB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAE7B,0BAA0B;IAC1B,WAAW,EAAE,eAAe,CAAC;IAE7B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAEjC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAElC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1D"}

package/dist/cmd/build/adapters/types.js

@@ -0,0 +1,8 @@
+/**
+ * Build adapter types.
+ *
+ * Adapters know how to build a specific framework and package the result.
+ * They receive a DetectedFramework and produce a BuildResult.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cmd/build/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cmd/build/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/cmd/build/detect/engine.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Framework detection engine.
+ *
+ * Evaluates detector rules from the framework database against a real project
+ * directory. Handles three rule types:
+ * - matchPackage: check if package exists in dependencies/devDependencies
+ * - path: check if a file exists at the given path
+ * - path + matchContent: check if a file exists AND its content matches a regex
+ *
+ * The `every` array requires ALL rules to match.
+ * The `some` array requires at least ONE rule to match.
+ * If both are present, both conditions must be satisfied.
+ */
+import type { FrameworkDefinition } from './frameworks';
+import type { PackageJsonData } from './types';
+/**
+ * Run detection against the framework database.
+ * Returns the first matching framework definition, or null.
+ *
+ * The framework list is evaluated in order — more specific frameworks
+ * should be listed before generic ones.
+ */
+export declare function detectFromDatabase(projectDir: string, pkg: PackageJsonData, frameworkList: FrameworkDefinition[]): Promise<FrameworkDefinition | null>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/cmd/build/detect/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/cmd/build/detect/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA4E/C;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACvC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,eAAe,EACpB,aAAa,EAAE,mBAAmB,EAAE,GAClC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOrC"}

package/dist/cmd/build/detect/engine.js

@@ -0,0 +1,91 @@
+/**
+ * Framework detection engine.
+ *
+ * Evaluates detector rules from the framework database against a real project
+ * directory. Handles three rule types:
+ * - matchPackage: check if package exists in dependencies/devDependencies
+ * - path: check if a file exists at the given path
+ * - path + matchContent: check if a file exists AND its content matches a regex
+ *
+ * The `every` array requires ALL rules to match.
+ * The `some` array requires at least ONE rule to match.
+ * If both are present, both conditions must be satisfied.
+ */
+import { join } from 'node:path';
+/**
+ * Check if a single detector rule matches the project.
+ */
+async function matchRule(rule, projectDir, pkg) {
+    // Package match: check dependencies and devDependencies
+    if (rule.matchPackage) {
+        const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+        return rule.matchPackage in allDeps;
+    }
+    // File path match (with optional content matching)
+    if (rule.path) {
+        const filePath = join(projectDir, rule.path);
+        const file = Bun.file(filePath);
+        if (!(await file.exists()))
+            return false;
+        // If matchContent is specified, check file content against regex
+        if (rule.matchContent) {
+            try {
+                const content = await file.text();
+                return new RegExp(rule.matchContent).test(content);
+            }
+            catch {
+                return false;
+            }
+        }
+        // File exists, no content check needed
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if a framework definition matches the project.
+ */
+async function matchFramework(fw, projectDir, pkg) {
+    const { detectors } = fw;
+    if (!detectors)
+        return false;
+    // Check 'every' rules: ALL must match
+    if (detectors.every && detectors.every.length > 0) {
+        for (const rule of detectors.every) {
+            if (!(await matchRule(rule, projectDir, pkg))) {
+                return false;
+            }
+        }
+    }
+    // Check 'some' rules: at least ONE must match
+    if (detectors.some && detectors.some.length > 0) {
+        let anyMatch = false;
+        for (const rule of detectors.some) {
+            if (await matchRule(rule, projectDir, pkg)) {
+                anyMatch = true;
+                break;
+            }
+        }
+        if (!anyMatch)
+            return false;
+    }
+    // If we have 'every' rules and they all matched (and 'some' either matched or wasn't present), pass
+    // If we only have 'some' rules and one matched, pass
+    return true;
+}
+/**
+ * Run detection against the framework database.
+ * Returns the first matching framework definition, or null.
+ *
+ * The framework list is evaluated in order — more specific frameworks
+ * should be listed before generic ones.
+ */
+export async function detectFromDatabase(projectDir, pkg, frameworkList) {
+    for (const fw of frameworkList) {
+        if (await matchFramework(fw, projectDir, pkg)) {
+            return fw;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=engine.js.map

package/dist/cmd/build/detect/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../src/cmd/build/detect/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;GAEG;AACH,KAAK,UAAU,SAAS,CACvB,IAAkB,EAClB,UAAkB,EAClB,GAAoB;IAEpB,wDAAwD;IACxD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC;IACrC,CAAC;IAED,mDAAmD;IACnD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAEzC,iEAAiE;QACjE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,uCAAuC;QACvC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAC5B,EAAuB,EACvB,UAAkB,EAClB,GAAoB;IAEpB,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAE7B,sCAAsC;IACtC,IAAI,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;IACF,CAAC;IAED,8CAA8C;IAC9C,IAAI,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC5C,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACP,CAAC;QACF,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC7B,CAAC;IAED,oGAAoG;IACpG,qDAAqD;IACrD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,UAAkB,EAClB,GAAoB,EACpB,aAAoC;IAEpC,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,MAAM,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/cmd/build/detect/frameworks.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Framework detection database.
+ *
+ * Package detection rules (which npm packages and config files identify each
+ * framework) were informed by the @vercel/frameworks package (Apache-2.0,
+ * Copyright 2017 Vercel Inc, github.com/vercel/vercel/tree/main/packages/frameworks).
+ *
+ * All Vercel-specific properties (logos, CDN URLs, runtime config, routing
+ * rules, deploy targets) have been stripped. Only generic framework facts
+ * remain: package names, config filenames, default build commands, and output
+ * directories as documented by each framework's own docs.
+ *
+ * Framework entries are ordered by specificity — more specific frameworks
+ * (e.g., SvelteKit) should be listed before generic ones (e.g., Vite).
+ */
+export interface DetectorRule {
+    /** Match a package in dependencies or devDependencies */
+    matchPackage?: string;
+    /** Match a file path (relative to project root) */
+    path?: string;
+    /** Regex pattern to match against file content (requires `path`) */
+    matchContent?: string;
+}
+export interface FrameworkDefinition {
+    /** Human-readable name */
+    name: string;
+    /** Unique slug identifier */
+    slug: string;
+    /** Default build command (null = no build step) */
+    buildCommand: string | null;
+    /** Default output directory for static assets */
+    outputDirectory: string | null;
+    /**
+     * Static/CDN asset directory, relative to the project root.
+     *
+     * Points to the directory containing files suitable for CDN upload
+     * (JS bundles, CSS, images, fonts, etc.) after the build runs.
+     *
+     * - `null` means the entire outputDirectory IS the static output
+     *   (pure static-site generators, SPAs) — resolved to outputDirectory.
+     * - A string path (e.g., `.next/static`, `.output/public`) is resolved
+     *   relative to the project root, since some frameworks put static
+     *   assets outside their main output directory.
+     * - `undefined` (omitted) means no known static asset directory.
+     */
+    staticDir?: string | null;
+    /** Environment variable prefix for browser-inlined values */
+    envPrefix?: string;
+    /**
+     * Detection rules.
+     * - `every`: ALL must match for the framework to be detected.
+     * - `some`: at least ONE must match (in addition to all `every` rules).
+     */
+    detectors: {
+        every?: DetectorRule[];
+        some?: DetectorRule[];
+    };
+}
+/**
+ * JS/TS framework definitions for detection.
+ *
+ * Order matters — first match wins. More specific frameworks come first,
+ * generic catch-alls (Vite, Parcel) come last.
+ */
+export declare const frameworkDefinitions: FrameworkDefinition[];
+//# sourceMappingURL=frameworks.d.ts.map

package/dist/cmd/build/detect/frameworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.d.ts","sourceRoot":"","sources":["../../../../src/cmd/build/detect/frameworks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,YAAY;IAC5B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE;QACV,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;KACtB,CAAC;CACF;AAID;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,EAuQrD,CAAC"}

package/dist/cmd/build/detect/frameworks.js

@@ -0,0 +1,278 @@
+/**
+ * Framework detection database.
+ *
+ * Package detection rules (which npm packages and config files identify each
+ * framework) were informed by the @vercel/frameworks package (Apache-2.0,
+ * Copyright 2017 Vercel Inc, github.com/vercel/vercel/tree/main/packages/frameworks).
+ *
+ * All Vercel-specific properties (logos, CDN URLs, runtime config, routing
+ * rules, deploy targets) have been stripped. Only generic framework facts
+ * remain: package names, config filenames, default build commands, and output
+ * directories as documented by each framework's own docs.
+ *
+ * Framework entries are ordered by specificity — more specific frameworks
+ * (e.g., SvelteKit) should be listed before generic ones (e.g., Vite).
+ */
+// ─── Framework Database ──────────────────────────────────────────────────────
+/**
+ * JS/TS framework definitions for detection.
+ *
+ * Order matters — first match wins. More specific frameworks come first,
+ * generic catch-alls (Vite, Parcel) come last.
+ */
+export const frameworkDefinitions = [
+    // ── Meta-frameworks (most specific, check first) ──
+    {
+        name: 'Next.js',
+        slug: 'nextjs',
+        buildCommand: 'next build',
+        outputDirectory: null, // Dynamic — reads from next.config
+        staticDir: '.next/static', // Relative to project root (adapter handles standalone copy)
+        envPrefix: 'NEXT_PUBLIC_',
+        detectors: {
+            every: [{ matchPackage: 'next' }],
+        },
+    },
+    {
+        name: 'Nuxt',
+        slug: 'nuxt',
+        buildCommand: 'nuxt build',
+        outputDirectory: 'dist',
+        staticDir: '.output/public', // Nitro output; static assets served from here
+        envPrefix: 'NUXT_ENV_',
+        detectors: {
+            some: [
+                { matchPackage: 'nuxt' },
+                { matchPackage: 'nuxt3' },
+                { matchPackage: 'nuxt-edge' },
+                { matchPackage: 'nuxt-nightly' },
+            ],
+        },
+    },
+    {
+        name: 'Remix',
+        slug: 'remix',
+        buildCommand: 'remix build',
+        outputDirectory: 'public',
+        staticDir: 'public/build', // Built browser bundles
+        detectors: {
+            some: [
+                { matchPackage: '@remix-run/dev' },
+                { path: 'remix.config.js' },
+                { path: 'remix.config.mjs' },
+            ],
+        },
+    },
+    {
+        name: 'React Router',
+        slug: 'react-router',
+        buildCommand: 'react-router build',
+        outputDirectory: 'build',
+        staticDir: 'build/client', // Client-side assets
+        detectors: {
+            some: [
+                { path: 'react-router.config.js' },
+                { path: 'react-router.config.ts' },
+                { path: 'vite.config.js', matchContent: '@react-router/dev/vite' },
+                { path: 'vite.config.ts', matchContent: '@react-router/dev/vite' },
+            ],
+        },
+    },
+    {
+        name: 'SvelteKit',
+        slug: 'sveltekit',
+        buildCommand: 'vite build',
+        outputDirectory: 'public',
+        staticDir: 'build/client', // adapter-node client assets
+        detectors: {
+            every: [
+                {
+                    path: 'package.json',
+                    matchContent: '"(dev)?(d|D)ependencies":\\s*{[^}]*"@sveltejs\\/kit":\\s*".+?"[^}]*}',
+                },
+            ],
+        },
+    },
+    {
+        name: 'Astro',
+        slug: 'astro',
+        buildCommand: 'astro build',
+        outputDirectory: 'dist',
+        staticDir: null, // Entire dist/ is static (SSG default); dist/client/ for SSR
+        envPrefix: 'PUBLIC_',
+        detectors: {
+            every: [{ matchPackage: 'astro' }],
+        },
+    },
+    {
+        name: 'SolidStart',
+        slug: 'solidstart',
+        buildCommand: 'vinxi build',
+        outputDirectory: '.output',
+        staticDir: '.output/public', // Nitro-based static assets
+        envPrefix: 'VITE_',
+        detectors: {
+            every: [{ matchPackage: 'solid-js' }, { matchPackage: '@solidjs/start' }],
+        },
+    },
+    {
+        name: 'TanStack Start',
+        slug: 'tanstack-start',
+        buildCommand: 'vite build',
+        outputDirectory: 'dist',
+        staticDir: '.output/public', // Nitro-based; similar to Nuxt/SolidStart
+        detectors: {
+            every: [{ matchPackage: '@tanstack/router-plugin' }, { matchPackage: 'nitro' }],
+        },
+    },
+    {
+        name: 'RedwoodJS',
+        slug: 'redwoodjs',
+        buildCommand: 'yarn rw build',
+        outputDirectory: null, // Dynamic — depends on target
+        staticDir: 'web/dist', // Redwood web-side build output
+        envPrefix: 'REDWOOD_ENV_',
+        detectors: {
+            every: [{ matchPackage: '@redwoodjs/core' }],
+        },
+    },
+    // ── Static site generators ──
+    {
+        name: 'Gatsby.js',
+        slug: 'gatsby',
+        buildCommand: 'gatsby build',
+        outputDirectory: 'public',
+        staticDir: null, // Entire public/ is static output
+        envPrefix: 'GATSBY_',
+        detectors: {
+            every: [{ matchPackage: 'gatsby' }],
+        },
+    },
+    {
+        name: 'Eleventy',
+        slug: 'eleventy',
+        buildCommand: 'npx @11ty/eleventy',
+        outputDirectory: '_site',
+        staticDir: null, // Entire _site/ is static output
+        detectors: {
+            every: [{ matchPackage: '@11ty/eleventy' }],
+        },
+    },
+    {
+        name: 'VitePress',
+        slug: 'vitepress',
+        buildCommand: 'vitepress build docs',
+        outputDirectory: 'docs/.vitepress/dist',
+        staticDir: null, // Entire output is static
+        detectors: {
+            every: [{ matchPackage: 'vitepress' }],
+        },
+    },
+    {
+        name: 'VuePress',
+        slug: 'vuepress',
+        buildCommand: 'vuepress build src',
+        outputDirectory: 'src/.vuepress/dist',
+        staticDir: null, // Entire output is static
+        detectors: {
+            every: [{ matchPackage: 'vuepress' }],
+        },
+    },
+    {
+        name: 'Docusaurus',
+        slug: 'docusaurus',
+        buildCommand: 'docusaurus build',
+        outputDirectory: 'build',
+        staticDir: null, // Entire build/ is static output
+        detectors: {
+            some: [{ matchPackage: '@docusaurus/core' }],
+        },
+    },
+    {
+        name: 'Hexo',
+        slug: 'hexo',
+        buildCommand: 'hexo generate',
+        outputDirectory: 'public',
+        staticDir: null, // Entire public/ is static output
+        detectors: {
+            every: [{ matchPackage: 'hexo' }],
+        },
+    },
+    // ── UI frameworks (with CLI build) ──
+    {
+        name: 'Angular',
+        slug: 'angular',
+        buildCommand: 'ng build',
+        outputDirectory: 'dist',
+        staticDir: null, // Entire dist/ is static output (browser subfolder in v17+)
+        detectors: {
+            every: [{ matchPackage: '@angular/cli' }],
+        },
+    },
+    {
+        name: 'Vue.js',
+        slug: 'vue',
+        buildCommand: 'vue-cli-service build',
+        outputDirectory: 'dist',
+        staticDir: null, // Entire dist/ is static output
+        envPrefix: 'VUE_APP_',
+        detectors: {
+            every: [{ matchPackage: '@vue/cli-service' }],
+        },
+    },
+    {
+        name: 'Create React App',
+        slug: 'create-react-app',
+        buildCommand: 'react-scripts build',
+        outputDirectory: 'build',
+        staticDir: null, // Entire build/ is static output
+        envPrefix: 'REACT_APP_',
+        detectors: {
+            some: [{ matchPackage: 'react-scripts' }, { matchPackage: 'react-dev-utils' }],
+        },
+    },
+    {
+        name: 'Preact',
+        slug: 'preact',
+        buildCommand: 'preact build',
+        outputDirectory: 'build',
+        staticDir: null, // Entire build/ is static output
+        detectors: {
+            every: [{ matchPackage: 'preact-cli' }],
+        },
+    },
+    // ── Server frameworks (no default build step) ──
+    {
+        name: 'Nitro',
+        slug: 'nitro',
+        buildCommand: 'nitro build',
+        outputDirectory: 'dist',
+        staticDir: '.output/public', // Nitro static assets
+        detectors: {
+            some: [{ matchPackage: 'nitropack' }, { matchPackage: 'nitro' }],
+        },
+    },
+    // ── Generic bundlers (least specific, check last) ──
+    {
+        name: 'Vite',
+        slug: 'vite',
+        buildCommand: 'vite build',
+        outputDirectory: 'dist',
+        staticDir: null, // Entire dist/ is static output
+        envPrefix: 'VITE_',
+        detectors: {
+            every: [{ matchPackage: 'vite' }],
+        },
+    },
+    {
+        name: 'Parcel',
+        slug: 'parcel',
+        buildCommand: 'parcel build',
+        outputDirectory: 'dist',
+        staticDir: null, // Entire dist/ is static output
+        detectors: {
+            every: [{ matchPackage: 'parcel' }],
+        },
+    },
+];
+//# sourceMappingURL=frameworks.js.map

package/dist/cmd/build/detect/frameworks.js.map

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

package/dist/cmd/build/detect/generic.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generic JS/TS project detector (fallback).
+ *
+ * This is the catch-all detector for projects that don't match any specific
+ * framework. It looks for:
+ * 1. A package.json with a "build" script
+ * 2. A "start" script or "main" field for the start command
+ *
+ * If neither is found, detection fails — we can't build what we don't understand.
+ */
+import type { FrameworkDetector } from './types';
+export declare const genericDetector: FrameworkDetector;
+//# sourceMappingURL=generic.d.ts.map

package/dist/cmd/build/detect/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../../src/cmd/build/detect/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,SAAS,CAAC;AAGpE,eAAO,MAAM,eAAe,EAAE,iBAuD7B,CAAC"}

package/dist/cmd/build/detect/generic.js

@@ -0,0 +1,62 @@
+/**
+ * Generic JS/TS project detector (fallback).
+ *
+ * This is the catch-all detector for projects that don't match any specific
+ * framework. It looks for:
+ * 1. A package.json with a "build" script
+ * 2. A "start" script or "main" field for the start command
+ *
+ * If neither is found, detection fails — we can't build what we don't understand.
+ */
+import { join } from 'node:path';
+import { detectPackageManager } from './util';
+export const genericDetector = {
+    name: 'generic',
+    priority: 100, // Lowest priority — true fallback
+    async detect(projectDir, pkg) {
+        // Must have a package.json with something we can work with
+        if (!pkg.scripts?.build && !pkg.scripts?.start && !pkg.main) {
+            return null;
+        }
+        const pm = await detectPackageManager(projectDir);
+        // Determine build command
+        const buildCommand = pkg.scripts?.build ?? null;
+        if (!buildCommand) {
+            // No build script — might be a runtime-only project
+            // We'll still try if there's a start command
+        }
+        // Determine start command
+        let startCommand;
+        let serverEntry;
+        if (pkg.scripts?.start) {
+            startCommand = pkg.scripts.start;
+        }
+        else if (pkg.main) {
+            // Check if main entry exists
+            const mainFile = Bun.file(join(projectDir, pkg.main));
+            if (await mainFile.exists()) {
+                const runtime = pm === 'bun' ? 'bun' : 'node';
+                startCommand = `${runtime} ${pkg.main}`;
+                serverEntry = pkg.main;
+            }
+        }
+        // If no build and no start, we can't do anything
+        if (!buildCommand && !startCommand) {
+            return null;
+        }
+        // Detect runtime from engines field or package manager
+        const runtime = pkg.engines?.bun ? 'bun' : pm === 'bun' ? 'bun' : 'node';
+        return {
+            name: 'generic',
+            runtime,
+            packageManager: pm,
+            buildCommand: buildCommand ?? 'echo "No build step"',
+            buildOutput: '.', // Generic — build output could be anywhere
+            startCommand,
+            serverEntry,
+            port: 3000,
+            confidence: 'low',
+        };
+    },
+};
+//# sourceMappingURL=generic.js.map

package/dist/cmd/build/detect/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../../src/cmd/build/detect/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAsB;IACjD,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,GAAG,EAAE,kCAAkC;IAEjD,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG;QAC3B,2DAA2D;QAC3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAElD,0BAA0B;QAC1B,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,oDAAoD;YACpD,6CAA6C;QAC9C,CAAC;QAED,0BAA0B;QAC1B,IAAI,YAAgC,CAAC;QACrC,IAAI,WAA+B,CAAC;QAEpC,IAAI,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACxB,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;QAClC,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACrB,6BAA6B;YAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,IAAI,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC9C,YAAY,GAAG,GAAG,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACxC,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;YACxB,CAAC;QACF,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,uDAAuD;QACvD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAEzE,OAAO;YACN,IAAI,EAAE,SAAS;YACf,OAAO;YACP,cAAc,EAAE,EAAE;YAClB,YAAY,EAAE,YAAY,IAAI,sBAAsB;YACpD,WAAW,EAAE,GAAG,EAAE,2CAA2C;YAC7D,YAAY;YACZ,WAAW;YACX,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,KAAK;SACjB,CAAC;IACH,CAAC;CACD,CAAC"}