Folio Assistant Core

Process

An IG release: the owner tags, a draft is built, the owner publishes

https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease

JSON-LD · diagram · in graph fhir-harness.jsonld ·

nameAn IG release: the owner tags, a draft is built, the owner publishes
summaryHow an IG repository's release is cut, and how a missed one is caught up (skill ig-binary-artefacts §"Releasing").
descriptionHow an IG repository's release is cut, and how a missed one is caught up (skill ig-binary-artefacts §"Releasing"). (Owner, 2026-11-10: "need to add this to process (and how to catchup if not tagged) of build".) THE RULE. A release is a governance decision. The owner tags the IG's CURRENT version from sushi-config.yaml, v<version>, on the default branch. The tag starts the IG's ig-release.yml caller, which builds the tag in full and makes a GitHub DRAFT release carrying package.tgz (and its R4/R4B variants), ast-data.zip and SHA256SUMS. The owner publishes the draft. An agent never chooses a version, never pushes a tag and never publishes a release. THE CATCH-UP. Every AST refresh of the default branch runs ig-release.ts check (advisory, never failing the run): an untagged current version is reported with the commit that set it, for the owner to tag; a tag with no release is reported with the by-hand run of the release workflow; a draft is reported as waiting for the owner. The site is not the release: it is published from the AST cache (ig-ast-cache.bpmn) and carries none of these files.
enforcementadvisory
sourcePathprocesses/content/ig-release.bpmn
sourceUrlhttps://github.com/litlfred/fhir-harness/blob/main/processes/content/ig-release.bpmn
depictionhttps://litlfred.github.io/folio-assistant/assets/img/workflows/ig-release.svg
startNodeVersion set on main
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Start_VersionSet
AST refresh of main
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Start_Check
nodeCount11
flowCount12
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

Flows

flow/Flow_1

partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromVersion set on main
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Start_VersionSet
toTag the IG's current version
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Tag
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_2

nametag pushed
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromTag the IG's current version
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Tag
toBuild the tag in full and make the draft release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_ReleaseBuild
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_3

namedraft made
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromBuild the tag in full and make the draft release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_ReleaseBuild
toPublish the draft release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Publish
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_4

partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromPublish the draft release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Publish
toRelease published
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/End_Released
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_5

partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromAST refresh of main
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Start_Check
toCheck the current version's tag and release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Check
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_6

partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromCheck the current version's tag and release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Check
toVersion tagged?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Tagged
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_7

nameno
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromVersion tagged?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Tagged
toTag the IG's current version
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Tag
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_8

nameyes
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromVersion tagged?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Tagged
toTag released?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Released
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_9

nameno release
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromTag released?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Released
toRun IG release (draft) by hand for the tag
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_RunRelease
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_10

namea draft
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromTag released?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Released
toPublish the draft release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_Publish
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_11

namepublished
partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromTag released?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/GW_Released
toReleased
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/End_InOrder
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_12

partOfAn IG release: the owner tags, a draft is built, the owner publishes
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease
fromRun IG release (draft) by hand for the tag
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_RunRelease
toBuild the tag in full and make the draft release
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgRelease/node/Task_ReleaseBuild
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes