@nathapp/nax 0.50.3 → 0.51.0

package/src/acceptance/templates/cli.ts

@@ -1,47 +0,0 @@
-/**
- * CLI test template builder
- *
- * Generates acceptance test structure for CLI testing strategy.
- * Uses Bun.spawn to run the binary and asserts on stdout text.
- */
-
-import type { AcceptanceCriterion } from "../types";
-
-export interface CliTemplateOptions {
-  featureName: string;
-  criteria: AcceptanceCriterion[];
-}
-
-/**
- * Build CLI test template code for the given criteria.
- *
- * @param options - Feature name and criteria list
- * @returns TypeScript test code string
- */
-export function buildCliTemplate(options: CliTemplateOptions): string {
-  const { featureName, criteria } = options;
-
-  const tests = criteria
-    .map(
-      (ac) => `  test("${ac.id}: ${ac.text}", async () => {
-    const proc = Bun.spawn(["bun", "run", "src/${featureName}.ts"], {
-      stdout: "pipe",
-      stderr: "pipe",
-    });
-    const [exitCode, stdout] = await Promise.all([
-      proc.exited,
-      new Response(proc.stdout).text(),
-    ]);
-    expect(exitCode).toBe(0);
-    expect(stdout).toContain(""); // Replace with expected stdout text
-  });`,
-    )
-    .join("\n\n");
-
-  return `import { describe, expect, test } from "bun:test";
-
-describe("${featureName} - Acceptance Tests", () => {
-${tests}
-});
-`;
-}

package/src/acceptance/templates/component.ts

@@ -1,78 +0,0 @@
-/**
- * Component test template builder
- *
- * Generates acceptance test structure for component testing strategy.
- * Supports ink-testing-library (lastFrame) and react (screen.getByText).
- */
-
-import type { AcceptanceCriterion } from "../types";
-
-export interface ComponentTemplateOptions {
-  featureName: string;
-  criteria: AcceptanceCriterion[];
-  /** Test framework: 'ink-testing-library' | 'react' */
-  testFramework?: string;
-}
-
-/**
- * Build component test template code for the given criteria.
- *
- * @param options - Feature name, criteria, and test framework
- * @returns TypeScript test code string
- */
-export function buildComponentTemplate(options: ComponentTemplateOptions): string {
-  const { featureName, criteria, testFramework = "ink-testing-library" } = options;
-
-  if (testFramework === "react") {
-    return buildReactTemplate(featureName, criteria);
-  }
-
-  return buildInkTemplate(featureName, criteria);
-}
-
-function buildInkTemplate(featureName: string, criteria: AcceptanceCriterion[]): string {
-  const tests = criteria
-    .map(
-      (ac) => `  test("${ac.id}: ${ac.text}", () => {
-    const { lastFrame } = render(<${toPascalCase(featureName)} />);
-    expect(lastFrame()).toContain(""); // Replace with expected output
-  });`,
-    )
-    .join("\n\n");
-
-  return `import { describe, expect, test } from "bun:test";
-import { render } from "ink-testing-library";
-import { ${toPascalCase(featureName)} } from "../src/${featureName}";
-
-describe("${featureName} - Acceptance Tests", () => {
-${tests}
-});
-`;
-}
-
-function buildReactTemplate(featureName: string, criteria: AcceptanceCriterion[]): string {
-  const tests = criteria
-    .map(
-      (ac) => `  test("${ac.id}: ${ac.text}", () => {
-    render(<${toPascalCase(featureName)} />);
-    expect(screen.getByText("")).toBeTruthy(); // Replace with expected text
-  });`,
-    )
-    .join("\n\n");
-
-  return `import { describe, expect, test } from "bun:test";
-import { render, screen } from "@testing-library/react";
-import { ${toPascalCase(featureName)} } from "../src/${featureName}";
-
-describe("${featureName} - Acceptance Tests", () => {
-${tests}
-});
-`;
-}
-
-function toPascalCase(name: string): string {
-  return name
-    .split(/[-_\s]+/)
-    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-    .join("");
-}

package/src/acceptance/templates/e2e.ts

