@vexdo/cli 0.1.0 → 0.1.2

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "@vexdo/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
+  "main": "./dist/index.js",
   "bin": {
     "vexdo": "./bin/vexdo.js"
   },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsup",
+    "prepack": "npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "test": "vitest run",

package/.eslintrc.json

@@ -1,23 +0,0 @@
-{
-  "root": true,
-  "env": {
-    "node": true,
-    "es2022": true
-  },
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "project": "./tsconfig.json",
-    "sourceType": "module"
-  },
-  "plugins": ["@typescript-eslint"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/strict-type-checked",
-    "plugin:@typescript-eslint/stylistic-type-checked",
-    "prettier"
-  ],
-  "rules": {
-    "@typescript-eslint/consistent-type-imports": "error"
-  },
-  "ignorePatterns": ["dist", "bin/*.js"]
-}

package/.github/workflows/ci.yml

@@ -1,84 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - '**'
-    tags:
-      - 'v*'
-  pull_request:
-
-jobs:
-  lint-typecheck:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 18
-      - uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
-          restore-keys: |
-            npm-${{ runner.os }}-
-      - run: npm ci
-      - run: npm run typecheck
-      - run: npm run lint
-
-  test:
-    runs-on: ubuntu-latest
-    needs: lint-typecheck
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 18
-      - uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
-          restore-keys: |
-            npm-${{ runner.os }}-
-      - run: npm ci
-      - run: npm run test:coverage
-
-  build:
-    runs-on: ubuntu-latest
-    needs: test
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 18
-      - uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
-          restore-keys: |
-            npm-${{ runner.os }}-
-      - run: npm ci
-      - run: npm run build
-      - run: test -n "$(find dist -mindepth 1 -maxdepth 1 -print -quit)"
-
-  release:
-    if: startsWith(github.ref, 'refs/tags/v')
-    runs-on: ubuntu-latest
-    needs: [lint-typecheck, test, build]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 18
-          registry-url: https://registry.npmjs.org
-      - uses: actions/cache@v4
-        with:
-          path: ~/.npm
-          key: npm-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
-          restore-keys: |
-            npm-${{ runner.os }}-
-      - run: npm ci
-      - run: npm run build
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.idea/copilot.data.migration.ask2agent.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Ask2AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/go.imports.xml

@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="GoImports">
-    <option name="excludedPackages">
-      <array>
-        <option value="github.com/pkg/errors" />
-        <option value="golang.org/x/net/context" />
-      </array>
-    </option>
-  </component>
-</project>

package/.idea/misc.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_24" default="true" project-jdk-name="openjdk-24" project-jdk-type="JavaSDK">
-    <output url="file://$PROJECT_DIR$/out" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/vexdo-cli.iml" filepath="$PROJECT_DIR$/.idea/vexdo-cli.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

package/.idea/vexdo-cli.iml

@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="JAVA_MODULE" version="4">
-  <component name="NewModuleRootManager" inherit-compiler-output="true">
-    <exclude-output />
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.prettierrc

@@ -1,5 +0,0 @@
-{
-  "singleQuote": true,
-  "trailingComma": "all",
-  "printWidth": 100
-}

package/CLAUDE.md

