Processes — folio-assistant-core

The diagrams folio-assistant-core holds in its declared processes directories — one sub-graph’s slice of every instance’s processes. The skills, lanes and findings below count these diagrams only.

Generated by cat-harness-tools/scripts/gen-processes-viz.ts. Every number here is counted from the directory, never carried in prose — bpmn-processes’ own rule, and the bean that asked for this page had two different counts in its title and its body.

30 diagram(s), 30 parsed, 0 that would not load.

wherediagrams
folio-assistant-core/collab/processes/content/14
folio-assistant-core/processes/library/6
folio-assistant-core/processes/content/4
folio-assistant-core/processes/ui/3
folio-assistant-core/collab/processes/conduct/1
folio-assistant-core/collab/processes/library/1
folio-assistant-core/dsa/processes/1

Every process — one page each

Each page shows the diagram, what it is for, who acts in it, every step with the skill it runs, and which processes call it. kg:audit’s process-diagram-published fails a diagram no page shows — 45 of 62 were in that state before these pages existed (bean ooq3).

Running instances links each workflow instance’s own page — the diagram with its token, its stuck states, its beans and todos — for every instance running this process or calling it as a subprocess. Links and counts only: where an instance IS lives in its file under beans/workflows/.

processstepsundocumented stepsrunning instances
Getting started · IRI · JSON-LD16—none recorded
Authoring a document · IRI · JSON-LD11—none recorded
Committee review of a content change · IRI · JSON-LD10—none recorded
Make the content change · IRI · JSON-LD7—none recorded
Merge and publish a content change · IRI · JSON-LD4—none recorded
Stage the content change · IRI · JSON-LD4—none recorded
Content Change and Review · IRI · JSON-LD11—none recorded
Content lifecycle · IRI · JSON-LD10—none recorded
Draft, review and publish · IRI · JSON-LD13—none recorded
Editing and HCI validation · IRI · JSON-LD17—none recorded
Evidence for a recommendation · IRI · JSON-LD10—none recorded
Guideline Updates · IRI · JSON-LD8—none recorded
Make a decided public comment change · IRI · JSON-LD4—none recorded
Release a draft for public comment · IRI · JSON-LD7—none recorded
Public comment on a review draft · IRI · JSON-LD10—none recorded
L1 document ingestion — a document to the L1 source knowledge graph · IRI · JSON-LD16—none recorded
Data sharing agreement document life cycle · IRI · JSON-LD26—none recorded
Contributor feedback on a working draft · IRI · JSON-LD9—none recorded
Review and publish a folio · IRI · JSON-LD3—none recorded
Record agent step · IRI · JSON-LD3—none recorded
Review-log watch · IRI · JSON-LD7—none recorded
Deep document research · IRI · JSON-LD4—none recorded
Ingestion subprocess — build the L1 knowledge graph · IRI · JSON-LD7—none recorded
Ingestion subprocess — derive content from the assets · IRI · JSON-LD8—none recorded
Ingestion subprocess — extract structure · IRI · JSON-LD6—none recorded
Ingestion subprocess — the L1 completeness gate · IRI · JSON-LD4—none recorded
Publish extracted statements with source links · IRI · JSON-LD4—none recorded
Board: open and close content · IRI · JSON-LD7—none recorded
Board: place a note · IRI · JSON-LD3—none recorded
Board: relocate content to the trashcan · IRI · JSON-LD5—none recorded

What runs this skill?

The reverse of <bootstrap.processes:skill ref>, which is the join nothing else exposes: a skill says what to do, and until now nothing said which processes ask for it.

61 distinct skill(s) are named by an activity.

