dsh-mnemon 0.1.5 → 0.2.0

package/lib/types/storage-scope.d.ts

@@ -1,33 +1,7 @@
 import type { ResolvedConfig } from './config.ts';
 import type { MnemonRunner } from './runner.ts';
-export type StorageScopeKind = 'global' | 'workspace' | 'custom';
-export type StorageAreaKind = 'runtime' | 'memory-bodies' | 'documents' | 'state';
-export type StorageAreaStatus = 'ready' | 'empty' | 'missing' | 'invalid';
-export interface StorageAreaInventory {
-    kind: StorageAreaKind;
-    path: string;
-    status: StorageAreaStatus;
-    bytes: number;
-    itemCount: number;
-    details: Record<string, number | string | boolean>;
-    issue?: string;
-}
-export interface StorageScopeInventory {
-    kind: StorageScopeKind;
-    root?: string;
-    configured: boolean;
-    active: boolean;
-    available: boolean;
-    totalBytes: number;
-    areas: StorageAreaInventory[];
-    issue?: string;
-}
-export interface StorageScopeCatalog {
-    activeKind: StorageScopeKind;
-    activeRoot: string;
-    scopes: StorageScopeInventory[];
-    generatedAt: string;
-}
+import type { StorageScopeCatalog } from './shared/contracts.ts';
+export type { StorageAreaInventory, StorageAreaKind, StorageAreaStatus, StorageScopeCatalog, StorageScopeInventory, StorageScopeKind } from './shared/contracts.ts';
 /** Read-only catalog of the three storage domains. It never creates, moves, or repairs files. */
 export declare class StorageScopeInspector {
     private readonly runner;
@@ -36,4 +10,3 @@ export declare class StorageScopeInspector {
     catalog(workspaceRoot?: string): StorageScopeCatalog;
 }
 export declare function validateCustomStorageRoot(value: string): string;
-//# sourceMappingURL=storage-scope.d.ts.map

package/lib/types/subagent.d.ts

@@ -1,28 +1,19 @@
 import type { HostAgent, HostSubagentsService } from './contracts.ts';
 import { type DocumentManager, type DocumentMutation, type DocumentMutationResult, type DocumentView } from './documents.ts';
 import { type RuntimeMemoryController, type RuntimeMemoryMutation, type RuntimeMemoryMutationResult } from './runtime-memory.ts';
-import type { Insight, RememberRequest, SearchRequest } from './service.ts';
+import type { Insight, MnemonService, RememberRequest, SearchRequest } from './service.ts';
+import { type PreparedMemoryPlacement } from './provider-placement.ts';
+import type { MemoryBodyMetadataMaintenanceResult, MemoryPlacementDecision, SubagentCounters } from './shared/contracts.ts';
+export type { SubagentCounters } from './shared/contracts.ts';
 interface AgentRuntimeSource {
     forAgent(agent: HostAgent): {
+        service: MnemonService;
         runtimeMemory: RuntimeMemoryController;
         documents: DocumentManager;
     };
 }
 /** Rejects schema keywords that DSH structured-output tools cannot compile. */
 export declare function assertDshOutputSchema(schema: unknown, path?: string): void;
-export interface SubagentCounters {
-    recalls: number;
-    writes: number;
-    answers: number;
-    reviews: number;
-    migrations: number;
-    compactions: number;
-    documentArchives: number;
-    failures: number;
-    lastRunId?: string;
-    lastOperation?: 'recall' | 'write' | 'review' | 'migration' | 'compaction' | 'document-archive';
-    lastAt?: string;
-}
 export interface DelegatedRecallResult {
     query: string;
     mode: string;
@@ -85,6 +76,11 @@ export declare class MnemonSubagentCoordinator {
     documentSearch(parent: HostAgent, query: string, includeArchived?: boolean, limit?: number): Promise<import("./documents.ts").DocumentSearchResult>;
     recall(parent: HostAgent, request: SearchRequest, signal: AbortSignal): Promise<DelegatedRecallResult>;
     related(parent: HostAgent, id: string, memoryBodyId: string | undefined, signal: AbortSignal): Promise<DelegatedRecallResult>;
+    placeProvider(parent: HostAgent, body: {
+        name: string;
+        description: string;
+    }, prepared: PreparedMemoryPlacement, signal: AbortSignal): Promise<MemoryPlacementDecision>;
+    maintainMetadata(parent: HostAgent, memoryBodyIds: readonly string[], signal: AbortSignal): Promise<MemoryBodyMetadataMaintenanceResult>;
     remember(parent: HostAgent, request: RememberRequest, signal: AbortSignal): Promise<DelegatedWriteResult>;
     runtime(parent: HostAgent, request: RuntimeMemoryMutation, signal: AbortSignal): Promise<CoordinatedRuntimeMemoryResult>;
     document(parent: HostAgent, request: DocumentMutation, signal: AbortSignal): Promise<CoordinatedDocumentResult>;
@@ -100,7 +96,6 @@ export declare class MnemonSubagentCoordinator {
     private delegate;
     private provider;
     private runtimeMemoryFor;
+    private serviceFor;
     private documentsFor;
 }
-export {};
-//# sourceMappingURL=subagent.d.ts.map

package/lib/types/tools.d.ts

@@ -15,4 +15,3 @@ interface AgentRuntimeSource {
 /** Root calls delegate to a bounded child; memory-worker calls reach the deterministic service. */
 export declare function registerTools(ctx: HostContextShape, serviceOrSource: MnemonService | AgentRuntimeSource, coordinator: MnemonSubagentCoordinator, runtimeMemory?: RuntimeMemoryController, documents?: DocumentManager): void;
 export {};
-//# sourceMappingURL=tools.d.ts.map

package/lib/types/version-updates.d.ts

@@ -1,32 +1,6 @@
 import { type ProcessRunner } from './process.ts';
-export type VersionComponentId = 'mnemon' | 'dsh-mnemon';
-export type VersionInstallMode = 'homebrew' | 'go' | 'npm' | 'link' | 'manual' | 'missing';
-export interface VersionComponentStatus {
-    id: VersionComponentId;
-    name: string;
-    executablePath?: string;
-    installPath?: string;
-    installProfile?: string;
-    current?: string;
-    latest?: string;
-    outdated: boolean;
-    installMode: VersionInstallMode;
-    updateSupported: boolean;
-    updateHint: string;
-    checkError?: string;
-}
-export interface VersionStatus {
-    checkedAt: string;
-    components: VersionComponentStatus[];
-}
-export interface VersionUpdateResult {
-    component: VersionComponentId;
-    previousVersion?: string;
-    currentVersion?: string;
-    updated: boolean;
-    restartRequired: boolean;
-    output?: string;
-}
+import type { VersionComponentId, VersionStatus, VersionUpdateResult } from './shared/contracts.ts';
+export type { VersionComponentId, VersionComponentStatus, VersionInstallMode, VersionStatus, VersionUpdateResult } from './shared/contracts.ts';
 export interface VersionUpdateDependencies {
     packageManifestPath?: string;
     dshHome?: string;
@@ -61,4 +35,3 @@ export declare class VersionUpdateManager {
     check(): Promise<VersionStatus>;
     update(component: VersionComponentId): Promise<VersionUpdateResult>;
 }
-//# sourceMappingURL=version-updates.d.ts.map

package/package.json

@@ -1,13 +1,22 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.1.5",
-  "description": "Cross-agent, local-first persistent memory plugin for DeepSeek Harness (DSH), powered by Mnemon. It shares long-term memory across Mnemon-enabled agents and adds runtime memory, searchable project documents, semantic recall, knowledge graph, and a Sidebar UI.",
+  "version": "0.2.0",
+  "description": "Three-tier memory system for DeepSeek Harness with nine pluggable providers, smart routing, independent task Agents, WebUI, and headless tools.",
   "keywords": [
     "deepseek-harness",
     "deepseek-harness-plugin",
     "dsh",
     "dsh-plugin",
     "mnemon",
+    "openviking",
+    "honcho",
+    "mem0",
+    "hindsight",
+    "holographic-memory",
+    "retaindb",
+    "byterover",
+    "supermemory",
+    "memory-provider",
     "memory-system",
     "memory-plugin",
     "agent-memory",
@@ -25,7 +34,7 @@
     "semantic-recall",
     "memory-space",
     "workspace-memory",
-    "subagent",
+    "task-agent",
     "knowledge-graph",
     "ai-agent",
     "llm-agent",
@@ -35,6 +44,7 @@
     "typescript",
     "cordis",
     "web-ui",
+    "headless",
     "sidebar"
   ],
   "repository": {
@@ -71,11 +81,8 @@
     "cordis.patch.yml",
     "README.md",
     "README.zh-CN.md",
+    "THIRD_PARTY_NOTICES.md",
     "SECURITY.md",
-    "docs/README.md",
-    "docs/assets",
-    "docs/zh-CN",
-    "docs/en",
     "LICENSE"
   ],
   "dsh": {
@@ -94,12 +101,16 @@
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && tsdown",
+    "build": "tsdown && tsc -p tsconfig.types.json",
     "bundle": "tsdown",
     "prepublishOnly": "pnpm run verify",
+    "lint:package": "publint --strict && attw --pack . --profile esm-only --quiet",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
-    "verify": "pnpm run typecheck && pnpm run test && pnpm run build"
+    "verify:build": "node scripts/verify-deterministic-build.mjs",
+    "verify:headless": "node scripts/verify-headless-profile.mjs",
+    "verify:package": "node scripts/verify-package-contents.mjs && pnpm run lint:package",
+    "verify": "pnpm run typecheck && pnpm run test && pnpm run verify:build && pnpm run verify:headless && pnpm run verify:package"
   },
   "dependencies": {
     "fflate": "^0.8.3",
@@ -112,6 +123,7 @@
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-connection": "0.1.0-rc.6",
@@ -128,6 +140,7 @@
     "@types/react-dom": "^18.3.0",
     "jsdom": "^26.1.0",
     "lightningcss": "^1.29.0",
+    "publint": "^0.3.23",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tsdown": "^0.22.0",

package/docs/README.md

@@ -1,8 +0,0 @@
-# dsh-mnemon Documentation / 文档
-
-- [English](./en/README.md)
-- [简体中文](./zh-CN/README.md)
-
-The root README stays focused on orientation and quick start. Architecture, data model, lifecycle, interfaces, operations, and development details live here.
-
-根目录 README 只保留项目概览和快速开始；架构、数据模型、生命周期、接口、运维和开发细节在此维护。

package/docs/assets/diagrams/en/project-architecture.svg

@@ -1,182 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1040" viewBox="0 0 1600 1040" role="img" aria-labelledby="title description" lang="en">
-  <title id="title">dsh-mnemon runtime architecture</title>
-  <desc id="description">DSH Web, the root Agent, and tools and commands enter the dsh-mnemon control and supervision layer, which connects to Runtime Memory, Project Documents, and long-term Mnemon Memory Spaces.</desc>
-  <style>
-    text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, Arial, sans-serif; fill: #172033; }
-    .canvas { fill: #f7f9fc; }
-    .section { fill: #f0f3f8; stroke: #d7deea; stroke-width: 1.5; }
-    .card { fill: #ffffff; stroke: #d7deea; stroke-width: 1.5; filter: url(#shadow); }
-    .card-hot { fill: #fff3df; stroke: #c66a09; }
-    .card-doc { fill: #e8f1ff; stroke: #2563be; }
-    .card-long { fill: #e2f7ef; stroke: #087c5b; }
-    .title { font-size: 34px; font-weight: 720; letter-spacing: -0.6px; }
-    .subtitle { font-size: 17px; fill: #647086; }
-    .section-title { font-size: 17px; font-weight: 700; fill: #6558d9; letter-spacing: 0.4px; }
-    .node-title { font-size: 21px; font-weight: 700; }
-    .node-copy { font-size: 15px; fill: #647086; }
-    .node-code { font-family: "SFMono-Regular", Consolas, monospace; font-size: 14px; fill: #647086; }
-    .store-title { font-size: 23px; font-weight: 740; }
-    .store-copy { font-size: 15px; fill: #647086; }
-    .pill { fill: #f0f3f8; stroke: #d7deea; }
-    .pill-text { font-size: 13px; font-weight: 650; fill: #647086; }
-    .flow { fill: none; stroke: #aeb9ca; stroke-width: 2.5; marker-end: url(#arrow); }
-    .flow-hot { stroke: #c66a09; marker-end: url(#arrow-hot); }
-    .flow-doc { stroke: #2563be; marker-end: url(#arrow-doc); }
-    .flow-long { stroke: #087c5b; marker-end: url(#arrow-long); }
-    .flow-supervised { stroke: #6558d9; stroke-dasharray: 8 7; marker-end: url(#arrow-accent); }
-    .flow-label { font-size: 13px; font-weight: 650; fill: #647086; }
-    .legend { font-size: 13px; fill: #647086; }
-    .legend-line, .bus-line { marker-end: none; }
-    .bar-hot { fill: #c66a09; }
-    .bar-doc { fill: #2563be; }
-    .bar-long { fill: #087c5b; }
-  </style>
-  <defs>
-    <filter id="shadow" x="-10%" y="-20%" width="120%" height="150%">
-      <feDropShadow dx="0" dy="7" stdDeviation="10" flood-color="#21314d" flood-opacity="0.08"/>
-    </filter>
-    <marker id="arrow" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#aeb9ca"/>
-    </marker>
-    <marker id="arrow-hot" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#c66a09"/>
-    </marker>
-    <marker id="arrow-doc" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#2563be"/>
-    </marker>
-    <marker id="arrow-long" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#087c5b"/>
-    </marker>
-    <marker id="arrow-accent" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#6558d9"/>
-    </marker>
-  </defs>
-
-  <rect class="canvas" width="1600" height="1040" rx="24"/>
-  <text class="title" x="64" y="58">dsh-mnemon runtime architecture</text>
-  <text class="subtitle" x="64" y="87">DSH supervises and orchestrates · Mnemon provides deterministic durable storage · all three tiers stay local</text>
-  <rect class="section" x="48" y="300" width="1504" height="394" rx="24"/>
-
-  <g aria-label="DSH interaction surfaces">
-    <rect class="card" x="64" y="124" width="430" height="126" rx="18"/>
-    <rect class="pill" x="88" y="146" width="96" height="27" rx="13.5"/>
-    <text class="pill-text" x="136" y="165" text-anchor="middle">DSH WEB</text>
-    <text class="node-title" x="88" y="204">Memory workspace and settings</text>
-    <text class="node-copy" x="88" y="231">Eight pages · Chinese/English · global theme</text>
-
-    <rect class="card" x="585" y="124" width="430" height="126" rx="18"/>
-    <rect class="pill" x="609" y="146" width="112" height="27" rx="13.5"/>
-    <text class="pill-text" x="665" y="165" text-anchor="middle">ROOT AGENT</text>
-    <text class="node-title" x="609" y="204">Current task and main context</text>
-    <text class="node-copy" x="609" y="231">Current instructions and live facts stay authoritative</text>
-
-    <rect class="card" x="1106" y="124" width="430" height="126" rx="18"/>
-    <rect class="pill" x="1130" y="146" width="142" height="27" rx="13.5"/>
-    <text class="pill-text" x="1201" y="165" text-anchor="middle">TOOLS · COMMANDS</text>
-    <text class="node-title" x="1130" y="204">Model tools and /mnemon</text>
-    <text class="node-copy" x="1130" y="231">Explicit recall, distill, links, status, maintenance</text>
-  </g>
-
-  <g aria-hidden="true">
-    <path class="flow" d="M279 250 V281 H1298 V350"/>
-    <path class="flow flow-supervised" d="M800 250 V350"/>
-    <path class="flow" d="M1321 250 V292 H800 V350"/>
-    <text class="flow-label" x="1042" y="276">typed RPC</text>
-    <text class="flow-label" x="815" y="302">tool calls</text>
-  </g>
-
-  <text class="section-title" x="80" y="337">DSH HOST · DSH-MNEMON CONTROL AND SUPERVISION LAYER</text>
-
-  <g aria-hidden="true">
-    <path class="flow bus-line" d="M300 476 V498"/>
-    <path class="flow flow-supervised bus-line" d="M800 476 V498"/>
-    <path class="flow bus-line" d="M1300 476 V498"/>
-    <path class="flow bus-line" d="M245 498 H1300"/>
-    <path class="flow" d="M245 498 V520"/>
-    <path class="flow" d="M615 498 V520"/>
-    <path class="flow" d="M985 498 V520"/>
-    <path class="flow" d="M990 630 H1190"/>
-  </g>
-
-  <g aria-label="Supervision and permission components">
-    <rect class="card" x="100" y="350" width="400" height="126" rx="17"/>
-    <text class="node-title" x="126" y="390">Prompt and lifecycle</text>
-    <text class="node-copy" x="126" y="420">Hot-context injection · short cues · activity score</text>
-    <text class="node-code" x="126" y="448">pre-step · turn/end · idle review</text>
-
-    <rect class="card" x="600" y="350" width="400" height="126" rx="17"/>
-    <text class="node-title" x="626" y="390">Subagent Coordinator</text>
-    <text class="node-copy" x="626" y="420">isolated spawn · completed-checkpoint fork</text>
-    <text class="node-code" x="626" y="448">persona · allowlist · schema · depth=1</text>
-
-    <rect class="card" x="1100" y="350" width="400" height="126" rx="17"/>
-    <text class="node-title" x="1126" y="390">RPC and permission boundary</text>
-    <text class="node-copy" x="1126" y="420">trusted-host reads · loopback writes</text>
-    <text class="node-code" x="1126" y="448">read · write · settings channels</text>
-  </g>
-
-  <g aria-label="Deterministic control components">
-    <rect class="card" x="80" y="520" width="330" height="110" rx="16"/>
-    <text class="node-title" x="104" y="559">Runtime Memory</text>
-    <text class="node-copy" x="104" y="587">JSON authority · Markdown projections</text>
-    <text class="node-code" x="104" y="612">lock · revision · UTF-8</text>
-
-    <rect class="card" x="450" y="520" width="330" height="110" rx="16"/>
-    <text class="node-title" x="474" y="559">Documents</text>
-    <text class="node-copy" x="474" y="587">index · search · active / archived</text>
-    <text class="node-code" x="474" y="612">path boundary · LRU · SHA-256</text>
-
-    <rect class="card" x="820" y="520" width="330" height="110" rx="16"/>
-    <text class="node-title" x="844" y="559">Mnemon Service</text>
-    <text class="node-copy" x="844" y="587">space routing · recall · links · graph</text>
-    <text class="node-code" x="844" y="612">active read · targeted write</text>
-
-    <rect class="card" x="1190" y="520" width="280" height="110" rx="16"/>
-    <text class="node-title" x="1214" y="559">CLI Runner</text>
-    <text class="node-copy" x="1214" y="587">argument arrays · no shell</text>
-    <text class="node-code" x="1214" y="612">serialized · timeout</text>
-  </g>
-
-  <g aria-hidden="true">
-    <path class="flow flow-hot" d="M245 630 V760"/>
-    <path class="flow flow-doc" d="M615 630 V724 H800 V760"/>
-    <path class="flow flow-long" d="M1330 630 V724 H1310 V760"/>
-    <text class="flow-label" x="262" y="718">every-turn projection</text>
-    <text class="flow-label" x="632" y="714">managed Markdown</text>
-    <text class="flow-label" x="1344" y="713">local CLI</text>
-  </g>
-
-  <g aria-label="Three local storage tiers">
-    <rect class="card card-hot" x="64" y="760" width="440" height="194" rx="20"/>
-    <rect class="bar-hot" x="88" y="784" width="9" height="48" rx="4.5"/>
-    <text class="store-title" x="116" y="809">Runtime hot memory</text>
-    <text class="node-code" x="116" y="834">&lt;storageRoot&gt;/runtime</text>
-    <text class="store-copy" x="88" y="870">memories.json is the only authority</text>
-    <text class="store-copy" x="88" y="898">USER.md 4 KiB · MEMORY.md 10 KiB</text>
-    <text class="store-copy" x="88" y="926">compact context enters every root turn</text>
-
-    <rect class="card card-doc" x="580" y="760" width="440" height="194" rx="20"/>
-    <rect class="bar-doc" x="604" y="784" width="9" height="48" rx="4.5"/>
-    <text class="store-title" x="632" y="809">Project Documents</text>
-    <text class="node-code" x="632" y="834">&lt;storageRoot&gt;/documents</text>
-    <text class="store-copy" x="604" y="870">index.json · active/ · archived/</text>
-    <text class="store-copy" x="604" y="898">complete Markdown narrative and provenance</text>
-    <text class="store-copy" x="604" y="926">cold-reference first, then move the original</text>
-
-    <rect class="card card-long" x="1096" y="760" width="440" height="194" rx="20"/>
-    <rect class="bar-long" x="1120" y="784" width="9" height="48" rx="4.5"/>
-    <text class="store-title" x="1148" y="809">Mnemon Memory Spaces</text>
-    <text class="node-code" x="1148" y="834">&lt;storageRoot&gt;/data/&lt;space-id&gt;/mnemon.db</text>
-    <text class="store-copy" x="1120" y="870">isolated SQLite Stores · active read boundary</text>
-    <text class="store-copy" x="1120" y="898">temporal · semantic · causal · entity</text>
-    <text class="store-copy" x="1120" y="926">cross-session, on-demand, attributed evidence</text>
-  </g>
-
-  <g aria-label="Legend">
-    <line x1="70" y1="996" x2="112" y2="996" class="flow legend-line"/>
-    <text class="legend" x="124" y="1001">deterministic data / control path</text>
-    <line x1="390" y1="996" x2="432" y2="996" class="flow flow-supervised legend-line"/>
-    <text class="legend" x="444" y="1001">LLM-supervised path</text>
-    <text class="legend" x="1532" y="1001" text-anchor="end">all persistent data stays under the selected storageRoot</text>
-  </g>
-</svg>

package/docs/assets/diagrams/zh-CN/project-architecture.svg

@@ -1,182 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1040" viewBox="0 0 1600 1040" role="img" aria-labelledby="title description" lang="zh-CN">
-  <title id="title">dsh-mnemon 运行时架构</title>
-  <desc id="description">DSH Web、主 Agent 和工具命令进入 dsh-mnemon 控制与监督层，再分别连接运行时热记忆、项目档案和 Mnemon 长期记忆体。</desc>
-  <style>
-    text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans CJK SC", "Microsoft YaHei", sans-serif; fill: #172033; }
-    .canvas { fill: #f7f9fc; }
-    .section { fill: #f0f3f8; stroke: #d7deea; stroke-width: 1.5; }
-    .card { fill: #ffffff; stroke: #d7deea; stroke-width: 1.5; filter: url(#shadow); }
-    .card-hot { fill: #fff3df; stroke: #c66a09; }
-    .card-doc { fill: #e8f1ff; stroke: #2563be; }
-    .card-long { fill: #e2f7ef; stroke: #087c5b; }
-    .title { font-size: 34px; font-weight: 720; letter-spacing: -0.6px; }
-    .subtitle { font-size: 17px; fill: #647086; }
-    .section-title { font-size: 17px; font-weight: 700; fill: #6558d9; letter-spacing: 0.4px; }
-    .node-title { font-size: 21px; font-weight: 700; }
-    .node-copy { font-size: 15px; fill: #647086; }
-    .node-code { font-family: "SFMono-Regular", Consolas, monospace; font-size: 14px; fill: #647086; }
-    .store-title { font-size: 23px; font-weight: 740; }
-    .store-copy { font-size: 15px; fill: #647086; }
-    .pill { fill: #f0f3f8; stroke: #d7deea; }
-    .pill-text { font-size: 13px; font-weight: 650; fill: #647086; }
-    .flow { fill: none; stroke: #aeb9ca; stroke-width: 2.5; marker-end: url(#arrow); }
-    .flow-hot { stroke: #c66a09; marker-end: url(#arrow-hot); }
-    .flow-doc { stroke: #2563be; marker-end: url(#arrow-doc); }
-    .flow-long { stroke: #087c5b; marker-end: url(#arrow-long); }
-    .flow-supervised { stroke: #6558d9; stroke-dasharray: 8 7; marker-end: url(#arrow-accent); }
-    .flow-label { font-size: 13px; font-weight: 650; fill: #647086; }
-    .legend { font-size: 13px; fill: #647086; }
-    .legend-line, .bus-line { marker-end: none; }
-    .bar-hot { fill: #c66a09; }
-    .bar-doc { fill: #2563be; }
-    .bar-long { fill: #087c5b; }
-  </style>
-  <defs>
-    <filter id="shadow" x="-10%" y="-20%" width="120%" height="150%">
-      <feDropShadow dx="0" dy="7" stdDeviation="10" flood-color="#21314d" flood-opacity="0.08"/>
-    </filter>
-    <marker id="arrow" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#aeb9ca"/>
-    </marker>
-    <marker id="arrow-hot" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#c66a09"/>
-    </marker>
-    <marker id="arrow-doc" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#2563be"/>
-    </marker>
-    <marker id="arrow-long" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#087c5b"/>
-    </marker>
-    <marker id="arrow-accent" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
-      <path d="M 0 0 L 10 5 L 0 10 z" fill="#6558d9"/>
-    </marker>
-  </defs>
-
-  <rect class="canvas" width="1600" height="1040" rx="24"/>
-  <text class="title" x="64" y="58">dsh-mnemon 运行时架构</text>
-  <text class="subtitle" x="64" y="87">DSH 负责监督与编排 · Mnemon 负责确定性长期存储 · 三层数据保留在本地</text>
-  <rect class="section" x="48" y="300" width="1504" height="394" rx="24"/>
-
-  <g aria-label="DSH 交互入口">
-    <rect class="card" x="64" y="124" width="430" height="126" rx="18"/>
-    <rect class="pill" x="88" y="146" width="96" height="27" rx="13.5"/>
-    <text class="pill-text" x="136" y="165" text-anchor="middle">DSH WEB</text>
-    <text class="node-title" x="88" y="204">记忆体工作台与插件设置</text>
-    <text class="node-copy" x="88" y="231">八个页面 · 中文/英文 · 全局明暗主题</text>
-
-    <rect class="card" x="585" y="124" width="430" height="126" rx="18"/>
-    <rect class="pill" x="609" y="146" width="112" height="27" rx="13.5"/>
-    <text class="pill-text" x="665" y="165" text-anchor="middle">ROOT AGENT</text>
-    <text class="node-title" x="609" y="204">当前任务与主上下文</text>
-    <text class="node-copy" x="609" y="231">当前指令和实时事实始终优先</text>
-
-    <rect class="card" x="1106" y="124" width="430" height="126" rx="18"/>
-    <rect class="pill" x="1130" y="146" width="142" height="27" rx="13.5"/>
-    <text class="pill-text" x="1201" y="165" text-anchor="middle">TOOLS · COMMANDS</text>
-    <text class="node-title" x="1130" y="204">模型工具与 /mnemon 命令</text>
-    <text class="node-copy" x="1130" y="231">显式召回、沉淀、关系、状态与维护</text>
-  </g>
-
-  <g aria-hidden="true">
-    <path class="flow" d="M279 250 V281 H1298 V350"/>
-    <path class="flow flow-supervised" d="M800 250 V350"/>
-    <path class="flow" d="M1321 250 V292 H800 V350"/>
-    <text class="flow-label" x="1042" y="276">typed RPC</text>
-    <text class="flow-label" x="815" y="302">工具调用</text>
-  </g>
-
-  <text class="section-title" x="80" y="337">DSH HOST · DSH-MNEMON 控制与监督层</text>
-
-  <g aria-hidden="true">
-    <path class="flow bus-line" d="M300 476 V498"/>
-    <path class="flow flow-supervised bus-line" d="M800 476 V498"/>
-    <path class="flow bus-line" d="M1300 476 V498"/>
-    <path class="flow bus-line" d="M245 498 H1300"/>
-    <path class="flow" d="M245 498 V520"/>
-    <path class="flow" d="M615 498 V520"/>
-    <path class="flow" d="M985 498 V520"/>
-    <path class="flow" d="M990 630 H1190"/>
-  </g>
-
-  <g aria-label="监督与权限组件">
-    <rect class="card" x="100" y="350" width="400" height="126" rx="17"/>
-    <text class="node-title" x="126" y="390">Prompt 与 Lifecycle</text>
-    <text class="node-copy" x="126" y="420">热记忆注入 · 短提示 · 活动评分</text>
-    <text class="node-code" x="126" y="448">pre-step · turn/end · idle review</text>
-
-    <rect class="card" x="600" y="350" width="400" height="126" rx="17"/>
-    <text class="node-title" x="626" y="390">Subagent Coordinator</text>
-    <text class="node-copy" x="626" y="420">spawn 隔离任务 · fork 已完成 checkpoint</text>
-    <text class="node-code" x="626" y="448">persona · allowlist · schema · depth=1</text>
-
-    <rect class="card" x="1100" y="350" width="400" height="126" rx="17"/>
-    <text class="node-title" x="1126" y="390">RPC 与权限边界</text>
-    <text class="node-copy" x="1126" y="420">trusted-host 读取 · loopback 写入</text>
-    <text class="node-code" x="1126" y="448">read · write · settings channels</text>
-  </g>
-
-  <g aria-label="确定性控制组件">
-    <rect class="card" x="80" y="520" width="330" height="110" rx="16"/>
-    <text class="node-title" x="104" y="559">Runtime Memory</text>
-    <text class="node-copy" x="104" y="587">JSON 事实源 · Markdown 投影</text>
-    <text class="node-code" x="104" y="612">lock · revision · UTF-8</text>
-
-    <rect class="card" x="450" y="520" width="330" height="110" rx="16"/>
-    <text class="node-title" x="474" y="559">Documents</text>
-    <text class="node-copy" x="474" y="587">索引 · 检索 · active / archived</text>
-    <text class="node-code" x="474" y="612">path boundary · LRU · SHA-256</text>
-
-    <rect class="card" x="820" y="520" width="330" height="110" rx="16"/>
-    <text class="node-title" x="844" y="559">Mnemon Service</text>
-    <text class="node-copy" x="844" y="587">记忆体路由 · 召回 · 关系 · 图谱</text>
-    <text class="node-code" x="844" y="612">active read · targeted write</text>
-
-    <rect class="card" x="1190" y="520" width="280" height="110" rx="16"/>
-    <text class="node-title" x="1214" y="559">CLI Runner</text>
-    <text class="node-copy" x="1214" y="587">参数数组 · 禁用 shell</text>
-    <text class="node-code" x="1214" y="612">serialized · timeout</text>
-  </g>
-
-  <g aria-hidden="true">
-    <path class="flow flow-hot" d="M245 630 V760"/>
-    <path class="flow flow-doc" d="M615 630 V724 H800 V760"/>
-    <path class="flow flow-long" d="M1330 630 V724 H1310 V760"/>
-    <text class="flow-label" x="262" y="718">每轮投影</text>
-    <text class="flow-label" x="632" y="714">受管 Markdown</text>
-    <text class="flow-label" x="1344" y="713">本地 CLI</text>
-  </g>
-
-  <g aria-label="三层本地存储">
-    <rect class="card card-hot" x="64" y="760" width="440" height="194" rx="20"/>
-    <rect class="bar-hot" x="88" y="784" width="9" height="48" rx="4.5"/>
-    <text class="store-title" x="116" y="809">运行时热记忆</text>
-    <text class="node-code" x="116" y="834">&lt;storageRoot&gt;/runtime</text>
-    <text class="store-copy" x="88" y="870">memories.json 是唯一事实源</text>
-    <text class="store-copy" x="88" y="898">USER.md 4 KiB · MEMORY.md 10 KiB</text>
-    <text class="store-copy" x="88" y="926">紧凑内容每轮直接进入主上下文</text>
-
-    <rect class="card card-doc" x="580" y="760" width="440" height="194" rx="20"/>
-    <rect class="bar-doc" x="604" y="784" width="9" height="48" rx="4.5"/>
-    <text class="store-title" x="632" y="809">项目档案</text>
-    <text class="node-code" x="632" y="834">&lt;storageRoot&gt;/documents</text>
-    <text class="store-copy" x="604" y="870">index.json · active/ · archived/</text>
-    <text class="store-copy" x="604" y="898">保留完整 Markdown 叙事与来源</text>
-    <text class="store-copy" x="604" y="926">先建立冷引用，再迁移原文</text>
-
-    <rect class="card card-long" x="1096" y="760" width="440" height="194" rx="20"/>
-    <rect class="bar-long" x="1120" y="784" width="9" height="48" rx="4.5"/>
-    <text class="store-title" x="1148" y="809">Mnemon 记忆体</text>
-    <text class="node-code" x="1148" y="834">&lt;storageRoot&gt;/data/&lt;space-id&gt;/mnemon.db</text>
-    <text class="store-copy" x="1120" y="870">独立 SQLite Store · active 读取边界</text>
-    <text class="store-copy" x="1120" y="898">temporal · semantic · causal · entity</text>
-    <text class="store-copy" x="1120" y="926">跨会话、按需、带来源的长期证据</text>
-  </g>
-
-  <g aria-label="图例">
-    <line x1="70" y1="996" x2="112" y2="996" class="flow legend-line"/>
-    <text class="legend" x="124" y="1001">确定性数据 / 控制路径</text>
-    <line x1="346" y1="996" x2="388" y2="996" class="flow flow-supervised legend-line"/>
-    <text class="legend" x="400" y="1001">LLM 监督路径</text>
-    <text class="legend" x="1532" y="1001" text-anchor="end">所有持久数据位于选定 storageRoot</text>
-  </g>
-</svg>