**Modal Scrolling Fix** (addresses user issue with 8-question visibility limit):
- Restructured modal layout to use dedicated scrollable wrapper
- Changed overflow-y-auto to overflow-y-scroll for always-visible scrollbar
- Separated scrollable container from content padding wrapper
- Modal now properly scrolls through all 28+ FAQ items
**PWA Meta Tag Update**:
- Added standard mobile-web-app-capable meta tag
- Replaced deprecated apple-mobile-web-app-capable (kept for compatibility)
- Resolves browser deprecation warning
Technical Details:
- New structure: flex-1 scrollable wrapper > padded content div
- Ensures min-h-0 works correctly with flexbox for scroll overflow
- Location: public/faq.html:505-570
🤖 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>
## FAQ Modal Fixes
- Fix modal scrolling: changed max-h-[85vh] to h-[85vh] with min-h-0
- Added flex-shrink-0 to modal header for proper flex behavior
- Users can now scroll through all 30 FAQ questions (was stuck at 8)
- Enhanced markdown parsing with error handling and fallback
## UI Improvements
- Removed Quick Actions section from FAQ page per user request
- Standardized footer across 7 user-facing pages
- Added Newsletter link under Community section in all footers
## Pages Updated
- faq.html, researcher.html, implementer.html, leader.html
- about.html, media-inquiry.html, case-submission.html
## Version
- Bumped to 1.0.4 with force update enabled
- Service worker cache updated
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Regenerated all PDF downloads with updated timestamps
- Updated markdown metadata across documentation
- Fixed ContextPressureMonitor test for conversation length tracking
- Documentation consistency improvements
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
**FAQ Enhancements:**
- Added 6 new Leader-focused questions (TCO, board justification, liability, metrics, compliance)
- Reordered all 28 questions to prioritize Leaders (IDs 1-18)
- Added sorting by ID to ensure consistent order
- Improved question categorization and keywords
**UI Improvements:**
- Enhanced search and filter functionality
- Improved markdown rendering in FAQ answers
- Better accessibility and keyboard navigation
Leaders now see business-critical questions first, followed by
technical implementation and research questions.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Implements cache busting and progressive web app features:
**Version Management:**
- version.json manifest with changelog tracking
- Service worker with automatic update checking (hourly)
- Update notification UI with changelog display
- Configurable forced updates after timeout
- Cache control headers for optimal performance
**PWA Features:**
- manifest.json with app shortcuts
- Apple touch icon support
- "Add to Home Screen" functionality
- Offline support via service worker
**Cache Strategy:**
- HTML: 5-minute cache with revalidation
- CSS/JS: 1-year immutable cache
- Images: 1-year immutable cache
- version.json/service-worker.js: no-cache
**Integration:**
- All main pages updated with PWA meta tags
- Version manager loaded on all user-facing pages
- Production deployment successful
Users who previously visited the site will now automatically receive
update notifications when version changes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Created new /architecture.html page with generic architecture diagram that emphasizes Tractatus works with any agent runtime (not just Claude Code). Revised tone to reflect early-stage research status, including limitations section and call for industry collaboration, per user feedback on avoiding overconfident claims.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace fuzzy title matching with explicit slug-to-category mapping
- Add 'advanced-topics' category for value pluralism and research docs
- Redistribute deployment docs to appropriate categories
- Move internal docs (Koha, Phase guides) to archived
- Fixes docs.html sidebar categories not collapsing (4th attempt)
- Root cause: Production MongoDB documents lacked category field
CRITICAL FIX: Document incorrectly stated PluralisticDeliberationOrchestrator
was in 'Planning / Research phase' - it's actually implemented as the 6th
mandatory service (October 2025).
Changes:
- Updated status from planning to implemented
- Added current capabilities list
- Fixed GitHub placeholder link
- Converted file paths to proper web links
- Fixed GitHub repository URLs (anthropics org, not AgenticGovernance)
- Updated navigation links to use specific document URLs instead of generic /docs.html
- Added instruction persistence system explanation to introduction
- Regenerated PDFs with corrections
- Remove inline styles from category rendering (CSP violation)
- Apply collapsed state via JavaScript after DOM insertion
- Update cache version to v=0.1.0.1760254264664 across all HTML files
- Categories now properly collapsed on page load (Research, Advanced, Case Studies, Business, Archives)
- Add 'Advanced Topics' category for value pluralism & deep dives
- Rename Value Pluralism FAQ to 'Understanding Value Pluralism'
- Restore research documents from archives (Research Foundations, Organizational Theory, etc.)
- Set most categories to collapsed by default for cleaner UX
- Restore Executive Brief to Business & Leadership
- Archive PoC session summaries
- Create comprehensive migration script for recategorization
Removed 16 sensitive files from git tracking to protect internal processes:
Root directory (5 files):
- CLAUDE_Tractatus_Maintenance_Guide.md
- DEPLOYMENT-2025-10-08.md
- NEXT_SESSION.md
- NEXT_SESSION_OPENING_PROMPT.md
- SESSION_CLOSEDOWN_20251006.md
docs/ directory (11 files):
- KOHA_PRODUCTION_DEPLOYMENT.md
- PHASE-2-DEPLOYMENT-GUIDE.md
- PRODUCTION_DEPLOYMENT_CHECKLIST.md
- SESSION-2025-10-07-AI-FEATURES.md
- SESSION-HANDOFF-2025-10-12.md
- SESSION_HANDOFF_2025-10-10.md
- SESSION_HANDOFF_2025-10-11.md
- SESSION_HANDOFF_2025_10_11.md
- SESSION_HANDOFF_2025_10_11_P3_P4.md
- SESSION_INIT_API_MEMORY_AUDIT.md
- planning/PHASE_3_SESSION_1_SUMMARY.md
These files contain:
- Internal workflow documentation
- Deployment procedures and server details
- Session handoff information
- Planning and strategy documents
Security posture:
✅ Files removed from tracking (won't appear in new commits)
✅ Files remain on disk for local use
✅ .gitignore already blocks these patterns
✅ .rsyncignore blocks deployment to production
⚠️ Files remain in git history (accessible via git log)
Note: This is low-risk remediation. Files remain in history but won't
be visible in file browser or future commits. For complete removal,
git history rewrite would be needed (high risk, requires force push).
Risk assessment: Medium exposure (internal processes visible) but no
credentials, keys, or direct access information exposed.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Two fixes for production deployment:
1. FAQ Answer Truncation Fix:
- Changed max-height from 2000px to none in faq.html
- Allows answers to expand to full height without cutting off
- Fixes Q18-Q22 (value pluralism) answers being truncated
2. Cache Busting:
- Updated version from v=1.0.3 to v=1.0.4
- Forces browser cache refresh for JavaScript and CSS
- Ensures value pluralism documents visible in docs.html sidebar
- Updated in both faq.html and docs.html
User feedback: "Some of the Answers in the new Q&As are cutting off
the bottom end of the Answer" and "I cannot find the three new files
in the left sidebar at docs.html on 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>
- Update integrated implementation roadmap with Phase 2 completions
- Update blog curation admin interface
- Update implementer page with value pluralism content
Reflects October 12 production status
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update glossary (v1.1) with value pluralism terminology
- Update case studies with value pluralism examples
- Update core concepts to include foundational pluralism
- Update introduction with 6th core service
- Update technical architecture and comparison matrix
- Update implementation guide with value pluralism sections
All markdown reflects 6-service production architecture
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Document PluralisticDeliberationOrchestrator as 6th mandatory service
- Update service initialization procedures
- Add value pluralism governance principles
- Update README with current framework status
Reflects production-ready 6-service architecture
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Update docs.html with MongoDB-integrated documents
- Add value pluralism documents to sidebar categories
- Update docs-app.js for proper document retrieval
- Sync navbar changes across UI pages
Documents now searchable and properly categorized in docs viewer
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Q18: What is value pluralism and why Tractatus uses it
- Q19: How Tractatus handles moral disagreement without hierarchy
- Q20: What makes value pluralism different from relativism
- Q21: How urgent decisions work with value pluralism
- Q22: Can organizations use this without adopting specific values
Added 5 comprehensive questions with researcher/leader audience tags
FAQ now covers full value pluralism approach
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- pluralistic-values-research-foundations.md (43KB)
- Academic grounding for PluralisticDeliberationOrchestrator
- Deliberative democracy theory
- Cross-cultural communication principles
- Value pluralism philosophy
- References to Berlin, Rawls, Habermas
- value-pluralism-faq.md (17KB)
- User-facing explanation of foundational pluralism
- Q&A format for accessibility
- How Tractatus handles moral disagreement
- pluralistic-values-deliberation-plan-v2.md (42KB)
- Technical design document
- Implementation roadmap
- Service architecture details
- Integration with existing framework
Migrated to MongoDB for docs.html integration
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Initialize PluralisticDeliberationOrchestrator (6th core service)
- Initialize AdaptiveCommunicationOrchestrator (support service)
- Add to governance services list for clean startup
- Server reports "6 core services" operational
All governance services now initialized on startup
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- GovernanceRule: Remove duplicate category index (uses compound index)
- VerificationLog: Remove duplicate verifiedAt index (uses compound + TTL)
- VariableValue: Remove duplicate category index (standalone index exists)
Eliminates 3 Mongoose duplicate index warnings on server startup
Server now starts with zero warnings
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Created openapi.yaml (1,621 lines, 46KB)
- Documents all API endpoints with full schemas
- Authentication, Documents, Governance Services, Audit, Admin
- Added OpenAPI download link to api-reference.html
- Deployed to production
Task 12 (API Documentation) - OpenAPI spec complete
