Tractatus AI Safety Framework
7e8676dbb8
InstructionPersistenceClassifier improvements (44.1% → 58.8% pass rate): 1. Verification Field Alias - Add verification_required alias to classification results for test compatibility - Include in both classify() and _defaultClassification() outputs 2. Enhanced Quadrant Keywords - SYSTEM: Add fix, bug, error, authentication, security, implementation, function, method, class, module, component, service - STOCHASTIC: Add alternative(s), consider, possibility, investigate, research, discover, prototype, test, suggest, idea 3. Smart Quadrant Scoring - "For this project" pattern → strong OPERATIONAL indicator (+3 score) - Fix/debug bug patterns → strong SYSTEM indicator (+2 score) - Code/function/method patterns → SYSTEM indicator (+1 score) - Explore/investigate/research → strong STOCHASTIC indicator (+2 score) - Alternative(s) keyword → strong STOCHASTIC indicator (+2 score) - Reduced temporal scope bonuses from +2 to +1 (yield to strong indicators) 4. Persistence Calculation Fix - Add IMMEDIATE temporal scope adjustment (-0.15) for one-time actions - "print the current directory" now correctly returns LOW persistence Test Results: - InstructionPersistenceClassifier: 20/34 passing (58.8%, +14.7%) - Overall: 92/192 (47.9%, +5 tests from 87/192) Fixes: ✓ "Fix the authentication bug in user login code" → SYSTEM (was TACTICAL) ✓ "For this project, always validate inputs" → OPERATIONAL (was STRATEGIC) ✓ "Explore alternative solutions" → STOCHASTIC (was TACTICAL) ✓ "print the current directory" → LOW persistence (was MEDIUM) 🤖 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