UAI Thinktank → Explorer Promotion Concept
Operator runbook for promoting UAI Thinktank artifacts to Explorer via the /operator/ideas inbox using an export-and-feedback pipeline, ensuring local deliberation stays isolated from production.
Body
Slug
[REDACTED:high-entropy]
Kind
plan
Project
uai-explorer
Required Tags
- docs
- uai-explorer
- idea
UAI Thinktank → Explorer Promotion Concept Document
1. Executive Summary
This document outlines the operator runbook for promoting deliberation artifacts from the local UAI Thinktank to the production Explorer environment. The UAI Thinktank serves as an isolated Mac archive for local consideration and feedback. Explorer acts as the central production hub, utilizing the /operator/ideas inbox to aggregate feedback. Because the canonical uai-thinktank tag is restricted, this promotion relies on a strict export-and-feedback pipeline, ensuring no local deliberation runtime executes on production servers.
2. Promotion Flow
The lifecycle of an idea moving from local deliberation to production catalog follows these sequential steps:
- Thinktank Export: The local Mac environment packages the deliberation context and proposed idea into a standard JSON payload.
- Feedback Bridging: The operator utilizes the
[REDACTED:high-entropy]runbook to format the export safely for production ingestion. - Explorer Inbox: The payload arrives in the Explorer Ideas inbox at
/operator/ideas. It is immediately categorized using the P0 schema. - Catalog Promote: Operators review the submission, resolve any flagged deliberation context, and approve the idea for promotion into the live Explorer catalog.
3. Field Mapping Table
To ensure proper routing from the local Thinktank to the Explorer inbox, the local export data must map to the Ideas P0 schema fields as follows:
| Local Thinktank Export Key | Explorer P0 Schema Field | Description & Format |
|---|---|---|
origin |
source_lane | Enum strictly set to thinktank. Identifies the payload origin. |
deliberation_status |
review_state | Set to pending_consideration upon initial arrival in the inbox. |
final_decision |
operator_approved | Boolean. Defaults to false; flipped to true upon catalog promotion. |
target_catalog_item |
promoted_to_slug | The canonical, URL-friendly slug assigned when promoted to Explorer. |
raw_mac_archive |
salvage_from | JSON object containing localized metadata (e.g., {"mac_node": "local-dock", "session_id": "xyz"}). |
4. Tag ACL Proposal
To maintain strict isolation between local deliberation and production AI execution, the following Access Control List (ACL) rules are proposed for the canonical uai-thinktank tag:
- Default State: Blocked. The AI lane cannot read, write, or execute against the
uai-thinktanktag under any circumstances. - Promoted-Only Read Access: The AI lane may only process the underlying data after it has been explicitly promoted to a new, authorized production slug within Explorer, completely severing the connection to the original local tag.
5. Owner Gates
Strict operational gates protect the integrity of the production environment and local archives:
- No Tag Mutation Without Approval: The canonical
uai-thinktanktag state cannot be modified, unblocked, or bypassed without explicit, logged operator approval. - No Thinktank Runtime on VPS: The UAI Thinktank deliberation engine is strictly forbidden from executing on Virtual Private Servers (VPS). It remains permanently sandboxed as a local Mac archive.
6. Acceptance Criteria
The Thinktank to Explorer promotion pipeline is considered fully operational when:
- The UAI Thinktank remains strictly isolated to the Mac archive with zero process footprints on production VPS instances.
- Exports successfully traverse the
[REDACTED:high-entropy]bridge and appear in the/operator/ideasinbox. - The Explorer P0 schema correctly ingests the payload, accurately mapping the
source_laneto thethinktankenum. - The AI lane is successfully denied direct access to the
uai-thinktanktag, verifying the default-blocked ACL configuration. - Operators can successfully transition an idea from
pending_considerationtooperator_approved, successfully generating thepromoted_to_slugwithout runtime errors.