================================================================================
SAFE_STAGING_DEPLOYMENT_RULES_5_12_26.txt
CollabORhythm / Collabtunes — Production Implementation Phase
Generated: 5.12.26 | Production Claude
PURPOSE: Define exactly what qualifies as staging, what cannot go live,
         what requires Tom approval, what requires source pulls,
         and what requires canon lock before any page moves to production.
STATUS: ACTIVE — apply to every file before deployment decision is made
================================================================================

================================================================================
SECTION 1 — WHAT QUALIFIES AS STAGING
================================================================================

A page is STAGING if ANY of the following are true:

  S-01  Filename contains _STAGING
  S-02  Page contains one or more SOURCE_PULL_REQUIRED badges
  S-03  Page contains one or more PENDING badges
  S-04  Template has not been approved by Tom
  S-05  GX score is unverified (delta conflict unresolved)
  S-06  Any internal crosslink points to an unresolved conflict URL
  S-07  Any track title slot is empty or marked pending
  S-08  Rating gate has not been tested in a live browser
  S-09  Page has not been reviewed by Tom
  S-10  Page carries a STAGING BANNER in the HTML

A staging page:
  — May be shared with Tom for review
  — May be tested locally in a browser
  — Must NOT be uploaded to Yola as a public page
  — Must NOT be linked from any live nav entry
  — Must NOT be described to visitors as complete content

--------------------------------------------------------------------------------

================================================================================
SECTION 2 — WHAT CANNOT GO LIVE (HARD BLOCKS)
================================================================================

The following conditions are absolute blocks on deployment.
If any are true, the page does not go live. No exceptions.

  HARD BLOCK 1 — TEMPLATE NOT LOCKED
    The 15-block AIO template must be approved by Tom before any AIO page
    is deployed. One approved staging page locks the template.
    No template lock = no AIO page deployment.

  HARD BLOCK 2 — DEFAMATION REGISTRY NOT CLEARED
    Tom has not reviewed DEFAMATION_RISK_REGISTRY_VOL1.
    No page that could contain flagged content goes live until Tom clears it.
    This is a project-wide block on all content deployment.

  HARD BLOCK 3 — RATING GATE UNTESTED IN BROWSER
    A page requiring a rating gate (PG-13, R, NC-17, X) must be tested
    in an actual browser at all rating levels before deployment.
    Code review alone is not sufficient. Gate must be confirmed working.

  HARD BLOCK 4 — UNRESOLVED URL IN CROSSLINKS
    If a page links to a conflict URL (duplicate ch.18, LadyWeaver conflict,
    unresolved YouTube slug), it cannot be deployed until the conflict is
    resolved and the correct URL is confirmed.

  HARD BLOCK 5 — PROFANITY VISIBLE WITHOUT GATE
    Any page where profanity or explicit content is visible to a G/PG visitor
    cannot be deployed. This includes pages where the rating gate has a bug.

  HARD BLOCK 6 — RAW BRACKET TEXT VISIBLE
    Any page where [SOURCE_PULL_REQUIRED] or similar bracket text appears
    as rendered visible text (not a styled badge) cannot be deployed.
    Placeholder text must always render as a styled badge element.

  HARD BLOCK 7 — STAGING BANNER PRESENT
    Any page with the STAGING BANNER div in the HTML is not deployment-ready.
    Remove the banner only after Tom approval and all hard blocks are cleared.

  HARD BLOCK 8 — CHAPTER DRIFT UNRESOLVED (for pages linking chapters)
    Any page that contains links to Songbook chapters 18B–34 cannot be deployed
    until chapter drift is resolved. Wrong chapter labels create broken nav.

--------------------------------------------------------------------------------

================================================================================
SECTION 3 — WHAT REQUIRES TOM APPROVAL
================================================================================

The following require explicit Tom approval before proceeding:

  TOM-01  AIO template structure — approve SL1 staging → locks template for all 34
  TOM-02  Mission Statement copy — structural placeholder active, needs real copy
  TOM-03  Bouncer subtitle copy — interim copy active, Tom to confirm or replace
  TOM-04  X-rated nav handling — Decision 01 (Option A/B/C)
  TOM-05  Revenue Streams destination URL — Decision 04, no safe default
  TOM-06  Chapter drift fix option — Decision 06 (Option A or B)
  TOM-07  Canonical Chapter 18 — Decision 07
  TOM-08  Canonical Lady Weaver URL — Decision 09
  TOM-09  GX delta:1 verification — 6 Song Lists affected
  TOM-10  Defamation registry clearance — required before any bulk generation
  TOM-11  Set List 23 content — unknown title context, unconfirmed rating
  TOM-12  Set List 24 content — LGBTQ+ likely, unconfirmed
  TOM-13  Full Lyrics gate level — Decision 03 (PG-13 or R minimum)
  TOM-14  Any page that inverts a prior canon decision

When Tom approval is pending:
  — Flag it: [NEEDS TOM DECISION — describe the item]
  — Do not execute the blocked action
  — Do not use a safe default for items marked NO SAFE DEFAULT
  — Document the block in the session's running flag list

--------------------------------------------------------------------------------

================================================================================
SECTION 4 — WHAT REQUIRES SOURCE PULLS
================================================================================

