{
  "service": "MachineSignal",
  "contract_name": "score_decision_contract",
  "version": "2026-07-15.public-live-surface.v4",
  "status": "controlled_b2b_italy_two_product_chain",
  "primary_customer_interface": "machine",
  "purpose": "Tell a customer machine how to interpret lead opportunity decisions for MS-DEC-250.",
  "product_code": "MS-DEC-250",
  "read_first": [
    "https://machinesignal.it/llms.txt",
    "https://machinesignal.it/product-catalog.json",
    "https://machinesignal.it/ms-dec-250-example.json",
    "https://machinesignal.it/machine-onboarding.json",
    "https://machinesignal.it/openapi.json"
  ],
  "score_endpoint": {
    "method": "POST",
    "path": "/v1/lead-opportunity-score",
    "required_headers": [
      "X-API-Key",
      "Idempotency-Key",
      "Content-Type: application/json"
    ],
    "access": "private_key_after_approval",
    "returns": [
      "opportunity_score",
      "confidence",
      "priority",
      "decision",
      "reason",
      "suggested_route",
      "usage"
    ]
  },
  "decision_routes": {
    "discard": {
      "meaning": "The record is not a useful opportunity for the current customer context.",
      "machine_action": "Do not prioritize the record. Keep an audit trace if required by the customer system."
    },
    "watchlist": {
      "meaning": "The record is not urgent but may be worth revisiting.",
      "machine_action": "Store the record for later customer review without external contact."
    },
    "review": {
      "meaning": "The record has enough signal for manual customer review.",
      "machine_action": "Create an internal review task or CRM note for the customer."
    },
    "prioritize": {
      "meaning": "The record has strong signal for the customer's internal workflow.",
      "machine_action": "Prioritize the record inside the customer system while keeping external outreach disabled unless the customer separately approves it.",
      "planned_continuation": "The same buyer may group exactly 25 qualified records for MS-ACT-25 after paid and completed MS-DEC-250 and after receiving a signed continuation entitlement."
    }
  },
  "credit_rules": {
    "valid_output": "One MS-DEC-250 credit is consumed only when a usable lead decision output is returned.",
    "invalid_input": "Do not consume a credit for invalid input, unsupported geography or blocked customer scope.",
    "duplicate_request": "Use Idempotency-Key so retries do not consume a second credit."
  },
  "blocked_actions": [
    "execute payment",
    "issue invoice",
    "create public checkout",
    "execute Wise payout",
    "contact external targets",
    "process B2C customers",
    "process non-Italian B2B customers"
  ],
  "billing_scope": {
    "customer_type": "B2B Italy only",
    "price_eur": 49,
    "regime_fiscale": "RF19",
    "iva_code": "N2.2"
  },
  "contact": "info@machinesignal.it",
  "conditional_continuation_product": {
    "code": "MS-ACT-25",
    "name": "Opportunity Action Pack 25",
    "status": "live_post_purchase_only",
    "purchasable": true,
    "order_intent_allowed": true,
    "anonymous_purchase_allowed": false,
    "public_checkout_url_exposed": false,
    "product_price_eur": 399,
    "stamp_duty_eur": 2,
    "total_due_eur": 401,
    "currency": "EUR",
    "included_valid_outputs": 25,
    "included_company_records": 25,
    "delivery_unit": "one complete 25-target campaign package with one detailed machine-readable action pack per selected company record",
    "output_format": "application/json",
    "product_promise": "A complete execution-ready campaign package for exactly 25 qualified targets, prepared for a buyer-controlled CRM or workflow.",
    "buyer_result_summary": "Receive Deep Analysis across 25 selected targets, explicit mini-checks, cluster strategy, message drafts, CRM/workflow payloads, a day 0/7/21/60 sequence, automatic rules, reputation/spam risk assessment and an audit trail.",
    "package_scope": {
      "target_count": 25,
      "deep_analysis_included": true,
      "target_or_cluster_diagnosis_required": true,
      "observable_evidence_required": true,
      "explicit_mini_check_required": true,
      "cluster_strategy_required": true,
      "initial_follow_up_nurturing_messages_required": true,
      "crm_workflow_payload_required": true,
      "campaign_sequence_days": [0, 7, 21, 60],
      "automatic_contact_stop_nurture_rules_required": true,
      "reputation_spam_risk_assessment_required": true,
      "audit_trail_required": true
    },
    "continuation_from": "MS-DEC-250",
    "eligibility_rule": "The same approved B2B Italy buyer must have paid for and completed MS-DEC-250 and must present a seller-signed entitlement bound to the buyer, source order, source delivery and exactly 25 unique qualified output references.",
    "qualified_record_rule": "Each source record must have decision buy_deep_analysis, opportunity_score >= 75 and confidence >= 0.65; duplicates, invalid and incomplete records do not count.",
    "deliverables": [
      "Deep Analysis included across all 25 selected targets",
      "concrete diagnosis per target or cluster with observable evidence and uncertainties",
      "explicit ready-to-use mini-check per target or cluster",
      "target clustering and an operating strategy for each cluster",
      "recommended offer, buyer hypothesis and reason to act now",
      "initial message, follow-up and nurturing variant as approval-gated drafts",
      "CRM/workflow payload with tags, priority, pipeline status, next action, follow-up date and reason code",
      "day 0, day 7, day 21 and day 60 operating sequence",
      "automatic contact, stop and nurturing rules",
      "reputation and spam risk assessment, approval gate and auditable decision trail"
    ],
    "output_validity_rule": "Every cited mini-check must list its explicit points. Each point must state the problem, observed evidence, recommended intervention and connected CRM/workflow action. A vague count such as '3 interventions' is invalid.",
    "external_action_policy": "MachineSignal delivers an execution-ready package but does not send messages, contact targets, invoke customer webhooks or write to a CRM automatically. External execution remains buyer-controlled and approval-gated.",
    "fulfillment_release_policy": "Fail closed: do not create or release a buyer-specific checkout and do not accept paid fulfillment unless the complete 25-target output contract can be generated and delivery readiness has been verified.",
    "payment_path": "A buyer-specific one-use controlled checkout may be created only after entitlement verification. No reusable or anonymous public Payment Link is exposed.",
    "machine_instruction": "Submit MS-ACT-25 only after receiving a valid continuation entitlement for the same buyer and 25-record set; otherwise stop."
  }
}
