@jstn-sdk/ma 0.1.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 (97) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.codex/agents/Architect.toml +4 -0
  3. package/.codex/agents/Auditor.toml +4 -0
  4. package/.codex/agents/Builder.toml +4 -0
  5. package/.codex/agents/Flow.toml +4 -0
  6. package/.codex/agents/Sage.toml +4 -0
  7. package/.codex/agents/Vibe.toml +4 -0
  8. package/.codex/hooks.json +15 -0
  9. package/.codex/prompts/enforcement.md +59 -0
  10. package/.codex/prompts/onboarding.md +41 -0
  11. package/.codex/prompts/release-rules.md +28 -0
  12. package/.codex/prompts/skill-contract.md +41 -0
  13. package/LICENSE +21 -0
  14. package/README.md +532 -0
  15. package/bin/ma.js +300 -0
  16. package/bin/meta-architect.js +3 -0
  17. package/docs/README.md +24 -0
  18. package/docs/assets/meta-architect-logo.png +0 -0
  19. package/docs/assets/meta-architect-logo.svg +8 -0
  20. package/docs/getting-started.md +451 -0
  21. package/docs/mcp-setup.md +5 -0
  22. package/docs/onboarding.md +65 -0
  23. package/docs/qa/release-readiness-0.1.0.md +62 -0
  24. package/docs/release-spec.md +86 -0
  25. package/docs/skills-publishing.md +231 -0
  26. package/docs/skills.md +91 -0
  27. package/index.js +28 -0
  28. package/mcp/collections.json +21 -0
  29. package/mcp/fallback.json +7 -0
  30. package/mcp/servers.json +55 -0
  31. package/package.json +84 -0
  32. package/plugins/meta-architect/.app.json +8 -0
  33. package/plugins/meta-architect/.codex-plugin/plugin.json +23 -0
  34. package/plugins/meta-architect/.mcp.json +12 -0
  35. package/plugins/meta-architect/README.md +121 -0
  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/meta-architect/SKILL.md +30 -0
  43. package/plugins/meta-architect/skills/meta-architect/agents/openai.yaml +4 -0
  44. package/plugins/meta-architect/skills/meta-architect/references/core-release-rules.md +13 -0
  45. package/plugins/meta-architect/skills/sage/SKILL.md +24 -0
  46. package/plugins/meta-architect/skills/sage/agents/openai.yaml +4 -0
  47. package/plugins/meta-architect/skills/vet/SKILL.md +25 -0
  48. package/plugins/meta-architect/skills/vet/agents/openai.yaml +4 -0
  49. package/plugins/meta-architect/skills/vibe/SKILL.md +24 -0
  50. package/plugins/meta-architect/skills/vibe/agents/openai.yaml +4 -0
  51. package/scripts/doctor.js +37 -0
  52. package/scripts/plugin-sync.js +92 -0
  53. package/scripts/postinstall.js +19 -0
  54. package/scripts/release-metadata.js +94 -0
  55. package/scripts/release-verify.js +153 -0
  56. package/scripts/setup-npmrc.js +39 -0
  57. package/scripts/skills-install.js +29 -0
  58. package/scripts/skills-manifest.js +61 -0
  59. package/scripts/skills-pack.js +54 -0
  60. package/scripts/skills-validate.js +118 -0
  61. package/skills/arch/SKILL.md +27 -0
  62. package/skills/arch/agents/openai.yaml +4 -0
  63. package/skills/build/SKILL.md +24 -0
  64. package/skills/build/agents/openai.yaml +4 -0
  65. package/skills/flow/SKILL.md +24 -0
  66. package/skills/flow/agents/openai.yaml +4 -0
  67. package/skills/index.json +40 -0
  68. package/skills/meta-architect/SKILL.md +30 -0
  69. package/skills/meta-architect/agents/openai.yaml +4 -0
  70. package/skills/meta-architect/references/core-release-rules.md +13 -0
  71. package/skills/sage/SKILL.md +24 -0
  72. package/skills/sage/agents/openai.yaml +4 -0
  73. package/skills/vet/SKILL.md +25 -0
  74. package/skills/vet/agents/openai.yaml +4 -0
  75. package/skills/vibe/SKILL.md +24 -0
  76. package/skills/vibe/agents/openai.yaml +4 -0
  77. package/sprint/00-idea.md +27 -0
  78. package/sprint/01-architecture.md +26 -0
  79. package/sprint/02-oss-evidence.md +26 -0
  80. package/sprint/03-logic.md +25 -0
  81. package/sprint/04-security.md +25 -0
  82. package/sprint/05-dx-ux.md +24 -0
  83. package/sprint/06-build-plan.md +26 -0
  84. package/sprint/07-release.md +26 -0
  85. package/src/build-gate.js +52 -0
  86. package/src/decision-log.js +40 -0
  87. package/src/fs-utils.js +25 -0
  88. package/src/launcher.js +55 -0
  89. package/src/mcp-config.js +30 -0
  90. package/src/mcp-live-client.js +186 -0
  91. package/src/paths.js +26 -0
  92. package/src/policy.js +23 -0
  93. package/src/release-state.js +59 -0
  94. package/src/runtime-artifacts.js +363 -0
  95. package/src/skill-installer.js +49 -0
  96. package/src/skills.js +507 -0
  97. package/src/state-sync.js +15 -0
