@nathapp/nax 0.38.1 → 0.38.2

package/dist/nax.js

@@ -18346,7 +18346,8 @@ var init_schemas3 = __esm(() => {
   });
   PluginConfigEntrySchema = exports_external.object({
     module: exports_external.string().min(1, "plugin.module must be non-empty"),
-    config: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+    config: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+    enabled: exports_external.boolean().default(true)
   });
   HooksConfigSchema = exports_external.object({
     skipGlobal: exports_external.boolean().optional(),
@@ -18406,6 +18407,7 @@ var init_schemas3 = __esm(() => {
     context: ContextConfigSchema,
     optimizer: OptimizerConfigSchema.optional(),
     plugins: exports_external.array(PluginConfigEntrySchema).optional(),
+    disabledPlugins: exports_external.array(exports_external.string()).optional(),
     hooks: HooksConfigSchema.optional(),
     interaction: InteractionConfigSchema.optional(),
     precheck: PrecheckConfigSchema.optional(),
@@ -20791,7 +20793,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@nathapp/nax",
-    version: "0.38.1",
+    version: "0.38.2",
     description: "AI Coding Agent Orchestrator \u2014 loops until done",
     type: "module",
     bin: {
@@ -20855,8 +20857,8 @@ var init_version = __esm(() => {
   NAX_VERSION = package_default.version;
   NAX_COMMIT = (() => {
     try {
-      if (/^[0-9a-f]{6,10}$/.test("8a59f16"))
-        return "8a59f16";
+      if (/^[0-9a-f]{6,10}$/.test("a4df623"))
+        return "a4df623";
     } catch {}
     try {
       const result = Bun.spawnSync(["git", "rev-parse", "--short", "HEAD"], {
@@ -28144,16 +28146,29 @@ import * as path11 from "path";
 function getSafeLogger6() {
   return getSafeLogger();
 }
-async function loadPlugins(globalDir, projectDir, configPlugins, projectRoot) {
+function extractPluginName(pluginPath) {
+  const basename2 = path11.basename(pluginPath);
+  if (basename2 === "index.ts" || basename2 === "index.js" || basename2 === "index.mjs") {
+    return path11.basename(path11.dirname(pluginPath));
+  }
+  return basename2.replace(/\.(ts|js|mjs)$/, "");
+}
+async function loadPlugins(globalDir, projectDir, configPlugins, projectRoot, disabledPlugins) {
   const loadedPlugins = [];
   const effectiveProjectRoot = projectRoot || projectDir;
   const pluginNames = new Set;
+  const disabledSet = new Set(disabledPlugins ?? []);
+  const logger = getSafeLogger6();
   const globalPlugins = await discoverPlugins(globalDir);
   for (const plugin of globalPlugins) {
+    const pluginName = extractPluginName(plugin.path);
+    if (disabledSet.has(pluginName)) {
+      logger?.info("plugins", `Skipping disabled plugin: '${pluginName}' (global directory)`);
+      continue;
+    }
     const validated = await loadAndValidatePlugin(plugin.path, {}, [globalDir]);
     if (validated) {
       if (pluginNames.has(validated.name)) {
-        const logger = getSafeLogger6();
         logger?.warn("plugins", `Plugin name collision: '${validated.name}' (global directory)`);
       }
       loadedPlugins.push({
@@ -28165,10 +28180,14 @@ async function loadPlugins(globalDir, projectDir, configPlugins, projectRoot) {
   }
   const projectPlugins = await discoverPlugins(projectDir);
   for (const plugin of projectPlugins) {
+    const pluginName = extractPluginName(plugin.path);
+    if (disabledSet.has(pluginName)) {
+      logger?.info("plugins", `Skipping disabled plugin: '${pluginName}' (project directory)`);
+      continue;
+    }
     const validated = await loadAndValidatePlugin(plugin.path, {}, [projectDir]);
     if (validated) {
       if (pluginNames.has(validated.name)) {
-        const logger = getSafeLogger6();
         logger?.warn("plugins", `Plugin name collision: '${validated.name}' (project directory overrides global)`);
       }
       loadedPlugins.push({
@@ -28179,11 +28198,14 @@ async function loadPlugins(globalDir, projectDir, configPlugins, projectRoot) {
     }
   }
   for (const entry of configPlugins) {
+    if (entry.enabled === false) {
+      logger?.info("plugins", `Skipping disabled plugin: '${entry.module}'`);
+      continue;
+    }
     const resolvedModule = resolveModulePath(entry.module, effectiveProjectRoot);
     const validated = await loadAndValidatePlugin(resolvedModule, entry.config ?? {}, [globalDir, projectDir, effectiveProjectRoot].filter(Boolean), entry.module);
     if (validated) {
       if (pluginNames.has(validated.name)) {
-        const logger = getSafeLogger6();
         logger?.warn("plugins", `Plugin name collision: '${validated.name}' (config entry overrides previous)`);
       }
       loadedPlugins.push({
@@ -31115,10 +31137,10 @@ var init_parallel_executor = __esm(() => {
 // src/pipeline/subscribers/events-writer.ts
 import { appendFile as appendFile2, mkdir } from "fs/promises";
 import { homedir as homedir5 } from "os";
-import { basename as basename2, join as join38 } from "path";
+import { basename as basename3, join as join38 } from "path";
 function wireEventsWriter(bus, feature, runId, workdir) {
   const logger = getSafeLogger();
-  const project = basename2(workdir);
+  const project = basename3(workdir);
   const eventsDir = join38(homedir5(), ".nax", "events", project);
   const eventsFile = join38(eventsDir, "events.jsonl");
   let dirReady = false;
@@ -31280,10 +31302,10 @@ var init_interaction2 = __esm(() => {
 // src/pipeline/subscribers/registry.ts
 import { mkdir as mkdir2, writeFile } from "fs/promises";
 import { homedir as homedir6 } from "os";
-import { basename as basename3, join as join39 } from "path";
+import { basename as basename4, join as join39 } from "path";
 function wireRegistry(bus, feature, runId, workdir) {
   const logger = getSafeLogger();
-  const project = basename3(workdir);
+  const project = basename4(workdir);
   const runDir = join39(homedir6(), ".nax", "runs", `${project}-${feature}-${runId}`);
   const metaFile = join39(runDir, "meta.json");
   const unsub = bus.on("run:started", (_ev) => {
@@ -32650,7 +32672,7 @@ async function setupRun(options) {
     const globalPluginsDir = path17.join(os5.homedir(), ".nax", "plugins");
     const projectPluginsDir = path17.join(workdir, "nax", "plugins");
     const configPlugins = config2.plugins || [];
-    const pluginRegistry = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir);
+    const pluginRegistry = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir, config2.disabledPlugins);
     logger?.info("plugins", `Loaded ${pluginRegistry.plugins.length} plugins`, {
       plugins: pluginRegistry.plugins.map((p) => ({ name: p.name, version: p.version, provides: p.provides }))
     });
@@ -65166,7 +65188,7 @@ async function pluginsListCommand(config2, workdir, overrideGlobalPluginsDir) {
   const globalPluginsDir = overrideGlobalPluginsDir ?? path12.join(os2.homedir(), ".nax", "plugins");
   const projectPluginsDir = path12.join(workdir, "nax", "plugins");
   const configPlugins = config2.plugins || [];
-  const registry2 = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir);
+  const registry2 = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir, config2.disabledPlugins);
   const plugins = registry2.plugins;
   if (plugins.length === 0) {
     console.log("No plugins installed.");
@@ -65179,29 +65201,33 @@ To install plugins:`);
 See https://github.com/nax/nax#plugins for more details.`);
     return;
   }
+  const disabledSet = new Set(config2.disabledPlugins ?? []);
   const rows = plugins.map((plugin) => {
     const source = registry2.getSource(plugin.name);
     const sourceStr = source ? formatSource(source.type, source.path) : "unknown";
+    const isDisabled = disabledSet.has(plugin.name);
     return {
       name: plugin.name,
       version: plugin.version,
       provides: plugin.provides.join(", "),
-      source: sourceStr
+      source: sourceStr,
+      enabled: isDisabled ? "disabled" : "enabled"
     };
   });
   const widths = {
     name: Math.max(4, ...rows.map((r) => r.name.length)),
     version: Math.max(7, ...rows.map((r) => r.version.length)),
     provides: Math.max(8, ...rows.map((r) => r.provides.length)),
-    source: Math.max(6, ...rows.map((r) => r.source.length))
+    source: Math.max(6, ...rows.map((r) => r.source.length)),
+    enabled: Math.max(7, ...rows.map((r) => r.enabled.length))
   };
   console.log(`
 Installed Plugins:
 `);
-  console.log(`${pad("Name", widths.name)}  ${pad("Version", widths.version)}  ${pad("Provides", widths.provides)}  ${pad("Source", widths.source)}`);
-  console.log(`${"-".repeat(widths.name)}  ${"-".repeat(widths.version)}  ${"-".repeat(widths.provides)}  ${"-".repeat(widths.source)}`);
+  console.log(`${pad("Name", widths.name)}  ${pad("Version", widths.version)}  ${pad("Provides", widths.provides)}  ${pad("Source", widths.source)}  ${pad("Status", widths.enabled)}`);
+  console.log(`${"-".repeat(widths.name)}  ${"-".repeat(widths.version)}  ${"-".repeat(widths.provides)}  ${"-".repeat(widths.source)}  ${"-".repeat(widths.enabled)}`);
   for (const row of rows) {
-    console.log(`${pad(row.name, widths.name)}  ${pad(row.version, widths.version)}  ${pad(row.provides, widths.provides)}  ${pad(row.source, widths.source)}`);
+    console.log(`${pad(row.name, widths.name)}  ${pad(row.version, widths.version)}  ${pad(row.provides, widths.provides)}  ${pad(row.source, widths.source)}  ${pad(row.enabled, widths.enabled)}`);
   }
   console.log();
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nathapp/nax",
-  "version": "0.38.1",
-  "description": "AI Coding Agent Orchestrator \u2014 loops until done",
+  "version": "0.38.2",
+  "description": "AI Coding Agent Orchestrator — loops until done",
   "type": "module",
   "bin": {
     "nax": "./dist/nax.js"

package/src/cli/plugins.ts

@@ -25,7 +25,13 @@ export async function pluginsListCommand(
   const globalPluginsDir = overrideGlobalPluginsDir ?? path.join(os.homedir(), ".nax", "plugins");
   const projectPluginsDir = path.join(workdir, "nax", "plugins");
   const configPlugins = config.plugins || [];
-  const registry = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir);
+  const registry = await loadPlugins(
+    globalPluginsDir,
+    projectPluginsDir,
+    configPlugins,
+    workdir,
+    config.disabledPlugins,
+  );
   const plugins = registry.plugins;
 
   if (plugins.length === 0) {
@@ -39,20 +45,24 @@ export async function pluginsListCommand(
   }
 
   // Build table data
+  const disabledSet = new Set(config.disabledPlugins ?? []);
   const rows: Array<{
     name: string;
     version: string;
     provides: string;
     source: string;
+    enabled: string;
   }> = plugins.map((plugin) => {
     const source = registry.getSource(plugin.name);
     const sourceStr = source ? formatSource(source.type, source.path) : "unknown";
+    const isDisabled = disabledSet.has(plugin.name);
 
     return {
       name: plugin.name,
       version: plugin.version,
       provides: plugin.provides.join(", "),
       source: sourceStr,
+      enabled: isDisabled ? "disabled" : "enabled",
     };
   });
 
@@ -62,20 +72,21 @@ export async function pluginsListCommand(
     version: Math.max(7, ...rows.map((r) => r.version.length)),
     provides: Math.max(8, ...rows.map((r) => r.provides.length)),
     source: Math.max(6, ...rows.map((r) => r.source.length)),
+    enabled: Math.max(7, ...rows.map((r) => r.enabled.length)),
   };
 
   // Display table
   console.log("\nInstalled Plugins:\n");
   console.log(
-    `${pad("Name", widths.name)}  ${pad("Version", widths.version)}  ${pad("Provides", widths.provides)}  ${pad("Source", widths.source)}`,
+    `${pad("Name", widths.name)}  ${pad("Version", widths.version)}  ${pad("Provides", widths.provides)}  ${pad("Source", widths.source)}  ${pad("Status", widths.enabled)}`,
   );
   console.log(
-    `${"-".repeat(widths.name)}  ${"-".repeat(widths.version)}  ${"-".repeat(widths.provides)}  ${"-".repeat(widths.source)}`,
+    `${"-".repeat(widths.name)}  ${"-".repeat(widths.version)}  ${"-".repeat(widths.provides)}  ${"-".repeat(widths.source)}  ${"-".repeat(widths.enabled)}`,
   );
 
   for (const row of rows) {
     console.log(
-      `${pad(row.name, widths.name)}  ${pad(row.version, widths.version)}  ${pad(row.provides, widths.provides)}  ${pad(row.source, widths.source)}`,
+      `${pad(row.name, widths.name)}  ${pad(row.version, widths.version)}  ${pad(row.provides, widths.provides)}  ${pad(row.source, widths.source)}  ${pad(row.enabled, widths.enabled)}`,
     );
   }
 

package/src/config/runtime-types.ts

@@ -267,6 +267,7 @@ export interface OptimizerConfig {
 export interface PluginConfigEntry {
   module: string;
   config?: Record<string, unknown>;
+  enabled?: boolean;
 }
 
 export interface HooksConfig {
@@ -435,6 +436,8 @@ export interface NaxConfig {
   optimizer?: OptimizerConfig;
   /** Plugin configurations (v0.10) */
   plugins?: PluginConfigEntry[];
+  /** Disabled plugin names (v0.38.2) */
+  disabledPlugins?: string[];
   /** Hooks configuration (v0.10) */
   hooks?: HooksConfig;
   /** Interaction settings (v0.15.0) */

package/src/config/schemas.ts

@@ -251,6 +251,7 @@ const OptimizerConfigSchema = z.object({
 const PluginConfigEntrySchema = z.object({
   module: z.string().min(1, "plugin.module must be non-empty"),
   config: z.record(z.string(), z.unknown()).optional(),
+  enabled: z.boolean().default(true),
 });
 
 const HooksConfigSchema = z.object({
@@ -330,6 +331,7 @@ export const NaxConfigSchema = z
     context: ContextConfigSchema,
     optimizer: OptimizerConfigSchema.optional(),
     plugins: z.array(PluginConfigEntrySchema).optional(),
+    disabledPlugins: z.array(z.string()).optional(),
     hooks: HooksConfigSchema.optional(),
     interaction: InteractionConfigSchema.optional(),
     precheck: PrecheckConfigSchema.optional(),

package/src/execution/lifecycle/run-setup.ts

@@ -171,7 +171,13 @@ export async function setupRun(options: RunSetupOptions): Promise<RunSetupResult
     const globalPluginsDir = path.join(os.homedir(), ".nax", "plugins");
     const projectPluginsDir = path.join(workdir, "nax", "plugins");
     const configPlugins = config.plugins || [];
-    const pluginRegistry = await loadPlugins(globalPluginsDir, projectPluginsDir, configPlugins, workdir);
+    const pluginRegistry = await loadPlugins(
+      globalPluginsDir,
+      projectPluginsDir,
+      configPlugins,
+      workdir,
+      config.disabledPlugins,
+    );
 
     // Log plugins loaded
     logger?.info("plugins", `Loaded ${pluginRegistry.plugins.length} plugins`, {

package/src/plugins/loader.ts

@@ -50,6 +50,24 @@ export interface PluginSource {
   path: string;
 }
 
+/**
+ * Extract plugin name from file path.
+ * For index files (e.g., /path/to/plugin/index.ts), returns the parent directory name.
+ * For single files (e.g., /path/to/plugin.ts), returns the filename without extension.
+ *
+ * @param pluginPath - Path to plugin file
+ * @returns Plugin name
+ */
+function extractPluginName(pluginPath: string): string {
+  const basename = path.basename(pluginPath);
+  if (basename === "index.ts" || basename === "index.js" || basename === "index.mjs") {
+    // For index files, use the parent directory name
+    return path.basename(path.dirname(pluginPath));
+  }
+  // For single files, use filename without extension
+  return basename.replace(/\.(ts|js|mjs)$/, "");
+}
+
 /**
  * Plugin with source information.
  */
@@ -67,11 +85,13 @@ export interface LoadedPlugin {
  * 3. Load explicit modules from config.plugins[]
  *
  * Each plugin is validated, then setup() is called with its config.
+ * Plugins can be disabled via config.plugins[].enabled or config.disabledPlugins[].
  *
  * @param globalDir - Global plugins directory (e.g., ~/.nax/plugins)
  * @param projectDir - Project plugins directory (e.g., <project>/nax/plugins)
  * @param configPlugins - Explicit plugin entries from config
  * @param projectRoot - Project root directory for resolving relative paths in config
+ * @param disabledPlugins - List of plugin names to disable (auto-discovered plugins only)
  * @returns PluginRegistry with all loaded plugins and their sources
  */
 export async function loadPlugins(
@@ -79,18 +99,25 @@ export async function loadPlugins(
   projectDir: string,
   configPlugins: PluginConfigEntry[],
   projectRoot?: string,
+  disabledPlugins?: string[],
 ): Promise<PluginRegistry> {
   const loadedPlugins: LoadedPlugin[] = [];
   const effectiveProjectRoot = projectRoot || projectDir;
   const pluginNames = new Set<string>();
+  const disabledSet = new Set(disabledPlugins ?? []);
+  const logger = getSafeLogger();
 
   // 1. Load plugins from global directory
   const globalPlugins = await discoverPlugins(globalDir);
   for (const plugin of globalPlugins) {
+    const pluginName = extractPluginName(plugin.path);
+    if (disabledSet.has(pluginName)) {
+      logger?.info("plugins", `Skipping disabled plugin: '${pluginName}' (global directory)`);
+      continue;
+    }
     const validated = await loadAndValidatePlugin(plugin.path, {}, [globalDir]);
     if (validated) {
       if (pluginNames.has(validated.name)) {
-        const logger = getSafeLogger();
         logger?.warn("plugins", `Plugin name collision: '${validated.name}' (global directory)`);
       }
       loadedPlugins.push({
@@ -104,10 +131,14 @@ export async function loadPlugins(
   // 2. Load plugins from project directory
   const projectPlugins = await discoverPlugins(projectDir);
   for (const plugin of projectPlugins) {
+    const pluginName = extractPluginName(plugin.path);
+    if (disabledSet.has(pluginName)) {
+      logger?.info("plugins", `Skipping disabled plugin: '${pluginName}' (project directory)`);
+      continue;
+    }
     const validated = await loadAndValidatePlugin(plugin.path, {}, [projectDir]);
     if (validated) {
       if (pluginNames.has(validated.name)) {
-        const logger = getSafeLogger();
         logger?.warn("plugins", `Plugin name collision: '${validated.name}' (project directory overrides global)`);
       }
       loadedPlugins.push({
@@ -120,6 +151,11 @@ export async function loadPlugins(
 
   // 3. Load plugins from config entries
   for (const entry of configPlugins) {
+    // Check if plugin is explicitly disabled in config
+    if (entry.enabled === false) {
+      logger?.info("plugins", `Skipping disabled plugin: '${entry.module}'`);
+      continue;
+    }
     // Resolve module path relative to effective project root for relative paths
     const resolvedModule = resolveModulePath(entry.module, effectiveProjectRoot);
     const validated = await loadAndValidatePlugin(
@@ -130,7 +166,6 @@ export async function loadPlugins(
     );
     if (validated) {
       if (pluginNames.has(validated.name)) {
-        const logger = getSafeLogger();
         logger?.warn("plugins", `Plugin name collision: '${validated.name}' (config entry overrides previous)`);
       }
       loadedPlugins.push({

package/src/plugins/types.ts

@@ -201,4 +201,6 @@ export interface PluginConfigEntry {
   module: string;
   /** Plugin-specific configuration */
   config?: Record<string, unknown>;
+  /** Whether this plugin is enabled (default: true) */
+  enabled?: boolean;
 }