Commit graph

527 commits

Author SHA1 Message Date
TheFlow
983033eb17 chore: bump cache version for deployment 2025-11-04 15:39:51 +13:00
TheFlow
1821a20cdb chore: bump cache version for deployment 2025-11-04 15:22:57 +13:00
TheFlow
8701499b3d chore: bump cache version for deployment 2025-11-04 15:11:36 +13:00
TheFlow
33d3937e45 chore: bump cache version for deployment 2025-11-04 11:37:39 +13:00
TheFlow
973be3e61d feat: Implement newsletter email sending functionality (Phase 3)
Complete implementation of newsletter sending system with SendGrid integration:

Backend Implementation:
- EmailService class with template rendering (Handlebars)
- sendNewsletter() method with subscriber iteration
- Preview and send controller methods
- Admin routes with CSRF protection and authentication
- findByInterest() method in NewsletterSubscription model

Frontend Implementation:
- Newsletter send form with validation
- Preview functionality (opens in new window)
- Test send to single email
- Production send to all tier subscribers
- Real-time status updates

Dependencies:
- handlebars (template engine)
- @sendgrid/mail (email delivery)
- html-to-text (plain text generation)

Security:
- Admin-only routes with authentication
- CSRF protection on all POST endpoints
- Input validation and sanitization
- Confirmation dialogs for production sends

Next steps: Configure SendGrid API key in environment variables

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 11:32:39 +13:00
TheFlow
1c768a19e4 chore: bump cache version for deployment 2025-11-04 11:17:11 +13:00
TheFlow
7d635bf3dc feat: Add Phase 2 newsletter enhancements and email templates
Phase 2 Implementation:
- Add RSS feed discovery links to footer (Subscribe section)
- Create email templates (base-template.html, research-updates-content.html)
- Add comprehensive newsletter sending implementation plan
- Fix CSP check to exclude email-templates directory

Email templates use inline styles for cross-client compatibility
(Gmail, Outlook, Apple Mail) and are excluded from CSP checks.

Next steps: Install dependencies (handlebars, @sendgrid/mail),
implement EmailService, controller methods, and admin UI.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 11:13:15 +13:00
TheFlow
3649986e30 chore: bump cache version for deployment 2025-11-04 10:48:00 +13:00
TheFlow
4408b694f9 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>
2025-11-04 10:42:43 +13:00
TheFlow
ea2d94b3fc fix: update GitHub link to correct public repository
Changed from non-existent tractatus-framework/tractatus-framework (404)
to correct public repository AgenticGovernance/tractatus-framework (200 OK).

Fixes broken GitHub link on Agent Lightning integration page.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 07:40:24 +13:00
TheFlow
8db17ff6c0 Revert "fix: correct GitHub repository URL"
This reverts commit a7cd9f5a41.
2025-11-04 07:10:47 +13:00
TheFlow
a7cd9f5a41 fix: correct GitHub repository URL
Changed from non-existent tractatus-framework/tractatus-framework
to actual repository AgenticGovernance/tractatus.

Fixes 404 error on GitHub link.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 07:08:27 +13:00
TheFlow
94661a2153 fix: make research email button visible and exclude venv from deployment
Changes:
1. Button visibility: Changed from white/transparent to solid white with black text
   - Makes research@agenticgovernance.digital email clearly visible
2. Deployment optimization: Exclude demos/**/venv/ from rsync
   - Prevents deploying massive Python library directories

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 07:00:28 +13:00
TheFlow
77da431299 feat: Update Agent Lightning status to operational with CPU baseline
Updates Agent Lightning integration documentation to reflect operational status:
- Status changed from "Preliminary findings (small-scale)" to "Operational (CPU baseline established)"
- Integration date updated to November 2025
- All translations updated (EN/DE/FR)
- Real LLM integration implemented with Mistral-7B (4-bit quantized)
- CPU stress testing validated with 1300%+ CPU utilization
- Documented CPU performance bottleneck and GPU migration plan

