ppt-template-reuse 0.4.0-rc.2

package/adapters/workbuddy/skills/learn-ppt-template/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: learn-ppt-template
+description: Create a content-complete, editable PowerPoint from a user-provided PPTX/POTX template and DOCX, PDF, PPTX, Markdown, or text material. Use whenever the user asks to make, imitate, learn, follow, or reuse a presentation template. Identify what every template page is for, adapt page count to source volume, preserve reasoning in native speaker notes, request missing visuals, expose real page previews, and stop on unresolved layouts, unsafe object edits, incomplete source coverage, or failed rendering. Works through the host-neutral ppt-template-reuse MCP or ppt-reuse CLI.
+---
+
+# Learn PPT Template
+
+Use the `ppt-template-reuse` MCP server as the normal execution path. Do not ask
+the user to prepare JSON, choose a page count, or run commands.
+
+## Default behavior
+
+For a request such as “参考这个模板和这些材料做一份内容完整、可编辑、带讲稿的
+PPT”:
+
+1. Call `ppt_create_session` with the template, material, output path, current
+   workspace roots, and stated audience/duration.
+2. Call `ppt_inspect`.
+3. Read every extracted source unit. Submit every original `id` and `anchor`
+   through `ppt_submit_semantics`; label facts, chronology, issues, rules,
+   evidence, analysis, counterarguments, rebuttals, conclusions, and
+   recommendations. Preserve `parentAnchor`, `segmentIndex`, and `segmentCount`
+   when a long paragraph, table, slide, or PDF page was deterministically
+   segmented. Never silently merge away or omit a unit.
+   For structured layouts, also supply short `displayFragments` with roles such
+   as `date`, `label`, `step`, `metric-label`, `body`, or `description`. These
+   are source-grounded slot values, not invented decoration. A timeline needs
+   dates and node labels; a multi-item grid needs one label/body pair per item.
+4. Review only template slides returned as unresolved. Classify each page's
+   purpose, safe slots, capacity, required assets, protected elements, and
+   editability. Never approve uncertain SmartArt, chart, media, animation, icon,
+   or flattened-object edits. If several opening or closing variants are
+   returned, approve exactly one for each role and block the alternatives; do
+   not choose by page order.
+5. Call `ppt_plan`. Let source volume, argument structure, slot capacity, and
+   requested speaking time determine page count. If planning returns
+   `template-selection`, show the returned full-size candidates, approve one
+   source slide for that role, block the competing candidates in the frozen
+   template profile, resubmit semantics, and plan again. Never break a tie by
+   page number.
+6. If assets are required, use the host's image search or generation capability
+   when authorized; otherwise ask once for all missing assets. Register them
+   with `ppt_supply_assets`. Never permit gray blocks or temporary placeholders.
+7. Call `ppt_generate`, then poll `ppt_status`. Show new real page previews in
+   order. Stop when the status contains `actionRequired`.
+8. Call `ppt_validate` when generation did not already validate. Deliver only
+   when state is `completed`.
+
+## Content rules
+
+- Preserve 100% of `critical` units and at least 95% weighted relevant content.
+- Require every included source unit to have a verified destination trace.
+  Preserve 100% of original source text in speaker notes, visibly represent
+  100% of critical units, and visibly represent at least 90% of weighted
+  relevant units. A `sourceUnitId` without matching field or notes text is not
+  coverage.
+- Put source-verification text in a clearly marked
+  `[来源追踪，不逐字朗读]` notes block. Estimate duration from the spoken
+  explanation, not from that reference block. Do not add filler slides merely
+  because a short source finishes below the requested minimum time.
+- Each analysis slide needs a claim, evidence, why-it-matters explanation, and
+  native speaker notes.
+- Pair each represented counterargument with a response.
+- Split overloaded material across more approved layouts; never shrink inherited
+  typography or delete reasoning to force a target page count.
+- Use `core`, `appendix`, and `exclude` deliberately. An explicit duration
+  conflict requires a user choice between more time, narrower scope, or multiple
+  decks.
+- A prior 19-page deck is only a regression example, never a fixed length.
+- Do not infer length from unit count alone. Use original character volume,
+  argument nodes, counterargument chains, requested time, and the approved
+  template slot capacity. Very long material may legitimately produce dozens
+  or more than one hundred pages; stop for a duration/scope decision instead of
+  compressing it to a familiar deck length.
+
+## Template and object rules
+
+- Exact native mode supports `.pptx` and `.potx`; `.pptm` is rejected and macros
+  are never executed.
+- Treat flattened templates as `hybrid-locked`. Do not call them fully editable.
+- Edit only declared slots. Preserve masters, layouts, themes, logos, page
+  chrome, animations, SmartArt, media, and all untargeted objects.
+- Replace inherited images in place. Update tables only when dimensions match.
+  Update charts only when the embedded workbook and rendered result can both be
+  validated; otherwise stop.
+- “插入图片”, “相关图片”, “ICON”, sample copy, and gray image blocks are
+  requirements, not audience-facing content.
+- If an older reviewed template capsule is available, import it only when its
+  source SHA256 matches. Keep deny-by-default safety, preserve the old
+  preview/review bindings, approve exactly one opening and closing, and never
+  re-guess already reviewed slots.
+
+## Completion gate
+
+Completion requires a frozen content plan and frame map, native speaker notes,
+no residual examples or placeholders, matching slide/render counts, real
+LibreOffice rendering, rendered-text fidelity, and a passing QA report. If
+LibreOffice is missing or its PDF contains missing/substituted glyphs, analysis
+and planning may complete but the PPTX must remain `validation-failed` until a
+manual WPS or PowerPoint review confirms text, line breaks, images, notes, and
+masters.
+
+The engine is local-first: it only reads declared roots/current workspace and
+temporary files, does not upload templates or material, and does not use the
+network by itself.

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "ppt-template-reuse",
+  "version": "0.4.0-rc.2",
+  "description": "A host-neutral PPTX template learning, content planning, native editing, validation, CLI, and MCP engine.",
+  "license": "MIT",
+  "author": "NEU-ZHA",
+  "private": false,
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "ppt-reuse": "./src/cli/ppt-reuse.mjs",
+    "ppt-template-reuse-mcp": "./src/mcp/server.mjs"
+  },
+  "exports": {
+    ".": "./src/index.mjs",
+    "./core": "./src/core/index.mjs",
+    "./mcp": "./src/mcp/server.mjs"
+  },
+  "files": [
+    "src/",
+    "skills/",
+    "adapters/",
+    "plugins/ppt-template-reuse/.codex-plugin/",
+    "plugins/ppt-template-reuse/.mcp.json",
+    "plugins/ppt-template-reuse/skills/learn-ppt-template/SKILL.md",
+    "plugins/ppt-template-reuse/skills/learn-ppt-template/agents/",
+    "LICENSE",
+    "NOTICE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "check": "node tests/run-tests.mjs",
+    "check:universal": "node tests/run-universal-tests.mjs",
+    "check:all": "npm run check && npm run check:universal",
+    "doctor": "node src/cli/ppt-reuse.mjs doctor --host all",
+    "privacy": "node scripts/privacy-scan.mjs",
+    "release:build": "node scripts/build-release.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@xmldom/xmldom": "^0.8.11",
+    "jszip": "^3.10.1",
+    "pdfjs-dist": "^5.4.296",
+    "pixelmatch": "^7.1.0",
+    "pngjs": "^7.0.0",
+    "zod": "^4.1.11"
+  },
+  "optionalDependencies": {
+    "@napi-rs/canvas": "^0.1.80"
+  }
+}

