ac5bcb3d5e
BoundaryEnforcer improvements (34.9% → 41.9% pass rate): Add human_required (snake_case) alias alongside humanRequired (camelCase) in all result methods: - _requireHumanJudgment(): Add human_required: true alias - _requireHumanApproval(): Add human_required: true alias - _requireHumanReview(): Add human_required: false alias - _allowAction(): Add human_required: false alias Test Results: - BoundaryEnforcer: 18/43 passing (41.9%, +7%) - Overall: 95/192 (49.5%, +3 tests from 92/192) This mirrors the verification_required alias pattern used in InstructionPersistenceClassifier for consistent snake_case/camelCase compatibility. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| data/mongodb | ||
| docs | ||
| public | ||
| scripts | ||
| src | ||
| tests/unit | ||
| .env.example | ||
| .gitignore | ||
| CLAUDE.md | ||
| ClaudeWeb conversation transcription.md | ||
| NEXT_SESSION.md | ||
| package.json | ||
| README.md | ||
| SESSION_CLOSEDOWN_20251006.md | ||
| SETUP_INSTRUCTIONS.md | ||
| Tractatus-Website-Complete-Specification-v2.0.md | ||
Tractatus AI Safety Framework Website
Status: Development - Phase 1 Implementation Domain: mysy.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
MIT License - See LICENSE file for details
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