@nathapp/nax 0.50.3 → 0.51.0

package/src/cli/diagnose.ts

@@ -1,203 +0,0 @@
-/**
- * Diagnose Command
- *
- * Reads run artifacts and produces structured diagnosis report.
- * Pure pattern matching -- no LLM calls, no agents.
- */
-
-import { existsSync, readdirSync } from "node:fs";
-import { join } from "node:path";
-import { findProjectDir } from "../config";
-import type { NaxStatusFile } from "../execution/status-file";
-import { getLogger } from "../logger";
-import { loadPRD } from "../prd";
-import { diagnoseStories, generateRecommendations } from "./diagnose-analysis";
-import { formatReport } from "./diagnose-formatter";
-
-export interface DiagnoseOptions {
-  feature?: string;
-  workdir?: string;
-  json?: boolean;
-  verbose?: boolean;
-}
-
-export type FailurePattern =
-  | "GREENFIELD_TDD"
-  | "TEST_MISMATCH"
-  | "ENVIRONMENTAL"
-  | "RATE_LIMITED"
-  | "ISOLATION_VIOLATION"
-  | "MAX_TIERS_EXHAUSTED"
-  | "SESSION_CRASH"
-  | "STALLED"
-  | "LOCK_STALE"
-  | "AUTO_RECOVERED"
-  | "UNKNOWN";
-
-export interface StoryDiagnosis {
-  storyId: string;
-  title: string;
-  status: string;
-  attempts: number;
-  tier?: string;
-  strategy?: string;
-  pattern: FailurePattern;
-  symptom?: string;
-  fixSuggestion?: string;
-}
-
-export interface LockCheck {
-  lockPresent: boolean;
-  pidAlive?: boolean;
-  pid?: number;
-  fixCommand?: string;
-}
-
-export interface DiagnosisReport {
-  runSummary: {
-    feature: string;
-    lastRunTime?: string;
-    status: string;
-    storiesPassed: number;
-    storiesFailed: number;
-    storiesPending: number;
-    cost?: number;
-    commitsProduced: number;
-  };
-  storyBreakdown: StoryDiagnosis[];
-  failureAnalysis: StoryDiagnosis[];
-  lockCheck: LockCheck;
-  recommendations: string[];
-  dataSources: {
-    prdFound: boolean;
-    statusFound: boolean;
-    eventsFound: boolean;
-    gitLogFound: boolean;
-  };
-}
-
-function isProcessAlive(pid: number): boolean {
-  try {
-    const result = Bun.spawnSync(["ps", "-p", String(pid)], { stdout: "ignore", stderr: "ignore" });
-    return result.exitCode === 0;
-  } catch {
-    return false;
-  }
-}
-
-async function loadStatusFile(workdir: string): Promise<NaxStatusFile | null> {
-  const statusPath = join(workdir, "nax", "status.json");
-  if (!existsSync(statusPath)) return null;
-  try {
-    return (await Bun.file(statusPath).json()) as NaxStatusFile;
-  } catch {
-    return null;
-  }
-}
-
-async function countCommitsSince(workdir: string, since?: string): Promise<number> {
-  if (!since) return 0;
-  try {
-    const result = Bun.spawnSync(["git", "log", "--oneline", `--since=${since}`, "--all"], {
-      cwd: workdir,
-      stdout: "pipe",
-      stderr: "ignore",
-    });
-    if (result.exitCode !== 0) return 0;
-    const output = new TextDecoder().decode(result.stdout);
-    return output
-      .trim()
-      .split("\n")
-      .filter((line) => line.length > 0).length;
-  } catch {
-    return 0;
-  }
-}
-
-async function checkLock(workdir: string): Promise<LockCheck> {
-  const lockFile = Bun.file(join(workdir, "nax.lock"));
-  if (!(await lockFile.exists())) return { lockPresent: false };
-  try {
-    const lockData = JSON.parse(await lockFile.text());
-    const pid = lockData.pid;
-    const pidAlive = isProcessAlive(pid);
-    if (!pidAlive) return { lockPresent: true, pidAlive: false, pid, fixCommand: "rm nax.lock" };
-    return { lockPresent: true, pidAlive: true, pid };
-  } catch {
-    return { lockPresent: true };
-  }
-}
-
-/** Run diagnose command */
-export async function diagnoseCommand(options: DiagnoseOptions = {}): Promise<void> {
-  const logger = getLogger();
-  const workdir = options.workdir ?? process.cwd();
-
-  const naxSubdir = findProjectDir(workdir);
-  let projectDir: string | null = naxSubdir ? join(naxSubdir, "..") : null;
-  if (!projectDir && existsSync(join(workdir, "nax"))) {
-    projectDir = workdir;
-  }
-  if (!projectDir) throw new Error("Not in a nax project directory");
-
-  let feature = options.feature;
-  if (!feature) {
-    const status = await loadStatusFile(projectDir);
-    if (status) {
-      feature = status.run.feature;
-    } else {
-      const featuresDir = join(projectDir, "nax", "features");
-      if (!existsSync(featuresDir)) throw new Error("No features found in project");
-      const features = readdirSync(featuresDir, { withFileTypes: true })
-        .filter((e) => e.isDirectory())
-        .map((e) => e.name);
-      if (features.length === 0) throw new Error("No features found");
-      feature = features[0];
-      logger.info("diagnose", "No feature specified, using first found", { feature });
-    }
-  }
-
-  const featureDir = join(projectDir, "nax", "features", feature);
-  const prdPath = join(featureDir, "prd.json");
-  if (!existsSync(prdPath)) throw new Error(`Feature not found: ${feature}`);
-
-  const prd = await loadPRD(prdPath);
-  const status = await loadStatusFile(projectDir);
-  const lockCheck = await checkLock(projectDir);
-  const commitCount = await countCommitsSince(projectDir, status?.run.startedAt);
-
-  const { storyBreakdown, failureAnalysis } = diagnoseStories(prd, status);
-
-  const report: DiagnosisReport = {
-    runSummary: {
-      feature,
-      lastRunTime: status?.run.startedAt,
-      status: status?.run.status ?? "unknown",
-      storiesPassed: prd.userStories.filter((s) => s.status === "passed").length,
-      storiesFailed: prd.userStories.filter((s) => s.status === "failed").length,
-      storiesPending: prd.userStories.filter(
-        (s) => s.status !== "passed" && s.status !== "failed" && s.status !== "skipped",
-      ).length,
-      cost: status?.cost.spent,
-      commitsProduced: commitCount,
-    },
-    storyBreakdown,
-    failureAnalysis,
-    lockCheck,
-    recommendations: [],
-    dataSources: {
-      prdFound: true,
-      statusFound: status !== null,
-      eventsFound: false,
-      gitLogFound: commitCount > 0,
-    },
-  };
-
-  report.recommendations = generateRecommendations(report);
-
-  if (options.json) {
-    console.log(JSON.stringify(report, null, 2));
-  } else {
-    console.log(formatReport(report, options.verbose ?? false));
-  }
-}

