agentfootprint/canonical-notes.json

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

{
  "$comment": "GENERATED by scripts/gen-canonical-notes.mjs from this package's own built exports - do not edit by hand. These are the strings a tool written in another language must reproduce byte for byte: the static notes each result shape carries, the reserved marker keys that make those shapes recognizable, the coverage block's heading, and the wire spelling of a result's period (every reserved key and the literal 'unknown') and of a ledger's in-progress list. Keys are the exported constant names, so the same value is reachable as a TypeScript import from the package's main entry point. The package version lives in package.json.",
  "notes": {
    "ABSENCE_NOTE": "The search ran and matched nothing. This is an ANSWER, not an error: nothing failed, nothing was substituted for what was asked, and calling this tool again with the same arguments returns this same result. `checked` is the ground this answer covers; anything under `not_checked` or `cannot_cover` is ground it does NOT cover, and reaching that needs a different question, not a retry.",
    "COVERAGE_NOTE": "This result covers only what `checked` lists. `not_checked` is ground the call this result answers did not look at, and `cannot_cover` is ground this tool can never see — a clean result here is NOT evidence about either, and no retry changes `cannot_cover`. Carry these limits into any answer you build on this result.",
    "SEMANTICS_NOTE": "Typed data, not prose. `grain` and `provenance` are caveats that travel with the numbers: check `is_counter` before summing values from a series, read `measured_at` (and `age_seconds`) as how old the data is, and treat everything under `not_covered` as ground this result does NOT cover — a clean look here says nothing about it."
  },
  "markers": {
    "ABSENCE_MARKER": "af_absent",
    "COVERAGE_MARKER": "af_coverage",
    "SEMANTICS_MARKER": "af_semantics"
  },
  "headings": {
    "COVERAGE_BLOCK_HEADING": "Coverage of this answer"
  },
  "wire": {
    "PERIOD_WIRE": {
      "key": "period",
      "queried": "queried",
      "held": "held",
      "from": "from",
      "to": "to",
      "readAt": "read_at",
      "heldUnknown": "unknown"
    },
    "IN_PROGRESS_WIRE": {
      "key": "in_progress",
      "count": "count"
    }
  }
}