skillrun by
adjudicationcontent-change-review-committee.bpmn, ingest-l1-completeness-gate.bpmn
bean-coordinationgetting-started.bpmn, authoring-a-document.bpmn, content-change-review.bpmn, content-lifecycle.bpmn, draft-to-publication.bpmn, editing-hci-validation.bpmn, l1-document-ingestion.bpmn, dsa-document-lifecycle.bpmn
before-after-previewcontent-change-review-make.bpmn, content-change-review.bpmn, editing-hci-validation.bpmn
block-actionspublic-comment.bpmn
board-diagram-interchangeboard-place-note.bpmn, board-relocate.bpmn
board-windowsboard-open-close.bpmn, board-relocate.bpmn
content-authorcontent-change-review-make.bpmn, content-change-review.bpmn, content-lifecycle.bpmn, draft-to-publication.bpmn, editing-hci-validation.bpmn, evidence-retrieval.bpmn
content-feedbackcontent-lifecycle.bpmn, draft-to-publication.bpmn
content-graphcontent-change-review-make.bpmn
content-planauthoring-a-document.bpmn, content-lifecycle.bpmn
content-publishcontent-change-review-publish.bpmn, content-lifecycle.bpmn, draft-to-publication.bpmn, guideline-updates.bpmn, dsa-document-lifecycle.bpmn, folio-review-publish.bpmn
content-retirecontent-lifecycle.bpmn
content-reviewauthoring-a-document.bpmn, content-change-review-committee.bpmn, content-change-review.bpmn, content-lifecycle.bpmn, draft-to-publication.bpmn, editing-hci-validation.bpmn, evidence-retrieval.bpmn, guideline-updates.bpmn, dsa-document-lifecycle.bpmn, folio-review-publish.bpmn
content-testcontent-lifecycle.bpmn, draft-to-publication.bpmn, editing-hci-validation.bpmn
content-validateauthoring-a-document.bpmn, content-lifecycle.bpmn, draft-to-publication.bpmn, editing-hci-validation.bpmn
corpus-commit-contractediting-hci-validation.bpmn
decision-auditcontent-change-review-committee.bpmn, editing-hci-validation.bpmn, guideline-updates.bpmn
deep-document-researchdeep-document-research.bpmn
deletion-requires-confirmationboard-relocate.bpmn
dispatch-agentgetting-started.bpmn
document-authoringauthoring-a-document.bpmn, dsa-document-lifecycle.bpmn
document-intakegetting-started.bpmn, evidence-retrieval.bpmn, l1-document-ingestion.bpmn, ingest-build-l1-kg.bpmn, ingest-derive-content.bpmn, ingest-extract-structure.bpmn, ingest-l1-completeness-gate.bpmn
document-publishingauthoring-a-document.bpmn, public-comment-release.bpmn, dsa-document-lifecycle.bpmn
document-structureauthoring-a-document.bpmn, dsa-document-lifecycle.bpmn
dsa-catalogue-statusdsa-document-lifecycle.bpmn
dsa-checksumdsa-document-lifecycle.bpmn
dsa-dcat-recorddsa-document-lifecycle.bpmn
dsa-odrl-sourcedsa-document-lifecycle.bpmn
evidence-appraisalevidence-retrieval.bpmn
feature-stagingcontent-change-review-make.bpmn, content-change-review-publish.bpmn, content-change-review-stage.bpmn, content-change-review.bpmn
getting-startedgetting-started.bpmn
glossary-termsingest-build-l1-kg.bpmn
interaction-modalitygetting-started.bpmn
l1-document-ingestionl1-document-ingestion.bpmn, ingest-build-l1-kg.bpmn, ingest-derive-content.bpmn, ingest-extract-structure.bpmn
library-ingestionl1-document-ingestion.bpmn
normative-statementsauthoring-a-document.bpmn, dsa-document-lifecycle.bpmn
package-releasedsa-document-lifecycle.bpmn
prepare-mergecontent-change-review-publish.bpmn, content-change-review.bpmn, guideline-updates.bpmn
prepare-merge-autocontent-change-review-make.bpmn
public-commentdraft-to-publication.bpmn, public-comment-change.bpmn, public-comment-release.bpmn, public-comment.bpmn, dsa-document-lifecycle.bpmn
public-comment-channelspublic-comment-release.bpmn
publish-extracted-statementsauthoring-a-document.bpmn, l1-document-ingestion.bpmn, publish-extracted-statements.bpmn
quality-controldraft-to-publication.bpmn
registry-authority-contractevidence-retrieval.bpmn
remote-mountguideline-updates.bpmn
render-kg-to-cdndraft-to-publication.bpmn
rendered-impactcontent-change-review-committee.bpmn, content-change-review-stage.bpmn, guideline-updates.bpmn
repo-conversiongetting-started.bpmn
review-commentscontent-change-review-committee.bpmn, dsa-document-lifecycle.bpmn
review-heatmapcontent-change-review-committee.bpmn
review-log-watchrecord-agent-step.bpmn, review-log-watch.bpmn
review-sheet-agent-columnscontributor-feedback.bpmn, record-agent-step.bpmn, review-log-watch.bpmn
review-sheet-scriptpublic-comment-release.bpmn, contributor-feedback.bpmn, folio-review-publish.bpmn, record-agent-step.bpmn, review-log-watch.bpmn
staging-reviewcontent-change-review-committee.bpmn, content-change-review.bpmn, draft-to-publication.bpmn, public-comment-change.bpmn, folio-review-publish.bpmn
theme-art-intakel1-document-ingestion.bpmn
todo-managergetting-started.bpmn, authoring-a-document.bpmn, content-change-review-publish.bpmn, content-change-review-stage.bpmn, content-change-review.bpmn, content-lifecycle.bpmn, draft-to-publication.bpmn, editing-hci-validation.bpmn, evidence-retrieval.bpmn, l1-document-ingestion.bpmn, dsa-document-lifecycle.bpmn
translation-manageringest-l1-completeness-gate.bpmn
untainted-verificationingest-l1-completeness-gate.bpmn
uses-editorial-reviewcontent-change-review-committee.bpmn
visual-diffcontent-change-review-committee.bpmn
watchcontent-change-review-publish.bpmn, content-change-review-stage.bpmn

