@jstn-sdk/ma 0.1.12 → 0.14.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 (198) hide show
  1. package/.codex/agents/Architect.toml +1 -2
  2. package/.codex/agents/Auditor.toml +1 -2
  3. package/.codex/agents/Builder.toml +1 -2
  4. package/.codex/agents/Flow.toml +1 -2
  5. package/.codex/agents/Sage.toml +1 -2
  6. package/.codex/agents/Vibe.toml +1 -2
  7. package/.codex/hooks.json +24 -13
  8. package/.codex/prompts/enforcement.md +4 -0
  9. package/.codex/prompts/onboarding.md +6 -1
  10. package/.codex/prompts/release-rules.md +0 -0
  11. package/.codex/prompts/skill-contract.md +4 -0
  12. package/COVERAGE.md +211 -0
  13. package/DEMO.md +274 -0
  14. package/LICENSE +0 -0
  15. package/README.md +132 -656
  16. package/bin/ma.js +748 -55
  17. package/data/clone-data.ledger.json +41 -0
  18. package/data/clone-data.proof.json +50 -0
  19. package/data/clone-data.rvf +37 -0
  20. package/docs/README.md +10 -1
  21. package/docs/autonomous-tasks.md +46 -0
  22. package/docs/codex-integration.md +16 -0
  23. package/docs/getting-started.md +62 -22
  24. package/docs/mcp-setup.md +64 -0
  25. package/docs/qa/release-issue-gates-0.14.0.json +644 -0
  26. package/docs/qa/release-readiness-0.1.5.md +1 -1
  27. package/docs/qa/{release-readiness-0.1.12.md → release-readiness-0.14.0.md} +25 -9
  28. package/docs/quality.md +24 -0
  29. package/docs/reference/native-security-playbooks.md +6 -0
  30. package/docs/reference/native-source-selection.md +6 -0
  31. package/docs/release-spec.md +39 -10
  32. package/docs/skills.md +14 -1
  33. package/index.js +295 -2
  34. package/mcp/collections.json +23 -6
  35. package/mcp/fallback.json +0 -0
  36. package/mcp/local/code-intel.js +179 -41
  37. package/mcp/local/context.js +180 -0
  38. package/mcp/local/memory.js +17 -6
  39. package/mcp/local/quality.js +39 -0
  40. package/mcp/local/state.js +7 -3
  41. package/mcp/local/team-run.js +56 -4
  42. package/mcp/local-capabilities.json +9 -0
  43. package/mcp/servers.json +24 -0
  44. package/package.json +29 -4
  45. package/plugins/meta-architect/.app.json +1 -1
  46. package/plugins/meta-architect/.codex-plugin/plugin.json +1 -1
  47. package/plugins/meta-architect/.mcp.json +1 -1
  48. package/plugins/meta-architect/README.md +8 -1
  49. package/plugins/meta-architect/obsidian/main.js +534 -0
  50. package/plugins/meta-architect/obsidian/manifest.json +9 -0
  51. package/plugins/meta-architect/obsidian/styles.css +7 -0
  52. package/plugins/meta-architect/skills/arch/SKILL.md +2 -0
  53. package/plugins/meta-architect/skills/build/SKILL.md +3 -0
  54. package/plugins/meta-architect/skills/flow/SKILL.md +2 -0
  55. package/plugins/meta-architect/skills/sage/SKILL.md +2 -0
  56. package/plugins/meta-architect/skills/sage/references/source-selection.md +8 -0
  57. package/plugins/meta-architect/skills/vet/SKILL.md +2 -0
  58. package/plugins/meta-architect/skills/vet/references/security-playbooks.md +7 -0
  59. package/plugins/meta-architect/skills/vibe/SKILL.md +2 -0
  60. package/schemas/autonomous-task-queue.schema.json +56 -0
  61. package/schemas/handoff-packet.schema.json +36 -0
  62. package/schemas/setup-receipt.schema.json +28 -0
  63. package/schemas/skill-frontmatter.schema.json +20 -0
  64. package/schemas/support-bundle.schema.json +37 -0
  65. package/schemas/task-contract.schema.json +31 -0
  66. package/scripts/active-autonomy-hook.mjs +226 -0
  67. package/scripts/build-linux-packages.mjs +7 -3
  68. package/scripts/cleanup-test-fixtures.sh +55 -0
  69. package/scripts/context-hydration-hook.mjs +89 -0
  70. package/scripts/demo-smoke.js +285 -0
  71. package/scripts/doctor.js +27 -12
  72. package/scripts/install.sh +57 -0
  73. package/scripts/install.sh.sha256 +1 -0
  74. package/scripts/linux-package-smoke.mjs +2 -2
  75. package/scripts/package-size-check.mjs +26 -0
  76. package/scripts/plugin-sync.js +83 -17
  77. package/scripts/postinstall.js +17 -10
  78. package/scripts/prepack.js +9 -0
  79. package/scripts/ralph/prompt.md +35 -0
  80. package/scripts/release-sync.js +72 -7
  81. package/scripts/release-verify.js +260 -2
  82. package/scripts/setup-npmrc.js +48 -23
  83. package/scripts/skills-install.js +9 -2
  84. package/scripts/skills-manifest.js +2 -21
  85. package/scripts/skills-pack.js +2 -2
  86. package/scripts/skills-validate.js +5 -55
  87. package/skills/arch/SKILL.md +2 -0
  88. package/skills/build/SKILL.md +3 -0
  89. package/skills/flow/SKILL.md +2 -0
  90. package/skills/index.json +0 -0
  91. package/skills/sage/SKILL.md +2 -0
  92. package/skills/sage/references/source-selection.md +8 -0
  93. package/skills/vet/SKILL.md +2 -0
  94. package/skills/vet/references/security-playbooks.md +7 -0
  95. package/skills/vibe/SKILL.md +2 -0
  96. package/sprint/00-idea.md +0 -0
  97. package/sprint/01-architecture.md +0 -0
  98. package/sprint/02-oss-evidence.md +0 -0
  99. package/sprint/03-logic.md +0 -0
  100. package/sprint/04-security.md +0 -0
  101. package/sprint/05-dx-ux.md +0 -0
  102. package/sprint/06-build-plan.md +0 -0
  103. package/sprint/07-release.md +0 -0
  104. package/src/agents.js +279 -0
  105. package/src/bootstrap.js +268 -62
  106. package/src/build-gate.js +2 -2
  107. package/src/codex-app-server.js +291 -0
  108. package/src/decision-log.js +0 -0
  109. package/src/fs-utils.js +175 -4
  110. package/src/launcher.js +28 -21
  111. package/src/mcp-config.js +9 -1
  112. package/src/mcp-live-client.js +422 -3
  113. package/src/paths.js +10 -1
  114. package/src/policy.js +3 -3
  115. package/src/prelaunch.js +189 -0
  116. package/src/quality/ai-quality-orchestrator.js +328 -0
  117. package/src/release-issue-gates.js +252 -0
  118. package/src/release-operations.js +62 -0
  119. package/src/release-state.js +0 -0
  120. package/src/runtime/active-autonomy-core.js +208 -0
  121. package/src/runtime/agent-compat.js +31 -0
  122. package/src/runtime/alignment-sentinel.js +165 -0
  123. package/src/runtime/architect-review.js +326 -0
  124. package/src/runtime/autonomous-tasks.js +408 -0
  125. package/src/runtime/build-readiness.js +28 -4
  126. package/src/runtime/code-graph-rehearse.js +113 -0
  127. package/src/runtime/codeburn-core.js +112 -0
  128. package/src/runtime/context-authority.js +40 -0
  129. package/src/runtime/context-economy-core.js +316 -0
  130. package/src/runtime/continuity-graph.js +201 -0
  131. package/src/runtime/continuity-notes.js +71 -26
  132. package/src/runtime/core-source-ingest.js +379 -0
  133. package/src/runtime/detached-provider.js +142 -0
  134. package/src/runtime/doctor-report.js +18 -0
  135. package/src/runtime/environment-awareness-core.js +460 -0
  136. package/src/runtime/exposure-catalog.js +276 -0
  137. package/src/runtime/graphify-core.js +167 -0
  138. package/src/runtime/guidance-stack.js +9 -2
  139. package/src/runtime/handoff-packets.js +92 -0
  140. package/src/runtime/headroom-core.js +104 -0
  141. package/src/runtime/helper-orchestration-core.js +307 -0
  142. package/src/runtime/hook-profiles.js +20 -0
  143. package/src/runtime/learning-loop-core.js +344 -0
  144. package/src/runtime/live-agent-verification.js +122 -0
  145. package/src/runtime/maestro-events.js +18 -0
  146. package/src/runtime/maestro-manager.js +19 -0
  147. package/src/runtime/maestro-output.js +58 -0
  148. package/src/runtime/maestro-state.js +125 -0
  149. package/src/runtime/managed-markdown.js +29 -0
  150. package/src/runtime/mcp-authority.js +147 -0
  151. package/src/runtime/mcp-policy.js +192 -0
  152. package/src/runtime/obsidian-integration-core.js +1089 -0
  153. package/src/runtime/obsidian-plugin-bridge.js +1045 -0
  154. package/src/runtime/pi-maestro-core.js +89 -0
  155. package/src/runtime/preferences.js +79 -0
  156. package/src/runtime/project-context.js +636 -0
  157. package/src/runtime/prompt-strategy-core.js +230 -0
  158. package/src/runtime/quorum-review.js +90 -0
  159. package/src/runtime/ralph-execution-core.js +217 -0
  160. package/src/runtime/redaction-gateway.js +373 -0
  161. package/src/runtime/runtime-state.js +935 -2
  162. package/src/runtime/schema-migrations.js +162 -0
  163. package/src/runtime/semantic-recording-core.js +147 -0
  164. package/src/runtime/signal-hooks.js +28 -0
  165. package/src/runtime/skills-registry-export.js +754 -0
  166. package/src/runtime/task-contracts.js +83 -0
  167. package/src/runtime/universal-plugin-broker-core.js +898 -0
  168. package/src/runtime/workspace-intelligence-runtime.js +674 -0
  169. package/src/runtime/workspace-virtualizer.js +102 -0
  170. package/src/runtime-artifacts.js +225 -62
  171. package/src/setup-lifecycle.js +359 -0
  172. package/src/skill-frontmatter.js +78 -0
  173. package/src/skill-installer.js +226 -71
  174. package/src/skills.js +1166 -96
  175. package/src/state-sync.js +0 -0
  176. package/src/test-fixtures.js +543 -0
  177. package/src/tui/grid.js +67 -0
  178. package/src/tui/status-grid.js +23 -0
  179. package/support-bundle.json +114 -0
  180. package/templates/AGENTS.md +6 -2
  181. package/templates/catalog-manifest.json +0 -0
  182. package/templates/model-instructions/core.md +0 -0
  183. package/templates/model-instructions/release.md +0 -0
  184. package/templates/model-instructions/security.md +0 -0
  185. package/templates/quality/ai-quality-rules.yml +37 -0
  186. package/docs/assets/image/Screenshot(1).png +0 -0
  187. package/docs/assets/image/Screenshot(2).png +0 -0
  188. package/docs/assets/image/Screenshot(3).png +0 -0
  189. package/docs/assets/image/Screenshot(4).png +0 -0
  190. package/docs/assets/image/Screenshot(5).png +0 -0
  191. package/docs/assets/image/Screenshot(6).png +0 -0
  192. package/docs/assets/image/Screenshot(7).png +0 -0
  193. package/docs/assets/image/Screenshot(8).png +0 -0
  194. package/docs/assets/image/Screenshot(9).png +0 -0
  195. package/docs/assets/meta-architect-logo.png +0 -0
  196. package/docs/assets/meta-architect-logo.svg +0 -8
  197. package/docs/onboarding.md +0 -65
  198. package/docs/skills-publishing.md +0 -255
