@jstn-sdk/ma 0.1.11 → 0.1.12

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 (133) hide show
  1. package/.agents/plugins/marketplace.json +0 -0
  2. package/README.md +136 -29
  3. package/bin/ma.js +23 -67
  4. package/docs/README.md +4 -1
  5. package/docs/assets/image/Screenshot(1).png +0 -0
  6. package/docs/assets/image/Screenshot(2).png +0 -0
  7. package/docs/assets/image/Screenshot(3).png +0 -0
  8. package/docs/assets/image/Screenshot(4).png +0 -0
  9. package/docs/assets/image/Screenshot(5).png +0 -0
  10. package/docs/assets/image/Screenshot(6).png +0 -0
  11. package/docs/assets/image/Screenshot(7).png +0 -0
  12. package/docs/assets/image/Screenshot(8).png +0 -0
  13. package/docs/assets/image/Screenshot(9).png +0 -0
  14. package/docs/assets/meta-architect-logo.png +0 -0
  15. package/docs/assets/meta-architect-logo.svg +0 -0
  16. package/docs/getting-started.md +74 -19
  17. package/docs/installed-sdk.md +23 -0
  18. package/docs/mcp-setup.md +30 -1
  19. package/docs/qa/{release-readiness-0.1.11.md → release-readiness-0.1.12.md} +29 -8
  20. package/docs/qa/release-readiness-0.1.5.md +0 -0
  21. package/docs/reference/native-engineering-patterns.md +35 -0
  22. package/docs/reference/native-security-playbooks.md +21 -0
  23. package/docs/reference/native-source-selection.md +21 -0
  24. package/docs/reference/native-style-and-deslop.md +20 -0
  25. package/docs/release-spec.md +21 -10
  26. package/docs/skills-publishing.md +25 -1
  27. package/docs/skills.md +24 -12
  28. package/mcp/local/code-intel.js +113 -0
  29. package/mcp/local/memory.js +46 -0
  30. package/mcp/local/playbooks.js +168 -0
  31. package/mcp/local/state.js +71 -0
  32. package/mcp/local/team-run.js +66 -0
  33. package/mcp/local/trace.js +60 -0
  34. package/mcp/local-capabilities.json +56 -0
  35. package/mcp/native-playbooks.json +117 -0
  36. package/mcp/servers.json +10 -0
  37. package/package.json +4 -1
  38. package/plugins/meta-architect/.app.json +1 -1
  39. package/plugins/meta-architect/.codex-plugin/plugin.json +4 -4
  40. package/plugins/meta-architect/.mcp.json +1 -1
  41. package/plugins/meta-architect/README.md +27 -1
  42. package/plugins/meta-architect/skills/align/SKILL.md +24 -0
  43. package/plugins/meta-architect/skills/align/agents/openai.yaml +4 -0
  44. package/plugins/meta-architect/skills/align/references/shared-language.md +24 -0
  45. package/plugins/meta-architect/skills/arch/SKILL.md +0 -0
  46. package/plugins/meta-architect/skills/arch/agents/openai.yaml +0 -0
  47. package/plugins/meta-architect/skills/build/SKILL.md +0 -0
  48. package/plugins/meta-architect/skills/build/agents/openai.yaml +0 -0
  49. package/plugins/meta-architect/skills/cleanup/SKILL.md +23 -0
  50. package/plugins/meta-architect/skills/cleanup/agents/openai.yaml +4 -0
  51. package/plugins/meta-architect/skills/cleanup/references/style-and-deslop.md +18 -0
  52. package/plugins/meta-architect/skills/diagnose/SKILL.md +24 -0
  53. package/plugins/meta-architect/skills/diagnose/agents/openai.yaml +4 -0
  54. package/plugins/meta-architect/skills/flow/SKILL.md +0 -0
  55. package/plugins/meta-architect/skills/flow/agents/openai.yaml +0 -0
  56. package/plugins/meta-architect/skills/maestro/SKILL.md +36 -3
  57. package/plugins/meta-architect/skills/maestro/agents/openai.yaml +2 -2
  58. package/plugins/meta-architect/skills/{meta-architect → maestro}/references/core-release-rules.md +0 -0
  59. package/plugins/meta-architect/skills/maestro/references/native-ingest-map.md +44 -0
  60. package/plugins/meta-architect/skills/sage/SKILL.md +3 -1
  61. package/plugins/meta-architect/skills/sage/agents/openai.yaml +0 -0
  62. package/plugins/meta-architect/skills/sage/references/source-selection.md +28 -0
  63. package/plugins/meta-architect/skills/tdd/SKILL.md +24 -0
  64. package/plugins/meta-architect/skills/tdd/agents/openai.yaml +4 -0
  65. package/plugins/meta-architect/skills/vet/SKILL.md +3 -1
  66. package/plugins/meta-architect/skills/vet/agents/openai.yaml +0 -0
  67. package/plugins/meta-architect/skills/vet/references/security-playbooks.md +23 -0
  68. package/plugins/meta-architect/skills/vibe/SKILL.md +0 -0
  69. package/plugins/meta-architect/skills/vibe/agents/openai.yaml +0 -0
  70. package/scripts/biome-staged.js +0 -0
  71. package/scripts/build-linux-packages.mjs +328 -0
  72. package/scripts/doctor.js +19 -0
  73. package/scripts/linux-package-lib.mjs +40 -0
  74. package/scripts/linux-package-smoke.mjs +103 -0
  75. package/scripts/plugin-sync.js +0 -0
  76. package/scripts/postinstall.js +0 -0
  77. package/scripts/release-metadata.js +0 -0
  78. package/scripts/release-sync.js +13 -6
  79. package/scripts/release-verify.js +0 -0
  80. package/scripts/setup-npmrc.js +0 -0
  81. package/skills/align/SKILL.md +24 -0
  82. package/skills/align/agents/openai.yaml +4 -0
  83. package/skills/align/references/shared-language.md +24 -0
  84. package/skills/arch/SKILL.md +0 -0
  85. package/skills/arch/agents/openai.yaml +0 -0
  86. package/skills/build/SKILL.md +0 -0
  87. package/skills/build/agents/openai.yaml +0 -0
  88. package/skills/cleanup/SKILL.md +23 -0
  89. package/skills/cleanup/agents/openai.yaml +4 -0
  90. package/skills/cleanup/references/style-and-deslop.md +18 -0
  91. package/skills/diagnose/SKILL.md +24 -0
  92. package/skills/diagnose/agents/openai.yaml +4 -0
  93. package/skills/flow/SKILL.md +0 -0
  94. package/skills/flow/agents/openai.yaml +0 -0
  95. package/skills/index.json +21 -6
  96. package/skills/maestro/SKILL.md +36 -3
  97. package/skills/maestro/agents/openai.yaml +2 -2
  98. package/skills/{meta-architect → maestro}/references/core-release-rules.md +0 -0
  99. package/skills/maestro/references/native-ingest-map.md +44 -0
  100. package/skills/sage/SKILL.md +3 -1
  101. package/skills/sage/agents/openai.yaml +0 -0
  102. package/skills/sage/references/source-selection.md +28 -0
  103. package/skills/tdd/SKILL.md +24 -0
  104. package/skills/tdd/agents/openai.yaml +4 -0
  105. package/skills/vet/SKILL.md +3 -1
  106. package/skills/vet/agents/openai.yaml +0 -0
  107. package/skills/vet/references/security-playbooks.md +23 -0
  108. package/skills/vibe/SKILL.md +0 -0
  109. package/skills/vibe/agents/openai.yaml +0 -0
  110. package/src/bootstrap.js +124 -24
  111. package/src/decision-log.js +12 -9
  112. package/src/launcher.js +0 -0
  113. package/src/mcp-config.js +130 -8
  114. package/src/mcp-live-client.js +1 -1
  115. package/src/paths.js +33 -1
  116. package/src/release-state.js +30 -1
  117. package/src/runtime/build-readiness.js +38 -0
  118. package/src/runtime/continuity-notes.js +79 -0
  119. package/src/runtime/guidance-stack.js +42 -0
  120. package/src/runtime/maestro-manager.js +586 -0
  121. package/src/runtime/orchestrator.js +158 -0
  122. package/src/runtime/runtime-state.js +382 -0
  123. package/src/runtime/signal-hooks.js +52 -0
  124. package/src/runtime/startup-path.js +14 -0
  125. package/src/runtime/workspaces.js +25 -0
  126. package/src/runtime-artifacts.js +190 -30
  127. package/src/skill-installer.js +53 -5
  128. package/src/skills.js +633 -49
  129. package/src/state-sync.js +51 -8
  130. package/plugins/meta-architect/skills/meta-architect/SKILL.md +0 -32
  131. package/plugins/meta-architect/skills/meta-architect/agents/openai.yaml +0 -4
  132. package/skills/meta-architect/SKILL.md +0 -32
  133. package/skills/meta-architect/agents/openai.yaml +0 -4
