Commit graph

88 commits

Author SHA1 Message Date
TheFlow
5e981db9d7 chore: bump cache version for deployment 2026-03-14 18:22:11 +13:00
TheFlow
b655c8f568 chore: bump cache version for deployment 2026-03-14 17:58:08 +13:00
TheFlow
fdee84044a chore: bump cache version for deployment 2026-03-13 20:50:13 +13:00
TheFlow
d1950d3a4d chore: bump cache version for deployment 2026-03-13 15:21:07 +13:00
TheFlow
8ecb0505f5 feat: rewrite architecture.html — Guardian Agents, defence in depth, i18n refresh
- Rewrite architecture.html from 1112 to 481 lines
- Add Guardian Agents section (4-phase verification, philosophical foundations)
- Add defence in depth narrative (3 layers with honest limitations)
- Compress five principles (remove examples, keep descriptions)
- Remove redundant sections (Six Core Services grid, Interactive SVG,
  Data Visualizations, Two Implementations, Applied to Training)
- Add Guardian Agents Philosophy paper to research-papers-modal.js
- Retranslate all locales (de, fr, mi) via DeepL with brand preservation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 15:21:01 +13:00
TheFlow
55c1838836 chore: bump cache version for deployment 2026-03-13 14:01:01 +13:00
TheFlow
c1d5016381 chore: bump cache version for deployment 2026-03-13 13:58:03 +13:00
TheFlow
2c14c91c16 chore: bump cache version for deployment 2026-03-13 13:18:51 +13:00
TheFlow
871ea0df27 chore: bump cache version for deployment 2026-02-27 13:42:34 +13:00
TheFlow
302bf516f3 chore: bump cache version for deployment 2026-02-24 10:29:57 +13:00
TheFlow
0893e4979d chore: bump cache version for deployment 2026-02-23 22:10:36 +13:00
TheFlow
2238547344 refactor: Rename "Home AI" → "Village AI" across entire codebase
- 57 files modified, 5 files renamed (home-ai → village-ai)
- HTML pages: all user-facing text, data-i18n attributes, anchor IDs, CSS classes
- i18n JSON: keys (home_ai → village_ai) and values across en/de/fr/mi
- Locale files renamed: home-ai.json → village-ai.json (4 languages)
- Main page renamed: home-ai.html → village-ai.html
- Research downloads: translated terms updated (French "IA domestique",
  Māori "AI ā-whare"/"AI kāinga" → "Village AI" per brand name rule)
- JavaScript: navbar component, blog post scripts
- Markdown: research timeline, steering vectors paper, taonga paper

Aligns with community codebase rename (commit 21ab7bc0).
"Village" is a brand name — stays untranslated in all languages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 22:09:44 +13:00
TheFlow
8323cca70a chore: bump cache version for deployment 2026-02-23 07:43:29 +13:00
TheFlow
6d8de05849 chore: bump cache version for deployment 2026-02-11 14:49:48 +13:00
TheFlow
d3e1cbc777 chore: bump cache version for deployment 2026-02-11 11:34:27 +13:00
TheFlow
25efeddd5b chore: bump cache version for deployment 2026-02-11 10:14:07 +13:00
TheFlow
d045b23641 chore: bump cache version for deployment 2026-02-11 08:07:44 +13:00
TheFlow
0c2c2e463d feat: Audit & update all audience pages with current research and metrics
- Add i18n data-i18n attributes to navbar.js (~30 elements) and expand
  all 4 common.json files with navbar translation keys (EN/DE/FR/MI)
- Replace broken HuggingFace Space links with local audit analytics
  dashboard across 4 HTML files; update counts to 171,800+
- Add Steering Vectors, Taonga Governance, and Home AI sections to
  researcher.html, leader.html, and implementer.html
- Update stale metrics: development period (11+ months), sessions
  (1,000+), instructions (68), model references (Opus 4.6)
- Update roadmap Multi-LLM status to reflect Home AI as first non-Claude
  deployment; add Sovereign Training Pipeline and Taonga Registry items
- Update all EN/DE/FR translation files with new section keys

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 08:07:26 +13:00
TheFlow
4a13e04aef fix: Improve WCAG AA contrast ratios across all public pages
Apply the same contrast fixes from the homepage audit to 10 additional
pages. All changes are one shade darker within the same hue family:

- text-teal-600 → text-teal-700 (4.08:1 → 5.31:1)
- text-emerald-600 → text-emerald-700 (4.52:1 → 5.94:1)
- text-gray-500 → text-gray-600 on gray backgrounds (3.77:1 → 5.27:1)