@@ -58,7 +58,7 @@ Helper-path validation:
58
58
 
59
59
  ```bash
60
60
  ma setup
61
- ma idea "Build a demo app"
61
+ ma idea "Harden Meta-Architect semantic core with evidence-backed gate readiness and package-visible proof"
62
62
  ma run '$arch'
63
63
  ma run '$sage'
64
64
  ma run '$flow'
@@ -1,26 +1,26 @@
1
- # Release Readiness 0.1.12
1
+ # Release Readiness 0.14.0
2
2
 
3
3
  ## Production bar
4
4
 
5
- `v0.1.12` is treated as production only when:
5
+ `v0.14.0` is treated as production only when:
6
6
  - the package installs cleanly from the canonical public install command
7
7
  - the Codex-hosted runtime path works end to end
8
8
  - the helper flow remains valid for scripted verification
9
9
  - the singular `$maestro` umbrella and helper-skill contract stay coherent
10
- - release docs, package metadata, and workflows all agree on `0.1.12`
10
+ - release docs, package metadata, and workflows all agree on `0.14.0`
11
11
 
12
12
  Target release state:
13
- - npm package: `@jstn-sdk/ma@0.1.12`
13
+ - npm package: `@jstn-sdk/ma@0.14.0`
14
14
  - npm registry state: pending publish
15
- - publishability note: this branch is prepared for the next publishable package line, `0.1.12`
16
- - git tag: `v0.1.12`
17
- - GitHub release: pending publish for `v0.1.12`
15
+ - publishability note: `0.14.0` is already published, so `0.14.0` is the next publishable package line
16
+ - git tag: `v0.14.0`
17
+ - GitHub release: pending publish for `v0.14.0`
18
18
 
19
19
  ## Production checklist
20
20
 
21
21
  - skills-first product identity: PASS
22
22
  - package/plugin identity aligned to `@jstn-sdk/ma`: PASS
23
- - version/tag alignment `0.1.12` / `v0.1.12`: PASS
23
+ - version/tag alignment `0.14.0` / `v0.14.0`: PASS
24
24
  - install/uninstall docs aligned: PASS
25
25
  - onboarding is concise and sequential: PASS
26
26
  - helper command documented as secondary: PASS
@@ -36,6 +36,7 @@ Target release state:
36
36
  - workflow/release/provenance docs aligned: PASS
37
37
  - no stale package names remain in tracked repo surfaces: PASS
38
38
  - no conflicting CLI-first product story remains in tracked product docs: PASS
39
+ - issue proof gates for `v0.14.0`: PASS; `release-issue-gates-0.14.0.json` marks issues `#13-#29` passed with implementation, verification, and production evidence, so release verification can enforce the gate artifact instead of blocking on pending issue states
39
40
 
