Commit graph

12 commits

Author SHA1 Message Date
TheFlow
ac2db33732 fix(submissions): restructure Economist package and fix article display
- 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>
2025-10-24 08:47:42 +13:00
TheFlow
60f239c0bf refactor: deep cleanup - remove all website code from framework repo
REMOVED: 77 website-specific files from src/ and public/

Website Models (9):
- Blog, CaseSubmission, Document, Donation, MediaInquiry,
  ModerationQueue, NewsletterSubscription, Resource, User

Website Services (6):
- BlogCuration, MediaTriage, Koha, ClaudeAPI, ClaudeMdAnalyzer,
  AdaptiveCommunicationOrchestrator

Website Controllers (9):
- blog, cases, documents, koha, media, newsletter, auth, admin, variables

Website Routes (10):
- blog, cases, documents, koha, media, newsletter, auth, admin, test, demo

Website Middleware (4):
- auth, csrf-protection, file-security, response-sanitization

Website Utils (3):
- document-section-parser, jwt, markdown

Website JS (36):
- Website components, docs viewers, page features, i18n, Koha

RETAINED Framework Code:
- 6 core services (Boundary, ContextPressure, CrossReference,
  InstructionPersistence, Metacognitive, PluralisticDeliberation)
- 4 support services (AnthropicMemoryClient, MemoryProxy,
  RuleOptimizer, VariableSubstitution)
- 9 framework models (governance, audit, deliberation, project state)
- 3 framework controllers (rules, projects, audit)
- 7 framework routes (rules, governance, projects, audit, hooks, sync)
- 6 framework middleware (error, validation, security, governance)
- Minimal admin UI (rule manager, dashboard, hooks dashboard)
- Framework demos and documentation

PURPOSE: Tractatus-framework repo is now PURELY framework code.
All website/project code remains in internal repo only.

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-21 21:22:40 +13:00
TheFlow
d3af7166c0 fix(content): remove prohibited terms from public UI files (inst_016/017/018)
FIXED PUBLIC UI FILES (10 violations → 0):

public/implementer.html (1 violation):
- Line 86: Removed "production-ready" claim
  "not production-ready commercial software" → "not commercial software"

public/locales/en/implementer.json (1 violation):
- Line 16: Removed "production-ready" claim (matches HTML)

public/js/faq.js (8 violations):
- Line 104: "architectural guarantee" → "architectural enforcement"
  (Constitutional AI comparison)

- Line 895-896: Guard dog analogy fixes
  "not guaranteed" → "not reliable"
  "always work" → "work consistently"

- Line 2119: Framework description
  "production-ready commercial product" → "research implementation, not commercial product"

- Line 2338: Liability disclaimer
  "Guarantee: No software can guarantee" → "Absolute certainty: No software can prevent all"

- Line 2355: Risk comparison
  "No enforcement guarantees" → "No enforcement mechanisms"

- Line 2422: Developer liability mitigation
  "No false production-ready claims" → "Accurate maturity statements (research, not commercial)"

