agents-relay 2.0.146 → 2.0.147

package/dist/workflow/graph-v2.js

@@ -24,11 +24,30 @@ function parseLabel(raw, line) {
 }
 export function parseGraphV2(source) {
     const lines = source.split(/\r?\n/);
+    // Mermaid YAML frontmatter is metadata only; never execute it as graph policy.
+    // Preserve original source line positions for diagnostics and coverage reports.
+    let graphStart = 0;
+    if (lines[0]?.trim() === '---') {
+        let closing = -1;
+        for (let i = 1; i < lines.length; i += 1) {
+            if (lines[i].trim() === '---') {
+                closing = i;
+                break;
+            }
+            if (!/^(title|description):\s+[^\r\n]+$/.test(lines[i]))
+                fail(i + 1, 'unsupported graph frontmatter field');
+        }
+        if (closing < 0)
+            fail(1, 'unterminated graph frontmatter');
+        if (closing === 1)
+            fail(1, 'empty graph frontmatter');
+        graphStart = closing + 1;
+    }
     let direction = null;
     let initial = null;
     const nodes = new Map();
     const edges = [];
-    for (let index = 0; index < lines.length; index += 1) {
+    for (let index = graphStart; index < lines.length; index += 1) {
         const lineNumber = index + 1;
         const line = lines[index].trim();
         if (!line)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.146",
+  "version": "2.0.147",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "repository": {
     "type": "git",

package/workflow/authoritative-unblock.mmd

@@ -1,3 +1,7 @@
+---
+title: Authoritative Unblock
+description: Validates authoritative unblock requests and safely resumes blocked workflow work.
+---
 flowchart LR
 %% relay: initial blocked
 blocked["state: blocked"]

package/workflow/blocker-resolution.mmd

@@ -1,3 +1,7 @@
+---
+title: Blocker Resolution
+description: Resolves blockers through verified recovery evidence and graph-authorized decisions.
+---
 flowchart LR
 %% relay: initial waiting
 waiting["state: waiting"]

package/workflow/escalation.mmd

@@ -1,3 +1,7 @@
+---
+title: Escalation
+description: Routes unresolved recovery to human escalation and records response outcomes.
+---
 flowchart LR
 %% relay: initial suspected
 suspected["state: suspected_human_blocker"]

package/workflow/interactive-invocation.mmd

@@ -1,3 +1,7 @@
+---
+title: Interactive Invocation
+description: Controls interactive agent invocation through guarded lifecycle transitions.
+---
 flowchart LR
 %% relay: initial awaiting_decision
 awaiting_decision["state: awaiting_decision"]

package/workflow/job-lifecycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Job Lifecycle
+description: Defines canonical Job states, completion gates, and terminal transitions.
+---
 flowchart LR
 %% relay: initial draft
 draft["state: DRAFT"]

package/workflow/main.mmd

@@ -1,3 +1,7 @@
+---
+title: Main
+description: Presentation-only entry map linking workflow graphs and explaining contract, graph, code, guard, action, and effect ownership.
+---
 %% dashboard: presentation-only — not registered with GraphRuntime or the executable Graph DSL.
 %% PRINCIPLES (this graph is a readable overview, not an executable policy):
 %% CONTRACT defines typed events, permissions and invariants; GRAPH defines legal transitions,

package/workflow/orchestrator-rescue.mmd

@@ -1,3 +1,7 @@
+---
+title: Orchestrator Rescue
+description: Determines when orchestration needs safe intervention or recovery.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/planner-orchestration.mmd

@@ -1,3 +1,7 @@
+---
+title: Planner Orchestration
+description: Guards autonomous planning rounds, interrupted plans, and planner recovery.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/planner-trigger.mmd

@@ -1,3 +1,7 @@
+---
+title: Planner Trigger
+description: Classifies planning requests as manual, unblock, scheduled, initial, or continuation.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/projection-conflict.mmd

@@ -1,3 +1,7 @@
+---
+title: Projection Conflict
+description: Detects and resolves conflicting workflow state projections against authoritative facts.
+---
 flowchart LR
 %% relay: initial classify
 classify["state: classify"]

package/workflow/review-lifecycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Review Lifecycle
+description: Manages review creation, immutable verdicts, changes-required, and re-review.
+---
 flowchart LR
 %% relay: initial none
 none["state: NONE"]

package/workflow/schedule-cycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Schedule Cycle
+description: Reconciles scheduled execution slots and finishes verified completed slots.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/scheduled-run.mmd

@@ -1,3 +1,7 @@
+---
+title: Scheduled Run
+description: Controls scheduled-run lifecycle and guarded execution.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]

package/workflow/task-lifecycle.mmd

@@ -1,3 +1,7 @@
+---
+title: Task Lifecycle
+description: Defines canonical Task transitions, dispatch guards, failure, and recovery.
+---
 flowchart LR
 %% relay: initial draft
 draft["state: DRAFT"]

package/workflow/task-related-action.mmd

@@ -1,3 +1,7 @@
+---
+title: Task Related Action
+description: Authorizes task-related control actions using current workflow state.
+---
 flowchart LR
 %% relay: initial evaluate
 evaluate["state: evaluate"]

package/workflow/task-resolution.mmd

@@ -1,3 +1,7 @@
+---
+title: Task Resolution
+description: Selects and verifies resolution paths for failed or blocked Tasks.
+---
 flowchart LR
 %% relay: initial unresolved
 unresolved["state: unresolved"]

package/workflow/troubleshooter.mmd

@@ -1,3 +1,7 @@
+---
+title: Troubleshooter
+description: Coordinates diagnosis, recovery, escalation, and resolution of failed Tasks.
+---
 flowchart LR
 %% relay: initial idle
 idle["state: idle"]