Generated from who-iris/processes/iris-cdn-nightly.bpmn by gen-processes-viz.ts — do not edit here. All processes · who-iris processes

IRIS CDN nightly change ingest

Process_IrisCdnNightly · strict (defaulted) · 9 step(s)

Every night: ask the IRIS DSpace REST API which items changed since the last published run, ingest only those, rebuild the whole graph (sorted output keeps unchanged partitions byte-identical), and publish a signed release. A night with no changes publishes nothing and commits nothing.

BPMN diagram: IRIS CDN nightly change ingest

How it connects

Lanes — who acts

lanerolewhat it does here
Build pipelinebuild-pipelineDeterministic scripts in scripts/iris-cdn/, entry point run.ts. Same input, same bytes.
IRIS CDN Exporter (agent)iris-cdn-exporterThe agent role. It plans, reviews and reports; it does not hold the signing key, and it never pushes to a WHO repository.

Steps

4 of 9 step(s) carry no documentation — activity-documented lists them.

steplaneskill / sub-processwhat it does
Read the cursor of the last published run
Task_ReadCursor
Build pipelineiris-rest-feedstate/cursor.json in the Cloudflare git repository: the lastModified of the newest item in the last VERIFIED release.
List items changed since the cursor
Task_ListChanged
Build pipelineiris-rest-feedscripts/iris-cdn/rest-feed.ts changedSince: a Discovery search for lastModified at or after the cursor, sorted by dc.date.accessioned (IRIS rejects a lastModified sort), paged until an item is older than the cursor. Inclusive of the cursor second, de-duplicated by uuid, returned oldest first.
Fetch the changed records and bitstream lists
Task_FetchChanged
Build pipelineiris-rest-feed
iris-dspace
—
Fetch only bitstreams whose checksum changed
Task_FetchNewBytes
Build pipelineiris-cdn-exporter—
Write canonical records into the library
Task_WriteRecords
Build pipelineiris-cdn-exporterA record whose canonical bytes equal the held ones is not rewritten. A touched-but-unchanged item therefore produces no diff.
Rebuild the whole graph (sorted output)
Call_Rebuild
Build pipelinecalls Package and distribute partitioned W3C N-Quads and named queries
iris-oxigraph
nquads-distribution
—
Sign and publish the release
Call_SignPublish
Build pipelinecalls Sign and publish an IRIS CDN release
iris-cdn-signing
—
Commit the advanced cursor
Task_AdvanceCursor
Build pipelineiris-rest-feedOnly after the release verified. A failed night leaves the cursor where it was, so the next night re-reads the same window.
Review the run report; open beans for anomalies
Task_Review
IRIS CDN Exporter (agent)iris-cdn-exporterAnomalies: a change count far from the recent median, quarantined bitstreams, a verification that came back unknown, a partition over its size ceiling.

Decisions

1 of 1 decision(s) carry no documentation — gateway-documented lists them.

decisionwhat decides itbranches
Anything changed?
GW_Any
—no → Nothing published, nothing committed
yes → Fetch the changed records and bitstream lists

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