dunstan 0.1.14 → 0.1.16

package/README.md

@@ -26,7 +26,7 @@ jobs:
   handback:
     runs-on: ubuntu-latest
     steps:
-      - uses: BargLabs/dunstan@v0.1.14 # pin the full commit SHA in production
+      - uses: BargLabs/dunstan@v0.1.16 # pin the full commit SHA in production
         with:
           report-source: pr-body
 ```
@@ -52,7 +52,7 @@ export exists).
 
 ## Use with Claude
 
-Dunstan ships as a Claude Code plugin: two MCP tools and a skill that has Claude declare, check and
+Dunstan ships as a Claude Code plugin: three MCP tools and a skill that has Claude declare, check and
 report a pull request's handback before it says done ([`plugins/dunstan/`](plugins/dunstan/)).
 
 **Install.** In Claude Code:
@@ -62,7 +62,7 @@ report a pull request's handback before it says done ([`plugins/dunstan/`](plugi
 /plugin install dunstan@barglabs
 ```
 
-The plugin runs the MCP server with `npx -y dunstan@0.1.14 mcp`, the `dunstan` npm package at that
+The plugin runs the MCP server with `npx -y dunstan@0.1.16 mcp`, the `dunstan` npm package at that
 exact version: one self-contained file, no dependencies.
 
 **The token.** When you enable the plugin, Claude Code asks for an optional GitHub token and keeps it

package/dist/dunstan.mjs

