# 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

```bash
# 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:**

- [x] 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
```bash
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
```bash
npm run lint            # Check code style
npm run lint:fix        # Fix linting issues
```

### Database Operations
```bash
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