@nathapp/nax 0.50.2 → 0.51.0

package/src/context/formatter.ts

@@ -1,107 +0,0 @@
-/**
- * Context Markdown Formatter
- *
- * Extracted from builder.ts: formats built context as markdown for agent consumption.
- */
-
-import type { BuiltContext, ContextElement } from "./types";
-
-/**
- * Format built context as markdown for agent consumption.
- *
- * Generates markdown with sections for progress, prior errors,
- * test coverage, current story, dependency stories, and relevant files.
- */
-export function formatContextAsMarkdown(built: BuiltContext): string {
-  const sections: string[] = [];
-
-  sections.push("# Story Context\n");
-  sections.push(`${built.summary}\n`);
-
-  // Group by type
-  const byType = new Map<string, ContextElement[]>();
-  for (const element of built.elements) {
-    const existing = byType.get(element.type) || [];
-    existing.push(element);
-    byType.set(element.type, existing);
-  }
-
-  renderSection(sections, byType, "progress", "## Progress\n", renderSimple);
-  renderErrorSection(sections, byType);
-  renderSection(sections, byType, "test-coverage", "", renderSimple);
-  renderSection(sections, byType, "story", "## Current Story\n", renderSimple);
-  renderSection(sections, byType, "dependency", "## Dependency Stories\n", renderSimple);
-  renderSection(sections, byType, "file", "## Relevant Source Files\n", renderSimple);
-
-  return sections.join("\n");
-}
-
-/** Render a simple section with elements as-is. */
-function renderSimple(sections: string[], elements: ContextElement[]): void {
-  for (const element of elements) {
-    sections.push(element.content);
-    sections.push("\n");
-  }
-}
-
-/** Render a typed section if elements exist. */
-function renderSection(
-  sections: string[],
-  byType: Map<string, ContextElement[]>,
-  type: string,
-  header: string,
-  renderer: (sections: string[], elements: ContextElement[]) => void,
-): void {
-  const elements = byType.get(type);
-  if (!elements || elements.length === 0) return;
-  if (header) sections.push(header);
-  renderer(sections, elements);
-}
-
-/** Render error section with special handling for ASSET_CHECK errors. */
-function renderErrorSection(sections: string[], byType: Map<string, ContextElement[]>): void {
-  const errorElements = byType.get("error");
-  if (!errorElements || errorElements.length === 0) return;
-
-  const assetCheckErrors: ContextElement[] = [];
-  const otherErrors: ContextElement[] = [];
-
-  for (const element of errorElements) {
-    if (element.content.startsWith("ASSET_CHECK_FAILED:")) {
-      assetCheckErrors.push(element);
-    } else {
-      otherErrors.push(element);
-    }
-  }
-
-  if (assetCheckErrors.length > 0) {
-    sections.push("## ⚠️ MANDATORY: Missing Files from Previous Attempts\n");
-    sections.push("**CRITICAL:** Previous attempts failed because these files were not created.\n");
-    sections.push("You MUST create these exact files. Do NOT use alternative filenames.\n\n");
-
-    for (const element of assetCheckErrors) {
-      const match = element.content.match(/Missing files: \[([^\]]+)\]/);
-      if (match) {
-        const fileList = match[1].split(",").map((f) => f.trim());
-        sections.push("**Required files:**\n");
-        for (const file of fileList) {
-          sections.push(`- \`${file}\``);
-        }
-        sections.push("\n");
-      } else {
-        sections.push("```");
-        sections.push(element.content);
-        sections.push("```\n");
-      }
-    }
-  }
-
-  if (otherErrors.length > 0) {
-    sections.push("## Prior Errors\n");
-    for (const element of otherErrors) {
-      sections.push("```");
-      sections.push(element.content);
-      sections.push("```\n");
-    }
-  }
-}

package/src/context/generator.ts

