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

package/src/utils/deps.ts

@@ -1,219 +0,0 @@
-import { $ } from 'bun';
-import { join } from 'node:path';
-import type { Logger } from '../types';
-
-export interface PackageRef {
-	name: string;
-	version: string;
-}
-
-/**
- * Mapping from alias key (aliasName@version) to actual package reference.
- * Used to resolve npm aliases (e.g., "tailwind-merge-v2": "npm:tailwind-merge@2.6.0")
- * to their actual package names for accurate malware detection.
- */
-export type AliasMap = Map<string, PackageRef>;
-
-export async function extractDependencies(
-	projectDir: string,
-	logger: Logger
-): Promise<PackageRef[]> {
-	try {
-		logger.debug('Extracting dependencies using bun pm ls --all');
-
-		const result = await $`bun pm ls --all`.cwd(projectDir).quiet().nothrow();
-
-		if (result.exitCode !== 0) {
-			logger.warn(
-				'Failed to extract dependencies: bun pm ls exited with code %d',
-				result.exitCode
-			);
-			return [];
-		}
-
-		const output = result.stdout.toString();
-		let packages = parseBunPmLsOutput(output);
-
-		// Load alias map from bun.lock to resolve npm aliases to actual package names
-		const aliasMap = await loadAliasMap(projectDir, logger);
-		if (aliasMap.size > 0) {
-			logger.debug('Loaded %d package aliases from bun.lock', aliasMap.size);
-			packages = resolveAliases(packages, aliasMap, logger);
-		}
-
-		logger.debug('Extracted %d unique packages', packages.length);
-		return packages;
-	} catch (error) {
-		logger.warn('Failed to extract dependencies: %s', error);
-		return [];
-	}
-}
-
-export function parseBunPmLsOutput(output: string): PackageRef[] {
-	const packages = new Map<string, PackageRef>();
-	const lines = output.split('\n');
-
-	for (const line of lines) {
-		const match = line.match(/([^\s]+)@(\d+\.\d+\.\d+[^\s]*)/);
-		if (match) {
-			const name = match[1];
-			const version = match[2];
-			if (name && version) {
-				const key = `${name}@${version}`;
-				if (!packages.has(key)) {
-					packages.set(key, { name, version });
-				}
-			}
-		}
-	}
-
-	return Array.from(packages.values());
-}
-
-/**
- * Load alias mappings from bun.lock file.
- *
- * The bun.lock file contains a "packages" object where:
- * - Keys are the package names as they appear in node_modules (alias names for aliased packages)
- * - Values are arrays where the first element is "actualPackageName@version"
- *
- * For npm aliases like `"tailwind-merge-v2": "npm:tailwind-merge@2.6.0"`:
- * - Key: "tailwind-merge-v2"
- * - Value[0]: "tailwind-merge@2.6.0"
- *
- * This function builds a map from "aliasName@version" to the actual PackageRef.
- */
-export async function loadAliasMap(projectDir: string, logger: Logger): Promise<AliasMap> {
-	const aliasMap: AliasMap = new Map();
-
-	try {
-		const lockfilePath = join(projectDir, 'bun.lock');
-		const lockfile = Bun.file(lockfilePath);
-
-		if (!(await lockfile.exists())) {
-			logger.debug('No bun.lock file found, skipping alias resolution');
-			return aliasMap;
-		}
-
-		const content = await lockfile.text();
-		const parsed = parseBunLockFile(content);
-
-		if (!parsed || !parsed.packages) {
-			return aliasMap;
-		}
-
-		for (const [aliasName, packageInfo] of Object.entries(parsed.packages)) {
-			if (!Array.isArray(packageInfo) || packageInfo.length === 0) {
-				continue;
-			}
-
-			const actualPackageSpec = packageInfo[0];
-			if (typeof actualPackageSpec !== 'string') {
-				continue;
-			}
-
-			// Parse "actualPackageName@version" from the first element
-			const atIndex = actualPackageSpec.lastIndexOf('@');
-			if (atIndex <= 0) {
-				continue;
-			}
-
-			const actualName = actualPackageSpec.substring(0, atIndex);
-			const actualVersion = actualPackageSpec.substring(atIndex + 1);
-
-			// Only add to alias map if the alias name differs from the actual name
-			// This indicates an npm alias (e.g., tailwind-merge-v2 -> tailwind-merge)
-			if (aliasName !== actualName) {
-				const aliasKey = `${aliasName}@${actualVersion}`;
-				aliasMap.set(aliasKey, { name: actualName, version: actualVersion });
-			}
-		}
-	} catch (error) {
-		logger.debug('Failed to parse bun.lock for alias resolution: %s', error);
-	}
-
-	return aliasMap;
-}
-
-/**
- * Parse bun.lock file content.
- *
- * bun.lock uses a relaxed JSON format (JSONC) with trailing commas, which
- * standard JSON.parse cannot handle. We need to strip trailing commas before parsing.
- *
- * Structure:
- * {
- *   "lockfileVersion": 1,
- *   "packages": {
- *     "package-name": ["actual-package@version", "", {}, "sha512-..."],
- *     ...
- *   }
- * }
- */
-export function parseBunLockFile(content: string): BunLockFile | null {
-	try {
-		// bun.lock uses JSONC format with trailing commas - strip them before parsing
-		const sanitized = stripTrailingCommas(content);
-		return JSON.parse(sanitized) as BunLockFile;
-	} catch {
-		return null;
-	}
-}
-
-/**
- * Strip trailing commas from JSONC content to make it valid JSON.
- * Handles trailing commas before ] and } characters.
- */
-function stripTrailingCommas(content: string): string {
-	// Match comma followed by optional whitespace and then ] or }
-	return content.replace(/,(\s*[}\]])/g, '$1');
-}
-
-/**
- * Represents the structure of a bun.lock file.
- */
-export interface BunLockFile {
-	lockfileVersion?: number;
-	packages?: Record<string, unknown[]>;
-}
-
-/**
- * Resolve npm aliases in the package list to their actual package names.
- *
- * This prevents false positives in malware detection where alias names
- * (e.g., "tailwind-merge-v2") are flagged as suspicious when they're
- * actually legitimate aliases for real packages (e.g., "tailwind-merge").
- */
-export function resolveAliases(
-	packages: PackageRef[],
-	aliasMap: AliasMap,
-	logger: Logger
-): PackageRef[] {
-	const resolved = new Map<string, PackageRef>();
-
-	for (const pkg of packages) {
-		const aliasKey = `${pkg.name}@${pkg.version}`;
-		const actualPkg = aliasMap.get(aliasKey);
-
-		if (actualPkg) {
-			logger.debug(
-				'Resolved npm alias: %s@%s -> %s@%s',
-				pkg.name,
-				pkg.version,
-				actualPkg.name,
-				actualPkg.version
-			);
-			const resolvedKey = `${actualPkg.name}@${actualPkg.version}`;
-			if (!resolved.has(resolvedKey)) {
-				resolved.set(resolvedKey, actualPkg);
-			}
-		} else {
-			const key = `${pkg.name}@${pkg.version}`;
-			if (!resolved.has(key)) {
-				resolved.set(key, pkg);
-			}
-		}
-	}
-
-	return Array.from(resolved.values());
-}

