@automagik/genie 4.260331.5 → 4.260331.7

package/src/term-commands/install.ts

@@ -1,372 +0,0 @@
-/**
- * Install Command — `genie install <git-url>[@version]`
- *
- * Clones a git repository, detects/validates the manifest, registers in
- * app_store, and performs type-specific setup (cache regen, board creation, etc.).
- */
-
-import { execSync } from 'node:child_process';
-import { existsSync, mkdirSync, rmSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { basename, join } from 'node:path';
-import type { Command } from 'commander';
-import {
-  getItemFromStore,
-  regenerateAgentCache,
-  registerItemInStore,
-  removeItemFromStore,
-} from '../lib/agent-cache.js';
-import { getActor, recordAuditEvent } from '../lib/audit.js';
-import { getConnection, isAvailable } from '../lib/db.js';
-import { type GenieManifest, type StageConfig, detectManifest, validateManifest } from '../lib/manifest.js';
-
-const GENIE_HOME = process.env.GENIE_HOME ?? join(homedir(), '.genie');
-const ITEMS_DIR = join(GENIE_HOME, 'items');
-
-// ============================================================================
-// URL parsing
-// ============================================================================
-
-interface ParsedUrl {
-  url: string;
-  version?: string;
-  name: string;
-}
-
-/**
- * Parse a git install target like `github.com/user/repo@v1.2.0`
- * into its components.
- */
-function parseInstallTarget(target: string): ParsedUrl {
-  let url = target;
-  let version: string | undefined;
-
-  // Extract @version suffix
-  const atIdx = url.lastIndexOf('@');
-  if (atIdx > 0 && !url.slice(atIdx).includes('/')) {
-    version = url.slice(atIdx + 1);
-    url = url.slice(0, atIdx);
-  }
-
-  // Normalise bare github.com/user/repo → https://github.com/user/repo.git
-  if (!url.startsWith('http') && !url.startsWith('git@') && !url.startsWith('ssh://')) {
-    url = `https://${url}`;
-  }
-  if (url.startsWith('https://') && !url.endsWith('.git')) {
-    url = `${url}.git`;
-  }
-
-  // Derive name from repo URL
-  const name = basename(url, '.git');
-
-  return { url, version, name };
-}
-
-// ============================================================================
-// Git operations
-// ============================================================================
-
-function cloneRepo(url: string, dest: string, options: { shallow?: boolean; version?: string }): void {
-  const args = ['git', 'clone'];
-  if (options.shallow !== false) args.push('--depth', '1');
-  if (options.version) args.push('--branch', options.version);
-  args.push(url, dest);
-
-  execSync(args.join(' '), { stdio: 'pipe', timeout: 120_000 });
-}
-
-function cleanupDir(dir: string): void {
-  if (existsSync(dir)) {
-    rmSync(dir, { recursive: true, force: true });
-  }
-}
-
-// ============================================================================
-// Type-specific registration
-// ============================================================================
-
-async function registerByType(manifest: GenieManifest, installPath: string): Promise<void> {
-  switch (manifest.type) {
-    case 'agent':
-      await regenerateAgentCache();
-      break;
-    case 'board':
-      await registerBoard(manifest);
-      break;
-    case 'workflow':
-      await registerWorkflow(manifest);
-      break;
-    case 'stack':
-      await installStack(manifest, installPath);
-      break;
-    // skill, app, template, hook — no extra registration needed beyond app_store
-  }
-}
-
-async function registerBoard(manifest: GenieManifest): Promise<void> {
-  if (!manifest.board?.stages) return;
-  if (!(await isAvailable())) return;
-
-  const sql = await getConnection();
-  const stages = manifest.board.stages.map((s, i) => ({
-    id: crypto.randomUUID(),
-    name: s.name,
-    label: s.label ?? s.name,
-    gate: s.gate,
-    action: s.action ?? null,
-    auto_advance: s.auto_advance ?? false,
-    roles: s.roles ?? ['*'],
-    color: s.color ?? '#94a3b8',
-    parallel: false,
-    on_fail: null,
-    position: i,
-    transitions: [],
-  }));
-
-  await sql`
-    INSERT INTO task_types (id, name, description, stages, is_builtin)
-    VALUES (
-      ${manifest.name},
-      ${manifest.name},
-      ${manifest.description ?? null},
-      ${sql.json(stages)},
-      false
-    )
-    ON CONFLICT (id) DO UPDATE SET
-      stages = EXCLUDED.stages,
-      description = EXCLUDED.description,
-      updated_at = now()
-  `;
-}
-
-async function registerWorkflow(manifest: GenieManifest): Promise<void> {
-  if (!manifest.workflow) return;
-  if (!(await isAvailable())) return;
-
-  const sql = await getConnection();
-  const wf = manifest.workflow;
-
-  await sql`
-    INSERT INTO schedules (id, name, cron_expression, timezone, command, run_spec, status)
-    VALUES (
-      ${`sched-${manifest.name}`},
-      ${manifest.name},
-      ${wf.cron},
-      ${wf.timezone ?? 'UTC'},
-      ${wf.command},
-      ${sql.json(wf.run_spec ?? {})},
-      'active'
-    )
-    ON CONFLICT (id) DO UPDATE SET
-      cron_expression = EXCLUDED.cron_expression,
-      timezone = EXCLUDED.timezone,
-      command = EXCLUDED.command,
-      run_spec = EXCLUDED.run_spec,
-      updated_at = now()
-  `;
-}
-
-async function handleInlineStackItem(
-  item: import('../lib/manifest.js').StackItem,
-  version: string,
-  tx: Awaited<ReturnType<typeof getConnection>>,
-): Promise<void> {
-  if (item.type === 'board' && item.config) {
-    await registerBoard({
-      name: item.name,
-      type: 'board',
-      version,
-      board: { stages: (item.config.stages ?? []) as StageConfig[] },
-    });
-  } else if (item.type === 'workflow' && item.config) {
-    await registerWorkflow({
-      name: item.name,
-      type: 'workflow',
-      version,
-      workflow: item.config as unknown as NonNullable<GenieManifest['workflow']>,
-    });
-  }
-  await tx`
-    INSERT INTO app_store (name, item_type, version, manifest)
-    VALUES (${item.name}, ${item.type}, ${version}, ${tx.json(item.config ?? {})})
-    ON CONFLICT (name) DO NOTHING
-  `;
-}
-
-async function handleExternalStackItem(
-  item: import('../lib/manifest.js').StackItem,
-  tx: Awaited<ReturnType<typeof getConnection>>,
-): Promise<string> {
-  if (!item.source) throw new Error(`Stack item "${item.name}" is missing source`);
-  const parsed = parseInstallTarget(item.source);
-  const itemDir = join(ITEMS_DIR, parsed.name);
-  mkdirSync(ITEMS_DIR, { recursive: true });
-  cloneRepo(parsed.url, itemDir, { version: parsed.version });
-
-  const detection = await detectManifest(itemDir);
-  if ('error' in detection) {
-    throw new Error(`Stack item "${item.name}" (${item.source}): ${detection.error}`);
-  }
-  const validation = validateManifest(detection.manifest, itemDir);
-  if (!validation.valid) {
-    throw new Error(`Stack item "${item.name}" validation failed: ${validation.errors.join(', ')}`);
-  }
-
-  await tx`
-    INSERT INTO app_store (name, item_type, version, git_url, install_path, manifest)
-    VALUES (
-      ${detection.manifest.name}, ${detection.manifest.type}, ${detection.manifest.version},
-      ${item.source}, ${itemDir}, ${tx.json(detection.manifest)}
-    )
-    ON CONFLICT (name) DO NOTHING
-  `;
-  await registerByType(detection.manifest, itemDir);
-  return parsed.name;
-}
-
-async function installStack(manifest: GenieManifest, _installPath: string): Promise<void> {
-  const stackItems = manifest.stack?.items;
-  if (!stackItems) return;
-  if (!(await isAvailable())) return;
-
-  const sql = await getConnection();
-  const installed: string[] = [];
-
-  try {
-    await sql.begin(async (tx: typeof sql) => {
-      for (const item of stackItems) {
-        if (item.inline) {
-          await handleInlineStackItem(item, manifest.version, tx);
-          installed.push(item.name);
-        } else if (item.source) {
-          const name = await handleExternalStackItem(item, tx);
-          installed.push(name);
-        }
-      }
-    });
-  } catch (err) {
-    // Rollback: clean up cloned dirs
-    for (const name of installed) {
-      cleanupDir(join(ITEMS_DIR, name));
-      await removeItemFromStore(name).catch(() => {});
-    }
-    throw err;
-  }
-}
-
-// ============================================================================
-// Install command
-// ============================================================================
-
-interface InstallOptions {
-  force?: boolean;
-  full?: boolean;
-}
-
-async function handleInstall(target: string, options: InstallOptions): Promise<void> {
-  const parsed = parseInstallTarget(target);
-  const installDir = join(ITEMS_DIR, parsed.name);
-
-  // Check for name conflict
-  const existing = await getItemFromStore(parsed.name).catch(() => null);
-  if (existing && !options.force) {
-    console.error(`Item "${parsed.name}" is already installed. Use --force to override.`);
-    process.exit(1);
-  }
-  if (existing && options.force) {
-    await removeItemFromStore(parsed.name).catch(() => {});
-    cleanupDir(installDir);
-  }
-
-  // Clone
-  mkdirSync(ITEMS_DIR, { recursive: true });
-  console.log(`Cloning ${parsed.url}${parsed.version ? ` @ ${parsed.version}` : ''}...`);
-  try {
-    cloneRepo(parsed.url, installDir, { shallow: !options.full, version: parsed.version });
-  } catch (err) {
-    cleanupDir(installDir);
-    console.error(`Clone failed: ${(err as Error).message}`);
-    process.exit(1);
-  }
-
-  // Detect manifest
-  const detection = await detectManifest(installDir);
-  if ('error' in detection) {
-    cleanupDir(installDir);
-    console.error(`Manifest detection failed: ${detection.error}`);
-    process.exit(1);
-  }
-
-  const { manifest, source } = detection;
-  console.log(`Detected ${manifest.type} manifest from ${source}`);
-
-  // Validate
-  const validation = validateManifest(manifest, installDir);
-  for (const w of validation.warnings) {
-    console.log(`  Warning: ${w}`);
-  }
-  if (!validation.valid) {
-    cleanupDir(installDir);
-    console.error(`Validation failed:\n${validation.errors.map((e) => `  - ${e}`).join('\n')}`);
-    process.exit(1);
-  }
-
-  // Register in app_store
-  try {
-    await registerItemInStore({
-      name: manifest.name,
-      itemType: manifest.type,
-      version: manifest.version,
-      description: manifest.description,
-      authorName: manifest.author?.name,
-      authorUrl: manifest.author?.url,
-      gitUrl: parsed.url,
-      installPath: installDir,
-      manifest: manifest as unknown as Record<string, unknown>,
-      tags: manifest.tags,
-      category: manifest.category,
-      license: manifest.license,
-      dependencies: manifest.dependencies,
-    });
-  } catch (err) {
-    cleanupDir(installDir);
-    console.error(`Registration failed: ${(err as Error).message}`);
-    process.exit(1);
-  }
-
-  // Type-specific registration
-  await registerByType(manifest, installDir);
-
-  // Audit
-  recordAuditEvent('item', manifest.name, 'item_installed', getActor(), {
-    type: manifest.type,
-    version: manifest.version,
-    source: parsed.url,
-    manifestSource: source,
-  }).catch(() => {});
-
-  console.log(`\nInstalled ${manifest.type} "${manifest.name}" v${manifest.version}`);
-  console.log(`  Source: ${parsed.url}`);
-  console.log(`  Path: ${installDir}`);
-}
-
-// ============================================================================
-// Command registration
-// ============================================================================
-
-export function registerInstallCommand(program: Command): void {
-  program
-    .command('install <target>')
-    .description('Install a genie item from a git URL (e.g. github.com/user/repo[@version])')
-    .option('--force', 'Override existing item with same name')
-    .option('--full', 'Full git clone instead of shallow')
-    .action(async (target: string, options: InstallOptions) => {
-      try {
-        await handleInstall(target, options);
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Error: ${message}`);
-        process.exit(1);
-      }
-    });
-}

package/src/term-commands/item-uninstall.ts

@@ -1,118 +0,0 @@
-/**
- * Uninstall Command — `genie uninstall <name>`
- *
- * Removes a previously installed item: deregisters from app_store,
- * performs type-specific cleanup, and removes the cloned directory.
- */
-
-import { existsSync, readFileSync, rmSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import type { Command } from 'commander';
-import { getItemFromStore, regenerateAgentCache, removeItemFromStore } from '../lib/agent-cache.js';
-import { getActor, recordAuditEvent } from '../lib/audit.js';
-import { getConnection, isAvailable } from '../lib/db.js';
-
-const GENIE_HOME = process.env.GENIE_HOME ?? join(homedir(), '.genie');
-const ITEMS_DIR = join(GENIE_HOME, 'items');
-
-// ============================================================================
-// Type-specific deregistration
-// ============================================================================
-
-async function deregisterByType(itemType: string, name: string): Promise<void> {
-  if (!(await isAvailable())) return;
-  const sql = await getConnection();
-
-  switch (itemType) {
-    case 'agent':
-      // Remove from legacy agents table too
-      await sql`DELETE FROM agents WHERE id = ${`dir:${name}`}`.catch(() => {});
-      await regenerateAgentCache();
-      break;
-    case 'board':
-      await sql`DELETE FROM task_types WHERE id = ${name}`.catch(() => {});
-      break;
-    case 'workflow':
-      await sql`DELETE FROM schedules WHERE id = ${`sched-${name}`}`.catch(() => {});
-      break;
-    case 'app':
-      await sql`DELETE FROM installed_apps WHERE app_store_id IN (
-        SELECT id FROM app_store WHERE name = ${name}
-      )`.catch(() => {});
-      break;
-    case 'stack': {
-      // Try to read manifest and uninstall sub-items
-      const manifestPath = join(ITEMS_DIR, name, 'genie.yaml');
-      if (existsSync(manifestPath)) {
-        try {
-          const yaml = await import('js-yaml');
-          const raw = yaml.load(readFileSync(manifestPath, 'utf-8')) as Record<string, unknown>;
-          const stack = raw.stack as { items?: Array<{ name: string; type: string }> } | undefined;
-          if (stack?.items) {
-            for (const item of stack.items) {
-              await deregisterByType(item.type, item.name);
-              await removeItemFromStore(item.name).catch(() => {});
-            }
-          }
-        } catch {
-          // Best effort
-        }
-      }
-      break;
-    }
-  }
-}
-
-// ============================================================================
-// Uninstall handler
-// ============================================================================
-
-async function handleUninstall(name: string): Promise<void> {
-  const existing = await getItemFromStore(name).catch(() => null);
-  if (!existing) {
-    console.error(`Item "${name}" is not installed.`);
-    process.exit(1);
-  }
-
-  const itemType = existing.item_type;
-
-  // Type-specific deregistration
-  await deregisterByType(itemType, name);
-
-  // Remove from app_store
-  await removeItemFromStore(name);
-
-  // Remove cloned directory
-  const installDir = join(ITEMS_DIR, name);
-  if (existsSync(installDir)) {
-    rmSync(installDir, { recursive: true, force: true });
-  }
-
-  // Audit
-  recordAuditEvent('item', name, 'item_uninstalled', getActor(), {
-    type: itemType,
-    version: existing.version,
-  }).catch(() => {});
-
-  console.log(`Uninstalled ${itemType} "${name}".`);
-}
-
-// ============================================================================
-// Command registration
-// ============================================================================
-
-export function registerItemUninstallCommand(parent: Command): void {
-  parent
-    .command('uninstall <name>')
-    .description('Remove an installed genie item')
-    .action(async (name: string) => {
-      try {
-        await handleUninstall(name);
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Error: ${message}`);
-        process.exit(1);
-      }
-    });
-}

