@dztabel/docxkit 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# DocxKit
+
+Agent-facing CLI for exporting prepared Markdown or `report.json` into polished, editable Word `.docx` reports.
+
+```bash
+npm install @dztabel/docxkit
+npx --no-install docx-kit --version
+npx --no-install docx-kit build content.md --out ./report
+```
+
+Outputs:
+
+- `report/report.docx`
+- `report/report.json`
+- `report/build-result.json`
+
+The MVP ships the `executive-cn-docx` template for formal Chinese reports.

package/docs/public-boundary.md

@@ -0,0 +1,86 @@
+# DocxKit Public Boundary
+
+`docxkit-cli` 是对外 npm 入口仓库，不承载核心渲染能力。
+
+## 仓库职责
+
+本仓库包含：
+
+- `package.json`
+- npm wrapper：`npm/docx-kit.cjs`
+- 平台包 metadata：`npm/platform-packages/*/package.json`
+- 用户 README
+- Codex skill
+- 公开示例和截图
+
+本仓库不包含：
+
+- `.NET` / OpenXML renderer 源码；
+- Word 模板源码；
+- schemas；
+- 测试；
+- release preflight；
+- 私有产品说明；
+- npm token。
+
+主包不包含二进制。平台包目录在发布前会放入当前平台 self-contained binary。
+public 仓库必须通过 `.gitignore` 忽略平台二进制：
+
+```gitignore
+npm/platform-packages/*/docx-kit
+npm/platform-packages/*/docx-kit.exe
+```
+
+## npm 包结构
+
+```text
+@dztabel/docxkit
+  public npm wrapper
+  - bin: docx-kit, docxkit
+  - optionalDependencies 指向平台包
+
+@dztabel/docxkit-darwin-arm64
+  platform packages
+  - 只包含当前平台 self-contained binary
+```
+
+MVP 只发布 `@dztabel/docxkit-darwin-arm64`。Linux 和 Windows 平台包是跨平台构建阶段的后续项。
+
+## 产品验收
+
+产品验收以 npm 安装态为准：
+
+```bash
+npm install @dztabel/docxkit
+npx --no-install docx-kit --version
+npx --no-install docx-kit build content.md --out ./report
+```
+
+验收通过条件：
+
+- 用户无需安装 Python、.NET SDK、Typst 或 Microsoft Word；
+- stdout 是单个 JSON；
+- `build-result.json` 与 stdout 完全一致；
+- 输出包含 `report.docx`、`report.json`、`build-result.json`；
+- `report.docx` 完整复刻 ReportKit 默认 `executive-cn` 格式；
+- 主包 tarball 不包含 core 源码、模板源码、schemas、tests 或二进制；
+- 平台包 tarball 只包含当前平台二进制和 package metadata。
+
+## 发布凭证和发布方式
+
+npm 已在本机用户级配置中登录。后续 LLM / Agent 发布前只需要验证当前登录态：
+
+```bash
+npm whoami
+npm ping
+```
+
+禁止读取、打印或提交任何 npm / GitHub token；禁止把 token 写入仓库、README、脚本、日志样例或构建产物。
+
+本机 GitHub 已验证可用：`gh auth status` 通过，账号 `dztabel-happy`，具备 `repo`、`workflow` 权限，可推送 GitHub。
+
+完整发布步骤见：
+
+```text
+/Users/dztmacmini/project/zhiyun/docxkit-cli-core/docs/release-runbook.md
+```

package/npm/docx-kit.cjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageRoot = findPackageRoot();
+const binary = findPlatformPackageBinary();
+
+if (!binary) {
+  const packageName = platformPackageName();
+  const version = packageVersion();
+  console.error("docx-kit: platform package is missing.");
+  console.error(
+    packageName
+      ? `docx-kit: expected optional dependency ${packageName} to provide the binary.`
+      : `docx-kit: unsupported platform ${process.platform}/${process.arch}.`,
+  );
+  if (packageName) {
+    console.error(`docx-kit: run "npm install -g @dztabel/docxkit@${version} ${packageName}@${version}".`);
+  }
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), {
+  cwd: process.cwd(),
+  env: process.env,
+  stdio: "inherit",
+});
+
+if (result.error) {
+  console.error(`docx-kit: failed to start: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);
+
+function findPackageRoot() {
+  const candidates = [
+    path.resolve(__dirname, ".."),
+    path.resolve(__dirname, "node_modules", "@dztabel", "docxkit"),
+    path.resolve(__dirname, "..", "node_modules", "@dztabel", "docxkit"),
+  ];
+
+  for (const candidate of candidates) {
+    if (isDocxKitPackageRoot(candidate)) {
+      return candidate;
+    }
+  }
+
+  try {
+    const packageJson = require.resolve("@dztabel/docxkit/package.json", {
+      paths: [__dirname, process.cwd()],
+    });
+    return path.dirname(packageJson);
+  } catch (_) {
+    return path.resolve(__dirname, "..");
+  }
+}
+
+function isDocxKitPackageRoot(candidate) {
+  try {
+    const packageJson = JSON.parse(fs.readFileSync(path.join(candidate, "package.json"), "utf8"));
+    return packageJson.name === "@dztabel/docxkit" && fs.existsSync(path.join(candidate, "npm", "docx-kit.cjs"));
+  } catch (_) {
+    return false;
+  }
+}
+
+function findPlatformPackageBinary() {
+  const packageName = platformPackageName();
+  if (!packageName) {
+    return null;
+  }
+  try {
+    const packageJson = require.resolve(`${packageName}/package.json`, { paths: [packageRoot] });
+    const platformRoot = path.dirname(packageJson);
+    const candidate = path.join(platformRoot, process.platform === "win32" ? "docx-kit.exe" : "docx-kit");
+    return fs.existsSync(candidate) ? candidate : null;
+  } catch (_) {
+    return null;
+  }
+}
+
+function platformPackageName() {
+  const arch = process.arch === "arm64" ? "arm64" : process.arch === "x64" ? "x64" : null;
+  if (!arch) {
+    return null;
+  }
+  if (process.platform === "darwin") {
+    return `@dztabel/docxkit-darwin-${arch}`;
+  }
+  return null;
+}
+
+function packageVersion() {
+  try {
+    const packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+    return packageJson.version || "latest";
+  } catch (_) {
+    return "latest";
+  }
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@dztabel/docxkit",
+  "version": "0.1.0",
+  "description": "Agent-facing CLI for exporting prepared content into polished Word docx reports.",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "docx-kit": "npm/docx-kit.cjs",
+    "docxkit": "npm/docx-kit.cjs"
+  },
+  "optionalDependencies": {
+    "@dztabel/docxkit-darwin-arm64": "0.1.0"
+  },
+  "files": [
+    "npm/docx-kit.cjs",
+    "README.md",
+    "docs/public-boundary.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}