package/plugins/ppt-template-reuse/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "ppt-template-reuse",
+  "version": "0.4.0-rc.2",
+  "description": "Cross-host PPTX template learning, adaptive content planning, native OOXML authoring, previews, and validation through a local MCP engine.",
+  "author": {
+    "name": "NEU-ZHA"
+  },
+  "license": "MIT",
+  "keywords": [
+    "powerpoint",
+    "pptx",
+    "template",
+    "speaker-notes",
+    "content-audit",
+    "adaptive-planning",
+    "template-intelligence",
+    "deterministic",
+    "visual-qa"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "PPT Template Reuse",
+    "shortDescription": "Purpose-aware, content-adaptive reuse of native PPTX templates.",
+    "longDescription": "Uses the same local engine as Claude Code, Kimi Code, Kimi Work, and WorkBuddy. It identifies template purposes and safe native slots, anchors every source unit, adapts page count to content volume and speaking time, preserves reasoning in notes, blocks missing visuals and unsafe edits, emits real previews, and requires rendered QA before delivery.",
+    "developerName": "NEU-ZHA",
+    "category": "Productivity",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Use this PPTX template and my source material to make a content-complete editable presentation.",
+      "Identify what every page in this template is for, then plan the deck from my material.",
+      "Choose the best template from my local library and create a detailed presentation with speaker notes."
+    ]
+  }
+}

