planr 1.10.0-alpha.9 → 2.0.0

package/docs/contracts/fixtures/evidence/v1/negative/passed-empty-attempt.json

@@ -1,22 +0,0 @@
-{
-  "id": "eatt-empty-passed",
-  "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": "passed",
-  "resolved_command": {},
-  "exit": {},
-  "retry_lineage": {},
-  "stdout_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-  "stderr_digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
-  "raw_result": {
-    "kind": "artifact",
-    "artifact_id": "artifact-http-response",
-    "digest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
-  },
-  "artifacts": [],
-  "output_bounds": {}
-}

package/docs/contracts/fixtures/evidence/v1/negative/policy-default-preset-unregistered.json

@@ -1,102 +0,0 @@
-{
-  "id": "epolicy-unregistered-default-preset",
-  "schema_version": "evidence.contract.v1",
-  "policy_digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
-  "defaults": {
-    "preset_id": "preset-missing",
-    "binding": true,
-    "assurance_level": "standard"
-  },
-  "named_presets": [
-    {
-      "id": "preset-http-health",
-      "schema_version": "evidence.contract.v1",
-      "namespace": "planr.api",
-      "observations": [
-        {
-          "id": "obs-http-200",
-          "type": "planr.api.http.response",
-          "subject": "GET /health",
-          "expected": {
-            "status": 200
-          },
-          "target": {
-            "kind": "local_service",
-            "uri": "http://127.0.0.1:4173/health"
-          }
-        }
-      ]
-    }
-  ],
-  "observation_schema_registrations": [
-    {
-      "type": "planr.api.http.response",
-      "schema_ref": "planr.api.http.response@v1",
-      "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
-      "owning_namespace": "planr.api"
-    }
-  ],
-  "adapter_registrations": [
-    {
-      "manifest_id": "vcap-planr-http-process-v1",
-      "manifest_path": "docs/contracts/fixtures/evidence/v1/examples/verification-capability-manifest.json",
-      "manifest_digest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
-      "observation_types": ["planr.api.http.response"],
-      "payload_schemas": [
-        {
-          "type": "planr.api.http.response",
-          "schema_ref": "planr.api.http.response@v1",
-          "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
-        }
-      ],
-      "provenance_path": "planr_observed_execution",
-      "execution_contract": {
-        "kind": "process",
-        "executable": "curl",
-        "args": ["--fail", "--silent", "http://127.0.0.1:4173/health"],
-        "working_directory": ".",
-        "timeout_ms": 10000,
-        "stdout_limit_bytes": 1048576,
-        "stderr_limit_bytes": 1048576,
-        "payload_schema": {
-          "type": "planr.api.http.response",
-          "schema_ref": "planr.api.http.response@v1",
-          "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
-        }
-      }
-    }
-  ],
-  "extension_namespaces": ["planr.api"],
-  "trust_policy": {
-    "accepted_provenance": ["planr_observed_execution"],
-    "min_receipt_status": "trusted",
-    "allow_user_attestation": false
-  },
-  "freshness_policy": {
-    "max_age_seconds": 3600,
-    "invalidate_on": ["source_change"]
-  },
-  "fixture_policy": {
-    "fixtures_allowed": false,
-    "mocks_allowed": false,
-    "disclosure_required": true
-  },
-  "completion_policy": {
-    "require_satisfied_or_waived": true,
-    "allow_inconclusive_completion": false,
-    "require_review_evidence": true
-  },
-  "layering_policy": {
-    "mode": "monotonic_strengthening",
-    "weakening_requires_waiver": true,
-    "layers": [
-      {
-        "scope": {
-          "kind": "plan",
-          "id": "pln-example"
-        },
-        "policy_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
-      }
-    ]
-  }
-}

package/docs/contracts/fixtures/evidence/v1/negative/policy-weakening-without-waiver.json

