create-windy 0.3.16 → 0.3.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +14 -36
  2. package/dist/cli.js +1831 -3178
  3. package/package.json +1 -1
  4. package/template/.windy-template.json +2 -2
  5. package/template/AGENTS.md +7 -1
  6. package/template/README.md +8 -11
  7. package/template/apps/agent-server/Dockerfile +2 -1
  8. package/template/apps/agent-server/README.md +13 -5
  9. package/template/apps/agent-server/adk_web_agents/canonical_debug/__init__.py +1 -0
  10. package/template/apps/agent-server/adk_web_agents/canonical_debug/agent.py +125 -0
  11. package/template/apps/agent-server/project/adk-web-debug.json +4 -0
  12. package/template/apps/agent-server/src/southwind_agent_server/adk_debug.py +315 -0
  13. package/template/apps/agent-server/tests/test_adk_web_canonical_debug.py +235 -0
  14. package/template/apps/server/Dockerfile +1 -1
  15. package/template/apps/server/src/agent/run-debug-authorization.ts +27 -0
  16. package/template/apps/server/src/agent/run-facade-adk-debug.test.ts +56 -0
  17. package/template/apps/server/src/agent/run-facade.test-support.ts +235 -0
  18. package/template/apps/server/src/agent/run-facade.test.ts +8 -244
  19. package/template/apps/server/src/agent/run-facade.ts +23 -48
  20. package/template/apps/server/src/agent/run-operation-registry.ts +51 -0
  21. package/template/apps/server/src/agent/runtime-bootstrap.ts +5 -2
  22. package/template/apps/server/src/agent/tool-audit.ts +3 -0
  23. package/template/apps/server/src/agent/tool-registry.test.ts +29 -0
  24. package/template/apps/server/src/application-services.ts +83 -15
  25. package/template/apps/server/src/audit/contracts.ts +8 -0
  26. package/template/apps/server/src/audit/recovery-queue.test.ts +48 -1
  27. package/template/apps/server/src/audit/recovery-queue.ts +73 -4
  28. package/template/apps/server/src/audit/reliable-writer.test.ts +120 -2
  29. package/template/apps/server/src/audit/reliable-writer.ts +98 -34
  30. package/template/apps/server/src/guards.ts +16 -0
  31. package/template/apps/server/src/index.ts +23 -20
  32. package/template/apps/server/src/jobs/legacy-adapter.integration.test.ts +0 -1
  33. package/template/apps/server/src/jobs/legacy-adapter.test.ts +6 -0
  34. package/template/apps/server/src/jobs/legacy-service-runtime.ts +18 -0
  35. package/template/apps/server/src/module-host/durable-context-unavailable.test.ts +84 -0
  36. package/template/apps/server/src/module-host/durable-context.test.ts +14 -0
  37. package/template/apps/server/src/module-host/durable-context.ts +17 -15
  38. package/template/apps/server/src/module-host/request-context.test.ts +30 -1
  39. package/template/apps/server/src/module-host/request-context.ts +15 -2
  40. package/template/apps/server/src/module-host/storage-port.ts +1 -1
  41. package/template/apps/server/src/platform-bootstrap.ts +16 -0
  42. package/template/apps/server/src/runtime-adk-debug.test.ts +246 -0
  43. package/template/apps/server/src/runtime-adk-debug.ts +158 -0
  44. package/template/apps/server/src/runtime-request-actor.test.ts +55 -0
  45. package/template/apps/server/src/runtime-request-actor.ts +22 -0
  46. package/template/apps/server/src/runtime.test.ts +3 -0
  47. package/template/apps/server/src/runtime.ts +36 -3
  48. package/template/apps/server/src/scheduler/definitions.test.ts +16 -0
  49. package/template/apps/web/Dockerfile +1 -1
  50. package/template/docker-compose.agent-debug.yml +56 -0
  51. package/template/docker-compose.yml +1 -39
  52. package/template/docs/architecture/ai-runtime.md +14 -5
  53. package/template/docs/architecture/module-manifest-composition.md +14 -0
  54. package/template/docs/development/custom-login-page.md +2 -16
  55. package/template/docs/platform/agent-runtime.md +57 -16
  56. package/template/docs/platform/agent-tool-sandbox.md +4 -3
  57. package/template/docs/platform/audit-reliability.md +33 -5
  58. package/template/docs/platform/platform-authentication.md +9 -1
  59. package/template/package.json +4 -3
  60. package/template/packages/database/drizzle/0043_activate_agent_dependencies.sql +196 -0
  61. package/template/packages/database/drizzle/meta/0043_snapshot.json +8335 -0
  62. package/template/packages/database/drizzle/meta/_journal.json +7 -0
  63. package/template/packages/database/src/schema-notification-delivery.test.ts +15 -6
  64. package/template/packages/database/src/schema-workflow-notification.test.ts +44 -29
  65. package/template/scripts/dev-adk-web.ts +107 -0
package/README.md CHANGED
@@ -68,10 +68,9 @@ npx create-windy@latest my-dashboard \
68
68
  为离线部署提供运行时验签与限制态。
69
69
 
70
70
  选择 `system.license` 时,Server 与 Web 通过 npm 依赖