package/plugins/ppt-template-reuse/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "ppt-template-reuse": {
+      "command": "ppt-template-reuse-mcp",
+      "args": [],
+      "note": "Local host-neutral PPTX template analysis, content planning, native OOXML authoring, previews, and validation."
+    }
+  }
+}

package/plugins/ppt-template-reuse/skills/learn-ppt-template/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: learn-ppt-template
+description: Create a content-complete, editable PowerPoint from a user-provided PPTX/POTX template and DOCX, PDF, PPTX, Markdown, or text material. Use whenever the user asks to make, imitate, learn, follow, or reuse a presentation template. Identify what every template page is for, adapt page count to source volume, preserve reasoning in native speaker notes, request missing visuals, expose real page previews, and stop on unresolved layouts, unsafe object edits, incomplete source coverage, or failed rendering. Works through the host-neutral ppt-template-reuse MCP or ppt-reuse CLI.
+---
+
+# Learn PPT Template
+
+Use the `ppt-template-reuse` MCP server as the normal execution path. Do not ask
+the user to prepare JSON, choose a page count, or run commands.
+
+## Default behavior
+
+For a request such as “参考这个模板和这些材料做一份内容完整、可编辑、带讲稿的
+PPT”:
+
+1. Call `ppt_create_session` with the template, material, output path, current
+   workspace roots, and stated audience/duration.
+2. Call `ppt_inspect`.
+3. Read every extracted source unit. Submit every original `id` and `anchor`
+   through `ppt_submit_semantics`; label facts, chronology, issues, rules,
+   evidence, analysis, counterarguments, rebuttals, conclusions, and
+   recommendations. Preserve `parentAnchor`, `segmentIndex`, and `segmentCount`
+   when a long paragraph, table, slide, or PDF page was deterministically
+   segmented. Never silently merge away or omit a unit.
+   For structured layouts, also supply short `displayFragments` with roles such
+   as `date`, `label`, `step`, `metric-label`, `body`, or `description`. These
+   are source-grounded slot values, not invented decoration. A timeline needs
+   dates and node labels; a multi-item grid needs one label/body pair per item.
+4. Review only template slides returned as unresolved. Classify each page's
+   purpose, safe slots, capacity, required assets, protected elements, and
+   editability. Never approve uncertain SmartArt, chart, media, animation, icon,
+   or flattened-object edits. If several opening or closing variants are
+   returned, approve exactly one for each role and block the alternatives; do
+   not choose by page order.
+5. Call `ppt_plan`. Let source volume, argument structure, slot capacity, and
+   requested speaking time determine page count. If planning returns
+   `template-selection`, show the returned full-size candidates, approve one
+   source slide for that role, block the competing candidates in the frozen
+   template profile, resubmit semantics, and plan again. Never break a tie by
+   page number.
+6. If assets are required, use the host's image search or generation capability
+   when authorized; otherwise ask once for all missing assets. Register them
+   with `ppt_supply_assets`. Never permit gray blocks or temporary placeholders.
+7. Call `ppt_generate`, then poll `ppt_status`. Show new real page previews in
+   order. Stop when the status contains `actionRequired`.
+8. Call `ppt_validate` when generation did not already validate. Deliver only
+   when state is `completed`.
+
+## Content rules
+
+- Preserve 100% of `critical` units and at least 95% weighted relevant content.
+- Require every included source unit to have a verified destination trace.
+  Preserve 100% of original source text in speaker notes, visibly represent
+  100% of critical units, and visibly represent at least 90% of weighted
+  relevant units. A `sourceUnitId` without matching field or notes text is not
+  coverage.
+- Put source-verification text in a clearly marked
+  `[来源追踪，不逐字朗读]` notes block. Estimate duration from the spoken
+  explanation, not from that reference block. Do not add filler slides merely
+  because a short source finishes below the requested minimum time.
+- Each analysis slide needs a claim, evidence, why-it-matters explanation, and
+  native speaker notes.
+- Pair each represented counterargument with a response.
+- Split overloaded material across more approved layouts; never shrink inherited
+  typography or delete reasoning to force a target page count.
+- Use `core`, `appendix`, and `exclude` deliberately. An explicit duration
+  conflict requires a user choice between more time, narrower scope, or multiple
+  decks.
+- A prior 19-page deck is only a regression example, never a fixed length.
+- Do not infer length from unit count alone. Use original character volume,
+  argument nodes, counterargument chains, requested time, and the approved
+  template slot capacity. Very long material may legitimately produce dozens
+  or more than one hundred pages; stop for a duration/scope decision instead of
+  compressing it to a familiar deck length.
+
+## Template and object rules
+
+- Exact native mode supports `.pptx` and `.potx`; `.pptm` is rejected and macros
+  are never executed.
+- Treat flattened templates as `hybrid-locked`. Do not call them fully editable.
+- Edit only declared slots. Preserve masters, layouts, themes, logos, page
+  chrome, animations, SmartArt, media, and all untargeted objects.
+- Replace inherited images in place. Update tables only when dimensions match.
+  Update charts only when the embedded workbook and rendered result can both be
+  validated; otherwise stop.
+- “插入图片”, “相关图片”, “ICON”, sample copy, and gray image blocks are
+  requirements, not audience-facing content.
+- If an older reviewed template capsule is available, import it only when its
+  source SHA256 matches. Keep deny-by-default safety, preserve the old
+  preview/review bindings, approve exactly one opening and closing, and never
+  re-guess already reviewed slots.
+
+## Completion gate
+
+Completion requires a frozen content plan and frame map, native speaker notes,
+no residual examples or placeholders, matching slide/render counts, real
+LibreOffice rendering, rendered-text fidelity, and a passing QA report. If
+LibreOffice is missing or its PDF contains missing/substituted glyphs, analysis
+and planning may complete but the PPTX must remain `validation-failed` until a
+manual WPS or PowerPoint review confirms text, line breaks, images, notes, and
+masters.
+
+The engine is local-first: it only reads declared roots/current workspace and
+temporary files, does not upload templates or material, and does not use the
+network by itself.

