@agentuity/cli 2.0.11 → 3.0.0-alpha.1

package/src/cmd/build/vite/db-rewrite.ts

@@ -1,189 +0,0 @@
-/**
- * DB import rewriting helpers for the Bun.build plugin.
- *
- * These functions rewrite `import { SQL } from 'bun'` → `@agentuity/postgres`
- * and `import { Pool } from 'pg'` → `@agentuity/postgres` so that
- * the Agentuity resilient postgres driver is bundled into the server output.
- */
-
-/**
- * Map a file path to the appropriate Bun loader based on extension.
- */
-export const getLoaderForPath = (filePath: string): string => {
-	if (filePath.endsWith('.tsx')) return 'tsx';
-	if (filePath.endsWith('.jsx')) return 'jsx';
-	if (filePath.endsWith('.ts')) return 'ts';
-	if (filePath.endsWith('.mts') || filePath.endsWith('.cts')) return 'ts';
-	if (filePath.endsWith('.js')) return 'js';
-	if (filePath.endsWith('.mjs')) return 'js';
-	if (filePath.endsWith('.cjs')) return 'js';
-	return 'js';
-};
-
-/**
- * Split named import/export specifiers, moving the `targetName` specifier
- * to the `move` list while leaving everything else in `stay`.
- *
- * Type-only specifiers (prefixed with `type `) always stay.
- * Aliases (`SQL as Foo`) are matched on the import name, not the alias.
- */
-export const rewriteNamedSpecifiers = (
-	specifiers: string,
-	targetName: string
-): {
-	stay: string[];
-	move: string[];
-	moved: boolean;
-} => {
-	const stay: string[] = [];
-	const move: string[] = [];
-	for (const raw of specifiers.split(',')) {
-		const spec = raw.trim();
-		if (!spec) continue;
-		const isType = spec.startsWith('type ');
-		const specText = isType ? spec.slice(5).trim() : spec;
-		const [importName] = specText.split(/\s+as\s+/);
-		if (!isType && importName === targetName) {
-			move.push(specText);
-		} else {
-			stay.push(spec);
-		}
-	}
-
-	return { stay, move, moved: move.length > 0 };
-};
-
-/**
- * Rewrite `import { SQL } from 'bun'` → `import { SQL } from '@agentuity/postgres'`.
- *
- * - Type-only imports (`import type { SQL }`) are left untouched.
- * - Inline type specifiers (`import { type SQL }`) are left untouched.
- * - Mixed imports are split: non-SQL specifiers stay with `'bun'`.
- * - Works with both single and double quotes, with or without semicolons.
- * - Preserves leading indentation.
- */
-export const rewriteBunImports = (contents: string): { contents: string; changed: boolean } => {
-	const bunNamedRegex =
-		/(^|\n)([\t ]*)(import|export)\s+(type\s+)?\{([^}]+)\}\s+from\s+(['"])bun\6\s*;?/g;
-	let changed = false;
-	const updated = contents.replace(
-		bunNamedRegex,
-		(match, prefix, indent, keyword, typeKeyword, specifiers) => {
-			if (typeKeyword) {
-				return match;
-			}
-			const { stay, move, moved } = rewriteNamedSpecifiers(specifiers, 'SQL');
-			if (!moved) {
-				return match;
-			}
-			changed = true;
-			const statements: string[] = [];
-			if (stay.length > 0) {
-				statements.push(`${indent}${keyword} { ${stay.join(', ')} } from 'bun';`);
-			}
-			if (move.length > 0) {
-				statements.push(
-					`${indent}${keyword} { ${move.join(', ')} } from '@agentuity/postgres';`
-				);
-			}
-			return `${prefix}${statements.join('\n')}`;
-		}
-	);
-
-	return { contents: updated, changed };
-};
-
-/**
- * Rewrite `import { Pool } from 'pg'` → `import { Pool } from '@agentuity/postgres'`.
- *
- * - Type-only imports (`import type { Pool }`) are left untouched.
- * - Namespace imports (`import * as pg`) are left untouched.
- * - Default imports (`import pg from 'pg'`) are left untouched.
- * - Mixed default+named imports are split correctly.
- * - Works with both `import` and `export` statements.
- */
-export const rewritePgImports = (contents: string): { contents: string; changed: boolean } => {
-	const importRegex = /(^|\n)([\t ]*)(import)\s+(type\s+)?([^;]+?)\s+from\s+(['"])pg\6\s*;?/g;
-	const exportRegex = /(^|\n)([\t ]*)(export)\s+(?!type\b)\{([^}]+)\}\s+from\s+(['"])pg\5\s*;?/g;
-	let changed = false;
-
-	const updatedImports = contents.replace(
-		importRegex,
-		(match, prefix, indent, keyword, typeKeyword, clause) => {
-			if (typeKeyword) {
-				return match; // import type { ... } from 'pg' — skip entirely
-			}
-			const trimmed = clause.trim();
-			if (trimmed.startsWith('*')) {
-				return match;
-			}
-
-			let defaultImport: string | undefined;
-			let namedSpecifiers: string | undefined;
-			if (trimmed.startsWith('{')) {
-				namedSpecifiers = trimmed.slice(1, trimmed.lastIndexOf('}'));
-			} else if (trimmed.includes('{')) {
-				const [defaultPart, rest] = trimmed.split('{', 2);
-				defaultImport = defaultPart.replace(/,\s*$/, '').trim();
-				namedSpecifiers = rest.slice(0, rest.lastIndexOf('}'));
-			} else {
-				defaultImport = trimmed;
-			}
-
-			const movedNamed = namedSpecifiers
-				? rewriteNamedSpecifiers(namedSpecifiers, 'Pool')
-				: { stay: [], move: [], moved: false };
-			const moveDefault = false; // Default import is the entire pg module, not Pool — keep it with 'pg'
-			const shouldMove = moveDefault || movedNamed.moved;
-
-			if (!shouldMove) {
-				return match;
-			}
-
-			changed = true;
-			const statements: string[] = [];
-			const pgNamed = movedNamed.stay;
-			const postgresNamed = movedNamed.move;
-			const pgDefault = moveDefault ? undefined : defaultImport;
-			const postgresDefault = moveDefault ? defaultImport : undefined;
-
-			if (pgDefault || pgNamed.length > 0) {
-				const parts: string[] = [];
-				if (pgDefault) parts.push(pgDefault);
-				if (pgNamed.length > 0) parts.push(`{ ${pgNamed.join(', ')} }`);
-				statements.push(`${indent}${keyword} ${parts.join(', ')} from 'pg';`);
-			}
-			if (postgresDefault || postgresNamed.length > 0) {
-				const parts: string[] = [];
-				if (postgresDefault) parts.push(postgresDefault);
-				if (postgresNamed.length > 0) parts.push(`{ ${postgresNamed.join(', ')} }`);
-				statements.push(`${indent}${keyword} ${parts.join(', ')} from '@agentuity/postgres';`);
-			}
-
-			return `${prefix}${statements.join('\n')}`;
-		}
-	);
-
-	const updatedExports = updatedImports.replace(
-		exportRegex,
-		(match, prefix, indent, keyword, specifiers) => {
-			const { stay, move, moved } = rewriteNamedSpecifiers(specifiers, 'Pool');
-			if (!moved) {
-				return match;
-			}
-			changed = true;
-			const statements: string[] = [];
-			if (stay.length > 0) {
-				statements.push(`${indent}${keyword} { ${stay.join(', ')} } from 'pg';`);
-			}
-			if (move.length > 0) {
-				statements.push(
-					`${indent}${keyword} { ${move.join(', ')} } from '@agentuity/postgres';`
-				);
-			}
-			return `${prefix}${statements.join('\n')}`;
-		}
-	);
-
-	return { contents: updatedExports, changed };
-};

package/src/cmd/build/vite/docs-generator.ts

@@ -1,103 +0,0 @@
-/**
- * Documentation Generator
- *
- * Generates README.md and AGENTS.md in src/generated/ directory
- * Only writes files if they don't already exist (preserves user modifications)
- */
-
-import { join } from 'node:path';
-import { mkdir } from 'node:fs/promises';
-import type { Logger } from '../../../types';
-
-const README_CONTENT = `# Generated Files - DO NOT EDIT
-
-This directory contains auto-generated TypeScript files created by the Agentuity build system.
-
-**These files are regenerated on every build.** Any manual changes will be overwritten.
-
-## Generated Files
-
-- \`registry.ts\` - Agent registry from \`src/agent/**\`
-- \`app.ts\` - Application entry point
-- \`analytics-config.ts\` - Web analytics configuration from \`agentuity.json\`
-- \`webanalytics.ts\` - Web analytics injection and route registration
-- \`env.d.ts\` - TypeScript types for environment variables from \`.env\` files
-- \`state.ts\` - App state type (only generated when \`setup()\` returns state in \`app.ts\`)
-- \`router.ts\` - Runtime wrapper with type augmentation (only generated when \`setup()\` returns state in \`app.ts\`)
-
-## Environment Variable Types
-
-The \`env.d.ts\` file provides TypeScript intellisense for your environment variables:
-
-- **ProcessEnv**: All variables from your \`.env\` files are typed as \`string\`
-- **ImportMetaEnv**: Only \`VITE_*\`, \`AGENTUITY_PUBLIC_*\`, and \`PUBLIC_*\` prefixed variables (for client-side use)
-
-Files are merged based on build mode:
-- **Development**: \`.env.{profile}\` → \`.env.development\` → \`.env\` (later files override)
-- **Production**: \`.env.{profile}\` → \`.env\` → \`.env.production\` (later files override)
-
-## For Developers
-
-Do not modify these files. Instead:
-- Add/modify agents in \`src/agent/\`
-- Add/modify routes in \`src/api/\`
-- Configure app in \`app.ts\`
-- Add environment variables to \`.env\` files
-
-These files ARE version controlled to enable better tooling and type checking.
-`;
-
-const AGENTS_MD_CONTENT = `# AI Agent Instructions
-
-**CRITICAL:** Files in this directory are AUTO-GENERATED by the Agentuity build system.
-
-## Rules for AI Agents
-
-1. ❌ NEVER edit files in \`src/generated/\`
-2. ❌ NEVER include \`src/generated/\` files in context when analyzing code
-3. ❌ NEVER suggest changes to generated files
-4. ✅ Ignore this directory when searching for user code
-5. ✅ Direct users to modify source files in \`src/agent/\`, \`src/api/\`, \`app.ts\`, or \`.env\` files
-
-## What Gets Generated
-
-- \`registry.ts\` - Built from agent discovery in \`src/agent/\`
-- \`app.ts\` - Entry point assembled from project configuration
-- \`analytics-config.ts\` - Web analytics configuration from \`agentuity.json\`
-- \`webanalytics.ts\` - Web analytics injection and route registration
-- \`env.d.ts\` - TypeScript types for environment variables from \`.env\` files
-- \`state.ts\` - App state type (only generated when \`setup()\` returns state in \`app.ts\`)
-- \`router.ts\` - Runtime wrapper with type augmentation (only generated when \`setup()\` returns state)
-
-These files are regenerated on every \`bun run build\` or \`bun run dev\`.
-`;
-
-/**
- * Generate documentation files in src/generated/ directory
- * Only creates files if they don't already exist
- */
-export async function generateDocumentation(srcDir: string, logger: Logger): Promise<void> {
-	const generatedDir = join(srcDir, 'generated');
-
-	// Ensure directory exists
-	await mkdir(generatedDir, { recursive: true });
-
-	const readmePath = join(generatedDir, 'README.md');
-	const agentsMdPath = join(generatedDir, 'AGENTS.md');
-
-	// Generate README.md if it doesn't exist
-	if (!(await Bun.file(readmePath).exists())) {
-		await Bun.write(readmePath, README_CONTENT);
-		logger.debug('Generated src/generated/README.md');
-	} else {
-		logger.trace('Skipping README.md - file already exists');
-	}
-
-	// Generate AGENTS.md if it doesn't exist
-	if (!(await Bun.file(agentsMdPath).exists())) {
-		await Bun.write(agentsMdPath, AGENTS_MD_CONTENT);
-		logger.debug('Generated src/generated/AGENTS.md');
-	} else {
-		logger.trace('Skipping AGENTS.md - file already exists');
-	}
-}

package/src/cmd/build/vite/env-types-generator.ts

@@ -1,145 +0,0 @@
-/**
- * Environment Types Generator
- *
- * Generates src/generated/env.d.ts by analyzing local .env files
- */
-
-import { join } from 'node:path';
-import { existsSync, mkdirSync } from 'node:fs';
-import { getEnvFilePaths, readEnvFile, isPublicVarKey } from '../../../env-util';
-import type { Logger } from '../../../types';
-
-/**
- * Generate TypeScript declarations for environment variables
- */
-function generateEnvTypesContent(keys: string[]): string {
-	const sortedKeys = [...keys].sort();
-	const publicKeys = sortedKeys.filter(isPublicVarKey);
-
-	// Build ProcessEnv interface entries
-	const processEnvEntries =
-		sortedKeys.length > 0
-			? sortedKeys.map((key) => `\t\treadonly ${key}: string;`).join('\n')
-			: '\t\t\t// No environment variables found';
-
-	// Build ImportMetaEnv interface entries (only public keys: VITE_*, AGENTUITY_PUBLIC_*, PUBLIC_*)
-	const importMetaEnvEntries =
-		publicKeys.length > 0
-			? publicKeys.map((key) => `\treadonly ${key}: string;`).join('\n')
-			: '\t// No VITE_*, AGENTUITY_PUBLIC_*, or PUBLIC_* prefixed variables found';
-
-	return `// @generated
-// AUTO-GENERATED from local .env files
-// This file is auto-generated by the build tool - do not edit manually
-
-declare global {
-	namespace NodeJS {
-		interface ProcessEnv {
-${processEnvEntries}
-		}
-	}
-}
-
-// Vite-compatible environment types
-// Only includes variables with VITE_, AGENTUITY_PUBLIC_, or PUBLIC_ prefix
-interface ImportMetaEnv {
-${importMetaEnvEntries}
-}
-
-interface ImportMeta {
-	readonly env: ImportMetaEnv;
-}
-
-export {};
-
-// FOUND AN ERROR IN THIS FILE?
-// Please file an issue at https://github.com/agentuity/sdk/issues
-// or if you know the fix please submit a PR!
-`;
-}
-
-export interface GenerateEnvTypesOptions {
-	/** Root directory of the project */
-	rootDir: string;
-	/** Source directory (typically rootDir/src) */
-	srcDir: string;
-	/** Logger instance */
-	logger: Logger;
-	/** Whether building for production (affects .env file precedence) */
-	isProduction: boolean;
-	/** Optional config profile name (e.g., 'staging', 'test') for .env.{profile} files */
-	profile?: string;
-}
-
-/**
- * Generate environment type definitions from local .env files
- *
- * @param options - Generation options
- * @returns true if types were generated, false if no env files found
- */
-export async function generateEnvTypes(options: GenerateEnvTypesOptions): Promise<boolean> {
-	const { rootDir, srcDir, logger, isProduction, profile } = options;
-
-	logger.debug('[env-types] Starting env types generation...');
-	logger.debug(`[env-types] rootDir: ${rootDir}`);
-	logger.debug(`[env-types] srcDir: ${srcDir}`);
-	logger.debug(`[env-types] isProduction: ${isProduction}`);
-	logger.debug(`[env-types] profile: ${profile ?? '(none)'}`);
-
-	// Get env file paths based on build mode and profile
-	// Dev: ['.env.{profile}', '.env.development', '.env'] - later files override earlier
-	// Prod: ['.env.{profile}', '.env', '.env.production'] - later files override earlier
-	const envFilePaths = getEnvFilePaths(rootDir, { isProduction, configName: profile });
-	logger.debug(`[env-types] Env file paths to check: ${envFilePaths.join(', ')}`);
-
-	// Read and merge env files (later files override earlier)
-	const mergedEnv: Record<string, string> = {};
-	let foundAnyFile = false;
-
-	for (const filePath of envFilePaths) {
-		const envVars = await readEnvFile(filePath);
-		const keyCount = Object.keys(envVars).length;
-
-		if (keyCount > 0) {
-			foundAnyFile = true;
-			logger.debug(`[env-types] Read ${keyCount} vars from ${filePath}`);
-
-			// Merge - later values override earlier
-			for (const [key, value] of Object.entries(envVars)) {
-				mergedEnv[key] = value;
-			}
-		} else {
-			logger.debug(`[env-types] No vars found in ${filePath} (file may not exist)`);
-		}
-	}
-
-	if (!foundAnyFile) {
-		logger.debug('[env-types] No .env files found, skipping env types generation');
-		return false;
-	}
-
-	// Extract just the keys (we don't include values in types)
-	const keys = Object.keys(mergedEnv);
-	logger.debug(`[env-types] Total unique keys: ${keys.length}`);
-
-	// Determine output path
-	const outDir = join(srcDir, 'generated');
-	const outputPath = join(outDir, 'env.d.ts');
-
-	// Ensure output directory exists
-	if (!existsSync(outDir)) {
-		mkdirSync(outDir, { recursive: true });
-		logger.debug(`[env-types] Created output directory: ${outDir}`);
-	}
-
-	// Generate and write types
-	const typesContent = generateEnvTypesContent(keys);
-	await Bun.write(outputPath, typesContent);
-
-	const publicKeyCount = keys.filter(isPublicVarKey).length;
-	logger.debug(
-		`[env-types] Generated env types with ${keys.length} keys (${publicKeyCount} public) at ${outputPath}`
-	);
-
-	return true;
-}

package/src/cmd/build/vite/index.ts

@@ -1,3 +0,0 @@
-// Re-export plugins for direct use in vite.config.ts
-export { browserEnvPlugin } from './browser-env-plugin';
-export { publicAssetPathPlugin } from './public-asset-path-plugin';