@nextcommerce/campaigns-os 1.33.0

package/contracts/fixtures/orientation/canonicalization/v1.json

@@ -0,0 +1,34 @@
+{
+  "fixture_version": "campaigns-os-release-ledger-canonicalization-example/v1",
+  "entry_sha256": {
+    "input_entry": {
+      "sequence": 9001,
+      "id": "RL-9001",
+      "date": "2026-09-02",
+      "kind": "release",
+      "surface_version": null,
+      "changelog_section": "0.0.0+agent.9001",
+      "changelog_sha256": "32370066aa254ac6328875ea43c031773686df7f94702d8ad3e970f655776685",
+      "agent_impact": "A consumer can reproduce ledger digests independently.",
+      "compatibility": "compatible",
+      "migration": "none",
+      "changes": [
+        {
+          "summary": "Publish the digest rule and a self-check vector.",
+          "surface_entry": "docs/orientation-contract-reference.md",
+          "path": "docs/orientation-contract-reference.md",
+          "class": "documentation"
+        }
+      ],
+      "entry_sha256": "55a7a77821ed4ef034683d0c5d36c897ee53e9cc2e1e42021a88e1be5bdfae54"
+    },
+    "canonical_utf8": "{\"agent_impact\":\"A consumer can reproduce ledger digests independently.\",\"changelog_section\":\"0.0.0+agent.9001\",\"changelog_sha256\":\"32370066aa254ac6328875ea43c031773686df7f94702d8ad3e970f655776685\",\"changes\":[{\"class\":\"documentation\",\"path\":\"docs/orientation-contract-reference.md\",\"summary\":\"Publish the digest rule and a self-check vector.\",\"surface_entry\":\"docs/orientation-contract-reference.md\"}],\"compatibility\":\"compatible\",\"date\":\"2026-09-02\",\"id\":\"RL-9001\",\"kind\":\"release\",\"migration\":\"none\",\"sequence\":9001,\"surface_version\":null}",
+    "digest": "55a7a77821ed4ef034683d0c5d36c897ee53e9cc2e1e42021a88e1be5bdfae54"
+  },
+  "changelog_sha256": {
+    "input_utf8": "# Changelog\n\n## [0.0.0+agent.9001] - 2026-09-02\n\n### Added\n\n- Canonicalization example.  \n\n## [1.17.0+agent.1] - 2026-09-02\n\n### Fixed\n\n- Earlier entry.\n",
+    "section_id": "0.0.0+agent.9001",
+    "section_body_utf8": "## [0.0.0+agent.9001] - 2026-09-02\n\n### Added\n\n- Canonicalization example.",
+    "digest": "32370066aa254ac6328875ea43c031773686df7f94702d8ad3e970f655776685"
+  }
+}

package/contracts/fixtures/orientation/envelope/current.json