40
41
  ## Automated checks run
41
42
 
@@ -65,6 +66,21 @@ That should prove:
65
66
  - the GitHub release asset set is complete
66
67
  - the packaged support bundle contains the playbooks and reference assets expected by the runtime
67
68
 
69
+ ## Issue proof gates
70
+
71
+ Issue gate artifact:
72
+
73
+ ```text
74
+ docs/qa/release-issue-gates-0.14.0.json
75
+ ```
76
+
77
+ Every open issue assigned to `v0.14.0` must remain in this file until it is production-passed. A passed issue requires:
78
+ - implementation evidence
79
+ - verification evidence
80
+ - production evidence
81
+
82
+ If any issue is `pending`, `in_progress`, `blocked`, or `failed`, `npm run release:verify` must fail and the issue must continue through its recorded loop action.
83
+
68
84
  ## Manual/behavioral checks run
69
85
 
70
86
  Canonical launch:
@@ -77,7 +93,7 @@ Helper-path validation:
77
93
 
78
94
  ```bash
79
95
  ma setup
80
- ma idea "Build a demo app"
96
+ ma idea "Harden Meta-Architect v0.14.0 semantic core with Obsidian vault context, Ralph execution proof, context economy, and package-gated release evidence"
81
97
  ma run '$arch'
82
98
  ma run '$sage'
83
99
  ma run '$flow'
@@ -0,0 +1,24 @@
1
+ # AI quality enforcement
2
+
3
+ Meta-Architect exposes `AIQualityOrchestrator` as a blocking policy boundary for generated code. It records bounded violation and KPI receipts under `.ma/quality/` and exposes them through the local MCP quality resources.
4
+
5
+ The default checks are deterministic source checks plus the installed Semgrep CLI. The orchestrator has no external provider or model configuration; security and architecture checks are local, deterministic, and fail closed when Semgrep is unavailable.
6
+
7
+ Every accepted generation must include approved test evidence. `testDrivenGeneration()` requires test generation, approval, code generation, execution, and at least 80% coverage before returning code.
8
+
9
+ ## Usage
10
+
11
+ ```js
12
+ import { AIQualityOrchestrator } from "@jstn-sdk/ma";
13
+
14
+ const quality = new AIQualityOrchestrator({ projectRoot: process.cwd() });
15
+ const result = await quality.validate(code, {
16
+ filePath: "src/example.ts",
17
+ hasTests: true,
18
+ testCoverage: 0.9,
19
+ });
20
+
21
+ if (!result.passed) throw new Error(result.reviewReason);
22
+ ```
23
+
24
+ The tracked Semgrep baseline is `templates/quality/ai-quality-rules.yml`; a project may provide a stricter `.ma/semgrep/ai-quality-rules.yml`.
@@ -19,3 +19,9 @@ Security-oriented external patterns are absorbed into Meta-Architect as `$vet` g
19
19
  ## Product rule
20
20
 
21
21
  Meta-Architect can absorb security arsenal patterns aggressively while still presenting them only as native guidance and packaged references.
22
+
23
+ ## Adversarial hardening
24
+
25
+ - For higher-risk changes, run a bounded adversarial hardening pass before final approval.
26
+ - Keep the hardening work inside the private scratchpad/runtime layer.
27
+ - Return structured findings, not direct gate mutations.
@@ -19,3 +19,9 @@ Meta-Architect uses external discovery surfaces as inputs to native source-selec
19
19
 
20
20
  - `$sage` owns source selection and evidence quality
21
21
  - helper skills can support preparation, but they do not replace `$sage`
22
+
23
+ ## Evidence grades
24
+
25
+ - `VERIFIED`: exact upstream mapping plus primary-source confirmation
26
+ - `PARTIAL`: candidate is mapped, but live proof or maturity proof is incomplete
27
+ - `MISSING`: no trustworthy exact upstream mapping yet
@@ -1,16 +1,17 @@
1
- # v0.1.12 Requirements & Rules
1
+ # v0.14.0 Requirements & Rules
2
2
 
3
3
  ## Production definition
4
4
 
5
- Meta-Architect `v0.1.12` is production only when:
5
+ Meta-Architect `v0.14.0` is production only when:
6
6
  1. the package/install surface works
7
7
  2. the in-session skill workflow from `$arch` through `$build` works
8
8
  3. the release evidence matches the actual package and git tag
9
9
 
10
- ## What `v0.1.12` must have
10
+ ## What `v0.14.0` must have
11
11
 
12
12
  ### 1. Canonical package/runtime path
13
13
 
14
+ - recommended POSIX install: download the latest installer and checksum through jsDelivr, verify the downloaded installer with `sha256sum -c`, then run `sh install.sh`
14
15
  - install: `npm i -g @openai/codex@latest @jstn-sdk/ma@latest`
15
16
  - optional helper launch: `ma --madmax --high`
16
17
  - uninstall Meta-Architect only: `npm uninstall -g @jstn-sdk/ma`
@@ -33,6 +34,10 @@ Helper commands remain available for setup and scripted validation:
33
34
  - `ma merge`
34
35
  - `ma release`
35
36
 
37
+ `ma merge` and `ma release` are approval-only by default. `--dry-run` performs
38
+ preflight without changing release state; `--execute` is the only mode that
39
+ runs the displayed `git merge --no-ff --no-edit -- <source>` command.
40
+
36
41
  ### 3. State and gate contract
37
42
 
38
43
  Canonical runtime namespace:
@@ -49,15 +54,16 @@ Canonical state files:
49
54
 
50
55
  ### 4. Required release evidence
51
56
 
52
- - `package.json` version `0.1.12`
53
- - git tag `v0.1.12`
57
+ - `package.json` version `0.14.0`
58
+ - git tag `v0.14.0`
54
59
  - `RELEASE.md`
55
60
  - `CHANGELOG.md`
56
- - `docs/qa/release-readiness-0.1.12.md`
61
+ - `docs/qa/release-readiness-0.14.0.md`
62
+ - `docs/qa/release-issue-gates-0.14.0.json`
57
63
  - green `npm run release:check`
58
- - GitHub release asset `meta-architect_0.1.12_all.deb`
59
- - GitHub release asset `meta-architect-0.1.12-1-any.pkg.tar.xz`
60
- - GitHub release asset `meta-architect-0.1.12-1.noarch.rpm`
64
+ - GitHub release asset `meta-architect_0.14.0_all.deb`
65
+ - GitHub release asset `meta-architect-0.14.0-1-any.pkg.tar.xz`
66
+ - GitHub release asset `meta-architect-0.14.0-1.noarch.rpm`
61
67
  - green `npm run linux:packages:build`
62
68
  - green `npm run linux:packages:smoke`
63
69
  - green `npm run release:assets`
@@ -81,7 +87,9 @@ Canonical state files:
81
87
  7. Build and smoke-check the Linux native packages on Linux:
82
88
  - `npm run linux:packages:build`
83
89
  - `npm run linux:packages:smoke`
84
- - `npm run release:assets`
90
+ - `npm run release:assets`
91
+ - `npm run release:assets:generate` creates `dist/SHA256SUMS`, `dist/sbom.spdx.json`, and `dist/release-summary.json`; `release:assets` verifies them.
92
+ - `dist/` is CI-generated and ignored by Git. GitHub Releases are the source of truth for downloadable packages; historical binaries are not retained in the repository.
85
93
  8. Create and push tag `v<version>`
86
94
  9. Preferred publish path: publish from `.github/workflows/npm-publish.yml` on a supported cloud runner so provenance can be generated
87
95
  10. Local shell fallback when not publishing from GitHub Actions or GitLab CI/CD:
@@ -97,8 +105,29 @@ Canonical state files:
97
105
  - `.github/workflows/release-sync.yml` automates the sync path on `main`
98
106
  - `.github/workflows/release-advance.yml` advances the repo to the next patch line after a published release
99
107
 
108
+ ### 6.2 Issue proof gates
109
+
110
+ Every open next-release issue must be represented in `docs/qa/release-issue-gates-0.14.0.json`.
111
+
112
+ Production pass rule:
113
+ - issue status must be `passed`
114
+ - issue milestone must match `v0.14.0`
115
+ - implementation evidence must be present
116
+ - verification evidence must be present
117
+ - production evidence must be present
118
+ - pending, blocked, failed, or in-progress issues must continue through their loop action instead of being treated as release-ready
119
+
120
+ `npm run release:verify` enforces this file. If any issue is not production-passed, the release remains blocked.
121
+
100
122
  ### 7. Provenance rule
101
123
 
102
124
  - `npm publish --provenance` is valid only from a supported cloud CI/CD provider
103
125
  - local shell publishes are expected to fail with `Automatic provenance generation not supported for provider: null`
104
126
  - use the repository publish workflow when provenance is part of the release bar
127
+ ## Package diagnostics
128
+
129
+ `npm run package:doctor` (or `npm run release:doctor`) checks maintainer-facing
130
+ release and package artifacts. It is distinct from `ma doctor`, which checks
131
+ installed/user environment health.
132
+ It is intentionally separate from `ma doctor`, which checks the installed
133
+ environment, runtime state, MCP readiness, and support bundle health.
package/docs/skills.md CHANGED
@@ -12,6 +12,13 @@ The package does not ship a separate `$meta-architect` in-session skill. `$maest
12
12
 
