Knowledge Platform — UI surfaces¶
Target
This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.
Screens fed by the platform¶
| Studio work area | Screen | Read model | Commands |
|---|---|---|---|
| Intelligence | Sources: kind, state, staleness, last snapshot, classification | GET /factory/knowledge/sources, GET /factory/knowledge/snapshots/{snapshotId} |
RegisterSource, SyncSource, DeleteSource (production-class) |
| Intelligence | Collections and index revisions with embedding profile versions | GET /factory/knowledge/collections/{collectionId}/indexes |
SetCollection, RebuildIndexes |
| Intelligence | Knowledge search with citations and trust tiers; graph query with temporal filters | POST /factory/knowledge/search, POST /factory/knowledge/graph/query |
none |
| Intelligence | Memory review inbox: candidates in review with evidence; promoted memory by scope | GET /factory/memory, GET /factory/memory/{memoryId} |
PromoteMemory (approval-gated), ArchiveMemory, SetMemoryConsent |
| Intelligence | Repository index sets per revision | GET /factory/repositories/{sourceId}/indexes |
RebuildRepositoryIndexes |
| Operations & usage | Run detail → context snapshots ("why was this included") | GET /factory/runs/{runId}/context-snapshots, GET /factory/context-snapshots/{contextSnapshotId} |
none |
| Operations & usage | Run detail → artifacts with previews, versions and lineage | GET /factory/runs/{runId}/artifacts, GET /factory/artifacts/{artifactId}/preview |
ExportArtifacts |
State families shown¶
| Family | Values |
|---|---|
| Source | Registered, Syncing, Healthy, Stale, Failing, Disabled, Deleting |
| Snapshot | Taken, Parsed, Chunked, Indexed, Published, Failed, Superseded |
| Index revision | Building, Ready, Rebuilding, Degraded, Retired |
| Context snapshot | Assembled, Truncated, Degraded, Failed |
| Artifact | Stored, Validated, Superseded, Deleted |
| Memory | Observed, Candidate, Classified, EvidenceChecked, InReview, Promoted, Reinforced, Decayed, Archived, Deleted |
| Trust tier | SourceFact, InferredFact, AgentObservation, UnverifiedMemory |
Rules the clients must honour¶
- Citations are shown with every result: source version, chunk, index revision and trust tier; a result without them is not rendered.
- Freshness is honest: a stale source is labelled on every search result that cites it.
- Context snapshots explain, never re-run: the Studio shows what was used and why from the snapshot, it never re-executes the assembly.
- Memory review shows evidence first and the exact content hash the decision binds to.
CLI and VS Code¶
factory knowledge sources|sync|search|graph, factory memory list|review, factory artifacts get|export; the VS Code extension offers scoped knowledge search in the editor and shows the context snapshot of the bound run.