@@ -9881,7 +9881,7 @@ async function reportFromComment(client, repository, number4, login) {
 // src/record/checker.ts
 import { readFileSync } from "node:fs";
 var CHECKER_NAME = "dunstan";
-var CHECKER_VERSION = "0.1.14";
+var CHECKER_VERSION = "0.1.16";
 function checkerIdentity(artifact) {
   return {
     name: CHECKER_NAME,
@@ -10567,7 +10567,7 @@ var FILES = { "handback-block-0.1.schema.json": `{
     }
   }
 }
-`, "survey-0.1-draft.schema.json": '{\n  "$schema": "https://json-schema.org/draft/2020-12/schema",\n  "$id": "https://barglabs.ai/dunstan/spec/schema/survey-0.1-draft.schema.json",\n  "title": "Dunstan survey record, DRAFT 0.1",\n  "description": "DRAFT, informative, for the operator to check (spec/claim-format.md, \\"DRAFT survey 0.1\\"). A read-only survey of a repository\'s recent pull requests: the selection, one entry per selected pull request with the record a check wrote for it or the reason there is none, and an aggregate that is a pure function of the entries. Each embedded record is a 0.1 or DRAFT 0.2.0 record and is validated against its own schema when the survey is verified. It changes neither record schema.",\n  "type": "object",\n  "required": ["format", "checker", "selection", "entries", "aggregate", "rerun", "digest"],\n  "additionalProperties": false,\n  "properties": {\n    "format": { "const": "dunstan-survey-0.1-draft" },\n    "checker": { "$ref": "record-0.1.schema.json#/$defs/predicate/properties/checker" },\n    "selection": {\n      "type": "object",\n      "required": ["parameters", "reader", "listing", "selected"],\n      "additionalProperties": false,\n      "properties": {\n        "parameters": { "$ref": "#/$defs/parameters" },\n        "reader": {\n          "description": "Whether the survey read GitHub with a token (GITHUB_TOKEN was set). The aggregate\'s remedy lines are worded for it. The token is never recorded.",\n          "type": "object",\n          "required": ["authenticated"],\n          "additionalProperties": false,\n          "properties": { "authenticated": { "type": "boolean" } }\n        },\n        "listing": { "$ref": "#/$defs/listing" },\n        "selected": {\n          "type": "array",\n          "uniqueItems": true,\n          "items": { "$ref": "#/$defs/number" }\n        }\n      }\n    },\n    "entries": {\n      "description": "One per selected pull request, in selection order. Verify checks that their pull request numbers are exactly `selection.selected`, which holds no number twice.",\n      "type": "array",\n      "uniqueItems": true,\n      "items": { "$ref": "#/$defs/entry" }\n    },\n    "aggregate": { "$ref": "#/$defs/aggregate" },\n    "rerun": {\n      "type": "object",\n      "required": ["offline", "online"],\n      "additionalProperties": false,\n      "properties": {\n        "offline": { "type": "string", "minLength": 1 },\n        "online": { "type": "string", "minLength": 1 }\n      }\n    },\n    "digest": {\n      "description": "SHA-256 of the JCS bytes of the survey record without this member.",\n      "type": "object",\n      "required": ["sha256"],\n      "additionalProperties": false,\n      "properties": { "sha256": { "$ref": "record-0.1.schema.json#/$defs/sha256" } }\n    }\n  },\n  "$defs": {\n    "number": { "type": "integer", "minimum": 1 },\n    "count": { "type": "integer", "minimum": 0 },\n    "login": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})(?:\\\\[bot\\\\])?$" },\n    "parameters": {\n      "type": "object",\n      "required": ["repository", "last", "since", "authors", "report", "advisory"],\n      "additionalProperties": false,\n      "properties": {\n        "repository": { "$ref": "record-0.1.schema.json#/$defs/repository" },\n        "last": { "type": "integer", "minimum": 1, "maximum": 200 },\n        "since": {\n          "oneOf": [\n            { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },\n            { "type": "null" }\n          ]\n        },\n        "authors": { "type": "array", "items": { "$ref": "#/$defs/login" } },\n        "report": {\n          "oneOf": [\n            {\n              "type": "object",\n              "required": ["kind"],\n              "additionalProperties": false,\n              "properties": { "kind": { "const": "pr-body" } }\n            },\n            {\n              "type": "object",\n              "required": ["kind", "author"],\n              "additionalProperties": false,\n              "properties": {\n                "kind": { "const": "pr-comment" },\n                "author": { "$ref": "#/$defs/login" }\n              }\n            }\n          ]\n        },\n        "advisory": { "type": "boolean" }\n      }\n    },\n    "listing": {\n      "type": "object",\n      "required": ["pageBound", "pages", "pullRequests", "duplicates", "end"],\n      "additionalProperties": false,\n      "properties": {\n        "pageBound": { "type": "integer", "minimum": 1 },\n        "pages": {\n          "type": "array",\n          "minItems": 1,\n          "items": {\n            "type": "object",\n            "required": ["page", "locator", "sha256", "readAt", "items", "duplicates"],\n            "additionalProperties": false,\n            "properties": {\n              "page": { "$ref": "#/$defs/number" },\n              "locator": { "type": "string", "minLength": 1 },\n              "sha256": { "$ref": "record-0.1.schema.json#/$defs/sha256" },\n              "readAt": { "$ref": "record-0.1.schema.json#/$defs/timestamp" },\n              "items": { "$ref": "#/$defs/count" },\n              "duplicates": {\n                "description": "How many of this page\'s items repeat a pull request number an earlier item of the listing already held. They are not in `pullRequests`.",\n                "$ref": "#/$defs/count"\n              },\n              "error": { "type": "string", "pattern": "^(?:http_[1-5][0-9]{2}|network|parse)$" }\n            }\n          }\n        },\n        "duplicates": {\n          "description": "How many listed items repeated an earlier one: the sum of the pages\' duplicates. The pages\' items are the length of `pullRequests` plus this.",\n          "$ref": "#/$defs/count"\n        },\n        "pullRequests": {\n          "description": "Each listed pull request once, at its first occurrence, in listing order. Verify refuses a number listed twice.",\n          "type": "array",\n          "uniqueItems": true,\n          "items": {\n            "type": "object",\n            "required": ["number", "createdAt", "author", "merged"],\n            "additionalProperties": false,\n            "properties": {\n              "number": { "$ref": "#/$defs/number" },\n              "createdAt": { "$ref": "record-0.1.schema.json#/$defs/timestamp" },\n              "author": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },\n              "merged": { "type": "boolean" }\n            }\n          }\n        },\n        "end": {\n          "enum": [\n            "selection_full",\n            "since_reached",\n            "listing_ended",\n            "listing_unreadable",\n            "page_bound"\n          ]\n        }\n      }\n    },\n    "noRecordReason": {\n      "enum": [\n        "pull_request_unreadable",\n        "pull_request_moved",\n        "rate_limited",\n        "report_unavailable"\n      ]\n    },\n    "entry": {\n      "oneOf": [\n        {\n          "type": "object",\n          "required": ["pullRequest", "record"],\n          "additionalProperties": false,\n          "properties": {\n            "pullRequest": { "$ref": "#/$defs/number" },\n            "record": {\n              "description": "The record `dunstan check` writes for this pull request, as written: a 0.1 record, or a DRAFT 0.2.0 record when the survey ran the advisory reader. Verify validates it against its own schema.",\n              "type": "object"\n            }\n          }\n        },\n        {\n          "type": "object",\n          "required": ["pullRequest", "record", "reason"],\n          "additionalProperties": false,\n          "properties": {\n            "pullRequest": { "$ref": "#/$defs/number" },\n            "record": { "type": "null" },\n            "reason": { "$ref": "#/$defs/noRecordReason" }\n          }\n        }\n      ]\n    },\n    "columns": {\n      "type": "object",\n      "required": ["supported", "unverifiable", "notRecordCheckable", "contradicted"],\n      "properties": {\n        "supported": { "$ref": "#/$defs/count" },\n        "unverifiable": { "$ref": "#/$defs/count" },\n        "notRecordCheckable": { "$ref": "#/$defs/count" },\n        "contradicted": { "$ref": "#/$defs/count" }\n      }\n    },\n    "fixed": { "type": "string", "pattern": "^[01]\\\\.[0-9]{4}$" },\n    "rate": {\n      "type": "object",\n      "required": ["numerator", "denominator", "value", "wilson95"],\n      "additionalProperties": false,\n      "properties": {\n        "numerator": { "$ref": "#/$defs/count" },\n        "denominator": { "$ref": "#/$defs/count" },\n        "value": { "oneOf": [{ "$ref": "#/$defs/fixed" }, { "type": "null" }] },\n        "wilson95": {\n          "oneOf": [\n            {\n              "type": "object",\n              "required": ["low", "high"],\n              "additionalProperties": false,\n              "properties": {\n                "low": { "$ref": "#/$defs/fixed" },\n                "high": { "$ref": "#/$defs/fixed" }\n              }\n            },\n            { "type": "null" }\n          ]\n        }\n      }\n    },\n    "aggregate": {\n      "type": "object",\n      "required": [\n        "mapping",\n        "pullRequests",\n        "claims",\n        "byType",\n        "cannotSettle",\n        "contradictedOfSettled",\n        "unsettled"\n      ],\n      "additionalProperties": false,\n      "properties": {\n        "mapping": {\n          "type": "object",\n          "required": ["version"],\n          "additionalProperties": false,\n          "properties": { "version": { "type": "string", "minLength": 1 } }\n        },\n        "pullRequests": {\n          "type": "object",\n          "required": [\n            "listed",\n            "selected",\n            "withRecord",\n            "blockFound",\n            "blockMissing",\n            "blockInvalid",\n            "blockAmbiguous",\n            "noRecord"\n          ],\n          "additionalProperties": false,\n          "properties": {\n            "listed": { "$ref": "#/$defs/count" },\n            "selected": { "$ref": "#/$defs/count" },\n            "withRecord": { "$ref": "#/$defs/count" },\n            "blockFound": { "$ref": "#/$defs/count" },\n            "blockMissing": { "$ref": "#/$defs/count" },\n            "blockInvalid": { "$ref": "#/$defs/count" },\n            "blockAmbiguous": { "$ref": "#/$defs/count" },\n            "noRecord": {\n              "type": "array",\n              "items": {\n                "type": "object",\n                "required": ["reason", "count"],\n                "additionalProperties": false,\n                "properties": {\n                  "reason": { "$ref": "#/$defs/noRecordReason" },\n                  "count": { "$ref": "#/$defs/count" }\n                }\n              }\n            }\n          }\n        },\n        "claims": {\n          "allOf": [{ "$ref": "#/$defs/columns" }],\n          "required": ["total"],\n          "properties": { "total": { "$ref": "#/$defs/count" } },\n          "unevaluatedProperties": false\n        },\n        "byType": {\n          "type": "array",\n          "items": {\n            "allOf": [{ "$ref": "#/$defs/columns" }],\n            "required": ["type"],\n            "properties": {\n              "type": { "enum": ["T1", "T2", "T3", "T4", "T5", "T6", "T7", "T8", "R"] }\n            },\n            "unevaluatedProperties": false\n          }\n        },\n        "cannotSettle": { "$ref": "#/$defs/rate" },\n        "contradictedOfSettled": { "$ref": "#/$defs/rate" },\n        "unsettled": {\n          "type": "array",\n          "items": {\n            "type": "object",\n            "required": ["reason", "column", "count", "remedy"],\n            "additionalProperties": false,\n            "properties": {\n              "reason": { "$ref": "record-0.1.schema.json#/$defs/claimReason" },\n              "column": { "enum": ["unverifiable", "notRecordCheckable"] },\n              "count": { "type": "integer", "minimum": 1 },\n              "remedy": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] }\n            }\n          }\n        },\n        "advisory": {\n          "type": "object",\n          "required": ["pullRequests", "notes"],\n          "additionalProperties": false,\n          "properties": {\n            "pullRequests": { "$ref": "#/$defs/count" },\n            "notes": {\n              "type": "array",\n              "items": {\n                "type": "object",\n                "required": ["note", "count"],\n                "additionalProperties": false,\n                "properties": {\n                  "note": { "type": "string", "minLength": 1 },\n                  "count": { "type": "integer", "minimum": 1 }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n' };
+`, "survey-0.1-draft.schema.json": '{\n  "$schema": "https://json-schema.org/draft/2020-12/schema",\n  "$id": "https://barglabs.ai/dunstan/spec/schema/survey-0.1-draft.schema.json",\n  "title": "Dunstan survey record, DRAFT 0.1",\n  "description": "DRAFT, informative, for the operator to check (spec/claim-format.md, \\"DRAFT survey 0.1\\"). A read-only survey of a repository\'s recent pull requests: the selection, one entry per selected pull request with the record a check wrote for it or the reason there is none, and an aggregate that is a pure function of the entries. Each embedded record is a 0.1 or DRAFT 0.2.0 record and is validated against its own schema when the survey is verified. It changes neither record schema.",\n  "type": "object",\n  "required": ["format", "checker", "selection", "entries", "aggregate", "rerun", "digest"],\n  "additionalProperties": false,\n  "properties": {\n    "format": { "const": "dunstan-survey-0.1-draft" },\n    "checker": { "$ref": "record-0.1.schema.json#/$defs/predicate/properties/checker" },\n    "selection": {\n      "type": "object",\n      "required": ["parameters", "reader", "listing", "selected"],\n      "additionalProperties": false,\n      "properties": {\n        "parameters": { "$ref": "#/$defs/parameters" },\n        "reader": {\n          "description": "Whether the survey read GitHub with a token (GITHUB_TOKEN was set). The aggregate\'s remedy lines are worded for it. The token is never recorded.",\n          "type": "object",\n          "required": ["authenticated"],\n          "additionalProperties": false,\n          "properties": { "authenticated": { "type": "boolean" } }\n        },\n        "listing": { "$ref": "#/$defs/listing" },\n        "selected": {\n          "type": "array",\n          "uniqueItems": true,\n          "items": { "$ref": "#/$defs/number" }\n        }\n      }\n    },\n    "entries": {\n      "description": "One per selected pull request, in selection order. Verify checks that their pull request numbers are exactly `selection.selected`, which holds no number twice.",\n      "type": "array",\n      "uniqueItems": true,\n      "items": { "$ref": "#/$defs/entry" }\n    },\n    "aggregate": { "$ref": "#/$defs/aggregate" },\n    "rerun": {\n      "type": "object",\n      "required": ["offline", "online"],\n      "additionalProperties": false,\n      "properties": {\n        "offline": { "type": "string", "minLength": 1 },\n        "online": { "type": "string", "minLength": 1 }\n      }\n    },\n    "digest": {\n      "description": "SHA-256 of the JCS bytes of the survey record without this member.",\n      "type": "object",\n      "required": ["sha256"],\n      "additionalProperties": false,\n      "properties": { "sha256": { "$ref": "record-0.1.schema.json#/$defs/sha256" } }\n    }\n  },\n  "$defs": {\n    "number": { "type": "integer", "minimum": 1 },\n    "count": { "type": "integer", "minimum": 0 },\n    "login": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})(?:\\\\[bot\\\\])?$" },\n    "parameters": {\n      "type": "object",\n      "required": ["repository", "last", "since", "authors", "report", "advisory"],\n      "additionalProperties": false,\n      "properties": {\n        "repository": { "$ref": "record-0.1.schema.json#/$defs/repository" },\n        "last": { "type": "integer", "minimum": 1, "maximum": 200 },\n        "since": {\n          "oneOf": [\n            { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },\n            { "type": "null" }\n          ]\n        },\n        "authors": { "type": "array", "items": { "$ref": "#/$defs/login" } },\n        "report": {\n          "oneOf": [\n            {\n              "type": "object",\n              "required": ["kind"],\n              "additionalProperties": false,\n              "properties": { "kind": { "const": "pr-body" } }\n            },\n            {\n              "type": "object",\n              "required": ["kind", "author"],\n              "additionalProperties": false,\n              "properties": {\n                "kind": { "const": "pr-comment" },\n                "author": { "$ref": "#/$defs/login" }\n              }\n            }\n          ]\n        },\n        "advisory": { "type": "boolean" }\n      }\n    },\n    "listingPage": {\n      "type": "object",\n      "required": ["page", "locator", "sha256", "readAt", "items", "duplicates"],\n      "additionalProperties": false,\n      "properties": {\n        "page": { "$ref": "#/$defs/number" },\n        "locator": { "type": "string", "minLength": 1 },\n        "sha256": { "$ref": "record-0.1.schema.json#/$defs/sha256" },\n        "readAt": { "$ref": "record-0.1.schema.json#/$defs/timestamp" },\n        "items": { "$ref": "#/$defs/count" },\n        "duplicates": {\n          "description": "How many of this page\'s items repeat a pull request number an earlier item of the same read already held. In the read used, they are not in `pullRequests`.",\n          "$ref": "#/$defs/count"\n        },\n        "error": { "type": "string", "pattern": "^(?:http_[1-5][0-9]{2}|network|parse)$" }\n      }\n    },\n    "listing": {\n      "description": "The read of the listing the selection is from, the last one, and the reads abandoned before it. A read is abandoned at its first page that repeats an earlier item, unless it is the third read, which is never abandoned.",\n      "type": "object",\n      "required": ["pageBound", "pages", "abandoned", "pullRequests", "duplicates", "end"],\n      "additionalProperties": false,\n      "properties": {\n        "pageBound": { "type": "integer", "minimum": 1 },\n        "pages": {\n          "type": "array",\n          "minItems": 1,\n          "items": { "$ref": "#/$defs/listingPage" }\n        },\n        "abandoned": {\n          "description": "One item per abandoned read, in order: its pages, the last of them the page that repeated an earlier item. No pull request list; abandoned reads contribute nothing to the selection. Empty when the first read was used.",\n          "type": "array",\n          "maxItems": 2,\n          "items": {\n            "type": "object",\n            "required": ["pages"],\n            "additionalProperties": false,\n            "properties": {\n              "pages": {\n                "type": "array",\n                "minItems": 1,\n                "items": { "$ref": "#/$defs/listingPage" }\n              }\n            }\n          }\n        },\n        "duplicates": {\n          "description": "How many listed items repeated an earlier one: the sum of the pages\' duplicates. The pages\' items are the length of `pullRequests` plus this.",\n          "$ref": "#/$defs/count"\n        },\n        "pullRequests": {\n          "description": "Each listed pull request once, at its first occurrence, in listing order. Verify refuses a number listed twice.",\n          "type": "array",\n          "uniqueItems": true,\n          "items": {\n            "type": "object",\n            "required": ["number", "createdAt", "author", "merged"],\n            "additionalProperties": false,\n            "properties": {\n              "number": { "$ref": "#/$defs/number" },\n              "createdAt": { "$ref": "record-0.1.schema.json#/$defs/timestamp" },\n              "author": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] },\n              "merged": { "type": "boolean" }\n            }\n          }\n        },\n        "end": {\n          "enum": [\n            "selection_full",\n            "since_reached",\n            "listing_ended",\n            "listing_unreadable",\n            "page_bound"\n          ]\n        }\n      }\n    },\n    "noRecordReason": {\n      "enum": [\n        "pull_request_unreadable",\n        "pull_request_moved",\n        "rate_limited",\n        "report_unavailable"\n      ]\n    },\n    "entry": {\n      "oneOf": [\n        {\n          "type": "object",\n          "required": ["pullRequest", "record"],\n          "additionalProperties": false,\n          "properties": {\n            "pullRequest": { "$ref": "#/$defs/number" },\n            "record": {\n              "description": "The record `dunstan check` writes for this pull request, as written: a 0.1 record, or a DRAFT 0.2.0 record when the survey ran the advisory reader. Verify validates it against its own schema.",\n              "type": "object"\n            }\n          }\n        },\n        {\n          "type": "object",\n          "required": ["pullRequest", "record", "reason"],\n          "additionalProperties": false,\n          "properties": {\n            "pullRequest": { "$ref": "#/$defs/number" },\n            "record": { "type": "null" },\n            "reason": { "$ref": "#/$defs/noRecordReason" }\n          }\n        }\n      ]\n    },\n    "columns": {\n      "type": "object",\n      "required": ["supported", "unverifiable", "notRecordCheckable", "contradicted"],\n      "properties": {\n        "supported": { "$ref": "#/$defs/count" },\n        "unverifiable": { "$ref": "#/$defs/count" },\n        "notRecordCheckable": { "$ref": "#/$defs/count" },\n        "contradicted": { "$ref": "#/$defs/count" }\n      }\n    },\n    "fixed": { "type": "string", "pattern": "^[01]\\\\.[0-9]{4}$" },\n    "rate": {\n      "type": "object",\n      "required": ["numerator", "denominator", "value", "wilson95"],\n      "additionalProperties": false,\n      "properties": {\n        "numerator": { "$ref": "#/$defs/count" },\n        "denominator": { "$ref": "#/$defs/count" },\n        "value": { "oneOf": [{ "$ref": "#/$defs/fixed" }, { "type": "null" }] },\n        "wilson95": {\n          "oneOf": [\n            {\n              "type": "object",\n              "required": ["low", "high"],\n              "additionalProperties": false,\n              "properties": {\n                "low": { "$ref": "#/$defs/fixed" },\n                "high": { "$ref": "#/$defs/fixed" }\n              }\n            },\n            { "type": "null" }\n          ]\n        }\n      }\n    },\n    "aggregate": {\n      "type": "object",\n      "required": [\n        "mapping",\n        "pullRequests",\n        "claims",\n        "byType",\n        "cannotSettle",\n        "contradictedOfSettled",\n        "unsettled"\n      ],\n      "additionalProperties": false,\n      "properties": {\n        "mapping": {\n          "type": "object",\n          "required": ["version"],\n          "additionalProperties": false,\n          "properties": { "version": { "type": "string", "minLength": 1 } }\n        },\n        "pullRequests": {\n          "type": "object",\n          "required": [\n            "listed",\n            "selected",\n            "withRecord",\n            "blockFound",\n            "blockMissing",\n            "blockInvalid",\n            "blockAmbiguous",\n            "noRecord"\n          ],\n          "additionalProperties": false,\n          "properties": {\n            "listed": { "$ref": "#/$defs/count" },\n            "selected": { "$ref": "#/$defs/count" },\n            "withRecord": { "$ref": "#/$defs/count" },\n            "blockFound": { "$ref": "#/$defs/count" },\n            "blockMissing": { "$ref": "#/$defs/count" },\n            "blockInvalid": { "$ref": "#/$defs/count" },\n            "blockAmbiguous": { "$ref": "#/$defs/count" },\n            "noRecord": {\n              "type": "array",\n              "items": {\n                "type": "object",\n                "required": ["reason", "count"],\n                "additionalProperties": false,\n                "properties": {\n                  "reason": { "$ref": "#/$defs/noRecordReason" },\n                  "count": { "$ref": "#/$defs/count" }\n                }\n              }\n            }\n          }\n        },\n        "claims": {\n          "allOf": [{ "$ref": "#/$defs/columns" }],\n          "required": ["total"],\n          "properties": { "total": { "$ref": "#/$defs/count" } },\n          "unevaluatedProperties": false\n        },\n        "byType": {\n          "type": "array",\n          "items": {\n            "allOf": [{ "$ref": "#/$defs/columns" }],\n            "required": ["type"],\n            "properties": {\n              "type": { "enum": ["T1", "T2", "T3", "T4", "T5", "T6", "T7", "T8", "R"] }\n            },\n            "unevaluatedProperties": false\n          }\n        },\n        "cannotSettle": { "$ref": "#/$defs/rate" },\n        "contradictedOfSettled": { "$ref": "#/$defs/rate" },\n        "unsettled": {\n          "type": "array",\n          "items": {\n            "type": "object",\n            "required": ["reason", "column", "count", "remedy"],\n            "additionalProperties": false,\n            "properties": {\n              "reason": { "$ref": "record-0.1.schema.json#/$defs/claimReason" },\n              "column": { "enum": ["unverifiable", "notRecordCheckable"] },\n              "count": { "type": "integer", "minimum": 1 },\n              "remedy": { "oneOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }] }\n            }\n          }\n        },\n        "advisory": {\n          "type": "object",\n          "required": ["pullRequests", "notes"],\n          "additionalProperties": false,\n          "properties": {\n            "pullRequests": { "$ref": "#/$defs/count" },\n            "notes": {\n              "type": "array",\n              "items": {\n                "type": "object",\n                "required": ["note", "count"],\n                "additionalProperties": false,\n                "properties": {\n                  "note": { "type": "string", "minLength": 1 },\n                  "count": { "type": "integer", "minimum": 1 }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n' };
 function schemaText(file2) {
   const text2 = FILES[file2];
   if (text2 === void 0) throw new Error(`no schema ${file2} in this build`);
@@ -35146,7 +35146,7 @@ var StdioServerTransport = class {
 
 // src/mcp/server.ts
 import { existsSync, writeFileSync as writeFileSync3 } from "node:fs";
-import { basename as basename2, resolve as resolve3 } from "node:path";
+import { basename as basename2, isAbsolute, resolve as resolve3 } from "node:path";
 
 // node_modules/.pnpm/zod@4.6.5/node_modules/zod/v3/helpers/util.js
 var util;
@@ -43335,14 +43335,147 @@ function suggestText(report) {
   return renderSuggestions(suggestDeclarations(report));
 }
 
+// src/template/tests-ci.ts
+var plural2 = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+function unsettled(reason, why, remedy) {
+  const notes = [`tests are not declared: ${why} (${reason}).`];
+  if (remedy !== void 0) notes.push(`remedy: ${remedy}`);
+  return { status: "unsettled", reason, notes };
+}
+async function testsFromCi(client, input2) {
+  const { repository, headCommit: head, record: record2 } = input2;
+  if (!client.hasToken) {
+    return unsettled(
+      "no_token",
+      "GITHUB_TOKEN is not set, and GitHub answers an artifact download only with a token, even on a public repository",
+      "set GITHUB_TOKEN to a token that can read the repository, with actions: read, and run dunstan template --tests-ci again."
+    );
+  }
+  if (!input2.pushed) {
+    return unsettled(
+      "not_pushed",
+      `HEAD ${head} is not on any remote-tracking branch, so no CI run can have tested it`,
+      "push it, wait for CI to finish, and run dunstan template --tests-ci again (run git fetch first if it was pushed from elsewhere)."
+    );
+  }
+  const observed = { runsNotCompleted: 0 };
+  const evidence = await readTestRecord(client, repository, record2, head, observed);
+  const named = `the artifact ${record2.artifact} holding ${record2.path} from job ${record2.job}`;
+  const pending = observed.runsNotCompleted > 0 ? `CI has not finished: ${plural2(observed.runsNotCompleted, "run", "runs")} of ${record2.workflow} at ${head} ${observed.runsNotCompleted === 1 ? "is" : "are"} not completed` : void 0;
+  const again = "run dunstan template --tests-ci again once CI has finished on this commit.";
+  if (evidence.status !== "ok") {
+    const reason = evidence.status === "unreadable" ? `source_unreadable:${evidence.source}` : `evidence_field_unpopulated:${evidence.field}`;
+    if (pending !== void 0) return unsettled(reason, pending, again);
+    const why = reason === "source_unreadable:artifact" ? `a run of ${record2.workflow} at ${head} uploaded ${record2.artifact}, and it could not be read` : `the workflow runs of ${record2.workflow} at ${head} could not be read`;
+    return unsettled(
+      reason,
+      why,
+      remedyForReason(reason, { hasToken: true }) ?? "run dunstan template --tests-ci again."
+    );
+  }
+  if (evidence.runs.length === 0) {
+    if (pending !== void 0) {
+      return unsettled(
+        "record_not_found",
+        `${pending}, and no completed run uploaded ${named}`,
+        again
+      );
+    }
+    return unsettled(
+      "record_not_found",
+      `no run of ${record2.workflow} at ${head} uploaded ${named}`,
+      remedyForReason("record_not_found", { hasToken: true })
+    );
+  }
+  const executed = new Set(evidence.runs.map((r) => r.executed));
+  const failed = new Set(evidence.runs.map((r) => r.failed));
+  if (executed.size > 1 || failed.size > 1) {
+    const counts = evidence.runs.map((r) => `run ${r.runId}: ${r.executed} executed, ${r.failed} failed`).join("; ");
+    return unsettled(
+      "record_ambiguous",
+      `the runs of ${record2.workflow} at ${head} that uploaded ${record2.artifact} disagree (${counts}), and the gate never picks one`,
+      "make the runs agree (re-run the one that differs), or name a job only one of them runs."
+    );
+  }
+  const run = evidence.runs[0];
+  const runs = evidence.runs.map((r) => r.runId).join(", ");
+  const notes = [
+    `tests: ${run.executed} executed and ${run.failed} failed in ${record2.path} in the artifact ${record2.artifact} of job ${record2.job} in ${record2.workflow} at ${head}, read from CI as the gate reads it (${evidence.runs.length === 1 ? "run" : "runs"} ${runs}).`
+  ];
+  if (pending !== void 0) {
+    notes.push(
+      `${pending}; a run that finishes later with other counts makes the gate's read ambiguous. Run dunstan template --tests-ci again once CI has finished.`
+    );
+  }
+  return {
+    status: "settled",
+    run: { command: input2.command, count: run.executed, failures: run.failed, record: record2 },
+    notes
+  };
+}
+
+// src/template/run.ts
+var DEFAULT_ARTIFACT = "dunstan-junit";
+var DEFAULT_ARTIFACT_PATH = "junit.xml";
+async function testsSource(request, context) {
+  const { cwd, tests } = request;
+  if (tests === void 0) return void 0;
+  if (tests.from === "local") return { kind: "local", junit: tests.junit, command: tests.command };
+  if (tests.from === "junit") {
+    return {
+      kind: "junit",
+      junit: tests.junit,
+      command: tests.command,
+      record: {
+        workflow: tests.workflow,
+        job: tests.job,
+        artifact: tests.artifact,
+        path: tests.artifactPath
+      }
+    };
+  }
+  const head = headCommit(cwd);
+  const repository = tests.repository ?? originRepository(cwd);
+  const client = new GitHubClient({
+    token: context.env.GITHUB_TOKEN,
+    ...context.fetch === void 0 ? {} : { fetch: context.fetch },
+    warn: context.warn
+  });
+  const read = await testsFromCi(client, {
+    repository,
+    headCommit: head,
+    command: tests.command,
+    pushed: isPushed(cwd, head),
+    record: {
+      kind: "junit",
+      workflow: tests.workflow,
+      job: tests.job,
+      artifact: tests.artifact ?? DEFAULT_ARTIFACT,
+      path: tests.artifactPath ?? DEFAULT_ARTIFACT_PATH
+    }
+  });
+  return { kind: "ci", read };
+}
+async function runTemplate(request, context) {
+  const tests = await testsSource(request, context);
+  const t = templateBlock({ cwd: request.cwd, base: request.base, tests });
+  return {
+    fence: renderBlock(t.block),
+    notes: t.notes,
+    tests: tests === void 0 ? "none" : tests.kind === "ci" && tests.read.status === "unsettled" ? "not_declared" : "declared"
+  };
+}
+
 // src/mcp/server.ts
 var TOOL_NAME = "dunstan_check_handback";
 var SUGGEST_TOOL_NAME = "dunstan_suggest_declarations";
