@open-press/cli 0.8.0 → 1.1.0

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

@@ -1,33 +0,0 @@
-import { searchSourceText } from "../runtime/source-text-tools.mjs";
-
-export async function run({ config, options }) {
-  const query = searchQueryFromOptions(options);
-  if (!query) {
-    console.error("Usage: node engine/cli.mjs search [path] <query> [--json] [--scope content|all] [--case-sensitive]");
-    return 2;
-  }
-
-  const report = await searchSourceText({
-    config,
-    query,
-    scope: options.scope ?? "content",
-    caseSensitive: options.caseSensitive === true,
-  });
-
-  if (options.json) {
-    console.log(JSON.stringify(report, null, 2));
-    return 0;
-  }
-
-  console.log(`OpenPress search: "${query}" (${report.matchCount} matches)`);
-  for (const match of report.matches) {
-    console.log(`${match.id} ${match.path}:${match.line}:${match.column} ${match.preview}`);
-  }
-  return 0;
-}
-
-function searchQueryFromOptions(options) {
-  const positional = options.positional ?? [];
-  if (positional.length > 1) return positional.slice(1).join(" ");
-  return positional[0] ?? "";
-}

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

@@ -1,5 +0,0 @@
-import { runCommand } from "./_shared.mjs";
-
-export async function run({ root }) {
-  return runCommand("npx", ["tsc", "--noEmit", "-p", "tsconfig.json"], root);
-}

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

