@hap-labs/human-agent-paradigm 0.1.0 → 0.2.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 (19) hide show
  1. package/CHANGELOG.md +2 -15
  2. package/README.md +18 -44
  3. package/README.zh-CN.md +5 -27
  4. package/assets/EN/CONFORMANCE_CHECKLIST.md +156 -161
  5. package/assets/EN/CONTRACT_TEMPLATE.md +108 -112
  6. package/assets/EN/DECISION_REQUEST_TEMPLATE.md +76 -81
  7. package/assets/EN/DELIVERY_REPORT_TEMPLATE.md +103 -83
  8. package/assets/EN/DERIVED_SPECIFICATION.md +73 -76
  9. package/assets/EN/HUMAN_AGENT_PARADIGM.md +26 -30
  10. package/assets/EN/TRANSLATION_GLOSSARY.md +79 -0
  11. package/assets/ZH_CN/TRANSLATION_GLOSSARY.md +72 -0
  12. package/package.json +6 -15
  13. package/scripts/python/repo_governance_check/__init__.py +0 -3
  14. package/scripts/python/repo_governance_check/__main__.py +0 -6
  15. package/scripts/python/repo_governance_check/checks.py +0 -359
  16. package/scripts/python/repo_governance_check/cli.py +0 -115
  17. package/scripts/python/repo_governance_check/config.py +0 -33
  18. package/scripts/python/repo_governance_check/governance_check_config.json +0 -166
  19. package/scripts/python/repo_governance_check/report.py +0 -79
package/CHANGELOG.md CHANGED
@@ -1,21 +1,8 @@
1
1
  # Changelog
2
2
 
3
- > 简体中文版见文末章节。
4
-
5
3
  ## 1.0.0 - 2026-09-07
6
4
 
7
5
  ### Added
8
6
 
9
- - Initial open-source release of the HAP governance content package: the six
10
- governance documents in Simplified Chinese (`assets/ZH_CN/`) and their
11
- official English translations (`assets/EN/`), plus the governance-document
12
- structural self-check (`scripts/python/repo_governance_check/`, Python
13
- stdlib only).
14
-
15
- ## 1.0.0 - 2026-09-07（简体中文）
16
-
17
- ### 新增
18
-
19
- - HAP 治理内容包首次开源发布：六份治理文档的简体中文原文（`assets/ZH_CN/`）
20
- 与官方英文译本（`assets/EN/`），以及治理文档结构自检工具
21
- （`scripts/python/repo_governance_check/`，仅 Python 标准库）。
7
+ - Initial open-source release of the HAP governance content package: the six governance documents in Simplified Chinese
8
+ (`assets/ZH_CN/`) and their official English translations (`assets/EN/`).
package/README.md CHANGED
@@ -1,60 +1,34 @@
1
- # hap-governance
1
+ # Human-Agent Paradigm
2
2
 
3
- The **governance content package** of the Human-Agent Paradigm (HAP):
4
- the frozen governance documents and their structural self-check tool, published as an independent npm package so content
5
- (owner-approval cadence) and tooling (engineering cadence) release independently.
3
+ The **governance content package** of the Human-Agent Paradigm (HAP): six frozen governance documents and their
4
+ structural self-check tool, published as a standalone npm package so that the content.
6
5
 
7
6
  **English** | [简体中文](README.zh-CN.md)
8
7
 
9
8
  ## Contents
10
9
 
