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:

1. InstructionPersistenceClassifier
2. CrossReferenceValidator
3. BoundaryEnforcer
4. ContextPressureMonitor
5. 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