Skip to Content
Last modified by Robert Schaub on 2025/12/24 20:33
From version 3.1
edited by Robert Schaub
on 2025/12/12 09:32
Change comment: Imported from XAR
To version 1.2
edited by Robert Schaub
on 2025/12/11 21:34
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -12,6 +12,8 @@
12 12  
13 13  Human reviewers, experts, and moderators always retain final authority.
14 14  
15 +----
16 +
15 15  == Purpose and Role ==
16 16  
17 17  AKEL transforms unstructured inputs into structured, review-ready drafts.
... ... @@ -26,6 +26,8 @@
26 26  * Re-evaluation proposal generation
27 27  * Cross-node embedding exchange (Release 1.0+)
28 28  
31 +----
32 +
29 29  == Components ==
30 30  
31 31  * **AKEL Orchestrator** – central coordinator
... ... @@ -37,51 +37,63 @@
37 37  * **Embedding Handler** (Release 1.0+)
38 38  * **Federation Sync Adapter** (Release 1.0+)
39 39  
44 +----
45 +
40 40  == Inputs and Outputs ==
41 41  
42 42  === Inputs ===
43 -* User-submitted claims or evidence
44 -* Uploaded documents
45 -* URLs or citations
46 -* External LLM API (optional)
49 +
50 +* User-submitted claims or evidence
51 +* Uploaded documents
52 +* URLs or citations
53 +* External LLM API (optional)
47 47  * Embeddings (from local or federated peers)
48 48  
49 49  === Outputs (all require human approval) ===
50 -* ClaimVersion (draft)
51 -* ScenarioVersion (draft)
52 -* EvidenceVersion (summary + metadata draft)
53 -* VerdictVersion (draft; internal only)
54 -* Contradiction alerts
55 -* Re-evaluation proposals
57 +
58 +* ClaimVersion (draft)
59 +* ScenarioVersion (draft)
60 +* EvidenceVersion (summary + metadata draft)
61 +* VerdictVersion (draft; internal only)
62 +* Contradiction alerts
63 +* Re-evaluation proposals
56 56  * Updated embeddings
57 57  
66 +----
67 +
58 58  == Architecture Overview ==
59 59  
60 -{{include reference="FactHarbor.Specification.Diagrams.AKEL Architecture.WebHome"/}}
70 +{{include reference="FactHarbor.Archive.Diagrams v0\.8q.AKEL Architecture.WebHome"/}}
61 61  
72 +----
73 +
62 62  == AKEL and Federation ==
63 63  
64 64  In Release 1.0+, AKEL participates in cross-node knowledge alignment:
65 65  
66 -* Shares embeddings
67 -* Exchanges canonicalized claim forms
68 -* Exchanges scenario templates
69 -* Sends + receives contradiction alerts
70 -* Never shares model weights
78 +* Shares embeddings
79 +* Exchanges canonicalized claim forms
80 +* Exchanges scenario templates
81 +* Sends + receives contradiction alerts
82 +* Never shares model weights
71 71  * Never overrides local governance
72 72  
73 73  Nodes may choose trust levels for AKEL-related data:
74 74  
75 -* Trusted nodes: auto-merge embeddings + templates
76 -* Neutral nodes: require reviewer approval
87 +* Trusted nodes: auto-merge embeddings + templates
88 +* Neutral nodes: require reviewer approval
77 77  * Untrusted nodes: fully manual import
78 78  
91 +----
92 +
79 79  == Human Approval Workflow ==
80 80  
81 -1. AKEL generates draft outputs (AuthorType = AI)
82 -2. Reviewers inspect and approve/moderate the drafts
83 -3. Experts validate high-risk or domain-specific outputs
84 -4. Moderators finalize publication
95 +1. AKEL generates draft outputs (AuthorType = AI)
96 +2. Reviewers inspect and approve/moderate the drafts
97 +3. Experts validate high-risk or domain-specific outputs
98 +4. Moderators finalize publication
85 85  5. Version numbers increment, history preserved
86 86  
87 87  No AKEL output is ever published automatically.
102 +
103 +----