Names an ⓘ task panel shows without a link are listed on Task panel links: QA.

Who appears in a process?

A lane NAMES the Role its tasks are performed in; it is not itself a Role. The NAME is free text — process-model.ts notes that sixty lanes spell two dozen positions — so the lane’s partitionElementRef (or the legacy <bootstrap.processes:role ref>) is the join that does not depend on spelling, and it is reported separately below rather than merged into the name.

58 distinct lane name(s).

lanein
Ingestion Engine (agent, runs unattended)6
CI/CD Pipeline3
Editor3
Review Committee3
Authoring agent2
Authoring agent (system)2
Authoring Committee2
Board renderer2
Build pipeline2
Build pipeline (system)2
Editors + authoring agents2
Folio-Assistant Agent2
Public review (commenters, review committee, editor)2
Publication manager2
QA reviewer (independent)2
Reader2
Adaptation committee (policy, clinical, programme)1
Adaptation team (human or agentic)1
Author1
Author (human or agentic)1
Author (person)1
Author / guideline developer (person)1
Author and policy author1
Change set — feature branch and staging1
Clinical / scientific SMEs1
Content Author1
Deep researcher1
Editor / author (person)1
Evidence agent (system)1
Guideline publisher1
HCI validation pipeline (system)1
Intake agent1
Layout layer1
Log watcher (authoring agent)1
Mechanical validation (system)1
Non-mechanical validation (review agent or SME)1
Onboarding agent (system)1
Parties and signatories (provider, recipient)1
Programme manager1
Programme manager (release authority)1
Public commenter1
Publish — GitHub Pages1
Publisher (data provider’s publication manager)1
Re-pin steward and build pipeline1
Release build and archive (pipeline)1
Review committee1
Review committee and editor1
Review coordinator1
Review Coordinator1
Review team (content · QC · technical officer)1
Review team and SMEs1
Reviewer1
Reviewer (legal, policy)1
Reviewer (SME or editor)1
Trusted registries and observatories (external)1
User (person)1
Validation and QA (mechanical + agents)1
Work plan (beans)1

Which steps touch the work plan?

<cat-harness.processes:bean op> — the audit trail for who reserves and resolves work.

opdiagrams
note10

Strict, advisory — and nobody said

Three states, not two. loadProcessModel reads an undeclared policy as strict, which is right for the engine — “a process that forgot to say is governed, not exempt” — and hides a fact a reader wants. Somebody chose strict and nobody said, so the engine assumed strict are different, and the second is 9 of 30 here.

enforcementdeclareddefaulted
strict99
advisory120

Findings

Every one of the 30 diagrams has a rendered SVG.

Activities carrying no <bootstrap.processes:skill ref> — a census, not a gap list

14 across 4 diagram(s). This section reported them as defects in its first version, and that was wrong: beans luke and uuhu worked this corpus from 90 down to this remainder and settled what is left. luke: “coverage is deliberately NOT gated — a human sign-off step has no skill”. uuhu added the call-activity exemption and recorded that its own remainder “are not gaps”.

3 are call activities, which delegate to a subprocess — the skill is named there, and naming it twice would be one fact in two places. The other 11 are listed by lane, because the lane is what says whether a person, a pipeline or an agent performs the step, and only the last of those has a skill to run.

lanesteps
Parties and signatories (provider, recipient)6
Author and policy author2
Content Author1
Editor / author (person)1
Folio-Assistant Agent1

No verdict is offered on which of these is a gap, and that is the honest state rather than a hedge: distinguishing a person’s judgement step from an agent step somebody forgot needs the lane’s actor KIND, which a free-text lane name does not give — process-model.ts notes sixty lanes spell two dozen positions. The lane’s partitionElementRef is the join that would answer it, and it is present on 11 of these 11 steps — which is the measurement, not an impression. An earlier draft of this sentence said few of these and was counting whether the lane had a NAME, a different question with a different answer.


folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev