astrocode-workflow 0.1.2 → 0.1.4

package/dist/agents/prompts.d.ts

@@ -1,2 +1,2 @@
 export declare const BASE_ORCH_PROMPT = "You are Astro (Orchestrator) for Astrocode.\n\nMission:\n- Advance a deterministic pipeline: frame \u2192 plan \u2192 spec \u2192 implement \u2192 review \u2192 verify \u2192 close.\n- The SQLite DB is the source of truth. Prefer tools over prose.\n- Never narrate what prompts you received.\n- Keep outputs short; store large outputs as artifacts and reference paths.\n\nOperating rules:\n- Only start new runs when the user explicitly requests implementation, workflow management, or story processing.\n- Answer questions directly when possible without starting workflows.\n- Prefer calling astro_workflow_proceed (step/loop) and astro_status only when actively managing a workflow.\n- Delegate stage work only to the stage subagent matching the current stage.\n- If a stage subagent returns status=blocked, inject the BLOCKED directive and stop.\n- Never delegate from subagents (enforced by permissions).\n- Be discretionary: assess if the user's request requires workflow initiation or just information.\n";
-export declare const BASE_STAGE_PROMPT = "You are an Astro stage subagent.\n\nFollow the latest [SYSTEM DIRECTIVE: ASTROCODE \u2014 STAGE_*] you receive.\n\nOutput exactly:\n1) Baton markdown (short, structured)\n2) Valid ASTRO JSON between markers:\n<!-- ASTRO_JSON_BEGIN -->\n{...}\n<!-- ASTRO_JSON_END -->\n\nDo not narrate. If blocked, ask exactly ONE question and stop.\n";
+export declare const BASE_STAGE_PROMPT = "You are an Astro stage subagent.\n\nFollow the latest [SYSTEM DIRECTIVE: ASTROCODE \u2014 STAGE_*] you receive.\n\nOutput exactly:\n1) Baton markdown (short, structured)\n2) Valid ASTRO JSON between markers with ALL required fields:\n<!-- ASTRO_JSON_BEGIN -->\n{\n  \"stage_key\": \"CURRENT_STAGE\",\n  \"status\": \"ok\",\n  \"summary\": \"Brief summary of work done\",\n  \"decisions\": [\"Decision 1\", \"Decision 2\"],\n  \"next_actions\": [\"Action 1\", \"Action 2\"],\n  \"files\": [{\"path\": \"file.js\", \"kind\": \"file\"}],\n  \"evidence\": [{\"path\": \"test.js\", \"kind\": \"evidence\"}],\n  \"tasks\": [{\"title\": \"Task\", \"complexity\": 3}],\n  \"new_stories\": [{\"title\": \"Story\", \"body_md\": \"Desc\"}],\n  \"questions\": [],\n  \"metrics\": {\"lines\": 100}\n}\n<!-- ASTRO_JSON_END -->\n\nCRITICAL: Include stage_key, status, and summary in EVERY response. Use \"ok\" status unless blocked/failed.\n\nDo not narrate. If blocked, ask exactly ONE question and stop.\n";

package/dist/agents/prompts.js

@@ -21,10 +21,24 @@ Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive.
 
 Output exactly:
 1) Baton markdown (short, structured)
-2) Valid ASTRO JSON between markers:
+2) Valid ASTRO JSON between markers with ALL required fields:
 <!-- ASTRO_JSON_BEGIN -->
-{...}
+{
+  "stage_key": "CURRENT_STAGE",
+  "status": "ok",
+  "summary": "Brief summary of work done",
+  "decisions": ["Decision 1", "Decision 2"],
+  "next_actions": ["Action 1", "Action 2"],
+  "files": [{"path": "file.js", "kind": "file"}],
+  "evidence": [{"path": "test.js", "kind": "evidence"}],
+  "tasks": [{"title": "Task", "complexity": 3}],
+  "new_stories": [{"title": "Story", "body_md": "Desc"}],
+  "questions": [],
+  "metrics": {"lines": 100}
+}
 <!-- ASTRO_JSON_END -->
 
