@open-press/cli 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @open-press/cli
 
-Scaffolder for [open-press](https://github.com/quan0715/open-press) — an AI-first fixed-layout document workspace.
+Workspace CLI for [open-press](https://github.com/quan0715/open-press) — an AI-first fixed-layout document workspace.
 
 ## Prerequisite
 
@@ -16,7 +16,7 @@ npm run dev
 
 Then open the local URL printed by Vite (typically `http://127.0.0.1:5173/?dev=1`).
 
-The CLI creates the OpenPress runtime workspace only. Starters and examples live in skills, installed separately with `npx skills add <owner/repo>`. The starter-bearing skills in the framework repo are just skills; agents can read and use them directly.
+The CLI creates a package-based OpenPress workspace. Runtime files stay inside `@open-press/core`; your project keeps only source files, theme files, media, and npm scripts.
 
 ## Usage
 
@@ -27,16 +27,15 @@ npx @open-press/cli init <target> [flags]
 | Flag                 | Description                                                                 |
 | -------------------- | --------------------------------------------------------------------------- |
 | `--title <s>`        | Document title (written to workspace config)                                |
-| `--subtitle <s>`     | Document subtitle                                                           |
-| `--organization <s>` | Organization name                                                           |
-| `--author <s>`       | Author name                                                                 |
 | `--no-git`           | Skip `git init` + initial commit (use when scaffolding inside an existing repo) |
 | `--no-install`       | Skip `npm install` (offline, or you'll run pnpm/bun yourself)              |
+| `--skills`           | Install OpenPress agent skills after scaffolding                            |
+| `--no-skills`        | Skip agent skill installation                                               |
 | `--help`             | Print help                                                                  |
 
 > The target must be empty. A `.git/` directory or other harmless dotfiles (`.gitignore`, `.gitkeep`, `.DS_Store`) are ignored — common when scaffolding into a fresh repo.
 
-To use an opinionated starter, install a skill and let the agent read that skill's files:
+To use an opinionated starter, install a skill and let the agent copy that starter's `press/` files into the workspace:
 
 ```bash
 npx -y skills@latest add quan0715/openpress-social-card-skill
@@ -46,16 +45,16 @@ npx -y skills@latest add quan0715/openpress-social-card-skill
 
 A self-contained workspace with:
 
-- `engine/`, `src/`, `vite.config.ts` — the open-press framework (snapshot of `@open-press/core`)
-- `.claude/skills/` and `.agents/skills/` — agent skill files for Claude Code, Codex, Cursor, Copilot, etc.
-- `openpress.config.mjs` — workspace metadata (title, subtitle, organization, author)
-- `AGENTS.md` — agent contract
+- `package.json` with `@open-press/core`, `@open-press/cli`, and `open-press ...` scripts
+- `press/index.tsx` — the workspace document entry
+- `press/theme/`, `press/media/`, `press/components/` — user-owned authoring files
+- `press/design.md` — working design notes for agents and maintainers
 
-The `press/` or transitional `document/` source tree is added by a skill, user-authored code, or a project-specific workflow after init.
+It does **not** create `engine/`, `src/openpress/`, `index.html`, or `vite.config.ts` in your project. Those are package-owned runtime internals.
 
 ## After init
 
-Workspace commands (run via `npm run` or `node engine/cli.mjs`):
+Workspace commands (run via `npm run` or `open-press`):
 
 ```
 npm run dev                       # start workbench

package/dist/cli.js

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 
 // src/cli.ts
+import { spawn as spawn2 } from "child_process";
+import { createRequire } from "module";
+import path2 from "path";
 import process2 from "process";
 
 // src/init.ts
 import { spawn } from "child_process";
 import { existsSync } from "fs";
-import { cp, mkdir } from "fs/promises";
+import { mkdir, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import path from "path";
 import process from "process";
 import { fileURLToPath } from "url";
@@ -43,63 +46,36 @@ async function patchPressTitle(entryPath, title) {
 function escapeStringForJs(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }
-async function patchPackageJsonName(packagePath, newName) {
-  const text = await readFile(packagePath, "utf8");
-  const pkg = JSON.parse(text);
-  const prevName = typeof pkg.name === "string" ? pkg.name : "";
-  pkg.name = newName;
-  pkg.version = "0.0.0";
-  pkg.private = true;
-  pkg.description = `open-press workspace: ${newName}`;
-  for (const field of [
-    "publishConfig",
-    "files",
-    "bin",
-    "main",
-    "types",
-    "exports",
-    "homepage",
-    "repository",
-    "bugs",
-    "keywords",
-    "license",
-    "author"
-  ]) {
-    delete pkg[field];
-  }
-  await writeFile(packagePath, JSON.stringify(pkg, null, 2) + "\n");
-  return prevName;
-}
 
 // src/init.ts
 var FRAMEWORK_SKILLS_SOURCE = "quan0715/open-press";
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var TEMPLATE_ROOT = path.resolve(__dirname, "..", "template");
-var TEMPLATE_CORE = path.join(TEMPLATE_ROOT, "core");
+var CLI_PACKAGE_JSON = path.resolve(__dirname, "..", "package.json");
 async function init(options) {
-  ensureTemplateBundled();
   const target = path.resolve(process.cwd(), options.target);
   await ensureTarget(target);
+  const workspaceName = path.basename(target);
+  const title = options.title ?? "OpenPress Document";
+  const version = await readCliVersion();
   log(`Creating open-press workspace at ${target}`);
-  log("Copying framework (engine + runtime + config)\u2026");
-  await cp(TEMPLATE_CORE, target, { recursive: true });
-  const pkgPath = path.join(target, "package.json");
-  if (existsSync(pkgPath)) {
-    await patchPackageJsonName(pkgPath, path.basename(target));
-  }
+  await writeWorkspacePackageJson(target, workspaceName, version);
+  await writeWorkspaceGitignore(target);
+  await writeStarterPress(target, title);
   if (options.title) {
     const pressEntry = path.join(target, "press", "index.tsx");
-    if (existsSync(pressEntry)) {
-      log("Writing title into <Press> in press/index.tsx");
-      await patchPressTitle(pressEntry, options.title);
-    }
+    log("Writing title into <Press> in press/index.tsx");
+    await patchPressTitle(pressEntry, options.title);
   }
-  log(`Installing framework skills via \`npx skills add ${FRAMEWORK_SKILLS_SOURCE}\`\u2026`);
-  try {
-    await runInTarget(target, "npx", ["-y", "skills@latest", "add", FRAMEWORK_SKILLS_SOURCE]);
-  } catch (err) {
-    log(`(framework skills install failed; retry: npx skills add ${FRAMEWORK_SKILLS_SOURCE})`);
-    log(`  reason: ${err instanceof Error ? err.message : String(err)}`);
+  if (options.skills) {
+    log(`Installing framework skills via \`open-press skills add\`\u2026`);
+    try {
+      await runInTarget(target, "npx", ["-y", "skills@latest", "add", FRAMEWORK_SKILLS_SOURCE]);
+    } catch (err) {
+      log(`(framework skills install failed; retry later: open-press skills add)`);
+      log(`  reason: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  } else {
+    log("Skipping agent skills (--no-skills)");
   }
   if (options.install) {
     log("Installing dependencies (npm install)\u2026");
@@ -121,13 +97,6 @@ async function init(options) {
   }
   printNextSteps(target, options);
 }
-function ensureTemplateBundled() {
-  if (!existsSync(TEMPLATE_CORE)) {
-    throw new Error(
-      `Template not bundled at ${TEMPLATE_ROOT}. If running from source, run \`pnpm sync:template\` in packages/cli first.`
-    );
-  }
-}
 async function ensureTarget(target) {
   if (existsSync(target)) {
     const empty = await pathIsEmpty(target, { ignoreHarmless: true });
@@ -140,6 +109,189 @@ async function ensureTarget(target) {
   }
   await mkdir(target, { recursive: true });
 }
+async function readCliVersion() {
+  const pkg = JSON.parse(await readFile2(CLI_PACKAGE_JSON, "utf8"));
+  return typeof pkg.version === "string" && pkg.version ? pkg.version : "latest";
+}
+async function writeWorkspacePackageJson(target, workspaceName, version) {
+  const pkg = {
+    name: workspaceName,
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    description: `open-press workspace: ${workspaceName}`,
+    scripts: {
+      dev: "open-press dev . --renderer react",
+      build: "open-press render . --renderer react",
+      preview: "open-press preview . --renderer react",
+      typecheck: "open-press typecheck .",
+      "openpress:image": "open-press image .",
+      "openpress:pdf": "open-press pdf .",
+      "openpress:deploy": "open-press deploy .",
+      "openpress:deploy:dry-run": "open-press deploy . --confirm --dry-run",
+      "openpress:skills": "open-press skills update"
+    },
+    dependencies: {
+      "@open-press/core": version
+    },
+    devDependencies: {
+      "@open-press/cli": version,
+      "@types/node": "^25.8.0",
+      "@types/react": "^19.2.14",
+      "@types/react-dom": "^19.2.3",
+      typescript: "^6.0.3"
+    },
+    openpress: {
+      pdf: {
+        filename: "document.pdf"
+      },
+      deploy: {
+        adapter: "cloudflare-pages",
+        source: ".deploy/openpress",
+        projectName: null,
+        commitDirty: false,
+        requiresConfirmation: true
+      }
+    }
+  };
+  await writeFile2(path.join(target, "package.json"), `${JSON.stringify(pkg, null, 2)}
+`, "utf8");
+}
+async function writeWorkspaceGitignore(target) {
+  const content = [
+    "node_modules/",
+    ".DS_Store",
+    "*.log",
+    "",
+    "# OpenPress generated artifacts",
+    ".openpress/",
+    ".deploy/",
+    ".turbo/",
+    "dist/",
+    "dist-react/",
+    "public/openpress/",
+    "output/",
+    ""
+  ].join("\n");
+  await writeFile2(path.join(target, ".gitignore"), content, "utf8");
+}
+async function writeStarterPress(target, title) {
+  const pressRoot = path.join(target, "press");
+  await mkdir(path.join(pressRoot, "components"), { recursive: true });
+  await mkdir(path.join(pressRoot, "media"), { recursive: true });
+  await mkdir(path.join(pressRoot, "theme", "base"), { recursive: true });
+  await mkdir(path.join(pressRoot, "theme", "page-surfaces"), { recursive: true });
+  await mkdir(path.join(pressRoot, "theme", "shell"), { recursive: true });
+  await writeFile2(path.join(pressRoot, "design.md"), `# ${title}
+
+Starter OpenPress workspace.
+`, "utf8");
+  await writeFile2(path.join(pressRoot, "media", "README.md"), "# Media\n\nPlace project media here.\n", "utf8");
+  await writeFile2(
+    path.join(pressRoot, "theme", "base", "page-contract.css"),
+    `* {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+  background: #181818;
+}
+
+body {
+  color: #171717;
+  font-family: var(--openpress-font-body, system-ui, sans-serif);
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
+}
+
+.reader-page {
+  background: #ffffff;
+}
+`,
+    "utf8"
+  );
+  await writeFile2(
+    path.join(pressRoot, "theme", "base", "typography.css"),
+    `h1,
+h2,
+h3,
+p {
+  margin: 0;
+}
+
+h1 {
+  font-family: var(--openpress-font-serif, Georgia, serif);
+  font-size: clamp(42px, 8cqw, 72px);
+  line-height: 1;
+  font-weight: 500;
+}
+
+p {
+  font-size: clamp(16px, 2cqw, 22px);
+  line-height: 1.5;
+}
+
+code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+`,
+    "utf8"
+  );
+  await writeFile2(
+    path.join(pressRoot, "theme", "base", "print.css"),
+    `@media print {
+  html,
+  body {
+    background: #ffffff;
+  }
+}
+`,
+    "utf8"
+  );
+  await writeFile2(path.join(pressRoot, "theme", "page-surfaces", "cover.css"), "/* Starter cover surface. */\n", "utf8");
+  await writeFile2(path.join(pressRoot, "theme", "page-surfaces", "back-cover.css"), "/* Starter back-cover surface. */\n", "utf8");
+  await writeFile2(path.join(pressRoot, "theme", "page-surfaces", "toc.css"), "/* Starter TOC surface. */\n", "utf8");
+  await writeFile2(path.join(pressRoot, "theme", "shell", "reader-controls.css"), "/* Starter reader controls surface. */\n", "utf8");
+  await writeFile2(
+    path.join(pressRoot, "theme", "tokens.css"),
+    `:root {
+  --openpress-font-body: system-ui, sans-serif;
+  --openpress-font-serif: Georgia, serif;
+}
+`,
+    "utf8"
+  );
+  await writeFile2(
+    path.join(pressRoot, "index.tsx"),
+    `import { Frame, Press, Workspace } from "@open-press/core";
+
+export default function OpenPressDocument() {
+  return (
+    <Workspace name="${escapeJsxAttribute(title)}">
+      <Press title="${escapeJsxAttribute(title)}">
+        <Frame frameKey="cover" role="manuscript.cover">
+          <main style={{ padding: "72px", fontFamily: "var(--openpress-font-serif, Georgia, serif)" }}>
+            <p style={{ letterSpacing: "0.12em", textTransform: "uppercase" }}>OpenPress</p>
+            <h1>${escapeText(title)}</h1>
+            <p>Edit <code>press/index.tsx</code>, then run <code>npm run dev</code>.</p>
+          </main>
+        </Frame>
+      </Press>
+    </Workspace>
+  );
+}
+`,
+    "utf8"
+  );
+}
+function escapeJsxAttribute(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}
+function escapeText(value) {
+  return value.replace(/{/g, "&#123;").replace(/}/g, "&#125;").replace(/</g, "&lt;");
+}
 async function runInTarget(cwd, command, args, opts = {}) {
   return new Promise((resolve, reject) => {
     const child = spawn(command, args, {
@@ -170,6 +322,9 @@ function printNextSteps(target, options) {
   if (!options.install) {
     lines.push("  npm install");
   }
+  if (!options.skills) {
+    lines.push("  npm run openpress:skills");
+  }
   lines.push(
     "",
     "  # start the workbench:",
@@ -177,30 +332,49 @@ function printNextSteps(target, options) {
     "",
     "Then open the local URL printed by Vite (typically http://127.0.0.1:5173/?dev=1).",
     "",
-    "Agent skills installed under .agents/skills/ (universal \u2014 read by Claude Code,",
-    `Cursor, Codex, Gemini CLI, etc.). Update later with: npx skills upgrade`,
-    "",
-    "Use an OpenPress-ready skill to add or adapt the press/document source tree.",
+    "Use an OpenPress-ready skill to add or adapt the press source tree.",
     ""
   );
   process.stdout.write(lines.join("\n"));
 }
 
 // src/cli.ts
+var require2 = createRequire(import.meta.url);
 var HELP = `open-press \u2014 AI-first fixed-layout document workspaces.
 
 Usage:
-  npx @open-press/cli init <target> [flags]
+  open-press init <target> [flags]
+  open-press <command> [path] [options]
+  open-press skills <add|update> [--source <owner/repo>]
 
-Flags:
+Init flags:
   --title <s>              Document title (written into <Press title="..."> in press/index.tsx)
   --no-git                 Skip git init
   --no-install             Skip npm install
+  --skills                 Install OpenPress agent skills after scaffolding
+  --no-skills              Skip agent skill installation
   --help                   Show this help
 
+Runtime commands:
+  dev                      Start the local OpenPress workbench
+  render                   Build the static reader
+  preview                  Preview the static reader
+  image                    Export pages to PNG
+  pdf                      Export pages to PDF
+  validate                 Validate source structure
+  inspect                  Inspect rendered output
+  search                   Search workspace source
+  replace                  Replace workspace source text
+  doctor                   Check package and skill freshness
+  upgrade                  Update workspace dependencies and skills
+  migrate                  Alias for upgrade
+  skills                   Install or update OpenPress agent skills
+
 Examples:
   npx @open-press/cli init my-doc
   npx @open-press/cli init my-brief --title "Q2 Brief"
+  npx open-press dev .
+  npx open-press image .
 `;
 async function main(argv) {
   if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
@@ -208,27 +382,26 @@ async function main(argv) {
     return 0;
   }
   const [subcommand, ...rest] = argv;
-  if (subcommand !== "init") {
-    process2.stderr.write(`Unknown command: ${subcommand}
-
+  if (subcommand === "init") {
+    const options = parseInitArgs(rest);
+    if (!options) {
+      process2.stderr.write(HELP);
+      return 1;
+    }
+    try {
+      await init(options);
+      return 0;
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process2.stderr.write(`open-press init failed: ${msg}
 `);
-    process2.stderr.write(HELP);
-    return 1;
-  }
-  const options = parseInitArgs(rest);
-  if (!options) {
-    process2.stderr.write(HELP);
-    return 1;
+      return 1;
+    }
   }
-  try {
-    await init(options);
-    return 0;
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    process2.stderr.write(`open-press init failed: ${msg}
-`);
-    return 1;
+  if (subcommand === "skills") {
+    return delegateToCore(normalizeSkillsArgs(rest));
   }
+  return delegateToCore([subcommand, ...rest]);
 }
 function parseInitArgs(args) {
   if (args.length === 0) {
@@ -239,7 +412,8 @@ function parseInitArgs(args) {
     target: "",
     title: void 0,
     git: true,
-    install: true
+    install: true,
+    skills: false
   };
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -253,12 +427,18 @@ function parseInitArgs(args) {
       case "--no-install":
         options.install = false;
         break;
+      case "--no-skills":
+        options.skills = false;
+        break;
       case "--git":
         options.git = true;
         break;
       case "--install":
         options.install = true;
         break;
+      case "--skills":
+        options.skills = true;
+        break;
       default:
         if (arg.startsWith("--")) {
           process2.stderr.write(`Unknown flag: ${arg}
@@ -281,6 +461,45 @@ function parseInitArgs(args) {
   }
   return options;
 }
+function normalizeSkillsArgs(args) {
+  const [subcommand, ...rest] = args;
+  if (!subcommand || subcommand === "add" || subcommand === "update") {
+    return ["skills:sync", ...rest];
+  }
+  return ["skills:sync", subcommand, ...rest];
+}
+async function delegateToCore(args) {
+  const coreCli = resolveCoreCli();
+  return new Promise((resolve, reject) => {
+    const child = spawn2(process2.execPath, [coreCli, ...args], {
+      cwd: process2.cwd(),
+      stdio: "inherit"
+    });
+    child.once("error", reject);
+    child.once("close", (code) => resolve(code ?? 1));
+  });
+}
+function resolveCoreCli() {
+  const coreEntry = require2.resolve("@open-press/core");
+  const coreRoot = findPackageRoot(coreEntry, "@open-press/core");
+  return path2.join(coreRoot, "engine", "cli.mjs");
+}
+function findPackageRoot(startPath, packageName) {
+  let dir = path2.dirname(startPath);
+  while (true) {
+    const pkgPath = path2.join(dir, "package.json");
+    try {
+      const pkg = require2(pkgPath);
+      if (pkg.name === packageName) return dir;
+    } catch {
+    }
+    const parent = path2.dirname(dir);
+    if (parent === dir) {
+      throw new Error(`Could not find ${packageName} package root from ${startPath}`);
+    }
+    dir = parent;
+  }
+}
 main(process2.argv.slice(2)).then((code) => process2.exit(code)).catch((err) => {
   process2.stderr.write(`${err instanceof Error ? err.stack ?? err.message : String(err)}
 `);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@open-press/cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
-  "description": "Scaffolder for open-press — AI-first fixed-layout document workspaces.",
+  "description": "Command line interface for OpenPress workspaces.",
   "license": "MIT",
   "author": "quan0715",
   "homepage": "https://github.com/quan0715/open-press#readme",
@@ -24,14 +24,15 @@
     "ai-first",
     "scaffold",
     "init",
-    "cli"
+    "cli",
+    "render",
+    "pdf"
   ],
   "bin": {
     "open-press": "dist/cli.js"
   },
   "files": [
     "dist",
-    "template",
     "README.md"
   ],
   "publishConfig": {
@@ -40,15 +41,16 @@
   "engines": {
     "node": ">=20"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@open-press/core": "1.1.0"
+  },
   "devDependencies": {
     "@types/node": "^25.8.0",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3"
   },
   "scripts": {
-    "sync:template": "node scripts/sync-template.mjs",
-    "build": "pnpm sync:template && tsup",
+    "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "pnpm build && node --test tests/*.test.mjs"