dsh-kingdom 0.3.1

package/lib/core/kingdom.js

@@ -0,0 +1,117 @@
+/**
+ * dsh-kingdom — Kingdom 初始化/接入（幂等）。
+ *
+ * 语义（Owner 2026-08-17 裁决）：
+ * - /kingdom init 幂等：首次建库 → 初始化；再次执行 → 接入（不覆盖、不重建）。
+ * - Owner = 声明性本地身份：init 时生成稳定 owner_id(UUID) + owner_name(OS 用户名或显式名称)，
+ *   仅作 Kingdom 内部稳定引用，不代表签名认证（TPM/Windows Hello/Principal/Owner Port 后置）。
+ */
+import { randomUUID } from 'node:crypto';
+import { userInfo } from 'node:os';
+import { KingdomStore, SCHEMA_VERSION } from './db.js';
+import { kingdomDbPath } from '../paths.js';
+/** 当前 OS 用户名（显式名称缺失时的兜底）。 */
+export function currentOsUser() {
+    try {
+        const info = userInfo();
+        if (info && info.username && info.username.trim().length > 0)
+            return info.username;
+    }
+    catch {
+        // 某些受限环境拿不到 userInfo，回退
+    }
+    return 'owner';
+}
+export class KingdomManager {
+    store;
+    opts;
+    constructor(options = {}) {
+        this.opts = {
+            kingdomName: options.kingdomName ?? 'My Kingdom',
+            ownerName: options.ownerName ?? currentOsUser(),
+            dbPath: options.dbPath ?? kingdomDbPath(),
+        };
+        this.store = new KingdomStore(this.opts.dbPath);
+    }
+    get storeHandle() {
+        return this.store;
+    }
+    /**
+     * init：扫描本机 → 无 kingdom.db 则初始化，有则接入。
+     * 幂等：重复调用只接入，绝不覆盖既有数据。
+     */
+    init() {
+        const kingdom = this.store.getDefaultKingdom();
+        if (!kingdom) {
+            // ── 初始化路径 ──
+            const now = new Date().toISOString();
+            const kingdomId = randomUUID();
+            const ownerId = randomUUID();
+            const created = {
+                kingdom_id: kingdomId,
+                name: this.opts.kingdomName,
+                created_at: now,
+                owner_id: ownerId,
+                owner_name: this.opts.ownerName,
+                schema_version: SCHEMA_VERSION,
+            };
+            this.store.insertKingdom(created);
+            // Owner binding：principal_id = ownerId（Kingdom 内部稳定引用）
+            this.store.insertBinding({
+                binding_id: randomUUID(),
+                kingdom_id: kingdomId,
+                role_type: 'OWNER',
+                role_name: `Owner-${this.opts.ownerName}`,
+                runtime_type: 'dsh',
+                session_id: null,
+                principal_id: ownerId,
+                created_at: now,
+                updated_at: now,
+            });
+            this.store.appendEvent({
+                event_id: randomUUID(),
+                kingdom_id: kingdomId,
+                event_type: 'KINGDOM_CREATED',
+                actor_role: 'OWNER',
+                actor_id: ownerId,
+                target_type: 'kingdom',
+                target_id: kingdomId,
+                payload_json: JSON.stringify({ name: this.opts.kingdomName, owner: this.opts.ownerName }),
+                created_at: now,
+            });
+            const result = {
+                action: 'initialized',
+                kingdomId,
+                kingdomName: this.opts.kingdomName,
+                ownerId,
+                ownerName: this.opts.ownerName,
+                territoryCount: 0,
+                bindingCount: 1,
+                detail: `已初始化王国「${this.opts.kingdomName}」，Owner = ${this.opts.ownerName}（id=${ownerId}）。`,
+            };
+            return result;
+        }
+        // ── 接入路径（王国已存在）──
+        const territories = this.store.listTerritories(kingdom.kingdom_id);
+        const bindings = this.store.listBindings(kingdom.kingdom_id);
+        return {
+            action: 'attached',
+            kingdomId: kingdom.kingdom_id,
+            kingdomName: kingdom.name,
+            ownerId: kingdom.owner_id,
+            ownerName: kingdom.owner_name,
+            territoryCount: territories.length,
+            bindingCount: bindings.length,
+            detail: `已接入现有王国「${kingdom.name}」（id=${kingdom.kingdom_id}），` +
+                `Owner = ${kingdom.owner_name}，${territories.length} 个领地，${bindings.length} 个角色绑定。`,
+        };
+    }
+    /** 重新扫描接入（不删除任何数据）。 */
+    rescan() {
+        return this.init();
+    }
+    close() {
+        this.store.close();
+    }
+}
+//# sourceMappingURL=kingdom.js.map

package/lib/core/kingdom.js.map

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