@vectorasystems/cli 0.1.0

package/bin/vectora.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+// @vectora/cli — Commander.js entry point
+// Commands are lazy-loaded to keep startup fast (<200ms for simple commands).
+import { Command } from 'commander';
+import { VERSION } from '../src/lib/constants.js';
+
+const program = new Command();
+
+program
+  .name('vectora')
+  .description('Vectora CLI — AI-powered product development')
+  .version(VERSION);
+
+// ── Auth ──────────────────────────────────────────────────────────────────────
+program
+  .command('login')
+  .description('Authenticate with Vectora API')
+  .option('--api-key <key>', 'Authenticate using an API key directly')
+  .action(async (opts) => {
+    const m = await import('../src/commands/auth.js');
+    await m.login(opts);
+  });
+
+program
+  .command('logout')
+  .description('Clear stored credentials')
+  .action(async () => {
+    const m = await import('../src/commands/auth.js');
+    await m.logout();
+  });
+
+program
+  .command('whoami')
+  .description('Show current authenticated user')
+  .action(async () => {
+    const m = await import('../src/commands/auth.js');
+    await m.whoami();
+  });
+
+// ── Projects ──────────────────────────────────────────────────────────────────
+const projects = program.command('projects').description('Manage projects');
+
+projects
+  .command('list')
+  .description('List projects')
+  .option('-w, --workspace <id>', 'Filter by workspace ID')
+  .option('-f, --format <fmt>', 'Output format: table or json')
+  .action(async (opts) => {
+    const m = await import('../src/commands/projects.js');
+    await m.list(opts);
+  });
+
+projects
+  .command('create <name>')
+  .description('Create a new project')
+  .option('-o, --orchestrator <id>', 'Orchestrator: forge or temper', 'forge')
+  .option('-w, --workspace <id>', 'Workspace ID')
+  .action(async (name, opts) => {
+    const m = await import('../src/commands/projects.js');
+    await m.create(name, opts);
+  });
+
+projects
+  .command('show [id]')
+  .description('Show project details (defaults to active project)')
+  .option('-f, --format <fmt>', 'Output format: table or json')
+  .action(async (id, opts) => {
+    const m = await import('../src/commands/projects.js');
+    await m.show(id, opts);
+  });
+
+projects
+  .command('select <id>')
+  .description('Set active project')
+  .action(async (id) => {
+    const m = await import('../src/commands/projects.js');
+    await m.select(id);
+  });
+
+projects
+  .command('delete <id>')
+  .description('Delete a project')
+  .action(async (id) => {
+    const m = await import('../src/commands/projects.js');
+    await m.remove(id);
+  });
+
+// ── Chat ──────────────────────────────────────────────────────────────────────
+program
+  .command('chat')
+  .description('Interactive idea-chat with streaming AI')
+  .option('-p, --project <id>', 'Project ID (defaults to active)')
+  .action(async (opts) => {
+    const m = await import('../src/commands/chat.js');
+    await m.chat(opts);
+  });
+
+// ── Run Phase ─────────────────────────────────────────────────────────────────
+program
+  .command('run <phase>')
+  .description('Run a phase (analyze-codebase, plan-mvp, scope-loop, etc.)')
+  .option('-p, --project <id>', 'Project ID (defaults to active)')
+  .option('--workspace-root <path>', 'Workspace root for analyze-codebase (defaults to cwd)')
+  .action(async (phase, opts) => {
+    const m = await import('../src/commands/run.js');
+    await m.run(phase, opts);
+  });
+
+// ── Status ────────────────────────────────────────────────────────────────────
+program
+  .command('status')
+  .description('Show current project status')
+  .option('-p, --project <id>', 'Project ID (defaults to active)')
+  .action(async (opts) => {
+    const m = await import('../src/commands/status.js');
+    await m.status(opts);
+  });
+
+// ── Artifacts ─────────────────────────────────────────────────────────────────
+const artifacts = program.command('artifacts').description('View project artifacts');
+
+artifacts
+  .command('list')
+  .description('List artifacts')
+  .option('-p, --project <id>', 'Project ID (defaults to active)')
+  .option('-t, --type <type>', 'Filter by artifact type')
+  .option('-f, --format <fmt>', 'Output format: table or json')
+  .action(async (opts) => {
+    const m = await import('../src/commands/artifacts.js');
+    await m.list(opts);
+  });
+
+artifacts
+  .command('show <id>')
+  .description('Show artifact details')
+  .option('-f, --format <fmt>', 'Output format: table or json')
+  .action(async (id, opts) => {
+    const m = await import('../src/commands/artifacts.js');
+    await m.show(id, opts);
+  });
+
+// ── Usage ─────────────────────────────────────────────────────────────────────
+program
+  .command('usage')
+  .description('Show usage summary')
+  .option('-f, --format <fmt>', 'Output format: table or json')
+  .action(async (opts) => {
+    const m = await import('../src/commands/usage.js');
+    await m.usage(opts);
+  });
+
+// ── Config ────────────────────────────────────────────────────────────────────
+const config = program.command('config').description('Manage CLI configuration');
+
+config
+  .command('get <key>')
+  .description('Get a config value')
+  .action(async (key) => {
+    const m = await import('../src/commands/config.js');
+    await m.get(key);
+  });
+
+config
+  .command('set <key> <value>')
+  .description('Set a config value')
+  .action(async (key, value) => {
+    const m = await import('../src/commands/config.js');
+    await m.set(key, value);
+  });
+
+config
+  .command('list')
+  .description('Show all config values')
+  .action(async () => {
+    const m = await import('../src/commands/config.js');
+    await m.configList();
+  });
+
+config
+  .command('reset')
+  .description('Reset config to defaults')
+  .action(async () => {
+    const m = await import('../src/commands/config.js');
+    await m.reset();
+  });
+
+// ── TUI ───────────────────────────────────────────────────────────────────────
+program
+  .command('ui')
+  .description('Launch TUI dashboard')
+  .action(async () => {
+    const m = await import('../src/commands/ui.js');
+    await m.ui();
+  });
+
+// ── Parse ─────────────────────────────────────────────────────────────────────
+await program.parseAsync(process.argv);

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@vectorasystems/cli",
+  "version": "0.1.0",
+  "description": "Vectora CLI — AI-powered project orchestration",
+  "type": "module",
+  "bin": {
+    "vectora": "bin/vectora.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "dependencies": {
+    "commander": "^13.0.0",
+    "ink": "^5.1.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "ink-select-input": "^6.0.0",
+    "react": "^18.3.0",
+    "open": "^10.0.0",
+    "conf": "^13.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.0",
+    "cli-table3": "^0.6.5",
+    "figures": "^6.1.0",
+    "boxen": "^8.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/commands/artifacts.js

@@ -0,0 +1,88 @@
+// @vectora/cli — artifact commands
+import chalk from 'chalk';
+import { getProjectArtifacts, getArtifact } from '../lib/api-client.js';
+import { getConfig, getConfigValue } from '../lib/config-store.js';
+import { handleError } from '../lib/errors.js';
+import { renderTable, renderJson, renderTime, warn, info } from '../lib/output.js';
+
+/**
+ * vectora artifacts list [--project <id>] [--type <type>]
+ */
+export async function list(opts) {
+  try {
+    const projectId = opts.project ?? getConfigValue('defaultProject');
+    if (!projectId) {
+      warn('No project selected. Use --project <id> or: vectora projects select <id>');
+      process.exitCode = 1;
+      return;
+    }
+
+    const format = opts.format ?? getConfig().outputFormat;
+    const artifacts = await getProjectArtifacts(projectId, opts.type);
+
+    if (artifacts.length === 0) {
+      info('No artifacts found. Run a phase first: vectora run <phase>');
+      return;
+    }
+
+    if (format === 'json') {
+      renderJson(artifacts);
+      return;
+    }
+
+    renderTable(
+      ['ID', 'Type', 'Version', 'Created'],
+      artifacts.map((a) => [
+        chalk.dim(a.id.slice(0, 12)),
+        chalk.cyan(a.type),
+        String(a.version),
+        renderTime(a.createdAt),
+      ]),
+    );
+  } catch (err) {
+    handleError(err);
+  }
+}
+
+/**
+ * vectora artifacts show <id>
+ */
+export async function show(id, opts) {
+  try {
+    if (!id) {
+      console.error(chalk.red('Error — artifact ID is required'));
+      process.exitCode = 1;
+      return;
+    }
+
+    const artifact = await getArtifact(id);
+    const format = opts.format ?? getConfig().outputFormat;
+
+    if (format === 'json') {
+      renderJson(artifact);
+      return;
+    }
+
+    console.log();
+    console.log(chalk.cyan.bold(`  Artifact: ${artifact.type}`));
+    console.log(chalk.dim('  ─────────────────────────────'));
+    console.log(`  ID:        ${chalk.dim(artifact.id)}`);
+    console.log(`  Type:      ${chalk.cyan(artifact.type)}`);
+    console.log(`  Version:   ${artifact.version}`);
+    console.log(`  Project:   ${chalk.dim(artifact.projectId)}`);
+    console.log(`  Created:   ${renderTime(artifact.createdAt)}`);
+
+    if (artifact.publicUrl) {
+      console.log(`  URL:       ${chalk.underline(artifact.publicUrl)}`);
+    }
+
+    if (artifact.metadata && Object.keys(artifact.metadata).length > 0) {
+      console.log();
+      console.log(chalk.dim('  Metadata:'));
+      console.log(chalk.dim(JSON.stringify(artifact.metadata, null, 2).split('\n').map((l) => '    ' + l).join('\n')));
+    }
+    console.log();
+  } catch (err) {
+    handleError(err);
+  }
+}

package/src/commands/auth.js

@@ -0,0 +1,207 @@
+// @vectora/cli — auth commands: login, logout, whoami
+import http from 'node:http';
+import crypto from 'node:crypto';
+import chalk from 'chalk';
+import { getCredentials, saveCredentials, clearCredentials, requireToken } from '../lib/auth-store.js';
+import { getMe, checkHealth } from '../lib/api-client.js';
+import { getConfig } from '../lib/config-store.js';
+import { handleError, AuthError } from '../lib/errors.js';
+import { success, info, warn } from '../lib/output.js';
+
+/**
+ * vectora login [--api-key <key>]
+ * Authenticates with the Vectora API using device flow or direct API key.
+ */
+export async function login(opts) {
+  try {
+    // Check if already logged in
+    const existing = await getCredentials();
+    if (existing?.apiToken) {
+      try {
+        const me = await getMe(existing.apiToken);
+        warn(`Already logged in as ${chalk.bold(me.userId)} (org: ${me.orgName})`);
+        info('Run `vectora logout` first, or use --api-key to replace credentials.');
+        return;
+      } catch {
+        // Token is stale, proceed with login
+      }
+    }
+
+    // Direct API key mode
+    if (opts.apiKey) {
+      await loginWithApiKey(opts.apiKey);
+      return;
+    }
+
+    // Device flow
+    await loginDeviceFlow();
+  } catch (err) {
+    handleError(err);
+  }
+}
+
+async function loginWithApiKey(apiKey) {
+  const trimmed = apiKey.trim();
+  if (!trimmed.startsWith('vk_')) {
+    throw new AuthError('Invalid API key format. Keys should start with "vk_".');
+  }
+
+  info('Validating API key...');
+  const me = await getMe(trimmed);
+
+  await saveCredentials({
+    method: 'api-key',
+    apiToken: trimmed,
+    userId: me.userId,
+    orgId: me.orgId,
+    orgName: me.orgName,
+    createdAt: new Date().toISOString(),
+  });
+
+  success(`Logged in as ${chalk.bold(me.userId)} (org: ${chalk.bold(me.orgName)})`);
+}
+
+async function loginDeviceFlow() {
+  const { apiUrl, appUrl } = getConfig();
+
+  // Check API is reachable
+  const health = await checkHealth();
+  if (health.status === 'unreachable') {
+    throw new AuthError(`Cannot reach Vectora API at ${apiUrl}. Is it running?`);
+  }
+
+  const state = crypto.randomBytes(16).toString('hex');
+  const port = await findFreePort();
+
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      server.close();
+      reject(new AuthError('Login timed out after 120 seconds. Try again or use --api-key.'));
+    }, 120_000);
+
+    const server = http.createServer(async (req, res) => {
+      const url = new URL(req.url, `http://localhost:${port}`);
+
+      if (url.pathname === '/callback') {
+        const receivedState = url.searchParams.get('state');
+        const token = url.searchParams.get('token');
+        const userId = url.searchParams.get('userId');
+        const orgId = url.searchParams.get('orgId');
+
+        res.writeHead(200, { 'Content-Type': 'text/html', 'Connection': 'close' });
+
+        if (receivedState !== state) {
+          res.end('<html><body><h2>State mismatch — login rejected.</h2><p>You can close this tab.</p></body></html>');
+          clearTimeout(timeout);
+          server.closeAllConnections?.();
+          server.close();
+          reject(new AuthError('State mismatch during login callback.'));
+          return;
+        }
+
+        if (!token) {
+          res.end('<html><body><h2>No token received.</h2><p>Try again.</p></body></html>');
+          clearTimeout(timeout);
+          server.closeAllConnections?.();
+          server.close();
+          reject(new AuthError('No token received in callback.'));
+          return;
+        }
+
+        res.end(`<html><body style="font-family:monospace;background:#0a0b0e;color:#e0e0e0;display:flex;align-items:center;justify-content:center;height:100vh;margin:0">
+          <div style="text-align:center">
+            <h2 style="color:#00e5ff">VECTORA CLI</h2>
+            <p style="color:#00c853">Authenticated successfully.</p>
+            <p style="color:#666">You can close this tab and return to the terminal.</p>
+          </div>
+        </body></html>`);
+
+        clearTimeout(timeout);
+        server.closeAllConnections?.();
+        server.close();
+
+        try {
+          // Validate the token
+          const me = await getMe(token);
+          await saveCredentials({
+            method: 'device-flow',
+            apiToken: token,
+            userId: userId ?? me.userId,
+            orgId: orgId ?? me.orgId,
+            orgName: me.orgName,
+            createdAt: new Date().toISOString(),
+          });
+
+          success(`Logged in as ${chalk.bold(me.userId)} (org: ${chalk.bold(me.orgName)})`);
+          resolve();
+        } catch (err) {
+          reject(err);
+        }
+        return;
+      }
+
+      res.writeHead(404);
+      res.end('Not found');
+    });
+
+    server.listen(port, '127.0.0.1', () => {
+      const authUrl = `${appUrl}/cli-auth?port=${port}&state=${state}`;
+      console.log();
+      info('Opening browser for authentication...');
+      console.log(chalk.dim(`  If the browser doesn't open, visit:`));
+      console.log(chalk.cyan(`  ${authUrl}`));
+      console.log();
+
+      import('open').then((m) => m.default(authUrl)).catch(() => {
+        warn('Could not open browser automatically. Please open the URL above.');
+      });
+    });
+  });
+}
+
+function findFreePort() {
+  return new Promise((resolve, reject) => {
+    const s = http.createServer();
+    s.listen(0, '127.0.0.1', () => {
+      const { port } = s.address();
+      s.close(() => resolve(port));
+    });
+    s.on('error', reject);
+  });
+}
+
+/**
+ * vectora logout
+ */
+export async function logout() {
+  try {
+    const existing = await getCredentials();
+    if (!existing?.apiToken) {
+      info('Not logged in.');
+      return;
+    }
+    await clearCredentials();
+    success('Logged out. Credentials cleared.');
+  } catch (err) {
+    handleError(err);
+  }
+}
+
+/**
+ * vectora whoami
+ */
+export async function whoami() {
+  try {
+    const token = await requireToken();
+    const me = await getMe(token);
+    console.log();
+    console.log(chalk.cyan.bold('  VECTORA'));
+    console.log(chalk.dim('  ─────────────────'));
+    console.log(`  User:  ${chalk.bold(me.userId)}`);
+    console.log(`  Org:   ${chalk.bold(me.orgName)} ${chalk.dim(`(${me.orgId})`)}`);
+    console.log(`  Plan:  ${chalk.bold(me.plan)}`);
+    console.log();
+  } catch (err) {
+    handleError(err);
+  }
+}

