Run the IRIS CDN export

Dispatch iris-cdn.yml: the nightly change ingest or the weekly reconciliation of the IRIS CDN (scripts/iris-cdn/run.ts), then verify the signed release. Started with the standard GitHub CLI; the run is watched with gh run watch.

Skills it satisfies

A skill states the capability; this Tool is one way to exercise it. Each skill’s declared input and output contract follows, where it has one.

iris-cdn-exporter

The IRIS CDN Exporter agent — how WHO IRIS is exported onto Cloudflare — a git repository on Cloudflare Artifacts and R2 behind the CDN — with an initial load (metadata and PDFs), a nightly change ingest over the DSpace REST API, a weekly reconciliation, and one signed release per run. What the agent decides, what the pipeline does, and the no-churn rule both obey.

Source: who-iris/skills/iris-cdn-exporter.md.

The skill declares no I/O contract (schemas/skills/iris-cdn-exporter/{input,output}.schema.json).

Inputs and outputs

Each port names a shared type by IRI, so two Tools for one skill can be checked for interchangeability.

porttyperequireddescriptionconstraint
inrepoRepoFullNameThe repository whose workflow is run. Default: the current one.string · pattern ^[A-Za-z0-9][A-Za-z0-9._-]*\\/[A-Za-z0-9][A-Za-z0-9._-]*$ · A forge repository’s full name, owner/name
inrefBranchThe branch to run it on. Default: the default branch.string · pattern ^[A-Za-z0-9][A-Za-z0-9._/-]*$ · A git branch name
outrunTextThe dispatched run; its outcome is read with gh run watch or gh run view.string · A short single-line human string. Not admissible as a command-line argument.

Processes and tasks

Steps this Tool can carry out, because each names a skill it satisfies:

processsteplanevia skill
IRIS CDN initial loadState scope and budget, with denominatorsOwneriris-cdn-exporter
IRIS CDN initial loadPlan batches by community and collectionIRIS CDN Exporter (agent)iris-cdn-exporter
IRIS CDN initial loadFetch bitstreams not already heldBuild pipelineiris-cdn-exporter
IRIS CDN initial loadStore bytes under SHA-256 (skip if held)Build pipelineiris-cdn-exporter
IRIS CDN initial loadCommit the batch checkpointBuild pipelineiris-cdn-exporter
IRIS CDN initial loadQuarantine and report the mismatchBuild pipelineiris-cdn-exporter
IRIS CDN initial loadReview the load report; open beans for gapsIRIS CDN Exporter (agent)iris-cdn-exporter
IRIS CDN nightly change ingestFetch only bitstreams whose checksum changedBuild pipelineiris-cdn-exporter
IRIS CDN nightly change ingestWrite canonical records into the libraryBuild pipelineiris-cdn-exporter
IRIS CDN nightly change ingestReview the run report; open beans for anomaliesIRIS CDN Exporter (agent)iris-cdn-exporter
IRIS CDN weekly reconciliationTreat the listing as faulty; escalateIRIS CDN Exporter (agent)iris-cdn-exporter
Sign and publish an IRIS CDN releaseStore new objects (never overwrite)Release signeriris-cdn-exporter

How it is deployed and reached

  • Command line. From the repository root: gh workflow run iris-cdn.yml.
  • GitHub Actions. No workflow in this checkout runs its command.

As an API: its operation in the OpenAPI document and the MCP tool list of its layer.

installcli: gh
runtimegh
networkyes

When a host it reaches is refused:

host / errorremedy
github.comnone: The workflow runs on GitHub; with no host there is nothing to dispatch. The scripts it runs can still be run locally.
when to choose it
whenRunning the IRIS CDN nightly ingest or reconciliation on demand instead of waiting for its schedule. Pass the mode with -f mode=nightly or -f mode=reconcile.
limitsNeeds a token that may dispatch workflows (actions: write) on the repository.
costA CI run on GitHub’s runners.

What it is made of

Linked data

The Tool is published as its own JSON-LD document at its IRI, https://litlfred.github.io/folio-assistant/who-iris/tools/ci-iris-cdn.jsonld, partOf its layer’s document. The node below is the definition this page was drawn from, and is embedded in the page as application/ld+json.

{
  "@context": "https://litlfred.github.io/folio-assistant/who-iris/who-iris.context.jsonld",
  "@id": "https://litlfred.github.io/folio-assistant/who-iris/tools/ci-iris-cdn.jsonld",
  "@type": "https://litlfred.github.io/cat-harness/v0/ns/Tool",
  "partOf": "https://litlfred.github.io/folio-assistant/who-iris/who-iris.jsonld",
  "name": "ci-iris-cdn",
  "title": "Run the IRIS CDN export",
  "description": "Dispatch `iris-cdn.yml`: the nightly change ingest or the weekly reconciliation of the IRIS CDN (`scripts/iris-cdn/run.ts`), then verify the signed release. Started with the standard GitHub CLI; the run is watched with `gh run watch`.",
  "install": {
    "cli": "gh"
  },
  "invoke": {
    "shell": "gh workflow run iris-cdn.yml"
  },
  "io": {
    "inputs": [
      {
        "name": "repo",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoFullName",
        "description": "The repository whose workflow is run. Default: the current one.",
        "required": false,
        "arg": {
          "flag": "--repo"
        }
      },
      {
        "name": "ref",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Branch",
        "description": "The branch to run it on. Default: the default branch.",
        "required": false,
        "arg": {
          "flag": "--ref"
        }
      }
    ],
    "outputs": [
      {
        "name": "run",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Text",
        "description": "The dispatched run; its outcome is read with `gh run watch` or `gh run view`."
      }
    ]
  },
  "satisfies": [
    "iris-cdn-exporter"
  ],
  "requirements": {
    "runtime": [
      "gh"
    ],
    "network": true
  },
  "remedies": [
    {
      "host": "github.com",
      "none": "The workflow runs on GitHub; with no host there is nothing to dispatch. The scripts it runs can still be run locally."
    }
  ],
  "selection": {
    "when": "Running the IRIS CDN nightly ingest or reconciliation on demand instead of waiting for its schedule. Pass the mode with `-f mode=nightly` or `-f mode=reconcile`.",
    "limits": "Needs a token that may dispatch workflows (actions: write) on the repository.",
    "cost": "A CI run on GitHub's runners."
  }
}

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