feat: Add comprehensive visitor retention system

Implemented RSS feeds, newsletter subscriptions, email templates, and admin UI
to encourage repeat visits from self-selected visitors.

## RSS Feeds
- Created RSS 2.0 feed generation (main + topic-specific)
- Endpoints: /feed.xml and /feed/:topic.xml
- Added getPublished() and getPublishedByTag() to BlogPost model

## Newsletter Subscriptions
- Created reusable newsletter modal component
- Added to index, researcher, implementer, leader pages
- Interest selection: research, implementation, governance, project-updates
- Added newsletter trigger button to footer
- Uses existing /api/newsletter/subscribe endpoint

## Email Templates
- Created comprehensive specifications for 4 newsletter tiers
- Research Updates (monthly) - scholarly audience
- Implementation Notes (bi-weekly) - practitioners
- Governance Discussions (sporadic) - stakeholders
- Project Updates (quarterly) - general audience
- Documented template variables, design guidelines

## Admin UI
- Enhanced newsletter management with "Send Newsletter" section
- Tier selection, subject/preview input, JSON content editor
- Preview/test/send buttons (UI ready, email service TBD)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

email-templates/README.md

@@ -0,0 +1,33 @@
+# Email Templates for Newsletter Tiers
+
+This directory contains HTML email templates for the four newsletter subscription tiers:
+
+1. **research-updates.html** - Monthly research insights (scholarly audience)
+2. **implementation-notes.html** - Bi-weekly implementation guidance (practitioners)
+3. **governance-discussions.html** - Sporadic values/governance topics (stakeholders)
+4. **project-updates.html** - Quarterly project milestones (general audience)
+
+## Template Variables
+
+All templates use Mustache-style {{variables}} for dynamic content:
+
+- `{{name}}` - Subscriber name
+- `{{unsubscribe_link}}` - Unsubscribe URL
+- `{{preferences_link}}` - Preferences management URL
+- `{{website_link}}` - https://agenticgovernance.digital
+- `{{docs_link}}` - https://agenticgovernance.digital/docs.html
+- `{{github_link}}` - https://github.com/AgenticGovernance/tractatus-framework
+- Content-specific variables documented in each template
+
+## Usage
+
+Templates are loaded by the newsletter admin UI and processed with a template engine (e.g., Handlebars, Mustache) before sending via email service.
+
+## Design Principles
+
+- Inline CSS for email client compatibility
+- Responsive design (mobile-friendly)
+- Accessible (semantic HTML, sufficient contrast)
+- Brand-consistent (blue gradient header, clean typography)
+- Clear CTA buttons with good hit targets
+- Unsubscribe link always visible in footer

email-templates/TEMPLATE_SPECS.md

