@jstn-sdk/ma 0.1.13 → 0.14.1

package/skills/maestro/SKILL.md

@@ -7,7 +7,7 @@ description: "Use when the user wants the singular Meta-Architect in-session aut
 
 ## Overview
 
-Use this skill inside Codex as the singular Meta-Architect umbrella surface and bounded autonomous manager. It inspects workflow state, chooses the smallest safe next step, manages the fixed gated design-and-review sequence one lane at a time, and routes helper handoffs when they are enough. There is no separate shipped `$meta-architect` skill.
+Use this skill inside Codex as the singular Meta-Architect umbrella surface and persistent autonomous manager. It accepts one task or a durable batch, inspects workflow state, chooses the smallest safe next step, manages the fixed gated design-and-review sequence, and keeps resuming eligible work until each task is completed, blocked, cancelled, or failed. It never invents a second umbrella command. There is no separate shipped `$meta-architect` skill.
 
 ## Workflow
 
@@ -30,6 +30,19 @@ Use this skill inside Codex as the singular Meta-Architect umbrella surface and
    - `$build`
 5. End with a clear result shape: decision, evidence, blockers, the lane assignment if any, and the exact next trigger.
 
+## Autonomous task loop
+
+For a task or batch, keep the manager loop active across turns:
+
+1. Normalize the request into the durable `.ma` task contract before dispatch.
+2. Discover the selected host, available skills, and required lane syntax without taking ownership of user-installed assets.
+3. Dispatch independent tasks with bounded concurrency and preserve dependency order for dependent tasks.
+4. Inspect, implement, test, review, repair, and verify. Route a failure back to its owning lane with the failure evidence attached.
+5. Persist checkpoints, receipts, and the next trigger after every transition so an interrupted process can resume safely.
+6. Continue unaffected batch tasks when one task is blocked, then return a batch summary with terminal states and unresolved blockers.
+
+Routine local work continues without asking for another prompt. Stop only for credentials, destructive actions, production or external mutations, explicit approval gates, unsafe commands, unavailable required providers, or missing verification evidence.
+
 ## Output
 
 Produce:
@@ -43,6 +56,9 @@ Produce:
 ## Rules
 
 - Prefer the smallest next step that moves the workflow forward safely.
+- Continue eligible work until the current task or batch reaches a terminal state; do not stop after a single successful lane.
+- Treat persisted `.ma` state as the source for resume, deduplication, dependency ordering, cancellation, and bounded retries.
+- Keep autonomous execution bounded by task dependencies, concurrency limits, deadlines, retry limits, and explicit safety gates.
 - Respect current gate state before recommending implementation or release work.
 - Be explicit when more evidence, planning, or validation is still needed.
 - Treat the in-session skill flow as primary. Use `ma ...` terminal helpers only when repo-local setup, inspection, or scripted state automation is explicitly the better support path.

package/skills/maestro/references/core-release-rules.md

@@ -8,6 +8,6 @@
   - `logic_status = GREEN`
   - `security_status = GREEN`
   - `experience_status = GREEN` or `WAIVED`
-- Feature work merges into `development`, never directly into `prod`.
-- Release promotion is allowed only from `development` or approved `release/*`.
+- Feature work merges into `dev`, never directly into `main`.
+- Release promotion is allowed only from `dev` or approved `release/*`.
 - Use the helper command path only when repo-local state automation is explicitly needed; otherwise stay inside Codex and carry the gate decisions in the session.

package/sprint/07-release.md

@@ -16,8 +16,8 @@ Move from completed bounded implementation to a controlled merge and release pat
 
 ## Exit criteria
 
-- merge follows `feature/* -> development`
-- release follows `development|release/* -> prod`
+- merge follows `feature/* -> dev`
+- release follows `dev|release/* -> main`
 
 ## Failure conditions
 

package/src/agents.js

