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 2.1
edited by Robert Schaub
on 2025/12/11 21:35
Change comment: Imported from XAR

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,61 @@
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 +* User-submitted claims or evidence
50 +* Uploaded documents
51 +* URLs or citations
52 +* 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
56 +* ClaimVersion (draft)
57 +* ScenarioVersion (draft)
58 +* EvidenceVersion (summary + metadata draft)
59 +* VerdictVersion (draft; internal only)
60 +* Contradiction alerts
61 +* Re-evaluation proposals
56 56  * Updated embeddings
57 57  
64 +----
65 +
58 58  == Architecture Overview ==
59 59  
60 60  {{include reference="FactHarbor.Specification.Diagrams.AKEL Architecture.WebHome"/}}
61 61  
70 +----
71 +
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
76 +* Shares embeddings
77 +* Exchanges canonicalized claim forms
78 +* Exchanges scenario templates
79 +* Sends + receives contradiction alerts
80 +* 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
85 +* Trusted nodes: auto-merge embeddings + templates
86 +* Neutral nodes: require reviewer approval
77 77  * Untrusted nodes: fully manual import
78 78  
89 +----
90 +
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
93 +1. AKEL generates draft outputs (AuthorType = AI)
94 +2. Reviewers inspect and approve/moderate the drafts
95 +3. Experts validate high-risk or domain-specific outputs
96 +4. Moderators finalize publication
85 85  5. Version numbers increment, history preserved
86 86  
87 87  No AKEL output is ever published automatically.
100 +
101 +----