githublarskomo/skillz-for-all/knowledge-view

Knowledge View

Zweck

Eine Knowledge View ist ein reproduzierbares Read Model über Knowledge Artifacts. Das Prinzip entspricht einer Datenbankansicht: Auswahl und Darstellung ändern die Quelle nicht.

Vertrag

Eine View-Spezifikation enthält mindestens:

• id
• sourceScopes
• filters
• optionale sort, groupBy, fields, derivedFields
• includeStates (standardmäßig nur active, sofern der aufrufende Fach-Skill nichts anderes verlangt)

Der Output enthält:

• die angewandte View-Spezifikation,
• referenzierte Artifact-IDs,
• projizierte Felder,
• asOf bzw. den Snapshot-Bezug.

Workflow

1. Lade ausschließlich bereits zulässige Artefakte aus dem angegebenen Scope.
2. Wende Lifecycle-Filter vor inhaltlichen Filtern an.
3. Filtere und sortiere deterministisch.
4. Berechne abgeleitete Felder ausschließlich aus vorhandenen Werten; keine neuen fachlichen Claims.
5. Erhalte Artifact-IDs und SourceRefs für Drill-down und Audit.
6. Gib die View ohne Mutation der Quellen zurück.

Grenzen

• Kein Last-write-wins oder Conflict Resolution.
• Keine Memory-Aktivierung.
• Keine automatische Speicherung der View als neues Memory.
• Keine stillen Joins über Scopes, die der Aufrufer nicht freigegeben hat.

Qualitätsgate

Die gleiche View-Spezifikation auf demselben Snapshot muss dasselbe Ergebnis liefern. Jede Zeile muss auf ihre Quellartefakte zurückführbar sein. Offene Konflikte dürfen nicht durch Filterung als scheinbar eindeutige Wahrheit präsentiert werden.