Commit graph

18 commits

Author SHA1 Message Date
TheFlow
d854ac85e2 feat(research): add cross-environment audit log sync infrastructure
Implements privacy-preserving synchronization of production audit logs
to development for comprehensive governance research analysis.

Backend Components:
- SyncMetadata.model.js: Track sync state and statistics
- audit-sanitizer.util.js: Privacy sanitization utility
  - Redacts credentials, API keys, user identities
  - Sanitizes file paths and violation content
  - Preserves statistical patterns for research
- sync-prod-audit-logs.js: CLI sync script
  - Incremental sync with deduplication
  - Dry-run mode for testing
  - Configurable date range
- AuditLog.model.js: Enhanced schema with environment tracking
  - environment field (development/production/staging)
  - sync_metadata tracking (original_id, synced_from, etc.)
  - New indexes for cross-environment queries
- audit.controller.js: New /api/admin/audit-export endpoint
  - Privacy-sanitized export for cross-environment sync
  - Environment filter support in getAuditLogs
- MemoryProxy.service.js: Environment tagging in auditDecision()
  - Tags new logs with NODE_ENV or override
  - Sets is_local flag for tracking

Frontend Components:
- audit-analytics.html: Environment filter dropdown
- audit-analytics.js: Environment filter query parameter handling

Research Benefits:
- Combine dev and prod governance statistics
- Longitudinal analysis across environments
- Validate framework consistency
- Privacy-preserving data sharing

Security:
- API-based export (not direct DB access)
- Admin-only endpoints with JWT authentication
- Comprehensive credential redaction
- One-way sync (production → development)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 12:11:16 +13:00
TheFlow
39ec39f175 feat(bi): add scrollable modal with fixed header/footer for cost config
Enhanced modal UX with proper scroll handling:

1. Modal Structure:
   - Fixed header (title + description)
   - Scrollable content area (form fields)
   - Fixed footer (Cancel + Save buttons)

2. Flexbox Layout:
   - Container: flex flex-col max-height 90vh
   - Header/Footer: flex-shrink-0 (stays visible)
   - Content: flex-1 overflow-y-auto (scrolls)

