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>
- 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>
**Issue:** New documents not appearing in production docs sidebar
**Root Cause:** Documents not migrated to MongoDB + browser caching old JS
**Changes:**
1. **Cache Busting:** Updated all cache versions from 1.0.2 → 1.0.3
- public/docs.html (CSS, navbar.js, docs-app.js, docs-search-enhanced.js, document-cards.js)
- public/faq.html (CSS, navbar.js, faq.js)
2. **Document Migration:** Migrated new documents to MongoDB
- comparison-matrix.md → comparison-matrix-claude-code-claudemd-and-tractatus-framework
- technical-architecture.md → technical-architecture
- 27027-incident-detailed-analysis.md → the-27027-incident-a-case-study-in-pattern-recognition-bias
- Plus 5 case studies created today
**Production deployment:**
- Deployed updated HTML files with new cache versions
- Migrated 8 new documents to tractatus_prod database
- Restarted tractatus.service to clear server-side caches
**Documents now available in docs.html sidebar:**
✓ Technical Architecture (new today)
✓ Comparison Matrix: Claude Code vs Tractatus (new today)
✓ The 27027 Incident Case Study (new today)
✓ Implementation Guide v1.1 (updated today)
✓ All case studies from earlier sessions
**Cache busting forces browser reload of:**
- Document list JavaScript
- Search functionality
- Navbar component
- FAQ page JavaScript
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Task 10 from integrated implementation roadmap complete.
**New files:**
- public/faq.html: Responsive FAQ page with search, filters, expandable Q&A
- public/js/faq.js: 17 comprehensive Q&A pairs organized by audience
**Features:**
- Live search with highlighting
- Audience filters (All, Researcher, Implementer, Leader)
- Expandable/collapsible questions with smooth animations
- Quick actions section linking to Quickstart, Docs, Demos
- Mobile-responsive design with sticky search bar
**Questions covered:**
1. Why not just better prompts/CLAUDE.md?
2. Performance overhead cost
3. Multi-model support beyond Claude Code
4. Relationship to Constitutional AI
5. False positive rates for governance enforcement
6. How to update governance rules
7. Learning curve for developers
8. Version control for governance rules
9. Is Tractatus overkill for smaller projects?
10. Can I use only parts of Tractatus?
11. How does Tractatus handle instruction conflicts?
12. What happens at 100% context pressure?
13. How to audit governance for compliance?
14. Difference from AI safety via prompting
15. Can Tractatus prevent hallucinations?
16. CI/CD pipeline integration
17. Common deployment mistakes
**Technical implementation:**
- FAQ data structure with question, answer, audience tags, keywords
- Search functionality with query matching across questions/answers/keywords
- Filter logic with active pill state management
- Expand/collapse with CSS max-height transitions
- Results counting with dynamic updates
- Accessibility: ARIA labels, keyboard navigation, focus indicators
**Updated files:**
- public/js/components/navbar.js: Added FAQ link to desktop + mobile menus
**Metrics:**
- 17 Q&A pairs (exceeds 15-20 target)
- ~56KB JavaScript (comprehensive answers with code examples)
- Organized by 3 audience types (researcher/implementer/leader)
- Deployed to production: https://agenticgovernance.digital/faq.html🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
