@agentuity/cli 1.0.37 → 1.0.39

package/src/cmd/build/vite/bundle-files.ts

@@ -0,0 +1,135 @@
+import { join, dirname } from 'node:path';
+import { mkdirSync, cpSync } from 'node:fs';
+import type { Logger } from '../../../types';
+
+/** Paths that are always excluded regardless of .gitignore */
+function isHardExcluded(match: string): boolean {
+	return (
+		match.startsWith('.agentuity/') ||
+		match.startsWith('.agentuity\\') ||
+		match.startsWith('node_modules/') ||
+		match.startsWith('node_modules\\') ||
+		match.startsWith('.git/') ||
+		match.startsWith('.git\\') ||
+		match === '.env' ||
+		match.startsWith('.env.')
+	);
+}
+
+/**
+ * Use `git check-ignore --stdin` to filter out files that are ignored by .gitignore.
+ * Returns the subset of `files` that are NOT gitignored.
+ * Falls back to returning all files if not in a git repo or git is unavailable.
+ */
+async function filterGitIgnored(
+	rootDir: string,
+	files: string[],
+	logger: Logger
+): Promise<string[]> {
+	if (files.length === 0) return files;
+
+	try {
+		// Check if we're in a git repo
+		const gitCheck = Bun.spawnSync(['git', 'rev-parse', '--git-dir'], {
+			cwd: rootDir,
+			stderr: 'pipe',
+		});
+		if (gitCheck.exitCode !== 0) {
+			logger.debug('Not a git repository, skipping .gitignore filtering');
+			return files;
+		}
+
+		// Use git check-ignore to find which files are ignored
+		const proc = Bun.spawn(['git', 'check-ignore', '--stdin'], {
+			cwd: rootDir,
+			stdin: 'pipe',
+			stdout: 'pipe',
+			stderr: 'pipe',
+		});
+
+		// Write all file paths to stdin, one per line
+		proc.stdin.write(files.join('\n'));
+		proc.stdin.end();
+
+		const output = await new Response(proc.stdout).text();
+		await proc.exited;
+
+		// git check-ignore exits 0 if some files are ignored, 1 if none are ignored.
+		// Both are fine. Other exit codes mean an error.
+
+		const ignoredFiles = output
+			.split('\n')
+			.map((line) => line.trim())
+			.filter(Boolean);
+		const ignoredSet = new Set(ignoredFiles);
+
+		if (ignoredSet.size > 0) {
+			logger.debug(`Filtered ${ignoredSet.size} gitignored file(s) from bundle`);
+		}
+
+		return files.filter((f) => !ignoredSet.has(f));
+	} catch {
+		logger.debug('git not available, skipping .gitignore filtering');
+		return files;
+	}
+}
+
+/**
+ * Copy files matching glob patterns into the build output directory.
+ * Files are copied preserving their relative directory structure from the project root.
+ * This runs BEFORE the build steps so that build output can overwrite any conflicts.
+ *
+ * Filtering layers:
+ * 1. Hard exclusions: .agentuity/, node_modules/, .git/, .env* (always skipped)
+ * 2. .gitignore: files ignored by git are skipped (falls back if not a git repo)
+ */
+export async function copyBundleFiles(
+	rootDir: string,
+	outDir: string,
+	patterns: string[],
+	logger: Logger
+): Promise<number> {
+	let totalCopied = 0;
+
+	// Ensure output directory exists
+	mkdirSync(outDir, { recursive: true });
+
+	for (const pattern of patterns) {
+		const glob = new Bun.Glob(pattern);
+		const candidates: string[] = [];
+
+		// Phase 1: Glob match + hard exclusions
+		for await (const match of glob.scan({ cwd: rootDir, onlyFiles: true })) {
+			if (!isHardExcluded(match)) {
+				candidates.push(match);
+			}
+		}
+
+		// Phase 2: Filter out gitignored files
+		const filesToCopy = await filterGitIgnored(rootDir, candidates, logger);
+
+		// Phase 3: Copy files
+		for (const match of filesToCopy) {
+			const src = join(rootDir, match);
+			const dest = join(outDir, match);
+			try {
+				mkdirSync(dirname(dest), { recursive: true });
+				cpSync(src, dest);
+			} catch (err) {
+				throw new Error(
+					`Failed to copy bundle file '${match}' (pattern '${pattern}'): ${(err as Error).message}`
+				);
+			}
+		}
+
+		if (filesToCopy.length === 0) {
+			logger.warn(`Bundle pattern '${pattern}' matched no files`);
+		} else {
+			logger.debug(`Bundle pattern '${pattern}': ${filesToCopy.length} file(s)`);
+		}
+
+		totalCopied += filesToCopy.length;
+	}
+
+	return totalCopied;
+}

