@pmelab/gtd 10.9.0 → 10.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmelab/gtd",
-  "version": "10.9.0",
+  "version": "10.11.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {
@@ -51,7 +51,8 @@
     "storybook": "storybook dev --host 0.0.0.0",
     "coverage": "vitest run --project unit --coverage",
     "eval": ": \"${GTD_EVALS_URL:?GTD_EVALS_URL is required — the OpenAI-compatible gateway every graded turn and the judge run through}\" && : \"${GTD_EVALS_KEY:?GTD_EVALS_KEY is required — the gateway bearer key}\" && npx turbo run build && node evals/eval.mjs",
-    "eval:baseline": "node evals/compare-baseline.mjs --record"
+    "eval:baseline": "node evals/compare-baseline.mjs --record",
+    "eval:judgments": ": \"${GTD_EVALS_URL:?GTD_EVALS_URL is required — the judge model gateway}\" && : \"${GTD_EVALS_KEY:?GTD_EVALS_KEY is required — the gateway bearer key}\" && node evals/judgments/eval.mjs"
   },
   "lint-staged": {
     "*": "oxfmt --no-error-on-unmatched-pattern --write"

package/schema.json

@@ -173,6 +173,47 @@
                             }
                           }
                         },
+                        "judge": {
+                          "type": "string",
+                          "description": "Eta template rendered ALONGSIDE this state's message: (content kind stays message — no sixth content kind). Must render to the JSON document { state, questions: [{ id, primitive, instructions, criteria }] }: `state` is evidence the template gathers only through it.read(...)/git helpers a prompt template already uses — never an uncommitted, freshly-gathered artifact. `questions` is part of the RENDERED document, not a separate structured YAML field — write it as ordinary JSON text inside this same template (a literal array, or computed however you like); gtd never parses it as YAML. `primitive` is one of noul (yes/no), choice, score. An unaware driver ignores this field and shows message: to a human; an aware driver pipes it to a judge model and answers with `gtd judge answer`. Requires a sibling `message:`."
+                        },
+                        "routes": {
+                          "type": "array",
+                          "description": "Ordered list of judgment routing rows — a probability is not an \"on\" change pattern, so this is its own engine routing language. Each row is { question, is, minP, maxP, to }: question names one of this state's own judge: question ids, is the expected answer, minP the probability floor (>=) and maxP the probability ceiling (<) that answer's own p must clear (both Eta templates, typically a workflow var:; either alone is legal). First declared match wins, exactly like \"on\". The list MUST end with a catch-all row carrying only \"to\" — a list without one is a load error. A conjunction (\"all of N questions answered yes at p >= threshold\") is expressed by inversion: per question, one escape row for the wrong answer plus one for the right answer under maxP=threshold, routing to the conservative target, followed by the catch-all routing to the optimistic one. Requires a sibling `judge:`.",
+                          "items": {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "required": [
+                              "to"
+                            ],
+                            "properties": {
+                              "question": {
+                                "type": "string",
+                                "description": "One of this state's own judge: question ids."
+                              },
+                              "is": {
+                                "type": "string",
+                                "description": "The expected answer for this row to match."
+                              },
+                              "minP": {
+                                "type": "string",
+                                "description": "Probability floor (>=) the answer's own p must clear (an Eta template, typically a workflow var: reference)."
+                              },
+                              "maxP": {
+                                "type": "string",
+                                "description": "Probability ceiling (<) the answer's own p must stay under (an Eta template, typically a workflow var: reference)."
+                              },
+                              "to": {
+                                "type": "string",
+                                "description": "The target state name."
+                              }
+                            }
+                          }
+                        },
+                        "shadow": {
+                          "type": "boolean",
+                          "description": "When true, this state's judge: verdict is recorded (Gtd-Judge: trailer) but never consulted for routing — the state routes exactly as if judge: were absent. A debugging switch a repo turns on to diagnose a live threshold, not a release stage every gate passes through. Requires a sibling `judge:`."
+                        },
                         "label": {
                           "type": "string",
                           "description": "Opaque display name passed through `gtd next --json`/`gtd status --json` so a driver/viewer can show something nicer than the raw state name (e.g. \"Running checks\"). Never interpreted by gtd."
@@ -291,6 +332,10 @@
         "key": {
           "type": "string",
           "description": "Path to a TLS private key file, enabling HTTPS. Requires `cert` too."
+        },
+        "format": {
+          "type": "string",
+          "description": "Shell command run after every UI write, before it resolves (Eta template; it.file is the written file's absolute path). A non-zero exit or missing binary never reverts the write or refuses it — it's reported to the client as a notice naming the command and its exit code. Absent means no command runs at all."
         }
       }
     },