# 1. Health check & AWS telemetry
curl -s https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/api/health | jq .

# 2. Query all 5 registered MCP tools over Streamable HTTP
curl -X POST https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"judge-list-test","method":"tools/list"}'

# 3. Execute deterministic serial-variant BOM diagnosis (Carrier AC 24ACC636 -> CARRIER-HC98JA045D Capacitor)
curl -X POST https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":"judge-carrier-diag",
    "method": "tools/call",
    "params": {
      "name": "diagnose_equipment_and_bom",
      "arguments": {
        "brand": "Carrier",
        "modelNumber": "24ACC636A003",
        "serialNumber": "2023W19482",
        "errorCode": "E4"
      }
    }
  }' | jq .result

# 4. Query UCP 2026-01-11 discovery profile
curl -s https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/.well-known/ucp | jq .

# 5. Query live Amazon DynamoDB (FirstFixMcpState) records in us-east-1
curl -s https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/api/aws/dynamo-records | jq .

# 6. Query live B2B contractor FSM webhook dispatches (ServiceTitan / Jobber)
curl -s https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/v1/fsm/dispatches | jq .

# 7. Query Household Equipment & Active Warranty Registry
curl -s https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws/api/household/registry | jq .

flowchart TD
    subgraph ClientLayer["Echo Show 15 & Alexa+ Clients"]
        ES15["Echo Show 15 Multimodal Display (1080p)"]
        Voice["Alexa+ Voice Host (Streaming Audio)"]
        Camera["Rating Plate Image Upload (JPEG/PNG)"]
    end

    subgraph AWSCloud["AWS us-east-1 Cloud Infrastructure"]
        LambdaUrl["AWS Lambda Function URL (Public HTTPS Auth: NONE)<br/>https://qe2khmjs7zmipvuuk2ailnsq340lfhrg.lambda-url.us-east-1.on.aws"]
        
        subgraph ServerlessCompute["AWS Lambda (nodejs20.x, 512MB, 30s)"]
            Handler["Express HTTP Bridge (src/aws/lambdaHandler.ts)"]
            MCPEngine["MCP 2025-11-25 Streamable HTTP Server (POST /mcp)"]
            UCPEngine["Universal Commerce Protocol (2026-01-11 Checkout)"]
            BookingEngine["Alexa+ Local Booking SPI (com.amazon.alexa.localbooking.v1)"]
            FSMWebhook["B2B Contractor FSM Webhooks (ServiceTitan / Jobber)"]
            OAuthEngine["OAuth 2.1 PKCE S256 Server (RFC 7636 / RFC 9728)"]
            RingController["Ring Smart Access Controller (Arrival Windows)"]
            DeterministicBOM["Deterministic OEM BOM Engine (30 Variants across 15 Brands)"]
            HouseholdRegistry["Household Equipment & Active Warranty Registry"]
        end

        subgraph ManagedServices["AWS Managed Cloud Services"]
            Bedrock["Amazon Bedrock Nova Pro<br/>us.amazon.nova-pro-v1:0 (Rating-Plate Vision)"]
            DynamoDB["Amazon DynamoDB<br/>FirstFixMcpState (PAY_PER_REQUEST)"]
        end
    end

    Camera -->|Upload Image| Handler
    Voice -->|Voice Intent| MCPEngine
    ES15 -->|Render UI Apps| Handler

    Handler --> MCPEngine
    Handler --> UCPEngine
    Handler --> BookingEngine
    Handler --> FSMWebhook
    Handler --> OAuthEngine
    Handler --> RingController
    Handler --> HouseholdRegistry

    MCPEngine --> DeterministicBOM
    Handler -->|Async Perception| Bedrock
    DeterministicBOM -->|State Sync & Audit| DynamoDB

# Run all 90 tests across Sprints 1–10
npm test

