tractatus/NEW_SESSION_PROMPT.md

# New Session Startup Prompt

**For use with Claude Code - October 2025**

---

## Recommended Startup Prompt

```
I'm starting a NEW session on the Tractatus Framework project.

Current state:
- Local development server needs restart: npm start (port 9000)
- MongoDB tractatus_dev running on port 27017
- Recent work: Completed multilingual implementation with simplified icons-only language selector
- Repository status: 15 commits ahead of origin/main (MUST PUSH)
- All framework tests passing (238/238)

MANDATORY tasks:
1. Run session-init.js (will block if not done)
2. Push 15 commits to remote repository (git push origin main)
3. Audit status against /home/theflow/projects/tractatus/docs/plans/integrated-implementation-roadmap-2025.md
4. Update roadmap progress based on completed work
5. Identify next priority tasks from roadmap

Please review session handoff: SESSION_HANDOFF_2025-10-17_LANGUAGE_SELECTOR.md

Confirm framework initialization and proceed with mandatory tasks.
```

---

## Alternative Prompt (If Specific Task Known)

```
I'm starting a NEW session on the Tractatus Framework project.

Task: [DESCRIBE YOUR TASK HERE]

Project state:
- Recent completion: Multilingual implementation (icons-only language selector)
- Repository: 15 commits ahead of origin/main
- Framework components: All operational
- Handoff available: SESSION_HANDOFF_2025-10-17_LANGUAGE_SELECTOR.md

Please run session-init.js and then proceed with the task.
```

---

## Key Context for New Session

### Recent Major Changes
1. **Language Selector Simplified** (Oct 17, 2025)
   - Removed dropdown interface
   - Unified to icons-only across all devices
   - Added Māori flag with "Planned" state
   - File: `public/js/components/language-selector.js`

2. **Multilingual Support Complete** (Oct 2025)
   - 7 pages with data-i18n attributes
   - English translations complete
   - German/French translations need professional review
   - Cache-busting version: `?v=0.1.0.1760643941`

3. **Framework Enforcement Architecture** (Oct 15, 2025)
   - Hook validators operational
   - Pre-action checks enforcing governance
   - CSP compliance monitored automatically
   - Session-init.js blocks without local server

### Repository State
- **Branch**: main
- **Status**: 15 commits ahead of origin/main
- **Last commits**:
  - `e4bb7b4` - chore: update session metrics and roadmap progress
  - `514d3f2` - refactor(i18n): simplify language selector to icons-only
  - `9ddc34e` - fix(i18n): use block/hidden pattern for selectors

### Technical Details
- **Node.js/Express**: Port 9000
- **MongoDB**: Port 27017, database `tractatus_dev`
- **Production**: https://agenticgovernance.digital
- **SSH Deploy**: `~/.ssh/tractatus_deploy` to `ubuntu@vps-93a693da.vps.ovh.net`
- **Tech Stack**: Vanilla JS, Tailwind CSS, MongoDB, Express (NO shared code with other projects)

### Important Files
- `CLAUDE.md` - Project instructions (mandatory reading)
- `CLAUDE_Tractatus_Maintenance_Guide.md` - Full governance framework
- `SESSION_HANDOFF_2025-10-17_LANGUAGE_SELECTOR.md` - Latest work completed
- `SESSION_HANDOFF_2025-10-15_ENFORCEMENT_ARCHITECTURE.md` - Framework architecture
- `.claude/instruction-history.json` - Persistent instruction database (37 active)

---

## Session Initialization Checklist

When starting a new session, ensure:

1. ✅ Run `node scripts/session-init.js` (MANDATORY - first action)
2. ✅ Review session handoff document if continuing previous work
3. ✅ Start local dev server: `npm start` (port 9000)
4. ✅ Verify MongoDB connection (port 27017)
5. ✅ Check git status and branch
6. ✅ Use TodoWrite for task planning (if complex/multi-step work)

---

## Common Commands

```bash
# Session initialization (MANDATORY)
node scripts/session-init.js

# Development
npm start                                      # Start local server (port 9000)
node scripts/check-session-pressure.js         # Check context pressure

# Testing
npm test                                       # Run all tests
npm run test:unit                              # Run unit tests only

# Deployment
./scripts/deploy-full-project-SAFE.sh          # Deploy to production (comprehensive)
ssh -i ~/.ssh/tractatus_deploy ubuntu@vps-93a693da.vps.ovh.net "sudo systemctl status tractatus"

# Document workflow
npm run migrate:docs -- --source docs/markdown --force
node scripts/generate-single-pdf.js <input.md> <output.pdf>

# Git workflow
git status
git add [files]
git commit -m "..."
git push origin main
```

---

## Framework Components

All 6 components should initialize automatically via session-init.js:

1. **ContextPressureMonitor** - Token/complexity tracking
2. **InstructionPersistenceClassifier** - Long-term instruction management
3. **CrossReferenceValidator** - Detect conflicting instructions
4. **BoundaryEnforcer** - File/command governance
5. **MetacognitiveVerifier** - Self-monitoring and error detection
6. **PluralisticDeliberationOrchestrator** - Multi-perspective decision making

Token checkpoints at: 50k, 100k, 150k tokens (200k total budget)

---

## Notes

- **Session-init.js is MANDATORY** - It will block if local server not running on port 9000
- **Framework fade prevention** - If governance not followed, it's an enforcement gap (fix architecturally)
- **Human approval required** - Architectural changes, DB schema, security, values content
- **Quality standard** - World-class, no shortcuts, no fake data
- **Process management** - systemd (NOT pm2) on production

---

**Last Updated**: 2025-10-17
**Next Session Type**: NEW (not continuation)
**Priority**: Push commits to remote repository