**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>
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>
- 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)
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>