package/src/cli/generate.ts

@@ -1,250 +0,0 @@
-/**
- * `nax generate` CLI Command (v0.16.1)
- *
- * Generates agent-specific config files from nax/context.md + auto-injected project metadata.
- * Replaces `nax constitution generate`.
- */
-
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import chalk from "chalk";
-import { loadConfig } from "../config/loader";
-import { discoverPackages, generateAll, generateFor, generateForPackage } from "../context/generator";
-import type { AgentType } from "../context/types";
-
-/** Options for `nax generate` */
-export interface GenerateCommandOptions {
-  /** Path to context file (default: nax/context.md) */
-  context?: string;
-  /** Output directory (default: project root) */
-  output?: string;
-  /** Specific agent to generate for */
-  agent?: string;
-  /** Dry run — preview without writing */
-  dryRun?: boolean;
-  /** Disable auto-injection of project metadata */
-  noAutoInject?: boolean;
-  /**
-   * Generate for a specific package directory (relative to repo root).
-   * Reads <package>/nax/context.md, writes <package>/CLAUDE.md.
-   * @example "packages/api"
-   */
-  package?: string;
-  /**
-   * Generate for all discovered packages.
-   * Auto-discovers packages with nax/context.md up to 2 levels deep.
-   */
-  allPackages?: boolean;
-}
-
-const VALID_AGENTS: AgentType[] = ["claude", "codex", "opencode", "cursor", "windsurf", "aider", "gemini"];
-
-/**
- * `nax generate` command handler.
- */
-export async function generateCommand(options: GenerateCommandOptions): Promise<void> {
-  const workdir = process.cwd();
-  const dryRun = options.dryRun ?? false;
-
-  // Load config early — needed for all paths
-  let config: Awaited<ReturnType<typeof loadConfig>>;
-  try {
-    config = await loadConfig(workdir);
-  } catch {
-    config = {} as Awaited<ReturnType<typeof loadConfig>>;
-  }
-
-  // --all-packages: discover and generate for all packages
-  if (options.allPackages) {
-    if (dryRun) {
-      console.log(chalk.yellow("⚠ Dry run — no files will be written"));
-    }
-    console.log(chalk.blue("→ Discovering packages with nax/context.md..."));
-    const packages = await discoverPackages(workdir);
-
-    if (packages.length === 0) {
-      console.log(chalk.yellow("  No packages found (no */nax/context.md or */*/nax/context.md)"));
-      return;
-    }
-
-    console.log(chalk.blue(`→ Generating agent files for ${packages.length} package(s)...`));
-    let errorCount = 0;
-
-    for (const pkgDir of packages) {
-      const results = await generateForPackage(pkgDir, config, dryRun);
-      for (const result of results) {
-        if (result.error) {
-          console.error(chalk.red(`✗ ${pkgDir}: ${result.error}`));
-          errorCount++;
-        } else {
-          const suffix = dryRun ? " (dry run)" : "";
-          console.log(chalk.green(`✓ ${pkgDir}/${result.outputFile} (${result.content.length} bytes${suffix})`));
-        }
-      }
-    }
-
-    if (errorCount > 0) {
-      console.error(chalk.red(`\n✗ ${errorCount} generation(s) failed`));
-      process.exit(1);
-    }
-    return;
-  }
-
-  // --package: generate for a specific package
-  if (options.package) {
-    const packageDir = join(workdir, options.package);
-    if (dryRun) {
-      console.log(chalk.yellow("⚠ Dry run — no files will be written"));
-    }
-    console.log(chalk.blue(`→ Generating agent files for package: ${options.package}`));
-    const pkgResults = await generateForPackage(packageDir, config, dryRun);
-    let pkgHasError = false;
-    for (const result of pkgResults) {
-      if (result.error) {
-        console.error(chalk.red(`✗ ${result.error}`));
-        pkgHasError = true;
-      } else {
-        const suffix = dryRun ? " (dry run)" : "";
-        console.log(chalk.green(`✓ ${options.package}/${result.outputFile} (${result.content.length} bytes${suffix})`));
-      }
-    }
-    if (pkgHasError) process.exit(1);
-    return;
-  }
-
-  const contextPath = options.context ? join(workdir, options.context) : join(workdir, "nax/context.md");
-  const outputDir = options.output ? join(workdir, options.output) : workdir;
-  const autoInject = !options.noAutoInject;
-
-  // Validate context file
-  if (!existsSync(contextPath)) {
-    console.error(chalk.red(`✗ Context file not found: ${contextPath}`));
-    console.error(chalk.yellow("  Create nax/context.md first, or run `nax init` to scaffold it."));
-    process.exit(1);
-  }
-
-  // Validate agent if specified
-  if (options.agent && !VALID_AGENTS.includes(options.agent as AgentType)) {
-    console.error(chalk.red(`✗ Unknown agent: ${options.agent}`));
-    console.error(chalk.yellow(`  Valid agents: ${VALID_AGENTS.join(", ")}`));
-    process.exit(1);
-  }
-
-  if (dryRun) {
-    console.log(chalk.yellow("⚠ Dry run — no files will be written"));
-  }
-
-  console.log(chalk.blue(`→ Loading context from ${contextPath}`));
-  if (autoInject) {
-    console.log(chalk.dim("  Auto-injecting project metadata..."));
-  }
-
-  const genOptions = {
-    contextPath,
-    outputDir,
-    workdir,
-    dryRun,
-    autoInject,
-  };
-
-  try {
-    if (options.agent) {
-      // CLI --agent flag: single specific agent (overrides config)
-      const agent = options.agent as AgentType;
-      console.log(chalk.blue(`→ Generating config for ${agent}...`));
-
-      const result = await generateFor(agent, genOptions, config);
-
-      if (result.error) {
-        console.error(chalk.red(`✗ ${agent}: ${result.error}`));
-        process.exit(1);
-      }
-
-      const suffix = dryRun ? " (dry run)" : "";
-      console.log(chalk.green(`✓ ${agent} → ${result.outputFile} (${result.content.length} bytes${suffix})`));
-    } else {
-      // No --agent flag: use config.generate.agents filter, or generate all
-      let configAgents = config?.generate?.agents;
-
-      // Detect misplaced generate config (autoMode.generate.agents) and warn
-      const misplacedAgents = (config?.autoMode as unknown as Record<string, unknown> | undefined)?.generate as
-        | { agents?: string[] }
-        | undefined;
-      if (!configAgents && misplacedAgents?.agents && misplacedAgents.agents.length > 0) {
-        console.warn(
-          chalk.yellow(
-            '⚠ Warning: "generate.agents" is nested under "autoMode" in your config — it should be at the top level.',
-          ),
-        );
-        console.warn(chalk.yellow('  Move it to: { "generate": { "agents": [...] } }'));
-        configAgents = misplacedAgents.agents as Array<
-          "claude" | "codex" | "opencode" | "cursor" | "windsurf" | "aider" | "gemini"
-        >;
-      }
-
-      const agentFilter = configAgents && configAgents.length > 0 ? configAgents : null;
-
-      if (agentFilter) {
-        console.log(chalk.blue(`→ Generating configs for: ${agentFilter.join(", ")} (from config)...`));
-      } else {
-        console.log(chalk.blue("→ Generating configs for all agents..."));
-      }
-
-      // Pass agentFilter to generateAll so only matching agents are written to disk
-      const results = await generateAll(genOptions, config, agentFilter ?? undefined);
-
-      let errorCount = 0;
-
-      for (const result of results) {
-        if (result.error) {
-          console.error(chalk.red(`✗ ${result.agent}: ${result.error}`));
-          errorCount++;
-        } else {
-          const suffix = dryRun ? " (dry run)" : "";
-          console.log(
-            chalk.green(`✓ ${result.agent} → ${result.outputFile} (${result.content.length} bytes${suffix})`),
-          );
-        }
-      }
-
-      if (errorCount > 0) {
-        console.error(chalk.red(`\n✗ ${errorCount} generation(s) failed`));
-        process.exit(1);
-      }
-
-      // Auto-generate per-package agent files when packages with nax/context.md are discovered
-      const packages = await discoverPackages(workdir);
-      if (packages.length > 0) {
-        console.log(
-          chalk.blue(`\n→ Discovered ${packages.length} package(s) with nax/context.md — generating agent files...`),
-        );
-        let pkgErrorCount = 0;
-        for (const pkgDir of packages) {
-          const pkgResults = await generateForPackage(pkgDir, config, dryRun);
-          for (const result of pkgResults) {
-            if (result.error) {
-              console.error(chalk.red(`✗ ${pkgDir}: ${result.error}`));
-              pkgErrorCount++;
-            } else {
-              const suffix = dryRun ? " (dry run)" : "";
-              const rel = pkgDir.startsWith(workdir) ? pkgDir.slice(workdir.length + 1) : pkgDir;
-              console.log(chalk.green(`✓ ${rel}/${result.outputFile} (${result.content.length} bytes${suffix})`));
-            }
-          }
-        }
-        if (pkgErrorCount > 0) {
-          console.error(chalk.red(`\n✗ ${pkgErrorCount} package generation(s) failed`));
-          process.exit(1);
-        }
-      }
-    }
-
-    if (!dryRun) {
-      console.log(chalk.green(`\n✓ Agent configs written to ${outputDir}`));
-    }
-  } catch (err) {
-    const error = err instanceof Error ? err.message : String(err);
-    console.error(chalk.red(`✗ Generation failed: ${error}`));
-    process.exit(1);
-  }
-}

