@open-press/cli 0.8.0 → 1.1.0

package/template/core/engine/commands/_shared.mjs

@@ -1,177 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { printUrlToPdf, stopChildProcess, waitForPrintReady } from "../output/chrome-pdf.mjs";
-import { loadConfig, publicPdfHref } from "../runtime/config.mjs";
-import { exportDocument } from "../document-export.mjs";
-import { optimizePdfMediaForStaticRoot } from "../output/pdf-media.mjs";
-
-export const ENGINE_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-export const CLI_ENTRY = path.join(ENGINE_DIR, "cli.mjs");
-export const STATIC_SERVER = path.join(ENGINE_DIR, "output", "static-server.mjs");
-
-export function parseOptions(argv) {
-  const options = {};
-  const positional = [];
-  for (let i = 0; i < argv.length; i += 1) {
-    const value = argv[i];
-    if (value === "--renderer") options.renderer = argv[++i];
-    else if (value === "--host") options.host = argv[++i];
-    else if (value === "--port") options.port = argv[++i];
-    else if (value === "--dry-run") options.dryRun = true;
-    else if (value === "--force") options.force = true;
-    else if (value === "--confirm") options.confirm = true;
-    else if (value === "--json") options.json = true;
-    else if (value === "--no-build") options.noBuild = true;
-    else if (value === "--apply") options.apply = true;
-    else if (value === "--include-code") options.includeCode = true;
-    else if (value === "--case-sensitive") options.caseSensitive = true;
-    else if (value === "--scope") options.scope = argv[++i];
-    else if (value === "--source") options.source = argv[++i];
-    else if (value === "--output") options.output = argv[++i];
-    else if (value.startsWith("--")) throw new Error(`Unknown option: ${value}`);
-    else positional.push(value);
-  }
-  options.path = positional[0];
-  options.positional = positional;
-  return options;
-}
-
-export function parseInitOptions(argv) {
-  const options = { force: false };
-  const positional = [];
-  for (let i = 0; i < argv.length; i += 1) {
-    const value = argv[i];
-    if (value === "--skill") options.skill = argv[++i];
-    else if (value === "--force") options.force = true;
-    else if (value.startsWith("--")) throw new Error(`Unknown option: ${value}`);
-    else positional.push(value);
-  }
-  options.target = positional[0];
-  return options;
-}
-
-export function formatDisplayPath(absolutePath) {
-  const relative = path.relative(process.cwd(), absolutePath);
-  if (!relative || relative.startsWith("..")) return absolutePath;
-  return relative;
-}
-
-export function runCommand(commandName, commandArgs, cwd) {
-  const result = spawnSync(commandName, commandArgs, { cwd, stdio: "inherit" });
-  return result.status ?? 1;
-}
-
-export function formatNodeScriptCommand(root, scriptPath) {
-  const relative = path.relative(root, scriptPath).replaceAll("\\", "/");
-  const displayPath = relative && !relative.startsWith("../") ? relative : scriptPath;
-  return `node ${displayPath}`;
-}
-
-export async function buildReactStatic({ root, noBuild = false, recurse, silent = false }) {
-  if (noBuild) return 0;
-  if (!silent) {
-    return await recurse("render", [root, "--renderer", "react"]);
-  }
-
-  await exportDocument(root);
-  const result = spawnSync("npx", ["vite", "build", "--config", "vite.config.ts"], {
-    cwd: root,
-    encoding: "utf8",
-  });
-  return result.status ?? 1;
-}
-
-export async function buildReactPdf({
-  root,
-  config,
-  outPath,
-  host = "127.0.0.1",
-  port = "5185",
-  noBuild = false,
-  recurse,
-}) {
-  config ??= await loadConfig(root);
-  outPath ??= config.paths.pdf;
-  const renderCode = await buildReactStatic({ root, noBuild, recurse });
-  if (renderCode !== 0) throw new Error(`React render failed with exit code ${renderCode}`);
-  await optimizePdfMediaForStaticRoot(config.paths.outputDir);
-  await fs.mkdir(path.dirname(outPath), { recursive: true });
-
-  const server = await startStaticServer(root, config, host, port);
-  try {
-    const pageCount = await printUrlToPdf({
-      root,
-      url: `http://${host}:${port}/?print=1`,
-      outPath,
-      waitForReady: waitForPrintReady,
-      debuggingPortBase: 9300,
-      debuggingPortRange: 600,
-      profilePrefix: "chrome-pdf",
-    });
-    console.log(`${pageCount} OpenPress pages printed to PDF`);
-  } finally {
-    await stopChildProcess(server);
-  }
-
-  return { pdfPath: outPath };
-}
-
-export function startStaticServer(root, config, host, port) {
-  return new Promise((resolve, reject) => {
-    const child = spawn("node", [STATIC_SERVER, config.outputDir, "--host", host, "--port", port, "--workspace", "."], {
-      cwd: root,
-      shell: false,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-    let settled = false;
-    let stderr = "";
-    const timer = setTimeout(() => {
-      if (settled) return;
-      settled = true;
-      child.kill();
-      reject(new Error(`Timed out waiting for OpenPress static server on ${host}:${port}`));
-    }, 10000);
-
-    child.stdout.on("data", (chunk) => {
-      const text = String(chunk);
-      if (!settled && text.includes("OpenPress static preview:")) {
-        settled = true;
-        clearTimeout(timer);
-        resolve(child);
-      }
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += String(chunk);
-    });
-    child.on("error", (error) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      reject(error);
-    });
-    child.on("close", (code) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      reject(new Error(`OpenPress static server exited with code ${code ?? 1}: ${stderr}`));
-    });
-  });
-}
-
-export async function writePdfStageDeployConfig(root, source, config) {
-  const deployRoot = path.resolve(root, source);
-  const openpressDir = path.join(deployRoot, "openpress");
-  await fs.mkdir(openpressDir, { recursive: true });
-  await fs.writeFile(
-    path.join(openpressDir, "deploy.json"),
-    `${JSON.stringify({ pdf: publicPdfHref(config), deployed_at: new Date().toISOString() }, null, 2)}\n`,
-    "utf8",
-  );
-  await fs.writeFile(
-    path.join(deployRoot, "_headers"),
-    `${publicPdfHref(config)}\n  Content-Type: application/pdf\n  Content-Disposition: inline; filename="${config.pdf.filename}"\n`,
-    "utf8",
-  );
-}