@@ -1,43 +0,0 @@
-/**
- * E2E test template builder
- *
- * Generates acceptance test structure for end-to-end testing strategy.
- * Uses fetch() against localhost and asserts on response body.
- */
-
-import type { AcceptanceCriterion } from "../types";
-
-export interface E2eTemplateOptions {
-  featureName: string;
-  criteria: AcceptanceCriterion[];
-}
-
-const DEFAULT_PORT = 3000;
-
-/**
- * Build E2E test template code for the given criteria.
- *
- * @param options - Feature name and criteria list
- * @returns TypeScript test code string
- */
-export function buildE2eTemplate(options: E2eTemplateOptions): string {
-  const { featureName, criteria } = options;
-
-  const tests = criteria
-    .map(
-      (ac) => `  test("${ac.id}: ${ac.text}", async () => {
-    const response = await fetch("http://localhost:${DEFAULT_PORT}/api/${featureName}");
-    expect(response.ok).toBe(true);
-    const body = await response.text();
-    expect(body).toContain(""); // Replace with expected response body
-  });`,
-    )
-    .join("\n\n");
-
-  return `import { describe, expect, test } from "bun:test";
-
-describe("${featureName} - Acceptance Tests", () => {
-${tests}
-});
-`;
-}

package/src/acceptance/templates/index.ts

@@ -1,21 +0,0 @@
-/**
- * Acceptance Test Template Builders
- *
- * One builder per test strategy. The generator selects the appropriate
- * builder based on the testStrategy option.
- */
-
-export { buildUnitTemplate } from "./unit";
-export type { UnitTemplateOptions } from "./unit";
-
-export { buildComponentTemplate } from "./component";
-export type { ComponentTemplateOptions } from "./component";
-
-export { buildCliTemplate } from "./cli";
-export type { CliTemplateOptions } from "./cli";
-
-export { buildE2eTemplate } from "./e2e";
-export type { E2eTemplateOptions } from "./e2e";
-
-export { buildSnapshotTemplate } from "./snapshot";
-export type { SnapshotTemplateOptions } from "./snapshot";

package/src/acceptance/templates/snapshot.ts

@@ -1,50 +0,0 @@
-/**
- * Snapshot test template builder
- *
- * Generates acceptance test structure for snapshot testing strategy.
- * Renders the component and uses toMatchSnapshot() for assertions.
- */
-
-import type { AcceptanceCriterion } from "../types";
-
-export interface SnapshotTemplateOptions {
-  featureName: string;
-  criteria: AcceptanceCriterion[];
-  /** Test framework: 'ink-testing-library' | 'react' */
-  testFramework?: string;
-}
-
-/**
- * Build snapshot test template code for the given criteria.
- *
- * @param options - Feature name, criteria, and optional test framework
- * @returns TypeScript test code string
- */
-export function buildSnapshotTemplate(options: SnapshotTemplateOptions): string {
-  const { featureName, criteria } = options;
-
-  const tests = criteria
-    .map(
-      (ac) => `  test("${ac.id}: ${ac.text}", () => {
-    const { lastFrame } = render(<${toPascalCase(featureName)} />);
-    expect(lastFrame()).toMatchSnapshot();
-  });`,
-    )
-    .join("\n\n");
-
-  return `import { describe, expect, test } from "bun:test";
-import { render } from "ink-testing-library";
-import { ${toPascalCase(featureName)} } from "../src/${featureName}";
-
-describe("${featureName} - Acceptance Tests", () => {
-${tests}
-});
-`;
-}
-
-function toPascalCase(name: string): string {
-  return name
-    .split(/[-_\s]+/)
-    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-    .join("");
-}

package/src/acceptance/templates/unit.ts

@@ -1,48 +0,0 @@
-/**
- * Unit test template builder
- *
- * Generates acceptance test structure for unit testing strategy:
- * imports the function under test, calls it, and asserts on the return value.
- */
-
-import type { AcceptanceCriterion } from "../types";
-
-export interface UnitTemplateOptions {
-  featureName: string;
-  criteria: AcceptanceCriterion[];
-}
-
-/**
- * Build unit test template code for the given criteria.
- *
- * @param options - Feature name and criteria list
- * @returns TypeScript test code string
- */
-export function buildUnitTemplate(options: UnitTemplateOptions): string {
-  const { featureName, criteria } = options;
-
-  const tests = criteria
-    .map(
-      (ac) => `  test("${ac.id}: ${ac.text}", async () => {
-    // TODO: import and call the function under test
-    expect(true).toBe(true); // Replace with real assertion
-  });`,
-    )
-    .join("\n\n");
-
-  return `import { describe, expect, test } from "bun:test";
-import { ${toCamelCase(featureName)} } from "../src/${toKebabCase(featureName)}";
-
-describe("${featureName} - Acceptance Tests", () => {
-${tests}
-});
-`;
-}
-
-function toCamelCase(name: string): string {
-  return name.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());
-}
-
-function toKebabCase(name: string): string {
-  return name.toLowerCase().replace(/\s+/g, "-");
-}

package/src/acceptance/types.ts

