@rosenfan/matrix 0.1.3 → 0.1.5

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 (54) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +72 -63
  3. package/README.zh-CN.md +70 -61
  4. package/{.claude → assets}/skills/matrix/SKILL.md +81 -86
  5. package/{.claude → assets}/skills/matrix/agents/openai.yaml +4 -4
  6. package/{.claude → assets}/skills/matrix/scripts/matrix_claude.py +11 -11
  7. package/{.claude → assets}/skills/matrix/scripts/matrix_state.py +60 -60
  8. package/assets/skills/matrix/scripts/test_matrix_claude.py +69 -0
  9. package/assets/skills/matrix/scripts/test_matrix_state.py +69 -0
  10. package/{.claude → assets}/skills/matrix-archive/SKILL.md +27 -27
  11. package/{.claude/skills/matrix-hotfix → assets/skills/matrix-archive}/agents/openai.yaml +4 -4
  12. package/{.claude → assets}/skills/matrix-build/SKILL.md +41 -38
  13. package/{.claude/skills/matrix-archive → assets/skills/matrix-build}/agents/openai.yaml +4 -4
  14. package/{.claude → assets}/skills/matrix-claude/SKILL.md +93 -93
  15. package/{.claude → assets}/skills/matrix-claude/agents/openai.yaml +4 -4
  16. package/{.claude → assets}/skills/matrix-design/SKILL.md +69 -67
  17. package/{.claude → assets}/skills/matrix-design/agents/openai.yaml +4 -4
  18. package/{.claude → assets}/skills/matrix-hotfix/SKILL.md +7 -7
  19. package/{.claude/skills/matrix-build → assets/skills/matrix-hotfix}/agents/openai.yaml +4 -4
  20. package/{.claude → assets}/skills/matrix-open/SKILL.md +26 -24
  21. package/assets/skills/matrix-open/agents/openai.yaml +4 -0
  22. package/{.claude → assets}/skills/matrix-status/SKILL.md +14 -14
  23. package/{.claude → assets}/skills/matrix-status/agents/openai.yaml +4 -4
  24. package/{.claude → assets}/skills/matrix-tweak/SKILL.md +7 -7
  25. package/assets/skills/matrix-tweak/agents/openai.yaml +4 -0
  26. package/assets/skills/matrix-verify/SKILL.md +89 -0
  27. package/assets/skills/matrix-verify/agents/openai.yaml +4 -0
  28. package/assets/skills-zh-CN/matrix/SKILL.md +27 -27
  29. package/assets/skills-zh-CN/matrix-archive/SKILL.md +10 -10
  30. package/assets/skills-zh-CN/matrix-build/SKILL.md +13 -11
  31. package/assets/skills-zh-CN/matrix-claude/SKILL.md +10 -10
  32. package/assets/skills-zh-CN/matrix-design/SKILL.md +12 -10
  33. package/assets/skills-zh-CN/matrix-hotfix/SKILL.md +1 -1
  34. package/assets/skills-zh-CN/matrix-open/SKILL.md +18 -16
  35. package/assets/skills-zh-CN/matrix-status/SKILL.md +3 -3
  36. package/assets/skills-zh-CN/matrix-tweak/SKILL.md +1 -1
  37. package/assets/skills-zh-CN/matrix-verify/SKILL.md +25 -9
  38. package/bin/matrix.js +15 -15
  39. package/package.json +4 -13
  40. package/src/catalog.js +110 -92
  41. package/src/cli.js +138 -80
  42. package/src/distribution.js +379 -253
  43. package/src/installer.js +4 -4
  44. package/src/matt-catalog.mjs +67 -0
  45. package/src/matt.js +91 -9
  46. package/src/messages.js +14 -10
  47. package/src/runtime-resolver.js +76 -0
  48. package/src/self-update.js +2 -2
  49. package/src/workflow-transaction.js +9 -5
  50. package/src/workflow.js +688 -429
  51. package/.claude/skills/matrix-open/agents/openai.yaml +0 -4
  52. package/.claude/skills/matrix-tweak/agents/openai.yaml +0 -4
  53. package/.claude/skills/matrix-verify/SKILL.md +0 -73
  54. package/.claude/skills/matrix-verify/agents/openai.yaml +0 -4
