create-zudo-doc 5.8.0 → 5.9.0

package/README.md

@@ -73,7 +73,8 @@ Each feature has a `--[no-]<flag>` form. Passing `--feature` enables it; `--no-f
 | `--[no-]sidebar-filter` | Real-time sidebar filter | on |
 | `--[no-]image-enlarge` | Click-to-enlarge for oversized images | on |
 | `--[no-]tag-governance` | Vocabulary-aware tag audit + suggest scripts | off |
-| `--[no-]claude-resources` | Auto-generate Claude Code docs (`CLAUDE.md`, `llms.txt`) | off |
+| `--[no-]claude-resources` | Auto-generate Claude Code docs from `.claude/` | off |
+| `--[no-]codex-resources` | Auto-generate Codex docs from `.codex/` + `AGENTS.md` | off |
 | `--[no-]claude-skills` | Ship zudo-doc Claude Code skills (design-system, translate, version-bump) | off |
 | `--[no-]design-token-panel` | Interactive panel for tweaking spacing, font, color tokens | off |
 | `--[no-]sidebar-resizer` | Draggable sidebar width handle | off |

package/dist/claude-md-gen.js

@@ -127,6 +127,7 @@ export function generateCLAUDEFile(choices) {
         docHistory: "Document edit history",
         llmsTxt: "Generates llms.txt for LLM consumption",
         claudeResources: "Auto-generated docs for Claude Code resources",
+        codexResources: "Auto-generated docs for Codex resources (.codex/, AGENTS.md)",
         changelog: "Changelog page at `/docs/changelog`",
         tauri: "Desktop app wrapper (`cargo tauri dev` / `cargo tauri build`) — Cmd/Ctrl+F find bar via the package-owned `FindInPageInit` island (`findInPage: true` in `zfb.config.ts`)",
         tagGovernance: "Vocabulary-aware tag audit (`tags:audit`) / suggest (`tags:suggest`) scripts",

package/dist/cli.d.ts

@@ -17,6 +17,7 @@ export interface CliArgs {
     sidebarToggle?: boolean;
     versioning?: boolean;
     claudeResources?: boolean;
+    codexResources?: boolean;
     claudeSkills?: boolean;
     claudeSkillsWriting?: boolean;
     docHistory?: boolean;

package/dist/constants.js

@@ -212,6 +212,13 @@ export const FEATURES = [
         default: false,
         cliFlag: "claude-resources",
     },
+    {
+        value: "codexResources",
+        label: "Codex Resources",
+        hint: "Auto-generate Codex docs (.codex/, AGENTS.md)",
+        default: false,
+        cliFlag: "codex-resources",
+    },
     {
         value: "claudeSkills",
         label: "Claude skills (user-facing)",

package/dist/features/codex-resources.d.ts

@@ -0,0 +1,11 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Codex-resources feature.
+ *
+ * Fully plugin-owned (`@takazudo/zudo-doc/plugins/codex-resources`,
+ * `zudoDocPreset()` wires it whenever `settings.codexResources` is
+ * truthy). Generation is package-owned. This feature's touch points are now
+ * just: `codexResources` + `defaultLocaleOnlyPrefixes` fields
+ * (`zfb-config-gen.ts`).
+ */
+export declare const codexResourcesFeature: FeatureModule;

package/dist/features/codex-resources.js

@@ -0,0 +1,13 @@
+/**
+ * Codex-resources feature.
+ *
+ * Fully plugin-owned (`@takazudo/zudo-doc/plugins/codex-resources`,
+ * `zudoDocPreset()` wires it whenever `settings.codexResources` is
+ * truthy). Generation is package-owned. This feature's touch points are now
+ * just: `codexResources` + `defaultLocaleOnlyPrefixes` fields
+ * (`zfb-config-gen.ts`).
+ */
+export const codexResourcesFeature = () => ({
+    name: "codexResources",
+    injections: [],
+});

package/dist/features/index.js

@@ -14,6 +14,7 @@ import { tocToggleFeature } from "./toc-toggle.js";
 import { docHistoryFeature } from "./doc-history.js";
 import { llmsTxtFeature } from "./llms-txt.js";
 import { claudeResourcesFeature } from "./claude-resources.js";
+import { codexResourcesFeature } from "./codex-resources.js";
 import { designTokenPanelFeature } from "./design-token-panel.js";
 import { themePackSwitcherFeature } from "./theme-pack-switcher.js";
 import { i18nFeature } from "./i18n.js";
@@ -36,6 +37,7 @@ export const featureModules = {
     search: searchFeature,
     // sidebarFilter — built into sidebar-tree.tsx, stays in base
     claudeResources: claudeResourcesFeature,
+    codexResources: codexResourcesFeature,
     designTokenPanel: designTokenPanelFeature,
     themePackSwitcher: themePackSwitcherFeature,
     sidebarResizer: sidebarResizerFeature,

package/dist/scaffold.d.ts

@@ -32,5 +32,5 @@ export declare function deriveDocSkillName(projectName: string): string;
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^5.8.0";
+export declare const ZUDO_DOC_PIN = "^5.9.0";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -43,7 +43,7 @@ export function deriveDocSkillName(projectName) {
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^5.8.0";
+export const ZUDO_DOC_PIN = "^5.9.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -748,7 +748,7 @@ function generatePackageJson(choices) {
         // `/exclude` at module scope from the always-bundled chrome graph; #3110
         // moved compileExclude into @takazudo/zudo-doc, so docHistory-OFF projects
         // no longer need the package at all.
-        deps["@takazudo/zudo-doc-history-server"] = "^5.8.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^5.9.0";
         // tsx is no longer needed here: the relocated package plugin imports the
         // runner directly (no `tsx -e` spawn) since the package ships compiled
         // dist/ — package-first migration #2321 (#2337).

package/dist/zfb-config-gen.js

@@ -65,6 +65,7 @@ export const DEFAULT_MIRROR = {
     bodyFootUtilArea: false,
     versions: false,
     claudeResources: false,
+    codexResources: false,
     defaultLocaleOnlyPrefixes: [],
     footer: false,
     headerNav: [],
@@ -239,19 +240,22 @@ function buildDesiredConfig(choices) {
         desired.bodyFootUtilArea = false;
     }
     desired.versions = choices.features.includes("versioning") ? [] : false;
+    const defaultLocaleOnlyPrefixes = [];
     if (choices.features.includes("claudeResources")) {
         desired.claudeResources = { claudeDir: ".claude" };
-        desired.defaultLocaleOnlyPrefixes = [
-            "/docs/claude-md/",
-            "/docs/claude-skills/",
-            "/docs/claude-agents/",
-            "/docs/claude-commands/",
-        ];
+        defaultLocaleOnlyPrefixes.push("/docs/claude-md/", "/docs/claude-skills/", "/docs/claude-agents/", "/docs/claude-commands/");
     }
     else {
         desired.claudeResources = false;
-        desired.defaultLocaleOnlyPrefixes = [];
     }
+    if (choices.features.includes("codexResources")) {
+        desired.codexResources = { codexDir: ".codex" };
+        defaultLocaleOnlyPrefixes.push("/docs/codex-agents-md/", "/docs/codex-config/", "/docs/codex-agents/", "/docs/codex-hooks/", "/docs/codex-rules/", "/docs/codex-skills/");
+    }
+    else {
+        desired.codexResources = false;
+    }
+    desired.defaultLocaleOnlyPrefixes = defaultLocaleOnlyPrefixes;
     // ── Footer ────────────────────────────────────────────────────────────
     if (choices.features.includes("footerNavGroup") ||
         choices.features.includes("footerCopyright") ||
@@ -297,6 +301,13 @@ function buildDesiredConfig(choices) {
             categoryMatch: "claude",
         });
     }
+    if (choices.features.includes("codexResources")) {
+        headerNav.push({
+            label: "Codex",
+            path: "/docs/codex",
+            categoryMatch: "codex",
+        });
+    }
     if (choices.features.includes("changelog")) {
         headerNav.push({
             label: "Changelog",
@@ -368,6 +379,7 @@ const FIELD_ORDER = [
     "bodyFootUtilArea",
     "versions",
     "claudeResources",
+    "codexResources",
     "defaultLocaleOnlyPrefixes",
     "footer",
     "headerNav",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zudo-doc",
-  "version": "5.8.0",
+  "version": "5.9.0",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",

package/templates/features/claudeSkillsWriting/files/.claude/skills/zudo-doc-writing/SKILL.md

@@ -210,7 +210,7 @@ Check `zfb.config.ts`: if the `zudoDoc({...})` call sets a non-empty `locales` f
 Two carve-outs — do NOT create secondary-locale mirrors for these:
 
 - Pages with `generated: true` in frontmatter (build-generated content).
-- Paths listed in the `defaultLocaleOnlyPrefixes` setting in `zfb.config.ts` — default-locale-only by design (the Claude Resources feature, when enabled, registers its four `/docs/claude-*` prefixes there).
+- Paths listed in the `defaultLocaleOnlyPrefixes` setting in `zfb.config.ts` — default-locale-only by design (the Claude Resources and Codex Resources features, when enabled, register four `/docs/claude-*` prefixes and six `/docs/codex-*` prefixes there; their top-level `/docs/claude/` and `/docs/codex/` indexes remain bilingual).
 
 ## Common Mistakes (Do Not Do)