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

package/src/cmd/ai/capabilities/index.ts

@@ -1,16 +0,0 @@
-import type { CommandDefinition } from '../../../types';
-import { createCommand } from '../../../types';
-import { showSubcommand } from './show';
-import { getCommand } from '../../../command-prefix';
-
-export const capabilitiesCommand: CommandDefinition = createCommand({
-	name: 'capabilities',
-	description: 'Show CLI capabilities and available tasks',
-	tags: ['read-only', 'fast'],
-	examples: [
-		{ command: getCommand('ai capabilities show'), description: 'Show CLI capabilities' },
-	],
-	subcommands: [showSubcommand],
-});
-
-export default capabilitiesCommand;

package/src/cmd/ai/capabilities/show.ts

@@ -1,258 +0,0 @@
-import { createSubcommand } from '../../../types';
-import type { CommandContext } from '../../../types';
-import * as tui from '../../../tui';
-import { getCommand } from '../../../command-prefix';
-import { z } from 'zod';
-
-export interface Capability {
-	id: string;
-	name: string;
-	description: string;
-	commands: string[];
-	requiresAuth?: boolean;
-	requiresProject?: boolean;
-}
-
-export interface CapabilitiesResponse {
-	version: string;
-	capabilities: Capability[];
-	workflows: Array<{
-		name: string;
-		description: string;
-		steps: string[];
-	}>;
-}
-
-const CapabilitiesShowResponseSchema = z.object({
-	version: z.string().describe('CLI capabilities version'),
-	capabilities: z
-		.array(
-			z.object({
-				id: z.string().describe('Capability ID'),
-				name: z.string().describe('Capability name'),
-				description: z.string().describe('Description'),
-				commands: z.array(z.string()).describe('Available commands'),
-				requiresAuth: z.boolean().optional().describe('Requires authentication'),
-				requiresProject: z.boolean().optional().describe('Requires project'),
-			})
-		)
-		.describe('Available capabilities'),
-	workflows: z
-		.array(
-			z.object({
-				name: z.string().describe('Workflow name'),
-				description: z.string().describe('Workflow description'),
-				steps: z.array(z.string()).describe('Workflow steps'),
-			})
-		)
-		.describe('Common workflows'),
-});
-
-export const showSubcommand = createSubcommand({
-	name: 'show',
-	description: 'Display CLI capabilities',
-	tags: ['read-only', 'fast'],
-	examples: [
-		{ command: getCommand('capabilities show'), description: 'Show CLI AI capabilities' },
-		{
-			command: getCommand('--json capabilities show'),
-			description: 'Show output in JSON format',
-		},
-	],
-	schema: {
-		response: CapabilitiesShowResponseSchema,
-	},
-	idempotent: true,
-	async handler(ctx: CommandContext) {
-		const { options } = ctx;
-
-		const capabilities: CapabilitiesResponse = {
-			version: '1.0.0',
-			capabilities: [
-				{
-					id: 'auth',
-					name: 'Authentication',
-					description: 'Login, logout, and manage API keys',
-					commands: ['auth login', 'auth logout', 'auth whoami', 'auth signup'],
-					requiresAuth: false,
-				},
-				{
-					id: 'ssh',
-					name: 'SSH Key Management',
-					description: 'Manage SSH keys for secure access',
-					commands: ['auth ssh list', 'auth ssh add', 'auth ssh delete'],
-					requiresAuth: true,
-				},
-				{
-					id: 'project',
-					name: 'Project Management',
-					description: 'Create, list, and manage projects',
-					commands: [
-						'project create',
-						'project list',
-						'project show',
-						'project download',
-						'project update',
-						'project delete',
-					],
-					requiresAuth: true,
-				},
-				{
-					id: 'deployment',
-					name: 'Deployment',
-					description: 'Deploy and manage applications',
-					commands: [
-						'bundle',
-						'cloud deploy',
-						'cloud deployment list',
-						'cloud deployment show',
-						'cloud deployment logs',
-						'cloud deployment rollback',
-					],
-					requiresAuth: true,
-					requiresProject: true,
-				},
-				{
-					id: 'env',
-					name: 'Environment Variables & Secrets',
-					description: 'Manage environment variables and secrets',
-					commands: ['env list', 'env set', 'env set --secret', 'env get', 'env delete'],
-					requiresAuth: true,
-					requiresProject: true,
-				},
-				{
-					id: 'kv',
-					name: 'Key-Value Storage',
-					description: 'Store and retrieve key-value data',
-					commands: ['kv list', 'kv get', 'kv set', 'kv delete', 'kv stats'],
-					requiresAuth: true,
-					requiresProject: true,
-				},
-				{
-					id: 'databases',
-					name: 'Cloud Databases',
-					description: 'Manage database resources',
-					commands: ['cloud db list', 'cloud db create', 'cloud db get', 'cloud db delete'],
-					requiresAuth: true,
-				},
-				{
-					id: 'storage',
-					name: 'Cloud Storage',
-					description: 'Manage storage resources',
-					commands: [
-						'cloud storage list',
-						'cloud storage create',
-						'cloud storage get',
-						'cloud storage delete',
-					],
-					requiresAuth: true,
-				},
-				{
-					id: 'config',
-					name: 'Configuration',
-					description: 'Manage CLI profiles and configuration',
-					commands: [
-						'profile list',
-						'profile create',
-						'profile delete',
-						'profile show',
-						'profile switch',
-					],
-				},
-				{
-					id: 'dev',
-					name: 'Development',
-					description: 'Local development server and REPL',
-					commands: ['dev', 'repl'],
-					requiresProject: true,
-				},
-				{
-					id: 'introspection',
-					name: 'CLI Introspection',
-					description: 'Discover CLI structure and capabilities',
-					commands: ['schema show', 'capabilities show', 'version'],
-				},
-			],
-			workflows: [
-				{
-					name: 'Initial Setup',
-					description: 'Get started with Agentuity',
-					steps: [
-						'auth signup',
-						'auth login',
-						'project create',
-						'env set API_KEY <value> --secret',
-						'dev',
-					],
-				},
-				{
-					name: 'Deploy Application',
-					description: 'Deploy your application to the cloud',
-					steps: ['bundle', 'cloud deploy', 'cloud deployment logs', 'cloud deployment show'],
-				},
-				{
-					name: 'Manage Environment Variables',
-					description: 'Configure environment variables and secrets',
-					steps: [
-						'env list',
-						'env set <key> <value>',
-						'env set <key> <value> --secret',
-						'env get <key>',
-					],
-				},
-				{
-					name: 'SSH Key Setup',
-					description: 'Add SSH keys for secure access',
-					steps: ['auth ssh list', 'auth ssh add --file ~/.ssh/id_rsa.pub'],
-				},
-			],
-		};
-
-		if (options.json) {
-			console.log(JSON.stringify(capabilities, null, 2));
-		} else {
-			// Human-readable output
-			console.log(tui.bold('Agentuity CLI Capabilities'));
-			tui.newline();
-
-			console.log(tui.bold('Available Tasks:'));
-			tui.newline();
-
-			for (const cap of capabilities.capabilities) {
-				console.log(`  ${tui.bold(cap.name)}`);
-				console.log(`    ${cap.description}`);
-
-				const requirements: string[] = [];
-				if (cap.requiresAuth) requirements.push('requires authentication');
-				if (cap.requiresProject) requirements.push('requires project');
-				if (requirements.length > 0) {
-					console.log(`    ${tui.muted(`(${requirements.join(', ')})`)}`);
-				}
-
-				console.log(
-					`    ${tui.muted(`Commands: ${cap.commands.slice(0, 3).join(', ')}${cap.commands.length > 3 ? '...' : ''}`)}`
-				);
-				tui.newline();
-			}
-
-			console.log(tui.bold('Common Workflows:'));
-			tui.newline();
-
-			for (const workflow of capabilities.workflows) {
-				console.log(`  ${tui.bold(workflow.name)}`);
-				console.log(`    ${workflow.description}`);
-				console.log(`    ${tui.muted('Steps:')}`);
-				for (let i = 0; i < workflow.steps.length; i++) {
-					console.log(`      ${i + 1}. ${workflow.steps[i]}`);
-				}
-				tui.newline();
-			}
-
-			console.log(tui.muted('Tip: Use --json for machine-readable output'));
-		}
-
-		return capabilities;
-	},
-});
-
-export default showSubcommand;