package/template/core/engine/commands/deploy.mjs

@@ -1,31 +0,0 @@
-import path from "node:path";
-import { deploySync } from "../output/deploy-sync.mjs";
-import { CLI_ENTRY, buildReactPdf, formatNodeScriptCommand, runCommand, writePdfStageDeployConfig } from "./_shared.mjs";
-
-export async function run({ root, config, options, recurse }) {
-  if (config.deploy.requiresConfirmation === true && !options.confirm) {
-    console.error("OpenPress deploy requires --confirm before updating a public Cloudflare Pages site.");
-    return 2;
-  }
-  const source = config.deploy.source;
-  const projectName = config.deploy.projectName;
-  const commitDirty = config.deploy.commitDirty;
-  if (options.dryRun) {
-    console.log("OpenPress deploy dry run");
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
-    console.log(`Step:    deploy-sync (copy ${config.outputDir} → ${source})`);
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} pdf . --output ${source}/${config.pdf.filename}`);
-    console.log(`Step:    write ${source}/openpress/deploy.json with deployment metadata`);
-    console.log(`Command: npx wrangler pages deploy ${source}${projectName ? ` --project-name=${projectName}` : ""}${commitDirty ? " --commit-dirty=true" : ""}`);
-    return 0;
-  }
-  const renderCode = await recurse("render", [root, "--renderer", "react"]);
-  if (renderCode !== 0) return renderCode;
-  await deploySync(root, config.outputDir, source);
-  await buildReactPdf({ root, config, outPath: path.resolve(root, source, config.pdf.filename), noBuild: true, recurse });
-  await writePdfStageDeployConfig(root, source, config);
-  const wranglerArgs = ["wrangler", "pages", "deploy", source];
-  if (projectName) wranglerArgs.push(`--project-name=${projectName}`);
-  if (commitDirty) wranglerArgs.push("--commit-dirty=true");
-  return runCommand("npx", wranglerArgs, root);
-}

package/template/core/engine/commands/dev.mjs

@@ -1,49 +0,0 @@
-import { exportDocument } from "../document-export.mjs";
-import { diagnose } from "./doctor.mjs";
-import { CLI_ENTRY, formatNodeScriptCommand, runCommand } from "./_shared.mjs";
-
-export async function run({ root, options }) {
-  const renderer = options.renderer ?? "react";
-  if (renderer !== "react") {
-    console.error(`Unknown renderer: ${renderer}`);
-    return 2;
-  }
-  const host = options.host ?? "127.0.0.1";
-  const port = options.port ?? "5173";
-  const url = `http://${host}:${port}/?dev=1`;
-  if (options.dryRun) {
-    console.log(`OpenPress dev URL: ${url}`);
-    if (!options.noBuild) {
-      console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} export .`);
-    }
-    console.log(`Command: npx vite --force --config vite.config.ts --host ${host} --port ${port}`);
-    return 0;
-  }
-  if (!options.noBuild) {
-    await exportDocument(root);
-  }
-
-  // One-line update notice (24h cached, network failure is silent).
-  await printDoctorNoticeIfStale(root);
-
-  console.log(`OpenPress dev: ${url}`);
-  return runCommand("npx", ["vite", "--force", "--config", "vite.config.ts", "--host", host, "--port", port], root);
-}
-
-async function printDoctorNoticeIfStale(root) {
-  try {
-    const report = await diagnose(root);
-    if (!report.stale) return;
-    const parts = [];
-    if (report.coreUpdateAvailable) {
-      parts.push(`@open-press/core ${report.coreVersion} → ${report.coreLatest}`);
-    }
-    if (report.pendingMigrations.length > 0) {
-      parts.push(`${report.pendingMigrations.length} migration note(s)`);
-    }
-    if (parts.length === 0) return;
-    console.log(`○ open-press: ${parts.join(" · ")} — run \`npx open-press doctor\` for details.`);
-  } catch {
-    // Doctor is informational only; never block dev.
-  }
-}