@@ -1,138 +0,0 @@
-/**
- * Acceptance Test Generation Types
- *
- * Types for generating acceptance tests from spec.md acceptance criteria.
- */
-
-import type { AgentAdapter } from "../agents/types";
-import type { AcceptanceTestStrategy, ModelDef, ModelTier, NaxConfig } from "../config/schema";
-
-/**
- * A single refined acceptance criterion produced by the refinement module.
- */
-export interface RefinedCriterion {
-  /** The original criterion text from the PRD */
-  original: string;
-  /** Concrete, machine-verifiable description produced by LLM */
-  refined: string;
-  /** False if the LLM determines the criterion cannot be automatically tested */
-  testable: boolean;
-  /** The story ID this criterion belongs to */
-  storyId: string;
-}
-
-/**
- * Context passed to refineAcceptanceCriteria.
- */
-export interface RefinementContext {
-  /** Story ID for attribution on each RefinedCriterion */
-  storyId: string;
-  /** Codebase context string (file tree, dependencies, etc.) */
-  codebaseContext: string;
-  /** Global config — model tier resolved from config.acceptance.model */
-  config: NaxConfig;
-  /** Test strategy — controls strategy-specific prompt instructions */
-  testStrategy?: AcceptanceTestStrategy;
-  /** Test framework — informs LLM which testing library syntax to use */
-  testFramework?: string;
-}
-
-/**
- * A single acceptance criterion extracted from spec.md.
- *
- * @example
- * ```ts
- * const ac: AcceptanceCriterion = {
- *   id: "AC-2",
- *   text: "set(key, value, ttl) expires after ttl milliseconds",
- *   lineNumber: 42,
- * };
- * ```
- */
-export interface AcceptanceCriterion {
-  /** AC identifier (e.g., "AC-1", "AC-2") */
-  id: string;
-  /** Full criterion text */
-  text: string;
-  /** Line number in spec.md for reference */
-  lineNumber: number;
-}
-
-/**
- * Options for generating acceptance tests.
- *
- * @example
- * ```ts
- * const options: GenerateAcceptanceTestsOptions = {
- *   specContent: "# Feature\n\n## Acceptance Criteria\n- AC-1: ...",
- *   featureName: "url-shortener",
- *   workdir: "/home/user/project",
- *   codebaseContext: "File tree:\nsrc/\n  index.ts\n",
- *   modelTier: "balanced",
- *   modelDef: { provider: "anthropic", model: "claude-sonnet-4-5" },
- * };
- * ```
- */
-/**
- * Options for generating acceptance tests from PRD stories and refined criteria.
- */
-export interface GenerateFromPRDOptions {
-  /** Feature name for context */
-  featureName: string;
-  /** Working directory for context scanning */
-  workdir: string;
-  /** Feature directory where acceptance-refined.json is written */
-  featureDir: string;
-  /** Codebase context (file tree, dependencies, test patterns) */
-  codebaseContext: string;
-  /** Model tier to use for test generation */
-  modelTier: ModelTier;
-  /** Resolved model definition */
-  modelDef: ModelDef;
-  /** Global config for quality settings */
-  config: NaxConfig;
-  /** Test strategy to use for template selection (default: 'unit') */
-  testStrategy?: AcceptanceTestStrategy;
-  /** Test framework for component/snapshot strategies (e.g. 'ink-testing-library', 'react') */
-  testFramework?: string;
-  /** Agent adapter to use for test generation — overrides _generatorPRDDeps.adapter */
-  adapter?: AgentAdapter;
-}
-
-export interface GenerateAcceptanceTestsOptions {
-  /** Full spec.md content */
-  specContent: string;
-  /** Feature name for context */
-  featureName: string;
-  /** Working directory for context scanning */
-  workdir: string;
-  /** Codebase context (file tree, dependencies, test patterns) */
-  codebaseContext: string;
-  /** Model tier to use for test generation */
-  modelTier: ModelTier;
-  /** Resolved model definition */
-  modelDef: ModelDef;
-  /** Global config for quality settings */
-  config: NaxConfig;
-}
-
-/**
- * Result from acceptance test generation.
- *
- * @example
- * ```ts
- * const result: AcceptanceTestResult = {
- *   testCode: 'import { describe, test, expect } from "bun:test";\n\n...',
- *   criteria: [
- *     { id: "AC-1", text: "TTL expires", lineNumber: 12 },
- *     { id: "AC-2", text: "set(key, value, ttl) expires after ttl", lineNumber: 13 },
- *   ],
- * };
- * ```
- */
-export interface AcceptanceTestResult {
-  /** Generated test code */
-  testCode: string;
-  /** Acceptance criteria that were processed */
-  criteria: AcceptanceCriterion[];
-}