astrocode-workflow 0.1.29 → 0.1.34

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\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";
+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 (copy/paste this template):\n\n1) First, a short summary paragraph (1-3 sentences).\n\n2) Then, immediately after, the ASTRO JSON between markers:\n\n<!-- ASTRO_JSON_BEGIN -->\n{\n  \"stage_key\": \"CURRENT_STAGE\",\n  \"status\": \"ok\",\n  \"summary\": \"Brief summary of work done\",\n  \"tasks\": [],\n  \"files\": [],\n  \"questions\": []\n}\n<!-- ASTRO_JSON_END -->\n\nMANDATORY:\n- stage_key must be \"CURRENT_STAGE\"\n- status must be \"ok\", \"blocked\", or \"failed\"\n- summary must be a non-empty string\n- JSON must be valid syntax\n- Use exact markers shown above\n\nEXAMPLE OUTPUT:\nI analyzed the requirements and identified key components for implementation.\n\n<!-- ASTRO_JSON_BEGIN -->\n{\n  \"stage_key\": \"plan\",\n  \"status\": \"ok\",\n  \"summary\": \"Created implementation plan with 5 main tasks\",\n  \"tasks\": [\n    {\"title\": \"Setup database\", \"complexity\": 3},\n    {\"title\": \"Build API endpoints\", \"complexity\": 5}\n  ],\n  \"files\": [\n    {\"path\": \"schema.prisma\", \"kind\": \"file\"}\n  ],\n  \"questions\": []\n}\n<!-- ASTRO_JSON_END -->\n\nIf blocked, set status=\"blocked\" and add ONE question to questions array. Do not deviate from this format.\n";

package/dist/agents/prompts.js

@@ -19,36 +19,48 @@ export const BASE_STAGE_PROMPT = `You are an Astro stage subagent.
 
 ***CRITICAL: Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive EXACTLY.***
 
-Your output MUST be in this EXACT format (no deviations):
+Your output MUST be in this EXACT format (copy/paste this template):
 
-1) First, a short baton markdown summary (1-3 sentences).
+1) First, a short summary paragraph (1-3 sentences).
 
-2) Then, immediately after, the ASTRO JSON markers with valid JSON:
+2) Then, immediately after, the ASTRO JSON between markers:
 
 <!-- ASTRO_JSON_BEGIN -->
 {
-  "schema_version": 1,
   "stage_key": "CURRENT_STAGE",
   "status": "ok",
-  "summary": "Brief summary",
-  "decisions": [],
-  "next_actions": [],
+  "summary": "Brief summary of work done",
   "tasks": [],
   "files": [],
-  "evidence": [],
-  "new_stories": [],
-  "questions": [],
-  "metrics": {}
+  "questions": []
 }
 <!-- ASTRO_JSON_END -->
 
-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
+MANDATORY:
+- stage_key must be "CURRENT_STAGE"
+- status must be "ok", "blocked", or "failed"
+- summary must be a non-empty string
+- JSON must be valid syntax
+- Use exact markers shown above
 
-If blocked, set status="blocked" and put ONE question in questions array. Do not output anything else.
+EXAMPLE OUTPUT:
+I analyzed the requirements and identified key components for implementation.
+
+<!-- ASTRO_JSON_BEGIN -->
+{
+  "stage_key": "plan",
+  "status": "ok",
+  "summary": "Created implementation plan with 5 main tasks",
+  "tasks": [
+    {"title": "Setup database", "complexity": 3},
+    {"title": "Build API endpoints", "complexity": 5}
+  ],
+  "files": [
+    {"path": "schema.prisma", "kind": "file"}
+  ],
+  "questions": []
+}
+<!-- ASTRO_JSON_END -->
+
+If blocked, set status="blocked" and add ONE question to questions array. Do not deviate from this format.
 `;

package/dist/tools/workflow.js

@@ -166,6 +166,11 @@ export function createAstroWorkflowProceedTool(opts) {
                         if (systemConfig.agent && systemConfig.agent[name]) {
                             return true;
                         }
+                        // For known stage agents, assume they exist (they are system-provided subagents)
+                        const knownStageAgents = ["Frame", "Plan", "Spec", "Implement", "Review", "Verify", "Close"];
+                        if (knownStageAgents.includes(name)) {
+                            return true;
+                        }
                         return false;
                     };
                     if (!agentExists(agentName)) {

package/dist/workflow/baton.js

@@ -1,6 +1,5 @@
 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"]);
@@ -45,11 +44,27 @@ export function parseStageOutputText(text) {
     let jsonRaw = "";
     let fallbackUsed = false;
     if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+        // Enhanced fallback: scan for any JSON object in the text
+        const jsonMatch = norm.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            try {
+                const parsed = JSON.parse(jsonMatch[0]);
+                const astroJson = AstroJsonSchema.parse(parsed);
+                return {
+                    baton_md: norm.replace(jsonMatch[0], "").trim(),
+                    astro_json: astroJson,
+                    astro_json_raw: jsonMatch[0],
+                    error: null
+                };
+            }
+            catch (e) {
+                // JSON found but invalid, continue to marker error
+            }
+        }
         // 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,
@@ -64,7 +79,7 @@ export function parseStageOutputText(text) {
             baton_md: norm,
             astro_json: null,
             astro_json_raw: null,
-            error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}. If output is pure JSON, ensure it's wrapped in markers.`,
+            error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}. If output contains JSON, ensure it's valid.`,
         };
     }
     const before = norm.slice(0, beginIdx).trim();