package/src/commands/chat.js

@@ -0,0 +1,116 @@
+// @vectora/cli — interactive idea-chat command
+import readline from 'node:readline';
+import chalk from 'chalk';
+import { requireToken } from '../lib/auth-store.js';
+import { getConfig, getConfigValue } from '../lib/config-store.js';
+import { streamIdeaChat } from '../lib/sse-client.js';
+import { handleError } from '../lib/errors.js';
+import { renderReadinessBar, warn, info } from '../lib/output.js';
+
+/**
+ * vectora chat [--project <id>]
+ */
+export async function chat(opts) {
+  try {
+    const projectId = opts.project ?? getConfigValue('defaultProject');
+    if (!projectId) {
+      warn('No project selected. Use --project <id> or: vectora projects select <id>');
+      process.exitCode = 1;
+      return;
+    }
+
+    const token = await requireToken();
+    const { apiUrl } = getConfig();
+
+    console.log();
+    console.log(chalk.cyan.bold('  VECTORA IDEA CHAT'));
+    console.log(chalk.dim('  ─────────────────────────────'));
+    console.log(chalk.dim('  Type your idea. The AI will help refine it into a build-ready brief.'));
+    console.log(chalk.dim('  Commands: /brief  /quit'));
+    console.log();
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      prompt: chalk.green('> '),
+    });
+
+    rl.prompt();
+
+    rl.on('line', async (line) => {
+      const trimmed = line.trim();
+      if (!trimmed) { rl.prompt(); return; }
+
+      // Handle special commands
+      if (trimmed === '/quit' || trimmed === '/exit') {
+        console.log(chalk.dim('  Goodbye.'));
+        rl.close();
+        return;
+      }
+
+      if (trimmed === '/brief') {
+        info('Brief summary is shown after each message. Send a message to see current readiness.');
+        rl.prompt();
+        return;
+      }
+
+      // Stream the chat response
+      process.stdout.write(chalk.cyan('  '));
+      let lastComplete = null;
+
+      try {
+        for await (const { event, data } of streamIdeaChat(apiUrl, token, projectId, trimmed)) {
+          switch (event) {
+            case 'chat:delta':
+              process.stdout.write(data.text ?? '');
+              break;
+
+            case 'chat:complete':
+              lastComplete = data;
+              break;
+
+            case 'chat:error':
+              console.log();
+              console.error(chalk.red(`  Error: ${data.error ?? 'Unknown error'}`));
+              break;
+          }
+        }
+      } catch (err) {
+        console.log();
+        console.error(chalk.red(`  ${err.message}`));
+        rl.prompt();
+        return;
+      }
+
+      console.log();
+
+      // Show readiness after each response
+      if (lastComplete?.readiness) {
+        const r = lastComplete.readiness;
+        console.log();
+        console.log(`  ${chalk.dim('Readiness:')} ${renderReadinessBar(r.score)}`);
+        if (r.isReady) {
+          console.log(chalk.green('  Brief is ready! Run phases to start building.'));
+        } else if (r.failedChecks?.length) {
+          console.log(chalk.dim(`  Missing: ${r.failedChecks.join(', ')}`));
+        }
+      }
+
+      if (lastComplete?.updatedFields?.length) {
+        console.log(chalk.dim(`  Updated: ${lastComplete.updatedFields.join(', ')}`));
+      }
+
+      console.log();
+      rl.prompt();
+    });
+
+    rl.on('close', () => {
+      process.exit(0);
+    });
+
+    // Keep the process alive
+    await new Promise(() => {});
+  } catch (err) {
+    handleError(err);
+  }
+}