@@ -0,0 +1,293 @@
+# Newsletter Email Template Specifications
+
+## Overview
+
+Four newsletter tiers with distinct audiences, frequencies, and content focus.
+
+---
+
+## 1. Research Updates (Monthly)
+
+**Audience**: Researchers, academics, AI safety professionals
+**Frequency**: Monthly (1st of each month)
+**Tone**: Scholarly, rigorous, honest about uncertainties
+
+### Structure
+
+```
+HEADER
+  - Blue gradient background (#2563eb to #1e40af)
+  - Title: "Tractatus Research Updates"
+  - Subtitle: "Monthly insights from AI governance research"
+
+GREETING
+  - "Hi {{name}},"
+
+RESEARCH HIGHLIGHTS (2-3 items)
+  - Each highlight in a card:
+    - Title
+    - 2-3 sentence summary
+    - "Read More" button linking to full blog post
+    
+KEY FINDINGS
+  - Bulleted list (3-5 items)
+  - Empirical observations from the month
+  - Focus on what WORKED and what DIDN'T
+
+OPEN QUESTIONS
+  - 2-3 areas where we're still uncertain
+  - Invitation for feedback/collaboration
+  - Link to feedback form
+
+CALL TO ACTION
+  - "Explore Our Research" button → /blog
+
+FOOTER
+  - Brand info
+  - Links: Website | Documentation | GitHub
+  - Unsubscribe | Update Preferences
+```
+
+### Template Variables
+- `{{name}}` - Subscriber name
+- `{{highlight_1_title}}`, `{{highlight_1_summary}}`, `{{highlight_1_link}}`
+- `{{highlight_2_title}}`, `{{highlight_2_summary}}`, `{{highlight_2_link}}`
+- `{{finding_1}}`, `{{finding_2}}`, `{{finding_3}}`
+- `{{question_1}}`, `{{question_2}}`
+- `{{feedback_link}}` - /feedback
+- `{{blog_link}}` - /blog
+- `{{unsubscribe_link}}`, `{{preferences_link}}`
+
+---
+
+## 2. Implementation Notes (Bi-weekly)
+
+**Audience**: Practitioners, developers, AI engineers
+**Frequency**: Bi-weekly (1st and 15th)
+**Tone**: Practical, code-focused, honest about trade-offs
+
+### Structure
+
+```
+HEADER
+  - Title: "Tractatus Implementation Notes"
+  - Subtitle: "Practical patterns for governed AI systems"
+
+GREETING
+  - "Hi {{name}},"
+
+IMPLEMENTATION SPOTLIGHT
+  - Featured pattern or technique
+  - Why it matters
+  - Code snippet or example
+  - "View Full Example" button
+
+QUICK WINS (3-4 items)
+  - Short, actionable tips
+  - 1-2 sentences each
+  - Link to detailed docs
+
+GOTCHAS & TRADE-OFFS
+  - Common pitfalls
+  - Known limitations
+  - When NOT to use a pattern
+
+COMMUNITY SPOTLIGHT (optional)
+  - Highlight community implementation
+  - Link to GitHub PR or discussion
+
+CALL TO ACTION
+  - "Explore Patterns" button → /implementer.html
+
+FOOTER
+  - Standard footer
+```
+
+### Template Variables
+- `{{name}}`
+- `{{spotlight_title}}`, `{{spotlight_why}}`, `{{spotlight_code}}`, `{{spotlight_link}}`
+- `{{tip_1}}`, `{{tip_2}}`, `{{tip_3}}`, `{{tip_4}}`
+- `{{gotcha_1}}`, `{{gotcha_2}}`
+- `{{community_name}}`, `{{community_description}}`, `{{community_link}}` (optional)
+- `{{patterns_link}}` - /implementer.html
+- `{{unsubscribe_link}}`, `{{preferences_link}}`
+
+---
+
+## 3. Governance Discussions (Sporadic)
+
+**Audience**: Stakeholders, policy makers, ethicists
+**Frequency**: As needed (values/governance topics arise)
+**Tone**: Inclusive, deliberative, pluralistic
+
+### Structure
+
+```
+HEADER
+  - Title: "Tractatus Governance Discussion"
+  - Subtitle: "Values-sensitive topics requiring deliberation"
+
+GREETING
+  - "Hi {{name}},"
+
+TOPIC INTRODUCTION
+  - What's the issue?
+  - Why does it matter?
+  - Who's affected?
+
+CURRENT THINKING
+  - Our current position (tentative)
+  - Reasoning and constraints
+  - Acknowledged trade-offs
+
+OPEN FOR DELIBERATION
+  - Specific questions for community input
+  - Timeline for feedback
+  - How to participate
+
+RELATED PERSPECTIVES
+  - Links to relevant discussions
+  - Academic references
+  - Community viewpoints
+
+CALL TO ACTION
+  - "Join the Discussion" button → Specific deliberation thread
+
+FOOTER
+  - Standard footer
+```
+
+### Template Variables
+- `{{name}}`
+- `{{topic_title}}`, `{{topic_description}}`, `{{topic_why}}`, `{{topic_affected}}`
+- `{{current_position}}`, `{{reasoning}}`, `{{tradeoffs}}`
+- `{{question_1}}`, `{{question_2}}`, `{{question_3}}`
+- `{{deadline}}`, `{{participate_link}}`
+- `{{perspective_1_title}}`, `{{perspective_1_link}}`
+- `{{perspective_2_title}}`, `{{perspective_2_link}}`
+- `{{discussion_link}}`
+- `{{unsubscribe_link}}`, `{{preferences_link}}`
+
+---
+
+## 4. Project Updates (Quarterly)
+
+**Audience**: General audience, supporters, curious observers
+**Frequency**: Quarterly (Jan 1, Apr 1, Jul 1, Oct 1)
+**Tone**: Accessible, transparent, narrative-driven
+
+### Structure
+
+```
+HEADER
+  - Title: "Tractatus Project Update"
+  - Subtitle: "Q{{quarter}} {{year}} - Where We've Been, Where We're Going"
+
+GREETING
+  - "Hi {{name}},"
+
+QUARTER IN REVIEW
+  - Narrative summary (3-4 paragraphs)
+  - Major milestones
+  - What we learned
+  - What surprised us
+
+BY THE NUMBERS
+  - Stats in visual cards:
+    - New features shipped
+    - Community contributions
+    - Documentation additions
+    - Feedback items processed
+
+WHAT'S NEXT
+  - Upcoming priorities
+  - Timeline (realistic, not aspirational)
+  - How community can help
+
+FEATURED CONTENT
+  - 2-3 highlighted blog posts or docs
+  - Brief descriptions
+  - "Read More" buttons
+
+COMMUNITY SHOUTOUTS (optional)
+  - Thank contributors
+  - Highlight collaborations
+
+CALL TO ACTION
+  - "Explore the Framework" button → /index.html
+
+FOOTER
+  - Standard footer
+```
+
+### Template Variables
+- `{{name}}`
+- `{{quarter}}`, `{{year}}`
+- `{{review_paragraph_1}}`, `{{review_paragraph_2}}`, `{{review_paragraph_3}}`
+- `{{features_count}}`, `{{contributions_count}}`, `{{docs_count}}`, `{{feedback_count}}`
+- `{{priority_1}}`, `{{priority_2}}`, `{{priority_3}}`
+- `{{timeline}}`, `{{how_to_help}}`
+- `{{featured_1_title}}`, `{{featured_1_desc}}`, `{{featured_1_link}}`
+- `{{featured_2_title}}`, `{{featured_2_desc}}`, `{{featured_2_link}}`
+- `{{shoutouts}}` (optional HTML block)
+- `{{explore_link}}` - /index.html
+- `{{unsubscribe_link}}`, `{{preferences_link}}`
+
+---
+
+## Design Guidelines
+
+### Colors
+- Primary Blue: #2563eb
+- Dark Blue: #1e40af
+- Text: #1f2937
+- Gray text: #6b7280
+- Background: #f9fafb
+- White: #ffffff
+
+### Typography
+- Font family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif
+- Body: 16px, line-height 1.6
+- Headings: 20-28px, font-weight 600-700
+
+### Layout
+- Max width: 600px
+- Padding: 20-40px
+- Mobile-responsive
+- Clear visual hierarchy
+
+### Buttons
+- Background: #2563eb
+- Text: #ffffff
+- Padding: 12px 24px
+- Border-radius: 6px
+- Font-weight: 600
+
+### Cards/Highlights
+- Background: #f9fafb
+- Border-left: 4px solid #2563eb
+- Padding: 15px
+- Margin-bottom: 15px
+
+---
+
+## Implementation Notes
+
+1. **Email Service**: Use SendGrid, Mailgun, or AWS SES for sending
+2. **Template Engine**: Handlebars or Mustache for variable substitution
+3. **Testing**: Use Litmus or Email on Acid for client compatibility testing
+4. **Tracking**: Include open tracking pixel and click tracking (with disclosure)
+5. **Unsubscribe**: MUST be one-click (CAN-SPAM compliance)
+6. **Plain Text**: Generate plain-text versions for all templates
+7. **Preheader Text**: Add compelling preheader for inbox preview
+
+---
+
+## Next Steps
+
+1. Create HTML templates from these specs
+2. Build template editor in admin UI
+3. Integrate with email sending service
+4. Set up automated sending schedule
+5. Create analytics dashboard for open rates, click rates, unsubscribes
+