+CRITICAL: Include stage_key, status, and summary in EVERY response. Use "ok" status unless blocked/failed.
+
 Do not narrate. If blocked, ask exactly ONE question and stop.
 `;

package/dist/tools/stage.js

@@ -81,10 +81,10 @@ export function createAstroStageCompleteTool(opts) {
             }
             const parsed = parseStageOutputText(output_text);
             if (parsed.error || !parsed.astro_json) {
-                return `❌ Stage completion failed: ${parsed.error ?? "ASTRO JSON missing"}. Please ensure output includes proper JSON markers.`;
+                return `❌ JSON Parse Error: ${parsed.error ?? "ASTRO JSON missing"}. Ensure output includes <!-- ASTRO_JSON_BEGIN -->{...}<!-- ASTRO_JSON_END --> markers with valid JSON.`;
             }
             if (parsed.astro_json.stage_key !== sk) {
-                return `❌ Stage completion failed: ASTRO JSON stage_key mismatch (expected ${sk}, got ${parsed.astro_json.stage_key}).`;
+                return `❌ Stage Key Mismatch: ASTRO JSON has stage_key="${parsed.astro_json.stage_key}" but expected "${sk}". Update the JSON to match the current stage.`;
             }
             // Evidence requirement
             const evidenceRequired = (sk === "verify" && config.workflow.evidence_required.verify) ||

package/dist/tools/workflow.js

@@ -7,6 +7,19 @@ import { injectChatPrompt } from "../ui/inject";
 import { nowISO } from "../shared/time";
 import { newEventId } from "../state/ids";
 import { createToastManager } from "../ui/toasts";
+// Agent name mapping for case-sensitive resolution
+const STAGE_TO_AGENT_MAP = {
+    frame: "Frame",
+    plan: "Plan",
+    spec: "Spec",
+    implement: "Implement",
+    review: "Review",
+    verify: "Verify",
+    close: "Close"
+};
+function resolveAgentName(stageKey) {
+    return STAGE_TO_AGENT_MAP[stageKey] || "General";
+}
 function stageGoal(stage, cfg) {
     switch (stage) {
         case "frame":
@@ -111,7 +124,15 @@ export function createAstroWorkflowProceedTool(opts) {
                     const run = db.prepare("SELECT * FROM runs WHERE run_id=?").get(active.run_id);
                     const story = db.prepare("SELECT * FROM stories WHERE story_key=?").get(run.story_key);
                     // Mark stage started + set subagent_type to the stage agent.
-                    const agentName = next.stage_key;
+                    let agentName = resolveAgentName(next.stage_key);
+                    // Validate agent availability (check system config for registered agents)
+                    const systemConfig = ctx.config; // OpenCode's system config
+                    if (!systemConfig.agent || !systemConfig.agent[agentName]) {
+                        console.warn(`Agent ${agentName} not found in system config. Available agents:`, Object.keys(systemConfig.agent || {}));
+                        // Fallback to General
+                        agentName = "General";
+                    }
+                    console.log(`Delegating stage ${next.stage_key} to agent: ${agentName}`);
                     withTx(db, () => {
                         startStage(db, active.run_id, next.stage_key, { subagent_type: agentName });
                     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astrocode-workflow",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,7 +18,7 @@
   "dependencies": {
     "@opencode-ai/plugin": "^1.1.19",
     "@opencode-ai/sdk": "^1.1.19",
-    "astrocode-workflow": "0.1.1",
+    "astrocode-workflow": "^0.1.2",
     "jsonc-parser": "^3.2.0",
     "zod": "4.1.8"
   },

package/src/agents/prompts.ts

@@ -22,10 +22,24 @@ Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive.
 
 Output exactly:
 1) Baton markdown (short, structured)
-2) Valid ASTRO JSON between markers:
+2) Valid ASTRO JSON between markers with ALL required fields:
 <!-- ASTRO_JSON_BEGIN -->
-{...}
+{
+  "stage_key": "CURRENT_STAGE",
+  "status": "ok",
+  "summary": "Brief summary of work done",
+  "decisions": ["Decision 1", "Decision 2"],
+  "next_actions": ["Action 1", "Action 2"],
+  "files": [{"path": "file.js", "kind": "file"}],
+  "evidence": [{"path": "test.js", "kind": "evidence"}],
+  "tasks": [{"title": "Task", "complexity": 3}],
+  "new_stories": [{"title": "Story", "body_md": "Desc"}],
+  "questions": [],
+  "metrics": {"lines": 100}
+}
 <!-- ASTRO_JSON_END -->
 
+CRITICAL: Include stage_key, status, and summary in EVERY response. Use "ok" status unless blocked/failed.
+
 Do not narrate. If blocked, ask exactly ONE question and stop.
 `;

