901 lines
34 KiB
HTML
901 lines
34 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
|
|
<meta http-equiv="Pragma" content="no-cache">
|
|
<meta http-equiv="Expires" content="0">
|
|
<title>Framework Documentation | Tractatus AI Safety</title>
|
|
<meta name="description" content="Comprehensive documentation for the Tractatus AI Safety Framework - external governance services for Claude Code and agentic AI systems. Learn about instruction persistence, boundary enforcement, and pluralistic deliberation.">
|
|
|
|
<!-- Open Graph / Facebook -->
|
|
<meta property="og:type" content="website">
|
|
<meta property="og:url" content="https://agenticgovernance.digital/docs.html">
|
|
<meta property="og:title" content="Documentation | Tractatus Framework">
|
|
<meta property="og:description" content="Implementation guides, API reference, and operational examples of architectural AI governance constraints.">
|
|
<meta property="og:image" content="https://agenticgovernance.digital/images/social-preview.png">
|
|
<meta property="og:image:width" content="1200">
|
|
<meta property="og:image:height" content="630">
|
|
<meta property="og:site_name" content="Tractatus Framework">
|
|
<meta property="og:see_also" content="https://www.facebook.com/agenticgovernance">
|
|
|
|
<!-- Twitter -->
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:url" content="https://agenticgovernance.digital/docs.html">
|
|
<meta name="twitter:title" content="Documentation | Tractatus Framework">
|
|
<meta name="twitter:description" content="Implementation guides, API reference, and operational examples of architectural AI governance constraints.">
|
|
<meta name="twitter:image" content="https://agenticgovernance.digital/images/social-preview.png">
|
|
<link rel="icon" type="image/svg+xml" href="/favicon-new.svg">
|
|
|
|
<!-- PWA Manifest -->
|
|
<link rel="manifest" href="/manifest.json">
|
|
|
|
<!-- PWA Meta Tags -->
|
|
<meta name="theme-color" content="#3b82f6">
|
|
<meta name="apple-mobile-web-app-capable" content="yes">
|
|
<meta name="apple-mobile-web-app-status-bar-style" content="default">
|
|
<meta name="apple-mobile-web-app-title" content="Tractatus">
|
|
<link rel="apple-touch-icon" href="/images/tractatus-icon-new.svg">
|
|
|
|
<!-- Preload critical fonts for faster initial render -->
|
|
<link rel="preload" href="/fonts/inter-400.woff2" as="font" type="font/woff2" crossorigin>
|
|
<link rel="preload" href="/fonts/inter-700.woff2" as="font" type="font/woff2" crossorigin>
|
|
|
|
<link rel="stylesheet" href="/css/fonts.css?v=0.1.2.1770432766670">
|
|
<link rel="stylesheet" href="/css/tailwind.css?v=0.1.2.1770432766670">
|
|
<link rel="stylesheet" href="/css/tractatus-theme.min.css?v=0.1.2.1770432766670">
|
|
<style>
|
|
html { scroll-behavior: smooth; }
|
|
|
|
/* Accessibility: Skip link */
|
|
.skip-link { position: absolute; left: -9999px; top: 0; }
|
|
.skip-link:focus { left: 0; z-index: 100; background: white; padding: 1rem; border: 2px solid #3b82f6; }
|
|
|
|
/* Accessibility: Focus indicators (WCAG 2.4.7) */
|
|
a:focus, button:focus, input:focus, select:focus, textarea:focus {
|
|
outline: 3px solid #3b82f6;
|
|
outline-offset: 2px;
|
|
}
|
|
a:focus:not(:focus-visible) { outline: none; }
|
|
a:focus-visible { outline: 3px solid #3b82f6; outline-offset: 2px; }
|
|
|
|
/* Card-based layout */
|
|
.doc-header {
|
|
text-align: center;
|
|
padding: 2rem 0;
|
|
}
|
|
|
|
.card-grid-container {
|
|
width: 100%;
|
|
overflow: visible;
|
|
min-height: auto;
|
|
}
|
|
|
|
.category-section {
|
|
margin-bottom: 2rem;
|
|
}
|
|
|
|
.card-grid {
|
|
display: grid;
|
|
gap: 1rem;
|
|
width: 100%;
|
|
}
|
|
|
|
@media (min-width: 768px) {
|
|
.card-grid {
|
|
grid-template-columns: repeat(2, 1fr);
|
|
}
|
|
}
|
|
|
|
@media (min-width: 1024px) {
|
|
.card-grid {
|
|
grid-template-columns: repeat(3, 1fr);
|
|
}
|
|
}
|
|
|
|
.doc-card {
|
|
min-height: 180px;
|
|
display: flex;
|
|
flex-direction: column;
|
|
transition: all 0.2s ease;
|
|
cursor: pointer;
|
|
user-select: none;
|
|
}
|
|
|
|
.doc-card:hover {
|
|
transform: translateY(-2px);
|
|
box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
|
|
}
|
|
|
|
.doc-card:active {
|
|
transform: translateY(0);
|
|
}
|
|
|
|
.line-clamp-3 {
|
|
display: -webkit-box;
|
|
-webkit-line-clamp: 3;
|
|
-webkit-box-orient: vertical;
|
|
overflow: hidden;
|
|
}
|
|
|
|
/* Prose styles for modal content */
|
|
.prose {
|
|
max-width: none;
|
|
line-height: 1.75;
|
|
color: #374151;
|
|
}
|
|
|
|
.prose h1 {
|
|
font-size: 1.875rem;
|
|
font-weight: 700;
|
|
color: #111827;
|
|
margin-bottom: 1.5rem;
|
|
margin-top: 2rem;
|
|
line-height: 1.2;
|
|
border-bottom: 2px solid #e5e7eb;
|
|
padding-bottom: 0.5rem;
|
|
}
|
|
|
|
.prose h2 {
|
|
font-size: 1.5rem;
|
|
font-weight: 600;
|
|
color: #111827;
|
|
margin-bottom: 1rem;
|
|
margin-top: 2rem;
|
|
line-height: 1.3;
|
|
border-bottom: 1px solid #e5e7eb;
|
|
padding-bottom: 0.375rem;
|
|
}
|
|
|
|
.prose h3 {
|
|
font-size: 1.25rem;
|
|
font-weight: 600;
|
|
color: #1f2937;
|
|
margin-bottom: 0.75rem;
|
|
margin-top: 1.5rem;
|
|
line-height: 1.4;
|
|
}
|
|
|
|
.prose h4 {
|
|
font-size: 1.125rem;
|
|
font-weight: 600;
|
|
color: #374151;
|
|
margin-bottom: 0.5rem;
|
|
margin-top: 1.25rem;
|
|
line-height: 1.5;
|
|
}
|
|
|
|
.prose p {
|
|
color: #4b5563;
|
|
margin-bottom: 1.25rem;
|
|
line-height: 1.8;
|
|
font-size: 1rem;
|
|
}
|
|
|
|
.prose li {
|
|
margin-bottom: 0.5rem;
|
|
line-height: 1.75;
|
|
color: #4b5563;
|
|
}
|
|
|
|
.prose code {
|
|
background-color: #f3f4f6;
|
|
padding: 0.125rem 0.375rem;
|
|
border-radius: 0.25rem;
|
|
font-size: 0.875rem;
|
|
font-family: ui-monospace, 'Courier New', monospace;
|
|
color: #1f2937;
|
|
border: 1px solid #e5e7eb;
|
|
}
|
|
|
|
.prose pre {
|
|
background-color: #1f2937;
|
|
color: #f3f4f6;
|
|
padding: 1.25rem;
|
|
border-radius: 0.5rem;
|
|
margin-bottom: 1.5rem;
|
|
overflow-x: auto;
|
|
border: 1px solid #374151;
|
|
}
|
|
|
|
.prose pre code {
|
|
background-color: transparent;
|
|
padding: 0;
|
|
border: none;
|
|
color: inherit;
|
|
font-size: 0.875rem;
|
|
}
|
|
|
|
.prose ul {
|
|
list-style-type: disc;
|
|
padding-left: 1.75rem;
|
|
margin-bottom: 1.25rem;
|
|
color: #4b5563;
|
|
}
|
|
|
|
.prose ol {
|
|
list-style-type: decimal;
|
|
padding-left: 1.75rem;
|
|
margin-bottom: 1.25rem;
|
|
color: #4b5563;
|
|
}
|
|
|
|
.prose > h2:first-child {
|
|
margin-top: 0;
|
|
}
|
|
|
|
/* Download links in sidebar */
|
|
.doc-download-link {
|
|
position: absolute;
|
|
right: 0.5rem;
|
|
top: 50%;
|
|
transform: translateY(-50%);
|
|
padding: 0.5rem;
|
|
color: #3b82f6;
|
|
background-color: transparent;
|
|
border-radius: 0.25rem;
|
|
transition: all 0.15s ease-in-out;
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
text-decoration: none;
|
|
z-index: 10;
|
|
}
|
|
|
|
.doc-download-link:hover {
|
|
color: #1d4ed8;
|
|
background-color: #dbeafe;
|
|
}
|
|
|
|
.doc-download-link svg {
|
|
width: 1.25rem;
|
|
height: 1.25rem;
|
|
display: block;
|
|
}
|
|
|
|
/* Document list container - prevent CLS */
|
|
#document-list {
|
|
min-height: 800px; /* Reserve space for ~40 documents to prevent layout shift */
|
|
contain: layout; /* Isolate layout calculations */
|
|
}
|
|
|
|
#document-list .relative,
|
|
#document-list > div {
|
|
position: relative !important;
|
|
}
|
|
|
|
.doc-link {
|
|
padding-right: 3rem !important;
|
|
display: block;
|
|
width: 100%;
|
|
}
|
|
|
|
/* Modal styles */
|
|
#section-modal {
|
|
position: fixed;
|
|
inset: 0;
|
|
background-color: rgba(0, 0, 0, 0.5);
|
|
z-index: 9999;
|
|
display: none;
|
|
align-items: center;
|
|
justify-content: center;
|
|
padding: 1rem;
|
|
}
|
|
|
|
#section-modal.show {
|
|
display: flex !important;
|
|
animation: fadeIn 0.2s ease-out;
|
|
}
|
|
|
|
#section-modal > div {
|
|
display: flex;
|
|
flex-direction: column;
|
|
max-height: 90vh;
|
|
width: 100%;
|
|
max-width: 56rem;
|
|
background-color: white;
|
|
border-radius: 0.5rem;
|
|
box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
|
|
animation: slideUp 0.3s ease-out;
|
|
}
|
|
|
|
#modal-content {
|
|
flex: 1 1 0%;
|
|
overflow-y: auto;
|
|
overflow-x: hidden;
|
|
padding: 1.5rem;
|
|
min-height: 0;
|
|
}
|
|
|
|
@keyframes fadeIn {
|
|
from {
|
|
opacity: 0;
|
|
}
|
|
to {
|
|
opacity: 1;
|
|
}
|
|
}
|
|
|
|
@keyframes slideUp {
|
|
from {
|
|
transform: translateY(20px);
|
|
opacity: 0;
|
|
}
|
|
to {
|
|
transform: translateY(0);
|
|
opacity: 1;
|
|
}
|
|
}
|
|
|
|
/* ToC Modal */
|
|
#toc-modal {
|
|
display: none;
|
|
}
|
|
|
|
#toc-modal.show {
|
|
display: flex !important;
|
|
position: fixed !important;
|
|
top: 0 !important;
|
|
left: 0 !important;
|
|
right: 0 !important;
|
|
bottom: 0 !important;
|
|
animation: fadeIn 0.2s ease-out forwards;
|
|
background: rgba(0, 0, 0, 0.5) !important;
|
|
}
|
|
|
|
#toc-modal.show > div {
|
|
animation: slideUp 0.3s ease-out forwards;
|
|
opacity: 1 !important;
|
|
}
|
|
|
|
/* ToC modal content scrolling */
|
|
#toc-modal-content {
|
|
max-height: 60vh;
|
|
overflow-y: auto;
|
|
overflow-x: hidden;
|
|
}
|
|
|
|
/* Custom scrollbar for ToC modal */
|
|
#toc-modal-content::-webkit-scrollbar {
|
|
width: 8px;
|
|
}
|
|
|
|
#toc-modal-content::-webkit-scrollbar-track {
|
|
background: #f1f1f1;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
#toc-modal-content::-webkit-scrollbar-thumb {
|
|
background: #cbd5e1;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
#toc-modal-content::-webkit-scrollbar-thumb:hover {
|
|
background: #94a3b8;
|
|
}
|
|
|
|
/* Category collapsible sections */
|
|
.category-arrow {
|
|
transition: transform 0.2s ease;
|
|
}
|
|
|
|
/* Category icon sizing */
|
|
.category-icon {
|
|
font-size: 1.5rem;
|
|
line-height: 1;
|
|
}
|
|
|
|
/* Sidebar scrolling */
|
|
aside .bg-white {
|
|
max-height: calc(100vh - 120px);
|
|
overflow-y: auto;
|
|
overflow-x: hidden;
|
|
}
|
|
|
|
/* Custom scrollbar styling */
|
|
aside .bg-white::-webkit-scrollbar {
|
|
width: 8px;
|
|
}
|
|
|
|
aside .bg-white::-webkit-scrollbar-track {
|
|
background: #f1f1f1;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
aside .bg-white::-webkit-scrollbar-thumb {
|
|
background: #cbd5e1;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
aside .bg-white::-webkit-scrollbar-thumb:hover {
|
|
background: #94a3b8;
|
|
}
|
|
|
|
/* ToC modal indent levels (CSP compliant) */
|
|
.toc-indent-1 { padding-left: 12px; }
|
|
.toc-indent-2 { padding-left: 28px; }
|
|
.toc-indent-3 { padding-left: 44px; }
|
|
|
|
/* Search Modal */
|
|
#search-modal {
|
|
display: none;
|
|
}
|
|
|
|
#search-modal.show {
|
|
display: flex !important;
|
|
position: fixed !important;
|
|
top: 0 !important;
|
|
left: 0 !important;
|
|
right: 0 !important;
|
|
bottom: 0 !important;
|
|
animation: fadeIn 0.2s ease-out forwards;
|
|
background: rgba(0, 0, 0, 0.5) !important;
|
|
}
|
|
|
|
#search-modal.show > div {
|
|
animation: slideUp 0.3s ease-out forwards;
|
|
opacity: 1 !important;
|
|
}
|
|
|
|
/* Search modal content scrolling */
|
|
#search-modal-content {
|
|
max-height: 70vh;
|
|
overflow-y: auto;
|
|
overflow-x: hidden;
|
|
}
|
|
|
|
/* Custom scrollbar for search modal */
|
|
#search-modal-content::-webkit-scrollbar {
|
|
width: 8px;
|
|
}
|
|
|
|
#search-modal-content::-webkit-scrollbar-track {
|
|
background: #f1f1f1;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
#search-modal-content::-webkit-scrollbar-thumb {
|
|
background: #cbd5e1;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
#search-modal-content::-webkit-scrollbar-thumb:hover {
|
|
background: #94a3b8;
|
|
}
|
|
|
|
/* Mobile document viewer navigation */
|
|
@media (max-width: 1023px) {
|
|
/* Initially show sidebar, hide main content */
|
|
aside {
|
|
display: block;
|
|
}
|
|
|
|
main#document-viewer-main {
|
|
display: none;
|
|
}
|
|
|
|
/* When document is active, hide sidebar and show content */
|
|
body.document-active aside {
|
|
display: none;
|
|
}
|
|
|
|
body.document-active main#document-viewer-main {
|
|
display: block;
|
|
}
|
|
}
|
|
|
|
/* Back button styling (mobile only) */
|
|
#back-to-docs-btn {
|
|
display: none;
|
|
}
|
|
|
|
@media (max-width: 1023px) {
|
|
#back-to-docs-btn {
|
|
display: flex;
|
|
}
|
|
}
|
|
</style>
|
|
|
|
<!-- Auto-reload on service worker update -->
|
|
</head>
|
|
<body class="bg-gray-50">
|
|
|
|
<!-- Skip Link for Keyboard Navigation -->
|
|
<a href="#main-content" class="skip-link">Skip to main content</a>
|
|
|
|
<!-- Navigation (injected by navbar.js) -->
|
|
<script src="/js/components/navbar.js?v=0.1.2.1770432766670" defer></script>
|
|
|
|
<!-- Page Header -->
|
|
<div class="bg-white border-b border-gray-200">
|
|
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
|
|
<div class="flex items-center justify-between">
|
|
<div>
|
|
<h1 class="text-3xl font-bold text-gray-900">Framework Documentation</h1>
|
|
<p class="text-gray-600 mt-2">Technical specifications, guides, and reference materials</p>
|
|
</div>
|
|
<div class="flex items-center gap-3">
|
|
<!-- Search Button -->
|
|
<button type="button" id="open-search-modal-btn" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition flex items-center gap-2" aria-label="Open search">
|
|
<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
|
|
</svg>
|
|
<span>Search</span>
|
|
</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Search Results Panel (initially hidden) -->
|
|
<div id="search-results-panel" class="hidden bg-white border-b border-gray-200">
|
|
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
|
|
<div class="flex items-center justify-between mb-4">
|
|
<h2 class="text-lg font-semibold text-gray-900">Search Results</h2>
|
|
<button id="close-search-results" class="text-sm text-gray-600 hover:text-gray-900" aria-label="Close search results">
|
|
<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
</svg>
|
|
</button>
|
|
</div>
|
|
<div id="search-results-list" class="space-y-4">
|
|
<!-- Results will be populated here by JavaScript -->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Main Layout -->
|
|
<main id="main-content" class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
|
|
<div class="grid grid-cols-1 lg:grid-cols-4 gap-8">
|
|
|
|
<!-- Sidebar -->
|
|
<aside class="lg:col-span-1">
|
|
<div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4 sticky top-24">
|
|
<h3 class="font-semibold text-gray-900 mb-3">Documents</h3>
|
|
<div id="document-list" class="space-y-1">
|
|
<noscript>
|
|
<div class="text-sm text-gray-700 space-y-3">
|
|
<p class="font-medium">JavaScript is required to browse documentation interactively.</p>
|
|
<p>You can also access the documentation directly:</p>
|
|
<ul class="list-disc pl-5 space-y-1">
|
|
<li><a href="https://github.com/AgenticGovernance/tractatus-framework" class="text-blue-600 hover:underline">GitHub Repository</a></li>
|
|
<li><a href="/architecture.html" class="text-blue-600 hover:underline">Architecture Overview</a></li>
|
|
<li><a href="/implementer.html" class="text-blue-600 hover:underline">Implementation Guide</a></li>
|
|
<li><a href="/researcher.html" class="text-blue-600 hover:underline">Research Foundations</a></li>
|
|
<li><a href="/village-case-study.html" class="text-blue-600 hover:underline">Village Case Study</a></li>
|
|
</ul>
|
|
</div>
|
|
</noscript>
|
|
<div class="text-sm text-gray-500">Loading...</div>
|
|
</div>
|
|
|
|
<!-- GitHub Section -->
|
|
<div class="mt-6 pt-6 border-t border-gray-200">
|
|
<h3 class="font-semibold text-gray-900 mb-3 flex items-center gap-2">
|
|
<svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
|
|
<path fill-rule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clip-rule="evenodd"/>
|
|
</svg>
|
|
GitHub
|
|
</h3>
|
|
<div class="space-y-2">
|
|
<a href="https://github.com/AgenticGovernance/tractatus-framework"
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
class="flex items-center gap-2 p-2 rounded-lg hover:bg-gray-50 transition group">
|
|
<svg class="w-4 h-4 text-gray-600 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4"/>
|
|
</svg>
|
|
<div class="flex-1 min-w-0">
|
|
<div class="text-sm font-medium text-gray-900 group-hover:text-gray-700 transition">Public Repository</div>
|
|
<div class="text-xs text-gray-500">Source code, examples & contributions</div>
|
|
</div>
|
|
</a>
|
|
<a href="https://github.com/AgenticGovernance/tractatus-framework#readme"
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
class="flex items-center gap-2 p-2 rounded-lg hover:bg-gray-50 transition group">
|
|
<svg class="w-4 h-4 text-gray-600 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
</svg>
|
|
<div class="flex-1 min-w-0">
|
|
<div class="text-sm font-medium text-gray-900 group-hover:text-gray-700 transition">README & Quick Start</div>
|
|
<div class="text-xs text-gray-500">Installation and getting started guide</div>
|
|
</div>
|
|
</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</aside>
|
|
|
|
<!-- Main Content -->
|
|
<main id="document-viewer-main" class="lg:col-span-3">
|
|
<!-- Back to Documents Button (Mobile Only) -->
|
|
<button id="back-to-docs-btn"
|
|
class="mb-4 items-center gap-2 px-4 py-2 bg-white border border-gray-300 rounded-lg shadow-sm hover:bg-gray-50 transition"
|
|
aria-label="Back to documents list">
|
|
<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 19l-7-7 7-7"/>
|
|
</svg>
|
|
<span class="font-medium text-gray-700">Back to Documents</span>
|
|
</button>
|
|
|
|
<div id="document-content" class="bg-white rounded-lg shadow-sm border border-gray-200 p-8 overflow-x-hidden">
|
|
<noscript>
|
|
<div class="prose max-w-none">
|
|
<h2>Tractatus Framework Documentation</h2>
|
|
<p>This documentation viewer requires JavaScript to load and display documents interactively. Please enable JavaScript, or access the documentation through the links below:</p>
|
|
<h3>Core Documentation</h3>
|
|
<ul>
|
|
<li><a href="/architecture.html">System Architecture</a> — Five architectural principles and six governance services</li>
|
|
<li><a href="/implementer.html">Implementation Guide</a> — Technical integration guide with code examples</li>
|
|
<li><a href="/researcher.html">Research Foundations</a> — Philosophical and theoretical basis</li>
|
|
</ul>
|
|
<h3>Case Studies</h3>
|
|
<ul>
|
|
<li><a href="/village-case-study.html">Village Case Study</a> — Production deployment evidence</li>
|
|
<li><a href="/home-ai.html">Home AI / SLL</a> — Sovereign locally-trained language model</li>
|
|
</ul>
|
|
<h3>Research Papers</h3>
|
|
<ul>
|
|
<li><a href="/architectural-alignment.html">Academic Edition</a></li>
|
|
<li><a href="/architectural-alignment-community.html">Community Edition</a></li>
|
|
<li><a href="/architectural-alignment-policymakers.html">Policymakers Edition</a></li>
|
|
</ul>
|
|
<h3>Source Code</h3>
|
|
<ul>
|
|
<li><a href="https://github.com/AgenticGovernance/tractatus-framework">GitHub Repository</a> — Apache 2.0 licensed</li>
|
|
</ul>
|
|
</div>
|
|
</noscript>
|
|
<div class="text-center py-12">
|
|
<svg class="mx-auto h-12 w-12 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"/>
|
|
</svg>
|
|
<h3 id="select-document-heading" class="mt-2 text-lg font-medium text-gray-900">Select a Document</h3>
|
|
<p id="select-document-desc" class="mt-1 text-sm text-gray-500">Choose a document from the sidebar to begin reading</p>
|
|
</div>
|
|
</div>
|
|
</main>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<!-- ToC Modal -->
|
|
<div id="toc-modal" class="fixed inset-0 bg-black bg-opacity-50 z-50 flex items-center justify-center p-4">
|
|
<div class="bg-white rounded-lg shadow-2xl max-w-2xl w-full max-h-[80vh] flex flex-col">
|
|
<!-- Modal Header -->
|
|
<div class="flex items-center justify-between p-6 border-b border-gray-200">
|
|
<h2 class="text-2xl font-bold text-gray-900">Table of Contents</h2>
|
|
<button id="toc-close-button"
|
|
class="p-2 text-gray-400 hover:text-gray-600 hover:bg-gray-100 rounded transition"
|
|
aria-label="Close table of contents">
|
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
</svg>
|
|
</button>
|
|
</div>
|
|
|
|
<!-- Modal Content -->
|
|
<div id="toc-modal-content" class="flex-1 overflow-y-auto p-6">
|
|
<div class="text-gray-500">Loading table of contents...</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Search Tips Modal -->
|
|
<div id="search-tips-modal" class="fixed inset-0 bg-black bg-opacity-50 z-50 flex items-center justify-center p-4 hidden">
|
|
<div class="bg-white rounded-lg shadow-2xl max-w-2xl w-full max-h-[80vh] flex flex-col">
|
|
<!-- Modal Header -->
|
|
<div class="flex items-center justify-between p-6 border-b border-gray-200">
|
|
<h2 class="text-2xl font-bold text-gray-900">Search Tips</h2>
|
|
<button id="search-tips-close-btn" class="p-2 text-gray-400 hover:text-gray-600 hover:bg-gray-100 rounded transition" aria-label="Close search tips">
|
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
</svg>
|
|
</button>
|
|
</div>
|
|
|
|
<!-- Modal Content -->
|
|
<div class="flex-1 overflow-y-auto p-6">
|
|
<div class="space-y-6">
|
|
<!-- Basic Search -->
|
|
<div>
|
|
<h3 class="text-lg font-semibold text-gray-900 mb-2">Basic Search</h3>
|
|
<p class="text-gray-600 mb-3">Type keywords in the search box to find relevant documents. The search looks through document titles and content.</p>
|
|
<div class="bg-gray-50 p-3 rounded border border-gray-200">
|
|
<code class="text-sm text-gray-800">Example: "boundary enforcement"</code>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Faceted Filters -->
|
|
<div>
|
|
<h3 class="text-lg font-semibold text-gray-900 mb-2">Faceted Filters</h3>
|
|
<p class="text-gray-600 mb-3">Combine text search with filters to narrow down results:</p>
|
|
<ul class="space-y-2 text-gray-600">
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-blue-600 mr-2">•</span>
|
|
<span><strong>Quadrant:</strong> Filter by Strategic, Operational, Tactical, System, or Storage documents</span>
|
|
</li>
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-blue-600 mr-2">•</span>
|
|
<span><strong>Persistence:</strong> Filter by High, Medium, or Low persistence level</span>
|
|
</li>
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-blue-600 mr-2">•</span>
|
|
<span><strong>Audience:</strong> Filter for Researcher, Implementer, Leader, Technical, or General audience</span>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- Search Tips -->
|
|
<div>
|
|
<h3 class="text-lg font-semibold text-gray-900 mb-2">Search Tips</h3>
|
|
<ul class="space-y-2 text-gray-600">
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-green-600 mr-2">✓</span>
|
|
<span>Use specific terms for better results</span>
|
|
</li>
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-green-600 mr-2">✓</span>
|
|
<span>Combine multiple filters to narrow results</span>
|
|
</li>
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-green-600 mr-2">✓</span>
|
|
<span>Clear filters to see all documents</span>
|
|
</li>
|
|
<li class="flex items-start">
|
|
<span class="font-medium text-green-600 mr-2">✓</span>
|
|
<span>Recent searches are saved for quick access</span>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- Keyboard Shortcuts -->
|
|
<div>
|
|
<h3 class="text-lg font-semibold text-gray-900 mb-2">Keyboard Shortcuts</h3>
|
|
<div class="space-y-2">
|
|
<div class="flex items-center justify-between bg-gray-50 p-2 rounded">
|
|
<span class="text-gray-600">Focus search</span>
|
|
<kbd class="px-2 py-1 bg-white border border-gray-300 rounded text-sm font-mono">Ctrl + K</kbd>
|
|
</div>
|
|
<div class="flex items-center justify-between bg-gray-50 p-2 rounded">
|
|
<span class="text-gray-600">Navigate results</span>
|
|
<kbd class="px-2 py-1 bg-white border border-gray-300 rounded text-sm font-mono">↑ ↓</kbd>
|
|
</div>
|
|
<div class="flex items-center justify-between bg-gray-50 p-2 rounded">
|
|
<span class="text-gray-600">Open result</span>
|
|
<kbd class="px-2 py-1 bg-white border border-gray-300 rounded text-sm font-mono">Enter</kbd>
|
|
</div>
|
|
<div class="flex items-center justify-between bg-gray-50 p-2 rounded">
|
|
<span class="text-gray-600">Close search</span>
|
|
<kbd class="px-2 py-1 bg-white border border-gray-300 rounded text-sm font-mono">Esc</kbd>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Search Modal -->
|
|
<div id="search-modal" class="fixed inset-0 bg-black bg-opacity-50 z-50 items-center justify-center p-4">
|
|
<div class="bg-white rounded-lg shadow-2xl max-w-4xl w-full max-h-[85vh] flex flex-col">
|
|
<!-- Modal Header -->
|
|
<div class="flex items-center justify-between p-6 border-b border-gray-200">
|
|
<h2 class="text-2xl font-bold text-gray-900">Search Documentation</h2>
|
|
<button id="search-modal-close-btn"
|
|
class="p-2 text-gray-400 hover:text-gray-600 hover:bg-gray-100 rounded transition"
|
|
aria-label="Close search">
|
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
|
|
</svg>
|
|
</button>
|
|
</div>
|
|
|
|
<!-- Modal Content -->
|
|
<div id="search-modal-content" class="flex-1 overflow-y-auto p-6">
|
|
<!-- Search Input -->
|
|
<div class="mb-4">
|
|
<div class="relative">
|
|
<input
|
|
type="text"
|
|
id="docs-search-input"
|
|
placeholder="Search documentation..."
|
|
class="w-full px-4 py-3 pl-11 pr-4 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition"
|
|
aria-label="Search documentation"
|
|
/>
|
|
<svg class="absolute left-3 top-3.5 h-5 w-5 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
|
|
</svg>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Filters Row -->
|
|
<div class="flex flex-wrap items-center gap-3 mb-4">
|
|
<!-- Quadrant Filter -->
|
|
<div class="flex-1 min-w-[200px]">
|
|
<label for="filter-quadrant" class="sr-only">Filter by Quadrant</label>
|
|
<select id="filter-quadrant" class="w-full px-3 py-2 border border-gray-300 rounded-lg bg-white focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition">
|
|
<option value="">All Quadrants</option>
|
|
<option value="STR">Strategic</option>
|
|
<option value="OPS">Operational</option>
|
|
<option value="TAC">Tactical</option>
|
|
<option value="SYS">System</option>
|
|
<option value="STO">Storage</option>
|
|
</select>
|
|
</div>
|
|
|
|
<!-- Persistence Filter -->
|
|
<div class="flex-1 min-w-[200px]">
|
|
<label for="filter-persistence" class="sr-only">Filter by Persistence</label>
|
|
<select id="filter-persistence" class="w-full px-3 py-2 border border-gray-300 rounded-lg bg-white focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition">
|
|
<option value="">All Persistence Levels</option>
|
|
<option value="HIGH">High</option>
|
|
<option value="MEDIUM">Medium</option>
|
|
<option value="LOW">Low</option>
|
|
</select>
|
|
</div>
|
|
|
|
<!-- Audience Filter -->
|
|
<div class="flex-1 min-w-[200px]">
|
|
<label for="filter-audience" class="sr-only">Filter by Audience</label>
|
|
<select id="filter-audience" class="w-full px-3 py-2 border border-gray-300 rounded-lg bg-white focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition">
|
|
<option value="">All Audiences</option>
|
|
<option value="researcher">Researcher</option>
|
|
<option value="implementer">Implementer</option>
|
|
<option value="leader">Leader</option>
|
|
<option value="technical">Technical</option>
|
|
<option value="general">General</option>
|
|
</select>
|
|
</div>
|
|
|
|
<!-- Clear Filters Button -->
|
|
<button id="clear-filters-btn" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 transition">
|
|
Clear Filters
|
|
</button>
|
|
|
|
<!-- Search Tips Button -->
|
|
<button id="search-tips-btn" class="p-2 text-gray-600 hover:text-blue-600 hover:bg-white rounded-lg transition" title="Search Tips" aria-label="Show search tips">
|
|
<svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
|
|
</svg>
|
|
</button>
|
|
</div>
|
|
|
|
<!-- Search Results Summary -->
|
|
<div id="search-results-summary" class="mb-4 text-sm text-gray-600 hidden">
|
|
<span id="search-results-count"></span>
|
|
</div>
|
|
|
|
<!-- Search History (Recent Searches) -->
|
|
<div id="search-history-container" class="mb-4 hidden">
|
|
<div class="text-xs text-gray-500 mb-2">Recent Searches:</div>
|
|
<div id="search-history" class="flex flex-wrap gap-2"></div>
|
|
</div>
|
|
|
|
<!-- Search Results in Modal -->
|
|
<div id="search-results-modal" class="mt-6 hidden">
|
|
<h3 class="text-lg font-semibold text-gray-900 mb-4">Search Results</h3>
|
|
<div id="search-results-list-modal" class="space-y-4">
|
|
<!-- Results will be populated here by JavaScript -->
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Version Management & PWA -->
|
|
|
|
<script src="/js/version-manager.js?v=0.1.2.1770432766670" defer></script>
|
|
|
|
<script src="/js/components/document-cards.js?v=0.1.2.1770432766670" defer></script>
|
|
<script src="/js/docs-app.js?v=0.1.2.1770432766670" defer></script>
|
|
<script src="/js/docs-search-enhanced.js?v=0.1.2.1770432766670" defer></script>
|
|
|
|
<!-- Internationalization -->
|
|
<script src="/js/i18n-simple.js?v=0.1.2.1770432766670" defer></script>
|
|
<script src="/js/components/language-selector.js?v=0.1.2.1770432766670" defer></script>
|
|
|
|
</body>
|
|
</html>
|