firstfix-mcp-alexa-plus/
├── .env.example                               # Production environment variable template
├── .gitignore                                 # Git ignore rules (ignoring node_modules, dist, data/)
├── .well-known/                               # RFC Discovery manifests
│   ├── oauth-authorization-server.json        # RFC 8414 OAuth 2.1 authorization server metadata
│   ├── oauth-protected-resource.json          # RFC 9728 OAuth 2.0 protected resource metadata
│   └── ucp.json                               # Universal Commerce Protocol 2026-01-11 profile
├── Dockerfile                                 # Multi-stage production container definition
├── LICENSE                                    # MIT License
├── README.md                                  # Complete project documentation
├── addon-package/                             # Alexa+ Add-On distribution package
│   ├── addon.json                             # Add-on manifest with 5 tools & 3 UI resources
│   └── assets/                                # Standard 6 light icons and hero carousel
├── deployment-receipt.json                    # Authentic AWS us-east-1 deployment receipt
├── docs/                                      # Hackathon bonus documentation
│   ├── FRICTION_LOGS_10_PERCENT_BONUS.md      # 10 comprehensive friction logs (+10% Bonus)
│   └── PRODUCT_FEEDBACK_5_PARTS.md            # 5-part feedback for Amazon engineering teams
├── open-source-contribution/                  # Upstream community contribution bundle
│   └── devices-agent-skills/
│       ├── PULL_REQUEST_TEMPLATE.md           # PR template for AmazonAppDev/devices-agent-skills #14
│       └── skills/
│           └── alexa-plus-mcp-ucp-local-booking/
│               └── SKILL.md                   # Complete Alexa+ Add-On AI developer guide
├── packages/                                  # Monorepo packages
│   └── alexa-plus-ucp-mcp-kit/                # Published npm package: alexa-plus-ucp-mcp-kit
│       ├── README.md                          # SDK documentation and usage patterns
│       ├── package.json                       # SDK package manifest
│       ├── tsconfig.json                      # SDK TypeScript configuration
│       └── src/
│           └── index.ts                       # 6 exported integration utilities
├── public/                                    # Echo Show 15 Multimodal Simulator Web UI
│   ├── app.js                                 # Dual-screen orchestration, postMessage, height clamp
│   ├── index.html                             # Responsive Echo Show 15 & Fleet Command Center
│   └── styles.css                             # Production CSS with zero-overflow table rules
├── skills/                                    # Antigravity & Agent Skills bundle
│   └── firstfix-dispatch-skill/
│       └── SKILL.md                           # Skill frontmatter and tool guidance
├── src/                                       # Core TypeScript application source
│   ├── ai/
│   │   ├── firstFixAgent.ts                   # Agent orchestration controller
│   │   ├── ratingPlateVision.ts               # Bedrock Nova Pro OCR & <0.90 confirmation gate
│   │   └── safetyGuardrails.ts                # <2ms pre-inference life-safety emergency shutoff
│   ├── aws/
│   │   ├── dynamoPersistence.ts               # Amazon DynamoDB FirstFixMcpState client
│   │   └── lambdaHandler.ts                   # APIGatewayProxyEventV2 Express bridge
│   ├── data/
│   │   └── seedData.ts                        # 15 OEM brands × 2 batches (30 BOM variants), vans
│   ├── engine/
│   │   └── firstFixEngine.ts                  # Deterministic serial BOM & stocked van matcher
│   ├── mcp/
│   │   └── uiTemplates.ts                     # 3 UI templates with #mcp-app-root height negotiation
│   ├── schemas/
│   │   └── discovery.ts                       # Zod validation schemas for discovery manifests
│   ├── scripts/
│   │   ├── deployAwsLive.ts                   # 1-command AWS us-east-1 serverless deployment script
│   │   ├── generateValidAssets.ts             # PNG IHDR asset generator
│   │   └── testLiveBedrock.ts                 # Direct Bedrock Nova Pro smoke test
│   ├── server/
│   │   ├── app.ts                             # Express server, routes, and middleware
│   │   ├── fsmWebhook.ts                      # B2B contractor FSM webhook dispatches
│   │   ├── localBookingSpi.ts                 # Alexa+ Local Booking SPI routes
│   │   ├── mcpServer.ts                       # MCP 2025-11-25 Streamable HTTP server
│   │   ├── oauthServer.ts                     # OAuth 2.1 PKCE authorization & token server
│   │   ├── ringAccess.ts                      # Ring smart arrival access controller
│   │   ├── start.ts                           # Local HTTP startup script
│   │   ├── state.ts                           # In-memory reactive state manager
│   │   └── ucpCheckout.ts                     # UCP 2026-01-11 checkout lifecycle
│   ├── storage/
│   │   └── storageAdapter.ts                  # Hybrid in-memory & DynamoDB storage adapter
│   └── types/
│       └── index.ts                           # Canonical TypeScript interfaces
├── template.yaml                              # AWS SAM / CloudFormation serverless template
├── tests/                                     # 10 Automated Test Suites (90/90 Passing Tests)
│   ├── sprint1.test.ts                        # Sprint 1: Schemas, BOM engine & safety shutoffs
│   ├── sprint2.test.ts                        # Sprint 2: MCP streamable HTTP & UCP checkout
│   ├── sprint3.test.ts                        # Sprint 3: Bedrock Nova Pro & injection defense
│   ├── sprint4.test.ts                        # Sprint 4: MCP Apps (ui://) & Echo Show 15 simulator
│   ├── sprint5.test.ts                        # Sprint 5: Standalone SDK & AWS deployment bridge
│   ├── sprint6.test.ts                        # Sprint 6: AWS Function URL & DynamoDB smoke tests
│   ├── sprint7.test.ts                        # Sprint 7: OAuth 2.1 PKCE, FSM webhooks, zero fallback
│   ├── sprint8.test.ts                        # Sprint 8: Layman stepper & dynamic multi-brand
│   ├── sprint9.test.ts                        # Sprint 9: Layout clipping fix & blueprint audit
│   └── sprint10.test.ts                       # Sprint 10: Height loop fix & household registry
├── tsconfig.json                              # TypeScript project configuration
└── package.json                               # Node.js project manifest & scripts

git clone https://github.com/hsalman-saeed/firstfix-mcp-alexa-plus.git
cd firstfix-mcp-alexa-plus
npm install --legacy-peer-deps

cp .env.example .env
# Edit .env with your AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION=us-east-1

npm test
# Runs all 90 tests across 10 test suites (100% pass)

npm start
# Server opens at http://localhost:3001

npm run deploy:aws
# Automatically bundles Lambda handler, provisions DynamoDB table, updates IAM roles,
# synchronizes .well-known/ manifests and addon.json, and tests public HTTPS in us-east-1!