@synap-core/workspace-templates 0.12.0 → 0.23.0

package/automations/github-pr-events.automation.json

@@ -0,0 +1,505 @@
+{
+  "name": "GitHub pull requests and checks \u2192 dev-loop facts",
+  "description": "Reads the GitHub org webhook (one inbound source named GitHub) and records what happened as dev-loop observations: a pull request opened or reopened \u2192 dev.pr_opened, merged \u2192 dev.pr_merged, closed unmerged \u2192 dev.pr_closed; a check suite completed \u2192 ci.finished. The pod's own consumers (the merge sweeper, the Ship a change automations) take it from there.",
+  "triggerType": "webhook",
+  "status": "draft",
+  "triggerConfig": {
+    "webhookSource": {
+      "name": "GitHub"
+    }
+  },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "t",
+        "type": "trigger",
+        "position": {
+          "x": 0,
+          "y": 0
+        },
+        "data": {
+          "label": "GitHub posts an event",
+          "triggerType": "webhook",
+          "config": {
+            "webhookSource": {
+              "name": "GitHub"
+            }
+          }
+        }
+      },
+      {
+        "id": "route",
+        "type": "switch",
+        "position": {
+          "x": 0,
+          "y": 120
+        },
+        "data": {
+          "label": "Which GitHub event",
+          "expression": "{{trigger.payload.event}}",
+          "cases": [
+            {
+              "value": "pull_request",
+              "label": "A pull request"
+            },
+            {
+              "value": "check_suite",
+              "label": "A check suite"
+            }
+          ]
+        }
+      },
+      {
+        "id": "into-default",
+        "type": "condition",
+        "position": {
+          "x": -300,
+          "y": 240
+        },
+        "data": {
+          "label": "Its base is the default branch",
+          "expression": "trigger.payload.body.pull_request.base.ref == trigger.payload.body.repository.default_branch"
+        }
+      },
+      {
+        "id": "pr-action",
+        "type": "switch",
+        "position": {
+          "x": -300,
+          "y": 360
+        },
+        "data": {
+          "label": "What happened to it",
+          "expression": "{{trigger.payload.body.action}}:{{trigger.payload.body.pull_request.merged}}",
+          "cases": [
+            {
+              "value": "opened:false",
+              "label": "Opened"
+            },
+            {
+              "value": "reopened:false",
+              "label": "Reopened"
+            },
+            {
+              "value": "closed:true",
+              "label": "Merged"
+            },
+            {
+              "value": "closed:false",
+              "label": "Closed without merging"
+            }
+          ]
+        }
+      },
+      {
+        "id": "pr-opened",
+        "type": "output",
+        "position": {
+          "x": -600,
+          "y": 480
+        },
+        "data": {
+          "label": "Record dev.pr_opened",
+          "outputType": "record_observation",
+          "config": {
+            "type": "dev.pr_opened",
+            "subjectId": "{{trigger.payload.body.repository.full_name}}#{{trigger.payload.body.pull_request.number}}",
+            "subjectType": "pull_request",
+            "occurredAt": "{{trigger.payload.body.pull_request.created_at}}",
+            "data": {
+              "repo": "{{trigger.payload.body.repository.full_name}}",
+              "number": "{{trigger.payload.body.pull_request.number}}",
+              "url": "{{trigger.payload.body.pull_request.html_url}}",
+              "sha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "branch": "{{trigger.payload.body.pull_request.head.ref}}",
+              "base": "{{trigger.payload.body.pull_request.base.ref}}",
+              "intoDefault": "{{steps.into-default.output.result}}",
+              "title": "{{trigger.payload.body.pull_request.title}}",
+              "body": "{{trigger.payload.body.pull_request.body}}",
+              "action": "{{trigger.payload.body.action}}",
+              "merged": "{{trigger.payload.body.pull_request.merged}}",
+              "headSha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "author": "{{trigger.payload.body.pull_request.user.login}}",
+              "source": "github-webhook"
+            }
+          }
+        }
+      },
+      {
+        "id": "pr-reopened",
+        "type": "output",
+        "position": {
+          "x": -400,
+          "y": 480
+        },
+        "data": {
+          "label": "Record dev.pr_opened (reopened)",
+          "outputType": "record_observation",
+          "config": {
+            "type": "dev.pr_opened",
+            "subjectId": "{{trigger.payload.body.repository.full_name}}#{{trigger.payload.body.pull_request.number}}",
+            "subjectType": "pull_request",
+            "occurredAt": "{{trigger.payload.body.pull_request.updated_at}}",
+            "data": {
+              "repo": "{{trigger.payload.body.repository.full_name}}",
+              "number": "{{trigger.payload.body.pull_request.number}}",
+              "url": "{{trigger.payload.body.pull_request.html_url}}",
+              "sha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "branch": "{{trigger.payload.body.pull_request.head.ref}}",
+              "base": "{{trigger.payload.body.pull_request.base.ref}}",
+              "intoDefault": "{{steps.into-default.output.result}}",
+              "title": "{{trigger.payload.body.pull_request.title}}",
+              "body": "{{trigger.payload.body.pull_request.body}}",
+              "action": "{{trigger.payload.body.action}}",
+              "merged": "{{trigger.payload.body.pull_request.merged}}",
+              "headSha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "author": "{{trigger.payload.body.pull_request.user.login}}",
+              "source": "github-webhook"
+            }
+          }
+        }
+      },
+      {
+        "id": "pr-merged",
+        "type": "output",
+        "position": {
+          "x": -200,
+          "y": 480
+        },
+        "data": {
+          "label": "Record dev.pr_merged",
+          "outputType": "record_observation",
+          "config": {
+            "type": "dev.pr_merged",
+            "subjectId": "{{trigger.payload.body.repository.full_name}}#{{trigger.payload.body.pull_request.number}}",
+            "subjectType": "pull_request",
+            "occurredAt": "{{trigger.payload.body.pull_request.merged_at}}",
+            "data": {
+              "repo": "{{trigger.payload.body.repository.full_name}}",
+              "number": "{{trigger.payload.body.pull_request.number}}",
+              "url": "{{trigger.payload.body.pull_request.html_url}}",
+              "sha": "{{trigger.payload.body.pull_request.merge_commit_sha}}",
+              "branch": "{{trigger.payload.body.pull_request.head.ref}}",
+              "base": "{{trigger.payload.body.pull_request.base.ref}}",
+              "intoDefault": "{{steps.into-default.output.result}}",
+              "title": "{{trigger.payload.body.pull_request.title}}",
+              "body": "{{trigger.payload.body.pull_request.body}}",
+              "action": "{{trigger.payload.body.action}}",
+              "merged": "{{trigger.payload.body.pull_request.merged}}",
+              "headSha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "author": "{{trigger.payload.body.pull_request.user.login}}",
+              "source": "github-webhook"
+            }
+          }
+        }
+      },
+      {
+        "id": "pr-closed",
+        "type": "output",
+        "position": {
+          "x": 0,
+          "y": 480
+        },
+        "data": {
+          "label": "Record dev.pr_closed",
+          "outputType": "record_observation",
+          "config": {
+            "type": "dev.pr_closed",
+            "subjectId": "{{trigger.payload.body.repository.full_name}}#{{trigger.payload.body.pull_request.number}}",
+            "subjectType": "pull_request",
+            "occurredAt": "{{trigger.payload.body.pull_request.closed_at}}",
+            "data": {
+              "repo": "{{trigger.payload.body.repository.full_name}}",
+              "number": "{{trigger.payload.body.pull_request.number}}",
+              "url": "{{trigger.payload.body.pull_request.html_url}}",
+              "sha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "branch": "{{trigger.payload.body.pull_request.head.ref}}",
+              "base": "{{trigger.payload.body.pull_request.base.ref}}",
+              "intoDefault": "{{steps.into-default.output.result}}",
+              "title": "{{trigger.payload.body.pull_request.title}}",
+              "body": "{{trigger.payload.body.pull_request.body}}",
+              "action": "{{trigger.payload.body.action}}",
+              "merged": "{{trigger.payload.body.pull_request.merged}}",
+              "headSha": "{{trigger.payload.body.pull_request.head.sha}}",
+              "author": "{{trigger.payload.body.pull_request.user.login}}",
+              "source": "github-webhook"
+            }
+          }
+        }
+      },
+      {
+        "id": "cs-action",
+        "type": "switch",
+        "position": {
+          "x": 300,
+          "y": 240
+        },
+        "data": {
+          "label": "Has it completed",
+          "expression": "{{trigger.payload.body.action}}",
+          "cases": [
+            {
+              "value": "completed",
+              "label": "Completed"
+            }
+          ]
+        }
+      },
+      {
+        "id": "known-conclusion",
+        "type": "guard",
+        "position": {
+          "x": 300,
+          "y": 360
+        },
+        "data": {
+          "label": "A conclusion the dev loop knows",
+          "checks": [
+            {
+              "path": "trigger.payload.body.check_suite.conclusion",
+              "anyOf": [
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "success"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "failure"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "cancelled"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "skipped"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "neutral"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "timed_out"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "startup_failure"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "action_required"
+                },
+                {
+                  "path": "trigger.payload.body.check_suite.conclusion",
+                  "equals": "stale"
+                }
+              ],
+              "message": "A check suite whose conclusion the dev-loop contract does not know (or none yet): not reported."
+            }
+          ]
+        }
+      },
+      {
+        "id": "is-startup-failure",
+        "type": "condition",
+        "position": {
+          "x": 300,
+          "y": 480
+        },
+        "data": {
+          "label": "Concluded startup_failure",
+          "expression": "trigger.payload.body.check_suite.conclusion == \"startup_failure\""
+        }
+      },
+      {
+        "id": "fold-1",
+        "type": "select",
+        "position": {
+          "x": 300,
+          "y": 600
+        },
+        "data": {
+          "label": "startup_failure reads as failure",
+          "when": "{{steps.is-startup-failure.output.result}}",
+          "ifTrue": "failure",
+          "ifFalse": "{{trigger.payload.body.check_suite.conclusion}}"
+        }
+      },
+      {
+        "id": "is-action-required",
+        "type": "condition",
+        "position": {
+          "x": 300,
+          "y": 720
+        },
+        "data": {
+          "label": "Concluded action_required",
+          "expression": "trigger.payload.body.check_suite.conclusion == \"action_required\""
+        }
+      },
+      {
+        "id": "fold-2",
+        "type": "select",
+        "position": {
+          "x": 300,
+          "y": 840
+        },
+        "data": {
+          "label": "action_required reads as neutral",
+          "when": "{{steps.is-action-required.output.result}}",
+          "ifTrue": "neutral",
+          "ifFalse": "{{steps.fold-1.output.value}}"
+        }
+      },
+      {
+        "id": "is-stale",
+        "type": "condition",
+        "position": {
+          "x": 300,
+          "y": 960
+        },
+        "data": {
+          "label": "Concluded stale",
+          "expression": "trigger.payload.body.check_suite.conclusion == \"stale\""
+        }
+      },
+      {
+        "id": "fold-3",
+        "type": "select",
+        "position": {
+          "x": 300,
+          "y": 1080
+        },
+        "data": {
+          "label": "stale reads as cancelled",
+          "when": "{{steps.is-stale.output.result}}",
+          "ifTrue": "cancelled",
+          "ifFalse": "{{steps.fold-2.output.value}}"
+        }
+      },
+      {
+        "id": "ci-finished",
+        "type": "output",
+        "position": {
+          "x": 300,
+          "y": 1200
+        },
+        "data": {
+          "label": "Record ci.finished",
+          "outputType": "record_observation",
+          "config": {
+            "type": "ci.finished",
+            "subjectId": "{{trigger.payload.body.repository.full_name}}@{{trigger.payload.body.check_suite.head_sha}}",
+            "subjectType": "ci_run",
+            "occurredAt": "{{trigger.payload.body.check_suite.updated_at}}",
+            "data": {
+              "status": "{{steps.fold-3.output.value}}",
+              "sha": "{{trigger.payload.body.check_suite.head_sha}}",
+              "repo": "{{trigger.payload.body.repository.full_name}}",
+              "pr": "{{trigger.payload.body.check_suite.pull_requests[0].number}}",
+              "workflow": "{{trigger.payload.body.check_suite.app.name}}",
+              "branch": "{{trigger.payload.body.check_suite.head_branch}}",
+              "conclusion": "{{trigger.payload.body.check_suite.conclusion}}",
+              "source": "github-webhook"
+            }
+          }
+        }
+      }
+    ],
+    "edges": [
+      {
+        "id": "t--route",
+        "source": "t",
+        "target": "route"
+      },
+      {
+        "id": "route--into-default",
+        "source": "route",
+        "target": "into-default",
+        "sourceHandle": "pull_request"
+      },
+      {
+        "id": "into-default--pr-action",
+        "source": "into-default",
+        "target": "pr-action"
+      },
+      {
+        "id": "pr-action--pr-opened",
+        "source": "pr-action",
+        "target": "pr-opened",
+        "sourceHandle": "opened:false"
+      },
+      {
+        "id": "pr-action--pr-reopened",
+        "source": "pr-action",
+        "target": "pr-reopened",
+        "sourceHandle": "reopened:false"
+      },
+      {
+        "id": "pr-action--pr-merged",
+        "source": "pr-action",
+        "target": "pr-merged",
+        "sourceHandle": "closed:true"
+      },
+      {
+        "id": "pr-action--pr-closed",
+        "source": "pr-action",
+        "target": "pr-closed",
+        "sourceHandle": "closed:false"
+      },
+      {
+        "id": "route--cs-action",
+        "source": "route",
+        "target": "cs-action",
+        "sourceHandle": "check_suite"
+      },
+      {
+        "id": "cs-action--known-conclusion",
+        "source": "cs-action",
+        "target": "known-conclusion",
+        "sourceHandle": "completed"
+      },
+      {
+        "id": "known-conclusion--is-startup-failure",
+        "source": "known-conclusion",
+        "target": "is-startup-failure"
+      },
+      {
+        "id": "is-startup-failure--fold-1",
+        "source": "is-startup-failure",
+        "target": "fold-1"
+      },
+      {
+        "id": "fold-1--is-action-required",
+        "source": "fold-1",
+        "target": "is-action-required"
+      },
+      {
+        "id": "is-action-required--fold-2",
+        "source": "is-action-required",
+        "target": "fold-2"
+      },
+      {
+        "id": "fold-2--is-stale",
+        "source": "fold-2",
+        "target": "is-stale"
+      },
+      {
+        "id": "is-stale--fold-3",
+        "source": "is-stale",
+        "target": "fold-3"
+      },
+      {
+        "id": "fold-3--ci-finished",
+        "source": "fold-3",
+        "target": "ci-finished"
+      }
+    ]
+  },
+  "metadata": {
+    "staged": "STAGED (no catalog header, so never published): it uses the record_observation output verb (Synap-core/backend#325) and the webhookSource binding (Synap-core/backend#327), neither merged yet, and the catalog flow vocabulary (src/validate-flow.ts, bound to backend main by validate-flow.drift.test.ts) does not know record_observation. Once both merge: add record_observation to src/validate-flow.ts and a github-pr-events.catalog.json header beside this file.",
+    "mapping": "Ported from Synap-core/backend scripts/pod-observation.mjs (#281): opened/reopened \u2192 dev.pr_opened, closed+merged \u2192 dev.pr_merged (sha = merge commit), closed \u2192 dev.pr_closed; intoDefault = base.ref == repository.default_branch; a check suite's conclusion folds startup_failure \u2192 failure, action_required \u2192 neutral, stale \u2192 cancelled, and any other conclusion is not reported (the guard). Optional fields that resolve to null are left out by the step (contract: absent, never null). The session is resolved by the pod from the PR body's Pod session line (record-observation's resolver), so no field carries it.",
+    "sender": "A person creates the inbound webhook source named GitHub in the install space (pod-admin, space Connections, Webhook sources): the install binds to it by name, in either order. GitHub org webhook: Payload URL = that source's URL, Content type application/json, Secret = the source's secret (shown once; Replace secret shows a new one), events: Pull requests + Check suites."
+  }
+}