package/src/tools/stage.ts

@@ -94,11 +94,11 @@ export function createAstroStageCompleteTool(opts: { ctx: any; config: Astrocode
 
        const parsed = parseStageOutputText(output_text);
        if (parsed.error || !parsed.astro_json) {
-         return `❌ Stage completion failed: ${parsed.error ?? "ASTRO JSON missing"}. Please ensure output includes proper JSON markers.`;
+         return `❌ JSON Parse Error: ${parsed.error ?? "ASTRO JSON missing"}. Ensure output includes <!-- ASTRO_JSON_BEGIN -->{...}<!-- ASTRO_JSON_END --> markers with valid JSON.`;
        }
 
        if (parsed.astro_json.stage_key !== sk) {
-         return `❌ Stage completion failed: ASTRO JSON stage_key mismatch (expected ${sk}, got ${parsed.astro_json.stage_key}).`;
+         return `❌ Stage Key Mismatch: ASTRO JSON has stage_key="${parsed.astro_json.stage_key}" but expected "${sk}". Update the JSON to match the current stage.`;
        }
 
       // Evidence requirement

package/src/tools/workflow.ts

@@ -11,6 +11,21 @@ import { nowISO } from "../shared/time";
 import { newEventId } from "../state/ids";
 import { createToastManager } from "../ui/toasts";
 
+// Agent name mapping for case-sensitive resolution
+const STAGE_TO_AGENT_MAP: Record<string, string> = {
+  frame: "Frame",
+  plan: "Plan",
+  spec: "Spec",
+  implement: "Implement",
+  review: "Review",
+  verify: "Verify",
+  close: "Close"
+};
+
+function resolveAgentName(stageKey: string): string {
+  return STAGE_TO_AGENT_MAP[stageKey] || "General";
+}
+
 function stageGoal(stage: StageKey, cfg: AstrocodeConfig): string {
   switch (stage) {
     case "frame":
@@ -135,8 +150,19 @@ export function createAstroWorkflowProceedTool(opts: { ctx: any; config: Astroco
           const run = db.prepare("SELECT * FROM runs WHERE run_id=?").get(active.run_id) as any;
           const story = db.prepare("SELECT * FROM stories WHERE story_key=?").get(run.story_key) as any;
 
-           // Mark stage started + set subagent_type to the stage agent.
-           const agentName = next.stage_key;
+          // Mark stage started + set subagent_type to the stage agent.
+          let agentName = resolveAgentName(next.stage_key);
+
+          // Validate agent availability (check system config for registered agents)
+          const systemConfig = ctx.config; // OpenCode's system config
+          if (!systemConfig.agent || !systemConfig.agent[agentName]) {
+            console.warn(`Agent ${agentName} not found in system config. Available agents:`, Object.keys(systemConfig.agent || {}));
+            // Fallback to General
+            agentName = "General";
+          }
+
+          console.log(`Delegating stage ${next.stage_key} to agent: ${agentName}`);
+
           withTx(db, () => {
             startStage(db, active.run_id, next.stage_key, { subagent_type: agentName });
           });