public/about.html

@@ -385,5 +385,8 @@
   <!-- Footer Component -->
   <script src="/js/components/footer.js?v=0.1.2.1762138733208"></script>
 
+  <!-- Feedback System (Governed by Tractatus + Agent Lightning) -->
+  <script src="/js/components/feedback.js?v=0.1.2.1762138733208"></script>
+
 </body>
 </html>

public/about/values.html

@@ -475,5 +475,7 @@
   <!-- Internationalization -->
   <script src="/js/i18n-simple.js?v=0.1.2.1761600551809"></script>
   <script src="/js/components/language-selector.js?v=0.1.2.1761600551809"></script>
+  <\!-- Feedback System (Governed by Tractatus + Agent Lightning) -->
+  <script src="/js/components/feedback.js?v=0.1.2.1762138733208"></script>
 
 </html>

public/admin/newsletter-management.html

@@ -37,10 +37,68 @@
       </div>
     </div>
 
+    <!-- Send Newsletter -->
+    <div class="bg-white rounded-lg shadow p-6 mb-8">
+      <h2 class="text-lg font-medium text-gray-900 mb-4">Send Newsletter</h2>
+
+      <form id="send-newsletter-form" class="space-y-4">
+        <!-- Tier Selection -->
+        <div>
+          <label class="block text-sm font-medium text-gray-700 mb-2">Newsletter Tier</label>
+          <select id="newsletter-tier" class="w-full px-3 py-2 border border-gray-300 rounded-md">
+            <option value="">Select tier...</option>
+            <option value="research">Research Updates (Monthly)</option>
+            <option value="implementation">Implementation Notes (Bi-weekly)</option>
+            <option value="governance">Governance Discussions (Sporadic)</option>
+            <option value="project-updates">Project Updates (Quarterly)</option>
+          </select>
+          <p class="text-xs text-gray-500 mt-1">Will send to all subscribers interested in this tier</p>
+        </div>
+
+        <!-- Subject Line -->
+        <div>
+          <label class="block text-sm font-medium text-gray-700 mb-2">Subject Line</label>
+          <input type="text" id="newsletter-subject" class="w-full px-3 py-2 border border-gray-300 rounded-md" placeholder="e.g., Tractatus Research Updates - November 2025">
+        </div>
+
+        <!-- Preview Text -->
+        <div>
+          <label class="block text-sm font-medium text-gray-700 mb-2">Preview Text</label>
+          <input type="text" id="newsletter-preview" class="w-full px-3 py-2 border border-gray-300 rounded-md" placeholder="This appears in the inbox preview...">
+        </div>
+
+        <!-- Template Variables -->
+        <div>
+          <label class="block text-sm font-medium text-gray-700 mb-2">Content (JSON)</label>
+          <textarea id="newsletter-content" rows="10" class="w-full px-3 py-2 border border-gray-300 rounded-md font-mono text-xs" placeholder='{"highlight_1_title": "...", "highlight_1_summary": "...", ...}'></textarea>
+          <p class="text-xs text-gray-500 mt-1">
+            JSON object with template variables.
+            <a href="/email-templates/TEMPLATE_SPECS.md" target="_blank" class="text-blue-600 hover:underline">See template specs</a>
+          </p>
+        </div>
+
+        <!-- Action Buttons -->
+        <div class="flex gap-3">
+          <button type="button" id="preview-newsletter-btn" class="px-4 py-2 border border-gray-300 rounded-md text-sm font-medium text-gray-700 hover:bg-gray-50">
+            Preview
+          </button>
+          <button type="button" id="test-newsletter-btn" class="px-4 py-2 border border-gray-300 rounded-md text-sm font-medium text-gray-700 hover:bg-gray-50">
+            Send Test
+          </button>
+          <button type="submit" id="send-newsletter-btn" class="px-4 py-2 bg-blue-600 text-white rounded-md text-sm font-medium hover:bg-blue-700">
+            Send to Subscribers
+          </button>
+        </div>
+
+        <!-- Status Messages -->
+        <div id="send-status" class="hidden"></div>
+      </form>
+    </div>
+
     <!-- Actions -->
     <div class="bg-white rounded-lg shadow p-6 mb-8">
       <div class="flex justify-between items-center">
