@agentuity/cli 3.0.0-alpha.7 → 3.0.0-beta.0

package/src/cmd/build/adapters/nextjs.ts

@@ -1,146 +0,0 @@
-/**
- * Next.js build adapter.
- *
- * Handles Next.js-specific build concerns:
- * 1. Ensures standalone output mode is configured
- * 2. Copies the standalone directory + static assets to output
- * 3. Sets up the correct start command
- */
-
-import { join } from 'node:path';
-import { cpSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
-import type { BuildAdapter, BuildAdapterOptions, BuildResult } from './types';
-import { installDependencies, runBuildCommand } from './generic';
-
-/**
- * Ensure next.config has output: 'standalone'.
- *
- * Rather than modifying the user's config file, we set the NEXT_OUTPUT env var
- * which can be read in next.config.js, or we check if standalone is already configured.
- * As a fallback, we also set the experimental config via env.
- */
-function getNextBuildEnv(): Record<string, string> {
-	return {
-		// Signal to the build that we want standalone output
-		NEXT_PRIVATE_STANDALONE: 'true',
-	};
-}
-
-export const nextjsAdapter: BuildAdapter = {
-	name: 'nextjs',
-
-	async build(options: BuildAdapterOptions): Promise<BuildResult> {
-		const { projectDir, framework, outputDir, logger } = options;
-		const started = Date.now();
-		const logs: string[] = [];
-
-		// Step 1: Install dependencies
-		logger.debug('Installing dependencies...');
-		const installStart = Date.now();
-		await installDependencies(projectDir, framework.packageManager, logger);
-		logs.push(`✓ Dependencies installed in ${Date.now() - installStart}ms`);
-
-		// Step 2: Check if standalone mode is configured
-		const nextConfigPath = await findNextConfig(projectDir);
-		let standaloneConfigured = false;
-		if (nextConfigPath) {
-			const content = readFileSync(nextConfigPath, 'utf-8');
-			standaloneConfigured =
-				content.includes("'standalone'") || content.includes('"standalone"');
-		}
-
-		if (!standaloneConfigured) {
-			logger.debug(
-				'Standalone output not detected in next.config — setting NEXT_PRIVATE_STANDALONE=true'
-			);
-		}
-
-		// Step 3: Run the build with standalone env
-		const buildEnv = {
-			...framework.buildEnv,
-			...getNextBuildEnv(),
-		};
-
-		logger.debug(`Running Next.js build: ${framework.buildCommand}`);
-		const buildStart = Date.now();
-		await runBuildCommand(
-			projectDir,
-			framework.buildCommand,
-			framework.packageManager,
-			buildEnv,
-			logger
-		);
-		logs.push(`✓ Next.js build completed in ${Date.now() - buildStart}ms`);
-
-		// Step 4: Package the standalone output
-		mkdirSync(outputDir, { recursive: true });
-
-		const standalonePath = join(projectDir, '.next', 'standalone');
-		const staticPath = join(projectDir, '.next', 'static');
-		const publicPath = join(projectDir, 'public');
-
-		if (existsSync(standalonePath)) {
-			// Copy standalone server
-			logger.debug('Copying standalone server...');
-			cpSync(standalonePath, outputDir, { recursive: true });
-
-			// Copy static assets into .next/static within the output
-			if (existsSync(staticPath)) {
-				const staticDst = join(outputDir, '.next', 'static');
-				mkdirSync(staticDst, { recursive: true });
-				cpSync(staticPath, staticDst, { recursive: true });
-			}
-
-			// Copy public assets
-			if (existsSync(publicPath)) {
-				const publicDst = join(outputDir, 'public');
-				mkdirSync(publicDst, { recursive: true });
-				cpSync(publicPath, publicDst, { recursive: true });
-			}
-
-			logs.push('✓ Standalone output packaged');
-		} else {
-			// Fallback: copy the whole .next directory
-			logger.debug('No standalone output found — copying full .next directory');
-			const nextDst = join(outputDir, '.next');
-			cpSync(join(projectDir, '.next'), nextDst, { recursive: true });
-
-			// Copy package.json and node_modules
-			cpSync(join(projectDir, 'package.json'), join(outputDir, 'package.json'));
-			if (existsSync(join(projectDir, 'node_modules'))) {
-				cpSync(join(projectDir, 'node_modules'), join(outputDir, 'node_modules'), {
-					recursive: true,
-				});
-			}
-
-			logs.push('⚠ No standalone output — using full build (consider enabling standalone mode)');
-		}
-
-		// Determine start command based on what we have
-		const hasStandalone = existsSync(join(outputDir, 'server.js'));
-		const startCommand = hasStandalone ? 'node server.js' : 'node node_modules/.bin/next start';
-
-		return {
-			outputDir,
-			startCommand,
-			serverEntry: hasStandalone ? 'server.js' : undefined,
-			staticDir: existsSync(join(outputDir, '.next', 'static'))
-				? join(outputDir, '.next', 'static')
-				: undefined,
-			port: framework.port ?? 3000,
-			duration: Date.now() - started,
-			logs,
-		};
-	},
-};
-
-async function findNextConfig(projectDir: string): Promise<string | null> {
-	const candidates = ['next.config.js', 'next.config.mjs', 'next.config.ts', 'next.config.cjs'];
-
-	for (const name of candidates) {
-		const path = join(projectDir, name);
-		if (existsSync(path)) return path;
-	}
-
-	return null;
-}

package/src/cmd/build/adapters/static-server.ts

@@ -1,143 +0,0 @@
-/**
- * Static file server injector.
- *
- * When a framework has no start command (e.g., static-only builds from
- * Vite SPA, Gatsby, Eleventy), this module injects a minimal file server
- * so there's always a valid start command in launch.json.
- *
- * The server is a small Node.js http script that:
- * - Serves files from the build output directory
- * - Returns index.html for non-file routes (SPA support)
- * - Sets appropriate cache headers
- */
-
-import { join } from 'node:path';
-import { writeFileSync, mkdirSync } from 'node:fs';
-
-/**
- * The static server script, inlined as a string.
- * Uses Bun.serve which is available in the deployment runtime.
- * Falls back to a Node.js http server if Bun is not available.
- */
-const STATIC_SERVER_SCRIPT = `#!/usr/bin/env node
-/**
- * Minimal static file server — auto-generated by Agentuity build.
- * Serves files from the current directory with SPA fallback.
- */
-const path = require('path');
-const fs = require('fs');
-const http = require('http');
-
-const PORT = parseInt(process.env.PORT || '3000', 10);
-const ROOT = __dirname;
-
-const MIME_TYPES = {
-   '.html': 'text/html',
-   '.js': 'application/javascript',
-   '.css': 'text/css',
-   '.json': 'application/json',
-   '.png': 'image/png',
-   '.jpg': 'image/jpeg',
-   '.jpeg': 'image/jpeg',
-   '.gif': 'image/gif',
-   '.svg': 'image/svg+xml',
-   '.ico': 'image/x-icon',
-   '.webp': 'image/webp',
-   '.avif': 'image/avif',
-   '.woff': 'font/woff',
-   '.woff2': 'font/woff2',
-   '.ttf': 'font/ttf',
-   '.otf': 'font/otf',
-   '.map': 'application/json',
-   '.txt': 'text/plain',
-   '.xml': 'application/xml',
-   '.webmanifest': 'application/manifest+json',
-};
-
-function getMimeType(filePath) {
-   const ext = path.extname(filePath).toLowerCase();
-   return MIME_TYPES[ext] || 'application/octet-stream';
-}
-
-function isImmutableAsset(filePath) {
-   // Hashed assets from bundlers (e.g., main-abc123.js)
-   return /\\.[a-f0-9]{8,}\\./i.test(filePath);
-}
-
-const server = http.createServer((req, res) => {
-   const url = new URL(req.url, \`http://localhost:\${PORT}\`);
-   let filePath = path.join(ROOT, url.pathname);
-
-   // Security: prevent directory traversal
-   if (!filePath.startsWith(ROOT)) {
-      res.writeHead(403);
-      res.end('Forbidden');
-      return;
-   }
-
-   // Try to serve the exact file
-   if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
-      const content = fs.readFileSync(filePath);
-      const mime = getMimeType(filePath);
-      const headers = { 'Content-Type': mime };
-
-      // Immutable caching for hashed assets
-      if (isImmutableAsset(filePath)) {
-         headers['Cache-Control'] = 'public, max-age=31536000, immutable';
-      } else {
-         headers['Cache-Control'] = 'public, max-age=0, must-revalidate';
-      }
-
-      res.writeHead(200, headers);
-      res.end(content);
-      return;
-   }
-
-   // Try index.html in the directory
-   if (fs.existsSync(filePath) && fs.statSync(filePath).isDirectory()) {
-      const indexPath = path.join(filePath, 'index.html');
-      if (fs.existsSync(indexPath)) {
-         const content = fs.readFileSync(indexPath);
-         res.writeHead(200, { 'Content-Type': 'text/html', 'Cache-Control': 'public, max-age=0, must-revalidate' });
-         res.end(content);
-         return;
-      }
-   }
-
-   // SPA fallback: serve root index.html for non-file routes
-   const indexPath = path.join(ROOT, 'index.html');
-   if (fs.existsSync(indexPath)) {
-      const content = fs.readFileSync(indexPath);
-      res.writeHead(200, { 'Content-Type': 'text/html', 'Cache-Control': 'public, max-age=0, must-revalidate' });
-      res.end(content);
-      return;
-   }
-
-   res.writeHead(404);
-   res.end('Not Found');
-});
-
-server.listen(PORT, () => {
-   console.log(\`Static server listening on port \${PORT}\`);
-});
-`;
-
-/**
- * Inject a static file server into the build output directory.
- *
- * @param outputDir - Absolute path to the build output
- * @returns The start command for the injected server
- */
-export function injectStaticServer(outputDir: string): {
-	startCommand: string;
-	serverEntry: string;
-} {
-	mkdirSync(outputDir, { recursive: true });
-	const serverPath = join(outputDir, '_serve.js');
-	writeFileSync(serverPath, STATIC_SERVER_SCRIPT, 'utf-8');
-
-	return {
-		startCommand: 'node _serve.js',
-		serverEntry: '_serve.js',
-	};
-}

package/src/cmd/build/adapters/types.ts

@@ -1,93 +0,0 @@
-/**
- * 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>;
-}

package/src/cmd/build/ci.ts

@@ -1,225 +0,0 @@
-import type { Logger } from '@agentuity/core';
-import { spawn } from 'bun';
-import { mkdir, mkdtemp, readdir, realpath, rm, stat } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { ErrorCode } from '../../errors';
-import * as tui from '../../tui';
-
-export interface CIBuildOptions {
-	url?: string;
-	directory?: string;
-	trigger?: string;
-	event?: string;
-	message?: string;
-	commit?: string;
-	commitUrl?: string;
-	branch?: string;
-	repo?: string;
-	provider?: string;
-	pullRequestNumber?: number;
-	pullRequestUrl?: string;
-	logsUrl?: string;
-}
-
-async function runCommand(cmd: string[], cwd: string): Promise<number> {
-	const proc = spawn({
-		cmd,
-		cwd,
-		env: { ...process.env, CI: 'true' },
-		stdin: 'ignore',
-		stdout: 'inherit',
-		stderr: 'inherit',
-	});
-	await proc.exited;
-	return proc.exitCode ?? 1;
-}
-async function downloadSource(url: string, targetPath: string): Promise<void> {
-	let lastError: unknown;
-
-	for (let attempt = 1; attempt <= 3; attempt++) {
-		try {
-			const response = await fetch(url, { signal: AbortSignal.timeout(60_000) });
-			if (!response.ok) {
-				throw new Error(`Download failed with status ${response.status}`);
-			}
-
-			await Bun.write(targetPath, await response.arrayBuffer());
-			return;
-		} catch (error) {
-			lastError = error;
-			if (attempt < 3) {
-				tui.info(`Download failed (attempt ${attempt}/3), retrying...`);
-			}
-		}
-	}
-
-	throw lastError instanceof Error ? lastError : new Error('Download failed');
-}
-
-function buildDeployArgs(opts: CIBuildOptions): string[] {
-	const args: string[] = [];
-
-	if (opts.trigger) args.push('--trigger', opts.trigger);
-	if (opts.event) args.push('--event', opts.event);
-	if (opts.message) args.push('--message', opts.message);
-	if (opts.commit) args.push('--commit', opts.commit);
-	if (opts.commitUrl) args.push('--commit-url', opts.commitUrl);
-	if (opts.branch) args.push('--branch', opts.branch);
-	if (opts.repo) args.push('--repo', opts.repo);
-	if (opts.provider) args.push('--provider', opts.provider);
-	if (opts.pullRequestNumber !== undefined) {
-		args.push('--pull-request-number', String(opts.pullRequestNumber));
-	}
-	if (opts.pullRequestUrl) args.push('--pull-request-url', opts.pullRequestUrl);
-	if (opts.logsUrl) args.push('--logs-url', opts.logsUrl);
-
-	return args;
-}
-
-export async function runCIBuild(opts: CIBuildOptions, _logger: Logger): Promise<void> {
-	let tempDir = '';
-	// Track subprocess exit code so we can clean up in finally before calling process.exit().
-	// Bun does not reliably honor process.exitCode, so an explicit process.exit() is required.
-	let pendingExitCode: number | undefined;
-
-	try {
-		let projectDir: string;
-
-		if (opts.url) {
-			// Download and extract source from URL
-			tempDir = await mkdtemp(join(tmpdir(), 'agentuity-ci-build-'));
-			const sourceZipPath = join(tempDir, 'source.zip');
-			const extractPath = join(tempDir, 'build');
-
-			tui.info('1️⃣ Downloading source code from GitHub...');
-			await downloadSource(opts.url, sourceZipPath);
-
-			tui.info('2️⃣ Unzipping source code from GitHub...');
-			await mkdir(extractPath, { recursive: true });
-			const unzipExit = await runCommand(
-				['unzip', '-q', sourceZipPath, '-d', extractPath],
-				tempDir
-			);
-			if (unzipExit !== 0 && unzipExit !== 1) {
-				tui.error(`Failed to unzip source archive (exit ${unzipExit})`);
-				pendingExitCode = unzipExit;
-				return;
-			}
-
-			const extractedEntries = await readdir(extractPath, { withFileTypes: true });
-			const extractedDirs = extractedEntries.filter((entry) => entry.isDirectory());
-			if (extractedDirs.length !== 1) {
-				tui.fatal(
-					`Expected one root directory after unzip, found ${extractedDirs.length}`,
-					ErrorCode.BUILD_FAILED
-				);
-			}
-
-			const sourceRoot = extractedDirs.at(0);
-			if (!sourceRoot) {
-				tui.fatal('Could not determine extracted source directory', ErrorCode.BUILD_FAILED);
-			}
-
-			const sourceRootDir = join(extractPath, sourceRoot.name);
-			projectDir = sourceRootDir;
-			if (opts.directory) {
-				projectDir = join(sourceRootDir, opts.directory);
-			}
-
-			const projectStats = await stat(projectDir).catch(() => null);
-			if (!projectStats?.isDirectory()) {
-				tui.fatal(`Build directory not found: ${projectDir}`, ErrorCode.CONFIG_INVALID);
-			}
-
-			// Resolve symlinks and verify the project dir is within the source root
-			const realProjectDir = await realpath(projectDir).catch(() => null);
-			const realSourceRoot = await realpath(sourceRootDir).catch(() => null);
-			if (!realProjectDir || !realSourceRoot || !realProjectDir.startsWith(realSourceRoot)) {
-				tui.fatal(
-					'Directory path escapes the source root (path traversal denied)',
-					ErrorCode.CONFIG_INVALID
-				);
-			}
-			projectDir = realProjectDir;
-		} else {
-			// No URL — use current working directory (source already present, e.g. snapshot-based deploy)
-			tui.info('1️⃣ Using local source (no download URL provided)...');
-			projectDir = process.cwd();
-			if (opts.directory) {
-				projectDir = join(projectDir, opts.directory);
-			}
-		}
-
-		const sdkKey = process.env.AGENTUITY_SDK_KEY;
-		if (sdkKey) {
-			await Bun.write(join(projectDir, '.env'), `AGENTUITY_SDK_KEY=${sdkKey}\n`);
-		}
-
-		tui.info('3️⃣ Installing your project dependencies...');
-		const installExit = await runCommand(['bun', 'install'], projectDir);
-		if (installExit !== 0) {
-			tui.error(`Dependency installation failed (exit ${installExit})`);
-			pendingExitCode = installExit;
-			return;
-		}
-
-		const packageJsonPath = join(projectDir, 'package.json');
-		const packageJsonFile = Bun.file(packageJsonPath);
-		let scripts: Record<string, string> | undefined;
-		if (await packageJsonFile.exists()) {
-			const packageJson = (await packageJsonFile.json()) as {
-				scripts?: Record<string, string>;
-			};
-			scripts = packageJson.scripts;
-		}
-
-		if (scripts?.predeploy) {
-			tui.info('🔧 Running predeploy script...');
-			const predeployExit = await runCommand(['bun', 'run', '--bun', 'predeploy'], projectDir);
-			if (predeployExit !== 0) {
-				tui.error(`Predeploy failed (exit ${predeployExit})`);
-				pendingExitCode = predeployExit;
-				return;
-			}
-		}
-
-		tui.info('4️⃣ Deploying your project...');
-		// Use the locally installed CLI binary instead of bunx to avoid
-		// bunx resolution crashes on certain Bun versions (e.g. arm64 segfaults)
-		const localCliBin = join(projectDir, 'node_modules', '.bin', 'agentuity');
-		const cliExists = await stat(localCliBin).catch(() => null);
-		const deployCmd = cliExists
-			? ['bun', localCliBin, 'deploy', ...buildDeployArgs(opts)]
-			: ['bunx', '--bun', 'agentuity', 'deploy', ...buildDeployArgs(opts)];
-		tui.info(`Using CLI: ${cliExists ? localCliBin : 'bunx --bun agentuity'}`);
-		const deployExit = await runCommand(deployCmd, projectDir);
-		if (deployExit !== 0) {
-			tui.error(`Deploy failed (exit ${deployExit})`);
-			pendingExitCode = deployExit;
-			return;
-		}
-
-		if (scripts?.postdeploy) {
-			tui.info('🔧 Running postdeploy script...');
-			const postdeployExit = await runCommand(['bun', 'run', '--bun', 'postdeploy'], projectDir);
-			if (postdeployExit !== 0) {
-				tui.error(`Postdeploy failed (exit ${postdeployExit})`);
-				pendingExitCode = postdeployExit;
-				return;
-			}
-		}
-
-		tui.success('✅ Your project has been built...');
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		tui.fatal(`CI build failed: ${message}`, ErrorCode.BUILD_FAILED);
-	} finally {
-		if (tempDir) {
-			await rm(tempDir, { recursive: true, force: true });
-		}
-		if (pendingExitCode !== undefined) {
-			process.exit(pendingExitCode);
-		}
-	}
-}