diff --git a/docs/BreakVault/AGENT_MESH.md b/docs/BreakVault/AGENT_MESH.md new file mode 100644 index 00000000..1ab53eb8 --- /dev/null +++ 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. \ No newline at end of file diff --git a/docs/BreakVault/OPERATING_SYSTEM_2026-08-17.md b/docs/BreakVault/OPERATING_SYSTEM_2026-08-17.md new file mode 100644 index 00000000..58fd844f --- /dev/null +++ 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. \ No newline at end of file diff --git a/docs/BreakVault/SPORTSCARDSPRO_SYNC.md b/docs/BreakVault/SPORTSCARDSPRO_SYNC.md new file mode 100644 index 00000000..94e402d9 --- /dev/null +++ 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. \ No newline at end of file