package/src/utils/format.ts

@@ -1,17 +0,0 @@
-/**
- * Abbreviate a string to a maximum length, adding ellipsis if truncated
- */
-export function abbreviate(str: string | null | undefined, maxLength = 8): string {
-	if (!str) return 'N/A';
-	if (str.length <= maxLength) return str;
-	return str.slice(0, maxLength) + '...';
-}
-
-/**
- * Abbreviate a description (longer default length)
- */
-export function abbreviateDescription(str: string | null | undefined, maxLength = 40): string {
-	if (!str) return 'N/A';
-	if (str.length <= maxLength) return str;
-	return str.slice(0, maxLength) + '...';
-}

package/src/utils/git.ts

@@ -1,209 +0,0 @@
-import type { Logger } from '@agentuity/core';
-import { existsSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-
-/**
- * Git information detected from the repository
- */
-export interface GitInfo {
-	branch?: string;
-	repo?: string;
-	provider?: string;
-	tags?: string[];
-	commit?: string;
-	message?: string;
-}
-
-/**
- * Git options that can be provided via CLI flags to override auto-detected values
- */
-export interface GitOptions {
-	message?: string;
-	commit?: string;
-	branch?: string;
-	repo?: string;
-	provider?: string;
-	commitUrl?: string;
-}
-
-/**
- * Extended git info that includes CI-related fields
- */
-export interface GitInfoExtended extends GitInfo {
-	commitUrl?: string;
-	logsUrl?: string;
-	trigger?: string;
-	event?: string;
-	pull_request?: {
-		number: number;
-		url?: string;
-	};
-}
-
-/**
- * Detect git information from the repository at the given root directory.
- * Walks up parent directories to find .git directory (supports monorepos).
- *
- * @param rootDir - The root directory to start searching for .git
- * @param logger - Logger instance for trace output
- * @returns Git information or undefined if not in a git repository
- */
-export async function getGitInfo(rootDir: string, logger: Logger): Promise<GitInfo | undefined> {
-	if (!Bun.which('git')) {
-		logger.trace('git not found in PATH');
-		return undefined;
-	}
-
-	try {
-		// Find .git directory (may be in parent directories for monorepos)
-		let gitDir = join(rootDir, '.git');
-		let parentDir = dirname(dirname(gitDir));
-		while (!existsSync(gitDir) && parentDir !== dirname(parentDir) && gitDir !== '/') {
-			gitDir = join(parentDir, '.git');
-			parentDir = dirname(parentDir);
-		}
-
-		if (!existsSync(gitDir)) {
-			logger.trace('No .git directory found');
-			return undefined;
-		}
-
-		const $ = Bun.$;
-		const gitInfo: GitInfo = {
-			provider: 'git',
-		};
-
-		// Get git tags pointing to HEAD
-		const tagResult = $`git tag -l --points-at HEAD`.nothrow().quiet();
-		if (tagResult) {
-			const tagText = await tagResult.text();
-			if (tagText) {
-				gitInfo.tags = tagText
-					.trim()
-					.split(/\n/)
-					.map((s) => s.trim())
-					.filter(Boolean);
-			}
-		}
-
-		// Get current branch
-		const branchResult = $`git branch --show-current`.nothrow().quiet();
-		if (branchResult) {
-			const branchText = await branchResult.text();
-			if (branchText) {
-				gitInfo.branch = branchText.trim();
-			}
-		}
-
-		// Get commit SHA
-		const commitResult = $`git rev-parse HEAD`.nothrow().quiet();
-		if (commitResult) {
-			const commitText = await commitResult.text();
-			if (commitText) {
-				gitInfo.commit = commitText.trim();
-
-				// Get commit message
-				const msgResult = $`git log --pretty=format:%s -n1 ${gitInfo.commit}`.nothrow().quiet();
-				if (msgResult) {
-					const msgText = await msgResult.text();
-					if (msgText) {
-						gitInfo.message = msgText.trim();
-					}
-				}
-			}
-		}
-
-		// Get remote origin URL and parse
-		const originResult = $`git config --get remote.origin.url`.nothrow().quiet();
-		if (originResult) {
-			const originText = await originResult.text();
-			if (originText) {
-				const remoteUrl = originText.trim();
-
-				// Parse provider and repo from URL
-				if (remoteUrl.includes('github.com')) {
-					gitInfo.provider = 'github';
-					const match = remoteUrl.match(/github\.com[:/](.+?)(?:\.git)?$/);
-					if (match) {
-						gitInfo.repo = `https://github.com/${match[1]}`;
-					}
-				} else if (remoteUrl.includes('gitlab.com')) {
-					gitInfo.provider = 'gitlab';
-					const match = remoteUrl.match(/gitlab\.com[:/](.+?)(?:\.git)?$/);
-					if (match) {
-						gitInfo.repo = `https://gitlab.com/${match[1]}`;
-					}
-				} else if (remoteUrl.includes('bitbucket.org')) {
-					gitInfo.provider = 'bitbucket';
-					const match = remoteUrl.match(/bitbucket\.org[:/](.+?)(?:\.git)?$/);
-					if (match) {
-						gitInfo.repo = `https://bitbucket.org/${match[1]}`;
-					}
-				} else {
-					gitInfo.repo = remoteUrl;
-				}
-			}
-		}
-
-		return gitInfo;
-	} catch (error) {
-		logger.trace(`Failed to get git info: ${error}`);
-		return undefined;
-	}
-}
-
-/**
- * Merge auto-detected git info with CLI-provided overrides.
- * CLI options take precedence over auto-detected values.
- *
- * @param autoDetected - Git info auto-detected from the repository
- * @param overrides - CLI options that override auto-detected values
- * @returns Merged git info
- */
-export function mergeGitInfo(
-	autoDetected: GitInfo | undefined,
-	overrides: GitOptions
-): GitInfoExtended {
-	const result: GitInfoExtended = { ...(autoDetected ?? {}) };
-
-	// CLI overrides take precedence
-	if (overrides.message !== undefined) {
-		result.message = overrides.message;
-	}
-	if (overrides.commit !== undefined) {
-		result.commit = overrides.commit;
-	}
-	if (overrides.branch !== undefined) {
-		result.branch = overrides.branch;
-	}
-	if (overrides.repo !== undefined) {
-		result.repo = overrides.repo;
-	}
-	if (overrides.provider !== undefined) {
-		result.provider = overrides.provider;
-	}
-	if (overrides.commitUrl !== undefined) {
-		result.commitUrl = overrides.commitUrl;
-	}
-
-	return result;
-}
-
-/**
- * Build an array of tags from git info, including branch and short commit.
- * Used for deployment tagging.
- *
- * @param gitInfo - Git information
- * @returns Array of tags
- */
-export function buildGitTags(gitInfo: GitInfo | undefined): string[] {
-	const tags = new Set(gitInfo?.tags ?? []);
-	tags.add('latest');
-	if (gitInfo?.branch) {
-		tags.add(gitInfo.branch);
-	}
-	if (gitInfo?.commit) {
-		tags.add(gitInfo.commit.substring(0, 7));
-	}
-	return Array.from(tags);
-}

package/src/utils/installation-type.ts

@@ -1,106 +0,0 @@
-/**
- * Detects how the CLI was installed and is being run
- */
-
-import fs from 'node:fs';
-import os from 'node:os';
-
-export type InstallationType = 'global' | 'local' | 'source';
-
-/**
- * Resolve a path to its real path (following symlinks) and normalize to POSIX separators.
- * Returns the original path if resolution fails.
- */
-function resolveRealPath(path: string): string {
-	if (!path) return '';
-	try {
-		// fs.realpathSync resolves symlinks (e.g., /tmp -> /private/tmp on macOS)
-		return fs.realpathSync(path).replace(/\\/g, '/');
-	} catch {
-		// If the path doesn't exist or can't be resolved, return normalized original
-		return path.replace(/\\/g, '/');
-	}
-}
-
-/**
- * Determines the installation type based on how the CLI is being executed
- *
- * @returns 'global' - Installed globally via `bun add -g @agentuity/cli`
- * @returns 'local' - Running from project's node_modules (bunx or direct)
- * @returns 'source' - Running from source code (development)
- */
-export function getInstallationType(): InstallationType {
-	// Bun.main already returns the resolved real path, just normalize separators
-	const mainPath = Bun.main.replace(/\\/g, '/');
-
-	// Get home directory reliably and resolve symlinks
-	// On macOS, os.homedir() returns /Users/xxx which is already real
-	const home = resolveRealPath(os.homedir() ?? process.env.HOME ?? process.env.USERPROFILE ?? '');
-
-	// Get bun install directory from BUN_INSTALL or default to ~/.bun
-	// Resolve symlinks to handle cases like BUN_INSTALL=/tmp/... on macOS where /tmp -> /private/tmp
-	const bunInstallRaw = process.env.BUN_INSTALL ?? (home ? `${home}/.bun` : '');
-	const bunInstall = resolveRealPath(bunInstallRaw);
-
-	// GLOBAL DETECTION: Check if running from bun's global install location
-	// When installed via `bun add -g`, the CLI lives at ~/.bun/node_modules/@agentuity/cli/
-	// or ~/.bun/install/global/node_modules/@agentuity/cli/
-	if (bunInstall) {
-		// Check for ~/.bun/node_modules/@agentuity/cli/ (common bun global layout)
-		if (mainPath.startsWith(`${bunInstall}/node_modules/@agentuity/cli/`)) {
-			return 'global';
-		}
-		// Check for ~/.bun/install/global/node_modules/@agentuity/cli/ (alternative layout)
-		if (mainPath.startsWith(`${bunInstall}/install/global/`)) {
-			return 'global';
-		}
-	}
-
-	// GLOBAL DETECTION: Check for legacy ~/.agentuity/ installation
-	// The install.sh script may install to ~/.agentuity/node_modules/@agentuity/cli/
-	// or create a shim at ~/.agentuity/bin/agentuity
-	if (home) {
-		const agentuityDir = resolveRealPath(`${home}/.agentuity`);
-		if (mainPath.startsWith(`${agentuityDir}/`)) {
-			return 'global';
-		}
-	}
-
-	// GLOBAL DETECTION: Fallback check for any path containing /.bun/ before node_modules
-	// This catches edge cases where BUN_INSTALL might not match the actual path
-	if (mainPath.includes('/.bun/') && mainPath.includes('/node_modules/@agentuity/cli/')) {
-		return 'global';
-	}
-
-	// LOCAL DETECTION: Running from a project's node_modules
-	// This is when someone runs `bunx agentuity` or has it as a project dependency
-	// At this point, we've ruled out global installs, so any node_modules path is local
-	if (mainPath.includes('/node_modules/@agentuity/cli/')) {
-		return 'local';
-	}
-
-	// SOURCE DETECTION: Running from source code (development)
-	// This is when running directly from the monorepo: packages/cli/bin/cli.ts
-	return 'source';
-}
-
-/**
- * Check if running from a global installation
- */
-export function isGlobalInstall(): boolean {
-	return getInstallationType() === 'global';
-}
-
-/**
- * Check if running from a local project installation
- */
-export function isLocalInstall(): boolean {
-	return getInstallationType() === 'local';
-}
-
-/**
- * Check if running from source (development mode)
- */
-export function isSourceInstall(): boolean {
-	return getInstallationType() === 'source';
-}

package/src/utils/jsonc.ts

@@ -1,67 +0,0 @@
-/**
- * Parse JSON with Comments (JSONC).
- *
- * Strips single-line (`//`) and block (`/* *​/`) comments as well as trailing
- * commas that appear before `}` or `]`, then delegates to the built-in
- * `JSON.parse`.  This covers the comment syntax used by `tsconfig.json` and
- * similar config files without pulling in a full JSON5 parser.
- *
- * String literals are respected — comments and trailing commas inside quoted
- * strings are left untouched.
- */
-export function parseJSONC(text: string): unknown {
-	let result = '';
-	let i = 0;
-	const len = text.length;
-
-	while (i < len) {
-		const ch = text[i];
-
-		// --- quoted string: copy verbatim, including any escape sequences ---
-		if (ch === '"') {
-			const start = i;
-			i++; // skip opening quote
-			while (i < len) {
-				if (text[i] === '\\') {
-					i += i + 1 < len ? 2 : 1; // skip escaped character (guard end-of-input)
-				} else if (text[i] === '"') {
-					i++; // skip closing quote
-					break;
-				} else {
-					i++;
-				}
-			}
-			result += text.slice(start, i);
-			continue;
-		}
-
-		// --- single-line comment: skip to end of line ---
-		if (ch === '/' && text[i + 1] === '/') {
-			i += 2;
-			while (i < len && text[i] !== '\n') {
-				i++;
-			}
-			continue;
-		}
-
-		// --- block comment: skip to closing *​/ ---
-		if (ch === '/' && text[i + 1] === '*') {
-			i += 2;
-			while (i < len && !(text[i] === '*' && text[i + 1] === '/')) {
-				i++;
-			}
-			if (i < len) {
-				i += 2; // skip closing */
-			}
-			continue;
-		}
-
-		result += ch;
-		i++;
-	}
-
-	// Strip trailing commas before } or ] (with optional whitespace between).
-	result = result.replace(/,(\s*[}\]])/g, '$1');
-
-	return JSON.parse(result);
-}

package/src/utils/normalize-path.ts

@@ -1,12 +0,0 @@
-/**
- * Normalize path separators to forward slashes for cross-platform compatibility.
- *
- * On Windows, Node.js path functions (relative, resolve, join) return backslashes.
- * JavaScript import paths, zip entry names, and remote file paths must use forward slashes.
- *
- * @param p - The path to normalize
- * @returns The path with all backslashes replaced by forward slashes
- */
-export function toForwardSlash(p: string): string {
-	return p.replace(/\\/g, '/');
-}