DMN reference column → L1 citations

Extract the L1 citations from a DMN decision table’s reference column (smart-base/L2-dmn/schemas/extract-citations.ts, ported from WHO smart-kg tools/extract-citations.mjs): one external-artifact node for the table and one citation node per distinct reference string, each left unresolved, with appearsIn edges and a coverage report of how many rules cite an L1 source. A citation string is content-addressed in the DAK’s namespace, so the same string is one node here and in the L2-DMN graph’s citesSource edges. The output is an L2 document.

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.

smart-base-tools

Source: smart-base/skills/content/authoring-who-smart-guidelines/smart-base-tools.md.

Also satisfied by: extract-dak, kg-extract-dak, bpmn-graphviz-layout, bpmn-to-fsh, bpmn-validate, kg-extract-bpmn, kg-extract-dmn, kg-extract-l3.

The skill declares no I/O contract (schemas/skills/smart-base-tools/{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
indmnRepoPathyesThe .dmn file to read.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
inoutRepoPathWhere the graph document goes; also echoed to stdout when absent.string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments.
outgraphRepoPathThe citation graph document (an L2 document: the table as an external artefact and its L1 citation nodes), plus a coverage report on stderr.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
SMART Guideline end to end3 · Choose L2 dependencies (WHO / jurisdiction DAKs)Authoring agentsmart-base-tools
SMART Guideline end to end4 · Create / adapt L2 DAK assetsAuthoring agentsmart-base-tools
SMART Guideline end to end5 · Choose L3 dependencies (WHO / jurisdiction IGs)Authoring agentsmart-base-tools
SMART Guideline end to end6 · Produce L3 assetsAuthoring agentsmart-base-tools

How it is deployed and reached

  • Command line. From the repository root: npx --prefix smart-base/L1/schemas tsx smart-base/L2-dmn/schemas/extract-citations.ts.
  • 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
when to choose it
whenA DMN decision table carries an L1 reference column and its citations are to be turned into graph nodes, with coverage counted rather than assumed.
limitsCopies each reference string verbatim and never resolves it to a publication — resolution is a judgement the schema requires evidence for. ‘[Add appropriate reference]’ is recorded as a placeholder, which coverage counts apart from a blank. The reference column is found by its description.
costSeconds, no network.

What it is made of

Linked data

The Tool is published as its own JSON-LD document at its IRI, http://smart.who.int/base/tools/kg-extract-citations.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": "http://smart.who.int/base/smart-base.context.jsonld",
  "@id": "http://smart.who.int/base/tools/kg-extract-citations.jsonld",
  "@type": "https://litlfred.github.io/cat-harness/v0/ns/Tool",
  "partOf": "http://smart.who.int/base/smart-base.jsonld",
  "name": "kg-extract-citations",
  "title": "DMN reference column → L1 citations",
  "description": "Extract the L1 citations from a DMN decision table's reference column (`smart-base/L2-dmn/schemas/extract-citations.ts`, ported from WHO smart-kg `tools/extract-citations.mjs`): one `external-artifact` node for the table and one `citation` node per distinct reference string, each left `unresolved`, with `appearsIn` edges and a coverage report of how many rules cite an L1 source. A citation string is content-addressed in the DAK's namespace, so the same string is one node here and in the L2-DMN graph's `citesSource` edges. The output is an L2 document.",
  "install": {
    "none": true
  },
  "invoke": {
    "shell": "npx --prefix smart-base/L1/schemas tsx smart-base/L2-dmn/schemas/extract-citations.ts"
  },
  "io": {
    "inputs": [
      {
        "name": "dmn",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The .dmn file to read.",
        "required": true
      },
      {
        "name": "out",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "Where the graph document goes; also echoed to stdout when absent.",
        "required": false,
        "arg": {
          "flag": "--out"
        }
      }
    ],
    "outputs": [
      {
        "name": "graph",
        "schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
        "description": "The citation graph document (an L2 document: the table as an external artefact and its L1 citation nodes), plus a coverage report on stderr."
      }
    ]
  },
  "satisfies": [
    "smart-base-tools"
  ],
  "selection": {
    "when": "A DMN decision table carries an L1 reference column and its citations are to be turned into graph nodes, with coverage counted rather than assumed.",
    "limits": "Copies each reference string verbatim and never resolves it to a publication — resolution is a judgement the schema requires evidence for. '[Add appropriate reference]' is recorded as a placeholder, which coverage counts apart from a blank. The reference column is found by its description.",
    "cost": "Seconds, no network."
  }
}

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