@hanamesh/dsh-app-host 0.2.0-rc.2

package/docs/DSH_INTEGRATION.md

@@ -0,0 +1,43 @@
+# DSH 集成
+
+> **NPM-APPHOST-01（2026-10-05，当前候选）：** 目标为官方 `@deepseek-ai/dsh@0.2.0-rc.2`；本地 tarball 在隔离官方 profile 的 `dsh.profile.bundles` 中落座，`--dump-config` 可见 `hanamesh-app-host`。以下 rc.11 及更早说明保留为历史，不作为本候选的公开 npm 门。owner D-2026-10-05-02 已确认内联 `lib-provision` 为自有且可分发；独立许可分区见根 `LICENSE`，PUBLIC_NPM 由 PM 执行。浏览器可见性证据以 BlueMap 当前卡 REPORT 为准。
+
+> **2026-09-19（rc.11）：** 本包现在声明 DSH bundle。对独立 profile 执行 `dsh plugin --profile <name> add <本包.tgz>` 即会通过 `profile/cordis.patch.yml` 激活包根 `@hanamesh/dsh-app-host`，不要再手写 insert。包根保留核心 API，并以懒加载方式落座 Host；固定版本 `dsh-client-modules` 只有在 loader entry 是包根时才会发现 `./client`。HanaMesh 套件已内含本包；套件用户不要单独安装。若此前装过单包，先 `plugin remove @hanamesh/dsh-app-host` 再安装套件，避免重复 `hanamesh-app-host` loader id。桌面 Electron 壳必须在 config 提供独立可执行 `nodeBinary`。
+>
+> 应用库浏览可只配置 `library.fixture` 或 `library.sources`；`sources` 未配置时默认 HanaMesh 目录源（rc.26）。安装/卸载需要绝对 `library.profileDir`、`library.profileName`、`library.dshBin` 与 `nodeBinary`——桌面壳 overlay 显式给出；纯 DSH CLI profile 下 rc.26 从本包自身真实安装位置、启动本进程的 `@deepseek-ai/dsh/lib/bin.js` 和（非 Electron 的）`process.execPath` 推断，显式配置优先。钉版本宿主没有公开 profile-directory 服务，因此仍不从 cwd、PATH 或个人 `~/.dsh` 猜。目录源与安装契约见 `LIBRARY.md`，推断规则见 `CONTRACT.md`「应用库配置」。
+
+> **2026-09-12（rc.3）：** 干净安装锁文件和占用 Stop 的 HTTP 409 已修复；五个动作的重新验收证据见 `acceptance/wave01-resolution-report.md`。rc.2 的回收证据保留在下方，不能作为 rc.3 的包摘要。
+
+> **2026-09-12（rc.2）：DSH 侧已实现并在真实 profile 加载。** 入口 `@hanamesh/dsh-app-host/dsh`（`src/dsh.js`）绑定固定版本 DSH 0.1.5-alpha.1 **声明过的**公开 API：`ctx.storageDomain.open()`（single 布局，整个快照是一个 global，`global.set` 即一次整体发布）、`ctx.webServer.register()`（八条 exact 路由）、`ctx.connection.requestRejection()`（与 `/api` 通道相同的 Host/Origin 栅栏 + 浏览器 cookie；主体为本 profile 唯一的本地浏览器会话 `dsh-browser`）、`ctx.provide/ctx.effect`。`inject` 声明三项服务，缺 `connection` 时插件不激活、不会有公开路由。profile 接法：
+>
+> ```yaml
+> - insert:
+>     - id: hanamesh-app-host
+>       name: '@hanamesh/dsh-app-host/dsh'
+>       config: { dataRoot: /abs/path, applications: [ …AppDefinition… ] }
+> ```
+>
+> 证据：`docs/acceptance/recovery-20260912/h01-real-profile.log`、`dsh-real-cordis.tap`。下文是 rc.1 交付方写下的当时缺口，作为历史保留。
+
+## rc.1 时的缺口（历史）
+
+**当时不支持直接把本候选当成已加载的 DSH 插件。** `apply()` 有意抛出 DSH_BINDING_REQUIRED。`createDshPlugin()` 接受的 bridge 是本仓定义的集成端口，不是已验证的官方 API 名称；不能填几个假函数就把 H01/H11 标 PASS。
+
+## 已知目标与实际证据
+
+输入文档锁定 DSH `0.1.5-alpha.1`、Node `24.13.1`、pnpm `10.33.0`、desktop `v0.1.0`、Tauri `2.11.5`、macOS arm64 / web profile。当前只有 Linux Node22.16.0，未安装真实 DSH。npm registry 网络解析失败；所需私有原型仓通过连接器读取返回404。
+
+因此以下结论没有成立：原型代码提取完成、原许可证继承、Cordis 服务加载成功、DSH domain 持久化成功、DSH session 写后自读成功、Tauri iframe兼容、macOS进程组/端口检查通过、workspace依赖已满足。
+
+## 接续开发只做这几步
+
+1. **取得指定原型。** `yzsnstotz/hanamesh` 的 `research/dsh-greenfield-2026-09-09/workspace/packages/hanamesh-app-host/`。记录实际 commit、许可证、package exports、描述符与路由契约；与本候选比对，尽量把已验证核心回归合入原型提取版，而不是机械替换未核对的接口。
+2. **读取固定版本公开扩展点。** 在独立 profile 查清 `ctx.provide`、`ctx.webServer.register`、卸载 hook、认证/授权上下文，以及官方 storage-domain 的 single 布局完整镜像发布 API。不要修改 DSH 内核，不调用猜测名称的接口，不写未知 Session.append 事件。
+3. **实现一个小的真实 bridge。** `storage(ctx)` 返回 `{layout:'single',domain:'hanamesh-app-host',readSnapshot,publishSnapshot,acquireExclusive,releaseExclusive}`；publishSnapshot 必须一次提交整个镜像。`mountAuthenticatedRoutes`、`provide` 返回真实注销函数；`onDispose` await 本模块 dispose；authenticate/authorize 连接宿主既有身份系统。bridge版本判断必须来自实际运行宿主，不是配置字符串自证。
+4. **最小 profile 真实加载验证。** 安装固定 tarball、实际读取 `ctx.hanameshApps`、注册受控应用并调用 Open/Close；移除研究目录仍能启动。随后通过 DSH 自己的 session API 建立/读取合法 session，执行租约写入，再通过 DSH 自己读取原 session；保存实际输入输出，完成 H01/H11。
+5. **复跑强杀和浏览器验收。** 在真实 single domain 发布边界运行 X02/X03；Mac上验证应用监听端口确属已启动进程组。允许正常回环访问的合法测试环境复跑浏览器H10/H13/H14，不绕过任何管理员控制。MOD-05 上游应用行为由对应适配包验收，不挤进 app-host 伪造通过。
+6. **核对版本与依赖门。** 修改与原型的差异按版本说明，发布新锁定产物和摘要。只有完整门通过才可标 DELIVERED；ACCEPTED 仍由用户操作。不要直接把本 rc 改成正式0.1.0并解锁 workspace。
+
+peer 范围保留输入要求：`@deepseek-ai/cordis ^4.0.2` 与 `@deepseek-ai/schemastery ^3.18.2`。目前标 optional 仅为了核心独立安装不从网络拉未验证组件；不表示 DSH 集成可以不用它们。
+
+运行 `npm run preflight:dsh` 会输出当前缺失项并以代码2退出，这个预检是阻塞说明，不是安装器，也不是自动联网修复。

