planr 1.9.0 → 1.10.0-alpha.2

package/docs/contracts/fixtures/evidence/v1/negative/timed-out-zero-exit-attempt.json

@@ -0,0 +1,39 @@
+{
+  "id": "eatt-timed-out-zero-exit",
+  "schema_version": "evidence.contract.v1",
+  "criterion_id": "criterion-api-health",
+  "obligation_id": "pob-planr-api-health-v1",
+  "capability_instance_id": "vcinst-planr-http-process-v1",
+  "started_at": "2026-07-28T12:00:05Z",
+  "ended_at": "2026-07-28T12:00:06Z",
+  "status": "timed_out",
+  "resolved_command": {
+    "kind": "command",
+    "command": ["curl", "-fsS", "http://127.0.0.1:4173/health"],
+    "cwd": "$PLANR_REPOSITORY_ROOT"
+  },
+  "exit": {
+    "exit_code": 0,
+    "signal": null,
+    "error": null
+  },
+  "retry_lineage": {
+    "attempt_number": 1,
+    "max_attempts": 1,
+    "previous_attempt_ids": []
+  },
+  "stdout_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "stderr_digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+  "raw_result": {
+    "kind": "artifact",
+    "artifact_id": "artifact-http-response",
+    "digest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+  },
+  "artifacts": [],
+  "output_bounds": {
+    "stdout_bytes": 2,
+    "stderr_bytes": 0,
+    "stdout_truncated": false,
+    "stderr_truncated": false
+  }
+}

package/docs/contracts/fixtures/evidence/v1/negative/unavailable-zero-exit-attempt.json

@@ -0,0 +1,39 @@
+{
+  "id": "eatt-unavailable-zero-exit",
+  "schema_version": "evidence.contract.v1",
+  "criterion_id": "criterion-api-health",
+  "obligation_id": "pob-planr-api-health-v1",
+  "capability_instance_id": "vcinst-planr-http-process-v1",
+  "started_at": "2026-07-28T12:00:05Z",
+  "ended_at": "2026-07-28T12:00:06Z",
+  "status": "unavailable",
+  "resolved_command": {
+    "kind": "command",
+    "command": ["curl", "-fsS", "http://127.0.0.1:4173/health"],
+    "cwd": "$PLANR_REPOSITORY_ROOT"
+  },
+  "exit": {
+    "exit_code": 0,
+    "signal": null,
+    "error": null
+  },
+  "retry_lineage": {
+    "attempt_number": 1,
+    "max_attempts": 1,
+    "previous_attempt_ids": []
+  },
+  "stdout_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "stderr_digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+  "raw_result": {
+    "kind": "artifact",
+    "artifact_id": "artifact-http-response",
+    "digest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+  },
+  "artifacts": [],
+  "output_bounds": {
+    "stdout_bytes": 2,
+    "stderr_bytes": 0,
+    "stdout_truncated": false,
+    "stderr_truncated": false
+  }
+}

package/docs/contracts/fixtures/evidence/v1/negative/unbound-waiver.json

@@ -0,0 +1,21 @@
+{
+  "id": "ewaiver-unbound",
+  "schema_version": "evidence.contract.v1",
+  "scope": {
+    "kind": "item",
+    "id": "item-example"
+  },
+  "observation_ids": [
+    "obs-http-200"
+  ],
+  "reason": "temporary manual exception",
+  "created_by": "user@example.com",
+  "created_at": "2026-07-28T12:00:00Z",
+  "expires_at": "2026-07-29T12:00:00Z",
+  "approval_ref": "approval-123",
+  "audit_trail": [
+    {
+      "event": "created"
+    }
+  ]
+}

package/docs/contracts/fixtures/evidence/v1/negative/unsatisfied-coverage-without-gap.json

@@ -0,0 +1,63 @@
+{
+  "id": "cverdict-unsatisfied-no-gap",
+  "schema_version": "evidence.contract.v1",
+  "scope": {
+    "kind": "criterion",
+    "id": "criterion-api-health"
+  },
+  "evaluated_at": "2026-07-28T12:00:08Z",
+  "status": "unsatisfied",
+  "observation_coverage": [
+    {
+      "requirement_id": "obs-http-200",
+      "status": "covered",
+      "covering_receipt_ids": ["erec-planr-api-health-v1"]
+    }
+  ],
+  "validation_details": {
+    "trust": {
+      "status": "failed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": ["missing_observation"]
+    },
+    "freshness": {
+      "status": "passed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": []
+    },
+    "target": {
+      "status": "passed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": []
+    },
+    "schema": {
+      "status": "passed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": []
+    },
+    "provenance": {
+      "status": "passed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": []
+    },
+    "fixture": {
+      "status": "passed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": []
+    },
+    "completion": {
+      "status": "failed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": ["missing_observation"]
+    }
+  },
+  "suggested_next_action": "run required observation",
+  "actionable_now": true
+}

package/docs/contracts/fixtures/evidence/v1/negative/waived-coverage-forbidden-gap-reason.json

@@ -0,0 +1,28 @@
+{
+  "id": "cverdict-waived-forbidden-gap",
+  "schema_version": "evidence.contract.v1",
+  "scope": {
+    "kind": "criterion",
+    "id": "criterion-api-health"
+  },
+  "evaluated_at": "2026-07-28T12:00:08Z",
+  "status": "waived",
+  "observation_coverage": [
+    {
+      "requirement_id": "obs-http-200",
+      "status": "waived",
+      "gap_reason": "waiver_expired",
+      "waiver_id": "ewaiver-api-health-v1"
+    }
+  ],
+  "validation_details": {
+    "trust": {
+      "status": "failed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": ["waiver_expired"]
+    }
+  },
+  "suggested_next_action": "renew waiver",
+  "actionable_now": true
+}

package/docs/contracts/fixtures/evidence/v1/negative/waived-coverage-missing-waiver-id.json

@@ -0,0 +1,27 @@
+{
+  "id": "cverdict-waived-missing-waiver",
+  "schema_version": "evidence.contract.v1",
+  "scope": {
+    "kind": "criterion",
+    "id": "criterion-api-health"
+  },
+  "evaluated_at": "2026-07-28T12:00:08Z",
+  "status": "waived",
+  "observation_coverage": [
+    {
+      "requirement_id": "obs-http-200",
+      "status": "waived",
+      "gap_reason": "missing_observation"
+    }
+  ],
+  "validation_details": {
+    "trust": {
+      "status": "failed",
+      "checked_at": "2026-07-28T12:00:08Z",
+      "receipt_ids": [],
+      "gap_reasons": ["missing_observation"]
+    }
+  },
+  "suggested_next_action": "record waiver id",
+  "actionable_now": true
+}