@@ -0,0 +1,95 @@
+{
+  "schema_version": "campaigns-os-tooling-orientation/v1",
+  "request": {
+    "run_id": "run-example-0001",
+    "checkout_mode": "managed",
+    "mutation_policy": "observe_only",
+    "baseline": {
+      "kind": "supported_surface",
+      "commit": "1111111111111111111111111111111111111111",
+      "surface_version": "1.13.0"
+    },
+    "accepted_orientation_schemas": [
+      "campaigns-os-tooling-orientation/v1"
+    ],
+    "accepted_surface_range": ">=1.13.0 <2.0.0",
+    "manifest_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "repository": {
+    "owner": "NextCommerceCo",
+    "repository": "campaigns-os",
+    "branch": "main",
+    "upstream": "origin/main",
+    "clean": true,
+    "shallow": false,
+    "graph_relation": "identical",
+    "common_git_identity": "managed-store-0001",
+    "worktree_identity": "generation-0001",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_fetched": "1111111111111111111111111111111111111111",
+    "commit_after": "1111111111111111111111111111111111111111"
+  },
+  "freshness": {
+    "state": "current",
+    "observed_at": "2026-08-28T00:00:00Z",
+    "fetch_result": {
+      "attempted": true,
+      "succeeded": true,
+      "duration_ms": 420
+    }
+  },
+  "surface": {
+    "reviewed_version": "1.13.0",
+    "target_version": "1.13.0",
+    "current_version": "1.13.0",
+    "compatibility_result": "compatible",
+    "compatibility_rule": "target surface_version is inside the consumer's accepted_surface_range",
+    "transitions": []
+  },
+  "release_ledger": {
+    "ledger_schema_version": "campaigns-os-release-ledger/v1",
+    "entries": []
+  },
+  "changelog": {
+    "sections": []
+  },
+  "runtime": {
+    "recipe_id": null,
+    "source_fingerprint": "3333333333333333333333333333333333333333333333333333333333333333",
+    "generated_state": "fresh",
+    "emitter_commit": "1111111111111111111111111111111111111111",
+    "refresh_action": "none",
+    "ready": true
+  },
+  "transaction": {
+    "state": "none",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_target": "1111111111111111111111111111111111111111",
+    "commit_observed": "1111111111111111111111111111111111111111",
+    "recovered_interrupted_update": false
+  },
+  "outcome": {
+    "disposition": "current",
+    "reason_code": "already_current",
+    "active_generation_changed": false,
+    "fresh_exec_required": false,
+    "next_actions": [
+      "proceed"
+    ]
+  },
+  "limits": {
+    "limits_version": "1.0.0",
+    "max_source_bytes": 1048576,
+    "max_section_count": 1024,
+    "max_section_bytes": 65536,
+    "max_envelope_bytes": 262144,
+    "max_ledger_entries": 1024,
+    "applied": {
+      "source_bytes": 22024,
+      "section_count": 8,
+      "max_observed_section_bytes": 3903,
+      "envelope_bytes": 4096,
+      "ledger_entries": 1
+    }
+  }
+}

package/contracts/fixtures/orientation/envelope/freshness_unknown.json

@@ -0,0 +1,97 @@
+{
+  "schema_version": "campaigns-os-tooling-orientation/v1",
+  "request": {
+    "run_id": "run-example-0001",
+    "checkout_mode": "managed",
+    "mutation_policy": "observe_only",
+    "baseline": {
+      "kind": "supported_surface",
+      "commit": "1111111111111111111111111111111111111111",
+      "surface_version": "1.13.0"
+    },
+    "accepted_orientation_schemas": [
+      "campaigns-os-tooling-orientation/v1"
+    ],
+    "accepted_surface_range": ">=1.13.0 <2.0.0",
+    "manifest_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "repository": {
+    "owner": "NextCommerceCo",
+    "repository": "campaigns-os",
+    "branch": "main",
+    "upstream": "origin/main",
+    "clean": true,
+    "shallow": false,
+    "graph_relation": "unknown",
+    "common_git_identity": "managed-store-0001",
+    "worktree_identity": "generation-0001",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_fetched": null,
+    "commit_after": "1111111111111111111111111111111111111111"
+  },
+  "freshness": {
+    "state": "unknown",
+    "observed_at": "2026-08-28T00:00:00Z",
+    "fetch_result": {
+      "attempted": true,
+      "succeeded": false,
+      "duration_ms": 30000,
+      "reason_code": "fetch_failed"
+    }
+  },
+  "surface": {
+    "reviewed_version": "1.13.0",
+    "target_version": null,
+    "current_version": "1.13.0",
+    "compatibility_result": "unknown",
+    "compatibility_rule": "no target was observed, so compatibility is not decidable",
+    "transitions": []
+  },
+  "release_ledger": {
+    "ledger_schema_version": "campaigns-os-release-ledger/v1",
+    "entries": []
+  },
+  "changelog": {
+    "sections": []
+  },
+  "runtime": {
+    "recipe_id": null,
+    "source_fingerprint": "3333333333333333333333333333333333333333333333333333333333333333",
+    "generated_state": "fresh",
+    "emitter_commit": "1111111111111111111111111111111111111111",
+    "refresh_action": "none",
+    "ready": true
+  },
+  "transaction": {
+    "state": "none",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_target": "1111111111111111111111111111111111111111",
+    "commit_observed": "1111111111111111111111111111111111111111",
+    "recovered_interrupted_update": false
+  },
+  "outcome": {
+    "disposition": "freshness_unknown",
+    "reason_code": "fetch_failed",
+    "active_generation_changed": false,
+    "fresh_exec_required": false,
+    "next_actions": [
+      "restore network access and rerun"
+    ],
+    "refusal_remedy": "Restore network access and rerun. The prior verified generation is left intact and no launch proceeds under strict-latest policy."
+  },
+  "limits": {
+    "limits_version": "1.0.0",
+    "max_source_bytes": 1048576,
+    "max_section_count": 1024,
+    "max_section_bytes": 65536,
+    "max_envelope_bytes": 262144,
+    "max_ledger_entries": 1024,
+    "applied": {
+      "source_bytes": 22024,
+      "section_count": 8,
+      "max_observed_section_bytes": 3903,
+      "envelope_bytes": 4096,
+      "ledger_entries": 1
+    }
+  }
+}