Technical changes:
- Modified stress_test_vllm.py to use transformers library instead of vLLM API
- Implemented 4-bit quantization (BitsAndBytes) to fit model in available RAM
- Added CPU_BASELINE_FINDINGS.md documenting operational metrics
- Validated governance architecture under RL optimization

Research integrity maintained: Clear distinction between validated claims
(operational CPU baseline) and future work (GPU acceleration, scale testing).

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 06:07:00 +13:00
TheFlow
789618d67f feat: Add real Agent Lightning integration with CPU stress testing
This commit adds a complete Agent Lightning integration using actual
AL 0.2.2 library with validated CPU stress testing baseline.

## Changes

### Integration Implementation (al-integration/)
- Real feedback analyzer agent with @agl.rollout decorator
- Event emission (agl.emit_message, emit_reward, emit_exception)
- Reward function based on categorization accuracy
- Training infrastructure (CPU-ready, GPU-ready architecture)
- Stress test suite with 100% pass rate (4/4 tests)

### Documentation
- IMPLEMENTATION_SUMMARY.md: Comprehensive integration docs
- README.md: Real implementation guide
- STRESS_TEST_REPORT.md: Validated CPU baseline metrics
- UPDATE_PLAN.md: Documentation update strategy

### Testing
- stress_test.py: CPU baseline validation suite
- stress_test_vllm.py: Enhanced concurrent load testing (10/50/100 workers)
- Validated: 100% category accuracy, perfect reward consistency

### Frontend
- public/integrations/agent-lightning.html: Integration status page
- Translation files: EN/DE locales updated

