demo:
  id: fintech-deal-intelligence
  title: Fintech Deal Intelligence Demo
  domain: fintech
  purpose: >
    Demonstrates how SMA can govern a high-density deal, investment, or company
    intelligence interface by resolving which signals matter for different
    stakeholder roles before the interface, schema, or agent response is rendered.

semantic_contract:
  name: deal_intelligence_contract
  principle: One meaning source projects into human UI, structured data, and agent response.
  sma_pattern: signal_meaning_action

deployment_note: &deployment_note >
  SMA sits above the delivery mechanism. MCP, A2A, static UI, custom APIs, or
  internal scripts can carry the projection, but the meaning contract is defined first.

deployment:
  type: semantic_interface
  modes:
    default: avatar_driven
    supported:
      - avatar_driven
      - headless
  entry_signal:
    avatar_driven: authenticated_role_session_or_declared_stakeholder_context
    headless: selected_criteria_query_behavior_or_dataset_weighting
  identity_model:
    avatar_driven: declared_identity
    headless: data_driven_no_avatar
  note: *deployment_note

source_signals:
  provider: structured_financial_dataset
  default_fields:
    - company_name
    - sector
    - geography
    - revenue
    - growth_rate
    - margin_profile
    - risk_flags
    - funding_stage
    - valuation
    - recent_activity

sma_enrichment:
  fields:
    growth_signal:
      label: Growth
      group: upside
      type: score
      range: 0_to_1
      meaning: Expansion, revenue velocity, market traction, and upside.
    risk_exposure:
      label: Risk
      group: constraint
      type: score
      range: 0_to_1
      meaning: Regulatory, operational, financial, or market downside.
    strategic_fit:
      label: Strategic Fit
      group: alignment
      type: score
      range: 0_to_1
      meaning: Alignment with investment thesis, portfolio, or acquisition goals.
    liquidity_signal:
      label: Liquidity
      group: transaction_readiness
      type: score
      range: 0_to_1
      meaning: Capital access, exit feasibility, and transaction readiness.
    operational_quality:
      label: Operations
      group: execution
      type: score
      range: 0_to_1
      meaning: Execution quality, process maturity, and team reliability.
    market_position:
      label: Market Position
      group: defensibility
      type: score
      range: 0_to_1
      meaning: Category strength, competitive edge, and defensibility.

avatars:
  investor:
    meaning: Needs upside, risk-adjusted return, market position, and liquidity path.
    ux_mode: explore
    scoring:
      growth_signal: 0.30
      market_position: 0.20
      risk_exposure: 0.20
      liquidity_signal: 0.15
      strategic_fit: 0.10
      operational_quality: 0.05
    directions:
      growth_signal: higher_better
      market_position: higher_better
      risk_exposure: lower_better
      liquidity_signal: higher_better
      strategic_fit: higher_better
      operational_quality: higher_better
    ipc:
      rule: Risk is a demotion signal unless outweighed by growth and market strength.
      forbidden_behaviors:
        - hide risk flags behind aggregate score
        - present upside without risk-adjusted rationale
        - reorder top deals without exposing changed criteria

  operator:
    meaning: Needs operational quality, risk clarity, and execution readiness.
    ux_mode: balanced
    scoring:
      operational_quality: 0.30
      risk_exposure: 0.25
      strategic_fit: 0.20
      growth_signal: 0.10
      liquidity_signal: 0.10
      market_position: 0.05
    directions:
      operational_quality: higher_better
      risk_exposure: lower_better
      strategic_fit: higher_better
      growth_signal: higher_better
      liquidity_signal: higher_better
      market_position: higher_better
    ipc:
      rule: Operational concerns are foregrounded over pure upside.
      forbidden_behaviors:
        - bury execution risk below valuation detail
        - treat operational maturity as a secondary note
        - use growth as the only visual emphasis

  compliance_reviewer:
    meaning: Needs risk exposure, regulatory flags, and decision traceability.
    ux_mode: focus
    scoring:
      risk_exposure: 0.45
      operational_quality: 0.20
      liquidity_signal: 0.10
      strategic_fit: 0.10
      market_position: 0.10
      growth_signal: 0.05
    directions:
      risk_exposure: lower_better
      operational_quality: higher_better
      liquidity_signal: higher_better
      strategic_fit: higher_better
      market_position: higher_better
      growth_signal: higher_better
    ipc:
      rule: Risk flags are elevated and cannot be visually suppressed by growth signals.
      forbidden_behaviors:
        - suppress compliance warnings in compact views
        - allow positive growth styling to overpower red-flag states
        - omit rationale for risk demotion

headless_scoring:
  description: >
    The interface can resolve deal relevance through weighted criteria without
    requiring a declared stakeholder avatar.
  controls:
    - growth_signal
    - risk_exposure
    - strategic_fit
    - liquidity_signal
    - operational_quality
    - market_position
  output: weighted_deal_ranking_with_visible_rationale

projections:
  human_ui:
    - deal cards
    - weighted score panels
    - risk emphasis states
    - stakeholder toggles
    - semantic ranking controls
  structured_data:
    type: deal_semantics
    format:
      - JSON
      - JSON-LD
      - YAML contract
  agent_response:
    behavior: ranked_deal_explanation_with_governed_rationale

proof_points:
  - Same deal data resolves differently for investor, operator, and compliance reviewer.
  - Risk can change visual priority and ranking behavior through IPC.
  - SMA creates traceable semantic rationale before UI display.
  - Headless scoring supports non-persona-based prioritization.
