@synap-core/workspace-templates 0.11.0 → 0.23.0

package/automations/ship-a-change-checks-green.automation.json

@@ -0,0 +1,106 @@
+{
+  "name": "CI green → Ship a change waits on the merge",
+  "description": "When a CI run on a pull request's head finishes green, grade the session's checks-green criterion and move its Ship a change step to Merged.",
+  "triggerType": "event",
+  "status": "draft",
+  "triggerConfig": {
+    "eventPattern": "ci.finished"
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "t",
+        "type": "trigger",
+        "position": {
+          "x": 0,
+          "y": 0
+        },
+        "data": {
+          "label": "A CI run finished",
+          "triggerType": "event",
+          "config": {
+            "eventPattern": "ci.finished"
+          }
+        }
+      },
+      {
+        "id": "has-session",
+        "type": "guard",
+        "position": {
+          "x": 0,
+          "y": 120
+        },
+        "data": {
+          "label": "The fact names its session",
+          "checks": [
+            {
+              "path": "trigger.payload.data.sessionId",
+              "minLength": 36,
+              "message": "The fact names no Pod session: nothing to move."
+            }
+          ]
+        }
+      },
+      {
+        "id": "green-evidence",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 240
+        },
+        "data": {
+          "label": "Grade checks-green as passed",
+          "outputType": "post_evidence",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "evidence": {
+              "checks-green": {
+                "passed": "true",
+                "detail": "{{trigger.payload.data.workflow}} green on {{trigger.payload.data.sha}}: {{trigger.payload.data.url}}"
+              }
+            }
+          }
+        }
+      },
+      {
+        "id": "advance",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 360
+        },
+        "data": {
+          "label": "Move the step to Merged",
+          "outputType": "session_update",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "currentStage": "merge"
+          }
+        }
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "t",
+        "target": "has-session"
+      },
+      {
+        "id": "e2",
+        "source": "has-session",
+        "target": "green-evidence"
+      },
+      {
+        "id": "e3",
+        "source": "green-evidence",
+        "target": "advance"
+      }
+    ],
+    "precondition": "trigger.payload.data.status === 'success'"
+  },
+  "metadata": {
+    "playbook": "Ship a change (builder-workspace)",
+    "staged": "STAGED (no catalog header, so never published): it uses the plan v5 T2 output verbs post_evidence / complete_outcome (Synap-core/backend#286, not merged), which the catalog's flow vocabulary (src/validate-flow.ts, bound to backend main) does not know yet. Add its <name>.catalog.json header once #286 merges and the mirror is updated.",
+    "notes": "Reads `sessionId` on ci.finished: not in the contract (types events/dev-loop.ts, extra fields allowed), but both producers send it when they know it (GitHub Actions from the run's PR body, the devbox from GATE_POD_SESSION). A run with none (a push to main, a body naming no session) stops at the guard. ONE workflow green is not every check green: a repository with several required workflows posts one ci.finished each, so this grades on the first; the worker re-reads all runs with github_pr_checks before the merge."
+  }
+}

package/automations/ship-a-change-checks-red.automation.json

@@ -0,0 +1,106 @@
+{
+  "name": "CI red → Ship a change goes back to Building",
+  "description": "When a CI run on a pull request's head fails, grade the session's checks-green criterion as failed and send its Ship a change step back to Building (the Checks green stage's onFail).",
+  "triggerType": "event",
+  "status": "draft",
+  "triggerConfig": {
+    "eventPattern": "ci.finished"
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "t",
+        "type": "trigger",
+        "position": {
+          "x": 0,
+          "y": 0
+        },
+        "data": {
+          "label": "A CI run finished",
+          "triggerType": "event",
+          "config": {
+            "eventPattern": "ci.finished"
+          }
+        }
+      },
+      {
+        "id": "has-session",
+        "type": "guard",
+        "position": {
+          "x": 0,
+          "y": 120
+        },
+        "data": {
+          "label": "The fact names its session",
+          "checks": [
+            {
+              "path": "trigger.payload.data.sessionId",
+              "minLength": 36,
+              "message": "The fact names no Pod session: nothing to move."
+            }
+          ]
+        }
+      },
+      {
+        "id": "red-evidence",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 240
+        },
+        "data": {
+          "label": "Grade checks-green as failed",
+          "outputType": "post_evidence",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "evidence": {
+              "checks-green": {
+                "passed": "false",
+                "detail": "{{trigger.payload.data.workflow}} failed on {{trigger.payload.data.sha}}: {{trigger.payload.data.url}}"
+              }
+            }
+          }
+        }
+      },
+      {
+        "id": "advance",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 360
+        },
+        "data": {
+          "label": "Send the step back to Building",
+          "outputType": "session_update",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "currentStage": "build"
+          }
+        }
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "t",
+        "target": "has-session"
+      },
+      {
+        "id": "e2",
+        "source": "has-session",
+        "target": "red-evidence"
+      },
+      {
+        "id": "e3",
+        "source": "red-evidence",
+        "target": "advance"
+      }
+    ],
+    "precondition": "trigger.payload.data.status === 'failure'"
+  },
+  "metadata": {
+    "playbook": "Ship a change (builder-workspace)",
+    "staged": "STAGED (no catalog header, so never published): it uses the plan v5 T2 output verbs post_evidence / complete_outcome (Synap-core/backend#286, not merged), which the catalog's flow vocabulary (src/validate-flow.ts, bound to backend main) does not know yet. Add its <name>.catalog.json header once #286 merges and the mirror is updated.",
+    "notes": "A precondition is one comparison: timed_out is not caught here (cancelled, skipped and neutral are not red). Same sessionId source as ship-a-change-checks-green."
+  }
+}