@@ -1,93 +0,0 @@
-# CLAUDE.md
-
-## 1) Project overview
-
-`vexdo` is a task orchestrator CLI for multi-service repositories. The core flow is: load task + config, run Codex for each step, run Claude reviewer + arbiter loop, then submit PRs or escalate.
-
-## 2) Architecture
-
-Dependency direction should stay:
-
-```text
-types  ←  lib  ←  commands  ←  index.ts
-```
-
-Key invariants:
-- `commands/` may exit process; `lib/` should generally return errors.
-- `lib/` is reusable orchestration/integration logic.
-- `types/` stays free of runtime dependencies.
-- Reviewer and arbiter must run with isolated contexts/data.
-
-## 3) Key files and roles
-
-```text
-src/
-  index.ts                  # commander bootstrap, global flags, command wiring
-  commands/
-    init.ts                 # interactive bootstrap (`vexdo init`)
-    start.ts                # primary task execution flow
-    review.ts               # rerun review loop on active step
-    fix.ts                  # feed corrective prompt to Codex then review
-    submit.ts               # PR creation and state completion
-    abort.ts                # cancel task, preserve branches
-    status.ts               # print active state
-    logs.ts                 # print iteration logs
-  lib/
-    config.ts               # .vexdo.yml discovery + validation
-    tasks.ts                # task loading/validation and lane moves
-    state.ts                # active state persistence
-    review-loop.ts          # reviewer/arbiter loop control
-    claude.ts               # Anthropic SDK wrapper
-    codex.ts                # codex CLI wrapper
-    gh.ts                   # gh CLI wrapper for PRs
-    git.ts                  # git operations
-    logger.ts               # output formatting
-    requirements.ts         # env/runtime checks
-  prompts/
-    reviewer.ts             # reviewer prompt construction
-    arbiter.ts              # arbiter prompt construction
-  types/index.ts            # shared type contracts
-```
-
-## 4) Common tasks
-
-### Add a command
-1. Add `src/commands/<name>.ts` with `register<Name>Command`.
-2. Keep parsing and CLI concerns in command file.
-3. Put reusable logic in `lib/`.
-4. Register in `src/index.ts`.
-5. Add tests and README docs.
-
-### Add a lib function
-1. Add function to the nearest `lib/*` module.
-2. Keep signature typed and avoid `any`.
-3. Return errors; avoid process termination.
-4. Add focused unit tests.
-
-### Add a test
-1. Unit tests in `test/unit` or `tests/unit` for isolated behavior.
-2. Integration tests in `test/integration` or `tests/integration` for flow.
-3. Use `vi.mock` for `child_process`, SDKs, and external CLIs.
-
-## 5) Constraints to always enforce
-
-- No `any` in new code.
-- Keep ESM `.js` import specifiers in TS source.
-- No `process.exit` inside `lib/` modules.
-- Do not add `chalk`; use `picocolors` for output styling.
-- Reviewer and arbiter contexts must remain isolated.
-
-## 6) Test conventions
-
-- Prefer mocking at module boundary.
-- `child_process` calls should be mocked with `vi.mock('node:child_process', ...)`.
-- Anthropic SDK behavior should be mocked through `lib/claude.ts` dependencies.
-- Use temp directories for filesystem side effects.
-
-## 7) What not to do
-
-- Do not embed orchestration logic directly in `index.ts`.
-- Do not tightly couple command handlers to specific prompt text.
-- Do not bypass task/config validation.
-- Do not mutate state without persisting through `state.ts` helpers.
-- Do not mix reviewer and arbiter outputs in a single decision context.

package/CONTRIBUTING.md

@@ -1,62 +0,0 @@
-# Contributing to vexdo
-
-## 1) Development setup
-
-```bash
-git clone <repo-url>
-cd vexdo-cli
-npm install
-npm link
-npm test
-```
-
-Useful checks:
-- `npm run typecheck`
-- `npm run lint`
-- `npm run build`
-
-## 2) Project structure
-
-```text
-src/
-  index.ts            # CLI entrypoint and command registration
-  commands/           # User-facing command handlers
-  lib/                # Core orchestration, integrations, and helpers
-  prompts/            # Claude reviewer/arbiter prompt templates
-  types/              # Shared TypeScript types
-test/ + tests/        # Unit and integration tests
-```
-
-## 3) Adding a new command
-
-1. Create `src/commands/<name>.ts`.
-2. Export `register<Name>Command(program: Command)`.
-3. Implement `run<Name>` function and keep side effects inside command layer.
-4. Add registration in `src/index.ts`.
-5. Add unit tests for parsing/behavior and integration tests if command touches git/fs/process.
-6. Update README command docs.
-
-## 4) Testing conventions
-
-- **Unit tests**: isolated logic, heavy mocking (`child_process`, SDK clients, filesystem helpers).
-- **Integration tests**: flow-level behavior and state transitions.
-- Prefer deterministic fixtures and temporary directories.
-- External dependencies (Anthropic, gh, codex) must be mocked in unit tests.
-
-## 5) Commit conventions
-
-- Follow Conventional Commits, e.g.:
-  - `feat: add init command`
-  - `fix: prevent duplicate gitignore entry`
-  - `docs: expand README`
-- PRs should include:
-  - clear summary
-  - tests run
-  - any breaking changes
-
-## 6) Release process
-
-1. Bump version and update changelog/release notes.
-2. Push tag `vX.Y.Z`.
-3. GitHub Actions CI runs lint/typecheck/test/build.
-4. Release job publishes to npm using `NPM_TOKEN`.