11
- | Path | Purpose |
12
- |:----------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
13
- | `assets/ZH_CN/` | The six governance documents — Simplified Chinese originals: `HUMAN_AGENT_PARADIGM.md` (Constitution v1.0), `DERIVED_SPECIFICATION.md` (v1.0), `CONFORMANCE_CHECKLIST.md` (v1.0), `CONTRACT_TEMPLATE.md`, `DECISION_REQUEST_TEMPLATE.md`, `DELIVERY_REPORT_TEMPLATE.md` |
14
- | `assets/EN/` | Official English translations of the same six documents |
15
- | `scripts/python/repo_governance_check/` | Structural self-check for the document set (Python stdlib only; auto-detects `assets/ZH_CN` etc.) |
10
+ | Path | Purpose |
11
+ |:----------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
12
+ | `assets/ZH_CN/` | The six governance documents (Simplified Chinese originals): `HUMAN_AGENT_PARADIGM.md` (Constitution v1.0), `DERIVED_SPECIFICATION.md` (Derived Specification v1.0), `CONFORMANCE_CHECKLIST.md` (Conformance Checklist v1.0), `CONTRACT_TEMPLATE.md`, `DECISION_REQUEST_TEMPLATE.md`, `DELIVERY_REPORT_TEMPLATE.md` |
13
+ | `assets/EN/` | The official English translations of the same six documents |
16
14
 
17
15
  ## Usage
18
16
 
19
- Consumers copy the `assets/` language directories into their workspace governance root
20
-
21
- ```bash
22
- python3 -m scripts.python.repo_governance_check --root . --out-dir reports
23
- ```
17
+ Consumers copy the `assets/` language directory into the governance root of their own workspace. Standalone use.
24
18
 
25
19
  ## Version strategy
26
20
 
27
- | Content version | Package version | Trigger |
28
- |:-------------------------------------------------------|:-------------------|:---------------------------|
29
- | Constitution v1.0 | 1.0.0 (baseline) | initial release |
30
- | Constitution revision (major) | major bump | a new Constitution version |
31
- | Derived Specification / Checklist / Templates revision | minor / patch bump | derived-family edits |
32
-
33
- The Constitution version is authoritative; package versions follow it. Every content amendment requires explicit owner
34
- approval in a HAP flow (Constitution §0.4, Derived Specification §0.4). Tooling changes to the checker do not change the
35
- governance content.
36
-
37
- ## Publishing
38
-
39
- Releases are published to npm from GitHub Actions ([.github/workflows/publish.yml](.github/workflows/publish.yml)):
40
- pushing a `v*` tag that matches the `package.json` version triggers a build + `npm publish`; the same can be triggered
41
- manually with `workflow_dispatch`.
42
-
43
- The workflow uses npm **Trusted Publishing (OIDC)** — publishing authenticates with the GitHub Actions OIDC token, so
44
- **no npm token/secret** is stored in this repository. Provenance is generated automatically for public repositories.
45
-
46
- Before the first publish succeeds, configure the Trusted Publisher once on npmjs.com
47
- (Package Settings → Trusted publishing → GitHub Actions):
48
-
49
- - Organization or user: `hap-labs`
50
- - Repository: `human-agent-paradigm-governance`
51
- - Workflow filename: `publish.yml`
52
- - Allowed actions: `npm publish`
21
+ | Content version | Package version | Trigger |
22
+ |:----------------------------------------------|:------------------------|:-------------------------|
23
+ | Constitution v1.0 | 1.0.0 (baseline) | Initial release |
24
+ | Constitution amendment (major) | major increment | New constitution version |
25
+ | Derived spec / checklist / template revisions | minor / patch increment | Derived-family edits |
53
26
 
