Fetch IRIS cover PDFs

Dispatch iris-cover-pdfs.yml: fetch the PDFs the replica’s home page references (scripts/iris-covers/fetch-referenced-pdfs.py) and render their cover previews (scripts/iris-covers/render-previews.py). 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-dspace

How WHO IRIS uses DSpace and qualified Dublin Core — the three identifier systems, MeSH as a controlled vocabulary, bundles, and the containment path — and the requirements a tool reading a record must meet.

Source: who-iris/skills/iris-dspace.md.

The skill declares no I/O contract (schemas/skills/iris-dspace/{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 loadPlan batches by community and collectionIRIS CDN Exporter (agent)iris-dspace
IRIS CDN initial loadHarvest a batch of item records (REST)Build pipelineiris-dspace
IRIS CDN nightly change ingestFetch the changed records and bitstream listsBuild pipelineiris-dspace

How it is deployed and reached

  • Command line. From the repository root: gh workflow run iris-cover-pdfs.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
whenRefreshing the replica’s cover previews on demand. Pass -f only=<slugs> to limit it to some items.
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-cover-pdfs.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-cover-pdfs.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-cover-pdfs",
  "title": "Fetch IRIS cover PDFs",
  "description": "Dispatch `iris-cover-pdfs.yml`: fetch the PDFs the replica's home page references (`scripts/iris-covers/fetch-referenced-pdfs.py`) and render their cover previews (`scripts/iris-covers/render-previews.py`). Started with the standard GitHub CLI; the run is watched with `gh run watch`.",
  "install": {
    "cli": "gh"
  },
  "invoke": {
    "shell": "gh workflow run iris-cover-pdfs.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-dspace"
  ],
  "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": "Refreshing the replica's cover previews on demand. Pass `-f only=<slugs>` to limit it to some items.",
    "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