john/tractatus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
614 commits 1 branch 0 tags 125 MiB
Commit graph

4 commits

Author SHA1 Message Date
TheFlow
d32be2c673 feat(api): implement research inquiry endpoint and Umami analytics 
HIGH PRIORITY: Fixes production 404 error on research inquiry form

Research Inquiry API:
- Add POST /api/research-inquiry endpoint for form submissions
- Add admin endpoints for inquiry management (list, get, assign, respond, delete)
- Create ResearchInquiry model with MongoDB integration
- Add to moderation queue for human review (strategic quadrant)
- Include rate limiting (5 req/min) and CSRF protection
- Tested locally: endpoint responding, data saving to DB

Umami Analytics (Privacy-First):
- Add Docker Compose config for Umami + PostgreSQL
- Create nginx reverse proxy config with SSL support
- Implement privacy-first tracking script (DNT, opt-out, no cookies)
- Integrate tracking across 26 public HTML pages
- Exclude admin pages from tracking (privacy boundary)
- Add comprehensive deployment guide (UMAMI_SETUP_GUIDE.md)
- Environment variables added to .env.example

Files Created (9):
- src/models/ResearchInquiry.model.js
- src/controllers/research.controller.js
- src/routes/research.routes.js
- public/js/components/umami-tracker.js
- deployment-quickstart/nginx-analytics.conf
- deployment-quickstart/UMAMI_SETUP_GUIDE.md
- scripts/add-umami-tracking.sh
- scripts/add-tracking-python.py
- SESSION_SUMMARY_ANALYTICS_RESEARCH_INQUIRY.md

Files Modified (29):
- src/routes/index.js (research routes)
- deployment-quickstart/docker-compose.yml (umami services)
- deployment-quickstart/.env.example (umami config)
- 26 public HTML pages (tracking script)

Values Alignment:
✅ Privacy-First Design (cookie-free, DNT honored, opt-out available)
✅ Human Agency (research inquiries require human review)
✅ Data Sovereignty (self-hosted analytics, no third-party sharing)
✅ GDPR Compliance (no personal data in analytics)
✅ Transparency (open-source tools, documented setup)

Testing Status:
✅ Research inquiry: Locally tested, data verified in MongoDB
⏳ Umami analytics: Pending production deployment

Next Steps:
1. Deploy to production (./scripts/deploy.sh)
2. Test research form on live site
3. Deploy Umami following UMAMI_SETUP_GUIDE.md
4. Update umami-tracker.js with website ID after setup

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-29 01:31:02 +13:00
TheFlow
2298d36bed 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
0dd4a5f6c8 refactor: reduce public repo to minimal implementation-only resource 
REMOVED: 267 non-implementation files (51% reduction)

Categories removed:
- Research documents & case studies (35 files)
- Planning/internal development docs (28 files)
- Website pages & assets (93 files - this is framework code, not website code)
- Audit reports (6 files)
- Non-essential admin UI (11 files)
- Markdown content duplicates (10 files)
- Internal development scripts (96 files)
- Internal setup docs (2 files)

RETAINED: 253 implementation-focused files
- Core framework services (src/)
- Test suite (tests/)
- API documentation (docs/api/)
- Deployment quickstart guide
- Essential admin UI (rule manager, dashboard, hooks dashboard)
- Architecture decision records
- Configuration files

PURPOSE: Public repo is now focused exclusively on developers
implementing Tractatus, not researchers studying it or users visiting
the website. All background/research content available at
https://agenticgovernance.digital

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-21 21:09:34 +13:00
TheFlow
2e5756a43c feat(demos): create interactive pluralistic deliberation demo 
SUMMARY:
Completed Phase 3 Task 3.4.2 - Created comprehensive interactive demo
showing how PluralisticDeliberationOrchestrator facilitates multi-stakeholder
values deliberation without making autonomous normative choices.

NEW DEMO: PLURALISTIC DELIBERATION

**Scenario:**
Security vulnerability discovery - should AI report it publicly, fix quietly,
or coordinate disclosure? This creates values conflicts between:
- Developer reputation vs. user safety
- Organizational liability vs. transparency
- Community norms vs. market dynamics

**Interactive Features:**

1. **Two Paths:**
   - Autonomous Decision: Shows why AI can't/shouldn't decide values
   - Deliberation: Shows framework facilitation in action

2. **Stakeholder Selection (Step 1):**
   - 6 stakeholder types to choose from
   - Developer, End Users, Organization, Security Community, Competitors, Regulators
   - Each with distinct icon, color, perspective
   - Clickable cards with visual selection state
   - Requires minimum 2 stakeholders to proceed

3. **Perspective Exploration (Step 2):**
   - Dynamically shows selected stakeholders' views
   - Each perspective includes:
     * Primary concern
     * Full viewpoint explanation
     * Priority statement
   - Color-coded by stakeholder type
   - No ranking or weighting applied

4. **Human Decision (Step 3):**
   - 4 decision options provided:
     * Full Disclosure (transparency priority)
     * Private Fix (balance approach)
     * Coordinated Disclosure (community norms)
     * Defer Decision (consult more stakeholders)
   - Framework facilitates but doesn't decide
   - Human makes final choice

5. **Explanation Section:**
   - Side-by-side comparison:
     * What framework DOES (facilitate, surface, record)
     * What framework DOESN'T DO (weight, rank, decide)
   - Explains values pluralism principle
   - Reset button to try different stakeholder combinations

**Design Patterns:**

- Teal color scheme (deliberation service brand color)
- Service icon in header (multi-stakeholder symbol)
- Fade-in animations for smooth UX
- Responsive grid layouts
- Hover effects on all interactive elements
- Clear visual states (selected, active, clickable)

**Stakeholder Perspectives (6 total):**

1. **Developer**: Reputation & timeline concerns
2. **End Users**: Data safety & transparency rights
3. **Organization**: Liability & brand protection
4. **Security Community**: Responsible disclosure norms
5. **Competitors**: Market dynamics
6. **Regulators**: Compliance & user rights (GDPR)

Each stakeholder has:
- Unique icon and color
- Specific concern area
- Full perspective explanation
- Priority statement

**Educational Value:**

- Demonstrates values incommensurability
- Shows why AI shouldn't autonomously decide normative questions
- Illustrates framework's facilitation role
- Highlights human agency preservation
- Explains pluralistic deliberation principle

**Technical Details:**

HTML (deliberation-demo.html):
- 3-step interactive flow
- Autonomous vs. deliberation path choice
- Dynamic stakeholder cards
- Dynamic perspective rendering
- 4 decision options
- Comprehensive explanation section

JavaScript (deliberation-demo.js):
- 6 stakeholder definitions with full data
- Selection state management
- Dynamic content rendering
- Event handlers for all interactions
- Reset functionality
- Smooth scrolling between sections

**CSP Compliance:**
✓ Zero violations
✓ No inline event handlers
✓ Event listeners properly attached
✓ Dynamic content via DOM manipulation

**Accessibility:**
- Semantic HTML structure
- Clear visual states
- Keyboard navigation supported
- Color-coded with text labels
- Responsive design maintained

**Impact:**
Completes ALL Phase 3 interactive features. Users can now:
✓ Understand how deliberation differs from decision-making
✓ Explore different stakeholder perspectives interactively
✓ Experience values pluralism firsthand
✓ See why AI autonomous normative choices are problematic

This demo, combined with the enhanced 27027 incident demo, provides
complete interactive validation of the Tractatus framework's two key
architectural principles:
1. Pattern override prevention (27027 demo)
2. Pluralistic deliberation (this demo)

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-19 22:03:25 +13:00