package/automations/ship-a-change-deployed.automation.json

@@ -0,0 +1,56 @@
+{
+  "name": "Deployed → the devbox worker dogfoods it",
+  "description": "When this pod reports a new build live (dev.deployed, recorded by the pod itself after a successful update), start a Dogfood a change run handed to the devbox worker, filed into the goal.",
+  "triggerType": "event",
+  "status": "draft",
+  "triggerConfig": {
+    "eventPattern": "dev.deployed"
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "t",
+        "type": "trigger",
+        "position": {
+          "x": 0,
+          "y": 0
+        },
+        "data": {
+          "label": "A build went live",
+          "triggerType": "event",
+          "config": {
+            "eventPattern": "dev.deployed"
+          }
+        }
+      },
+      {
+        "id": "dogfood",
+        "type": "playbook_run",
+        "position": {
+          "x": 0,
+          "y": 120
+        },
+        "data": {
+          "label": "Dogfood what went live, on the devbox worker",
+          "playbookName": "Dogfood a change",
+          "mode": "run",
+          "goalOverride": "Dogfood what {{trigger.payload.data.sha}} put live on {{trigger.payload.data.target}}: every Ship a change session waiting at Dogfooded in this goal. Load the dogfood skill, walk each change as a person would, report WORKS / BROKEN / CANNOT-TELL, and post the evidence dogfooded on each session (passed only when every path works).",
+          "handToAgentId": "<the devbox agent's user id on this pod (synap_list_agents)>",
+          "trackId": "<the goal this loop serves (synap_list_tracks)>"
+        }
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "t",
+        "target": "dogfood"
+      }
+    ]
+  },
+  "metadata": {
+    "playbook": "Ship a change (builder-workspace)",
+    "staged": "STAGED (no catalog header, so never published): it uses the plan v5 T2 output verbs post_evidence / complete_outcome (Synap-core/backend#286, not merged), which the catalog's flow vocabulary (src/validate-flow.ts, bound to backend main) does not know yet. Add its <name>.catalog.json header once #286 merges and the mirror is updated.",
+    "notes": "POD-SPECIFIC VALUES: handToAgentId and trackId are ids on ONE pod, and the catalog has no install-time params for an automation, while playbook_run reads both literally (backend jobs steps/playbook-run.ts: not template-resolved). So this copy keeps them as <…> holes; the pod write (lanes/catalog.md, pilot setup) fills them. dev.deployed is recorded by the pod that was updated, as its owner: this automation hears ITS pod's deploys only. A lab that is another pod reaches the goal's pod only if a producer forwards its deploy."
+  }
+}

package/automations/ship-a-change-pr-merged.automation.json