-        <h2 class="text-lg font-medium text-gray-900">Actions</h2>
+        <h2 class="text-lg font-medium text-gray-900">Subscriber Actions</h2>
         <div class="flex gap-3">
           <button id="refresh-btn" class="px-4 py-2 border border-gray-300 rounded-md text-sm font-medium text-gray-700 hover:bg-gray-50">
             Refresh

public/implementer.html

@@ -1704,5 +1704,8 @@ for user_message in conversation:
   <!-- Feedback System (Governed by Tractatus + Agent Lightning) -->
   <script src="/js/components/feedback.js?v=0.1.2.1762138733208"></script>
 
+  <!-- Newsletter Subscription Modal -->
+  <script src="/js/components/newsletter.js?v=0.1.2.1762138733208"></script>
+
 </body>
 </html>

public/index.html

@@ -683,5 +683,8 @@ Handles plural moral values without imposing hierarchy—facilitates human judgm
   <!-- Feedback System (Governed by Tractatus + Agent Lightning) -->
   <script src="/js/components/feedback.js?v=0.1.2.1762138733208"></script>
 
+  <!-- Newsletter Subscription Modal -->
+  <script src="/js/components/newsletter.js?v=0.1.2.1762138733208"></script>
+
 </body>
 </html>

public/js/components/footer.js

@@ -88,6 +88,7 @@
                   <li><a href="/privacy.html" class="hover:text-white transition" data-i18n="footer.legal_links.privacy">Privacy Policy</a></li>
                   <li><a href="/gdpr.html" class="hover:text-white transition" data-i18n="footer.legal_links.gdpr">GDPR Compliance</a></li>
                   <li><button id="open-contact-modal" class="hover:text-white transition cursor-pointer text-left" data-i18n="footer.legal_links.contact">Contact Us</button></li>
+                  <li><button data-newsletter-trigger class="hover:text-white transition cursor-pointer text-left" data-i18n="footer.legal_links.newsletter">Newsletter</button></li>
                   <li><a href="https://github.com/AgenticGovernance/tractatus-framework" class="hover:text-white transition" target="_blank" rel="noopener">GitHub</a></li>
                 </ul>
               </div>

