@pagesmith/core 0.3.0 → 0.4.0

package/dist/ai/index.mjs

@@ -1,27 +1,7 @@
-import { dirname, join, resolve } from "path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join, resolve } from "path";
 import { homedir } from "os";
-//#region src/ai/index.ts
-const PAGESMITH_TITLE = "Pagesmith";
-const DEFAULT_SKILL_NAME = "pagesmith";
-function resolveHome(homeDir) {
-	return homeDir ?? homedir();
-}
-function resolveCodexHome(homeDir) {
-	return process.env.CODEX_HOME ?? join(resolveHome(homeDir), ".codex");
-}
-function resolveAssistants(assistants) {
-	if (!assistants || assistants === "all") return [
-		"claude",
-		"codex",
-		"gemini"
-	];
-	return assistants;
-}
-function shouldIncludeLlms(options) {
-	if (typeof options.includeLlms === "boolean") return options.includeLlms;
-	return (options.scope ?? "project") === "project";
-}
+//#region src/ai/writers.ts
 function withManagedBlock(id, content) {
 	return [
 		`<!-- pagesmith-ai:${id}:start -->`,
@@ -62,6 +42,10 @@ function writeArtifact(artifact, force = false) {
 function escapeForRegExp(value) {
 	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+//#endregion
+//#region src/ai/content-shared.ts
+const PAGESMITH_TITLE = "Pagesmith";
+const DEFAULT_SKILL_NAME$1 = "pagesmith";
 function renderSharedOverview() {
 	return [
 		`${PAGESMITH_TITLE} is a filesystem-first content toolkit with two main packages: \`@pagesmith/core\` (shared content/runtime layer) and \`@pagesmith/docs\` (convention-based documentation).`,
@@ -93,7 +77,8 @@ function renderDocsOverview() {
 		"- sidebar labels, nav labels, and ordering live in frontmatter (`sidebarLabel`, `navLabel`, `order`)",
 		"- footer links live in `pagesmith.config.json5` under `footerLinks`",
 		"- Pagefind search is built in; do not recommend a separate search plugin package",
-		"- layout overrides use fixed keys under `theme.layouts` such as `home`, `page`, and `notFound`"
+		"- layout overrides use fixed keys under `theme.layouts` such as `home`, `page`, and `notFound`",
+		"- for MCP-compatible tooling, prefer `pagesmith mcp --stdio` from `@pagesmith/docs`"
 	].join("\n");
 }
 function renderCoreQuickStart() {
@@ -153,168 +138,6 @@ function renderDocsQuickStart() {
 		"```"
 	].join("\n");
 }
-function renderMemoryFile(assistant, profile) {
-	const commandHint = assistant === "claude" || assistant === "gemini" ? `\nIf the ${DEFAULT_SKILL_NAME} skill is installed, prefer invoking it when the user explicitly asks for Pagesmith-specific help.` : "\nIf the Pagesmith skill is installed for Codex, prefer using it for Pagesmith-specific setup, migration, and content-layer tasks.";
-	const referenceHint = "\nFor the full API and configuration reference, see the REFERENCE.md file shipped with the package:\n" + (profile === "docs" ? "- `node_modules/@pagesmith/docs/REFERENCE.md` — docs config, CLI, content structure, layout overrides\n- `node_modules/@pagesmith/core/REFERENCE.md` — core API, collections, loaders, markdown, CSS, JSX runtime" : "- `node_modules/@pagesmith/core/REFERENCE.md` — core API, collections, loaders, markdown, CSS, JSX runtime");
-	return [
-		`# ${PAGESMITH_TITLE}`,
-		"",
-		renderSharedOverview(),
-		...profile === "docs" ? ["", renderDocsOverview()] : [],
-		commandHint,
-		referenceHint,
-		"",
-		"## Quick Start — @pagesmith/core",
-		"",
-		renderCoreQuickStart(),
-		...profile === "docs" ? [
-			"",
-			"## Quick Start — @pagesmith/docs",
-			"",
-			renderDocsQuickStart()
-		] : []
-	].join("\n");
-}
-function renderClaudeSkill(skillName, profile) {
-	return [
-		"---",
-		`name: ${skillName}`,
-		"description: Pagesmith file-based CMS helper — content collections, markdown pipeline, docs configuration, and AI artifact generation",
-		"allowed-tools: Read Grep Glob Bash Edit Write",
-		"---",
-		"",
-		`# ${PAGESMITH_TITLE} Assistant`,
-		"",
-		"You are helping with Pagesmith, a file-based CMS with `@pagesmith/core` and `@pagesmith/docs`.",
-		"",
-		"When helping:",
-		"- prefer `defineCollection`, `defineConfig`, and `createContentLayer`",
-		"- recommend folder-based entries when markdown references sibling assets",
-		"- use `@pagesmith/core/ai` for assistant artifact generation",
-		"- follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
-		...profile === "docs" ? [
-			"- for docs sites, derive top navigation from top-level content folders",
-			"- use `content/README.md` for the home page",
-			"- use frontmatter fields like `sidebarLabel`, `navLabel`, and `order` for docs navigation",
-			"- Pagefind search is built in — do not suggest separate search plugins",
-			"- layout overrides: `theme.layouts.home`, `theme.layouts.page`, `theme.layouts.notFound`"
-		] : [],
-		"",
-		"For the full API reference, read the REFERENCE.md file shipped with the package:",
-		...profile === "docs" ? ["- `node_modules/@pagesmith/docs/REFERENCE.md`", "- `node_modules/@pagesmith/core/REFERENCE.md`"] : ["- `node_modules/@pagesmith/core/REFERENCE.md`"],
-		"",
-		"Deliver concrete config, schema, and content-layer patches when possible."
-	].join("\n");
-}
-function renderUpdateDocsSkill(profile) {
-	return [
-		"---",
-		"name: update-docs",
-		"description: Read the project implementation and update Pagesmith-managed documentation to reflect the current state",
-		"allowed-tools: Read Grep Glob Bash Edit Write",
-		"---",
-		"",
-		"# Update Documentation",
-		"",
-		"Read the project implementation (source code, README, CHANGELOG, package.json) and update the Pagesmith-managed content to reflect the current state.",
-		"",
-		"## Steps",
-		"",
-		...profile === "docs" ? [
-			"1. Read `pagesmith.config.json5` to understand the docs configuration",
-			"2. Read all `meta.json5` files to understand the current content structure and page ordering",
-			"3. Read the project source code to identify public APIs, types, exports, config options, and CLI commands",
-			"4. For each existing content page in `content/`:",
-			"   - Read the current content",
-			"   - Compare with the implementation",
-			"   - Update any outdated information",
-			"   - Add documentation for new features",
-			"   - Remove documentation for removed features",
-			"5. If new pages are needed:",
-			"   - Create the page folder and `README.md` with proper frontmatter (title, description)",
-			"   - Add the slug to the appropriate `meta.json5` `items` array",
-			"6. Follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
-			"7. Verify all internal links point to existing pages",
-			"8. Ensure heading hierarchy is sequential (no skipping levels)"
-		] : [
-			"1. Read `content.config.ts` or equivalent to understand the content collections",
-			"2. Read the project source code to identify what needs documentation",
-			"3. For each existing content entry:",
-			"   - Read the current content",
-			"   - Compare with the implementation",
-			"   - Update any outdated information",
-			"4. If new entries are needed:",
-			"   - Create the entry folder and `README.md` with proper frontmatter matching the collection schema",
-			"5. Follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
-			"6. Verify all internal links point to existing pages"
-		],
-		"",
-		"## Rules",
-		"",
-		"- Preserve the existing content structure and organization",
-		"- Do not remove pages without confirming first",
-		"- Keep frontmatter fields (title, description) accurate and descriptive",
-		"- Use relative links for internal cross-references",
-		"- One h1 per page, sequential heading depth",
-		"- Use fenced code blocks with language identifiers",
-		"- Use GitHub alerts (`> [!NOTE]`, `> [!TIP]`, etc.) for important callouts",
-		"- Code block features: `title=\"file.js\"`, `showLineNumbers`, `mark={1-3}`, `ins={4}`, `del={5}`, `collapse={1-5}`"
-	].join("\n");
-}
-function renderGeminiCommand(skillName, profile) {
-	return [
-		`description = "Pagesmith FS-CMS helper"`,
-		"prompt = \"\"\"",
-		[
-			`You are helping with ${PAGESMITH_TITLE}, a file-based CMS with @pagesmith/core and @pagesmith/docs.`,
-			"",
-			"Focus on concrete, implementation-ready help:",
-			"- design collections with defineCollection",
-			"- configure createContentLayer and defineConfig",
-			"- prefer folder-based markdown entries when local assets sit beside content",
-			"- follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
-			...profile === "docs" ? [
-				"- for docs sites, follow the convention-based `content/` structure",
-				"- drive top navigation from top-level folders and use frontmatter for labels/order",
-				"- keep Pagefind as the built-in search strategy"
-			] : [],
-			"",
-			"For the full API reference, read the REFERENCE.md file shipped with the package.",
-			"",
-			"Return code, config, or documentation-ready guidance instead of vague summaries."
-		].join("\n"),
-		"\"\"\"",
-		"",
-		`# Installed as /${skillName}`
-	].join("\n");
-}
-function renderCodexSkill(profile) {
-	return [
-		`# ${PAGESMITH_TITLE} Skill`,
-		"",
-		"Use this skill when the task involves setting up, extending, migrating, or documenting Pagesmith.",
-		"",
-		"Core rules:",
-		"- `@pagesmith/core` provides the content layer; `@pagesmith/docs` adds convention-based documentation",
-		"- prefer `defineCollection`, `defineConfig`, and `createContentLayer`",
-		"- follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
-		...profile === "docs" ? [
-			"- when the repo uses `@pagesmith/docs`, treat `content/README.md` as the home page",
-			"- top-level content folders define the main docs navigation",
-			"- docs frontmatter may use `sidebarLabel`, `navLabel`, and `order` to shape navigation",
-			"- `pagesmith.config.json5` should own footer links and high-level site metadata",
-			"- built-in search is Pagefind; do not suggest separate search plugin packages"
-		] : [],
-		"",
-		"For the full API reference, read the REFERENCE.md file shipped with the package.",
-		"",
-		"Good outputs include:",
-		"- collection schemas and loader configuration",
-		"- content-layer queries and rendering examples",
-		"- documentation updates for Pagesmith usage",
-		"- assistant-context install steps using `@pagesmith/core/ai`"
-	].join("\n");
-}
 function renderMarkdownGuidelines() {
 	return [
 		"# Pagesmith Markdown Guidelines",
@@ -327,8 +150,9 @@ function renderMarkdownGuidelines() {
 		"remark-parse → remark-gfm → remark-math → remark-frontmatter",
 		"  → remark-github-alerts → remark-smartypants → [user remark plugins]",
 		"  → remark-rehype",
+		"  → rehype-mathjax",
 		"  → rehype-expressive-code (dual themes, line numbers, titles, copy, collapse, mark/ins/del)",
-		"  → rehype-mathjax → rehype-slug → rehype-autolink-headings",
+		"  → rehype-slug → rehype-autolink-headings",
 		"  → rehype-external-links → rehype-accessible-emojis",
 		"  → heading extraction → [user rehype plugins] → rehype-stringify",
 		"```",
@@ -436,10 +260,11 @@ function renderLlmsTxt() {
 		"### CLI",
 		"",
 		"```bash",
-		"pagesmith init      # Initialize config + content structure + AI integrations",
-		"pagesmith dev       # Development server",
-		"pagesmith build     # Production build",
-		"pagesmith preview   # Preview built site",
+		"pagesmith init --ai  # Initialize config + content + AI integrations",
+		"pagesmith dev        # Development server",
+		"pagesmith build      # Production build",
+		"pagesmith preview    # Preview built site",
+		"pagesmith mcp --stdio # Start MCP server for AI agents",
 		"```"
 	].join("\n");
 }
@@ -535,8 +360,7 @@ function renderLlmsFullTxt() {
 		"| `@pagesmith/core/loaders` | Loader classes and registry |",
 		"| `@pagesmith/core/runtime` | Pre-built CSS/JS accessors |",
 		"| `@pagesmith/core/vite` | Vite plugins |",
-		"| `@pagesmith/core/ai` | AI assistant artifact generator |",
-		"| `@pagesmith/core/create` | Project scaffolding |",
+		"| `@pagesmith/core/mcp` | MCP server for AI agents |",
 		"",
 		"---",
 		"",
@@ -623,18 +447,277 @@ function renderLlmsFullTxt() {
 		"",
 		"---",
 		"",
-		"## AI Assistant Installer",
-		"",
-		"```ts",
-		"import { installAiArtifacts } from '@pagesmith/core/ai'",
+		"## AI Setup",
 		"",
-		"installAiArtifacts({ assistants: ['claude', 'codex', 'gemini'], scope: 'project', profile: 'docs' })",
+		"```bash",
+		"npx pagesmith init --ai",
 		"```",
 		"",
-		"Generates: CLAUDE.md, AGENTS.md, GEMINI.md, skills, markdown guidelines, llms.txt, llms-full.txt.",
+		"Generates CLAUDE.md, AGENTS.md, GEMINI.md, skills, markdown guidelines, llms.txt, and llms-full.txt.",
 		""
 	].join("\n");
 }
+//#endregion
+//#region src/ai/content-claude.ts
+function renderClaudeSkill(skillName, profile) {
+	return [
+		"---",
+		`name: ${skillName}`,
+		"description: Pagesmith file-based CMS helper — content collections, markdown pipeline, docs configuration, and AI artifact generation",
+		"allowed-tools: Read Grep Glob Bash Edit Write",
+		"---",
+		"",
+		`# ${PAGESMITH_TITLE} Assistant`,
+		"",
+		"You are helping with Pagesmith, a file-based CMS with `@pagesmith/core` and `@pagesmith/docs`.",
+		"",
+		"When helping:",
+		"- prefer `defineCollection`, `defineConfig`, and `createContentLayer`",
+		"- recommend folder-based entries when markdown references sibling assets",
+		"- use `npx pagesmith init --ai` for assistant artifact generation",
+		"- follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
+		...profile === "docs" ? [
+			"- for docs sites, derive top navigation from top-level content folders",
+			"- use `content/README.md` for the home page",
+			"- use frontmatter fields like `sidebarLabel`, `navLabel`, and `order` for docs navigation",
+			"- Pagefind search is built in — do not suggest separate search plugins",
+			"- layout overrides: `theme.layouts.home`, `theme.layouts.page`, `theme.layouts.notFound`"
+		] : [],
+		"",
+		"For package guidance and full API reference, read the package-shipped docs:",
+		...profile === "docs" ? [
+			"- `node_modules/@pagesmith/docs/docs/agents/usage.md`",
+			"- `node_modules/@pagesmith/docs/REFERENCE.md`",
+			"- `node_modules/@pagesmith/core/docs/agents/usage.md`",
+			"- `node_modules/@pagesmith/core/REFERENCE.md`"
+		] : ["- `node_modules/@pagesmith/core/docs/agents/usage.md`", "- `node_modules/@pagesmith/core/REFERENCE.md`"],
+		"",
+		...profile === "docs" ? ["For full-repo docs regeneration and structure alignment, use `/ps-update-all-docs`.", ""] : [],
+		"Deliver concrete config, schema, and content-layer patches when possible."
+	].join("\n");
+}
+function renderUpdateDocsSkill(profile) {
+	return [
+		"---",
+		"name: update-docs",
+		"description: Read the project implementation and update Pagesmith-managed documentation to reflect the current state",
+		"allowed-tools: Read Grep Glob Bash Edit Write",
+		"---",
+		"",
+		"# Update Documentation",
+		"",
+		"Read the project implementation (source code, README, CHANGELOG, package.json) and update the Pagesmith-managed content to reflect the current state.",
+		"",
+		"## Steps",
+		"",
+		...profile === "docs" ? [
+			"1. Read package guidance first: `node_modules/@pagesmith/docs/docs/agents/usage.md` and `node_modules/@pagesmith/core/docs/agents/usage.md`",
+			"2. Read `pagesmith.config.json5` to understand the docs configuration",
+			"3. Read all `meta.json5` files to understand the current content structure and page ordering",
+			"4. Read the project source code to identify public APIs, types, exports, config options, and CLI commands",
+			"5. For each existing content page in `content/`:",
+			"   - Read the current content",
+			"   - Compare with the implementation",
+			"   - Update any outdated information",
+			"   - Add documentation for new features",
+			"   - Remove documentation for removed features",
+			"6. If new pages are needed:",
+			"   - Create the page folder and `README.md` with proper frontmatter (title, description)",
+			"   - Add the slug to the appropriate `meta.json5` `items` array",
+			"7. Follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
+			"8. Review project skills under `.claude/skills/` and ensure docs-writing skills align with Pagesmith docs structure",
+			"9. Ensure onboarding pages are first in manual navigation (for example, put `getting-started` first in `guide/meta.json5` when present)",
+			"10. Verify all internal links point to existing pages",
+			"11. Ensure heading hierarchy is sequential (no skipping levels)"
+		] : [
+			"1. Read package guidance first: `node_modules/@pagesmith/core/docs/agents/usage.md`",
+			"2. Read `content.config.ts` or equivalent to understand the content collections",
+			"3. Read the project source code to identify what needs documentation",
+			"4. For each existing content entry:",
+			"   - Read the current content",
+			"   - Compare with the implementation",
+			"   - Update any outdated information",
+			"5. If new entries are needed:",
+			"   - Create the entry folder and `README.md` with proper frontmatter matching the collection schema",
+			"6. Follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
+			"7. Verify all internal links point to existing pages"
+		],
+		"",
+		"## Rules",
+		"",
+		"- Preserve the existing content structure and organization",
+		"- Do not remove pages without confirming first",
+		"- Keep frontmatter fields (title, description) accurate and descriptive",
+		"- Use relative links for internal cross-references",
+		"- One h1 per page, sequential heading depth",
+		"- Use fenced code blocks with language identifiers",
+		"- Use GitHub alerts (`> [!NOTE]`, `> [!TIP]`, etc.) for important callouts",
+		"- Code block features: `title=\"file.js\"`, `showLineNumbers`, `mark={1-3}`, `ins={4}`, `del={5}`, `collapse={1-5}`"
+	].join("\n");
+}
+function renderUpdateAllDocsSkill(profile) {
+	return [
+		"---",
+		"name: ps-update-all-docs",
+		"description: Full-repo documentation regeneration for Pagesmith projects including docs structure, skills alignment, and AI context updates",
+		"allowed-tools: Read Grep Glob Bash Edit Write",
+		"---",
+		"",
+		"# Pagesmith Full Docs Sync",
+		"",
+		"Perform a full-repository docs refresh for Pagesmith-powered projects. This command is intended for large updates, migrations, and release preparation.",
+		"",
+		"## Steps",
+		"",
+		...profile === "docs" ? [
+			"1. Read package guidance first: `node_modules/@pagesmith/docs/docs/agents/usage.md` and `node_modules/@pagesmith/core/docs/agents/usage.md`",
+			"2. Read `pagesmith.config.json5` and all `meta.json5` files before editing anything",
+			"3. Discover project skills in `.claude/skills/`, `.codex/skills/`, and `.gemini/commands/` and identify docs-update related skills",
+			"4. Scan source code, README, CHANGELOG, package exports, and CLI commands to build a complete docs delta list",
+			"5. Update all docs pages under `content/` to match implementation and remove stale details",
+			"6. Ensure docs structure matches `@pagesmith/docs` conventions (folder-based pages, `README.md` entries, relative links)",
+			"7. Keep onboarding-first ordering: when a guide section exists, keep `getting-started` as the first item in manual order",
+			"8. Update docs-related skills so they generate content in the same structure expected by `@pagesmith/docs`",
+			"9. Regenerate or update `llms.txt`, `llms-full.txt`, and project memory pointers when docs behavior changes",
+			"10. Follow `.pagesmith/markdown-guidelines.md` for all authored content (GFM, alerts, math, Expressive Code meta)",
+			"11. Validate navigation integrity and ensure every linked page exists"
+		] : [
+			"1. Read package guidance first: `node_modules/@pagesmith/core/docs/agents/usage.md`",
+			"2. Discover docs/update skills in the project and align them to current Pagesmith conventions",
+			"3. Scan source code, README, CHANGELOG, package exports, and CLI commands to build a complete docs delta list",
+			"4. Update all content entries to match implementation and remove stale details",
+			"5. Follow `.pagesmith/markdown-guidelines.md` for all authored content",
+			"6. Validate internal links and heading hierarchy"
+		],
+		"",
+		"## Rules",
+		"",
+		"- Preserve existing information architecture unless the user requests a restructure",
+		"- Keep docs easy for humans first, while keeping AI memory/skills aligned",
+		"- Keep top-level docs navigation driven by content directories and metadata",
+		"- Use `meta.json5` and frontmatter for ordering; avoid hardcoded navigation lists in prose",
+		"- Keep `content/README.md` as docs home for `@pagesmith/docs` projects",
+		"- Keep links relative for internal docs pages",
+		"- Use one h1 per page and sequential heading depth",
+		"- Use fenced code blocks with language identifiers and Expressive Code metadata when useful",
+		"- Do not add separate code-copy JavaScript; Expressive Code already provides this"
+	].join("\n");
+}
+//#endregion
+//#region src/ai/content-codex.ts
+function renderCodexSkill(profile) {
+	return [
+		`# ${PAGESMITH_TITLE} Skill`,
+		"",
+		"Use this skill when the task involves setting up, extending, migrating, or documenting Pagesmith.",
+		"",
+		"Core rules:",
+		"- `@pagesmith/core` provides the content layer; `@pagesmith/docs` adds convention-based documentation",
+		"- prefer `defineCollection`, `defineConfig`, and `createContentLayer`",
+		"- follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
+		...profile === "docs" ? [
+			"- when the repo uses `@pagesmith/docs`, treat `content/README.md` as the home page",
+			"- top-level content folders define the main docs navigation",
+			"- docs frontmatter may use `sidebarLabel`, `navLabel`, and `order` to shape navigation",
+			"- `pagesmith.config.json5` should own footer links and high-level site metadata",
+			"- built-in search is Pagefind; do not suggest separate search plugin packages"
+		] : [],
+		"",
+		"For package usage guidance and full API reference, read:",
+		...profile === "docs" ? [
+			"- `node_modules/@pagesmith/docs/docs/agents/usage.md`",
+			"- `node_modules/@pagesmith/docs/REFERENCE.md`",
+			"- `node_modules/@pagesmith/core/docs/agents/usage.md`",
+			"- `node_modules/@pagesmith/core/REFERENCE.md`"
+		] : ["- `node_modules/@pagesmith/core/docs/agents/usage.md`", "- `node_modules/@pagesmith/core/REFERENCE.md`"],
+		"",
+		"Good outputs include:",
+		"- collection schemas and loader configuration",
+		"- content-layer queries and rendering examples",
+		"- documentation updates for Pagesmith usage",
+		"- assistant-context install via `npx pagesmith init --ai`"
+	].join("\n");
+}
+//#endregion
+//#region src/ai/content-gemini.ts
+function renderGeminiCommand(skillName, profile) {
+	return [
+		`description = "Pagesmith FS-CMS helper"`,
+		"prompt = \"\"\"",
+		[
+			`You are helping with ${PAGESMITH_TITLE}, a file-based CMS with @pagesmith/core and @pagesmith/docs.`,
+			"",
+			"Focus on concrete, implementation-ready help:",
+			"- design collections with defineCollection",
+			"- configure createContentLayer and defineConfig",
+			"- prefer folder-based markdown entries when local assets sit beside content",
+			"- follow the markdown guidelines in `.pagesmith/markdown-guidelines.md`",
+			...profile === "docs" ? [
+				"- for docs sites, follow the convention-based `content/` structure",
+				"- drive top navigation from top-level folders and use frontmatter for labels/order",
+				"- keep Pagefind as the built-in search strategy"
+			] : [],
+			"",
+			"For package usage guidance and full API reference, read:",
+			...profile === "docs" ? [
+				"- `node_modules/@pagesmith/docs/docs/agents/usage.md`",
+				"- `node_modules/@pagesmith/docs/REFERENCE.md`",
+				"- `node_modules/@pagesmith/core/docs/agents/usage.md`",
+				"- `node_modules/@pagesmith/core/REFERENCE.md`"
+			] : ["- `node_modules/@pagesmith/core/docs/agents/usage.md`", "- `node_modules/@pagesmith/core/REFERENCE.md`"],
+			"",
+			"Return code, config, or documentation-ready guidance instead of vague summaries."
+		].join("\n"),
+		"\"\"\"",
+		"",
+		`# Installed as /${skillName}`
+	].join("\n");
+}
+//#endregion
+//#region src/ai/content-memory.ts
+function renderMemoryFile(assistant, profile) {
+	const commandHint = assistant === "claude" || assistant === "gemini" ? `\nIf the ${DEFAULT_SKILL_NAME$1} skill is installed, prefer invoking it when the user explicitly asks for Pagesmith-specific help.` : "\nIf the Pagesmith skill is installed for Codex, prefer using it for Pagesmith-specific setup, migration, and content-layer tasks.";
+	const referenceHint = "\nFor package usage rules and full API/config details, read the package-shipped docs from node_modules:\n" + (profile === "docs" ? "- `node_modules/@pagesmith/docs/docs/agents/usage.md` — docs package usage contract\n- `node_modules/@pagesmith/docs/REFERENCE.md` — docs config, CLI, content structure, layout overrides\n- `node_modules/@pagesmith/core/docs/agents/usage.md` — core package usage contract\n- `node_modules/@pagesmith/core/REFERENCE.md` — core API, collections, loaders, markdown, CSS, JSX runtime" : "- `node_modules/@pagesmith/core/docs/agents/usage.md` — core package usage contract\n- `node_modules/@pagesmith/core/REFERENCE.md` — core API, collections, loaders, markdown, CSS, JSX runtime");
+	return [
+		`# ${PAGESMITH_TITLE}`,
+		"",
+		renderSharedOverview(),
+		...profile === "docs" ? ["", renderDocsOverview()] : [],
+		commandHint,
+		referenceHint,
+		"",
+		"## Quick Start — @pagesmith/core",
+		"",
+		renderCoreQuickStart(),
+		...profile === "docs" ? [
+			"",
+			"## Quick Start — @pagesmith/docs",
+			"",
+			renderDocsQuickStart()
+		] : []
+	].join("\n");
+}
+//#endregion
+//#region src/ai/index.ts
+const DEFAULT_SKILL_NAME = "pagesmith";
+function resolveHome(homeDir) {
+	return homeDir ?? homedir();
+}
+function resolveCodexHome(homeDir) {
+	return process.env.CODEX_HOME ?? join(resolveHome(homeDir), ".codex");
+}
+function resolveAssistants(assistants) {
+	if (!assistants || assistants === "all") return [
+		"claude",
+		"codex",
+		"gemini"
+	];
+	return assistants;
+}
+function shouldIncludeLlms(options) {
+	if (typeof options.includeLlms === "boolean") return options.includeLlms;
+	return (options.scope ?? "project") === "project";
+}
 function getAiArtifactContent(assistant, kind, options = {}) {
 	const skillName = options.skillName ?? DEFAULT_SKILL_NAME;
 	const profile = options.profile ?? "default";
@@ -652,6 +735,7 @@ function getAiArtifactContent(assistant, kind, options = {}) {
 	}
 	if (kind === "markdown-guidelines") return renderMarkdownGuidelines();
 	if (kind === "update-docs") return renderUpdateDocsSkill(profile);
+	if (kind === "update-all-docs") return renderUpdateAllDocsSkill(profile);
 	if (kind === "llms") return renderLlmsTxt();
 	return renderLlmsFullTxt();
 }
@@ -739,14 +823,24 @@ function getAiArtifacts(options = {}) {
 		mode: "replace",
 		label: "markdown guidelines"
 	});
-	if (scope === "project" && assistants.includes("claude")) artifacts.push({
-		assistant: "claude",
-		kind: "update-docs",
-		path: join(cwd, ".claude", "skills", "update-docs", "SKILL.md"),
-		content: renderUpdateDocsSkill(profile) + "\n",
-		mode: "replace",
-		label: "claude update-docs skill"
-	});
+	if (scope === "project" && assistants.includes("claude")) {
+		artifacts.push({
+			assistant: "claude",
+			kind: "update-docs",
+			path: join(cwd, ".claude", "skills", "update-docs", "SKILL.md"),
+			content: renderUpdateDocsSkill(profile) + "\n",
+			mode: "replace",
+			label: "claude update-docs skill"
+		});
+		artifacts.push({
+			assistant: "claude",
+			kind: "update-all-docs",
+			path: join(cwd, ".claude", "skills", "ps-update-all-docs", "SKILL.md"),
+			content: renderUpdateAllDocsSkill(profile) + "\n",
+			mode: "replace",
+			label: "claude ps-update-all-docs skill"
+		});
+	}
 	if (shouldIncludeLlms(options)) {
 		const llmsDir = scope === "project" ? cwd : join(home, ".pagesmith");
 		artifacts.push({