package/plugins/ppt-template-reuse/skills/learn-ppt-template/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "PPT模板智能复用"
+  short_description: "识别模板用途并按材料完整度生成内容充实、可编辑、带讲稿的PPT"
+  default_prompt: "使用 $learn-ppt-template 参考我的PPTX模板和材料，自动规划页数并生成内容完整、可编辑、带讲稿和真实预览的演示文稿。"
+policy:
+  allow_implicit_invocation: true

package/skills/ppt-template-reuse/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: learn-ppt-template
+description: Create a content-complete, editable PowerPoint from a user-provided PPTX/POTX template and DOCX, PDF, PPTX, Markdown, or text material. Use whenever the user asks to make, imitate, learn, follow, or reuse a presentation template. Identify what every template page is for, adapt page count to source volume, preserve reasoning in native speaker notes, request missing visuals, expose real page previews, and stop on unresolved layouts, unsafe object edits, incomplete source coverage, or failed rendering. Works through the host-neutral ppt-template-reuse MCP or ppt-reuse CLI.
+---
+
+# Learn PPT Template
+
+Use the `ppt-template-reuse` MCP server as the normal execution path. Do not ask
+the user to prepare JSON, choose a page count, or run commands.
+
+## Default behavior
+
+For a request such as “参考这个模板和这些材料做一份内容完整、可编辑、带讲稿的
+PPT”:
+
+1. Call `ppt_create_session` with the template, material, output path, current
+   workspace roots, and stated audience/duration.
+2. Call `ppt_inspect`.
+3. Read every extracted source unit. Submit every original `id` and `anchor`
+   through `ppt_submit_semantics`; label facts, chronology, issues, rules,
+   evidence, analysis, counterarguments, rebuttals, conclusions, and
+   recommendations. Preserve `parentAnchor`, `segmentIndex`, and `segmentCount`
+   when a long paragraph, table, slide, or PDF page was deterministically
+   segmented. Never silently merge away or omit a unit.
+   For structured layouts, also supply short `displayFragments` with roles such
+   as `date`, `label`, `step`, `metric-label`, `body`, or `description`. These
+   are source-grounded slot values, not invented decoration. A timeline needs
+   dates and node labels; a multi-item grid needs one label/body pair per item.
+4. Review only template slides returned as unresolved. Classify each page's
+   purpose, safe slots, capacity, required assets, protected elements, and
+   editability. Never approve uncertain SmartArt, chart, media, animation, icon,
+   or flattened-object edits. If several opening or closing variants are
+   returned, approve exactly one for each role and block the alternatives; do
+   not choose by page order.
+5. Call `ppt_plan`. Let source volume, argument structure, slot capacity, and
+   requested speaking time determine page count. If planning returns
+   `template-selection`, show the returned full-size candidates, approve one
+   source slide for that role, block the competing candidates in the frozen
+   template profile, resubmit semantics, and plan again. Never break a tie by
+   page number.
+6. If assets are required, use the host's image search or generation capability
+   when authorized; otherwise ask once for all missing assets. Register them
+   with `ppt_supply_assets`. Never permit gray blocks or temporary placeholders.
+7. Call `ppt_generate`, then poll `ppt_status`. Show new real page previews in
+   order. Stop when the status contains `actionRequired`.
+8. Call `ppt_validate` when generation did not already validate. Deliver only
+   when state is `completed`.
+
+## Content rules
+
+- Preserve 100% of `critical` units and at least 95% weighted relevant content.
+- Require every included source unit to have a verified destination trace.
+  Preserve 100% of original source text in speaker notes, visibly represent
+  100% of critical units, and visibly represent at least 90% of weighted
+  relevant units. A `sourceUnitId` without matching field or notes text is not
+  coverage.
+- Put source-verification text in a clearly marked
+  `[来源追踪，不逐字朗读]` notes block. Estimate duration from the spoken
+  explanation, not from that reference block. Do not add filler slides merely
+  because a short source finishes below the requested minimum time.
+- Each analysis slide needs a claim, evidence, why-it-matters explanation, and
+  native speaker notes.
+- Pair each represented counterargument with a response.
+- Split overloaded material across more approved layouts; never shrink inherited
+  typography or delete reasoning to force a target page count.
+- Use `core`, `appendix`, and `exclude` deliberately. An explicit duration
+  conflict requires a user choice between more time, narrower scope, or multiple
+  decks.
+- A prior 19-page deck is only a regression example, never a fixed length.
+- Do not infer length from unit count alone. Use original character volume,
+  argument nodes, counterargument chains, requested time, and the approved
+  template slot capacity. Very long material may legitimately produce dozens
+  or more than one hundred pages; stop for a duration/scope decision instead of
+  compressing it to a familiar deck length.
+
+## Template and object rules
+
+- Exact native mode supports `.pptx` and `.potx`; `.pptm` is rejected and macros
+  are never executed.
+- Treat flattened templates as `hybrid-locked`. Do not call them fully editable.
+- Edit only declared slots. Preserve masters, layouts, themes, logos, page
+  chrome, animations, SmartArt, media, and all untargeted objects.
+- Replace inherited images in place. Update tables only when dimensions match.
+  Update charts only when the embedded workbook and rendered result can both be
+  validated; otherwise stop.
+- “插入图片”, “相关图片”, “ICON”, sample copy, and gray image blocks are
+  requirements, not audience-facing content.
+- If an older reviewed template capsule is available, import it only when its
+  source SHA256 matches. Keep deny-by-default safety, preserve the old
+  preview/review bindings, approve exactly one opening and closing, and never
+  re-guess already reviewed slots.
+
+## Completion gate
+
+Completion requires a frozen content plan and frame map, native speaker notes,
+no residual examples or placeholders, matching slide/render counts, real
+LibreOffice rendering, rendered-text fidelity, and a passing QA report. If
+LibreOffice is missing or its PDF contains missing/substituted glyphs, analysis
+and planning may complete but the PPTX must remain `validation-failed` until a
+manual WPS or PowerPoint review confirms text, line breaks, images, notes, and
+masters.
+
+The engine is local-first: it only reads declared roots/current workspace and
+temporary files, does not upload templates or material, and does not use the
+network by itself.