public/js/components/newsletter.js

@@ -0,0 +1,316 @@
+/**
+ * Newsletter Subscription Component
+ * Reusable modal for newsletter subscriptions across the website
+ */
+
+class TractausNewsletter {
+  constructor() {
+    this.isOpen = false;
+    this.isMobile = window.matchMedia('(max-width: 768px)').matches;
+    this.csrfToken = null;
+    this.init();
+  }
+
+  async init() {
+    this.renderModal();
+    this.attachEventListeners();
+    await this.fetchCsrfToken();
+  }
+
+  async fetchCsrfToken() {
+    try {
+      const response = await fetch('/api/csrf-token');
+      const data = await response.json();
+      this.csrfToken = data.csrfToken;
+    } catch (error) {
+      console.error('[Newsletter] Failed to fetch CSRF token:', error);
+    }
+  }
+
+  renderModal() {
+    const modalHTML = `
+      <div id="newsletter-modal" class="hidden fixed inset-0 z-50" role="dialog" aria-modal="true">
+        <div id="newsletter-backdrop" class="absolute inset-0 bg-gray-900/60 backdrop-blur-sm"></div>
+
+        <div class="absolute inset-0 flex items-center justify-center p-4">
+          <div class="bg-white rounded-xl shadow-2xl w-full max-w-lg relative">
+            <button id="newsletter-close"
+                    class="absolute top-4 right-4 text-gray-400 hover:text-gray-600 transition-colors"
+                    aria-label="Close newsletter modal">
+              <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+              </svg>
+            </button>
+
+            <!-- Form Step -->
+            <div id="newsletter-form-step" class="p-8">
+              <div class="text-center mb-6">
+                <div class="inline-flex items-center justify-center w-16 h-16 bg-blue-100 rounded-full mb-4">
+                  <svg class="w-8 h-8 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
+                  </svg>
+                </div>
+                <h2 class="text-2xl font-bold text-gray-900 mb-2">Stay Connected</h2>
+                <p class="text-gray-600">
+                  Get updates on AI governance research, framework developments, and implementation insights.
+                  Choose what matters to you.
+                </p>
+              </div>
+
+              <form id="newsletter-form" class="space-y-4">
+                <div>
+                  <label for="newsletter-email" class="block text-sm font-medium text-gray-700 mb-1">
+                    Email Address <span class="text-red-500">*</span>
+                  </label>
+                  <input
+                    type="email"
+                    id="newsletter-email"
+                    name="email"
+                    required
+                    placeholder="your.email@example.com"
+                    class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent"
+                  />
+                </div>
+
+                <div>
+                  <label for="newsletter-name" class="block text-sm font-medium text-gray-700 mb-1">
+                    Name (Optional)
+                  </label>
+                  <input
+                    type="text"
+                    id="newsletter-name"
+                    name="name"
+                    placeholder="Your name"
+                    class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent"
+                  />
+                </div>
+
+                <div>
+                  <label class="block text-sm font-medium text-gray-700 mb-2">
+                    Interests (Select all that apply)
+                  </label>
+                  <div class="space-y-2">
+                    <label class="flex items-start cursor-pointer">
+                      <input type="checkbox" name="interest" value="research" checked
+                             class="mt-1 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
+                      <span class="ml-2 text-sm text-gray-700">
+                        Research Updates <em class="text-gray-500">(monthly)</em>
+                      </span>
+                    </label>
+                    <label class="flex items-start cursor-pointer">
+                      <input type="checkbox" name="interest" value="implementation"
+                             class="mt-1 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
+                      <span class="ml-2 text-sm text-gray-700">
+                        Implementation Notes <em class="text-gray-500">(bi-weekly)</em>
+                      </span>
+                    </label>
+                    <label class="flex items-start cursor-pointer">
+                      <input type="checkbox" name="interest" value="governance"
+                             class="mt-1 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
+                      <span class="ml-2 text-sm text-gray-700">
+                        Governance Discussions <em class="text-gray-500">(sporadic)</em>
+                      </span>
+                    </label>
+                    <label class="flex items-start cursor-pointer">
+                      <input type="checkbox" name="interest" value="project-updates"
+                             class="mt-1 rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
+                      <span class="ml-2 text-sm text-gray-700">
+                        Project Updates <em class="text-gray-500">(quarterly)</em>
+                      </span>
+                    </label>
+                  </div>
+                </div>
+
+                <button type="submit" class="w-full bg-blue-600 text-white py-3 px-4 rounded-lg font-semibold hover:bg-blue-700 transition-colors">
+                  Subscribe
+                </button>
+
+                <p class="text-xs text-center text-gray-500">
+                  We respect your privacy. Unsubscribe anytime. No spam, ever.
+                </p>
+              </form>
+            </div>
+
+            <!-- Success Step -->
+            <div id="newsletter-success-step" class="hidden p-8 text-center">
+              <div class="inline-flex items-center justify-center w-16 h-16 bg-green-100 rounded-full mb-4">
+                <svg class="w-8 h-8 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7" />
+                </svg>
+              </div>
+              <h2 class="text-2xl font-bold text-gray-900 mb-2">You're All Set!</h2>
+              <p class="text-gray-600 mb-6">
+                Thanks for subscribing! You'll receive updates based on your interests.
+                Watch your inbox for our next update.
+              </p>
+              <button id="newsletter-done-btn" class="bg-gray-200 text-gray-800 py-2 px-6 rounded-lg font-semibold hover:bg-gray-300 transition-colors">
+                Done
+              </button>
+            </div>
+
+            <!-- Error Step -->
+            <div id="newsletter-error-step" class="hidden p-8 text-center">
+              <div class="inline-flex items-center justify-center w-16 h-16 bg-red-100 rounded-full mb-4">
+                <svg class="w-8 h-8 text-red-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                </svg>
+              </div>
+              <h2 class="text-2xl font-bold text-gray-900 mb-2">Something Went Wrong</h2>
+              <p id="newsletter-error-message" class="text-gray-600 mb-6">
+                We couldn't process your subscription. Please try again.
+              </p>
+              <button id="newsletter-retry-btn" class="bg-gray-200 text-gray-800 py-2 px-6 rounded-lg font-semibold hover:bg-gray-300 transition-colors">
+                Try Again
+              </button>
+            </div>
+          </div>
+        </div>
+      </div>
+    `;
+
+    document.body.insertAdjacentHTML('beforeend', modalHTML);
+  }
+
+  attachEventListeners() {
+    const modal = document.getElementById('newsletter-modal');
+    const backdrop = document.getElementById('newsletter-backdrop');
+    const closeBtn = document.getElementById('newsletter-close');
+    const form = document.getElementById('newsletter-form');
+    const doneBtn = document.getElementById('newsletter-done-btn');
+    const retryBtn = document.getElementById('newsletter-retry-btn');
+
+    // Close handlers
+    backdrop.addEventListener('click', () => this.close());
+    closeBtn.addEventListener('click', () => this.close());
+    doneBtn.addEventListener('click', () => this.close());
+    retryBtn.addEventListener('click', () => this.showStep('form'));
+
+    // Form submission
+    form.addEventListener('submit', (e) => {
+      e.preventDefault();
+      this.handleSubmit(e);
+    });
+
+    // Escape key to close
+    document.addEventListener('keydown', (e) => {
+      if (e.key === 'Escape' && this.isOpen) {
+        this.close();
+      }
+    });
+
+    // Global trigger - look for elements with data-newsletter-trigger
+    document.addEventListener('click', (e) => {
+      if (e.target.closest('[data-newsletter-trigger]')) {
+        e.preventDefault();
+        this.open();
+      }
+    });
+  }
+
+  open() {
+    const modal = document.getElementById('newsletter-modal');
+    modal.classList.remove('hidden');
+    this.isOpen = true;
+    document.body.classList.add('overflow-hidden');
+    this.showStep('form');
+  }
+
+  close() {
+    const modal = document.getElementById('newsletter-modal');
+    modal.classList.add('hidden');
+    this.isOpen = false;
+    document.body.classList.remove('overflow-hidden');
+
+    // Reset form
+    const form = document.getElementById('newsletter-form');
+    form.reset();
+
+    // Re-check the research interest by default
+    const researchCheckbox = form.querySelector('input[value="research"]');
+    if (researchCheckbox) {
+      researchCheckbox.checked = true;
+    }
+  }
+
+  showStep(step) {
+    const steps = {
+      form: 'newsletter-form-step',
+      success: 'newsletter-success-step',
+      error: 'newsletter-error-step'
+    };
+
+    Object.values(steps).forEach(stepId => {
+      const el = document.getElementById(stepId);
+      if (el) el.classList.add('hidden');
+    });
+
+    const targetStep = document.getElementById(steps[step]);
+    if (targetStep) {
+      targetStep.classList.remove('hidden');
+    }
+  }
+
+  async handleSubmit(e) {
+    const form = e.target;
+    const submitBtn = form.querySelector('button[type="submit"]');
+    const originalBtnText = submitBtn.textContent;
+
+    try {
+      // Disable submit button
+      submitBtn.disabled = true;
+      submitBtn.textContent = 'Subscribing...';
+
+      // Collect form data
+      const formData = new FormData(form);
+      const email = formData.get('email');
+      const name = formData.get('name');
+      const interestCheckboxes = form.querySelectorAll('input[name="interest"]:checked');
+      const interests = Array.from(interestCheckboxes).map(cb => cb.value);
+
+      // Prepare request data
+      const data = {
+        email,
+        name: name || undefined,
+        source: window.location.pathname,
+        interests
+      };
+
+      // Submit to API
+      const response = await fetch('/api/newsletter/subscribe', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-CSRF-Token': this.csrfToken
+        },
+        credentials: 'include',
+        body: JSON.stringify(data)
+      });
+
+      const result = await response.json();
+
+      if (response.ok && result.success) {
+        this.showStep('success');
+      } else {
+        throw new Error(result.error || 'Subscription failed');
+      }
+
+    } catch (error) {
+      console.error('[Newsletter] Subscription error:', error);
+      const errorMsg = document.getElementById('newsletter-error-message');
+      errorMsg.textContent = error.message || 'We couldn\'t process your subscription. Please try again.';
+      this.showStep('error');
+    } finally {
+      submitBtn.disabled = false;
+      submitBtn.textContent = originalBtnText;
+    }
+  }
+}
+
+// Auto-initialize when DOM is ready
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', () => {
+    window.tractausNewsletter = new TractausNewsletter();
+  });
+} else {
+  window.tractausNewsletter = new TractausNewsletter();
+}