package/dist/workflow/state-machine.js

@@ -64,7 +64,10 @@ export function createRunForStory(db, config, storyKey) {
     const isGenesisCandidate = storyKey === 'S-0001' || isInitialStory(db, storyKey) ||
         (story.body_md && story.body_md.length > 100 &&
             (story.title.toLowerCase().includes('implement') || story.body_md.toLowerCase().includes('implement')));
-    if (isGenesisCandidate) {
+    // Skip conversion if there are already many stories (spec already decomposed)
+    const existingStoriesCount = db.prepare("SELECT COUNT(*) as count FROM stories").get();
+    const alreadyDecomposed = existingStoriesCount.count > 10; // Arbitrary threshold
+    if (isGenesisCandidate && !alreadyDecomposed) {
         const planningTitle = `Plan and decompose: ${story.title}`;
         const planningBody = `Analyze the requirements and break down "${story.title}" into 50-200 detailed, granular implementation stories. Each story should be focused on a specific, implementable task with clear acceptance criteria.\n\nOriginal request: ${story.body_md || ''}`;
         db.prepare("UPDATE stories SET title=?, body_md=? WHERE story_key=?").run(planningTitle, planningBody, storyKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astrocode-workflow",
-  "version": "0.1.29",
+  "version": "0.1.34",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/agents/prompts.ts

@@ -20,36 +20,48 @@ export const BASE_STAGE_PROMPT = `You are an Astro stage subagent.
 
 ***CRITICAL: Follow the latest [SYSTEM DIRECTIVE: ASTROCODE — STAGE_*] you receive EXACTLY.***
 
-Your output MUST be in this EXACT format (no deviations):
+Your output MUST be in this EXACT format (copy/paste this template):
 
-1) First, a short baton markdown summary (1-3 sentences).
+1) First, a short summary paragraph (1-3 sentences).
 
-2) Then, immediately after, the ASTRO JSON markers with valid JSON:
+2) Then, immediately after, the ASTRO JSON between markers:
 
 <!-- ASTRO_JSON_BEGIN -->
 {
-  "schema_version": 1,
   "stage_key": "CURRENT_STAGE",
   "status": "ok",
-  "summary": "Brief summary",
-  "decisions": [],
-  "next_actions": [],
+  "summary": "Brief summary of work done",
   "tasks": [],
   "files": [],
-  "evidence": [],
-  "new_stories": [],
-  "questions": [],
-  "metrics": {}
+  "questions": []
 }
 <!-- ASTRO_JSON_END -->
 
-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
+MANDATORY:
+- stage_key must be "CURRENT_STAGE"
+- status must be "ok", "blocked", or "failed"
+- summary must be a non-empty string
+- JSON must be valid syntax
+- Use exact markers shown above
 
-If blocked, set status="blocked" and put ONE question in questions array. Do not output anything else.
+EXAMPLE OUTPUT:
+I analyzed the requirements and identified key components for implementation.
+
+<!-- ASTRO_JSON_BEGIN -->
+{
+  "stage_key": "plan",
+  "status": "ok",
+  "summary": "Created implementation plan with 5 main tasks",
+  "tasks": [
+    {"title": "Setup database", "complexity": 3},
+    {"title": "Build API endpoints", "complexity": 5}
+  ],
+  "files": [
+    {"path": "schema.prisma", "kind": "file"}
+  ],
+  "questions": []
+}
+<!-- ASTRO_JSON_END -->
+
+If blocked, set status="blocked" and add ONE question to questions array. Do not deviate from this format.
 `;

package/src/tools/workflow.ts

@@ -204,6 +204,11 @@ export function createAstroWorkflowProceedTool(opts: { ctx: any; config: Astroco
              if (systemConfig.agent && systemConfig.agent[name]) {
                return true;
              }
+             // For known stage agents, assume they exist (they are system-provided subagents)
+             const knownStageAgents = ["Frame", "Plan", "Spec", "Implement", "Review", "Verify", "Close"];
+             if (knownStageAgents.includes(name)) {
+               return true;
+             }
              return false;
           };
 

package/src/workflow/baton.ts

@@ -80,11 +80,27 @@ export function parseStageOutputText(text: string): ParsedStageOutput {
   let fallbackUsed = false;
 
   if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
+    // Enhanced fallback: scan for any JSON object in the text
+    const jsonMatch = norm.match(/\{[\s\S]*\}/);
+    if (jsonMatch) {
+      try {
+        const parsed = JSON.parse(jsonMatch[0]) as unknown;
+        const astroJson = AstroJsonSchema.parse(parsed);
+        return {
+          baton_md: norm.replace(jsonMatch[0], "").trim(),
+          astro_json: astroJson,
+          astro_json_raw: jsonMatch[0],
+          error: null
+        };
+      } catch (e) {
+        // JSON found but invalid, continue to marker error
+      }
+    }
+
     // 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,
@@ -99,7 +115,7 @@ export function parseStageOutputText(text: string): ParsedStageOutput {
       baton_md: norm,
       astro_json: null,
       astro_json_raw: null,
-      error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}. If output is pure JSON, ensure it's wrapped in markers.`,
+      error: `Missing ASTRO JSON markers. Expected markers ${ASTRO_JSON_BEGIN} ... ${ASTRO_JSON_END}. If output contains JSON, ensure it's valid.`,
     };
   }
 

package/src/workflow/state-machine.ts

@@ -94,7 +94,11 @@ export function createRunForStory(db: SqliteDb, config: AstrocodeConfig, storyKe
     (story.body_md && story.body_md.length > 100 &&
       (story.title.toLowerCase().includes('implement') || story.body_md.toLowerCase().includes('implement')));
 
-  if (isGenesisCandidate) {
+  // Skip conversion if there are already many stories (spec already decomposed)
+  const existingStoriesCount = db.prepare("SELECT COUNT(*) as count FROM stories").get() as { count: number };
+  const alreadyDecomposed = existingStoriesCount.count > 10; // Arbitrary threshold
+
+  if (isGenesisCandidate && !alreadyDecomposed) {
     const planningTitle = `Plan and decompose: ${story.title}`;
     const planningBody = `Analyze the requirements and break down "${story.title}" into 50-200 detailed, granular implementation stories. Each story should be focused on a specific, implementable task with clear acceptance criteria.\n\nOriginal request: ${story.body_md || ''}`;
     db.prepare("UPDATE stories SET title=?, body_md=? WHERE story_key=?").run(planningTitle, planningBody, storyKey);