astrocode-workflow 0.1.18 → 0.1.20

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 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";
+export declare const BASE_STAGE_PROMPT = "You are an Astro stage subagent.\n\n***CRITICAL: Follow the latest [SYSTEM DIRECTIVE: ASTROCODE \u2014 STAGE_*] you receive EXACTLY.***\n\nYour output MUST be in this EXACT format (no deviations):\n\n1) First, a short baton markdown summary (1-3 sentences).\n\n2) Then, immediately after, the ASTRO JSON markers with valid JSON:\n\n<!-- ASTRO_JSON_BEGIN -->\n{\n  \"schema_version\": 1,\n  \"stage_key\": \"CURRENT_STAGE\",\n  \"status\": \"ok\",\n  \"summary\": \"Brief summary\",\n  \"decisions\": [],\n  \"next_actions\": [],\n  \"tasks\": [],\n  \"files\": [],\n  \"evidence\": [],\n  \"new_stories\": [],\n  \"questions\": [],\n  \"metrics\": {}\n}\n<!-- ASTRO_JSON_END -->\n\nMANDATORY RULES:\n- ALL fields above MUST be present (use empty arrays/objects if no data)\n- stage_key MUST be \"CURRENT_STAGE\" (will be replaced)\n- status MUST be \"ok\" unless blocked/failed\n- summary MUST be a string describing the work\n- JSON MUST be valid and parseable\n- Markers MUST be exact as shown\n\nIf blocked, set status=\"blocked\" and put ONE question in questions array. Do not output anything else.\n";

package/dist/agents/prompts.js

@@ -17,28 +17,38 @@ Operating rules:
 `;
 export const BASE_STAGE_PROMPT = `You are an Astro stage subagent.
 
-Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive.
+***CRITICAL: Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive EXACTLY.***
+
+Your output MUST be in this EXACT format (no deviations):
+
+1) First, a short baton markdown summary (1-3 sentences).
+
+2) Then, immediately after, the ASTRO JSON markers with valid JSON:
 
-Output exactly:
-1) Baton markdown (short, structured)
-2) Valid ASTRO JSON between markers with ALL required fields:
 <!-- ASTRO_JSON_BEGIN -->
 {
+  "schema_version": 1,
   "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"}],
+  "summary": "Brief summary",
+  "decisions": [],
+  "next_actions": [],
+  "tasks": [],
+  "files": [],
+  "evidence": [],
+  "new_stories": [],
   "questions": [],
-  "metrics": {"lines": 100}
+  "metrics": {}
 }
 <!-- ASTRO_JSON_END -->
 
-CRITICAL: Include stage_key, status, and summary in EVERY response. Use "ok" status unless blocked/failed.
+MANDATORY RULES:
+- ALL fields above MUST be present (use empty arrays/objects if no data)
+- stage_key MUST be "CURRENT_STAGE" (will be replaced)
+- status MUST be "ok" unless blocked/failed
+- summary MUST be a string describing the work
+- JSON MUST be valid and parseable
+- Markers MUST be exact as shown
 
-Do not narrate. If blocked, ask exactly ONE question and stop.
+If blocked, set status="blocked" and put ONE question in questions array. Do not output anything else.
 `;

package/dist/tools/stage.js

@@ -117,7 +117,29 @@ export function createAstroStageCompleteTool(opts) {
             }
             const parsed = parseStageOutputText(output_text);
             if (parsed.error || !parsed.astro_json) {
-                return `❌ JSON Parse Error: ${parsed.error ?? "ASTRO JSON missing"}. Ensure output includes <!-- ASTRO_JSON_BEGIN -->{...}<!-- ASTRO_JSON_END --> markers with valid JSON.`;
+                return `❌ JSON Parse Error: ${parsed.error ?? "ASTRO JSON missing"}.
+
+Expected format:
+1) Narrative summary (optional)
+2) Valid JSON between markers:
+<!-- ASTRO_JSON_BEGIN -->
+{
+  "schema_version": 1,
+  "stage_key": "${sk}",
+  "status": "ok",
+  "summary": "Brief summary",
+  "decisions": [],
+  "next_actions": [],
+  "tasks": [],
+  "files": [],
+  "evidence": [],
+  "new_stories": [],
+  "questions": [],
+  "metrics": {}
+}
+<!-- ASTRO_JSON_END -->
+
+Ensure JSON has required fields (stage_key, status) and valid syntax.`;
             }
             if (parsed.astro_json.stage_key !== sk) {
                 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.`;

