@lukawi/toporealm 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LUKAWI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,113 @@
+# TopoRealm
+
+**An extensible, visual, agent-friendly local graph workspace.**
+
+TopoRealm provides a stable foundation for graph storage, versioned mutations, CLI, MCP, and a Web UI. Domain behavior arrives through modules that users install explicitly. It is for people who want humans and agents to share one local source of truth without baking task, research, or learning semantics into Core.
+
+> `0.1.0` is a public Preview. The graph and module protocols are frozen at v1, but the npm package ships with no domain modules. `research`, `exploration`, and `workflow` currently exist only as non-release test fixtures. They will be developed independently after v0.1 and must pass standalone connection tests and multi-module composition tests before release.
+
+[中文](README.md) · [Architecture boundary](docs/architecture/FOUNDATION.md) · [Module contract](docs/architecture/module-contract.md) · [Release checklist](docs/releases/v0.1.0-preview.md)
+
+## What is included
+
+- **Core:** local YAML graphs, stable IDs, revisions, atomic mutations, conflict handling, undo/redo, and base/full validation.
+- **Web UI:** canvas, search, graph switching, generic editing, history, module status, and declarative module styling and forms.
+- **CLI and stdio MCP:** humans and agents use the same Core; MCP exposes fixed graph, validation, history, module, and action entry points.
+- **Module ecosystem:** install, bind, activate per graph, registry snapshots, lossless reads without a module, `MutationPlan` actions, and uninstall.
+- **Four base Skills:** `toporealm`, `toporealm-design`, `toporealm-join`, and `toporealm-grilling`.
+- **Three host projections:** directly usable manifests, Skills, MCP configuration, and read-only onboarding hooks for Codex, Claude Code, and Pi.
+
+## Start in five minutes
+
+Node.js 20 or newer is required.
+
+```bash
+npm install --global @lukawi/toporealm@preview
+
+mkdir my-realm
+cd my-realm
+toporealm init demo
+toporealm status
+toporealm serve --open
+```
+
+`serve` prints the local URL. Without `--open`, open that URL manually. TopoRealm discovers `.toporealm/` by walking upward; `--root <directory>` and `--graph <graph-id>` select targets explicitly.
+
+```bash
+toporealm list
+toporealm switch demo
+toporealm read
+toporealm validate
+toporealm validate --complete
+toporealm undo
+toporealm redo
+```
+
+## Connect an agent through MCP
+
+Any stdio MCP host can launch TopoRealm with:
+
+```json
+{
+  "mcpServers": {
+    "toporealm": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@lukawi/toporealm@0.1.0", "mcp"]
+    }
+  }
+}
+```
+
+Inside a workspace, `toporealm mcp` starts the same server directly. Its fixed tools are `graph_list`, `graph_read`, `graph_create`, `graph_select`, `graph_validate`, `graph_apply`, `graph_undo`, `graph_redo`, `module_status`, `action_list`, and `action_execute`.
+
+## Install modules and sync hosts
+
+Modules are independent npm packages, not hidden built-ins:
+
+```bash
+toporealm module add <npm-package-or-local-path>
+toporealm module list
+toporealm host sync
+```
+
+`host sync` creates TopoRealm-owned assets under `.codex/`, `.claude/`, and `.pi/` in the current workspace and preserves user files without a TopoRealm ownership marker. If a module is removed, its data remains losslessly readable, but domain-level full validation is unavailable.
+
+### Module trust boundary
+
+v0.1 loads only trusted local code that the user explicitly installs. It does not provide a third-party code sandbox or remote module marketplace. A module may provide domain operation implementations invoked by Core, but it has no graph-storage write access. Every graph change must be returned to Core as a `MutationPlan` for validation and commit. Core is the only component allowed to write graph facts through the supported contract.
+
+## Base Skills
+
+| Skill | Purpose |
+|---|---|
+| `toporealm` | Identifies the workspace, graph, and modules, then routes the request to the foundation or a module Skill. |
+| `toporealm-design` | Designs domain-neutral objects, relations, capability composition, layers, and readability. |
+| `toporealm-join` | Gives a new session a read-only view of scope, modules, key objects, and recent changes. |
+| `toporealm-grilling` | Aligns requirements and intent, asking one focused question at a time when a critical product or protocol ambiguity remains. |
+
+These Skills do not decide domain objects, lifecycles, or completion rules on behalf of a domain module.
+
+## Use TopoRealm as a library
+
+```ts
+import { GraphStore } from "@lukawi/toporealm/core";
+import type { MutationPlan } from "@lukawi/toporealm/module-sdk";
+```
+
+Public subpaths also include `cli`, `mcp`, `server`, `web`, and `distribution`. See [CONTEXT.md](CONTEXT.md) for the shared vocabulary and the [v1 freeze](docs/architecture/v1-freeze.md) for stable contracts.
+
+## Develop and verify
+
+```bash
+npm install
+npm --prefix web-ui install
+npm run verify
+git diff --check
+```
+
+`npm run verify` covers type checking, Core/CLI/MCP/module/host tests, Web type and component tests, and CLI/MCP/Web smoke tests from an installed npm tarball. CI runs the same gate on Node.js 20 across Windows, macOS, and Linux.
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,115 @@
+# TopoRealm｜拓境
+
+**一个可扩展、可视化、对 agent 友好的本地图工作空间。**
+
+TopoRealm 把图存储、版本化变更、CLI、MCP 和 Web UI 做成稳定基座，再让用户按需安装领域模块。它适合希望用同一份本地数据连接人、agent 与不同工作方法，同时又不愿把任务流、研究流或学习流写死在 Core 里的用户。
+
+> `0.1.0` 是公开 Preview：图格式和模块协议已冻结为 v1，但 npm 包不内置任何领域模块。`research`、`exploration`、`workflow` 目前仅作为非发布测试 fixture；它们将在 v0.1 发布后独立开发，并分别完成连接测试和多模块组合测试。
+
+[English](README.en.md) · [架构边界](docs/architecture/FOUNDATION.md) · [模块协议](docs/architecture/module-contract.md) · [发布清单](docs/releases/v0.1.0-preview.md)
+
+## 你得到什么
+
+- **Core**：本地 YAML 图、稳定 ID、revision、原子变更、并发冲突、撤销/重做、基础与完整校验。
+- **Web UI**：画布、搜索、图切换、通用编辑、历史、模块状态，以及模块声明式贡献的样式和表单。
+- **CLI 与 stdio MCP**：人和 agent 通过同一 Core 读写图；MCP 固定提供图、校验、历史、模块和动作入口。
+- **模块生态**：安装、绑定、图级启用、注册快照、缺失模块无损读取、`MutationPlan` 动作和卸载。
+- **四个基础 Skills**：`toporealm`、`toporealm-design`、`toporealm-join`、`toporealm-grilling`。
+- **三宿主投影**：为 Codex、Claude Code 与 Pi 生成各自可直接使用的 manifest、Skills、MCP 配置和只读入场钩子。
+
+## 5 分钟开始
+
+需要 Node.js 20 或更高版本。
+
+```bash
+npm install --global @lukawi/toporealm@preview
+
+mkdir my-realm
+cd my-realm
+toporealm init demo
+toporealm status
+toporealm serve --open
+```
+
+`serve` 会输出本地地址；不使用 `--open` 时可以手动在浏览器打开。工作区通过向上查找 `.toporealm/` 自动识别，也可以显式传入 `--root <目录>` 和 `--graph <图 ID>`。
+
+常用命令：
+
+```bash
+toporealm list
+toporealm switch demo
+toporealm read
+toporealm validate
+toporealm validate --complete
+toporealm undo
+toporealm redo
+```
+
+## 给 agent 接入 MCP
+
+任何支持 stdio MCP 的宿主都可以启动：
+
+```json
+{
+  "mcpServers": {
+    "toporealm": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@lukawi/toporealm@0.1.0", "mcp"]
+    }
+  }
+}
+```
+
+也可以先进入工作区，再直接运行 `toporealm mcp`。固定工具包括 `graph_list`、`graph_read`、`graph_create`、`graph_select`、`graph_validate`、`graph_apply`、`graph_undo`、`graph_redo`、`module_status`、`action_list` 和 `action_execute`。
+
+## 安装模块与同步宿主
+
+模块是独立 npm 包，而不是 Core 的隐藏内置功能：
+
+```bash
+toporealm module add <npm-package-or-local-path>
+toporealm module list
+toporealm host sync
+```
+
+`host sync` 在当前工作区的 `.codex/`、`.claude/`、`.pi/` 下生成 TopoRealm 所有的宿主资产，并保留没有 TopoRealm 所有权标记的用户文件。模块卸载后，缺少模块的图仍能无损读取原有数据，但不能声称完成领域级完整校验。
+
+### 模块信任边界
+
+v0.1 只加载用户主动安装的可信本地代码，不提供第三方代码沙箱或远程模块市场。模块可以提供由 Core 调用的领域操作实现，但没有图存储写权限；所有图变更只能以 `MutationPlan` 形式交给 Core 校验并提交。Core 是受支持契约中唯一写入图事实来源的组件。
+
+## 基础 Skills
+
+| Skill | 作用 |
+|---|---|
+| `toporealm` | 识别当前工作区、图和模块，把请求路由到基座或合适的模块 Skill。 |
+| `toporealm-design` | 设计领域中立的对象、关系、能力组合、图层与可读性。 |
+| `toporealm-join` | 新会话只读了解图的范围、模块、主要对象和近期变化。 |
+| `toporealm-grilling` | 与用户对齐需求、识别真实意图，并在关键产品或协议歧义处逐问收敛。 |
+
+这些 Skills 不替代领域模块决定业务对象、生命周期或完成规则。
+
+## 作为库使用
+
+```ts
+import { GraphStore } from "@lukawi/toporealm/core";
+import type { MutationPlan } from "@lukawi/toporealm/module-sdk";
+```
+
+公开子路径还包括 `cli`、`mcp`、`server`、`web` 和 `distribution`。完整术语见 [CONTEXT.md](CONTEXT.md)，稳定契约见 [v1 冻结清单](docs/architecture/v1-freeze.md)。
+
+## 开发与验证
+
+```bash
+npm install
+npm --prefix web-ui install
+npm run verify
+git diff --check
+```
+
+`npm run verify` 覆盖类型检查、Core/CLI/MCP/模块/宿主测试、Web 类型与组件测试，以及从真实 npm tarball 安装后的 CLI、MCP 和 Web smoke。CI 在 Windows、macOS、Linux 的 Node.js 20 上运行同一套门禁。
+
+## 许可证
+
+[MIT](LICENSE)

