Proof-object extraction

Extract the theorem, lemma and definition environments of a paper’s LaTeX chapters into proof-objects.json — the manifest the dependency graph and the proof-status update read.

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-status-update.

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
inoutputRepoPathWhere to write proof-objects.json.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
outmanifestRepoPathproof-objects.json. A chapter file that is missing is skipped with a warning, not treated as empty.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/extract_proof_objects.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-objects-extract.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-objects-extract.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-objects-extract",
  "title": "Proof-object extraction",
  "description": "Extract the theorem, lemma and definition environments of a paper's LaTeX chapters into `proof-objects.json` — the manifest the dependency graph and the proof-status update read.",
  "install": {
    "none": true
  },
  "invoke": {
    "shell": "python3 .github/scripts/extract_proof_objects.py"
  },
  "io": {
    "inputs": [
      {
        "name": "output",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "Where to write proof-objects.json.",
        "required": false,
        "arg": {
          "flag": "--output"
        }
      }
    ],
    "outputs": [
      {
        "name": "manifest",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "proof-objects.json. A chapter file that is missing is skipped with a warning, not treated as empty."
      }
    ]
  },
  "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