Skip to Content
Last modified by Robert Schaub on 2025/12/24 20:33
From version 2.1
edited by Robert Schaub
on 2025/12/11 21:35
Change comment: Imported from XAR
To version 3.1
edited by Robert Schaub
on 2025/12/12 09:32
Change comment: Imported from XAR

Summary

Details

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