Commit graph

8 commits

Author SHA1 Message Date
TheFlow
7cd10978f6 docs: regenerate PDFs and update documentation metadata
- Regenerated all PDF downloads with updated timestamps
- Updated markdown metadata across documentation
- Fixed ContextPressureMonitor test for conversation length tracking
- Documentation consistency improvements

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-14 10:53:48 +13:00
TheFlow
9d336e4ee5 docs: fix GitHub URLs and navigation links in foundational documents
- Fixed GitHub repository URLs (anthropics org, not AgenticGovernance)
- Updated navigation links to use specific document URLs instead of generic /docs.html
- Added instruction persistence system explanation to introduction
- Regenerated PDFs with corrections
2025-10-12 20:40:08 +13:00
TheFlow
4de439a325 docs: update framework to 6 services with PluralisticDeliberationOrchestrator
- Updated all core documentation (introduction, core-concepts, implementation guides)
- Added comprehensive PluralisticDeliberationOrchestrator sections
- Fixed implementation-guide-v1.1.md (BlogCuration → PluralisticDeliberationOrchestrator)
- Updated UI pages (index, researcher, leader) to reflect 6 services
- Enhanced cache busting with unified version script
- FAQ already includes comprehensive value pluralism coverage (Q18-22)

Framework now correctly documents all 6 mandatory services:
1. InstructionPersistenceClassifier
2. CrossReferenceValidator
3. BoundaryEnforcer
4. ContextPressureMonitor
5. MetacognitiveVerifier
6. PluralisticDeliberationOrchestrator (added October 2025)

🤖 Generated with Claude Code
2025-10-12 19:55:44 +13:00
TheFlow
d814e09762 docs: update markdown documentation for value pluralism
- Update glossary (v1.1) with value pluralism terminology
- Update case studies with value pluralism examples
- Update core concepts to include foundational pluralism
- Update introduction with 6th core service
- Update technical architecture and comparison matrix
- Update implementation guide with value pluralism sections

All markdown reflects 6-service production architecture

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-12 16:37:37 +13:00
TheFlow
e583774824 feat: comprehensive documentation improvements and GitHub integration
- Add professional README for public repository with code examples
- Fix all broken documentation links across 4 markdown files
- Add favicon to all HTML pages (eliminates 404 errors)
- Redesign Experience section with 4-card incident grid
- Add GitHub section to docs.html sidebar with repository links
- Migrate 4 new case studies to database (19 total documents)
- Generate 26 PDFs for public download
- Add automated sync GitHub Action for public repository
- Add security validation for public documentation sync
- Update docs-app.js to categorize research topics

Mobile responsive, accessibility compliant, production ready.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-09 14:33:14 +13:00
TheFlow
d95dc4663c feat(infra): semantic versioning and systemd service implementation
**Cache-Busting Improvements:**
- Switched from timestamp-based to semantic versioning (v1.0.2)
- Updated all HTML files: index.html, docs.html, leader.html
- CSS: tailwind.css?v=1.0.2
- JS: navbar.js, document-cards.js, docs-app.js v1.0.2
- Professional versioning approach for production stability

**systemd Service Implementation:**
- Created tractatus-dev.service for development environment
- Created tractatus-prod.service for production environment
- Added install-systemd.sh script for easy deployment
- Security hardening: NoNewPrivileges, PrivateTmp, ProtectSystem
- Resource limits: 1GB dev, 2GB prod memory limits
- Proper logging integration with journalctl
- Automatic restart on failure (RestartSec=10)

**Why systemd over pm2:**
1. Native Linux integration, no additional dependencies
2. Better OS-level security controls (ProtectSystem, ProtectHome)
3. Superior logging with journalctl integration
4. Standard across Linux distributions
5. More robust process management for production

**Usage:**
  # Development:
  sudo ./scripts/install-systemd.sh dev

  # Production:
  sudo ./scripts/install-systemd.sh prod

  # View logs:
  sudo journalctl -u tractatus -f

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-09 09:16:22 +13:00
TheFlow
19473fdbb6 docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital
This commit completes Phase 2 preparation with comprehensive kickoff materials
and migrates all domain references from mysy.digital to agenticgovernance.digital.

New Phase 2 Documents:
- PHASE-2-PRESENTATION.md: 20-slide stakeholder presentation deck
- PHASE-2-EMAIL-TEMPLATES.md: Invitation templates for 20-50 soft launch users
- PHASE-2-KICKOFF-CHECKLIST.md: Comprehensive 12-week deployment checklist (200+ tasks)
- PHASE-2-PREPARATION-ADVISORY.md: Advisory on achieving world-class UI/UX