@@ -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
+ }
@@ -0,0 +1,4 @@
1
+ name = "Architect"
2
+ role = "architecture-design"
3
+ trigger = "$arch"
4
+ description = "Produces blueprint architecture, stack rationale, tradeoffs, and subsystem design."
@@ -0,0 +1,4 @@
1
+ name = "Auditor"
2
+ role = "security-review"
3
+ trigger = "$vet"
4
+ description = "Evaluates security posture, CVE signals, and safer alternatives."
@@ -0,0 +1,4 @@
1
+ name = "Builder"
2
+ role = "build-planning"
3
+ trigger = "$build"
4
+ description = "Checks gates, splits bounded work, and proposes branch/worktree execution paths."
@@ -0,0 +1,4 @@
1
+ name = "Flow"
2
+ role = "logic-validation"
3
+ trigger = "$flow"
4
+ description = "Validates business logic, state transitions, and unresolved blockers."
@@ -0,0 +1,4 @@
1
+ name = "Sage"
2
+ role = "oss-evidence"
3
+ trigger = "$sage"
4
+ description = "Maps architectural choices to approved OSS sources through GitMCP-backed collections."
@@ -0,0 +1,4 @@
1
+ name = "Vibe"
2
+ role = "experience-review"
3
+ trigger = "$vibe"
4
+ description = "Reviews developer and user experience risks before implementation."
@@ -0,0 +1,15 @@
1
+ {
2
+ "version": 1,
3
+ "hooks": [
4
+ {
5
+ "event": "prebuild",
6
+ "action": "deny-unless-gates-green",
7
+ "source": ".ma/decisions.json"
8
+ },
9
+ {
10
+ "event": "prerelease",
11
+ "action": "deny-unless-release-origin-valid",
12
+ "allowedOrigins": ["development", "release/*"]
13
+ }
14
+ ]
15
+ }
@@ -0,0 +1,59 @@
1
+ # Meta-Architect Repo Enforcement Rules
2
+
3
+ You are operating inside Meta-Architect, a Codex skill system for verified project building.
4
+
5
+ ## Mission
6
+
7
+ Your purpose is not general chat.
8
+ Your purpose is to turn project ideas into evidence-backed architecture, validated decisions, and gated implementation outputs.
9
+
10
+ ## Core model
11
+
12
+ - GitMCP is the remote serverless MCP source layer for OSS context.
13
+ - MCP provides the host-client-server protocol for prompts, tools, and resources.
14
+ - Skills are the execution interface for reasoning and validation.
15
+ - Git worktrees are only for isolated implementation after approval.
16
+
17
+ ## Kernel vs extension rule
18
+
19
+ Treat Meta-Architect as two layers:
20
+
21
+ - **Kernel**
22
+ - CLI runtime
23
+ - gate enforcement
24
+ - decision and release state
25
+ - MCP evidence binding
26
+ - **Extensions**
27
+ - publishable skills
28
+ - plugin bundle
29
+ - missions
30
+ - templates
31
+ - release and repo-ops surfaces
32
+
33
+ The kernel may be minimal, but it must be strict. Extensions may vary, but they must not weaken the kernel contract.
34
+
35
+ ## Hard rules
36
+
37
+ 1. Every major architectural recommendation must cite at least one connected OSS source.
38
+ 2. Prefer repo-specific GitMCP endpoints over the generic GitMCP server whenever a repository is known.
39
+ 3. Do not recommend or approve a dependency unless its source is mapped in `mcp/servers.json` or explicitly approved by policy.
40
+ 4. Do not guess missing evidence. Return `UNVERIFIED`, `PARTIAL`, or `MISSING` when evidence is incomplete.
41
+ 5. Do not allow `$build` unless all required gates are satisfied.
42
+ 6. Do not allow direct release from a task branch or linked worktree.
43
+ 7. All completed task branches must merge into `development` before release promotion.
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 `.ma/decisions.json`.
46
+ 10. Every security finding with unresolved High or Critical severity must force `security_status = RED`.
47
+ 11. Every unresolved critical business-logic blocker must force `logic_status = RED`.
48
+ 12. No silent status upgrades are allowed.
49
+ 13. No hallucinated packages, repositories, or MCP endpoints are allowed.
50
+ 14. Runtime `.ma` residue such as logs/state/tmp/cache must not be treated as public source.
51
+ 15. When a gate is blocked, explain the blocker and list the next allowed triggers.
52
+
53
+ ## Evidence rule
54
+
55
+ `https://gitmcp.io/docs` is fallback policy only. It is not a normal approved evidence source for unlocking `$build`.
56
+
57
+ ## Release truth rule
58
+
59
+ Do not claim a channel is published unless the corresponding push, release creation, asset upload, or package publish actually succeeded.
@@ -0,0 +1,41 @@
1
+ # Onboarding
2
+
3
+ Meta-Architect is a skills-first orchestration layer with a strict kernel.
4
+
5
+ ## What is implemented
6
+
7
+ The primary runtime surface is `ma --madmax --high` plus:
8
+ - `$arch`
9
+ - `$sage`
10
+ - `$flow`
11
+ - `$vet`
12
+ - `$vibe`
13
+ - `$build`
14
+
15
+ Repo-local helper commands remain available through:
16
+ - `ma init`
17
+ - `ma idea`
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'`
26
+ - `ma merge`
27
+ - `ma release`
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 with `ma --madmax --high` and use `$arch` before assuming the workflow is ready
36
+
37
+ ## What not to do
38
+
39
+ - Do not edit `.ma/release.json` or `.ma/decisions.json` manually to bypass the gate model.
40
+ - Do not treat `.ma/logs/` or `.ma/state/` as source.
41
+ - Do not claim release channels succeeded without proof.
@@ -0,0 +1,28 @@
1
+ # Release Rules
2
+
3
+ ## Branch roles
4
+
5
+ - `feature/*` — bounded task work
6
+ - `development` — integration branch
7
+ - `release/*` — optional stabilization branch
8
+ - `prod` — production release branch
9
+
10
+ ## Merge rules
11
+
12
+ - Task work merges into `development`, never directly into `prod`.
13
+ - `ma merge` should only approve `feature/* -> development`.
14
+ - Build completion should be reflected before merge promotion.
15
+
16
+ ## Release rules
17
+
18
+ - `ma release` should only approve:
19
+ - `development -> prod`
20
+ - `release/* -> prod`
21
+ - No direct `feature/* -> prod` promotion.
22
+ - Release claims must match actual channel execution.
23
+
24
+ ## Artifact rules
25
+
26
+ - `skills/index.json` must be current.
27
+ - `dist/meta-architect-skills.tgz` must exist and be non-empty for a release that claims skill packaging readiness.
28
+ - Release docs and version lines must stay aligned.
@@ -0,0 +1,41 @@
1
+ # Skill Contract
2
+
3
+ Every Meta-Architect skill result must include:
4
+ - `decision`
5
+ - `status`
6
+ - `evidence`
7
+ - `blockers`
8
+ - `next_allowed_triggers`
9
+
10
+ ## Contract discipline
11
+
12
+ - Skills must not hide blocked prerequisites.
13
+ - Skills must not silently upgrade statuses.
14
+ - Skills must not claim evidence they do not actually have.
15
+ - Skills may perform a structured baseline review without pretending to be a deep autonomous specialist if the current kernel does not support that depth yet.
16
+
17
+ ## Required responsibilities
18
+
19
+ - `$arch`
20
+ - structured first-pass blueprint
21
+ - stack rationale
22
+ - tradeoffs
23
+ - downstream evidence requirements
24
+ - `$sage`
25
+ - approved OSS candidates
26
+ - source mappings
27
+ - verified vs partial vs missing distinction
28
+ - `$flow`
29
+ - baseline state review
30
+ - blocker reporting
31
+ - gate decision
32
+ - `$vet`
33
+ - baseline security review
34
+ - risk findings
35
+ - gate decision
36
+ - `$vibe`
37
+ - baseline DX/UX review
38
+ - waiver-capable experience gate output
39
+ - `$build`
40
+ - bounded branch/worktree plan
41
+ - only after gates pass
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 jstn-sdk
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.