@nathapp/nax 0.47.0 → 0.48.0

package/dist/nax.js

@@ -22210,7 +22210,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@nathapp/nax",
-    version: "0.47.0",
+    version: "0.48.0",
     description: "AI Coding Agent Orchestrator \u2014 loops until done",
     type: "module",
     bin: {
@@ -22283,8 +22283,8 @@ var init_version = __esm(() => {
   NAX_VERSION = package_default.version;
   NAX_COMMIT = (() => {
     try {
-      if (/^[0-9a-f]{6,10}$/.test("ed0a660"))
-        return "ed0a660";
+      if (/^[0-9a-f]{6,10}$/.test("3188738"))
+        return "3188738";
     } catch {}
     try {
       const result = Bun.spawnSync(["git", "rev-parse", "--short", "HEAD"], {
@@ -66438,7 +66438,7 @@ init_test_strategy();
 
 // src/context/generator.ts
 init_path_security2();
-import { existsSync as existsSync10 } from "fs";
+import { existsSync as existsSync10, readFileSync } from "fs";
 import { join as join11 } from "path";
 
 // src/context/injector.ts
@@ -66852,6 +66852,73 @@ async function discoverPackages(repoRoot) {
   }
   return packages;
 }
+async function discoverWorkspacePackages(repoRoot) {
+  const existing = await discoverPackages(repoRoot);
+  if (existing.length > 0) {
+    return existing.map((p) => p.replace(`${repoRoot}/`, ""));
+  }
+  const seen = new Set;
+  const results = [];
+  async function resolveGlobs(patterns) {
+    for (const pattern of patterns) {
+      if (pattern.startsWith("!"))
+        continue;
+      const base = pattern.replace(/\/+$/, "");
+      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);
+        }
+      }
+    }
+  }
+  const turboPath = join11(repoRoot, "turbo.json");
+  if (existsSync10(turboPath)) {
+    try {
+      const turbo = JSON.parse(readFileSync(turboPath, "utf-8"));
+      if (Array.isArray(turbo.packages)) {
+        await resolveGlobs(turbo.packages);
+      }
+    } catch {}
+  }
+  const pkgPath = join11(repoRoot, "package.json");
+  if (existsSync10(pkgPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      const ws = pkg.workspaces;
+      const patterns = Array.isArray(ws) ? ws : Array.isArray(ws?.packages) ? ws.packages : [];
+      if (patterns.length > 0)
+        await resolveGlobs(patterns);
+    } catch {}
+  }
+  const pnpmPath = join11(repoRoot, "pnpm-workspace.yaml");
+  if (existsSync10(pnpmPath)) {
+    try {
+      const raw = readFileSync(pnpmPath, "utf-8");
+      const lines = raw.split(`
+`);
+      let inPackages = false;
+      const patterns = [];
+      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 {}
+  }
+  return results.sort();
+}
 async function generateForPackage(packageDir, config2, dryRun = false) {
   const contextPath = join11(packageDir, "nax", "context.md");
   if (!existsSync10(contextPath)) {
@@ -67059,7 +67126,9 @@ var _deps2 = {
   },
   mkdirp: (path) => Bun.spawn(["mkdir", "-p", path]).exited.then(() => {}),
   existsSync: (path) => existsSync11(path),
-  discoverPackages: (repoRoot) => discoverPackages(repoRoot)
+  discoverWorkspacePackages: (repoRoot) => discoverWorkspacePackages(repoRoot),
+  readPackageJsonAt: (path) => Bun.file(path).json().catch(() => null),
+  createInteractionBridge: () => createCliInteractionBridge()
 };
 async function planCommand(workdir, config2, options) {
   const naxDir = join12(workdir, "nax");
@@ -67072,11 +67141,15 @@ async function planCommand(workdir, config2, options) {
   logger?.info("plan", "Scanning codebase...");
   const [scan, discoveredPackages, pkg] = await Promise.all([
     _deps2.scanCodebase(workdir),
-    _deps2.discoverPackages(workdir),
+    _deps2.discoverWorkspacePackages(workdir),
     _deps2.readPackageJson(workdir)
   ]);
   const codebaseContext = buildCodebaseContext2(scan);
-  const relativePackages = discoveredPackages.map((p) => p.replace(`${workdir}/`, ""));
+  const relativePackages = discoveredPackages.map((p) => p.startsWith("/") ? p.replace(`${workdir}/`, "") : p);
+  const packageDetails = relativePackages.length > 0 ? await Promise.all(relativePackages.map(async (rel) => {
+    const pkgJson = await _deps2.readPackageJsonAt(join12(workdir, rel, "package.json"));
+    return buildPackageSummary(rel, pkgJson);
+  })) : [];
   const projectName = detectProjectName(workdir, pkg);
   const branchName = options.branch ?? `feat/${options.feature}`;
   const outputDir = join12(naxDir, "features", options.feature);
@@ -67086,7 +67159,7 @@ async function planCommand(workdir, config2, options) {
   const timeoutSeconds = config2?.execution?.sessionTimeoutSeconds ?? 600;
   let rawResponse;
   if (options.auto) {
-    const prompt = buildPlanningPrompt(specContent, codebaseContext, undefined, relativePackages);
+    const prompt = buildPlanningPrompt(specContent, codebaseContext, undefined, relativePackages, packageDetails);
     const cliAdapter = _deps2.getAgent(agentName);
     if (!cliAdapter)
       throw new Error(`[plan] No agent adapter found for '${agentName}'`);
@@ -67098,11 +67171,11 @@ async function planCommand(workdir, config2, options) {
       }
     } catch {}
   } else {
-    const prompt = buildPlanningPrompt(specContent, codebaseContext, outputPath, relativePackages);
+    const prompt = buildPlanningPrompt(specContent, codebaseContext, outputPath, relativePackages, packageDetails);
     const adapter = _deps2.getAgent(agentName, config2);
     if (!adapter)
       throw new Error(`[plan] No agent adapter found for '${agentName}'`);
-    const interactionBridge = createCliInteractionBridge();
+    const interactionBridge = _deps2.createInteractionBridge();
     const pidRegistry = new PidRegistry(workdir);
     const resolvedPerm = resolvePermissions(config2, "plan");
     const resolvedModel = config2?.plan?.model ?? "balanced";
@@ -67180,6 +67253,66 @@ function detectProjectName(workdir, pkg) {
   }
   return "unknown";
 }
+var FRAMEWORK_PATTERNS = [
+  [/\bnext\b/, "Next.js"],
+  [/\bnuxt\b/, "Nuxt"],
+  [/\bremix\b/, "Remix"],
+  [/\bexpress\b/, "Express"],
+  [/\bfastify\b/, "Fastify"],
+  [/\bhono\b/, "Hono"],
+  [/\bnestjs|@nestjs\b/, "NestJS"],
+  [/\breact\b/, "React"],
+  [/\bvue\b/, "Vue"],
+  [/\bsvelte\b/, "Svelte"],
+  [/\bastro\b/, "Astro"],
+  [/\belectron\b/, "Electron"]
+];
+var TEST_RUNNER_PATTERNS = [
+  [/\bvitest\b/, "vitest"],
+  [/\bjest\b/, "jest"],
+  [/\bmocha\b/, "mocha"],
+  [/\bava\b/, "ava"]
+];
+var KEY_DEP_PATTERNS = [
+  [/\bprisma\b/, "prisma"],
+  [/\bdrizzle-orm\b/, "drizzle"],
+  [/\btypeorm\b/, "typeorm"],
+  [/\bmongoose\b/, "mongoose"],
+  [/\bsqlite\b|better-sqlite/, "sqlite"],
+  [/\bstripe\b/, "stripe"],
+  [/\bgraphql\b/, "graphql"],
+  [/\btrpc\b/, "tRPC"],
+  [/\bzod\b/, "zod"],
+  [/\btailwind\b/, "tailwind"]
+];
+function buildPackageSummary(rel, pkg) {
+  const name = typeof pkg?.name === "string" ? pkg.name : rel;
+  const allDeps = { ...pkg?.dependencies, ...pkg?.devDependencies };
+  const depNames = Object.keys(allDeps).join(" ");
+  const scripts = pkg?.scripts ?? {};
+  const testScript = scripts.test ?? "";
+  const runtime = testScript.includes("bun ") ? "bun" : testScript.includes("node ") ? "node" : "unknown";
+  const framework = FRAMEWORK_PATTERNS.find(([re]) => re.test(depNames))?.[1] ?? "";
+  const testRunner = TEST_RUNNER_PATTERNS.find(([re]) => re.test(depNames))?.[1] ?? (testScript.includes("bun test") ? "bun:test" : "");
+  const keyDeps = KEY_DEP_PATTERNS.filter(([re]) => re.test(depNames)).map(([, label]) => label);
+  return { path: rel, name, runtime, framework, testRunner, keyDeps };
+}
+function buildPackageDetailsSection(details) {
+  if (details.length === 0)
+    return "";
+  const rows = details.map((d) => {
+    const stack = [d.framework, d.testRunner, ...d.keyDeps].filter(Boolean).join(", ") || "\u2014";
+    return `| \`${d.path}\` | ${d.name} | ${stack} |`;
+  });
+  return `
+## Package Tech Stacks
+
+| Path | Package | Stack |
+|:-----|:--------|:------|
+${rows.join(`
+`)}
+`;
+}
 function buildCodebaseContext2(scan) {
   const sections = [];
   sections.push(`## Codebase Structure
@@ -67206,15 +67339,16 @@ function buildCodebaseContext2(scan) {
   return sections.join(`
 `);
 }
-function buildPlanningPrompt(specContent, codebaseContext, outputFilePath, packages) {
+function buildPlanningPrompt(specContent, codebaseContext, outputFilePath, packages, packageDetails) {
   const isMonorepo = packages && packages.length > 0;
+  const packageDetailsSection = packageDetails && packageDetails.length > 0 ? buildPackageDetailsSection(packageDetails) : "";
   const monorepoHint = isMonorepo ? `
 ## Monorepo Context
 
 This is a monorepo. Detected packages:
 ${packages.map((p) => `- ${p}`).join(`
 `)}
-
+${packageDetailsSection}
 For each user story, set the "workdir" field to the relevant package path (e.g. "packages/api"). Stories that span the root should omit "workdir".` : "";
   const workdirField = isMonorepo ? `
       "workdir": "string \u2014 optional, relative path to package (e.g. \\"packages/api\\"). Omit for root-level stories.",` : "";
@@ -68709,8 +68843,15 @@ async function generateCommand(options) {
       const suffix = dryRun ? " (dry run)" : "";
       console.log(source_default.green(`\u2713 ${agent} \u2192 ${result.outputFile} (${result.content.length} bytes${suffix})`));
     } else {
-      console.log(source_default.blue("\u2192 Generating configs for all agents..."));
-      const results = await generateAll(genOptions, config2);
+      const configAgents = config2?.generate?.agents;
+      const agentFilter = configAgents && configAgents.length > 0 ? configAgents : null;
+      if (agentFilter) {
+        console.log(source_default.blue(`\u2192 Generating configs for: ${agentFilter.join(", ")} (from config)...`));
+      } else {
+        console.log(source_default.blue("\u2192 Generating configs for all agents..."));
+      }
+      const allResults = await generateAll(genOptions, config2);
+      const results = agentFilter ? allResults.filter((r) => agentFilter.includes(r.agent)) : allResults;
       let errorCount = 0;
       for (const result of results) {
         if (result.error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nathapp/nax",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "AI Coding Agent Orchestrator — loops until done",
   "type": "module",
   "bin": {

package/src/cli/generate.ts

@@ -142,6 +142,7 @@ export async function generateCommand(options: GenerateCommandOptions): Promise<
 
   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}...`));
 
@@ -155,9 +156,19 @@ export async function generateCommand(options: GenerateCommandOptions): Promise<
       const suffix = dryRun ? " (dry run)" : "";
       console.log(chalk.green(`✓ ${agent} → ${result.outputFile} (${result.content.length} bytes${suffix})`));
     } else {
-      console.log(chalk.blue("→ Generating configs for all agents..."));
+      // No --agent flag: use config.generate.agents filter, or generate all
+      const configAgents = config?.generate?.agents;
+      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..."));
+      }
+
+      const allResults = await generateAll(genOptions, config);
+      const results = agentFilter ? allResults.filter((r) => agentFilter.includes(r.agent as AgentType)) : allResults;
 
-      const results = await generateAll(genOptions, config);
       let errorCount = 0;
 
       for (const result of results) {

package/src/cli/plan.ts

@@ -17,7 +17,7 @@ import type { CodebaseScan } from "../analyze/types";
 import type { NaxConfig } from "../config";
 import { resolvePermissions } from "../config/permissions";
 import { COMPLEXITY_GUIDE, GROUPING_RULES, TEST_STRATEGY_GUIDE } from "../config/test-strategy";
-import { discoverPackages } from "../context/generator";
+import { discoverWorkspacePackages } from "../context/generator";
 import { PidRegistry } from "../execution/pid-registry";
 import { getLogger } from "../logger";
 import { validatePlanOutput } from "../prd/schema";
@@ -42,7 +42,15 @@ export const _deps = {
   },
   mkdirp: (path: string): Promise<void> => Bun.spawn(["mkdir", "-p", path]).exited.then(() => {}),
   existsSync: (path: string): boolean => existsSync(path),
-  discoverPackages: (repoRoot: string): Promise<string[]> => discoverPackages(repoRoot),
+  discoverWorkspacePackages: (repoRoot: string): Promise<string[]> => discoverWorkspacePackages(repoRoot),
+  readPackageJsonAt: (path: string): Promise<Record<string, unknown> | null> =>
+    Bun.file(path)
+      .json()
+      .catch(() => null),
+  createInteractionBridge: (): {
+    detectQuestion: (text: string) => Promise<boolean>;
+    onQuestionDetected: (text: string) => Promise<string>;
+  } => createCliInteractionBridge(),
 };
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -89,13 +97,25 @@ export async function planCommand(workdir: string, config: NaxConfig, options: P
   logger?.info("plan", "Scanning codebase...");
   const [scan, discoveredPackages, pkg] = await Promise.all([
     _deps.scanCodebase(workdir),
-    _deps.discoverPackages(workdir),
+    _deps.discoverWorkspacePackages(workdir),
     _deps.readPackageJson(workdir),
   ]);
   const codebaseContext = buildCodebaseContext(scan);
 
-  // MW-007: convert absolute paths to repo-relative for prompt readability
-  const relativePackages = discoveredPackages.map((p) => p.replace(`${workdir}/`, ""));
+  // Normalize to repo-relative paths (discoverWorkspacePackages returns relative,
+  // but mocks/legacy callers may return absolute — strip workdir prefix if present)
+  const relativePackages = discoveredPackages.map((p) => (p.startsWith("/") ? p.replace(`${workdir}/`, "") : p));
+
+  // Scan per-package tech stacks for richer monorepo planning context
+  const packageDetails =
+    relativePackages.length > 0
+      ? await Promise.all(
+          relativePackages.map(async (rel) => {
+            const pkgJson = await _deps.readPackageJsonAt(join(workdir, rel, "package.json"));
+            return buildPackageSummary(rel, pkgJson);
+          }),
+        )
+      : [];
 
   // Auto-detect project name
   const projectName = detectProjectName(workdir, pkg);
@@ -115,7 +135,7 @@ export async function planCommand(workdir: string, config: NaxConfig, options: P
   let rawResponse: string;
   if (options.auto) {
     // One-shot: use CLI adapter directly — simple completion doesn't need ACP session overhead
-    const prompt = buildPlanningPrompt(specContent, codebaseContext, undefined, relativePackages);
+    const prompt = buildPlanningPrompt(specContent, codebaseContext, undefined, relativePackages, packageDetails);
     const cliAdapter = _deps.getAgent(agentName);
     if (!cliAdapter) throw new Error(`[plan] No agent adapter found for '${agentName}'`);
     rawResponse = await cliAdapter.complete(prompt, { jsonMode: true, workdir, config });
@@ -130,10 +150,10 @@ export async function planCommand(workdir: string, config: NaxConfig, options: P
     }
   } else {
     // Interactive: agent writes PRD JSON directly to outputPath (avoids output truncation)
-    const prompt = buildPlanningPrompt(specContent, codebaseContext, outputPath, relativePackages);
+    const prompt = buildPlanningPrompt(specContent, codebaseContext, outputPath, relativePackages, packageDetails);
     const adapter = _deps.getAgent(agentName, config);
     if (!adapter) throw new Error(`[plan] No agent adapter found for '${agentName}'`);
-    const interactionBridge = createCliInteractionBridge();
+    const interactionBridge = _deps.createInteractionBridge();
     const pidRegistry = new PidRegistry(workdir);
     const resolvedPerm = resolvePermissions(config, "plan");
     const resolvedModel = config?.plan?.model ?? "balanced";
@@ -246,6 +266,91 @@ function detectProjectName(workdir: string, pkg: Record<string, unknown> | null)
   return "unknown";
 }
 
+/** Compact per-package summary for the planning prompt. */
+interface PackageSummary {
+  path: string;
+  name: string;
+  runtime: string;
+  framework: string;
+  testRunner: string;
+  keyDeps: string[];
+}
+
+const FRAMEWORK_PATTERNS: [RegExp, string][] = [
+  [/\bnext\b/, "Next.js"],
+  [/\bnuxt\b/, "Nuxt"],
+  [/\bremix\b/, "Remix"],
+  [/\bexpress\b/, "Express"],
+  [/\bfastify\b/, "Fastify"],
+  [/\bhono\b/, "Hono"],
+  [/\bnestjs|@nestjs\b/, "NestJS"],
+  [/\breact\b/, "React"],
+  [/\bvue\b/, "Vue"],
+  [/\bsvelte\b/, "Svelte"],
+  [/\bastro\b/, "Astro"],
+  [/\belectron\b/, "Electron"],
+];
+
+const TEST_RUNNER_PATTERNS: [RegExp, string][] = [
+  [/\bvitest\b/, "vitest"],
+  [/\bjest\b/, "jest"],
+  [/\bmocha\b/, "mocha"],
+  [/\bava\b/, "ava"],
+];
+
+const KEY_DEP_PATTERNS: [RegExp, string][] = [
+  [/\bprisma\b/, "prisma"],
+  [/\bdrizzle-orm\b/, "drizzle"],
+  [/\btypeorm\b/, "typeorm"],
+  [/\bmongoose\b/, "mongoose"],
+  [/\bsqlite\b|better-sqlite/, "sqlite"],
+  [/\bstripe\b/, "stripe"],
+  [/\bgraphql\b/, "graphql"],
+  [/\btrpc\b/, "tRPC"],
+  [/\bzod\b/, "zod"],
+  [/\btailwind\b/, "tailwind"],
+];
+
+/**
+ * Build a compact summary of a package's tech stack from its package.json.
+ */
+function buildPackageSummary(rel: string, pkg: Record<string, unknown> | null): PackageSummary {
+  const name = typeof pkg?.name === "string" ? pkg.name : rel;
+  const allDeps = { ...(pkg?.dependencies as object | undefined), ...(pkg?.devDependencies as object | undefined) };
+  const depNames = Object.keys(allDeps).join(" ");
+  const scripts = (pkg?.scripts ?? {}) as Record<string, string>;
+
+  // Detect runtime from scripts or lock files
+  const testScript = scripts.test ?? "";
+  const runtime = testScript.includes("bun ") ? "bun" : testScript.includes("node ") ? "node" : "unknown";
+
+  // Detect framework
+  const framework = FRAMEWORK_PATTERNS.find(([re]) => re.test(depNames))?.[1] ?? "";
+
+  // Detect test runner
+  const testRunner =
+    TEST_RUNNER_PATTERNS.find(([re]) => re.test(depNames))?.[1] ?? (testScript.includes("bun test") ? "bun:test" : "");
+
+  // Key deps
+  const keyDeps = KEY_DEP_PATTERNS.filter(([re]) => re.test(depNames)).map(([, label]) => label);
+
+  return { path: rel, name, runtime, framework, testRunner, keyDeps };
+}
+
+/**
+ * Render per-package summaries as a compact markdown table for the prompt.
+ */
+function buildPackageDetailsSection(details: PackageSummary[]): string {
+  if (details.length === 0) return "";
+
+  const rows = details.map((d) => {
+    const stack = [d.framework, d.testRunner, ...d.keyDeps].filter(Boolean).join(", ") || "—";
+    return `| \`${d.path}\` | ${d.name} | ${stack} |`;
+  });
+
+  return `\n## Package Tech Stacks\n\n| Path | Package | Stack |\n|:-----|:--------|:------|\n${rows.join("\n")}\n`;
+}
+
 /**
  * Build codebase context markdown from scan results.
  */
@@ -293,10 +398,13 @@ function buildPlanningPrompt(
   codebaseContext: string,
   outputFilePath?: string,
   packages?: string[],
+  packageDetails?: PackageSummary[],
 ): string {
   const isMonorepo = packages && packages.length > 0;
+  const packageDetailsSection =
+    packageDetails && packageDetails.length > 0 ? buildPackageDetailsSection(packageDetails) : "";
   const monorepoHint = isMonorepo
-    ? `\n## Monorepo Context\n\nThis is a monorepo. Detected packages:\n${packages.map((p) => `- ${p}`).join("\n")}\n\nFor each user story, set the "workdir" field to the relevant package path (e.g. "packages/api"). Stories that span the root should omit "workdir".`
+    ? `\n## Monorepo Context\n\nThis is a monorepo. Detected packages:\n${packages.map((p) => `- ${p}`).join("\n")}\n${packageDetailsSection}\nFor each user story, set the "workdir" field to the relevant package path (e.g. "packages/api"). Stories that span the root should omit "workdir".`
     : "";
 
   const workdirField = isMonorepo

package/src/config/runtime-types.ts

@@ -476,6 +476,18 @@ export interface NaxConfig {
   decompose?: DecomposeConfig;
   /** Agent protocol settings (ACP-003) */
   agent?: AgentConfig;
+  /** Generate settings */
+  generate?: GenerateConfig;
+}
+
+/** Generate command configuration */
+export interface GenerateConfig {
+  /**
+   * Agents to generate config files for (default: all).
+   * Restricts `nax generate` to only the listed agents.
+   * @example ["claude", "opencode"]
+   */
+  agents?: Array<"claude" | "codex" | "opencode" | "cursor" | "windsurf" | "aider" | "gemini">;
 }
 
 /** Agent protocol configuration (ACP-003) */

package/src/context/generator.ts

@@ -5,7 +5,7 @@
  * Replaces the old constitution generator.
  */
 
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import type { NaxConfig } from "../config";
 import { validateFilePath } from "../config/path-security";
@@ -166,6 +166,101 @@ export async function discoverPackages(repoRoot: string): Promise<string[]> {
   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 the claude CLAUDE.md for a specific package.
  *