package/src/cmd/ai/claude-code/constants.ts

@@ -1,26 +0,0 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-
-export interface ClaudeSettings {
-	permissions?: {
-		allow?: string[];
-		deny?: string[];
-	};
-	[key: string]: unknown;
-}
-
-export const CLAUDE_DIR = join(homedir(), '.claude');
-export const CLAUDE_SETTINGS_FILE = join(CLAUDE_DIR, 'settings.local.json');
-export const PLUGIN_INSTALL_DIR = join(homedir(), '.agentuity', 'plugins', 'claude-code');
-
-export const AGENTUITY_ALLOW_PERMISSIONS = [
-	'Bash(agentuity cloud *)',
-	'Bash(agentuity auth whoami *)',
-];
-
-export const AGENTUITY_DENY_PERMISSIONS = [
-	'Bash(agentuity cloud secrets *)',
-	'Bash(agentuity cloud secret *)',
-	'Bash(agentuity cloud apikey *)',
-	'Bash(agentuity auth token *)',
-];

package/src/cmd/ai/claude-code/index.ts

@@ -1,23 +0,0 @@
-import { createCommand } from '../../../types';
-import { installSubcommand } from './install';
-import { uninstallSubcommand } from './uninstall';
-import { getCommand } from '../../../command-prefix';
-
-export const command = createCommand({
-	name: 'claude-code',
-	description: 'Agentuity Coder plugin for Claude Code',
-	tags: ['fast'],
-	examples: [
-		{
-			command: getCommand('ai claude-code install'),
-			description: 'Install Agentuity Coder plugin for Claude Code',
-		},
-		{
-			command: getCommand('ai claude-code uninstall'),
-			description: 'Uninstall Agentuity Coder plugin for Claude Code',
-		},
-	],
-	subcommands: [installSubcommand, uninstallSubcommand],
-});
-
-export default command;

