@open-press/cli 1.0.0 → 1.1.0

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],
-  };
-}

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/skills-sync.mjs

@@ -1,71 +0,0 @@
-import path from "node:path";
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { runCommand } from "./_shared.mjs";
-
-const DEFAULT_SOURCE = "quan0715/open-press";
-
-// Refresh installed agent skills against the workspace's lock file.
-// Behavior:
-//   - If skills-lock.json exists, run `npx skills upgrade` (refreshes all
-//     currently-installed sources to their latest published versions).
-//   - If skills-lock.json is missing, install the OpenPress framework
-//     skill bundle (and any user-supplied --source) as a first-time setup.
-//   - If a --source flag is passed, also add that source on top of any
-//     existing installations.
-//
-// Always exits 0 unless the underlying `skills` tool fails.
-export async function run({ root, options }) {
-  const lockPath = path.join(root, "skills-lock.json");
-  const lockExists = existsSync(lockPath);
-  const extraSource = options?.source;
-
-  if (options?.dryRun) {
-    if (lockExists) {
-      console.log("Command: npx -y skills@latest upgrade");
-    } else {
-      console.log(`Command: npx -y skills@latest add ${DEFAULT_SOURCE}`);
-    }
-    if (extraSource) {
-      console.log(`Command: npx -y skills@latest add ${extraSource}`);
-    }
-    return 0;
-  }
-
-  if (lockExists) {
-    const sources = await readLockSources(lockPath);
-    if (sources.length === 0) {
-      console.log("skills-lock.json has no sources; installing framework default…");
-      const code = await runCommand("npx", ["-y", "skills@latest", "add", DEFAULT_SOURCE], root);
-      if (code !== 0) return code;
-    } else {
-      console.log(`Refreshing ${sources.length} installed source(s)…`);
-      for (const src of sources) console.log(`  ${src}`);
-      const code = await runCommand("npx", ["-y", "skills@latest", "upgrade"], root);
-      if (code !== 0) return code;
-    }
-  } else {
-    console.log(`No skills-lock.json; installing framework default: ${DEFAULT_SOURCE}`);
-    const code = await runCommand("npx", ["-y", "skills@latest", "add", DEFAULT_SOURCE], root);
-    if (code !== 0) return code;
-  }
-
-  if (extraSource) {
-    console.log(`Adding extra source: ${extraSource}`);
-    const code = await runCommand("npx", ["-y", "skills@latest", "add", extraSource], root);
-    if (code !== 0) return code;
-  }
-
-  console.log("✓ Skills synced");
-  return 0;
-}
-
-async function readLockSources(lockPath) {
-  try {
-    const lock = JSON.parse(await readFile(lockPath, "utf8"));
-    const sources = Array.isArray(lock?.sources) ? lock.sources : [];
-    return sources.map((s) => s?.source).filter((s) => typeof s === "string");
-  } catch {
-    return [];
-  }
-}

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

@@ -1,67 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { createRequire } from "node:module";
-import { runCommand } from "./_shared.mjs";
-
-// Run typecheck via the locally installed typescript. The previous
-// implementation used `npx tsc`; npm 11 + Node 24 (our CI / release
-// pin) changed npx's bin lookup so it no longer walks pnpm's nested
-// `.bin/` symlink farm and falls back to fetching the legacy
-// `tsc@2.0.4` shim, which crashes.
-//
-// Resolution order:
-//   1. `node <resolved tsc>` via require.resolve(typescript/package.json)
-//      — works with npm-hoisted layouts and most pnpm installs.
-//   2. Walk up node_modules/.bin/tsc — covers downstream npm/yarn.
-//   3. Fall back to `pnpm exec tsc` — pnpm knows its own symlink farm
-//      even when bare require.resolve doesn't, which is what CI hits.
-export async function run({ root }) {
-  const absoluteRoot = path.resolve(root);
-
-  const tscBin = resolveTscBin(absoluteRoot);
-  if (tscBin) {
-    return runCommand("node", [tscBin, "--noEmit", "-p", "tsconfig.json"], absoluteRoot);
-  }
-
-  if (hasCommand("pnpm")) {
-    return runCommand("pnpm", ["exec", "tsc", "--noEmit", "-p", "tsconfig.json"], absoluteRoot);
-  }
-
-  console.error("[openpress] typescript is not installed in this workspace.");
-  console.error("Add it with: npm install --save-dev typescript");
-  return 1;
-}
-
-function resolveTscBin(absoluteRoot) {
-  try {
-    const require = createRequire(path.join(absoluteRoot, "package.json"));
-    const pkgPath = require.resolve("typescript/package.json");
-    return path.join(path.dirname(pkgPath), "bin", "tsc");
-  } catch {
-    // fall through to .bin probe
-  }
-
-  let dir = absoluteRoot;
-  while (true) {
-    const candidate = path.join(dir, "node_modules", ".bin", "tsc");
-    if (fs.existsSync(candidate)) return candidate;
-    const parent = path.dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-
-function hasCommand(name) {
-  const PATH = process.env.PATH ?? "";
-  const sep = process.platform === "win32" ? ";" : ":";
-  const exts = process.platform === "win32"
-    ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";")
-    : [""];
-  for (const dir of PATH.split(sep)) {
-    if (!dir) continue;
-    for (const ext of exts) {
-      if (fs.existsSync(path.join(dir, name + ext))) return true;
-    }
-  }
-  return false;
-}

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 press/ 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 press/ for affected patterns, propose edits before applying.\n",
-    );
-  }
-
-  process.stdout.write("\nVerify with:\n  npm run build\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 press/index.tsx with a Press default export before exporting.",
-  );
-}

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>;