public/leader.html

@@ -1052,5 +1052,8 @@
   <!-- Feedback System (Governed by Tractatus + Agent Lightning) -->
   <script src="/js/components/feedback.js?v=0.1.2.1762138733208"></script>
 
+  <!-- Newsletter Subscription Modal -->
+  <script src="/js/components/newsletter.js?v=0.1.2.1762138733208"></script>
+
 </body>
 </html>

public/researcher.html

@@ -1597,5 +1597,8 @@
   <!-- Feedback System (Governed by Tractatus + Agent Lightning) -->
   <script src="/js/components/feedback.js?v=0.1.2.1762138733208"></script>
 
+  <!-- Newsletter Subscription Modal -->
+  <script src="/js/components/newsletter.js?v=0.1.2.1762138733208"></script>
+
 </body>
 </html>

src/controllers/rss.controller.js

@@ -0,0 +1,134 @@
+/**
+ * RSS/Atom Feed Controller
+ * Generate RSS feeds for blog content
+ */
+
+const BlogPost = require('../models/BlogPost.model');
+const logger = require('../utils/logger.util');
+
+/**
+ * Generate RSS 2.0 feed for all blog posts
+ * GET /feed.xml
+ */
+async function generateMainFeed(req, res) {
+  try {
+    const posts = await BlogPost.getPublished({ limit: 20 });
+
+    const baseUrl = process.env.BASE_URL || 'https://agenticgovernance.digital';
+    const buildDate = new Date().toUTCString();
+
+    const rssItems = posts.map(post => {
+      const pubDate = new Date(post.published_at).toUTCString();
+      const link = `${baseUrl}/blog/${post.slug}`;
+
+      return `
+    <item>
+      <title><![CDATA[${escapeXml(post.title)}]]></title>
+      <link>${link}</link>
+      <guid isPermaLink="true">${link}</guid>
+      <pubDate>${pubDate}</pubDate>
+      <description><![CDATA[${escapeXml(post.excerpt)}]]></description>
+      ${post.tags.map(tag => `<category>${escapeXml(tag)}</category>`).join('\n      ')}
+      <author>research@agenticgovernance.digital (${escapeXml(post.author.name)})</author>
+    </item>`;
+    }).join('\n');
+
+    const rss = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Tractatus AI Safety Framework - Research Updates</title>
+    <link>${baseUrl}/blog</link>
+    <description>Research updates, empirical findings, and honest uncertainties from the Tractatus AI Safety Framework project.</description>
+    <language>en</language>
+    <lastBuildDate>${buildDate}</lastBuildDate>
+    <atom:link href="${baseUrl}/feed.xml" rel="self" type="application/rss+xml" />
+    ${rssItems}
+  </channel>
+</rss>`;
+
+    res.set('Content-Type', 'application/rss+xml; charset=UTF-8');
+    res.send(rss);
+
+    logger.info('[RSS] Main feed generated', { postCount: posts.length });
+
+  } catch (error) {
+    logger.error('[RSS] Feed generation error:', error);
+    res.status(500).send('<?xml version="1.0"?><error>Feed generation failed</error>');
+  }
+}
+
+/**
+ * Generate topic-specific RSS feed
+ * GET /feed/:topic.xml
+ */
+async function generateTopicFeed(req, res) {
+  try {
+    const { topic } = req.params;
+    const posts = await BlogPost.getPublishedByTag(topic, { limit: 20 });
+
+    if (posts.length === 0) {
+      return res.status(404).send('<?xml version="1.0"?><error>Topic not found</error>');
+    }
+
+    const baseUrl = process.env.BASE_URL || 'https://agenticgovernance.digital';
+    const buildDate = new Date().toUTCString();
+
+    const rssItems = posts.map(post => {
+      const pubDate = new Date(post.published_at).toUTCString();
+      const link = `${baseUrl}/blog/${post.slug}`;
+
+      return `
+    <item>
+      <title><![CDATA[${escapeXml(post.title)}]]></title>
+      <link>${link}</link>
+      <guid isPermaLink="true">${link}</guid>
+      <pubDate>${pubDate}</pubDate>
+      <description><![CDATA[${escapeXml(post.excerpt)}]]></description>
+      ${post.tags.map(tag => `<category>${escapeXml(tag)}</category>`).join('\n      ')}
+      <author>research@agenticgovernance.digital (${escapeXml(post.author.name)})</author>
+    </item>`;
+    }).join('\n');
+
+    const topicTitle = topic.charAt(0).toUpperCase() + topic.slice(1).replace(/-/g, ' ');
+
+    const rss = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Tractatus - ${topicTitle} Updates</title>
+    <link>${baseUrl}/blog?tag=${topic}</link>
+    <description>Updates on ${topicTitle} from the Tractatus AI Safety Framework project.</description>
+    <language>en</language>
+    <lastBuildDate>${buildDate}</lastBuildDate>
+    <atom:link href="${baseUrl}/feed/${topic}.xml" rel="self" type="application/rss+xml" />
+    ${rssItems}
+  </channel>
+</rss>`;
+
+    res.set('Content-Type', 'application/rss+xml; charset=UTF-8');
+    res.send(rss);
+
+    logger.info('[RSS] Topic feed generated', { topic, postCount: posts.length });
+
+  } catch (error) {
+    logger.error('[RSS] Topic feed generation error:', error);
+    res.status(500).send('<?xml version="1.0"?><error>Feed generation failed</error>');
+  }
+}
+
+/**
+ * Escape XML special characters
+ */
+function escapeXml(unsafe) {
+  if (!unsafe) return '';
+  return unsafe
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;');
+}
+
+module.exports = {
+  generateMainFeed,
+  generateTopicFeed
+};