@@ -1,159 +0,0 @@
-import { existsSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { diagnose } from "./doctor.mjs";
-import { runCommand } from "./_shared.mjs";
-
-// Migration notes live in the framework repo, not in scaffolded workspaces.
-// `npx open-press upgrade` fetches the notes for each pending version and
-// caches them under `.openpress/migrations/` so agents can read locally.
-const MIGRATION_REMOTE_BASE = "https://raw.githubusercontent.com/quan0715/open-press/main/docs/migrations";
-const MIGRATION_CACHE_DIR = path.join(".openpress", "migrations");
-
-export async function run({ root, options }) {
-  const dryRun = Boolean(options?.dryRun);
-  const skipSkills = Boolean(options?.noSkills);
-  const skipDeps = Boolean(options?.noDeps);
-  const json = Boolean(options?.json);
-
-  // 1. Fresh diagnose (force re-check, ignore cache).
-  const before = await diagnose(root, { noCache: true });
-
-  if (!before.stale) {
-    const message = "open-press is already up to date.";
-    if (json) {
-      process.stdout.write(JSON.stringify({ status: "noop", before }, null, 2) + "\n");
-    } else {
-      process.stdout.write(`✓ ${message}\n`);
-    }
-    return 0;
-  }
-
-  if (!json) {
-    process.stdout.write("○ open-press upgrade\n\n");
-    if (before.coreUpdateAvailable) {
-      process.stdout.write(
-        `  @open-press/core: ${before.coreVersion} → ${before.coreLatest}\n`,
-      );
-    }
-    if (before.pendingMigrations.length > 0) {
-      process.stdout.write(`  migration notes: ${before.pendingMigrations.join(", ")}\n`);
-    }
-    process.stdout.write("\n");
-  }
-
-  if (dryRun) {
-    if (!json) {
-      process.stdout.write("dry run — nothing changed. The agent should:\n");
-      process.stdout.write("  1. read each docs/migrations/<version>.md for document-level changes\n");
-      process.stdout.write("  2. apply edits to document/ where needed\n");
-      process.stdout.write("  3. re-run: npx open-press upgrade   (without --dry-run)\n");
-    } else {
-      process.stdout.write(JSON.stringify({ status: "dry-run", before }, null, 2) + "\n");
-    }
-    return 0;
-  }
-
-  // 2. Refresh framework dep (only when workspace declares @open-press/core).
-  if (!skipDeps && (await hasCoreDep(root))) {
-    if (!json) process.stdout.write("▸ updating @open-press/core via npm…\n");
-    const code = runCommand("npm", ["update", "@open-press/core"], root);
-    if (code !== 0) {
-      if (!json) process.stdout.write("  ⚠ npm update returned non-zero; continuing\n");
-    }
-  }
-
-  // 3. Refresh skills (npx skills upgrade respects skills-lock.json).
-  if (!skipSkills) {
-    if (!json) process.stdout.write("▸ refreshing skills via npx skills upgrade…\n");
-    runCommand("npx", ["-y", "skills@latest", "upgrade"], root);
-  }
-
-  // 4. Surface migration notes for the agent to read.
-  const migrationContents = await loadMigrations(root, before.pendingMigrations);
-
-  // 5. Re-diagnose to confirm the move.
-  const after = await diagnose(root, { noCache: true });
-
-  if (json) {
-    process.stdout.write(
-      JSON.stringify(
-        { status: "applied", before, after, migrationContents: migrationContents.map((m) => m.path) },
-        null,
-        2,
-      ) + "\n",
-    );
-    return 0;
-  }
-
-  process.stdout.write("\n✓ upgrade applied. Now read these migration notes:\n\n");
-  if (migrationContents.length === 0) {
-    process.stdout.write("  (no migration docs in this version range)\n\n");
-  } else {
-    for (const m of migrationContents) {
-      if (m.path) {
-        process.stdout.write(`  ─ ${m.path}${m.fetched ? "  (fetched from github)" : ""}\n`);
-      } else {
-        process.stdout.write(`  ─ ${m.version}.md  (not found locally or on github — check the repo manually)\n`);
-      }
-    }
-    process.stdout.write(
-      "\nAgent: open each file, identify document-level changes, grep document/ for affected patterns, propose edits before applying.\n",
-    );
-  }
-
-  process.stdout.write("\nVerify with:\n  npm run openpress:validate\n  npm run openpress:render\n\n");
-  return 0;
-}
-
-async function hasCoreDep(root) {
-  try {
-    const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
-    return Boolean(pkg.dependencies?.["@open-press/core"] || pkg.devDependencies?.["@open-press/core"]);
-  } catch {
-    return false;
-  }
-}
-
-async function loadMigrations(root, versions) {
-  const results = [];
-  const cacheDir = path.join(root, MIGRATION_CACHE_DIR);
-  await mkdir(cacheDir, { recursive: true });
-
-  for (const v of versions) {
-    // Framework repo has docs/migrations/ at root — prefer local if present
-    // (covers the open-press framework repo itself acting as a workspace).
-    const localDocsPath = path.join(root, "docs", "migrations", `${v}.md`);
-    if (existsSync(localDocsPath)) {
-      results.push({ version: v, path: path.relative(root, localDocsPath), fetched: false });
-      continue;
-    }
-
-    // Otherwise fetch from GitHub raw and cache to .openpress/migrations/.
-    const cachedPath = path.join(cacheDir, `${v}.md`);
-    if (existsSync(cachedPath)) {
-      results.push({ version: v, path: path.relative(root, cachedPath), fetched: false });
-      continue;
-    }
-
-    const body = await fetchMigration(v);
-    if (body) {
-      await writeFile(cachedPath, body, "utf8");
-      results.push({ version: v, path: path.relative(root, cachedPath), fetched: true });
-    } else {
-      results.push({ version: v, path: null, fetched: false });
-    }
-  }
-  return results;
-}
-
-async function fetchMigration(version) {
-  const url = `${MIGRATION_REMOTE_BASE}/${version}.md`;
-  try {
-    const res = await fetch(url, { headers: { Accept: "text/plain" } });
-    if (!res.ok) return null;
-    return await res.text();
-  } catch {
-    return null;
-  }
-}

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

@@ -1,17 +0,0 @@
-import { validateWorkspace } from "../runtime/validation.mjs";
-import { exitCodeForIssueReport } from "../runtime/issue-report.mjs";
-
-export async function run({ root, options }) {
-  const report = await validateWorkspace(root);
-  if (options.json) {
-    console.log(JSON.stringify(report, null, 2));
-    return exitCodeForIssueReport(report);
-  }
-  if (report.ok) {
-    console.log("OpenPress validation OK");
-    console.log(`Checked: ${report.checked.join(", ")}`);
-    return 0;
-  }
-  console.log(report.format());
-  return 1;
-}

package/template/core/engine/document-export.mjs

@@ -1,15 +0,0 @@
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { exportReactDocument } from "./react/document-export.mjs";
-
-const SELF_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(SELF_DIR, "..");
-
-export async function exportDocument(root = ROOT) {
-  const reactResult = await exportReactDocument(root);
-  if (reactResult) return reactResult;
-
-  throw new Error(
-    "React/MDX document entry not found. Expected document/index.tsx with a Press default export before exporting.",
-  );
-}

package/template/core/engine/init.mjs

@@ -1,90 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const SELF_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ENGINE_ROOT = path.resolve(SELF_DIR, "..");
-const SKILLS_DIR = path.join(ENGINE_ROOT, "skills");
-
-const DEFAULT_SKILL = "editorial-monograph";
-
-export async function initWorkspace({ target, skill = DEFAULT_SKILL, force = false }) {
-  if (!target) throw new Error("openpress init: target path is required");
-  const targetPath = path.resolve(target);
-
-  const starterPath = path.join(SKILLS_DIR, skill, "starter");
-  try {
-    const stat = await fs.stat(starterPath);
-    if (!stat.isDirectory()) {
-      throw new Error(`openpress init: skill "${skill}" has no starter/ directory at ${starterPath}`);
-    }
-  } catch (error) {
-    if (error?.code === "ENOENT") {
-      const available = await listStylePackSkills();
-      throw new Error(
-        `openpress init: skill "${skill}" not found or has no starter. ` +
-        `Available style packs: ${available.join(", ") || "(none)"}`,
-      );
-    }
-    throw error;
-  }
-
-  if (!force) {
-    try {
-      const stat = await fs.stat(targetPath);
-      if (stat.isDirectory()) {
-        const entries = await fs.readdir(targetPath);
-        if (entries.length > 0) {
-          throw new Error(`openpress init: target ${targetPath} exists and is not empty. Pass --force to overwrite.`);
-        }
-      } else {
-        throw new Error(`openpress init: target ${targetPath} exists and is not a directory.`);
-      }
-    } catch (error) {
-      if (error?.code !== "ENOENT") throw error;
-    }
-  }
-
-  await fs.mkdir(targetPath, { recursive: true });
-  await copyDirectory(starterPath, targetPath);
-
-  return { targetPath, skill };
-}
-
-export async function listStylePackSkills() {
-  try {
-    const entries = await fs.readdir(SKILLS_DIR, { withFileTypes: true });
-    const names = [];
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const starter = path.join(SKILLS_DIR, entry.name, "starter");
-      try {
-        const stat = await fs.stat(starter);
-        if (stat.isDirectory()) names.push(entry.name);
-      } catch {
-        // skill without starter/ is not a style pack — skip
-      }
-    }
-    return names.sort();
-  } catch (error) {
-    if (error?.code === "ENOENT") return [];
-    throw error;
-  }
-}
-
-async function copyDirectory(source, destination) {
-  await fs.mkdir(destination, { recursive: true });
-  for (const entry of await fs.readdir(source, { withFileTypes: true })) {
-    if (entry.name === ".DS_Store") continue;
-    const sourcePath = path.join(source, entry.name);
-    const destPath = path.join(destination, entry.name);
-    if (entry.isDirectory()) {
-      await copyDirectory(sourcePath, destPath);
-    } else if (entry.isFile()) {
-      await fs.copyFile(sourcePath, destPath);
-    } else if (entry.isSymbolicLink()) {
-      const link = await fs.readlink(sourcePath);
-      await fs.symlink(link, destPath);
-    }
-  }
-}