package/skills/ppt-template-reuse/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "PPT模板智能复用"
+  short_description: "识别模板用途并按材料完整度生成内容充实、可编辑、带讲稿的PPT"
+  default_prompt: "使用 $learn-ppt-template 参考我的PPTX模板和材料，自动规划页数并生成内容完整、可编辑、带讲稿和真实预览的演示文稿。"
+policy:
+  allow_implicit_invocation: true

package/src/cli/ppt-reuse.mjs

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+import {
+  createSession,
+  engineDoctor,
+  generateSession,
+  getSessionStatus,
+  validateSession,
+} from "../core/universal-engine.mjs";
+import { parseCliArgs } from "../core/io.mjs";
+import { importLegacyCapsule } from "../core/legacy-capsule-import.mjs";
+import { installHosts, uninstallHost } from "../install/installer.mjs";
+import { startHttp, startStdio } from "../mcp/server.mjs";
+
+const packageJson = JSON.parse(
+  fs.readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
+);
+
+function usage() {
+  return `ppt-reuse ${packageJson.version}
+
+Commands:
+  ppt-reuse install --auto [--dry-run] [--home-root <path>]
+  ppt-reuse doctor --host all
+  ppt-reuse import-capsule --capsule <dir> --template <file> --opening <n> --closing <n> [--approve <1,2,3>]
+  ppt-reuse create --template <file> --source <file> --output <file> --root <dir>
+  ppt-reuse status <session-id> [--after-event <n>]
+  ppt-reuse resume <session-id>
+  ppt-reuse validate <session-id>
+  ppt-reuse mcp --stdio
+  ppt-reuse serve --host 127.0.0.1 [--port 8765]
+  ppt-reuse uninstall --host <name> [--dry-run]`;
+}
+
+function required(args, key) {
+  const value = args[key];
+  if (!value || value === true) throw new Error(`Missing --${key}`);
+  return String(value);
+}
+
+function output(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+
+function requirements(args) {
+  return {
+    title: args.title,
+    subtitle: args.subtitle,
+    audience: args.audience,
+    communicationJob: args["communication-job"],
+    useCase: args["use-case"],
+    density: args.density,
+    scope: args.scope,
+    duration: args.duration,
+  };
+}
+
+export async function runCli(argv = process.argv.slice(2)) {
+  const [command, ...rest] = argv;
+  const args = parseCliArgs(rest);
+  if (command === "--version" || command === "-v") {
+    process.stdout.write(`${packageJson.version}\n`);
+    return;
+  }
+  if (!command || command === "--help" || command === "-h" || args.help) {
+    process.stdout.write(`${usage()}\n`);
+    return;
+  }
+  if (command === "install") {
+    const installOptions = {
+      host: args.host || (args.auto === true ? "auto" : "auto"),
+      homeRoot: args["home-root"],
+    };
+    const plan = await installHosts({ ...installOptions, dryRun: true });
+    output(
+      args["dry-run"] === true
+        ? { plan }
+        : {
+            plan,
+            result: await installHosts({
+              ...installOptions,
+              dryRun: false,
+            }),
+          },
+    );
+    return;
+  }
+  if (command === "doctor") {
+    const engine = await engineDoctor({ home: args.home });
+    const hosts = await installHosts({
+      host: args.host || "all",
+      homeRoot: args["home-root"],
+      dryRun: true,
+    });
+    output({ engine, hosts });
+    return;
+  }
+  if (command === "import-capsule") {
+    const approvedSourceSlides = String(args.approve || "")
+      .split(",")
+      .map((value) => Number(value.trim()))
+      .filter(Number.isFinite);
+    output(
+      await importLegacyCapsule({
+        capsuleDir: required(args, "capsule"),
+        templatePath: required(args, "template"),
+        openingSourceSlide: Number(required(args, "opening")),
+        closingSourceSlide: Number(required(args, "closing")),
+        approvedSourceSlides,
+        home: args.home,
+        persist: args["dry-run"] !== true,
+      }),
+    );
+    return;
+  }
+  if (command === "create") {
+    const rootValues = rest
+      .flatMap((token, index) =>
+        token === "--root" && rest[index + 1] ? [rest[index + 1]] : [],
+      );
+    output(
+      await createSession(
+        {
+          template: required(args, "template"),
+          source: required(args, "source"),
+          output: required(args, "output"),
+          roots: rootValues,
+          requirements: requirements(args),
+        },
+        { home: args.home },
+      ),
+    );
+    return;
+  }
+  if (command === "status") {
+    const id = args._[0];
+    if (!id) throw new Error("Missing session id");
+    output(
+      await getSessionStatus(id, {
+        home: args.home,
+        afterEvent: Number(args["after-event"] || 0),
+      }),
+    );
+    return;
+  }
+  if (command === "resume") {
+    const id = args._[0];
+    if (!id) throw new Error("Missing session id");
+    output(
+      await generateSession(id, {
+        home: args.home,
+        validate: true,
+        livePreview: args["no-live-preview"] !== true,
+      }),
+    );
+    return;
+  }
+  if (command === "validate") {
+    const id = args._[0];
+    if (!id) throw new Error("Missing session id");
+    output(await validateSession(id, { home: args.home }));
+    return;
+  }
+  if (command === "mcp") {
+    await startStdio({ home: args.home });
+    return;
+  }
+  if (command === "serve") {
+    const host = String(args.host || "127.0.0.1");
+    const port = Number(args.port || 8765);
+    await startHttp({ host, port, home: args.home });
+    process.stdout.write(
+      `ppt-template-reuse MCP listening at http://${host}:${port}/mcp\n`,
+    );
+    return;
+  }
+  if (command === "uninstall") {
+    output(
+      await uninstallHost({
+        host: required(args, "host"),
+        homeRoot: args["home-root"],
+        dryRun: args["dry-run"] === true,
+      }),
+    );
+    return;
+  }
+  throw new Error(`Unknown command: ${command}\n${usage()}`);
+}
+
+const isMain =
+  process.argv[1] &&
+  pathToFileURL(fs.realpathSync(path.resolve(process.argv[1]))).href ===
+    import.meta.url;
+if (isMain) {
+  runCli().catch((error) => {
+    process.stderr.write(`${error.stack || error.message}\n`);
+    process.exit(1);
+  });
+}