### Configuration
- .gitignore: Exclude models/ (28GB Mistral-7B), venv/, demos/*/venv/
- al-integration/.gitignore: Python-specific exclusions

## Validation

CPU Stress Test Results (November 3, 2025):
- Test Pass Rate: 4/4 (100%)
- Category Accuracy: 100% (6/6 correct)
- Reward Consistency: Perfect (std dev = 0)
- Error Handling: 100% (4/4 scenarios)
- Analysis Time: <0.01ms (architecture validated)
- Memory Usage: <0.01MB (minimal overhead)

## Research Integrity

All claims validated:
- Real AL 0.2.2 integration (actual library, not mock)
- Operational CPU MVP (tested and working)
- GPU-ready architecture (awaits ROCm + MS-S1 Max)
- Validated performance metrics (100% test pass rate)

Terminology compliance:
- Replaced "production-ready" with "operational"/"validated"
- Removed absolute assurance terms
- Added [NEEDS VERIFICATION] to unvalidated projections

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 21:57:47 +13:00
TheFlow
41ea0d2a7c fix: standardize Agent Lightning Discord invite link
Updated all pages to use consistent AL Discord invite (bVZtkceKsS):
- implementer.html: 2QH69Rtd → bVZtkceKsS
- leader.html: 2QH69Rtd → bVZtkceKsS
- index.html: 2QH69Rtd → bVZtkceKsS

All pages now use:
- Tractatus: https://discord.gg/Dkke2ADu4E
- Agent Lightning: https://discord.gg/bVZtkceKsS

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 16:25:31 +13:00
TheFlow
4b4be5cb0b fix: correct GitHub link and replace broken collaboration button
Fixed issues on Agent Lightning integration page:
- Changed GitHub link from non-existent tractatus-ai/agent-lightning-integration
  to existing tractatus-framework/tractatus-framework repo
- Replaced unresponsive "Contact for Collaboration" button with email display
  (research@agenticgovernance.digital)
- Removed broken click handler script that ran before feedback component loaded

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 16:16:03 +13:00
TheFlow
8f2bfc08fd chore: bump cache version for deployment 2025-11-03 15:58:53 +13:00
TheFlow
6d251ca08a feat: add i18n support for Agent Lightning page and navbar feedback
Added comprehensive internationalization:
- German and French translations via DeepL API
- Language-responsive Agent Lightning integration page
- Navbar feedback button now translates (DE: "Feedback geben", FR: "Donner son avis")
- Translation files: agent-lightning-integration.json (EN/DE/FR)
- Data-i18n attributes on all major headings and CTA buttons
- i18n scripts loaded on Agent Lightning page

Translation coverage:
- Hero section
- All major section headings
- Call-to-action buttons
- Navbar feedback menu item

Files modified:
- public/integrations/agent-lightning.html (i18n scripts + data-i18n attributes)
- public/js/components/navbar.js (data-i18n for feedback button)
- public/js/i18n-simple.js (page map entry)
- public/locales/*/agent-lightning-integration.json (translations)
- public/locales/*/common.json (navbar.feedback translations)
- scripts/translate-agent-lightning.js (translation automation)
- docs/reports/FRAMEWORK_PERFORMANCE_REPORT_2025-11-03.md (framework stats)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 15:58:12 +13:00
TheFlow
71689bbe97 fix: feedback button visibility using inline styles
Root cause: Tailwind arbitrary value z-[9999] was not in compiled CSS
(tailwind.css last modified Oct 9, feedback.js modified Nov 3).

Solution: Use inline styles with !important for all critical properties:
- position: fixed
- bottom/right positioning
- z-index: 999999
- display: flex
- visibility: visible
- opacity: 1

This bypasses Tailwind compilation issues and ensures button is visible.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 15:39:23 +13:00
TheFlow
edac97951d chore: bump cache version for deployment 2025-11-03 15:38:54 +13:00
TheFlow
6f05c58269 chore: bump cache version for deployment 2025-11-03 15:16:46 +13:00
TheFlow
b8df972619 feat: Add Agent Lightning integration to navigation and homepage
- Add Agent Lightning link to navbar menu (visible on all pages)
- Add prominent "What's New" banner on homepage highlighting AL integration
- Link to AL Discord and integration page
- Improve discoverability of AL integration for visitors

Related to Phase 2 Master Plan completion

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 15:12:29 +13:00
TheFlow
b92eab85ff fix: feedback button visibility and Agent Lightning page issues
Feedback Button (z-index issue):
- Increased z-index from 40 to 9999 with !important
- Button was rendering but hidden behind other elements
- Added inline style as backup for z-index

Agent Lightning Page:
- Fixed text visibility: changed gray-300 to white on dark background
- Fixed broken download link: changed to GitHub repo link
- Fixed collaboration button: now triggers feedback FAB correctly
- Removed duplicate closing script tag

All issues resolved and deployed

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 15:04:00 +13:00
TheFlow
531284d75a fix: render feedback button immediately without waiting for CSRF
- Changed init() to render FAB/modal before fetching CSRF token
- CSRF fetch now runs in parallel (non-blocking)
- Prevents button from never appearing if CSRF fetch fails/is slow
- Fixed cache version in agent-lightning.html to match deployment

Fixes issue where feedback button was invisible on all pages

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 14:52:37 +13:00
TheFlow
63dc3b356d chore: bump cache version for deployment 2025-11-03 14:38:30 +13:00
TheFlow
2a727a80b8 feat: Complete Phase 2 Agent Lightning website integration
- Added Agent Lightning research section to researcher.html with Demo 2 results
- Created comprehensive /integrations/agent-lightning.html page
- Added Agent Lightning link in homepage hero section
- Updated Discord invite links (Tractatus + semantipy) across all pages
- Added feedback.js script to all key pages for live demonstration

Phase 2 of Master Plan complete: Discord setup → Website completion

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 14:38:20 +13:00
TheFlow
0ba9213e7c chore: bump cache version for deployment 2025-11-03 13:22:13 +13:00
TheFlow
49d12e3063 chore: bump cache version for deployment 2025-11-03 13:21:40 +13:00
TheFlow
eef84d678d fix: FORCE cache invalidation - complete Phase 2 deployment
CRITICAL COMPLETE FIX:
- Service worker: 0.1.4
- version.json: 0.1.4
- ALL HTML files: Updated to cache version 0.1.2.1762128274267
- Service worker registration: ?v=0.1.4 cache-buster

This WILL force all clients to reload immediately.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 13:05:15 +13:00
TheFlow
06049bc2bf fix: add cache-busting to service worker registration
CRITICAL FIX: Forces browsers to fetch new service worker

- Add ?v=0.1.4 query parameter to service worker registration
- Browsers will now immediately fetch updated SW file
- Ensures Phase 2 content visible to ALL users immediately
- Fixes persistent caching issue

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 13:03:41 +13:00
TheFlow
9838efb593 fix: force cache invalidation - bump to v0.1.4
CRITICAL: Force all clients to dump old cached content

- Increment service worker CACHE_VERSION from 0.1.3 to 0.1.4
- Update version.json to 0.1.4
- Forces immediate cache invalidation for all users
- Ensures Phase 2 content (Agent Lightning, Discord) visible immediately

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 13:02:29 +13:00
TheFlow
59cb5b40e1 chore: update version.json changelog for Phase 2 launch
- Updated buildDate to Nov 3, 2025
- Updated changelog to reflect Agent Lightning integration
- Documents Discord community launch
- Documents new feedback system

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 12:57:16 +13:00
TheFlow
cd94f3b0ae chore: bump cache version for deployment 2025-11-03 12:53:25 +13:00
TheFlow
72404725ae feat: Add feedback button to navbar
- Adds 'Give Feedback' button to mobile navigation menu
- Integrates with feedback modal system
- Part of governed feedback system (Tractatus + AL)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 12:53:14 +13:00
TheFlow
925b28498d feat: Complete Phase 2 - Agent Lightning integration and Discord community launch
## Website Updates
- **Homepage** (index.html):
  - Updated hero subtitle to mention Agent Lightning integration
  - Added " Now with AL" badges to all pathway cards
  - Removed Audit Logs from hero (moved to researcher page)
  - Added comprehensive community section with both Discord servers

- **Researcher Page** (researcher.html:619-786):
  - Added Agent Lightning integration section
  - 5 open research questions
  - Demo 2 validation status with limitations
  - Both Discord community links

- **Implementer Page** (implementer.html:1324-1341):
  - Added Discord invite buttons to AL CTA section

- **Leader Page** (leader.html:424-441):
  - Added Discord invite buttons to AL CTA section

- **New Integration Page** (integrations/agent-lightning.html):
  - Standalone AL integration guide
  - Overview and community links

## Feedback System (Governed AI Communication)
- Backend: Feedback model, controller, routes, governance service
- Frontend: FAB, modal UI, navbar integration
- Three governance pathways: Autonomous, Deliberation, Human Mandatory

## Discord Communities
- Tractatus Discord: https://discord.gg/Dkke2ADu4E
- Agent Lightning Discord: https://discord.gg/bVZtkceKsS

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 12:52:26 +13:00
TheFlow
40488a3d7c fix: handle undefined technicalLevel in cards and set glossary category
- Added null check for section.technicalLevel (defaults to 'basic')
- Prevents "Cannot read properties of undefined (reading 'charAt')" error
- Updated fix-glossary-structure.js to set category: 'getting-started'
- Moves glossary back to Getting Started section where it belongs

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 11:41:18 +13:00
TheFlow
da76300aa8 fix: add direct PDF download links for all three glossary languages
- Added (PDF) links next to each glossary entry in implementer Resources
- English: /downloads/glossary.pdf
- German: /downloads/glossary-de.pdf
- French: /downloads/glossary-fr.pdf
- Links open in new tab with target="_blank"

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 11:19:51 +13:00
TheFlow
e208b1cea3 fix: remove undefined showTranslationFallbackNotice function call
- Removed call to showTranslationFallbackNotice(language) which was undefined
- Console warning already logs the fallback behavior
- Prevents ReferenceError when loading translated documents
- Related to glossary translation fallback handling

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 11:11:38 +13:00
TheFlow
8c09943659 feat: add glossary translations to implementer page resources
- Added glossary links (EN/DE/FR) to implementer.html Resources section
- Added translation keys to all three locale files
- Links to /docs.html?doc=glossary with language parameter
- Addresses overdue task: Add German & French Translations to Implementer Page

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 10:47:39 +13:00
TheFlow
b2e1c47d7a fix: replace gradient backgrounds with solid orange for HF buttons
Changed all Hugging Face buttons from bg-gradient-to-r (which wasn't
rendering) to solid bg-orange-600 for proper visibility. The gradient
classes were showing as white-on-white.

Affected pages:
- index.html: Hero section HF CTA
- researcher.html: Collaboration section HF link
- architecture.html: Interactive exploration section HF button

Now using bg-orange-600 hover:bg-orange-700 for consistent, visible styling.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 09:05:20 +13:00
TheFlow
80c7946deb feat: integrate Hugging Face Space links across website
- researcher.html: Add HF Space link in collaboration section and resources
- index.html: Add HF Space CTA button in hero section
- architecture.html: Add "See It In Action" interactive exploration section

All links point to https://huggingface.co/spaces/tractatus-framework/audit-log-viewer
with proper styling (HF brand colors), external link icons, and i18n support.

Implements P0 recommendations from HF exposure optimization report.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 08:57:13 +13:00
TheFlow
819b557ec1 feat(i18n): add Hugging Face Space references in EN/DE/FR translations
- Add HF Space link translations for researcher page collaboration section
- Add HF Space resource translations for researcher page resources section
- Add HF Space CTA translation for homepage hero section
- Add interactive exploration section translations for architecture page

All translations provided in English, German, and French.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 08:57:04 +13:00
TheFlow
51a9f3ca7f docs: comprehensive social media and HF Space maintenance guide
Created detailed documentation for future Claude Code instances to maintain:
- Reddit presence (u/tractatus-framework, r/AI_Agents engagement)
- Facebook presence (Agentic Governance NZ page)
- Hugging Face Space (audit-log-viewer deployment)
- Deep Interlock coordination tracking implementation

New files:
- docs/outreach/SOCIAL-MEDIA-AND-HF-MAINTENANCE.md (full guide)
- docs/outreach/QUICK-REFERENCE-SOCIAL-MEDIA.md (quick commands)
- docs/outreach/HUGGINGFACE-PRESENCE-PLAN.md (initial setup plan)
- scripts/export-hf-audit-data.js (HF data export script)
- public/images/tractatus-reddit-avatar*.png (Reddit branding)

Key features documented:
- Weekly HF Space update procedure
- Daily Reddit engagement strategy
- Coordination tracking troubleshooting
- Performance metrics and goals
- Complete troubleshooting guide

All procedures include copy-paste commands for easy maintenance.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 08:09:01 +13:00
TheFlow
9b3ac9e864 feat(social): add Open Graph and Twitter Card metadata + hero graphic
Added social media preview support to improve shareability on Facebook,
Twitter, LinkedIn, and other platforms.

Changes:
- Added social preview image (1200x630px blueprint graphic)
- Implemented Open Graph metadata (og:title, og:description, og:image, etc.)
- Implemented Twitter Card metadata (twitter:card, twitter:image, etc.)
- Added Facebook page reference (og:see_also)
- Integrated hero graphic into architecture.html (visual anchor)

Pages updated:
- index.html
- architecture.html
- values.html
- docs.html
- researcher.html
- implementer.html
- leader.html

Social metadata includes:
- Page-specific titles and descriptions
- 1200x630px social preview image
- Proper image dimensions for optimal rendering
- Facebook page link: https://www.facebook.com/agenticgovernance

Fixes: Facebook "Link unavailable" error when sharing site URLs
Impact: Improves content discoverability and shareability (Community value)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 11:12:48 +13:00
TheFlow
5275fad5a6 chore: bump cache version for deployment 2025-10-31 01:25:48 +13:00
TheFlow
21276f2be2 chore: bump cache version to 0.1.4 for i18n updates
Updated service worker cache version from 0.1.3 to 0.1.4 to ensure
browsers clear cache and fetch updated architectural_principles
translations in values.json files.

Note: /locales/ is in NEVER_CACHE_PATHS, so translations are always
fresh, but bumping version ensures service worker update triggers.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 01:21:51 +13:00
TheFlow
6f78d2a7ef fix(i18n): add architectural_principles translations to values.json (EN/DE/FR)
Added complete architectural_principles section to all three language files:
- English (en/values.json): baseline translations
- German (de/values.json): complete German translations
- French (fr/values.json): complete French translations

Fixes rendering issue on values.html where raw i18n keys were displaying
instead of translated content.

Section includes:
- Five Alexander principles (Deep Interlock, Structure-Preserving, Gradients,
  Living Process, Not-Separateness)
- Each with title, description, and connection to core values
- Monitoring note about October 2025 integration
- TOC entry for navigation

Technical terms preserved in English across all translations per i18n guidelines.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 01:20:01 +13:00
TheFlow
e86d4771ad feat(i18n): add DE/FR translations for architecture.html Alexander principles
Added complete German and French translations for the Five Architectural
Principles section added in previous commit.

Changes:
- Updated hero section (badge, title, subtitle, CTAs) in all 3 languages
- Added full "principles" section with all 5 principles × 6 fields each
  - Not-Separateness (Governance in Critical Path)
  - Deep Interlock (Services Reinforce Each Other)
  - Gradients Not Binary (Nuanced Responses)
  - Structure-Preserving (Audit Continuity)
  - Living Process (Evidence-Based Evolution)
- Added "How They Work Together" interlocking pattern (6 fields)
- Added services.subtitle connecting services to principles

Translation consistency:
- German: Maintained translations from homepage.json (Tiefe Verriegelung,
  Not-Separatheit, etc.)
- French: Maintained translations from homepage.json (Interlock profond,
  Non-séparation, etc.)
- Technical terms preserved in English per translation guidelines
  (BoundaryEnforcer, PreToolUse Hook, inst_064, 27027 Incident)

Files changed:
- public/locales/en/architecture.json: +54 keys (hero + principles + services.subtitle)
- public/locales/de/architecture.json: +54 keys (complete German translations)
- public/locales/fr/architecture.json: +54 keys (complete French translations)

Testing: All 3 language JSON files verified serving correctly via curl/jq

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 00:56:56 +13:00
TheFlow
2edefad2cc feat(architecture): restructure page around 5 Alexander principles + framework fixes
Major Changes:
- Restructured architecture.html to lead with Five Architectural Principles
- Added comprehensive 158-line principles section (Not-Separateness, Deep Interlock,
  Gradients, Structure-Preserving, Living Process)
- Updated hero section: "Five Architectural Principles for AI Safety"
- Added principle cross-references to Six Services section
- Created i18n documentation for ~50 new translation keys

Framework Improvements (Structure-Preserving):
- Fixed PreToolUse hook to return 'ask' for boundary crossings requiring human judgment
  (was incorrectly auto-denying, now properly escalates via Claude Code permission system)
- Fixed CSP validator to only flag NEW violations introduced by edits, not pre-existing ones
  (prevents false positives while maintaining security enforcement)

Content Alignment:
- Messaging anchors: "woven into architecture", "critical execution path", "architecturally
  impossible to bypass", "evidence-based evolution"
- Cultural DNA compliant (inst_085-089): grounded examples (27027 Incident, inst_064),
  evidence-based, anti-consultant, candid about limitations
- Real operational examples: MetacognitiveVerifier selective mode, framework fade detection

Files Changed:
- public/architecture.html: +165 lines (hero + principles section + services intro)
- .claude/hooks/framework-audit-hook.js: Fixed boundary enforcement escalation logic
- scripts/hook-validators/validate-file-edit.js: Improved CSP violation detection
- docs/i18n/ARCHITECTURE_PAGE_I18N_KEYS.md: Translation documentation (new)

Implementation follows SESSION-SUMMARY-2025-10-30-COMPLETE.md action plan (lines 89,
196-237). Structure-preserving transformation: existing content retained, new principles
section adds coherence without breaking existing architecture diagrams or services.

Next Steps: German/French i18n translations needed (~50 keys, 2-3 hours per language)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-31 00:43:43 +13:00