13
13
  Install the package once, start Codex context if needed, and use the skills directly in-session.
14
14
 
15
+ Recommended CLI install for macOS, Linux, WSL, and Git-Bash:
16
+
17
+ ```bash
18
+ # One-line install (POSIX shells only; use WSL/Git-Bash on Windows)
19
+ curl -fsSLo install.sh https://cdn.jsdelivr.net/gh/JustineDevs/meta-architect@latest/scripts/install.sh && curl -fsSLo install.sh.sha256 https://cdn.jsdelivr.net/gh/JustineDevs/meta-architect@latest/scripts/install.sh.sha256 && sed 's#scripts/install.sh#install.sh#' install.sh.sha256 | sha256sum -c - && sh install.sh
20
+ ```
21
+
15
22
  ```bash
16
23
  # Install
17
24
  npm i -g @openai/codex@latest @jstn-sdk/ma@latest
@@ -46,7 +53,10 @@ ma setup
46
53
  ma init
47
54
  ma idea "Build a product"
48
55
  ma status
56
+ ma status --maestro-view
57
+ ma verify --architect
49
58
  ma run '$arch'
59
+ ma run '$maestro' --auto-heal --parallel
50
60
  ```
51
61
 
52
62
  In-session skills are used inside the Codex conversation:
@@ -78,6 +88,8 @@ Manager contract:
78
88
  - `$maestro` is the only umbrella in-session surface
