@hap-labs/human-agent-paradigm 0.1.0 → 0.2.1

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 (18) hide show
  1. package/README.md +19 -45
  2. package/assets/EN/CONFORMANCE_CHECKLIST.md +156 -161
  3. package/assets/EN/CONTRACT_TEMPLATE.md +108 -112
  4. package/assets/EN/DECISION_REQUEST_TEMPLATE.md +76 -81
  5. package/assets/EN/DELIVERY_REPORT_TEMPLATE.md +103 -83
  6. package/assets/EN/DERIVED_SPECIFICATION.md +73 -76
  7. package/assets/EN/HUMAN_AGENT_PARADIGM.md +26 -30
  8. package/docs/ZH_CN/README.md +30 -0
  9. package/package.json +7 -16
  10. package/CHANGELOG.md +0 -21
  11. package/README.zh-CN.md +0 -52
  12. package/scripts/python/repo_governance_check/__init__.py +0 -3
  13. package/scripts/python/repo_governance_check/__main__.py +0 -6
  14. package/scripts/python/repo_governance_check/checks.py +0 -359
  15. package/scripts/python/repo_governance_check/cli.py +0 -115
  16. package/scripts/python/repo_governance_check/config.py +0 -33
  17. package/scripts/python/repo_governance_check/governance_check_config.json +0 -166
  18. package/scripts/python/repo_governance_check/report.py +0 -79
package/assets/EN/DELIVERY_REPORT_TEMPLATE.md CHANGED
@@ -1,47 +1,43 @@
1
1
  # Delivery Report Template (execution layer)
2
2
 
3
- > English translation of the frozen document `DELIVERY_REPORT_TEMPLATE.md`. The Simplified Chinese original is
4
- > authoritative for governance and is the signing copy; this English copy is provided for agent reading, understanding,
5
- > and reference. Version markers mirror the original (v1.0). The checklist reference points to
6
- > `CONFORMANCE_CHECKLIST.md`
7
- > (v1.0) in this English copy.
8
-
9
3
  Version: v1.0
10
4
  Hierarchy: constitution `HUMAN_AGENT_PARADIGM.md` v1.0 → derived specification `DERIVED_SPECIFICATION.md` v1.0 → this
11
5
  template
12
- Status: execution-layer template · produced with the Owner's authorization
13
- Applicable scope: P7 delivery and acceptance; submitted as part of the delivery units together with the product,
14
- evidence package, and reusable assets
6
+ Status: execution-layer template · produced under the Owner's authorization
7
+ Applicable scope: P7 delivery and acceptance; submitted as part of the delivery units together with the product, the
8
+ evidence package, and the reusable assets
15
9
 
16
- ## Usage Rules
10
+ ## Usage rules
17
11
 
18
- 1. This report is the index of the evidence package and the contract-comparison statement — **not proof of
19
- conformance**; conformance rests on independently verifiable evidence (constitution 9.2).
20
- 2. Any "completed/achieved/passed" wording must point to an evidence ID; conclusions without evidence IDs must not
12
+ 1. This report is an index of the evidence package and a contract-comparison statement — **not proof of conformance**;
13
+ conformance rests on independently verifiable evidence (constitution 9.2).
14
+ 2. Any "completed/achieved/passed" wording must point to an evidence ID; conclusions without an evidence ID must not
21
15
  appear.
22
- 3. Incomplete work, failures, and unmet standards must be listed explicitly; vague wording such as "basically done",
23
- "almost", or "should work" is forbidden.
24
- 4. The acceptance recommendation is only the Agent's self-check conclusion and is not acceptance evidence; the human
25
- verifies independently per the contract and then signs.
26
- 5. Before submission, execute《Conformance Self-Check Checklist》v1.0 and attach the results into section 7.
16
+ 3. Incomplete work, failure, and unmet standards must be listed explicitly; vague wording such as "basically done",
17
+ "almost", "should work" is forbidden.
18
+ 4. The acceptance recommendation is only the Agent's self-check conclusion and does not constitute acceptance evidence;
19
+ the human verifies independently against the contract before signing.
20
+ 5. Before submission, run the Conformance Self-Check Checklist v1.0 and attach its result in Section 7.
27
21
 