Domain Migration (mysy.digital → agenticgovernance.digital):
- Updated CLAUDE.md project instructions
- Updated README.md
- Updated all Phase 2 planning documents (ROADMAP, COST-ESTIMATES, INFRASTRUCTURE)
- Updated governance policies (TRA-OPS-0002, TRA-OPS-0003)
- Updated framework documentation (introduction.md)
- Updated implementation progress report

Phase 2 Status:
 Budget approved: $550 USD for 3 months, $100-150/month ongoing
 Timeline confirmed: Starting NOW
 All 5 TRA-OPS-* governance policies approved
 Infrastructure decisions finalized (OVHCloud VPS Essential)
 Domain registered: agenticgovernance.digital

Ready to Begin:
- Week 1: Infrastructure deployment (VPS, DNS, SSL)
- Week 5-8: AI features (Claude API, blog, media, case studies)
- Week 9-12: Testing, governance audit, soft launch (20-50 users)

Next Steps:
1. Provision OVHCloud VPS Essential (Singapore/Australia)
2. Configure DNS for agenticgovernance.digital
3. Generate secrets (JWT, MongoDB passwords)
4. Draft 3-5 initial blog posts (human-written)
5. Begin Week 1 infrastructure deployment

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-07 13:17:42 +13:00
TheFlow
c03bd68ab2 feat: complete Option A & B - infrastructure validation and content foundation
Phase 1 development progress: Core infrastructure validated, documentation created,
and basic frontend functionality implemented.

## Option A: Core Infrastructure Validation 

### Security
- Generated cryptographically secure JWT_SECRET (128 chars)
- Updated .env configuration (NOT committed to repo)

### Integration Tests
- Created comprehensive API test suites:
  - api.documents.test.js - Full CRUD operations
  - api.auth.test.js - Authentication flow
  - api.admin.test.js - Role-based access control
  - api.health.test.js - Infrastructure validation
- Tests verify: authentication, document management, admin controls, health checks

### Infrastructure Verification
- Server starts successfully on port 9000
- MongoDB connected on port 27017 (11→12 documents)
- All routes functional and tested
- Governance services load correctly on startup

## Option B: Content Foundation 

### Framework Documentation Created (12,600+ words)
- **introduction.md** - Overview, core problem, Tractatus solution (2,600 words)
- **core-concepts.md** - Deep dive into all 5 services (5,800 words)
- **case-studies.md** - Real-world failures & prevention (4,200 words)
- **implementation-guide.md** - Integration patterns, code examples (4,000 words)

### Content Migration
- 4 framework docs migrated to MongoDB (1 new, 3 existing)
- Total: 12 documents in database
- Markdown → HTML conversion working
- Table of contents extracted automatically

### API Validation
- GET /api/documents - Returns all documents 
- GET /api/documents/:slug - Retrieves by slug 
- Search functionality ready
- Content properly formatted

## Frontend Foundation 

### JavaScript Components
- **api.js** - RESTful API client with Documents & Auth modules
- **router.js** - Client-side routing with pattern matching
- **document-viewer.js** - Full-featured doc viewer with TOC, loading states

### User Interface
- **docs-viewer.html** - Complete documentation viewer page
- Sidebar navigation with all documents
- Responsive layout with Tailwind CSS
- Proper prose styling for markdown content

## Testing & Validation

- All governance unit tests: 192/192 passing (100%) 
- Server health check: passing 
- Document API endpoints: verified 
- Frontend serving: confirmed 

## Current State

**Database**: 12 documents (8 Anthropic submission + 4 Tractatus framework)
**Server**: Running, all routes operational, governance active
**Frontend**: HTML + JavaScript components ready
**Documentation**: Comprehensive framework coverage

## What's Production-Ready

 Backend API & authentication
 Database models & storage
 Document retrieval system
 Governance framework (100% tested)
 Core documentation (12,600+ words)
 Basic frontend functionality

## What Still Needs Work

⚠️ Interactive demos (classification, 27027, boundary)
⚠️ Additional documentation (API reference, technical spec)
⚠️ Integration test fixes (some auth tests failing)
 Admin dashboard UI
 Three audience path routing implementation

---

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-07 11:52:38 +13:00