@jstn-sdk/ma 0.1.5 → 0.1.7

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 (125) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.codex/hooks.json +1 -1
  3. package/.codex/prompts/enforcement.md +13 -3
  4. package/.codex/prompts/onboarding.md +29 -14
  5. package/README.md +536 -129
  6. package/bin/ma.js +61 -103
  7. package/docs/README.md +2 -1
  8. package/docs/assets/image/Screenshot(1).png +0 -0
  9. package/docs/assets/image/Screenshot(2).png +0 -0
  10. package/docs/assets/image/Screenshot(3).png +0 -0
  11. package/docs/assets/image/Screenshot(4).png +0 -0
  12. package/docs/assets/image/Screenshot(5).png +0 -0
  13. package/docs/assets/image/Screenshot(6).png +0 -0
  14. package/docs/assets/image/Screenshot(7).png +0 -0
  15. package/docs/assets/image/Screenshot(8).png +0 -0
  16. package/docs/assets/image/Screenshot(9).png +0 -0
  17. package/docs/assets/meta-architect-logo.png +0 -0
  18. package/docs/assets/meta-architect-logo.svg +8 -0
  19. package/docs/getting-started.md +434 -37
  20. package/docs/installed-sdk.md +60 -0
  21. package/docs/mcp-setup.md +46 -134
  22. package/docs/onboarding.md +41 -11
  23. package/docs/qa/release-readiness-0.1.5.md +46 -44
  24. package/docs/qa/release-readiness-0.1.7.md +79 -0
  25. package/docs/release-spec.md +81 -103
  26. package/docs/skills-publishing.md +187 -54
  27. package/docs/skills.md +82 -141
  28. package/mcp/collections.json +1 -1
  29. package/mcp/fallback.json +1 -1
  30. package/mcp/servers.json +1 -1
  31. package/package.json +17 -14
  32. package/plugins/meta-architect/.app.json +1 -1
  33. package/plugins/meta-architect/.codex-plugin/plugin.json +23 -0
  34. package/plugins/meta-architect/.mcp.json +1 -1
  35. package/plugins/meta-architect/README.md +23 -10
  36. package/plugins/meta-architect/skills/arch/SKILL.md +27 -0
  37. package/plugins/meta-architect/skills/arch/agents/openai.yaml +4 -0
  38. package/plugins/meta-architect/skills/build/SKILL.md +24 -0
  39. package/plugins/meta-architect/skills/build/agents/openai.yaml +4 -0
  40. package/plugins/meta-architect/skills/flow/SKILL.md +24 -0
  41. package/plugins/meta-architect/skills/flow/agents/openai.yaml +4 -0
  42. package/plugins/meta-architect/skills/maestro/SKILL.md +25 -0
  43. package/plugins/meta-architect/skills/maestro/agents/openai.yaml +4 -0
  44. package/plugins/meta-architect/skills/meta-architect/SKILL.md +19 -23
  45. package/plugins/meta-architect/skills/meta-architect/agents/openai.yaml +4 -0
  46. package/plugins/meta-architect/skills/meta-architect/references/core-release-rules.md +13 -0
  47. package/plugins/meta-architect/skills/sage/SKILL.md +37 -0
  48. package/plugins/meta-architect/skills/sage/agents/openai.yaml +4 -0
  49. package/plugins/meta-architect/skills/vet/SKILL.md +25 -0
  50. package/plugins/meta-architect/skills/vet/agents/openai.yaml +4 -0
  51. package/plugins/meta-architect/skills/vibe/SKILL.md +24 -0
  52. package/plugins/meta-architect/skills/vibe/agents/openai.yaml +4 -0
  53. package/scripts/doctor.js +8 -0
  54. package/scripts/plugin-sync.js +93 -0
  55. package/scripts/postinstall.js +23 -0
  56. package/scripts/release-metadata.js +94 -0
  57. package/scripts/release-sync.js +359 -0
  58. package/scripts/release-verify.js +153 -0
  59. package/scripts/setup-npmrc.js +39 -0
  60. package/scripts/skills-install.js +4 -36
  61. package/scripts/skills-manifest.js +1 -1
  62. package/scripts/skills-validate.js +78 -40
  63. package/skills/arch/SKILL.md +27 -0
  64. package/skills/arch/agents/openai.yaml +4 -0
  65. package/skills/build/SKILL.md +24 -0
  66. package/skills/build/agents/openai.yaml +4 -0
  67. package/skills/flow/SKILL.md +24 -0
  68. package/skills/flow/agents/openai.yaml +4 -0
  69. package/skills/index.json +27 -22
  70. package/skills/maestro/SKILL.md +25 -0
  71. package/skills/maestro/agents/openai.yaml +4 -0
  72. package/skills/meta-architect/SKILL.md +19 -23
  73. package/skills/meta-architect/agents/openai.yaml +3 -3
  74. package/skills/meta-architect/references/core-release-rules.md +2 -2
  75. package/skills/sage/SKILL.md +37 -0
  76. package/skills/sage/agents/openai.yaml +4 -0
  77. package/skills/vet/SKILL.md +25 -0
  78. package/skills/vet/agents/openai.yaml +4 -0
  79. package/skills/vibe/SKILL.md +24 -0
  80. package/skills/vibe/agents/openai.yaml +4 -0
  81. package/sprint/00-idea.md +1 -1
  82. package/sprint/01-architecture.md +1 -1
  83. package/sprint/02-oss-evidence.md +1 -1
  84. package/sprint/03-logic.md +1 -1
  85. package/sprint/04-security.md +2 -2
  86. package/sprint/05-dx-ux.md +1 -1
  87. package/src/decision-log.js +4 -4
  88. package/src/launcher.js +21 -17
  89. package/src/mcp-live-client.js +1 -1
  90. package/src/paths.js +8 -32
  91. package/src/release-state.js +3 -3
  92. package/src/runtime-artifacts.js +411 -0
  93. package/src/skill-installer.js +198 -0
  94. package/src/skills.js +473 -166
  95. package/templates/AGENTS.md +23 -6
  96. package/templates/model-instructions/core.md +1 -1
  97. package/.codex/config.toml +0 -2
  98. package/plugins/meta-architect/skills/meta-architect-arch/SKILL.md +0 -24
  99. package/plugins/meta-architect/skills/meta-architect-build/SKILL.md +0 -25
  100. package/plugins/meta-architect/skills/meta-architect-flow/SKILL.md +0 -23
  101. package/plugins/meta-architect/skills/meta-architect-sage/SKILL.md +0 -23
  102. package/plugins/meta-architect/skills/meta-architect-vet/SKILL.md +0 -23
  103. package/plugins/meta-architect/skills/meta-architect-vibe/SKILL.md +0 -24
  104. package/prompts/architect.md +0 -216
  105. package/prompts/builder.md +0 -10
  106. package/prompts/flow.md +0 -9
  107. package/prompts/release-manager.md +0 -10
  108. package/prompts/sage.md +0 -10
  109. package/prompts/security-reviewer.md +0 -10
  110. package/prompts/verifier.md +0 -10
  111. package/prompts/vibe.md +0 -10
  112. package/skills/meta-architect-arch/SKILL.md +0 -24
  113. package/skills/meta-architect-arch/agents/openai.yaml +0 -4
  114. package/skills/meta-architect-build/SKILL.md +0 -25
  115. package/skills/meta-architect-build/agents/openai.yaml +0 -4
  116. package/skills/meta-architect-flow/SKILL.md +0 -23
  117. package/skills/meta-architect-flow/agents/openai.yaml +0 -4
  118. package/skills/meta-architect-sage/SKILL.md +0 -23
  119. package/skills/meta-architect-sage/agents/openai.yaml +0 -4
  120. package/skills/meta-architect-vet/SKILL.md +0 -23
  121. package/skills/meta-architect-vet/agents/openai.yaml +0 -4
  122. package/skills/meta-architect-vibe/SKILL.md +0 -24
  123. package/skills/meta-architect-vibe/agents/openai.yaml +0 -4
  124. package/src/doctor.js +0 -30
  125. package/src/setup.js +0 -375
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "meta-architect-local",
3
+ "interface": {
4
+ "displayName": "Meta-Architect Local Plugins"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "meta-architect",
9
+ "source": {
10
+ "source": "local",
11
+ "path": "./plugins/meta-architect"
12
+ },
13
+ "policy": {
14
+ "installation": "AVAILABLE",
15
+ "authentication": "ON_INSTALL"
16
+ },
17
+ "category": "Developer Tools"
18
+ }
19
+ ]
20
+ }
package/.codex/hooks.json CHANGED
@@ -4,7 +4,7 @@
4
4
  {
5
5
  "event": "prebuild",
6
6
  "action": "deny-unless-gates-green",
7
- "source": ".omx/decisions.json"
7
+ "source": ".ma/decisions.json"
8
8
  },
