🎉 init: 小龙的工作空间

2026-06-06 10:40:48 +08:00
commit a188ee1426
3201 changed files with 231817 additions and 0 deletions
@@ -0,0 +1,107 @@
+# CHANGELOG.md — Protocol Stack V2
+
+> All notable changes to the three-layer agent protocol architecture.
+
+---
+
+## [2.0.0] — 2026-06-06
+
+### Added
+
+- **GOVERNANCE.md** — Full Execution Governance Protocol (§0–11)
+  - 8-state state machine with transition rules and mermaid diagram
+  - Heartbeat/stale detection rules with Small/Medium/Large thresholds
+  - Blocker management with escalation mechanism
+  - Replanning trigger (R1–R8 conditions)
+  - Scope explosion detector (S1–S4)
+  - Execution audit schema
+  - Project Health Score (5 dimensions + weighted formula + rating)
+  - Auto-Stop Rule with RECOVERY MODE
+  - Governance Quality Gate (8-item checklist)
+  - State initialization and override protocols
+
+- **PORTFOLIO.md** — Full Portfolio Management Protocol (§1–14)
+  - Portfolio registry schema (9 fields: ID/Name/Status/Priority/Health/Agents/Progress/Updated/ROI)
+  - 7-state project lifecycle (PLANNING→ACTIVE→...→ARCHIVED)
+  - Priority system (P0 Mission Critical → P3 Low Priority)
+  - Resource allocation with Agent Utilization Score
+  - Project Health Aggregation (5 dimensions + Execution/Risk)
+  - Portfolio Health Score (weighted by Agent count)
+  - Learning Reuse Detector with duplicate work criteria
+  - Portfolio Audit with daily generation
+  - Kill / Pause / Promotion rules
+  - Executive Dashboard schema
+  - Portfolio Quality Gate
+
+- **protocol-reference/** — Extracted reference directory
+  - `quality-gates.md` — 3 gates consolidated in one file
+  - `metrics.md` — All score formulas and rating tables
+  - `templates.md` — All example templates extracted from main docs
+
+- **Scripts**
+  - `scripts/audit-agents.mjs` — 24 checks for AGENTS.md
+  - `scripts/audit-governance.mjs` — 34 checks for GOVERNANCE.md
+  - `scripts/audit-portfolio.mjs` — 33 checks for PORTFOLIO.md
+  - `scripts/audit-all.mjs` — 91-check orchestrator + audit-report.md generator
+  - `scripts/upgrade-test.mjs` — 62-check OpenClaw upgrade compatibility suite
+  - `npm run audit` / `npm run upgrade` package.json entries
+
+- **Governance artifacts**
+  - `COMPATIBILITY-STRATEGY.md` — OpenClaw integration surface audit + risk matrix
+  - `version-contract.md` — Required/Forbidden interfaces contract
+  - `upgrade-playbook.md` — Migration strategy (minor/major/deprecation)
+  - `SYSTEM-AUDIT.md` — Protocol simplification audit with metrics
+  - `PROJECT-COMPLETION-REPORT.md` — Project completion template
+
+### Changed
+
+- **AGENTS.md**
+  - §6 Governance Compliance: ~50 lines → 3-line references to GOVERNANCE.md
+  - Removed non-protocol sections: Memory, Red Lines, External vs Internal, Group Chats, Security Baseline, Heartbeats
+  - §7 Auto-Capture: renumbered from §6 (after new §6 inserted)
+  - Cross-refs added to PORTFOLIO.md in §6e
+
+- **GOVERNANCE.md**
+  - §12 Portfolio Integration: deleted (covered by PORTFOLIO.md)
+  - §3.2 Blocker Schema: migrated to protocol-reference/templates.md
+  - §4.3 Replan Log Entry: migrated to protocol-reference/templates.md
+  - §6.2 Audit Schema: migrated to protocol-reference/templates.md
+  - §7.3 Rating: migrated to protocol-reference/metrics.md
+  - §9.1 Quality Gate checklist: migrated to protocol-reference/quality-gates.md
+
+- **PORTFOLIO.md**
+  - §8.2 Audit Schema: migrated to protocol-reference/templates.md
+  - §12.2 Dashboard Schema: migrated to protocol-reference/templates.md
+  - §13.1 Quality Gate checklist: migrated to protocol-reference/quality-gates.md
+  - Self-ref comment tags cleaned
+
+- **MEMORY.md** — Added Governance Protocol and Portfolio Protocol entries
+
+- **Package.json** — Added `audit`, `audit:*`, `upgrade` npm scripts
+
+### Removed
+
+- AGENTS.md: 6 non-protocol sections removed
+- GOVERNANCE.md: §12 Portfolio Integration removed
+- Inline template code blocks replaced with references to protocol-reference/
+
+### Fixed
+
+- AGENTS.md section numbering collision (§6 Governance vs old §6 Auto-Capture → renumbered §7)
+- upgrade-test.mjs: false-positive `DD.md` cross-ref detection
+
+### Secured
+
+- Zero OpenClaw internal API dependencies in audit scripts
+- All audit scripts are pure Node.js (fs/path)
+- Protocol files are pure Markdown (no runtime deps)
+- 62/62 upgrade compatibility tests (verified on v2026.5.28 → v2026.6.1)
+- Self-hosting readiness: 80/100
+
+## Volume History
+
+| Version | Date | Total Bytes | Audit PASS | Audit FAIL |
+|---------|------|-------------|------------|------------|
+| V0 (bootstrap) | 2026-06-05 | ~56KB | — | — |
+| V1 (initial) | 2026-06-06 | 56,002 | 78 | 0 |
+| **V2 (freeze)** | **2026-06-06** | **44,136 (−21%)** | **78** | **0** |