Skip to content

Commit cb3b764

Browse files
solomonneassolomonneas
authored
docs: replace evidence ledger stack map (#532)
1 parent b85eb46 commit cb3b764

3 files changed

Lines changed: 195 additions & 54 deletions

File tree

‎engines/evidence-ledger/README.md‎

Lines changed: 5 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -124,60 +124,11 @@ MiseLedger follows one ingest path:
124124

125125
## Stack Map
126126

127-
```mermaid
128-
flowchart TB
129-
MISELEDGER["<b>MiseLedger</b><br/><i>archive, search, evidence layer</i>"]
130-
SQLITE["<b>SQLite archive</b><br/>normalized records, FTS, relations, raw refs"]
131-
MISELEDGER -->|owns| SQLITE
132-
133-
subgraph AGENTS [" agent-session crawlers "]
134-
SESSIONS["<b>miseledger crawl sessions</b><br/>Codex, Claude, OpenClaw, OpenCode, Hermes, Cursor, Grok"]
135-
COMPAT["<b>Native imports</b><br/>source-specific compatibility commands"]
136-
end
137-
138-
subgraph LOCAL [" local artifact crawlers "]
139-
ARTIFACTS["<b>miseledger crawl docs/files</b><br/>Markdown, text, logs, HTML"]
140-
GITLOG["<b>miseledger crawl gitlog</b><br/>repository history"]
141-
GENERIC["<b>Generic adapter records</b><br/>normalized source exports"]
142-
end
143-
144-
subgraph CRAWLERS [" external crawler binaries "]
145-
DISCRAWL["discrawl"]
146-
GITCRAWL["gitcrawl"]
147-
GRAINCRAWL["graincrawl"]
148-
NOTCRAWL["notcrawl"]
149-
SLACRAWL["slacrawl"]
150-
MAILCRAWL["mailcrawl"]
151-
TELECRAWL["telecrawl"]
152-
end
153-
154-
SESSIONS & COMPAT == adapter JSONL ==> MISELEDGER
155-
ARTIFACTS & GITLOG & GENERIC == adapter JSONL ==> MISELEDGER
156-
DISCRAWL & GITCRAWL & GRAINCRAWL & NOTCRAWL & SLACRAWL & MAILCRAWL & TELECRAWL == adapter JSONL ==> MISELEDGER
157-
158-
subgraph READERS [" reader workflows "]
159-
CLI["<b>miseledger CLI</b><br/>search, show, explain, export"]
160-
EVIDENCE["<b>Evidence bundles</b><br/>Brigade-ready context"]
161-
MCP["<b>Agent readers</b><br/>HTTP loopback, stdio MCP"]
162-
OPS["<b>Archive operations</b><br/>doctor, stats, compact"]
163-
end
164-
165-
SQLITE --> CLI
166-
SQLITE --> EVIDENCE
167-
SQLITE --> MCP
168-
SQLITE --> OPS
169-
170-
classDef core fill:#2563eb,stroke:#1d4ed8,color:#fff;
171-
classDef archive fill:#fff7ed,stroke:#ea580c,color:#7c2d12;
172-
classDef source fill:#eff6ff,stroke:#2563eb,color:#1e3a8a;
173-
classDef crawler fill:#ecfdf5,stroke:#059669,color:#064e3b;
174-
classDef reader fill:#f1f5f9,stroke:#94a3b8,color:#334155;
175-
class MISELEDGER core;
176-
class SQLITE archive;
177-
class SESSIONS,COMPAT,ARTIFACTS,GITLOG,GENERIC source;
178-
class DISCRAWL,GITCRAWL,GRAINCRAWL,NOTCRAWL,SLACRAWL,MAILCRAWL,TELECRAWL crawler;
179-
class CLI,EVIDENCE,MCP,OPS reader;
180-
```
127+
<p align="center">
128+
<img src="docs/assets/stack-map.svg" alt="MiseLedger stack map: agent sessions, local artifacts, and external crawlers pass through native adapters and adapter.v1 validation into a normalized SQLite ledger with FTS5, then reach CLI, evidence bundle, HTTP/MCP, and archive-operation readers" width="880">
129+
</p>
130+
131+
<p align="center"><em>Generated from <code>docs/assets/workflows/stack-map.json</code> with <code>plating workflow</code>.</em></p>
181132

182133
MiseLedger owns local agent-session crawling, local artifact crawling, archive ingest, SQLite, FTS, relations, scan manifests, reader APIs, and evidence bundles.
183134

‎engines/evidence-ledger/docs/assets/stack-map.svg‎

Lines changed: 74 additions & 0 deletions
Loading

‎engines/evidence-ledger/docs/assets/workflows/stack-map.json‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
{
2+
"title": "From sources to searchable evidence",
3+
"eyebrow": "MISELEDGER STACK MAP",
4+
"description": "Agent sessions, local artifacts, and external crawlers converge on one adapter contract before readers query the local ledger.",
5+
"meta": "local SQLite · FTS5",
6+
"columns": [
7+
{
8+
"title": "SOURCES",
9+
"nodes": [
10+
{
11+
"id": "sessions",
12+
"label": "agent sessions",
13+
"detail": "Codex · Claude · 5 more"
14+
},
15+
{
16+
"id": "artifacts",
17+
"label": "local artifacts",
18+
"detail": "docs · files · gitlog"
19+
},
20+
{
21+
"id": "crawlers",
22+
"label": "external crawlers",
23+
"detail": "discrawl · gitcrawl · 5 more"
24+
}
25+
]
26+
},
27+
{
28+
"title": "CONTRACT",
29+
"nodes": [
30+
{
31+
"id": "adapter",
32+
"label": "adapter.v1 JSONL",
33+
"detail": "validate · normalize",
34+
"kind": "accent"
35+
}
36+
]
37+
},
38+
{
39+
"title": "LOCAL LEDGER",
40+
"nodes": [
41+
{
42+
"id": "sqlite",
43+
"label": "SQLite archive",
44+
"detail": "normalized records · raw refs",
45+
"kind": "focus",
46+
"badge": "local"
47+
},
48+
{
49+
"id": "index",
50+
"label": "search + scans",
51+
"detail": "FTS5 · relations · manifests"
52+
}
53+
]
54+
},
55+
{
56+
"title": "READERS",
57+
"nodes": [
58+
{
59+
"id": "cli",
60+
"label": "CLI",
61+
"detail": "search · explain · export"
62+
},
63+
{
64+
"id": "evidence",
65+
"label": "evidence bundles",
66+
"detail": "Brigade-ready context",
67+
"kind": "accent"
68+
},
69+
{
70+
"id": "api",
71+
"label": "HTTP + MCP",
72+
"detail": "reader APIs · archive ops"
73+
}
74+
]
75+
}
76+
],
77+
"edges": [
78+
{
79+
"from": "sessions",
80+
"to": "adapter"
81+
},
82+
{
83+
"from": "artifacts",
84+
"to": "adapter"
85+
},
86+
{
87+
"from": "crawlers",
88+
"to": "adapter"
89+
},
90+
{
91+
"from": "adapter",
92+
"to": "sqlite"
93+
},
94+
{
95+
"from": "adapter",
96+
"to": "index"
97+
},
98+
{
99+
"from": "sqlite",
100+
"to": "cli"
101+
},
102+
{
103+
"from": "index",
104+
"to": "evidence"
105+
},
106+
{
107+
"from": "index",
108+
"to": "api"
109+
}
110+
],
111+
"context": {
112+
"title": "OWNERSHIP BOUNDARY",
113+
"body": "external tools keep native sync/query · MiseLedger owns normalized local evidence",
114+
"detail": "After adapter ingest, imported text remains untrusted evidence, never instructions."
115+
}
116+
}

0 commit comments

Comments
 (0)