@studio-foundation/cli 0.3.0-beta.1 → 0.3.0-beta.5

package/src/commands/install.ts

@@ -1,23 +0,0 @@
-import { execSync } from 'node:child_process';
-import chalk from 'chalk';
-
-const KNOWN_EXTENSIONS: Record<string, string> = {
-  api: '@studio-foundation/api',
-};
-
-export async function installExtensionCommand(extension: string): Promise<void> {
-  const pkg = KNOWN_EXTENSIONS[extension];
-  if (!pkg) {
-    console.error(`Unknown extension: ${extension}. Available: ${Object.keys(KNOWN_EXTENSIONS).join(', ')}`);
-    process.exit(1);
-  }
-
-  console.log(`Installing ${pkg}...`);
-  try {
-    execSync(`npm install -g ${pkg}`, { stdio: 'inherit' });
-    console.log(chalk.green(`✓ ${pkg} installed. Run: studio api start`));
-  } catch {
-    console.error(chalk.red(`Failed to install ${pkg}`));
-    process.exit(1);
-  }
-}

package/src/commands/integrations.ts

@@ -1,332 +0,0 @@
-import { readFile, writeFile, mkdir, access, unlink } from 'node:fs/promises';
-import { resolve, join, dirname } from 'node:path';
-import chalk from 'chalk';
-import ora from 'ora';
-import * as yaml from 'js-yaml';
-import { getBundledIntegrationTemplate, listAvailableIntegrationTemplates, loadProjectIntegrations } from '@studio-foundation/runner';
-import type { IntegrationPluginDef } from '@studio-foundation/contracts';
-import { loadConfig, resolveEnvVars } from '../config.js';
-import { setConfigValue } from './config.js';
-
-export function getIntegrationsDir(studioDir: string): string {
-  return resolve(studioDir, 'integrations');
-}
-
-export function getIntegrationStatus(
-  plugin: IntegrationPluginDef,
-  config: Record<string, unknown>
-): 'configured' | 'not-configured' {
-  const required = plugin.config?.required ?? [];
-  const allSet = required.every(key => key in config && config[key] !== '');
-  return allSet ? 'configured' : 'not-configured';
-}
-
-async function loadRawIntegrationsConfig(studioDir: string): Promise<Record<string, Record<string, unknown>>> {
-  const configFile = join(studioDir, 'config.yaml');
-  try {
-    const raw = await readFile(configFile, 'utf-8');
-    const parsed = yaml.load(resolveEnvVars(raw)) as Record<string, unknown>;
-    return (parsed?.['integrations'] ?? {}) as Record<string, Record<string, unknown>>;
-  } catch {
-    return {};
-  }
-}
-
-function formatExtras(plugin: IntegrationPluginDef, config: Record<string, unknown>): string {
-  if (plugin.name === 'linear') {
-    const autoTrigger = config['autoTrigger'] ?? plugin.config?.optional?.['autoTrigger'] ?? false;
-    return `auto-trigger: ${autoTrigger ? 'on' : 'off'}`;
-  }
-  if (plugin.name === 'slack') {
-    const channel = config['channel'] ?? plugin.config?.optional?.['channel'] ?? '';
-    return channel ? `channel: ${String(channel)}` : '';
-  }
-  return '';
-}
-
-async function resolveStudioDir(): Promise<string> {
-  const config = await loadConfig();
-  const studioDir = config.resolvedStudioDir;
-  if (!studioDir) {
-    console.error("Error: No .studio/ directory found. Run 'studio init' first.");
-    process.exit(1);
-  }
-  return studioDir;
-}
-
-export async function installIntegration(source: string, integrationsDir: string): Promise<string> {
-  await mkdir(integrationsDir, { recursive: true });
-
-  let name: string;
-  let content: string;
-
-  if (source.startsWith('@studio-foundation/integration-')) {
-    name = source.replace('@studio-foundation/integration-', '');
-    const bundled = await getBundledIntegrationTemplate(name);
-    if (!bundled) {
-      const available = await listAvailableIntegrationTemplates();
-      throw new Error(
-        `Unknown integration '${name}'. Available: ${available.map(t => t.name).join(', ')}`
-      );
-    }
-    content = bundled;
-  } else {
-    try {
-      content = await readFile(source, 'utf-8');
-    } catch {
-      throw new Error(`File not found: ${source}`);
-    }
-    const def = yaml.load(content) as IntegrationPluginDef;
-    name = def.name;
-  }
-
-  const destPath = join(integrationsDir, `${name}.integration.yaml`);
-  const alreadyExists = await access(destPath).then(() => true).catch(() => false);
-  if (alreadyExists) {
-    throw new Error(
-      `'${name}' already installed. Run: studio integrations remove ${name}`
-    );
-  }
-
-  await writeFile(destPath, content, 'utf-8');
-  return name;
-}
-
-export async function removeIntegration(name: string, integrationsDir: string): Promise<void> {
-  const filePath = join(integrationsDir, `${name}.integration.yaml`);
-  try {
-    await unlink(filePath);
-  } catch {
-    throw new Error(`Integration '${name}' not found`);
-  }
-}
-
-async function loadRawFullConfig(configFile: string): Promise<Record<string, unknown>> {
-  try {
-    const raw = await readFile(configFile, 'utf-8');
-    const parsed = yaml.load(resolveEnvVars(raw));
-    return (parsed && typeof parsed === 'object' ? parsed : {}) as Record<string, unknown>;
-  } catch {
-    return {};
-  }
-}
-
-async function saveIntegrationConfig(configFile: string, config: Record<string, unknown>): Promise<void> {
-  await mkdir(dirname(configFile), { recursive: true });
-  await writeFile(configFile, yaml.dump(config), 'utf-8');
-}
-
-export interface IntegrationTestResult {
-  success: boolean;
-  statusCode?: number;
-  body?: string;
-  error?: string;
-}
-
-export async function runIntegrationTest(
-  plugin: IntegrationPluginDef,
-  config: Record<string, unknown>,
-  fetcher: typeof fetch = fetch
-): Promise<IntegrationTestResult> {
-  const testDef = plugin.test;
-  if (!testDef) {
-    throw new Error(`Integration '${plugin.name}' has no test: configuration`);
-  }
-
-  const resolveVar = (str: string) =>
-    str.replace(/\$\{([^}]+)\}/g, (_, key: string) => String(config[key.trim()] ?? ''));
-
-  const headers: Record<string, string> = {
-    'Content-Type': 'application/json',
-  };
-
-  if (testDef.auth) {
-    const resolvedAuth = resolveVar(testDef.auth);
-    const colonIdx = resolvedAuth.indexOf(':');
-    if (colonIdx !== -1) {
-      const scheme = resolvedAuth.slice(0, colonIdx);
-      const token = resolvedAuth.slice(colonIdx + 1);
-      headers['Authorization'] = `${scheme.charAt(0).toUpperCase()}${scheme.slice(1)} ${token}`;
-    }
-  }
-
-  try {
-    const response = await fetcher(testDef.endpoint, {
-      method: testDef.method ?? 'GET',
-      headers,
-      ...(testDef.body ? { body: testDef.body } : {}),
-    });
-
-    const body = await response.text().catch(() => '');
-    const expectedStatus = testDef.expect?.status ?? 200;
-
-    if (response.status !== expectedStatus) {
-      return { success: false, statusCode: response.status, body };
-    }
-    return { success: true, statusCode: response.status, body };
-  } catch (err) {
-    return { success: false, error: err instanceof Error ? err.message : String(err) };
-  }
-}
-
-export async function integrationsCommand(
-  action: string,
-  _args: string[],
-  _options: Record<string, string | boolean | undefined>
-): Promise<void> {
-  try {
-    switch (action) {
-      case 'install': {
-        const source = _args[0];
-        if (!source) {
-          console.error('Usage: studio integrations install <source>');
-          console.error('  <source> can be @studio/integration-<name> or a local file path');
-          process.exit(1);
-        }
-        const studioDir = await resolveStudioDir();
-        const intDir = getIntegrationsDir(studioDir);
-        const spinner = ora(`Installing ${source}...`).start();
-        try {
-          const name = await installIntegration(source, intDir);
-          spinner.succeed(chalk.green(`✓ Integration '${name}' installed`));
-          console.log(`\n  Configure with: ${chalk.cyan(`studio integrations set ${name}.<key> <value>`)}`);
-          console.log(`  Test with:      ${chalk.cyan(`studio integrations test ${name}`)}\n`);
-        } catch (err) {
-          spinner.fail(err instanceof Error ? err.message : String(err));
-          process.exit(1);
-        }
-        break;
-      }
-      case 'list': {
-        const studioDir = await resolveStudioDir();
-        const intDir = getIntegrationsDir(studioDir);
-        const plugins = await loadProjectIntegrations(intDir);
-
-        if (plugins.length === 0) {
-          console.log(chalk.yellow('\nNo integrations installed.'));
-          console.log(`  Run: ${chalk.cyan('studio integrations install @studio/integration-<name>')}\n`);
-          break;
-        }
-
-        const config = await loadRawIntegrationsConfig(studioDir);
-        console.log('');
-        for (const plugin of plugins) {
-          const pluginConfig = (config[plugin.name] ?? {}) as Record<string, unknown>;
-          const status = getIntegrationStatus(plugin, pluginConfig);
-          const dot = status === 'configured' ? chalk.green('●') : chalk.gray('○');
-          const statusLabel = status === 'configured'
-            ? chalk.green('configured')
-            : chalk.gray('not configured');
-          const extras = formatExtras(plugin, pluginConfig);
-          const version = `v${plugin.version}`;
-          console.log(`${plugin.name.padEnd(12)} ${dot} ${statusLabel.padEnd(20)} ${extras.padEnd(20)} ${chalk.gray(version)}`);
-        }
-        console.log('');
-        break;
-      }
-      case 'remove': {
-        const name = _args[0];
-        if (!name) {
-          console.error('Usage: studio integrations remove <name>');
-          process.exit(1);
-        }
-        const studioDir = await resolveStudioDir();
-        await removeIntegration(name, getIntegrationsDir(studioDir));
-        console.log(chalk.green(`✓ Integration '${name}' removed`));
-        break;
-      }
-      case 'test': {
-        const name = _args[0];
-        if (!name) {
-          console.error('Usage: studio integrations test <name>');
-          process.exit(1);
-        }
-        const studioDir = await resolveStudioDir();
-        const intDir = getIntegrationsDir(studioDir);
-        const plugins = await loadProjectIntegrations(intDir);
-        const plugin = plugins.find(p => p.name === name);
-
-        if (!plugin) {
-          console.error(
-            `Error: '${name}' not installed. Run: studio integrations install @studio/integration-${name}`
-          );
-          process.exit(1);
-        }
-
-        if (!plugin.test) {
-          console.error(`Error: Integration '${name}' has no test: configuration in its .integration.yaml`);
-          process.exit(1);
-        }
-
-        const intConfig = await loadRawIntegrationsConfig(studioDir);
-        const pluginConfig = intConfig[name] ?? {};
-        const required = plugin.config?.required ?? [];
-        const missing = required.filter(key => !pluginConfig[key] && !process.env[key]);
-        if (missing.length > 0) {
-          for (const key of missing) {
-            console.error(`Error: ${key} not set. Run: studio integrations set ${name}.${key} <value>`);
-          }
-          process.exit(1);
-        }
-
-        const spinner = ora(`Testing ${name} connection...`).start();
-        const result = await runIntegrationTest(plugin, pluginConfig as Record<string, unknown>);
-
-        if (result.success) {
-          spinner.succeed(chalk.green(`✓ ${name} connected`));
-        } else {
-          const detail = result.error ?? `HTTP ${result.statusCode}`;
-          spinner.fail(chalk.red(`✗ ${name} error — ${detail}`));
-          process.exit(1);
-        }
-        break;
-      }
-      case 'set': {
-        const dotPath = _args[0];
-        const value = _args[1];
-        if (!dotPath || value === undefined) {
-          console.error('Usage: studio integrations set <name>.<key> <value>');
-          process.exit(1);
-        }
-        const dotIndex = dotPath.indexOf('.');
-        if (dotIndex === -1) {
-          console.error('Error: path must be <integration-name>.<key> (e.g. linear.autoTrigger)');
-          process.exit(1);
-        }
-        const integrationName = dotPath.slice(0, dotIndex);
-        const key = dotPath.slice(dotIndex + 1);
-
-        const studioDir = await resolveStudioDir();
-        const intDir = getIntegrationsDir(studioDir);
-
-        const pluginPath = join(intDir, `${integrationName}.integration.yaml`);
-        const isInstalled = await access(pluginPath).then(() => true).catch(() => false);
-        if (!isInstalled) {
-          console.error(
-            `Error: Integration '${integrationName}' not installed. ` +
-            `Run: studio integrations install @studio/integration-${integrationName}`
-          );
-          process.exit(1);
-        }
-
-        const configFile = join(studioDir, 'config.yaml');
-        const rawConfig = await loadRawFullConfig(configFile);
-        setConfigValue(rawConfig, `integrations.${integrationName}.${key}`, value);
-        await saveIntegrationConfig(configFile, rawConfig);
-
-        console.log(chalk.green(`✓ Set integrations.${integrationName}.${key} = ${value}`));
-        break;
-      }
-      default:
-        console.error(`Unknown integrations action: ${action}. Available: install, list, remove, test, set`);
-        process.exit(1);
-    }
-  } catch (error) {
-    if (error instanceof Error && error.name === 'ExitPromptError') {
-      console.log('\nAborted.');
-      process.exit(0);
-    }
-    console.error(chalk.red('Error:'), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}

package/src/commands/list.ts

@@ -1,197 +0,0 @@
-import { readdir, readFile } from 'node:fs/promises';
-import { resolve, join } from 'node:path';
-import chalk from 'chalk';
-import { loadConfig } from '../config.js';
-
-const RUNS_DIR = '.studio/runs';
-
-interface ListOptions {
-  status?: string;
-  limit?: string;
-  json?: boolean;
-  project?: string;
-}
-
-export async function listCommand(
-  resource: string,
-  options: ListOptions
-): Promise<void> {
-  try {
-    const config = await loadConfig();
-    const configsDir = config.paths?.configs
-      ? resolve(config.paths.configs)
-      : config.resolvedStudioDir
-        ? resolve(config.resolvedStudioDir)
-        : resolve('./configs');
-
-    switch (resource) {
-      case 'projects':
-        await listProjects(configsDir, options.json);
-        break;
-      case 'pipelines':
-        await listPipelines(configsDir, options.json);
-        break;
-      case 'agents':
-        await listAgents(configsDir, options.json);
-        break;
-      case 'runs':
-        await listRuns(options);
-        break;
-      default:
-        console.error(
-          `Unknown resource: ${resource}. Available: projects, pipelines, agents, runs`
-        );
-        process.exit(1);
-    }
-  } catch (error) {
-    console.error('Error:', error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-
-async function listProjects(configsDir: string, json?: boolean): Promise<void> {
-  // With the flat .studio/ structure, there is no projects/ layer.
-  if (json) {
-    console.log(JSON.stringify([configsDir], null, 2));
-    return;
-  }
-  console.log('\nThis workspace uses a flat .studio/ structure (no projects/ layer).');
-  console.log('Run `studio list pipelines` to see available pipelines.');
-  console.log('');
-}
-
-async function listPipelines(configsDir: string, json?: boolean): Promise<void> {
-  const pipelinesDir = join(configsDir, 'pipelines');
-  const results = await getFileNames(pipelinesDir, '.pipeline.yaml');
-
-  if (json) {
-    console.log(JSON.stringify(results, null, 2));
-    return;
-  }
-
-  if (results.length === 0) {
-    console.log(chalk.yellow('No pipelines found'));
-    return;
-  }
-
-  console.log('\nPipelines:');
-  for (const name of results) {
-    console.log(`  - ${name}`);
-  }
-  console.log('');
-}
-
-async function listAgents(configsDir: string, json?: boolean): Promise<void> {
-  const agentsDir = join(configsDir, 'agents');
-  const results = await getFileNames(agentsDir, '.agent.yaml');
-
-  if (json) {
-    console.log(JSON.stringify(results, null, 2));
-    return;
-  }
-
-  if (results.length === 0) {
-    console.log(chalk.yellow('No agents found'));
-    return;
-  }
-
-  console.log('\nAgents:');
-  for (const name of results) {
-    console.log(`  - ${name}`);
-  }
-  console.log('');
-}
-
-interface RunListEntry {
-  date: string;
-  pipeline: string;
-  run_id: string;
-  status: string;
-  filename: string;
-}
-
-async function listRuns(options: ListOptions): Promise<void> {
-  const runsPath = resolve(process.cwd(), RUNS_DIR);
-  let entries: import('node:fs').Dirent[];
-  try {
-    entries = await readdir(runsPath, { withFileTypes: true });
-  } catch {
-    if (options.json) {
-      console.log('[]');
-    } else {
-      console.log(chalk.yellow(`No runs directory at ${runsPath}. Run a pipeline first.`));
-    }
-    return;
-  }
-
-  const jsonlFiles = entries
-    .filter((e) => e.isFile() && e.name.endsWith('.jsonl'))
-    .map((e) => e.name);
-
-  const runs: RunListEntry[] = [];
-  for (const filename of jsonlFiles) {
-    const match = filename.match(/^(\d{4}-\d{2}-\d{2}T\d{1,2}h\d{1,2}m)-(.+)-([a-f0-9]{8})\.jsonl$/i);
-    if (!match) continue;
-    const datePart = match[1];
-    const pipeline = match[2];
-    const runId = match[3];
-
-    let status = 'running';
-    try {
-      const content = await readFile(resolve(runsPath, filename), 'utf-8');
-      const lines = content.split('\n').filter((l) => l.trim().length > 0);
-      const lastLine = lines[lines.length - 1];
-      if (lastLine) {
-        const record = JSON.parse(lastLine) as Record<string, unknown>;
-        if (record.event === 'pipeline_complete' && typeof record.status === 'string') {
-          status = record.status;
-        }
-      }
-    } catch {
-      // keep default status
-    }
-    runs.push({
-      date: datePart ?? filename,
-      pipeline,
-      run_id: runId ?? '',
-      status,
-      filename,
-    });
-  }
-
-  runs.sort((a, b) => (b.date > a.date ? 1 : -1));
-  const limit = options.limit ? parseInt(options.limit, 10) : 10;
-  const limited = runs.slice(0, isNaN(limit) ? 10 : limit);
-
-  if (options.json) {
-    console.log(JSON.stringify(limited, null, 2));
-    return;
-  }
-
-  if (limited.length === 0) {
-    console.log(chalk.yellow('No runs found'));
-    return;
-  }
-
-  const statusColor = (s: string) =>
-    s === 'success' ? chalk.green(s) : s === 'rejected' || s === 'failed' ? chalk.red(s) : chalk.gray(s);
-
-  console.log('\nRuns:');
-  for (const r of limited) {
-    console.log(`  ${r.date}  ${r.pipeline}  ${r.run_id}  ${statusColor(r.status)}`);
-  }
-  console.log('');
-}
-
-async function getFileNames(dir: string, suffix: string): Promise<string[]> {
-  let files: string[];
-  try {
-    files = await readdir(dir);
-  } catch {
-    return [];
-  }
-  return files
-    .filter((f) => f.endsWith(suffix))
-    .map((f) => f.replace(suffix, ''))
-    .sort();
-}

package/src/commands/logs.ts

@@ -1,119 +0,0 @@
-import { readFile, readdir } from 'node:fs/promises';
-import { resolve } from 'node:path';
-import chalk from 'chalk';
-
-const RUNS_DIR = '.studio/runs';
-
-interface LogsOptions {
-  raw?: boolean;
-  json?: boolean;
-}
-
-function runIdShort(runId: string): string {
-  return runId.replace(/-/g, '').slice(0, 8);
-}
-
-function formatEventLine(record: Record<string, unknown>): string {
-  const event = record.event as string;
-  const ts = record.ts as string;
-  const time = ts ? new Date(ts).toISOString().slice(11, 19) : '';
-
-  switch (event) {
-    case 'pipeline_start':
-      return chalk.blue(`${time} Pipeline started: ${record.project}/${record.pipeline} (run ${record.run_id})`);
-    case 'pipeline_complete':
-      return chalk.blue(
-        `${time} Pipeline complete: ${record.status} (${record.duration_ms}ms, ${record.total_tokens ?? 0} tokens)`
-      );
-    case 'stage_start':
-      return chalk.gray(
-        `  ${time} [${(record.stage_index as number) + 1}/${record.total_stages}] ${record.stage} ...`
-      );
-    case 'stage_complete': {
-      const status = record.status as string;
-      const icon = status === 'success' ? chalk.green('✓') : chalk.red('✗');
-      const attempts = record.attempts !== undefined ? ` (${record.attempts} attempt(s))` : '';
-      const duration = record.duration_ms !== undefined ? ` ${record.duration_ms}ms` : '';
-      return chalk.gray(`  ${time} ${icon} ${record.stage} ${status}${attempts}${duration}`);
-    }
-    case 'stage_retry':
-      return chalk.yellow(
-        `  ${time} ↻ Retry #${record.attempt}: ${record.failure_reason ?? 'unknown'}`
-      );
-    case 'group_start':
-      return chalk.gray(`  ${time} Group ${record.group} (max ${record.max_iterations} iterations)`);
-    case 'group_iteration':
-      return chalk.yellow(`  ${time} ↻ Iteration ${record.iteration}/${record.max_iterations}`);
-    case 'group_feedback':
-      return chalk.yellow(`  ${time} Rejected: ${record.rejection_reason}`);
-    case 'group_complete':
-      return chalk.gray(`  ${time} Group complete: ${record.status} (${record.iterations} iterations)`);
-    default:
-      return chalk.gray(`${time} ${event} ${JSON.stringify(record)}`);
-  }
-}
-
-export async function logsCommand(runId: string, options: LogsOptions): Promise<void> {
-  try {
-    const runsPath = resolve(process.cwd(), RUNS_DIR);
-    let entries: import('node:fs').Dirent[];
-    try {
-      entries = await readdir(runsPath, { withFileTypes: true });
-    } catch {
-      console.error(chalk.yellow(`No runs directory found at ${runsPath}`));
-      process.exit(1);
-    }
-
-    const shortId = runIdShort(runId);
-    const jsonlFiles = entries
-      .filter((e) => e.isFile() && e.name.endsWith('.jsonl'))
-      .map((e) => e.name);
-
-    const matching = jsonlFiles.filter((name) => name.endsWith(`-${shortId}.jsonl`));
-    if (matching.length === 0) {
-      console.error(chalk.yellow(`No run log found for run id: ${runId}`));
-      process.exit(1);
-    }
-
-    const mostRecent = matching.sort().reverse()[0];
-    const filePath = resolve(runsPath, mostRecent);
-    const content = await readFile(filePath, 'utf-8');
-    const lines = content
-      .split('\n')
-      .filter((line) => line.trim().length > 0)
-      .map((line) => {
-        try {
-          return JSON.parse(line) as Record<string, unknown>;
-        } catch {
-          return null;
-        }
-      })
-      .filter((r): r is Record<string, unknown> => r !== null);
-
-    const forRun = lines.filter(
-      (r) => (r.run_id as string) === shortId || (r.run_id as string)?.startsWith(shortId)
-    );
-    const records = forRun.length > 0 ? forRun : lines;
-
-    if (options.raw) {
-      for (const r of records) {
-        console.log(JSON.stringify(r));
-      }
-      return;
-    }
-
-    if (options.json) {
-      console.log(JSON.stringify(records, null, 2));
-      return;
-    }
-
-    console.log(chalk.bold(`\nRun ${shortId} — ${mostRecent}\n`));
-    for (const record of records) {
-      console.log(formatEventLine(record));
-    }
-    console.log('');
-  } catch (error) {
-    console.error('Error:', error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}