feat(l1): keep native services and expose tasktree

2026-07-19 05:52:02 +02:00
parent e8864d24b3
commit 21d26688b7
5 changed files with 34 additions and 2 deletions
@@ -50,6 +50,10 @@ description: >-
  - 禁止用命令行覆盖、临时环境变量或隐藏 fallback 形成第二端口真相。
 - 固定端口、bind/probe、固定 HTTPS origin、状态目录和服务组成必须由 YAML-first 配置解析；代码和命令行不得补隐式默认值。
 - L1 API、Worker、Temporal 开发依赖和 Web 的启动、停止、重启、状态、日志必须由项目 CLI 管理；`npm run`、`bun run`、`vite` 或裸脚本只允许作为 CLI 的内部实现，不是用户操作入口。
+- 通过项目 lifecycle 启动的 L1 服务在测试和验收后默认保持运行：
+  - 只有用户明确要求停止或清理时才执行 stop；
+  - 一次性 disposable smoke 可以按自身隔离合同清理，但不能替代可持续访问的 L1 服务；
+  - 任务结束前必须重新读取 lifecycle status，不能凭启动返回值推断服务仍在运行。
 - CLI 显式使用项目 native `--over-api` transport，经 native API 调用 Worker。
 - Web 使用 `$unidesk-webdev` 的 `web-probe native-readiness` 从 owning YAML 固定 HTTPS origin 访问 native Web。
 - 微服务项目只启动当前微服务的前端、API、Worker及必要依赖。
@@ -67,6 +71,10 @@ description: >-
  - 公网配置随正常 `master` merge 由唯一 PaC authority 自动收敛；
  - 自动链未收敛时使用 `$unidesk-cicd` 只读归因，不由 L1 会话补写。
 - L1 验收命令必须实际从固定 HTTPS origin 打开页面和 API；本机 `127.0.0.1`/`localhost` 只可作为进程健康 probe，不构成 L1 证据。
+- 涉及 L1 的任务在结束时必须报告公网入口：
+  - 报告 owning YAML 声明的固定 HTTP/HTTPS origin 和当前可用状态；
+  - 存在页面路径时同时报告可直接访问的完整 URL；
+  - 公网入口未就绪时明确报告 blocker，禁止用 localhost、IP、bind 地址或裸端口冒充公网入口。
 - 执行任何 L1 流程时必须扫描当前项目已声明的 L1：
  - 发现历史 L1 尚未配置固定 HTTPS exposure 时，立即建立可追踪记录；
  - 发现一例就完成该实例的 YAML-first exposure、受控部署和原入口验收；
@@ -123,8 +123,8 @@ bun run tasktree:native:status
  - 修改前端时复用现有 HMR 与 API 进程；
  - 不触发镜像构建或 Kubernetes rollout。
 - native 进程使用独立 PID、日志和 state 目录：
-  - 开发期间允许持续复用；
-  - 完成或失败后必须停止并清理临时目录。
+  - 验收后是否保持运行及任务结束公网 URL 报告统一遵循 `$unidesk-devlevel`；
+  - 一次性 disposable smoke 继续按自身隔离合同清理。

 ## 部署态 CLI 验收

@@ -109,6 +109,7 @@ description: UniDesk Web 开发与受控浏览器验证技能。用户提到 Web
  - 页头高度预算、状态底栏和主体占比的默认判定见 [references/design.md](references/design.md)；
  - 历史页面按风险逐步迁移，新页面和重设计页面必须直接采用该合同。
 - L1 公网调试入口交给用户前必须完成浏览器 readiness 验收：
+  - L1 服务的验收后保留与任务结束公网 URL 报告统一遵循 `$unidesk-devlevel`，本 skill 不重复定义生命周期；
  - 使用 `bun scripts/cli.ts web-probe native-readiness --node <node> --lane <lane> --profile <profile>` 一次完成验收；
  - 固定 HTTPS origin、path、DOM、交互和失败判据只从 owning YAML 读取，禁止用 `--url` 或 `--origin` 覆盖；
  - 监听成功、端口可达、HTTP 200、API smoke 或源码测试通过都不能单独判定 L1 可用；