package/src/commands/abort.ts

@@ -1,66 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import readline from 'node:readline/promises';
-
-import type { Command } from 'commander';
-
-import { findProjectRoot } from '../lib/config.js';
-import * as logger from '../lib/logger.js';
-import { clearState, loadState } from '../lib/state.js';
-import { ensureTaskDirectory, moveTaskFileAtomically } from '../lib/tasks.js';
-
-export interface AbortOptions { force?: boolean }
-
-function fatalAndExit(message: string): never {
-  logger.fatal(message);
-  process.exit(1);
-}
-
-async function promptConfirmation(taskId: string): Promise<boolean> {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = await rl.question(`Abort task ${taskId}? Branches will be kept. [y/N] `);
-    return answer.trim().toLowerCase() === 'y';
-  } finally {
-    rl.close();
-  }
-}
-
-export async function runAbort(options: AbortOptions): Promise<void> {
-  const projectRoot = findProjectRoot();
-  if (!projectRoot) {
-    fatalAndExit('Not inside a vexdo project.');
-  }
-
-  const state = loadState(projectRoot);
-  if (!state) {
-    fatalAndExit('No active task.');
-  }
-
-  if (!options.force) {
-    const confirmed = await promptConfirmation(state.taskId);
-    if (!confirmed) {
-      logger.info('Abort cancelled.');
-      return;
-    }
-  }
-
-  const inProgressDir = path.join(projectRoot, 'tasks', 'in_progress');
-  if (state.taskPath.startsWith(inProgressDir) && fs.existsSync(state.taskPath)) {
-    const backlogDir = ensureTaskDirectory(projectRoot, 'backlog');
-    moveTaskFileAtomically(state.taskPath, backlogDir);
-  }
-
-  clearState(projectRoot);
-  logger.info('Task aborted. Branches preserved for manual review.');
-}
-
-export function registerAbortCommand(program: Command): void {
-  program
-    .command('abort')
-    .description('Abort active task')
-    .option('--force', 'Skip confirmation prompt')
-    .action(async (options: AbortOptions) => {
-      await runAbort(options);
-    });
-}

package/src/commands/fix.ts

