octocms 0.3.4 → 0.3.5

package/dist/cli/index.js

@@ -8,7 +8,7 @@ import {
 } from "../chunk-33PHLOAE.js";
 
 // package.json
-var version = "0.3.4";
+var version = "0.3.5";
 
 // cli/index.ts
 var HELP = `

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../package.json","../../cli/index.ts"],"sourcesContent":["{\n  \"name\": \"octocms\",\n  \"version\": \"0.3.4\",\n  \"description\": \"A file-based CMS for Next.js — schema-driven, Git-backed, no database\",\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"keywords\": [\n    \"cms\",\n    \"nextjs\",\n    \"headless-cms\",\n    \"git-cms\",\n    \"content-management\"\n  ],\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/octocms/octocms.git\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"require\": \"./dist/index.cjs\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./query\": {\n      \"types\": \"./dist/query.d.ts\",\n      \"require\": \"./dist/query.cjs\",\n      \"import\": \"./dist/query.js\"\n    },\n    \"./config\": {\n      \"types\": \"./dist/config.d.ts\",\n      \"require\": \"./dist/config.cjs\",\n      \"import\": \"./dist/config.js\"\n    },\n    \"./defineConfig\": {\n      \"types\": \"./dist/defineConfig.d.ts\",\n      \"require\": \"./dist/defineConfig.cjs\",\n      \"import\": \"./dist/defineConfig.js\"\n    },\n    \"./types\": {\n      \"types\": \"./dist/types.d.ts\",\n      \"require\": \"./dist/types.cjs\",\n      \"import\": \"./dist/types.js\"\n    },\n    \"./withOctoCMS\": {\n      \"types\": \"./dist/withOctoCMS.d.ts\",\n      \"require\": \"./dist/withOctoCMS.cjs\",\n      \"import\": \"./dist/withOctoCMS.js\"\n    },\n    \"./components/public\": {\n      \"types\": \"./dist/components/public/index.d.ts\",\n      \"require\": \"./dist/components/public/index.cjs\",\n      \"import\": \"./dist/components/public/index.js\"\n    },\n    \"./admin/AdminApp\": \"./admin/AdminApp.tsx\",\n    \"./admin/pages/AdminLayout\": \"./admin/pages/AdminLayout.tsx\",\n    \"./globals.css\": \"./globals.css\",\n    \"./docs/*\": \"./docs/*\"\n  },\n  \"bin\": {\n    \"octocms\": \"dist/cli/index.js\"\n  },\n  \"files\": [\n    \"dist\",\n    \"docs\",\n    \"globals.css\",\n    \"admin\",\n    \"components\",\n    \"hooks\",\n    \"lib\",\n    \"index.ts\",\n    \"query.ts\",\n    \"config.ts\",\n    \"defineConfig.ts\",\n    \"types.ts\",\n    \"withOctoCMS.ts\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"prepublishOnly\": \"npm run checks && npm run build\",\n    \"lint\": \"oxlint .\",\n    \"lint:fix\": \"oxlint --fix .\",\n    \"fmt\": \"oxfmt .\",\n    \"fmt:check\": \"oxfmt --check .\",\n    \"test\": \"vitest\",\n    \"test:run\": \"vitest run\",\n    \"ts-check\": \"tsc --noEmit --incremental false\",\n    \"checks\": \"npm run lint && npm run ts-check && npm run fmt:check && npm run test:run\",\n    \"checks:fix\": \"npm run lint:fix && npm run fmt && npm run test:run\"\n  },\n  \"peerDependencies\": {\n    \"next\": \">=15\",\n    \"react\": \">=18\",\n    \"react-dom\": \">=18\"\n  },\n  \"dependencies\": {\n    \"@mdxeditor/editor\": \"^3.11.4\",\n    \"@radix-ui/react-avatar\": \"^1.1.11\",\n    \"@radix-ui/react-dialog\": \"^1.1.15\",\n    \"@radix-ui/react-dropdown-menu\": \"^2.1.16\",\n    \"@radix-ui/react-label\": \"^2.1.8\",\n    \"@radix-ui/react-select\": \"^2.2.6\",\n    \"@radix-ui/react-slot\": \"^1.2.4\",\n    \"@radix-ui/react-tabs\": \"^1.1.13\",\n    \"@radix-ui/react-toast\": \"^1.2.15\",\n    \"class-variance-authority\": \"^0.7.1\",\n    \"clsx\": \"^2.1.1\",\n    \"glob\": \"^11.0.0\",\n    \"lucide-react\": \"^1.7.0\",\n    \"minisearch\": \"^7.2.0\",\n    \"next-auth\": \"^4.24.13\",\n    \"octokit\": \"^4.1.4\",\n    \"react-markdown\": \"^10.1.0\",\n    \"rehype-sanitize\": \"^6.0.0\",\n    \"remark-gfm\": \"^4.0.1\",\n    \"remark-mdx\": \"^3.1.1\",\n    \"sharp\": \"^0.34.5\",\n    \"slugify\": \"^1.6.9\",\n    \"sonner\": \"^2.0.7\",\n    \"tailwind-merge\": \"^3.5.0\",\n    \"zod\": \"^4.3.6\"\n  },\n  \"devDependencies\": {\n    \"@testing-library/dom\": \"^10.4.1\",\n    \"@testing-library/react\": \"^16.3.2\",\n    \"@types/node\": \"^20\",\n    \"@types/react\": \"^19.2.14\",\n    \"@types/react-dom\": \"^19.2.3\",\n    \"@vitejs/plugin-react\": \"^6.0.1\",\n    \"jsdom\": \"^29.0.1\",\n    \"oxfmt\": \"^0.11.0\",\n    \"oxlint\": \"^0.17.0\",\n    \"tsup\": \"^8.0.0\",\n    \"typescript\": \"^5.9.3\",\n    \"vite-tsconfig-paths\": \"^6.1.1\",\n    \"vitest\": \"^4.1.2\"\n  }\n}\n","#!/usr/bin/env node\n/* eslint-disable no-console */\n\n/**\n * OctoCMS CLI — command-line tools for managing an OctoCMS project.\n *\n * Commands:\n *   init        Initialize OctoCMS in a Next.js project\n *   dev         Start development server with config watching\n *   types:gen   Generate TypeScript types from next.config.ts\n *   validate    Validate all content entries against the schema\n *   update      Regenerate admin route files\n *   agent-docs  Inject AI agent doc links into AGENTS.md\n *\n * Usage:\n *   octocms <command> [options]\n *   octocms --help\n *   octocms --version\n */\n\nimport { fmt, log } from './lib/logger';\nimport { resolveProjectRoot } from './lib/project';\nimport { version as VERSION } from '../package.json';\n\nconst HELP = `\n  ${fmt.bold('OctoCMS CLI')} v${VERSION}\n\n  Usage: octocms <command> [options]\n\n  ${fmt.bold('Commands:')}\n    init         Initialize OctoCMS in a Next.js project\n    dev          Start development server with config watching\n    types:gen    Generate TypeScript types from next.config.ts\n    validate     Validate all content entries against the schema\n    update       Regenerate admin route files\n    agent-docs   Inject AI agent doc links into AGENTS.md\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n    --version   Show version number\n\n  Run ${fmt.cyan('octocms <command> --help')} for command-specific help.\n`;\n\nconst COMMAND_HELP: Record<string, string> = {\n  init: `\n  ${fmt.bold('octocms init')} — Initialize OctoCMS in a Next.js project\n\n  Creates next.config.ts, admin route files, demo content, and updates\n  next.config.ts and tsconfig.json with required configuration.\n\n  ${fmt.bold('Usage:')} octocms init [options]\n\n  ${fmt.bold('Options:')}\n    --yes, -y   Accept all defaults (non-interactive)\n    --help      Show this help message\n`,\n  dev: `\n  ${fmt.bold('octocms dev')} — Start development server with config watching\n\n  Spawns Next.js dev server and watches next.config.ts. When the config\n  changes, types are automatically regenerated.\n\n  ${fmt.bold('Usage:')} octocms dev [options]\n\n  ${fmt.bold('Options:')}\n    --port <n>  Port number (default: 3000)\n    --help      Show this help message\n`,\n  'types:gen': `\n  ${fmt.bold('octocms types:gen')} — Generate TypeScript types from next.config.ts\n\n  Produces cms/__generated__/types.ts, enums.ts, content.d.ts, and index.ts.\n  Validates the config before generating.\n\n  ${fmt.bold('Usage:')} octocms types:gen\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n  validate: `\n  ${fmt.bold('octocms validate')} — Validate all content entries against the schema\n\n  Reads every JSON file in cms/content/, validates structure, field types,\n  required fields, select option values, reference targets, and companion files.\n\n  ${fmt.bold('Usage:')} octocms validate\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n  'agent-docs': `\n  ${fmt.bold('octocms agent-docs')} — Inject AI agent doc links into AGENTS.md\n\n  Creates AGENTS.md if it doesn't exist, or appends the OctoCMS section\n  if the file exists but doesn't reference the agent docs yet.\n\n  ${fmt.bold('Usage:')} octocms agent-docs\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n  update: `\n  ${fmt.bold('octocms update')} — Regenerate admin route files\n\n  Ensures src/app/cms/layout.tsx and the catch-all page re-export are\n  up-to-date with the latest OctoCMS version.\n\n  ${fmt.bold('Usage:')} octocms update\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n};\n\nfunction parseArgs(argv: string[]): { command: string | null; flags: Record<string, string | boolean> } {\n  const args = argv.slice(2); // skip node + script path\n  const flags: Record<string, string | boolean> = {};\n  let command: string | null = null;\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === '--help' || arg === '-h') {\n      flags.help = true;\n    } else if (arg === '--version' || arg === '-v') {\n      flags.version = true;\n    } else if (arg === '--yes' || arg === '-y') {\n      flags.yes = true;\n    } else if (arg === '--port') {\n      flags.port = args[++i] ?? '';\n    } else if (arg.startsWith('--port=')) {\n      flags.port = arg.slice(7);\n    } else if (!arg.startsWith('-') && !command) {\n      // Handle compound commands as single tokens\n      if (arg === 'types:gen' || arg === 'agent-docs') {\n        command = arg;\n      } else {\n        command = arg;\n      }\n    }\n  }\n\n  return { command, flags };\n}\n\nasync function main(): Promise<void> {\n  const { command, flags } = parseArgs(process.argv);\n\n  if (flags.version) {\n    console.log(VERSION);\n    return;\n  }\n\n  if (!command || flags.help) {\n    if (command && COMMAND_HELP[command]) {\n      console.log(COMMAND_HELP[command]);\n    } else {\n      console.log(HELP);\n    }\n    return;\n  }\n\n  if (COMMAND_HELP[command] && flags.help) {\n    console.log(COMMAND_HELP[command]);\n    return;\n  }\n\n  try {\n    switch (command) {\n      case 'init': {\n        // init doesn't need an existing project root — use cwd\n        const { initCommand } = await import('./commands/init');\n        await initCommand(process.cwd(), { yes: flags.yes === true });\n        break;\n      }\n      case 'dev': {\n        const projectRoot = resolveProjectRoot();\n        const { devCommand } = await import('./commands/dev');\n        const port = flags.port ? Number(flags.port) : undefined;\n        await devCommand(projectRoot, { port });\n        break;\n      }\n      case 'types:gen': {\n        const projectRoot = resolveProjectRoot();\n        const { typesGenCommand } = await import('./commands/typesGen');\n        await typesGenCommand(projectRoot);\n        break;\n      }\n      case 'validate': {\n        const projectRoot = resolveProjectRoot();\n        const { validateCommand } = await import('./commands/validate');\n        await validateCommand(projectRoot);\n        break;\n      }\n      case 'update': {\n        const projectRoot = resolveProjectRoot();\n        const { updateCommand } = await import('./commands/update');\n        await updateCommand(projectRoot);\n        break;\n      }\n      case 'agent-docs': {\n        const projectRoot = resolveProjectRoot();\n        const { agentDocsCommand } = await import('./commands/agentDocs');\n        await agentDocsCommand(projectRoot);\n        break;\n      }\n      default:\n        log.error(`Unknown command: ${command}`);\n        console.log(HELP);\n        process.exitCode = 1;\n    }\n  } catch (e) {\n    log.error((e as Error).message);\n    process.exitCode = 1;\n  }\n}\n\nmain();\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../package.json","../../cli/index.ts"],"sourcesContent":["{\n  \"name\": \"octocms\",\n  \"version\": \"0.3.5\",\n  \"description\": \"A file-based CMS for Next.js — schema-driven, Git-backed, no database\",\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"keywords\": [\n    \"cms\",\n    \"nextjs\",\n    \"headless-cms\",\n    \"git-cms\",\n    \"content-management\"\n  ],\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/octocms/octocms.git\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"require\": \"./dist/index.cjs\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./query\": {\n      \"types\": \"./dist/query.d.ts\",\n      \"require\": \"./dist/query.cjs\",\n      \"import\": \"./dist/query.js\"\n    },\n    \"./config\": {\n      \"types\": \"./dist/config.d.ts\",\n      \"require\": \"./dist/config.cjs\",\n      \"import\": \"./dist/config.js\"\n    },\n    \"./defineConfig\": {\n      \"types\": \"./dist/defineConfig.d.ts\",\n      \"require\": \"./dist/defineConfig.cjs\",\n      \"import\": \"./dist/defineConfig.js\"\n    },\n    \"./types\": {\n      \"types\": \"./dist/types.d.ts\",\n      \"require\": \"./dist/types.cjs\",\n      \"import\": \"./dist/types.js\"\n    },\n    \"./withOctoCMS\": {\n      \"types\": \"./dist/withOctoCMS.d.ts\",\n      \"require\": \"./dist/withOctoCMS.cjs\",\n      \"import\": \"./dist/withOctoCMS.js\"\n    },\n    \"./components/public\": {\n      \"types\": \"./dist/components/public/index.d.ts\",\n      \"require\": \"./dist/components/public/index.cjs\",\n      \"import\": \"./dist/components/public/index.js\"\n    },\n    \"./admin/AdminApp\": \"./admin/AdminApp.tsx\",\n    \"./admin/pages/AdminLayout\": \"./admin/pages/AdminLayout.tsx\",\n    \"./globals.css\": \"./globals.css\",\n    \"./docs/*\": \"./docs/*\"\n  },\n  \"bin\": {\n    \"octocms\": \"dist/cli/index.js\"\n  },\n  \"files\": [\n    \"dist\",\n    \"docs\",\n    \"globals.css\",\n    \"admin\",\n    \"components\",\n    \"hooks\",\n    \"lib\",\n    \"utils\",\n    \"index.ts\",\n    \"query.ts\",\n    \"config.ts\",\n    \"defineConfig.ts\",\n    \"github-public.ts\",\n    \"types.ts\",\n    \"withOctoCMS.ts\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"prepublishOnly\": \"npm run checks && npm run build\",\n    \"lint\": \"oxlint .\",\n    \"lint:fix\": \"oxlint --fix .\",\n    \"fmt\": \"oxfmt .\",\n    \"fmt:check\": \"oxfmt --check .\",\n    \"test\": \"vitest\",\n    \"test:run\": \"vitest run\",\n    \"ts-check\": \"tsc --noEmit --incremental false\",\n    \"checks\": \"npm run lint && npm run ts-check && npm run fmt:check && npm run test:run\",\n    \"checks:fix\": \"npm run lint:fix && npm run fmt && npm run test:run\"\n  },\n  \"peerDependencies\": {\n    \"next\": \">=15\",\n    \"react\": \">=18\",\n    \"react-dom\": \">=18\"\n  },\n  \"dependencies\": {\n    \"@mdxeditor/editor\": \"^3.11.4\",\n    \"@radix-ui/react-avatar\": \"^1.1.11\",\n    \"@radix-ui/react-dialog\": \"^1.1.15\",\n    \"@radix-ui/react-dropdown-menu\": \"^2.1.16\",\n    \"@radix-ui/react-label\": \"^2.1.8\",\n    \"@radix-ui/react-select\": \"^2.2.6\",\n    \"@radix-ui/react-slot\": \"^1.2.4\",\n    \"@radix-ui/react-tabs\": \"^1.1.13\",\n    \"@radix-ui/react-toast\": \"^1.2.15\",\n    \"class-variance-authority\": \"^0.7.1\",\n    \"clsx\": \"^2.1.1\",\n    \"glob\": \"^11.0.0\",\n    \"lucide-react\": \"^1.7.0\",\n    \"minisearch\": \"^7.2.0\",\n    \"next-auth\": \"^4.24.13\",\n    \"octokit\": \"^4.1.4\",\n    \"react-markdown\": \"^10.1.0\",\n    \"rehype-sanitize\": \"^6.0.0\",\n    \"remark-gfm\": \"^4.0.1\",\n    \"remark-mdx\": \"^3.1.1\",\n    \"sharp\": \"^0.34.5\",\n    \"slugify\": \"^1.6.9\",\n    \"sonner\": \"^2.0.7\",\n    \"tailwind-merge\": \"^3.5.0\",\n    \"zod\": \"^4.3.6\"\n  },\n  \"devDependencies\": {\n    \"@testing-library/dom\": \"^10.4.1\",\n    \"@testing-library/react\": \"^16.3.2\",\n    \"@types/node\": \"^20\",\n    \"@types/react\": \"^19.2.14\",\n    \"@types/react-dom\": \"^19.2.3\",\n    \"@vitejs/plugin-react\": \"^6.0.1\",\n    \"jsdom\": \"^29.0.1\",\n    \"oxfmt\": \"^0.11.0\",\n    \"oxlint\": \"^0.17.0\",\n    \"tsup\": \"^8.0.0\",\n    \"typescript\": \"^5.9.3\",\n    \"vite-tsconfig-paths\": \"^6.1.1\",\n    \"vitest\": \"^4.1.2\"\n  }\n}\n","#!/usr/bin/env node\n/* eslint-disable no-console */\n\n/**\n * OctoCMS CLI — command-line tools for managing an OctoCMS project.\n *\n * Commands:\n *   init        Initialize OctoCMS in a Next.js project\n *   dev         Start development server with config watching\n *   types:gen   Generate TypeScript types from next.config.ts\n *   validate    Validate all content entries against the schema\n *   update      Regenerate admin route files\n *   agent-docs  Inject AI agent doc links into AGENTS.md\n *\n * Usage:\n *   octocms <command> [options]\n *   octocms --help\n *   octocms --version\n */\n\nimport { fmt, log } from './lib/logger';\nimport { resolveProjectRoot } from './lib/project';\nimport { version as VERSION } from '../package.json';\n\nconst HELP = `\n  ${fmt.bold('OctoCMS CLI')} v${VERSION}\n\n  Usage: octocms <command> [options]\n\n  ${fmt.bold('Commands:')}\n    init         Initialize OctoCMS in a Next.js project\n    dev          Start development server with config watching\n    types:gen    Generate TypeScript types from next.config.ts\n    validate     Validate all content entries against the schema\n    update       Regenerate admin route files\n    agent-docs   Inject AI agent doc links into AGENTS.md\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n    --version   Show version number\n\n  Run ${fmt.cyan('octocms <command> --help')} for command-specific help.\n`;\n\nconst COMMAND_HELP: Record<string, string> = {\n  init: `\n  ${fmt.bold('octocms init')} — Initialize OctoCMS in a Next.js project\n\n  Creates next.config.ts, admin route files, demo content, and updates\n  next.config.ts and tsconfig.json with required configuration.\n\n  ${fmt.bold('Usage:')} octocms init [options]\n\n  ${fmt.bold('Options:')}\n    --yes, -y   Accept all defaults (non-interactive)\n    --help      Show this help message\n`,\n  dev: `\n  ${fmt.bold('octocms dev')} — Start development server with config watching\n\n  Spawns Next.js dev server and watches next.config.ts. When the config\n  changes, types are automatically regenerated.\n\n  ${fmt.bold('Usage:')} octocms dev [options]\n\n  ${fmt.bold('Options:')}\n    --port <n>  Port number (default: 3000)\n    --help      Show this help message\n`,\n  'types:gen': `\n  ${fmt.bold('octocms types:gen')} — Generate TypeScript types from next.config.ts\n\n  Produces cms/__generated__/types.ts, enums.ts, content.d.ts, and index.ts.\n  Validates the config before generating.\n\n  ${fmt.bold('Usage:')} octocms types:gen\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n  validate: `\n  ${fmt.bold('octocms validate')} — Validate all content entries against the schema\n\n  Reads every JSON file in cms/content/, validates structure, field types,\n  required fields, select option values, reference targets, and companion files.\n\n  ${fmt.bold('Usage:')} octocms validate\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n  'agent-docs': `\n  ${fmt.bold('octocms agent-docs')} — Inject AI agent doc links into AGENTS.md\n\n  Creates AGENTS.md if it doesn't exist, or appends the OctoCMS section\n  if the file exists but doesn't reference the agent docs yet.\n\n  ${fmt.bold('Usage:')} octocms agent-docs\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n  update: `\n  ${fmt.bold('octocms update')} — Regenerate admin route files\n\n  Ensures src/app/cms/layout.tsx and the catch-all page re-export are\n  up-to-date with the latest OctoCMS version.\n\n  ${fmt.bold('Usage:')} octocms update\n\n  ${fmt.bold('Options:')}\n    --help      Show this help message\n`,\n};\n\nfunction parseArgs(argv: string[]): { command: string | null; flags: Record<string, string | boolean> } {\n  const args = argv.slice(2); // skip node + script path\n  const flags: Record<string, string | boolean> = {};\n  let command: string | null = null;\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === '--help' || arg === '-h') {\n      flags.help = true;\n    } else if (arg === '--version' || arg === '-v') {\n      flags.version = true;\n    } else if (arg === '--yes' || arg === '-y') {\n      flags.yes = true;\n    } else if (arg === '--port') {\n      flags.port = args[++i] ?? '';\n    } else if (arg.startsWith('--port=')) {\n      flags.port = arg.slice(7);\n    } else if (!arg.startsWith('-') && !command) {\n      // Handle compound commands as single tokens\n      if (arg === 'types:gen' || arg === 'agent-docs') {\n        command = arg;\n      } else {\n        command = arg;\n      }\n    }\n  }\n\n  return { command, flags };\n}\n\nasync function main(): Promise<void> {\n  const { command, flags } = parseArgs(process.argv);\n\n  if (flags.version) {\n    console.log(VERSION);\n    return;\n  }\n\n  if (!command || flags.help) {\n    if (command && COMMAND_HELP[command]) {\n      console.log(COMMAND_HELP[command]);\n    } else {\n      console.log(HELP);\n    }\n    return;\n  }\n\n  if (COMMAND_HELP[command] && flags.help) {\n    console.log(COMMAND_HELP[command]);\n    return;\n  }\n\n  try {\n    switch (command) {\n      case 'init': {\n        // init doesn't need an existing project root — use cwd\n        const { initCommand } = await import('./commands/init');\n        await initCommand(process.cwd(), { yes: flags.yes === true });\n        break;\n      }\n      case 'dev': {\n        const projectRoot = resolveProjectRoot();\n        const { devCommand } = await import('./commands/dev');\n        const port = flags.port ? Number(flags.port) : undefined;\n        await devCommand(projectRoot, { port });\n        break;\n      }\n      case 'types:gen': {\n        const projectRoot = resolveProjectRoot();\n        const { typesGenCommand } = await import('./commands/typesGen');\n        await typesGenCommand(projectRoot);\n        break;\n      }\n      case 'validate': {\n        const projectRoot = resolveProjectRoot();\n        const { validateCommand } = await import('./commands/validate');\n        await validateCommand(projectRoot);\n        break;\n      }\n      case 'update': {\n        const projectRoot = resolveProjectRoot();\n        const { updateCommand } = await import('./commands/update');\n        await updateCommand(projectRoot);\n        break;\n      }\n      case 'agent-docs': {\n        const projectRoot = resolveProjectRoot();\n        const { agentDocsCommand } = await import('./commands/agentDocs');\n        await agentDocsCommand(projectRoot);\n        break;\n      }\n      default:\n        log.error(`Unknown command: ${command}`);\n        console.log(HELP);\n        process.exitCode = 1;\n    }\n  } catch (e) {\n    log.error((e as Error).message);\n    process.exitCode = 1;\n  }\n}\n\nmain();\n"],"mappings":"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","names":[]}

package/github-public.ts

@@ -0,0 +1,160 @@
+import { Octokit } from 'octokit';
+
+import { getConfig } from './lib/configStore';
+import { ContentSourceError, isContentSourceError, mapGitHubApiErrorToContentSource } from './lib/contentSourceError';
+
+export { isProductionMode } from './lib/githubContentMode';
+
+const getGitHubConfig = () => ({
+  owner: process.env.GITHUB_REPO_OWNER || '',
+  repo: process.env.GITHUB_REPO_NAME || '',
+  branch: getConfig().git.baseBranch,
+});
+
+export const assertGitHubConfig = () => {
+  const { owner, repo, branch } = getGitHubConfig();
+
+  if (!owner || !repo) {
+    throw new ContentSourceError(
+      'github_config',
+      'GitHub repository is not configured. Set environment variables GITHUB_REPO_OWNER and GITHUB_REPO_NAME.',
+    );
+  }
+
+  return { owner, repo, branch };
+};
+
+/**
+ * Create public-read Octokit clients.
+ *
+ * 1) Use CMS_GITHUB_TOKEN when available (private repos / higher rate limits).
+ *    NOTE: Do NOT use GITHUB_TOKEN — Vercel overrides it with its own system token.
+ * 2) Also try unauthenticated reads (public repos) to avoid hard dependency.
+ */
+export const getPublicOctokits = (): Octokit[] => {
+  const token = process.env.CMS_GITHUB_TOKEN?.trim();
+  const clients: Octokit[] = [];
+
+  if (token) {
+    clients.push(new Octokit({ auth: token }));
+  }
+
+  clients.push(new Octokit());
+
+  return clients;
+};
+
+/**
+ * When `config.git.publishedPointerBranch` is set, `cms/published.json` is read and written on
+ * that branch — use an unprotected branch so Publish avoids a protected base branch.
+ */
+export const getPublishedPointerRef = (): string | undefined => {
+  const v = getConfig().git.publishedPointerBranch?.trim();
+  return v || undefined;
+};
+
+/**
+ * Read a file from GitHub using a static server token (no user session required).
+ * Used by public pages to fetch content in production.
+ */
+export const readGitHubFilePublic = async (filePath: string, branch?: string): Promise<string | null> => {
+  const { owner, repo, branch: configBranch } = assertGitHubConfig();
+  const ref = branch ?? configBranch;
+  const clients = getPublicOctokits();
+
+  for (const octokit of clients) {
+    try {
+      const { data } = await octokit.rest.repos.getContent({
+        owner,
+        repo,
+        path: filePath,
+        ref,
+      });
+
+      if ('content' in data && data.type === 'file') {
+        return Buffer.from(data.content, 'base64').toString('utf-8');
+      }
+
+      return null;
+    } catch (error: any) {
+      if (error.status === 429) {
+        throw mapGitHubApiErrorToContentSource(error, { owner, repo, ref });
+      }
+
+      if (error.status === 401 || error.status === 403) {
+        // Try next client (e.g. unauthenticated) before giving up.
+        continue;
+      }
+
+      if (error.status === 404) {
+        // 404 can mean missing file, missing ref, or no repo access.
+        // Try next client if available before deciding.
+        continue;
+      }
+
+      throw mapGitHubApiErrorToContentSource(error, { owner, repo, ref });
+    }
+  }
+
+  // All clients failed — typical for private repos or invalid token permissions.
+  throw new ContentSourceError(
+    'github_auth',
+    `Cannot read ${owner}/${repo} (ref: ${ref}) from GitHub. For private repositories, set CMS_GITHUB_TOKEN with Contents: Read access on this repository.`,
+  );
+};
+
+/**
+ * List files in a directory from the GitHub repo.
+ * Returns an array of file paths.
+ */
+export const listGitHubFiles = async (dirPath: string, extension?: string, branch?: string): Promise<string[]> => {
+  const [octokit] = getPublicOctokits();
+  const { owner, repo, branch: configBranch } = assertGitHubConfig();
+  const ref = branch ?? configBranch;
+
+  try {
+    const { data } = await octokit.rest.repos.getContent({
+      owner,
+      repo,
+      path: dirPath,
+      ref,
+    });
+
+    if (!Array.isArray(data)) {
+      return [];
+    }
+
+    let files = data.filter((item) => item.type === 'file').map((item) => item.path);
+
+    if (extension) {
+      files = files.filter((f) => f.endsWith(extension));
+    }
+
+    return files;
+  } catch (error: any) {
+    if (error.status === 404) {
+      return [];
+    }
+    throw mapGitHubApiErrorToContentSource(error, { owner, repo, ref });
+  }
+};
+
+/**
+ * Read cms/published.json to determine which branch public pages read content from.
+ * Uses {@link getPublishedPointerRef} when set; otherwise reads from `config.git.baseBranch`.
+ * Falls back to base branch on missing file or invalid JSON.
+ */
+export const getPublishedBranch = async (): Promise<string> => {
+  const { branch: configBranch } = assertGitHubConfig();
+  const pointerRef = getPublishedPointerRef();
+
+  try {
+    const content = await readGitHubFilePublic('cms/published.json', pointerRef);
+    if (!content) return configBranch;
+    const parsed = JSON.parse(content);
+    return typeof parsed.branch === 'string' ? parsed.branch : configBranch;
+  } catch (e) {
+    if (isContentSourceError(e)) throw e;
+    return configBranch;
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocms",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "A file-based CMS for Next.js — schema-driven, Git-backed, no database",
   "license": "MIT",
   "type": "module",
@@ -67,10 +67,12 @@
     "components",
     "hooks",
     "lib",
+    "utils",
     "index.ts",
     "query.ts",
     "config.ts",
     "defineConfig.ts",
+    "github-public.ts",
     "types.ts",
     "withOctoCMS.ts"
   ],

package/utils/parseFileName.ts

@@ -0,0 +1,30 @@
+import { getConfig } from '../lib/configStore';
+
+import { SelectedFile } from '../types';
+
+export const parseFileName = (file: string): SelectedFile => {
+  const config = getConfig();
+  const nameWithoutFolder = file.replace(`${config.contentFolder}/`, '').replace('.json', '');
+  const split = nameWithoutFolder.split('/');
+  const type = split[0];
+  const id = split.pop() as string;
+
+  return { type, id, path: file };
+};
+
+export const parseMediaFileName = (file: string): SelectedFile => {
+  const config = getConfig();
+  let nameWithoutFolder = file.replace(`${config.mediaFolder}/`, '');
+  (config.mediaAllowedFormats || []).forEach((format) => {
+    nameWithoutFolder = nameWithoutFolder.replace(`.${format}`, '');
+  });
+  const split = nameWithoutFolder.split('/');
+  let type = split[0];
+  const id = split.pop() as string;
+
+  if (type === id) {
+    type = '/';
+  }
+
+  return { type, id, path: file };
+};