Folio Assistant Core

Process

An IG site, built from the AST on its cache branch

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

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

nameAn IG site, built from the AST on its cache branch
summaryHow an IG repository's own site is published, and how the AST it is built from is kept current (skill ig-build-pipeline §"The AST cache lifecycle").
descriptionHow an IG repository's own site is published, and how the AST it is built from is kept current (skill ig-build-pipeline §"The AST cache lifecycle"). THE RULE. An IG site is built from the IG Publisher AST read from the IG repository's cache branch cat/fhir-harness/fhir-ast/<package id>, never from Publisher HTML. The publish refuses an AST that is not valid for the commit it publishes (ig-cache.sh restore then verify). A later commit that changes no IG input (sushi-config.yaml, ig.ini, input/) does not make the AST stale. THE REFRESH. The cache is written by ONE thing: fhir-harness's reusable workflow .github/workflows/ig-ast-refresh.yml, which an IG repository's Site publish calls as its first job (ast; template templates/ig-repo-site/site-publish.yml). It runs the Publisher through the AST exporter on a GitHub runner (Java, 10 GB heap, tx.fhir.org). It seeds the branch only from a commit on the default branch whose inputs equal the tip's. A valid AST is a cache, not a release: every page drawn from it carries the provisional mark (ig-ast-delta).
enforcementadvisory
sourcePathprocesses/content/ig-ast-cache.bpmn
sourceUrlhttps://github.com/litlfred/fhir-harness/blob/main/processes/content/ig-ast-cache.bpmn
depictionhttps://litlfred.github.io/folio-assistant/assets/img/workflows/ig-ast-cache.svg
startNodeIG site publish wanted
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Start_Publish
nodeCount11
flowCount11
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

Flows

flow/Flow_1

partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromIG site publish wanted
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Start_Publish
toRestore and judge the cached AST
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Restore
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_2

partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromRestore and judge the cached AST
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Restore
toAST valid for this commit?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Valid
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_3

nameyes
partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromAST valid for this commit?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Valid
toBuild and publish the site from the AST
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_BuildSite
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_4

nameno — refused: stale, cannot tell, miss
partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromAST valid for this commit?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Valid
toDispatch AST refresh
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Dispatch
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_5

partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromBuild and publish the site from the AST
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_BuildSite
toReview the site's size
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_SizeReview
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_11

partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromReview the site's size
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_SizeReview
toSite published from the AST
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/End_Published
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_6

partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromDispatch AST refresh
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Dispatch
toBuild the IG with the AST exporter
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Export
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_7

partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromBuild the IG with the AST exporter
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Export
toOn the default branch, with its inputs?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Seedable
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_8

nameyes
partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromOn the default branch, with its inputs?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Seedable
toSeed the cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Seed
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_9

namepublish again
partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromSeed the cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Seed
toRestore and judge the cached AST
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Restore
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes

flow/Flow_10

nameno
partOfAn IG site, built from the AST on its cache branch
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
fromOn the default branch, with its inputs?
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Seedable
toAST kept as a run artifact; cache unchanged
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/End_NotSeeded
inSubgraphfhir-harness-processes
https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes