astro-tractstack 2.1.3 → 2.2.0

package/README.md

@@ -1,303 +1,91 @@
-# TractStack v2.1
-
-**The Digital Experience Platform (DXP) for the Missing Middle.**
-
-> "Static websites treat every visitor like a stranger. TractStack treats them like a relationship."
-
-## The Problem: The Legacy Web has Amnesia
-
-Static technology forces you to serve the exact same generic monologue to everyone—whether they are a "tire kicker" or a "high-ticket buyer."
-
-Legacy tools (Wix, WordPress) suffer from **Intent Blindness**. They were built for page views, not signal clarity. They force your best leads to dig through a haystack to find the "hidden door" they need, causing them to bounce.
-
-## The Solution: A Living Funnel
-
-TractStack is an **Epistemic Hypermedia Server** that acts as a triage nurse, not a brochure. It turns a fragile "page view" into a powerful, privacy-first user journey.
-
-### Core Philosophy
-
-1. **The Recall (No Cookies Required):** We moved "memory" from fragile cookies to a proprietary server-side logic engine. This ensures the conversation persists across privacy blocks and browser refreshes.
-2. **Smart Triage:** Our logic engine identifies 'High-Intent' users instantly and accelerates them to conversion, while automatically nurturing the rest.
-3. **Hidden Doors:** Instead of a static page, you define content paths that only open when a user signals interest.
-
----
-
-## The Tech Stack: "Convert OS"
-
-TractStack is a hybrid engine designed for performance and logic.
-
-- **Frontend:** [Astro](https://astro.build/) (The "Free" Web Press). Renders SEO-ready, indexable HTML.
-- **Backend:** [Golang](https://go.dev/) (The Logic Processor). A compiled, server-side engine that manages state, session continuity, and adaptive content.
-- **Glue:** [HTMX](https://htmx.org/). Enables real-time, dynamic interactions without heavy client-side frameworks.
-- **Database:** SQLite by default (Zero Config) with optional [Turso](https://app.turso.tech/) support.
-
-## For Agencies & Empire Builders
-
-TractStack was engineered for the "Missing Middle"—high-volume creators and agencies who have outgrown static sites but don't need enterprise bloat.
-
-- **Wholesale DXP:** An infrastructure-first model. Agencies pay a flat wholesale fee and own the recurring margin on "Growth Projects."
-- **Visual Journey Mapping:** Don't guess what works. See it. TractStack visualizes the narrative journey of your audience, showing exactly how they navigate your Hidden Doors.
-- **No Code Required:** Build engaging, interactive websites where the "general noise" fades and specific content triggers based on engagement.
-
-## Quick Install
-
-### One-Line Installer
-
-```bash
-curl -fsSL https://get.tractstack.com | bash
+# The "Free Web" Press by At Risk Media
+
+```text
+ ▄██▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄██▄▄▄▄▄▄▄██▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄
+  ██  ██ ██ ▀▀ ██ ██ ▀▀ ██ ██ ▀▀ ██ ▀▀ ██ ██ ▀▀ ██ ██
+  ██  ██▀█▄ ██▀██ ██ ▄▄ ██ ▀▀▀██ ██ ██▀██ ██ ▄▄ ██▀█▄
+  ██  ██ ██ ██▄██ ██▄██ ██ ██▄██ ██ ██▄██ ██▄██ ██ ██
+   ▀▀                   ▀▀       ▀▀             ▀▀ ▀▀▀
 ```
 
-This automatically installs both the Go backend and creates a new Astro project with TractStack integration.
-
-### Installation Options
-
-- `--quick` - Development setup in user directory (no sudo required)
-- `--prod --domain=yourdomain.com` - Production single-tenant
-- `--multi --domain=yourdomain.com` - Production multi-tenant hosting
-- `--dedicated SITE_ID --domain=yourdomain.com` - Isolated dedicated instance
+## The Manifesto: The Web Has Amnesia
 
-## Manual Installation
+Traditional CMS software conquered the world by making publishing easy—but it broke the relationship. It treats every visitor like a stranger. It forces you to serve the exact same generic monologue to everyone, relying on invasive third-party tracking to guess who is reading.
 
-**Prerequisites:**
-
-- Node.js 20+
-- pnpm (recommended) or npm
-- Go 1.22+
-- Git
-
-### Step 1: Install Go Backend
-
-```bash
-mkdir -p ~/t8k/src
-cd ~/t8k/src
-git clone https://github.com/AtRiskMedia/tractstack-go.git
-cd tractstack-go
-echo "GO_BACKEND_PATH=$HOME/t8k/t8k-go-server/" > .env
-echo "GIN_MODE=release" >> .env
-go build -o tractstack-go ./cmd/tractstack-go
-```
-
-### Step 2: Create Astro Frontend
-
-```bash
-cd ~/t8k
-pnpm create astro@latest my-tractstack --template minimal --typescript strict --install
-cd my-tractstack
-pnpm add astro-tractstack@latest
-echo "PRIVATE_GO_BACKEND_PATH=$HOME/t8k/t8k-go-server/" > .env
-npx create-tractstack
-```
-
-### Step 3: Start Development
-
-```bash
-# Terminal 1: Go backend
-cd ~/t8k/src/tractstack-go
-./tractstack-go
-
-# Terminal 2: Astro frontend
-cd ~/t8k/src/my-tractstack
-pnpm dev
-```
+## The "Free Web" Press Restores the Signal
 
-Visit <https://127.0.0.1:4321> to access your site and activate your Story Keep (CMS).
+**TractStack v2.2** is not just a CMS; it is a **Signal Continuity Engine**. It takes the concept of the "Press"—broadcasting ideas—and adds the "Handshake."
 
-## Installation Types
+### 1. The Mass-Produced Handshake (Smart Triage)
 
-### Development (Quick Install)
+Legacy tools suffer from **Intent Blindness**. The Free Web Press serves a dialogue.
 
-- Local setup in `~/t8k/`
-- No sudo required
-- Perfect for development and testing
-- SQLite database included
+- **Identify Intent:** Our logic engine acts like a triage nurse, identifying high-intent users instantly.
+- **The Hidden Door:** You define content paths that only open when a user signals interest.
+- **The Result:** You don't just "publish" a site; you press a branded universe that adapts to every visitor.
 
-### Production Single-Tenant
+### 2. Generative Architecture (No-Code Freedom)
 
-- System-wide installation at `/home/t8k/`
-- SSL certificates via Let's Encrypt
-- nginx reverse proxy
-- systemd services for automatic startup
-- PM2 process management
+Don't settle for the "rigid" look of standard platforms.
 
-### Production Multi-Tenant
+- **AI Design Creator:** Design any section by prompt for complete creative control.
+- **Semantic Integrity:** We extract content as Markdown for full-text search and maximum SEO benefit, ensuring your signal remains concrete even when the design is fluid.
 
-- Same as single-tenant plus:
-- Wildcard domain support (`*.yourdomain.com`)
-- Tenant management at `/sandbox/register`
-- Multiple isolated websites from one installation
+### 3. Total Memory (Privacy as Infrastructure)
 
-### Dedicated Instance
+We moved "memory" from fragile third-party cookies (The Dependent Web) to a proprietary server-side logic engine (The Free Web).
 
-- Completely separate installation per site
-- Own source code, binaries, and data
-- Maximum isolation and customization
-- Perfect for agencies managing multiple clients
+- **The Handshake:** First-party session management keeps the conversation fluid without external tracking.
+- **The Kill Switch:** True data sovereignty. If a user revokes consent, the system immediately purges the session.
 
-## Project Structure
-
-```
-~/t8k/                              # Development install
-├── src/
-│   ├── tractstack-go/             # Go backend source
-│   │   └── tractstack-go          # Compiled binary
-│   └── my-tractstack/             # Astro frontend
-│       ├── src/
-│       │   ├── components/        # Custom components
-│       │   ├── pages/            # Astro pages
-│       │   └── custom/           # Your customizations
-│       └── astro.config.mjs
-└── t8k-go-server/                 # Backend data storage
-    ├── config/
-    │   ├── t8k/
-    │   │   └── tenants.json       # Tenant registry
-    │   └── default/               # Default tenant config
-    │       ├── env.json           # Core configuration
-    │       ├── brand.json         # Site branding
-    │       ├── knownResources.json # Resource tracking
-    │       ├── tailwindWhitelist.json # CSS optimization
-    │       └── media/             # Media files
-    │           ├── images/
-    │           └── css/
-    ├── db/
-    │   └── default/
-    │       └── tractstack.db      # SQLite database
-    └── log/
-        ├── system.log
-        ├── tenant.log
-        └── database.log
-```
-
-### Production Structure
-
-Production installations live at `/home/t8k/` with the same structure plus:
-
-```
-/home/t8k/
-├── bin/
-│   └── tractstack-go             # Production binary
-├── etc/
-│   ├── letsencrypt/             # SSL certificates
-│   ├── pm2/                     # PM2 configs
-│   └── t8k-ports.conf           # Port allocations
-├── scripts/
-│   └── t8k-concierge.sh         # Build automation
-└── state/                       # Build queue
-```
-
-## Multi-Tenant Features
-
-TractStack v2 includes powerful multi-tenant capabilities:
+---
 
-- **Tenant Registration**: Self-service tenant creation at `/sandbox/register`
-- **Domain Routing**: Automatic subdomain routing (`tenant.yourdomain.com`)
-- **Isolated Data**: Each tenant has separate databases and media
-- **Capacity Management**: Configurable tenant limits
-- **Email Activation**: Automated tenant activation emails
+## The Tech Stack
 
-## Service Management
+TractStack is a hybrid engine designed for performance and logic.
 
-### Main Installation
+- **Frontend:** [Astro](https://astro.build) — The "Free Web" Press for SEO-ready HTML.
+- **Backend:** Golang — A compiled engine that manages state, session continuity, and adaptive content.
+- **Glue:** [HTMX](https://htmx.org) — Enables real-time, dynamic interactions without heavy client-side frameworks.
+- **Data:** [Turso](https://turso.tech) — Scalable high performance, lightweight database.
 
-```bash
-# Status
-sudo systemctl status tractstack-go
-sudo -u t8k pm2 status astro-main
+## Quick Start
 
-# Restart
-sudo systemctl restart tractstack-go
-sudo -u t8k pm2 restart astro-main
-
-# Logs
-sudo journalctl -u tractstack-go -f
-sudo -u t8k pm2 logs astro-main
-```
-
-### Dedicated Instances
+Visit [https://tractstack.com](Tract Stack dot com) for hosted plans. For the do-it-yourself folks, our one-line installer handles the heavy lifting:
 
 ```bash
-# Replace SITE_ID with your site identifier
-sudo systemctl status tractstack-go@SITE_ID
-sudo -u t8k pm2 status astro-SITE_ID
-```
-
-## Build System
-
-The build concierge processes automated builds via CSV files in `/home/t8k/state/`:
-
-```csv
-type=main,tenant=default,command=build
-type=dedicated,site=SITE_ID,command=build
+curl -fsSL https://get.tractstack.com | bash
 ```
 
-The system automatically:
-
-1. Pulls latest code from Git
-2. Builds Go backend and Astro frontend
-3. Extracts Tailwind CSS optimizations
-4. Restarts services
-5. Cleans up processed files
-
-## Database Options
-
-### SQLite (Default)
-
-- Zero configuration required
-- Perfect for most websites
-- Automatic backups and maintenance
-- Scales to hundreds of thousands of visitors
-
-### Turso Cloud Database
-
-- Distributed SQLite with global replication
-- Configure during site initialization
-- Seamless scaling for high-traffic sites
-- Built-in analytics and monitoring
-
-## Development Workflow
-
-1. **Edit Content**: Use StoryKeep CMS at `/storykeep`
-2. **Customize Design**: Modify components in `src/custom/`
-3. **Add Features**: Create CodeHooks for dynamic functionality
-4. **Test Changes**: Hot reloading with `pnpm dev`
-5. **Deploy**: Automated builds handle production updates
+For more recipes and community guides, visit [FreeWebPress.org](https://FreeWebPress.org).
 
-## API Integration
-
-TractStack provides RESTful APIs for:
-
-- Content management
-- User analytics
-- Belief tracking (visitor preferences)
-- Multi-tenant operations
-- Media handling
+---
 
-## Uninstalling
+## Technical Scrutiny: Privacy & Continuity
 
-**For Production installations**, the uninstall script is located at `/home/t8k/scripts/`:
+- **Functional Persistence:** Uses `tractstack_session_id` for short-lived (24hr) functional continuity.
+- **Hybrid Restoration:** Uses a secure "fingerprint" token to reconstruct sessions in RAM if the server restarts, ensuring continuity without permanent tracking.
+- **Data Minimization:** Sensitive profile data (name, email) is stored in the user's browser `localStorage` rather than a centralized database by default.
 
-```bash
-sudo /home/t8k/scripts/t8k-uninstall.sh
-```
+---
 
-**For Quick install (development)**, the script is in:
+## Roadmap v4.0
 
-```bash
-sudo ~/t8k/src/tractstack-go/pkg/scripts/t8k-uninstall.sh
-```
+### Transcribe Integration
 
-## Support & Documentation
+Expanding full-text search to include embedded video transcripts (via BunnyCDN).
 
-- **Documentation**: <https://tractstack.org>
-- **GitHub Issues**: <https://github.com/AtRiskMedia/tractstack-go/issues>
-- **Email Support**: <hello@tractstack.com>
-- **Community**: Join discussions about adaptive web experiences
+- **AI Visual Editor:** Powered by AssemblyAI askLemur to highlight and extract transcript sections.
+- **Smart Content:** Automated chaptering and descriptions for long-form video.
+- **Video-to-Blog Pipeline:** Transform video highlights into rich, searchable blog pages using the design library.
 
-## License
+### Future Infrastructure
 
-The frontend Astro integration is available via the MIT license.
-The backend epistemic hypermedia server is available via the **O'Sassy Open Source License**
+- **HTMX 4.0 Migration:** Full alignment with the htmx 4.0 standard to ensure the platform remains at the cutting edge of hypermedia.
 
 ---
 
-TractStack v2.1
-_Made with ❤️ by [At Risk Media](https://atriskmedia.com)_
+**Documentation:** [tractstack.org](https://tractstack.org)  
+**Support:** [hello@tractstack.com](mailto:hello@tractstack.com)
+
+_TractStack v2.2 Made with ❤️ by At Risk Media_

package/bin/create-tractstack.js

@@ -332,7 +332,7 @@ PUBLIC_ENABLE_BUNNY="${finalResponses.enableBunny ? 'true' : 'false'}"
   try {
     // Install React and Node adapter
     execSync(
-      `${addCommand} react@^18.3.1 react-dom@^18.3.1 @astrojs/react@^4.0.0 @astrojs/node@^9.4.3`,
+      `${addCommand} react@^19.0.0 react-dom@^19.0.0 @astrojs/react@^4.4.2 @astrojs/node@^9.4.3`,
       { stdio: 'inherit' }
     );
     console.log(kleur.green('✅ React and Node adapter installed'));
@@ -348,7 +348,7 @@ PUBLIC_ENABLE_BUNNY="${finalResponses.enableBunny ? 'true' : 'false'}"
 
     // Install UI components
     execSync(
-      `${addCommand} @ark-ui/react@^5.26.0 @heroicons/react@^2.1.1 @internationalized/date@3.10.0`,
+      `${addCommand} @ark-ui/react@^5.30.0 @heroicons/react@^2.1.1 @internationalized/date@^3.10.1`,
       {
         stdio: 'inherit',
       }
@@ -365,12 +365,15 @@ PUBLIC_ENABLE_BUNNY="${finalResponses.enableBunny ? 'true' : 'false'}"
     console.log(kleur.green('✅ Visualization dependencies installed'));
 
     // Install additional dependencies
-    execSync(`${addCommand} path-to-regexp@^8.0.0`, { stdio: 'inherit' });
+    execSync(
+      `${addCommand} path-to-regexp@^8.0.0 postcss postcss-selector-parser`,
+      { stdio: 'inherit' }
+    );
     console.log(kleur.green('✅ Additional dependencies installed'));
 
     // Install dev dependencies
     execSync(
-      `${addCommand} -D @types/node@^22.18.0 @types/react@^18.3.11 @types/react-dom@^18.3.0 @types/d3@^7.4.3 @types/d3-sankey@^0.12.3 prettier@^3.3.3 prettier-plugin-astro@^0.14.1 prettier-plugin-tailwindcss@^0.6.8 typescript@^5.9.2 @types/tinycolor2@^1.4.6 @mhsdesign/jit-browser-tailwindcss@^0.4.2`,
+      `${addCommand} -D @types/node@^22.18.0 @types/react@^19.0.0 @types/react-dom@^19.0.0 @types/d3@^7.4.3 @types/d3-sankey@^0.12.3 prettier@^3.7.4 prettier-plugin-astro@^0.14.1 prettier-plugin-tailwindcss@^0.7.2 typescript@^5.9.3 @types/tinycolor2@^1.4.6 @mhsdesign/jit-browser-tailwindcss@^0.4.2`,
       { stdio: 'inherit' }
     );
     console.log(kleur.green('✅ Dev dependencies installed'));
@@ -379,12 +382,12 @@ PUBLIC_ENABLE_BUNNY="${finalResponses.enableBunny ? 'true' : 'false'}"
     console.log('Please run manually:');
     console.log(
       kleur.cyan(
-        `${addCommand} react@^18.3.1 react-dom@^18.3.1 @astrojs/react@^4.0.0 @astrojs/node@^9.4.3 @nanostores/react@^1.0.0 nanostores@^1.0.1 @nanostores/persistent ulid@^3.0.1 @ark-ui/react@^5.26.0 @heroicons/react@^2.1.1 @internationalized/date@3.10.0 d3@^7.9.0 d3-sankey@^0.12.3 recharts@^3.1.2 player.js@^0.1.0 tinycolor2@1.6.0 html-to-image@^1.11.13 path-to-regexp@^8.0.0`
+        `${addCommand} react@^19.0.0 react-dom@^19.0.0 @astrojs/react@^4.4.2 @astrojs/node@^9.4.3 @nanostores/react@^1.0.0 nanostores@^1.0.1 @nanostores/persistent ulid@^3.0.1 @ark-ui/react@^5.30.0 @heroicons/react@^2.1.1 @internationalized/date@^3.10.1 d3@^7.9.0 d3-sankey@^0.12.3 recharts@^3.1.2 player.js@^0.1.0 tinycolor2@1.6.0 html-to-image@^1.11.13 path-to-regexp@^8.0.0 postcss postcss-selector-parser`
       )
     );
     console.log(
       kleur.cyan(
-        `${addCommand} -D @types/node@^22.18.0 @types/react@^18.3.11 @types/react-dom@^18.3.0 @types/d3@^7.4.3 @types/d3-sankey@^0.12.3 prettier@^3.3.3 prettier-plugin-astro@^0.14.1 prettier-plugin-tailwindcss@^0.6.8 typescript@^5.9.2 @types/tinycolor2@^1.4.6 @mhsdesign/jit-browser-tailwindcss@^0.4.2`
+        `${addCommand} -D @types/node@^22.18.0 @types/react@^19.0.0 @types/react-dom@^19.0.0 @types/d3@^7.4.3 @types/d3-sankey@^0.12.3 prettier@^3.7.4 prettier-plugin-astro@^0.14.1 prettier-plugin-tailwindcss@^0.7.2 typescript@^5.9.3 @types/tinycolor2@^1.4.6 @mhsdesign/jit-browser-tailwindcss@^0.4.2`
       )
     );
     process.exit(1);