create-leafmesh 2.4.1__tar.gz → 2.5.0__tar.gz

create_leafmesh-2.5.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: create-leafmesh
+Version: 2.5.0
+Summary: Project scaffolding + cloud-deploy tool for LeafMesh
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: questionary<3,>=2.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: boto3<2,>=1.34
+
+# create-leafmesh
+
+Project scaffolding tool for [LeafMesh](https://pypi.org/project/leafmesh/) — the YAML-native multi-agent orchestration platform.
+
+## Install
+
+```bash
+pip install create-leafmesh
+```
+
+## Create a Project
+
+```bash
+create-leafmesh create my-project
+cd my-project
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+python main.py
+```
+
+## CLI Options
+
+```bash
+# Create in a specific directory
+create-leafmesh create my-project -o /path/to/dir
+
+# Skip git initialization
+create-leafmesh create my-project --no-git
+
+# Interactive mode (prompts for project name)
+create-leafmesh create
+```
+
+## Generated Project Structure
+
+```
+my-project/
+  configs/
+    config.yaml              # Agent definitions, mesh wiring, HITL config
+  agency/
+    greeter_agent.py         # LLM agent with @pre_compose
+    processor_agent.py       # Programmatic agent with @conditional_chain
+    researcher_agent.py      # LLM agent with @chain_with_results + smart memory
+    fallback_researcher_agent.py  # Fast fallback (race pattern)
+    advisor_agent.py         # LLM fan-in with @chain + @compose
+    scheduler_agent.py       # Cron-scheduled agent
+    tools.py                 # Custom tools (@global_tool, @tool)
+    external_agents.py       # Integration reference (CrewAI, LangGraph, etc.)
+  main.py                    # Entry point
+  hitl_stub_receiver.py      # Webhook stub for testing HITL locally
+  requirements.txt
+  .env                       # API keys
+  Dockerfile
+  docker-compose.yml         # Redis + app
+```
+
+## What's Included
+
+- **8 agents** showcasing all 4 agent types (human, llm, programmatic, external)
+- **Human-in-the-Loop (HITL)** with dual webhook mode and `from_agent` routing
+- **Fan-in/fan-out** with OR expressions (`processor AND (researcher OR fallback)`)
+- **Smart memory** with hybrid recency/relevance scoring
+- **Scheduled agents** with cron expressions
+- **Custom tools** with access control and categories
+- **All 5 decorators**: `@pre_compose`, `@chain`, `@chain_with_results`, `@conditional_chain`, `@compose`
+- **HITL test stub** (`hitl_stub_receiver.py`) for local webhook testing
+- **Docker-ready** with Redis included
+- **Full README** with HITL walkthrough (2 scenarios, step-by-step)
+
+## Requirements
+
+- Python 3.10+
+- Redis server running (default: localhost:6379)
+- At least one LLM API key (e.g. `OPENAI_API_KEY` in `.env`)
+
+## Links
+
+- [LeafMesh SDK](https://pypi.org/project/leafmesh/)
+- [LeafCraft Studios](https://leafcraft.ai)
+
+## License
+
+MIT

create_leafmesh-2.5.0/create_leafmesh/__init__.py

@@ -0,0 +1,3 @@
+"""create-leafmesh — Project scaffolding + cloud-deploy tool for LeafMesh."""
+
+__version__ = "2.5.0"

create_leafmesh-2.5.0/create_leafmesh/templates/_registry.yaml

@@ -0,0 +1,415 @@
+# create-leafmesh — Template Registry
+#
+# Single source of truth for available templates. Used by:
+#   - The CLI picker (interactive)
+#   - `create-leafmesh --list`
+#   - `create-leafmesh --describe <slug>`
+#   - The CLI's --template flag validation
+#
+# Each template is one business function from the LeafCraft operating-ROI
+# model (see docs/roi-pricing-calculator.html). A template is a TEAM of
+# capable agents — not a fixed pipeline. Wires are conditional, the
+# workflow can start from any of multiple entry points, and any agent
+# can be a terminus. The Manager composes the team for each request.
+#
+# DO NOT remove or rename `slug` fields once published — customers may
+# pin to slugs. Add new templates by appending to the `templates:` list.
+#
+# `status` values:
+#   ready    — template fully implemented and tested; available in picker
+#   planned  — listed in --list with "(coming soon)" tag; not selectable
+#   deprecated — present for legacy support; not shown in picker
+
+version: 2
+
+templates:
+
+  # ──────────────────────────────────────────────────────────────
+  # FINANCE & BACK-OFFICE
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: finance-ops
+    status: ready
+    category: "Finance & back-office"
+    short_name: "Finance Ops"
+    full_name: "Finance Operations — AP / AR / close cycle"
+    one_line: "Invoice → extract → match → reconcile → fraud-check → GL → exception."
+    industries: ["goods", "saas", "services"]
+    roi_cells: ["fin × goods", "fin × saas", "fin × services"]
+    agent_count: 16
+    cron_count: 2
+    trust_lead: "regulator visibility (high) — every action audited, exception-routed to Controller"
+    complexity: "high"
+    decision_tree_path: "finance_automation"
+    description: >
+      Accounts payable + accounts receivable + close-cycle automation.
+      Multi-entry: invoices land via email, vendor portal, ERP webhook,
+      mobile photo. Team: extraction · PO-match · 3-way recon ·
+      fraud/duplicate · GL-coding · exception drafter, with AP clerk,
+      Controller, CFO, internal auditor in the human roster.
+      Industry config overlays for goods (PO-heavy), SaaS (revenue
+      recognition), services (project accounting).
+
+  - slug: recruiting-ops
+    status: ready
+    category: "People operations"
+    short_name: "Recruiting Ops"
+    full_name: "Recruiting & HR Operations"
+    one_line: "Source → screen → outreach → schedule → offer."
+    industries: ["any (services-strong)"]
+    roi_cells: ["recruit × services"]
+    agent_count: 14
+    cron_count: 1
+    trust_lead: "internal visibility — pipeline-health monitor + offer-letter HITL"
+    complexity: "medium"
+    decision_tree_path: "talent_pipeline"
+    description: >
+      End-to-end recruiting team. Multi-entry: req filed in ATS,
+      referral submitted, LinkedIn-InMail reply, scheduled wake-up
+      for pipeline health. Team: sourcing · resume screener · outreach
+      drafter · scheduling agent · pipeline monitor · offer drafter,
+      with sourcer, recruiter, recruiting manager, hiring manager,
+      HRBP, coordinator in the human roster.
+
+  # ──────────────────────────────────────────────────────────────
+  # CUSTOMER-FACING
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: customer-support
+    status: ready
+    category: "Customer & growth"
+    short_name: "Customer Support"
+    full_name: "Customer Support — ticket triage & resolution"
+    one_line: "Ticket → triage → sentiment → KB → draft → QA → escalation."
+    industries: ["saas", "services", "any with support"]
+    roi_cells: ["supp × saas"]
+    agent_count: 14
+    cron_count: 0
+    trust_lead: "customer visibility — sentiment-aware, escalation default-deny on low confidence"
+    complexity: "medium"
+    decision_tree_path: "support_triage"
+    description: >
+      Reactive support team. Multi-entry: Slack/email/chat/phone/web
+      channels each fire ticket.opened. Team: triage · sentiment ·
+      knowledge · response · QA · escalation, with Tier-1, Tier-2,
+      Tier-3 SME, queue manager, QA reviewer, account-named-CSM in
+      the human roster. Channel-native HITL — operators reply where
+      they already work.
+
+  - slug: customer-success
+    status: ready
+    category: "Customer & growth"
+    short_name: "Customer Success"
+    full_name: "Customer Success — retention & renewal"
+    one_line: "Health score → risk → playbook → QBR → renewal — proactive."
+    industries: ["saas"]
+    roi_cells: ["cs × saas"]
+    agent_count: 15
+    cron_count: 1
+    trust_lead: "customer visibility — high — save-play actions HITL-gated"
+    complexity: "high"
+    decision_tree_path: "retention_motion"
+    description: >
+      Proactive (NOT reactive) retention team. Multi-entry:
+      product-telemetry signal, billing event, support escalation
+      crossing CS threshold, scheduled health-score sweep. Team:
+      health-score · risk detector · playbook trigger · QBR drafter ·
+      renewal forecaster · save-play, with CSM, senior CSM,
+      renewals manager, AE, CS Ops, VP CS in the human roster.
+
+  # ──────────────────────────────────────────────────────────────
+  # ENGINEERING & INFRA
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: engineering-sdlc
+    status: ready
+    category: "Engineering & platform"
+    short_name: "Engineering SDLC"
+    full_name: "Engineering / R&D — software delivery"
+    one_line: "Ticket → spec → build → test → security → review → merge."
+    industries: ["saas", "any with eng org"]
+    roi_cells: ["eng × saas"]
+    agent_count: 14
+    cron_count: 2
+    trust_lead: "internal visibility — security agent gate before merge; reviewer HITL on risky changes"
+    complexity: "high"
+    decision_tree_path: "sdlc_acceleration"
+    description: >
+      Software-delivery team. Multi-entry: ticket filed, PR opened,
+      design-doc submitted, scheduled refactor pass. Team: spec ·
+      junior engineer · test engineer · security · code reviewer ·
+      refactor · doc, with junior, senior, staff/tech lead, eng
+      manager, architect, PM, QA, security, SRE in the human roster.
+
+  - slug: infra-cost-ops
+    status: ready
+    category: "Engineering & platform"
+    short_name: "Infra Cost Ops"
+    full_name: "Infrastructure & Cloud Cost Optimization"
+    one_line: "Telemetry → right-size → reserved-plan → drift → tune."
+    industries: ["saas", "any cloud-heavy"]
+    roi_cells: ["infra × saas"]
+    agent_count: 9
+    cron_count: 1
+    trust_lead: "internal — risky tunes HITL-gated by SRE"
+    complexity: "medium"
+    decision_tree_path: "cloud_cost"
+    description: >
+      Continuous cloud-cost optimization. Multi-entry: cost-anomaly
+      alert, scheduled right-size sweep, IaC commit triggers drift
+      check, reserved-capacity renewal window. Team: cost tuner ·
+      right-sizer · reserved-capacity planner · anomaly detector ·
+      IaC drift, with SRE, DevOps, platform eng, cost analyst, CTO
+      in the human roster.
+
+  # ──────────────────────────────────────────────────────────────
+  # REVENUE & GO-TO-MARKET
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: sales-orchestration
+    status: ready
+    category: "Customer & growth"
+    short_name: "Sales Orchestration"
+    full_name: "Sales & Marketing — lead-to-handoff"
+    one_line: "Score → route → sequence → personalise → handoff."
+    industries: ["saas", "services"]
+    roi_cells: ["sales × saas"]
+    agent_count: 11
+    cron_count: 1
+    trust_lead: "customer — pipeline-health monitor on adaptive routing"
+    complexity: "medium"
+    decision_tree_path: "inbound_sales"
+    description: >
+      Inbound-sales team. Multi-entry: web-form submit, demo request,
+      event-list ingest, partner-lead handoff, scheduled
+      pipeline-health sweep. Team: scorer · router · sequence
+      orchestrator · personalisation · handoff · health monitor, with
+      SDR, AE, sales manager, marketing ops, RevOps, sales engineer,
+      VP Sales in the human roster.
+
+  - slug: bd-proposals
+    status: ready
+    category: "Customer & growth"
+    short_name: "BD Proposals"
+    full_name: "Business Development — proposals & RFPs"
+    one_line: "RFP → past-proposal → draft → pricing → compliance."
+    industries: ["services"]
+    roi_cells: ["bd × services"]
+    agent_count: 14
+    cron_count: 0
+    trust_lead: "customer — legal compliance reviewer + practice-lead HITL on pricing"
+    complexity: "medium"
+    decision_tree_path: "proposal_factory"
+    description: >
+      RFP-response team. Multi-entry: RFP email, RFP portal upload,
+      partner-referred opportunity. Team: RFP ingester · past-proposal
+      retriever · section drafter · pricing-config · compliance
+      reviewer · closing, with BD rep, practice lead, proposal
+      writer, engagement architect, partner, legal in the human roster.
+
+  - slug: quote-to-cash
+    status: ready
+    category: "Finance & back-office"
+    short_name: "Quote to Cash"
+    full_name: "Pricing & Quote-to-Cash"
+    one_line: "RFQ → cost calc → discount policy → approval → quote."
+    industries: ["goods", "services"]
+    roi_cells: ["price × goods"]
+    agent_count: 13
+    cron_count: 0
+    trust_lead: "customer + regulator (margin policy) — discount approval HITL-gated"
+    complexity: "medium"
+    decision_tree_path: "dynamic_pricing"
+    description: >
+      RFQ-to-quote team. Multi-entry: RFQ email, sales-rep request,
+      CPQ event, competitor-price-change webhook. Team: RFQ ingester ·
+      cost calculator · discount-policy · approval router · quote
+      drafter · competitor watch, with sales rep, deal desk, pricing
+      analyst, sales manager, finance approver in the human roster.
+
+  # ──────────────────────────────────────────────────────────────
+  # SERVICES DELIVERY
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: services-delivery
+    status: ready
+    category: "Services & delivery"
+    short_name: "Services Delivery"
+    full_name: "Professional Services — delivery operations"
+    one_line: "Brief → context → research → analysis → draft → QA."
+    industries: ["services", "saas (PS arm)"]
+    roi_cells: ["util × services", "hours × services"]
+    agent_count: 18
+    cron_count: 1
+    trust_lead: "customer — engagement-lead HITL on final delivery"
+    complexity: "high"
+    decision_tree_path: "consulting_engagement"
+    description: >
+      Billable-delivery team — covers both "more output per head" and
+      "fewer hours per job" ROI angles in a single mesh. Multi-entry:
+      brief filed, client message, scheduled status report. Team:
+      research · context · analysis · draft · QA · knowledge ·
+      citation, with consultant, senior consultant, SME, engagement
+      lead, partner, QA reviewer in the human roster.
+
+  - slug: bench-management
+    status: ready
+    category: "People operations"
+    short_name: "Bench Management"
+    full_name: "Resource & Bench Allocation"
+    one_line: "Forecast → skills match → allocate → idle-detect."
+    industries: ["services"]
+    roi_cells: ["bench × services"]
+    agent_count: 11
+    cron_count: 0
+    trust_lead: "internal — staffing-partner HITL on allocation conflicts"
+    complexity: "medium"
+    decision_tree_path: "staff_utilization"
+    description: >
+      Continuous resource-allocation team. Multi-entry: new project
+      kickoff, person rolls off engagement, weekly bench review.
+      Team: capacity forecaster · skills matcher · project
+      allocator · idle detector · reskilling recommender, with
+      resource manager, staffing partner, engagement lead, practice
+      lead, talent ops in the human roster.
+
+  # ──────────────────────────────────────────────────────────────
+  # GOODS / MANUFACTURING
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: production-planning
+    status: ready
+    category: "Production & supply"
+    short_name: "Production Planning"
+    full_name: "Production Planning & Scheduling"
+    one_line: "Demand sense → schedule → constraint flag → release."
+    industries: ["goods"]
+    roi_cells: ["prod × goods"]
+    agent_count: 14
+    cron_count: 1
+    trust_lead: "internal — planner HITL on conflict / major change"
+    complexity: "medium"
+    decision_tree_path: "factory_planning"
+    description: >
+      Production-planning team. Multi-entry: demand signal arrives,
+      capacity change event, scheduled re-optimization wake-up. Team:
+      demand sensor · scheduler · constraint flagger · re-optimizer ·
+      conflict resolver, with demand planner, master scheduler, plant
+      manager, capacity planner, materials manager, ops director in
+      the human roster.
+
+  - slug: quality-yield
+    status: ready
+    category: "Production & supply"
+    short_name: "Quality & Yield"
+    full_name: "Quality Inspection & Yield Optimization"
+    one_line: "Inspect → defect → root-cause → corrective → release."
+    industries: ["goods"]
+    roi_cells: ["qual × goods"]
+    agent_count: 10
+    cron_count: 1
+    trust_lead: "internal — QA-manager HITL on batch-release decisions"
+    complexity: "medium"
+    decision_tree_path: "quality_systems"
+    description: >
+      Quality-inspection team. Multi-entry: vision-system event,
+      SPC-out-of-control signal, customer complaint webhook,
+      scheduled batch inspection. Team: defect detector · root-cause
+      analyzer · yield optimizer · SPC monitor · corrective-action
+      drafter, with QA inspector, QA manager, plant engineer, process
+      engineer, reliability lead in the human roster.
+
+  - slug: predictive-maintenance
+    status: ready
+    category: "Production & supply"
+    short_name: "Predictive Maintenance"
+    full_name: "Asset Condition & Predictive Maintenance"
+    one_line: "Condition sense → predict failure → work order → parts → repair."
+    industries: ["goods"]
+    roi_cells: ["maint × goods"]
+    agent_count: 11
+    cron_count: 1
+    trust_lead: "internal — reliability-engineer HITL on shutdown / unscheduled work"
+    complexity: "medium"
+    decision_tree_path: "asset_reliability"
+    description: >
+      Condition-based maintenance team. Multi-entry: IIoT sensor
+      anomaly, work order filed, scheduled inspection, parts-arrived
+      event. Team: condition sensor · failure predictor · work-order
+      scheduler · parts requestor · technician dispatcher, with
+      maintenance tech, reliability engineer, ops manager, asset
+      planner in the human roster.
+
+  - slug: warehouse-supply-chain
+    status: ready
+    category: "Production & supply"
+    short_name: "Warehouse / Supply Chain"
+    full_name: "Warehouse Operations & Supply Chain (with humanoid integration)"
+    one_line: "Order → allocate → pick (humanoid) → inspect → pack → ship."
+    industries: ["goods"]
+    roi_cells: ["supply × goods"]
+    agent_count: 16
+    cron_count: 1
+    trust_lead: "internal + safety — ops-supervisor HITL on damage / exception; humanoid actions audit-trailed"
+    complexity: "high"
+    decision_tree_path: "physical_operations"
+    description: >
+      Warehouse-operations team — introduces the humanoid actor kind
+      for physical work. Multi-entry: order placed, returns received,
+      restock event, scheduled cycle count. Team: allocation ·
+      inventory · routing · exception (agents) PLUS picker · inspection
+      · loader (humanoids — projected $3-8/hr), with ops supervisor,
+      warehouse manager, inventory analyst, inbound coordinator,
+      safety officer, transport planner in the human roster.
+
+  - slug: procurement-ops
+    status: ready
+    category: "Production & supply"
+    short_name: "Procurement Ops"
+    full_name: "Procure-to-Pay & Supply Chain Operations"
+    one_line: "Order intake → inventory check → supplier sourcing → PO → goods receipt."
+    industries: ["goods", "services"]
+    roi_cells: ["procurement × goods"]
+    agent_count: 11
+    cron_count: 1
+    trust_lead: "operations-manager HITL on order approval; po-approver HITL before formal PO issuance; hash-chained audit on every state change"
+    complexity: "high"
+    decision_tree_path: "procure_to_pay"
+    description: >
+      Procure-to-pay team — order intake + compliance screening in a
+      single LLM pass, then inventory check, supplier sourcing,
+      logistics planning, PO generation (real PDF rendering),
+      goods-receipt note, and supply-health reporting. Seed data in
+      configs/inventory.yaml, configs/suppliers.yaml, configs/open_pos.yaml
+      gives a working demo on first run; replace with ERP / WMS /
+      supplier-management API calls in production. Two human roles:
+      operations_manager (order approval) and po_approval (PO issuance).
+      Includes Lyzr-inspired trade_compliance + tariff_classifier
+      agents for international procurement workflows.
+
+  # ──────────────────────────────────────────────────────────────
+  # MARKETING & GROWTH
+  # ──────────────────────────────────────────────────────────────
+
+  - slug: marketing-ops
+    status: ready
+    category: "Customer & growth"
+    short_name: "Marketing Ops"
+    full_name: "Marketing Operations — campaign & growth"
+    one_line: "Brief → audience+comp → strategy → copy+visual → compliance → publish → perf → attribute."
+    industries: ["saas", "services", "goods"]
+    roi_cells: ["mkt × saas", "mkt × services", "mkt × goods"]
+    agent_count: 15
+    cron_count: 0
+    trust_lead: "brand + legal visibility — compliance gates publish; legal HITL on regulated claims; CMO on budget > 50K and crises"
+    complexity: "high"
+    decision_tree_path: "campaign_growth"
+    description: >
+      Marketing team — campaign briefs land via many channels (form,
+      email, product-launch, competitor signal, crisis). Team:
+      brief intake · audience intelligence · competitor intel ·
+      campaign strategist · copywriter · visual briefer · compliance
+      reviewer · publisher · performance analyzer · attribution ·
+      crisis responder, with marketing manager, legal reviewer, and
+      CMO in the human roster. Includes weekly performance sweep
+      cron + rapid crisis-response side path.

create_leafmesh-2.5.0/create_leafmesh/templates/bd-proposals/README.md

@@ -0,0 +1,27 @@
+# {{project_name}} — BD Proposals
+
+bd × services, YAML-first. opportunity_feed pulls new opportunities
+from YOUR capture tool (GovWin / SAM.gov / FedConnect saved searches,
+via the n8n connector — the watchlist and dedup live there, not in
+template SQLite) → rfp_intake normalises inbound RFPs + extracts
+structured requirements → precedent_research (prior wins + the
+proposal-library knowledge group over your DMS) → sections → pricing
+(rate-card bands) → contracts_review (regulatory fit + clause
+playbook, mode-dispatched). Deal-breakers and incomplete attachment
+extraction route to partner; blocked clearance or any unacceptable
+clause forces legal review (hard gate); out-of-band pricing flags
+practice-lead review; competitive_intel runs win/loss post-mortems
+and forwards surfaced competitor signals to YOUR CRM through the
+competitor_signal_ledger connector (ingest / query); writer /
+practice_lead / partner / legal HITL chain default-deny;
+hash-chained WORM.
+
+Everything is configured in `configs/config.yaml` — the only Python
+left is the WORM audit sink (`agency/_shared/audit_logger.py`).
+Point `OPPORTUNITY_FEED_WEBHOOK_URL` and `CRM_SIGNAL_WEBHOOK_URL`
+at your systems, then uncomment the scout cron on
+`opportunity_feed_agent`.
+
+```bash
+cp env .env && pip install -r requirements.txt && python main.py
+```

create_leafmesh-2.5.0/create_leafmesh/templates/bd-proposals/_prompts.json

@@ -0,0 +1,67 @@
+{
+  "env_vars": [
+    {
+      "key": "LEAFMESH_LICENSE_KEY",
+      "label": "LeafMesh license key",
+      "signup_url": "https://leafcraft.ai",
+      "required": true,
+      "note": "Required to start the SDK. Format: 4BB1-…-01CF (20 hyphen groups)."
+    },
+    {
+      "key": "LEAFMESH_ENV_TOKEN",
+      "label": "LeafMesh env token",
+      "signup_url": "https://leafcraft.ai",
+      "required": true,
+      "note": "Per-environment telemetry token (dev / staging / prod). Issued alongside the license key."
+    },
+    {
+      "key": "OPENAI_API_KEY",
+      "label": "OpenAI API key",
+      "signup_url": "https://platform.openai.com/api-keys",
+      "required": true,
+      "note": "Primary LLM provider. Used by all LLM agents (gpt-4o-mini)."
+    },
+    {
+      "key": "ANTHROPIC_API_KEY",
+      "label": "Anthropic API key",
+      "signup_url": "https://console.anthropic.com/settings/keys",
+      "required": false,
+      "note": "Optional. Used by the BuiltIn Summarizer (claude-haiku) if you want narration."
+    },
+    {
+      "key": "REDIS_HOST",
+      "label": "Redis host",
+      "signup_url": "",
+      "required": false,
+      "note": "Optional. Defaults to 'localhost'. Run via 'docker compose up redis -d'."
+    },
+    {
+      "key": "REDIS_PORT",
+      "label": "Redis port",
+      "signup_url": "",
+      "required": false,
+      "note": "Optional. Defaults to 6379."
+    },
+    {
+      "key": "REDIS_PASSWORD",
+      "label": "Redis password",
+      "signup_url": "",
+      "required": false,
+      "note": "Optional. Empty for local Redis without auth."
+    },
+    {
+      "key": "OPPORTUNITY_FEED_WEBHOOK_URL",
+      "label": "Opportunity feed webhook (GovWin / SAM.gov via n8n)",
+      "signup_url": "",
+      "required": false,
+      "note": "Optional. n8n workflow URL that queries your GovWin / SAM.gov / FedConnect saved searches and returns only new notices. The daily scout cron stays commented out in config.yaml until this is wired."
+    },
+    {
+      "key": "CRM_SIGNAL_WEBHOOK_URL",
+      "label": "CRM competitor-signal webhook (n8n)",
+      "signup_url": "",
+      "required": false,
+      "note": "Optional. n8n workflow URL against your CRM / intel store (Salesforce, HubSpot, Klue, Crayon, Notion) — ingest mode creates a signal record, query mode returns signals + top competitors."
+    }
+  ]
+}