@getpipher/armory-fleet 0.12.3 → 0.12.4

package/README.md

@@ -304,6 +304,8 @@ Workflows are authored in a JS DSL (`src/workflows/source.ts` parses; `vm-realm.
 
 Every workflow run is **journaled** (`workflows/journal.ts`) and **resumable**. `edit-resume` replays the unchanged prefix from cache and re-runs only the edited suffix. `runtime/controller.ts` orchestrates; `runtime/pause-gate.ts` handles checkpoints; `runtime/adapters.ts` binds the controller to the fleet's spawn + accounting.
 
+**Full JS DSL API reference:** [`docs/workflows.md`](./docs/workflows.md) — `export const meta`, `agent()`/`parallel()`/`pipeline()`/`phase()`, the 7 helpers, the script context, worked examples, and the error surface.
+
 ---
 
 ## Roadmap

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpipher/armory-fleet",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "private": false,
   "description": "The armory suite's subagent orchestrator for the pi coding agent — a cross-harness, superpowers-native fleet where every agent is armory-native from birth.",
   "license": "MIT",

package/src/tools/fleet.ts

@@ -125,7 +125,14 @@ async function handleControlAction(controller: WorkflowController, params: Fleet
     if (!run) {
       return { isError: true, content: [{ type: "text" as const, text: `workflow '${params.runId}' not found` }] }
     }
-    return { content: [{ type: "text" as const, text: `workflow ${run.runId}: ${run.status}` }], details: { run: summarizeRun(run) } }
+    // #37: surface the abort/failure reason in the status text (previously only `status` was shown —
+    // `workflow wf-x: aborted` with no WHY, leaving the orchestrator unable to tell a script error from
+    // a budget/timeout/signal abort). The `details.run.error` already carried it; this surfaces it in the
+    // headline text the model + user see first. Cap very long reasons to keep the status line concise.
+    const reason = (run.status === "aborted" || run.status === "failed") && run.error
+      ? ` — ${run.error.length > 300 ? run.error.slice(0, 300) + `…(truncated from ${run.error.length} chars, see details.run.error)` : run.error}`
+      : "";
+    return { content: [{ type: "text" as const, text: `workflow ${run.runId}: ${run.status}${reason}` }], details: { run: summarizeRun(run) } }
   }
 
   if (control === "pause") {

package/src/workflows/builtin/adversarial-review.js

@@ -6,13 +6,13 @@ export const meta = {
 
 phase('Attack')
 const vulns = await parallel([
-  () => agent('Find injection vulnerabilities in this code.', { tier: 'medium' }),
-  () => agent('Find logic errors and race conditions.', { tier: 'medium' }),
-  () => agent('Find authentication bypass vectors.', { tier: 'medium' }),
+  () => agent('Find injection vulnerabilities in this code.', { tier: 'standard' }),
+  () => agent('Find logic errors and race conditions.', { tier: 'standard' }),
+  () => agent('Find authentication bypass vectors.', { tier: 'standard' }),
 ])
 
 phase('Defend')
-const defenses = await parallel(vulns.map((v) => () => agent(`Propose a fix for: ${v}`, { tier: 'low' })))
+const defenses = await parallel(vulns.map((v) => () => agent(`Propose a fix for: ${v}`, { tier: 'economy' })))
 
 phase('Judge')
 const winner = await judgePanel([...vulns, ...defenses], { judges: 3, rubric: 'severity and fixability' })

package/src/workflows/builtin/code-review.js

@@ -6,7 +6,7 @@ export const meta = {
 
 phase('Review')
 const angles = ['security', 'correctness', 'performance', 'readability', 'edge-cases', 'tests', 'api-design']
-const findings = await parallel(angles.map((angle) => () => agent(`Review this diff for ${angle} issues. Report concrete findings only.`, { tier: 'medium' })))
+const findings = await parallel(angles.map((angle) => () => agent(`Review this diff for ${angle} issues. Report concrete findings only.`, { tier: 'standard' })))
 
 phase('Verify')
 const verified = await verify(findings.join('\n---\n'), { reviewers: 2, lens: 'false positives' })

package/src/workflows/builtin/codebase-audit.js

@@ -6,7 +6,7 @@ export const meta = {
 
 phase('Scan')
 const files = await loopUntilDry({
-  round: (n) => n < 4 ? agent(`List files in dir ${n}. Return a JSON array of file path strings.`, { tier: 'low', schema: { type: 'array' }, retries: 1 }) : [],
+  round: (n) => n < 4 ? agent(`List files in dir ${n}. Return a JSON array of file path strings.`, { tier: 'economy', schema: { type: 'array' }, retries: 1 }) : [],
   consecutiveEmpty: 2,
   maxRounds: 6,
 })

package/src/workflows/builtin/deep-research.js

@@ -5,8 +5,8 @@ export const meta = {
 }
 
 phase('Discover')
-const topics = await loopUntilDry({ round: (n) => n < 3 ? agent(`Find unique sources for round ${n}. Return a JSON array of source strings.`, { tier: 'low', schema: { type: 'array' }, retries: 1 }) : [], consecutiveEmpty: 2, maxRounds: 5 })
+const topics = await loopUntilDry({ round: (n) => n < 3 ? agent(`Find unique sources for round ${n}. Return a JSON array of source strings.`, { tier: 'economy', schema: { type: 'array' }, retries: 1 }) : [], consecutiveEmpty: 2, maxRounds: 5 })
 
 phase('Synthesize')
-const summary = await agent(`Synthesize these ${topics.length} sources into a coherent report.`, { tier: 'medium' })
+const summary = await agent(`Synthesize these ${topics.length} sources into a coherent report.`, { tier: 'standard' })
 return { sources: topics, summary }

package/src/workflows/builtin/multi-perspective.js

@@ -6,11 +6,11 @@ export const meta = {
 
 phase('Review')
 const personas = ['product manager', 'security engineer', 'UX designer', 'dev-ops lead']
-const reviews = await parallel(personas.map((p) => () => agent(`Review this artifact as a ${p}. Focus on your domain only.`, { tier: 'medium' })))
+const reviews = await parallel(personas.map((p) => () => agent(`Review this artifact as a ${p}. Focus on your domain only.`, { tier: 'standard' })))
 
 phase('Merge')
 const merged = await gate(
-  async (feedback, n) => n === 0 ? agent(`Initial synthesis of ${reviews.length} reviews.`, { tier: 'low' }) : agent(`Revise synthesis: ${feedback}`, { tier: 'low' }),
+  async (feedback, n) => n === 0 ? agent(`Initial synthesis of ${reviews.length} reviews.`, { tier: 'economy' }) : agent(`Revise synthesis: ${feedback}`, { tier: 'economy' }),
   (v) => typeof v === 'string' && v.length > 100 ? { ok: true } : { ok: false, feedback: 'more detail needed' },
   { attempts: 3 },
 )