callumalpass_tasknotes/conformance
2026-03-31 05:41:55 +11:00
..
README.md Extract core logic and add conformance waivers 2026-03-31 05:41:55 +11:00
waivers.json Extract core logic and add conformance waivers 2026-03-31 05:41:55 +11:00

Conformance Waivers

npm run conformance:test in tasknotes can skip specific tasknotes-spec fixture IDs without editing the shared spec repo.

Configure waivers in waivers.json.

Each waiver must include:

  • id: fixture id such as link.0028
  • scope: short category such as host-controlled, known-deviation, or spec-gap
  • reason: short human-readable summary
  • justification: why the fixture is not currently actionable for TaskNotes

Example:

{
  "waivers": [
    {
      "id": "link.0028",
      "scope": "host-controlled",
      "reason": "Ambiguous simple-name wikilink resolution is delegated to Obsidian",
      "justification": "TaskNotes passes link paths to metadataCache.getFirstLinkpathDest and does not own the final candidate tie-break policy."
    }
  ]
}

Behavior:

  • The local runner filters waived fixtures after generation and restores the spec fixtures afterward.
  • The waiver summary is printed before the test run.
  • Waiver ids must match generated fixture ids, and every waiver must include a justification.