71
- `@southwind-ai/license@^0.1.1` 使用运行时能力;生成项目及 `create-windy` 模板快照都不包含
72
- `packages/license-sdk` 源码。公网 npm 已发布兼容的 `@southwind-ai/license@0.1.2`;
73
- 发布包含该模块的新版创建器前,必须先确认目标 registry 中存在兼容版本,并完成真实
74
- 安装回归。
71
+ `@southwind-ai/license@^0.1.5` 使用运行时能力;生成项目及 `create-windy` 模板快照都
72
+ 不包含 `packages/license-sdk` 源码。发布包含该模块的新版创建器前,必须先确认目标
73
+ registry 中存在该版本,并完成真实安装回归。
75
74
 
76
75
  未选择的模块会从 package、源码、依赖、Composition、Manifest、schema、migration
77
76
  和模块文档中物理排除,而不是只隐藏菜单或关闭 Feature。模块依赖会自动补齐;未知
@@ -130,40 +129,19 @@ bun run windy sync-docker
130
129
  bun run windy update --check
131
130
  bun run windy update --dry-run
132
131
  bun run windy update
133
- bun run windy reconcile --to <精确目标版本>
134
132
  ```
135
133
 
136
- 更新器不检查 Git 工作区是否干净:只规划目标版本实际变更的受管文件,从 npm 历史
137
- artifact 重建 Base,并以 Base/Ours/Theirs 合并共享脚手架。未触及的业务修改不会进入
138
- 更新判断;`package.json` 使用字段级合并;已发布 migration 只允许追加;冲突发生时不写
139
- 项目,验证失败则从 `.windy/backups/` 自动回滚。项目锁定
140
- 的 CLI 检测到新版后,会委托给目标版本生成完整更新计划。受管清单 schema v3 用不含
141
- hash 的 missing tombstone 记住客户删除的 `project-owned` 路径;后续版本不会把它
142
- 当作首次新增而重建,客户自行恢复文件后则采纳客户实际正文基线。既有 schema v1/v2
143
- 仍可读取,未知或损坏状态会 fail closed。
144
-
145
- 当发布说明明确指出历史受管清单与确定性格式化结果不一致时,可使用
146
- `reconcile --to <精确目标版本>`。该命令默认只演练;显式增加 `--apply` 后也只更新
147
- `.windy/files.json` 和无正文报告,不修改项目源码或推进 Project Lock。来源/目标均
148
- 校验公网 npm artifact identity 与 integrity,只有内置不可变 proof 完整命中的
149
- `windy-managed` 文件可以对账;`shared-scaffold` 也必须精确命中内置 proof,
150
- `project-owned` 和未知语义差异保持未决。对账不修改项目源码;中断仍通过
151
- `doctor --repair` 恢复事务。
152
-
153
- 公网 `0.3.0` 的默认 Git + Oxc 项目需要先运行
154
- `create-windy@0.3.2 reconcile --to 0.3.0`,确认后增加 `--apply`,提交生成的清单和
155
- 报告,再运行 `create-windy@0.3.2 update --to 0.3.2`。这里的同版本目标是为了同时
156
- 校验来源与目标均为同一个不可变 `0.3.0` artifact,不会把 Project Lock 提前推进。
157
-
158
- 公网 `0.2.34` 的默认推荐模块项目也先对账到 `0.3.0`。该 profile 只有在 Project
159
- Lock、Oxfmt 配置、manifest 与来源 artifact 哈希全部精确命中时才启用专属 proof;
160
- 未知 formatter 输出继续保持未决。当前公网默认项目实测为 12 个可证明、0 个未决,
161
- 而非默认的 sharp-sword 仍为 5 个可证明、2 个未决。
162
-
163
- 发布后隔离回归确认全新 `0.3.2` 默认 Git/Oxc 项目 doctor 为 `0/0`。真实
164
- `0.2.34` 经 `12/0` 对账和 `160` 文件、`0` 冲突更新后,真实 `0.3.0` 经
165
- `81/2` 对账和 `30` 文件、`0` 冲突更新后,均完成正常 Husky/Oxfmt 提交并最终
166
- 收敛到 Git 干净、doctor `0/0`。
134
+ `0.3.17` 是 Starter 更新的最低支持基线。更新器不检查 Git 工作区是否干净:只规划
135
+ 目标版本实际变更的受管文件,从 source Project Lock 指向的精确 npm artifact 重建
136
+ Base,并以 Base/Ours/Theirs 合并共享脚手架。未触及的业务修改不会进入更新判断;
137
+ `package.json` 使用字段级合并;已发布 migration 只允许追加;冲突发生时不写项目,
138
+ 验证失败则从 `.windy/backups/` 自动回滚。项目锁定的 CLI 检测到新版后,会委托给
139
+ 目标版本生成完整更新计划。
140
+
141
+ 受管清单使用 schema v4:`hash` 冻结下游实际正文,`artifactHash` 在两者不同时记录
142
+ 公开模板基线;无正文的 missing tombstone 记住客户删除的 `project-owned` 路径。
143
+ 低于 `0.3.17` 的 Project Lock、旧清单 schema、损坏的 artifact lineage 或 recipe
144
+ 缺口都会在写文件前 fail closed,不提供旧状态的自动迁移路径。
167
145
 
168
146
  本地 Web 默认使用 8746;如果该端口属于其它服务,会自动尝试 8747、8748 等端口。
169
147
  如果检测到同一个项目已启动,则直接复用现有地址。