54
- After the first successful publish, consider hardening the package (Settings → Publishing access → "Require two-factor
55
- authentication and disallow tokens") and revoking any obsolete automation tokens.
27
+ The constitution version governs, and the package version follows it. Any content revision must be explicitly approved
28
+ by the Owner within a HAP run (Constitution §0.4, Derived Specification §0.4). Tool-only changes to the self-check tool
29
+ do not change the governance content.
56
30
 
57
31
  ## Governance
58
32
 
59
- This repository is governed by its own content (the HAP Constitution). Amendments are made through HAP runs with owner
60
- sign-off; publishing is an owner-authorized action.
33
+ This repository is governed by its own content (the HAP Constitution). Revisions happen through a HAP run with the
34
+ Owner's signature; publishing is an Owner-authorized action.
package/README.zh-CN.md CHANGED
@@ -1,6 +1,6 @@
1
- # hap-governance
1
+ # Human-Agent Paradigm
2
2
 
3
- 人机协作范式（HAP）的 **治理内容包**：六份冻结治理文档与其结构自检工具， 作为独立 npm 包发布，使内容（按人批准节奏演进）与工具（按工程节奏演进）解耦发布。
3
+ 人机协作范式（HAP）的 **治理内容包**：六份冻结治理文档与其结构自检工具， 作为独立 npm 包发布。
4
4
 
5
5
  [English](README.md) | **简体中文**
6
6
 
@@ -10,15 +10,10 @@
10
10
  |:----------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
11
11
  | `assets/ZH_CN/` | 六份治理文档（简体中文原文）：`HUMAN_AGENT_PARADIGM.md`（宪法 v1.0）、`DERIVED_SPECIFICATION.md`（派生规范 v1.0）、`CONFORMANCE_CHECKLIST.md`（符合性清单 v1.0）、`CONTRACT_TEMPLATE.md`、`DECISION_REQUEST_TEMPLATE.md`、`DELIVERY_REPORT_TEMPLATE.md` |
12
12
  | `assets/EN/` | 同一六份的官方英文译本 |
13
- | `scripts/python/repo_governance_check/` | 文档组结构自检（仅 Python 标准库；自动探测 `assets/ZH_CN` 等） |
14
13
 
15
14
  ## 用法
16
15
 
17
- 消费方把 `assets/` 语言目录复制进各自工作区的治理根。独立使用：
18
-
19
- ```bash
20
- python3 -m scripts.python.repo_governance_check --root . --out-dir reports
21
- ```
16
+ 消费方把 `assets/` 语言目录复制进各自工作区的治理根。独立使用。
22
17
 
23
18
  ## 版本策略
24
19
 
@@ -28,25 +23,8 @@ python3 -m scripts.python.repo_governance_check --root . --out-dir reports
28
23
  | 宪法修订（主版本） | major 递增 | 宪法新版本 |
29
24
  | 派生规范 / 清单 / 模板修订 | minor / patch 递增 | 派生家族编辑 |
30
25
 
31
- 宪法版本为准，包版本随动。任何内容修订都须在 HAP 流程中经所有者明确批准
32
- （宪法 §0.4、派生规范 §0.4）。自检工具的工具性改动不改变治理内容。
33
-
34
- ## 发布
35
-
36
- 版本经 GitHub Actions（[.github/workflows/publish.yml](.github/workflows/publish.yml)）发布到 npm：推送与 `package.json` 版本一致的 `v*` tag 会触发构建 + `npm publish`；也可用 `workflow_dispatch` 手动触发。
37
-
38
- 工作流使用 npm **Trusted Publishing（OIDC）**——发布时以 GitHub Actions 的 OIDC token 认证，**本仓库无需存储任何 npm token/密钥**；公开仓库发布时 provenance 自动生成。
39
-
40
- 首次发布成功前，需在 npmjs.com 完成一次性 Trusted Publisher 配置（包 Settings → Trusted publishing → GitHub Actions）：
41
-
42
- - Organization or user：`hap-labs`
43
- - Repository：`human-agent-paradigm-governance`
44
- - Workflow filename：`publish.yml`
45
- - Allowed actions：`npm publish`
46
-
47
- 首次发布成功后，可进一步加固（包 Settings → Publishing access → 「Require two-factor authentication and disallow tokens」），并吊销不再使用的自动化 token。
26
+ 宪法版本为准，包版本随动。任何内容修订都须在 HAP 流程中经所有者明确批准 （宪法 §0.4、派生规范 §0.4）。自检工具的工具性改动不改变治理内容。
48
27
 
49
28
  ## 治理
50
29
 
51
- 本仓库受自身内容（HAP 宪法）治理。修订通过 HAP run + 所有者签署完成；
52
- 发布是所有者授权动作。
30
+ 本仓库受自身内容（HAP 宪法）治理。修订通过 HAP run + 所有者签署完成； 发布是所有者授权动作。