Wiki source code of Roles & Publication Modes

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

Hide last authors
Robert Schaub 1.1 1 = Roles & Publication Modes =
2
3 **Version:** 0.9.70
4 **Last Updated:** December 21, 2025
5 **Status:** CORRECTED - Automation Philosophy Consistent
6
7 This page defines user roles and publication modes in FactHarbor.
8
9 == 1. User Roles ==
10
11 === 1.1 Contributors ===
12
13 **Who**: Community members who suggest system improvements
14
15 **Responsibilities:**
Robert Schaub 1.3 16
Robert Schaub 1.1 17 * Participate in sampling audits (analyze patterns, not individual outputs)
18 * Suggest algorithm/prompt improvements based on findings
19 * Document systematic issues observed
20 * Contribute to system improvement discussions
21
22 **Can:**
Robert Schaub 1.3 23
Robert Schaub 1.1 24 * Edit published content (changes apply immediately, Wikipedia-style)
25 * Flag quality issues (for sampling audit)
26 * Earn reputation through contributions
27 * Participate in RFC (Request for Comments) processes
28
29 **Cannot:**
Robert Schaub 1.3 30
Robert Schaub 1.1 31 * Approve content before publication
32 * Override quality gates
33 * Act as gatekeepers
34 * Manually fix individual AI outputs
35
36 **Note**: Contributors improve THE SYSTEM, not individual outputs.
37
38 === 1.2 Trusted Contributors ===
39
40 **Who**: Contributors with proven track record and domain expertise
41
42 **Responsibilities:**
Robert Schaub 1.3 43
Robert Schaub 1.1 44 * Same as Contributors, plus:
45 * Review complex algorithm changes
46 * Provide domain expertise on contested claims
47 * Mentor new contributors
48
49 **Can:**
Robert Schaub 1.3 50
Robert Schaub 1.1 51 * Everything Contributors can do, plus:
52 * Participate in higher-level system design decisions
53 * Review RFC proposals
54 * Access more detailed system metrics
55
56 **Cannot:**
Robert Schaub 1.3 57
Robert Schaub 1.1 58 * Approve content before publication
59 * Override quality gates
60 * Act as gatekeepers
61
62 **Important**: "Trusted" refers to judgment quality, NOT approval authority.
63
64 === 1.3 Moderators ===
65
66 **Who**: Team members focused on community health and abuse prevention
67
68 **Responsibilities:**
Robert Schaub 1.3 69
Robert Schaub 1.1 70 * Handle abuse, spam, and harassment
71 * Enforce community guidelines
72 * Respond to user reports
73 * Manage bans and appeals
74
75 **Can:**
Robert Schaub 1.3 76
Robert Schaub 1.1 77 * Hide abusive content
78 * Ban users for policy violations
79 * Review appeals
80 * Escalate serious issues to Governing Team
81
82 **Cannot:**
Robert Schaub 1.3 83
Robert Schaub 1.1 84 * Approve content for publication
85 * Review content quality before publication
86 * Override quality gates for content
87 * Act as editorial gatekeepers
88
89 **Critical Distinction:**
90 ```
91 Moderators handle: ABUSE (spam, harassment, violations)
92 Moderators DO NOT handle: CONTENT QUALITY (that's automated)
93 ```
94
95 === 1.4 Domain Trusted Contributors (Optional, Task-Specific) ===
96
97 **Who**: Subject matter specialists invited for specific high-stakes disputes
98
99 **Not a permanent role**: Contacted externally when needed for contested claims in their domain
100
101 **When used:**
Robert Schaub 1.3 102
Robert Schaub 1.1 103 * Medical claims with life/safety implications
104 * Legal interpretations with significant impact
105 * Scientific claims with high controversy
106 * Technical claims requiring specialized knowledge
107
108 **Process:**
Robert Schaub 1.3 109
Robert Schaub 1.1 110 * Moderator identifies need for expert input
111 * Contact expert externally (don't require them to be users)
112 * Trusted Contributor provides written opinion with sources
113 * Opinion added to claim record
114 * Trusted Contributor acknowledged in claim
115
116 **Important**: This is CONSULTATION, not APPROVAL. Their opinion is added to the evidence, not used as a gate.
117
118 **User Needs served**: UN-16 (Expert validation status)
119
120 == 2. Publication Modes ==
121
122 **Fulfills**: UN-1 (Trust indicators), UN-16 (Review status transparency)
123
124 FactHarbor uses **TWO publication modes** (not three). Focus is on transparency and confidence scoring, not gatekeeping.
125
126 === 2.1 Mode 1: Draft-Only ===
127
128 **Status**: Not visible to public
129
130 **When Used:**
Robert Schaub 1.3 131
Robert Schaub 1.1 132 * Quality gates failed
133 * Confidence below threshold
134 * Structural integrity issues
135 * Insufficient evidence
136
137 **What Happens:**
Robert Schaub 1.3 138
Robert Schaub 1.1 139 * Content remains private
140 * System logs failure reasons
141 * Prompts/algorithms improved based on patterns
142 * Content may be re-processed after improvements
143
144 **NOT "pending human approval"** - it's blocked because it doesn't meet automated quality standards.
145
146 === 2.2 Mode 2: AI-Generated (Public) ===
147
148 **Status**: Published and visible to all users
149
150 **When Used:**
Robert Schaub 1.3 151
Robert Schaub 1.1 152 * Quality gates passed
153 * Confidence ≥ threshold
154 * Meets structural requirements
155 * Sufficient evidence found
156
157 **Includes:**
Robert Schaub 1.3 158
Robert Schaub 1.1 159 * Confidence score displayed (0-100%)
160 * Risk tier badge (A/B/C)
161 * Quality indicators
162 * Clear "AI-Generated" labeling
163 * Sampling audit status
164
165 **Labels by Risk Tier:**
Robert Schaub 1.3 166
Robert Schaub 1.1 167 * **Tier A (High Risk):** "⚠️ AI-Generated - High Impact Topic - Seek Professional Advice"
168 * **Tier B (Medium Risk):** "🤖 AI-Generated - May Contain Errors"
169 * **Tier C (Low Risk):** "🤖 AI-Generated"
170
171 **User Contributions:**
Robert Schaub 1.3 172
Robert Schaub 1.1 173 * User edits apply immediately (Wikipedia model)
174 * All changes logged and versioned
175 * May be selected for sampling audit
176 * Reputation earned for quality contributions
177
178 === REMOVED: Mode 3 ===
179
180 **V0.9.50 Decision:** No centralized approval workflow.
181
182 **Rationale:**
Robert Schaub 1.3 183
Robert Schaub 1.1 184 * Defeats automation purpose
185 * Creates bottleneck
186 * Inconsistent quality
187 * Not scalable
188
189 **What Replaced It:**
Robert Schaub 1.3 190
Robert Schaub 1.1 191 * Better quality gates
192 * Sampling audits for system improvement
193 * Transparent confidence scoring
194 * Risk-based warnings
195
196 == 3. Content States ==
197
198 === 3.1 Published ===
199
200 **Status**: Visible to all users
201
202 **Includes:**
Robert Schaub 1.3 203
Robert Schaub 1.1 204 * AI-generated analyses (default state after passing gates)
205 * User-contributed content
206 * Edited/improved content
207
208 **Quality Indicators** (displayed with content):
Robert Schaub 1.3 209
Robert Schaub 1.1 210 * **Confidence Score**: 0-100% (AI's confidence in analysis)
211 * **Source Quality Score**: 0-100% (based on source track record)
212 * **Controversy Flag**: If high dispute/edit activity
213 * **Completeness Score**: % of expected fields filled
214 * **Last Updated**: Date of most recent change
215 * **Edit Count**: Number of revisions
216 * **Review Status**: AI-generated / Enhanced by contributors
217
218 **Automatic Warnings:**
Robert Schaub 1.3 219
Robert Schaub 1.1 220 * Confidence < 60%: "Low confidence - use caution"
221 * Source quality < 40%: "Sources may be unreliable"
222 * High controversy: "Disputed - multiple interpretations exist"
223 * Medical/Legal/Safety domain: "Seek professional advice"
224
225 **User Needs served**: UN-1 (Trust score), UN-9 (Methodology transparency), ~~UN-15 (Evolution timeline - Deferred)~~, UN-16 (Review status)
226
227 === 3.2 Hidden ===
228
229 **Status**: Not visible to regular users (only to moderators)
230
231 **Reasons:**
Robert Schaub 1.3 232
Robert Schaub 1.1 233 * Spam or advertising
234 * Personal attacks or harassment
235 * Illegal content
236 * Privacy violations
237 * Deliberate misinformation (verified)
238 * Abuse or harmful content
239
240 **Process:**
Robert Schaub 1.3 241
Robert Schaub 1.1 242 * Automated detection flags for moderator review
243 * Moderator confirms and hides
244 * Original author notified with reason
245 * Can appeal to board if disputes moderator decision
246
247 **Note**: Content is hidden, not deleted (for audit trail)
248
249 == 4. Role Evolution Path ==
250
251 **Contributor Journey:**
252
253 1. **Visitor** – Explores platform, reads documentation, may raise questions
254 2. **New Contributor** – Submits first improvements (typo fixes, small clarifications, new issues)
255 3. **Contributor** – Contributes regularly and follows project conventions
256 4. **Trusted Contributor** – Has a track record of high-quality work and reliable judgment
257 5. **Auditor** – Participates in sampling audits (pattern analysis)
258 6. **Moderator** – Focuses on behavior, tone, and conflict moderation (not content quality)
259 7. **Domain Expert** (optional) – Offers domain expertise without changing governance authority
260
261 **Key Principle**: Low barrier to entry, transparent criteria for advancement, clear separation between content quality (automated) and behavior moderation (human).
262
263 == 5. Principles ==
264
265 * **Low barrier to entry** for new contributors
266 * **Transparent criteria** for gaining and losing responsibilities
267 * **Clear separation** between content quality (automated) and behavioral moderation (human)
268 * **Documented processes** for escalation and appeal
269 * **No gatekeeping** for content publication
270 * **Immediate application** of contributions (Wikipedia model)
271
272 == 6. Related Pages ==
273
Robert Schaub 1.7 274 * [[AKEL>>Archive.FactHarbor 2026\.01\.20.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system
Robert Schaub 1.10 275 * [[Workflows>>Archive.FactHarbor 2026\.01\.20.Specification.Workflows.WebHome]] - Process workflows
Robert Schaub 1.8 276 * [[Architecture>>Archive.FactHarbor 2026\.01\.20.Specification.Architecture.WebHome]] - System architecture
Robert Schaub 1.1 277 * [[Decision Processes>>FactHarbor.Organisation.Decision-Processes.WebHome]] - Governance
Robert Schaub 1.9 278 * [[Requirements>>Archive.FactHarbor 2026\.01\.20.Specification.Requirements.WebHome]] - All requirements
Robert Schaub 1.1 279
280 **V0.9.70 CHANGES:**
281
282 **REMOVED:**
283 - All references to "Mode 3" publication
284 - "Contributors validate quality gates"
285 - "Trusted Contributors validate outputs"
286 - "Moderators finalize publication"
287
288 **CLARIFIED:**
289 - Contributors suggest system improvements (not approve outputs)
290 - Moderators handle abuse only (not content quality)
291 - Trusted Contributors provide consultation (not validation)
292 - Domain experts provide opinions (not approval)
293 - Only 2 publication modes (AI-Generated / Draft-Only)
294
295 **ADDED:**
296 - Clear role boundaries
297 - Explicit "cannot" lists for each role
298 - Publication mode details
299 - Content state specifications