package/docs/LIBRARY.md

@@ -0,0 +1,45 @@
+# HanaMesh 市场（原应用库）
+
+> rc.28：入口改名「市场」，插件与应用同一入口、同一 `dsh plugin add/remove` 路径；已装列表含插件；可升级 / 需重启；新路由与响应形状见 `CONTRACT.md`「市场」。下文旧称「应用库」的段落仍然成立。
+
+## 范围
+
+应用库是 app-host 自带的 DSH 页面，不依赖第三方市场。它读取一个启用的目录源，同时独立扫描当前 profile 已安装的应用包；由 Community Market 安装的同一包会被接管，不做宿主市场探测。
+
+## 目录源
+
+- `library.fixture` 只用于受控验收；内容必须符合 `schemas/catalog-provider-page.schema.json`。
+- `library.sources` **未配置**时默认为 HanaMesh 目录源 `https://market.hanamesh.com/catalog-source.json`（rc.26；显式 `[]` = 不要来源）；可有多项，但浏览时必须恰好启用一项。远端 manifest 只接受标准端口 HTTPS、无凭据/query/fragment；endpoint 必须同源。
+- 请求固定 `Accept: application/json` 与 `Accept-Encoding: identity`；最多三次同源跳转，拒绝压缩响应与超过 2 MiB 的响应。
+- `categories` 含 `hanamesh-app` 且 `package.registry` 为 `npm` 的条目是应用（安装后读 `app.json`、供给 runtime）；其它 `package.registry` 为 `npm` 的条目是插件（rc.28 起同样可装卸，只跑 `dsh plugin add/remove`）；无 npm 包的条目（repository-only）只展示。
+
+## Profile 与安装
+
+钉版本 DSH 没有向插件公开 profile 目录或 profile 名。桌面壳通过 overlay 显式给出 `library.profileDir`（绝对路径）、`library.profileName`、`library.dshBin` 与 `nodeBinary`，显式值永远优先。**纯 DSH CLI profile（rc.26）** 下缺省值按 `CONTRACT.md`「应用库配置」推断：`profileDir` 来自本包自身真实安装位置所属的 profile、`profileName` 为其目录名、`dshBin` 只取启动本进程的 `@deepseek-ai/dsh/lib/bin.js`、`nodeBinary` 只在非 Electron 进程取 `process.execPath`。Electron 下仍必须由 dsh-runtime/core 提供绝对 `nodeBinary`；应用库不会在 Electron 里回退到 `process.execPath`。
+
+安装先向 registry 的 `latest` 端点复核精确稳定版本，再用显式 Node 执行 DSH 自己的 `bin.js plugin --profile <name> add --save-exact <package>@<version>`。成功后读取包内 `app.json`；如果描述符声明 runtime，则调用随包内联的锁定 `@hanamesh/lib-provision@0.1.0-rc.1`。生产默认拒绝 prerelease；隔离 Verdaccio 验收可显式设 `allowPrerelease: true`。
+
+安装/卸载完成只返回 `restart-required`，绝不静默重启 DSH。卸载只删除包与 lib-provision 账本认领的 runtime 文件，保留 `<dataRoot>` 下应用数据；彻底删除需用户手动处理对应数据目录。
+
+## 状态与路由
+
+已安装应用扫描给出 `registered`、`installed-not-loaded`、`runtime-missing` 或 `invalid`；已安装插件扫描（rc.28）给出 `installed`、`installed-not-loaded`、`uninstalled-not-unloaded` 或 `invalid`。浏览器路由为 `/hanamesh/library`、`/hanamesh/library/sources`、`/hanamesh/library/install`、`/hanamesh/library/provision`、`/hanamesh/library/uninstall`、`/hanamesh/library/events`、`/hanamesh/library/installedPlugins`、`/hanamesh/library/plugins/install` 和 `/hanamesh/library/plugins/uninstall`，全部复用 app-host 的 Host/Origin/iframe/auth/CSRF 防护链。
+
+应用打开仍只走 app-host 的视图租约 API；页面只保存临时 receipt，不拥有第二份实例状态。
+
+## 锁定产物
+
+私有 `@hanamesh/lib-provision` 不作为 package dependency 或 peer。build 校验 vendor tgz 的 SHA-256 后提取 `lib/**` 到 `dist/provision/`，并带入 notices 与独立 `LICENSE` 声明；来源、SHA-256 与许可分区记录在 `docs/PROVENANCE.json`、`docs/LICENSES.json` 和根 `LICENSE`。
+
+
+## rc.16 · 浏览语义（2026-09-20 线上目录门后定）
+
+- `GET /hanamesh/library?q=&category=&cursor=`：`category` 缺省为 `hanamesh-app`（本页是**应用库**，只列应用条目）；显式 `category=`（空）列出来源的全部条目；`q` 与 `cursor` 原样透传给目录源的 `/v1/plugins`（`limit=50`）。未知参数 → `UNKNOWN_FIELDS`。
+- 客户端：搜索框（回车/「搜索」）、「只看应用」开关（默认开）、「更多」按 `page.nextCursor` 追加。
+- 背景：真实来源 `market.hanamesh.com` 有 12,121 条，rc.15 之前只显示按更新时间排序的前 50 条且无搜索，应用条目实际不可达。
+
+## rc.28 · 市场浏览语义
+
+- 市场页默认 `category=`（全部）；筛选：全部 / 应用（`hanamesh-app`）/ 插件（客户端视图：本页非应用的 npm 条目）/ 目录页里出现过的类别（累积自 `categories`）。路由 `/hanamesh/library` 的缺省 `category=hanamesh-app` 不变（向后兼容）。
+- 卡片：`kind · 发布者 · latestVersion · 类别`；已装行显示状态与版本；「升级到 x.y.z」出现在 `upgradeAvailable` 时；插件「卸载」走 `plugins/uninstall`。页面底部「已安装」列出应用与插件（含 bundle 未启用为 profile 层的提示）。
+- 「需重启 DSH」横幅：任一装卸操作完成后，或列表 `restartRequired` 为真时显示；壳内为 `hanamesh://restart` 链接，官方 DSH 直开为文字提示。

