@sellable/mcp 0.1.511 → 0.1.512

package/skills/refill-sends-evergreen-workflow/core/flow.v1.json

@@ -0,0 +1,247 @@
+{
+  "version": "v1.0",
+  "workflow": "refill-sends-evergreen-workflow",
+  "principle": "Plan evergreen waterfall refill as a read-only dry-run with zero mutations.",
+  "enumeratedRungs": [
+    "start_campaign",
+    "approve_messages",
+    "wait_for_active_work",
+    "enrich_more",
+    "reconcile_source_copy",
+    "add_leads_same_source",
+    "paid_lane_fallback",
+    "next_campaign",
+    "wait_for_scheduler",
+    "done"
+  ],
+  "requiredBootstrap": [
+    {
+      "tool": "get_auth_status",
+      "purpose": "Confirm MCP auth before reading workspace or plan facts."
+    },
+    {
+      "tool": "get_active_workspace",
+      "purpose": "Resolve explicit workspace evidence when the request did not provide workspaceId."
+    },
+    {
+      "tool": "refill_sends_evergreen",
+      "requiredValues": {
+        "workspaceId": "{workspaceId}"
+      },
+      "requiredOutput": [
+        "readOnly true",
+        "approvalContract says Phase 85 is plan-only"
+      ]
+    },
+    {
+      "tool": "get_subskill_prompt",
+      "requiredValues": {
+        "subskillName": "refill-sends-evergreen-workflow"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      }
+    },
+    {
+      "tool": "get_subskill_asset",
+      "requiredValues": {
+        "subskillName": "refill-sends-evergreen-workflow",
+        "assetPath": "core/flow.v1.json"
+      },
+      "mustReadUntil": {
+        "hasMore": false
+      },
+      "validation": {
+        "workflow": "refill-sends-evergreen-workflow",
+        "versionPrefix": "v1",
+        "requiredTopLevelKeys": [
+          "states",
+          "gateOrder",
+          "enumeratedRungs",
+          "verification"
+        ]
+      }
+    },
+    {
+      "tool": "get_evergreen_refill_plan",
+      "requiredValues": {
+        "workspaceId": "{workspaceId}"
+      },
+      "requiredOutput": [
+        "planRevision",
+        "stateRevision",
+        "packet",
+        "journalPath",
+        "sideEffects"
+      ]
+    }
+  ],
+  "gateOrder": ["bootstrap", "plan", "report"],
+  "states": [
+    {
+      "id": "bootstrap",
+      "description": "Load the read-only command contract, workflow prompt, flow asset, and workspace facts.",
+      "allowedTools": [
+        "get_auth_status",
+        "get_active_workspace",
+        "list_workspaces",
+        "get_workspace",
+        "refill_sends_evergreen",
+        "get_subskill_prompt",
+        "get_subskill_asset",
+        "get_evergreen_refill_plan"
+      ],
+      "onEnter": [
+        {
+          "tool": "get_auth_status"
+        },
+        {
+          "tool": "refill_sends_evergreen",
+          "requiredFields": ["workspaceId"]
+        },
+        {
+          "tool": "get_subskill_prompt",
+          "requiredValues": {
+            "subskillName": "refill-sends-evergreen-workflow"
+          }
+        },
+        {
+          "tool": "get_subskill_asset",
+          "requiredValues": {
+            "subskillName": "refill-sends-evergreen-workflow",
+            "assetPath": "core/flow.v1.json"
+          }
+        }
+      ],
+      "transitions": {
+        "contract_loaded": "plan"
+      }
+    },
+    {
+      "id": "plan",
+      "description": "Call the dry-run evergreen refill planner exactly once for this invocation.",
+      "allowedTools": ["get_evergreen_refill_plan"],
+      "onEnter": [
+        {
+          "tool": "get_evergreen_refill_plan",
+          "requiredFields": ["workspaceId"],
+          "optionalFields": ["senderIds", "runState", "journal", "journalNote"]
+        }
+      ],
+      "requiredOutput": [
+        "sideEffects all false",
+        "planRevision starts with pr1:",
+        "journalPath reported",
+        "chosen evergreenRung is in enumeratedRungs"
+      ],
+      "allowedRungsSource": "enumeratedRungs",
+      "doNotAllow": [
+        "add_column",
+        "add_on_demand_leads",
+        "add_rubric_item",
+        "add_teammate",
+        "add_to_comment_campaign",
+        "add_to_connection_campaign",
+        "add_to_inmail_campaign",
+        "archive_campaign",
+        "attach_recommended_sequence",
+        "attach_sequence",
+        "bulk_enrich_with_prospeo",
+        "cancel_campaign_message_preparation",
+        "cancel_lead_import",
+        "capture_post_idea",
+        "check_rubric",
+        "commit_blueprint",
+        "confirm_harvest_job_companies",
+        "confirm_lead_list",
+        "confirm_prospeo_company_accounts",
+        "copy_sender_config",
+        "create_campaign",
+        "create_on_demand_campaign",
+        "create_on_demand_table",
+        "create_workspace",
+        "create_workflow_table",
+        "delete_column",
+        "delete_rubric_item",
+        "duplicate_campaign",
+        "enrich_with_prospeo",
+        "fill_campaign_horizon",
+        "get_or_create_direct_campaign_table",
+        "import_leads",
+        "load_csv_dnc_entries",
+        "load_csv_domains",
+        "load_csv_linkedin_leads",
+        "mark_post_published",
+        "migrate_flat_configs",
+        "pause_campaign",
+        "pause_direct_campaign",
+        "pause_on_demand_campaign",
+        "prepare_campaign_ab_test",
+        "queue_campaign_cells",
+        "queue_cells",
+        "record_campaign_review_batch",
+        "record_engage_proven_search",
+        "refill_sends",
+        "refresh_paid_inmail_credits",
+        "revise_message_template_and_rerun",
+        "save_domain_filters",
+        "save_hook_research",
+        "save_post_draft",
+        "save_rubrics",
+        "send_inbox_draft",
+        "send_inbox_manual_reply",
+        "set_active_workspace",
+        "set_campaign_waterfall_order",
+        "set_company_info",
+        "set_engage_state",
+        "set_engage_style_guide",
+        "set_headline_icp_criteria",
+        "set_sender_routing",
+        "setup_evergreen_campaigns",
+        "start_campaign",
+        "start_campaign_message_preparation",
+        "start_direct_campaign",
+        "start_on_demand_campaign",
+        "update_campaign",
+        "update_campaign_brief",
+        "update_cell",
+        "update_column",
+        "update_inbox_draft",
+        "update_post_draft",
+        "update_published_post_metrics",
+        "update_rubric_item",
+        "upsert_engage_tracked_person",
+        "upsert_rubric"
+      ],
+      "transitions": {
+        "packet_returned": "report"
+      }
+    },
+    {
+      "id": "report",
+      "description": "Present packet, itinerary, warnings, blockers, plan revision, and journal path; then stop.",
+      "allowedTools": [],
+      "onEnter": [
+        {
+          "action": "present_packet_itinerary_and_journal_path"
+        }
+      ],
+      "terminal": true
+    }
+  ],
+  "verification": {
+    "requiredProof": [
+      "sideEffects all false in get_evergreen_refill_plan response",
+      "planRevision has pr1: prefix",
+      "journalPath reported or journalWriteFailed warning surfaced",
+      "chosen evergreenRung belongs to enumeratedRungs",
+      "packet reviewed with itinerary and blockers"
+    ],
+    "notCompletionProof": [
+      "called get_evergreen_refill_plan alone",
+      "action queue exists",
+      "ready rows alone",
+      "operator wants execution"
+    ]
+  }
+}