package/template/core/engine/output/chrome-pdf.d.mts

@@ -1,34 +0,0 @@
-import type { ChildProcess } from "node:child_process";
-
-export interface ChromeDevToolsClient {
-  send(method: string, params?: Record<string, unknown>): Promise<any>;
-  close(): void;
-}
-
-export interface PrintUrlToPdfOptions {
-  root: string;
-  url: string;
-  outPath: string;
-  chrome?: string;
-  waitForReady?: (client: ChromeDevToolsClient) => Promise<unknown>;
-  printOptions?: Record<string, unknown>;
-  debuggingPortBase?: number;
-  debuggingPortRange?: number;
-  profilePrefix?: string;
-}
-
-export interface EvaluateUrlWithChromeOptions {
-  root: string;
-  url: string;
-  chrome?: string;
-  evaluate: (client: ChromeDevToolsClient) => Promise<unknown>;
-  emulatedMedia?: "screen" | "print" | "none";
-  debuggingPortBase?: number;
-  debuggingPortRange?: number;
-  profilePrefix?: string;
-}
-
-export function printUrlToPdf(options: PrintUrlToPdfOptions): Promise<unknown>;
-export function evaluateUrlWithChrome(options: EvaluateUrlWithChromeOptions): Promise<unknown>;
-export function waitForPrintReady(client: ChromeDevToolsClient): Promise<number>;
-export function stopChildProcess(child: ChildProcess): Promise<void>;