@unbrained/pm-cli 2026.10.10 → 2026.10.12

package/docs/SDK_EVIDENCE_TRACEABILITY.md

@@ -58,6 +58,10 @@ not contain the rationale and graph fields required to support the answer.
 
 ## SDK and MCP
 
+[Linked-test metadata edits](LINKED_TEST_EDITS.md) provide a public SDK operation
+for correcting one test while retaining its position, original provenance and
+immutable history, with matching CLI and MCP action options.
+
 The public SDK exposes both reusable-client and one-shot forms:
 
 ```ts

package/docs/TESTING.md

@@ -506,6 +506,9 @@ the descriptor registry does not yet know about.
 
 ## Linked Tests
 
+For in-place metadata corrections and context admission/refusal semantics, see
+[Linked-test edits](LINKED_TEST_EDITS.md).
+
 Add tests to the item that owns the work:
 
 ```bash
@@ -735,6 +738,16 @@ transient process logs are gone.
 
 ## Linked-Test Assertions
 
+Tracked by [pm-test-measure-prerequisite](../.agents/pm/issues/pm-test-measure-prerequisite.toon):
+`--measure` requires `--run`, as declared by CLI help and machine contracts.
+A measurement-only request refuses before writing item or history data. Its
+tokenized recovery preserves measurement values and run selectors and keeps
+clone-local command trust enforced. Measurement evidence describes execution;
+it cannot be added to an item without running its linked tests.
+
+See [startup runner qualification](performance/runner-qualification.md) for the
+independent control measurements retained by the SDK and CLI performance gates.
+
 Linked tests can include assertion metadata:
 
 ```bash

package/docs/agent-task-token-baseline.json

@@ -1,292 +1 @@
-{
-  "version": 5,
-  "transcript_version": 2,
-  "transcript_digest": "sha256:6d4041acfaa4075dde1972d6127a74f18916f7661738b4f5d5fd47a61c179a78",
-  "estimator": "ceil(utf8_bytes / 4)",
-  "comparison_scope": "plan_recovery_tracker_root_canonicalized",
-  "measurement_scope": "output_before_token_accounting",
-  "published_with_release": true,
-  "orientation": {
-    "canonical_task_id": "orientation-context-intent",
-    "required_capabilities": [
-      "actionable_work",
-      "active_ownership",
-      "workspace_state"
-    ],
-    "measured_winner_tokens": 1087,
-    "protocols": [
-      {
-        "task_id": "orientation-context-intent",
-        "command_count": 1,
-        "estimated_tokens": 1087,
-        "capabilities": [
-          "actionable_work",
-          "active_ownership",
-          "workspace_state"
-        ],
-        "capability_evidence": {
-          "actionable_work": [
-            {
-              "step_id": "context",
-              "field_path": "hierarchy"
-            }
-          ],
-          "active_ownership": [
-            {
-              "step_id": "context",
-              "field_path": "activity"
-            }
-          ],
-          "workspace_state": [
-            {
-              "step_id": "context",
-              "field_path": "summary.active_items"
-            }
-          ]
-        }
-      },
-      {
-        "task_id": "orientation-operating-rules",
-        "command_count": 4,
-        "estimated_tokens": 2325,
-        "capabilities": [
-          "actionable_work",
-          "active_ownership",
-          "workspace_state"
-        ],
-        "capability_evidence": {
-          "actionable_work": [
-            {
-              "step_id": "open",
-              "field_path": "items"
-            }
-          ],
-          "active_ownership": [
-            {
-              "step_id": "in-progress",
-              "field_path": "items"
-            }
-          ],
-          "workspace_state": [
-            {
-              "step_id": "context",
-              "field_path": "summary.active_items"
-            }
-          ]
-        }
-      },
-      {
-        "task_id": "orientation-contracts-next",
-        "command_count": 2,
-        "estimated_tokens": 5203,
-        "capabilities": [
-          "actionable_work",
-          "active_ownership",
-          "workspace_state"
-        ],
-        "capability_evidence": {
-          "actionable_work": [
-            {
-              "step_id": "next",
-              "field_path": "recommended.id"
-            }
-          ],
-          "active_ownership": [
-            {
-              "step_id": "next",
-              "field_path": "held_by_others"
-            }
-          ],
-          "workspace_state": [
-            {
-              "step_id": "next",
-              "field_path": "summary.in_progress"
-            }
-          ]
-        }
-      }
-    ]
-  },
-  "tasks": [
-    {
-      "id": "orientation-context-intent",
-      "max_estimated_tokens": 1087,
-      "steps": [
-        {
-          "id": "context",
-          "max_estimated_tokens": 1087,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "orientation-contracts-next",
-      "max_estimated_tokens": 5203,
-      "steps": [
-        {
-          "id": "contracts",
-          "max_estimated_tokens": 4481,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "next",
-          "max_estimated_tokens": 722,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "orientation-operating-rules",
-      "max_estimated_tokens": 2325,
-      "steps": [
-        {
-          "id": "context",
-          "max_estimated_tokens": 1087,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "search",
-          "max_estimated_tokens": 164,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "open",
-          "max_estimated_tokens": 878,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "in-progress",
-          "max_estimated_tokens": 196,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "context-bootstrap",
-      "max_estimated_tokens": 2010,
-      "steps": [
-        {
-          "id": "triage",
-          "max_estimated_tokens": 552,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "orient",
-          "max_estimated_tokens": 1087,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "inspect",
-          "max_estimated_tokens": 371,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "closed-domain-recovery",
-      "max_estimated_tokens": 630,
-      "steps": [
-        {
-          "id": "refuse-intent",
-          "max_estimated_tokens": 259,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "retry-intent",
-          "max_estimated_tokens": 371,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "unknown-option-recovery",
-      "max_estimated_tokens": 596,
-      "steps": [
-        {
-          "id": "refuse-option",
-          "max_estimated_tokens": 433,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "retry-option",
-          "max_estimated_tokens": 163,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "lifecycle-mutation",
-      "max_estimated_tokens": 812,
-      "steps": [
-        {
-          "id": "create",
-          "max_estimated_tokens": 20,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "inspect-open",
-          "max_estimated_tokens": 363,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "close",
-          "max_estimated_tokens": 31,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "inspect-closed",
-          "max_estimated_tokens": 398,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "bulk-effect-outcomes",
-      "max_estimated_tokens": 326,
-      "steps": [
-        {
-          "id": "create-bulk-target",
-          "max_estimated_tokens": 20,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "partial-effect",
-          "max_estimated_tokens": 174,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "no-effect",
-          "max_estimated_tokens": 132,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    },
-    {
-      "id": "plan-execution-mutations",
-      "max_estimated_tokens": 806,
-      "steps": [
-        {
-          "id": "create-plan",
-          "max_estimated_tokens": 21,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "add-step",
-          "max_estimated_tokens": 254,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "complete-step",
-          "max_estimated_tokens": 253,
-          "accounting_mode": "self_reported"
-        },
-        {
-          "id": "inspect-plan",
-          "max_estimated_tokens": 278,
-          "accounting_mode": "self_reported"
-        }
-      ]
-    }
-  ],
-  "composite_max_estimated_tokens": 13795
-}
+{"version":5,"transcript_version":2,"transcript_digest":"sha256:6d4041acfaa4075dde1972d6127a74f18916f7661738b4f5d5fd47a61c179a78","estimator":"ceil(utf8_bytes / 4)","comparison_scope":"plan_recovery_tracker_root_canonicalized","measurement_scope":"output_before_token_accounting","published_with_release":true,"orientation":{"canonical_task_id":"orientation-context-intent","required_capabilities":["actionable_work","active_ownership","workspace_state"],"measured_winner_tokens":1087,"protocols":[{"task_id":"orientation-context-intent","command_count":1,"estimated_tokens":1087,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"context","field_path":"hierarchy"}],"active_ownership":[{"step_id":"context","field_path":"activity"}],"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}]}},{"task_id":"orientation-operating-rules","command_count":4,"estimated_tokens":2325,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"open","field_path":"items"}],"active_ownership":[{"step_id":"in-progress","field_path":"items"}],"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}]}},{"task_id":"orientation-contracts-next","command_count":2,"estimated_tokens":5203,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"next","field_path":"recommended.id"}],"active_ownership":[{"step_id":"next","field_path":"held_by_others"}],"workspace_state":[{"step_id":"next","field_path":"summary.in_progress"}]}}]},"tasks":[{"id":"orientation-context-intent","max_estimated_tokens":1087,"steps":[{"id":"context","max_estimated_tokens":1087,"accounting_mode":"self_reported"}]},{"id":"orientation-contracts-next","max_estimated_tokens":5203,"steps":[{"id":"contracts","max_estimated_tokens":4481,"accounting_mode":"self_reported"},{"id":"next","max_estimated_tokens":722,"accounting_mode":"self_reported"}]},{"id":"orientation-operating-rules","max_estimated_tokens":2325,"steps":[{"id":"context","max_estimated_tokens":1087,"accounting_mode":"self_reported"},{"id":"search","max_estimated_tokens":164,"accounting_mode":"self_reported"},{"id":"open","max_estimated_tokens":878,"accounting_mode":"self_reported"},{"id":"in-progress","max_estimated_tokens":196,"accounting_mode":"self_reported"}]},{"id":"context-bootstrap","max_estimated_tokens":2010,"steps":[{"id":"triage","max_estimated_tokens":552,"accounting_mode":"self_reported"},{"id":"orient","max_estimated_tokens":1087,"accounting_mode":"self_reported"},{"id":"inspect","max_estimated_tokens":371,"accounting_mode":"self_reported"}]},{"id":"closed-domain-recovery","max_estimated_tokens":630,"steps":[{"id":"refuse-intent","max_estimated_tokens":259,"accounting_mode":"self_reported"},{"id":"retry-intent","max_estimated_tokens":371,"accounting_mode":"self_reported"}]},{"id":"unknown-option-recovery","max_estimated_tokens":596,"steps":[{"id":"refuse-option","max_estimated_tokens":433,"accounting_mode":"self_reported"},{"id":"retry-option","max_estimated_tokens":163,"accounting_mode":"self_reported"}]},{"id":"lifecycle-mutation","max_estimated_tokens":812,"steps":[{"id":"create","max_estimated_tokens":20,"accounting_mode":"self_reported"},{"id":"inspect-open","max_estimated_tokens":363,"accounting_mode":"self_reported"},{"id":"close","max_estimated_tokens":31,"accounting_mode":"self_reported"},{"id":"inspect-closed","max_estimated_tokens":398,"accounting_mode":"self_reported"}]},{"id":"bulk-effect-outcomes","max_estimated_tokens":326,"steps":[{"id":"create-bulk-target","max_estimated_tokens":20,"accounting_mode":"self_reported"},{"id":"partial-effect","max_estimated_tokens":174,"accounting_mode":"self_reported"},{"id":"no-effect","max_estimated_tokens":132,"accounting_mode":"self_reported"}]},{"id":"plan-execution-mutations","max_estimated_tokens":806,"steps":[{"id":"create-plan","max_estimated_tokens":21,"accounting_mode":"self_reported"},{"id":"add-step","max_estimated_tokens":254,"accounting_mode":"self_reported"},{"id":"complete-step","max_estimated_tokens":253,"accounting_mode":"self_reported"},{"id":"inspect-plan","max_estimated_tokens":278,"accounting_mode":"self_reported"}]}],"composite_max_estimated_tokens":13795}