package/dist/cli/index.d.ts

@@ -0,0 +1,46 @@
+import { GraphStore, type GraphManifest, type MutationPlan } from "../core/index.js";
+import { type HostSyncOptions, type InstallOptions } from "../distribution/index.js";
+export declare const cliSurface: {
+    readonly name: "cli";
+    readonly coreFormat: "toporealm.graph/v1";
+};
+export interface ResolverEnvironment {
+    TOPOREALM_ROOT?: string;
+    TOPOREALM_GRAPH?: string;
+    TOPOREALM_HOME?: string;
+}
+export interface CliExecutionResult {
+    exitCode: 0 | 1 | 2;
+    stdout: string;
+    stderr: string;
+}
+export declare function resolveWorkspaceRoot(options?: {
+    cwd?: string | undefined;
+    explicitRoot?: string | undefined;
+    env?: ResolverEnvironment | undefined;
+    allowCreate?: boolean;
+}): string;
+export declare function listGraphs(workspaceRoot: string): Array<{
+    id: string;
+    label?: string;
+}>;
+export declare function resolveGraphTarget(workspaceRoot: string, options?: {
+    explicitGraph?: string | undefined;
+    env?: ResolverEnvironment | undefined;
+}): string;
+export declare function selectGraph(workspaceRoot: string, graphId: string): void;
+export declare function openGraph(workspaceRoot: string, graphId: string): GraphStore;
+export declare function readGraph(workspaceRoot: string, graphId: string): import("../core/types.js").GraphSnapshot;
+export declare function applyGraphPlan(workspaceRoot: string, graphId: string, plan: MutationPlan): import("../core/types.js").MutationResult;
+export declare function undoGraph(workspaceRoot: string, graphId: string, expectedRevision?: number): import("../core/types.js").MutationResult;
+export declare function redoGraph(workspaceRoot: string, graphId: string, expectedRevision?: number): import("../core/types.js").MutationResult;
+export declare function initGraph(workspaceRoot: string, graphId: string, manifest: GraphManifest): import("../core/types.js").GraphSnapshot;
+export declare function addModule(spec: string, options: InstallOptions): import("../distribution/installer.js").InstalledModule;
+export declare function syncHostProjections(options: HostSyncOptions): readonly import("../distribution/hosts.js").HostSyncResult[];
+/** Synchronous command seam. Long-running serve/mcp processes are wired by the executable entrypoint. */
+export declare function runCli(argv: readonly string[], cwd?: string, env?: ResolverEnvironment): string;
+export declare function executeCli(argv: readonly string[], options?: {
+    cwd?: string;
+    env?: ResolverEnvironment;
+}): CliExecutionResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,UAAU,EAGV,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAGlC,eAAO,MAAM,UAAU;;;CAAgE,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE;IAC5C,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAmBd;AAED,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAYvF;AASD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE;IACjE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAClC,GAAG,MAAM,CAYd;AAED,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGxE;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAE5E;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,4CAE/D;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,6CAExF;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,6CAE1F;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,6CAE1F;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,4CAExF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,0DAE9D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,gEAE3D;AAiDD,yGAAyG;AACzG,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,SAAgB,EAAE,GAAG,GAAE,mBAAiC,GAAG,MAAM,CA6EnH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,mBAAmB,CAAA;CAAO,GAAG,kBAAkB,CASjI"}