package/src/term-commands/item-update.ts

@@ -1,205 +0,0 @@
-/**
- * Update Command — `genie update <name>` or `genie update --all`
- *
- * Pulls the latest version (or a specific tag) of an installed item,
- * re-validates its manifest, and updates the app_store entry.
- */
-
-import { execSync } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import type { Command } from 'commander';
-import { getItemFromStore, listItemsFromStore, regenerateAgentCache, updateItemInStore } from '../lib/agent-cache.js';
-import { getActor, recordAuditEvent } from '../lib/audit.js';
-import { getConnection, isAvailable } from '../lib/db.js';
-import { type GenieManifest, detectManifest, validateManifest } from '../lib/manifest.js';
-
-const GENIE_HOME = process.env.GENIE_HOME ?? join(homedir(), '.genie');
-const ITEMS_DIR = join(GENIE_HOME, 'items');
-
-// ============================================================================
-// Type-specific re-registration
-// ============================================================================
-
-async function reregisterByType(manifest: GenieManifest): Promise<void> {
-  if (!(await isAvailable())) return;
-  const sql = await getConnection();
-
-  switch (manifest.type) {
-    case 'agent':
-      await regenerateAgentCache();
-      break;
-    case 'board':
-      if (manifest.board?.stages) {
-        const stages = manifest.board.stages.map((s, i) => ({
-          id: crypto.randomUUID(),
-          name: s.name,
-          label: s.label ?? s.name,
-          gate: s.gate,
-          action: s.action ?? null,
-          auto_advance: s.auto_advance ?? false,
-          roles: s.roles ?? ['*'],
-          color: s.color ?? '#94a3b8',
-          parallel: false,
-          on_fail: null,
-          position: i,
-          transitions: [],
-        }));
-        await sql`
-          UPDATE task_types SET stages = ${sql.json(stages)}, updated_at = now()
-          WHERE id = ${manifest.name}
-        `.catch(() => {});
-      }
-      break;
-    case 'workflow':
-      if (manifest.workflow) {
-        await sql`
-          UPDATE schedules SET
-            cron_expression = ${manifest.workflow.cron},
-            timezone = ${manifest.workflow.timezone ?? 'UTC'},
-            command = ${manifest.workflow.command},
-            run_spec = ${sql.json(manifest.workflow.run_spec ?? {})},
-            updated_at = now()
-          WHERE id = ${`sched-${manifest.name}`}
-        `.catch(() => {});
-      }
-      break;
-  }
-}
-
-// ============================================================================
-// Update handler
-// ============================================================================
-
-interface UpdateOptions {
-  all?: boolean;
-}
-
-async function handleUpdateSingle(name: string, version?: string): Promise<boolean> {
-  const existing = await getItemFromStore(name).catch(() => null);
-  if (!existing) {
-    console.error(`Item "${name}" is not installed.`);
-    return false;
-  }
-
-  const installDir = existing.install_path ?? join(ITEMS_DIR, name);
-  if (!existsSync(installDir)) {
-    console.error(`Install directory not found: ${installDir}`);
-    return false;
-  }
-
-  // Pull latest or checkout specific version
-  try {
-    if (version) {
-      execSync(`git fetch --tags && git checkout ${version}`, {
-        cwd: installDir,
-        stdio: 'pipe',
-        timeout: 60_000,
-      });
-    } else {
-      execSync('git pull --ff-only', {
-        cwd: installDir,
-        stdio: 'pipe',
-        timeout: 60_000,
-      });
-    }
-  } catch (err) {
-    console.error(`Git update failed for "${name}": ${(err as Error).message}`);
-    return false;
-  }
-
-  // Re-detect and validate manifest
-  const detection = await detectManifest(installDir);
-  if ('error' in detection) {
-    console.error(`Manifest detection failed after update: ${detection.error}`);
-    return false;
-  }
-
-  const { manifest } = detection;
-  const validation = validateManifest(manifest, installDir);
-  for (const w of validation.warnings) {
-    console.log(`  Warning: ${w}`);
-  }
-  if (!validation.valid) {
-    console.error(`Validation failed after update:\n${validation.errors.map((e) => `  - ${e}`).join('\n')}`);
-    return false;
-  }
-
-  // Update app_store
-  await updateItemInStore(name, {
-    version: manifest.version,
-    description: manifest.description,
-    manifest: manifest as unknown as Record<string, unknown>,
-  });
-
-  // Type-specific re-registration
-  await reregisterByType(manifest);
-
-  // Audit
-  recordAuditEvent('item', name, 'item_updated', getActor(), {
-    type: manifest.type,
-    version: manifest.version,
-    previousVersion: existing.version,
-  }).catch(() => {});
-
-  console.log(`Updated ${manifest.type} "${name}" → v${manifest.version}`);
-  return true;
-}
-
-async function handleUpdate(nameOrVersion: string | undefined, options: UpdateOptions): Promise<void> {
-  if (options.all) {
-    const items = await listItemsFromStore();
-    const gitItems = items.filter((i) => i.git_url);
-    if (gitItems.length === 0) {
-      console.log('No git-installed items to update.');
-      return;
-    }
-
-    console.log(`Updating ${gitItems.length} item(s)...`);
-    let updated = 0;
-    for (const item of gitItems) {
-      const ok = await handleUpdateSingle(item.name);
-      if (ok) updated++;
-    }
-    console.log(`\n${updated}/${gitItems.length} items updated successfully.`);
-    return;
-  }
-
-  if (!nameOrVersion) {
-    console.error('Usage: genie update <name>[@version] or genie update --all');
-    process.exit(1);
-  }
-
-  // Parse name@version
-  let name = nameOrVersion;
-  let version: string | undefined;
-  const atIdx = name.lastIndexOf('@');
-  if (atIdx > 0) {
-    version = name.slice(atIdx + 1);
-    name = name.slice(0, atIdx);
-  }
-
-  const ok = await handleUpdateSingle(name, version);
-  if (!ok) process.exit(1);
-}
-
-// ============================================================================
-// Command registration
-// ============================================================================
-
-export function registerItemUpdateCommand(parent: Command): void {
-  parent
-    .command('update [name]')
-    .description('Update an installed item to the latest version or a specific tag')
-    .option('--all', 'Update all git-installed items')
-    .action(async (name: string | undefined, options: UpdateOptions) => {
-      try {
-        await handleUpdate(name, options);
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`Error: ${message}`);
-        process.exit(1);
-      }
-    });
-}