79
89
  - `$maestro` manages the next allowed step, but gated outputs still belong to `$arch -> $sage -> $flow -> $vet -> $vibe -> $build`
80
90
  - helper skills are publishable mirrors that can assist a lane, but they do not move release gates
91
+ - `ma run '$maestro' --auto-heal --parallel` enables the bounded runtime repair path and records conductor state in the private scratchpad layer when eligible
92
+ - `ma verify --architect` runs an external architect reviewer command when `MA_ARCHITECT_REVIEW_CMD` is configured
81
93
 
82
94
  ## Installed support bundle
83
95
 
@@ -105,6 +117,7 @@ Relevant packaged assets there include:
105
117
  - `plugins/meta-architect/`
106
118
  - `templates/`
107
119
  - native skill references such as `skills/maestro/references/`, `skills/sage/references/`, `skills/vet/references/`, `skills/align/references/`, and `skills/cleanup/references/`
120
+ - runtime scratchpad state such as `.ma/state/manager-runs.json` and `.ma/state/maestro-state.json` when local execution is active
108
121
 
109
122
  This exists so Meta-Architect can use relevant packaged files without guessing paths.
110
123
 
@@ -128,7 +141,7 @@ Every skill result must include:
128
141
  - `$vibe` -> `experience_status`
129
142
  - `$build` -> `build_status`