28
22
  ---
29
23
 
30
24
  ## 1. Metadata
31
25
 
32
- | Field | Content |
33
- |:--------------------------|:--------------------------------|
34
- | Delivery ID | |
35
- | Contract ID / version | |
36
- | Product/task name | |
37
- | Delivery report version | |
38
- | Delivery time | |
39
- | Checklist version | `CONFORMANCE_CHECKLIST.md` v1.0 |
40
- | Evidence package location | |
41
- | Product location | |
42
- | Asset location | |
26
+ | Field | Content |
27
+ |:-----------------------------|:--------------------------------|
28
+ | Delivery ID | |
29
+ | Contract ID / version | |
30
+ | Product/task name | |
31
+ | Delivery-report version | |
32
+ | Delivery time | |
33
+ | Self-check-checklist version | `CONFORMANCE_CHECKLIST.md` v1.0 |
34
+ | Evidence-package location | |
35
+ | Product location | |
36
+ | Asset location | |
37
+
38
+ ---
43
39
 
44
- ## 2. Delivery Units List
40
+ ## 2. Delivery-Units List
45
41
 
46
42
  | Category | Content | Location/link |
47
43
  |:-----------------|:------------|:--------------|
@@ -50,15 +46,19 @@ evidence package, and reusable assets
50
46
  | Reusable assets | | |
51
47
  | Delivery report | this report | |
52
48
 
53
- ## 3. Contract Comparison Master Table
49
+ ---
54
50
 
55
- | Contract clause ID | Contract criterion/deliverable | Evidence ID | Review method | Conclusion |
51
+ ## 3. Contract-Comparison Master Table
52
+
53
+ | Contract-clause ID | Contract criterion/deliverable | Evidence ID | Review method | Conclusion |
56
54
  |:-------------------|:-------------------------------|:------------|:--------------|:------------------|
57
55
  | C2-S1 | | | | `Met` / `Not met` |
58
56
  | C4-1 | | | | |
59
57
  | C5-E6.x | | | | |
60
58
 
61
- **Rules:** conclusions may only be `Met` / `Not met`; `Met` must be checkable by a third party from the evidence.
59
+ **Rules:** the conclusion may only be `Met` / `Not met`; `Met` must be checkable by a third party from the evidence.
60
+
61
+ ---
62
62
 
63
63
  ## 4. Reliability Evidence
64
64
 
@@ -86,11 +86,13 @@ evidence package, and reusable assets
86
86
  |:----|:------------------------|:-------|:---------|:------------|
87
87
  | | | | | |
88
88
 
89
- **Statement:** none of the incomplete items above is presented as complete elsewhere in this delivery report.
89
+ **Statement:** none of the incomplete items above is described as complete anywhere else in this delivery report.
90
90
 
91
- ## 5. Excellence Evidence (per dimension)
91
+ ---
92
+
93
+ ## 5. Excellence Evidence (five dimensions, item by item)
92
94
 
93
- | Dimension | Contract criterion ID | Judgment | Evidence ID | Third-party review method |
95
+ | Dimension | Contract-criterion ID | Judgment | Evidence ID | Third-party review method |
94
96
  |:---------------------------|:----------------------|:------------------|:------------|:--------------------------|
95
97
  | 6.1 Sound design | | `Met` / `Not met` | | |
96
98
  | 6.2 Complete functionality | | | | |
@@ -98,91 +100,109 @@ evidence package, and reusable assets
98
100
  | 6.4 Perfect experience | | | | |
99
101
  | 6.5 Excellent performance | | | | |
100
102
 
