docs: archify

This commit is contained in:
2026-08-24 19:34:16 -03:00
parent 23de7d8fe7
commit d2d1aad001
180 changed files with 216559 additions and 5766 deletions
File diff suppressed because it is too large Load Diff
+259
View File
@@ -0,0 +1,259 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "TextNLPClassifierApp Runtime Architecture",
"output": "runtime-architecture.html",
"quality_profile": "showcase",
"views": [
{
"id": "primary-pipeline",
"label": "Primary Processing Pipeline",
"focus": ["google-news", "foxcape-engine", "triple-extractor", "f1-selector", "markdown-sanitizer", "state-machine", "inherence-classifier", "storage-layer"],
"note": "Trace an article from Google News RSS ingestion through extraction, consensus, NLP inherence, and atomic SQLite persistence."
},
{
"id": "nlp-decision",
"label": "NLP & AI Decision Tiers",
"focus": ["ecp-profile", "inherence-classifier", "ai-fallback", "state-machine"],
"note": "Tier 1 deterministic rule-based NLP classification with optional Tier 2 embeddings and Tier 3 LLM fallback for borderline ambiguity."
},
{
"id": "governance-storage",
"label": "State Governance & Quality",
"focus": ["state-machine", "storage-layer", "observability"],
"note": "State transition lifecycle gating, SHA-256 fingerprinting, transactional SQLite ledger, and telemetry."
}
]
},
"components": [
{
"id": "google-news",
"type": "external",
"label": "Google News RSS",
"sublabel": "Public News Feeds",
"pos": [40, 60],
"size": [140, 56]
},
{
"id": "foxcape-engine",
"type": "backend",
"label": "Foxcape Engine",
"sublabel": "Camoufox Headless",
"pos": [290, 60],
"size": [140, 56]
},
{
"id": "triple-extractor",
"type": "backend",
"label": "Multi-Engine Harvester",
"sublabel": "Trafilatura / N4k / Readability",
"pos": [540, 60],
"size": [160, 56]
},
{
"id": "f1-selector",
"type": "backend",
"label": "F1 Consensus Selector",
"sublabel": "5-Token Shingles",
"pos": [800, 60],
"size": [150, 56]
},
{
"id": "markdown-sanitizer",
"type": "backend",
"label": "Markdown Sanitizer",
"sublabel": "Editorial Normalizer",
"pos": [800, 180],
"size": [150, 56]
},
{
"id": "state-machine",
"type": "backend",
"label": "State Machine",
"sublabel": "Lifecycle Transition Gate",
"pos": [540, 180],
"size": [160, 56]
},
{
"id": "ecp-profile",
"type": "database",
"label": "ECP Snapshot",
"sublabel": "Anchors & Graph",
"pos": [290, 300],
"size": [140, 56]
},
{
"id": "inherence-classifier",
"type": "backend",
"label": "Inherence Classifier",
"sublabel": "Tier 1 Multilingual NLP",
"pos": [290, 180],
"size": [140, 56]
},
{
"id": "ai-fallback",
"type": "cloud",
"label": "AI Fallback",
"sublabel": "Tier 2/3 Vector & LLM",
"pos": [40, 180],
"size": [140, 56],
"tag": "Optional"
},
{
"id": "storage-layer",
"type": "database",
"label": "Storage Ledger",
"sublabel": "SQLite Store & FileStore",
"pos": [540, 300],
"size": [160, 56]
},
{
"id": "observability",
"type": "backend",
"label": "Observability",
"sublabel": "Telemetry & Quality Gate",
"pos": [800, 300],
"size": [150, 56]
}
],
"boundaries": [
{
"kind": "security-group",
"label": "Untrusted Public Web",
"wraps": ["google-news"]
},
{
"kind": "security-group",
"label": "Ingestion & Anti-Bot Sandbox",
"wraps": ["foxcape-engine", "triple-extractor"]
},
{
"kind": "region",
"label": "Trusted Core Processing Domain",
"wraps": ["f1-selector", "markdown-sanitizer", "state-machine", "ecp-profile", "inherence-classifier", "storage-layer", "observability"]
},
{
"kind": "security-group",
"label": "External AI Provider Gateway",
"wraps": ["ai-fallback"]
}
],
"connections": [
{
"id": "rss-to-foxcape",
"from": "google-news",
"to": "foxcape-engine",
"label": "RSS links",
"variant": "emphasis"
},
{
"id": "foxcape-to-extractor",
"from": "foxcape-engine",
"to": "triple-extractor",
"label": "stealth DOM",
"variant": "emphasis"
},
{
"id": "extractor-to-selector",
"from": "triple-extractor",
"to": "f1-selector",
"label": "triplet JSON",
"variant": "emphasis"
},
{
"id": "selector-to-sanitizer",
"from": "f1-selector",
"to": "markdown-sanitizer",
"label": "winner JSON",
"variant": "emphasis",
"fromSide": "bottom",
"toSide": "top",
"labelDy": 32
},
{
"id": "sanitizer-to-statemachine",
"from": "markdown-sanitizer",
"to": "state-machine",
"label": "clean MD",
"variant": "emphasis"
},
{
"id": "statemachine-to-classifier",
"from": "state-machine",
"to": "inherence-classifier",
"label": "eval inherence",
"variant": "emphasis"
},
{
"id": "ecp-to-classifier",
"from": "ecp-profile",
"to": "inherence-classifier",
"label": "anchors & aliases",
"variant": "dashed",
"fromSide": "top",
"toSide": "bottom",
"labelDy": -32
},
{
"id": "classifier-to-fallback",
"from": "inherence-classifier",
"to": "ai-fallback",
"label": "LLM fallback",
"variant": "dashed",
"fromSide": "left",
"toSide": "right"
},
{
"id": "statemachine-to-storage",
"from": "state-machine",
"to": "storage-layer",
"label": "atomic commit",
"variant": "emphasis",
"fromSide": "bottom",
"toSide": "top",
"labelDy": 32
},
{
"id": "statemachine-to-observability",
"from": "state-machine",
"to": "observability",
"label": "audit telemetry",
"variant": "dashed"
}
],
"cards": [
{
"dot": "cyan",
"title": "Ingestion & Anti-Bot",
"items": [
"Camoufox stealth headless browser with automated anti-bot evasion",
"Tri-engine simultaneous extraction via Trafilatura, N4k & Readability"
]
},
{
"dot": "emerald",
"title": "Consensus & NLP",
"items": [
"Zero-dependency 5-token shingle consensus with F1 score selection",
"Multilingual NLP classifier (6 languages) weighted by ECP anchors"
]
},
{
"dot": "violet",
"title": "AI & Fallback Resilience",
"items": [
"Tier 2 vector embeddings and Tier 3 LLM fallback for ambiguity (<0.60)",
"Graceful degradation to deterministic Tier 1 heuristics on API failure"
]
},
{
"dot": "amber",
"title": "State & Persistence",
"items": [
"Finite state machine enforcing strict validated lifecycle transitions",
"SHA-256 fingerprint deduplication with atomic SQLite & file persistence"
]
}
]
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 178 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 184 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 223 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 228 KiB

