3aae86edf9
## Implementer Page Enhancements ### Hero Section Redesign - Changed title to "External Governance Services for AI Systems" - Added three value proposition cards (Architectural Separation, Instruction Persistence, Audit Trail) - Governance-compliant messaging (addresses vs prevents, designed to vs guarantees) - Mobile-responsive card layout ### New "How It Works" Section - Pattern Override Challenge explanation - External Architecture Approach - Request Flow with Governance diagram - SVG download links ### New "Hook Architecture" Section (Credibility Layer) - Architectural enforcement explanation - Four real enforcement examples: * inst_084 GitHub URL Protection * inst_008 CSP Compliance * inst_027 Governance file protection * BoundaryEnforcer values decisions - New hook-architecture.svg diagram showing PreToolUse flow - Process separation and exit code enforcement details ### Deployment Section Improvements - Removed broken "View Online" button - PDF-only deployment guide download - Simplified, cleaner presentation ### Responsive Diagrams - Created system-architecture-mobile.svg (400x600px simplified) - Created system-architecture-desktop.svg (full detail) - Picture element with media queries for responsive switching - Fixed request-flow-sequence.svg (restored from archive) ## Security & Governance ### inst_084 GitHub URL Modification Protocol - HARD BLOCK on GitHub URL changes without explicit approval - Prevents accidental private repository exposure - Implemented in both validate-file-edit.js and validate-file-write.js - Regex pattern matching for repository name changes - Detailed error messages with context ### Hook Validator Improvements - Fixed stderr output issue (console.log → console.error) - Added checkGitHubURLProtection() function - Enhanced error messaging for blocked actions ## Documentation ### New Deployment Guide - Created comprehensive 14KB markdown guide (docs/markdown/deployment-guide.md) - Generated 284KB PDF (public/docs/pdfs/deployment-guide.pdf) - Covers: local dev, production, Docker, K8s, AWS, GCP, monitoring, security - Removed MongoDB credential examples to comply with inst_069/070 ### Diagram Archive - Moved old diagrams to public/docs/diagrams/archive/ - Preserved deployment-architecture-old.svg - Preserved request-flow-sequence-old.svg - Preserved system-architecture-old.svg ## Cache & Version - Bumped version to 0.1.2 - Updated changelog with all implementer changes - forceUpdate: true for new diagrams and PDFs - minVersion: 0.1.4 ## Context This addresses user feedback on implementer.html from 2025-10-26: - Broken diagrams (404 errors, cut off at bottom) - Need for credibility layer (hook architecture) - GitHub URL security incident prevention - Mobile responsiveness issues - Deployment guide accessibility 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
91 lines
4.9 KiB
XML
91 lines
4.9 KiB
XML
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 600">
|
|
<defs>
|
|
<style>
|
|
.component { fill: #fff; stroke: #2563eb; stroke-width: 2; }
|
|
.service { fill: #dbeafe; stroke: #1e40af; stroke-width: 2; }
|
|
.data { fill: #1e293b; stroke: #0f172a; stroke-width: 2; }
|
|
.text { fill: #1e293b; font-family: Arial, sans-serif; font-size: 14px; }
|
|
.label { fill: #1e293b; font-family: Arial, sans-serif; font-size: 12px; font-weight: bold; }
|
|
.small { fill: #64748b; font-family: Arial, sans-serif; font-size: 10px; }
|
|
.arrow { stroke: #475569; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
|
|
.section-label { fill: #475569; font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; }
|
|
</style>
|
|
<marker id="arrowhead" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto">
|
|
<polygon points="0 0, 10 3, 0 6" fill="#475569" />
|
|
</marker>
|
|
</defs>
|
|
|
|
<!-- Application Layer -->
|
|
<text x="400" y="30" class="section-label" text-anchor="middle">Application Layer</text>
|
|
<rect x="300" y="50" width="200" height="60" class="component" rx="5"/>
|
|
<text x="400" y="75" class="label" text-anchor="middle">AI Application</text>
|
|
<text x="400" y="95" class="small" text-anchor="middle">Claude Code / Custom LLM</text>
|
|
|
|
<!-- Governance Layer -->
|
|
<text x="400" y="160" class="section-label" text-anchor="middle">Tractatus Governance Layer</text>
|
|
|
|
<!-- Row 1: 3 services -->
|
|
<rect x="50" y="190" width="180" height="70" class="service" rx="5"/>
|
|
<text x="140" y="215" class="label" text-anchor="middle">BoundaryEnforcer</text>
|
|
<text x="140" y="235" class="small" text-anchor="middle">Values Decisions</text>
|
|
<text x="140" y="250" class="small" text-anchor="middle">(Tractatus 12.1-12.7)</text>
|
|
|
|
<rect x="310" y="190" width="180" height="70" class="service" rx="5"/>
|
|
<text x="400" y="215" class="label" text-anchor="middle">InstructionPersistence</text>
|
|
<text x="400" y="235" class="small" text-anchor="middle">Classifier</text>
|
|
<text x="400" y="250" class="small" text-anchor="middle">(Quadrant + Persistence)</text>
|
|
|
|
<rect x="570" y="190" width="180" height="70" class="service" rx="5"/>
|
|
<text x="660" y="215" class="label" text-anchor="middle">CrossReference</text>
|
|
<text x="660" y="235" class="small" text-anchor="middle">Validator</text>
|
|
<text x="660" y="250" class="small" text-anchor="middle">(Pattern Override Prevention)</text>
|
|
|
|
<!-- Row 2: 3 services -->
|
|
<rect x="50" y="290" width="180" height="70" class="service" rx="5"/>
|
|
<text x="140" y="315" class="label" text-anchor="middle">ContextPressure</text>
|
|
<text x="140" y="335" class="small" text-anchor="middle">Monitor</text>
|
|
<text x="140" y="350" class="small" text-anchor="middle">(Token & Complexity)</text>
|
|
|
|
<rect x="310" y="290" width="180" height="70" class="service" rx="5"/>
|
|
<text x="400" y="315" class="label" text-anchor="middle">Metacognitive</text>
|
|
<text x="400" y="335" class="small" text-anchor="middle">Verifier</text>
|
|
<text x="400" y="350" class="small" text-anchor="middle">(Confidence Scoring)</text>
|
|
|
|
<rect x="570" y="290" width="180" height="70" class="service" rx="5"/>
|
|
<text x="660" y="315" class="label" text-anchor="middle">Pluralistic</text>
|
|
<text x="660" y="335" class="small" text-anchor="middle">Deliberation</text>
|
|
<text x="660" y="350" class="small" text-anchor="middle">(Multi-Stakeholder)</text>
|
|
|
|
<!-- Data Layer -->
|
|
<text x="400" y="410" class="section-label" text-anchor="middle">Data Layer</text>
|
|
|
|
<rect x="200" y="440" width="180" height="80" class="service" rx="5"/>
|
|
<text x="290" y="465" class="label" text-anchor="middle">MemoryProxy v3</text>
|
|
<text x="290" y="485" class="small" text-anchor="middle">Hybrid Storage</text>
|
|
<text x="290" y="505" class="small" text-anchor="middle">(MongoDB + Optional API)</text>
|
|
|
|
<rect x="420" y="440" width="180" height="80" class="data" rx="5"/>
|
|
<text x="510" y="465" class="label" text-anchor="middle" fill="#fff">MongoDB</text>
|
|
<text x="510" y="485" class="small" text-anchor="middle" fill="#94a3b8">Instructions Database</text>
|
|
<text x="510" y="505" class="small" text-anchor="middle" fill="#94a3b8">Audit Logs</text>
|
|
|
|
<!-- Arrows -->
|
|
<!-- Application to Services -->
|
|
<path d="M 400 110 L 140 190" class="arrow"/>
|
|
<path d="M 400 110 L 400 190" class="arrow"/>
|
|
<path d="M 400 110 L 660 190" class="arrow"/>
|
|
|
|
<!-- Services to MemoryProxy -->
|
|
<path d="M 140 260 L 250 440" class="arrow"/>
|
|
<path d="M 400 260 L 320 440" class="arrow"/>
|
|
<path d="M 660 260 L 350 440" class="arrow"/>
|
|
<path d="M 140 360 L 270 440" class="arrow"/>
|
|
<path d="M 400 360 L 290 440" class="arrow"/>
|
|
<path d="M 660 360 L 340 440" class="arrow"/>
|
|
|
|
<!-- MemoryProxy to MongoDB -->
|
|
<path d="M 380 480 L 420 480" class="arrow"/>
|
|
|
|
<!-- Legend -->
|
|
<text x="50" y="570" class="small" fill="#64748b">6 Governance Services • Persistent Storage • Production-Tested Architecture</text>
|
|
</svg>
|