Proof status from a Lean build

Update each proof object’s status in proof-objects.json from a Lean build log — which objects built, which carry sorry, which failed. Exits 1 on a manifest with no objects rather than writing an empty status.

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.

proof-status-tracking

Maintain the proof-objects.json manifest tracking formalization status, review records, and LaTeX-to-Lean linkages. Generate status dashboards and enforce review policies.

Source: folio-assistant-sci/skills/content/folio-paper-adapter/proof-status-tracking.md.

Also satisfied by: proof-dependency-graph, proof-objects-extract.

The skill declares no I/O contract (schemas/skills/proof-status-tracking/{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
inmanifestRepoPathThe proof-objects.json to update.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
inbuildLogRepoPathThe Lean build log; stdin when absent.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
outmanifestRepoPathproof-objects.json with statuses updated in place.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.

Processes and tasks

No process step names a skill this Tool satisfies.

How it is deployed and reached

  • Command line. From the repository root: python3 .github/scripts/update_proof_status.py.
  • 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.

installnone
runtimepython3
networkno

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/folio-assistant-sci/tools/proof-status-update.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/folio-assistant-sci/folio-assistant-sci.context.jsonld",
  "@id": "https://litlfred.github.io/folio-assistant/folio-assistant-sci/tools/proof-status-update.jsonld",
  "@type": "https://litlfred.github.io/cat-harness/v0/ns/Tool",
  "partOf": "https://litlfred.github.io/folio-assistant/folio-assistant-sci/folio-assistant-sci.jsonld",
  "name": "proof-status-update",
  "title": "Proof status from a Lean build",
  "description": "Update each proof object's status in `proof-objects.json` from a Lean build log — which objects built, which carry `sorry`, which failed. Exits 1 on a manifest with no objects rather than writing an empty status.",
  "install": {
    "none": true
  },
  "invoke": {
    "shell": "python3 .github/scripts/update_proof_status.py"
  },
  "io": {
    "inputs": [
      {
        "name": "manifest",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The proof-objects.json to update.",
        "required": false,
        "arg": {
          "flag": "--manifest"
        }
      },
      {
        "name": "buildLog",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The Lean build log; stdin when absent.",
        "required": false,
        "arg": {
          "flag": "--build-log"
        }
      }
    ],
    "outputs": [
      {
        "name": "manifest",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "proof-objects.json with statuses updated in place."
      }
    ]
  },
  "satisfies": [
    "proof-status-tracking"
  ],
  "requirements": {
    "runtime": [
      "python3"
    ],
    "network": false
  }
}

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