4445b0e8d0
- Create comprehensive project structure (29 directories) - Add CLAUDE.md with project context and conventions - Add package.json with dependencies and scripts - Add .gitignore and .env.example - Add README.md with project overview - Configure ports: MongoDB 27017, Application 9000 - Establish Tractatus governance framework baseline - Document Te Tiriti approach and indigenous perspective - Set up infrastructure for Phase 1 implementation Project Status: Development - Phase 1 Foundation Complete Next: MongoDB instance setup and systemd service configuration
203 lines
5.2 KiB
Markdown
203 lines
5.2 KiB
Markdown
# 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
|