package/contracts/fixtures/orientation/envelope/legacy_baseline.json

@@ -0,0 +1,95 @@
+{
+  "schema_version": "campaigns-os-tooling-orientation/v1",
+  "request": {
+    "run_id": "run-example-0001",
+    "checkout_mode": "operator_supplied",
+    "mutation_policy": "observe_only",
+    "baseline": {
+      "kind": "legacy_commit",
+      "commit": "1111111111111111111111111111111111111111"
+    },
+    "accepted_orientation_schemas": [
+      "campaigns-os-tooling-orientation/v1"
+    ],
+    "accepted_surface_range": ">=1.13.0 <2.0.0",
+    "manifest_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "repository": {
+    "owner": "NextCommerceCo",
+    "repository": "campaigns-os",
+    "branch": "main",
+    "upstream": "origin/main",
+    "clean": true,
+    "shallow": false,
+    "graph_relation": "identical",
+    "common_git_identity": "managed-store-0001",
+    "worktree_identity": "generation-0001",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_fetched": "1111111111111111111111111111111111111111",
+    "commit_after": "1111111111111111111111111111111111111111"
+  },
+  "freshness": {
+    "state": "current",
+    "observed_at": "2026-08-28T00:00:00Z",
+    "fetch_result": {
+      "attempted": true,
+      "succeeded": true,
+      "duration_ms": 420
+    }
+  },
+  "surface": {
+    "reviewed_version": null,
+    "target_version": null,
+    "current_version": null,
+    "compatibility_result": "unknown",
+    "compatibility_rule": "the reviewed baseline predates supported surfaces; no version is fabricated for it",
+    "transitions": []
+  },
+  "release_ledger": {
+    "ledger_schema_version": "campaigns-os-release-ledger/v1",
+    "entries": []
+  },
+  "changelog": {
+    "sections": []
+  },
+  "runtime": {
+    "recipe_id": null,
+    "source_fingerprint": null,
+    "generated_state": "unknown",
+    "emitter_commit": null,
+    "refresh_action": "none",
+    "ready": false
+  },
+  "transaction": {
+    "state": "none",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_target": "1111111111111111111111111111111111111111",
+    "commit_observed": "1111111111111111111111111111111111111111",
+    "recovered_interrupted_update": false
+  },
+  "outcome": {
+    "disposition": "legacy_baseline",
+    "reason_code": "orientation_rendered",
+    "active_generation_changed": false,
+    "fresh_exec_required": false,
+    "next_actions": [
+      "launch only the already verified operator-supplied checkout",
+      "adopt a supported-surface baseline"
+    ]
+  },
+  "limits": {
+    "limits_version": "1.0.0",
+    "max_source_bytes": 1048576,
+    "max_section_count": 1024,
+    "max_section_bytes": 65536,
+    "max_envelope_bytes": 262144,
+    "max_ledger_entries": 1024,
+    "applied": {
+      "source_bytes": 22024,
+      "section_count": 8,
+      "max_observed_section_bytes": 3903,
+      "envelope_bytes": 4096,
+      "ledger_entries": 1
+    }
+  }
+}

package/contracts/fixtures/orientation/envelope/orientation_available.json