package/dist/tools/workflow.js

@@ -6,6 +6,7 @@ import { buildStageDirective, directiveHash } from "../workflow/directives";
 import { injectChatPrompt } from "../ui/inject";
 import { nowISO } from "../shared/time";
 import { newEventId } from "../state/ids";
+import { debug } from "../shared/log";
 import { createToastManager } from "../ui/toasts";
 // Agent name mapping for case-sensitive resolution
 const STAGE_TO_AGENT_MAP = {
@@ -63,7 +64,7 @@ function agentNameForStage(stage, cfg) {
 function buildDelegationPrompt(opts) {
     const { stageDirective, run_id, stage_key, stage_agent_name } = opts;
     const stageUpper = stage_key.toUpperCase();
-    return [
+    const prompt = [
         `[SYSTEM DIRECTIVE: ASTROCODE — DELEGATE_STAGE_${stageUpper}]`,
         ``,
         `Do this now, in order:`,
@@ -81,6 +82,9 @@ function buildDelegationPrompt(opts) {
         ``,
         `Important: do NOT do any stage work yourself in orchestrator mode.`,
     ].join("\n").trim();
+    // Debug log the delegation prompt to troubleshoot agent output issues
+    debug(`Delegating stage ${stage_key} to agent ${stage_agent_name}`, { prompt_length: prompt.length });
+    return prompt;
 }
 export function createAstroWorkflowProceedTool(opts) {
     const { ctx, config, db, agents } = opts;

package/dist/workflow/baton.js

@@ -1,5 +1,6 @@
 import { clampLines, normalizeNewlines, stripCodeFences } from "../shared/text";
 import { z, ZodError } from "zod";
+import { debug } from "../shared/log";
 export const ASTRO_JSON_BEGIN = "<!-- ASTRO_JSON_BEGIN -->";
 export const ASTRO_JSON_END = "<!-- ASTRO_JSON_END -->";
 export const StageKeySchema = z.enum(["frame", "plan", "spec", "implement", "review", "verify", "close"]);
@@ -40,28 +41,46 @@ export function parseStageOutputText(text) {
     const norm = normalizeNewlines(text ?? "").trim();
     const beginIdx = norm.indexOf(ASTRO_JSON_BEGIN);
     const endIdx = norm.indexOf(ASTRO_JSON_END);
+    let baton_md = "";
+    let jsonRaw = "";
+    let fallbackUsed = false;
     if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+        // Fallback: if no markers, check if the entire text is JSON
+        try {
+            const parsed = JSON.parse(norm);
+            const astroJson = AstroJsonSchema.parse(parsed);
+            debug("Used JSON fallback parsing (no markers found)", { stage_key: astroJson.stage_key });
+            return {
+                baton_md: "",
+                astro_json: astroJson,
+                astro_json_raw: norm,
+                error: null
+            };
+        }
+        catch (e) {
+            // Not JSON, proceed with marker error
+        }
         return {
             baton_md: norm,
             astro_json: null,
             astro_json_raw: null,
-            error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}`,
+            error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}. If output is pure JSON, ensure it's wrapped in markers.`,
         };
     }
     const before = norm.slice(0, beginIdx).trim();
-    const jsonRaw = norm.slice(beginIdx + ASTRO_JSON_BEGIN.length, endIdx).trim();
+    jsonRaw = norm.slice(beginIdx + ASTRO_JSON_BEGIN.length, endIdx).trim();
     const after = norm.slice(endIdx + ASTRO_JSON_END.length).trim();
-    const baton = [before, after].filter(Boolean).join("\n\n").trim();
+    baton_md = [before, after].filter(Boolean).join("\n\n").trim();
     try {
         const cleaned = stripCodeFences(jsonRaw).trim();
         const parsed = JSON.parse(cleaned);
         const astroJson = AstroJsonSchema.parse(parsed);
-        return { baton_md: baton, astro_json: astroJson, astro_json_raw: cleaned, error: null };
+        return { baton_md, astro_json: astroJson, astro_json_raw: cleaned, error: null };
     }
     catch (e) {
         if (e instanceof ZodError) {
             return {
-                baton_md: baton,
+                baton_md,
                 astro_json: null,
                 astro_json_raw: jsonRaw,
                 error: `Schema validation failed: ${e.message}. Ensure JSON conforms to ASTRO schema with required fields like stage_key, status, etc.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astrocode-workflow",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "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.17",
+    "astrocode-workflow": "^0.1.18",
     "jsonc-parser": "^3.2.0",
     "zod": "4.1.8"
   },

package/src/agents/prompts.ts

@@ -18,28 +18,38 @@ Operating rules:
 
 export const BASE_STAGE_PROMPT = `You are an Astro stage subagent.
 
-Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive.
+***CRITICAL: Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive EXACTLY.***
+
+Your output MUST be in this EXACT format (no deviations):
+
+1) First, a short baton markdown summary (1-3 sentences).
+
+2) Then, immediately after, the ASTRO JSON markers with valid JSON:
 
-Output exactly:
-1) Baton markdown (short, structured)
-2) Valid ASTRO JSON between markers with ALL required fields:
 <!-- ASTRO_JSON_BEGIN -->
 {
+  "schema_version": 1,
   "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"}],
+  "summary": "Brief summary",
+  "decisions": [],
+  "next_actions": [],
+  "tasks": [],
+  "files": [],
+  "evidence": [],
+  "new_stories": [],
   "questions": [],
-  "metrics": {"lines": 100}
+  "metrics": {}
 }
 <!-- ASTRO_JSON_END -->
 
-CRITICAL: Include stage_key, status, and summary in EVERY response. Use "ok" status unless blocked/failed.
+MANDATORY RULES:
+- ALL fields above MUST be present (use empty arrays/objects if no data)
+- stage_key MUST be "CURRENT_STAGE" (will be replaced)
+- status MUST be "ok" unless blocked/failed
+- summary MUST be a string describing the work
+- JSON MUST be valid and parseable
+- Markers MUST be exact as shown
 
-Do not narrate. If blocked, ask exactly ONE question and stop.
+If blocked, set status="blocked" and put ONE question in questions array. Do not output anything else.
 `;

package/src/tools/stage.ts

@@ -153,7 +153,29 @@ export function createAstroStageCompleteTool(opts: { ctx: any; config: Astrocode
 
        const parsed = parseStageOutputText(output_text);
        if (parsed.error || !parsed.astro_json) {
-         return `❌ JSON Parse Error: ${parsed.error ?? "ASTRO JSON missing"}. Ensure output includes <!-- ASTRO_JSON_BEGIN -->{...}<!-- ASTRO_JSON_END --> markers with valid JSON.`;
+          return `❌ JSON Parse Error: ${parsed.error ?? "ASTRO JSON missing"}.
+
+Expected format:
+1) Narrative summary (optional)
+2) Valid JSON between markers:
+<!-- ASTRO_JSON_BEGIN -->
+{
+  "schema_version": 1,
+  "stage_key": "${sk}",
+  "status": "ok",
+  "summary": "Brief summary",
+  "decisions": [],
+  "next_actions": [],
+  "tasks": [],
+  "files": [],
+  "evidence": [],
+  "new_stories": [],
+  "questions": [],
+  "metrics": {}
+}
+<!-- ASTRO_JSON_END -->
+
+Ensure JSON has required fields (stage_key, status) and valid syntax.`;
        }
 
         if (parsed.astro_json.stage_key !== sk) {

package/src/tools/workflow.ts

@@ -9,6 +9,7 @@ import { buildStageDirective, directiveHash } from "../workflow/directives";
 import { injectChatPrompt } from "../ui/inject";
 import { nowISO } from "../shared/time";
 import { newEventId } from "../state/ids";
+import { debug } from "../shared/log";
 import { createToastManager } from "../ui/toasts";
 
 // Agent name mapping for case-sensitive resolution
@@ -79,7 +80,7 @@ function buildDelegationPrompt(opts: {
   const { stageDirective, run_id, stage_key, stage_agent_name } = opts;
   const stageUpper = stage_key.toUpperCase();
 
-  return [
+  const prompt = [
     `[SYSTEM DIRECTIVE: ASTROCODE — DELEGATE_STAGE_${stageUpper}]`,
     ``,
     `Do this now, in order:`,
@@ -97,6 +98,11 @@ function buildDelegationPrompt(opts: {
     ``,
     `Important: do NOT do any stage work yourself in orchestrator mode.`,
   ].join("\n").trim();
+
+  // Debug log the delegation prompt to troubleshoot agent output issues
+  debug(`Delegating stage ${stage_key} to agent ${stage_agent_name}`, { prompt_length: prompt.length });
+
+  return prompt;
 }
 
 import { AgentConfig } from "@opencode-ai/sdk";

package/src/workflow/baton.ts

@@ -2,6 +2,7 @@ import { tool } from "@opencode-ai/plugin/tool";
 import type { AstrocodeConfig } from "../config/schema";
 import { clampLines, normalizeNewlines, stripCodeFences } from "../shared/text";
 import { z, ZodError } from "zod";
+import { debug } from "../shared/log";
 
 export const ASTRO_JSON_BEGIN = "<!-- ASTRO_JSON_BEGIN -->";
 export const ASTRO_JSON_END = "<!-- ASTRO_JSON_END -->";
@@ -74,30 +75,49 @@ export function parseStageOutputText(text: string): ParsedStageOutput {
   const beginIdx = norm.indexOf(ASTRO_JSON_BEGIN);
   const endIdx = norm.indexOf(ASTRO_JSON_END);
 
+  let baton_md = "";
+  let jsonRaw = "";
+  let fallbackUsed = false;
+
   if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+    // Fallback: if no markers, check if the entire text is JSON
+    try {
+      const parsed = JSON.parse(norm) as unknown;
+      const astroJson = AstroJsonSchema.parse(parsed);
+      debug("Used JSON fallback parsing (no markers found)", { stage_key: astroJson.stage_key });
+      return {
+        baton_md: "",
+        astro_json: astroJson,
+        astro_json_raw: norm,
+        error: null
+      };
+    } catch (e) {
+      // Not JSON, proceed with marker error
+    }
+
     return {
       baton_md: norm,
       astro_json: null,
       astro_json_raw: null,
-      error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}`,
+      error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}. If output is pure JSON, ensure it's wrapped in markers.`,
     };
   }
 
   const before = norm.slice(0, beginIdx).trim();
-  const jsonRaw = norm.slice(beginIdx + ASTRO_JSON_BEGIN.length, endIdx).trim();
+  jsonRaw = norm.slice(beginIdx + ASTRO_JSON_BEGIN.length, endIdx).trim();
   const after = norm.slice(endIdx + ASTRO_JSON_END.length).trim();
 
-  const baton = [before, after].filter(Boolean).join("\n\n").trim();
+  baton_md = [before, after].filter(Boolean).join("\n\n").trim();
 
   try {
     const cleaned = stripCodeFences(jsonRaw).trim();
     const parsed = JSON.parse(cleaned) as unknown;
     const astroJson = AstroJsonSchema.parse(parsed);
-    return { baton_md: baton, astro_json: astroJson, astro_json_raw: cleaned, error: null };
+    return { baton_md, astro_json: astroJson, astro_json_raw: cleaned, error: null };
   } catch (e) {
     if (e instanceof ZodError) {
       return {
-        baton_md: baton,
+        baton_md,
         astro_json: null,
         astro_json_raw: jsonRaw,
         error: `Schema validation failed: ${e.message}. Ensure JSON conforms to ASTRO schema with required fields like stage_key, status, etc.`,