@@ -1,343 +0,0 @@
-/**
- * Context Generator Orchestrator (v0.16.1)
- *
- * Generates agent-specific config files from nax/context.md + auto-injected metadata.
- * Replaces the old constitution generator.
- */
-
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import type { NaxConfig } from "../config";
-import { validateFilePath } from "../config/path-security";
-import { aiderGenerator } from "./generators/aider";
-import { claudeGenerator } from "./generators/claude";
-import { codexGenerator } from "./generators/codex";
-import { cursorGenerator } from "./generators/cursor";
-import { geminiGenerator } from "./generators/gemini";
-import { opencodeGenerator } from "./generators/opencode";
-import { windsurfGenerator } from "./generators/windsurf";
-import { buildProjectMetadata } from "./injector";
-import type { AgentContextGenerator, AgentType, ContextContent, GeneratorMap } from "./types";
-
-/** Generator registry */
-const GENERATORS: GeneratorMap = {
-  claude: claudeGenerator,
-  codex: codexGenerator,
-  opencode: opencodeGenerator,
-  cursor: cursorGenerator,
-  windsurf: windsurfGenerator,
-  aider: aiderGenerator,
-  gemini: geminiGenerator,
-};
-
-/** Generation result for a single agent */
-export interface GenerationResult {
-  agent: AgentType;
-  outputFile: string;
-  content: string;
-  written: boolean;
-  error?: string;
-}
-
-/** Generate options */
-export interface GenerateOptions {
-  /** Path to nax/context.md (default: <workdir>/nax/context.md) */
-  contextPath: string;
-  /** Output directory (default: project root) */
-  outputDir: string;
-  /** Working directory for metadata injection */
-  workdir: string;
-  /** Dry run mode */
-  dryRun?: boolean;
-  /** Specific agent (default: all) */
-  agent?: AgentType;
-  /** Auto-inject project metadata (default: true) */
-  autoInject?: boolean;
-}
-
-/**
- * Load context content and optionally inject project metadata.
- */
-async function loadContextContent(options: GenerateOptions, config: NaxConfig): Promise<ContextContent> {
-  if (!existsSync(options.contextPath)) {
-    throw new Error(`Context file not found: ${options.contextPath}`);
-  }
-
-  const file = Bun.file(options.contextPath);
-  const markdown = await file.text();
-
-  const autoInject = options.autoInject ?? true;
-  const metadata = autoInject ? await buildProjectMetadata(options.workdir, config) : undefined;
-
-  return { markdown, metadata };
-}
-
-/**
- * Generate config for a specific agent.
- */
-async function generateFor(agent: AgentType, options: GenerateOptions, config: NaxConfig): Promise<GenerationResult> {
-  const generator = GENERATORS[agent];
-  if (!generator) {
-    return { agent, outputFile: "", content: "", written: false, error: `Unknown agent: ${agent}` };
-  }
-
-  try {
-    const context = await loadContextContent(options, config);
-    const content = generator.generate(context);
-    const outputPath = join(options.outputDir, generator.outputFile);
-
-    validateFilePath(outputPath, options.outputDir);
-
-    if (!options.dryRun) {
-      await Bun.write(outputPath, content);
-    }
-
-    return { agent, outputFile: generator.outputFile, content, written: !options.dryRun };
-  } catch (err) {
-    const error = err instanceof Error ? err.message : String(err);
-    return { agent, outputFile: generator.outputFile, content: "", written: false, error };
-  }
-}
-
-/**
- * Generate configs for all agents (or a filtered subset).
- *
- * @param agentFilter - Optional list of agent names to generate. When provided,
- *   only those agents are written to disk. When omitted, all agents are generated.
- */
-async function generateAll(
-  options: GenerateOptions,
-  config: NaxConfig,
-  agentFilter?: AgentType[],
-): Promise<GenerationResult[]> {
-  // Load context once and share across generators
-  const context = await loadContextContent(options, config);
-
-  const results: GenerationResult[] = [];
-
-  const entries = (Object.entries(GENERATORS) as [AgentType, AgentContextGenerator][]).filter(
-    ([agentKey]) => !agentFilter || agentFilter.length === 0 || agentFilter.includes(agentKey),
-  );
-
-  for (const [agentKey, generator] of entries) {
-    try {
-      const content = generator.generate(context);
-      const outputPath = join(options.outputDir, generator.outputFile);
-
-      validateFilePath(outputPath, options.outputDir);
-
-      if (!options.dryRun) {
-        await Bun.write(outputPath, content);
-      }
-
-      results.push({ agent: agentKey, outputFile: generator.outputFile, content, written: !options.dryRun });
-    } catch (err) {
-      const error = err instanceof Error ? err.message : String(err);
-      results.push({ agent: agentKey, outputFile: generator.outputFile, content: "", written: false, error });
-    }
-  }
-
-  return results;
-}
-
-/** Result from generateForPackage */
-export interface PackageGenerationResult {
-  packageDir: string;
-  outputFile: string;
-  content: string;
-  written: boolean;
-  error?: string;
-}
-
-/**
- * Discover packages that have nax/context.md files.
- *
- * Scans up to 2 levels deep (one-level and two-level patterns).
- *
- * @param repoRoot - Absolute repo root to scan
- * @returns Array of package directory paths (absolute)
- */
-export async function discoverPackages(repoRoot: string): Promise<string[]> {
-  const packages: string[] = [];
-  const seen = new Set<string>();
-
-  for (const pattern of ["*/nax/context.md", "*/*/nax/context.md"]) {
-    const glob = new Bun.Glob(pattern);
-    for await (const match of glob.scan(repoRoot)) {
-      // match is e.g. "packages/api/nax/context.md" — strip trailing /nax/context.md
-      const pkgRelative = match.replace(/\/nax\/context\.md$/, "");
-      const pkgAbsolute = join(repoRoot, pkgRelative);
-      if (!seen.has(pkgAbsolute)) {
-        seen.add(pkgAbsolute);
-        packages.push(pkgAbsolute);
-      }
-    }
-  }
-
-  return packages;
-}
-
-/**
- * Discover packages from workspace manifests (turbo.json, package.json workspaces,
- * pnpm-workspace.yaml). Used as fallback when no nax/context.md files exist yet.
- *
- * Returns relative paths (e.g. "packages/api") sorted alphabetically.
- */
-export async function discoverWorkspacePackages(repoRoot: string): Promise<string[]> {
-  // 1. Prefer packages that already have nax/context.md
-  const existing = await discoverPackages(repoRoot);
-  if (existing.length > 0) {
-    return existing.map((p) => p.replace(`${repoRoot}/`, ""));
-  }
-
-  const seen = new Set<string>();
-  const results: string[] = [];
-
-  async function resolveGlobs(patterns: string[]): Promise<void> {
-    for (const pattern of patterns) {
-      if (pattern.startsWith("!")) continue; // skip negations
-      // Convert workspace pattern to package.json glob so Bun can scan files
-      // "packages/*"  → "packages/*/package.json"
-      // "packages/**" → "packages/**/package.json"
-      const base = pattern.replace(/\/+$/, ""); // strip trailing slashes
-      const pkgPattern = base.endsWith("*") ? `${base}/package.json` : `${base}/*/package.json`;
-
-      const g = new Bun.Glob(pkgPattern);
-      for await (const match of g.scan(repoRoot)) {
-        const rel = match.replace(/\/package\.json$/, "");
-        if (!seen.has(rel)) {
-          seen.add(rel);
-          results.push(rel);
-        }
-      }
-    }
-  }
-
-  // 2. turbo v2+: turbo.json top-level "packages" array
-  const turboPath = join(repoRoot, "turbo.json");
-  if (existsSync(turboPath)) {
-    try {
-      const turbo = JSON.parse(readFileSync(turboPath, "utf-8")) as Record<string, unknown>;
-      if (Array.isArray(turbo.packages)) {
-        await resolveGlobs(turbo.packages as string[]);
-      }
-    } catch {
-      // malformed turbo.json — skip
-    }
-  }
-
-  // 3. root package.json "workspaces" (npm/yarn/bun/turbo v1)
-  const pkgPath = join(repoRoot, "package.json");
-  if (existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
-      const ws = pkg.workspaces;
-      const patterns: string[] = Array.isArray(ws)
-        ? (ws as string[])
-        : Array.isArray((ws as Record<string, unknown>)?.packages)
-          ? ((ws as Record<string, unknown>).packages as string[])
-          : [];
-      if (patterns.length > 0) await resolveGlobs(patterns);
-    } catch {
-      // malformed package.json — skip
-    }
-  }
-
-  // 4. pnpm-workspace.yaml
-  const pnpmPath = join(repoRoot, "pnpm-workspace.yaml");
-  if (existsSync(pnpmPath)) {
-    try {
-      const raw = readFileSync(pnpmPath, "utf-8");
-      // Simple YAML parse for "packages:\n  - 'packages/*'" without full YAML dep
-      const lines = raw.split("\n");
-      let inPackages = false;
-      const patterns: string[] = [];
-      for (const line of lines) {
-        if (/^packages\s*:/.test(line)) {
-          inPackages = true;
-          continue;
-        }
-        if (inPackages && /^\s+-\s+/.test(line)) {
-          patterns.push(line.replace(/^\s+-\s+['"]?/, "").replace(/['"]?\s*$/, ""));
-        } else if (inPackages && !/^\s/.test(line)) {
-          break;
-        }
-      }
-      if (patterns.length > 0) await resolveGlobs(patterns);
-    } catch {
-      // malformed yaml — skip
-    }
-  }
-
-  return results.sort();
-}
-
-/**
- * Generate agent config file(s) for a specific package.
- *
- * Reads `<packageDir>/nax/context.md` and writes agent files (e.g. CLAUDE.md,
- * AGENTS.md) into the package directory. Respects `config.generate.agents` — when
- * set, only generates for those agents; defaults to `["claude"]` when unset.
- *
- * Per-package files contain only package-specific content — Claude Code's native
- * directory hierarchy merges root CLAUDE.md + package CLAUDE.md at runtime.
- *
- * Returns one result per generated agent.
- */
-export async function generateForPackage(
-  packageDir: string,
-  config: NaxConfig,
-  dryRun = false,
-): Promise<PackageGenerationResult[]> {
-  const contextPath = join(packageDir, "nax", "context.md");
-
-  if (!existsSync(contextPath)) {
-    return [
-      {
-        packageDir,
-        outputFile: "CLAUDE.md",
-        content: "",
-        written: false,
-        error: `context.md not found: ${contextPath}`,
-      },
-    ];
-  }
-
-  // Respect config.generate.agents; default to ["claude"] when unset
-  const agentsToGenerate: AgentType[] =
-    config?.generate?.agents && config.generate.agents.length > 0
-      ? (config.generate.agents as AgentType[])
-      : ["claude"];
-
-  const options: GenerateOptions = {
-    contextPath,
-    outputDir: packageDir,
-    workdir: packageDir,
-    dryRun,
-    autoInject: true,
-  };
-
-  const results: PackageGenerationResult[] = [];
-
-  for (const agent of agentsToGenerate) {
-    try {
-      const result = await generateFor(agent, options, config);
-      results.push({
-        packageDir,
-        outputFile: result.outputFile,
-        content: result.content,
-        written: result.written,
-        error: result.error,
-      });
-    } catch (err) {
-      const error = err instanceof Error ? err.message : String(err);
-      const fallbackFile = GENERATORS[agent]?.outputFile ?? `${agent}.md`;
-      results.push({ packageDir, outputFile: fallbackFile, content: "", written: false, error });
-    }
-  }
-
-  return results;
-}
-
-export { generateFor, generateAll };
-export type { AgentType };

package/src/context/generators/aider.ts

@@ -1,34 +0,0 @@
-/**
- * Aider Config Generator (v0.16.1)
- *
- * Generates .aider.conf.yml from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateAiderConfig(context: ContextContent): string {
-  const header = `# Aider Configuration
-# Auto-generated from nax/context.md — run \`nax generate\` to regenerate.
-# DO NOT EDIT MANUALLY
-
-# Project instructions
-instructions: |
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  const combined = metaSection + context.markdown;
-
-  const indented = combined
-    .split("\n")
-    .map((line) => `  ${line}`)
-    .join("\n");
-
-  return `${header}${indented}\n`;
-}
-
-export const aiderGenerator: AgentContextGenerator = {
-  name: "aider",
-  outputFile: ".aider.conf.yml",
-  generate: generateAiderConfig,
-};

package/src/context/generators/claude.ts

@@ -1,28 +0,0 @@
-/**
- * Claude Code Config Generator (v0.16.1)
- *
- * Generates CLAUDE.md from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateClaudeConfig(context: ContextContent): string {
-  const header = `# Project Context
-
-This file is auto-generated from \`nax/context.md\`.
-DO NOT EDIT MANUALLY — run \`nax generate\` to regenerate.
-
----
-
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  return header + metaSection + context.markdown;
-}
-
-export const claudeGenerator: AgentContextGenerator = {
-  name: "claude",
-  outputFile: "CLAUDE.md",
-  generate: generateClaudeConfig,
-};

package/src/context/generators/codex.ts

@@ -1,28 +0,0 @@
-/**
- * Codex Config Generator (v0.16.1)
- *
- * Generates codex.md from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateCodexConfig(context: ContextContent): string {
-  const header = `# Codex Instructions
-
-This file is auto-generated from \`nax/context.md\`.
-DO NOT EDIT MANUALLY — run \`nax generate\` to regenerate.
-
----
-
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  return header + metaSection + context.markdown;
-}
-
-export const codexGenerator: AgentContextGenerator = {
-  name: "codex",
-  outputFile: "codex.md",
-  generate: generateCodexConfig,
-};

package/src/context/generators/cursor.ts

@@ -1,28 +0,0 @@
-/**
- * Cursor Rules Generator (v0.16.1)
- *
- * Generates .cursorrules from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateCursorRules(context: ContextContent): string {
-  const header = `# Project Rules
-
-Auto-generated from nax/context.md — run \`nax generate\` to regenerate.
-DO NOT EDIT MANUALLY
-
----
-
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  return header + metaSection + context.markdown;
-}
-
-export const cursorGenerator: AgentContextGenerator = {
-  name: "cursor",
-  outputFile: ".cursorrules",
-  generate: generateCursorRules,
-};

package/src/context/generators/gemini.ts

@@ -1,28 +0,0 @@
-/**
- * Gemini CLI Config Generator (v0.16.1)
- *
- * Generates GEMINI.md from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateGeminiConfig(context: ContextContent): string {
-  const header = `# Gemini CLI Context
-
-This file is auto-generated from \`nax/context.md\`.
-DO NOT EDIT MANUALLY — run \`nax generate\` to regenerate.
-
----
-
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  return header + metaSection + context.markdown;
-}
-
-export const geminiGenerator: AgentContextGenerator = {
-  name: "gemini",
-  outputFile: "GEMINI.md",
-  generate: generateGeminiConfig,
-};

package/src/context/generators/opencode.ts

@@ -1,30 +0,0 @@
-/**
- * OpenCode Config Generator (v0.16.1)
- *
- * Generates AGENTS.md from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateOpencodeConfig(context: ContextContent): string {
-  const header = `# Agent Instructions
-
-This file is auto-generated from \`nax/context.md\`.
-DO NOT EDIT MANUALLY — run \`nax generate\` to regenerate.
-
-These instructions apply to all AI coding agents in this project.
-
----
-
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  return header + metaSection + context.markdown;
-}
-
-export const opencodeGenerator: AgentContextGenerator = {
-  name: "opencode",
-  outputFile: "AGENTS.md",
-  generate: generateOpencodeConfig,
-};

package/src/context/generators/windsurf.ts

@@ -1,28 +0,0 @@
-/**
- * Windsurf Rules Generator (v0.16.1)
- *
- * Generates .windsurfrules from nax/context.md + auto-injected metadata.
- */
-
-import { formatMetadataSection } from "../injector";
-import type { AgentContextGenerator, ContextContent } from "../types";
-
-function generateWindsurfRules(context: ContextContent): string {
-  const header = `# Windsurf Project Rules
-
-Auto-generated from nax/context.md — run \`nax generate\` to regenerate.
-DO NOT EDIT MANUALLY
-
----
-
-`;
-
-  const metaSection = context.metadata ? formatMetadataSection(context.metadata) : "";
-  return header + metaSection + context.markdown;
-}
-
-export const windsurfGenerator: AgentContextGenerator = {
-  name: "windsurf",
-  outputFile: ".windsurfrules",
-  generate: generateWindsurfRules,
-};