@nathapp/nax 0.50.2 → 0.51.0

package/src/commands/runs.ts

@@ -1,220 +0,0 @@
-/**
- * Runs Command
- *
- * Reads all ~/.nax/runs/*\/meta.json entries and displays a table of runs
- * sorted by registeredAt descending. Resolves each statusPath to read the
- * live NaxStatusFile for current state. Falls back to '[unavailable]' if
- * the status file is missing or unreadable.
- *
- * Usage:
- *   nax runs [--project <name>] [--last <N>] [--status <status>]
- */
-
-import { readdir } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import chalk from "chalk";
-import type { NaxStatusFile } from "../execution/status-file";
-import type { MetaJson } from "../pipeline/subscribers/registry";
-
-const DEFAULT_LIMIT = 20;
-
-/**
- * Swappable dependencies for testing (project convention: _deps over mock.module).
- */
-export const _deps = {
-  getRunsDir: () => join(homedir(), ".nax", "runs"),
-};
-
-export interface RunsOptions {
-  /** Filter by project name */
-  project?: string;
-  /** Limit number of runs displayed (default: 20) */
-  last?: number;
-  /** Filter by run status */
-  status?: "running" | "completed" | "failed" | "crashed";
-}
-
-interface RunRow {
-  runId: string;
-  project: string;
-  feature: string;
-  status: string;
-  passed: number;
-  total: number;
-  durationMs: number;
-  registeredAt: string;
-}
-
-/**
- * Format duration in milliseconds to human-readable string.
- */
-function formatDuration(ms: number): string {
-  if (ms <= 0) return "-";
-  const minutes = Math.floor(ms / 60000);
-  const seconds = Math.floor((ms % 60000) / 1000);
-  if (minutes === 0) return `${seconds}s`;
-  return `${minutes}m ${seconds}s`;
-}
-
-/**
- * Format ISO date to short local date string.
- */
-function formatDate(iso: string): string {
-  try {
-    const d = new Date(iso);
-    return d.toLocaleDateString(undefined, { month: "short", day: "numeric", year: "numeric" });
-  } catch {
-    return iso;
-  }
-}
-
-/**
- * Color a status string for terminal output.
- */
-function colorStatus(status: string): string {
-  switch (status) {
-    case "completed":
-      return chalk.green(status);
-    case "failed":
-      return chalk.red(status);
-    case "running":
-      return chalk.yellow(status);
-    case "[unavailable]":
-      return chalk.dim(status);
-    default:
-      return chalk.dim(status);
-  }
-}
-
-/** Regex that matches ANSI escape sequences. */
-const ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
-
-/** Strip ANSI escape codes to compute visible string length. */
-function visibleLength(str: string): number {
-  return str.replace(ANSI_RE, "").length;
-}
-
-/**
- * Pad a string to a fixed width (left-aligned).
- */
-function pad(str: string, width: number): string {
-  const padding = Math.max(0, width - visibleLength(str));
-  return str + " ".repeat(padding);
-}
-
-/**
- * Display all registered runs from ~/.nax/runs/ as a table.
- *
- * @param options - Filter and limit options
- */
-export async function runsCommand(options: RunsOptions = {}): Promise<void> {
-  const runsDir = _deps.getRunsDir();
-
-  let entries: string[];
-  try {
-    entries = await readdir(runsDir);
-  } catch {
-    console.log("No runs found.");
-    return;
-  }
-
-  const rows: RunRow[] = [];
-
-  for (const entry of entries) {
-    const metaPath = join(runsDir, entry, "meta.json");
-    let meta: MetaJson;
-    try {
-      meta = await Bun.file(metaPath).json();
-    } catch {
-      continue;
-    }
-
-    // Apply project filter early
-    if (options.project && meta.project !== options.project) continue;
-
-    // Read live status file
-    let statusData: NaxStatusFile | null = null;
-    try {
-      statusData = await Bun.file(meta.statusPath).json();
-    } catch {
-      // statusPath missing or unreadable — handled gracefully below
-    }
-
-    const runStatus = statusData ? statusData.run.status : "[unavailable]";
-
-    // Apply status filter
-    if (options.status && runStatus !== options.status) continue;
-
-    rows.push({
-      runId: meta.runId,
-      project: meta.project,
-      feature: meta.feature,
-      status: runStatus,
-      passed: statusData?.progress.passed ?? 0,
-      total: statusData?.progress.total ?? 0,
-      durationMs: statusData?.durationMs ?? 0,
-      registeredAt: meta.registeredAt,
-    });
-  }
-
-  // Sort newest first
-  rows.sort((a, b) => new Date(b.registeredAt).getTime() - new Date(a.registeredAt).getTime());
-
-  // Apply limit
-  const limit = options.last ?? DEFAULT_LIMIT;
-  const displayed = rows.slice(0, limit);
-
-  if (displayed.length === 0) {
-    console.log("No runs found.");
-    return;
-  }
-
-  // Column widths (minimum per header)
-  const COL = {
-    runId: Math.max(6, ...displayed.map((r) => r.runId.length)),
-    project: Math.max(7, ...displayed.map((r) => r.project.length)),
-    feature: Math.max(7, ...displayed.map((r) => r.feature.length)),
-    status: Math.max(6, ...displayed.map((r) => visibleLength(r.status))),
-    stories: 7,
-    duration: 8,
-    date: 11,
-  };
-
-  // Header
-  const header = [
-    pad(chalk.bold("RUN ID"), COL.runId),
-    pad(chalk.bold("PROJECT"), COL.project),
-    pad(chalk.bold("FEATURE"), COL.feature),
-    pad(chalk.bold("STATUS"), COL.status),
-    pad(chalk.bold("STORIES"), COL.stories),
-    pad(chalk.bold("DURATION"), COL.duration),
-    chalk.bold("DATE"),
-  ].join("  ");
-
-  console.log();
-  console.log(header);
-  console.log(
-    chalk.dim("-".repeat(COL.runId + COL.project + COL.feature + COL.status + COL.stories + COL.duration + 11 + 12)),
-  );
-
-  for (const row of displayed) {
-    const colored = colorStatus(row.status);
-    const line = [
-      pad(row.runId, COL.runId),
-      pad(row.project, COL.project),
-      pad(row.feature, COL.feature),
-      pad(colored, COL.status + (colored.length - visibleLength(colored))),
-      pad(`${row.passed}/${row.total}`, COL.stories),
-      pad(formatDuration(row.durationMs), COL.duration),
-      formatDate(row.registeredAt),
-    ].join("  ");
-    console.log(line);
-  }
-
-  console.log();
-  if (rows.length > limit) {
-    console.log(chalk.dim(`Showing ${limit} of ${rows.length} runs. Use --last <N> to see more.`));
-    console.log();
-  }
-}

