octocms 0.4.16 → 0.4.17

package/README.md

@@ -2,7 +2,7 @@
 
 A file-based CMS for Next.js. Schema defined in TypeScript, content stored as JSON files, Git-backed, no database.
 
-**[octocms.com](https://octocms.com)** · [Docs](https://octocms.com/docs)
+**[octocms.gunkin.dev](https://octocms.gunkin.dev)** · [Docs](https://octocms.gunkin.dev/docs)
 
 ## Requirements
 

package/dist/agent/chatSetup.d.ts

@@ -1,6 +1,6 @@
 import type { AgentConfig } from './types';
 /** OctoCMS product documentation — linked from the in-admin setup screen. */
-export declare const CHAT_AGENT_DOCS_HREF = "https://octocms.com/docs/chat-agent";
+export declare const CHAT_AGENT_DOCS_HREF = "https://octocms.gunkin.dev/docs/chat-agent";
 export type ChatSetupReason = 'no-config' | 'no-key' | 'budget-exceeded';
 export type ChatSetupStep = {
     title: string;

package/dist/agent/chatSetup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatSetup.d.ts","sourceRoot":"","sources":["../../agent/chatSetup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAE1D,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,wCAAwC,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGrF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAkC7F"}
+{"version":3,"file":"chatSetup.d.ts","sourceRoot":"","sources":["../../agent/chatSetup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAE1D,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,+CAA+C,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGrF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAkC7F"}

package/dist/agent/chatSetup.js

@@ -1,6 +1,6 @@
 import "../chunk-B5LE2OEC.js";
 import { getAgentStatus } from "./featureFlag";
-const CHAT_AGENT_DOCS_HREF = "https://octocms.com/docs/chat-agent";
+const CHAT_AGENT_DOCS_HREF = "https://octocms.gunkin.dev/docs/chat-agent";
 function isChatAgentReady(agentConfig) {
   if (!agentConfig) return false;
   return getAgentStatus(agentConfig).enabled;

package/dist/agent/chatSetup.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../agent/chatSetup.ts"],"sourcesContent":["import { getAgentStatus } from './featureFlag';\nimport type { AgentConfig, AgentProvider } from './types';\n\n/** OctoCMS product documentation — linked from the in-admin setup screen. */\nexport const CHAT_AGENT_DOCS_HREF = 'https://octocms.com/docs/chat-agent';\n\nexport type ChatSetupReason = 'no-config' | 'no-key' | 'budget-exceeded';\n\nexport type ChatSetupStep = {\n  title: string;\n  detail: string;\n  code?: string;\n};\n\nexport type ChatSetupInfo = {\n  reason: ChatSetupReason;\n  docsHref: string;\n  headline: string;\n  summary: string;\n  steps: ChatSetupStep[];\n};\n\nexport function isChatAgentReady(agentConfig: AgentConfig | null | undefined): boolean {\n  if (!agentConfig) return false;\n  return getAgentStatus(agentConfig).enabled;\n}\n\nexport function buildChatSetupInfo(agentConfig: AgentConfig | null | undefined): ChatSetupInfo {\n  if (!agentConfig) {\n    return {\n      reason: 'no-config',\n      docsHref: CHAT_AGENT_DOCS_HREF,\n      headline: 'Chat agent is not configured',\n      summary:\n        'The chat agent is optional. Follow the OctoCMS documentation to install dependencies, add agent settings to your project config, and connect a model provider.',\n      steps: noConfigSteps(),\n    };\n  }\n\n  const status = getAgentStatus(agentConfig);\n  if (status.enabled) {\n    throw new Error('buildChatSetupInfo called while agent is enabled');\n  }\n\n  if (status.reason === 'budget-exceeded') {\n    return {\n      reason: 'budget-exceeded',\n      docsHref: CHAT_AGENT_DOCS_HREF,\n      headline: 'Chat agent budget reached',\n      summary: `This deploy has reached the configured spend cap ($${status.budgetUSD.toFixed(2)}). Raise the limit in your agent config or restart the server to reset the in-memory counter.`,\n      steps: budgetExceededSteps(),\n    };\n  }\n\n  return {\n    reason: 'no-key',\n    docsHref: CHAT_AGENT_DOCS_HREF,\n    headline: 'Chat agent is not ready',\n    summary: providerCredentialSummary(agentConfig.provider),\n    steps: noKeySteps(agentConfig.provider),\n  };\n}\n\nfunction noConfigSteps(): ChatSetupStep[] {\n  return [\n    {\n      title: 'Read the setup guide',\n      detail:\n        'The documentation covers supported providers, required packages, and a full checklist for your environment.',\n    },\n    {\n      title: 'Add agent settings to your project',\n      detail:\n        'Export `agentConfig` from `cms/octocms.config.ts` using `defineAgentConfig`, alongside your main CMS config.',\n    },\n    {\n      title: 'Connect your model provider',\n      detail:\n        'Configure the provider block (hosted API or local endpoint) and add the credentials or URL your deployment expects. Restart the app after changing secrets.',\n    },\n    {\n      title: 'Index content for search (recommended)',\n      detail: 'Run the embeddings command from the docs so the agent can retrieve entries from your repository.',\n    },\n  ];\n}\n\nfunction noKeySteps(provider: AgentProvider): ChatSetupStep[] {\n  if (provider.type === 'local') {\n    return [\n      {\n        title: 'Confirm the local endpoint',\n        detail:\n          'Ensure your OpenAI-compatible server is running and that `agentConfig` points at the correct base URL for this deployment.',\n      },\n      {\n        title: 'Check optional auth',\n        detail: 'If your server requires an API key, set the env var named in `provider.apiKeyEnv` and restart.',\n      },\n      {\n        title: 'Restart after changes',\n        detail: 'Restart the dev server or redeploy so new environment variables are loaded.',\n      },\n    ];\n  }\n\n  return [\n    {\n      title: 'Add provider credentials',\n      detail:\n        'Set the API key (or custom env var) described in the setup guide for your chosen hosted provider, in local env files and production secrets.',\n    },\n    {\n      title: 'Restart or redeploy',\n      detail: 'Restart the dev server locally. On hosted platforms, redeploy after updating secrets.',\n    },\n    {\n      title: 'Install required packages',\n      detail: 'Install the chat and embedding dependencies listed in the documentation before sending a message.',\n    },\n  ];\n}\n\nfunction budgetExceededSteps(): ChatSetupStep[] {\n  return [\n    {\n      title: 'Raise the deploy cap',\n      detail:\n        'Increase `totalBudgetUSD` in `cms/octocms.config.ts`, or set it to `0` to disable the cap for this deploy.',\n    },\n    {\n      title: 'Or reset the in-memory counter',\n      detail: 'The spend tracker resets on cold start — redeploy or restart the dev server during testing.',\n    },\n    {\n      title: 'Use provider-side alerts',\n      detail: 'For production, also configure spend alerts in your model provider’s dashboard.',\n    },\n  ];\n}\n\nfunction providerCredentialSummary(provider: AgentProvider): string {\n  if (provider.type === 'local') {\n    return provider.baseURL\n      ? 'A local provider is configured, but the server could not reach the endpoint. Confirm the model server is running and accessible from this app.'\n      : 'A local provider needs an endpoint URL in `agentConfig`. See the setup guide for examples.';\n  }\n  const label = provider.type === 'anthropic' ? 'Anthropic' : 'OpenAI';\n  return `${label} is selected in config, but the required credentials are missing or empty. Follow the setup guide to add them and restart.`;\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAIxB,MAAM,uBAAuB;AAkB7B,SAAS,iBAAiB,aAAsD;AACrF,MAAI,CAAC,YAAa,QAAO;AACzB,SAAO,eAAe,WAAW,EAAE;AACrC;AAEO,SAAS,mBAAmB,aAA4D;AAC7F,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,SACE;AAAA,MACF,OAAO,cAAc;AAAA,IACvB;AAAA,EACF;AAEA,QAAM,SAAS,eAAe,WAAW;AACzC,MAAI,OAAO,SAAS;AAClB,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,MAAI,OAAO,WAAW,mBAAmB;AACvC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,SAAS,sDAAsD,OAAO,UAAU,QAAQ,CAAC,CAAC;AAAA,MAC1F,OAAO,oBAAoB;AAAA,IAC7B;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS,0BAA0B,YAAY,QAAQ;AAAA,IACvD,OAAO,WAAW,YAAY,QAAQ;AAAA,EACxC;AACF;AAEA,SAAS,gBAAiC;AACxC,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,WAAW,UAA0C;AAC5D,MAAI,SAAS,SAAS,SAAS;AAC7B,WAAO;AAAA,MACL;AAAA,QACE,OAAO;AAAA,QACP,QACE;AAAA,MACJ;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,sBAAuC;AAC9C,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,0BAA0B,UAAiC;AAClE,MAAI,SAAS,SAAS,SAAS;AAC7B,WAAO,SAAS,UACZ,mJACA;AAAA,EACN;AACA,QAAM,QAAQ,SAAS,SAAS,cAAc,cAAc;AAC5D,SAAO,GAAG,KAAK;AACjB;","names":[]}
+{"version":3,"sources":["../../agent/chatSetup.ts"],"sourcesContent":["import { getAgentStatus } from './featureFlag';\nimport type { AgentConfig, AgentProvider } from './types';\n\n/** OctoCMS product documentation — linked from the in-admin setup screen. */\nexport const CHAT_AGENT_DOCS_HREF = 'https://octocms.gunkin.dev/docs/chat-agent';\n\nexport type ChatSetupReason = 'no-config' | 'no-key' | 'budget-exceeded';\n\nexport type ChatSetupStep = {\n  title: string;\n  detail: string;\n  code?: string;\n};\n\nexport type ChatSetupInfo = {\n  reason: ChatSetupReason;\n  docsHref: string;\n  headline: string;\n  summary: string;\n  steps: ChatSetupStep[];\n};\n\nexport function isChatAgentReady(agentConfig: AgentConfig | null | undefined): boolean {\n  if (!agentConfig) return false;\n  return getAgentStatus(agentConfig).enabled;\n}\n\nexport function buildChatSetupInfo(agentConfig: AgentConfig | null | undefined): ChatSetupInfo {\n  if (!agentConfig) {\n    return {\n      reason: 'no-config',\n      docsHref: CHAT_AGENT_DOCS_HREF,\n      headline: 'Chat agent is not configured',\n      summary:\n        'The chat agent is optional. Follow the OctoCMS documentation to install dependencies, add agent settings to your project config, and connect a model provider.',\n      steps: noConfigSteps(),\n    };\n  }\n\n  const status = getAgentStatus(agentConfig);\n  if (status.enabled) {\n    throw new Error('buildChatSetupInfo called while agent is enabled');\n  }\n\n  if (status.reason === 'budget-exceeded') {\n    return {\n      reason: 'budget-exceeded',\n      docsHref: CHAT_AGENT_DOCS_HREF,\n      headline: 'Chat agent budget reached',\n      summary: `This deploy has reached the configured spend cap ($${status.budgetUSD.toFixed(2)}). Raise the limit in your agent config or restart the server to reset the in-memory counter.`,\n      steps: budgetExceededSteps(),\n    };\n  }\n\n  return {\n    reason: 'no-key',\n    docsHref: CHAT_AGENT_DOCS_HREF,\n    headline: 'Chat agent is not ready',\n    summary: providerCredentialSummary(agentConfig.provider),\n    steps: noKeySteps(agentConfig.provider),\n  };\n}\n\nfunction noConfigSteps(): ChatSetupStep[] {\n  return [\n    {\n      title: 'Read the setup guide',\n      detail:\n        'The documentation covers supported providers, required packages, and a full checklist for your environment.',\n    },\n    {\n      title: 'Add agent settings to your project',\n      detail:\n        'Export `agentConfig` from `cms/octocms.config.ts` using `defineAgentConfig`, alongside your main CMS config.',\n    },\n    {\n      title: 'Connect your model provider',\n      detail:\n        'Configure the provider block (hosted API or local endpoint) and add the credentials or URL your deployment expects. Restart the app after changing secrets.',\n    },\n    {\n      title: 'Index content for search (recommended)',\n      detail: 'Run the embeddings command from the docs so the agent can retrieve entries from your repository.',\n    },\n  ];\n}\n\nfunction noKeySteps(provider: AgentProvider): ChatSetupStep[] {\n  if (provider.type === 'local') {\n    return [\n      {\n        title: 'Confirm the local endpoint',\n        detail:\n          'Ensure your OpenAI-compatible server is running and that `agentConfig` points at the correct base URL for this deployment.',\n      },\n      {\n        title: 'Check optional auth',\n        detail: 'If your server requires an API key, set the env var named in `provider.apiKeyEnv` and restart.',\n      },\n      {\n        title: 'Restart after changes',\n        detail: 'Restart the dev server or redeploy so new environment variables are loaded.',\n      },\n    ];\n  }\n\n  return [\n    {\n      title: 'Add provider credentials',\n      detail:\n        'Set the API key (or custom env var) described in the setup guide for your chosen hosted provider, in local env files and production secrets.',\n    },\n    {\n      title: 'Restart or redeploy',\n      detail: 'Restart the dev server locally. On hosted platforms, redeploy after updating secrets.',\n    },\n    {\n      title: 'Install required packages',\n      detail: 'Install the chat and embedding dependencies listed in the documentation before sending a message.',\n    },\n  ];\n}\n\nfunction budgetExceededSteps(): ChatSetupStep[] {\n  return [\n    {\n      title: 'Raise the deploy cap',\n      detail:\n        'Increase `totalBudgetUSD` in `cms/octocms.config.ts`, or set it to `0` to disable the cap for this deploy.',\n    },\n    {\n      title: 'Or reset the in-memory counter',\n      detail: 'The spend tracker resets on cold start — redeploy or restart the dev server during testing.',\n    },\n    {\n      title: 'Use provider-side alerts',\n      detail: 'For production, also configure spend alerts in your model provider’s dashboard.',\n    },\n  ];\n}\n\nfunction providerCredentialSummary(provider: AgentProvider): string {\n  if (provider.type === 'local') {\n    return provider.baseURL\n      ? 'A local provider is configured, but the server could not reach the endpoint. Confirm the model server is running and accessible from this app.'\n      : 'A local provider needs an endpoint URL in `agentConfig`. See the setup guide for examples.';\n  }\n  const label = provider.type === 'anthropic' ? 'Anthropic' : 'OpenAI';\n  return `${label} is selected in config, but the required credentials are missing or empty. Follow the setup guide to add them and restart.`;\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAIxB,MAAM,uBAAuB;AAkB7B,SAAS,iBAAiB,aAAsD;AACrF,MAAI,CAAC,YAAa,QAAO;AACzB,SAAO,eAAe,WAAW,EAAE;AACrC;AAEO,SAAS,mBAAmB,aAA4D;AAC7F,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,SACE;AAAA,MACF,OAAO,cAAc;AAAA,IACvB;AAAA,EACF;AAEA,QAAM,SAAS,eAAe,WAAW;AACzC,MAAI,OAAO,SAAS;AAClB,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,MAAI,OAAO,WAAW,mBAAmB;AACvC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,SAAS,sDAAsD,OAAO,UAAU,QAAQ,CAAC,CAAC;AAAA,MAC1F,OAAO,oBAAoB;AAAA,IAC7B;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS,0BAA0B,YAAY,QAAQ;AAAA,IACvD,OAAO,WAAW,YAAY,QAAQ;AAAA,EACxC;AACF;AAEA,SAAS,gBAAiC;AACxC,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,WAAW,UAA0C;AAC5D,MAAI,SAAS,SAAS,SAAS;AAC7B,WAAO;AAAA,MACL;AAAA,QACE,OAAO;AAAA,QACP,QACE;AAAA,MACJ;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,sBAAuC;AAC9C,SAAO;AAAA,IACL;AAAA,MACE,OAAO;AAAA,MACP,QACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,0BAA0B,UAAiC;AAClE,MAAI,SAAS,SAAS,SAAS;AAC7B,WAAO,SAAS,UACZ,mJACA;AAAA,EACN;AACA,QAAM,QAAQ,SAAS,SAAS,cAAc,cAAc;AAC5D,SAAO,GAAG,KAAK;AACjB;","names":[]}

package/dist/agentDocs-6LQD3JUN.js

@@ -0,0 +1,54 @@
+import {
+  agentsMdSection,
+  agentsMdTemplate
+} from "./chunk-FZROCUU3.js";
+import {
+  log
+} from "./chunk-6PHFHGTZ.js";
+import "./chunk-DDAAVRWG.js";
+
+// cli/commands/agentDocs.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+var AGENT_DOCS_MARKER = "<!-- octocms:agent-docs -->";
+function upsertAgentsMdSection(content, section) {
+  const markerIndex = content.indexOf(AGENT_DOCS_MARKER);
+  if (markerIndex === -1) {
+    return content.trimEnd() + "\n\n" + section + "\n";
+  }
+  const before = content.slice(0, markerIndex).trimEnd();
+  const afterMarker = content.slice(markerIndex + AGENT_DOCS_MARKER.length);
+  const nextSectionIndex = afterMarker.indexOf("\n\n## ", 1);
+  const tail = nextSectionIndex === -1 ? "" : afterMarker.slice(nextSectionIndex + 2).trimStart();
+  const parts = [before, section.trimEnd()];
+  if (tail) parts.push(tail);
+  return parts.join("\n\n") + "\n";
+}
+async function agentDocsCommand(projectRoot) {
+  log.header("Agent documentation");
+  const agentsMdPath = join(projectRoot, "AGENTS.md");
+  const section = agentsMdSection();
+  if (!existsSync(agentsMdPath)) {
+    writeFileSync(agentsMdPath, agentsMdTemplate(), "utf8");
+    log.success("AGENTS.md \u2014 created with OctoCMS agent docs section");
+  } else {
+    const current = readFileSync(agentsMdPath, "utf8");
+    if (current.includes(AGENT_DOCS_MARKER)) {
+      writeFileSync(agentsMdPath, upsertAgentsMdSection(current, section), "utf8");
+      log.step("AGENTS.md \u2014 updated OctoCMS agent docs section");
+    } else {
+      writeFileSync(agentsMdPath, upsertAgentsMdSection(current, section), "utf8");
+      log.step("AGENTS.md \u2014 appended OctoCMS agent docs section");
+    }
+  }
+  log.blank();
+  log.info("Package docs: octocms/docs/overview.md, octocms/docs/editing-schema.md");
+  log.info("Project docs: cms/__generated__/agent-docs/ (regenerate with npm run agent-docs:gen)");
+  log.blank();
+}
+export {
+  AGENT_DOCS_MARKER,
+  agentDocsCommand,
+  upsertAgentsMdSection
+};
+//# sourceMappingURL=agentDocs-6LQD3JUN.js.map

package/dist/agentDocs-6LQD3JUN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/commands/agentDocs.ts"],"sourcesContent":["/**\n * `octocms agent-docs` — Inject AI agent documentation links into AGENTS.md.\n *\n * Creates AGENTS.md if it doesn't exist, or appends/replaces the OctoCMS section.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'fs';\nimport { join } from 'path';\n\nimport { log } from '../lib/logger';\nimport { agentsMdSection, agentsMdTemplate } from '../lib/templates';\n\nexport const AGENT_DOCS_MARKER = '<!-- octocms:agent-docs -->';\n\n/** Replace an existing OctoCMS section or append a new one. */\nexport function upsertAgentsMdSection(content: string, section: string): string {\n  const markerIndex = content.indexOf(AGENT_DOCS_MARKER);\n  if (markerIndex === -1) {\n    return content.trimEnd() + '\\n\\n' + section + '\\n';\n  }\n\n  const before = content.slice(0, markerIndex).trimEnd();\n  const afterMarker = content.slice(markerIndex + AGENT_DOCS_MARKER.length);\n  const nextSectionIndex = afterMarker.indexOf('\\n\\n## ', 1);\n  const tail = nextSectionIndex === -1 ? '' : afterMarker.slice(nextSectionIndex + 2).trimStart();\n  const parts = [before, section.trimEnd()];\n  if (tail) parts.push(tail);\n  return parts.join('\\n\\n') + '\\n';\n}\n\nexport async function agentDocsCommand(projectRoot: string): Promise<void> {\n  log.header('Agent documentation');\n\n  const agentsMdPath = join(projectRoot, 'AGENTS.md');\n  const section = agentsMdSection();\n\n  if (!existsSync(agentsMdPath)) {\n    writeFileSync(agentsMdPath, agentsMdTemplate(), 'utf8');\n    log.success('AGENTS.md — created with OctoCMS agent docs section');\n  } else {\n    const current = readFileSync(agentsMdPath, 'utf8');\n    if (current.includes(AGENT_DOCS_MARKER)) {\n      writeFileSync(agentsMdPath, upsertAgentsMdSection(current, section), 'utf8');\n      log.step('AGENTS.md — updated OctoCMS agent docs section');\n    } else {\n      writeFileSync(agentsMdPath, upsertAgentsMdSection(current, section), 'utf8');\n      log.step('AGENTS.md — appended OctoCMS agent docs section');\n    }\n  }\n\n  log.blank();\n  log.info('Package docs: octocms/docs/overview.md, octocms/docs/editing-schema.md');\n  log.info('Project docs: cms/__generated__/agent-docs/ (regenerate with npm run agent-docs:gen)');\n  log.blank();\n}\n"],"mappings":";;;;;;;;;;AAMA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,YAAY;AAKd,IAAM,oBAAoB;AAG1B,SAAS,sBAAsB,SAAiB,SAAyB;AAC9E,QAAM,cAAc,QAAQ,QAAQ,iBAAiB;AACrD,MAAI,gBAAgB,IAAI;AACtB,WAAO,QAAQ,QAAQ,IAAI,SAAS,UAAU;AAAA,EAChD;AAEA,QAAM,SAAS,QAAQ,MAAM,GAAG,WAAW,EAAE,QAAQ;AACrD,QAAM,cAAc,QAAQ,MAAM,cAAc,kBAAkB,MAAM;AACxE,QAAM,mBAAmB,YAAY,QAAQ,WAAW,CAAC;AACzD,QAAM,OAAO,qBAAqB,KAAK,KAAK,YAAY,MAAM,mBAAmB,CAAC,EAAE,UAAU;AAC9F,QAAM,QAAQ,CAAC,QAAQ,QAAQ,QAAQ,CAAC;AACxC,MAAI,KAAM,OAAM,KAAK,IAAI;AACzB,SAAO,MAAM,KAAK,MAAM,IAAI;AAC9B;AAEA,eAAsB,iBAAiB,aAAoC;AACzE,MAAI,OAAO,qBAAqB;AAEhC,QAAM,eAAe,KAAK,aAAa,WAAW;AAClD,QAAM,UAAU,gBAAgB;AAEhC,MAAI,CAAC,WAAW,YAAY,GAAG;AAC7B,kBAAc,cAAc,iBAAiB,GAAG,MAAM;AACtD,QAAI,QAAQ,0DAAqD;AAAA,EACnE,OAAO;AACL,UAAM,UAAU,aAAa,cAAc,MAAM;AACjD,QAAI,QAAQ,SAAS,iBAAiB,GAAG;AACvC,oBAAc,cAAc,sBAAsB,SAAS,OAAO,GAAG,MAAM;AAC3E,UAAI,KAAK,qDAAgD;AAAA,IAC3D,OAAO;AACL,oBAAc,cAAc,sBAAsB,SAAS,OAAO,GAAG,MAAM;AAC3E,UAAI,KAAK,sDAAiD;AAAA,IAC5D;AAAA,EACF;AAEA,MAAI,MAAM;AACV,MAAI,KAAK,wEAAwE;AACjF,MAAI,KAAK,sFAAsF;AAC/F,MAAI,MAAM;AACZ;","names":[]}

package/dist/chunk-CIKOAIJP.js

@@ -0,0 +1,7 @@
+// package.json
+var version = "0.4.17";
+
+export {
+  version
+};
+//# sourceMappingURL=chunk-CIKOAIJP.js.map

package/dist/{chunk-TOUAHFDW.js.map → chunk-CIKOAIJP.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"octocms\",\n  \"version\": \"0.4.16\",\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    \"./agent\": {\n      \"types\": \"./dist/agent/index.d.ts\",\n      \"require\": \"./dist/agent/index.cjs\",\n      \"import\": \"./dist/agent/index.js\"\n    },\n    \"./schema\": {\n      \"types\": \"./dist/schema/index.d.ts\",\n      \"import\": \"./dist/schema/index.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    \"./lib/configStore\": {\n      \"types\": \"./dist/lib/configStore.d.ts\",\n      \"require\": \"./dist/lib/configStore.cjs\",\n      \"import\": \"./dist/lib/configStore.js\"\n    },\n    \"./admin\": {\n      \"types\": \"./dist/admin/index.d.ts\",\n      \"import\": \"./dist/admin/index.js\"\n    },\n    \"./admin/*\": {\n      \"types\": \"./dist/admin/*.d.ts\",\n      \"import\": \"./dist/admin/*.js\"\n    },\n    \"./components/*\": {\n      \"types\": \"./dist/components/*.d.ts\",\n      \"import\": \"./dist/components/*.js\"\n    },\n    \"./hooks/*\": {\n      \"types\": \"./dist/hooks/*.d.ts\",\n      \"import\": \"./dist/hooks/*.js\"\n    },\n    \"./lib/*\": {\n      \"types\": \"./dist/lib/*.d.ts\",\n      \"import\": \"./dist/lib/*.js\"\n    },\n    \"./schema/*\": {\n      \"types\": \"./dist/schema/*.d.ts\",\n      \"import\": \"./dist/schema/*.js\"\n    },\n    \"./utils/*\": {\n      \"types\": \"./dist/utils/*.d.ts\",\n      \"import\": \"./dist/utils/*.js\"\n    },\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  ],\n  \"scripts\": {\n    \"build\": \"tsup && tsc -p tsconfig.build.json && cp globals.css dist/globals.css\",\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    \"@anthropic-ai/sdk\": \">=0.91\",\n    \"@huggingface/transformers\": \">=4\",\n    \"@mdxeditor/editor\": \">=3\",\n    \"@tanstack/react-query\": \">=5\",\n    \"mammoth\": \">=1.12\",\n    \"minisearch\": \">=7\",\n    \"next\": \">=15\",\n    \"next-auth\": \">=4\",\n    \"octokit\": \">=4\",\n    \"openai\": \">=4\",\n    \"pdfjs-dist\": \">=4\",\n    \"react\": \">=18\",\n    \"react-dom\": \">=18\",\n    \"react-markdown\": \">=10\",\n    \"rehype-sanitize\": \">=6\",\n    \"remark-gfm\": \">=4\",\n    \"remark-mdx\": \">=3\",\n    \"sharp\": \">=0.34\",\n    \"zod\": \">=4\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@anthropic-ai/sdk\": {\n      \"optional\": true\n    },\n    \"@huggingface/transformers\": {\n      \"optional\": true\n    },\n    \"mammoth\": {\n      \"optional\": true\n    },\n    \"openai\": {\n      \"optional\": true\n    },\n    \"pdfjs-dist\": {\n      \"optional\": true\n    }\n  },\n  \"devDependencies\": {\n    \"@tanstack/react-query\": \"^5.100.9\",\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"],"mappings":";AAEE,cAAW;","names":[]}
+{"version":3,"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"octocms\",\n  \"version\": \"0.4.17\",\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    \"./agent\": {\n      \"types\": \"./dist/agent/index.d.ts\",\n      \"require\": \"./dist/agent/index.cjs\",\n      \"import\": \"./dist/agent/index.js\"\n    },\n    \"./schema\": {\n      \"types\": \"./dist/schema/index.d.ts\",\n      \"import\": \"./dist/schema/index.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    \"./lib/configStore\": {\n      \"types\": \"./dist/lib/configStore.d.ts\",\n      \"require\": \"./dist/lib/configStore.cjs\",\n      \"import\": \"./dist/lib/configStore.js\"\n    },\n    \"./admin\": {\n      \"types\": \"./dist/admin/index.d.ts\",\n      \"import\": \"./dist/admin/index.js\"\n    },\n    \"./admin/*\": {\n      \"types\": \"./dist/admin/*.d.ts\",\n      \"import\": \"./dist/admin/*.js\"\n    },\n    \"./components/*\": {\n      \"types\": \"./dist/components/*.d.ts\",\n      \"import\": \"./dist/components/*.js\"\n    },\n    \"./hooks/*\": {\n      \"types\": \"./dist/hooks/*.d.ts\",\n      \"import\": \"./dist/hooks/*.js\"\n    },\n    \"./lib/*\": {\n      \"types\": \"./dist/lib/*.d.ts\",\n      \"import\": \"./dist/lib/*.js\"\n    },\n    \"./schema/*\": {\n      \"types\": \"./dist/schema/*.d.ts\",\n      \"import\": \"./dist/schema/*.js\"\n    },\n    \"./utils/*\": {\n      \"types\": \"./dist/utils/*.d.ts\",\n      \"import\": \"./dist/utils/*.js\"\n    },\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  ],\n  \"scripts\": {\n    \"build\": \"tsup && tsc -p tsconfig.build.json && cp globals.css dist/globals.css\",\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    \"@anthropic-ai/sdk\": \">=0.91\",\n    \"@huggingface/transformers\": \">=4\",\n    \"@mdxeditor/editor\": \">=3\",\n    \"@tanstack/react-query\": \">=5\",\n    \"mammoth\": \">=1.12\",\n    \"minisearch\": \">=7\",\n    \"next\": \">=15\",\n    \"next-auth\": \">=4\",\n    \"octokit\": \">=4\",\n    \"openai\": \">=4\",\n    \"pdfjs-dist\": \">=4\",\n    \"react\": \">=18\",\n    \"react-dom\": \">=18\",\n    \"react-markdown\": \">=10\",\n    \"rehype-sanitize\": \">=6\",\n    \"remark-gfm\": \">=4\",\n    \"remark-mdx\": \">=3\",\n    \"sharp\": \">=0.34\",\n    \"zod\": \">=4\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@anthropic-ai/sdk\": {\n      \"optional\": true\n    },\n    \"@huggingface/transformers\": {\n      \"optional\": true\n    },\n    \"mammoth\": {\n      \"optional\": true\n    },\n    \"openai\": {\n      \"optional\": true\n    },\n    \"pdfjs-dist\": {\n      \"optional\": true\n    }\n  },\n  \"devDependencies\": {\n    \"@tanstack/react-query\": \"^5.100.9\",\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"],"mappings":";AAEE,cAAW;","names":[]}

package/dist/{chunk-I7VNI2IG.js → chunk-FZROCUU3.js}

@@ -295,7 +295,7 @@ export default async function HelloPage() {
 function readmeTemplate(projectName) {
   return `# ${projectName}
 
-Built with [OctoCMS](https://octocms.com) \u2014 a file-based CMS on Next.js.
+Built with [OctoCMS](https://octocms.gunkin.dev) \u2014 a file-based CMS on Next.js.
 
 ## Setup
 
@@ -312,7 +312,7 @@ npm install octocms next-auth @tanstack/react-query @mdxeditor/editor \\
 
 ### 2. Create a GitHub App
 
-Follow the [OctoCMS GitHub App setup guide](https://octocms.com/docs/github-app) to create a GitHub App for authentication.
+Follow the [OctoCMS GitHub App setup guide](https://octocms.gunkin.dev/docs/github-app) to create a GitHub App for authentication.
 
 ### 3. Configure environment variables
 
@@ -367,12 +367,19 @@ function agentsMdSection() {
   return `${AGENT_DOCS_MARKER}
 ## OctoCMS \u2014 AI Content Management
 
-For tasks that involve creating, editing, or deleting CMS content directly (without the admin UI), read the auto-generated agent docs:
+For tasks that involve creating, editing, or deleting CMS content directly (without the admin UI), read these docs:
 
-- **\`octocms/docs/overview.md\`** \u2014 How to find, create, update, and delete content entries via file operations
-- **\`octocms/docs/schema.md\`** \u2014 Per-collection field definitions, example JSON, and file path conventions
+**Package docs (content-agnostic, stable):**
 
-These docs are generated from \`cms/octocms.config.ts\`. Regenerate after schema changes: \`npm run agent-docs:gen\`.`;
+- **\`octocms/docs/overview.md\`** \u2014 Generic content management (CRUD, entry shape, status values)
+- **\`octocms/docs/editing-schema.md\`** \u2014 How to edit \`cms/schema.json\` safely
+
+**Project docs (auto-generated from \`cms/schema.json\`):**
+
+- **\`cms/__generated__/agent-docs/schema.md\`** \u2014 Per-collection field definitions and example JSON
+- **\`cms/__generated__/agent-docs/collections.md\`** \u2014 Collection list and URL mapping
+
+Regenerate project docs after schema changes: \`npm run agent-docs:gen\` (or \`npm run types:gen\`).`;
 }
 function agentsMdTemplate() {
   return `# Project Guidelines
@@ -417,4 +424,4 @@ export {
   agentsMdTemplate,
   tsconfigPaths
 };
-//# sourceMappingURL=chunk-I7VNI2IG.js.map
+//# sourceMappingURL=chunk-FZROCUU3.js.map

package/dist/{chunk-I7VNI2IG.js.map → chunk-FZROCUU3.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../cli/lib/templates.ts"],"sourcesContent":["/**\n * File templates used by `octocms init` and `octocms update`.\n */\n\nconst CODEGEN_BANNER = `/*\n * AUTO-GENERATED — DO NOT EDIT.\n * Generated from cms/octocms.config.ts.\n * Run \\`npx octocms types:gen\\` to regenerate.\n */\n\n`;\n\n/** Static cms/__generated__/types.ts for the helloPage demo schema. */\nexport const generatedTypesTemplate =\n  CODEGEN_BANNER +\n  `import type { EntryStatus } from 'octocms/types';\n\nexport interface HelloPageFields {\n  title: string;\n  description: string;\n}\n\nexport interface HelloPageEntry {\n  sys: { id: string; type: 'helloPage'; status: EntryStatus };\n  fields: HelloPageFields;\n}\n\nexport type AnyEntry = HelloPageEntry;\n\nexport type EntryMap = {\n  helloPage: HelloPageEntry;\n};\n`;\n\n/** Static cms/__generated__/enums.ts for the helloPage demo schema. */\nexport const generatedEnumsTemplate =\n  CODEGEN_BANNER +\n  `export const CollectionName = {\n  HelloPage: 'helloPage',\n} as const;\nexport type CollectionName = (typeof CollectionName)[keyof typeof CollectionName];\n\nexport const COLLECTION_NAMES = ['helloPage'] as const;\n\nexport const FieldFormat = {\n  String: 'string',\n  Text: 'text',\n  Markdown: 'markdown',\n  Boolean: 'boolean',\n  Reference: 'reference',\n  Image: 'image',\n  Number: 'number',\n  Datetime: 'datetime',\n  Json: 'json',\n  Slug: 'slug',\n  Select: 'select',\n  Url: 'url',\n  Color: 'color',\n  Conditional: 'conditional',\n  Richtext: 'richtext',\n} as const;\nexport type FieldFormat = (typeof FieldFormat)[keyof typeof FieldFormat];\n`;\n\n/** Static cms/__generated__/content.d.ts for the helloPage demo schema. */\nexport const generatedContentDeclsTemplate =\n  CODEGEN_BANNER +\n  `import type { EntryStatus } from 'octocms/types';\n\n// Raw on-disk types (before query() processing).\nexport interface RawHelloPageFields {\n  title: string;\n  description: string;\n}\n\nexport interface RawHelloPageEntry {\n  sys: { id: string; type: 'helloPage'; status: EntryStatus };\n  fields: RawHelloPageFields;\n}\n`;\n\n/** Static cms/__generated__/index.ts — always the same shape. */\nexport const generatedIndexTemplate =\n  CODEGEN_BANNER +\n  `export * from './types';\nexport * from './enums';\nexport * from './query';\n`;\n\n/** Static cms/__generated__/query.ts — always the same shape (schema-independent). */\nexport const generatedQueryTemplate =\n  CODEGEN_BANNER +\n  `import { createQuery } from 'octocms/query';\nimport { configOctoCMS, type OctoConfig } from '../octocms.config';\nimport type { EntryMap } from './types';\n\n// configOctoCMS is widened to Config for admin internals; cast back to OctoConfig so\n// createQuery preserves literal collection/field names for type-safe queries.\nexport const query = createQuery<EntryMap, OctoConfig>(configOctoCMS as unknown as OctoConfig);\n`;\n\n/** Static cms/__generated__/configInit.ts — always the same shape (schema-independent). */\nexport const generatedConfigInitTemplate =\n  CODEGEN_BANNER +\n  `import { configOctoCMS } from '../octocms.config';\nimport { setConfig } from 'octocms/lib/configStore';\n\nsetConfig(configOctoCMS);\n`;\n\n/**\n * All scaffolded files import the generated config initialiser via the bare\n * specifier `cms/__generated__/configInit`. Resolution works in two layers:\n *\n *   - TypeScript IntelliSense: the consumer's `tsconfig.json` `paths` (added\n *     by `octocms init`).\n *   - Bundler: an alias registered by `withOctoCMS()` so Webpack and Turbopack\n *     resolve the bare specifier from anywhere — including `app/layout.tsx`,\n *     route handlers at any depth, and files inside `node_modules/octocms/`.\n *\n * This eliminates the previous depth-counting (`'../../../cms/...'`) that was\n * a recurring source of off-by-one bugs across templates and routes.\n */\nconst CONFIG_INIT_IMPORT = \"import 'cms/__generated__/configInit';\";\n\n/**\n * Minimal root layout written when `app/layout.tsx` does not already exist.\n * The configInit import is the critical side-effect; the rest is a Next.js\n * boilerplate shell.\n */\nexport const rootLayoutTemplate = `${CONFIG_INIT_IMPORT}\nimport type { Metadata } from 'next';\n\nexport const metadata: Metadata = {\n  title: 'My App',\n};\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    <html lang=\"en\">\n      <body>{children}</body>\n    </html>\n  );\n}\n`;\n\n/** The one-liner prepended to an existing root layout to register the config. */\nexport const rootLayoutConfigInitImport = `${CONFIG_INIT_IMPORT}\\n`;\n\nexport function buildAdminLayoutTemplate(): string {\n  return `${CONFIG_INIT_IMPORT}\nimport '@mdxeditor/editor/style.css';\nimport 'octocms/globals.css';\n\nexport { AdminLayout as default, metadata } from 'octocms/admin';\n`;\n}\n\n/**\n * Catch-all admin route — every \\`/cms/*\\` URL renders the package's\n * \\`AdminApp\\` async server component (awaits \\`params\\`, no outer Suspense).\n * Side-effect-imports \\`configInit\\` so server-action bundles register\n * \\`setConfig()\\` even when Next.js does not load \\`layout.tsx\\` for the POST.\n */\nexport function buildAdminPageTemplate(): string {\n  return `// Registers setConfig() for server actions — some POST bundles skip layout.tsx.\n${CONFIG_INIT_IMPORT}\n\nexport { AdminApp as default } from 'octocms/admin';\n`;\n}\n\n/**\n * Admin error boundary — rendered by Next.js when anything in the catch-all\n * tree throws during render. Re-uses the shared \\`AdminErrorView\\` so GitHub\n * config / auth / availability / rate-limit copy stays consistent with the\n * public-page error boundary.\n */\nexport const adminErrorTemplate = `'use client';\n\nexport { AdminError as default } from 'octocms/admin';\n`;\n\n/**\n * Historical template values used by \\`octocms update\\` to recognise an\n * unmodified install when migrating between routing models. Each entry is\n * the literal file content shipped by a previous OctoCMS version. If a\n * user-app file matches one of these byte-for-byte, \\`update\\` will replace\n * it with the current template; otherwise it leaves it alone.\n */\nexport const LEGACY_ADMIN_LAYOUT_TEMPLATES: ReadonlyArray<string> = [\n  // 0.4.x — re-exported from the deep path.\n  `import '../../cms/__generated__/configInit';\nimport 'octocms/globals.css';\nimport '@mdxeditor/editor/style.css';\n\nexport { AdminLayout as default, metadata } from 'octocms/admin/pages/AdminLayout';\n`,\n  // 0.5.x — barrel re-export with depth-counted relative configInit import.\n  `import '../../cms/__generated__/configInit';\nimport 'octocms/globals.css';\nimport '@mdxeditor/editor/style.css';\n\nexport { AdminLayout as default, metadata } from 'octocms/admin';\n`,\n];\n\nexport const LEGACY_ADMIN_CATCH_ALL_TEMPLATES: ReadonlyArray<string> = [\n  // 0.4.x — re-exported from the deep path.\n  `export { AdminApp as default } from 'octocms/admin/AdminApp';\n`,\n  // 0.5.x — barrel re-export without configInit on the page (server actions could miss setConfig).\n  `export { AdminApp as default } from 'octocms/admin';\n`,\n  // 0.5.x with depth-counted configInit (replaced by bare-specifier alias).\n  `// Registers setConfig() for server actions — some POST bundles skip layout.tsx.\nimport '../../../cms/__generated__/configInit';\n\nexport { AdminApp as default } from 'octocms/admin';\n`,\n];\n\nexport const nextAuthRouteTemplate = `import NextAuth from 'next-auth';\nimport { authOptions } from 'octocms/admin/auth';\n\nconst handler = NextAuth(authOptions);\n\nexport { handler as GET, handler as POST };\n`;\n\n/**\n * Build a thin re-export Route Handler for the chat-agent SSE endpoint.\n *\n * The actual handler lives in `octocms/agent/chatApi.ts`\n * (`chatRoute` / `chatStatusRoute`). The user-app file just:\n *   1. side-effect-imports `cms/__generated__/configInit` so\n *      `getAgentConfig()` resolves on cold start (Route Handlers don't run\n *      `app/layout.tsx`); and\n *   2. re-exports `chatRoute` as `POST` and `chatStatusRoute` as `GET`.\n *\n * The configInit import uses the bare specifier (resolved by the bundler\n * alias from `withOctoCMS()`), so the route file is depth-agnostic and can be\n * placed under `app/` or `src/app/` without code changes.\n */\nexport function agentChatRouteTemplate(): string {\n  return `// Side-effect import: registers \\`configOctoCMS\\` + \\`agentConfig\\` into the\n// runtime stores so \\`getAgentConfig()\\` resolves on cold start. Route Handlers\n// don't run \\`app/layout.tsx\\`, so this import has to live here.\n${CONFIG_INIT_IMPORT}\n\nexport { chatRoute as POST, chatStatusRoute as GET } from 'octocms/agent';\n`;\n}\n\n/**\n * Build a thin re-export Route Handler for the `/media/[...slug]` proxy.\n *\n * The actual handler lives in `octocms/admin/mediaRoute.ts`\n * (`mediaRoute`). The user-app file just:\n *   1. side-effect-imports `cms/__generated__/configInit` so `getConfig()`\n *      resolves on cold start (Route Handlers don't run `app/layout.tsx`); and\n *   2. re-exports `mediaRoute` as `GET`.\n *\n * The configInit import uses the bare specifier (resolved by the bundler\n * alias from `withOctoCMS()`), so the route file is depth-agnostic.\n */\nexport function mediaRouteTemplate(): string {\n  return `// Side-effect import: registers \\`configOctoCMS\\` into the runtime store so\n// \\`getConfig()\\` resolves on cold start. Route Handlers don't run\n// \\`app/layout.tsx\\`, so this import has to live here.\n${CONFIG_INIT_IMPORT}\n\nexport { mediaRoute as GET } from 'octocms/admin/mediaRoute';\n`;\n}\n\n/**\n * Build a thin re-export Route Handler for the public-site `/api/search`\n * endpoint consumed by the `SearchBox` component shipped at\n * `octocms/components/public`.\n *\n * The actual handler lives in `octocms/admin/searchRoute.ts`\n * (`searchRoute`). The user-app file just:\n *   1. side-effect-imports `cms/__generated__/configInit` so `getConfig()`\n *      resolves on cold start (Route Handlers don't run `app/layout.tsx`); and\n *   2. re-exports `searchRoute` as `GET`.\n *\n * The configInit import uses the bare specifier (resolved by the bundler\n * alias from `withOctoCMS()`), so the route file is depth-agnostic.\n */\nexport function searchRouteTemplate(): string {\n  return `// Side-effect import: registers \\`configOctoCMS\\` into the runtime store so\n// \\`getConfig()\\` resolves on cold start. Route Handlers don't run\n// \\`app/layout.tsx\\`, so this import has to live here.\n${CONFIG_INIT_IMPORT}\n\nexport { searchRoute as GET } from 'octocms/admin/searchRoute';\n`;\n}\n\ntype SchemaInitOpts = { projectName: string; baseBranch: string; pointerBranch?: string };\n\n/**\n * The starter schema used by `octocms init`. The data lives in `cms/schema.json`\n * (source of truth — hand-editable + edited by the Content Model UI). The other\n * two scaffolded files (`cms/__generated__/schema.ts` and `cms/octocms.config.ts`)\n * mirror this same shape — keep them aligned by editing here only and letting\n * `npx octocms types:gen` regenerate the rest in the user's project.\n */\nfunction buildStarterSchema(opts: SchemaInitOpts): Record<string, unknown> {\n  const git: Record<string, string> = { baseBranch: opts.baseBranch };\n  if (opts.pointerBranch) git.publishedPointerBranch = opts.pointerBranch;\n  return {\n    projectName: opts.projectName,\n    git,\n    contentFolder: 'cms/content',\n    mediaContentFolder: 'cms/media',\n    mediaFolder: 'public/media',\n    mediaAllowedFormats: ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'avif'],\n    collections: {\n      helloPage: {\n        label: 'Hello Page',\n        fields: {\n          title: { label: 'Title', format: 'string', entryTitle: true, required: true },\n          description: { label: 'Description', format: 'text' },\n        },\n      },\n    },\n  };\n}\n\n/**\n * `cms/schema.json` — the source of truth. The Content Model UI (`/cms/model`)\n * reads and writes this file via `getSchema()` / `saveSchema()` server actions.\n */\nexport function schemaJsonTemplate(opts: SchemaInitOpts): string {\n  return JSON.stringify(buildStarterSchema(opts), null, 2) + '\\n';\n}\n\n/**\n * `cms/__generated__/schema.ts` — auto-generated literal-typed mirror of\n * `cms/schema.json`. Required because `query()` infers narrow collection /\n * field / format types from the literal `defineConfig()` call — a plain JSON\n * import cannot preserve those literals.\n *\n * `npx octocms types:gen` regenerates this from `cms/schema.json` after every\n * schema edit (and `npm run types:check` fails on drift).\n */\nexport function generatedSchemaShimTemplate(opts: SchemaInitOpts): string {\n  const gitBlock = opts.pointerBranch\n    ? `  git: {\\n    baseBranch: '${opts.baseBranch}',\\n    publishedPointerBranch: '${opts.pointerBranch}',\\n  },`\n    : `  git: { baseBranch: '${opts.baseBranch}' },`;\n  return `/*\n * AUTO-GENERATED — DO NOT EDIT.\n * Generated from cms/schema.json.\n * Run \\`npx octocms types:gen\\` to regenerate.\n */\n\nimport { defineConfig } from 'octocms/defineConfig';\n\nexport const schema = defineConfig({\n  projectName: '${opts.projectName}',\n${gitBlock}\n  contentFolder: 'cms/content',\n  mediaContentFolder: 'cms/media',\n  mediaFolder: 'public/media',\n  mediaAllowedFormats: ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'avif'],\n  collections: {\n    helloPage: {\n      label: 'Hello Page',\n      fields: {\n        title: { label: 'Title', format: 'string', entryTitle: true, required: true },\n        description: { label: 'Description', format: 'text' },\n      },\n    },\n  },\n});\n`;\n}\n\n/**\n * `cms/octocms.config.ts` — thin TS binding. Imports the literal-typed\n * `schema` from the generated shim and re-exports it as `configOctoCMS` (the\n * runtime `Config`) and `OctoConfig` (the literal type used by `query()`).\n *\n * Hand-edits should go to `cms/schema.json`. After editing the JSON, run\n * `npx octocms types:gen` to refresh `cms/__generated__/schema.ts`.\n */\nexport function octoConfigTemplate(_opts: SchemaInitOpts): string {\n  return `import type { Config } from 'octocms/types';\nimport { schema } from './__generated__/schema';\n\n/**\n * The schema is defined in \\`cms/schema.json\\` (source of truth — hand-editable\n * and editable through the Content Model UI). \\`npx octocms types:gen\\` mirrors\n * it into \\`cms/__generated__/schema.ts\\` as a literal-typed \\`defineConfig()\\`\n * call so the downstream \\`query()\\` API can infer narrow collection / field /\n * format types (which a plain JSON import cannot preserve).\n *\n * \\`npm run types:check\\` fails if the JSON and the generated shim drift.\n */\nconst _typedConfigOctoCMS = schema;\n\n/** Runtime config — widened to \\`Config\\` for dynamic indexing in CMS internals. */\nexport const configOctoCMS: Config = _typedConfigOctoCMS as Config;\n\n/**\n * Exact literal type of the config — use this for type-level inference only\n * (e.g. the \\`query()\\` API derives collection/field names from it).\n */\nexport type OctoConfig = typeof _typedConfigOctoCMS;\n`;\n}\n\nexport function nextConfigTemplate(): string {\n  return `import type { NextConfig } from 'next';\nimport { withOctoCMS } from 'octocms/config';\nimport { configOctoCMS } from './cms/octocms.config';\n\nexport { configOctoCMS } from './cms/octocms.config';\nexport type { OctoConfig } from './cms/octocms.config';\n\nconst nextConfig: NextConfig = {};\n\nexport default withOctoCMS(nextConfig, configOctoCMS);\n`;\n}\n\nexport function demoHelloPageJson(): string {\n  return JSON.stringify(\n    {\n      sys: { id: '0000', type: 'helloPage', status: 'merged' },\n      fields: {\n        title: 'Hello World',\n        description: 'Welcome to your new OctoCMS site! Edit this content in the CMS admin panel.',\n      },\n    },\n    null,\n    2,\n  );\n}\n\nexport const helloPageTemplate = `import { query } from 'cms/__generated__/query';\n\nexport default async function HelloPage() {\n  const page = await query('helloPage').first();\n  if (!page) return null;\n  return (\n    <main>\n      <h1>{page.fields.title}</h1>\n      <p>{page.fields.description}</p>\n    </main>\n  );\n}\n`;\n\nexport function readmeTemplate(projectName: string): string {\n  return `# ${projectName}\n\nBuilt with [OctoCMS](https://octocms.com) — a file-based CMS on Next.js.\n\n## Setup\n\n### 1. Install dependencies\n\n\\`\\`\\`bash\nnpm install octocms next-auth @tanstack/react-query @mdxeditor/editor \\\\\n  minisearch octokit \\\\\n  react-markdown rehype-sanitize remark-gfm remark-mdx \\\\\n  sharp zod\n\\`\\`\\`\n\n> The exact list (with the right \\`octocms\\` version pin) is also printed by \\`npx octocms init\\` — copy it from there.\n\n### 2. Create a GitHub App\n\nFollow the [OctoCMS GitHub App setup guide](https://octocms.com/docs/github-app) to create a GitHub App for authentication.\n\n### 3. Configure environment variables\n\nCopy the values from your GitHub App into \\`.env.local\\`:\n\n\\`\\`\\`bash\n# GitHub App credentials (required for CMS auth)\nGITHUB_ID=your_github_app_client_id\nGITHUB_SECRET=your_github_app_client_secret\n\n# NextAuth (generate secret: openssl rand -base64 32)\nNEXTAUTH_SECRET=your_nextauth_secret\nNEXTAUTH_URL=http://localhost:3000\n\n# GitHub repo for content storage (required in production)\nGITHUB_REPO_OWNER=your_github_username_or_org\nGITHUB_REPO_NAME=your_repo_name\n\n# Optional: static GitHub token for private repos / higher API rate limits\n# CMS_GITHUB_TOKEN=your_github_pat\n\\`\\`\\`\n\n### 4. Run the dev server\n\n\\`\\`\\`bash\nnpm run dev\n\\`\\`\\`\n\nOpen [http://localhost:3000/cms](http://localhost:3000/cms) to access the CMS admin.\n`;\n}\n\nexport function envLocalTemplate(): string {\n  return `# GitHub App credentials (required for CMS auth)\n# Create a GitHub App at: https://github.com/settings/apps/new\nGITHUB_ID=\nGITHUB_SECRET=\n\n# NextAuth secret — generate with: openssl rand -base64 32\nNEXTAUTH_SECRET=\nNEXTAUTH_URL=http://localhost:3000\n\n# GitHub repo for content storage (required in production)\nGITHUB_REPO_OWNER=\nGITHUB_REPO_NAME=\n\n# Optional: static GitHub token for private repos or higher API rate limits\n# CMS_GITHUB_TOKEN=\n`;\n}\n\nconst AGENT_DOCS_MARKER = '<!-- octocms:agent-docs -->';\n\nexport function agentsMdSection(): string {\n  return `${AGENT_DOCS_MARKER}\n## OctoCMS — AI Content Management\n\nFor tasks that involve creating, editing, or deleting CMS content directly (without the admin UI), read the auto-generated agent docs:\n\n- **\\`octocms/docs/overview.md\\`** — How to find, create, update, and delete content entries via file operations\n- **\\`octocms/docs/schema.md\\`** — Per-collection field definitions, example JSON, and file path conventions\n\nThese docs are generated from \\`cms/octocms.config.ts\\`. Regenerate after schema changes: \\`npm run agent-docs:gen\\`.`;\n}\n\nexport function agentsMdTemplate(): string {\n  return `# Project Guidelines\n\n${agentsMdSection()}\n`;\n}\n\nexport function tsconfigPaths(): Record<string, string[]> {\n  return {\n    'cms/__generated__': ['./cms/__generated__/index.ts'],\n    'cms/__generated__/*': ['./cms/__generated__/*'],\n    '@/*': ['./src/*'],\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../cli/lib/templates.ts"],"sourcesContent":["/**\n * File templates used by `octocms init` and `octocms update`.\n */\n\nconst CODEGEN_BANNER = `/*\n * AUTO-GENERATED — DO NOT EDIT.\n * Generated from cms/octocms.config.ts.\n * Run \\`npx octocms types:gen\\` to regenerate.\n */\n\n`;\n\n/** Static cms/__generated__/types.ts for the helloPage demo schema. */\nexport const generatedTypesTemplate =\n  CODEGEN_BANNER +\n  `import type { EntryStatus } from 'octocms/types';\n\nexport interface HelloPageFields {\n  title: string;\n  description: string;\n}\n\nexport interface HelloPageEntry {\n  sys: { id: string; type: 'helloPage'; status: EntryStatus };\n  fields: HelloPageFields;\n}\n\nexport type AnyEntry = HelloPageEntry;\n\nexport type EntryMap = {\n  helloPage: HelloPageEntry;\n};\n`;\n\n/** Static cms/__generated__/enums.ts for the helloPage demo schema. */\nexport const generatedEnumsTemplate =\n  CODEGEN_BANNER +\n  `export const CollectionName = {\n  HelloPage: 'helloPage',\n} as const;\nexport type CollectionName = (typeof CollectionName)[keyof typeof CollectionName];\n\nexport const COLLECTION_NAMES = ['helloPage'] as const;\n\nexport const FieldFormat = {\n  String: 'string',\n  Text: 'text',\n  Markdown: 'markdown',\n  Boolean: 'boolean',\n  Reference: 'reference',\n  Image: 'image',\n  Number: 'number',\n  Datetime: 'datetime',\n  Json: 'json',\n  Slug: 'slug',\n  Select: 'select',\n  Url: 'url',\n  Color: 'color',\n  Conditional: 'conditional',\n  Richtext: 'richtext',\n} as const;\nexport type FieldFormat = (typeof FieldFormat)[keyof typeof FieldFormat];\n`;\n\n/** Static cms/__generated__/content.d.ts for the helloPage demo schema. */\nexport const generatedContentDeclsTemplate =\n  CODEGEN_BANNER +\n  `import type { EntryStatus } from 'octocms/types';\n\n// Raw on-disk types (before query() processing).\nexport interface RawHelloPageFields {\n  title: string;\n  description: string;\n}\n\nexport interface RawHelloPageEntry {\n  sys: { id: string; type: 'helloPage'; status: EntryStatus };\n  fields: RawHelloPageFields;\n}\n`;\n\n/** Static cms/__generated__/index.ts — always the same shape. */\nexport const generatedIndexTemplate =\n  CODEGEN_BANNER +\n  `export * from './types';\nexport * from './enums';\nexport * from './query';\n`;\n\n/** Static cms/__generated__/query.ts — always the same shape (schema-independent). */\nexport const generatedQueryTemplate =\n  CODEGEN_BANNER +\n  `import { createQuery } from 'octocms/query';\nimport { configOctoCMS, type OctoConfig } from '../octocms.config';\nimport type { EntryMap } from './types';\n\n// configOctoCMS is widened to Config for admin internals; cast back to OctoConfig so\n// createQuery preserves literal collection/field names for type-safe queries.\nexport const query = createQuery<EntryMap, OctoConfig>(configOctoCMS as unknown as OctoConfig);\n`;\n\n/** Static cms/__generated__/configInit.ts — always the same shape (schema-independent). */\nexport const generatedConfigInitTemplate =\n  CODEGEN_BANNER +\n  `import { configOctoCMS } from '../octocms.config';\nimport { setConfig } from 'octocms/lib/configStore';\n\nsetConfig(configOctoCMS);\n`;\n\n/**\n * All scaffolded files import the generated config initialiser via the bare\n * specifier `cms/__generated__/configInit`. Resolution works in two layers:\n *\n *   - TypeScript IntelliSense: the consumer's `tsconfig.json` `paths` (added\n *     by `octocms init`).\n *   - Bundler: an alias registered by `withOctoCMS()` so Webpack and Turbopack\n *     resolve the bare specifier from anywhere — including `app/layout.tsx`,\n *     route handlers at any depth, and files inside `node_modules/octocms/`.\n *\n * This eliminates the previous depth-counting (`'../../../cms/...'`) that was\n * a recurring source of off-by-one bugs across templates and routes.\n */\nconst CONFIG_INIT_IMPORT = \"import 'cms/__generated__/configInit';\";\n\n/**\n * Minimal root layout written when `app/layout.tsx` does not already exist.\n * The configInit import is the critical side-effect; the rest is a Next.js\n * boilerplate shell.\n */\nexport const rootLayoutTemplate = `${CONFIG_INIT_IMPORT}\nimport type { Metadata } from 'next';\n\nexport const metadata: Metadata = {\n  title: 'My App',\n};\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    <html lang=\"en\">\n      <body>{children}</body>\n    </html>\n  );\n}\n`;\n\n/** The one-liner prepended to an existing root layout to register the config. */\nexport const rootLayoutConfigInitImport = `${CONFIG_INIT_IMPORT}\\n`;\n\nexport function buildAdminLayoutTemplate(): string {\n  return `${CONFIG_INIT_IMPORT}\nimport '@mdxeditor/editor/style.css';\nimport 'octocms/globals.css';\n\nexport { AdminLayout as default, metadata } from 'octocms/admin';\n`;\n}\n\n/**\n * Catch-all admin route — every \\`/cms/*\\` URL renders the package's\n * \\`AdminApp\\` async server component (awaits \\`params\\`, no outer Suspense).\n * Side-effect-imports \\`configInit\\` so server-action bundles register\n * \\`setConfig()\\` even when Next.js does not load \\`layout.tsx\\` for the POST.\n */\nexport function buildAdminPageTemplate(): string {\n  return `// Registers setConfig() for server actions — some POST bundles skip layout.tsx.\n${CONFIG_INIT_IMPORT}\n\nexport { AdminApp as default } from 'octocms/admin';\n`;\n}\n\n/**\n * Admin error boundary — rendered by Next.js when anything in the catch-all\n * tree throws during render. Re-uses the shared \\`AdminErrorView\\` so GitHub\n * config / auth / availability / rate-limit copy stays consistent with the\n * public-page error boundary.\n */\nexport const adminErrorTemplate = `'use client';\n\nexport { AdminError as default } from 'octocms/admin';\n`;\n\n/**\n * Historical template values used by \\`octocms update\\` to recognise an\n * unmodified install when migrating between routing models. Each entry is\n * the literal file content shipped by a previous OctoCMS version. If a\n * user-app file matches one of these byte-for-byte, \\`update\\` will replace\n * it with the current template; otherwise it leaves it alone.\n */\nexport const LEGACY_ADMIN_LAYOUT_TEMPLATES: ReadonlyArray<string> = [\n  // 0.4.x — re-exported from the deep path.\n  `import '../../cms/__generated__/configInit';\nimport 'octocms/globals.css';\nimport '@mdxeditor/editor/style.css';\n\nexport { AdminLayout as default, metadata } from 'octocms/admin/pages/AdminLayout';\n`,\n  // 0.5.x — barrel re-export with depth-counted relative configInit import.\n  `import '../../cms/__generated__/configInit';\nimport 'octocms/globals.css';\nimport '@mdxeditor/editor/style.css';\n\nexport { AdminLayout as default, metadata } from 'octocms/admin';\n`,\n];\n\nexport const LEGACY_ADMIN_CATCH_ALL_TEMPLATES: ReadonlyArray<string> = [\n  // 0.4.x — re-exported from the deep path.\n  `export { AdminApp as default } from 'octocms/admin/AdminApp';\n`,\n  // 0.5.x — barrel re-export without configInit on the page (server actions could miss setConfig).\n  `export { AdminApp as default } from 'octocms/admin';\n`,\n  // 0.5.x with depth-counted configInit (replaced by bare-specifier alias).\n  `// Registers setConfig() for server actions — some POST bundles skip layout.tsx.\nimport '../../../cms/__generated__/configInit';\n\nexport { AdminApp as default } from 'octocms/admin';\n`,\n];\n\nexport const nextAuthRouteTemplate = `import NextAuth from 'next-auth';\nimport { authOptions } from 'octocms/admin/auth';\n\nconst handler = NextAuth(authOptions);\n\nexport { handler as GET, handler as POST };\n`;\n\n/**\n * Build a thin re-export Route Handler for the chat-agent SSE endpoint.\n *\n * The actual handler lives in `octocms/agent/chatApi.ts`\n * (`chatRoute` / `chatStatusRoute`). The user-app file just:\n *   1. side-effect-imports `cms/__generated__/configInit` so\n *      `getAgentConfig()` resolves on cold start (Route Handlers don't run\n *      `app/layout.tsx`); and\n *   2. re-exports `chatRoute` as `POST` and `chatStatusRoute` as `GET`.\n *\n * The configInit import uses the bare specifier (resolved by the bundler\n * alias from `withOctoCMS()`), so the route file is depth-agnostic and can be\n * placed under `app/` or `src/app/` without code changes.\n */\nexport function agentChatRouteTemplate(): string {\n  return `// Side-effect import: registers \\`configOctoCMS\\` + \\`agentConfig\\` into the\n// runtime stores so \\`getAgentConfig()\\` resolves on cold start. Route Handlers\n// don't run \\`app/layout.tsx\\`, so this import has to live here.\n${CONFIG_INIT_IMPORT}\n\nexport { chatRoute as POST, chatStatusRoute as GET } from 'octocms/agent';\n`;\n}\n\n/**\n * Build a thin re-export Route Handler for the `/media/[...slug]` proxy.\n *\n * The actual handler lives in `octocms/admin/mediaRoute.ts`\n * (`mediaRoute`). The user-app file just:\n *   1. side-effect-imports `cms/__generated__/configInit` so `getConfig()`\n *      resolves on cold start (Route Handlers don't run `app/layout.tsx`); and\n *   2. re-exports `mediaRoute` as `GET`.\n *\n * The configInit import uses the bare specifier (resolved by the bundler\n * alias from `withOctoCMS()`), so the route file is depth-agnostic.\n */\nexport function mediaRouteTemplate(): string {\n  return `// Side-effect import: registers \\`configOctoCMS\\` into the runtime store so\n// \\`getConfig()\\` resolves on cold start. Route Handlers don't run\n// \\`app/layout.tsx\\`, so this import has to live here.\n${CONFIG_INIT_IMPORT}\n\nexport { mediaRoute as GET } from 'octocms/admin/mediaRoute';\n`;\n}\n\n/**\n * Build a thin re-export Route Handler for the public-site `/api/search`\n * endpoint consumed by the `SearchBox` component shipped at\n * `octocms/components/public`.\n *\n * The actual handler lives in `octocms/admin/searchRoute.ts`\n * (`searchRoute`). The user-app file just:\n *   1. side-effect-imports `cms/__generated__/configInit` so `getConfig()`\n *      resolves on cold start (Route Handlers don't run `app/layout.tsx`); and\n *   2. re-exports `searchRoute` as `GET`.\n *\n * The configInit import uses the bare specifier (resolved by the bundler\n * alias from `withOctoCMS()`), so the route file is depth-agnostic.\n */\nexport function searchRouteTemplate(): string {\n  return `// Side-effect import: registers \\`configOctoCMS\\` into the runtime store so\n// \\`getConfig()\\` resolves on cold start. Route Handlers don't run\n// \\`app/layout.tsx\\`, so this import has to live here.\n${CONFIG_INIT_IMPORT}\n\nexport { searchRoute as GET } from 'octocms/admin/searchRoute';\n`;\n}\n\ntype SchemaInitOpts = { projectName: string; baseBranch: string; pointerBranch?: string };\n\n/**\n * The starter schema used by `octocms init`. The data lives in `cms/schema.json`\n * (source of truth — hand-editable + edited by the Content Model UI). The other\n * two scaffolded files (`cms/__generated__/schema.ts` and `cms/octocms.config.ts`)\n * mirror this same shape — keep them aligned by editing here only and letting\n * `npx octocms types:gen` regenerate the rest in the user's project.\n */\nfunction buildStarterSchema(opts: SchemaInitOpts): Record<string, unknown> {\n  const git: Record<string, string> = { baseBranch: opts.baseBranch };\n  if (opts.pointerBranch) git.publishedPointerBranch = opts.pointerBranch;\n  return {\n    projectName: opts.projectName,\n    git,\n    contentFolder: 'cms/content',\n    mediaContentFolder: 'cms/media',\n    mediaFolder: 'public/media',\n    mediaAllowedFormats: ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'avif'],\n    collections: {\n      helloPage: {\n        label: 'Hello Page',\n        fields: {\n          title: { label: 'Title', format: 'string', entryTitle: true, required: true },\n          description: { label: 'Description', format: 'text' },\n        },\n      },\n    },\n  };\n}\n\n/**\n * `cms/schema.json` — the source of truth. The Content Model UI (`/cms/model`)\n * reads and writes this file via `getSchema()` / `saveSchema()` server actions.\n */\nexport function schemaJsonTemplate(opts: SchemaInitOpts): string {\n  return JSON.stringify(buildStarterSchema(opts), null, 2) + '\\n';\n}\n\n/**\n * `cms/__generated__/schema.ts` — auto-generated literal-typed mirror of\n * `cms/schema.json`. Required because `query()` infers narrow collection /\n * field / format types from the literal `defineConfig()` call — a plain JSON\n * import cannot preserve those literals.\n *\n * `npx octocms types:gen` regenerates this from `cms/schema.json` after every\n * schema edit (and `npm run types:check` fails on drift).\n */\nexport function generatedSchemaShimTemplate(opts: SchemaInitOpts): string {\n  const gitBlock = opts.pointerBranch\n    ? `  git: {\\n    baseBranch: '${opts.baseBranch}',\\n    publishedPointerBranch: '${opts.pointerBranch}',\\n  },`\n    : `  git: { baseBranch: '${opts.baseBranch}' },`;\n  return `/*\n * AUTO-GENERATED — DO NOT EDIT.\n * Generated from cms/schema.json.\n * Run \\`npx octocms types:gen\\` to regenerate.\n */\n\nimport { defineConfig } from 'octocms/defineConfig';\n\nexport const schema = defineConfig({\n  projectName: '${opts.projectName}',\n${gitBlock}\n  contentFolder: 'cms/content',\n  mediaContentFolder: 'cms/media',\n  mediaFolder: 'public/media',\n  mediaAllowedFormats: ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'avif'],\n  collections: {\n    helloPage: {\n      label: 'Hello Page',\n      fields: {\n        title: { label: 'Title', format: 'string', entryTitle: true, required: true },\n        description: { label: 'Description', format: 'text' },\n      },\n    },\n  },\n});\n`;\n}\n\n/**\n * `cms/octocms.config.ts` — thin TS binding. Imports the literal-typed\n * `schema` from the generated shim and re-exports it as `configOctoCMS` (the\n * runtime `Config`) and `OctoConfig` (the literal type used by `query()`).\n *\n * Hand-edits should go to `cms/schema.json`. After editing the JSON, run\n * `npx octocms types:gen` to refresh `cms/__generated__/schema.ts`.\n */\nexport function octoConfigTemplate(_opts: SchemaInitOpts): string {\n  return `import type { Config } from 'octocms/types';\nimport { schema } from './__generated__/schema';\n\n/**\n * The schema is defined in \\`cms/schema.json\\` (source of truth — hand-editable\n * and editable through the Content Model UI). \\`npx octocms types:gen\\` mirrors\n * it into \\`cms/__generated__/schema.ts\\` as a literal-typed \\`defineConfig()\\`\n * call so the downstream \\`query()\\` API can infer narrow collection / field /\n * format types (which a plain JSON import cannot preserve).\n *\n * \\`npm run types:check\\` fails if the JSON and the generated shim drift.\n */\nconst _typedConfigOctoCMS = schema;\n\n/** Runtime config — widened to \\`Config\\` for dynamic indexing in CMS internals. */\nexport const configOctoCMS: Config = _typedConfigOctoCMS as Config;\n\n/**\n * Exact literal type of the config — use this for type-level inference only\n * (e.g. the \\`query()\\` API derives collection/field names from it).\n */\nexport type OctoConfig = typeof _typedConfigOctoCMS;\n`;\n}\n\nexport function nextConfigTemplate(): string {\n  return `import type { NextConfig } from 'next';\nimport { withOctoCMS } from 'octocms/config';\nimport { configOctoCMS } from './cms/octocms.config';\n\nexport { configOctoCMS } from './cms/octocms.config';\nexport type { OctoConfig } from './cms/octocms.config';\n\nconst nextConfig: NextConfig = {};\n\nexport default withOctoCMS(nextConfig, configOctoCMS);\n`;\n}\n\nexport function demoHelloPageJson(): string {\n  return JSON.stringify(\n    {\n      sys: { id: '0000', type: 'helloPage', status: 'merged' },\n      fields: {\n        title: 'Hello World',\n        description: 'Welcome to your new OctoCMS site! Edit this content in the CMS admin panel.',\n      },\n    },\n    null,\n    2,\n  );\n}\n\nexport const helloPageTemplate = `import { query } from 'cms/__generated__/query';\n\nexport default async function HelloPage() {\n  const page = await query('helloPage').first();\n  if (!page) return null;\n  return (\n    <main>\n      <h1>{page.fields.title}</h1>\n      <p>{page.fields.description}</p>\n    </main>\n  );\n}\n`;\n\nexport function readmeTemplate(projectName: string): string {\n  return `# ${projectName}\n\nBuilt with [OctoCMS](https://octocms.gunkin.dev) — a file-based CMS on Next.js.\n\n## Setup\n\n### 1. Install dependencies\n\n\\`\\`\\`bash\nnpm install octocms next-auth @tanstack/react-query @mdxeditor/editor \\\\\n  minisearch octokit \\\\\n  react-markdown rehype-sanitize remark-gfm remark-mdx \\\\\n  sharp zod\n\\`\\`\\`\n\n> The exact list (with the right \\`octocms\\` version pin) is also printed by \\`npx octocms init\\` — copy it from there.\n\n### 2. Create a GitHub App\n\nFollow the [OctoCMS GitHub App setup guide](https://octocms.gunkin.dev/docs/github-app) to create a GitHub App for authentication.\n\n### 3. Configure environment variables\n\nCopy the values from your GitHub App into \\`.env.local\\`:\n\n\\`\\`\\`bash\n# GitHub App credentials (required for CMS auth)\nGITHUB_ID=your_github_app_client_id\nGITHUB_SECRET=your_github_app_client_secret\n\n# NextAuth (generate secret: openssl rand -base64 32)\nNEXTAUTH_SECRET=your_nextauth_secret\nNEXTAUTH_URL=http://localhost:3000\n\n# GitHub repo for content storage (required in production)\nGITHUB_REPO_OWNER=your_github_username_or_org\nGITHUB_REPO_NAME=your_repo_name\n\n# Optional: static GitHub token for private repos / higher API rate limits\n# CMS_GITHUB_TOKEN=your_github_pat\n\\`\\`\\`\n\n### 4. Run the dev server\n\n\\`\\`\\`bash\nnpm run dev\n\\`\\`\\`\n\nOpen [http://localhost:3000/cms](http://localhost:3000/cms) to access the CMS admin.\n`;\n}\n\nexport function envLocalTemplate(): string {\n  return `# GitHub App credentials (required for CMS auth)\n# Create a GitHub App at: https://github.com/settings/apps/new\nGITHUB_ID=\nGITHUB_SECRET=\n\n# NextAuth secret — generate with: openssl rand -base64 32\nNEXTAUTH_SECRET=\nNEXTAUTH_URL=http://localhost:3000\n\n# GitHub repo for content storage (required in production)\nGITHUB_REPO_OWNER=\nGITHUB_REPO_NAME=\n\n# Optional: static GitHub token for private repos or higher API rate limits\n# CMS_GITHUB_TOKEN=\n`;\n}\n\nconst AGENT_DOCS_MARKER = '<!-- octocms:agent-docs -->';\n\nexport function agentsMdSection(): string {\n  return `${AGENT_DOCS_MARKER}\n## OctoCMS — AI Content Management\n\nFor tasks that involve creating, editing, or deleting CMS content directly (without the admin UI), read these docs:\n\n**Package docs (content-agnostic, stable):**\n\n- **\\`octocms/docs/overview.md\\`** — Generic content management (CRUD, entry shape, status values)\n- **\\`octocms/docs/editing-schema.md\\`** — How to edit \\`cms/schema.json\\` safely\n\n**Project docs (auto-generated from \\`cms/schema.json\\`):**\n\n- **\\`cms/__generated__/agent-docs/schema.md\\`** — Per-collection field definitions and example JSON\n- **\\`cms/__generated__/agent-docs/collections.md\\`** — Collection list and URL mapping\n\nRegenerate project docs after schema changes: \\`npm run agent-docs:gen\\` (or \\`npm run types:gen\\`).`;\n}\n\nexport function agentsMdTemplate(): string {\n  return `# Project Guidelines\n\n${agentsMdSection()}\n`;\n}\n\nexport function tsconfigPaths(): Record<string, string[]> {\n  return {\n    'cms/__generated__': ['./cms/__generated__/index.ts'],\n    'cms/__generated__/*': ['./cms/__generated__/*'],\n    '@/*': ['./src/*'],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   version
-} from "../chunk-TOUAHFDW.js";
+} from "../chunk-CIKOAIJP.js";
 import {
   resolveProjectRoot
 } from "../chunk-ZYUK2J5L.js";
@@ -164,7 +164,7 @@ async function main() {
   try {
     switch (command) {
       case "init": {
-        const { initCommand } = await import("../init-KNIWQGJL.js");
+        const { initCommand } = await import("../init-TZFZEP4O.js");
         await initCommand(process.cwd(), { yes: flags.yes === true });
         break;
       }
@@ -177,7 +177,7 @@ async function main() {
       }
       case "types:gen": {
         const projectRoot = resolveProjectRoot();
-        const { typesGenCommand } = await import("../typesGen-MFAL3B4V.js");
+        const { typesGenCommand } = await import("../typesGen-QWWTC4SZ.js");
         await typesGenCommand(projectRoot);
         break;
       }
@@ -195,13 +195,13 @@ async function main() {
       }
       case "update": {
         const projectRoot = resolveProjectRoot();
-        const { updateCommand } = await import("../update-QALIQG76.js");
+        const { updateCommand } = await import("../update-7KYYD57J.js");
         await updateCommand(projectRoot);
         break;
       }
       case "agent-docs": {
         const projectRoot = resolveProjectRoot();
-        const { agentDocsCommand } = await import("../agentDocs-QZ4NOQVH.js");
+        const { agentDocsCommand } = await import("../agentDocs-6LQD3JUN.js");
         await agentDocsCommand(projectRoot);
         break;
       }

package/dist/cli/lib/agentDocs.d.ts

@@ -2,14 +2,15 @@
  * Agent documentation generators — pure functions that produce Markdown strings
  * describing how AI agents should manage OctoCMS content.
  *
- * Output is written to `octocms/docs/` by `scripts/generate-agent-docs.ts`
- * so it ships with the npm package.
+ * Project-specific output is written to `cms/__generated__/agent-docs/` by
+ * `npm run agent-docs:gen` (or `npm run types:gen`, which regenerates the
+ * same files along with TypeScript artifacts).
  */
 import type { CollectionField, Config } from 'octocms/types';
-export declare const AGENT_DOCS_BANNER = "<!--\n  AUTO-GENERATED FILE \u2014 DO NOT EDIT.\n  Generated by scripts/generate-agent-docs.ts from cms/schema.json.\n  Run `npm run agent-docs:gen` to regenerate.\n-->\n\n";
+export declare const AGENT_DOCS_BANNER = "<!--\n  AUTO-GENERATED FILE \u2014 DO NOT EDIT.\n  Generated from cms/schema.json via npm run agent-docs:gen.\n  Run `npm run agent-docs:gen` (or `npm run types:gen`) to regenerate.\n-->\n\n";
 /** Return a JSON-safe placeholder value string for a field (for example entries). */
 export declare function placeholderValue(field: CollectionField, collectionNames: readonly string[]): string;
-export declare function generateAgentOverview(cfg: Config, collectionNames: readonly string[]): string;
+export declare function generateAgentCollections(cfg: Config, collectionNames: readonly string[]): string;
 export declare function generateAgentSchema(cfg: Config, collectionNames: readonly string[]): string;
 export declare function generateAgentIndex(): string;
 //# sourceMappingURL=agentDocs.d.ts.map

package/dist/cli/lib/agentDocs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentDocs.d.ts","sourceRoot":"","sources":["../../../cli/lib/agentDocs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE7D,eAAO,MAAM,iBAAiB,iLAM7B,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA2CnG;AAgDD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA+J7F;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiI3F;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CA6B3C"}
+{"version":3,"file":"agentDocs.d.ts","sourceRoot":"","sources":["../../../cli/lib/agentDocs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE7D,eAAO,MAAM,iBAAiB,mMAM7B,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA2CnG;AAgDD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAqEhG;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiI3F;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CAoC3C"}