Files: architecture, village-case-study, implementer, leader, timeline,
api-reference, koha, koha/transparency, gdpr, agent-lightning

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 06:52:18 +13:00
TheFlow
ef281ee846 chore: bump cache version for deployment 2026-02-11 06:11:57 +13:00
TheFlow
551c7e9a05 chore: bump cache version for deployment 2026-02-09 18:26:34 +13:00
TheFlow
f04eb5b75d chore: bump cache version for deployment 2026-02-09 18:11:27 +13:00
TheFlow
c97b21b69c chore: bump cache version for deployment 2026-02-09 18:07:06 +13:00
TheFlow
fd3d935415 chore: bump cache version for deployment 2026-02-09 17:58:33 +13:00
TheFlow
2bf206ed43 chore: bump cache version for deployment 2026-02-09 17:55:14 +13:00
TheFlow
61c1ff2e53 chore: bump cache version for deployment 2026-02-09 16:56:42 +13:00
TheFlow
dd1d83a6b8 chore: bump cache version for deployment 2026-02-09 16:33:48 +13:00
TheFlow
b3946fc006 chore: bump cache version for deployment 2026-02-09 16:21:55 +13:00
TheFlow
d7bf3aa551 chore: bump cache version for deployment 2026-02-09 16:17:18 +13:00
TheFlow
3ad1a5b953 feat: Replace binary comparison with defence-in-depth 3-layer model
The old section presented behavioral training as all-bad and structural
enforcement as all-good, which is intellectually dishonest given our
planned SLL with BoundaryEnforcer in the training loop. Replaced with
three stacked layer cards (training, architecture, human oversight),
each showing strengths, known limitations, and status. Added insight
blockquote and "Measured, Not Assumed" metrics grid with 6 commitments.
Updated hero text for narrative consistency. All i18n in EN/DE/FR.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:54:31 +13:00
TheFlow
8e7c70cbb7 fix: Improve architecture.html accessibility and performance
- Fix low-contrast orange-600 bg + white text to orange-700 (3.58:1 → 5.18:1)
- Convert social-preview hero image from PNG to WebP (2,647 KiB → 147 KiB, 94% savings)
- Add explicit width/height to hero image to prevent CLS
- Use <picture> element with WebP source and PNG fallback

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:30:15 +13:00
TheFlow
609396d87e chore: bump cache version for deployment 2026-02-07 21:24:35 +13:00
TheFlow
45e74fd5d5 chore: bump cache version for deployment 2026-02-07 20:58:13 +13:00
TheFlow
7c0e705194 chore: bump cache version for deployment 2026-02-07 16:56:48 +13:00
TheFlow
82ee807fbd chore: bump cache version for deployment 2026-02-07 16:10:34 +13:00
TheFlow
ddabc83da8 feat: Add dual-layer Tractatus architecture section and fix Koha contrast
- Add prominent "Dual-Layer Tractatus Architecture" section to home-ai.html
  explaining Layer A (inherent/trained-in) and Layer B (active/runtime)
- Fix Koha paragraph contrast: text-blue-800 on bg-blue-50 had insufficient
  contrast (~3.8:1). Changed to text-gray-800/text-gray-900 for WCAG AA compliance
- Include prior session changes: architecture.html updates, homepage redesign

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 15:37:33 +13:00
TheFlow
df8c6ccb03 fix: Remove absolute assurance language per inst_017 across codebase
Replace "ensures", "guarantee", "foolproof", "world-class" and similar
absolute terms with evidence-based language throughout public pages, JS
components, and FAQ content. Changes apply inst_017 (no absolute
assurance terms) consistently.

Replacements:
- "ensures X" → "validates X", "so that X", "supports X", "maintains X"
- "guarantee" → removed or rephrased with qualified language
- "foolproof" → "infallible"
- "architecturally impossible" → "architecture prevents without
  explicit override flags"

Preserved: published research papers (architectural-alignment*.html),
EU AI Act quotes, Te Tiriti treaty language, and FAQ meta-commentary
that deliberately critiques this language (lines 2842-2896).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 14:44:45 +13:00
TheFlow
074906608d feat: Complete site audit and UI/UX redesign for agenticgovernance.digital
Homepage redesign with coherent story arc: Problem → Philosophy →
Architecture → Production Evidence → Audience Paths → Papers → Timeline.
Add Koha (donations) section prominently after Honesty Note for optimal
placement. Add Philosophical Foundations PDF download link.

New pages: timeline.html (research evolution Oct 2025–Feb 2026),
home-ai.html (SLL sovereign AI story). Blog seed script with two
initial posts.

Global navigation: consistent desktop nav with Research, Architecture,
and About dropdowns across all pages. Blog/FAQ removed from nav until
populated.

Page refinements: remove emoji from headings across architecture,
leader, implementer, researcher pages. Fix FAQ dead links → counter-
arguments. Add no-JS fallback to docs.html. Fix CSP inline style
violations in village-case-study.html (hero and CTA sections converted
from inline styles to Tailwind/CSS classes). Add Home AI cross-reference
to village case study.