@@ -1,106 +0,0 @@
-import path from 'node:path';
-
-import type { Command } from 'commander';
-
-import { ClaudeClient } from '../lib/claude.js';
-import * as codex from '../lib/codex.js';
-import { findProjectRoot, loadConfig } from '../lib/config.js';
-import * as logger from '../lib/logger.js';
-import { requireAnthropicApiKey } from '../lib/requirements.js';
-import { runReviewLoop } from '../lib/review-loop.js';
-import { loadState, saveState } from '../lib/state.js';
-import { ensureTaskDirectory, loadAndValidateTask, moveTaskFileAtomically } from '../lib/tasks.js';
-
-interface FixOptions { dryRun?: boolean; verbose?: boolean }
-
-function fatalAndExit(message: string): never {
-  logger.fatal(message);
-  process.exit(1);
-}
-
-export async function runFix(feedback: string, options: FixOptions): Promise<void> {
-  try {
-    const projectRoot = findProjectRoot();
-    if (!projectRoot) {
-      fatalAndExit('Not inside a vexdo project.');
-    }
-
-    const config = loadConfig(projectRoot);
-    const state = loadState(projectRoot);
-    if (!state) {
-      fatalAndExit('No active task.');
-    }
-
-    if (!options.dryRun) {
-      requireAnthropicApiKey();
-      await codex.checkCodexAvailable();
-    }
-
-    const currentStep = state.steps.find((step) => step.status === 'in_progress' || step.status === 'pending');
-    if (!currentStep) {
-      fatalAndExit('No in-progress step found in active task.');
-    }
-
-    const task = loadAndValidateTask(state.taskPath, config);
-    const step = task.steps.find((item) => item.service === currentStep.service);
-    if (!step) {
-      fatalAndExit(`Could not locate task step for service '${currentStep.service}'.`);
-    }
-
-    if (!options.dryRun) {
-      const serviceConfig = config.services.find((service) => service.name === currentStep.service);
-      if (!serviceConfig) {
-        fatalAndExit(`Unknown service in step: ${currentStep.service}`);
-      }
-
-      await codex.exec({
-        spec: feedback,
-        model: config.codex.model,
-        cwd: path.resolve(projectRoot, serviceConfig.path),
-        verbose: options.verbose,
-      });
-    }
-
-    const result = await runReviewLoop({
-      taskId: task.id,
-      task,
-      step,
-      stepState: currentStep,
-      projectRoot,
-      config,
-      claude: new ClaudeClient(process.env.ANTHROPIC_API_KEY ?? ''),
-      dryRun: options.dryRun,
-      verbose: options.verbose,
-    });
-
-    if (result.decision === 'escalate') {
-      currentStep.status = 'escalated';
-      state.status = 'escalated';
-      if (!options.dryRun) {
-        saveState(projectRoot, state);
-        const blockedDir = ensureTaskDirectory(projectRoot, 'blocked');
-        state.taskPath = moveTaskFileAtomically(state.taskPath, blockedDir);
-        saveState(projectRoot, state);
-      }
-      process.exit(1);
-    }
-
-    currentStep.status = 'done';
-    if (!options.dryRun) {
-      saveState(projectRoot, state);
-    }
-  } catch (error: unknown) {
-    fatalAndExit(error instanceof Error ? error.message : String(error));
-  }
-}
-
-export function registerFixCommand(program: Command): void {
-  program
-    .command('fix')
-    .description('Provide feedback to codex and rerun review')
-    .argument('<feedback>')
-    .action(async (feedback: string, options: FixOptions, command: Command) => {
-      const merged = command.optsWithGlobals();
-      await runFix(feedback, { ...options, ...merged });
-    });
-}

package/src/commands/init.ts