101
- **Rules:** none of the five dimensions may be missing; outstanding performance on one dimension does not offset failure
103
+ **Rules:** none of the five dimensions may be missing; outstanding performance on one dimension must not offset failure
102
104
  on another.
103
105
 
106
+ ---
107
+
104
108
  ## 6. Multi-View Review and Defects
105
109
 
106
110
  ### 6.1 Review records
107
111
 
108
- | Perspective | Review standpoint | Defect-finding method | Counterexamples/paths attempted | Problems found | Record ID |
109
- |:------------|:------------------|:----------------------|:--------------------------------|:---------------|:----------|
110
- | Product | | | | | |
111
- | User | | | | | |
112
- | Engineering | | | | | |
113
- | Adversarial | | | | | |
112
+ | Perspective | Review standpoint | Defect-finding method | Counterexamples/paths tried | Problems found (count) | Record ID |
113
+ |:------------|:------------------|:----------------------|:----------------------------|:-----------------------|:----------|
114
+ | Product | | | | | |
115
+ | User | | | | | |
116
+ | Engineering | | | | | |
117
+ | Adversarial | | | | | |
114
118
 
115
119
  ### 6.2 Defect list
116
120
 
117
- | Defect ID | Severity | In/out of contract scope | Handling | Re-verification evidence ID | Status |
121
+ | Defect ID | Grade | In/out of contract scope | Handling | Re-verification evidence ID | Status |
118
122
  |:----------|:--------------------|:-------------------------|:---------|:----------------------------|:--------------------------------|
119
123
  | | Blocker/Major/Minor | | | | `Closed` / `Moved out of scope` |
120
124
 
121
- **Exit judgment:** all in-contract defects closed; defects moved out of scope were human-approved and are explicitly
122
- disclosed here (never silently hidden).
125
+ **Exit judgment:** all in-contract defects closed; defects moved out of scope were approved by the human and are
126
+ explicitly disclosed here (not silently hidden).
123
127
 
124
- ## 7. Conformance Self-Check Results
128
+ ---
129
+
130
+ ## 7. Conformance Self-Check Result
125
131
 
126
- | Item | Result |
127
- |:-------------------------------------------------|:-------|
128
- | Checklist version | |
129
- | Groups A–I items total / passed / not applicable | |
130
- | ★ hard items total / passed | |
131
- | Non-conformances and rectification evidence | |
132
- | Paradigm-level group J (applicable / passed) | |
132
+ | Item | Result |
133
+ |:---------------------------------------------------|:-------|
134
+ | Self-check-checklist version | |
135
+ | Groups A–I total items / passed / not applicable | |
136
+ | ★ hard items total / passed | |
137
+ | Non-conformances and remediation evidence | |
138
+ | Paradigm-level group J (applicable / passed count) | |
133
139
 
134
- **Statement:** passing self-check is only the Agent's self-check conclusion and is not proof of conformance; final
135
- conformance rests on behavior and results, evidenced by independently verifiable records.
140
+ **Statement:** passing the self-check is only the Agent's self-check conclusion and is not proof of conformance; final
141
+ conformance rests on behavior and results, evidenced by independently verifiable evidence.
142
+
143
+ ---
136
144
 
137
145
  ## 8. Asset Deposition
138
146
 
139
- | Asset ID | Type | Source | Verification evidence | Owner | Usage authorization scope |
140
- |:---------|:--------------------------------------|:-------|:----------------------|:----------|:--------------------------|
141
- | | preference/criterion/component/lesson | | | the human | |
147
+ | Asset ID | Type | Source | Verification evidence | Owner | Usage-authorization scope |
148
+ |:---------|:--------------------------------------|:-------|:----------------------|:------|:--------------------------|
149
+ | | preference/criterion/component/lesson | | | human | |
150
+
151
+ ---
142
152
 
143
- ## 9. Cost Ledger Summary
153
+ ## 9. Cost-Ledger Summary
144
154
 
