Proof dependency graph

Render the dependency graph of a paper’s proof objects from proof-objects.json as SVG (or DOT), each node linking to its anchor in the published PDF.

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.

docs-generation

How a checkout of this harness generates and publishes its docs site: regenerating derived references, composing the docs layers and each layer’s site into one Jekyll source, building it with just-the-docs, the post-build passes, the TypeDoc API reference, the knowledge-graph export, and the full-replace publish to gh-pages and its branches/ previews.

Source: cat-harness/skills/ui/ui-core/docs-generation.md.

Also satisfied by: bpmn-checklist, bpmn-render, ci-post-merge-regen, pages-index, pages-publish, readme-audit, readme-sync, render-order, schema-docs, shared-assets, site-build-local, site-search-index, site-search-scopes, skill-docs, subgraph-readmes, upload-step-docs, stage-ig-sites.

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

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-objects-extract, 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
inmanifestRepoPathThe proof-objects.json to read.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
inoutputRepoPathWhere to write the SVG.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
inpdfBaseUrlUrlThe published PDF, for the anchor links.string · format uri · An absolute http(s) URL
indotOnlyFlagWrite DOT source instead of rendering.boolean · A boolean switch — projects to a bare flag, with no value word
outgraphRepoPathThe SVG, or DOT with --dot-only.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.

Processes and tasks

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

processsteplanevia skill
Publishing the docs site, and keeping the previews aliveCompose each layer’s site [its Tool]CI/CD Pipelinedocs-generation

How it is deployed and reached

  • Command line. From the repository root: python3 .github/scripts/generate_dependency_graph.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-dependency-graph.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-dependency-graph.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-dependency-graph",
  "title": "Proof dependency graph",
  "description": "Render the dependency graph of a paper's proof objects from `proof-objects.json` as SVG (or DOT), each node linking to its anchor in the published PDF.",
  "install": {
    "none": true
  },
  "invoke": {
    "shell": "python3 .github/scripts/generate_dependency_graph.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 read.",
        "required": false,
        "arg": {
          "flag": "--manifest"
        }
      },
      {
        "name": "output",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "Where to write the SVG.",
        "required": false,
        "arg": {
          "flag": "--output"
        }
      },
      {
        "name": "pdfBaseUrl",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Url",
        "description": "The published PDF, for the anchor links.",
        "required": false,
        "arg": {
          "flag": "--pdf-base-url"
        }
      },
      {
        "name": "dotOnly",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Flag",
        "description": "Write DOT source instead of rendering.",
        "required": false,
        "arg": {
          "flag": "--dot-only"
        }
      }
    ],
    "outputs": [
      {
        "name": "graph",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The SVG, or DOT with `--dot-only`."
      }
    ]
  },
  "satisfies": [
    "docs-generation",
    "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