130
143
 
131
- Helper skills do not own release-state fields. They are publishable but non-gating, so they support the current lane and then hand work back to `$maestro` or the gated lane that owns the decision.
144
+ `$maestro` may dispatch a gated lane, but it does not own that lane's artifact or release-state field. Helper skills do not own release-state fields. They are publishable but non-gating, so they support the current lane and then hand work back to `$maestro` or the gated lane that owns the decision.
132
145
 
133
146
  ## Operator note
134
147
 
package/index.js CHANGED
@@ -1,21 +1,305 @@
1
+ export { qualityResources, queryQualityStatus, readQualityResource } from "./mcp/local/quality.js";
2
+ export {
3
+ agentRegistry as agentSurfaceRegistry,
4
+ detectInstalled,
5
+ getAgent,
6
+ getAgentInvocation,
7
+ getNonUniversalAgents,
8
+ isUniversalAgent as isUniversalAgentSurface,
9
+ listAgents,
10
+ resolveAgentCommand,
11
+ } from "./src/agents.js";
1
12
  export {
2
13
  evaluateBuildGate,
3
14
  formatBuildBlockers,
4
15
  formatNextAllowedTriggers,
5
16
  } from "./src/build-gate.js";
17
+ export {
18
+ CodexAppServerClient,
19
+ CodexRpcError,
20
+ createStdioTransport,
21
+ generateCodexBindings,
22
+ parseCodexJsonl,
23
+ runCodexExec,
24
+ validateStructuredResult,
25
+ } from "./src/codex-app-server.js";
6
26
  export {
7
27
  appendDecision,
8
28
  loadDecisionLog,
9
- updateDecisionStatuses,
10
29
  } from "./src/decision-log.js";
11
- export { isValidGitMcpEndpoint, loadMcpServers, validateMcpServers } from "./src/mcp-config.js";
30
+ export {
31
+ getSupportedLocalCapabilities,
32
+ isValidGitMcpEndpoint,
33
+ loadLocalCapabilities,
34
+ loadMcpServers,
35
+ runLocalCapabilityReadinessChecks,
36
+ validateLocalCapabilities,
37
+ validateMcpServers,
38
+ } from "./src/mcp-config.js";
12
39
  export {
13
40
  canMarkBuildDone,
14
41
  rejectsDirectProdPromotion,
15
42
  validateMergeTarget,
16
43
  validateReleaseOrigin,
17
44
  } from "./src/policy.js";
45
+ export {
46
+ AIQualityOrchestrator,
47
+ calculateQualityScore,
48
+ staticViolations,
49
+ } from "./src/quality/ai-quality-orchestrator.js";
18
50
  export { loadReleaseState, saveReleaseState, validateReleaseState } from "./src/release-state.js";
