Wiki source code of Workflows

Last modified by Robert Schaub on 2026/02/08 08:26

Hide last authors
Robert Schaub 1.1 1 = Workflows =
Robert Schaub 4.2 2
Robert Schaub 1.1 3 FactHarbor workflows are **simple, automated, focused on continuous improvement**.
Robert Schaub 4.2 4
Robert Schaub 1.1 5 == 1. Core Principles ==
Robert Schaub 4.2 6
Robert Schaub 1.1 7 * **Automated by default**: AI processes everything
8 * **Publish immediately**: No centralized approval (removed in V0.9.50)
9 * **Quality through monitoring**: Not gatekeeping
10 * **Fix systems, not data**: Errors trigger improvements
11 * **Human-in-loop**: Only for edge cases and abuse
Robert Schaub 4.2 12
Robert Schaub 1.1 13 == 2. Claim Submission Workflow ==
Robert Schaub 3.1 14
15 === 2.1 Claim Extraction ===
16
17 When users submit content (text, articles, web pages), FactHarbor first extracts individual verifiable claims:
18
19 **Input Types:**
Robert Schaub 4.2 20
Robert Schaub 3.1 21 * Single claim: "The Earth is flat"
22 * Text with multiple claims: "Climate change is accelerating. Sea levels rose 3mm in 2023. Arctic ice decreased 13% annually."
23 * URLs: Web pages analyzed for factual claims
24
25 **Extraction Process:**
Robert Schaub 4.2 26
Robert Schaub 3.1 27 * LLM analyzes submitted content
28 * Identifies distinct, verifiable factual claims
29 * Separates claims from opinions, questions, or commentary
30 * Each claim becomes independent for processing
31
32 **Output:**
Robert Schaub 4.2 33
Robert Schaub 3.1 34 * List of claims with context
35 * Each claim assigned unique ID
36 * Original context preserved for reference
37
38 This extraction ensures:
Robert Schaub 4.2 39
Robert Schaub 3.1 40 * Each claim receives focused analysis
41 * Multiple claims in one submission are all processed
42 * Claims are properly isolated for independent verification
43 * Context is preserved for accurate interpretation
44
Robert Schaub 1.1 45 ```
46 User submits → Duplicate detection → Categorization → Processing queue → User receives ID
47 ```
48 **Timeline**: Seconds
49 **No approval needed**
Robert Schaub 2.1 50
51 == 2.5 Claim and Scenario Workflow ==
52
Robert Schaub 4.12 53 {{include reference="Archive.FactHarbor 2026\.01\.20.Specification.Diagrams.Claim and Scenario Workflow.WebHome"/}}
Robert Schaub 2.1 54
Robert Schaub 1.1 55 == 3. Automated Analysis Workflow ==
Robert Schaub 4.2 56
Robert Schaub 1.1 57 ```
58 Claim from queue
59
60 Evidence gathering (AKEL)
61
62 Source evaluation (track record check)
63
64 Scenario generation
65
66 Verdict synthesis
67
68 Risk assessment
69
70 Quality gates (confidence > 40%? risk < 80%?)
71
72 Publish OR Flag for improvement
73 ```
74 **Timeline**: 10-30 seconds
75 **90%+ published automatically**
Robert Schaub 4.2 76
Robert Schaub 1.1 77 == 3.5 Evidence and Verdict Workflow ==
Robert Schaub 4.2 78
Robert Schaub 4.13 79 {{include reference="Archive.FactHarbor 2026\.01\.20.Specification.Diagrams.Evidence and Verdict Workflow.WebHome"/}}
Robert Schaub 4.2 80
Robert Schaub 1.1 81 == 4. Publication Workflow ==
Robert Schaub 4.2 82
Robert Schaub 1.1 83 **Standard (90%+)**: Pass quality gates → Publish immediately with confidence scores
84 **High Risk (<10%)**: Risk > 80% → Moderator review
85 **Low Quality**: Confidence < 40% → Improvement queue → Re-process
Robert Schaub 4.2 86
Robert Schaub 1.1 87 == 5. User Contribution Workflow ==
Robert Schaub 4.2 88
Robert Schaub 1.1 89 ```
90 Contributor edits → System validates → Applied immediately → Logged → Reputation earned
91 ```
92 **No approval required** (Wikipedia model)
93 **New contributors** (<50 reputation): Limited to minor edits
Robert Schaub 4.2 94
Robert Schaub 2.1 95 == 5.5 Quality and Audit Workflow ==
96
Robert Schaub 4.14 97 {{include reference="Archive.FactHarbor 2026\.01\.20.Specification.Diagrams.Quality and Audit Workflow.WebHome"/}}
Robert Schaub 2.1 98
Robert Schaub 1.1 99 == 6. Flagging Workflow ==
Robert Schaub 4.2 100
Robert Schaub 1.1 101 ```
102 User flags issue → Categorize (abuse/quality) → Automated or manual resolution
103 ```
104 **Quality issues**: Add to improvement queue → System fix → Auto re-process
105 **Abuse**: Moderator review → Action taken
Robert Schaub 4.2 106
Robert Schaub 1.1 107 == 7. Moderation Workflow ==
Robert Schaub 4.2 108
Robert Schaub 1.1 109 **Automated pre-moderation**: 95% published automatically
110 **Moderator queue**: Only high-risk or flagged content
111 **Appeal process**: Different moderator → Governing Team if needed
Robert Schaub 4.2 112
Robert Schaub 1.1 113 == 8. System Improvement Workflow ==
Robert Schaub 4.2 114
Robert Schaub 1.1 115 **Weekly cycle**:
116 ```
117 Monday: Review error patterns
118 Tuesday-Wednesday: Develop fixes
119 Thursday: Test improvements
120 Friday: Deploy & re-process
121 Weekend: Monitor metrics
122 ```
123 **Error capture**:
124 ```
125 Error detected → Categorize → Root cause → Improvement queue → Pattern analysis
126 ```
127 **A/B Testing**:
128 ```
129 New algorithm → Split traffic (90% control, 10% test) → Run 1 week → Compare metrics → Deploy if better
130 ```
Robert Schaub 4.2 131
Robert Schaub 1.1 132 == 9. Quality Monitoring Workflow ==
Robert Schaub 4.2 133
Robert Schaub 1.1 134 **Continuous**: Every hour calculate metrics, detect anomalies
135 **Daily**: Update source track records, aggregate error patterns
136 **Weekly**: System improvement cycle, performance review
Robert Schaub 4.2 137
Robert Schaub 1.1 138 == 10. Source Track Record Workflow ==
Robert Schaub 4.2 139
Robert Schaub 1.1 140 **Initial score**: New source starts at 50 (neutral)
141 **Daily updates**: Calculate accuracy, correction frequency, update score
142 **Continuous**: All claims using source recalculated when score changes
Robert Schaub 4.2 143
Robert Schaub 1.1 144 == 11. Re-Processing Workflow ==
Robert Schaub 4.2 145
Robert Schaub 1.1 146 **Triggers**: System improvement deployed, source score updated, new evidence, error fixed
147 **Process**: Identify affected claims → Re-run AKEL → Compare → Update if better → Log change
Robert Schaub 4.2 148
Robert Schaub 1.1 149 == 12. Related Pages ==
Robert Schaub 4.2 150
Robert Schaub 4.15 151 * [[Requirements>>Archive.FactHarbor 2026\.01\.20.Specification.Requirements.WebHome]]
Robert Schaub 4.10 152 * [[Architecture>>Archive.FactHarbor 2026\.01\.20.Specification.Architecture.WebHome]]
Robert Schaub 4.11 153 * [[Data Model>>Archive.FactHarbor 2026\.01\.20.Specification.Data Model.WebHome]]