@@ -0,0 +1,110 @@
+{
+  "name": "PR merged → Ship a change waits on the lab deploy",
+  "description": "When a PR merges: the merge sweeper (built in, backend#283) already marks the session's pr-* outcome met. This automation grades the session's `merged` criterion and moves its Ship a change step to Deployed to lab, where the person approves the deploy.",
+  "triggerType": "event",
+  "status": "draft",
+  "triggerConfig": {
+    "eventPattern": "dev.pr_merged"
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "t",
+        "type": "trigger",
+        "position": {
+          "x": 0,
+          "y": 0
+        },
+        "data": {
+          "label": "A PR merged",
+          "triggerType": "event",
+          "config": {
+            "eventPattern": "dev.pr_merged"
+          }
+        }
+      },
+      {
+        "id": "has-session",
+        "type": "guard",
+        "position": {
+          "x": 0,
+          "y": 120
+        },
+        "data": {
+          "label": "The PR names its session and landed on the default branch",
+          "checks": [
+            {
+              "path": "trigger.payload.data.sessionId",
+              "minLength": 36,
+              "message": "The PR body names no Pod session: nothing to advance (the merge sweeper still completed any outcome whose ref is this PR)."
+            },
+            {
+              "path": "trigger.payload.data.intoDefault",
+              "equals": true,
+              "message": "Merged into a branch that is not the default one (a stacked PR): not delivered yet, the step stays where it is."
+            }
+          ]
+        }
+      },
+      {
+        "id": "merged-evidence",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 240
+        },
+        "data": {
+          "label": "Grade the merged criterion",
+          "outputType": "post_evidence",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "evidence": {
+              "merged": {
+                "passed": "true",
+                "detail": "Merged: {{trigger.payload.data.url}}"
+              }
+            }
+          }
+        }
+      },
+      {
+        "id": "advance",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 360
+        },
+        "data": {
+          "label": "Move the step to Deployed to lab",
+          "outputType": "session_update",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "currentStage": "deploy"
+          }
+        }
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "t",
+        "target": "has-session"
+      },
+      {
+        "id": "e2",
+        "source": "has-session",
+        "target": "merged-evidence"
+      },
+      {
+        "id": "e3",
+        "source": "merged-evidence",
+        "target": "advance"
+      }
+    ]
+  },
+  "metadata": {
+    "playbook": "Ship a change (builder-workspace)",
+    "staged": "STAGED (no catalog header, so never published): it uses the plan v5 T2 output verbs post_evidence / complete_outcome (Synap-core/backend#286, not merged), which the catalog's flow vocabulary (src/validate-flow.ts, bound to backend main) does not know yet. Add its <name>.catalog.json header once #286 merges and the mirror is updated.",
+    "notes": "Derived from be-loop's config (lanes/be-loop-automation-config.json, pinned by backend#286). Two changes: the step moves to `deploy`, not `verifying` (the Ship a change order is merged → deployed to lab → dogfooded → criteria verified, and no stage is keyed verifying); the dogfood run starts on dev.deployed (ship-a-change-deployed), not at the merge."
+  }
+}

package/automations/ship-a-change-pr-opened.automation.json

@@ -0,0 +1,104 @@
+{
+  "name": "PR opened → Ship a change waits on its checks",
+  "description": "When a pull request opens with a `Pod session:` line, grade the session's pr-opened criterion and move its Ship a change step to Checks green.",
+  "triggerType": "event",
+  "status": "draft",
+  "triggerConfig": {
+    "eventPattern": "dev.pr_opened"
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "t",
+        "type": "trigger",
+        "position": {
+          "x": 0,
+          "y": 0
+        },
+        "data": {
+          "label": "A PR opened",
+          "triggerType": "event",
+          "config": {
+            "eventPattern": "dev.pr_opened"
+          }
+        }
+      },
+      {
+        "id": "has-session",
+        "type": "guard",
+        "position": {
+          "x": 0,
+          "y": 120
+        },
+        "data": {
+          "label": "The fact names its session",
+          "checks": [
+            {
+              "path": "trigger.payload.data.sessionId",
+              "minLength": 36,
+              "message": "The PR body names no Pod session: nothing to move."
+            }
+          ]
+        }
+      },
+      {
+        "id": "opened-evidence",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 240
+        },
+        "data": {
+          "label": "Grade the pr-opened criterion",
+          "outputType": "post_evidence",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "evidence": {
+              "pr-opened": {
+                "passed": "true",
+                "detail": "Opened: {{trigger.payload.data.url}}"
+              }
+            }
+          }
+        }
+      },
+      {
+        "id": "advance",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 360
+        },
+        "data": {
+          "label": "Move the step to Checks green",
+          "outputType": "session_update",
+          "config": {
+            "sessionId": "{{trigger.payload.data.sessionId}}",
+            "currentStage": "checks"
+          }
+        }
+      }
+    ],
+    "edges": [
+      {
+        "id": "e1",
+        "source": "t",
+        "target": "has-session"
+      },
+      {
+        "id": "e2",
+        "source": "has-session",
+        "target": "opened-evidence"
+      },
+      {
+        "id": "e3",
+        "source": "opened-evidence",
+        "target": "advance"
+      }
+    ]
+  },
+  "metadata": {
+    "playbook": "Ship a change (builder-workspace)",
+    "staged": "STAGED (no catalog header, so never published): it uses the plan v5 T2 output verbs post_evidence / complete_outcome (Synap-core/backend#286, not merged), which the catalog's flow vocabulary (src/validate-flow.ts, bound to backend main) does not know yet. Add its <name>.catalog.json header once #286 merges and the mirror is updated."
+  }
+}

package/automations/url-bookmark-capture.automation.json