Note: philosophical-foundations-village-project.pdf must be deployed
separately to public/downloads/ (gitignored directory).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 12:44:53 +13:00
TheFlow
6811605477 feat: Add Kōrero HTML page, remove umami analytics
- Create korero-counter-arguments.html (STO-INN-0004) with styled critique cards
- Remove umami-tracker.js and all references from HTML files
- Update privacy.html Section 6 to reflect "No Analytics" policy

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 11:43:29 +13:00
TheFlow
72b6a5af3f fix: Replace Tailwind color classes with inline styles for visibility
- Homepage Village section: all text now uses inline style="#000000"
- Village case study hero: title, subtitle, disclaimer use inline styles
- Village case study CTA buttons: inline styles for guaranteed visibility
- Service worker bumped to 0.2.0 for cache busting
- version.json forceUpdate: true to force browser refresh

Fixes white text on white background issue when Tailwind CSS fails to load.
Inline styles intentionally bypass CSP for critical visibility fallback.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-09 16:42:24 +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
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
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
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
TheFlow
e727cde947 chore: bump cache version for deployment 2025-10-29 15:03:01 +13:00
TheFlow
d32be2c673 feat(api): implement research inquiry endpoint and Umami analytics
HIGH PRIORITY: Fixes production 404 error on research inquiry form

Research Inquiry API:
- Add POST /api/research-inquiry endpoint for form submissions
- Add admin endpoints for inquiry management (list, get, assign, respond, delete)
- Create ResearchInquiry model with MongoDB integration
- Add to moderation queue for human review (strategic quadrant)
- Include rate limiting (5 req/min) and CSRF protection
- Tested locally: endpoint responding, data saving to DB

Umami Analytics (Privacy-First):
- Add Docker Compose config for Umami + PostgreSQL
- Create nginx reverse proxy config with SSL support
- Implement privacy-first tracking script (DNT, opt-out, no cookies)
- Integrate tracking across 26 public HTML pages
- Exclude admin pages from tracking (privacy boundary)
- Add comprehensive deployment guide (UMAMI_SETUP_GUIDE.md)
- Environment variables added to .env.example

Files Created (9):
- src/models/ResearchInquiry.model.js
- src/controllers/research.controller.js
- src/routes/research.routes.js
- public/js/components/umami-tracker.js
- deployment-quickstart/nginx-analytics.conf
- deployment-quickstart/UMAMI_SETUP_GUIDE.md
- scripts/add-umami-tracking.sh
- scripts/add-tracking-python.py
- SESSION_SUMMARY_ANALYTICS_RESEARCH_INQUIRY.md

Files Modified (29):
- src/routes/index.js (research routes)
- deployment-quickstart/docker-compose.yml (umami services)
- deployment-quickstart/.env.example (umami config)
- 26 public HTML pages (tracking script)

Values Alignment:
 Privacy-First Design (cookie-free, DNT honored, opt-out available)
 Human Agency (research inquiries require human review)
 Data Sovereignty (self-hosted analytics, no third-party sharing)
 GDPR Compliance (no personal data in analytics)
 Transparency (open-source tools, documented setup)

Testing Status:
 Research inquiry: Locally tested, data verified in MongoDB
 Umami analytics: Pending production deployment

Next Steps:
1. Deploy to production (./scripts/deploy.sh)
2. Test research form on live site
3. Deploy Umami following UMAMI_SETUP_GUIDE.md
4. Update umami-tracker.js with website ID after setup

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-29 01:31:02 +13:00
TheFlow
b7a76017dc fix(architecture): inline SVG and complete i18n for interactive diagram
- Replaced <object> element with inline SVG to fix contentDocument NULL issues
- Simplified interactive-diagram.js to work with inline SVG directly
- Added diagram_services translations loading from window.i18nTranslations
- Exposed window.i18nTranslations in i18n-simple.js for global access
- Added event listeners for i18nInitialized and languageChanged
- Diagram modals now fully translate across EN/DE/FR languages
- Removed complex retry/race condition logic from SVG loading
- Converted SVG style attributes to presentation attributes (CSP compliant)

Fixes: Interactive diagram was broken due to contentDocument being NULL
when accessing SVG via <object> element. Inline SVG approach is more
reliable and works immediately without race conditions.
2025-10-26 13:45:39 +13:00
TheFlow
5643050eb6 fix(i18n): complete architecture page translations and fix diagram modals
- Added data-i18n to service card descriptions (validator, pressure, metacognitive, deliberation)
- Fixed interactive-diagram.js to properly load translations from i18n system
- Added language change handlers for dynamic modal updates
- All service cards and modals now fully translate across EN/DE/FR
2025-10-26 13:20:56 +13:00
TheFlow
5cd8e235f4 fix(architecture): add defer attribute to interactive-diagram.js for proper loading 2025-10-26 12:19:38 +13:00