+var TEMPLATE_TOOL_NAME = "dunstan_template_handback";
 var InputError = class extends Error {
 };
-var INSTRUCTIONS = `Before you say a task is done: generate your dunstan-handback block with \`dunstan template\` and add your test and reference claims; call ${SUGGEST_TOOL_NAME} with your report and declare or reword each sentence it lists; then call ${TOOL_NAME} with your pull request and the block. If the verdict is not pass, report the rows as they are; never edit the block to make it pass without changing the work. The check reads only what the block declares; the prose is yours to bring into the block.`;
+var INSTRUCTIONS = `Before you say a task is done: call ${TEMPLATE_TOOL_NAME} with the absolute path of your checkout (and tests.from "ci" once CI has finished on your last push) to generate your dunstan-handback block, or run \`dunstan template\`, the same thing from a shell; add your reference claims; call ${SUGGEST_TOOL_NAME} with your report and declare or reword each sentence it lists; then call ${TOOL_NAME} with your pull request and the block. If the verdict is not pass, report the rows as they are; never edit the block to make it pass without changing the work. The check reads only what the block declares; the prose is yours to bring into the block.`;
 var SUGGEST_DESCRIPTION = `List the sentences in your report's prose that look like claims your dunstan-handback block does not declare, before you say done. Give report, the report text. For each, declare it in the block, or reword it if it is not a claim about this PR. Offline: needs no pull request, reads nothing and writes nothing. Never a verdict: nothing passes or fails, and nothing is written to a record. The same text as \`dunstan suggest\`.`;
 var DESCRIPTION = `Check a completion handback against the repository's own record, before you say done. Give the subject (repository owner/name and pull request number) and exactly one of: block, the dunstan-handback block as a JSON object; or report, the report text that carries exactly one \`\`\`dunstan-handback fence. Of the checks claims, checks.allSucceeded is true only if every counted check run concluded success, so a skipped or neutral run makes it false; checks.noneFailed is true if none concluded other than success, skipped or neutral and at least one succeeded. Returns the verdict (pass, fail or unverifiable), the claims table, and the full record as JSON. Same checker and same verdict as \`dunstan check\` on the same evidence; no model decides. Reads GitHub metadata with GITHUB_TOKEN and writes nothing to GitHub or the repository; the record is written to a file only when you pass outPath. If the verdict is not pass, report the rows as they are; change the work, not the block.`;