package/dist/cli/index.js

@@ -0,0 +1,276 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { CoreError, GRAPH_FORMAT, GraphStore, coreSurface, validateGraph, } from "../core/index.js";
+import { installModule, listInstalledModules, syncHosts, uninstallModule, } from "../distribution/index.js";
+import { GraphActivator, WorkspaceModuleResolver } from "../module-sdk/index.js";
+export const cliSurface = { name: "cli", coreFormat: coreSurface.graphFormat };
+class CliUsageError extends Error {
+    code = "CLI_USAGE";
+}
+const HELP = `TopoRealm CLI
+
+用法：toporealm [--root <目录>] [--graph <图 ID>] <命令>
+
+命令：
+  init <图 ID>              初始化工作区和图
+  list                      列出工作区中的图
+  switch <图 ID>            设置当前图
+  status                    查看当前图状态
+  read                      读取图快照
+  apply <MutationPlan JSON> 提交图变更
+  undo [revision]           撤销
+  redo [revision]           重做
+  validate [--complete]     基础或完整校验
+  serve                     启动 Web Server
+  mcp                       启动 stdio MCP Server
+  module add|remove|list    管理模块
+  host sync                 同步 Codex、Claude、Pi 宿主资产
+  help                      显示帮助
+
+环境变量：TOPOREALM_ROOT、TOPOREALM_GRAPH、TOPOREALM_HOME`;
+function workspaceMarker(root) {
+    return join(root, ".toporealm");
+}
+function isWorkspace(root) {
+    return existsSync(workspaceMarker(root));
+}
+export function resolveWorkspaceRoot(options = {}) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const explicit = options.explicitRoot ?? options.env?.TOPOREALM_ROOT;
+    if (explicit) {
+        const root = resolve(cwd, explicit);
+        if (!options.allowCreate && !isWorkspace(root)) {
+            throw new CoreError({ code: "WORKSPACE_NOT_FOUND", message: `指定目录不是 TopoRealm 工作区：${root}` });
+        }
+        return root;
+    }
+    let candidate = cwd;
+    while (true) {
+        if (isWorkspace(candidate))
+            return candidate;
+        const parent = dirname(candidate);
+        if (parent === candidate)
+            break;
+        candidate = parent;
+    }
+    if (options.allowCreate)
+        return cwd;
+    throw new CoreError({ code: "WORKSPACE_NOT_FOUND", message: `从 ${cwd} 向上找不到 .toporealm 工作区。` });
+}
+export function listGraphs(workspaceRoot) {
+    const graphsRoot = join(workspaceRoot, ".toporealm", "graphs");
+    if (!existsSync(graphsRoot))
+        return [];
+    return readdirSync(graphsRoot, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && existsSync(join(graphsRoot, entry.name, "graph.yaml")))
+        .map((entry) => {
+        const snapshot = GraphStore.fromWorkspace(workspaceRoot, entry.name).read();
+        const item = { id: entry.name };
+        if (snapshot.manifest.label !== undefined)
+            item.label = snapshot.manifest.label;
+        return item;
+    })
+        .sort((left, right) => left.id.localeCompare(right.id));
+}
+function assertGraphExists(workspaceRoot, graphId, source) {
+    if (!existsSync(join(workspaceRoot, ".toporealm", "graphs", graphId, "graph.yaml"))) {
+        throw new CoreError({ code: "GRAPH_NOT_FOUND", message: `${source}指定的图不存在：${graphId}` });
+    }
+    return graphId;
+}
+export function resolveGraphTarget(workspaceRoot, options = {}) {
+    if (options.explicitGraph)
+        return assertGraphExists(workspaceRoot, options.explicitGraph, "--graph ");
+    if (options.env?.TOPOREALM_GRAPH)
+        return assertGraphExists(workspaceRoot, options.env.TOPOREALM_GRAPH, "TOPOREALM_GRAPH ");
+    const activePath = join(workspaceRoot, ".toporealm", "active");
+    if (existsSync(activePath)) {
+        const active = readFileSync(activePath, "utf8").trim();
+        if (active)
+            return assertGraphExists(workspaceRoot, active, "当前图 ");
+    }
+    const graphs = listGraphs(workspaceRoot);
+    if (graphs.some((graph) => graph.id === "default"))
+        return "default";
+    if (graphs.length === 1 && graphs[0])
+        return graphs[0].id;
+    throw new CoreError({ code: "GRAPH_REQUIRED", message: "无法唯一确定目标图；请使用 --graph、TOPOREALM_GRAPH 或 switch。" });
+}
+export function selectGraph(workspaceRoot, graphId) {
+    assertGraphExists(workspaceRoot, graphId, "");
+    writeFileSync(join(workspaceRoot, ".toporealm", "active"), `${graphId}\n`, "utf8");
+}
+export function openGraph(workspaceRoot, graphId) {
+    return GraphStore.fromWorkspace(workspaceRoot, graphId);
+}
+export function readGraph(workspaceRoot, graphId) {
+    return openGraph(workspaceRoot, graphId).read();
+}
+export function applyGraphPlan(workspaceRoot, graphId, plan) {
+    return openGraph(workspaceRoot, graphId).apply(plan);
+}
+export function undoGraph(workspaceRoot, graphId, expectedRevision) {
+    return openGraph(workspaceRoot, graphId).undo(expectedRevision);
+}
+export function redoGraph(workspaceRoot, graphId, expectedRevision) {
+    return openGraph(workspaceRoot, graphId).redo(expectedRevision);
+}
+export function initGraph(workspaceRoot, graphId, manifest) {
+    return openGraph(workspaceRoot, graphId).initialize(manifest);
+}
+export function addModule(spec, options) {
+    return installModule(spec, options);
+}
+export function syncHostProjections(options) {
+    return syncHosts(options);
+}
+function parseCli(argv) {
+    const parsed = { args: [], complete: false, global: false, open: false };
+    for (let index = 0; index < argv.length; index += 1) {
+        const value = argv[index];
+        if (value === "--root" || value === "--graph" || value === "--host" || value === "--port") {
+            const option = argv[index + 1];
+            if (!option)
+                throw new CliUsageError(`${value} 需要一个值。`);
+            if (value === "--root")
+                parsed.root = option;
+            else if (value === "--graph")
+                parsed.graph = option;
+            else if (value === "--host")
+                parsed.host = option;
+            else {
+                const port = Number(option);
+                if (!Number.isInteger(port) || port < 0 || port > 65535)
+                    throw new CliUsageError(`--port 无效：${option}`);
+                parsed.port = port;
+            }
+            index += 1;
+        }
+        else if (value === "--complete")
+            parsed.complete = true;
+        else if (value === "--global")
+            parsed.global = true;
+        else if (value === "--open")
+            parsed.open = true;
+        else if (value !== undefined)
+            parsed.args.push(value);
+    }
+    return parsed;
+}
+function required(value, usage) {
+    if (!value)
+        throw new CliUsageError(`用法：${usage}`);
+    return value;
+}
+function parseRevision(value) {
+    if (value === undefined)
+        return undefined;
+    const revision = Number(value);
+    if (!Number.isInteger(revision) || revision < 0)
+        throw new CliUsageError(`revision 必须是非负整数：${value}`);
+    return revision;
+}
+/** Synchronous command seam. Long-running serve/mcp processes are wired by the executable entrypoint. */
+export function runCli(argv, cwd = process.cwd(), env = process.env) {
+    const parsed = parseCli(argv);
+    const [command, first, second] = parsed.args;
+    if (!command || command === "help" || command === "--help" || command === "-h")
+        return HELP;
+    const commands = new Set(["init", "list", "switch", "status", "read", "apply", "undo", "redo", "validate", "serve", "mcp", "module", "host"]);
+    if (!commands.has(command))
+        throw new CliUsageError(`未知命令：${command}`);
+    if (command === "init") {
+        const graphId = parsed.graph ?? required(first, "toporealm init <图 ID>");
+        const root = resolveWorkspaceRoot({ cwd, explicitRoot: parsed.root, env, allowCreate: true });
+        mkdirSync(join(root, ".toporealm", "graphs"), { recursive: true });
+        const snapshot = initGraph(root, graphId, {
+            format: GRAPH_FORMAT,
+            id: graphId,
+            sources: { objects: "objects/*.yaml", relations: "relations/*.yaml" },
+        });
+        if (!existsSync(join(root, ".toporealm", "active")))
+            selectGraph(root, graphId);
+        return JSON.stringify(snapshot);
+    }
+    const root = resolveWorkspaceRoot({ cwd, explicitRoot: parsed.root, env });
+    if (command === "list") {
+        let currentId;
+        try {
+            currentId = resolveGraphTarget(root, { explicitGraph: parsed.graph, env });
+        }
+        catch {
+            currentId = undefined;
+        }
+        return JSON.stringify({ currentId, graphs: listGraphs(root) });
+    }
+    if (command === "switch") {
+        const graphId = parsed.graph ?? required(first, "toporealm switch <图 ID>");
+        selectGraph(root, graphId);
+        return JSON.stringify({ currentId: graphId });
+    }
+    if (command === "module") {
+        const action = required(first, "toporealm module add|remove|list");
+        const options = { workspaceRoot: root, scope: parsed.global ? "global" : "workspace" };
+        if (env.TOPOREALM_HOME)
+            options.globalHome = env.TOPOREALM_HOME;
+        if (action === "list")
+            return JSON.stringify({ modules: listInstalledModules(options) });
+        if (action === "add")
+            return JSON.stringify(addModule(required(second, "toporealm module add <npm-spec>"), options));
+        if (action === "remove") {
+            const id = required(second, "toporealm module remove <module-id>");
+            uninstallModule(id, options);
+            return JSON.stringify({ removed: id, scope: options.scope });
+        }
+        throw new CliUsageError(`未知 module 子命令：${action}`);
+    }
+    if (command === "host") {
+        if (first !== "sync")
+            throw new CliUsageError("用法：toporealm host sync");
+        return JSON.stringify(syncHostProjections({
+            workspaceRoot: root,
+            hostRoots: { codex: join(root, ".codex"), claude: join(root, ".claude"), pi: join(root, ".pi") },
+        }));
+    }
+    if (command === "serve" || command === "mcp") {
+        return JSON.stringify({ command, workspaceRoot: root, graphId: resolveGraphTarget(root, { explicitGraph: parsed.graph, env }), host: parsed.host ?? "127.0.0.1", port: parsed.port ?? 0, open: parsed.open });
+    }
+    let legacyGraph;
+    let payload = first;
+    if (!parsed.graph && ["read", "apply"].includes(command) && first && !first.startsWith("{")) {
+        legacyGraph = first;
+        payload = second;
+    }
+    const graphId = resolveGraphTarget(root, { explicitGraph: parsed.graph ?? legacyGraph, env });
+    const store = openGraph(root, graphId);
+    if (command === "read")
+        return JSON.stringify(store.read());
+    if (command === "status") {
+        const snapshot = store.read();
+        return JSON.stringify({ graphId, revision: snapshot.revision, objects: snapshot.objects.length, relations: snapshot.relations.length, history: store.historyStatus() });
+    }
+    if (command === "apply")
+        return JSON.stringify(store.apply(JSON.parse(required(payload, "toporealm apply <MutationPlan JSON>"))));
+    if (command === "undo")
+        return JSON.stringify(store.undo(parseRevision(first)));
+    if (command === "redo")
+        return JSON.stringify(store.redo(parseRevision(first)));
+    if (command === "validate") {
+        const snapshot = store.read();
+        const registry = parsed.complete ? new GraphActivator(new WorkspaceModuleResolver(root)).activate(snapshot) : undefined;
+        return JSON.stringify(validateGraph(snapshot, registry));
+    }
+    throw new CliUsageError(`未知命令：${command}`);
+}
+export function executeCli(argv, options = {}) {
+    try {
+        return { exitCode: 0, stdout: `${runCli(argv, options.cwd, options.env)}\n`, stderr: "" };
+    }
+    catch (error) {
+        const usage = error instanceof CliUsageError;
+        const code = error instanceof CoreError ? error.code : usage ? error.code : "CLI_ERROR";
+        const message = error instanceof Error ? error.message : String(error);
+        return { exitCode: usage ? 2 : 1, stdout: "", stderr: `${JSON.stringify({ error: { code, message } })}\n` };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}

package/dist/cli/main.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { executeCli, runCli } from "./index.js";
+import { startToporealmMcpStdio } from "../mcp/index.js";
+import { GraphStore } from "../core/index.js";
+import { listenToporealmServer } from "../server/index.js";
+import { spawn } from "node:child_process";
+function openBrowser(url) {
+    const command = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true }).unref();
+}
+const argv = process.argv.slice(2);
+if (argv.includes("mcp")) {
+    try {
+        const target = JSON.parse(runCli(argv));
+        await startToporealmMcpStdio(target);
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+else if (argv.includes("serve")) {
+    try {
+        const target = JSON.parse(runCli(argv));
+        const server = await listenToporealmServer(GraphStore.fromWorkspace(target.workspaceRoot, target.graphId), target.port, target.host);
+        const address = server.address();
+        if (!address || typeof address === "string")
+            throw new Error("Web Server 未获得 TCP 地址。");
+        const url = `http://${target.host}:${address.port}/`;
+        process.stdout.write(`${JSON.stringify({ url, graphId: target.graphId })}\n`);
+        if (target.open)
+            openBrowser(url);
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+else {
+    const result = executeCli(argv);
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    process.exitCode = result.exitCode;
+}
+//# sourceMappingURL=main.js.map