@unbrained/pm-cli 2026.10.10 → 2026.10.12

package/docs/agent-task-transcripts.json

@@ -1,478 +1 @@
-{
-  "version": 2,
-  "orientation": {
-    "canonical_task_id": "orientation-context-intent",
-    "required_capabilities": [
-      "workspace_state",
-      "active_ownership",
-      "actionable_work"
-    ],
-    "protocols": [
-      {
-        "task_id": "orientation-context-intent",
-        "capabilities": [
-          "workspace_state",
-          "active_ownership",
-          "actionable_work"
-        ],
-        "capability_evidence": {
-          "workspace_state": [
-            {
-              "step_id": "context",
-              "field_path": "summary.active_items"
-            }
-          ],
-          "active_ownership": [
-            {
-              "step_id": "context",
-              "field_path": "activity"
-            }
-          ],
-          "actionable_work": [
-            {
-              "step_id": "context",
-              "field_path": "hierarchy"
-            }
-          ]
-        }
-      },
-      {
-        "task_id": "orientation-contracts-next",
-        "capabilities": [
-          "workspace_state",
-          "active_ownership",
-          "actionable_work"
-        ],
-        "capability_evidence": {
-          "workspace_state": [
-            {
-              "step_id": "next",
-              "field_path": "summary.in_progress"
-            }
-          ],
-          "active_ownership": [
-            {
-              "step_id": "next",
-              "field_path": "held_by_others"
-            }
-          ],
-          "actionable_work": [
-            {
-              "step_id": "next",
-              "field_path": "recommended.id"
-            }
-          ]
-        }
-      },
-      {
-        "task_id": "orientation-operating-rules",
-        "capabilities": [
-          "workspace_state",
-          "active_ownership",
-          "actionable_work"
-        ],
-        "capability_evidence": {
-          "workspace_state": [
-            {
-              "step_id": "context",
-              "field_path": "summary.active_items"
-            }
-          ],
-          "active_ownership": [
-            {
-              "step_id": "in-progress",
-              "field_path": "items"
-            }
-          ],
-          "actionable_work": [
-            {
-              "step_id": "open",
-              "field_path": "items"
-            }
-          ]
-        }
-      }
-    ]
-  },
-  "tasks": [
-    {
-      "id": "orientation-context-intent",
-      "description": "Build sufficient cold-start workspace, ownership, and actionable-work context with the bounded orientation intent.",
-      "steps": [
-        {
-          "id": "context",
-          "args": ["context", "--for", "orient", "--limit", "10"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["summary.active_items", "hierarchy", "activity"]
-        }
-      ]
-    },
-    {
-      "id": "orientation-contracts-next",
-      "description": "Compare the proposed contracts-summary plus next cold-start protocol on the same fixed workspace.",
-      "steps": [
-        {
-          "id": "contracts",
-          "args": ["contracts", "--summary"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["commands"]
-        },
-        {
-          "id": "next",
-          "args": ["next", "--for", "execute", "--ready-only", "--limit", "3"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": [
-            "summary.in_progress",
-            "held_by_others",
-            "recommended.id"
-          ]
-        }
-      ]
-    },
-    {
-      "id": "orientation-operating-rules",
-      "description": "Compare the historical context, search, open-list, and in-progress-list orientation sequence.",
-      "steps": [
-        {
-          "id": "context",
-          "args": ["context", "--for", "orient", "--limit", "10"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["summary.active_items", "hierarchy", "activity"]
-        },
-        {
-          "id": "search",
-          "args": ["search", "agent task", "--status", "all", "--limit", "10"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["items"]
-        },
-        {
-          "id": "open",
-          "args": ["list", "--status", "open", "--limit", "20"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["items"]
-        },
-        {
-          "id": "in-progress",
-          "args": ["list", "--status", "in_progress", "--limit", "20"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["items"]
-        }
-      ]
-    },
-    {
-      "id": "context-bootstrap",
-      "description": "Orient in a scaled workspace and inspect the canonical focus item.",
-      "steps": [
-        {
-          "id": "triage",
-          "args": ["list", "--for", "triage", "--limit", "2"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["items"]
-        },
-        {
-          "id": "orient",
-          "args": ["context", "--for", "orient", "--limit", "5"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["summary.active_items", "hierarchy", "activity"]
-        },
-        {
-          "id": "inspect",
-          "args": ["get", "$ANCHOR_ID", "--for", "inspect"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "entity",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["item.id"]
-        }
-      ]
-    },
-    {
-      "id": "closed-domain-recovery",
-      "description": "Reject an invalid context intent and execute the advertised shell-free retry.",
-      "steps": [
-        {
-          "id": "refuse-intent",
-          "args": ["get", "$ANCHOR_ID", "--for", "invalid-agent-intent"],
-          "expected_exit_code": 2,
-          "expected_output_kind": "refusal",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["code", "refusal", "recovery"],
-          "expected_error_code": "unknown_context_intent",
-          "expected_field_values": {
-            "recovery.recovery_mode": "compact"
-          },
-          "expected_refusal_surface": "--for"
-        },
-        {
-          "id": "retry-intent",
-          "args": ["get", "$ANCHOR_ID", "--for", "inspect"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "entity",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["item.id"],
-          "recovery_for": "refuse-intent"
-        }
-      ]
-    },
-    {
-      "id": "unknown-option-recovery",
-      "description": "Identify an unsupported option after valid flags and continue with the corrected command.",
-      "steps": [
-        {
-          "id": "refuse-option",
-          "args": [
-            "search",
-            "agent task",
-            "--status",
-            "open",
-            "--limit",
-            "5",
-            "--include-body"
-          ],
-          "expected_exit_code": 2,
-          "expected_output_kind": "refusal",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["code", "refusal", "recovery"],
-          "expected_error_code": "unknown_option",
-          "expected_refusal_surface": "--include-body"
-        },
-        {
-          "id": "retry-option",
-          "args": ["search", "agent task", "--status", "open", "--limit", "5"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["items"],
-          "recovery_for": "refuse-option"
-        }
-      ]
-    },
-    {
-      "id": "lifecycle-mutation",
-      "description": "Create, inspect, close, and confirm a project item through public CLI receipts.",
-      "steps": [
-        {
-          "id": "create",
-          "args": [
-            "create",
-            "--id",
-            "$LIFECYCLE_ID",
-            "--title",
-            "Transcript lifecycle item",
-            "--description",
-            "Golden multi-step lifecycle task",
-            "--type",
-            "Task",
-            "--status",
-            "open",
-            "--create-mode",
-            "progressive"
-          ],
-          "expected_exit_code": 0,
-          "expected_output_kind": "mutation_receipt",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["id", "changed_field_count"]
-        },
-        {
-          "id": "inspect-open",
-          "args": ["get", "$LIFECYCLE_ID", "--for", "inspect"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "entity",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["item.id", "item.status"],
-          "expected_field_values": {
-            "item.status": "open"
-          }
-        },
-        {
-          "id": "close",
-          "args": ["close", "$LIFECYCLE_ID", "Golden task completed"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "mutation_receipt",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["id", "status", "close_reason"]
-        },
-        {
-          "id": "inspect-closed",
-          "args": ["get", "$LIFECYCLE_ID", "--for", "inspect"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "entity",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["item.id", "item.status"],
-          "expected_field_values": {
-            "item.status": "closed"
-          }
-        }
-      ]
-    },
-    {
-      "id": "bulk-effect-outcomes",
-      "description": "Preserve successful partial-effect and no-effect outcomes across a bulk lifecycle task.",
-      "steps": [
-        {
-          "id": "create-bulk-target",
-          "args": [
-            "create",
-            "--id",
-            "$BULK_ID",
-            "--title",
-            "Transcript bulk effect target",
-            "--description",
-            "Golden bulk outcome transcript target",
-            "--type",
-            "Task",
-            "--status",
-            "open",
-            "--create-mode",
-            "progressive"
-          ],
-          "expected_exit_code": 0,
-          "expected_output_kind": "mutation_receipt",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["id", "status", "changed_field_count"]
-        },
-        {
-          "id": "partial-effect",
-          "args": [
-            "close-many",
-            "--ids",
-            "$BULK_ID,pm-transcript-missing",
-            "--reason",
-            "Golden partial-effect transcript",
-            "--validate-close",
-            "off",
-            "--no-checkpoint"
-          ],
-          "expected_exit_code": 7,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["rows", "outcome", "exit_code"],
-          "expected_field_values": {
-            "outcome": "partial_effect"
-          }
-        },
-        {
-          "id": "no-effect",
-          "args": [
-            "close-many",
-            "--ids",
-            "$BULK_ID",
-            "--reason",
-            "Golden no-effect transcript",
-            "--validate-close",
-            "off",
-            "--no-checkpoint"
-          ],
-          "expected_exit_code": 6,
-          "expected_output_kind": "collection",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["rows", "outcome", "exit_code"],
-          "expected_field_values": {
-            "outcome": "no_effect"
-          }
-        }
-      ]
-    },
-    {
-      "id": "plan-execution-mutations",
-      "description": "Create a Plan, add and complete a step, then inspect its durable evidence without echoing the full Plan on each mutation.",
-      "steps": [
-        {
-          "id": "create-plan",
-          "args": [
-            "create",
-            "--id",
-            "pm-transcript-plan",
-            "--type",
-            "Plan",
-            "--title",
-            "Transcript execution Plan",
-            "--create-mode",
-            "progressive"
-          ],
-          "expected_exit_code": 0,
-          "expected_output_kind": "mutation_receipt",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["id", "status"]
-        },
-        {
-          "id": "add-step",
-          "args": [
-            "plan",
-            "add-step",
-            "pm-transcript-plan",
-            "--step-title",
-            "Verify result",
-            "--step-body",
-            "Durable execution context retained for later inspection."
-          ],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": [
-            "id",
-            "step.id",
-            "steps_summary.total",
-            "inspection_command"
-          ],
-          "expected_field_values": {
-            "kind": "plan_mutation",
-            "steps_summary.total": 1
-          }
-        },
-        {
-          "id": "complete-step",
-          "args": [
-            "plan",
-            "complete-step",
-            "pm-transcript-plan",
-            "plan-step-001",
-            "--step-evidence",
-            "Verified result"
-          ],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": [
-            "id",
-            "step.status",
-            "steps_summary.completed",
-            "omission_receipt"
-          ],
-          "expected_field_values": {
-            "step.status": "completed",
-            "steps_summary.completed": 1
-          }
-        },
-        {
-          "id": "inspect-plan",
-          "args": ["plan", "show", "pm-transcript-plan", "--depth", "deep"],
-          "expected_exit_code": 0,
-          "expected_output_kind": "diagnostic",
-          "expected_accounting_mode": "self_reported",
-          "required_fields": ["plan.steps", "plan.steps_summary.completed"],
-          "expected_field_values": {
-            "plan.steps_summary.completed": 1
-          }
-        }
-      ]
-    }
-  ]
-}
+{"version":2,"orientation":{"canonical_task_id":"orientation-context-intent","required_capabilities":["workspace_state","active_ownership","actionable_work"],"protocols":[{"task_id":"orientation-context-intent","capabilities":["workspace_state","active_ownership","actionable_work"],"capability_evidence":{"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}],"active_ownership":[{"step_id":"context","field_path":"activity"}],"actionable_work":[{"step_id":"context","field_path":"hierarchy"}]}},{"task_id":"orientation-contracts-next","capabilities":["workspace_state","active_ownership","actionable_work"],"capability_evidence":{"workspace_state":[{"step_id":"next","field_path":"summary.in_progress"}],"active_ownership":[{"step_id":"next","field_path":"held_by_others"}],"actionable_work":[{"step_id":"next","field_path":"recommended.id"}]}},{"task_id":"orientation-operating-rules","capabilities":["workspace_state","active_ownership","actionable_work"],"capability_evidence":{"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}],"active_ownership":[{"step_id":"in-progress","field_path":"items"}],"actionable_work":[{"step_id":"open","field_path":"items"}]}}]},"tasks":[{"id":"orientation-context-intent","description":"Build sufficient cold-start workspace, ownership, and actionable-work context with the bounded orientation intent.","steps":[{"id":"context","args":["context","--for","orient","--limit","10"],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["summary.active_items","hierarchy","activity"]}]},{"id":"orientation-contracts-next","description":"Compare the proposed contracts-summary plus next cold-start protocol on the same fixed workspace.","steps":[{"id":"contracts","args":["contracts","--summary"],"expected_exit_code":0,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["commands"]},{"id":"next","args":["next","--for","execute","--ready-only","--limit","3"],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["summary.in_progress","held_by_others","recommended.id"]}]},{"id":"orientation-operating-rules","description":"Compare the historical context, search, open-list, and in-progress-list orientation sequence.","steps":[{"id":"context","args":["context","--for","orient","--limit","10"],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["summary.active_items","hierarchy","activity"]},{"id":"search","args":["search","agent task","--status","all","--limit","10"],"expected_exit_code":0,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["items"]},{"id":"open","args":["list","--status","open","--limit","20"],"expected_exit_code":0,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["items"]},{"id":"in-progress","args":["list","--status","in_progress","--limit","20"],"expected_exit_code":0,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["items"]}]},{"id":"context-bootstrap","description":"Orient in a scaled workspace and inspect the canonical focus item.","steps":[{"id":"triage","args":["list","--for","triage","--limit","2"],"expected_exit_code":0,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["items"]},{"id":"orient","args":["context","--for","orient","--limit","5"],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["summary.active_items","hierarchy","activity"]},{"id":"inspect","args":["get","$ANCHOR_ID","--for","inspect"],"expected_exit_code":0,"expected_output_kind":"entity","expected_accounting_mode":"self_reported","required_fields":["item.id"]}]},{"id":"closed-domain-recovery","description":"Reject an invalid context intent and execute the advertised shell-free retry.","steps":[{"id":"refuse-intent","args":["get","$ANCHOR_ID","--for","invalid-agent-intent"],"expected_exit_code":2,"expected_output_kind":"refusal","expected_accounting_mode":"self_reported","required_fields":["code","refusal","recovery"],"expected_error_code":"unknown_context_intent","expected_field_values":{"recovery.recovery_mode":"compact"},"expected_refusal_surface":"--for"},{"id":"retry-intent","args":["get","$ANCHOR_ID","--for","inspect"],"expected_exit_code":0,"expected_output_kind":"entity","expected_accounting_mode":"self_reported","required_fields":["item.id"],"recovery_for":"refuse-intent"}]},{"id":"unknown-option-recovery","description":"Identify an unsupported option after valid flags and continue with the corrected command.","steps":[{"id":"refuse-option","args":["search","agent task","--status","open","--limit","5","--include-body"],"expected_exit_code":2,"expected_output_kind":"refusal","expected_accounting_mode":"self_reported","required_fields":["code","refusal","recovery"],"expected_error_code":"unknown_option","expected_refusal_surface":"--include-body"},{"id":"retry-option","args":["search","agent task","--status","open","--limit","5"],"expected_exit_code":0,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["items"],"recovery_for":"refuse-option"}]},{"id":"lifecycle-mutation","description":"Create, inspect, close, and confirm a project item through public CLI receipts.","steps":[{"id":"create","args":["create","--id","$LIFECYCLE_ID","--title","Transcript lifecycle item","--description","Golden multi-step lifecycle task","--type","Task","--status","open","--create-mode","progressive"],"expected_exit_code":0,"expected_output_kind":"mutation_receipt","expected_accounting_mode":"self_reported","required_fields":["id","changed_field_count"]},{"id":"inspect-open","args":["get","$LIFECYCLE_ID","--for","inspect"],"expected_exit_code":0,"expected_output_kind":"entity","expected_accounting_mode":"self_reported","required_fields":["item.id","item.status"],"expected_field_values":{"item.status":"open"}},{"id":"close","args":["close","$LIFECYCLE_ID","Golden task completed"],"expected_exit_code":0,"expected_output_kind":"mutation_receipt","expected_accounting_mode":"self_reported","required_fields":["id","status","close_reason"]},{"id":"inspect-closed","args":["get","$LIFECYCLE_ID","--for","inspect"],"expected_exit_code":0,"expected_output_kind":"entity","expected_accounting_mode":"self_reported","required_fields":["item.id","item.status"],"expected_field_values":{"item.status":"closed"}}]},{"id":"bulk-effect-outcomes","description":"Preserve successful partial-effect and no-effect outcomes across a bulk lifecycle task.","steps":[{"id":"create-bulk-target","args":["create","--id","$BULK_ID","--title","Transcript bulk effect target","--description","Golden bulk outcome transcript target","--type","Task","--status","open","--create-mode","progressive"],"expected_exit_code":0,"expected_output_kind":"mutation_receipt","expected_accounting_mode":"self_reported","required_fields":["id","status","changed_field_count"]},{"id":"partial-effect","args":["close-many","--ids","$BULK_ID,pm-transcript-missing","--reason","Golden partial-effect transcript","--validate-close","off","--no-checkpoint"],"expected_exit_code":7,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["rows","outcome","exit_code"],"expected_field_values":{"outcome":"partial_effect"}},{"id":"no-effect","args":["close-many","--ids","$BULK_ID","--reason","Golden no-effect transcript","--validate-close","off","--no-checkpoint"],"expected_exit_code":6,"expected_output_kind":"collection","expected_accounting_mode":"self_reported","required_fields":["rows","outcome","exit_code"],"expected_field_values":{"outcome":"no_effect"}}]},{"id":"plan-execution-mutations","description":"Create a Plan, add and complete a step, then inspect its durable evidence without echoing the full Plan on each mutation.","steps":[{"id":"create-plan","args":["create","--id","pm-transcript-plan","--type","Plan","--title","Transcript execution Plan","--create-mode","progressive"],"expected_exit_code":0,"expected_output_kind":"mutation_receipt","expected_accounting_mode":"self_reported","required_fields":["id","status"]},{"id":"add-step","args":["plan","add-step","pm-transcript-plan","--step-title","Verify result","--step-body","Durable execution context retained for later inspection."],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["id","step.id","steps_summary.total","inspection_command"],"expected_field_values":{"kind":"plan_mutation","steps_summary.total":1}},{"id":"complete-step","args":["plan","complete-step","pm-transcript-plan","plan-step-001","--step-evidence","Verified result"],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["id","step.status","steps_summary.completed","omission_receipt"],"expected_field_values":{"step.status":"completed","steps_summary.completed":1}},{"id":"inspect-plan","args":["plan","show","pm-transcript-plan","--depth","deep"],"expected_exit_code":0,"expected_output_kind":"diagnostic","expected_accounting_mode":"self_reported","required_fields":["plan.steps","plan.steps_summary.completed"],"expected_field_values":{"plan.steps_summary.completed":1}}]}]}