naftiko: "1.0.0-alpha1"

info:
  label: "Memesio Trends and Growth"
  description: >
    Trend alert, growth, lifecycle, and analytics workflow: subscribe to
    trend alerts, configure delivery channels, manage trigger rules,
    inspect ranking quality, run growth experiments, schedule lifecycle
    messaging, drive viral triggers and referrals, publish to social, and
    review the metric dictionary and dashboards.
  tags:
    - Memesio
    - Trends
    - Growth
    - Lifecycle
    - Analytics
  created: "2026-05-16"
  modified: "2026-05-16"

binds:
  - namespace: env
    keys:
      MEMESIO_API_KEY: MEMESIO_API_KEY

capability:
  consumes:
    - import: memesio
      location: ./shared/memesio.yaml

  exposes:
    - type: rest
      port: 8809
      namespace: trends-growth-api
      description: "REST surface for Memesio trend alerts, growth, and analytics."
      resources:
        - path: /v1/trend-alerts
          name: trend-alerts
          description: "Trend alert pipeline."
          operations:
            - method: GET
              name: list-alerts
              description: "List trend alerts."
              call: "memesio.get-alerts"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-connectors
              description: "List delivery connectors."
              call: "memesio.get-alerts-connectors"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-delivery
              description: "Inspect alert delivery state."
              call: "memesio.get-alerts-delivery"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: post-delivery
              description: "Acknowledge or replay alert delivery."
              call: "memesio.post-alerts-delivery"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-feedback
              description: "Read alert feedback."
              call: "memesio.get-alerts-feedback"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: submit-feedback
              description: "Submit feedback on a trend alert."
              call: "memesio.post-alerts-feedback"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-quality-report
              description: "Quality report for alert ranking and recall."
              call: "memesio.get-alerts-quality-report"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-ranking
              description: "Trend ranking signals."
              call: "memesio.get-alerts-ranking"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-preferences
              description: "Read alert preferences."
              call: "memesio.get-alerts-preferences"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: update-preferences
              description: "Update alert preferences."
              call: "memesio.post-alerts-preferences"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-triggers
              description: "List alert trigger rules."
              call: "memesio.get-alerts-triggers"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-trigger
              description: "Create an alert trigger rule."
              call: "memesio.post-alerts-triggers"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/growth
          name: growth
          description: "Growth ops."
          operations:
            - method: GET
              name: get-experiment-decisions
              description: "Read growth experiment decisions."
              call: "memesio.get-growth-experiments-decision"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: post-experiment-decision
              description: "Submit a growth experiment decision."
              call: "memesio.post-growth-experiments-decision"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-lifecycle-messaging
              description: "Read lifecycle messaging plan."
              call: "memesio.get-growth-lifecycle-messaging"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: schedule-lifecycle-message
              description: "Schedule a lifecycle message."
              call: "memesio.post-growth-lifecycle-messaging"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-referrals
              description: "List referral codes / state."
              call: "memesio.get-growth-referrals"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-referral
              description: "Create a referral campaign or code."
              call: "memesio.post-growth-referrals"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-social-publish
              description: "List social publish targets."
              call: "memesio.get-growth-social-publish"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: publish-social
              description: "Publish meme content to a connected social channel."
              call: "memesio.post-growth-social-publish"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-trend-campaigns
              description: "List trend campaigns."
              call: "memesio.get-growth-trend-campaigns"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-trend-campaign
              description: "Create a trend campaign."
              call: "memesio.post-growth-trend-campaigns"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-viral-triggers
              description: "List viral triggers."
              call: "memesio.get-growth-viral-triggers"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/analytics
          name: analytics
          description: "Analytics dashboards and metrics."
          operations:
            - method: GET
              name: get-metric-dictionary
              description: "Read the analytics metric dictionary."
              call: "memesio.get-analytics-metric-dictionary"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-activation-retention
              description: "Activation and retention dashboard."
              call: "memesio.get-analytics-dashboards-activation-retention"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-feature-adoption
              description: "Feature adoption dashboard."
              call: "memesio.get-analytics-dashboards-feature-adoption"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-backend-reliability
              description: "Backend reliability dashboard."
              call: "memesio.get-analytics-dashboards-backend-reliability"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: get-ai-anomalies
              description: "AI cost / output anomalies."
              call: "memesio.get-analytics-anomalies-ai"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: GET
              name: list-experiment-templates
              description: "List experiment templates."
              call: "memesio.get-analytics-experiments-templates"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 8810
      namespace: trends-growth-mcp
      transport: http
      description: "MCP tools for trend alerts and growth pipelines."
      tools:
        - name: list-trend-alerts
          description: "List active trend alerts."
          call: "memesio.get-alerts"
          outputParameters:
            - type: object
              mapping: "$."
        - name: submit-alert-feedback
          description: "Submit feedback on a trend alert."
          call: "memesio.post-alerts-feedback"
          outputParameters:
            - type: object
              mapping: "$."
        - name: publish-to-social
          description: "Publish a meme to a connected social channel."
          call: "memesio.post-growth-social-publish"
          outputParameters:
            - type: object
              mapping: "$."
        - name: read-metric-dictionary
          description: "Inspect the analytics metric dictionary."
          call: "memesio.get-analytics-metric-dictionary"
          outputParameters:
            - type: object
              mapping: "$."