@@ -0,0 +1,32 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Archify visual-check · runtime-architecture.html</title>
<style>
*{box-sizing:border-box}body{margin:0;padding:24px;background:#e9eef5;color:#172033;font:14px/1.5 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}header{max-width:1500px;margin:0 auto 18px}h1{margin:0 0 6px;font-size:20px}p{margin:0;color:#526176}.grid{max-width:1500px;margin:auto;display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:18px}figure{margin:0;padding:10px;background:white;border:1px solid #c9d4e3;border-radius:12px;box-shadow:0 10px 30px rgba(15,23,42,.08)}img{display:block;width:100%;height:auto;border:1px solid #e2e8f0}figcaption{padding:9px 4px 2px;color:#526176}@media(max-width:900px){.grid{grid-template-columns:1fr}}
</style>
</head>
<body>
<header><h1>Archify visual-check</h1><p>runtime-architecture.html · automated containment pass · visual review pending</p></header>
<main class="grid">
<figure>
<img src="runtime-architecture.visual-check.1440x900.light.png" alt="light 1440 by 900">
<figcaption><strong>LIGHT</strong> · 1440×900 · containment pass</figcaption>
</figure>
<figure>
<img src="runtime-architecture.visual-check.1440x900.dark.png" alt="dark 1440 by 900">
<figcaption><strong>DARK</strong> · 1440×900 · containment pass</figcaption>
</figure>
<figure>
<img src="runtime-architecture.visual-check.2048x1320.light.png" alt="light 2048 by 1320">
<figcaption><strong>LIGHT</strong> · 2048×1320 · containment pass</figcaption>
</figure>
<figure>
<img src="runtime-architecture.visual-check.2048x1320.dark.png" alt="dark 2048 by 1320">
<figcaption><strong>DARK</strong> · 2048×1320 · containment pass</figcaption>
</figure>
</main>
</body>
</html>
@@ -0,0 +1,482 @@
{
"schemaVersion": 1,
"ok": true,
"command": "visual-check",
"status": "pass",
"visualReview": "pending",
"artifact": {
"path": "C:\\Users\\aferr\\Projects\\AFTech\\DunaMedia\\TextNLPClassifierApp\\docs\\runtime-architecture.html",
"sha256": "66284a667f9c3ec5afd8d275fdd83e5980425836788aec8d650c95cfffaa9d1f",
"bytes": 693750
},
"state": {
"detail": "read",
"motion": "still"
},
"chrome": {
"status": "available",
"executable": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
},
"containment": {
"status": "pass",
"viewports": [
{
"width": 1440,
"height": 900,
"theme": "light",
"innerWidth": 1440,
"innerHeight": 900,
"scrollWidth": 1440,
"scrollHeight": 900,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1266,
"diagramWidth": 1236,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 1600,
"height": 1000,
"theme": "light",
"innerWidth": 1600,
"innerHeight": 1000,
"scrollWidth": 1600,
"scrollHeight": 1000,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1464,
"diagramWidth": 1434,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 1920,
"height": 1080,
"theme": "light",
"innerWidth": 1920,
"innerHeight": 1080,
"scrollWidth": 1920,
"scrollHeight": 1080,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1647,
"diagramWidth": 1617,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 2048,
"height": 1320,
"theme": "light",
"innerWidth": 2048,
"innerHeight": 1320,
"scrollWidth": 2048,
"scrollHeight": 1320,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1920,
"diagramWidth": 1870,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
}
]
},
"readability": {
"status": "pass",
"minimumProjectedNodeTextPx": 6,
"viewports": [
{
"width": 1440,
"height": 900,
"theme": "light",
"innerWidth": 1440,
"innerHeight": 900,
"scrollWidth": 1440,
"scrollHeight": 900,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1266,
"diagramWidth": 1236,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 1600,
"height": 1000,
"theme": "light",
"innerWidth": 1600,
"innerHeight": 1000,
"scrollWidth": 1600,
"scrollHeight": 1000,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1464,
"diagramWidth": 1434,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 1920,
"height": 1080,
"theme": "light",
"innerWidth": 1920,
"innerHeight": 1080,
"scrollWidth": 1920,
"scrollHeight": 1080,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1647,
"diagramWidth": 1617,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 2048,
"height": 1320,
"theme": "light",
"innerWidth": 2048,
"innerHeight": 1320,
"scrollWidth": 2048,
"scrollHeight": 1320,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1920,
"diagramWidth": 1870,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
}
]
},
"viewerChrome": {
"status": "pass",
"viewports": [
{
"width": 1440,
"height": 900,
"theme": "light",
"innerWidth": 1440,
"innerHeight": 900,
"scrollWidth": 1440,
"scrollHeight": 900,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1266,
"diagramWidth": 1236,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 1600,
"height": 1000,
"theme": "light",
"innerWidth": 1600,
"innerHeight": 1000,
"scrollWidth": 1600,
"scrollHeight": 1000,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1464,
"diagramWidth": 1434,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 1920,
"height": 1080,
"theme": "light",
"innerWidth": 1920,
"innerHeight": 1080,
"scrollWidth": 1920,
"scrollHeight": 1080,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1647,
"diagramWidth": 1617,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
},
{
"width": 2048,
"height": 1320,
"theme": "light",
"innerWidth": 2048,
"innerHeight": 1320,
"scrollWidth": 2048,
"scrollHeight": 1320,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1920,
"diagramWidth": 1870,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light"
}
]
},
"captures": {
"status": "pass",
"screenshots": [
{
"width": 1440,
"height": 900,
"theme": "light",
"innerWidth": 1440,
"innerHeight": 900,
"scrollWidth": 1440,
"scrollHeight": 900,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1266,
"diagramWidth": 1236,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light",
"file": "runtime-architecture.visual-check.1440x900.light.png"
},
{
"width": 1440,
"height": 900,
"theme": "dark",
"innerWidth": 1440,
"innerHeight": 900,
"scrollWidth": 1440,
"scrollHeight": 900,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1266,
"diagramWidth": 1236,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "dark",
"file": "runtime-architecture.visual-check.1440x900.dark.png"
},
{
"width": 2048,
"height": 1320,
"theme": "light",
"innerWidth": 2048,
"innerHeight": 1320,
"scrollWidth": 2048,
"scrollHeight": 1320,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1920,
"diagramWidth": 1870,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "light",
"file": "runtime-architecture.visual-check.2048x1320.light.png"
},
{
"width": 2048,
"height": 1320,
"theme": "dark",
"innerWidth": 2048,
"innerHeight": 1320,
"scrollWidth": 2048,
"scrollHeight": 1320,
"overflowX": false,
"overflowY": false,
"ok": true,
"readerWidth": 1920,
"diagramWidth": 1870,
"viewBoxWidth": 1020,
"minimumProjectedNodeTextPx": 8.1,
"minimumProjectedNodeText": "Trafilatura / N4k / Readability",
"minimumProjectedNodeTextDetail": "context",
"minimumRequiredNodeTextPx": 6,
"readabilityOk": true,
"hasLegend": true,
"hasNavigationDock": true,
"legendDockIntersectionArea": 0,
"viewerChromeReserve": 0,
"viewerChromeActive": false,
"viewerChromeOk": true,
"resolvedTheme": "dark",
"file": "runtime-architecture.visual-check.2048x1320.dark.png"
}
],
"contactSheet": "runtime-architecture.visual-check.html"
},
"sidecars": {
"receipt": "runtime-architecture.visual-check.json",
"contactSheet": "runtime-architecture.visual-check.html"
}
}