package/template/core/engine/commands/doctor.mjs

@@ -1,229 +0,0 @@
-import { existsSync } from "node:fs";
-import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24h
-const CORE_PACKAGE = "@open-press/core";
-
-export async function run({ root, options }) {
-  const json = Boolean(options?.json);
-  const noCache = Boolean(options?.noCache);
-
-  const report = await diagnose(root, { noCache });
-
-  if (json) {
-    process.stdout.write(JSON.stringify(report, null, 2) + "\n");
-  } else {
-    printHumanReport(report);
-  }
-
-  // Exit 0 even when stale — doctor is informational, not a gate.
-  // Agents / CI can check report.stale or report.coreUpdateAvailable.
-  return 0;
-}
-
-/**
- * Diagnose workspace against latest framework state.
- * Result shape:
- *   {
- *     coreVersion: "0.4.0",                    // installed
- *     coreLatest: "0.5.0" | null,              // null on network failure
- *     coreUpdateAvailable: boolean,
- *     skillsInstalled: ["openpress", ...],
- *     skillsLockSource: "quan0715/open-press" | null,
- *     pendingMigrations: ["0.5.0"],            // versions with docs/migrations notes
- *     stale: boolean,                          // either core or skills behind
- *     cachedAt: ISO timestamp
- *   }
- */
-export async function diagnose(root, { noCache = false } = {}) {
-  const cachePath = path.join(root, ".openpress", "cache", "doctor.json");
-
-  if (!noCache) {
-    const cached = await readCached(cachePath);
-    if (cached) return cached;
-  }
-
-  const coreVersion = await readCoreVersion(root);
-  const coreLatest = await fetchCoreLatest();
-  const skillsInstalled = await listInstalledSkills(root);
-  const skillsLockSource = await readSkillsLockSource(root);
-  const pendingMigrations = await listPendingMigrations(root, coreVersion, coreLatest);
-
-  const coreUpdateAvailable = Boolean(
-    coreVersion && coreLatest && coreVersion !== coreLatest && semverLt(coreVersion, coreLatest),
-  );
-
-  const report = {
-    coreVersion,
-    coreLatest,
-    coreUpdateAvailable,
-    skillsInstalled,
-    skillsLockSource,
-    pendingMigrations,
-    stale: coreUpdateAvailable || pendingMigrations.length > 0,
-    cachedAt: new Date().toISOString(),
-  };
-
-  await writeCached(cachePath, report).catch(() => {});
-  return report;
-}
-
-async function readCached(cachePath) {
-  try {
-    const stats = await stat(cachePath);
-    if (Date.now() - stats.mtimeMs > CACHE_TTL_MS) return null;
-    return JSON.parse(await readFile(cachePath, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-async function writeCached(cachePath, report) {
-  await mkdir(path.dirname(cachePath), { recursive: true });
-  await writeFile(cachePath, JSON.stringify(report, null, 2) + "\n", "utf8");
-}
-
-async function readCoreVersion(root) {
-  // Try workspace package.json deps first; fall back to installed package.
-  try {
-    const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
-    const range = pkg.dependencies?.[CORE_PACKAGE] ?? pkg.devDependencies?.[CORE_PACKAGE];
-    if (range) {
-      // Try the installed version (more accurate than the range).
-      try {
-        const installed = JSON.parse(
-          await readFile(path.join(root, "node_modules", CORE_PACKAGE, "package.json"), "utf8"),
-        );
-        return installed.version;
-      } catch {
-        return range.replace(/^[\^~>=<\s]+/, "");
-      }
-    }
-  } catch {}
-
-  // Self-bundled framework (cli scaffolded workspace): pkg.version is the framework version.
-  try {
-    const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
-    if (pkg.name === CORE_PACKAGE) return pkg.version;
-  } catch {}
-
-  return null;
-}
-
-async function fetchCoreLatest() {
-  try {
-    const res = await fetch(`https://registry.npmjs.org/${CORE_PACKAGE}/latest`, {
-      headers: { Accept: "application/json" },
-      signal: AbortSignal.timeout(5000),
-    });
-    if (!res.ok) return null;
-    const data = await res.json();
-    return typeof data.version === "string" ? data.version : null;
-  } catch {
-    return null;
-  }
-}
-
-async function listInstalledSkills(root) {
-  const skillsDir = path.join(root, ".agents", "skills");
-  try {
-    const { readdir } = await import("node:fs/promises");
-    const entries = await readdir(skillsDir, { withFileTypes: true });
-    return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
-  } catch {
-    return [];
-  }
-}
-
-async function readSkillsLockSource(root) {
-  try {
-    const lock = JSON.parse(await readFile(path.join(root, "skills-lock.json"), "utf8"));
-    const sources = lock?.sources;
-    if (Array.isArray(sources) && sources.length > 0) return sources[0]?.source ?? null;
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-async function listPendingMigrations(root, currentVersion, latestVersion) {
-  if (!currentVersion || !latestVersion || !semverLt(currentVersion, latestVersion)) return [];
-  // Look for docs/migrations/<version>.md files for versions in (current, latest].
-  const migrationsDir = path.join(root, "docs", "migrations");
-  try {
-    const { readdir } = await import("node:fs/promises");
-    const files = await readdir(migrationsDir);
-    return files
-      .filter((f) => /^\d+\.\d+\.\d+\.md$/.test(f))
-      .map((f) => f.replace(/\.md$/, ""))
-      .filter((v) => semverGt(v, currentVersion) && !semverGt(v, latestVersion))
-      .sort(semverCompare);
-  } catch {
-    return [];
-  }
-}
-
-function semverParse(v) {
-  const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
-  if (!m) return [0, 0, 0];
-  return [Number(m[1]), Number(m[2]), Number(m[3])];
-}
-function semverCompare(a, b) {
-  const A = semverParse(a);
-  const B = semverParse(b);
-  for (let i = 0; i < 3; i++) if (A[i] !== B[i]) return A[i] - B[i];
-  return 0;
-}
-function semverLt(a, b) { return semverCompare(a, b) < 0; }
-function semverGt(a, b) { return semverCompare(a, b) > 0; }
-
-function printHumanReport(report) {
-  const lines = [];
-  lines.push("○ open-press doctor");
-  lines.push("");
-  lines.push("framework");
-  if (report.coreVersion) {
-    if (report.coreLatest === null) {
-      lines.push(`  ? @open-press/core: ${report.coreVersion} installed (couldn't check latest — offline?)`);
-    } else if (report.coreUpdateAvailable) {
-      lines.push(`  ⚠ @open-press/core: ${report.coreVersion} installed → ${report.coreLatest} available`);
-    } else {
-      lines.push(`  ✓ @open-press/core: ${report.coreVersion} (latest)`);
-    }
-  } else {
-    lines.push("  ? @open-press/core: not detected in this workspace");
-  }
-  lines.push("");
-  lines.push("skills");
-  if (report.skillsInstalled.length === 0) {
-    lines.push("  ? no skills installed under .agents/skills/");
-    lines.push("    run: npx skills add quan0715/open-press");
-  } else {
-    lines.push(`  ✓ ${report.skillsInstalled.length} skills installed`);
-    if (report.skillsLockSource) {
-      lines.push(`    source: ${report.skillsLockSource}`);
-      lines.push("    refresh: npx skills upgrade");
-    }
-  }
-  lines.push("");
-  lines.push("migrations");
-  if (report.pendingMigrations.length === 0) {
-    if (report.coreUpdateAvailable) {
-      lines.push(`  ✓ no breaking migrations documented for the ${report.coreLatest} window`);
-    } else {
-      lines.push("  ✓ up to date");
-    }
-  } else {
-    lines.push(`  ⚠ ${report.pendingMigrations.length} migration note(s) since your version:`);
-    for (const v of report.pendingMigrations) lines.push(`    - docs/migrations/${v}.md`);
-  }
-  lines.push("");
-  if (report.stale) {
-    lines.push("next");
-    lines.push("  npx open-press upgrade        # apply all updates (agent-driven)");
-    lines.push("  npx open-press doctor --json  # machine-readable output");
-    lines.push("");
-  }
-  process.stdout.write(lines.join("\n"));
-}

package/template/core/engine/commands/export.mjs

@@ -1,8 +0,0 @@
-import path from "node:path";
-import { exportDocument } from "../document-export.mjs";
-
-export async function run({ root }) {
-  const result = await exportDocument(root);
-  console.log(`OpenPress export: ${path.relative(root, result.documentPath)} (${result.pageCount} pages)`);
-  return 0;
-}

package/template/core/engine/commands/init.mjs

@@ -1,24 +0,0 @@
-import { initWorkspace, listStylePackSkills } from "../init.mjs";
-import { formatDisplayPath, parseInitOptions } from "./_shared.mjs";
-
-export const needsWorkspace = false;
-
-export async function run({ argv }) {
-  const options = parseInitOptions(argv);
-  if (!options.target) {
-    console.error("openpress init: target path is required");
-    console.error("Usage: openpress init <target> [--skill <name>] [--force]");
-    const available = await listStylePackSkills();
-    if (available.length) console.error(`Style packs available: ${available.join(", ")}`);
-    return 1;
-  }
-  const result = await initWorkspace(options);
-  const displayPath = formatDisplayPath(result.targetPath);
-  console.log(`OpenPress init: created ${displayPath} from style pack "${result.skill}".`);
-  console.log("Next steps:");
-  console.log(`  cd ${displayPath}`);
-  console.log("  # 填入 openpress.config.mjs 的 title / subtitle / organization");
-  console.log("  # 改 document/index.tsx 與 document/chapters/**/*.mdx 為實際內容");
-  console.log("  node engine/cli.mjs validate");
-  return 0;
-}

package/template/core/engine/commands/inspect.mjs

@@ -1,35 +0,0 @@
-import { inspectWorkspace } from "../runtime/inspection.mjs";
-import { exitCodeForIssueReport } from "../runtime/issue-report.mjs";
-
-export async function run({ root, config, options, recurse }) {
-  const host = options.host ?? "127.0.0.1";
-  const port = options.port ?? "5186";
-  const url = `http://${host}:${port}/?print=1`;
-
-  if (options.dryRun) {
-    if (!options.noBuild) {
-      console.log("Command: node engine/cli.mjs render . --renderer react");
-    }
-    console.log(`Command: node engine/output/static-server.mjs ${config.outputDir} --host ${host} --port ${port} --workspace .`);
-    console.log(`Chrome inspection URL: ${url}`);
-    return 0;
-  }
-
-  const report = await inspectWorkspace({ root, config, options, recurse });
-  if (options.json) {
-    console.log(JSON.stringify(report, null, 2));
-    return exitCodeForIssueReport(report);
-  }
-
-  if (report.ok) {
-    console.log(report.format());
-    console.log(`Checked: ${report.checked.join(", ")}`);
-    if (report.summary) {
-      console.log(`Summary: ${JSON.stringify(report.summary)}`);
-    }
-    return 0;
-  }
-
-  console.log(report.format());
-  return exitCodeForIssueReport(report);
-}

package/template/core/engine/commands/pdf.mjs

@@ -1,26 +0,0 @@
-import path from "node:path";
-import { CLI_ENTRY, STATIC_SERVER, buildReactPdf, formatNodeScriptCommand } from "./_shared.mjs";
-
-export async function run({ root, config, options, recurse }) {
-  const outputPath = options.output ? path.resolve(root, options.output) : undefined;
-  if (options.dryRun) {
-    const relOutput = path.relative(root, outputPath ?? config.paths.pdf);
-    const host = options.host ?? "127.0.0.1";
-    const port = options.port ?? "5185";
-    console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
-    console.log(`Command: ${formatNodeScriptCommand(root, STATIC_SERVER)} ${config.outputDir} --host ${host} --port ${port} --workspace .`);
-    console.log(`Command: Chrome --print-to-pdf=${relOutput} http://${host}:${port}/?print=1`);
-    return 0;
-  }
-  const result = await buildReactPdf({
-    root,
-    config,
-    outPath: outputPath,
-    host: options.host,
-    port: options.port,
-    noBuild: options.noBuild,
-    recurse,
-  });
-  console.log(`OpenPress PDF: ${path.relative(root, result.pdfPath)}`);
-  return 0;
-}

package/template/core/engine/commands/preview.mjs

@@ -1,26 +0,0 @@
-import { CLI_ENTRY, STATIC_SERVER, formatNodeScriptCommand, runCommand } from "./_shared.mjs";
-
-export async function run({ root, config, options, recurse }) {
-  const renderer = options.renderer ?? "react";
-  if (renderer !== "react") {
-    console.error(`Unknown renderer: ${renderer}`);
-    return 2;
-  }
-  const host = options.host ?? "127.0.0.1";
-  const port = options.port ?? "5173";
-  const url = `http://${host}:${port}`;
-  if (options.dryRun) {
-    console.log(`OpenPress preview URL: ${url}`);
-    if (!options.noBuild) {
-      console.log(`Command: ${formatNodeScriptCommand(root, CLI_ENTRY)} render . --renderer react`);
-    }
-    console.log(`Command: ${formatNodeScriptCommand(root, STATIC_SERVER)} ${config.outputDir} --host ${host} --port ${port} --workspace .`);
-    return 0;
-  }
-  if (!options.noBuild) {
-    const renderCode = await recurse("render", [root, "--renderer", renderer]);
-    if (renderCode !== 0) return renderCode;
-  }
-  console.log(`OpenPress preview: ${url}`);
-  return runCommand("node", [STATIC_SERVER, config.outputDir, "--host", host, "--port", port, "--workspace", "."], root);
-}

package/template/core/engine/commands/render.mjs

@@ -1,17 +0,0 @@
-import { exportDocument } from "../document-export.mjs";
-import { runCommand } from "./_shared.mjs";
-
-export async function run({ root, options }) {
-  const renderer = options.renderer ?? "react";
-  if (renderer !== "react") {
-    console.error(`Unknown renderer: ${renderer}`);
-    return 2;
-  }
-  if (options.dryRun) {
-    console.log("Command: node engine/cli.mjs export .");
-    console.log("Command: npx vite build --config vite.config.ts");
-    return 0;
-  }
-  await exportDocument(root);
-  return runCommand("npx", ["vite", "build", "--config", "vite.config.ts"], root);
-}

package/template/core/engine/commands/replace.mjs

@@ -1,41 +0,0 @@
-import { replaceSourceText } from "../runtime/source-text-tools.mjs";
-
-export async function run({ config, options }) {
-  const args = replaceArgsFromOptions(options);
-  if (!args) {
-    console.error("Usage: node engine/cli.mjs replace [path] <from> <to> [--json] [--apply] [--scope content|all] [--include-code] [--case-sensitive]");
-    return 2;
-  }
-
-  const report = await replaceSourceText({
-    config,
-    from: args.from,
-    to: args.to,
-    scope: options.scope ?? "content",
-    caseSensitive: options.caseSensitive === true,
-    includeCode: options.includeCode === true,
-    apply: options.apply === true,
-  });
-
-  if (options.json) {
-    console.log(JSON.stringify(report, null, 2));
-    return 0;
-  }
-
-  console.log(`OpenPress replace ${report.applied ? "applied" : "preview"}: "${args.from}" -> "${args.to}" (${report.matchCount} matches in ${report.fileCount} files)`);
-  if (!report.applied) console.log("No files written. Re-run with --apply to update sources.");
-  for (const change of report.changes) {
-    console.log(`${change.path}: ${change.replacements.length} replacements`);
-  }
-  return 0;
-}
-
-function replaceArgsFromOptions(options) {
-  const positional = options.positional ?? [];
-  const args = positional.length >= 3 ? positional.slice(1) : positional;
-  if (args.length < 2) return null;
-  return {
-    from: args[0],
-    to: args[1],
-  };
-}