- Enhanced update-cache-version.js to update service worker and version.json
- Added inst_075 governance instruction (HIGH persistence)
- Integrated cache check into deployment script (Step 1/5)
- Created CACHE_MANAGEMENT_ENFORCEMENT.md documentation
- Bumped version to 0.1.1
- Updated all HTML cache parameters
BREAKING: Deployment now blocks if JS changed without cache update
- Create Economist SubmissionTracking package correctly:
* mainArticle = full blog post content
* coverLetter = 216-word SIR— letter
* Links to blog post via blogPostId
- Archive 'Letter to The Economist' from blog posts (it's the cover letter)
- Fix date display on article cards (use published_at)
- Target publication already displaying via blue badge
Database changes:
- Make blogPostId optional in SubmissionTracking model
- Economist package ID: 68fa85ae49d4900e7f2ecd83
- Le Monde package ID: 68fa2abd2e6acd5691932150
Next: Enhanced modal with tabs, validation, export
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Removed files:
- SECURITY_INCIDENT_HUMAN_ACTIONS_REQUIRED.md (internal security doc)
- .claude/instruction-history.json (project-specific governance rules)
- scripts/add-security-rules-2025-10-21.js (dated, project-specific)
- scripts/apply-governance-audit-2025-10-21.js (dated, project-specific)
- docs/governance/GOVERNANCE_LEARNINGS_2025-10-21.md (internal learnings)
- docs/governance/GOVERNANCE_RULES_AUDIT_2025-10-21.md (internal audit)
These are internal to the tractatus project, not framework resources.
Public repo should contain only framework implementation code and docs.
Updated .gitignore to prevent future commits of similar files.
NEW GOVERNANCE RULE:
- ID: inst_062
- Text: "GitHub README.md must be reviewed weekly and 'Last Updated' date updated when material changes occur"
- Quadrant: OPERATIONAL
- Persistence: HIGH
- Temporal Scope: PERMANENT
RATIONALE:
GitHub README is the primary external interface for implementers.
World-class open source projects maintain current, accurate README files.
MATERIAL CHANGES (require date update):
- Service additions/removals
- Architecture changes
- Status updates
- Documentation links
- Critical corrections
NON-MATERIAL CHANGES (no date update):
- Typos
- Formatting
- Minor clarifications
VERSION: 3.4 → 3.5
ACTIVE INSTRUCTIONS: 52 → 53
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed sync script disconnecting Mongoose (prevents production errors)
- Created text search index (fixes search in rule-manager)
- Enhanced inst_024 with closedown protocol, added inst_061
- Added sync infrastructure: API routes, dashboard widget, auto-sync
- Fixed MemoryProxy tests MongoDB connection
- Created ADR-001 and integration tests
Result: Production stable, 52 rules synced, search working
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
SUMMARY:
Added inst_049 requiring AI to test user hypotheses first before pursuing
alternatives. Documented incident where ignoring user suggestion wasted
70k tokens and 4 hours. Published research case study analyzing governance ROI.
CHANGES:
- inst_049: Enforce testing user technical hypotheses first (inst_049)
- Research case study: Governance ROI analysis with empirical incident data
- Framework incident report: 12-attempt debugging failure documentation
RATIONALE:
User correctly identified 'Tailwind issue' early but AI pursued 12 failed
alternatives first. Framework failure: BoundaryEnforcer existed but wasn't
architecturally enforced. New rule prevents similar resource waste.
STATS:
- Total instructions: 49 (was 48)
- STRATEGIC quadrant: 8 (was 7)
- HIGH persistence: 45 (was 44)
🤖 Generated with Claude Code (https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Bug Fixes
- Fixed inline FAQ markdown rendering with error handling
- Added try-catch around marked.parse() for inline FAQs
- Added fallback to plain text with line breaks on parse failure
- Enhanced logging for FAQ rendering diagnostics
## New Instruction (inst_040)
Created rule requiring complete coverage when user says "all":
- "update all pages" means EVERY page, not representative subset
- Must identify complete scope before starting
- Verify ALL items processed before marking complete
- Ask user to prioritize if scope >20 items
## Rationale
User reported inline FAQs showing raw markdown instead of formatted HTML.
Root cause: createInlineFAQItemHTML lacked error handling that was added
to createFAQItemHTML in previous version. Both functions now have consistent
error handling with logging.
User directive: When saying "all", Claude must not choose subset.
## Version
- Bumped to 1.0.5
- Force update enabled
- Synced inst_040 to production
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
MongoDB authentication fixes:
- load-inst-035.js: Add dotenv.config() to load .env file
- migrate-value-pluralism-docs.js: Add dotenv.config() to load .env file
- Scripts now properly authenticate with production MongoDB
Governance enhancement:
- inst_036: NEVER attempt quick fixes when working with human PM
- Prohibits shortcuts, workarounds, partial implementations
- Requires proper root cause analysis and thorough solutions
- Exception only for critical production outages
- Enforces inst_004 (world-class quality) in all development
Root cause: Scripts weren't loading .env, couldn't access MongoDB credentials
Impact: Production migrations will now work correctly
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- inst_029: Foundational Pluralism (no automatic value ranking)
- inst_030: Legitimate Disagreement (valid outcome when incommensurable)
- inst_031: Moral Remainder (document what's lost in decisions)
- inst_032: Provisional Decisions (reviewable when context changes)
- inst_033: Multi-stakeholder Facilitation (AI facilitates, humans decide)
- inst_034: Cultural Communication Adaptation (linguistic equity)
- inst_035: Precedent Database (informative, not binding)
All HIGH persistence in STRATEGIC quadrant
Supports PluralisticDeliberationOrchestrator implementation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Establishes clear protocol for handoff documents: when user requests
handoff at end of session, this signals intent to start NEW session
with fresh 200k token budget, NOT continue from compacted conversation.
PROTOCOL:
- After handoff created: STOP all work immediately
- DO NOT continue after conversation compaction
- DO NOT auto-run session-init.js on compacted continuation
- Wait for user to start fresh Claude Code session
RATIONALE:
User caught Claude auto-continuing after handoff in this session. Handoff
documents are bridges between sessions, not continuations within sessions.
Also includes session handoff document from previous session documenting
Priority 3 (Search Enhancement) and Priority 4 Backend (Media Triage) completion.
📊 Context Pressure: NORMAL (32.0%) | Tokens: 64k/200k | Next: 100k
Generated with Claude Code (https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive governance rule for managing dev servers, file
watchers, and daemon processes across session boundaries.
Key requirements:
- Document process intent before spawning background processes
- Kill non-essential processes before session handoff
- Check for orphaned processes at session start
- Prefer foreground dev servers to avoid port conflicts
Prevents EADDRINUSE errors and resource leaks across sessions.
Related: inst_006 (session management)
Trigger: User observed npm start processes causing port conflicts
Stats: OPERATIONAL quadrant count updated from 6 to 7
## Problem
inst_018 incorrectly treated "development framework" as a limitation or
early-stage status, when it's actually the CORRECT classification.
## User Clarification
Tractatus IS a development tool (like IDE, linter, framework):
- Runs in developer environments to help build projects
- The websites/SaaS built WITH Tractatus go to production
- Tractatus itself is the development platform
## Changes to inst_018
**Old restriction**: Don't claim "production-ready" (implied always wrong)
**New restriction**: Don't claim "production-ready" WITHOUT testing evidence
**Key updates**:
- Added: "Development tool" is correct classification, not limitation
- Changed focus: Restriction is about testing/validation status
- Allowed: "production-ready development tool" ONCE validated
- Preserved: No unverifiable claims about adoption/customers
## Parameters Updated
- tool_category: "development_tool" (correct classification)
- category_is_correct: true
- focus_restriction: "testing_validation_status"
- allowed_once_validated: ["production-ready development tool", ...]
## Impact
Framework will now:
✅ Accept "development tool" as permanent correct status
✅ Allow "production-ready" claims once testing validates it
✅ Block unverified testing/stability claims
✅ Preserve honesty requirements (inst_016, inst_017)
Timestamp: 2025-10-10T23:30:00Z
Session: 2025-10-10-api-memory-transition
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
FRAMEWORK VIOLATION (2025-10-09):
Claude fabricated statistics and made false claims on leader.html without
triggering BoundaryEnforcer. This is a CRITICAL VALUES VIOLATION.
FABRICATIONS REMOVED:
- $3.77M annual savings (NO BASIS)
- 1,315% ROI (FABRICATED)
- 14mo payback (FABRICATED)
- 80% risk reduction (FABRICATED)
- 90% incident reduction (FABRICATED)
- 81% faster response (FABRICATED)
- "architectural guarantees" (PROHIBITED LANGUAGE)
- "Production-Ready" claim (FALSE - dev/research stage)
ROOT CAUSE:
- BoundaryEnforcer NOT invoked for marketing content
- Marketing context override prioritized UX over factual accuracy
- Missing explicit prohibition against fabricated statistics
- Framework awareness diminished after conversation compaction
CORRECTIVE ACTIONS:
✅ Added 3 new HIGH persistence instructions (inst_016, inst_017, inst_018)
✅ Documented failure in docs/FRAMEWORK_FAILURE_2025-10-09.md
✅ Completely rewrote leader.html with ONLY factual content
✅ Updated cache-busting to v1.0.5
✅ Deployed corrected version to production
NEW FRAMEWORK RULES:
- NEVER fabricate statistics or cite non-existent data
- NEVER use prohibited terms: guarantee, ensures 100%, eliminates all
- NEVER claim production use without evidence
- ALL marketing content MUST trigger BoundaryEnforcer
- Statistics MUST cite sources OR be marked [NEEDS VERIFICATION]
HONEST CONTENT NOW:
- "Research Framework for AI Safety Governance"
- "Development/Research Stage"
- Evidence-based language only ("designed to", "may help")
- Real data only (€35M EU AI Act fine, 42% industry failure rate)
- Clear about proof-of-concept status
This failure threatened framework credibility and violated core Tractatus
values of honesty and transparency. Framework enhanced to prevent recurrence.
Supersedes commit: ec6cf87
**Cache-Busting Improvements:**
- Switched from timestamp-based to semantic versioning (v1.0.2)
- Updated all HTML files: index.html, docs.html, leader.html
- CSS: tailwind.css?v=1.0.2
- JS: navbar.js, document-cards.js, docs-app.js v1.0.2
- Professional versioning approach for production stability
**systemd Service Implementation:**
- Created tractatus-dev.service for development environment
- Created tractatus-prod.service for production environment
- Added install-systemd.sh script for easy deployment
- Security hardening: NoNewPrivileges, PrivateTmp, ProtectSystem
- Resource limits: 1GB dev, 2GB prod memory limits
- Proper logging integration with journalctl
- Automatic restart on failure (RestartSec=10)
**Why systemd over pm2:**
1. Native Linux integration, no additional dependencies
2. Better OS-level security controls (ProtectSystem, ProtectHome)
3. Superior logging with journalctl integration
4. Standard across Linux distributions
5. More robust process management for production
**Usage:**
# Development:
sudo ./scripts/install-systemd.sh dev
# Production:
sudo ./scripts/install-systemd.sh prod
# View logs:
sudo journalctl -u tractatus -f
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed download icon size (1.25rem instead of huge black icons)
- Uploaded all 12 PDFs to production server
- Restored table of contents rendering for all documents
- Fixed modal cards with proper CSS and event handlers
- Replaced all docs-viewer.html links with docs.html
- Added nginx redirect from /docs/* to /docs.html
- Fixed duplicate headers in modal sections
- Improved cache-busting with timestamp versioning
All documentation features now working correctly:
✅ Card-based document viewer with modals
✅ PDF downloads with proper icons
✅ Table of contents navigation
✅ Consistent URL structure
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