@@ -0,0 +1,136 @@
+{
+  "schema_version": "campaigns-os-tooling-orientation/v1",
+  "request": {
+    "run_id": "run-example-0001",
+    "checkout_mode": "managed",
+    "mutation_policy": "observe_only",
+    "baseline": {
+      "kind": "supported_surface",
+      "commit": "1111111111111111111111111111111111111111",
+      "surface_version": "1.13.0"
+    },
+    "accepted_orientation_schemas": [
+      "campaigns-os-tooling-orientation/v1"
+    ],
+    "accepted_surface_range": ">=1.13.0 <2.0.0",
+    "manifest_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "repository": {
+    "owner": "NextCommerceCo",
+    "repository": "campaigns-os",
+    "branch": "main",
+    "upstream": "origin/main",
+    "clean": true,
+    "shallow": false,
+    "graph_relation": "identical",
+    "common_git_identity": "managed-store-0001",
+    "worktree_identity": "generation-0001",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_fetched": "1111111111111111111111111111111111111111",
+    "commit_after": "1111111111111111111111111111111111111111"
+  },
+  "freshness": {
+    "state": "available",
+    "observed_at": "2026-08-28T00:00:00Z",
+    "fetch_result": {
+      "attempted": true,
+      "succeeded": true,
+      "duration_ms": 610
+    }
+  },
+  "surface": {
+    "reviewed_version": "1.13.0",
+    "target_version": "1.14.0",
+    "current_version": "1.13.0",
+    "compatibility_result": "compatible",
+    "compatibility_rule": "target surface_version is inside the consumer's accepted_surface_range",
+    "transitions": [
+      {
+        "from": "1.13.0",
+        "to": "1.14.0"
+      }
+    ]
+  },
+  "release_ledger": {
+    "ledger_schema_version": "campaigns-os-release-ledger/v1",
+    "entries": [
+      {
+        "id": "RL-0001",
+        "sequence": 1,
+        "date": "2026-08-28",
+        "kind": "release",
+        "surface_version": "1.14.0",
+        "changelog_section": "1.14.0",
+        "changelog_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
+        "agent_impact": "A consumer may now read the orientation contract and release ledger from Git objects.",
+        "compatibility": "additive",
+        "migration": "none",
+        "affected_surface_entries": [
+          "contracts/release-ledger.json"
+        ],
+        "changes": [
+          {
+            "class": "named_surface",
+            "path": "contracts/release-ledger.json",
+            "surface_entry": "contracts/release-ledger.json",
+            "summary": "The append-only agent-relevant release ledger was introduced."
+          }
+        ],
+        "entry_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
+        "introducing_commit": "2222222222222222222222222222222222222222"
+      }
+    ]
+  },
+  "changelog": {
+    "sections": [
+      {
+        "section_id": "1.14.0",
+        "date": "2026-08-28",
+        "agent_impact": "A consumer may now read the orientation contract and release ledger from Git objects.",
+        "migration_action": "none",
+        "body_markdown": "## [1.14.0] - 2026-08-28\n\n### Added\n\n- The orientation contract and the agent-relevant release ledger.",
+        "body_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+      }
+    ]
+  },
+  "runtime": {
+    "recipe_id": null,
+    "source_fingerprint": "3333333333333333333333333333333333333333333333333333333333333333",
+    "generated_state": "fresh",
+    "emitter_commit": "1111111111111111111111111111111111111111",
+    "refresh_action": "none",
+    "ready": true
+  },
+  "transaction": {
+    "state": "none",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_target": "1111111111111111111111111111111111111111",
+    "commit_observed": "1111111111111111111111111111111111111111",
+    "recovered_interrupted_update": false
+  },
+  "outcome": {
+    "disposition": "orientation_available",
+    "reason_code": "orientation_rendered",
+    "active_generation_changed": false,
+    "fresh_exec_required": false,
+    "next_actions": [
+      "review the release ledger",
+      "request a managed update"
+    ]
+  },
+  "limits": {
+    "limits_version": "1.0.0",
+    "max_source_bytes": 1048576,
+    "max_section_count": 1024,
+    "max_section_bytes": 65536,
+    "max_envelope_bytes": 262144,
+    "max_ledger_entries": 1024,
+    "applied": {
+      "source_bytes": 22024,
+      "section_count": 8,
+      "max_observed_section_bytes": 3903,
+      "envelope_bytes": 4096,
+      "ledger_entries": 1
+    }
+  }
+}

package/contracts/fixtures/orientation/envelope/recovered_interrupted_update.json

@@ -0,0 +1,136 @@
+{
+  "schema_version": "campaigns-os-tooling-orientation/v1",
+  "request": {
+    "run_id": "run-example-0001",
+    "checkout_mode": "managed",
+    "mutation_policy": "managed_update",
+    "baseline": {
+      "kind": "supported_surface",
+      "commit": "1111111111111111111111111111111111111111",
+      "surface_version": "1.13.0"
+    },
+    "accepted_orientation_schemas": [
+      "campaigns-os-tooling-orientation/v1"
+    ],
+    "accepted_surface_range": ">=1.13.0 <2.0.0",
+    "manifest_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "repository": {
+    "owner": "NextCommerceCo",
+    "repository": "campaigns-os",
+    "branch": "main",
+    "upstream": "origin/main",
+    "clean": true,
+    "shallow": false,
+    "graph_relation": "identical",
+    "common_git_identity": "managed-store-0001",
+    "worktree_identity": "generation-0001",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_fetched": "2222222222222222222222222222222222222222",
+    "commit_after": "2222222222222222222222222222222222222222"
+  },
+  "freshness": {
+    "state": "updated",
+    "observed_at": "2026-08-28T00:00:00Z",
+    "fetch_result": {
+      "attempted": true,
+      "succeeded": true,
+      "duration_ms": 610
+    }
+  },
+  "surface": {
+    "reviewed_version": "1.13.0",
+    "target_version": "1.14.0",
+    "current_version": "1.13.0",
+    "compatibility_result": "compatible",
+    "compatibility_rule": "target surface_version is inside the consumer's accepted_surface_range",
+    "transitions": [
+      {
+        "from": "1.13.0",
+        "to": "1.14.0"
+      }
+    ]
+  },
+  "release_ledger": {
+    "ledger_schema_version": "campaigns-os-release-ledger/v1",
+    "entries": [
+      {
+        "id": "RL-0001",
+        "sequence": 1,
+        "date": "2026-08-28",
+        "kind": "release",
+        "surface_version": "1.14.0",
+        "changelog_section": "1.14.0",
+        "changelog_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
+        "agent_impact": "A consumer may now read the orientation contract and release ledger from Git objects.",
+        "compatibility": "additive",
+        "migration": "none",
+        "affected_surface_entries": [
+          "contracts/release-ledger.json"
+        ],
+        "changes": [
+          {
+            "class": "named_surface",
+            "path": "contracts/release-ledger.json",
+            "surface_entry": "contracts/release-ledger.json",
+            "summary": "The append-only agent-relevant release ledger was introduced."
+          }
+        ],
+        "entry_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
+        "introducing_commit": "2222222222222222222222222222222222222222"
+      }
+    ]
+  },
+  "changelog": {
+    "sections": [
+      {
+        "section_id": "1.14.0",
+        "date": "2026-08-28",
+        "agent_impact": "A consumer may now read the orientation contract and release ledger from Git objects.",
+        "migration_action": "none",
+        "body_markdown": "## [1.14.0] - 2026-08-28\n\n### Added\n\n- The orientation contract and the agent-relevant release ledger.",
+        "body_sha256": "3333333333333333333333333333333333333333333333333333333333333333"
+      }
+    ]
+  },
+  "runtime": {
+    "recipe_id": null,
+    "source_fingerprint": "3333333333333333333333333333333333333333333333333333333333333333",
+    "generated_state": "fresh",
+    "emitter_commit": "1111111111111111111111111111111111111111",
+    "refresh_action": "none",
+    "ready": true
+  },
+  "transaction": {
+    "state": "reconciled",
+    "commit_before": "1111111111111111111111111111111111111111",
+    "commit_target": "2222222222222222222222222222222222222222",
+    "commit_observed": "2222222222222222222222222222222222222222",
+    "recovered_interrupted_update": true,
+    "reason_code": "transaction_reconciled"
+  },
+  "outcome": {
+    "disposition": "recovered_interrupted_update",
+    "reason_code": "transaction_reconciled",
+    "active_generation_changed": true,
+    "fresh_exec_required": true,
+    "next_actions": [
+      "start a fresh session against the reconciled generation"
+    ]
+  },
+  "limits": {
+    "limits_version": "1.0.0",
+    "max_source_bytes": 1048576,
+    "max_section_count": 1024,
+    "max_section_bytes": 65536,
+    "max_envelope_bytes": 262144,
+    "max_ledger_entries": 1024,
+    "applied": {
+      "source_bytes": 22024,
+      "section_count": 8,
+      "max_observed_section_bytes": 3903,
+      "envelope_bytes": 4096,
+      "ledger_entries": 1
+    }
+  }
+}