@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.
- package/.codex/agents/Architect.toml +1 -2
- package/.codex/agents/Auditor.toml +1 -2
- package/.codex/agents/Builder.toml +1 -2
- package/.codex/agents/Flow.toml +1 -2
- package/.codex/agents/Sage.toml +1 -2
- package/.codex/agents/Vibe.toml +1 -2
- package/.codex/hooks.json +24 -13
- package/.codex/prompts/enforcement.md +4 -0
- package/.codex/prompts/onboarding.md +6 -1
- package/.codex/prompts/release-rules.md +0 -0
- package/.codex/prompts/skill-contract.md +4 -0
- package/COVERAGE.md +211 -0
- package/DEMO.md +274 -0
- package/LICENSE +0 -0
- package/README.md +132 -656
- package/bin/ma.js +748 -55
- package/data/clone-data.ledger.json +41 -0
- package/data/clone-data.proof.json +50 -0
- package/data/clone-data.rvf +37 -0
- package/docs/README.md +10 -1
- package/docs/autonomous-tasks.md +46 -0
- package/docs/codex-integration.md +16 -0
- package/docs/getting-started.md +62 -22
- package/docs/mcp-setup.md +64 -0
- package/docs/qa/release-issue-gates-0.14.0.json +644 -0
- package/docs/qa/release-readiness-0.1.5.md +1 -1
- package/docs/qa/{release-readiness-0.1.12.md → release-readiness-0.14.0.md} +25 -9
- package/docs/quality.md +24 -0
- package/docs/reference/native-security-playbooks.md +6 -0
- package/docs/reference/native-source-selection.md +6 -0
- package/docs/release-spec.md +39 -10
- package/docs/skills.md +14 -1
- package/index.js +295 -2
- package/mcp/collections.json +23 -6
- package/mcp/fallback.json +0 -0
- package/mcp/local/code-intel.js +179 -41
- package/mcp/local/context.js +180 -0
- package/mcp/local/memory.js +17 -6
- package/mcp/local/quality.js +39 -0
- package/mcp/local/state.js +7 -3
- package/mcp/local/team-run.js +56 -4
- package/mcp/local-capabilities.json +9 -0
- package/mcp/servers.json +24 -0
- package/package.json +29 -4
- package/plugins/meta-architect/.app.json +1 -1
- package/plugins/meta-architect/.codex-plugin/plugin.json +1 -1
- package/plugins/meta-architect/.mcp.json +1 -1
- package/plugins/meta-architect/README.md +8 -1
- package/plugins/meta-architect/obsidian/main.js +534 -0
- package/plugins/meta-architect/obsidian/manifest.json +9 -0
- package/plugins/meta-architect/obsidian/styles.css +7 -0
- package/plugins/meta-architect/skills/arch/SKILL.md +2 -0
- package/plugins/meta-architect/skills/build/SKILL.md +3 -0
- package/plugins/meta-architect/skills/flow/SKILL.md +2 -0
- package/plugins/meta-architect/skills/sage/SKILL.md +2 -0
- package/plugins/meta-architect/skills/sage/references/source-selection.md +8 -0
- package/plugins/meta-architect/skills/vet/SKILL.md +2 -0
- package/plugins/meta-architect/skills/vet/references/security-playbooks.md +7 -0
- package/plugins/meta-architect/skills/vibe/SKILL.md +2 -0
- package/schemas/autonomous-task-queue.schema.json +56 -0
- package/schemas/handoff-packet.schema.json +36 -0
- package/schemas/setup-receipt.schema.json +28 -0
- package/schemas/skill-frontmatter.schema.json +20 -0
- package/schemas/support-bundle.schema.json +37 -0
- package/schemas/task-contract.schema.json +31 -0
- package/scripts/active-autonomy-hook.mjs +226 -0
- package/scripts/build-linux-packages.mjs +7 -3
- package/scripts/cleanup-test-fixtures.sh +55 -0
- package/scripts/context-hydration-hook.mjs +89 -0
- package/scripts/demo-smoke.js +285 -0
- package/scripts/doctor.js +27 -12
- package/scripts/install.sh +57 -0
- package/scripts/install.sh.sha256 +1 -0
- package/scripts/linux-package-smoke.mjs +2 -2
- package/scripts/package-size-check.mjs +26 -0
- package/scripts/plugin-sync.js +83 -17
- package/scripts/postinstall.js +17 -10
- package/scripts/prepack.js +9 -0
- package/scripts/ralph/prompt.md +35 -0
- package/scripts/release-sync.js +72 -7
- package/scripts/release-verify.js +260 -2
- package/scripts/setup-npmrc.js +48 -23
- package/scripts/skills-install.js +9 -2
- package/scripts/skills-manifest.js +2 -21
- package/scripts/skills-pack.js +2 -2
- package/scripts/skills-validate.js +5 -55
- package/skills/arch/SKILL.md +2 -0
- package/skills/build/SKILL.md +3 -0
- package/skills/flow/SKILL.md +2 -0
- package/skills/index.json +0 -0
- package/skills/sage/SKILL.md +2 -0
- package/skills/sage/references/source-selection.md +8 -0
- package/skills/vet/SKILL.md +2 -0
- package/skills/vet/references/security-playbooks.md +7 -0
- package/skills/vibe/SKILL.md +2 -0
- package/sprint/00-idea.md +0 -0
- package/sprint/01-architecture.md +0 -0
- package/sprint/02-oss-evidence.md +0 -0
- package/sprint/03-logic.md +0 -0
- package/sprint/04-security.md +0 -0
- package/sprint/05-dx-ux.md +0 -0
- package/sprint/06-build-plan.md +0 -0
- package/sprint/07-release.md +0 -0
- package/src/agents.js +279 -0
- package/src/bootstrap.js +268 -62
- package/src/build-gate.js +2 -2
- package/src/codex-app-server.js +291 -0
- package/src/decision-log.js +0 -0
- package/src/fs-utils.js +175 -4
- package/src/launcher.js +28 -21
- package/src/mcp-config.js +9 -1
- package/src/mcp-live-client.js +422 -3
- package/src/paths.js +10 -1
- package/src/policy.js +3 -3
- package/src/prelaunch.js +189 -0
- package/src/quality/ai-quality-orchestrator.js +328 -0
- package/src/release-issue-gates.js +252 -0
- package/src/release-operations.js +62 -0
- package/src/release-state.js +0 -0
- package/src/runtime/active-autonomy-core.js +208 -0
- package/src/runtime/agent-compat.js +31 -0
- package/src/runtime/alignment-sentinel.js +165 -0
- package/src/runtime/architect-review.js +326 -0
- package/src/runtime/autonomous-tasks.js +408 -0
- package/src/runtime/build-readiness.js +28 -4
- package/src/runtime/code-graph-rehearse.js +113 -0
- package/src/runtime/codeburn-core.js +112 -0
- package/src/runtime/context-authority.js +40 -0
- package/src/runtime/context-economy-core.js +316 -0
- package/src/runtime/continuity-graph.js +201 -0
- package/src/runtime/continuity-notes.js +71 -26
- package/src/runtime/core-source-ingest.js +379 -0
- package/src/runtime/detached-provider.js +142 -0
- package/src/runtime/doctor-report.js +18 -0
- package/src/runtime/environment-awareness-core.js +460 -0
- package/src/runtime/exposure-catalog.js +276 -0
- package/src/runtime/graphify-core.js +167 -0
- package/src/runtime/guidance-stack.js +9 -2
- package/src/runtime/handoff-packets.js +92 -0
- package/src/runtime/headroom-core.js +104 -0
- package/src/runtime/helper-orchestration-core.js +307 -0
- package/src/runtime/hook-profiles.js +20 -0
- package/src/runtime/learning-loop-core.js +344 -0
- package/src/runtime/live-agent-verification.js +122 -0
- package/src/runtime/maestro-events.js +18 -0
- package/src/runtime/maestro-manager.js +19 -0
- package/src/runtime/maestro-output.js +58 -0
- package/src/runtime/maestro-state.js +125 -0
- package/src/runtime/managed-markdown.js +29 -0
- package/src/runtime/mcp-authority.js +147 -0
- package/src/runtime/mcp-policy.js +192 -0
- package/src/runtime/obsidian-integration-core.js +1089 -0
- package/src/runtime/obsidian-plugin-bridge.js +1045 -0
- package/src/runtime/pi-maestro-core.js +89 -0
- package/src/runtime/preferences.js +79 -0
- package/src/runtime/project-context.js +636 -0
- package/src/runtime/prompt-strategy-core.js +230 -0
- package/src/runtime/quorum-review.js +90 -0
- package/src/runtime/ralph-execution-core.js +217 -0
- package/src/runtime/redaction-gateway.js +373 -0
- package/src/runtime/runtime-state.js +935 -2
- package/src/runtime/schema-migrations.js +162 -0
- package/src/runtime/semantic-recording-core.js +147 -0
- package/src/runtime/signal-hooks.js +28 -0
- package/src/runtime/skills-registry-export.js +754 -0
- package/src/runtime/task-contracts.js +83 -0
- package/src/runtime/universal-plugin-broker-core.js +898 -0
- package/src/runtime/workspace-intelligence-runtime.js +674 -0
- package/src/runtime/workspace-virtualizer.js +102 -0
- package/src/runtime-artifacts.js +225 -62
- package/src/setup-lifecycle.js +359 -0
- package/src/skill-frontmatter.js +78 -0
- package/src/skill-installer.js +226 -71
- package/src/skills.js +1166 -96
- package/src/state-sync.js +0 -0
- package/src/test-fixtures.js +543 -0
- package/src/tui/grid.js +67 -0
- package/src/tui/status-grid.js +23 -0
- package/support-bundle.json +114 -0
- package/templates/AGENTS.md +6 -2
- package/templates/catalog-manifest.json +0 -0
- package/templates/model-instructions/core.md +0 -0
- package/templates/model-instructions/release.md +0 -0
- package/templates/model-instructions/security.md +0 -0
- package/templates/quality/ai-quality-rules.yml +37 -0
- package/docs/assets/image/Screenshot(1).png +0 -0
- package/docs/assets/image/Screenshot(2).png +0 -0
- package/docs/assets/image/Screenshot(3).png +0 -0
- package/docs/assets/image/Screenshot(4).png +0 -0
- package/docs/assets/image/Screenshot(5).png +0 -0
- package/docs/assets/image/Screenshot(6).png +0 -0
- package/docs/assets/image/Screenshot(7).png +0 -0
- package/docs/assets/image/Screenshot(8).png +0 -0
- package/docs/assets/image/Screenshot(9).png +0 -0
- package/docs/assets/meta-architect-logo.png +0 -0
- package/docs/assets/meta-architect-logo.svg +0 -8
- package/docs/onboarding.md +0 -65
- package/docs/skills-publishing.md +0 -255
|
@@ -1,26 +1,26 @@
|
|
|
1
|
-
# Release Readiness 0.
|
|
1
|
+
# Release Readiness 0.14.0
|
|
2
2
|
|
|
3
3
|
## Production bar
|
|
4
4
|
|
|
5
|
-
`v0.
|
|
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.
|
|
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.
|
|
13
|
+
- npm package: `@jstn-sdk/ma@0.14.0`
|
|
14
14
|
- npm registry state: pending publish
|
|
15
|
-
- publishability note:
|
|
16
|
-
- git tag: `v0.
|
|
17
|
-
- GitHub release: pending publish for `v0.
|
|
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.
|
|
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 "
|
|
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'
|
package/docs/quality.md
ADDED
|
@@ -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
|
package/docs/release-spec.md
CHANGED
|
@@ -1,16 +1,17 @@
|
|
|
1
|
-
# v0.
|
|
1
|
+
# v0.14.0 Requirements & Rules
|
|
2
2
|
|
|
3
3
|
## Production definition
|
|
4
4
|
|
|
5
|
-
Meta-Architect `v0.
|
|
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.
|
|
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.
|
|
53
|
-
- git tag `v0.
|
|
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.
|
|
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.
|
|
59
|
-
- GitHub release asset `meta-architect-0.
|
|
60
|
-
- GitHub release asset `meta-architect-0.
|
|
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
|
-
|
|
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 {
|
|
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";
|
package/mcp/collections.json
CHANGED
|
@@ -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": [
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
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
|