Source pull = pulling confirmed content from a primary source file
(34_ALBUMS PDF, mood_settings file, revised_category_list, live site capture).
Do not invent, summarize, or generate content as a substitute for a source pull.

  PULL-01  SL1 tracks 2–7 and 9–13 — titles unknown
           Source: 34_ALBUMS PDF (White Claude 2 material)

  PULL-02  Per-track ratings for all 34 collections
           Source: mood_settings_ratings_explicit file (not yet uploaded)

  PULL-03  GX scores for all collections beyond confirmed ones
           Source: mood_settings file + Tom GX verification

  PULL-04  Category tags for all 34 collections
           Source: revised_category_list_updated.odt

  PULL-05  One-sentence summaries for all 34 collections
           Source: 34_ALBUMS PDF, Ch.10 of Songbook

  PULL-06  Rolling Stone-style reviews for all 34 collections
           Source: Ch.9 of Songbook (R-gated — gate before accessing)

  PULL-07  Full track notes / annotations
           Source: 34_ALBUMS PDF source files

  PULL-08  Per-track trigger warnings and profanity flags
           Source: mood_settings file + RATINGS_INDEX

  PULL-09  Set List 23 content and rating
           Source: Source pull required before any generation

  PULL-10  Set List 24 content and rating
           Source: Source pull required before any generation

  PULL-11  Fast Scroll body content
           Source: Manual capture by Tom (JS-rendered — cannot automate)

Rules for source pulls:
  — Never substitute editorial generation for a source pull
  — If source is unavailable, use a styled SOURCE_PULL_REQUIRED badge
  — Never invent track titles, ratings, summaries, or metadata
  — When source is received, cross-check against canon before injecting

--------------------------------------------------------------------------------

================================================================================
SECTION 5 — WHAT REQUIRES CANON LOCK
================================================================================

Canon lock = a data item confirmed and recorded in FINAL_CANON_AUTHORITY_REGISTRY.
Locked items cannot be changed without Tom confirmation.
Unlocked items cannot be stated as fact in any generated page.

CURRENTLY LOCKED (safe to use in generation):
  ✅ All 34 album titles (10 Song Lists + 24 Set Lists)
  ✅ SL1 track count = 13
  ✅ SL1 Track 1 = "Knowing the Know" — LadyWeaver credited
  ✅ SL1 Track 8 = "Rain" — partial only, two stanzas
  ✅ SL1 artist comparisons = Bob Dylan, Leonard Cohen, Lou Reed
  ✅ SL1 confirmed themes = addiction, isolation, identity fracture, media critique
  ✅ Rating = PG-13 for all 10 Song Lists
  ✅ Set List 7 = R rated
  ✅ Set List 8 = R rated
  ✅ HOW I GOT HERE Full Dirty = X rated
  ✅ HOW I GOT HERE Full Talk w/Claude AI = X rated
  ✅ Visual canon palette (all CSS variables)
  ✅ 15-block AIO page structure
  ✅ All 34 album page URLs (/song-list-N, /set-list-N confirmed)
  ✅ Chapters 1–15 and 17 — URL slugs correct, no drift
  ✅ Rating system: G / PG / PG-13 / R / NC-17 / X

REQUIRES CANON LOCK BEFORE USE:
  ⚠️ GX score for SL1 (and SL3, SL6, SL7, SL8, SL10) — delta:1 unresolved
  ⚠️ SL1 tracks 2–7, 9–13 — source pull + Tom confirmation needed
  ⚠️ Per-track ratings for all collections — mood_settings file needed
  ⚠️ Canonical Lady Weaver URL — Tom Decision 09
  ⚠️ Canonical Chapter 18 — Tom Decision 07
  ⚠️ SL22–24 URL format standard — Tom Decision pending
  ⚠️ Which Chapter 19 status — orphan decision pending
  ⚠️ Set List 23 rating — source pull + Tom confirmation
  ⚠️ Set List 24 rating — source pull + Tom confirmation

Never use an unlocked item as if it were fact.
If data is unlocked: use a pending badge and flag it.

--------------------------------------------------------------------------------

================================================================================
SECTION 6 — STAGING → PRODUCTION PROMOTION CHECKLIST
================================================================================

Before promoting any page from STAGING to PRODUCTION:

  [ ] Tom has reviewed and approved the page
  [ ] All SOURCE_PULL badges replaced with confirmed data
  [ ] All PENDING badges resolved or explicitly accepted as-is by Tom
  [ ] STAGING BANNER removed from HTML
  [ ] _STAGING removed from filename → replaced with _APPROVED
  [ ] Rating gate tested in Chrome, Firefox, and mobile
  [ ] All internal links verified against MASTER_URL_AUTHORITY_REGISTRY
  [ ] No links point to conflict URLs (ch.18 dup, LadyWeaver dup)
  [ ] Defamation registry clearance confirmed for this collection
  [ ] GX score confirmed (delta resolved or Tom accepted pending display)
  [ ] Template version matches locked template version
  [ ] Page added to deployment manifest before uploading to Yola
  [ ] Rollback ZIP created before uploading

Only after all boxes are checked: upload to Yola at confirmed URL slug.

================================================================================
END SAFE_STAGING_DEPLOYMENT_RULES_5_12_26.txt
================================================================================