51
+ export {
52
+ classifyAutonomyBranch,
53
+ createDefaultActiveAutonomyCore,
54
+ detectPassivePermissionHandoff,
55
+ loadActiveAutonomyCore,
56
+ validateActiveAutonomyCore,
57
+ } from "./src/runtime/active-autonomy-core.js";
58
+ export {
59
+ agentCompatPackage,
60
+ agentCompatVersion,
61
+ compileAgentIntegrations,
62
+ detectAgentEnvironments,
63
+ listAgentCompatAdapters,
64
+ validateAgentIntegrations,
65
+ } from "./src/runtime/agent-compat.js";
66
+ export {
67
+ createAlignmentRecoveryPlan,
68
+ createDefaultAlignmentSentinelReport,
69
+ evaluateAlignmentDrift,
70
+ loadAlignmentSentinelReportOrDefault,
71
+ saveAlignmentSentinelReport,
72
+ } from "./src/runtime/alignment-sentinel.js";
73
+ export {
74
+ autonomousTaskSchemaVersion,
75
+ cancelAutonomousTask,
76
+ createTaskQueue,
77
+ enqueueAutonomousTasks,
78
+ getAutonomousTaskQueuePath,
79
+ loadTaskQueue,
80
+ parseTaskInput,
81
+ runAutonomousTasks,
82
+ saveTaskQueue,
83
+ seedAutonomousTaskArtifacts,
84
+ summarizeTasks,
85
+ validateTaskQueue,
86
+ } from "./src/runtime/autonomous-tasks.js";
87
+ export {
88
+ createCodeGraphTouchpoint,
89
+ createCodeGraphTouchpointFromFile,
90
+ createDefaultCodeGraphRehearse,
91
+ createRehearsalTrace,
92
+ extractStaticImports,
93
+ loadCodeGraphRehearse,
94
+ validateCodeGraphRehearse,
95
+ } from "./src/runtime/code-graph-rehearse.js";
96
+ export {
97
+ createContextEconomyPayload,
98
+ createContextEconomyView,
99
+ createDefaultContextEconomyCore,
100
+ createMcpDescriptorEconomy,
101
+ loadContextEconomyCore,
102
+ shouldBypassContextEconomy,
103
+ validateContextEconomyCore,
104
+ } from "./src/runtime/context-economy-core.js";
105
+ export {
106
+ continuityGraphSchemaVersion,
107
+ createDefaultContinuityGraph,
108
+ getContinuityGraphPath,
109
+ loadContinuityGraph,
110
+ mergeContinuityGraph,
111
+ queryContinuityGraph,
112
+ validateContinuityGraph,
113
+ } from "./src/runtime/continuity-graph.js";
114
+ export {
115
+ coreSourceDefinitions,
116
+ createDefaultCoreSourceIngest,
117
+ findIngestedCoreSourceForRepo,
118
+ ingestCoreSources,
119
+ loadCoreSourceIngest,
120
+ validateCoreSourceIngest,
121
+ } from "./src/runtime/core-source-ingest.js";
122
+ export {
123
+ createDefaultEnvironmentAwarenessCore,
124
+ createDiscoveredEnvironmentAwarenessCore,
125
+ createEnvironmentCapability,
126
+ discoverEnvironmentCapabilities,
127
+ loadEnvironmentAwarenessCore,
128
+ refreshEnvironmentAwarenessCore,
129
+ selectEnvironmentCapabilitiesForTask,
130
+ validateEnvironmentAwarenessCore,
131
+ } from "./src/runtime/environment-awareness-core.js";
132
+ export {
133
+ scanExposureProfile,
134
+ scanLockfilePackageExposure,
135
+ scanPackageExposureFromLockfile,
136
+ scanPackageExposureFromManifest,
137
+ validateMcpPolicyExposure,
138
+ } from "./src/runtime/exposure-catalog.js";
139
+ export {
140
+ chooseHelperRoute,
141
+ createDefaultHelperOrchestrationCore,
142
+ createHelperReceipt,
143
+ evaluateHelperCoreCoverage,
144
+ helperSkillNames,
145
+ loadHelperOrchestrationCore,
146
+ resolveHelperContract,
147
+ validateHelperOrchestrationCore,
148
+ } from "./src/runtime/helper-orchestration-core.js";
149
+ export {
150
+ addLearningRecord,
151
+ createDefaultLearningLoopCore,
152
+ createLearningRecord,
153
+ evaluateLearningLoopReadiness,
154
+ learningLoopDomains,
155
+ loadLearningLoopCore,
156
+ validateLearningLoopCore,
157
+ } from "./src/runtime/learning-loop-core.js";
158
+ export { verifyLiveAgentMatrix } from "./src/runtime/live-agent-verification.js";
159
+ export {
160
+ validateRuntimeMcpPolicy,
161
+ validateRuntimeMcpPolicyFile,
162
+ } from "./src/runtime/mcp-policy.js";
163
+ export {
164
+ appendObsidianOperationReceipt,
165
+ createDefaultObsidianBridge,
166
+ createDefaultObsidianVaultOperations,
167
+ createObsidianIntakeContext,
168
+ createObsidianNote,
169
+ createObsidianPluginRequest,
170
+ createObsidianVaultContext,
171
+ createObsidianVaultSnapshotExport,
172
+ deleteObsidianNote,
173
+ ensureObsidianGraphLinks,
174
+ indexObsidianVault,
175
+ listObsidianNotes,
176
+ loadObsidianBridge,
177
+ loadObsidianVaultIndex,
178
+ loadObsidianVaultOperations,
179
+ obsidianGraphMapNotePath,
180
+ readObsidianNote,
181
+ updateObsidianNote,
182
+ validateObsidianBridge,
183
+ validateObsidianVaultIndex,
184
+ validateObsidianVaultOperations,
185
+ writeObsidianVaultIndex,
186
+ } from "./src/runtime/obsidian-integration-core.js";
187
+ export {
188
+ applyObsidianFrontmatterAuthority,
189
+ createDefaultObsidianPluginBridgeManifest,
190
+ createObsidianMetadataGraph,
191
+ createObsidianSelectionContext,
192
+ drainObsidianPluginRequestQueue,
193
+ extractObsidianCanvasContext,
194
+ generateObsidianMarkdownLink,
195
+ installObsidianPlugin,
196
+ obsidianPluginActiveContextPath,
197
+ obsidianPluginAttachmentDir,
198
+ obsidianPluginId,
199
+ obsidianPluginName,
200
+ obsidianPluginQueuePath,
201
+ registerMetaArchitectObsidianPluginRuntime,
202
+ registerObsidianEventWatchers,
203
+ registerObsidianProtocolHandlers,
204
+ renameObsidianFileSafely,
205
+ writeObsidianAttachment,
206
+ } from "./src/runtime/obsidian-plugin-bridge.js";
207
+ export {
208
+ assertPiMaestroToolAllowed,
209
+ createPiMaestroCapabilityMapping,
210
+ createPiMaestroToolSurface,
211
+ isPiMaestroEnabled,
212
+ maestroGateLanes,
213
+ runPiMaestroExperimental,
214
+ } from "./src/runtime/pi-maestro-core.js";
215
+ export {
216
+ createDefaultPromptStrategyCore,
217
+ loadPromptStrategyCore,
218
+ resolvePromptStrategyForRole,
219
+ resolvePromptStrategyForSurface,
220
+ validatePromptStrategyCore,
221
+ } from "./src/runtime/prompt-strategy-core.js";
222
+ export {
223
+ createQuorumReviewReceipt,
224
+ evaluateQuorumVotes,
225
+ quorumDecisions,
226
+ } from "./src/runtime/quorum-review.js";
227
+ export {
228
+ appendRalphProgressEntry,
229
+ completeRalphStory,
230
+ createRalphIterationPlan,
231
+ createRalphPrdContract,
232
+ selectNextRalphStory,
233
+ validateRalphPrdContract,
234
+ writeRalphExecutionContract,
235
+ } from "./src/runtime/ralph-execution-core.js";
236
+ export {
237
+ loadRedactionVaultOrDefault,
238
+ maskSensitiveText,
239
+ redactProviderBoundPayload,
240
+ redactProviderBoundText,
241
+ seedRedactionVault,
242
+ } from "./src/runtime/redaction-gateway.js";
243
+ export {
244
+ createDefaultSemanticRecordingCore,
245
+ loadSemanticRecordingCore,
246
+ validateSemanticRecordingCore,
247
+ } from "./src/runtime/semantic-recording-core.js";
248
+ export {
249
+ agentRegistry,
250
+ createDefaultSkillsRegistryExport,
251
+ createHostInstallReceipt,
252
+ createSkillCompatibilityPayload,
253
+ createSkillLockEntry,
254
+ inspectSkillCompatibilityInstall,
255
+ isUniversalAgent,
256
+ loadSkillsRegistryExport,
257
+ renderSkillCompatibilitySkillMd,
258
+ resolveSkillInstallPlan,
259
+ validateSkillLockEntry,
260
+ validateSkillsRegistryExport,
261
+ verifyCrossAgentInstallMatrix,
262
+ writeSkillCompatibilityExport,
263
+ } from "./src/runtime/skills-registry-export.js";
264
+ export {
265
+ createDefaultUniversalPluginBrokerCore,
266
+ createUniversalPluginManifest,
267
+ detectInstalledPluginHosts,
268
+ injectAntigravityMcpServer,
269
+ injectClaudeCodeMcpServer,
270
+ injectCodexMcpServer,
271
+ injectCursorMcpServer,
272
+ injectPluginToVendors,
273
+ installUniversalPlugin,
274
+ loadUniversalPluginBrokerCore,
275
+ loadUniversalPluginManifest,
276
+ renderPluginContextSkillMd,
277
+ renderUniversalMcpServerTemplate,
278
+ validateUniversalPluginBrokerCore,
279
+ validateUniversalPluginManifest,
280
+ writePluginContextSkill,
281
+ } from "./src/runtime/universal-plugin-broker-core.js";
282
+ export {
283
+ addSemanticReceipt,
284
+ createDefaultCapabilityComposition,
285
+ createDefaultSemanticReceiptIndex,
286
+ createDefaultWorkspaceContextPack,
287
+ createDefaultWorkspaceEffectiveness,
288
+ createSemanticReceipt,
289
+ evaluateWorkspaceEffectiveness,
290
+ loadWorkspaceIntelligenceArtifacts,
291
+ validateCapabilityComposition,
292
+ validateSemanticReceiptIndex,
293
+ validateWorkspaceContextPack,
294
+ validateWorkspaceEffectiveness,
295
+ } from "./src/runtime/workspace-intelligence-runtime.js";
296
+ export {
297
+ createDefaultWorkspaceVirtualizer,
298
+ createVirtualVerificationReceipt,
299
+ createVirtualWorkspacePlan,
300
+ loadWorkspaceVirtualizer,
301
+ validateWorkspaceVirtualizer,
302
+ } from "./src/runtime/workspace-virtualizer.js";
19
303
  export {
20
304
  listSkills,
21
305
  runArch,
@@ -26,3 +310,12 @@ export {
26
310
  runVet,
27
311
  runVibe,
28
312
  } from "./src/skills.js";
313
+ export { loadCombinedState, syncStatusUpdates } from "./src/state-sync.js";
314
+ export {
315
+ measureWidth,
316
+ padCell,
317
+ renderGrid,
318
+ renderRow,
319
+ renderSeparatorLine,
320
+ } from "./src/tui/grid.js";
321
+ export { renderCheckGrid, renderReleaseGrid } from "./src/tui/status-grid.js";
@@ -10,12 +10,29 @@
10
10
  "java",
11
11
  "dotnet",
12
12
  "self-hosted",
13
- "system-design"
13
+ "system-design",
14
+ "obsidian-api-docs",
15
+ "obsidian-plugin-scaffold",
16
+ "prompt-techniques"
14
17
  ],
15
- "sage": ["meta-list", "typescript", "rust", "go", "python", "java", "dotnet", "self-hosted"],
16
- "vet": ["security"],
17
- "flow": [],
18
- "vibe": [],
19
- "build": []
18
+ "sage": [
19
+ "meta-list",
20
+ "typescript",
21
+ "rust",
22
+ "go",
23
+ "python",
24
+ "java",
25
+ "dotnet",
26
+ "self-hosted",
27
+ "system-design",
28
+ "obsidian-api-docs",
29
+ "obsidian-plugin-scaffold",
30
+ "context-economy",
31
+ "prompt-techniques"
32
+ ],
33
+ "vet": ["security", "context-economy", "prompt-techniques"],
34
+ "flow": ["system-design", "prompt-techniques"],
35
+ "vibe": ["obsidian-api-docs", "context-economy", "prompt-techniques"],
36
+ "build": ["system-design", "context-economy", "prompt-techniques"]
20
37
  }
21
38
  }
package/mcp/fallback.json CHANGED
File without changes