GO Vault

_WEB_DEPLOY_PIPELINE

7 min read

THEOPHYSICS WEB DEPLOYMENT PIPELINE

4 AI Sessions → Everything Online, Linked, Permanent

Ring 2 — Canonical Grounding

Ring 3 — Framework Connections

OVERVIEW

Goal: Take everything in O:\_Theophysics_v3\04_THEOPYHISCS (200+ markdown files across 50+ directories), convert to linked HTML, deploy to Cloudflare, never lose it.

Existing Infrastructure:

  • theophysics-html-server Worker → serves from R2 bucket theophysics-html
  • Auth-protected, gold/dark aesthetic already built
  • Domains: theophysics.pro, faiththruphysics.com
  • R2 buckets: theophysics-html, theophysics-files, theophysics-storage

Each session gets a copy-paste prompt below. Run them in order.

SESSION 1: THE INVENTORY

AI: Any (Claude, Gemini, GPT — whoever has filesystem access)

Time: ~15 min

Output: manifest.json + site_map.md

TASK: Build a complete inventory of all Theophysics content.

LOCATION: O:\_Theophysics_v3\04_THEOPYHISCS\

Walk every directory and subdirectory. For each .md file, extract:
- filepath (relative to 04_THEOPYHISCS)
- title (from YAML frontmatter title field, or first # heading, or filename)
- word count
- category (infer from parent directory: "Genesis to Quantum", "Laws", "Trinity", "Consciousness", "Axioms", "Logos Foundation", "Theological Engineering", "Cross-Domain", "Three Truths", "Spirits", "Topics", "Hypotheses", "Unified Coherence", "Scored Papers", "Foundations", "Other")
- has_math (true if file contains LaTeX: $, \int, \frac, etc.)
- internal_links (list of wikilinks found in the file)
- layer (if in LAYER_1/2/3/4 directory, note which)

OUTPUT TWO FILES:

1. O:\_Theophysics_v3\04_THEOPYHISCS\manifest.json
   - Array of objects, one per file, with all fields above
   - Sort by category, then by filename

2. O:\_Theophysics_v3\04_THEOPYHISCS\site_map.md
   - Human-readable site map organized by category
   - Show hierarchy: Category > Subcategory > File (word count)
   - Include total stats at top: total files, total words, categories, files with math

DO NOT convert anything. DO NOT modify any files. Inventory only.

SESSION 2: THE CONVERTER

AI: Claude (needs code execution for batch processing)

Time: ~30 min

Output: Full HTML site in O:\_Theophysics_v3\04_THEOPYHISCS\_site\

TASK: Convert the entire Theophysics content library to a linked HTML website.

INPUTS:
- Source: O:\_Theophysics_v3\04_THEOPYHISCS\ (all .md files)
- Manifest: O:\_Theophysics_v3\04_THEOPYHISCS\manifest.json (from Session 1)

REQUIREMENTS:

1. CONVERSION
   - Convert every .md file to .html
   - Preserve directory structure under _site/
   - Render markdown to HTML (headers, bold, italic, lists, code blocks)
   - Render LaTeX math using KaTeX CDN (inline $ and display $$)
   - Convert wikilinks to working <a href="..."> links pointing to the correct .html file
   - If a wikilink target doesn't exist, make it a dead link styled in red

2. NAVIGATION
   - Every page gets a persistent left sidebar with:
     - Site title: "THEOPHYSICS" (gold, links to index)
     - Category sections (collapsible): Genesis to Quantum, Laws, Trinity, etc.
     - Current page highlighted
   - Every page gets breadcrumbs at top: Category > Subcategory > Page
   - Every page gets prev/next links at bottom (within same category)

3. INDEX PAGE (_site/index.html)
   - Hero section: "THEOPHYSICS RESEARCH ARCHIVE" with subtitle and total stats
   - Category cards with file counts and descriptions
   - Search box (client-side, filters visible page links)
   - Recent files section (by modified date if available, otherwise alphabetical)

4. STYLING
   - Dark background: #0a0e27
   - Gold accent: #d4af37
   - Body text: #e8e8e8
   - Links: #4a90e2
   - Code blocks: dark with syntax highlighting
   - Math: rendered clean via KaTeX
   - Responsive (works on mobile)
   - Font: system stack (-apple-system, etc.)

5. SPECIAL PAGES
   - _site/genesis-to-quantum/index.html — series landing page with article order and descriptions
   - _site/laws/index.html — all 10 laws with their symmetry pairs noted
   - _site/logos-foundation/index.html — all 14 papers in order

OUTPUT: Write a Python script that does all of this.
- Script path: O:\_Theophysics_v3\04_THEOPYHISCS\build_site.py
- Output directory: O:\_Theophysics_v3\04_THEOPYHISCS\_site\
- The script should be re-runnable (clean _site/ first, then rebuild)
- Print summary when done: files converted, links resolved, broken links found

DO NOT upload anything. Build locally only.

SESSION 3: THE DEPLOYER

AI: Claude with Cloudflare MCP (or any AI that can run wrangler commands)

Time: ~15 min

Output: Everything live on the web

TASK: Deploy the Theophysics HTML site to Cloudflare.

BUILT SITE LOCATION: O:\_Theophysics_v3\04_THEOPYHISCS\_site\

EXISTING INFRASTRUCTURE:
- R2 bucket: "theophysics-html" (already exists)
- Worker: "theophysics-html-server" (already exists, serves from this bucket)
- The worker has Basic Auth protection (keep this)

STEPS:

1. UPLOAD TO R2
   - Upload every file in _site/ to the "theophysics-html" R2 bucket
   - Preserve directory structure (e.g., _site/laws/index.html → laws/index.html)
   - Set correct Content-Type headers:
     - .html → text/html
     - .css → text/css
     - .js → application/javascript
     - .json → application/json
   - Use wrangler CLI: npx wrangler r2 object put theophysics-html/{key} --file {local_path}
   - Or write a batch upload script

2. UPDATE WORKER (if needed)
   - The existing worker serves index.html for "/" and any path from the bucket
   - It may need updates to handle:
     - Directory paths (e.g., /laws/ should serve /laws/index.html)
     - Proper MIME types for CSS/JS assets
     - Cache headers for static assets
   - Test the worker handles nested paths correctly

3. VERIFY
   - Confirm the site loads at the worker URL
   - Confirm auth still works
   - Confirm at least 3 internal links work (click through)
   - Confirm KaTeX math renders
   - Report: total files uploaded, total size, any failures

Print the live URL when done.

SESSION 4: THE POLISHER

AI: Claude or any frontend-capable AI

Time: ~20 min

Output: Visual improvements, better navigation, final touches

TASK: Polish the Theophysics web archive for presentation quality.

SITE LOCATION: O:\_Theophysics_v3\04_THEOPYHISCS\_site\
LIVE URL: [paste URL from Session 3]

IMPROVEMENTS NEEDED:

1. HOMEPAGE UPGRADE
   - Add a brief "What is Theophysics?" intro paragraph (pull from any README or intro file)
   - Make the Genesis to Quantum series featured prominently — it's the public-facing entry point
   - Add visual hierarchy: featured series → category grid → full index
   - Add a "Start Here" button linking to Genesis to Quantum overview

2. READING EXPERIENCE
   - Add estimated reading time to each article (based on word count / 200)
   - Add a floating "back to top" button
   - Add a table of contents sidebar for long articles (auto-generated from headings)
   - Improve code block styling (if any exist)
   - Make sure math equations have breathing room (margin above/below)

3. CROSS-LINKING ENHANCEMENT
   - At the bottom of each Genesis to Quantum article, add a "Sources" section listing which Logos Papers it draws from (use LOGOS_GTQ_CROSSREF.md data)
   - At the bottom of each Logos Foundation paper, add "Referenced by" links back to GTQ articles
   - Add "Related pages" suggestions at bottom of each page (same category, or pages that link to this one)

4. VISUAL POLISH
   - Add subtle gold line separators between sections
   - Add a small Theophysics logo/wordmark in the sidebar header
   - Improve the search: make it instant-filter (already client-side, just make it snappier)
   - Add smooth scroll behavior
   - Add print stylesheet (clean, no sidebar, black text on white)

5. METADATA
   - Add <meta> tags: description, author (David Lee), keywords
   - Add Open Graph tags so links look good when shared
   - Add a favicon (generate a simple gold chi on dark background)

After making changes, re-run the build script or edit HTML directly.
Then re-upload changed files to R2 (Session 3 upload commands).

NOTES

  • Sessions 1-2 can run on any AI with filesystem access to O: drive
  • Session 3 needs Cloudflare access (MCP or wrangler CLI)
  • Session 4 can run anywhere, but needs to re-upload after
  • Total time: ~1-1.5 hours across all 4 sessions
  • Once deployed, the content is on Cloudflare’s global CDN — it’s not going anywhere

QUICK REFERENCE: What’s Being Deployed

CategoryFilesDescription
Genesis to Quantum12+7 articles + 5 tangents + crossref + intro
Logos Foundation14Formal academic papers (P00-P13)
Laws20+Ten Laws with symmetry pairs, parallel Master Eq structure
Trinity9+Math summary, individual persons, full paper, visual walkthrough
Axiom Foundations22Core definitions: Existence through Truth
Consciousness System40-10-5Funnel hierarchy with evidence extracts
Theological Engineering7+Proof papers: Resurrection, Salvation, Grace
Three Truths20+De Revolutionibus Veritatis series
Spirits28Full taxonomy indexed
Cross-Domain Coherence30+Four-layer application system
Topics15+P1-P15 stub papers
Unified Coherence15+Framework, critics response, manifesto
Scored Papers10+[5.5] through [8.2] rated works
Foundations/Other20+Master equation, hypotheses, misc
TOTAL~250+Full research archive

Canonical Hub: CANONICAL_INDEX

Graph View