759a37fbeb
- Add copyright headers to 5 core service files: - BoundaryEnforcer.service.js - ContextPressureMonitor.service.js - CrossReferenceValidator.service.js - InstructionPersistenceClassifier.service.js - MetacognitiveVerifier.service.js - Create NOTICE file per Apache License 2.0 requirements This strengthens copyright protection and makes enforcement easier. Git history provides proof of authorship. No registration required for copyright protection, but headers make ownership explicit. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| data/mongodb | ||
| docs | ||
| governance | ||
| public | ||
| scripts | ||
| src | ||
| tests | ||
| .env.example | ||
| .gitignore | ||
| CLAUDE.md | ||
| ClaudeWeb conversation transcription.md | ||
| LICENSE | ||
| NEXT_SESSION.md | ||
| NOTICE | ||
| package.json | ||
| README.md | ||
| SESSION_CLOSEDOWN_20251006.md | ||
| SETUP_INSTRUCTIONS.md | ||
| tailwind.config.js | ||
| Tractatus-Website-Complete-Specification-v2.0.md | ||
Tractatus AI Safety Framework Website
Status: Development - Phase 1 Implementation Domain: agenticgovernance.digital Project Start: 2025-10-06
Overview
A world-class platform demonstrating the Tractatus-Based LLM Safety Framework through three audience paths (Researcher, Implementer, Advocate), AI-powered features with human oversight, and interactive demonstrations.
Key Innovation: The website implements the Tractatus framework to govern its own AI operations (dogfooding).
Project Structure
tractatus/
├── docs/ # Source markdown & governance documents
├── public/ # Frontend assets (CSS, JS, images)
├── src/ # Backend code (Express, MongoDB)
│ ├── routes/ # API route handlers
│ ├── controllers/ # Business logic
│ ├── models/ # MongoDB models
│ ├── middleware/ # Express middleware
│ │ └── tractatus/ # Framework enforcement
│ ├── services/ # Core services (AI, governance)
│ └── utils/ # Utility functions
├── scripts/ # Setup & migration scripts
├── tests/ # Test suites (unit, integration, security)
├── data/ # MongoDB data directory
└── logs/ # Application & MongoDB logs
Quick Start
Prerequisites
- Node.js 18+
- MongoDB 7+
- Git
Installation
# Clone repository (once GitHub account is set up)
cd /home/theflow/projects/tractatus
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env
# Edit .env with your configuration
# Initialize database
npm run init:db
# Migrate documents
npm run migrate:docs
# Create admin user
npm run seed:admin
# Start development server
npm run dev
The application will be available at http://localhost:9000
Technical Stack
- Backend: Node.js, Express, MongoDB
- Frontend: Vanilla JavaScript, Tailwind CSS
- Authentication: JWT
- AI Integration: Claude API (Sonnet 4.5) - Phase 2+
- Testing: Jest, Supertest
Infrastructure
- MongoDB Port: 27017
- Application Port: 9000
- Database: tractatus_dev
- Systemd Service: mongodb-tractatus.service, tractatus.service
Phase 1 Deliverables (3-4 Months)
Must-Have for Complete Prototype:
- Infrastructure setup
- Document migration pipeline
- Three audience paths (Researcher/Implementer/Advocate)
- Tractatus governance services (Classifier, Validator, Boundary Enforcer)
- AI-curated blog with human oversight
- Media inquiry triage system
- Case study submission portal
- Resource directory
- Interactive demonstrations (classification, 27027, boundary enforcement)
- Human oversight dashboard
- Comprehensive testing suite
Development Workflow
Running Tests
npm test # All tests with coverage
npm run test:unit # Unit tests only
npm run test:integration # Integration tests
npm run test:security # Security tests
npm run test:watch # Watch mode
Code Quality
npm run lint # Check code style
npm run lint:fix # Fix linting issues
Database Operations
npm run init:db # Initialize database & indexes
npm run migrate:docs # Import markdown documents
npm run generate:pdfs # Generate PDF downloads
Governance
This project adheres to the Tractatus framework principles:
- Sovereignty & Self-determination: No tracking, user control, open source
- Transparency & Honesty: Public moderation queue, AI reasoning visible
- Harmlessness & Protection: Privacy-first design, security audits
- Community & Accessibility: WCAG compliance, three audience paths
All AI actions are governed by:
- InstructionPersistenceClassifier
- CrossReferenceValidator
- BoundaryEnforcer
- ContextPressureMonitor
- MetacognitiveVerifier
Human Approval Required
All major decisions require human approval:
- Architectural changes
- Database schema modifications
- Security implementations
- Third-party integrations
- Values-sensitive content
- Cost-incurring services
See: CLAUDE.md for complete project context and conventions
Te Tiriti & Indigenous Perspective
This project acknowledges Te Tiriti o Waitangi and indigenous leadership in digital sovereignty. Implementation follows documented indigenous data sovereignty principles (CARE Principles) with respect and without tokenism.
No premature engagement: We will not approach Māori organizations until we have something valuable to offer post-launch.
Links & Resources
- Project Context:
CLAUDE.md - Specification:
Tractatus-Website-Complete-Specification-v2.0.md - Framework Documentation:
/home/theflow/projects/sydigital/stochastic/innovation-exploration/ - Governance References:
/home/theflow/projects/sydigital/strategic/
License
Apache License 2.0 - See LICENSE file for details.
The Tractatus Framework is licensed under the Apache License 2.0, which provides:
- Patent protection for users
- Clear contribution terms
- Permissive use (commercial, modification, distribution)
- Compatibility with most other open source licenses
Contact
Project Owner: John Stroh Email: john.stroh.nz@pm.me Repository: GitHub (primary) + Codeberg/Gitea (mirrors)
Last Updated: 2025-10-06 Next Milestone: Complete MongoDB setup and systemd service