@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.
- package/AGENTS.md +4 -3
- package/CHANGELOG.md +39 -0
- package/README.md +7 -5
- package/docs/ARCHITECTURE.md +2 -1
- package/docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md +29 -22
- package/docs/methodology/README.md +1 -0
- package/docs/methodology/execution/PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md +136 -0
- package/docs/methodology/execution/README.md +1 -0
- package/docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md +71 -0
- package/docs/methodology/pointers/HARNESS_HAT_CHAIN_V2_ONEPAGER_v1_zh.md +31 -0
- package/docs/methodology/pointers/README.md +1 -0
- package/docs/methodology/pointers/SDD_HAT_FLOW_v1_zh.md +5 -4
- package/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md +100 -47
- package/docs/methodology/product/README.md +2 -1
- package/docs/methodology/product/SDD_HAT_FLOW_v2_zh.md +78 -0
- package/graph/templates/00_main.graph.yaml +72 -0
- package/graph/templates/00_main.md +53 -40
- package/graph/templates/02_version.md +6 -0
- package/graph/templates/10_flow_MAIN.graph.yaml +105 -0
- package/graph/templates/10_flow_MAIN.md +80 -38
- package/graph/templates/99_mermaid_protocol.md +39 -20
- package/graph/templates/README.md +37 -12
- package/harness/prompts/10-requirements.md +3 -1
- package/harness/prompts/22-task-audit.md +3 -1
- package/harness/prompts/30-execute-code.md +2 -1
- package/harness/prompts/40-self-check.md +7 -4
- package/harness/prompts/README.md +31 -22
- package/ontology.yaml +27 -7
- package/package.json +1 -1
- package/wizard/ONBOARDING_wizard_v1_zh.md +2 -1
- package/wizard/guides/GUIDE_new_project_bootstrap_v1_zh.md +158 -0
- package/graph/templates/00_main.ai.md +0 -28
- 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
|
-
```
|