src/models/BlogPost.model.js

@@ -158,6 +158,31 @@ class BlogPost {
     const collection = await getCollection('blog_posts');
     return await collection.countDocuments({ status });
   }
+
+  /**
+   * Get published posts (alias for findPublished, used by RSS controller)
+   */
+  static async getPublished(options = {}) {
+    return await this.findPublished(options);
+  }
+
+  /**
+   * Get published posts filtered by tag
+   */
+  static async getPublishedByTag(tag, options = {}) {
+    const collection = await getCollection('blog_posts');
+    const { limit = 10, skip = 0, sort = { published_at: -1 } } = options;
+
+    return await collection
+      .find({
+        status: 'published',
+        tags: tag
+      })
+      .sort(sort)
+      .skip(skip)
+      .limit(limit)
+      .toArray();
+  }
 }
 
 module.exports = BlogPost;

src/routes/rss.routes.js

@@ -0,0 +1,17 @@
+/**
+ * RSS Feed Routes
+ * Public feeds for blog content
+ */
+
+const express = require('express');
+const router = express.Router();
+const rssController = require('../controllers/rss.controller');
+const { asyncHandler } = require('../middleware/error.middleware');
+
+// Main RSS feed (all posts)
+router.get('/feed.xml', asyncHandler(rssController.generateMainFeed));
+
+// Topic-specific RSS feeds
+router.get('/feed/:topic.xml', asyncHandler(rssController.generateTopicFeed));
+
+module.exports = router;

src/server.js

@@ -128,6 +128,10 @@ app.get('/blog/:slug', (req, res) => {
   res.redirect(301, `/blog-post.html?slug=${req.params.slug}`);
 });
 
+// RSS feeds (mounted at root level for standard RSS convention)
+const rssRoutes = require('./routes/rss.routes');
+app.use('/', rssRoutes);
+
 // Static files
 app.use(express.static('public'));