+var TEMPLATE_DESCRIPTION = `Generate your dunstan-handback block from the local git checkout of your pull request's branch, after your last push: headCommit is HEAD, filesChanged is HEAD's diff against its merge base with base. Give directory, the checkout's absolute path. To declare tests, give tests.from "ci" with command, workflow and job once CI has finished on your last push: the counts are read from the JUnit record CI published, as the gate reads it, with GITHUB_TOKEN. tests.from "local" declares a local JUnit file as a local run, which the gate reports unverifiable. Returns the first line (tests: declared, tests: not declared, or tests: none asked) and the notes, then the fence, byte for byte what \`dunstan template\` prints. When the first line is tests: not declared, the block has no tests: do not add counts yourself; do what the note says. Add your references and checks yourself. Reads git and, with tests.from "ci", GitHub metadata and the JUnit artifact for its counts; writes nothing.`;
 function reportOfBlock(block) {
   const text2 = canonicalize(block);
   return {
@@ -43421,8 +43554,47 @@ function handbackResult(record2, outPath, notes, context) {
     ]
   };
 }
-function toolError(error62) {
-  const known = error62 instanceof InputError || error62 instanceof PullRequestUnreadable || error62 instanceof PullRequestMoved || error62 instanceof CanonicalizationError || typeof error62.code === "string";
+var TESTS_LINE = {
+  declared: "tests: declared",
+  not_declared: "tests: not declared",
+  none: "tests: none asked"
+};
+async function templateHandback(input2, options) {
+  if (!isAbsolute(input2.directory)) {
+    throw new InputError(`directory ${input2.directory} is not an absolute path`);
+  }
+  const warnings = [];
+  const run = await runTemplate(
+    { cwd: input2.directory, base: input2.base, tests: input2.tests },
+    {
+      env: options.env,
+      fetch: options.fetch,
+      warn: (message) => {
+        warnings.push(message);
+        options.warn(`dunstan: ${message}
+`);
+      }
+    }
+  );
+  const head = [TESTS_LINE[run.tests]];
+  if (run.tests === "not_declared") {
+    head.push("The block below has no tests. Do not add counts yourself; do what the note says.");
+  }
+  head.push(...[...warnings, ...run.notes].map((n) => `note: ${n}`));
+  return {
+    content: [
+      { type: "text", text: `${head.join("\n")}
+` },
+      { type: "text", text: run.fence }
+    ]
+  };
+}
+var ERROR_TAIL = {
+  check: "This is an error, not a verdict: nothing was checked.",
+  template: "This is an error: no block was produced."
+};
+function toolError(error62, tail = "check") {
+  const known = error62 instanceof InputError || error62 instanceof PullRequestUnreadable || error62 instanceof PullRequestMoved || error62 instanceof CanonicalizationError || error62 instanceof TemplateError || typeof error62.code === "string";
   const message = error62.message ?? String(error62);
   return {
     isError: true,
@@ -43430,12 +43602,37 @@ function toolError(error62) {
       {
         type: "text",
         text: `dunstan: ${known ? message : `internal error: ${message}`}
-This is an error, not a verdict: nothing was checked.
+${ERROR_TAIL[tail]}
 `
       }
     ]
   };
 }
+var nonEmpty = external_exports.string().min(1);
+var TEMPLATE_TESTS = external_exports.discriminatedUnion("from", [
+  external_exports.object({
+    from: external_exports.literal("ci"),
+    command: nonEmpty.describe("The command that ran the tests, as the block declares it."),
+    workflow: nonEmpty.describe(
+      "The workflow file that ran them, as a path: .github/workflows/ci.yml."
+    ),
+    job: nonEmpty.describe("The name of the job that uploaded the JUnit artifact."),
+    artifact: nonEmpty.optional().describe("The artifact holding the JUnit file. Absent: dunstan-junit."),
+    artifactPath: nonEmpty.optional().describe("The JUnit file in the artifact. Absent: junit.xml."),
+    repository: external_exports.string().regex(REPOSITORY, "repository must be owner/name").optional().describe("The GitHub repository, owner/name. Absent: the one the origin remote names.")
+  }).strict().describe(
+    "Read CI's counts at HEAD from the JUnit record CI published, as the gate reads it (dunstan template --tests-ci)."
+  ),
+  external_exports.object({
+    from: external_exports.literal("local"),
+    junit: nonEmpty.describe(
+      "The local JUnit XML file; a relative path resolves against directory."
+    ),
+    command: nonEmpty.describe("The command that ran the tests, as the block declares it.")
+  }).strict().describe(
+    "Declare a local JUnit file as a local run, which the gate reports unverifiable (dunstan template --tests-local)."
+  )
+]);
 function createDunstanMcpServer(options) {
   const server = new McpServer(
     { name: CHECKER_NAME, version: CHECKER_VERSION },
@@ -43489,6 +43686,37 @@ function createDunstanMcpServer(options) {
     },
     async (input2) => ({ content: [{ type: "text", text: suggestText(input2.report) }] })
   );
+  server.registerTool(
+    TEMPLATE_TOOL_NAME,
+    {
+      title: "Generate a handback block from git",
+      description: TEMPLATE_DESCRIPTION,
+      inputSchema: external_exports.object({
+        directory: nonEmpty.describe(
+          "The absolute path of the local git checkout of the pull request's branch. Git runs there."
+        ),
+        base: nonEmpty.optional().describe(
+          "The ref the pull request merges into, as dunstan template --base. Absent: the remote's default branch."
+        ),
+        tests: TEMPLATE_TESTS.optional().describe(
+          "Which tests to declare. Absent: none, and the note says how."
+        )
+      }).strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    async (input2) => {
+      try {
+        return await templateHandback(input2, options);
+      } catch (error62) {
+        return toolError(error62, "template");
+      }
+    }
+  );
   return server;
 }
 
@@ -43779,6 +44007,7 @@ function aggregate(entries, listed2, advisory, reader) {
 // src/survey/record.ts
 var SURVEY_FORMAT = "dunstan-survey-0.1-draft";
 var LISTING_PER_PAGE = 100;
+var LISTING_READS = 3;
 var DEFAULT_LAST = 30;
 var MAX_LAST = 200;
 function appendListed(listed2, seen, items) {
@@ -43896,6 +44125,15 @@ function listedOf(item) {
   };
 }
 async function readListing(client, parameters, now, pageBound) {
+  const abandoned = [];
+  for (; ; ) {
+    const last = abandoned.length === LISTING_READS - 1;
+    const read = await readOnce(client, parameters, now, pageBound, !last);
+    if ("end" in read) return { ...read, abandoned };
+    abandoned.push(read);
+  }
+}
+async function readOnce(client, parameters, now, pageBound, abandonOnRepeat) {
   const pages = [];
   const pullRequests = [];
   const seen = /* @__PURE__ */ new Set();
@@ -43928,6 +44166,7 @@ async function readListing(client, parameters, now, pageBound) {
       }
     }
     pages.push(entry);
+    if (abandonOnRepeat && entry.duplicates > 0) return { pages };
     const end = listingStop(parameters, pages, pullRequests);
     if (end !== null) return done(end);
   }
@@ -44022,7 +44261,7 @@ function share(r) {
 function interval(r) {
   return r.wilson95 === null ? "n/a" : `${r.wilson95.low}\u2013${r.wilson95.high}`;
 }
-function plural2(n, one, many) {
+function plural3(n, one, many) {
   return `${n} ${n === 1 ? one : many}`;
 }
 function renderSurveySummary(record2) {
@@ -44046,7 +44285,7 @@ function renderSurveySummary(record2) {
     "",
     "## Claims the record could not settle",
     "",
-    `The record could not settle ${a.cannotSettle.numerator} of ${plural2(a.cannotSettle.denominator, "claim", "claims")}.`,
+    `The record could not settle ${a.cannotSettle.numerator} of ${plural3(a.cannotSettle.denominator, "claim", "claims")}.`,
     ""
   );
   if (a.unsettled.length === 0) {
@@ -44118,7 +44357,7 @@ function renderSurveySummary(record2) {
       "",
       "## Advisory notes",
       "",
-      `The advisory reader read the prose of ${plural2(a.advisory.pullRequests, "pull request", "pull requests")}. Its notes never enter either rate, and a possible disagreement is unverified.`,
+      `The advisory reader read the prose of ${plural3(a.advisory.pullRequests, "pull request", "pull requests")}. Its notes never enter either rate, and a possible disagreement is unverified.`,
       ""
     );
     if (a.advisory.notes.length === 0) lines.push("No notes.");
@@ -44151,19 +44390,26 @@ function renderSurveySummary(record2) {
       ]
     ),
     "",
-    `The listing was read for ${plural2(listing.pages.length, "page", "pages")} and no further because ${listing.end === "page_bound" ? `it reached the bound of ${listing.pageBound} pages` : END_TEXT[listing.end]}.`
+    `The listing was read for ${plural3(listing.pages.length, "page", "pages")} and no further because ${listing.end === "page_bound" ? `it reached the bound of ${listing.pageBound} pages` : END_TEXT[listing.end]}.`
   );
+  const abandoned = listing.abandoned.length;
   if (listing.duplicates > 0) {
     const one = listing.duplicates === 1;
+    const reread = abandoned === 0 ? "" : ` It was read ${abandoned + 1} times, from the first page each time, and moved during every read.`;
     lines.push(
       "",
-      `The listing named ${plural2(listing.duplicates, "pull request", "pull requests")} again on a later page, so it changed while it was read: most likely ${plural2(listing.duplicates, "pull request", "pull requests")} closed meanwhile and ${one ? "was" : "were"} not listed, and the selection may be missing ${one ? "it" : "them"}. Each repeated pull request is listed, selected and counted once: the pages held ${listing.pullRequests.length + listing.duplicates} items for ${listing.pullRequests.length} pull requests.`
+      `The listing named ${plural3(listing.duplicates, "pull request", "pull requests")} again on a later page, so it changed while it was read: most likely ${plural3(listing.duplicates, "pull request", "pull requests")} closed meanwhile and ${one ? "was" : "were"} not listed, and the selection may be missing ${one ? "it" : "them"}. Each repeated pull request is listed, selected and counted once: the pages held ${listing.pullRequests.length + listing.duplicates} items for ${listing.pullRequests.length} pull requests.${reread}`
+    );
+  } else if (abandoned > 0) {
+    lines.push(
+      "",
+      `The listing moved while it was read: ${plural3(abandoned, "read was", "reads were")} abandoned at a repeated pull request and the listing was read again from the first page. The read used repeated no pull request.`
     );
   }
   if (selected.length < parameters.last) {
     lines.push(
       "",
-      `${plural2(selected.length, "pull request was", "pull requests were")} selected, fewer than the ${parameters.last} asked for.`
+      `${plural3(selected.length, "pull request was", "pull requests were")} selected, fewer than the ${parameters.last} asked for.`
     );
   }
   lines.push(
@@ -44250,95 +44496,12 @@ summary: ${values.summary}
 
 // src/cli/template.ts
 import { parseArgs as parseArgs6 } from "node:util";
-
-// src/template/tests-ci.ts
-var plural3 = (n, one, many) => `${n} ${n === 1 ? one : many}`;
-function unsettled(reason, why, remedy) {
-  const notes = [`tests are not declared: ${why} (${reason}).`];
-  if (remedy !== void 0) notes.push(`remedy: ${remedy}`);
-  return { status: "unsettled", reason, notes };
-}
-async function testsFromCi(client, input2) {
-  const { repository, headCommit: head, record: record2 } = input2;
-  if (!client.hasToken) {
-    return unsettled(
-      "no_token",
-      "GITHUB_TOKEN is not set, and GitHub answers an artifact download only with a token, even on a public repository",
-      "set GITHUB_TOKEN to a token that can read the repository, with actions: read, and run dunstan template --tests-ci again."
-    );
-  }
-  if (!input2.pushed) {
-    return unsettled(
-      "not_pushed",
-      `HEAD ${head} is not on any remote-tracking branch, so no CI run can have tested it`,
-      "push it, wait for CI to finish, and run dunstan template --tests-ci again (run git fetch first if it was pushed from elsewhere)."
-    );
-  }
-  const observed = { runsNotCompleted: 0 };
-  const evidence = await readTestRecord(client, repository, record2, head, observed);
-  const named = `the artifact ${record2.artifact} holding ${record2.path} from job ${record2.job}`;
-  const pending = observed.runsNotCompleted > 0 ? `CI has not finished: ${plural3(observed.runsNotCompleted, "run", "runs")} of ${record2.workflow} at ${head} ${observed.runsNotCompleted === 1 ? "is" : "are"} not completed` : void 0;
-  const again = "run dunstan template --tests-ci again once CI has finished on this commit.";
-  if (evidence.status !== "ok") {
-    const reason = evidence.status === "unreadable" ? `source_unreadable:${evidence.source}` : `evidence_field_unpopulated:${evidence.field}`;
-    if (pending !== void 0) return unsettled(reason, pending, again);
-    const why = reason === "source_unreadable:artifact" ? `a run of ${record2.workflow} at ${head} uploaded ${record2.artifact}, and it could not be read` : `the workflow runs of ${record2.workflow} at ${head} could not be read`;
-    return unsettled(
-      reason,
-      why,
-      remedyForReason(reason, { hasToken: true }) ?? "run dunstan template --tests-ci again."
-    );
-  }
-  if (evidence.runs.length === 0) {
-    if (pending !== void 0) {
-      return unsettled(
-        "record_not_found",
-        `${pending}, and no completed run uploaded ${named}`,
-        again
-      );
-    }
-    return unsettled(
-      "record_not_found",
-      `no run of ${record2.workflow} at ${head} uploaded ${named}`,
-      remedyForReason("record_not_found", { hasToken: true })
-    );
-  }
-  const executed = new Set(evidence.runs.map((r) => r.executed));
-  const failed = new Set(evidence.runs.map((r) => r.failed));
-  if (executed.size > 1 || failed.size > 1) {
-    const counts = evidence.runs.map((r) => `run ${r.runId}: ${r.executed} executed, ${r.failed} failed`).join("; ");
-    return unsettled(
-      "record_ambiguous",
-      `the runs of ${record2.workflow} at ${head} that uploaded ${record2.artifact} disagree (${counts}), and the gate never picks one`,
-      "make the runs agree (re-run the one that differs), or name a job only one of them runs."
-    );
-  }
-  const run = evidence.runs[0];
-  const runs = evidence.runs.map((r) => r.runId).join(", ");
-  const notes = [
-    `tests: ${run.executed} executed and ${run.failed} failed in ${record2.path} in the artifact ${record2.artifact} of job ${record2.job} in ${record2.workflow} at ${head}, read from CI as the gate reads it (${evidence.runs.length === 1 ? "run" : "runs"} ${runs}).`
-  ];
-  if (pending !== void 0) {
-    notes.push(
-      `${pending}; a run that finishes later with other counts makes the gate's read ambiguous. Run dunstan template --tests-ci again once CI has finished.`
-    );
-  }
-  return {
-    status: "settled",
-    run: { command: input2.command, count: run.executed, failures: run.failed, record: record2 },
-    notes
-  };
-}
-
-// src/cli/template.ts
 var RECORD_FLAGS = [
   "tests-workflow",
   "tests-job",
   "tests-artifact",
   "tests-artifact-path"
 ];
-var DEFAULT_ARTIFACT = "dunstan-junit";
-var DEFAULT_ARTIFACT_PATH = "junit.xml";
 async function template(args, io) {
   const { values } = parseArgs6({
     args,
@@ -44363,7 +44526,6 @@ async function template(args, io) {
   }
   if (flag("repo") !== void 0 && !ci) throw new UsageError("--repo goes with --tests-ci");
   const given = ["tests-command", ...RECORD_FLAGS].filter((f) => flag(f) !== void 0);
-  const cwd = io.cwd ?? process.cwd();
   let tests;
   if (ci) {
     const missing = ["tests-command", "tests-workflow", "tests-job"].filter(
@@ -44376,28 +44538,15 @@ async function template(args, io) {
     if (repo !== void 0 && !REPOSITORY.test(repo)) {
       throw new UsageError("--repo must be <owner/name>");
     }
-    const head = headCommit(cwd);
-    const repository = repo ?? originRepository(cwd);
-    const client = new GitHubClient({
-      token: io.env.GITHUB_TOKEN,
-      ...io.fetch === void 0 ? {} : { fetch: io.fetch },
-      warn: (message) => io.err(`dunstan: ${message}
-`)
-    });
-    const read = await testsFromCi(client, {
-      repository,
-      headCommit: head,
+    tests = {
+      from: "ci",
       command: flag("tests-command"),
-      pushed: isPushed(cwd, head),
-      record: {
-        kind: "junit",
-        workflow: flag("tests-workflow"),
-        job: flag("tests-job"),
-        artifact: flag("tests-artifact") ?? DEFAULT_ARTIFACT,
-        path: flag("tests-artifact-path") ?? DEFAULT_ARTIFACT_PATH
-      }
-    });
-    tests = { kind: "ci", read };
+      workflow: flag("tests-workflow"),
+      job: flag("tests-job"),
+      artifact: flag("tests-artifact"),
+      artifactPath: flag("tests-artifact-path"),
+      repository: repo
+    };
   } else if (flag("tests-local") !== void 0) {
     if (flag("tests-command") === void 0) {
       throw new UsageError("--tests-local needs --tests-command <cmd>");
@@ -44405,7 +44554,7 @@ async function template(args, io) {
     const extra = RECORD_FLAGS.find((f) => flag(f) !== void 0);
     if (extra !== void 0) throw new UsageError(`--${extra} does not go with --tests-local`);
     tests = {
-      kind: "local",
+      from: "local",
       junit: flag("tests-local"),
       command: flag("tests-command")
     };
@@ -44419,24 +44568,26 @@ async function template(args, io) {
       );
     }
     tests = {
-      kind: "junit",
+      from: "junit",
       junit: flag("tests-junit"),
       command: flag("tests-command"),
-      record: {
-        workflow: flag("tests-workflow"),
-        job: flag("tests-job"),
-        artifact: flag("tests-artifact"),
-        path: flag("tests-artifact-path")
-      }
+      workflow: flag("tests-workflow"),
+      job: flag("tests-job"),
+      artifact: flag("tests-artifact"),
+      artifactPath: flag("tests-artifact-path")
     };
   } else if (given.length > 0) {
     throw new UsageError(`--${given[0]} goes with --tests-ci, --tests-local or --tests-junit`);
   }
-  const t = templateBlock({ cwd, base: flag("base"), tests });
-  io.out(renderBlock(t.block));
-  for (const note of t.notes) io.err(`dunstan: ${note}
+  const run = await runTemplate(
+    { cwd: io.cwd ?? process.cwd(), base: flag("base"), tests },
+    { env: io.env, fetch: io.fetch, warn: (message) => io.err(`dunstan: ${message}
+`) }
+  );
+  io.out(run.fence);
+  for (const note of run.notes) io.err(`dunstan: ${note}
 `);
-  return tests?.kind === "ci" && tests.read.status === "unsettled" ? EXIT.unverifiable : 0;
+  return run.tests === "not_declared" ? EXIT.unverifiable : 0;
 }
 
 // src/cli/verify.ts
@@ -44583,6 +44734,68 @@ function at(value, pointer, base) {
   }
   return v;
 }
+function abandonedProblems(listing, repeated) {
+  const problems = [];
+  const base = "/selection/listing/abandoned";
+  const { abandoned } = listing;
+  abandoned.forEach((read, r) => {
+    if (read.pages.length > listing.pageBound) {
+      problems.push({
+        member: `${base}/${r}/pages`,
+        message: `${read.pages.length} pages read, past the bound of ${listing.pageBound}`
+      });
+    }
+    read.pages.forEach((page, i) => {
+      const at2 = `${base}/${r}/pages/${i}`;
+      if (page.page !== i + 1) {
+        problems.push({
+          member: `${at2}/page`,
+          message: `recorded ${page.page}; a read runs from page 1 without a gap, so this is page ${i + 1}`
+        });
+      }
+      if (i < read.pages.length - 1) {
+        if (page.duplicates !== 0) {
+          problems.push({
+            member: `${at2}/duplicates`,
+            message: `recorded ${page.duplicates}; a read is abandoned at its first page that repeats an earlier item, so no page before its last repeats one`
+          });
+        }
+        if (page.error !== void 0) {
+          problems.push({
+            member: `${at2}/error`,
+            message: `recorded ${text(page.error)}; a page that could not be read ends its read, so only a last page has an error`
+          });
+        }
+      } else if (page.duplicates === 0 || page.duplicates > page.items) {
+        problems.push({
+          member: `${at2}/duplicates`,
+          message: page.duplicates === 0 ? "recorded 0; an abandoned read ends at a page that repeats an earlier item" : `recorded ${page.duplicates}, more than the page's ${page.items} items`
+        });
+      }
+    });
+  });
+  if (repeated > 0 && abandoned.length !== LISTING_READS - 1) {
+    problems.push({
+      member: base,
+      message: `${abandoned.length} reads abandoned, but the read used repeated ${repeated} items: a read that repeats is abandoned unless it is the last of ${LISTING_READS} reads, so ${LISTING_READS - 1} reads were abandoned before it`
+    });
+  }
+  const reads = [...abandoned.map((read) => read.pages), listing.pages];
+  reads.slice(1).forEach((later2, r) => {
+    const first = later2[0];
+    if (first === void 0) return;
+    const next = Date.parse(first.readAt);
+    (reads[r] ?? []).forEach((page, i) => {
+      if (Date.parse(page.readAt) > next) {
+        problems.push({
+          member: `${base}/${r}/pages/${i}/readAt`,
+          message: `recorded ${text(page.readAt)}, after the next read's first page (${text(first.readAt)})`
+        });
+      }
+    });
+  });
+  return problems;
+}
 function verifySurveyRecord(value) {
   const schemaErrors = validateSurveyRecord(value);
   if (schemaErrors.length > 0) {
@@ -44672,6 +44885,7 @@ function verifySurveyRecord(value) {
       message: `${listing.pages.length} pages read, past the bound of ${listing.pageBound}`
     });
   }
+  problems.push(...abandonedProblems(listing, repeated));
   const selected = selectPullRequests(parameters, listing.pullRequests);
   differ("/selection/selected", selection.selected, selected);
   differ(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dunstan",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "mcpName": "io.github.BargLabs/dunstan",
   "description": "Holds a coding agent's completion report to the record: deterministic checks of a declared handback block against the repository's own metadata.",
   "license": "AGPL-3.0-only",