package/automations/mail-feed.automation.json

@@ -0,0 +1,86 @@
+{
+  "name": "Mail feed → Discord (AI-triaged)",
+  "triggerType": "cron",
+  "status": "draft",
+  "triggerConfig": { "expression": "0 */2 * * *" },
+  "flowDefinition": {
+    "nodes": [
+      {
+        "id": "trigger",
+        "type": "trigger",
+        "position": { "x": 0, "y": 0 },
+        "data": {
+          "triggerType": "cron",
+          "label": "Every 2 hours",
+          "config": { "expression": "0 */2 * * *" }
+        }
+      },
+      {
+        "id": "fetch-mail",
+        "type": "capability",
+        "position": { "x": 0, "y": 120 },
+        "data": {
+          "label": "Search Gmail (source verb)",
+          "verbId": "gmail_search",
+          "inputMapping": { "query": "newer_than:2d", "maxResults": "25" },
+          "connectionSelector": { "connectionId": "" }
+        }
+      },
+      {
+        "id": "triage",
+        "type": "capability",
+        "position": { "x": 0, "y": 240 },
+        "data": {
+          "label": "AI triage (batch classifier verb)",
+          "verbId": "ai.triage",
+          "inputMapping": { "emails": "{{steps.fetch-mail.output.results}}" }
+        }
+      },
+      {
+        "id": "relevant-loop",
+        "type": "loop",
+        "position": { "x": 0, "y": 360 },
+        "data": {
+          "label": "For each relevant email",
+          "iteratorExpression": "steps.triage.output.results",
+          "itemVariable": "email"
+        }
+      },
+      {
+        "id": "post-to-feed",
+        "type": "output",
+        "position": { "x": 0, "y": 480 },
+        "data": {
+          "label": "Post to the Discord-bound feed channel",
+          "outputType": "channel_message",
+          "config": {
+            "channelId": "<discord-bound team feed channel id>",
+            "content": "**{{loop.item.subject}}** — _{{loop.item.category}}_\n{{loop.item.summary}}",
+            "channelType": "proactive",
+            "metadata": {
+              "proactiveType": "mail-feed",
+              "gmailId": "{{loop.item.id}}"
+            }
+          }
+        }
+      }
+    ],
+    "edges": [
+      { "id": "e1", "source": "trigger", "target": "fetch-mail" },
+      { "id": "e2", "source": "fetch-mail", "target": "triage" },
+      { "id": "e3", "source": "triage", "target": "relevant-loop" },
+      { "id": "e4", "source": "relevant-loop", "target": "post-to-feed" }
+    ]
+  },
+  "metadata": {
+    "source": "feed-template",
+    "purpose": "CANONICAL example of the North Star: a FEED is an AUTOMATION that composes capability verbs. Cron → gmail_search (source verb) → AI triage (classifier verb) → loop → post relevant items to a Discord-bound feed channel. Replaces the bespoke run-mail-feed.ts worker with pure config.",
+    "prerequisites": [
+      "Wave 1 (SHIPPED): the `capability` node dispatches gmail_search (declarative) + any verb through executeCapability.",
+      "verb `ai.triage`: a batch email classifier verb must be seeded (today this is the mail_triage IS route; roadmap folds it into a verb). Until then, swap the triage node for a `command` node (IS task) or point verbId at the seeded classifier.",
+      "a connected Google account (nango-google) + set connectionSelector.connectionId to pin the mailbox.",
+      "a Discord-bound `branchPurpose:'team'` feed channel — put its id in the post node (or use channelType:'proactive' for the user's feed).",
+      "PER-ITEM filtering/AI inside the loop needs automation Wave 2 (loop body currently allows `output` only — this template does BATCH triage OUTSIDE the loop and posts via an `output.channel_message` node INSIDE the loop, which IS loop-allowed today)."
+    ]
+  }
+}