package/src/cmd/build/vite/vite-builder.ts

@@ -325,6 +325,17 @@ export async function runAllBuilds(options: Omit<ViteBuildOptions, 'mode'>): Pro
 	// Load config to check if workbench is enabled (dev mode only)
 	const { loadAgentuityConfig, getWorkbenchConfig } = await import('./config-loader');
 	const config = await loadAgentuityConfig(rootDir, logger);
+
+	// Copy bundle files if configured (before build so build output takes priority)
+	if (config?.bundle?.length) {
+		const { copyBundleFiles } = await import('./bundle-files');
+		const outDir = join(rootDir, '.agentuity');
+		const count = await copyBundleFiles(rootDir, outDir, config.bundle, logger);
+		if (count > 0) {
+			logger.debug(`Copied ${count} bundle file(s) to .agentuity`);
+		}
+	}
+
 	const workbenchConfig = getWorkbenchConfig(config, dev);
 	// Generate workbench files BEFORE any builds if enabled (dev mode only)
 	if (workbenchConfig.enabled) {

package/src/cmd/cloud/task/create.ts

@@ -95,7 +95,7 @@ export const createSubcommand = createCommand({
 				.optional()
 				.describe('task priority (default: none)'),
 			status: z
-				.enum(['open', 'in_progress', 'closed', 'done', 'cancelled'])
+				.enum(['open', 'in_progress', 'done', 'cancelled'])
 				.optional()
 				.describe('initial task status (default: open)'),
 			parentId: z.string().optional().describe('parent task ID for subtasks'),

package/src/cmd/cloud/task/delete.ts

@@ -70,8 +70,8 @@ export const deleteSubcommand = createCommand({
 			description: 'Delete a single task by ID',
 		},
 		{
-			command: getCommand('cloud task delete --status closed --older-than 7d'),
-			description: 'Delete closed tasks older than 7 days',
+			command: getCommand('cloud task delete --status done --older-than 7d'),
+			description: 'Delete done tasks older than 7 days',
 		},
 		{
 			command: getCommand('cloud task delete --status done --limit 10 --dry-run'),
@@ -88,7 +88,7 @@ export const deleteSubcommand = createCommand({
 		}),
 		options: z.object({
 			status: z
-				.enum(['open', 'in_progress', 'done', 'closed', 'cancelled'])
+				.enum(['open', 'in_progress', 'done', 'cancelled'])
 				.optional()
 				.describe('filter batch delete by status'),
 			type: z

package/src/cmd/cloud/task/index.ts

@@ -6,6 +6,8 @@ import { listSubcommand } from './list';
 import { deleteSubcommand } from './delete';
 import { statsSubcommand } from './stats';
 import { attachmentSubcommand } from './attachment';
+import { userSubcommand } from './user';
+import { projectSubcommand } from './project';
 import { getCommand } from '../../../command-prefix';
 
 export const taskCommand = createCommand({
@@ -34,13 +36,21 @@ export const taskCommand = createCommand({
 			description: 'Delete a task by ID',
 		},
 		{
-			command: getCommand('cloud task delete --status closed --older-than 7d'),
-			description: 'Batch delete closed tasks older than 7 days',
+			command: getCommand('cloud task delete --status done --older-than 7d'),
+			description: 'Batch delete done tasks older than 7 days',
 		},
 		{
 			command: getCommand('cloud task attachment upload task_abc123 ./report.pdf'),
 			description: 'Upload a file attachment to a task',
 		},
+		{
+			command: getCommand('cloud task user list'),
+			description: 'List task users',
+		},
+		{
+			command: getCommand('cloud task project list'),
+			description: 'List task projects',
+		},
 	],
 	subcommands: [
 		getSubcommand,
@@ -50,6 +60,8 @@ export const taskCommand = createCommand({
 		deleteSubcommand,
 		statsSubcommand,
 		attachmentSubcommand,
+		userSubcommand,
+		projectSubcommand,
 	],
 	requires: { auth: true },
 });

package/src/cmd/cloud/task/list.ts

@@ -55,7 +55,6 @@ const STATUS_COLORS: Record<string, (s: string) => string> = {
 	open: tui.colorSuccess,
 	in_progress: tui.colorWarning,
 	done: tui.colorInfo,
-	closed: tui.muted,
 	cancelled: tui.muted,
 };
 
@@ -108,7 +107,7 @@ export const listSubcommand = createCommand({
 	schema: {
 		options: z.object({
 			status: z
-				.enum(['open', 'in_progress', 'done', 'closed', 'cancelled'])
+				.enum(['open', 'in_progress', 'done', 'cancelled'])
 				.optional()
 				.describe('filter by status'),
 			type: z

package/src/cmd/cloud/task/project.ts

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+
+// ── List ────────────────────────────────────────────────────────────────
+
+const listProjectsSubcommand = createCommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List all task projects',
+	tags: ['read-only', 'slow', 'requires-auth'],
+	requires: { auth: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud task project list'),
+			description: 'List all projects',
+		},
+	],
+	schema: {
+		response: z.object({
+			success: z.boolean(),
+			projects: z.array(z.object({ id: z.string(), name: z.string() })),
+			total: z.number(),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		const result = await storage.listProjects();
+		const durationMs = Date.now() - started;
+
+		if (!options.json) {
+			if (result.projects.length === 0) {
+				tui.info('No projects found.');
+			} else {
+				tui.table(
+					result.projects.map((p) => ({ id: p.id, name: p.name })),
+					['id', 'name']
+				);
+				tui.info(`${result.projects.length} project(s) (${durationMs.toFixed(1)}ms)`);
+			}
+		}
+
+		return {
+			success: true,
+			projects: result.projects,
+			total: result.projects.length,
+			durationMs,
+		};
+	},
+});
+
+// ── Create ──────────────────────────────────────────────────────────────
+
+const createProjectSubcommand = createCommand({
+	name: 'create',
+	description: 'Create a new task project',
+	tags: ['mutating', 'slow', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud task project create "My Project"'),
+			description: 'Create a new project',
+		},
+	],
+	schema: {
+		args: z.object({
+			name: z.string().min(1).describe('the project name'),
+		}),
+		response: z.object({
+			success: z.boolean(),
+			project: z.object({ id: z.string(), name: z.string() }),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		const project = await storage.createProject({ name: args.name });
+		const durationMs = Date.now() - started;
+
+		if (!options.json) {
+			tui.success(`Created project: ${project.name} (${project.id})`);
+		}
+
+		return { success: true, project, durationMs };
+	},
+});
+
+// ── Get ─────────────────────────────────────────────────────────────────
+
+const getProjectSubcommand = createCommand({
+	name: 'get',
+	description: 'Get a task project by ID',
+	tags: ['read-only', 'slow', 'requires-auth'],
+	requires: { auth: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud task project get prj_abc123'),
+			description: 'Get project details',
+		},
+	],
+	schema: {
+		args: z.object({
+			id: z.string().min(1).describe('the project ID'),
+		}),
+		response: z.object({
+			success: z.boolean(),
+			project: z.object({ id: z.string(), name: z.string() }),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		try {
+			const project = await storage.getProject(args.id);
+			const durationMs = Date.now() - started;
+
+			if (!options.json) {
+				tui.table([{ id: project.id, name: project.name }], ['id', 'name'], {
+					layout: 'vertical',
+				});
+			}
+
+			return { success: true, project, durationMs };
+		} catch (_err) {
+			const durationMs = Date.now() - started;
+			if (!options.json) {
+				tui.error(`Project not found: ${args.id}`);
+			}
+			return { success: false, project: { id: args.id, name: '' }, durationMs };
+		}
+	},
+});
+
+// ── Delete ──────────────────────────────────────────────────────────────
+
+const deleteProjectSubcommand = createCommand({
+	name: 'delete',
+	aliases: ['del', 'rm'],
+	description: 'Delete a task project',
+	tags: ['mutating', 'slow', 'requires-auth', 'destructive'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud task project delete prj_abc123'),
+			description: 'Delete a project',
+		},
+	],
+	schema: {
+		args: z.object({
+			id: z.string().min(1).describe('the project ID'),
+		}),
+		response: z.object({
+			success: z.boolean(),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		try {
+			await storage.deleteProject(args.id);
+			const durationMs = Date.now() - started;
+
+			if (!options.json) {
+				tui.success(`Deleted project: ${args.id}`);
+			}
+
+			return { success: true, durationMs };
+		} catch (_err) {
+			const durationMs = Date.now() - started;
+			if (!options.json) {
+				tui.error(`Failed to delete project: ${args.id}`);
+			}
+			return { success: false, durationMs };
+		}
+	},
+});
+
+// ── Parent command ──────────────────────────────────────────────────────
+
+export const projectSubcommand = createCommand({
+	name: 'project',
+	aliases: ['proj'],
+	description: 'Manage task projects',
+	tags: ['requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud task project list'),
+			description: 'List all projects',
+		},
+		{
+			command: getCommand('cloud task project create "My Project"'),
+			description: 'Create a new project',
+		},
+		{
+			command: getCommand('cloud task project get prj_abc123'),
+			description: 'Get project details',
+		},
+		{
+			command: getCommand('cloud task project delete prj_abc123'),
+			description: 'Delete a project',
+		},
+	],
+	subcommands: [
+		listProjectsSubcommand,
+		createProjectSubcommand,
+		getProjectSubcommand,
+		deleteProjectSubcommand,
+	],
+});

package/src/cmd/cloud/task/update.ts

@@ -55,7 +55,10 @@ export const updateSubcommand = createCommand({
 				.enum(['epic', 'feature', 'enhancement', 'bug', 'task'])
 				.optional()
 				.describe('new task type'),
-			status: z.enum(['open', 'in_progress', 'closed']).optional().describe('new task status'),
+			status: z
+				.enum(['open', 'in_progress', 'done', 'cancelled'])
+				.optional()
+				.describe('new task status'),
 			assignedId: z.string().optional().describe('new assigned agent or user ID'),
 			parentId: z.string().optional().describe('new parent task ID'),
 			closedId: z.string().optional().describe('ID of the closer (agent or user)'),

package/src/cmd/cloud/task/user.ts

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+
+// ── List ────────────────────────────────────────────────────────────────
+
+const listUsersSubcommand = createCommand({
+	name: 'list',
+	aliases: ['ls'],
+	description: 'List all task users',
+	tags: ['read-only', 'slow', 'requires-auth'],
+	requires: { auth: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud task user list'),
+			description: 'List all users',
+		},
+	],
+	schema: {
+		response: z.object({
+			success: z.boolean(),
+			users: z.array(
+				z.object({
+					id: z.string(),
+					name: z.string(),
+					type: z.string().optional(),
+				})
+			),
+			total: z.number(),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		const result = await storage.listUsers();
+		const durationMs = Date.now() - started;
+
+		if (!options.json) {
+			if (result.users.length === 0) {
+				tui.info('No users found.');
+			} else {
+				tui.table(
+					result.users.map((u) => ({
+						id: u.id,
+						name: u.name,
+						type: (u as { type?: string }).type ?? 'human',
+					})),
+					['id', 'name', 'type']
+				);
+				tui.info(`${result.users.length} user(s) (${durationMs.toFixed(1)}ms)`);
+			}
+		}
+
+		return { success: true, users: result.users, total: result.users.length, durationMs };
+	},
+});
+
+// ── Create ──────────────────────────────────────────────────────────────
+
+const createUserSubcommand = createCommand({
+	name: 'create',
+	description: 'Create a new task user',
+	tags: ['mutating', 'slow', 'requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud task user create "Jane Doe"'),
+			description: 'Create a human user',
+		},
+		{
+			command: getCommand('cloud task user create "My Agent" --type agent'),
+			description: 'Create an agent user',
+		},
+	],
+	schema: {
+		args: z.object({
+			name: z.string().min(1).describe('the user display name'),
+		}),
+		options: z.object({
+			type: z.enum(['human', 'agent']).optional().describe('user type (human or agent)'),
+		}),
+		response: z.object({
+			success: z.boolean(),
+			user: z.object({
+				id: z.string(),
+				name: z.string(),
+				type: z.string().optional(),
+			}),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, opts, options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		const user = await storage.createUser({ name: args.name, type: opts.type });
+		const durationMs = Date.now() - started;
+
+		if (!options.json) {
+			tui.success(`Created user: ${user.name} (${user.id})`);
+		}
+
+		return { success: true, user, durationMs };
+	},
+});
+
+// ── Get ─────────────────────────────────────────────────────────────────
+
+const getUserSubcommand = createCommand({
+	name: 'get',
+	description: 'Get a task user by ID',
+	tags: ['read-only', 'slow', 'requires-auth'],
+	requires: { auth: true },
+	idempotent: true,
+	examples: [
+		{
+			command: getCommand('cloud task user get usr_abc123'),
+			description: 'Get user details',
+		},
+	],
+	schema: {
+		args: z.object({
+			id: z.string().min(1).describe('the user ID'),
+		}),
+		response: z.object({
+			success: z.boolean(),
+			user: z.object({
+				id: z.string(),
+				name: z.string(),
+				type: z.string().optional(),
+			}),
+			durationMs: z.number(),
+		}),
+	},
+
+	async handler(ctx) {
+		const { args, options } = ctx;
+		const started = Date.now();
+		const storage = await createStorageAdapter(ctx);
+		try {
+			const user = await storage.getUser(args.id);
+			const durationMs = Date.now() - started;
+
+			if (!options.json) {
+				tui.table(
+					[
+						{
+							id: user.id,
+							name: user.name,
+							type: (user as { type?: string }).type ?? 'human',
+						},
+					],
+					['id', 'name', 'type'],
+					{ layout: 'vertical' }
+				);
+			}
+
+			return { success: true, user, durationMs };
+		} catch (_err) {
+			const durationMs = Date.now() - started;
+			if (!options.json) {
+				tui.error(`User not found: ${args.id}`);
+			}
+			return {
+				success: false,
+				user: { id: args.id, name: '', type: 'human' as const },
+				durationMs,
+			};
+		}
+	},
+});
+
+// ── Parent command ──────────────────────────────────────────────────────
+
+export const userSubcommand = createCommand({
+	name: 'user',
+	description: 'Manage task users',
+	tags: ['requires-auth'],
+	requires: { auth: true },
+	examples: [
+		{
+			command: getCommand('cloud task user list'),
+			description: 'List all users',
+		},
+		{
+			command: getCommand('cloud task user create "Jane Doe"'),
+			description: 'Create a new user',
+		},
+		{
+			command: getCommand('cloud task user get usr_abc123'),
+			description: 'Get user details',
+		},
+	],
+	subcommands: [listUsersSubcommand, createUserSubcommand, getUserSubcommand],
+});

package/src/types.ts

@@ -249,6 +249,15 @@ export interface AgentuityConfig {
 	 * Note: Cannot override AGENTUITY_PUBLIC_* or process.env.NODE_ENV
 	 */
 	define?: Record<string, string>;
+	/**
+	 * Glob patterns for additional files to include in the deployment bundle.
+	 * Files matching these patterns will be copied into the .agentuity build
+	 * output directory before the build runs, preserving their relative paths
+	 * from the project root. Build output will overwrite any conflicting files.
+	 *
+	 * @example ['data/**', 'templates/*.json', 'models/weights.bin']
+	 */
+	bundle?: string[];
 }
 
 /**