@@ -0,0 +1,281 @@
+import path from "node:path";
+import { safeSpawnSync } from "./process-utils.js";
+
+const definitions = {
+  codex: {
+    id: "codex",
+    displayName: "Codex CLI",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.agents/skills",
+    isUniversal: true,
+    command: "codex",
+    surface: "cli",
+    vendor: "openai",
+    probeable: true,
+  },
+  "claude-code": {
+    id: "claude-code",
+    displayName: "Claude Code",
+    skillsDir: ".claude/skills",
+    globalSkillsDir: "~/.claude/skills",
+    isUniversal: false,
+    command: "claude",
+    surface: "cli",
+    vendor: "anthropic",
+    probeable: true,
+  },
+  cursor: {
+    id: "cursor",
+    displayName: "Cursor",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.agents/skills",
+    isUniversal: true,
+    command: "cursor",
+    surface: "ide",
+    vendor: "cursor",
+    probeable: true,
+  },
+  opencode: {
+    id: "opencode",
+    displayName: "OpenCode",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.config/opencode/skills",
+    isUniversal: true,
+    command: "opencode",
+    surface: "cli",
+    vendor: "sst",
+    probeable: true,
+  },
+  "gemini-cli": {
+    id: "gemini-cli",
+    displayName: "Gemini CLI",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.gemini/skills",
+    isUniversal: true,
+    command: "gemini",
+    surface: "cli",
+    vendor: "google",
+    probeable: true,
+  },
+  amp: {
+    id: "amp",
+    displayName: "Amp",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.config/agents/skills",
+    isUniversal: true,
+    command: "amp",
+    surface: "cli",
+    vendor: "sourcegraph",
+    probeable: true,
+  },
+  goose: {
+    id: "goose",
+    displayName: "Goose",
+    skillsDir: ".goose/skills",
+    globalSkillsDir: "~/.config/goose/skills",
+    isUniversal: false,
+    command: "goose",
+    surface: "cli",
+    vendor: "block",
+    probeable: true,
+  },
+  "hermes-agent": {
+    id: "hermes-agent",
+    displayName: "Hermes Agent",
+    skillsDir: ".hermes/skills",
+    globalSkillsDir: "~/.hermes/skills",
+    isUniversal: false,
+    command: "hermes",
+    surface: "cli",
+    vendor: "nous-research",
+    probeable: true,
+  },
+  pi: {
+    id: "pi",
+    displayName: "Pi Coding Agent",
+    skillsDir: ".pi/skills",
+    globalSkillsDir: "~/.pi/agent/skills",
+    isUniversal: false,
+    command: "pi",
+    surface: "cli",
+    vendor: "pi",
+    probeable: true,
+  },
+  windsurf: {
+    id: "windsurf",
+    displayName: "Windsurf",
+    skillsDir: ".windsurf/skills",
+    globalSkillsDir: "~/.codeium/windsurf/skills",
+    isUniversal: false,
+    command: null,
+    surface: "ide",
+    vendor: "windsurf",
+    probeable: false,
+  },
+  cline: {
+    id: "cline",
+    displayName: "Cline",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.agents/skills",
+    isUniversal: true,
+    command: null,
+    surface: "ide",
+    vendor: "cline",
+    probeable: false,
+  },
+  continue: {
+    id: "continue",
+    displayName: "Continue",
+    skillsDir: ".continue/skills",
+    globalSkillsDir: "~/.continue/skills",
+    isUniversal: false,
+    command: "continue",
+    surface: "ide",
+    vendor: "continue",
+    probeable: true,
+  },
+  roo: {
+    id: "roo",
+    displayName: "Roo Code",
+    skillsDir: ".roo/skills",
+    globalSkillsDir: "~/.roo/skills",
+    isUniversal: false,
+    command: null,
+    surface: "ide",
+    vendor: "roo-code",
+    probeable: false,
+  },
+  "kiro-cli": {
+    id: "kiro-cli",
+    displayName: "Kiro CLI",
+    skillsDir: ".kiro/skills",
+    globalSkillsDir: "~/.kiro/skills",
+    isUniversal: false,
+    command: "kiro",
+    surface: "ide",
+    vendor: "amazon",
+    probeable: true,
+  },
+  junie: {
+    id: "junie",
+    displayName: "Junie",
+    skillsDir: ".junie/skills",
+    globalSkillsDir: "~/.junie/skills",
+    isUniversal: false,
+    command: null,
+    surface: "ide",
+    vendor: "jetbrains",
+    probeable: false,
+  },
+  "github-copilot": {
+    id: "github-copilot",
+    displayName: "GitHub Copilot",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.copilot/skills",
+    isUniversal: true,
+    command: null,
+    surface: "ide",
+    vendor: "github",
+    probeable: false,
+  },
+  antigravity: {
+    id: "antigravity",
+    displayName: "Antigravity",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.gemini/antigravity/skills",
+    isUniversal: true,
+    command: null,
+    surface: "ide",
+    vendor: "google",
+    probeable: false,
+  },
+  universal: {
+    id: "universal",
+    displayName: "Universal Agent Skills",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: "~/.agents/skills",
+    isUniversal: true,
+    command: null,
+    surface: "generic",
+    vendor: "universal",
+    probeable: false,
+  },
+};
+
+export const agentRegistry = Object.freeze(
+  Object.fromEntries(
+    Object.entries(definitions).map(([id, definition]) => [id, Object.freeze(definition)]),
+  ),
+);
+
+export function getAgent(type = process.env.MA_AGENT || "codex") {
+  return agentRegistry[type] ?? agentRegistry.codex;
+}
+
+export function getNonUniversalAgents() {
+  return Object.values(agentRegistry).filter((agent) => !agent.isUniversal);
+}
+
+export function isUniversalAgent(type) {
+  return getAgent(type).isUniversal;
+}
+
+export function resolveAgentCommand(type = process.env.MA_AGENT || "codex") {
+  const agent = getAgent(type);
+  if (!agent.command) return null;
+  const envKey = `MA_${agent.id.replaceAll("-", "_").toUpperCase()}_BIN`;
+  return process.env[envKey]?.trim() || agent.command;
+}
+
+export function detectInstalled(type = process.env.MA_AGENT || "codex") {
+  const agent = getAgent(type);
+  const command = resolveAgentCommand(agent.id);
+  if (!command || !agent.probeable) {
+    return {
+      ...agent,
+      installed: false,
+      command: command ?? null,
+      version: "",
+      probe: "unsupported",
+    };
+  }
+  const script = [".js", ".mjs", ".cjs"].includes(path.extname(command));
+  const result = safeSpawnSync(
+    script ? process.execPath : command,
+    script ? [command, "--version"] : ["--version"],
+    {
+      encoding: "utf8",
+      shell: false,
+      timeout: 5_000,
+    },
+  );
+  return {
+    ...agent,
+    command,
+    installed: result.status === 0,
+    version: result.status === 0 ? result.stdout.trim() : "",
+    error: result.error?.message || result.stderr?.trim() || "",
+  };
+}
+
+export function listAgents() {
+  return Object.values(agentRegistry);
+}
+
+const slashInvocationAgents = new Set([
+  "cursor",
+  "windsurf",
+  "cline",
+  "continue",
+  "roo",
+  "kiro-cli",
+  "junie",
+  "github-copilot",
+  "antigravity",
+]);
+
+export function getAgentInvocation(type, command = "maestro") {
+  if (type === "codex") return `$${command}`;
+  if (slashInvocationAgents.has(type)) return `/${command}`;
+  return command;
+}