@@ -1,102 +0,0 @@
-{
-  "id": "epolicy-weakening",
-  "schema_version": "evidence.contract.v1",
-  "policy_digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
-  "defaults": {
-    "preset_id": "preset-http-health",
-    "binding": true,
-    "assurance_level": "standard"
-  },
-  "named_presets": [
-    {
-      "id": "preset-http-health",
-      "schema_version": "evidence.contract.v1",
-      "namespace": "planr.api",
-      "observations": [
-        {
-          "id": "obs-http-200",
-          "type": "planr.api.http.response",
-          "subject": "GET /health",
-          "expected": {
-            "status": 200
-          },
-          "target": {
-            "kind": "local_service",
-            "uri": "http://127.0.0.1:4173/health"
-          }
-        }
-      ]
-    }
-  ],
-  "observation_schema_registrations": [
-    {
-      "type": "planr.api.http.response",
-      "schema_ref": "planr.api.http.response@v1",
-      "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
-      "owning_namespace": "planr.api"
-    }
-  ],
-  "adapter_registrations": [
-    {
-      "manifest_id": "vcap-planr-http-process-v1",
-      "manifest_path": "docs/contracts/fixtures/evidence/v1/examples/verification-capability-manifest.json",
-      "manifest_digest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
-      "observation_types": ["planr.api.http.response"],
-      "payload_schemas": [
-        {
-          "type": "planr.api.http.response",
-          "schema_ref": "planr.api.http.response@v1",
-          "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
-        }
-      ],
-      "provenance_path": "planr_observed_execution",
-      "execution_contract": {
-        "kind": "process",
-        "executable": "curl",
-        "args": ["--fail", "--silent", "http://127.0.0.1:4173/health"],
-        "working_directory": ".",
-        "timeout_ms": 10000,
-        "stdout_limit_bytes": 1048576,
-        "stderr_limit_bytes": 1048576,
-        "payload_schema": {
-          "type": "planr.api.http.response",
-          "schema_ref": "planr.api.http.response@v1",
-          "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
-        }
-      }
-    }
-  ],
-  "extension_namespaces": ["planr.api"],
-  "trust_policy": {
-    "accepted_provenance": ["planr_observed_execution"],
-    "min_receipt_status": "trusted",
-    "allow_user_attestation": false
-  },
-  "freshness_policy": {
-    "max_age_seconds": 3600,
-    "invalidate_on": ["source_change"]
-  },
-  "fixture_policy": {
-    "fixtures_allowed": false,
-    "mocks_allowed": false,
-    "disclosure_required": true
-  },
-  "completion_policy": {
-    "require_satisfied_or_waived": true,
-    "allow_inconclusive_completion": false,
-    "require_review_evidence": true
-  },
-  "layering_policy": {
-    "mode": "monotonic_strengthening",
-    "weakening_requires_waiver": false,
-    "layers": [
-      {
-        "scope": {
-          "kind": "plan",
-          "id": "pln-example"
-        },
-        "policy_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
-      }
-    ]
-  }
-}

package/docs/contracts/fixtures/evidence/v1/negative/process-probe-missing-output-limits.json

@@ -1,49 +0,0 @@
-{
-  "id": "vcap-process-probe-missing-limits",
-  "schema_version": "evidence.contract.v1",
-  "version": "1.0.0",
-  "adapter_kind": "process",
-  "adapter_digest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
-  "supported_surfaces": ["local-process"],
-  "supported_observations": [
-    {
-      "type": "planr.api.http.response",
-      "schema_ref": "planr.api.http.response@v1",
-      "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
-    }
-  ],
-  "supported_interactions": ["http-get"],
-  "supported_artifacts": ["stdout"],
-  "runtime_targets": [
-    {
-      "kind": "process",
-      "id": "planr-doc-fixture"
-    }
-  ],
-  "provenance_path": "planr_observed_execution",
-  "permissions": {
-    "network": "localhost_only",
-    "filesystem": "read_workspace"
-  },
-  "costs": {
-    "network": "local"
-  },
-  "determinism": "deterministic for static health endpoint",
-  "repeatability": "replayable from source tree and target URI",
-  "independence": "adapter observes process output independently of agent text",
-  "blind_spots": [],
-  "availability_probe": {
-    "kind": "process",
-    "execution": {
-      "kind": "process",
-      "executable": "curl",
-      "args": ["--version"],
-      "timeout_ms": 5000,
-      "payload_schema": {
-        "type": "planr.api.http.response",
-        "schema_ref": "planr.api.http.response@v1",
-        "schema_digest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
-      }
-    }
-  }
-}

package/docs/contracts/fixtures/evidence/v1/negative/satisfied-empty-coverage-verdict.json

@@ -1,14 +0,0 @@
-{
-  "id": "cverdict-empty-satisfied",
-  "schema_version": "evidence.contract.v1",
-  "scope": {
-    "kind": "criterion",
-    "id": "criterion-api-health"
-  },
-  "evaluated_at": "2026-07-28T12:00:08Z",
-  "status": "satisfied",
-  "observation_coverage": [],
-  "validation_details": {},
-  "suggested_next_action": "none",
-  "actionable_now": false
-}

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

@@ -1,39 +0,0 @@
-{
-  "id": "eatt-skipped-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": "skipped",
-  "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/stale-coverage-with-inconclusive-reason.json

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

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

@@ -1,39 +0,0 @@
-{
-  "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

@@ -1,39 +0,0 @@
-{
-  "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

@@ -1,21 +0,0 @@
-{
-  "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

@@ -1,63 +0,0 @@
-{
-  "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

@@ -1,28 +0,0 @@
-{
-  "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

@@ -1,27 +0,0 @@
-{
-  "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
-}