@lukawi/toporealm 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,108 @@
+/** The v1 graph format intentionally contains no domain-specific enums. */
+export declare const GRAPH_FORMAT: "toporealm.graph/v1";
+export type GraphFormat = typeof GRAPH_FORMAT;
+export type EntityId = string;
+export type ModuleId = string;
+export type ModuleNamespace = string;
+export interface GraphModuleRef {
+    id: ModuleId;
+    namespace: ModuleNamespace;
+    schema: number;
+}
+export interface GraphSources {
+    objects: string;
+    relations: string;
+}
+export interface GraphManifest {
+    format: GraphFormat;
+    id: string;
+    label?: string;
+    modules?: GraphModuleRef[];
+    sources: GraphSources;
+    meta?: Record<string, unknown>;
+}
+export interface ObjectRecord {
+    id: EntityId;
+    kind: string;
+    label: string;
+    data?: Record<string, unknown>;
+    capabilities?: Record<string, Record<string, unknown>>;
+    meta?: Record<string, unknown>;
+}
+export type RelationDirection = "directed" | "undirected";
+export interface RelationRecord {
+    id: EntityId;
+    kind: string;
+    source: EntityId;
+    target: EntityId;
+    direction: RelationDirection;
+    label?: string;
+    data?: Record<string, unknown>;
+    capabilities?: Record<string, Record<string, unknown>>;
+    meta?: Record<string, unknown>;
+}
+export interface GraphSnapshot {
+    manifest: GraphManifest;
+    objects: readonly ObjectRecord[];
+    relations: readonly RelationRecord[];
+    revision: number;
+}
+export type ObjectMutation = {
+    op: "upsert_object";
+    object: ObjectRecord;
+} | {
+    op: "delete_object";
+    id: EntityId;
+};
+export type RelationMutation = {
+    op: "upsert_relation";
+    relation: RelationRecord;
+} | {
+    op: "delete_relation";
+    id: EntityId;
+};
+export type ManifestMutation = {
+    op: "patch_manifest";
+    patch: Partial<Pick<GraphManifest, "label" | "modules" | "meta">>;
+};
+/** A single user/agent command. It is the atomic unit for undo and redo. */
+export type Mutation = ObjectMutation | RelationMutation | ManifestMutation;
+export interface MutationPlan {
+    mutations: readonly Mutation[];
+    expectedRevision?: number;
+    label?: string;
+}
+export interface GraphPatch {
+    fromRevision: number;
+    toRevision: number;
+    objects: {
+        added: readonly ObjectRecord[];
+        updated: readonly ObjectRecord[];
+        deleted: readonly EntityId[];
+    };
+    relations: {
+        added: readonly RelationRecord[];
+        updated: readonly RelationRecord[];
+        deleted: readonly EntityId[];
+    };
+    manifestChanged: boolean;
+    manifest?: GraphManifest;
+}
+export interface MutationResult {
+    snapshot: GraphSnapshot;
+    patch: GraphPatch;
+    history: {
+        canUndo: boolean;
+        canRedo: boolean;
+    };
+}
+export interface CoreErrorShape {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface CoreSurface {
+    readonly name: "core";
+    readonly graphFormat: GraphFormat;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,3 @@
+/** The v1 graph format intentionally contains no domain-specific enums. */
+export const GRAPH_FORMAT = "toporealm.graph/v1";
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,oBAA6B,CAAC"}

package/dist/core/validate.d.ts

@@ -0,0 +1,16 @@
+import type { GraphSnapshot } from "./types.js";
+import type { GraphRegistrySnapshot } from "../module-sdk/registry.js";
+export interface ValidationIssue {
+    code: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface GraphValidationResult {
+    ok: boolean;
+    complete: boolean;
+    errors: readonly ValidationIssue[];
+    warnings: readonly ValidationIssue[];
+}
+/** Basic checks are always available; complete checks additionally require module registries. */
+export declare function validateGraph(snapshot: GraphSnapshot, registry?: GraphRegistrySnapshot): GraphValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CACtC;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,qBAAqB,CA0B9G"}

package/dist/core/validate.js

@@ -0,0 +1,32 @@
+/** Basic checks are always available; complete checks additionally require module registries. */
+export function validateGraph(snapshot, registry) {
+    const errors = [];
+    const warnings = [];
+    const ids = new Set();
+    for (const object of snapshot.objects) {
+        if (ids.has(object.id))
+            errors.push({ code: "DUPLICATE_ID", message: `重复实体 ID：${object.id}`, severity: "error" });
+        ids.add(object.id);
+    }
+    for (const relation of snapshot.relations) {
+        if (ids.has(relation.id))
+            errors.push({ code: "DUPLICATE_ID", message: `重复实体 ID：${relation.id}`, severity: "error" });
+        ids.add(relation.id);
+        if (!snapshot.objects.some((object) => object.id === relation.source) || !snapshot.objects.some((object) => object.id === relation.target)) {
+            errors.push({ code: "DANGLING_RELATION", message: `关系 ${relation.id} 的端点不存在。`, severity: "error" });
+        }
+    }
+    let complete = registry !== undefined;
+    if (!registry)
+        warnings.push({ code: "MODULE_REGISTRY_UNAVAILABLE", message: "未提供模块注册快照，只能报告基础校验。", severity: "warning" });
+    else {
+        for (const module of registry.modules) {
+            if (module.status === "unavailable") {
+                complete = false;
+                warnings.push({ code: "MODULE_UNAVAILABLE", message: `模块 ${module.id} 不可用：${module.reason ?? "未知原因"}`, severity: "warning" });
+            }
+        }
+    }
+    return { ok: errors.length === 0, complete, errors, warnings };
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAgBA,iGAAiG;AACjG,MAAM,UAAU,aAAa,CAAC,QAAuB,EAAE,QAAgC;IACrF,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAClH,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtH,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3I,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,GAAG,QAAQ,KAAK,SAAS,CAAC;IACtC,IAAI,CAAC,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;SACtH,CAAC;QACJ,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACpC,QAAQ,GAAG,KAAK,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAChI,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACjE,CAAC"}

package/dist/distribution/hosts.d.ts

@@ -0,0 +1,12 @@
+export type HostId = "codex" | "claude" | "pi";
+export interface HostSyncOptions {
+    workspaceRoot: string;
+    hostRoots: Record<HostId, string>;
+}
+export interface HostSyncResult {
+    host: HostId;
+    projectionRoot: string;
+    modules: readonly string[];
+}
+export declare function syncHosts(options: HostSyncOptions): readonly HostSyncResult[];
+//# sourceMappingURL=hosts.d.ts.map

package/dist/distribution/hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../../src/distribution/hosts.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAiGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,cAAc,EAAE,CAsB7E"}

package/dist/distribution/hosts.js

@@ -0,0 +1,122 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { WorkspaceModuleResolver } from "../module-sdk/index.js";
+import { CoreError } from "../core/index.js";
+import { BASE_SKILL_NAMES, baseSkillsRoot } from "./skills.js";
+function writeJson(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(value, null, 2), "utf8");
+}
+function readOwner(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function ensureOwnedOrEmpty(path, expectedModule) {
+    if (!existsSync(path))
+        return;
+    const owner = readOwner(join(path, ".toporealm-owner.json"));
+    if (!owner || owner.managedBy !== "toporealm" || owner.generator !== "toporealm-host-sync" || (expectedModule && owner.moduleId !== expectedModule)) {
+        throw new CoreError({ code: "HOST_TARGET_UNOWNED", message: `不会覆盖无 TopoRealm 所有权标记的宿主资产：${path}` });
+    }
+}
+function writeBaseProjection(root, host, modules) {
+    writeJson(join(root, ".toporealm-owner.json"), { managedBy: "toporealm", generator: "toporealm-host-sync" });
+    const mcpServer = { type: "stdio", command: "npx", args: ["-y", "@lukawi/toporealm@0.1.0", "mcp"], enabled: true };
+    writeJson(join(root, ".mcp.json"), { mcpServers: { toporealm: mcpServer } });
+    mkdirSync(join(root, "hooks"), { recursive: true });
+    writeFileSync(join(root, "hooks", "session-brief.mjs"), `import { spawnSync } from "node:child_process";
+const result = spawnSync("npx", ["-y", "@lukawi/toporealm@0.1.0", "status"], { encoding: "utf8", shell: process.platform === "win32" });
+const summary = result.status === 0 ? result.stdout.trim() : "TopoRealm 工作区尚不可用。";
+process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: summary } }));
+`, "utf8");
+    if (host === "codex") {
+        writeJson(join(root, ".codex-plugin", "plugin.json"), {
+            name: "toporealm", version: "0.1.0", description: "Domain-neutral graph foundation for Codex.",
+            author: { name: "lukawi", url: "https://github.com/LUKAWI/toporealm" }, homepage: "https://github.com/LUKAWI/toporealm",
+            repository: "https://github.com/LUKAWI/toporealm", license: "MIT", keywords: ["graph", "mcp", "skills"],
+            skills: "./skills/", mcpServers: "./.mcp.json",
+            interface: { displayName: "TopoRealm", shortDescription: "Domain-neutral graphs, modules, and visual editing", longDescription: "Read, evolve, validate, and visualize extensible TopoRealm graphs through Core, CLI, MCP, Web UI, and separately installed modules.", developerName: "lukawi", category: "Developer Tools", capabilities: ["Read", "Write"], websiteURL: "https://github.com/LUKAWI/toporealm", defaultPrompt: ["Read the current TopoRealm graph and help me continue", "Design a domain-neutral graph change for this request"] },
+        });
+    }
+    if (host === "claude") {
+        writeJson(join(root, ".claude-plugin", "plugin.json"), {
+            $schema: "https://json.schemastore.org/claude-code-plugin-manifest.json", name: "toporealm", displayName: "TopoRealm",
+            description: "Domain-neutral graph foundation for Claude Code.", version: "0.1.0", author: { name: "lukawi" },
+            homepage: "https://github.com/LUKAWI/toporealm", repository: "https://github.com/LUKAWI/toporealm", license: "MIT", keywords: ["graph", "mcp", "skills"],
+        });
+        writeJson(join(root, "hooks", "hooks.json"), { hooks: { SessionStart: [{ hooks: [{ type: "command", command: "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-brief.mjs\"" }] }] } });
+    }
+    if (host === "pi") {
+        writeJson(join(root, "package.json"), {
+            name: "@lukawi/toporealm-pi", version: "0.1.0", private: true, type: "module", keywords: ["pi-package", "graph", "mcp"],
+            pi: { extensions: ["./index.js"], skills: ["./skills"] }, mcpServers: { toporealm: mcpServer },
+        });
+        writeFileSync(join(root, "index.js"), `import { spawnSync } from "node:child_process";
+export default function toporealmPi(pi) {
+  pi.on("before_agent_start", async () => {
+    const result = spawnSync("npx", ["-y", "@lukawi/toporealm@0.1.0", "status"], { encoding: "utf8", shell: process.platform === "win32" });
+    return { message: { customType: "toporealm-status", content: result.status === 0 ? result.stdout.trim() : "TopoRealm 工作区尚不可用。", display: false } };
+  });
+}
+`, "utf8");
+    }
+}
+function copySkills(root, module) {
+    if (module.status !== "available")
+        return;
+    const skills = module.manifest.skills?.directory;
+    if (!skills)
+        return;
+    const source = resolve(module.root, skills);
+    if (!existsSync(source))
+        return;
+    const target = join(root, "skills", module.id);
+    ensureOwnedOrEmpty(target, module.id);
+    if (existsSync(target))
+        rmSync(target, { recursive: true, force: true });
+    cpSync(source, target, { recursive: true });
+    writeJson(join(target, ".toporealm-owner.json"), { managedBy: "toporealm", generator: "toporealm-host-sync", moduleId: module.id, version: module.manifest.version });
+}
+function removeStaleSkills(root, active) {
+    const skillsRoot = join(root, "skills");
+    if (!existsSync(skillsRoot))
+        return;
+    for (const id of readdirSync(skillsRoot)) {
+        const target = join(skillsRoot, id);
+        const owner = readOwner(join(target, ".toporealm-owner.json"));
+        if (owner?.managedBy === "toporealm" && owner.generator === "toporealm-host-sync" && owner.moduleId && !active.has(owner.moduleId))
+            rmSync(target, { recursive: true, force: true });
+    }
+}
+export function syncHosts(options) {
+    const resolver = new WorkspaceModuleResolver(options.workspaceRoot);
+    const bindings = resolver.readBindings().bindings ?? {};
+    const resolved = Object.keys(bindings).map((id) => resolver.resolve(id));
+    const available = resolved.filter((item) => item.status === "available");
+    const modules = available.map((item) => item.id);
+    return ["codex", "claude", "pi"].map((host) => {
+        const root = join(resolve(options.hostRoots[host]), ".toporealm", "generated", host);
+        ensureOwnedOrEmpty(root);
+        mkdirSync(root, { recursive: true });
+        for (const name of BASE_SKILL_NAMES) {
+            const path = join(root, "skills", name);
+            ensureOwnedOrEmpty(path, "core");
+            if (existsSync(path))
+                rmSync(path, { recursive: true, force: true });
+            cpSync(join(baseSkillsRoot(), name), path, { recursive: true });
+            writeJson(join(path, ".toporealm-owner.json"), { managedBy: "toporealm", generator: "toporealm-host-sync", moduleId: "core" });
+        }
+        for (const module of available)
+            copySkills(root, module);
+        removeStaleSkills(root, new Set(["core", ...modules]));
+        writeBaseProjection(root, host, [...BASE_SKILL_NAMES, ...modules]);
+        return { host, projectionRoot: root, modules };
+    });
+}
+//# sourceMappingURL=hosts.js.map

package/dist/distribution/hosts.js.map

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

package/dist/distribution/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./installer.js";
+export * from "./hosts.js";
+export * from "./skills.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/distribution/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/distribution/index.js

@@ -0,0 +1,4 @@
+export * from "./installer.js";
+export * from "./hosts.js";
+export * from "./skills.js";
+//# sourceMappingURL=index.js.map

package/dist/distribution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distribution/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/distribution/installer.d.ts

@@ -0,0 +1,23 @@
+export type InstallScope = "workspace" | "global";
+export interface InstallOptions {
+    workspaceRoot: string;
+    scope?: InstallScope;
+    globalHome?: string;
+    npmCommand?: string;
+}
+export interface InstalledModule {
+    id: string;
+    version: string;
+    root: string;
+    scope: InstallScope;
+    sourceSpec: string;
+}
+interface SourceRecord extends InstalledModule {
+    managedBy: "toporealm";
+    installedAt: string;
+}
+export declare function installModule(spec: string, options: InstallOptions): InstalledModule;
+export declare function uninstallModule(id: string, options: InstallOptions): void;
+export declare function listInstalledModules(options: InstallOptions): readonly SourceRecord[];
+export {};
+//# sourceMappingURL=installer.d.ts.map

package/dist/distribution/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/distribution/installer.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAa,SAAQ,eAAe;IAC5C,SAAS,EAAE,WAAW,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAoID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,eAAe,CAiBpF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAazE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,YAAY,EAAE,CAKrF"}

package/dist/distribution/installer.js

@@ -0,0 +1,179 @@
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync, renameSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { homedir, tmpdir } from "node:os";
+import { dirname, join, relative, resolve } from "node:path";
+import * as YAML from "yaml";
+import { CoreError } from "../core/index.js";
+const SOURCE_FILE = "module-sources.yaml";
+function parseYaml(path) {
+    try {
+        return YAML.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new CoreError({ code: "INVALID_MODULE_PACKAGE", message: `无法读取模块包文件：${path}`, details: { cause: error instanceof Error ? error.message : String(error) } });
+    }
+}
+function writeYaml(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, YAML.stringify(value), "utf8");
+}
+function safeModuleId(id) {
+    if (!id || /[\\/:]/.test(id))
+        throw new CoreError({ code: "INVALID_MODULE_ID", message: `模块 id 无效：${id}` });
+}
+function ensureInside(root, path) {
+    const resolved = resolve(path);
+    const escaped = relative(resolve(root), resolved).startsWith("..") || resolve(relative(resolve(root), resolved)) === ".";
+    if (escaped)
+        throw new CoreError({ code: "MODULE_PATH_ESCAPE", message: `模块包路径越出包目录：${path}` });
+    return resolved;
+}
+function canonicalPath(path) {
+    return existsSync(path) ? realpathSync.native(path) : path;
+}
+function validatePackage(packageRoot) {
+    const packageJsonPath = join(packageRoot, "package.json");
+    const packageJson = parseYaml(packageJsonPath);
+    if (typeof packageJson.toporealm !== "string")
+        throw new CoreError({ code: "INVALID_MODULE_PACKAGE", message: "package.json 缺少 toporealm 清单入口。" });
+    const manifestPath = ensureInside(packageRoot, join(packageRoot, packageJson.toporealm));
+    const manifest = parseYaml(manifestPath);
+    if (manifest.format !== "toporealm.module/v1" || typeof manifest.id !== "string" || typeof manifest.version !== "string") {
+        throw new CoreError({ code: "INVALID_MODULE_PACKAGE", message: "module.yaml 缺少有效的 TopoRealm 身份。" });
+    }
+    safeModuleId(manifest.id);
+    if (packageJson.version !== manifest.version)
+        throw new CoreError({ code: "INVALID_MODULE_PACKAGE", message: `package.json version=${String(packageJson.version)} 与 module.yaml version=${manifest.version} 不一致。` });
+    const scripts = packageJson.scripts && typeof packageJson.scripts === "object" ? packageJson.scripts : {};
+    if (["preinstall", "install", "postinstall"].some((name) => scripts[name] !== undefined))
+        throw new CoreError({ code: "MODULE_INSTALL_SCRIPT", message: "TopoRealm 模块禁止安装阶段脚本。" });
+    if (packageJson.dependencies && typeof packageJson.dependencies === "object" && Object.keys(packageJson.dependencies).length > 0)
+        throw new CoreError({ code: "MODULE_NOT_SELF_CONTAINED", message: "模块必须把普通运行时依赖打入 bundle，不能依赖外部 node_modules。" });
+    if (existsSync(join(packageRoot, "node_modules")))
+        throw new CoreError({ code: "MODULE_NOT_SELF_CONTAINED", message: "模块包不能包含 node_modules。" });
+    return manifest;
+}
+function readSourceRecords(path) {
+    if (!existsSync(path))
+        return [];
+    const parsed = parseYaml(path);
+    return Array.isArray(parsed.modules) ? parsed.modules : [];
+}
+function writeSourceRecord(path, record) {
+    const records = readSourceRecords(path).filter((item) => !(item.id === record.id && item.scope === record.scope));
+    records.push(record);
+    writeYaml(path, { modules: records });
+}
+function readBindings(path) {
+    if (!existsSync(path))
+        return { bindings: {} };
+    const parsed = parseYaml(path);
+    return parsed && typeof parsed === "object" ? parsed : { bindings: {} };
+}
+function writeWorkspaceBinding(workspaceRoot, id) {
+    const path = join(workspaceRoot, ".toporealm", "modules.yaml");
+    const bindings = readBindings(path);
+    const next = bindings.bindings ?? {};
+    next[id] = { source: "workspace", path: `modules/${id}` };
+    writeYaml(path, { ...bindings, bindings: next });
+}
+function removeWorkspaceBinding(workspaceRoot, id) {
+    const path = join(workspaceRoot, ".toporealm", "modules.yaml");
+    const bindings = readBindings(path);
+    if (bindings.bindings)
+        delete bindings.bindings[id];
+    writeYaml(path, bindings);
+}
+function unpackPackage(spec, options) {
+    const staging = mkdtempSync(join(tmpdir(), "toporealm-npm-"));
+    const npm = options.npmCommand;
+    const npmArgs = ["pack", "--ignore-scripts", spec, "--pack-destination", staging];
+    try {
+        if (npm) {
+            execFileSync(npm, npmArgs, { cwd: options.workspaceRoot, stdio: ["ignore", "pipe", "inherit"], shell: process.platform === "win32" });
+        }
+        else {
+            const candidates = [
+                process.env.npm_execpath,
+                join(dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js"),
+                resolve(dirname(process.execPath), "..", "lib", "node_modules", "npm", "bin", "npm-cli.js"),
+            ].filter((candidate) => Boolean(candidate));
+            const npmCli = candidates.find((candidate) => existsSync(candidate));
+            if (!npmCli)
+                throw new Error("找不到 npm CLI；请通过 npm 运行 TopoRealm 或显式提供 npmCommand。");
+            execFileSync(process.execPath, [npmCli, ...npmArgs], { cwd: options.workspaceRoot, stdio: ["ignore", "pipe", "inherit"] });
+        }
+        const tarball = readdirSync(staging).find((file) => file.endsWith(".tgz"));
+        if (!tarball)
+            throw new Error("npm pack 没有产生 tarball。");
+        const unpacked = join(staging, "unpacked");
+        mkdirSync(unpacked, { recursive: true });
+        execFileSync("tar", ["-xzf", join(staging, tarball), "-C", unpacked], { stdio: "ignore" });
+        const root = existsSync(join(unpacked, "package")) ? join(unpacked, "package") : unpacked;
+        validatePackage(root);
+        return { root, cleanup: () => rmSync(staging, { recursive: true, force: true }) };
+    }
+    catch (error) {
+        rmSync(staging, { recursive: true, force: true });
+        if (error instanceof CoreError)
+            throw error;
+        throw new CoreError({ code: "MODULE_PACK_FAILED", message: `npm pack 或解包失败：${spec}`, details: { cause: error instanceof Error ? error.message : String(error) } });
+    }
+}
+function moveManagedModule(sourceRoot, targetRoot, manifest) {
+    mkdirSync(dirname(targetRoot), { recursive: true });
+    if (existsSync(targetRoot)) {
+        const markerPath = join(targetRoot, ".toporealm-source.json");
+        if (!existsSync(markerPath))
+            throw new CoreError({ code: "MODULE_TARGET_UNOWNED", message: `不会覆盖无来源标记的模块目录：${targetRoot}` });
+        rmSync(targetRoot, { recursive: true, force: true });
+    }
+    const temporary = `${targetRoot}.tmp-${process.pid}-${Date.now()}`;
+    cpSync(sourceRoot, temporary, { recursive: true });
+    writeFileSync(join(temporary, ".toporealm-source.json"), JSON.stringify({ managedBy: "toporealm", id: manifest.id, version: manifest.version }, null, 2), "utf8");
+    renameSync(temporary, targetRoot);
+}
+export function installModule(spec, options) {
+    const scope = options.scope ?? "workspace";
+    const globalHome = resolve(options.globalHome ?? process.env.TOPOREALM_HOME ?? join(homedir(), ".toporealm"));
+    const packed = unpackPackage(spec, options);
+    try {
+        const manifest = validatePackage(packed.root);
+        const targetRoot = scope === "workspace"
+            ? join(resolve(options.workspaceRoot), ".toporealm", "modules", manifest.id)
+            : join(globalHome, "modules", manifest.id, manifest.version);
+        moveManagedModule(packed.root, targetRoot, manifest);
+        const record = { managedBy: "toporealm", id: manifest.id, version: manifest.version, root: canonicalPath(targetRoot), scope, sourceSpec: spec, installedAt: new Date().toISOString() };
+        writeSourceRecord(scope === "workspace" ? join(options.workspaceRoot, ".toporealm", SOURCE_FILE) : join(globalHome, SOURCE_FILE), record);
+        if (scope === "workspace")
+            writeWorkspaceBinding(options.workspaceRoot, manifest.id);
+        return record;
+    }
+    finally {
+        packed.cleanup();
+    }
+}
+export function uninstallModule(id, options) {
+    safeModuleId(id);
+    const scope = options.scope ?? "workspace";
+    const globalHome = resolve(options.globalHome ?? process.env.TOPOREALM_HOME ?? join(homedir(), ".toporealm"));
+    const sourceFile = scope === "workspace" ? join(options.workspaceRoot, ".toporealm", SOURCE_FILE) : join(globalHome, SOURCE_FILE);
+    const records = readSourceRecords(sourceFile);
+    const record = records.find((item) => item.id === id && item.scope === scope);
+    if (!record)
+        throw new CoreError({ code: "MODULE_SOURCE_NOT_FOUND", message: `没有 TopoRealm 所有权记录，拒绝卸载：${id}` });
+    const marker = join(record.root, ".toporealm-source.json");
+    if (!existsSync(marker))
+        throw new CoreError({ code: "MODULE_TARGET_UNOWNED", message: `模块目录缺少所有权标记，拒绝卸载：${record.root}` });
+    rmSync(record.root, { recursive: true, force: true });
+    writeYaml(sourceFile, { modules: records.filter((item) => item !== record) });
+    if (scope === "workspace")
+        removeWorkspaceBinding(options.workspaceRoot, id);
+}
+export function listInstalledModules(options) {
+    const globalHome = resolve(options.globalHome ?? process.env.TOPOREALM_HOME ?? join(homedir(), ".toporealm"));
+    const workspace = readSourceRecords(join(options.workspaceRoot, ".toporealm", SOURCE_FILE));
+    const global = readSourceRecords(join(globalHome, SOURCE_FILE));
+    return [...workspace, ...global];
+}
+//# sourceMappingURL=installer.js.map

package/dist/distribution/installer.js.map

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

package/dist/distribution/skills.d.ts

@@ -0,0 +1,11 @@
+export declare const BASE_SKILL_NAMES: readonly ["toporealm", "toporealm-design", "toporealm-join", "toporealm-grilling"];
+export type BaseSkillName = typeof BASE_SKILL_NAMES[number];
+export declare function baseSkillsRoot(): string;
+export declare function routeSkillIntent(input: {
+    explicitSkill?: BaseSkillName;
+    asksForGrilling?: boolean;
+    criticalAmbiguity?: boolean;
+    designRequest?: boolean;
+    joinRequest?: boolean;
+}): BaseSkillName;
+//# sourceMappingURL=skills.d.ts.map

package/dist/distribution/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/distribution/skills.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,oFAAqF,CAAC;AACnH,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5D,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,aAAa,CAMhB"}

package/dist/distribution/skills.js

@@ -0,0 +1,20 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+export const BASE_SKILL_NAMES = ["toporealm", "toporealm-design", "toporealm-join", "toporealm-grilling"];
+export function baseSkillsRoot() {
+    const packaged = fileURLToPath(new URL("../integrations/skills/", import.meta.url));
+    return existsSync(join(packaged, "toporealm", "SKILL.md")) ? packaged : join(process.cwd(), "integrations", "src", "skills");
+}
+export function routeSkillIntent(input) {
+    if (input.explicitSkill)
+        return input.explicitSkill;
+    if (input.asksForGrilling || input.criticalAmbiguity)
+        return "toporealm-grilling";
+    if (input.designRequest)
+        return "toporealm-design";
+    if (input.joinRequest)
+        return "toporealm-join";
+    return "toporealm";
+}
+//# sourceMappingURL=skills.js.map

package/dist/distribution/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/distribution/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,oBAAoB,CAAU,CAAC;AAGnH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,yBAAyB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC/H,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAMhC;IACC,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC,aAAa,CAAC;IACpD,IAAI,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,iBAAiB;QAAE,OAAO,oBAAoB,CAAC;IAClF,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,kBAAkB,CAAC;IACnD,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,gBAAgB,CAAC;IAC/C,OAAO,WAAW,CAAC;AACrB,CAAC"}