package/src/cmd/ai/claude-code/install.ts

@@ -1,178 +0,0 @@
-import { mkdirSync, writeFileSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { createSubcommand, type CommandContext } from '../../../types';
-import * as tui from '../../../tui';
-import { getCommand } from '../../../command-prefix';
-import {
-	type ClaudeSettings,
-	CLAUDE_DIR,
-	CLAUDE_SETTINGS_FILE,
-	PLUGIN_INSTALL_DIR,
-	AGENTUITY_ALLOW_PERMISSIONS,
-	AGENTUITY_DENY_PERMISSIONS,
-} from './constants';
-
-async function readClaudeSettings(): Promise<ClaudeSettings> {
-	try {
-		if (await Bun.file(CLAUDE_SETTINGS_FILE).exists()) {
-			const content = readFileSync(CLAUDE_SETTINGS_FILE, 'utf-8');
-			return JSON.parse(content);
-		}
-	} catch {
-		// invalid or missing
-	}
-	return {};
-}
-
-function writeClaudeSettings(settings: ClaudeSettings): void {
-	mkdirSync(CLAUDE_DIR, { recursive: true });
-	writeFileSync(CLAUDE_SETTINGS_FILE, JSON.stringify(settings, null, 2) + '\n');
-}
-
-function configurePermissions(settings: ClaudeSettings): number {
-	if (!settings.permissions) {
-		settings.permissions = {};
-	}
-	if (!settings.permissions.allow) {
-		settings.permissions.allow = [];
-	}
-	if (!settings.permissions.deny) {
-		settings.permissions.deny = [];
-	}
-
-	let added = 0;
-
-	for (const perm of AGENTUITY_ALLOW_PERMISSIONS) {
-		if (!settings.permissions.allow.includes(perm)) {
-			settings.permissions.allow.push(perm);
-			added++;
-		}
-	}
-
-	for (const perm of AGENTUITY_DENY_PERMISSIONS) {
-		if (!settings.permissions.deny.includes(perm)) {
-			settings.permissions.deny.push(perm);
-			added++;
-		}
-	}
-
-	return added;
-}
-
-async function installPackage(logger: { debug: (msg: string) => void }): Promise<string | null> {
-	mkdirSync(PLUGIN_INSTALL_DIR, { recursive: true });
-
-	const packageJsonPath = join(PLUGIN_INSTALL_DIR, 'package.json');
-	if (!(await Bun.file(packageJsonPath).exists())) {
-		writeFileSync(
-			packageJsonPath,
-			JSON.stringify({ name: 'agentuity-claude-code-plugin', private: true }, null, 2)
-		);
-	}
-
-	logger.debug(`Installing @agentuity/claude-code to ${PLUGIN_INSTALL_DIR}`);
-
-	const proc = Bun.spawn(['bun', 'add', '@agentuity/claude-code@latest'], {
-		cwd: PLUGIN_INSTALL_DIR,
-		stdio: ['ignore', 'pipe', 'pipe'],
-	});
-
-	await proc.exited;
-
-	const pluginPath = join(PLUGIN_INSTALL_DIR, 'node_modules', '@agentuity', 'claude-code');
-	if (await Bun.file(join(pluginPath, '.claude-plugin', 'plugin.json')).exists()) {
-		return pluginPath;
-	}
-
-	return null;
-}
-
-export const installSubcommand = createSubcommand({
-	name: 'install',
-	description: 'Install Agentuity Coder plugin for Claude Code',
-	tags: ['fast'],
-	requires: { auth: true, apiClient: true, org: true },
-	examples: [
-		{
-			command: getCommand('ai claude-code install'),
-			description: 'Install Agentuity Coder plugin for Claude Code',
-		},
-	],
-	async handler(ctx: CommandContext<{ auth: true; apiClient: true; org: true }>) {
-		const { options, orgId, logger } = ctx;
-		const jsonMode = !!options?.json;
-
-		if (!jsonMode) {
-			tui.newline();
-			tui.output(tui.bold('Installing Agentuity Coder plugin for Claude Code'));
-			tui.newline();
-			tui.success(`Using organization: ${orgId}`);
-		}
-
-		if (!jsonMode) {
-			tui.info('Installing @agentuity/claude-code package...');
-		}
-
-		const pluginPath = await installPackage(logger);
-
-		if (!pluginPath) {
-			if (jsonMode) {
-				return { success: false, orgId, error: 'Failed to install package' };
-			}
-			logger.fatal(
-				'Failed to install @agentuity/claude-code package. Make sure bun is installed and try again'
-			);
-		}
-
-		if (!jsonMode) {
-			tui.success(`Plugin installed to: ${pluginPath}`);
-		}
-
-		const settings = await readClaudeSettings();
-
-		const permissionsAdded = configurePermissions(settings);
-		if (permissionsAdded > 0) {
-			if (!jsonMode) {
-				tui.success(
-					`Configured ${permissionsAdded} permission rules for Agentuity Cloud commands`
-				);
-			}
-		} else {
-			if (!jsonMode) {
-				tui.info('Permissions already configured');
-			}
-		}
-
-		writeClaudeSettings(settings);
-
-		if (!jsonMode) {
-			tui.newline();
-			tui.output(tui.bold('Agentuity Coder plugin installed successfully!'));
-			tui.newline();
-
-			tui.info('To use the plugin, start Claude Code with:');
-			tui.output(`  ${tui.ICONS.bullet} ${tui.bold(`claude --plugin-dir ${pluginPath}`)}`);
-			tui.newline();
-
-			tui.info('Or install permanently via the Claude Code marketplace:');
-			tui.output(`  ${tui.ICONS.bullet} ${tui.bold('/plugin marketplace add agentuity/sdk')}`);
-			tui.output(
-				`  ${tui.ICONS.bullet} ${tui.bold('/plugin install agentuity-coder@agentuity')}`
-			);
-			tui.newline();
-
-			tui.info('Available commands in Claude Code:');
-			tui.output(
-				`  ${tui.ICONS.bullet} ${tui.muted('/agentuity-coder')} - Run a task with the agent team`
-			);
-			tui.output(
-				`  ${tui.ICONS.bullet} ${tui.muted('/agentuity-cadence')} - Start autonomous long-running task`
-			);
-			tui.newline();
-		}
-
-		return { success: true, orgId, pluginPath };
-	},
-});
-
-export default installSubcommand;

package/src/cmd/ai/claude-code/uninstall.ts

@@ -1,122 +0,0 @@
-import { readFileSync, writeFileSync, rmSync } from 'node:fs';
-import { createSubcommand, type CommandContext } from '../../../types';
-import * as tui from '../../../tui';
-import { getCommand } from '../../../command-prefix';
-import {
-	type ClaudeSettings,
-	CLAUDE_SETTINGS_FILE,
-	PLUGIN_INSTALL_DIR,
-	AGENTUITY_ALLOW_PERMISSIONS,
-	AGENTUITY_DENY_PERMISSIONS,
-} from './constants';
-
-export const uninstallSubcommand = createSubcommand({
-	name: 'uninstall',
-	description: 'Uninstall Agentuity Coder plugin for Claude Code',
-	tags: ['fast'],
-	examples: [
-		{
-			command: getCommand('ai claude-code uninstall'),
-			description: 'Uninstall Agentuity Coder plugin for Claude Code',
-		},
-	],
-	async handler(ctx: CommandContext) {
-		const { options } = ctx;
-		const jsonMode = !!options?.json;
-
-		if (!jsonMode) {
-			tui.newline();
-			tui.output(tui.bold('Uninstalling Agentuity Coder plugin for Claude Code'));
-			tui.newline();
-		}
-
-		let removedPlugin = false;
-		let removedPermissions = false;
-
-		if (await Bun.file(`${PLUGIN_INSTALL_DIR}/package.json`).exists()) {
-			try {
-				rmSync(PLUGIN_INSTALL_DIR, { recursive: true, force: true });
-				removedPlugin = true;
-				if (!jsonMode) {
-					tui.success('Removed plugin installation directory');
-				}
-			} catch (error) {
-				if (!jsonMode) {
-					tui.warning(`Failed to remove plugin directory: ${error}`);
-				}
-			}
-		} else {
-			if (!jsonMode) {
-				tui.info('Plugin installation directory not found - nothing to remove');
-			}
-		}
-
-		if (await Bun.file(CLAUDE_SETTINGS_FILE).exists()) {
-			try {
-				const content = readFileSync(CLAUDE_SETTINGS_FILE, 'utf-8');
-				const settings: ClaudeSettings = JSON.parse(content);
-
-				if (settings.permissions) {
-					const allPerms = [...AGENTUITY_ALLOW_PERMISSIONS, ...AGENTUITY_DENY_PERMISSIONS];
-
-					if (settings.permissions.allow) {
-						const originalAllowLen = settings.permissions.allow.length;
-						settings.permissions.allow = settings.permissions.allow.filter(
-							(p) => !allPerms.includes(p)
-						);
-						if (settings.permissions.allow.length < originalAllowLen) {
-							removedPermissions = true;
-						}
-					}
-
-					if (settings.permissions.deny) {
-						const originalDenyLen = settings.permissions.deny.length;
-						settings.permissions.deny = settings.permissions.deny.filter(
-							(p) => !allPerms.includes(p)
-						);
-						if (settings.permissions.deny.length < originalDenyLen) {
-							removedPermissions = true;
-						}
-					}
-
-					if (removedPermissions) {
-						writeFileSync(CLAUDE_SETTINGS_FILE, JSON.stringify(settings, null, 2) + '\n');
-						if (!jsonMode) {
-							tui.success('Removed Agentuity permissions from Claude Code settings');
-						}
-					} else {
-						if (!jsonMode) {
-							tui.info('No Agentuity permissions found in Claude Code settings');
-						}
-					}
-				}
-			} catch (error) {
-				if (!jsonMode) {
-					tui.warning(`Failed to update Claude Code settings: ${error}`);
-				}
-			}
-		} else {
-			if (!jsonMode) {
-				tui.info('Claude Code settings file not found');
-			}
-		}
-
-		if (!jsonMode) {
-			tui.newline();
-
-			if (removedPlugin || removedPermissions) {
-				tui.output(tui.bold('Agentuity Coder plugin uninstalled successfully'));
-			} else {
-				tui.output(tui.bold('Agentuity Coder plugin was not installed'));
-			}
-
-			tui.newline();
-			tui.info(`To reinstall, run: ${tui.bold(getCommand('ai claude-code install'))}`);
-			tui.newline();
-		}
-
-		return { success: true, removedPlugin, removedPermissions };
-	},
-});
-
-export default uninstallSubcommand;

package/src/cmd/ai/detect.ts

@@ -1,54 +0,0 @@
-import { createSubcommand } from '../../types';
-import { getExecutingAgent, getAgentDisplayName, KNOWN_AGENTS } from '../../agent-detection';
-import { getCommand } from '../../command-prefix';
-import * as tui from '../../tui';
-
-export const detectSubcommand = createSubcommand({
-	name: 'detect',
-	description: 'Detect if the CLI is being run from a known AI coding agent',
-	tags: ['read-only', 'fast'],
-	idempotent: true,
-	examples: [
-		{ command: getCommand('ai detect'), description: 'Detect the executing agent' },
-		{ command: getCommand('ai detect --json'), description: 'Output detection result as JSON' },
-	],
-	handler(ctx) {
-		const agentId = getExecutingAgent();
-		const agentName = agentId ? getAgentDisplayName(agentId) : null;
-
-		if (ctx.options.json) {
-			tui.json({
-				id: agentId ?? null,
-				name: agentName,
-			});
-			// Exit with code 1 when no agent detected (consistent with non-JSON mode)
-			if (!agentId) {
-				process.exit(1);
-			}
-			return;
-		}
-
-		if (agentId) {
-			tui.success(`Detected agent: ${agentName} (${agentId})`);
-		} else {
-			tui.newline();
-			tui.info('No AI coding agent detected.');
-			tui.newline();
-			console.log(`  This CLI can detect when it's being run by an AI coding agent.`);
-			console.log(`  Currently supported agents:\n`);
-			for (const [, id] of KNOWN_AGENTS) {
-				console.log(`    - ${getAgentDisplayName(id)} (${id})`);
-			}
-			tui.newline();
-			console.log(
-				`  You can also set the ${tui.colorPrimary('AGENTUITY_AGENT_MODE')} environment variable`
-			);
-			console.log(`  to manually specify the agent.\n`);
-
-			// Exit with code 1 when no agent detected (non-JSON mode)
-			process.exit(1);
-		}
-	},
-});
-
-export default detectSubcommand;