@@ -0,0 +1,132 @@
+{
+  "name": "URL → Bookmark (inbound messages)",
+  "triggerType": "event",
+  "status": "active",
+  "triggerConfig": {
+    "eventPattern": "external_message.received.*",
+    "filters": { "provider": "discord" }
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "trigger",
+        "type": "trigger",
+        "position": { "x": 0, "y": 0 },
+        "data": {
+          "triggerType": "event",
+          "label": "Inbound message",
+          "config": {
+            "eventPattern": "external_message.received.*",
+            "filters": { "provider": "discord" }
+          }
+        }
+      },
+      {
+        "id": "content",
+        "type": "transform",
+        "position": { "x": 0, "y": 120 },
+        "data": {
+          "label": "Trim message text",
+          "expression": "{{trigger.payload.data.content}} | trim"
+        }
+      },
+      {
+        "id": "title-src",
+        "type": "transform",
+        "position": { "x": 0, "y": 240 },
+        "data": {
+          "label": "Human text (title source)",
+          "expression": "{{trigger.payload.data.messagePreview}} | trim"
+        }
+      },
+      {
+        "id": "extract",
+        "type": "transform",
+        "position": { "x": 0, "y": 360 },
+        "data": {
+          "label": "Extract URLs · drop bare-link noise",
+          "expression": "{{trigger.payload.data.content}} | url_extract | unique | filter:item !== steps.content.output.result | slice:5"
+        }
+      },
+      {
+        "id": "url-loop",
+        "type": "loop",
+        "position": { "x": 0, "y": 480 },
+        "data": {
+          "label": "For each URL",
+          "iteratorExpression": "steps.extract.output.result",
+          "itemVariable": "url"
+        }
+      },
+      {
+        "id": "create-bookmark",
+        "type": "output",
+        "position": { "x": 0, "y": 600 },
+        "data": {
+          "label": "Create bookmark",
+          "outputType": "entity_create",
+          "config": {
+            "profileSlug": "bookmark",
+            "title": "{{steps.title-src.output.result}}",
+            "dedupeBy": "url",
+            "body": "{{steps.content.output.result}}",
+            "properties": {
+              "url": "{{loop.item}}",
+              "sourceChannelId": "{{trigger.payload.data.channelId}}",
+              "sourceThreadId": "{{trigger.payload.data.threadId}}",
+              "sourceMessageId": "{{trigger.payload.data.messageId}}",
+              "sourceProvider": "{{trigger.payload.data.provider}}",
+              "sharedBy": "{{trigger.payload.data.participantName}}"
+            }
+          }
+        }
+      },
+      {
+        "id": "has-bookmark-id",
+        "type": "condition",
+        "position": { "x": 0, "y": 720 },
+        "data": {
+          "label": "Bookmark row exists?",
+          "expression": "steps.create-bookmark.output.entityId !== ''"
+        }
+      },
+      {
+        "id": "has-context-entity",
+        "type": "condition",
+        "position": { "x": 0, "y": 840 },
+        "data": {
+          "label": "Channel bound to an entity?",
+          "expression": "trigger.payload.data.entityId !== ''"
+        }
+      },
+      {
+        "id": "link-context",
+        "type": "output",
+        "position": { "x": 0, "y": 960 },
+        "data": {
+          "label": "Link bookmark → channel's entity",
+          "outputType": "relation_create",
+          "config": {
+            "fromEntityId": "{{steps.create-bookmark.output.entityId}}",
+            "toEntityId": "{{trigger.payload.data.entityId}}",
+            "relationType": "references"
+          }
+        }
+      }
+    ],
+    "edges": [
+      { "id": "e1", "source": "trigger", "target": "content" },
+      { "id": "e2", "source": "content", "target": "title-src" },
+      { "id": "e3", "source": "title-src", "target": "extract" },
+      { "id": "e4", "source": "extract", "target": "url-loop" },
+      { "id": "e5", "source": "url-loop", "target": "create-bookmark" },
+      { "id": "e6", "source": "create-bookmark", "target": "has-bookmark-id" },
+      { "id": "e7", "source": "has-bookmark-id", "target": "has-context-entity", "sourceHandle": "yes" },
+      { "id": "e8", "source": "has-context-entity", "target": "link-context", "sourceHandle": "yes" }
+    ]
+  },
+  "metadata": {
+    "source": "bridge-template",
+    "note": "Phase 1 is DETERMINISTIC — no AI. It keeps the context the trigger already hands it: data.channelId (the INTERNAL Synap channel UUID, not the Discord snowflake, which is kept separately as sourceThreadId), data.content (as the bookmark body) and data.entityId (the channel's bound entity, linked with a `references` relation). Title = the message's own 120-char preview; when the message is nothing but a link the item is dropped by the noise filter rather than named, so the title is never invented. Noise filter: `filter:item !== steps.content.output.result` keeps only links that arrived WITH human text — a Tenor/giphy GIF drop or a bare Google Photos paste is exactly a message whose whole trimmed text IS the URL. A host denylist is NOT expressible: the condition grammar (condition-eval.ts) has no substring/regex operator and `contains` is exact set intersection, so any 'tenor.com'-style match would silently never fire."
+  }
+}