┌───────────────────────────┐      ┌──────────────────────────────────┐
│   Alexa+ / Echo Show /    │      │   Bee Wearable AI (CLI / MCP)    │
│   Fire TV War Room HUD    │      │  Live Standup & Hallway Memory   │
└─────────────┬─────────────┘      └─────────────────┬────────────────┘
              │ Voice + APL Multimodal               │ Live Transcript Stream
              ▼                                      ▼
┌─────────────────────────────────────────────────────────────────────┐
│        RepoPulse MCP Server (Spec 2025-11-25 • Streamable HTTP)     │
│  • POST /mcp (JSON-RPC + SSE Stream)  • Stdio Local Transport       │
├───────────────────┬────────────────────────┬────────────────────────┤
│ 1. Pre-Flight     │ 2. AST Blast-Radius    │ 3. Autonomous Sandbox  │
│ Bedrock Guardrail │ & Bee Memory Correlator│ Patch Verifier         │
│ (Secret Redaction)│ (Symbol Call Graph)    │ (Isolated Test Runner) │
└─────────┬─────────┴───────────┬────────────┴───────────┬────────────┘
          ▼                     ▼                        ▼
┌─────────────────────────────────────────────────────────────────────┐
│   Amazon Bedrock Runtime (Amazon Nova Pro + Claude 3.7 Sonnet)      │
│   + 540-Model Fallback Router & GitHub Checks / PR Review Bot       │
└─────────────────────────────────────────────────────────────────────┘

💰 AWS FinOps Cost Impact Alert
- Added: 1x RDS Aurora PostgreSQL (db.r6g.xlarge, Multi-AZ) -> +$140.00 / month
- Added: 1x NAT Gateway (us-east-1) -> +$32.85 / month + data transfer
- Projected Monthly Spend Delta: +$172.85 / mo (+$2,074.20 / yr)
💡 Bedrock FinOps Recommendation: Consider using AWS Gateway VPC Endpoints for S3 and DynamoDB to eliminate NAT data processing charges.

flowchart TD
    subgraph DeveloperClients["Developer Presentation & Tools"]
        ELECTRON["Native Electron Desktop (Apple Liquid Glass)"]
        STUDIO["Local Web Studio (Port 3000)"]
        QCLI["Amazon Q Developer CLI / IDE"]
        GH["GitHub / GitLab Pull Request"]
    end

    subgraph AWSCloud["AWS Serverless Infrastructure (CDK v2)"]
        APIGW["Amazon API Gateway (Webhook Receiver)"]
        LAMBDA["AWS Lambda (RepoPulse Review Worker)"]
        DDB["Amazon DynamoDB (PR Cache & Telemetry)"]
        EBR["Amazon EventBridge (Scheduled Audits)"]
    end

    subgraph AWSBedrock["Amazon Bedrock AI Engine"]
        GUARD["Amazon Bedrock Guardrails (Secrets & PII Filter)"]
        NOVA["Amazon Nova Pro & Nova Lite"]
        CLAUDE["Anthropic Claude 3.7 on Bedrock"]
        KB["Bedrock Knowledge Bases (Titan Embeddings)"]
    end

    subgraph SpecializedEngines["RepoPulse Intelligence Engines"]
        IAC["AWS CDK / Terraform IaC AST Scanner"]
        FINOPS["AWS FinOps Cost-Delta Estimator"]
        AST["Deterministic Code AST Parser"]
    end

    GH -->|Webhook Event| APIGW
    APIGW --> LAMBDA
    EBR --> LAMBDA
    LAMBDA --> DDB

    ELECTRON & STUDIO & QCLI --> AST & IAC & FINOPS
    LAMBDA --> AST & IAC & FINOPS

    AST & IAC & FINOPS --> GUARD
    GUARD --> NOVA & CLAUDE
    KB --> NOVA
    NOVA & CLAUDE -->|Structured Review & Cost Delta| GH & ELECTRON & STUDIO

# 1. Clone repository
git clone https://github.com/miriyaladhanwinn/repo-pulse-ai.git
cd repo-pulse-ai

# 2. Build distribution
npm install
npm run build

# 3. Synthesize CloudFormation template
node -e "const { RepoPulseCdkStack } = require('./dist/infra/repopulse-cdk-stack.js'); const s = new RepoPulseCdkStack(null, 'stack'); console.log(JSON.stringify(s.toCloudFormationTemplate(), null, 2));" > cdk.out.json

# 4. Deploy via AWS CloudFormation
aws cloudformation deploy \
  --template-file cdk.out.json \
  --stack-name RepoPulseAiStack \
  --capabilities CAPABILITY_IAM \
  --parameter-overrides GitHubWebhookSecret="my-secret-token" \
  --region us-east-1

# Review current unstaged changes with Amazon Bedrock Nova Pro
git diff | npx repo-pulse review

# Audit AWS CDK, CloudFormation or Terraform diff for security invariants
git diff HEAD~1 | npx repo-pulse aws-audit

# Calculate AWS FinOps monthly spend delta on a PR
git diff origin/main | npx repo-pulse cost-delta

# Check code for leaked AWS credentials and prompt injections
npx repo-pulse guardrail --text "AWS_KEY = AKIAIOSFODNN7EXAMPLE"

# Autonomous Issue Triage with urgency classification
npx repo-pulse triage \
  --title "Race condition in async cache invalidation" \
  --body "Cache entries leak memory when invalidate() is called concurrently."

# Verify Amazon Bedrock and AI Gateway health
npx repo-pulse health

npm run studio

npm run desktop

{
  "mcpServers": {
    "repo-pulse": {
      "command": "node",
      "args": ["/path/to/repo-pulse-ai/dist/cli/index.js", "serve-mcp"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_BEDROCK_MODEL": "amazon.nova-pro-v1:0"
      }
    }
  }
}

npx repo-pulse serve-mcp-http --port 8787

npm test

✔ AssistantMatrix Persona Registry (6 tests)
✔ AuthService Core Security & OTP Unit Tests (6 tests)
✔ StudioServer Authentication HTTP Endpoints E2E (3 tests)
✔ AwsIacAnalyzer Suite (4 tests)
✔ BedrockGuardrailsEngine Suite (3 tests)
✔ AmazonBedrockProvider & SigV4 Suite (4 tests)
✔ TokenBudgeter Module (2 tests)
✔ Native Desktop Architecture & Cherry Parity Verification (4 tests)
✔ DiffAnalyzer Module (3 tests)
✔ Edge-to-Edge Stress & Edge Cases (9 tests)
✔ AwsFinOpsEstimator Suite (3 tests)
✔ IssueClassifier Module (2 tests)
✔ KnowledgeVault Semantic Snippet Engine (7 tests)
✔ MCPServer Module (7 tests)
✔ Universal ModelCatalog (500+ Models Registry) (6 tests)
✔ MultiModelRouter Frontier Gateway (6 tests)
✔ OpenAICodexProvider Heuristic Review & Triage Engine (5 tests)
✔ StudioServer E2E Verification (10 tests)

✔ AmazonHackathonSuite (Alexa+ • Bee • AST Sandbox • Bedrock Guardrails) (5 tests)

ℹ tests 104
ℹ suites 20
ℹ pass 104
ℹ fail 0
ℹ duration_ms 560ms