9
9
  {
10
10
  "event": "prerelease",
@@ -19,7 +19,7 @@ Your purpose is to turn project ideas into evidence-backed architecture, validat
19
19
  Treat Meta-Architect as two layers:
20
20
 
21
21
  - **Kernel**
22
- - CLI runtime
22
+ - helper runtime
23
23
  - gate enforcement
24
24
  - decision and release state
25
25
  - MCP evidence binding
@@ -42,18 +42,28 @@ The kernel may be minimal, but it must be strict. Extensions may vary, but they
42
42
  6. Do not allow direct release from a task branch or linked worktree.
43
43
  7. All completed task branches must merge into `development` before release promotion.
44
44
  8. Only release from `development` or an approved `release/*` branch to `prod`.
45
- 9. Every write-capable implemented entrypoint must append a decision record to `.omx/decisions.json`.
45
+ 9. Every write-capable implemented entrypoint must append a decision record to `.ma/decisions.json`.
46
46
  10. Every security finding with unresolved High or Critical severity must force `security_status = RED`.
47
47
  11. Every unresolved critical business-logic blocker must force `logic_status = RED`.
48
48
  12. No silent status upgrades are allowed.
49
49
  13. No hallucinated packages, repositories, or MCP endpoints are allowed.
50
- 14. Runtime `.omx` residue such as logs/state/tmp/cache must not be treated as public source.
50
+ 14. Runtime `.ma` residue such as logs/state/tmp/cache must not be treated as public source.
51
51
  15. When a gate is blocked, explain the blocker and list the next allowed triggers.
52
52
 
53
53
  ## Evidence rule
54
54
 
55
55
  `https://gitmcp.io/docs` is fallback policy only. It is not a normal approved evidence source for unlocking `$build`.
56
56
 
57
+ Approved discovery accelerators include `https://ossium.live/home`, `https://trendshift.io/`, `https://devhunt.org/`, `https://libraries.io/`, `https://openhub.net/`, and `https://www.opensourceprojects.dev/`.
58
+
59
+ These discovery accelerators help find OSS candidates faster, but they are not by themselves VERIFIED evidence sources for unlocking `$build`.
60
+
61
+ Canonical evidence order:
62
+ 1. If the upstream repo or official docs are already known, start there.
63
+ 2. Otherwise use approved discovery accelerators to generate or narrow candidates.
64
+ 3. Map the chosen candidate to an exact upstream repository.
65
+ 4. Verify against upstream repos and official docs before upgrading evidence status.
66
+
57
67
  ## Release truth rule
58
68
 
59
69
  Do not claim a channel is published unless the corresponding push, release creation, asset upload, or package publish actually succeeded.
@@ -1,26 +1,41 @@
1
1
  # Onboarding
2
2
 
3
- Meta-Architect is a Codex-native runtime layer.
3
+ Meta-Architect is a skills-first system for Codex with a strict kernel.
4
4
 
5
- ## Canonical start
5
+ ## What is implemented
6
6
 
7
- 1. Install `@openai/codex` and `meta-architect`
8
- 2. Launch `ma --madmax --high`
9
- 3. Operate through `$arch`, `$sage`, `$flow`, `$vet`, `$vibe`, `$build`
7
+ The primary product surface is the in-session skill flow:
8
+ - `$arch`
9
+ - `$sage`
10
+ - `$flow`
11
+ - `$vet`
12
+ - `$vibe`
13
+ - `$build`
10
14
 
11
- ## Secondary helpers
12
-
13
- Use only when needed:
14
- - `ma status`
15
+ Secondary helper commands remain available through:
16
+ - `ma init`
15
17
  - `ma idea`
16
- - `ma run ...`
18
+ - `ma skills`
19
+ - `ma status`
20
+ - `ma run '$arch'`
21
+ - `ma run '$sage'`
22
+ - `ma run '$flow'`
23
+ - `ma run '$vet'`
24
+ - `ma run '$vibe'`
25
+ - `ma run '$build'`
17
26
  - `ma merge`
18
27
  - `ma release`
19
- - `ma doctor`
20
- - `ma setup`
28
+
29
+ ## What to learn first
30
+
31
+ 1. Read `README.md`
32
+ 2. Read `docs/getting-started.md`
33
+ 3. Read `docs/release-spec.md`
34
+ 4. Read `docs/skills.md`
35
+ 5. Start Codex context if needed, then use `$arch` before assuming the workflow is ready
21
36
 
22
37
  ## What not to do
23
38
 
24
- - Do not edit `.omx/release.json` or `.omx/decisions.json` manually to bypass the gate model.
25
- - Do not treat `.omx/logs/`, `.omx/state/`, or `.omx/metrics.json` as source.
39
+ - Do not edit `.ma/release.json` or `.ma/decisions.json` manually to bypass the gate model.
40
+ - Do not treat `.ma` support files as public source.
26
41
  - Do not claim release channels succeeded without proof.