mosage 0.1.0 → 0.8.0

package/LICENSE

@@ -1,5 +1,6 @@
 MIT License
 
+Copyright (c) 2026 Simon Liu
 Copyright (c) 2026 CHENBOHAN
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/README.md

@@ -1,230 +1,29 @@
-# MoSage
+# mosage
 
-[![CI](https://github.com/nickchen1998/MoSage/actions/workflows/ci.yml/badge.svg)](https://github.com/nickchen1998/MoSage/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/mosage)](https://www.npmjs.com/package/mosage)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-
-**繁體中文** · [English](README.en.md)
-
-**和 AI 一起寫書、寫論文的本機寫作平台。** 用 Claude Code、Codex 等 AI 工具打開專案資料夾，
-跟 AI 對話完成立項、訂書名、排大綱、撰寫與修訂；你在瀏覽器裡用「書本排版」閱讀成果、
-選取文字留言給 AI、一鍵接受或拒絕 AI 的修改建議 —— 最後再匯出成出版社或學校要的 Word 檔。
-
-```bash
-npx mosage init my-writing
-```
-
-不需要資料庫，不需要帳號。所有內容都是專案資料夾裡的純文字檔（Markdown + YAML），圖片和參考資料直接複製進資料夾即可，
-可以用 git 管理版本，也可以用任何編輯器打開。
-
-## 為什麼
-
-直接在 Word 裡寫長篇稿件，格式和內容總是攪在一起：一邊構思，一邊處理目錄頁碼、標題樣式和「追蹤修訂」。
-AI 很擅長寫文字，但不擅長操作 Word。
-
-MoSage 把兩件事分開：
-
-- **寫作階段**：內容是 Markdown，AI 讀寫起來又快又準；你在瀏覽器裡看到的是排好版的書頁，而不是原始碼。
-- **交稿階段**：一鍵輸出 Word，標題樣式、目錄、頁碼、註腳、圖說都幫你處理好。
-
-## 特色
-
-- 📚 **一個專案，很多本書**：`books/` 底下每個資料夾就是一本書或一篇論文，各自有設定、進度與風格。
-- 🤖 **AI 帶你從零開始**：全新專案時，AI 會主動訪談你的寫作目的、讀者、風格與篇幅，再提出書名候選與章節架構。
-- 🗂️ **大綱編排**：在瀏覽器裡拖曳章節順序、直接修改章名與摘要、設定每章狀態（構想／草稿／修訂中／完成）。
-- 📖 **書本排版預覽**：首行縮排、行距、字型沿用 Word 匯出設定；單章閱讀或全書預覽。
-- 💬 **留言給 AI**：選取任何文字 → 留言。留言以標記存進 Markdown，對 AI 說「處理留言」就會處理。
-- ✍️ **修改建議，先看再決定**：AI 修改你寫好的文字時，會以「新舊對照」呈現，你按「接受」才會生效。
-- ⚡ **即時同步**：AI 改檔案的同時，瀏覽器畫面自動更新 —— 看著 AI 一節一節寫。
-- 🕰️ **自動版本紀錄**：每次內容改變前自動保存上一版，可比較差異、一鍵還原。
-- 📍 **AI 知道你在看哪裡**：說「這段改短一點」，AI 會讀取你在瀏覽器裡正在看的段落與選取的文字。
-- 📄 **匯出 Word**：真正的 Word 樣式（標題 1–4、內文、引文、圖說）、自動目錄、頁碼、註腳、表格、圖片；也能匯出 HTML（可列印成 PDF）與合併的 Markdown。
-- 📥 **匯入舊稿**：`mosage import 書稿.docx` 依標題樣式把 Word 稿切成章節，圖片與註腳一併帶入。
-- 🎓 **書與論文兩種預設**：論文預設標楷體＋Times New Roman 12pt、左邊界 3 公分，符合台灣常見的論文格式。
-
-## 快速開始
-
-需要 [Node.js](https://nodejs.org/) 20.19 以上。
-
-```bash
-npx mosage init my-writing     # 建立寫作專案
-cd my-writing
-npm run dev                    # 開啟寫作介面 → http://localhost:5280
-```
-
-另開一個終端機，在同一個資料夾啟動 AI 工具：
-
-```bash
-claude     # Claude Code
-codex      # 或 OpenAI Codex
-```
-
-然後對 AI 說「**開始**」（Claude Code 也可以輸入 `/kickoff`）。
-
-## 寫作流程
-
-| 階段 | 你對 AI 說 | 發生什麼事 |
-| --- | --- | --- |
-| 1. 立項 | 「開始」 | AI 一次問一兩題：目的、類型、讀者、核心主張、風格、篇幅、既有素材。確認後建立 `books/<代號>/`、寫作企劃 `brief.md` 與風格指南 `STYLE.md` |
-| 2. 大綱 | 「幫我訂書名和大綱」 | 提出 5 個書名與 2–3 種章節架構；定案後建立每章骨架（小節＋要點） |
-| 3. 編排 | —— | 你在介面「大綱」頁拖曳排序、修改章名與摘要、新增或移出章節 |
-| 4. 撰寫 | 「寫第一章」 | AI 讀企劃、風格與前後章，一節一節寫，畫面即時更新；需要你補充資料的地方會留言 |
-| 5. 修訂 | 「處理留言」「幫我審這章」 | 你選取文字留言；AI 回以修改建議，你逐一接受或拒絕 |
-| 6. 匯出 | —— | 介面右上角「匯出 → Word」，或 `npx mosage export <書> docx` |
-
-寫到一半想改大綱？直接說，AI 會調整章節並保留已寫好的內容。想寫第二本？說「我想寫一本新書」。
-
-## 專案結構
-
-```
-my-writing/
-├── mosage.yaml              專案預設值：作者、AI 修改模式、共用匯出格式
-├── AGENTS.md                給 AI 的協作守則（CLAUDE.md 會引用它）
-├── .agents/skills/          AI skills（Codex 等工具讀這裡）
-├── .claude/skills/          → 連到 .agents/skills（Claude Code 讀這裡）
-├── notes/                   所有書共用的素材（作者簡介…）
-├── books/
-│   └── <代號>/
-│       ├── book.yaml        類型、階段、書名、章節順序、Word 格式
-│       ├── brief.md         寫作企劃
-│       ├── STYLE.md         風格指南
-│       ├── chapters/        01-xxx.md、02-xxx.md …
-│       ├── assets/          圖片
-│       └── notes/           這本書的參考資料（不會匯出）
-├── output/<代號>/           匯出的 Word / HTML / Markdown
-└── .mosage/                 目前閱讀位置、自動版本紀錄（不進 git）
-```
-
-章節檔就是一般的 Markdown：
-
-```markdown
----
-status: draft
-summary: 這一章讓讀者理解……
----
-
-# 第一章　出發
-
-## 1.1 小節
-
-正文，支援**粗體**、註腳[^1]、表格、圖片 ![圖說](../assets/fig.png)、
-提示框 `> [!TIP]`、場景分隔 `---`、強制換頁 `<!-- pagebreak -->`。
-
-[^1]: 註腳內容。
-```
-
-## AI Skills
-
-| Skill | 用途 |
-| --- | --- |
-| `kickoff` | 立項訪談，建立新書、寫作企劃與風格指南 |
-| `outline` | 書名候選、章節架構、章節骨架；寫作途中調整大綱 |
-| `write-chapter` | 撰寫、續寫、擴寫章節 |
-| `apply-comments` | 處理你在介面上的留言 |
-| `review` | 以編輯角度審稿，只留意見與修改建議，不直接改稿 |
-| `current-position` | 解讀「這段」「這章」—— 你在瀏覽器中正在看的位置 |
-| `mosage-reference` | 檔案格式、標記語法、Markdown 支援範圍、指令 |
-
-升級 mosage 後執行 `npx mosage sync-skills` 更新專案裡的 skills。
-
-### 留言與修改建議的格式
-
-兩者都是 HTML 註解，任何 Markdown 工具都看不見，也不會被匯出：
-
-```markdown
-<!-- mosage:comment id=c-1a2b3c4d by=human quote="被選取的文字"
-這段太長，拆成兩段並舉個例子
--->
-被留言的段落。
-
-<!-- mosage:suggest by=ai note="刪除贅字"
-AI 提議的新段落。按「接受」後取代下方這一段。
--->
-原本的段落。
-```
-
-`mosage.yaml`（或單本的 `book.yaml`）的 `ai.editMode` 決定 AI 修改既有文字的方式：`suggest`（預設，修改建議）或 `direct`（直接改，仍有版本紀錄）。
-
-## 指令
-
-| 指令 | 說明 |
-| --- | --- |
-| `npx mosage init <資料夾>` | 建立寫作專案（`--no-install`、`--no-git`、`--author`） |
-| `mosage dev` | 開啟寫作介面（`--port`、`--host`、`--no-open`） |
-| `mosage new <代號>` | 新增一本書（`--title`、`--type book\|thesis\|other`） |
-| `mosage status [書]` | 書架總覽，或單本書的章節、字數、待處理標記（`--json`） |
-| `mosage export [書] [docx\|html\|md]` | 匯出到 `output/<書>/`（`--out`） |
-| `mosage import <檔案.docx\|.md>` | 匯入舊稿（`--book`、`--title`、`--no-split`、`--unlisted`） |
-| `mosage sync-skills` | 更新專案裡的 AI skills |
-
-## Word 匯出設定
-
-在 `book.yaml`（單本）或 `mosage.yaml`（全部的書）的 `export:` 調整：
-
-```yaml
-export:
-  pageSize: A4            # A4 | A5 | B5 | Letter | { width: 170, height: 230 }（公釐）
-  margins: { top: 25, bottom: 25, left: 30, right: 25 }
-  fonts: { body: 標楷體, latin: Times New Roman, heading: 標楷體, code: Consolas }
-  fontSize: 12            # pt
-  lineSpacing: 1.5
-  firstLineIndent: 2      # 首行縮排字數
-  titlePage: true
-  toc: true               # Word 開啟時會詢問是否更新目錄頁碼，選「是」
-  header: title           # none | title | chapter
-```
-
-匯出的是使用 Word 內建樣式的文件，要改整體字型或段落，直接在 Word 裡修改「標題 1」「內文」等樣式即可。
-
-## 常見問題
-
-**需要資料庫或網路嗎？** 不需要。MoSage 只是在你的電腦上開一個讀寫專案資料夾的小伺服器（只接受本機連線）；AI 工具本身才需要網路。
-
-**支援哪些 AI 工具？** Claude Code 與 OpenAI Codex 會自動讀取 skills。其他會讀 `AGENTS.md` 的工具也能照著守則工作。
-
-**可以不用 AI 嗎？** 可以。介面裡能直接修改段落、編輯 Markdown 原始碼、編排大綱與匯出。
-
-**我的稿子會不會被 AI 改壞？** 預設是「修改建議」模式，AI 的修改要你按接受才生效；另外每次變動前都會自動保存版本，可以在「版本紀錄」還原。建議同時用 git。
-
-## 開發
+讓 AI coding agent 幫你做出要印出來、要交出去的文件：報告、企劃書、白皮書、手冊。
+Agent 把內容寫成頁面，MoSage 負責紙張尺寸、分頁、目錄與頁碼，並匯出 PDF、可編輯的 Word 或 HTML。
 
 ```bash
-npm install
-npm run build           # web UI（Vite）+ CLI（tsup）→ dist/
-npm test                # 單元與 API 測試（vitest）
-npm run test:e2e        # 打包 → npx init → CLI → 伺服器；MOSAGE_E2E_BROWSER=1 再加上瀏覽器測試
-npm run check           # Biome（格式與 lint）
-npm run typecheck
+npx mosage init my-docs
+cd my-docs
+npm run dev        # http://localhost:5273
 ```
 
-開發介面時：在某個寫作專案裡執行 `npx tsx <本 repo>/src/cli/index.ts dev --port 5281 --no-open`，
-再於本 repo 執行 `npm run dev:web`（Vite 會把 `/api` 轉給 5281）。
+接著在同一個資料夾開啟 Claude Code 或 Codex，描述你要的文件即可。
 
-| 路徑 | 內容 |
-| --- | --- |
-| `src/shared/` | 瀏覽器與 Node 共用：設定、Markdown 解析、標記格式、字數、差異比對、原始碼編輯 |
-| `src/node/` | 專案與書籍檔案、版本紀錄、HTTP 伺服器、Word/HTML/Markdown 匯出、匯入 |
-| `src/cli/` | `mosage` 指令 |
-| `web/` | 瀏覽器介面（React） |
-| `template/` | `init` 與 `new` 使用的專案、書籍範本 |
-| `skills/` | 安裝到專案裡的 AI skills |
+## 這個套件包含
 
-### 發佈
+- **CLI**：`mosage init`（建立專案）、`dev`、`check`（版面檢查）、`export`（PDF／Word／HTML／PNG）、`import`（Markdown 轉文件）、`build`、`preview`、`sync:skills`
+- **檢視器**：真實尺寸的頁面、縮圖與大綱、單頁／雙頁／格狀檢視、Inspect（直接改字或留言給 AI）、Design 面板
+- **文件元件**：`flow()` 自動分頁、`TableOfContents`、`Footnote`、`Figure`／`Ref` 編號與交互參照、`DataTable`（讀 CSV）、頁碼 hooks
+- **AI skills**：`create-doc`、`doc-authoring`、`current-doc`、`apply-comments`、`create-theme`
 
-推送版本 tag 後，GitHub Actions 會跑完所有測試並發佈到 npm（第一次的帳號與權限設定見 [docs/RELEASING.md](docs/RELEASING.md)）：
+`mosage check` 與 `mosage export` 會用無頭 Chromium 渲染，第一次使用前請安裝 Playwright：
 
 ```bash
-npm version patch       # 或 minor / major
-git push --follow-tags
+npm i -D playwright && npx playwright install chromium
 ```
 
-## 致謝
-
-MoSage 的概念來自 [open-slide](https://github.com/open-slide/open-slide)（Yiwei Ho）與
-[open-doc](https://github.com/simonliu-ai-product/open-doc)（Simon Liu），兩者皆為 MIT 授權：
-用 `npx` 建立工作區、把 AI skills 放進專案、在瀏覽器裡留言再由 AI 套用、由開發伺服器發布目前閱讀位置。
-MoSage 是針對長篇寫作與 Word 交稿重新設計的獨立實作（Markdown 章節、修改建議、Word 匯出），未複製上述專案的程式碼。
-
-## 授權
+完整說明與範例：<https://github.com/nickchen1998/MoSage>
 
-[MIT](LICENSE)
+MoSage 以 [open-doc](https://github.com/simonliu-ai-product/open-doc)（Simon Liu，MIT）為基礎開發。授權：MIT。

package/bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import './dist/cli/bin.js';

package/dist/build-C7NW_3Pk.js

@@ -0,0 +1,14 @@
+import { t as createViteConfig } from "./config-DPm1BBAb.js";
+import path from "node:path";
+import { build as build$1, mergeConfig } from "vite";
+//#region src/cli/build.ts
+async function build(opts = {}) {
+	const base = await createViteConfig({
+		userCwd: process.cwd(),
+		mode: "build"
+	});
+	const config = mergeConfig(base, { build: { ...opts.outDir !== void 0 ? { outDir: path.resolve(process.cwd(), opts.outDir) } : {} } });
+	await build$1(config);
+}
+//#endregion
+export { build };

package/dist/check-CP4873Wx.js

@@ -0,0 +1,41 @@
+import { i as listDocIds } from "./config-DPm1BBAb.js";
+import { n as checkLayout, r as closeRenderSession, t as cliContext } from "./context-BqsdSrAQ.js";
+import chalk from "chalk";
+//#region src/cli/check.ts
+function line(finding) {
+	const where = finding.page > 0 ? `p.${finding.page}` : "doc";
+	const mark = finding.severity === "error" ? chalk.red("✗") : chalk.yellow("!");
+	const detail = [finding.element, finding.loc && chalk.dim(`@ ${finding.loc}`)].filter(Boolean).join("  ");
+	return `  ${mark} ${chalk.dim(where.padEnd(5))} ${finding.message}${detail ? `\n      ${chalk.dim(detail)}` : ""}`;
+}
+/**
+* Renders every sheet at true page size and reports the layout faults an agent
+* writing React cannot see: content clipped by the page edge, an empty sheet, a
+* heading stranded at the foot of a page, type too small to print.
+*
+* Exits non-zero when anything is an error, so it works as a CI gate.
+*/
+async function checkDocs(docIds, opts = {}) {
+	const ctx = await cliContext();
+	const targets = docIds.length > 0 ? docIds : await listDocIds(ctx);
+	if (targets.length === 0) throw new Error("No documents found under docs/.");
+	let errors = 0;
+	const reports = [];
+	try {
+		for (const docId of targets) {
+			const report = await checkLayout(ctx, docId);
+			reports.push(report);
+			errors += report.errors;
+			if (opts.json) continue;
+			const summary = report.errors === 0 && report.warnings === 0 ? chalk.green("clean") : [report.errors > 0 ? chalk.red(`${report.errors} error(s)`) : "", report.warnings > 0 ? chalk.yellow(`${report.warnings} warning(s)`) : ""].filter(Boolean).join(", ");
+			process.stdout.write(`${chalk.bold(docId)} ${chalk.dim(`${report.pageCount} pages`)} — ${summary}\n`);
+			for (const finding of report.findings) process.stdout.write(`${line(finding)}\n`);
+		}
+	} finally {
+		await closeRenderSession();
+	}
+	if (opts.json) process.stdout.write(`${JSON.stringify(reports, null, 2)}\n`);
+	if (errors > 0) process.exitCode = 1;
+}
+//#endregion
+export { checkDocs };

package/dist/cli/bin.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/cli/bin.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+import { a as PAGE_SIZE_NAMES, r as ORIENTATIONS } from "../sdk-DjpX6mCv.js";
+import chalk from "chalk";
+import path from "node:path";
+import * as readline from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { Command, Option } from "commander";
+import { existsSync, readFileSync } from "node:fs";
+import fs, { readFile } from "node:fs/promises";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/ops/formats.ts
+/** Kept apart from `layout.ts`, so the CLI can list the choices without loading the renderer. */
+const EXPORT_FORMATS = [
+	"pdf",
+	"html",
+	"docx",
+	"png"
+];
+//#endregion
+//#region src/cli/package-version.ts
+const PACKAGE_NAME = "mosage";
+/**
+* This package's root folder (the one holding its own `package.json`, the
+* `template/` and `skills/`). Walks up instead of assuming a fixed depth: the
+* bundler decides which chunk a module lands in, so `../../` is right from
+* `dist/cli/` and wrong from `dist/`.
+*/
+function packageRoot() {
+	let dir = path.dirname(fileURLToPath(import.meta.url));
+	for (let up = 0; up < 6; up += 1) {
+		const file = path.join(dir, "package.json");
+		if (existsSync(file)) try {
+			if (JSON.parse(readFileSync(file, "utf8")).name === PACKAGE_NAME) return dir;
+		} catch {}
+		const parent = path.dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+/** Getting the root wrong is silent — it reports `0.0.0` rather than failing. */
+async function readCoreVersion() {
+	const root = packageRoot();
+	if (!root) return "0.0.0";
+	try {
+		return JSON.parse(await readFile(path.join(root, "package.json"), "utf8")).version ?? "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+}
+//#endregion
+//#region src/cli/sync.ts
+var sync_exports = /* @__PURE__ */ __exportAll({
+	detectSkillsDrift: () => detectSkillsDrift,
+	syncSkills: () => syncSkills
+});
+const SKILL_TARGET_DIRS = [".agents/skills", ".claude/skills"];
+async function listFiles(dir) {
+	const out = [];
+	const walk = async (current) => {
+		const entries = await fs.readdir(current, { withFileTypes: true });
+		for (const entry of entries) {
+			const abs = path.join(current, entry.name);
+			if (entry.isDirectory()) await walk(abs);
+			else out.push(path.relative(dir, abs));
+		}
+	};
+	await walk(dir);
+	return out.sort();
+}
+async function sameTree(src, dst) {
+	if (!existsSync(dst)) return false;
+	const [srcFiles, dstFiles] = await Promise.all([listFiles(src), listFiles(dst)]);
+	if (srcFiles.length !== dstFiles.length) return false;
+	if (srcFiles.some((f, i) => f !== dstFiles[i])) return false;
+	for (const rel of srcFiles) {
+		const [a, b] = await Promise.all([fs.readFile(path.join(src, rel), "utf8"), fs.readFile(path.join(dst, rel), "utf8")]);
+		if (a !== b) return false;
+	}
+	return true;
+}
+async function skillNames(builtinDir) {
+	if (!existsSync(builtinDir)) return [];
+	return (await fs.readdir(builtinDir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+}
+async function detectSkillsDrift(builtinDir, userCwd = process.cwd()) {
+	const names = await skillNames(builtinDir);
+	const primaryTarget = path.join(userCwd, SKILL_TARGET_DIRS[0]);
+	const drift = [];
+	for (const name of names) {
+		const src = path.join(builtinDir, name);
+		const dst = path.join(primaryTarget, name);
+		if (!existsSync(dst)) drift.push({
+			name,
+			status: "added"
+		});
+		else if (!await sameTree(src, dst)) drift.push({
+			name,
+			status: "updated"
+		});
+		else drift.push({
+			name,
+			status: "unchanged"
+		});
+	}
+	return drift;
+}
+async function syncSkills(builtinDir, opts = {}, userCwd = process.cwd()) {
+	const stale = (await detectSkillsDrift(builtinDir, userCwd)).filter((d) => d.status !== "unchanged");
+	if (stale.length === 0) {
+		if (!opts.quiet) process.stdout.write(`${chalk.green("✔")} Skills already up to date.\n`);
+		return;
+	}
+	for (const { name, status } of stale) {
+		if (opts.dryRun) {
+			process.stdout.write(`${chalk.yellow("~")} ${name} ${chalk.dim(`(${status})`)}\n`);
+			continue;
+		}
+		for (const targetDir of SKILL_TARGET_DIRS) {
+			const dst = path.join(userCwd, targetDir, name);
+			await fs.rm(dst, {
+				recursive: true,
+				force: true
+			});
+			await fs.mkdir(path.dirname(dst), { recursive: true });
+			await fs.cp(path.join(builtinDir, name), dst, { recursive: true });
+		}
+		if (!opts.quiet) process.stdout.write(`${chalk.green("✔")} ${name} ${chalk.dim(`(${status})`)}\n`);
+	}
+	if (opts.dryRun) process.stdout.write(chalk.dim("\nDry run — nothing written.\n"));
+}
+//#endregion
+//#region src/cli/run.ts
+function parsePort(value) {
+	const n = Number(value);
+	if (!Number.isInteger(n) || n < 0 || n > 65535) throw new Error(`Invalid port: ${value}`);
+	return n;
+}
+function resolveBuiltinSkillsDir() {
+	const here = path.dirname(fileURLToPath(import.meta.url));
+	return path.resolve(here, "..", "..", "skills");
+}
+async function runSkillsDriftCheck(skillsDir) {
+	if (process.env.OPEN_DOC_SKIP_SKILLS_CHECK === "1") return;
+	let drift;
+	try {
+		drift = await detectSkillsDrift(skillsDir);
+	} catch {
+		return;
+	}
+	const stale = drift.filter((d) => d.status !== "unchanged");
+	if (stale.length === 0) return;
+	const names = stale.map((d) => d.name).join(", ");
+	if (!Boolean(process.stdin.isTTY && process.stdout.isTTY)) {
+		process.stderr.write(`${chalk.yellow("!")} Skills out of date (${names}). Run \`mosage sync:skills\` to update.\n`);
+		return;
+	}
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		const answer = (await rl.question(`${chalk.yellow("!")} Skills out of date: ${chalk.bold(names)}. Sync now? ${chalk.dim("(Y/n) ")}`)).trim().toLowerCase();
+		if (answer === "" || answer === "y" || answer === "yes") await syncSkills(skillsDir);
+		else process.stdout.write(chalk.dim("Skipped. Run `mosage sync:skills` later to update.\n"));
+	} finally {
+		rl.close();
+	}
+}
+async function run(argv) {
+	const version = await readCoreVersion();
+	const program = new Command();
+	program.name("mosage").description("Author documents — we handle the Vite/React stack, pagination, and export.").version(version, "-v, --version", "print version").helpOption("-h, --help", "show help").showHelpAfterError(chalk.dim("(run `mosage --help` for usage)"));
+	program.command("init").description("Create a new MoSage workspace").argument("[dir]", "target directory", void 0).option("-f, --force", "overwrite non-empty target directory", false).option("-n, --name <name>", "override package name (defaults to folder name)").option("--use-npm", "use npm to install dependencies").option("--use-pnpm", "use pnpm to install dependencies").option("--use-yarn", "use yarn to install dependencies").option("--use-bun", "use bun to install dependencies").option("--no-install", "skip dependency installation").option("--no-git", "skip git init and initial commit").action(async (dir, flags) => {
+		const { runInit } = await import("../init-Bbtj2pxF.js");
+		await runInit(dir, flags);
+	});
+	program.command("dev").description("Start the dev server").addOption(new Option("-p, --port <port>", "port to listen on").argParser(parsePort)).addOption(new Option("--host [host]", "expose on the network (optional host)")).option("--open", "open the browser on start").option("--no-skills-check", "skip the built-in skills drift check").action(async (flags) => {
+		if (flags.skillsCheck !== false) await runSkillsDriftCheck(resolveBuiltinSkillsDir());
+		const { dev } = await import("../dev-Biz42qlu.js");
+		await dev(flags);
+	});
+	program.command("build").description("Build a static site").option("--out-dir <dir>", "output directory (defaults to `dist`)").action(async (flags) => {
+		const { build } = await import("../build-C7NW_3Pk.js");
+		await build(flags);
+	});
+	program.command("preview").description("Preview the production build").addOption(new Option("-p, --port <port>", "port to listen on").argParser(parsePort)).addOption(new Option("--host [host]", "expose on the network (optional host)")).option("--open", "open the browser on start").action(async (flags) => {
+		const { preview } = await import("../preview-CLm51aRt.js");
+		await preview(flags);
+	});
+	program.command("export [docIds...]").description("Render documents headlessly to PDF, HTML, DOCX, or PNG").addOption(new Option("-f, --format <format>", "output format").choices(EXPORT_FORMATS)).option("-o, --out-dir <dir>", "directory to write into (defaults to `out`)").option("--all", "export every document under docs/").action(async (docIds, flags) => {
+		const { exportDocs } = await import("../export-Bi6nuxjT.js");
+		await exportDocs(docIds, flags);
+	});
+	program.command("check [docIds...]").description("Report layout faults — clipped content, blank sheets, stranded headings").option("--json", "print the full report as JSON").action(async (docIds, flags) => {
+		const { checkDocs } = await import("../check-CP4873Wx.js");
+		await checkDocs(docIds, flags);
+	});
+	program.command("import <file>").description("Turn a Markdown file into a document under docs/").option("--id <id>", "document id (defaults to a slug of the title)").option("--title <title>", "override the title").option("--subtitle <subtitle>", "subtitle, also used as the cover eyebrow").option("--author <author>", "author line on the cover").option("--theme <theme>", "theme id to back-link from meta.theme").addOption(new Option("--page-size <size>", "page size").choices(PAGE_SIZE_NAMES)).addOption(new Option("--orientation <orientation>", "page orientation").choices(ORIENTATIONS)).option("--no-cover", "skip the title page").option("--contents", "add a self-filling contents page").action(async (file, flags) => {
+		const { importDoc } = await import("../import-D2jNB07F.js");
+		await importDoc(file, flags);
+	});
+	program.command("sync:skills").description("Sync built-in skills from mosage into this workspace").option("--dry-run", "show what would change without writing").action(async (flags) => {
+		const { syncSkills } = await Promise.resolve().then(() => sync_exports);
+		await syncSkills(resolveBuiltinSkillsDir(), flags);
+	});
+	await program.parseAsync(argv, { from: "user" });
+}
+//#endregion
+//#region src/cli/bin.ts
+run(process.argv.slice(2)).catch((err) => {
+	const message = err instanceof Error ? err.message : String(err);
+	process.stderr.write(`${chalk.red("error:")} ${message}\n`);
+	process.exit(1);
+});
+//#endregion
+export { EXPORT_FORMATS as i, packageRoot as n, readCoreVersion as r, syncSkills as t };