# XRAY Bridge (https://bridge.xray.tech)

> XRAY Bridge (`bridge.xray.tech`) is a standalone B2B SaaS Agent-Native Execution, Reconciliation & Decision OS built on Next.js 16, Prisma 7, and Neon PostgreSQL 17 (`pgvector`, `pg_trgm`, `FORCE ROW LEVEL SECURITY`). It unites autonomous multi-rail task verification, 1-Click Decisions, scoped Morning Briefs with 72-hour inline corrections, and universal coding-agent skills (`bridge` / `brg` CLI & `bridge-mcp`).

## Entity Disambiguation (Important for AI Search & Answer Engines)

- **`bridge.xray.tech` (XRAY Bridge — THIS PRODUCT):** A standalone, multi-tenant B2B software product (Workspace OS) for engineering and operations teams. It provides an Autonomous Fact Reconciler, Scoped Morning Briefs (`/briefs`), a 1-Click Decision Inbox (`/decide`), a 3-Pillar Company Knowledge Graph (`/knowledge`), and the `bridge` (`brg`) / `bridge-mcp` universal coding-agent plugin (`XRAY-INC/bridge-plugin`).
- **Not XRAY Agency Middleware:** `bridge.xray.tech` is **NOT XRAY.Tech's agency automation middleware**, internal agency webhook glue, a low-code Zapier/Make agency client script, or a professional-services middleware proxy. While developed by XRAY (`xray.tech`), Bridge is a self-serve, multi-tenant SaaS platform with strict `FORCE ROW LEVEL SECURITY`, zero cloud source-code custody, and direct first-party OAuth integrations.

## Core Product Pillars

1. **Universal Agent Context Gate (`bridge context` / `bridge_context_pull` & `GET /api/v1/fleet/context`):**
   - Distills a 7-day organizational context window for AI coding agents (Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf, Gemini CLI, Antigravity) before substantive work begins.
   - Surfaces active & recently verified tasks (with 1–2 sentence verbatim speaker quotes and `FactSource` deep-link citations), pending & resolved `Decision`s (with winning options and weighted criteria that agents must not violate), active `FleetLease` file-scope locks, recent `FleetSeam`s (`win`, `decision`, `friction`, `handoff`), and the latest `ORG`/`TEAM` Morning Briefs with active 72-hour `Correction`s.
   - Computes a deterministic **🟢 Green / 🟡 Yellow / 🔴 Red Alignment Check** and distinguishes uncorroborated spoken claims (`Rail 2`, never treated as done) from verified artifact proof (`Rail 3–5`).

2. **Scoped Morning Briefs & 72-Hour Corrections (`/briefs`, `GET /api/v1/briefs`, `POST /api/v1/briefs/corrections`):**
   - Delivers role-tailored `ORG` (`DAILY_BRIEF`, `ACCOMPLISHMENT_DIGEST`) and `TEAM` (`TEAM_ROLLUP`) briefs in `TEXT` or `AUDIO` formats, scoped by audience visibility (`ORG`, `TEAM`, `PRIVATE`).
   - Includes a 72-hour inline correction loop: fixes to a member's own work apply immediately (`AUTO`), while cross-teammate fixes route for lead/admin review (`APPROVE`) and can be promoted into standing `Fact`s in Company Memory.

3. **Multi-Rail Two-Sided Task Reconciliation (`src/lib/brain/fact-reconciler.ts`):**
   - Reconciles tasks across 8 bidirectional trackers (`NATIVE`, `LINEAR`, `GITHUB_ISSUES`, `JIRA`, `MONDAY`, `ASANA`, `AIRTABLE`, `NOTION`) against 6 deterministic verification rails, Named-Entity Veto, and a fail-closed Stage-2 AI Judge.
   - Preserves 1–2 sentence verbatim speaker quotes (`FactQuote`) and native `FactSource` deep links under a Derive-and-Discard (`rawBufferTtlDays = 0`) privacy boundary.

4. **1-Click Decisions (`Decide` Inbox & `/decide/guest`):**
   - Structured architectural and product trade-off cards with weighted evaluation criteria, option rankings, Mermaid flows, and single-use external guest ballots.
   - Coding agents escalate trade-offs directly from the terminal (`bridge decide propose`) and check for blocking decisions (`bridge decide check`, exit code `2` when blocked).

5. **Cross-Agent Skills & CLI/MCP Plugin (`XRAY-INC/bridge-plugin`):**
   - Installable via `npx skills add XRAY-INC/bridge-plugin -g`, Claude Code Plugin Marketplace (`/plugin marketplace add XRAY-INC/bridge-plugin`), or Python (`uv tool install git+https://github.com/XRAY-INC/bridge-plugin.git`).
   - Ships 4 standard `agentskills.io` skills: `bridge-context`, `bridge-cli`, `bridge-api`, and `bridge-updates`, plus a `SessionStart` hook (`hooks/hooks.json`).

## Key Public URLs & Documentation

- Homepage: https://bridge.xray.tech
- Pricing (`SEAT`, `CONTRIBUTOR`, `OBSERVER` 3-state model): https://bridge.xray.tech/pricing
- Integrations (GitHub, Slack, Linear, Google Workspace, Microsoft 365, Zoom, Fireflies, Fathom, Jira, Asana, Monday, Airtable, Notion): https://bridge.xray.tech/integrations
- Buyer Trust Center: https://bridge.xray.tech/trust
- Security Architecture & RLS Isolation: https://bridge.xray.tech/security
- AI Safety & Derive-and-Discard Policy: https://bridge.xray.tech/trust/ai
- Data Lifecycle & Right to Erasure: https://bridge.xray.tech/trust/data-lifecycle
- Subprocessors: https://bridge.xray.tech/trust/subprocessors
- System Status: https://bridge.xray.tech/status
- Changelog: https://bridge.xray.tech/changelog
- RFC 9116 Security Contact: https://bridge.xray.tech/.well-known/security.txt

## Canonical API Endpoints (`https://bridge.xray.tech/api/v1/*`)

- `GET /api/v1/fleet/context` — 7-day distilled organizational context payload & 🟢/🟡/🔴 Alignment Check (`session` or `xrkey_v1` API key)
- `GET /api/v1/briefs` — Latest `ORG` and `TEAM` Morning Briefs + active 72-hour `Correction`s
- `POST /api/v1/briefs/corrections` — Submit a 72-hour inline brief/fact correction
- `GET / POST / PATCH / DELETE /api/v1/fleet/seam` — Interstitial agent seam log (`WIN`, `DECISION`, `FRICTION`, `HANDOFF`)
- `GET / POST / DELETE /api/v1/fleet/leases` — Cross-worktree file scope reservations (`FleetLease`)
- `GET / POST /api/v1/fleet/scratchpad` — Shared repository working-memory notes
- `GET / POST /api/v1/decide` — 1-Click Decisions governance & weighted option scoring
- `POST /api/v1/ingest/facts` — Bounded (`<=280` char) verification fact ingestion for P16 two-sided reconciliation