package/.claude/skills/matrix-open/agents/openai.yaml DELETED
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "Matrix Workflow"
3
- short_description: "Persistent development workflow stage"
4
- default_prompt: "Use $name to continue a Matrix development workflow."
package/.claude/skills/matrix-tweak/agents/openai.yaml DELETED
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "Matrix Workflow"
3
- short_description: "Persistent development workflow stage"
4
- default_prompt: "Use $name to continue a Matrix development workflow."
package/.claude/skills/matrix-verify/SKILL.md DELETED
@@ -1,73 +0,0 @@
1
- ---
2
- name: matrix-verify
3
- description: Verify the active Matrix change against its plan and review its diff. Use when the active Matrix phase is verify.
4
- ---
5
-
6
- # Matrix Verify
7
-
8
- Run the approved Contract's acceptance commands and record their output summaries under `## Test evidence` in `artifacts/verification.md`.
9
-
10
- Write verification prose in `artifact_language` from inspect while preserving the required English evidence headings.
11
-
12
- ## Input Sources
13
-
14
- This phase can receive implementation from two sources:
15
-
16
- 1. **Direct Codex implementation** — from `$matrix-build` phase
17
- 2. **Claude Code implementation** — from `$matrix-claude` sidecar
18
-
19
- Regardless of source, the verification process is the same: check that implementation evidence meets the plan's requirements.
20
-
21
- ## Prerequisites
22
-
23
- Before starting verification, ensure:
24
-
25
- - [ ] `artifacts/verification.md` exists
26
- - [ ] `## Build evidence` section is present and substantive
27
- - [ ] All commands from the plan's `## Validation` section have been run
28
- - [ ] Test results are recorded
29
-
30
- If these are missing (e.g., Claude Code didn't produce complete evidence), return to `$matrix-build` or ask Claude Code to补充.
31
-
32
- ## Orchestration
33
-
34
- Run `matrix workflow inspect` and read the frozen mode.
35
-
36
- - **Prim**: Matrix performs the Standards and Spec review itself.
37
- - **Arch**: invoke `code-review` to produce both review axes; announce the invocation and reason.
38
-
39
- Review findings are inputs to Matrix Verify; a companion cannot decide the phase outcome, broaden approved architecture, transition, or archive. Do not invoke post-review architecture wrappers. A correctly installed review capability gets at most one same-capability Matrix fallback; installation-integrity failure stops verification.
40
-
41
- ## Failure Handling
42
-
43
- If verification or review fails:
44
- - If the issue is in the implementation, run `matrix workflow return build --reason verification-failed`, then enter `$matrix-build` or ask Claude Code to fix.
45
- - If the issue is in the acceptance criteria or design, run `matrix workflow return design --reason acceptance-or-design-gap`, then enter `$matrix-design`.
46
-
47
- Both Return paths rotate the current `verification.md` into revisioned evidence history. Do not copy stale conclusions back into the new current evidence.
48
-
49
- If documents or public behavior changed, record the required synchronization work before the guard.
50
-
51
- ## Process
52
-
53
- 1. Check that `artifacts/verification.md` exists with `## Build evidence`
54
- 2. Run the approved validation commands (full plan or lightweight proposal)
55
- 3. Record test output under `## Test evidence`
56
- 4. Produce both Standards and Spec review axes through the selected orchestration mode
57
- 6. Record findings under `## Review evidence`
58
- 7. Run the guard
59
- 8. If it passes, transition to archive and enter `$matrix-archive`
60
-
61
- ```powershell
62
- matrix workflow guard verify
63
- matrix workflow transition archive
64
- ```
65
-
66
- ## Evidence Requirements
67
-
68
- The guard checks for:
69
-
70
- 1. **Test evidence** — Output from running the plan's validation commands
71
- 2. **Review evidence** — Findings from the two-axis code review
72
-
73
- Full requires Test and Review evidence. Hotfix additionally requires `## Regression evidence`; tweak additionally requires `## Scope review evidence`.
package/.claude/skills/matrix-verify/agents/openai.yaml DELETED
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "Matrix Workflow"
3
- short_description: "Persistent development workflow stage"
4
- default_prompt: "Use $name to continue a Matrix development workflow."