145
- | Cost item | Budget | Actual | Variance note |
146
- |:-------------------------------------------|:-------|:-------|:--------------|
147
- | Human attention (decisions/waiting/rework) | | | |
148
- | Agent consumption | | | |
149
- | Rework | | | |
150
- | Error and delay costs | | | |
155
+ | Cost item | Budget | Actual | Variance note |
156
+ |:---------------------------------------------------------|:-------|:-------|:--------------|
157
+ | Human attention (number of decisions / waiting / rework) | | | |
158
+ | Agent consumption | | | |
159
+ | Rework | | | |
160
+ | Error and delay costs | | | |
161
+
162
+ ---
151
163
 
152
164
  ## 10. Safety and Compliance
153
165
 
154
- | Check item | Result | Evidence ID |
155
- |:--------------------------------------------|:-------|:------------|
156
- | Safety/compliance risk identification | | |
157
- | Risk handling/escalation | | |
158
- | Bottom-line violation record (must be zero) | | |
159
- | Residual-risk disclosure | | |
166
+ | Check item | Result | Evidence ID |
167
+ |:----------------------------------------|:-------|:------------|
168
+ | Safety/compliance risk identification | | |
169
+ | Risk handling/escalation | | |
170
+ | Bottom-line violations (should be zero) | | |
171
+ | Residual-risk disclosure | | |
172
+
173
+ ---
160
174
 
161
- ## 11. Known Boundaries and Incomplete-Item Statement
175
+ ## 11. Known Boundaries and Incomplete-Item Notes
162
176
 
163
- **List all boundaries, incomplete items, and moved-out-of-scope items explicitly — no hiding or blurring:**
177
+ **List explicitly all boundaries, incomplete items, and moved-out-of-scope items; no hiding or blurring:**
178
+
179
+ ---
164
180
 
165
181
  ## 12. Acceptance Recommendation (self-check conclusion only)
166
182
 
167
183
  | Item | Content |
168
184
  |:-----------------------|:---------------------------------------------------------------------------------------------|
169
185
  | Recommended conclusion | `Recommend acceptance` / `Do not recommend acceptance` |
170
- | Basis | item-by-item comparison results of sections 3, 4, 5, 6, 7 |
186
+ | Basis | item-by-item comparison results of Sections 3, 4, 5, 6, 7 |
171
187
  | Nature statement | this recommendation is only the Agent's self-check conclusion and is not acceptance evidence |
172
188
 
189
+ ---
190
+
173
191
  ## 13. Signature and Acceptance
174
192
 
175
- | Role | Action | Signature | Time |
176
- |:-------------------------|:-------------------------------------------------------------------------------------------|:----------|:-----|
177
- | Agent delivering | warrant the report content matches the evidence package and nothing un-happened is claimed | | |
178
- | Independent review | re-check section 3 matrix against the evidence package | | |
179
- | Human (Owner) acceptance | accept and sign the conclusion per the contract | | |
193
+ | Role | Action | Signature | Time |
194
+ |:-----------------------|:--------------------------------------------------------------------------------------------------|:----------|:-----|
195
+ | Agent delivered | guarantees the report content matches the evidence package and claims nothing that did not happen | | |
196
+ | Independent review | reviews the Section 3 matrix against the evidence package | | |
197
+ | Human (Owner) accepted | accepts and signs the conclusion per the contract | | |
180
198
 
181
199
  **Acceptance conclusion:** `Pass` / `Fail`
182
200
  **Acceptance basis and time:**
183
201
 
202
+ ---
203
+
184
204
  ## Appendix: Traceability Matrix
185
205
 
186
- | Constitutional clause | Derived spec | Contract clause | Evidence ID | Conclusion |
187
- |:----------------------|:-------------|:----------------|:------------|:-----------|
188
- | | | | | |
206
+ | Constitutional clause | Derived specification | Contract clause | Evidence ID | Conclusion |
207
+ |:----------------------|:----------------------|:----------------|:------------|:-----------|
208
+ | | | | | |