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>
64 lines
3.7 KiB
XML
64 lines
3.7 KiB
XML
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 600">
|
|
<defs>
|
|
<style>
|
|
.layer { fill: #fff; stroke: #2563eb; stroke-width: 2; rx: 8; }
|
|
.layer-agent { fill: #dbeafe; stroke: #3b82f6; stroke-width: 3; }
|
|
.layer-governance { fill: #f0fdf4; stroke: #10b981; stroke-width: 3; }
|
|
.layer-storage { fill: #fef9c3; stroke: #eab308; stroke-width: 2; }
|
|
.layer-human { fill: #fce7f3; stroke: #ec4899; stroke-width: 3; }
|
|
.label { fill: #1e293b; font-family: Arial, sans-serif; font-size: 14px; font-weight: bold; text-anchor: middle; }
|
|
.sublabel { fill: #64748b; font-family: Arial, sans-serif; font-size: 11px; text-anchor: middle; }
|
|
.arrow { stroke: #64748b; stroke-width: 2; fill: none; marker-end: url(#arrow); }
|
|
.title { fill: #0f172a; font-family: Arial, sans-serif; font-size: 16px; font-weight: bold; text-anchor: middle; }
|
|
</style>
|
|
<marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto">
|
|
<polygon points="0 0, 8 4, 0 8" fill="#64748b" />
|
|
</marker>
|
|
</defs>
|
|
|
|
<text x="200" y="25" class="title">Tractatus Architecture</text>
|
|
<text x="200" y="42" class="sublabel">(Simplified View)</text>
|
|
|
|
<rect x="30" y="70" width="340" height="90" class="layer-agent" rx="8"/>
|
|
<text x="200" y="95" class="label">Agent Runtime Layer</text>
|
|
<text x="200" y="115" class="sublabel">LangChain • AutoGPT • CrewAI</text>
|
|
<text x="200" y="130" class="sublabel">Claude Code • Custom Agents</text>
|
|
<text x="200" y="145" class="sublabel">Tool Use • Planning • Execution</text>
|
|
|
|
<path d="M 200 160 L 200 190" class="arrow"/>
|
|
<text x="250" y="180" class="sublabel">Governance checks</text>
|
|
|
|
<rect x="30" y="190" width="340" height="120" class="layer-governance" rx="8"/>
|
|
<text x="200" y="215" class="label">Tractatus Governance Layer</text>
|
|
<text x="200" y="235" class="sublabel">6 External Services:</text>
|
|
<text x="200" y="252" class="sublabel">BoundaryEnforcer • CrossReference</text>
|
|
<text x="200" y="267" class="sublabel">InstructionPersistence • ContextPressure</text>
|
|
<text x="200" y="282" class="sublabel">Metacognitive • PluralisticDeliberation</text>
|
|
<text x="200" y="299" class="sublabel" fill="#ef4444">⚠ External architecture</text>
|
|
|
|
<path d="M 200 310 L 200 340" class="arrow"/>
|
|
<text x="250" y="330" class="sublabel">Audit logging</text>
|
|
|
|
<rect x="30" y="340" width="340" height="100" class="layer-storage" rx="8"/>
|
|
<text x="200" y="365" class="label">Persistent Storage Layer</text>
|
|
<text x="200" y="385" class="sublabel">MongoDB Collections:</text>
|
|
<text x="200" y="402" class="sublabel">governance_rules • audit_logs</text>
|
|
<text x="200" y="417" class="sublabel">instruction_history • session_state</text>
|
|
<text x="200" y="432" class="sublabel" fill="#ef4444">Audit trail design</text>
|
|
|
|
<path d="M 100 310 L 60 340 L 60 460 L 100 480" class="arrow"/>
|
|
<text x="20" y="390" class="sublabel" fill="#ec4899">Boundary</text>
|
|
<text x="20" y="405" class="sublabel" fill="#ec4899">violations</text>
|
|
|
|
<path d="M 100 490 L 60 500 L 60 430 L 100 320" class="arrow"/>
|
|
<text x="15" y="455" class="sublabel" fill="#ec4899">Approval/</text>
|
|
<text x="15" y="470" class="sublabel" fill="#ec4899">Rejection</text>
|
|
|
|
<rect x="30" y="480" width="340" height="90" class="layer-human" rx="8"/>
|
|
<text x="200" y="505" class="label">Human Oversight</text>
|
|
<text x="200" y="525" class="sublabel">Values Decisions</text>
|
|
<text x="200" y="540" class="sublabel">Strategic Changes • Boundary Violations</text>
|
|
<text x="200" y="560" class="sublabel" style="font-style: italic;">Final authority on incommensurable values</text>
|
|
|
|
<text x="200" y="590" class="sublabel" fill="#64748b">View full diagram for details →</text>
|
|
</svg>
|