3. Custom Purple Scrollbar:
   - WebKit (Chrome/Safari/Edge): 8px width, purple thumb
   - Firefox: thin scrollbar, purple color scheme
   - Matches Tractatus theme (#9333ea purple)

4. Responsive Height:
   - Modal max 90vh ensures it fits any screen
   - Content area scrolls when form is tall
   - Header/footer always visible for context

Users can now scroll through all 4 severity configurations while
always seeing the modal title and action buttons.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:27:15 +13:00
TheFlow
7ce444cc7f fix(bi): add explicit slider track styling for cross-browser visibility
Fixed invisible sliders in cost configuration modal by adding:

1. Explicit .slider base styles:
   - height: 8px (was conflicting with Tailwind h-2)
   - background: #e9d5ff (light purple)
   - appearance: none for both -webkit and standard

2. Track-specific styling:
   - ::-webkit-slider-track for Chrome/Safari/Edge
   - ::-moz-range-track for Firefox
   - Both get 8px height + purple background

3. Removed conflicting Tailwind classes:
   - Changed from "w-full h-2 bg-purple-200 rounded-lg..." to just "slider"
   - Custom CSS now has complete control

Issue: appearance-none removes native styling but browsers need
explicit track styles to render the slider bar visible.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:23:11 +13:00
TheFlow
88f9ccfb34 feat(bi): add period selector dropdown to cost avoidance metric
Added time period filtering to cost avoidance calculation:

HTML changes:
- Added dropdown selector next to "Cost Avoidance" title
- Options: 7 days, 30 days (default), 90 days, 1 year, all time
- Green focus ring matching metric theme

JavaScript changes:
- Filter audit data by selected time period before calculating costs
- Event listener updates calculation when period changes
- Cutoff date logic for temporal filtering
- Defaults to 30 days if selector not found

Users can now see cost avoidance for different time windows to track
governance ROI trends over various periods.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:20:11 +13:00
TheFlow
70f02ec932 feat(bi): add interactive sliders to cost configuration modal
Enhanced cost configuration UX with dual-control interface:
- Range sliders for quick visual adjustments
- Number inputs for precise values
- Real-time sync between slider and input
- Live value display with formatting ($X,XXX)
- Custom purple styling matching Tractatus theme

Slider ranges by severity:
- CRITICAL: $1k-$250k (step: $1k)
- HIGH: $500-$50k (step: $500)
- MEDIUM: $100-$10k (step: $100)
- LOW: $50-$5k (step: $50)

Users can drag sliders OR type exact amounts for maximum flexibility.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:16:21 +13:00
TheFlow
ad5aceeec5 fix(bi): use correct auth token key for cost-config API calls
Fixed authentication issue where loadCostConfig() and saveCostConfig()
were using wrong localStorage key 'tractatus_token' instead of
'admin_token' (accessed via getAuthToken()).

This caused "jwt malformed" 401 errors because:
- audit-logs endpoint: uses admin_token (works ✓)
- cost-config endpoint: was using tractatus_token (broken ✗)

Changed both functions to use getAuthToken() for consistency.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:13:05 +13:00
TheFlow
49fe809cbd fix(bi): resolve remaining totalCount reference in ROI projections
Fixed ReferenceError in enterprise scaling projections.

Changed totalCount to auditData.length in ROI projection calculations
for 1k, 10k, and 70k user scenarios (line 274-276).

Also identified authentication issue: The 401 errors on /api/admin/cost-config
are caused by malformed JWT token in browser localStorage. Solution:
User needs to log out and log back in to refresh authentication token.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 10:57:33 +13:00
TheFlow
4920a4a99e feat(bi): add business intelligence dashboard and cost configuration UI
Implements BI analytics dashboard with interactive cost configuration:

Dashboard Features:
- Risk Management ROI Platform section with gradient styling
- Cost avoidance tracking with configurable factors
- Framework maturity score visualization (0-100 with progress bar)
- Team performance comparison (AI-assisted vs human-direct)
- Activity type breakdown with risk indicators
- Enterprise scaling projections display

Cost Configuration Modal:
- User-configurable cost factors for all severity levels
- Currency and rationale fields for each tier
- Research disclaimer prominently displayed
- API integration for load/save operations
- Auto-refresh dashboard after configuration changes

Technical Improvements:
- Fixed JavaScript error: totalCount undefined (now uses auditData.length)
- Made renderBusinessIntelligence() async for API cost factor loading
- Added complete event handling for configure costs button
- Fallback to default values if API unavailable

UI/UX:
- Purple gradient theme for BI features
- Responsive modal design with validation
- Clear visual indicators for research prototype status

Status: v1.0 Research Prototype

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 10:07:52 +13:00
TheFlow
4f889b073c fix(audit): fix timeline chart rendering with pixel heights and count labels
Fixed broken "Decisions Over Time" chart that wasn't displaying bars.

Root cause: Empty divs with percentage heights collapsed in flex containers.

Fixes applied:
1. **Pixel heights instead of percentages**
   - Calculate absolute pixel heights from h-48 container (192px)
   - Percentage heights don't work in flex containers with items-end

2. **Non-breaking space inside bars**
   - Added &nbsp; to prevent empty div collapse
   - Even with height set, empty divs can collapse in some layouts

3. **Decision count labels**
   - Display count above each bar for exact numbers
   - Shows both visual proportion (bar height) and exact value (label)

4. **Minimum 10px height**
   - Ensures small values are always visible
   - Prevents bars from disappearing for low counts

5. **Wider bars**
   - Changed from max-w-16 (64px) to w-3/4 (75% width)
   - More visible and easier to interact with

Timeline modes working:
-  6-Hourly (24h) - 4 bars showing last 24 hours in 6-hour buckets
-  Daily (7d) - 7 bars showing last 7 days
-  Weekly (4w) - 4 bars showing last 4 weeks

All modes show current snapshot updated on refresh.

Files changed:
- public/js/admin/audit-analytics.js: Timeline rendering logic
- public/admin/audit-analytics.html: Updated cache version
- public/*.html: Cache version bump for consistency

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 12:22:55 +13:00
TheFlow
6a9c02cfd8 fix(audit): add missing renderAuditTable() call to renderDashboard()
The Recent Decisions table was not loading because renderAuditTable()
was not being called in the renderDashboard() function.

Added renderAuditTable() call to ensure the table renders with the
10 most recent decisions.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 11:50:54 +13:00
TheFlow
485ce6df0e feat(audit): comprehensive audit analytics dashboard improvements
Implemented improvements from AUDIT_ANALYTICS_IMPROVEMENTS.md:

1. Added Service Health (24h) section:
   - Shows which services are healthy (allowed, no violations)
   - Green/red status indicators per service
   - Displays allowed, blocked, and violation counts

2. Added Violations & Blocks (7 days) section:
   - Long-term view of violations and blocks
   - Shows only days with issues
   - Displays "No violations" message when clean
   - Lists services involved in violations

3. Fixed Timeline Chart with proper time bucketing:
   - Replaced broken hour-of-day aggregation
   - Added 3 modes: 6-hourly (24h), Daily (7d), Weekly (4w)
   - Proper date-based bucketing instead of hour grouping
   - Interactive mode switching with CSP-compliant event delegation

4. Simplified Recent Decisions table:
   - Reduced from 50 to 10 most recent decisions
   - Updated heading to clarify scope

All changes are CSP-compliant (no inline styles/handlers, Tailwind only).

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 11:46:15 +13:00
TheFlow
649eda71e1 chore: bump cache version to 0.1.1 for JS changes 2025-10-25 08:47:54 +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
0decd9882d feat(csp): add event delegation for all admin interactions
SUMMARY:
 Restored full admin functionality with CSP-compliant event handling
 All onclick/onchange handlers now use addEventListener
 Zero CSP violations maintained

CHANGES:

Added event delegation listeners to all admin JavaScript files:
- dashboard.js: approveItem, rejectItem, deleteUser, deleteDocument
- rule-manager.js: viewRule, editRule, deleteRule, goToPage
- project-manager.js: viewProject, editProject, manageVariables, deleteProject
- project-editor.js: editVariable, deleteVariable
- rule-editor.js: editRule, remove-parent
- audit-analytics.js: showDecisionDetails
- claude-md-migrator.js: toggleCandidate

TECHNICAL APPROACH:

Pattern: data-action attributes → addEventListener delegation
- Removed: onclick="functionName('arg')"
- Added: data-action="functionName" data-arg0="arg"
- Handler: document.addEventListener('click', delegation logic)

Benefits:
1. CSP compliant (no unsafe-inline)
2. Single event listener per file (performance)
3. Works with dynamic content
4. Maintains existing function signatures

Implementation:
- Use event.target.closest('[data-action]') for bubbling
- Extract action and arguments from data attributes
- Switch statement to route to appropriate functions
- Special handling for remove-parent (common pattern)

TESTING:
✓ CSP scanner confirms zero violations
✓ Public pages load correctly (/, /about, /researcher, /docs)
✓ Event delegation architecture in place

NOTE: Admin pages need testing with actual user interactions
to verify button clicks work correctly. The infrastructure is
complete but requires manual QA.

AUTOMATION:
Created scripts/add-event-delegation.js for automated addition
of event delegation patterns to admin files.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 13:36:53 +13:00
TheFlow
1960ccd155 fix(csp): achieve 100% CSP compliance - zero violations
SUMMARY:
 Fixed all 114 CSP violations (100% complete)
 All pages now fully CSP-compliant
 Zero inline styles, scripts, or unsafe-inline code

MILESTONE: Complete CSP compliance across entire codebase

CHANGES IN THIS SESSION:

Sprint 1 (commit 31345d5):
- Fixed 75 violations in public-facing pages
- Added 40+ utility classes to tractatus-theme.css
- Fixed all HTML files and coming-soon-overlay.js

Sprint 2 (this commit):
- Fixed remaining 39 violations in admin/* files
- Converted all inline styles to classes/data-attributes
- Replaced all inline event handlers with data-action attributes
- Added programmatic width/height setters for progress bars

FILES MODIFIED:

1. CSS Infrastructure:
   - tractatus-theme.css: Added auth-error-* classes
   - tractatus-theme.min.css: Auto-regenerated (39.5% smaller)

2. Admin JavaScript (39 violations → 0):
   - audit-analytics.js: Fixed 3 (1 event, 2 styles)
   - auth-check.js: Fixed 6 (6 styles → classes)
   - claude-md-migrator.js: Fixed 2 (2 onchange → data-change-action)
   - dashboard.js: Fixed 4 (4 onclick → data-action)
   - project-editor.js: Fixed 4 (4 onclick → data-action)
   - project-manager.js: Fixed 5 (5 onclick → data-action)
   - rule-editor.js: Fixed 9 (2 onclick + 7 styles)
   - rule-manager.js: Fixed 6 (4 onclick + 2 styles)

3. Automation Scripts Created:
   - scripts/fix-admin-csp-violations.js
   - scripts/fix-admin-event-handlers.js
   - scripts/add-progress-bar-helpers.js

TECHNICAL APPROACH:

Inline Styles (16 fixed):
- Static styles → CSS utility classes (.auth-error-*)
- Dynamic widths → data-width attributes + programmatic style.width
- Progress bars → setProgressBarWidths() helper function

Inline Event Handlers (23 fixed):
- onclick="func(arg)" → data-action="func" data-arg0="arg"
- onchange="func()" → data-change-action="func"
- this.parentElement.remove() → data-action="remove-parent"

NOTE: Event delegation listeners need to be added for admin
functionality. The violations are eliminated, but the event
handlers need to be wired up via addEventListener.

TESTING:
✓ Homepage and public pages load correctly
✓ CSP scanner confirms zero violations
✓ No console errors on public pages

SECURITY IMPACT:
- Eliminates all inline script/style injection vectors
- Full CSP compliance enables strict Content-Security-Policy header
- Both public and admin attack surfaces now hardened

FRAMEWORK COMPLIANCE:
Fully addresses inst_008 (CSP compliance requirement)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 13:32:24 +13:00
TheFlow
c417f5b7d6 feat: enhance framework services and format architectural documentation
Framework Service Enhancements:
- ContextPressureMonitor: Enhanced statistics tracking and contextual adjustments
- InstructionPersistenceClassifier: Improved context integration and consistency
- MetacognitiveVerifier: Extended verification capabilities and logging
- All services: 182 unit tests passing

Admin Interface Improvements:
- Blog curation: Enhanced content management and validation
- Audit analytics: Improved analytics dashboard and reporting
- Dashboard: Updated metrics and visualizations

Documentation:
- Architectural overview: Improved markdown formatting for readability
- Added blank lines between sections for better structure
- Fixed table formatting for version history

All tests passing: Framework stable for deployment

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-11 00:50:47 +13:00
TheFlow
fdd2df6fcb feat: Session 3 - Audit analytics dashboard
Created comprehensive audit analytics dashboard for monitoring governance
decisions from MemoryProxy audit trail.

Features:
- Real-time dashboard with summary metrics
- Decisions by action type (bar chart)
- Timeline visualization (hourly distribution)
- Recent decisions table with filtering
- Apache 2.0 licensed

Components:
- Frontend: /admin/audit-analytics.html
- JavaScript: /js/admin/audit-analytics.js
- Backend API: /api/admin/audit-logs
- Backend API: /api/admin/audit-analytics

Metrics Displayed:
- Total decisions count
- Allowed rate percentage
- Violations count
- Active services count

Visualizations:
- Action type distribution
- Timeline (decisions over time)
- Recent decisions log (last 50)

Session 3 Achievement: Advanced monitoring and insights for governance framework

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-10 13:05:14 +13:00