package/docs/LICENSES.json

@@ -0,0 +1,185 @@
+{
+  "package": {
+    "name": "@hanamesh/dsh-app-host",
+    "version": "0.2.0-rc.2",
+    "license": "SEE LICENSE IN LICENSE",
+    "source": "git+https://github.com/yzsnstotz/hanamesh-plugin-app-host.git",
+    "purpose": "Application ownership, view leases, Router forwarding, and application library for official DSH"
+  },
+  "scope": "Direct dependencies and build-time inlined module. External packages retain their own licenses; the root MIT terms do not cover dist/provision/**.",
+  "components": {
+    "@hanamesh/lib-provision": {
+      "version": "0.1.0-rc.1",
+      "license": "UNLICENSED",
+      "source": "vendor/hanamesh-lib-provision-0.1.0-rc.1.tgz",
+      "purpose": "Inlined runtime download, extraction, atomic promotion, and ledger logic in dist/provision/**",
+      "sha256": "386d57361ccc3c8578f54cad8137acc291dd72e01b3ff987e65dfaa716f2e0b0"
+    },
+    "zod": {
+      "version": "4.5.4",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/zod/-/zod-4.5.4.tgz",
+      "purpose": "Runtime snapshot validation",
+      "usedAs": [
+        "dependencies"
+      ]
+    },
+    "@deepseek-ai/cordis": {
+      "version": "4.0.4",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/cordis/-/cordis-4.0.4.tgz",
+      "purpose": "Official DSH plugin lifecycle and service container",
+      "usedAs": [
+        "peerDependencies",
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-storage-domain": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-storage-domain/-/dsh-storage-domain-0.2.0-rc.2.tgz",
+      "purpose": "Official DSH persistent storage service",
+      "usedAs": [
+        "peerDependencies",
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/schemastery": {
+      "version": "3.18.4",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/schemastery/-/schemastery-3.18.4.tgz",
+      "purpose": "Official DSH configuration schema service",
+      "usedAs": [
+        "peerDependencies",
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-host-webserver": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-host-webserver/-/dsh-host-webserver-0.2.0-rc.2.tgz",
+      "purpose": "Official DSH authenticated HTTP route host",
+      "usedAs": [
+        "peerDependencies",
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-client-connection/-/dsh-client-connection-0.2.0-rc.2.tgz",
+      "purpose": "Official DSH client connection service",
+      "usedAs": [
+        "peerDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-client-ui-slots/-/dsh-client-ui-slots-0.2.0-rc.2.tgz",
+      "purpose": "Official DSH client UI placement",
+      "usedAs": [
+        "peerDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-client-ui-settings/-/dsh-client-ui-settings-0.2.0-rc.2.tgz",
+      "purpose": "Official DSH client settings surface",
+      "usedAs": [
+        "peerDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-client-locale/-/dsh-client-locale-0.2.0-rc.2.tgz",
+      "purpose": "Official DSH client localization",
+      "usedAs": [
+        "peerDependencies"
+      ]
+    },
+    "react": {
+      "version": "18.3.1",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
+      "purpose": "Official DSH client UI peer",
+      "usedAs": [
+        "peerDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-scope": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-scope/-/dsh-scope-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH scopes",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-session": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-session/-/dsh-session-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH sessions",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-session-persistence": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-session-persistence/-/dsh-session-persistence-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH session persistence",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-session-persistence-jsonl": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-session-persistence-jsonl/-/dsh-session-persistence-jsonl-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH JSONL session persistence",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-session-projection": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-session-projection/-/dsh-session-projection-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH session projections",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-storage": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-storage/-/dsh-storage-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH storage",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "@deepseek-ai/dsh-storage-json": {
+      "version": "0.2.0-rc.2",
+      "license": "MIT",
+      "source": "https://registry.npmjs.org/@deepseek-ai/dsh-storage-json/-/dsh-storage-json-0.2.0-rc.2.tgz",
+      "purpose": "Build and test fixture for official DSH JSON storage",
+      "usedAs": [
+        "devDependencies"
+      ]
+    },
+    "typescript": {
+      "version": "5.8.3",
+      "license": "Apache-2.0",
+      "source": "https://registry.npmjs.org/typescript/-/typescript-5.8.3.tgz",
+      "purpose": "Build-time type checking and declarations",
+      "usedAs": [
+        "devDependencies"
+      ]
+    }
+  }
+}

package/docs/PROVENANCE.json

@@ -0,0 +1,63 @@
+{
+  "currentCandidate": {
+    "version": "0.2.0-rc.2",
+    "dshTarget": "0.2.0-rc.2",
+    "vendorSha256VerifiedAtBuild": true,
+    "libProvisionDistribution": "Owner confirmed self-owned and distributable; source license remains UNLICENSED; see LICENSE and docs/LICENSES.json",
+    "publicNpmGate": "NOT_RUN"
+  },
+  "module": "app-host",
+  "version": "0.1.0-rc.12",
+  "status": "PARTIAL",
+  "implementationOrigin": "New implementation candidate based on supplied specifications; not an extraction of the inaccessible prototype",
+  "inputArchive": {
+    "file": "90fe3c76-3f06-4abd-b83c-52c17429cba9.zip",
+    "sha256": "cd79ef78b311537f0a9425e0b7b8c9f0c44f2581d8c9156f23f1fe431832c1c7",
+    "bytes": 2121179
+  },
+  "inputDocsHead": "195ee9f2e71a41caede474e29d58237fab7e4b89",
+  "inputDocsWorkingTree": "Contains pre-existing modifications in supplied archive; original files left unchanged",
+  "requiredPrototype": {
+    "repository": "yzsnstotz/hanamesh",
+    "path": "research/dsh-greenfield-2026-09-09/workspace/packages/hanamesh-app-host/",
+    "commit": null,
+    "license": null,
+    "retrieval": "GitHub.get_repo returned HTTP 404"
+  },
+  "remoteDelivery": {
+    "created": false,
+    "pushed": false,
+    "pullRequest": null,
+    "reason": "No create_repository action exposed; requested prototype repository is not readable; unrelated repository not modified"
+  },
+  "runtime": {
+    "node": "v22.16.0",
+    "npm": "10.9.2",
+    "platform": "Linux",
+    "arch": "x86_64",
+    "typescript": "Version 5.8.3"
+  },
+  "target": {
+    "dsh": "0.1.5-alpha.1",
+    "node": "24.13.1",
+    "pnpm": "10.33.0",
+    "platform": "darwin-arm64",
+    "tested": false
+  },
+  "actualModel": "GPT-6 Astra Pro",
+  "effortSetting": "not exposed; not claimed",
+  "defaultModelInInput": "Opus 5 High (not executed here)",
+  "auxiliaryAgents": 0,
+  "tokenUsage": "not independently metered",
+  "upstreamFilesModified": 0,
+  "bundledArtifacts": {
+    "@hanamesh/lib-provision": {
+      "version": "0.1.0-rc.1",
+      "source": "vendor/hanamesh-lib-provision-0.1.0-rc.1.tgz",
+      "sha256": "386d57361ccc3c8578f54cad8137acc291dd72e01b3ff987e65dfaa716f2e0b0",
+      "mode": "build-time inline into dist/provision; no package dependency or peer declaration"
+    }
+  },
+  "sessionLogWrites": 0,
+  "historicalCandidateLicense": "UNLICENSED; no upstream-license inheritance or open-source grant asserted"
+}

package/docs/SECURITY.md

@@ -0,0 +1,52 @@
+# 安全与运行边界
+
+## 可信边界
+
+注册描述符、DSH bridge 与宿主代码可信；浏览器请求、应用 HTTP 内容、旧租约和磁盘错误不可信。浏览器不能传命令、argv、env、cwd、dataDir 或任意上游 URL。实际 HTTP 拒绝和负向测试见 acceptance。
+
+本实现**不是 OS 沙箱**。独立数据路径证明正常应用按配置写入隔离目录，不保证恶意的同 UID 本地程序不能访问其他文件、网络或自行调用 setsid。需要强隔离时应另行使用经过验收的 OS sandbox/container，本模块没有实现也没有宣称实现该能力。禁止 daemonizing 启动器；上游适配包必须验证应用使用所分配的 data/HOME/XDG 路径。
+
+## owned 与 attach
+
+每个 owned runtime 使用独立 guardian 及锚定进程组的 launcher。宿主 IPC 断开会触发 guardian 清理；清理仅对该精确子进程创建的进程组，绝不按名称匹配或复用磁盘 PID 发 kill。收到清理确认才发布 stopped。attach 无 guardian、无 kill 路径。
+
+主机断电、内核崩溃、存储损坏、恶意 daemon 脱离进程组不在此次证明范围。
+
+### runtime lock 的死主接管（rc.25）
+
+每个 owned 数据根下的 `.runtime.lock` 由 guardian 持有，记录 `{pid, start, id, children:[{pid,start,command,role,group}], port}`：`start` 是进程启动时间令牌（macOS/Linux 由 `ps -o lstart=` 或 `/proc/<pid>/stat` + boot_id 得到），`children` 是 guardian 自己创建的 launcher（进程组组长）与应用进程。launcher 在收到 launch 指令之前就已被记录，所以它还没机会派生任何东西时锁里已经有它。
+
+guardian 被强杀（桌面壳整棵树被 kill、`kill -9`）后，下一次 acquire 的判定顺序固定为：
+
+1. **owner 活着**（pid 存在且启动令牌一致，或旧格式无令牌但 pid 存在）→ `DATA_ROOT_BUSY`，`details = {pid, start, reason:'owner-alive', port}`，不发任何信号。
+2. **owner 死了**（pid 不存在，或同 pid 启动令牌不同 = pid 被复用）→ 逐个核对 `children`：
+   - pid 不存在、或启动令牌与记录不同（pid 被无关进程复用）→ 视为已消失，**不发信号**；
+   - pid + 启动令牌 + 可执行文件（realpath 比较）三者一致 → **可证明是我们的孤儿**，先 SIGTERM（进程组组长连同 `-pid` 组一起），等 `stopGraceMs`，再 SIGKILL，确认退出后接管；
+   - 活着但证明不了（记录或平台缺启动令牌、可执行文件不同）→ `DATA_ROOT_BUSY`，`details = {pid, pids, ownerPid, reason:'orphan-unproven', children}`，不发信号，锁原样保留。
+3. 接管仍走原有的 `.recovery` 独占标记序列化；损坏的锁文件依旧 `LOCK_RECOVERY_REQUIRED`，不自动删。
+
+Windows 与无 `ps` 的环境退化为只判 pid 存活：活着的进程永远无法被证明是我们的，只会 `DATA_ROOT_BUSY`，不会接管。绝不按进程名匹配，不 `pkill node`；人工维修时先看 `details.pid`。
+
+Linux 的 socket 所有权检查已实际运行；macOS lsof 路径未实测；Windows owned 在 spawn 前拒绝。平台声明不是跨平台验收。
+
+## 网关
+
+仅 `http://127.0.0.1:<显式端口>`，固定一个上游，不解析用户传入 target，不跟随 redirect，不接受 CONNECT 或绝对请求目标。只有携带当前租约 generation 能力 cookie 的请求可访问；bootstrap 限时单次票据要求指定父页面的 iframe 导航。直接顶层导航、未列名 Origin、过期/旧代能力拒绝。应用响应正文不改写，不注入 HTML、SDK 或 postMessage bridge。
+
+只删除 X-Frame-Options、将 CSP 的 frame-ancestors 设为一个 parent origin，保留其他 CSP 指令和应用头。HTTP hop-by-hop framing/连接由 Node 传输管理；不是网络原始报文字节镜像。bootstrap 是本模块自己的303响应，不冒称上游应用响应。真实浏览器 cookie/iframe 行为本环境被管理员策略拦截，所以不保证 H13 已全通过。
+
+DSH/宿主 cookie、控制头与 Authorization 默认不传上游；应用 cookie 必须逐名白名单，应用 Authorization 需要受信显式开启。父页和应用均在127.0.0.1时，浏览器 cookie 不是按端口隔离的，因此不把“不同端口”当作 cookie 安全边界。本网关的转发过滤只守住到上游这一跳，不能代替原应用正确设计自己的 cookie/auth。
+
+不更改原应用 Origin/CSRF/CORS；带严格自身 origin 校验或绝对 URL 的应用可能拒绝网关请求，必须如实报告并由适配器走受支持的配置，不得通过关掉应用安全策略解决。direct embedding 返回原上游 URL，沿用原应用自己的认证/框架限制，不具有 gateway 能力保护。
+
+## 日志与凭据
+
+日志有界、按完整行处理、Bearer/常见 token 字段及显式 secret env 值脱敏；超大行丢弃。此规则不可能识别任意业务敏感信息，默认不记录请求体/配置环境。leaseToken 原文只在回执中返回，磁盘保存哈希；工作台不得把 token 放进公开 URL、分析日志或应用 iframe。
+
+恢复凭据属于同一已认证 owner 的显式操作，要求 confirm:true，旋转 generation；真实 DSH bridge 的 authorize 必须对该路径落实授权。示例/测试的固定认证值绝不能作为真实 DSH 身份实现。
+
+## 浏览器测试限制
+
+实际 Chromium 启动于独立临时 profile，但回环导航返回 `net::ERR_BLOCKED_BY_ADMINISTRATOR`。未改管理员 policy、未关 CSP、未使用绕过标志。两个 REAL_BROWSER 测试显式 skip 并在产品矩阵标 PARTIAL，不算 PASS。
+
+测试 Chromium 的 `--no-sandbox` 仅为隔离容器内以 root 运行测试驱动所需，绝非生产应用/DSH 的启动配置；不应该移植到生产 profile。

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "@hanamesh/dsh-app-host",
+  "version": "0.2.0-rc.2",
+  "description": "HanaMesh application ownership, durable view leases, and application library for official DSH 0.2.0-rc.2",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yzsnstotz/hanamesh-plugin-app-host.git"
+  },
+  "engines": {
+    "node": ">=24.13.1 <25"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./dsh": {
+      "types": "./dist/dsh.d.ts",
+      "default": "./dist/dsh.js"
+    },
+    "./package.json": "./package.json",
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "node": "./dist/client.js",
+      "default": "./dist/client-ui.js"
+    },
+    "./client-ui": {
+      "types": "./dist/client-ui.d.ts",
+      "default": "./dist/client-ui.js"
+    }
+  },
+  "files": [
+    "dist",
+    "consistency.json",
+    "README.md",
+    "LICENSE",
+    "docs/CONTRACT.md",
+    "docs/DSH_INTEGRATION.md",
+    "docs/APP_PACKAGE.md",
+    "docs/LIBRARY.md",
+    "docs/SECURITY.md",
+    "docs/PROVENANCE.json",
+    "docs/LICENSES.json",
+    "schemas",
+    "profile"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "node --test --test-concurrency=1 tests/*.test.mjs",
+    "test:mutation": "node scripts/mutations.mjs",
+    "test:types": "tsc --noEmit --strict --target ES2022 --module NodeNext --moduleResolution NodeNext tests/consumer.mts",
+    "check": "npm run build && npm run check:consistency && npm test && npm run test:mutation",
+    "prepack": "npm run build",
+    "demo": "node examples/demo.mjs",
+    "preflight:dsh": "node scripts/preflight-dsh.mjs",
+    "check:consistency": "node scripts/check-consistency.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./profile/cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web",
+      "external": [
+        "react"
+      ]
+    }
+  },
+  "dependencies": {
+    "zod": "4.5.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
+    "react": "18.3.1"
+  },
+  "hanamesh": {
+    "module": "app-host",
+    "contractVersion": 1,
+    "dshTarget": "0.2.0-rc.2",
+    "upstreamFilesModified": 0
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session-persistence": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage-json": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "typescript": "5.8.3"
+  }
+}

package/profile/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+  - id: hanamesh-app-host
+    name: '@hanamesh/dsh-app-host'
+    config: {}