package/src/commands/unlock.ts

@@ -1,96 +0,0 @@
-/**
- * Unlock command implementation
- *
- * Releases stale locks from crashed nax processes.
- * Checks if lock-holding process is still alive before removing.
- */
-
-import { join } from "node:path";
-import chalk from "chalk";
-
-/**
- * Options for unlock command
- */
-export interface UnlockOptions {
-  /** Explicit project directory (from -d flag) */
-  dir?: string;
-  /** Force unlock without liveness check (from --force flag) */
-  force?: boolean;
-}
-
-/**
- * Check if a process with given PID is still alive
- */
-function isProcessAlive(pid: number): boolean {
-  try {
-    // kill(pid, 0) checks if process exists without actually sending a signal
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Format lock age in minutes
- */
-function formatLockAge(ageMs: number): string {
-  const minutes = Math.round(ageMs / (60 * 1000));
-  return `${minutes} min`;
-}
-
-/**
- * Run unlock command
- *
- * Reads nax.lock, checks if holding process is alive, and removes lock if safe.
- * Exits with code 0 on success, 1 on failure.
- */
-export async function unlockCommand(options: UnlockOptions): Promise<void> {
-  const workdir = options.dir ?? process.cwd();
-  const lockPath = join(workdir, "nax.lock");
-
-  // Check if lock file exists
-  const lockFile = Bun.file(lockPath);
-  const exists = await lockFile.exists();
-
-  if (!exists) {
-    console.log("No lock file found");
-    process.exit(0);
-  }
-
-  // Read lock file
-  let lockData: { pid: number; timestamp: number };
-  try {
-    const lockContent = await lockFile.text();
-    lockData = JSON.parse(lockContent);
-  } catch (error) {
-    console.error(chalk.red("Failed to parse lock file"));
-    process.exit(1);
-  }
-
-  const { pid, timestamp } = lockData;
-  const ageMs = Date.now() - timestamp;
-
-  // Check if process is alive (unless --force)
-  if (!options.force) {
-    if (isProcessAlive(pid)) {
-      console.error(chalk.red(`nax is still running (PID ${pid}). Use --force to override.`));
-      process.exit(1);
-    }
-  }
-
-  // Print lock info before removing
-  console.log(`Stale lock found (PID ${pid}, age: ${formatLockAge(ageMs)})`);
-
-  // Remove lock file
-  const proc = Bun.spawn(["rm", lockPath], { stdout: "pipe" });
-  const rmExitCode = await proc.exited;
-  if (rmExitCode !== 0) {
-    console.error(chalk.red(`Failed to remove lock: rm exited with code ${rmExitCode}`));
-    process.exit(1);
-  }
-  // Wait a bit for filesystem to sync (prevents race in tests)
-  await Bun.sleep(10);
-  console.log("Lock removed");
-  process.exit(0);
-}

package/src/config/defaults.ts

@@ -1,217 +0,0 @@
-/**
- * Default Configuration
- *
- * The default NaxConfig used as a base for all projects.
- */
-
-import type { NaxConfig } from "./types";
-
-/** Default configuration */
-export const DEFAULT_CONFIG: NaxConfig = {
-  version: 1,
-  models: {
-    fast: { provider: "anthropic", model: "haiku" },
-    balanced: { provider: "anthropic", model: "sonnet" },
-    powerful: { provider: "anthropic", model: "opus" },
-  },
-  autoMode: {
-    enabled: true,
-    defaultAgent: "claude",
-    fallbackOrder: ["claude", "codex", "opencode", "gemini"],
-    complexityRouting: {
-      simple: "fast",
-      medium: "balanced",
-      complex: "powerful",
-      expert: "powerful",
-    },
-    escalation: {
-      enabled: true,
-      tierOrder: [
-        { tier: "fast", attempts: 5 },
-        { tier: "balanced", attempts: 3 },
-        { tier: "powerful", attempts: 2 },
-      ],
-      escalateEntireBatch: true,
-    },
-  },
-  routing: {
-    strategy: "keyword",
-    adaptive: {
-      minSamples: 10,
-      costThreshold: 0.8,
-      fallbackStrategy: "llm",
-    },
-    llm: {
-      model: "fast",
-      fallbackToKeywords: true,
-      cacheDecisions: true,
-      mode: "hybrid",
-      timeoutMs: 15000,
-    },
-  },
-  execution: {
-    maxIterations: 10, // auto-calculated: sum of tier attempts (5+3+2=10)
-    iterationDelayMs: 2000,
-    costLimit: 5.0,
-    sessionTimeoutSeconds: 600, // 10 minutes
-    verificationTimeoutSeconds: 300, // 5 minutes
-    maxStoriesPerFeature: 500,
-    rectification: {
-      enabled: true,
-      maxRetries: 2,
-      fullSuiteTimeoutSeconds: 120,
-      maxFailureSummaryChars: 2000,
-      abortOnIncreasingFailures: true,
-    },
-    regressionGate: {
-      enabled: true,
-      timeoutSeconds: 120,
-      acceptOnTimeout: true,
-      maxRectificationAttempts: 2,
-    },
-    contextProviderTokenBudget: 2000,
-    smartTestRunner: true,
-  },
-  quality: {
-    requireTypecheck: true,
-    requireLint: true,
-    requireTests: true,
-    commands: {},
-    forceExit: false,
-    detectOpenHandles: true,
-    detectOpenHandlesRetries: 1,
-    gracePeriodMs: 5000,
-    drainTimeoutMs: 2000,
-    shell: "/bin/sh",
-    stripEnvVars: [
-      // Agent detection markers
-      "CLAUDECODE",
-      "REPL_ID",
-      "AGENT",
-      // Source control tokens
-      "GITLAB_ACCESS_TOKEN",
-      "GITHUB_TOKEN",
-      "GITHUB_ACCESS_TOKEN",
-      "GH_TOKEN",
-      "CI_GIT_TOKEN",
-      "CI_JOB_TOKEN",
-      "BITBUCKET_ACCESS_TOKEN",
-      // Package registry tokens
-      "NPM_TOKEN",
-      "NPM_AUTH_TOKEN",
-      "YARN_NPM_AUTH_TOKEN",
-      // LLM API keys (agent gets these via allowlist in buildAllowedEnv; test runners don't need them)
-      "ANTHROPIC_API_KEY",
-      "OPENAI_API_KEY",
-      "GEMINI_API_KEY",
-      "COHERE_API_KEY",
-      // Cloud / infra credentials
-      "AWS_ACCESS_KEY_ID",
-      "AWS_SECRET_ACCESS_KEY",
-      "AWS_SESSION_TOKEN",
-      "GOOGLE_APPLICATION_CREDENTIALS",
-      "GCLOUD_SERVICE_KEY",
-      "AZURE_CLIENT_SECRET",
-      "AZURE_TENANT_ID",
-      // CI secrets
-      "TELEGRAM_BOT_TOKEN",
-      "SLACK_TOKEN",
-      "SLACK_WEBHOOK_URL",
-      "SENTRY_AUTH_TOKEN",
-      "DATADOG_API_KEY",
-    ],
-    environmentalEscalationDivisor: 2,
-    testing: {
-      hermetic: true,
-    },
-  },
-  tdd: {
-    maxRetries: 2,
-    autoVerifyIsolation: true,
-    autoApproveVerifier: true,
-    strategy: "auto",
-    sessionTiers: {
-      testWriter: "balanced",
-      // implementer: undefined = uses story's routed tier
-      verifier: "fast",
-    },
-    testWriterAllowedPaths: ["src/index.ts", "src/**/index.ts"],
-    rollbackOnFailure: true,
-    greenfieldDetection: true,
-  },
-  constitution: {
-    enabled: true,
-    path: "constitution.md",
-    maxTokens: 2000,
-  },
-  analyze: {
-    llmEnhanced: true,
-    model: "balanced",
-    fallbackToKeywords: true,
-    maxCodebaseSummaryTokens: 5000,
-  },
-  review: {
-    enabled: true,
-    checks: ["typecheck", "lint"],
-    commands: {},
-    pluginMode: "per-story",
-  },
-  plan: {
-    model: "balanced",
-    outputPath: "spec.md",
-  },
-  acceptance: {
-    enabled: true,
-    maxRetries: 2,
-    generateTests: true,
-    testPath: "acceptance.test.ts",
-    model: "fast" as const,
-    refinement: true,
-    redGate: true,
-  },
-  context: {
-    fileInjection: "disabled",
-    testCoverage: {
-      enabled: true,
-      detail: "names-and-counts",
-      maxTokens: 500,
-      testPattern: "**/*.test.{ts,js,tsx,jsx}",
-      scopeToStory: true,
-    },
-    autoDetect: {
-      enabled: true,
-      maxFiles: 5,
-      traceImports: false,
-    },
-  },
-  interaction: {
-    plugin: "cli",
-    config: {},
-    defaults: {
-      timeout: 600000, // 10 minutes
-      fallback: "escalate",
-    },
-    triggers: {
-      "security-review": true,
-      "cost-warning": true,
-    },
-  },
-  precheck: {
-    storySizeGate: {
-      enabled: true,
-      maxAcCount: 6,
-      maxDescriptionLength: 2000,
-      maxBulletPoints: 8,
-    },
-  },
-  prompts: {},
-  // agent: intentionally omitted — cli is the default when no agent config is set
-  decompose: {
-    trigger: "auto",
-    maxAcceptanceCriteria: 6,
-    maxSubstories: 5,
-    maxSubstoryComplexity: "medium",
-    maxRetries: 2,
-    model: "balanced",
-  },
-};

package/src/config/index.ts

@@ -1,22 +0,0 @@
-export type {
-  NaxConfig,
-  Complexity,
-  TestStrategy,
-  TddStrategy,
-  ModelTier,
-  ModelDef,
-  ModelEntry,
-  ModelMap,
-  AutoModeConfig,
-  ExecutionConfig,
-  QualityConfig,
-  TddConfig,
-  TierConfig,
-  RectificationConfig,
-} from "./schema";
-export { DEFAULT_CONFIG, resolveModel, NaxConfigSchema, AcceptanceConfigSchema } from "./schema";
-export { loadConfig, findProjectDir, globalConfigPath } from "./loader";
-export { validateConfig, type ValidationResult } from "./validate"; // @deprecated: Use NaxConfigSchema.safeParse() instead
-export { validateDirectory, validateFilePath, isWithinDirectory, MAX_DIRECTORY_DEPTH } from "./path-security";
-export { globalConfigDir, projectConfigDir } from "./paths";
-export { deepMergeConfig } from "./merger";

package/src/config/loader.ts

@@ -1,143 +0,0 @@
-/**
- * Configuration Loader
- *
- * Merges global + project config with defaults.
- */
-
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { getLogger } from "../logger";
-import { loadJsonFile } from "../utils/json-file";
-import { mergePackageConfig } from "./merge";
-import { deepMergeConfig } from "./merger";
-import { MAX_DIRECTORY_DEPTH } from "./path-security";
-import { globalConfigDir } from "./paths";
-import { DEFAULT_CONFIG, type NaxConfig, NaxConfigSchema } from "./schema";
-
-/** Global config path */
-export function globalConfigPath(): string {
-  return join(globalConfigDir(), "config.json");
-}
-
-/** Find project nax directory (walks up from cwd) */
-export function findProjectDir(startDir: string = process.cwd()): string | null {
-  let dir = resolve(startDir);
-  let depth = 0;
-
-  while (depth < MAX_DIRECTORY_DEPTH) {
-    const candidate = join(dir, "nax");
-    if (existsSync(join(candidate, "config.json"))) {
-      return candidate;
-    }
-    const parent = join(dir, "..");
-    if (parent === dir) break; // Root reached
-    dir = parent;
-    depth++;
-  }
-
-  return null;
-}
-
-/** @internal Backward compat: map deprecated routing.llm.batchMode to routing.llm.mode.
- * Returns a new object (immutable -- does not mutate the input). */
-function applyBatchModeCompat(conf: Record<string, unknown>): Record<string, unknown> {
-  const routing = conf.routing as Record<string, unknown> | undefined;
-  const llm = routing?.llm as Record<string, unknown> | undefined;
-  if (llm && "batchMode" in llm && !("mode" in llm)) {
-    const batchMode = llm.batchMode;
-    if (typeof batchMode === "boolean") {
-      const mappedMode = batchMode ? "one-shot" : "per-story";
-      try {
-        getLogger().warn(
-          "config",
-          `routing.llm.batchMode is deprecated and will be removed in v1.0. Mapped to mode="${mappedMode}". Update your config to use routing.llm.mode instead.`,
-        );
-      } catch {
-        /* logger may not be init yet */
-      }
-      return {
-        ...conf,
-        routing: {
-          ...routing,
-          llm: { ...llm, mode: mappedMode },
-        },
-      };
-    }
-  }
-  return conf;
-}
-
-/** Load merged configuration (defaults < global < project < CLI overrides) */
-export async function loadConfig(projectDir?: string, cliOverrides?: Record<string, unknown>): Promise<NaxConfig> {
-  // Start with defaults as a plain object
-  let rawConfig: Record<string, unknown> = structuredClone(DEFAULT_CONFIG as unknown as Record<string, unknown>);
-
-  // Layer 1: Global config (~/.nax/config.json)
-  const globalConfRaw = await loadJsonFile<Record<string, unknown>>(globalConfigPath(), "config");
-  if (globalConfRaw) {
-    // Backward compatibility: apply batchMode->mode shim before merge so defaults don't shadow it
-    const globalConf = applyBatchModeCompat(globalConfRaw);
-    rawConfig = deepMergeConfig(rawConfig, globalConf);
-  }
-
-  // Layer 2: Project config (nax/config.json)
-  const projDir = projectDir ?? findProjectDir();
-  if (projDir) {
-    const projConf = await loadJsonFile<Record<string, unknown>>(join(projDir, "config.json"), "config");
-    if (projConf) {
-      // Backward compatibility: map deprecated batchMode -> mode on raw user config
-      // MUST run before deepMergeConfig so defaults don't shadow the check.
-      const resolvedProjConf = applyBatchModeCompat(projConf);
-      rawConfig = deepMergeConfig(rawConfig, resolvedProjConf);
-    }
-  }
-
-  // Layer 3: CLI overrides (highest priority)
-  if (cliOverrides) {
-    rawConfig = deepMergeConfig(rawConfig, cliOverrides);
-  }
-
-  // Parse and validate with Zod
-  const result = NaxConfigSchema.safeParse(rawConfig);
-  if (!result.success) {
-    const errors = result.error.issues.map((err) => {
-      const path = String(err.path.join("."));
-      return path ? `${path}: ${err.message}` : err.message;
-    });
-    throw new Error(`Invalid configuration:\n${errors.join("\n")}`);
-  }
-
-  return result.data as NaxConfig;
-}
-
-/**
- * Load config for a specific working directory (monorepo package).
- *
- * Resolution order:
- * 1. Load root nax/config.json via loadConfig()
- * 2. If packageDir is set, check <repoRoot>/<packageDir>/nax/config.json
- * 3. If package config exists → merge quality.commands over root
- * 4. Return merged config
- *
- * @param rootConfigPath - Absolute path to the root nax/config.json
- * @param packageDir - Package directory relative to repo root (e.g. "packages/api")
- */
-export async function loadConfigForWorkdir(rootConfigPath: string, packageDir?: string): Promise<NaxConfig> {
-  const rootNaxDir = dirname(rootConfigPath);
-  const rootConfig = await loadConfig(rootNaxDir);
-
-  if (!packageDir) {
-    return rootConfig;
-  }
-
-  const repoRoot = dirname(rootNaxDir);
-  const packageConfigPath = join(repoRoot, packageDir, "nax", "config.json");
-
-  const packageOverride = await loadJsonFile<Partial<NaxConfig>>(packageConfigPath, "config");
-
-  if (!packageOverride) {
-    return rootConfig;
-  }
-
-  return mergePackageConfig(rootConfig, packageOverride);
-}