RESULT: All public-facing UI content now inst_016/017/018 compliant

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-21 17:49:56 +13:00
TheFlow
d0700a6f92 fix(values): remove prohibited 'guarantee' language from user-facing content
VIOLATION: Using absolute assurance language violates inst_017
- README.md: "architectural AI safety guarantees" → "enforcement"
- README.md: "guarantees transparency" → "provides transparency"
- public/index.html meta: "guarantees" → "enforcement"
- public/about.html CTA: "architectural guarantees" → "constraints"
- public/js/components/footer.js: "guarantees" → "enforcement"
- public/js/faq.js (5 instances): "guarantees" → "enforcement/constraints"
- public/locales/en/*.json (3 files): "guarantees" → "enforcement/constraints"
- scripts/seed-first-blog-post.js: "safety guarantees" → "safety constraints"

RESULT: All user-facing "guarantee" language removed
- Production website now compliant with inst_017
- No absolute assurance claims in public content
- Framework documentation still pending (hook blocked markdown edits)

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-21 15:19:25 +13:00
TheFlow
5b92d3d927 refactor: rewrite Copilot Q&A in measured, evidence-based tone
Rewrote Copilot governance answer to match the restrained, analytical tone of the leader page, removing overconfident American-style assertions.

Key changes:
- Opening: "creates significant liability exposure" → "raises structural questions about governance"
- Removed dramatic scenarios: "Post-incident: 'How did this get approved?' No audit trail. No answer."
- Removed unvalidated cost claims (£500k-£2M settlements, specific ROI figures)
- Added development context: "proof-of-concept validated in a single project context"
- Changed assertions to observations: "will cause" → "may create", "is" → "raises questions about"
- Removed sales pitch language: "Case closed", "catastrophic liability exposure"
- Added honest limitations: "If your rules are inadequate...Tractatus enforces those inadequacies architecturally"
- Changed CTA: Removed "pro bono offer" for removed "show you exactly where your exposure is"
- Used cautious framing: "Whether this constitutes 'compliance-grade' evidence depends on your regulatory context"

Tone now matches leader page:
- Measured, intellectual engagement
- Evidence-based claims with context
- Acknowledges uncertainty
- Focuses on structural governance questions
- No prescriptive assertions

Version: 1.1.0 → 1.1.1

User feedback: "I like your overconfident American attitude. It has its place on this planet, but not here."

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-14 14:19:46 +13:00
TheFlow
5084ca82fd feat: add Copilot governance Q&A for General Counsel and AI VPs
Added strategically positioned question addressing governance gaps in Copilot deployments for client correspondence:

Question (ID: 2):
"We're deploying Copilot across our organisation for client correspondence—what governance gaps should concern us, and how does Tractatus address them?"

Answer highlights:
- Liability exposure: unauthorised commitments, confidentiality breaches
- Regulatory compliance gaps: GDPR Article 22, SOC 2 CC2.1
- Tractatus as governance layer above Copilot
- Compliance-grade audit trails
- Phased implementation path (observation → soft → hard enforcement)
- Board-ready cost-benefit analysis
- Architectural vs aspirational governance distinction

Target audience: General Counsel, AI Vice President, Executive Leadership
Placement: Second question in Leader section (prominent positioning)
Keywords: copilot, microsoft, client, correspondence, deployment, governance, risk, liability, compliance, audit, general counsel, legal

Version: 1.0.9 → 1.1.0
Files modified:
- public/js/faq.js (new question ~1,400 words)
- public/service-worker.js (version bump)
- public/version.json (changelog update)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-14 14:09:54 +13:00
TheFlow
ce6d4f9085 fix: inline FAQ markdown rendering and add inst_040
## 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>
2025-10-14 12:51:08 +13:00
TheFlow
a54eb6cffd fix: FAQ modal scrolling and standardize footers
## 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>
2025-10-14 12:46:23 +13:00
TheFlow
c8a7ed993b feat: enhance FAQ for Leader audience and improve navigation
**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>
2025-10-14 10:53:47 +13:00
TheFlow
1906c0be0b docs: update framework to 6 services with PluralisticDeliberationOrchestrator
- Updated all core documentation (introduction, core-concepts, implementation guides)
- Added comprehensive PluralisticDeliberationOrchestrator sections
- Fixed implementation-guide-v1.1.md (BlogCuration → PluralisticDeliberationOrchestrator)
- Updated UI pages (index, researcher, leader) to reflect 6 services
- Enhanced cache busting with unified version script
- FAQ already includes comprehensive value pluralism coverage (Q18-22)

Framework now correctly documents all 6 mandatory services:
1. InstructionPersistenceClassifier
2. CrossReferenceValidator
3. BoundaryEnforcer
4. ContextPressureMonitor
5. MetacognitiveVerifier
6. PluralisticDeliberationOrchestrator (added October 2025)

🤖 Generated with Claude Code
2025-10-12 19:55:44 +13:00
TheFlow
c0f4b27889 feat(ui): add value pluralism Q&A to FAQ (Q18-Q22)
- 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>
2025-10-12 16:36:33 +13:00
TheFlow
5e160d5728 feat: implement comprehensive FAQ section with 17 Q&A pairs
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>
2025-10-12 08:09:05 +13:00