@orchid-labs/pluxx 0.1.16 → 0.1.17

package/dist/cli/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAuE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AA8B3I,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAElE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAC/C;AAuCD,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAupED,wBAAsB,cAAc,CAClC,OAAO,GAAE,MAAsB,EAC/B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,YAAY,CAAC,CAkEvB;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkF1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAyB5D"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAuE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AA+B3I,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAElE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAC/C;AAuCD,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AA4qED,wBAAsB,cAAc,CAClC,OAAO,GAAE,MAAsB,EAC/B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,YAAY,CAAC,CAkEvB;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkF1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAyB5D"}

package/dist/cli/index.js

@@ -6077,7 +6077,7 @@ function getEnabledRuntimeReadinessBindings(capability, plan) {
   });
 }
 var NAMED_PROMPT_TARGET_NOTE = "Named `skills` / `commands` readiness targets currently translate through prompt-entry gating with best-effort matching because the core four do not share one exact per-skill or per-command runtime interception surface.";
-var CODEX_EXTERNAL_NOTE = "Codex readiness now bundles translated hooks in the plugin, and Pluxx still emits `.codex/readiness.generated.json` plus `.codex/hooks.generated.json` as debugging companions because some Codex runtimes still gate hook activation behind a `[features]` flag. Current Codex config surfaces still accept both `hooks = true` and `codex_hooks = true`, but maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 timing out without a project-local hook side effect under either flag while emitting a deprecation warning for `codex_hooks` that points users to `hooks`.";
+var CODEX_EXTERNAL_NOTE = "Codex readiness now bundles translated hooks in the plugin, and Pluxx still emits `.codex/readiness.generated.json` plus `.codex/hooks.generated.json` as debugging companions because plugin-bundled hook activation still depends on `[features].plugin_hooks = true`. The general `hooks = true` flag covers non-plugin hook config and defaults on, while `codex_hooks` is deprecated and should not be treated as a plugin-bundled hook fallback.";
 function getRuntimeReadinessNamedPromptTargetNote() {
   return NAMED_PROMPT_TARGET_NOTE;
 }
