Map partner authorization and provider expansion

[brendadeeznuts1111]

What changed

• add a canonical Telegram → partner authorization → Kalshi lifecycle map
• add bun run partner:map with Mermaid stdout and --output support
• document identifier boundaries and acceptance gates for future Polymarket execution
• link the map from README, partner-domain, and authorized-execution docs
• add Telegram and Polymarket references to the code-owned official URL catalog
• correct the stale feature-branch reference in the execution delivery record

Boundary

Kalshi remains the only authorized execution provider. Polymarket is documented as read-only market/compliance intelligence, and Fantasy402 remains unwired. Dashed map edges are future contracts, not runtime authority.

Validation

• bun run bun:ci — 1,406 tests, 0 failures
• pre-commit guard/typecheck/glossary/partner validation passed
• official URL health — 44/44 reachable
• Markdown local references — 33 files clean
• focused Telegram, Polymarket, URL, and domain tests — 63 passed

Summary by CodeRabbit

• New Features

  • Added partner execution expansion maps with Mermaid output via the CLI.
  • Added visual snapshot provenance, including runtime, dimensions, artifact integrity, and capture status.
  • Added support for typed WebView and WebSocket capture events with URL redaction.
  • Expanded glossary concepts covering authorization, execution safeguards, provider lifecycle, receipts, and intelligence boundaries.

• Documentation

  • Updated partner execution, authorized execution, Bun, glossary, official URL, and domain documentation.
  • Added Telegram and Polymarket API references.

• Bug Fixes

  • Improved capture error reporting and preserved HTML artifacts when image or WebView capture fails.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7e8a5c76-77d8-4289-8845-1712ac4322d1

📥 Commits

Reviewing files that changed from the base of the PR and between 11223e8 and b157fe7.

⛔ Files ignored due to path filters (1)

• bun.lock is excluded by !**/*.lock

📒 Files selected for processing (32)

• README.md
• docs/AUTHORIZED_EXECUTION.md
• docs/AUTHORIZED_EXECUTION_REMAINING_WORK.md
• docs/BUN_NATIVE.md
• docs/GLOSSARY.md
• docs/OFFICIAL_URLS.md
• docs/PARTNER-DOMAIN.md
• docs/PARTNER-EXECUTION-EXPANSION.md
• package.json
• scripts/audit-bun-native.ts
• scripts/export-toml.ts
• scripts/partners-validate.ts
• scripts/surface-audit.ts
• src/bot/kalshi-ws.ts
• src/institutions/event-store/match-liquidity-ground.ts
• src/institutions/event-store/tennis-ws-ground.ts
• src/institutions/event-store/visual-snapshot-meta.ts
• src/institutions/glossary.ts
• src/institutions/official-urls.ts
• src/partner/domain.ts
• src/partner/fantasy-ultra/pandora-socket.ts
• src/partner/webview-cdp-events.ts
• src/partner/webview-ws-capture.ts
• tests/audit-bun-native.test.ts
• tests/institutions/match-liquidity-ground.test.ts
• tests/institutions/tennis-ws-ground.test.ts
• tests/institutions/visual-snapshot-meta.test.ts
• tests/partner/domain.test.ts
• tests/partner/webview-ws-capture.test.ts
• tools/partner-domain.ts
• tools/partner-webview-ws-capture.ts
• tsconfig.json

---

📝 Walkthrough

Walkthrough

The change adds a partner execution expansion map, related documentation and glossary concepts, Bun-native type governance, typed WebView capture events, URL redaction, visual snapshot provenance, artifact integrity, and expanded validation coverage.

Changes

Partner execution mapping and contracts

Layer / File(s)	Summary
Partner execution map and documentation README.md, docs/*, package.json, scripts/partners-validate.ts, scripts/surface-audit.ts, src/institutions/glossary.ts, src/partner/domain.ts, tests/partner/domain.test.ts, tools/partner-domain.ts	The partner execution map documents authorization, provider boundaries, identifiers, execution gates, glossary concepts, visual provenance, and related references. The partner:map command generates Mermaid output.

Visual snapshot provenance

Layer / File(s)	Summary
Snapshot metadata and event contracts src/institutions/event-store/visual-snapshot-meta.ts, src/partner/webview-cdp-events.ts	New types and helpers describe runtime, WebView, image, artifact-integrity, and sanitized CDP event data.
Capture and persistence flows src/institutions/event-store/*, src/partner/webview-ws-capture.ts, tools/partner-webview-ws-capture.ts, src/partner/fantasy-ultra/pandora-socket.ts	Capture flows redact URLs, parse typed events, retain independent errors, compute metadata, and persist snapshot provenance.
Visual capture validation tests/institutions/*, tests/partner/webview-ws-capture.test.ts	Tests cover metadata construction, HTML-only artifacts, URL redaction, CDP parsing, and persisted schema data.

Bun-native tooling and WebSocket typing

Layer / File(s)	Summary
Bun type governance and audits package.json, scripts/audit-bun-native.ts, src/bot/kalshi-ws.ts, tests/audit-bun-native.test.ts, tsconfig.json	WebSocket option types derive from Bun declarations. The audit detects shadowing declarations. TypeScript coverage includes all script files.
Governed TOML export scripts/export-toml.ts	TOML export now uses tomlStringify and writes normalized output.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant CaptureTool
  participant CDPParsers
  participant ArtifactFiles
  participant SnapshotMetadata
  participant PersistedSummary
  CaptureTool->>CDPParsers: Parse WebSocket events
  CaptureTool->>ArtifactFiles: Write capture artifacts
  CaptureTool->>ArtifactFiles: Read integrity and image metadata
  ArtifactFiles->>SnapshotMetadata: Provide paths, sizes, hashes, and image details
  SnapshotMetadata->>PersistedSummary: Store sanitized URLs and snapshot metadata

Loading

Possibly related PRs

• brendadeeznuts1111/Kalshi-bot#1: Both changes expand and validate partner-ops glossary concepts.
• brendadeeznuts1111/Kalshi-bot#22: This change documents and maps the permissioned partner execution pipeline introduced there.
• brendadeeznuts1111/Kalshi-bot#23: Both changes update the partner domain and authorized-execution documentation.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/execution-doc-reference-audit

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.