@cyning/harness 2.0.3 → 2.1.0

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 (33) hide show
  1. package/AGENTS.md +4 -3
  2. package/CHANGELOG.md +39 -0
  3. package/README.md +7 -5
  4. package/docs/ARCHITECTURE.md +2 -1
  5. package/docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md +29 -22
  6. package/docs/methodology/README.md +1 -0
  7. package/docs/methodology/execution/PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md +136 -0
  8. package/docs/methodology/execution/README.md +1 -0
  9. package/docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md +71 -0
  10. package/docs/methodology/pointers/HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md +31 -0
  11. package/docs/methodology/pointers/README.md +1 -0
  12. package/docs/methodology/pointers/SDD_HAT_FLOW_v1_zh.md +5 -4
  13. package/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md +100 -47
  14. package/docs/methodology/product/README.md +2 -1
  15. package/docs/methodology/product/SDD_HAT_FLOW_v2_zh.md +78 -0
  16. package/graph/templates/00_main.graph.yaml +72 -0
  17. package/graph/templates/00_main.md +53 -40
  18. package/graph/templates/02_version.md +6 -0
  19. package/graph/templates/10_flow_MAIN.graph.yaml +105 -0
  20. package/graph/templates/10_flow_MAIN.md +80 -38
  21. package/graph/templates/99_mermaid_protocol.md +39 -20
  22. package/graph/templates/README.md +37 -12
  23. package/harness/prompts/10-requirements.md +3 -1
  24. package/harness/prompts/22-task-audit.md +3 -1
  25. package/harness/prompts/30-execute-code.md +2 -1
  26. package/harness/prompts/40-self-check.md +7 -4
  27. package/harness/prompts/README.md +31 -22
  28. package/ontology.yaml +27 -7
  29. package/package.json +1 -1
  30. package/wizard/ONBOARDING_wizard_v1_zh.md +2 -1
  31. package/wizard/guides/GUIDE_new_project_bootstrap_v1_zh.md +158 -0
  32. package/graph/templates/00_main.ai.md +0 -28
  33. package/graph/templates/10_flow_MAIN.ai.md +0 -43
@@ -1,28 +0,0 @@
1
- ```mermaid
2
- flowchart TD
3
- %% version: YYYY-MM-DD — AI 协议版 · 须与 00_main.md 语义等价
4
- %% 拓扑:见 99_mermaid_protocol.md
5
-
6
- %% === 入口阶段 ===
7
- Q[[用户 / 客户端请求]] --"->"--> E{"应用入口"}
8
- // → src/main.py#L1 或 app/router/index.ts#L1(替换为真实锚点)
9
-
10
- %% === 主业务分支 ===
11
- E --"主路径 A"--> M1[[核心业务处理]]
12
- // → 例:handlers/resource.py::handle_create
13
- E --"主路径 B"--> M2[[次要路径]]
14
- // → 例:handlers/health.py::health_check
15
- E --"管理/批处理"--> ADM[[Admin / Job]]
16
- // → 例:jobs/ingest.py::run_sync
17
-
18
- %% === 子流程折叠 ===
19
- M1 --"::triggers"--> FLOW_MAIN[[主路径子流程]]
20
- FLOW_MAIN --"加载"--> FLOW_DOC[>10_flow_MAIN.md]
21
-
22
- M1 --"->"--> DB[(持久化)]
23
- // → 例:db/repository.py 或 ORM 层
24
- ADM --"->"--> DB
25
-
26
- %% === 按需加载(可选)===
27
- E --"加载"--> STRUCT_DOC[>01_struct.md]
28
- ```
@@ -1,43 +0,0 @@
1
- ```mermaid
2
- flowchart TD
3
- %% Entry: 例 POST /api/v1/resource — 替换锚点为真实代码
4
- %% 拓扑协议:见 99_mermaid_protocol.md
5
-
6
- %% === 请求阶段 ===
7
- IN[[HTTP 请求]] --"->"--> AUTH[[鉴权 / 会话校验]]
8
- // → middleware/auth.py::require_user 或 src/auth/guard.ts
9
-
10
- AUTH --"[ok]"--> VAL[[参数校验]]
11
- AUTH --"[err]"--> ERR_AUTH[>Auth Failed]
12
- // → middleware/auth.py#L42
13
-
14
- VAL --"[ok]"--> SVC[[业务服务层]]
15
- // → services/resource_service.py::handle
16
- VAL --"[err]"--> ERR_VAL[>Validation Failed]
17
-
18
- %% === 数据阶段 ===
19
- SVC --"->"--> REPO[[仓储 / ORM]]
20
- // → repositories/resource_repo.py::find_by_id
21
-
22
- REPO --"->"--> DB[(数据库 / 存储)]
23
- // → db/session.py 或 ORM model
24
-
25
- REPO --"?>"--> HIT{record exists?}
26
- HIT --"[no]"--> NOTFOUND[[404 / 空结果]]
27
- HIT --"[yes]"--> SVC
28
-
29
- SVC --"[err]"--> BIZERR[[4xx 业务错误]]
30
- // → services/resource_service.py 业务规则分支
31
-
32
- %% === 响应阶段 ===
33
- SVC --"->"--> RESP[[组装响应 DTO]]
34
- RESP --"->"--> OUT[[返回 JSON / 页面]]
35
- // → handlers/resource.py::to_response
36
-
37
- %% === 归档 ===
38
- OUT --"::archives"--> LOG[[结构化日志]]
39
- // → observability/logger.py
40
-
41
- %% === 顶层链接 ===
42
- IN --"加载"--> MAIN_DOC[>00_main.md]
43
- ```