package/src/cli/index.ts

@@ -1,42 +0,0 @@
-/**
- * CLI Utilities
- */
-
-export { analyzeFeature } from "./analyze";
-export { planCommand } from "./plan";
-export { acceptCommand, type AcceptOptions } from "./accept";
-export {
-  displayCostMetrics,
-  displayLastRunMetrics,
-  displayModelEfficiency,
-  displayFeatureStatus,
-  type FeatureStatusOptions,
-} from "./status";
-export {
-  runsListCommand,
-  runsShowCommand,
-  type RunsListOptions,
-  type RunsShowOptions,
-} from "./runs";
-export {
-  promptsCommand,
-  promptsInitCommand,
-  exportPromptCommand,
-  type PromptsCommandOptions,
-  type PromptsInitCommandOptions,
-  type ExportPromptCommandOptions,
-} from "./prompts";
-export { initCommand, type InitOptions } from "./init";
-export { pluginsListCommand } from "./plugins";
-export { diagnoseCommand, type DiagnoseOptions } from "./diagnose";
-export {
-  interactListCommand,
-  interactRespondCommand,
-  interactCancelCommand,
-  type InteractListOptions,
-  type InteractRespondOptions,
-  type InteractCancelOptions,
-} from "./interact";
-export { generateCommand, type GenerateCommandOptions } from "./generate";
-export { configCommand, type ConfigCommandOptions } from "./config";
-export { agentsListCommand } from "./agents";