@@ -9870,18 +9870,25 @@ function toQuotedTomlKey(value) {
 // src/codex-hooks-feature.ts
 var RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG = "hooks";
 var ALTERNATE_CODEX_HOOKS_FEATURE_FLAG = "codex_hooks";
+var PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG = "plugin_hooks";
 function getCodexHooksFeatureState(features) {
   if (!features) {
     return {
+      pluginBundled: false,
       recommended: false,
       alternate: false
     };
   }
   return {
+    pluginBundled: features[PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG] === true,
     recommended: features[RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG] === true,
     alternate: features[ALTERNATE_CODEX_HOOKS_FEATURE_FLAG] === true
   };
 }
+function isCodexPluginHooksFeatureEnabled(features) {
+  const state = getCodexHooksFeatureState(features);
+  return state.pluginBundled;
+}
 function isCodexHooksFeatureEnabled(features) {
   const state = getCodexHooksFeatureState(features);
   return state.recommended || state.alternate;
@@ -10210,9 +10217,10 @@ var CodexGenerator = class extends Generator {
     await this.writeJson(".codex/hooks.generated.json", {
       model: "pluxx.codex-hooks.v1",
       enforcedByPluginBundle: true,
-      featureFlag: RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG,
-      alternateFeatureFlag: ALTERNATE_CODEX_HOOKS_FEATURE_FLAG,
-      note: "Codex hook configuration is bundled at hooks/hooks.json in the plugin. This companion mirror preserves the translated native event names, matcher groups, and command handlers while highlighting any dropped events or fields. Current Codex config surfaces still accept both hooks and codex_hooks under [features], but maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 timing out without a project-local hook side effect under either flag while emitting a deprecation warning for codex_hooks that points users to hooks.",
+      pluginBundleFeatureFlag: PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG,
+      generalFeatureFlag: RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG,
+      deprecatedGeneralFeatureFlag: ALTERNATE_CODEX_HOOKS_FEATURE_FLAG,
+      note: "Codex plugin-bundled hook configuration is bundled at hooks/hooks.json in the plugin and currently requires `[features].plugin_hooks = true`. The general `[features].hooks` flag covers non-plugin hook config and defaults on, while `codex_hooks` is deprecated and should not be treated as a plugin-bundled hook fallback. This companion mirror preserves the translated native event names, matcher groups, and command handlers while highlighting any dropped events or fields.",
       hooks,
       ...unsupported.length > 0 ? { unsupported } : {}
     });
@@ -11634,7 +11642,7 @@ var PLATFORM_VALIDATION_RULES = {
       supported: true,
       files: ["hooks/hooks.json", ".codex/hooks.json", "~/.codex/hooks.json"],
       eventNames: ["SessionStart", "PreToolUse", "PermissionRequest", "PostToolUse", "UserPromptSubmit", "Stop"],
-      notes: "Codex documents hooks in project and user config, and the current config schema still accepts both `[features].hooks = true` and `[features].codex_hooks = true`. Maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 timing out without a project-local `.codex/hooks.json` side effect or `/hooks` review gate under either flag; the `codex_hooks` variant also emitted a deprecation message that points users to `hooks`, while the official docs still show `codex_hooks`. The official hooks docs also cover plugin-bundled hooks, which Pluxx now emits at `hooks/hooks.json`."
+      notes: "Codex documents both project or user hook config and plugin-bundled hooks. Plugin-bundled hooks live at `hooks/hooks.json` in the plugin and require `[features].plugin_hooks = true`; the general `[features].hooks = true` flag covers non-plugin hook config and defaults on. `codex_hooks` is deprecated and should not be treated as a plugin-bundled hook fallback."
     },
     instructions: {
       files: ["AGENTS.md", "AGENTS.override.md"],
@@ -13343,12 +13351,12 @@ function lintCodexHooksExternalConfig(config, issues) {
   if (Object.keys(config.hooks).length === 0) return;
   const codexOverrides = asRecord3(config.platforms?.codex);
   const features = codexOverrides ? asRecord3(codexOverrides.features) : null;
-  const hasPluxxCodexHooksFlag = isCodexHooksFeatureEnabled(features);
-  if (!hasPluxxCodexHooksFlag) {
+  const hasPluxxCodexPluginHooksFlag = isCodexPluginHooksFeatureEnabled(features);
+  if (!hasPluxxCodexPluginHooksFlag) {
     pushIssue(issues, {
       level: "warning",
       code: "codex-hooks-external-config",
-      message: `Pluxx now bundles Codex hooks at \`hooks/hooks.json\`, but Codex hook loading may still be guarded by a \`[features]\` flag in the host runtime. Current Codex config surfaces still accept both \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` and \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\`; maintained probes on May 13, 2026 showed local Codex CLI 0.130.0 still failing to execute the project-local hook under either config flag and under the current CLI feature path \`--enable hooks\`, while \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` emitted a deprecation warning that points users to \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\`. If bundled hooks do not activate, enable \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` first, reload Codex, and retest in a trusted interactive session, but do not treat the flag by itself as proof that hooks will execute.`,
+      message: `Pluxx now bundles Codex hooks at \`hooks/hooks.json\`, and Codex plugin-bundled hook loading requires \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\`. The general \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\` flag covers non-plugin hook config and defaults on; \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` is deprecated and should not be treated as a plugin-bundled hook fallback. If bundled hooks do not activate, enable \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\`, reload Codex, and retest in a trusted interactive session.`,
       file: "pluxx.config.ts",
       platform: "Codex"
     });
@@ -13357,7 +13365,16 @@ function lintCodexHooksExternalConfig(config, issues) {
     pushIssue(issues, {
       level: "warning",
       code: "codex-hooks-legacy-feature-flag",
-      message: `Current local Codex CLI 0.130.0 interactive probes on May 13, 2026 emitted a deprecation warning for \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` that points users to \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\`. Keep \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` only as a compatibility fallback and prefer \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\`.`,
+      message: `\`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` is deprecated for general Codex hook config and should not be treated as a plugin-bundled hook fallback. Keep it only as a compatibility fallback for non-plugin hook wiring, prefer \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` there, and use \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` for plugin-bundled hooks.`,
+      file: "pluxx.config.ts",
+      platform: "Codex"
+    });
+  }
+  if (!hasPluxxCodexPluginHooksFlag && isCodexHooksFeatureEnabled(features)) {
+    pushIssue(issues, {
+      level: "warning",
+      code: "codex-hooks-general-feature-flag-only",
+      message: `This Codex config enables only general hook flags. Plugin-bundled hooks at \`hooks/hooks.json\` still need \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\`; \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\` and \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` alone are not sufficient.`,
       file: "pluxx.config.ts",
       platform: "Codex"
     });
@@ -19720,11 +19737,13 @@ function listCodexConfigCandidates(projectRoot) {
 function readCodexHooksFeatureFlag(filePath) {
   let inFeaturesTable = false;
   const lines = readFileSync14(filePath, "utf-8").split(/\r?\n/);
+  let pluginBundled;
   let recommended;
   let alternate;
   const assignFeatureFlag = (key, rawValue) => {
     const parsed = parseTomlValue(rawValue.trim());
     if (typeof parsed !== "boolean") return;
+    if (key === PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG) pluginBundled = parsed;
     if (key === RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG) recommended = parsed;
     if (key === ALTERNATE_CODEX_HOOKS_FEATURE_FLAG) alternate = parsed;
   };
@@ -19736,7 +19755,7 @@ function readCodexHooksFeatureFlag(filePath) {
       inFeaturesTable = sectionMatch[1].trim() === "features";
       continue;
     }
-    const dottedFeatureMatch = line.match(/^features\.(hooks|codex_hooks)\s*=\s*(.+)$/);
+    const dottedFeatureMatch = line.match(/^features\.(plugin_hooks|hooks|codex_hooks)\s*=\s*(.+)$/);
     if (dottedFeatureMatch) {
       assignFeatureFlag(dottedFeatureMatch[1], dottedFeatureMatch[2]);
       continue;
@@ -19746,18 +19765,20 @@ function readCodexHooksFeatureFlag(filePath) {
       const parsed = parseTomlValue(inlineFeaturesMatch[1].trim());
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         const featureState = getCodexHooksFeatureState(parsed);
+        pluginBundled = featureState.pluginBundled;
         recommended = featureState.recommended;
         alternate = featureState.alternate;
       }
       continue;
     }
     if (!inFeaturesTable) continue;
-    const featureMatch = line.match(/^(hooks|codex_hooks)\s*=\s*(.+)$/);
+    const featureMatch = line.match(/^(plugin_hooks|hooks|codex_hooks)\s*=\s*(.+)$/);
     if (!featureMatch) continue;
     assignFeatureFlag(featureMatch[1], featureMatch[2]);
   }
-  if (recommended === void 0 && alternate === void 0) return void 0;
+  if (pluginBundled === void 0 && recommended === void 0 && alternate === void 0) return void 0;
   return {
+    pluginBundled: pluginBundled === true,
     recommended: recommended === true,
     alternate: alternate === true
   };
@@ -19769,6 +19790,7 @@ function probeCodexHooksFeatureFlags(projectRoot) {
         ...candidate,
         exists: false,
         enabled: false,
+        pluginBundledEnabled: false,
         recommendedEnabled: false,
         alternateEnabled: false
       };
@@ -19778,7 +19800,8 @@ function probeCodexHooksFeatureFlags(projectRoot) {
       return {
         ...candidate,
         exists: true,
-        enabled: featureState?.recommended === true || featureState?.alternate === true,
+        enabled: featureState?.pluginBundled === true,
+        pluginBundledEnabled: featureState?.pluginBundled === true,
         recommendedEnabled: featureState?.recommended === true,
         alternateEnabled: featureState?.alternate === true
       };
@@ -19787,6 +19810,7 @@ function probeCodexHooksFeatureFlags(projectRoot) {
         ...candidate,
         exists: true,
         enabled: false,
+        pluginBundledEnabled: false,
         recommendedEnabled: false,
         alternateEnabled: false,
         parseError: error instanceof Error ? error.message : String(error)
@@ -20365,27 +20389,39 @@ function checkInstalledCodexHooksFeatureFlag(checks, rootDir, layout, options) {
   const checkedPaths = probes.map((probe) => `${probe.scope} ${probe.exists ? "config" : "path"}: ${probe.path}${probe.exists ? "" : " (missing)"}`).join("; ");
   const describeEnabledFlags = (probe) => {
     const enabledFlags = [];
+    if (probe.pluginBundledEnabled) enabledFlags.push(PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG);
     if (probe.recommendedEnabled) enabledFlags.push(RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG);
     if (probe.alternateEnabled) enabledFlags.push(ALTERNATE_CODEX_HOOKS_FEATURE_FLAG);
     return enabledFlags.join(" + ");
   };
+  const generalOnlyProbes = probes.filter((probe) => !probe.pluginBundledEnabled && (probe.recommendedEnabled || probe.alternateEnabled));
+  if (generalOnlyProbes.length > 0) {
+    addCheck2(checks, {
+      level: "warning",
+      code: "consumer-codex-plugin-hooks-feature-flag-general-only",
+      title: "Codex config enables only general hook flags, not the plugin-bundled hook gate",
+      detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, but ${generalOnlyProbes.map((probe) => `${probe.scope} config ${probe.path}`).join(" and ")} enables only general hook flags (${generalOnlyProbes.map((probe) => describeEnabledFlags(probe)).join(" and ")}). Those general flags do not activate plugin-bundled hooks by themselves.`,
+      fix: `Enable \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the active Codex config, reload Codex, and rerun pluxx verify-install.`,
+      path: generalOnlyProbes[0].path
+    });
+  }
+  const legacyOnlyProbes = probes.filter((probe) => probe.alternateEnabled && !probe.recommendedEnabled);
+  if (legacyOnlyProbes.length > 0) {
+    addCheck2(checks, {
+      level: "warning",
+      code: "consumer-codex-hooks-feature-flag-legacy-only",
+      title: "Codex config still uses the deprecated general hook compatibility flag",
+      detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, and the checked Codex config enables only the deprecated general hook flag \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\` in ${legacyOnlyProbes.map((probe) => `${probe.scope} config ${probe.path}`).join(" and ")}. That flag is not the plugin-bundled hook gate.`,
+      fix: `Prefer \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` only for non-plugin hook config if needed, and use \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` for plugin-bundled hooks. Reload Codex and rerun pluxx verify-install after updating the active config.`,
+      path: legacyOnlyProbes[0].path
+    });
+  }
   if (enabledProbes.length > 0) {
-    const legacyOnlyProbes = enabledProbes.filter((probe) => probe.alternateEnabled && !probe.recommendedEnabled);
-    if (legacyOnlyProbes.length > 0) {
-      addCheck2(checks, {
-        level: "warning",
-        code: "consumer-codex-hooks-feature-flag-legacy-only",
-        title: "Codex hooks are enabled only through the legacy compatibility flag",
-        detail: `This installed Codex bundle declares hooks at ${hooksReference}, and the checked Codex config enables only \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\` in ${legacyOnlyProbes.map((probe) => `${probe.scope} config ${probe.path}`).join(" and ")}. Maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 emitting a deprecation warning for \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` that points users to \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\`.`,
-        fix: `Prefer \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the active Codex config, keep \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` only as a compatibility fallback if needed, reload Codex, and rerun pluxx verify-install.`,
-        path: legacyOnlyProbes[0].path
-      });
-    }
     addCheck2(checks, {
       level: "success",
       code: "consumer-codex-hooks-feature-flag-enabled",
-      title: "Codex hook feature flag found for this install",
-      detail: `This installed Codex bundle declares hooks at ${hooksReference}, and a Codex hook feature flag was found in ${enabledProbes.map((probe) => `${probe.scope} config ${probe.path} (${describeEnabledFlags(probe)})`).join(" and ")}. Treat that as a prerequisite, not proof of live hook execution: maintained local probes on May 13, 2026 showed local Codex CLI 0.130.0 still failing to execute the project-local hook under \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\`, \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\`, and the current CLI feature path \`--enable hooks\`.`,
+      title: "Codex plugin-bundled hook feature flag found for this install",
+      detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, and the plugin hook gate was found in ${enabledProbes.map((probe) => `${probe.scope} config ${probe.path} (${describeEnabledFlags(probe)})`).join(" and ")}. Treat that as a prerequisite, not proof of live hook execution.`,
       fix: "No action needed.",
       path: enabledProbes[0].path
     });
@@ -20395,9 +20431,9 @@ function checkInstalledCodexHooksFeatureFlag(checks, rootDir, layout, options) {
   addCheck2(checks, {
     level: "warning",
     code: "consumer-codex-hooks-feature-flag-missing",
-    title: "Codex hook activation is missing its known feature-gate prerequisite",
-    detail: `This installed Codex bundle declares hooks at ${hooksReference}, but neither \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` nor \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\` was found in the checked Codex config layers. Current Codex config surfaces still accept both keys under \`[features]\`, but maintained probes on May 13, 2026 showed local Codex CLI 0.130.0 still failing to execute the project-local hook under \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\`, \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\`, and the current CLI feature path \`--enable hooks\`, while also emitting a deprecation warning for \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` that points users to \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\`. Checked ${checkedPaths}.${parseErrors.length > 0 ? ` Unparseable config: ${parseErrors.join("; ")}.` : ""}`,
-    fix: `Enable \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the relevant project or user Codex config, reload Codex, and rerun pluxx verify-install. Keep \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` only as a compatibility fallback if your Codex runtime still needs it, and treat any enabled flag as best-effort activation rather than proof that hooks will execute.`,
+    title: "Codex plugin-bundled hook activation is missing its known feature-gate prerequisite",
+    detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, but \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` was not found in the checked Codex config layers. The general \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\` flag covers non-plugin hook config and defaults on, while \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` is deprecated and should not be treated as a plugin-bundled hook fallback. Checked ${checkedPaths}.${parseErrors.length > 0 ? ` Unparseable config: ${parseErrors.join("; ")}.` : ""}`,
+    fix: `Enable \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the relevant project or user Codex config, reload Codex, and rerun pluxx verify-install.`,
     path: probes.find((probe) => probe.exists)?.path ?? hooksReference
   });
 }

package/dist/cli/lint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/cli/lint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuH,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAwBpK,OAAO,EAAuE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAsD3I,KAAK,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAEpC,UAAU,SAAS;IACjB,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAMD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;CAC3B;AAqmDD,wBAAsB,WAAW,CAC/B,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAoHrB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CA0BrF;AAED,wBAAsB,OAAO,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E"}
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/cli/lint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuH,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AA0BpK,OAAO,EAAuE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAsD3I,KAAK,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAEpC,UAAU,SAAS;IACjB,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAMD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,gBAAgB,CAAC,EAAE,2BAA2B,CAAA;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;CAC3B;AA+mDD,wBAAsB,WAAW,CAC/B,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAoHrB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CA0BrF;AAED,wBAAsB,OAAO,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E"}

package/dist/codex-hooks-feature.d.ts

@@ -1,10 +1,13 @@
 export declare const RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG = "hooks";
 export declare const ALTERNATE_CODEX_HOOKS_FEATURE_FLAG = "codex_hooks";
+export declare const PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG = "plugin_hooks";
 export interface CodexHooksFeatureState {
+    pluginBundled: boolean;
     recommended: boolean;
     alternate: boolean;
 }
 export declare function getCodexHooksFeatureState(features: Record<string, unknown> | null | undefined): CodexHooksFeatureState;
+export declare function isCodexPluginHooksFeatureEnabled(features: Record<string, unknown> | null | undefined): boolean;
 export declare function isCodexHooksFeatureEnabled(features: Record<string, unknown> | null | undefined): boolean;
 export declare function usesAlternateCodexHooksFeatureFlagOnly(features: Record<string, unknown> | null | undefined): boolean;
 //# sourceMappingURL=codex-hooks-feature.d.ts.map

package/dist/codex-hooks-feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex-hooks-feature.d.ts","sourceRoot":"","sources":["../src/codex-hooks-feature.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC,UAAU,CAAA;AAC3D,eAAO,MAAM,kCAAkC,gBAAgB,CAAA;AAE/D,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAYtH;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGxG;AAED,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpH"}
+{"version":3,"file":"codex-hooks-feature.d.ts","sourceRoot":"","sources":["../src/codex-hooks-feature.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC,UAAU,CAAA;AAC3D,eAAO,MAAM,kCAAkC,gBAAgB,CAAA;AAC/D,eAAO,MAAM,uCAAuC,iBAAiB,CAAA;AAErE,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CActH;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG9G;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGxG;AAED,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpH"}

package/dist/generators/codex/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/codex/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AA+ClD,qBAAa,cAAe,SAAQ,SAAS;IAC3C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAU;IAErC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YA0DjB,gBAAgB;YAoEhB,iBAAiB;YAOjB,4BAA4B;YAyB5B,gBAAgB;YAiBhB,oBAAoB;YAuDpB,sBAAsB;YAqGtB,0BAA0B;IAkCxC,OAAO,CAAC,0BAA0B;YAkBpB,yBAAyB;YAiCzB,uBAAuB;IAqCrC,OAAO,CAAC,+BAA+B;CAiBxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/codex/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAgDlD,qBAAa,cAAe,SAAQ,SAAS;IAC3C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAU;IAErC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YA0DjB,gBAAgB;YAoEhB,iBAAiB;YAOjB,4BAA4B;YAyB5B,gBAAgB;YAiBhB,oBAAoB;YAuDpB,sBAAsB;YAsGtB,0BAA0B;IAkCxC,OAAO,CAAC,0BAA0B;YAkBpB,yBAAyB;YAiCzB,uBAAuB;IAqCrC,OAAO,CAAC,+BAA+B;CAiBxC"}

package/dist/index.js

@@ -7855,7 +7855,7 @@ function getEnabledRuntimeReadinessBindings(capability, plan) {
   });
 }
 var NAMED_PROMPT_TARGET_NOTE = "Named `skills` / `commands` readiness targets currently translate through prompt-entry gating with best-effort matching because the core four do not share one exact per-skill or per-command runtime interception surface.";
-var CODEX_EXTERNAL_NOTE = "Codex readiness now bundles translated hooks in the plugin, and Pluxx still emits `.codex/readiness.generated.json` plus `.codex/hooks.generated.json` as debugging companions because some Codex runtimes still gate hook activation behind a `[features]` flag. Current Codex config surfaces still accept both `hooks = true` and `codex_hooks = true`, but maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 timing out without a project-local hook side effect under either flag while emitting a deprecation warning for `codex_hooks` that points users to `hooks`.";
+var CODEX_EXTERNAL_NOTE = "Codex readiness now bundles translated hooks in the plugin, and Pluxx still emits `.codex/readiness.generated.json` plus `.codex/hooks.generated.json` as debugging companions because plugin-bundled hook activation still depends on `[features].plugin_hooks = true`. The general `hooks = true` flag covers non-plugin hook config and defaults on, while `codex_hooks` is deprecated and should not be treated as a plugin-bundled hook fallback.";
 function getRuntimeReadinessNamedPromptTargetNote() {
   return NAMED_PROMPT_TARGET_NOTE;
 }
@@ -8304,7 +8304,7 @@ var PLATFORM_VALIDATION_RULES = {
       supported: true,
       files: ["hooks/hooks.json", ".codex/hooks.json", "~/.codex/hooks.json"],
       eventNames: ["SessionStart", "PreToolUse", "PermissionRequest", "PostToolUse", "UserPromptSubmit", "Stop"],
-      notes: "Codex documents hooks in project and user config, and the current config schema still accepts both `[features].hooks = true` and `[features].codex_hooks = true`. Maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 timing out without a project-local `.codex/hooks.json` side effect or `/hooks` review gate under either flag; the `codex_hooks` variant also emitted a deprecation message that points users to `hooks`, while the official docs still show `codex_hooks`. The official hooks docs also cover plugin-bundled hooks, which Pluxx now emits at `hooks/hooks.json`."
+      notes: "Codex documents both project or user hook config and plugin-bundled hooks. Plugin-bundled hooks live at `hooks/hooks.json` in the plugin and require `[features].plugin_hooks = true`; the general `[features].hooks = true` flag covers non-plugin hook config and defaults on. `codex_hooks` is deprecated and should not be treated as a plugin-bundled hook fallback."
     },
     instructions: {
       files: ["AGENTS.md", "AGENTS.override.md"],
@@ -10794,14 +10794,17 @@ var MUTATING_PREFIX_PATTERN = new RegExp(`^(${MUTATING_PREFIXES.join("|")})\\b`,
 // src/codex-hooks-feature.ts
 var RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG = "hooks";
 var ALTERNATE_CODEX_HOOKS_FEATURE_FLAG = "codex_hooks";
+var PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG = "plugin_hooks";
 function getCodexHooksFeatureState(features) {
   if (!features) {
     return {
+      pluginBundled: false,
       recommended: false,
       alternate: false
     };
   }
   return {
+    pluginBundled: features[PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG] === true,
     recommended: features[RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG] === true,
     alternate: features[ALTERNATE_CODEX_HOOKS_FEATURE_FLAG] === true
   };
@@ -11091,11 +11094,13 @@ function listCodexConfigCandidates(projectRoot) {
 function readCodexHooksFeatureFlag(filePath) {
   let inFeaturesTable = false;
   const lines = readFileSync4(filePath, "utf-8").split(/\r?\n/);
+  let pluginBundled;
   let recommended;
   let alternate;
   const assignFeatureFlag = (key, rawValue) => {
     const parsed = parseTomlValue(rawValue.trim());
     if (typeof parsed !== "boolean") return;
+    if (key === PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG) pluginBundled = parsed;
     if (key === RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG) recommended = parsed;
     if (key === ALTERNATE_CODEX_HOOKS_FEATURE_FLAG) alternate = parsed;
   };
@@ -11107,7 +11112,7 @@ function readCodexHooksFeatureFlag(filePath) {
       inFeaturesTable = sectionMatch[1].trim() === "features";
       continue;
     }
-    const dottedFeatureMatch = line.match(/^features\.(hooks|codex_hooks)\s*=\s*(.+)$/);
+    const dottedFeatureMatch = line.match(/^features\.(plugin_hooks|hooks|codex_hooks)\s*=\s*(.+)$/);
     if (dottedFeatureMatch) {
       assignFeatureFlag(dottedFeatureMatch[1], dottedFeatureMatch[2]);
       continue;
@@ -11117,18 +11122,20 @@ function readCodexHooksFeatureFlag(filePath) {
       const parsed = parseTomlValue(inlineFeaturesMatch[1].trim());
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         const featureState = getCodexHooksFeatureState(parsed);
+        pluginBundled = featureState.pluginBundled;
         recommended = featureState.recommended;
         alternate = featureState.alternate;
       }
       continue;
     }
     if (!inFeaturesTable) continue;
-    const featureMatch = line.match(/^(hooks|codex_hooks)\s*=\s*(.+)$/);
+    const featureMatch = line.match(/^(plugin_hooks|hooks|codex_hooks)\s*=\s*(.+)$/);
     if (!featureMatch) continue;
     assignFeatureFlag(featureMatch[1], featureMatch[2]);
   }
-  if (recommended === void 0 && alternate === void 0) return void 0;
+  if (pluginBundled === void 0 && recommended === void 0 && alternate === void 0) return void 0;
   return {
+    pluginBundled: pluginBundled === true,
     recommended: recommended === true,
     alternate: alternate === true
   };
@@ -11140,6 +11147,7 @@ function probeCodexHooksFeatureFlags(projectRoot) {
         ...candidate,
         exists: false,
         enabled: false,
+        pluginBundledEnabled: false,
         recommendedEnabled: false,
         alternateEnabled: false
       };
@@ -11149,7 +11157,8 @@ function probeCodexHooksFeatureFlags(projectRoot) {
       return {
         ...candidate,
         exists: true,
-        enabled: featureState?.recommended === true || featureState?.alternate === true,
+        enabled: featureState?.pluginBundled === true,
+        pluginBundledEnabled: featureState?.pluginBundled === true,
         recommendedEnabled: featureState?.recommended === true,
         alternateEnabled: featureState?.alternate === true
       };
@@ -11158,6 +11167,7 @@ function probeCodexHooksFeatureFlags(projectRoot) {
         ...candidate,
         exists: true,
         enabled: false,
+        pluginBundledEnabled: false,
         recommendedEnabled: false,
         alternateEnabled: false,
         parseError: error instanceof Error ? error.message : String(error)
@@ -11736,27 +11746,39 @@ function checkInstalledCodexHooksFeatureFlag(checks, rootDir, layout, options) {
   const checkedPaths = probes.map((probe) => `${probe.scope} ${probe.exists ? "config" : "path"}: ${probe.path}${probe.exists ? "" : " (missing)"}`).join("; ");
   const describeEnabledFlags = (probe) => {
     const enabledFlags = [];
+    if (probe.pluginBundledEnabled) enabledFlags.push(PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG);
     if (probe.recommendedEnabled) enabledFlags.push(RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG);
     if (probe.alternateEnabled) enabledFlags.push(ALTERNATE_CODEX_HOOKS_FEATURE_FLAG);
     return enabledFlags.join(" + ");
   };
+  const generalOnlyProbes = probes.filter((probe) => !probe.pluginBundledEnabled && (probe.recommendedEnabled || probe.alternateEnabled));
+  if (generalOnlyProbes.length > 0) {
+    addCheck(checks, {
+      level: "warning",
+      code: "consumer-codex-plugin-hooks-feature-flag-general-only",
+      title: "Codex config enables only general hook flags, not the plugin-bundled hook gate",
+      detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, but ${generalOnlyProbes.map((probe) => `${probe.scope} config ${probe.path}`).join(" and ")} enables only general hook flags (${generalOnlyProbes.map((probe) => describeEnabledFlags(probe)).join(" and ")}). Those general flags do not activate plugin-bundled hooks by themselves.`,
+      fix: `Enable \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the active Codex config, reload Codex, and rerun pluxx verify-install.`,
+      path: generalOnlyProbes[0].path
+    });
+  }
+  const legacyOnlyProbes = probes.filter((probe) => probe.alternateEnabled && !probe.recommendedEnabled);
+  if (legacyOnlyProbes.length > 0) {
+    addCheck(checks, {
+      level: "warning",
+      code: "consumer-codex-hooks-feature-flag-legacy-only",
+      title: "Codex config still uses the deprecated general hook compatibility flag",
+      detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, and the checked Codex config enables only the deprecated general hook flag \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\` in ${legacyOnlyProbes.map((probe) => `${probe.scope} config ${probe.path}`).join(" and ")}. That flag is not the plugin-bundled hook gate.`,
+      fix: `Prefer \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` only for non-plugin hook config if needed, and use \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` for plugin-bundled hooks. Reload Codex and rerun pluxx verify-install after updating the active config.`,
+      path: legacyOnlyProbes[0].path
+    });
+  }
   if (enabledProbes.length > 0) {
-    const legacyOnlyProbes = enabledProbes.filter((probe) => probe.alternateEnabled && !probe.recommendedEnabled);
-    if (legacyOnlyProbes.length > 0) {
-      addCheck(checks, {
-        level: "warning",
-        code: "consumer-codex-hooks-feature-flag-legacy-only",
-        title: "Codex hooks are enabled only through the legacy compatibility flag",
-        detail: `This installed Codex bundle declares hooks at ${hooksReference}, and the checked Codex config enables only \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\` in ${legacyOnlyProbes.map((probe) => `${probe.scope} config ${probe.path}`).join(" and ")}. Maintained interactive probes on May 13, 2026 showed local Codex CLI 0.130.0 emitting a deprecation warning for \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` that points users to \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\`.`,
-        fix: `Prefer \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the active Codex config, keep \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` only as a compatibility fallback if needed, reload Codex, and rerun pluxx verify-install.`,
-        path: legacyOnlyProbes[0].path
-      });
-    }
     addCheck(checks, {
       level: "success",
       code: "consumer-codex-hooks-feature-flag-enabled",
-      title: "Codex hook feature flag found for this install",
-      detail: `This installed Codex bundle declares hooks at ${hooksReference}, and a Codex hook feature flag was found in ${enabledProbes.map((probe) => `${probe.scope} config ${probe.path} (${describeEnabledFlags(probe)})`).join(" and ")}. Treat that as a prerequisite, not proof of live hook execution: maintained local probes on May 13, 2026 showed local Codex CLI 0.130.0 still failing to execute the project-local hook under \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\`, \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\`, and the current CLI feature path \`--enable hooks\`.`,
+      title: "Codex plugin-bundled hook feature flag found for this install",
+      detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, and the plugin hook gate was found in ${enabledProbes.map((probe) => `${probe.scope} config ${probe.path} (${describeEnabledFlags(probe)})`).join(" and ")}. Treat that as a prerequisite, not proof of live hook execution.`,
       fix: "No action needed.",
       path: enabledProbes[0].path
     });
@@ -11766,9 +11788,9 @@ function checkInstalledCodexHooksFeatureFlag(checks, rootDir, layout, options) {
   addCheck(checks, {
     level: "warning",
     code: "consumer-codex-hooks-feature-flag-missing",
-    title: "Codex hook activation is missing its known feature-gate prerequisite",
-    detail: `This installed Codex bundle declares hooks at ${hooksReference}, but neither \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` nor \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\` was found in the checked Codex config layers. Current Codex config surfaces still accept both keys under \`[features]\`, but maintained probes on May 13, 2026 showed local Codex CLI 0.130.0 still failing to execute the project-local hook under \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\`, \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG} = true\`, and the current CLI feature path \`--enable hooks\`, while also emitting a deprecation warning for \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` that points users to \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\`. Checked ${checkedPaths}.${parseErrors.length > 0 ? ` Unparseable config: ${parseErrors.join("; ")}.` : ""}`,
-    fix: `Enable \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the relevant project or user Codex config, reload Codex, and rerun pluxx verify-install. Keep \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` only as a compatibility fallback if your Codex runtime still needs it, and treat any enabled flag as best-effort activation rather than proof that hooks will execute.`,
+    title: "Codex plugin-bundled hook activation is missing its known feature-gate prerequisite",
+    detail: `This installed Codex bundle declares plugin-bundled hooks at ${hooksReference}, but \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` was not found in the checked Codex config layers. The general \`${RECOMMENDED_CODEX_HOOKS_FEATURE_FLAG}\` flag covers non-plugin hook config and defaults on, while \`${ALTERNATE_CODEX_HOOKS_FEATURE_FLAG}\` is deprecated and should not be treated as a plugin-bundled hook fallback. Checked ${checkedPaths}.${parseErrors.length > 0 ? ` Unparseable config: ${parseErrors.join("; ")}.` : ""}`,
+    fix: `Enable \`${PLUGIN_BUNDLED_CODEX_HOOKS_FEATURE_FLAG} = true\` under \`[features]\` in the relevant project or user Codex config, reload Codex, and rerun pluxx verify-install.`,
     path: probes.find((probe) => probe.exists)?.path ?? hooksReference
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchid-labs/pluxx",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Build AI agent plugins once. Prime-time on Claude Code, Cursor, Codex, and OpenCode, with beta generators for additional hosts.",
   "type": "module",
   "main": "dist/index.js",