@@ -1,142 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { createInterface } from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
-
-import type { Command } from 'commander';
-import { stringify } from 'yaml';
-
-import * as logger from '../lib/logger.js';
-import type { VexdoConfig } from '../types/index.js';
-
-const DEFAULT_REVIEW_MODEL = 'claude-haiku-4-5-20251001';
-const DEFAULT_MAX_ITERATIONS = 3;
-const DEFAULT_CODEX_MODEL = 'gpt-4o';
-
-const TASK_DIRS = ['backlog', 'in_progress', 'review', 'done', 'blocked'] as const;
-
-export type PromptFn = (question: string) => Promise<string>;
-
-async function defaultPrompt(question: string): Promise<string> {
-  const rl = createInterface({ input, output });
-  try {
-    return await rl.question(question);
-  } finally {
-    rl.close();
-  }
-}
-
-function parseServices(value: string): string[] {
-  const parsed = value
-    .split(',')
-    .map((item) => item.trim())
-    .filter((item) => item.length > 0);
-
-  return Array.from(new Set(parsed));
-}
-
-function parseBoolean(value: string): boolean {
-  const normalized = value.trim().toLowerCase();
-  return normalized === 'y' || normalized === 'yes';
-}
-
-function parseMaxIterations(value: string): number {
-  const parsed = Number.parseInt(value, 10);
-  return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_MAX_ITERATIONS;
-}
-
-function ensureGitignoreEntry(gitignorePath: string, entry: string): boolean {
-  if (!fs.existsSync(gitignorePath)) {
-    fs.writeFileSync(gitignorePath, `${entry}\n`, 'utf8');
-    return true;
-  }
-
-  const content = fs.readFileSync(gitignorePath, 'utf8');
-  const lines = content.split(/\r?\n/).map((line) => line.trim());
-
-  if (lines.includes(entry)) {
-    return false;
-  }
-
-  const suffix = content.endsWith('\n') || content.length === 0 ? '' : '\n';
-  fs.appendFileSync(gitignorePath, `${suffix}${entry}\n`, 'utf8');
-  return true;
-}
-
-export async function runInit(projectRoot: string, prompt: PromptFn = defaultPrompt): Promise<void> {
-  const configPath = path.join(projectRoot, '.vexdo.yml');
-
-  if (fs.existsSync(configPath)) {
-    logger.warn('Found existing .vexdo.yml.');
-    const overwriteAnswer = await prompt('Overwrite existing .vexdo.yml? (y/N): ');
-    if (!parseBoolean(overwriteAnswer)) {
-      logger.info('Initialization cancelled.');
-      return;
-    }
-  }
-
-  let services = parseServices(await prompt('Project services (comma-separated names, e.g. api,web): '));
-  if (services.length === 0) {
-    services = ['api'];
-  }
-
-  const serviceConfigs: VexdoConfig['services'] = [];
-  for (const name of services) {
-    const answer = await prompt(`Path for ${name} (default: ./${name}): `);
-    serviceConfigs.push({
-      name,
-      path: answer.trim().length > 0 ? answer.trim() : `./${name}`,
-    });
-  }
-
-  const reviewModelRaw = await prompt(`Review model (default: ${DEFAULT_REVIEW_MODEL}): `);
-  const maxIterationsRaw = await prompt(`Max review iterations (default: ${String(DEFAULT_MAX_ITERATIONS)}): `);
-  const autoSubmitRaw = await prompt('Auto-submit PRs? (y/N): ');
-  const codexModelRaw = await prompt(`Codex model (default: ${DEFAULT_CODEX_MODEL}): `);
-
-  const config: VexdoConfig = {
-    version: 1,
-    services: serviceConfigs,
-    review: {
-      model: reviewModelRaw.trim() || DEFAULT_REVIEW_MODEL,
-      max_iterations: maxIterationsRaw.trim() ? parseMaxIterations(maxIterationsRaw.trim()) : DEFAULT_MAX_ITERATIONS,
-      auto_submit: parseBoolean(autoSubmitRaw),
-    },
-    codex: {
-      model: codexModelRaw.trim() || DEFAULT_CODEX_MODEL,
-    },
-  };
-
-  fs.writeFileSync(configPath, stringify(config), 'utf8');
-
-  const createdDirs: string[] = [];
-  for (const taskDir of TASK_DIRS) {
-    const directory = path.join(projectRoot, 'tasks', taskDir);
-    fs.mkdirSync(directory, { recursive: true });
-    createdDirs.push(path.relative(projectRoot, directory));
-  }
-
-  const logDir = path.join(projectRoot, '.vexdo', 'logs');
-  fs.mkdirSync(logDir, { recursive: true });
-  createdDirs.push(path.relative(projectRoot, logDir));
-
-  const gitignorePath = path.join(projectRoot, '.gitignore');
-  const gitignoreUpdated = ensureGitignoreEntry(gitignorePath, '.vexdo/');
-
-  logger.success('Initialized vexdo project.');
-  logger.info(`Created: ${path.relative(projectRoot, configPath)}`);
-  logger.info(`Created directories: ${createdDirs.join(', ')}`);
-  if (gitignoreUpdated) {
-    logger.info('Updated .gitignore with .vexdo/');
-  }
-  logger.info("Next: create a task file in tasks/backlog/ and run 'vexdo start tasks/backlog/my-task.yml'");
-}
-
-export function registerInitCommand(program: Command): void {
-  program
-    .command('init')
-    .description('Initialize vexdo in the current project')
-    .action(async () => {
-      await runInit(process.cwd());
-    });
-}