ACoolNerd · ACoolNerd · Aug 17, 2026 · Aug 17, 2026 · Aug 17, 2026
diff --git a/docs/BreakVault/AGENT_MESH.md b/docs/BreakVault/AGENT_MESH.md
@@ -0,0 +1,29 @@
+# ACoolCOLLECTOR Agent Mesh
+
+## Human-governed roles
+Collector Lead, Break Host, Break Ops, Inventory/Custody, BETH Market, Content Producer, Community Moderator, Fulfillment, Finance/Reconciliation, ACoolNERD Tech, Ruth Review.
+
+## Agents
+| Agent | Responsibility | Human gate |
+|---|---|---|
+| ACoolOMNI | Orchestration and daily routing | External actions approved by Collector Lead |
+| ACoolCARD Intake | Normalize inventory, duplicate/version queue | Ambiguous identity to human |
+| BETH Market | Guide refresh + completed-sale evidence + confidence | Premium price cannot publish on weak evidence |
+| CONTENT-25 | Build 25 daily sale/content assets | Premium assets require Ruth Review |
+| ACoolBREAK Producer | Break manifest, participant schema, run of show | No undisclosed random/mystery mechanics |
+| LIVE Director | Cameras/audio/network checklist + clip markers | Host controls go-live/end |
+| BreakVault Custody | Hit assignment, digital twin, packing handoff | Premium image/serial verification |
+| HOWARD Community | Questions, moderation, follow-up | No payment/price override |
+| Fulfillment Agent | Pack list, label queue, tracking status | PII stays private |
+| Finance Recon | Fees/refunds/shipping closeout | Human approves accounting writeback |
+| SportsCardsPro Sync | Internal price-guide refresh | Token private; data use follows terms |
+| Ruth Review | Public QA and corrections | Final claim-quality gate |
+
+## RASCI principles
+- **A:** Collector Lead owns the weekly break slate, final public commercialization, and exceptions.
+- **R:** Specialist agent/role performs the defined workflow.
+- **S:** Tech/operations support automation and evidence collection.
+- **C:** BETH, Custody, Finance, or Ruth are consulted when their gate is implicated.
+- **I:** Other roles are informed via the operating ledger.
+
+Agents prepare and recommend. Premium price publication, custody transfers, accounting writebacks, refund/dispute exceptions, and public corrections remain human-gated.
diff --git a/docs/BreakVault/OPERATING_SYSTEM_2026-08-17.md b/docs/BreakVault/OPERATING_SYSTEM_2026-08-17.md
@@ -0,0 +1,57 @@
+# ACoolCOLLECTOR • BreakVault Operating System
+
+**Operating principle:** Cards today. Legacy tomorrow. Collect. Verify. Protect. Grow.
+
+## Current source snapshot
+- Newest collection import: **4,003 rows / 4,022 represented units**.
+- Stored source guide value: **~$10,391** before fresh premium comp verification.
+- **325 duplicate IDs** are routed to reconciliation before sale/break placement.
+- 30-day Daily 25 queue: **750 unique inventory assets**.
+
+## Daily rhythm (ET)
+| Time | Action |
+|---|---|
+| 08:00 | Inventory + market refresh |
+| 09:00 | Hero 5 |
+| 11:30 | Player / Set 5 |
+| 14:00 | Value / Lot 5 |
+| 17:00 | Pre-Live 5 |
+| 19:00 | Live room setup |
+| 20:00–22:00 | Long-form / break window |
+| 22:15 | Hits / Last-Call 5 |
+| 22:30 | Reconcile + clip extraction |
+
+## Weekly break slate
+| Day | Event | Time ET |
+|---|---|---|
+| Monday | Market Monday Singles Showcase | 8:00 PM |
+| Tuesday | Basketball Mixer | 8:30 PM |
+| Wednesday | Production + Shipping | No break |
+| Thursday | One Piece / Baseball rotation | 8:30 PM |
+| Friday | Football Prime | 9:00 PM |
+| Saturday | Multi-Sport Matinee | 2:00 PM |
+| Saturday | BreakVault Prime | 8:00 PM |
+| Sunday | Hits + Ship With Me | 7:00 PM |
+
+## Live production architecture
+- **DSLR** → HDMI capture → YouTube 16:9 master.
+- **Logi camera** → overhead/card-closeup/backup view.
+- **Phone + ONN 8-inch RGB ring light holder** → TikTok 9:16 vertical.
+- **Bower dual wireless microphones** → host + guest or backup audio.
+- **WhatsApp** → Daily 25 drop, live alerts, claim handoff, result follow-up.
+
+## BreakVault evidence gate
+1. Publish break format and rules.
+2. Lock participant/payment ledger.
+3. Show sealed product or fully disclosed inventory board.
+4. Record assignment/randomization when applicable.
+5. Keep opening/showcase recording uninterrupted.
+6. Show premium hits front/back/card number/serial when relevant.
+7. Move hits directly to labeled participant custody bins.
+8. Reconcile packing, tracking, refunds/disputes, and financial closeout.
+
+## Premium sale gate
+No premium or variation-sensitive asset is published with a final ask until exact version, condition evidence, and current market evidence are recorded. Duplicate IDs stay on hold until resolved. Cards are not marked SOLD before payment confirmation.
+
+## Source-of-truth hierarchy
+`ACool Inventory Ledger → Square → QuickBooks`, with daily reconciliation and no duplicate active SKU.
diff --git a/docs/BreakVault/SPORTSCARDSPRO_SYNC.md b/docs/BreakVault/SPORTSCARDSPRO_SYNC.md
@@ -0,0 +1,31 @@
+# SportsCardsPro Sync Plan
+
+## Role in ACoolCOLLECTOR
+SportsCardsPro is an internal current price-guide and demand input. It is not the only completed-sale authority for premium transaction decisions.
+
+## Secret handling
+Use an environment secret such as `SPORTSCARDSPRO_TOKEN`. Never commit a subscription token, API URL containing the token, or downloaded licensed data to a public repository.
+
+## Mapping flow
+1. If the inventory record contains a confirmed SportsCardsPro product ID, map directly.
+2. Otherwise search using product name + set/console name.
+3. Store candidate match confidence and require human review for ambiguous parallels/variants.
+4. Refresh price-guide data no more often than the subscription/data cadence requires.
+
+## Suggested fields
+- `mapping_status`
+- `scp_id`
+- `last_refreshed_at`
+- `loose_price`
+- `graded_price`
+- `psa10_price`
+- `bgs10_price`
+- `sales_volume`
+- `confidence`
+- `review_reason`
+
+## Premium card workflow
+Exact identity → front/back/condition evidence → SportsCardsPro current guide → independent completed-sale evidence where applicable → BETH confidence → Ruth Review → final public ask.
+
+## Data rights gate
+Treat downloaded/API price data as licensed internal business data unless external display/redistribution permission is confirmed under the current SportsCardsPro terms. Do not expose raw subscription datasets through a public API or client-side bundle.