package/src/state-sync.js CHANGED
@@ -1,15 +1,58 @@
1
- import { loadDecisionLog, updateDecisionStatuses } from "./decision-log.js";
2
- import { loadReleaseState, saveReleaseState } from "./release-state.js";
1
+ import { loadDecisionLog } from "./decision-log.js";
2
+ import { writeJson } from "./fs-utils.js";
3
+ import { getRuntimeWritePath } from "./paths.js";
4
+ import { allowedStatuses, loadReleaseStateOrDefault, saveReleaseState } from "./release-state.js";
5
+ import { loadManagerRunRegistryOrDefault } from "./runtime/maestro-manager.js";
6
+ import { guardLeaderMutation } from "./runtime/runtime-state.js";
3
7
 
4
- export async function syncStatusUpdates(statusUpdates) {
5
- const release = await loadReleaseState();
8
+ const publicStatusFields = new Set(Object.keys(allowedStatuses));
9
+
10
+ function validatePublicStatusUpdates(statusUpdates) {
11
+ if (!statusUpdates || typeof statusUpdates !== "object" || Array.isArray(statusUpdates)) {
12
+ throw new Error("Status updates must be an object");
13
+ }
14
+
15
+ const invalidFields = Object.keys(statusUpdates).filter(
16
+ (field) => !publicStatusFields.has(field),
17
+ );
18
+ if (invalidFields.length > 0) {
19
+ throw new Error(`Unknown release status field(s): ${invalidFields.join(", ")}`);
20
+ }
21
+ }
22
+
23
+ export async function syncStatusUpdates(statusUpdates, options = {}) {
24
+ validatePublicStatusUpdates(statusUpdates);
25
+ const guard = await guardLeaderMutation({
26
+ actor: options.actor,
27
+ kind: "release-status-update",
28
+ payload: statusUpdates,
29
+ });
30
+ if (!guard.allowed) {
31
+ return { proposed: true, proposalPath: guard.proposalPath };
32
+ }
33
+
34
+ const [release, decisions] = await Promise.all([loadReleaseStateOrDefault(), loadDecisionLog()]);
6
35
  const nextRelease = { ...release, ...statusUpdates };
7
36
  await saveReleaseState(nextRelease);
8
- await updateDecisionStatuses(statusUpdates);
9
- return nextRelease;
37
+
38
+ try {
39
+ for (const [field, value] of Object.entries(statusUpdates)) {
40
+ decisions[field] = value;
41
+ }
42
+ await writeJson(getRuntimeWritePath("decisions.json"), decisions);
43
+ } catch (error) {
44
+ await saveReleaseState(release);
45
+ throw error;
46
+ }
47
+
48
+ return { proposed: false, proposalPath: null, release: nextRelease };
10
49
  }
11
50
 
12
51
  export async function loadCombinedState() {
13
- const [release, decisions] = await Promise.all([loadReleaseState(), loadDecisionLog()]);
14
- return { release, decisions };
52
+ const [release, decisions, managerRuns] = await Promise.all([
53
+ loadReleaseStateOrDefault(),
54
+ loadDecisionLog(),
55
+ loadManagerRunRegistryOrDefault(),
56
+ ]);
57
+ return { release, decisions, managerRuns };
15
58
  }
@@ -1,32 +0,0 @@
1
- ---
2
- name: meta-architect
3
- description: "Use when the user wants the full Meta-Architect workflow inside Codex: architecture-first planning, evidence-backed OSS selection, logic review, security review, DX/UX review, and build readiness without leaving the Codex session."
4
- ---
5
-
6
- # Meta-Architect
7
-
8
- ## Overview
9
-
10
- Run the full Meta-Architect workflow inside Codex. Use this skill when the user wants the gated design-and-review sequence rather than a single specialist lane.
11
-
12
- ## Workflow
13
-
14
- 1. Start with `$arch` and turn the user's goal into a concrete architecture brief.
15
- 2. Continue with `$sage` to validate core stack choices against official docs or approved repo-backed sources.
16
- 3. Run `$flow` to map states, transitions, invariants, and blockers.
17
- 4. Run `$vet` to review trust boundaries, auth, data handling, and abuse paths.
18
- 5. Run `$vibe` to review developer and user experience quality.
19
- 6. Finish with `$build` to decide whether implementation is ready, what remains blocked, and what the exact next execution step should be.
20
-
21
- ## Rules
22
-
23
- - Stay inside Codex unless the user explicitly asks for repo-local helper commands.
24
- - Keep the workflow architecture-first. Do not jump into code before the architecture and review lanes are grounded.
25
- - Use approved discovery accelerators such as Ossium, Trendshift, Dev Hunt, Libraries.io, Open Hub, and Open-source Projects when you need faster OSS candidate discovery, then validate any promising project through upstream repos and official docs.
26
- - Keep the `$sage` order explicit: known upstream sources first, discovery accelerators second, exact repo mapping third, approval only after upstream verification.
27
- - Prefer official docs, upstream repos, and repo-configured GitMCP sources when validating tooling choices.
28
- - End each lane with a clear result shape: decision, evidence, blockers, and exact next trigger.
29
-
30
- ## References
31
-
32
- - For release gates and branch policy, read `references/core-release-rules.md`.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "$meta-architect"
3
- short_description: "Full Meta-Architect skill workflow"
4
- default_prompt: "Use $meta-architect to run the full Meta-Architect workflow inside Codex, then route through $arch, $sage, $flow, $vet, $vibe, and $build as needed."
@@ -1,32 +0,0 @@
1
- ---
2
- name: meta-architect
3
- description: "Use when the user wants the full Meta-Architect workflow inside Codex: architecture-first planning, evidence-backed OSS selection, logic review, security review, DX/UX review, and build readiness without leaving the Codex session."
4
- ---
5
-
6
- # Meta-Architect
7
-
8
- ## Overview
9
-
10
- Run the full Meta-Architect workflow inside Codex. Use this skill when the user wants the gated design-and-review sequence rather than a single specialist lane.
11
-
12
- ## Workflow
13
-
14
- 1. Start with `$arch` and turn the user's goal into a concrete architecture brief.
15
- 2. Continue with `$sage` to validate core stack choices against official docs or approved repo-backed sources.
16
- 3. Run `$flow` to map states, transitions, invariants, and blockers.
17
- 4. Run `$vet` to review trust boundaries, auth, data handling, and abuse paths.
18
- 5. Run `$vibe` to review developer and user experience quality.
19
- 6. Finish with `$build` to decide whether implementation is ready, what remains blocked, and what the exact next execution step should be.
20
-
21
- ## Rules
22
-
23
- - Stay inside Codex unless the user explicitly asks for repo-local helper commands.
24
- - Keep the workflow architecture-first. Do not jump into code before the architecture and review lanes are grounded.
25
- - Use approved discovery accelerators such as Ossium, Trendshift, Dev Hunt, Libraries.io, Open Hub, and Open-source Projects when you need faster OSS candidate discovery, then validate any promising project through upstream repos and official docs.
26
- - Keep the `$sage` order explicit: known upstream sources first, discovery accelerators second, exact repo mapping third, approval only after upstream verification.
27
- - Prefer official docs, upstream repos, and repo-configured GitMCP sources when validating tooling choices.
28
- - End each lane with a clear result shape: decision, evidence, blockers, and exact next trigger.
29
-
30
- ## References
31
-
32
- - For release gates and branch policy, read `references/core-release-rules.md`.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "$meta-architect"
3
- short_description: "Full Meta-Architect skill workflow"
4
- default_prompt: "Use $meta-architect to run the full Meta-Architect workflow inside Codex, then route through $arch, $sage, $flow, $vet, $vibe, and $build as needed."