AIFACTORY-FEAT-077: Studio work area: Intelligence¶
Generated from the architecture model
This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
A design artefact, not a tracker
This backlog is generated from model/backlog/ and validated against the architecture model. No work item exists in any tracker, and no item carries a date, an estimate or an assignee (ADR-0029).
Epic Factory Studio (PF-14) · Increment I3 Studio · State elaborated · Route frontend-developer · Build order 117 of 185 (Factory code)
The 6 screens of the Studio work area Intelligence on the Blazor shell and microfrontends, bound to the read models and commands the model names for them, with their state families, roles, locales and accessibility contracts. Screens come from model/ux/screens.yaml and the prototype alignment.
| Delivers | — |
| Stubs | — |
| Realizes | ux work areas: Intelligence |
| Requirements | — |
| Depends on | — |
| Sources | model/ux/screens.yaml, model/ux/prototype-alignment.yaml |
AIFACTORY-US-1399: Intelligence: I read the artifacts of a run with their lineage, versions and previews within my classification ceiling, and export the artifacts of a project¶
behavior · persona requester
As a requester, I want to open every artifact my run produced with its validation state, lineage, version chain and a preview, so that I judge the output of a run from its sources, and never see content above my classification ceiling.
A requester, a reviewer, an operator or an observer opens the screen artifacts at /intelligence/artifacts. StudioBff composes it under the scope of the session from ArtifactService, reached through KnowledgeHost: ListRunArtifacts for a run, with the validation state of each artifact, where a run of which the service holds nothing is answered with an empty list and the page says that the run recorded no artifact; GetArtifact for the metadata, the lineage, the position in the version chain and a scoped download reference; ListArtifactVersions for the version chain; and PreviewArtifact for a rendered diff, document or report, which is a projection and never a second copy. Generated content is shown in its own language and direction and marked as content, as docs/planes/experience/studio/localization-accessibility.md requires. An artifact whose classification is above the ceiling of the viewer is refused by ArtifactService with 403 and the page shows the denial with its explanation and no content, which is the adverse branch of the flow submit-assessment of model/ux/flows.yaml; classification follows ADR-0019 decision 2. An artifact of another tenant is answered 404 like one that does not exist. A user whose session permission snapshot holds the scope of the command may export the artifacts, lineage and metadata of a project in open formats with ExportArtifacts, an external-class action forwarded through ForwardCommand with an idempotency key and answered 202; the page shows the export as requested, and ADR-0019 decision 5 makes the tenant the owner of what it exports. Any other role sees the export disabled with the reason. When KnowledgeHost does not answer, the source is shown degraded with its last freshness and the export is refused with 503, never queued. StudioBff consumes ArtifactStored, ArtifactValidated and ArtifactSuperseded and refreshes the artifact view of an open page, so a superseded version is marked without a reload.
Acceptance criteria
| AC1 | Given a requester on artifacts for their run, when StudioBff/GetScreenModel composes it, then the list, the metadata, the lineage, the version chain and the preview come from ArtifactService/ListRunArtifacts, ArtifactService/GetArtifact, ArtifactService/ListArtifactVersions and ArtifactService/PreviewArtifact, and a run with no artifact shows an empty list with that statement, never an error (FUX-06). |
| AC2 | Given an artifact whose classification is above the ceiling of the viewer, when it is opened, then ArtifactService/GetArtifact or ArtifactService/PreviewArtifact answers 403 and the page shows the denial with its explanation and no content, as the flow submit-assessment of model/ux/flows.yaml requires; an artifact of another tenant is answered 404 (ADR-0019 decision 2, ADR-0015). |
| AC3 | Given a user whose session holds the export scope, when they export the artifacts of a project, then StudioBff/ForwardCommand forwards ArtifactService/ExportArtifacts with an idempotency key, the answer 202 is shown, and any other role sees the control disabled with the reason (ADR-0019 decision 5). |
| AC4 | Given an open artifact, when ArtifactService/ArtifactSuperseded, ArtifactService/ArtifactValidated or ArtifactService/ArtifactStored is consumed by StudioBff, then the page shows the new state without a reload, and when KnowledgeHost does not answer the source is shown degraded with its last freshness and the export is refused with 503 (model/services/factory-studio/StudioBff.yaml). |
| Traces: services | StudioBff, ArtifactService |
| Traces: apis | StudioBff/GetScreenModel, StudioBff/ForwardCommand, ArtifactService/ListRunArtifacts, ArtifactService/GetArtifact, ArtifactService/PreviewArtifact, ArtifactService/ListArtifactVersions, ArtifactService/ExportArtifacts |
| Traces: events | ArtifactService/ArtifactStored, ArtifactService/ArtifactValidated, ArtifactService/ArtifactSuperseded |
| Traces: adrs | ADR-0015, ADR-0019 |
| Traces: requirements | FUX-06 |
| Relates: screens | artifacts |
| Depends on | feature:studio-bff, feature:component-blazor-shell, feature:artifact-service, feature:knowledge-host |
| Sources | model/ux/screens.yaml, model/ux/flows.yaml, model/services/knowledge/ArtifactService.yaml, docs/architecture/adr/0019-data-governance.md, docs/planes/experience/studio/localization-accessibility.md |
Tasks
| Task | Kind | Expected output | Repository |
|---|---|---|---|
AIFACTORY-TASK-5645 Artifacts and lineage screen in the Intelligence microfrontend |
ui | The Intelligence microfrontend renders artifacts with the freshness family, the validation state per artifact, the lineage and the version chain, a preview panel that marks generated content in its own language and direction, the denial with its explanation for an artifact above the ceiling, and the export control with its reason when it is disabled. |
ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-5646 Screen model and export route of the artifacts screen in StudioBff |
contract | StudioBff composes artifacts through KnowledgeHost from ListRunArtifacts, GetArtifact, ListArtifactVersions and PreviewArtifact with the freshness of the source, returns a 403 of a classification ceiling unchanged, forwards ExportArtifacts with an idempotency key and the scope of the session, and refreshes the artifact view on ArtifactStored, ArtifactValidated and ArtifactSuperseded. |
ConnectSoft.AI.SoftwareFactory.StudioBff |
AIFACTORY-TASK-5647 Verify the artifacts screen with a ceiling denial and a superseded version |
verification | Run dotnet test -c Release --no-build and npx playwright test --project=chromium with a StudioBff stub serving artifacts of a run, an empty run, a 403 above the ceiling, a 404 of another tenant, a superseded version and an unreachable KnowledgeHost; the tests prove AC1 to AC4 of AIFACTORY-US-1399 (ArtifactService/PreviewArtifact, ArtifactService/ExportArtifacts). |
ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-5701 Verify the StudioBff side of the artifacts screen |
verification | Run dotnet test -c Release --filter "Category=Acceptance&Feature=studio-intelligence-artifacts-and-lineage" in StudioBff against stubbed platform gateways, where a filter that matches no test fails the run; the tests prove on the StudioBff side AC1 (composition through KnowledgeHost from the four artifact reads with freshness, an empty list for a run with no artifact), AC2 (the 403 of a classification ceiling and the 404 of another tenant returned unchanged with no content), AC3 (ExportArtifacts forwarded once with its idempotency key and its 202 returned) and AC4 (refresh on ArtifactStored, ArtifactValidated and ArtifactSuperseded, 503 while KnowledgeHost does not answer, nothing queued) of AIFACTORY-US-1399 (StudioBff/GetScreenModel, StudioBff/ForwardCommand). |
ConnectSoft.AI.SoftwareFactory.StudioBff |
AIFACTORY-US-131: The Intelligence work area of the Studio is bound to the model¶
behavior · persona requester
As a requester, I want the Intelligence work area of the Studio (6 screens) bound to the read models, commands, state families and roles the model names for it, so that I can read the artifacts of my runs today and see plainly which knowledge views arrive later, with every control reflecting what I may do and how fresh what I see is.
This is the integration PBI of the Intelligence area. The Intelligence microfrontend is generated from the microfrontend library template, composed into the Studio shell through its registry and holds the six screens of model/ux/screens.yaml with their routes, read models, commands, state families and roles; it calls StudioBff only. A screen is offered to the roles its list names; for any other role it is absent from the navigation and GetScreenModel refuses it with 403. In I3 only artifacts reads a service at the depth it needs, delivered by AIFACTORY-US-1399. The knowledge services are thin: KnowledgeIngestionService performs no ingestion, VectorMemoryService answers retrieval with an empty, well-formed result because no index exists, RepositoryIntelligenceService works only inside the sandbox of a run with no repository index, and ContextBuilderService passes the pinned artifacts of a step through without budget, ranking or provenance; none of them serves the public reads ListSources, GetSnapshot, Search, QueryGraph, ListRepositoryIndexSets, ListContextSnapshots or GetContextSnapshot before its complete delivery in I5, and MemoryPromotionService is delivered in I5. So knowledge-sources, knowledge-search, memory, repository-intelligence and context-snapshot are registered, offered to their roles and show their sources as unknown in the freshness family, named, never hidden, never filled from a fake and never presented as an empty index; none of their commands is offered. Every screen subscribes through Realtime.Subscribe of StudioRealtimeGateway; when the channel drops the page marks its data stale and when it returns the page reloads the screen model. Every screen renders in English, Russian and Hebrew right to left and is built to the accessibility contract of docs/planes/experience/studio/localization-accessibility.md; the area evidence that follows this PBI checks it on the finished area.
Acceptance criteria
| AC1 | Given the shell with the Intelligence microfrontend, when each of the 6 screens of model/ux/screens.yaml opens for a role its list names, then it renders from StudioBff/GetScreenModel only, and for a role its list does not name the screen is not offered and StudioBff/GetScreenModel answers 403 (ADR-0007, ADR-0015). |
| AC2 | Given knowledge-sources, knowledge-search, memory, repository-intelligence and context-snapshot, when they open in I3, then each shows its sources as unknown in the freshness family of model/ux/states.yaml with the source named, shows neither an invented value nor an empty index, and offers none of its commands, as model/backlog/features/knowledge.yaml states the thin scopes (FUX-09). |
| AC3 | Given an open screen and its subscription through StudioRealtimeGateway/Realtime.Subscribe, when the channel drops, then the page marks the data stale and never presents it as current, and when the channel returns the page reloads StudioBff/GetScreenModel and shows the current state without a browser reload (FUX-06). |
| AC4 | Given the export of artifacts, when a role issues it, then it is forwarded once through StudioBff/ForwardCommand with an idempotency key and the scope of the session, a role without the right sees the control disabled with the reason, and the screens render in en, ru and he right to left under docs/planes/experience/studio/localization-accessibility.md. |
| Traces: services | StudioBff, StudioRealtimeGateway, ArtifactService |
| Traces: apis | StudioBff/GetStudioSession, StudioBff/GetScreenModel, StudioBff/ForwardCommand, StudioRealtimeGateway/Realtime.Subscribe |
| Traces: adrs | ADR-0007, ADR-0015 |
| Traces: requirements | FUX-06, FUX-09 |
| Relates: screens | knowledge-sources, knowledge-search, memory, repository-intelligence, context-snapshot |
| Depends on | AIFACTORY-US-1399, feature:studio-bff, feature:studio-realtime-gateway, feature:component-blazor-shell |
| Sources | model/ux/screens.yaml, model/ux/states.yaml, model/ux/prototype-alignment.yaml, model/backlog/features/knowledge.yaml, docs/planes/experience/studio/screens/intelligence.md |
Tasks
| Task | Kind | Expected output | Repository |
|---|---|---|---|
AIFACTORY-TASK-439 Screens of the work area Intelligence: Knowledge sources, Knowledge search and graph, Memory and promotion, Repository intelligence, Context snapshot, Artifacts and lineage |
ui | The Intelligence microfrontend is composed into the shell through the registry with one navigation group and the six routes of model/ux/screens.yaml; each screen renders from StudioBff only, and the five screens of later sources render their sources as unknown with the source named and no command. | ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-440 Commands of the work area Intelligence |
implementation | The export of artifacts is forwarded through StudioBff with an idempotency key and the scope of the session, and the commands of the five screens of later sources (source registration, sync, deletion, collections, memory promotion, archive, consent, index rebuild) are not offered in I3. |
ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-441 States, roles, locales and accessibility of the work area Intelligence |
implementation | Each screen shows the state families the model names for it, hides or disables what the role may not do with the reason, marks stale data on a dropped channel and reloads on its return, renders in every supported locale including right-to-left, and passes the accessibility checks of the UX model. | ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-744 Verify studio-intelligence-work-area by running the declared command |
verification | Run dotnet build -c Release, dotnet test -c Release --no-build and npx playwright test --project=chromium; they pass and prove AC1 to AC4 of AIFACTORY-US-131 (StudioBff/GetScreenModel, StudioRealtimeGateway/Realtime.Subscribe). |
ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-US-1400: Intelligence area evidence: every screen passes the accessibility and phone-width checks and an end-to-end walk of the area through StudioBff is recorded¶
evidence · persona observer
As an observer, I want proof that every screen of the Intelligence area is usable by keyboard, in every locale and at phone width, and that the screens of later sources say so, so that the area is accepted on a recorded check and nobody reads an empty knowledge screen as an empty index.
This PBI is the proof of the Intelligence area and comes after its integration PBI AIFACTORY-US-131, which registers the six screens. The accessibility and phone-width check opens each of the six screens of the area for a role its list in model/ux/screens.yaml names and asserts the rules of docs/planes/experience/studio/localization-accessibility.md: WCAG 2.2 AA by the automated checks, keyboard operation, generated content marked and shown in its own direction inside right-to-left pages, refusals explained in words, reduced motion honoured, in English, Russian and Hebrew, light and dark, at 1440 by 900 and at 390 by 844 with no horizontal scroll. The end-to-end walk signs in as a requester and opens the artifacts of the fixture run of the first outcome with their lineage, versions and previews, then opens an artifact above the ceiling of a second user to see the denial; it signs in as an observer to see the same screens without the export; and it opens the five knowledge, memory, repository and context screens to assert that each shows its sources as unknown, named, because their services are delivered thin or not at all in I3, and never presents an empty list as an empty index. The record holds per screen and role the expected and observed result and the network log, which shows no address other than StudioBff and StudioRealtimeGateway.
Acceptance criteria
| AC1 | Given each of the 6 screens of the area in model/ux/screens.yaml, when the accessibility check runs in the three locales, both schemes and the two viewports of docs/planes/experience/studio/localization-accessibility.md, then every screen passes the automated WCAG 2.2 AA checks and keyboard operation and has no horizontal scroll at 390 by 844 (NFR-15, FUX-12). |
| AC2 | Given the walk as a requester, a second user under a lower ceiling and an observer, when it runs on the acceptance estate, then the artifacts of the fixture run render from StudioBff/GetScreenModel, the denial above the ceiling is shown with its explanation, and the five screens of later sources show their sources as unknown and named (ADR-0007, FUX-09). |
| AC3 | Given the record and the network log of the walk, when they are read, then the browser called no address other than StudioBff and StudioRealtimeGateway and the record holds one line per screen and role with the expected and observed result (FUX-12). |
| Traces: services | StudioBff |
| Traces: apis | StudioBff/GetScreenModel |
| Traces: adrs | ADR-0007 |
| Traces: requirements | FUX-09, FUX-12 |
| Relates: screens | knowledge-sources, knowledge-search, memory, repository-intelligence, context-snapshot, artifacts |
| Relates: nfrs | NFR-15 |
| Depends on | AIFACTORY-US-1399, AIFACTORY-US-131, feature:studio-bff, feature:component-blazor-shell |
| Sources | model/ux/screens.yaml, docs/planes/experience/studio/localization-accessibility.md, docs/planes/experience/studio/screens/intelligence.md |
Tasks
| Task | Kind | Expected output | Repository |
|---|---|---|---|
AIFACTORY-TASK-5648 End-to-end walk of the Intelligence area |
fixture | A browser-driven walk in the Studio repository that signs in as a requester, a user under a lower classification ceiling and an observer, opens the artifacts of the fixture run and the five screens of later sources, and records per screen and role the rendered state, the source markers, the offered commands and the addresses the browser called. | ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-5649 Accessibility and phone-width check of the Intelligence screens |
verification | Run dotnet test -c Release --filter Category=Accessibility, npx playwright test --project=chromium at 1440 by 900 and npx playwright test --project=phone-390x844, the Playwright project of the Studio at 390 by 844, on the six screens in en, ru and he, light and dark; the results prove AC1 of AIFACTORY-US-1400 against docs/planes/experience/studio/localization-accessibility.md. |
ConnectSoft.AI.SoftwareFactory.Studio |
AIFACTORY-TASK-5650 Verify the walk record of the Intelligence area |
verification | Run the walk of AIFACTORY-TASK-5648 on the acceptance estate; its record and network log prove AC2 and AC3 of AIFACTORY-US-1400 (StudioBff/GetScreenModel) and are kept with the evidence of increment I3. | ConnectSoft.AI.SoftwareFactory.Studio |