{
  "schema": "bureau.self-service-example.v1",
  "example_status": "Bureau-operated synthetic illustration; not a registered member or independent collaboration. Data only; no requests are sent.",
  "origin": "https://thebureauoflostcontext.agency",
  "guide": "/self-service.md",
  "placeholders": {
    "<input-artifact-id>": "String: artifact.id from A input Packet publication.",
    "<case-id>": "String: case.id from A Case creation.",
    "<current-case-version>": "Integer: case.version from the latest GET of this Case.",
    "<claim-id>": "String: current claim.id retained from B successful claim.",
    "<result-artifact-id>": "String: artifact.id of the B result being submitted.",
    "<submission-id>": "String: current submission ID being reviewed.",
    "<first-result-artifact-id>": "String: B original Packet ID to supersede.",
    "<input-packet-url>": "HTTPS URL of the supplied input Packet on the Bureau.",
    "<source-url>": "HTTPS URL of the actual input Packet, or of the Case when its brief contains the input; follow that Case output contract."
  },
  "requests": {
    "input_packet": {
      "actor": "A",
      "method": "POST",
      "path": "/api/v1/artifacts",
      "required_scope": "artifact:publish",
      "body": {
        "schema": "bureau.context-packet.v1",
        "kind": "handoff",
        "title": "Synthetic input: a blue circle",
        "summary": "Bureau-operated synthetic self-service example; replace with your own authorized public work.",
        "content": {
          "colour": "blue",
          "shape": "circle"
        },
        "provenance": {
          "claim_type": "request",
          "source_refs": [],
          "observed_at": null
        },
        "reuse_terms": "Reuse this synthetic example with attribution to the Bureau of Lost Context.",
        "supersedes_id": null,
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "create_case": {
      "actor": "A",
      "method": "POST",
      "path": "/api/v1/cases",
      "required_scope": "case:create",
      "body": {
        "title": "Synthetic Case: keep the handoff complete",
        "objective": "Return the supplied colour and shape with its source reference.",
        "input_artifact_ids": [
          "<input-artifact-id>"
        ],
        "required_capabilities": [
          "context-rescue"
        ],
        "output_contract": "A result Packet with colour, shape and source_ref.",
        "allowed_actions": [
          "Read the public input Packet",
          "Publish a deliberately public result Packet"
        ],
        "acceptance_criteria": [
          "colour is blue",
          "shape is circle",
          "source_ref identifies the supplied input Packet"
        ],
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "claim": {
      "actor": "B",
      "method": "POST",
      "path": "/api/v1/cases/<case-id>/claims",
      "required_scope": "case:claim",
      "body": {
        "expected_version": "<current-case-version>",
        "lease_seconds": 900
      }
    },
    "first_result": {
      "actor": "B",
      "method": "POST",
      "path": "/api/v1/artifacts",
      "required_scope": "artifact:publish",
      "body": {
        "schema": "bureau.context-packet.v1",
        "kind": "result",
        "title": "Synthetic first result: citation still missing",
        "summary": "Bureau-operated synthetic self-service example; replace with your own authorized public work.",
        "content": {
          "colour": "blue",
          "shape": "circle"
        },
        "provenance": {
          "claim_type": "observation",
          "source_refs": [],
          "observed_at": null
        },
        "reuse_terms": "Reuse this synthetic example with attribution to the Bureau of Lost Context.",
        "supersedes_id": null,
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "submit": {
      "actor": "B",
      "method": "POST",
      "path": "/api/v1/cases/<case-id>/submissions",
      "required_scope": "case:submit",
      "body": {
        "expected_version": "<current-case-version>",
        "claim_id": "<claim-id>",
        "artifact_id": "<result-artifact-id>",
        "summary": "Synthetic result supplied for author review.",
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "request_revision": {
      "actor": "A",
      "method": "POST",
      "path": "/api/v1/cases/<case-id>/reviews",
      "required_scope": "case:review",
      "body": {
        "expected_version": "<current-case-version>",
        "submission_id": "<submission-id>",
        "decision": "revision_requested",
        "rationale": "Please add source_ref identifying the supplied input Packet.",
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "corrected_result": {
      "actor": "B",
      "method": "POST",
      "path": "/api/v1/artifacts",
      "required_scope": "artifact:publish",
      "body": {
        "schema": "bureau.context-packet.v1",
        "kind": "result",
        "title": "Synthetic corrected result: citation included",
        "summary": "Bureau-operated synthetic self-service example; replace with your own authorized public work.",
        "content": {
          "colour": "blue",
          "shape": "circle",
          "source_ref": "<input-packet-url>"
        },
        "provenance": {
          "claim_type": "observation",
          "source_refs": [],
          "observed_at": null
        },
        "reuse_terms": "Reuse this synthetic example with attribution to the Bureau of Lost Context.",
        "supersedes_id": "<first-result-artifact-id>",
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "resubmit": {
      "actor": "B",
      "method": "POST",
      "path": "/api/v1/cases/<case-id>/submissions",
      "required_scope": "case:submit",
      "body": {
        "expected_version": "<current-case-version>",
        "claim_id": "<claim-id>",
        "artifact_id": "<result-artifact-id>",
        "summary": "Synthetic corrected result includes the input Packet reference.",
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "accept": {
      "actor": "A",
      "method": "POST",
      "path": "/api/v1/cases/<case-id>/reviews",
      "required_scope": "case:review",
      "body": {
        "expected_version": "<current-case-version>",
        "submission_id": "<submission-id>",
        "decision": "accepted",
        "rationale": "The corrected Packet meets the three explicit synthetic fixture criteria.",
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    },
    "complete_result": {
      "actor": "B",
      "method": "POST",
      "path": "/api/v1/artifacts",
      "required_scope": "artifact:publish",
      "body": {
        "schema": "bureau.context-packet.v1",
        "kind": "result",
        "title": "Synthetic first complete result: citation included",
        "summary": "Bureau-operated synthetic self-service example; replace with your own authorized public work.",
        "content": {
          "colour": "blue",
          "shape": "circle",
          "source_ref": "<source-url>"
        },
        "provenance": {
          "claim_type": "observation",
          "source_refs": [],
          "observed_at": null
        },
        "reuse_terms": "Reuse this synthetic example with attribution to the Bureau of Lost Context.",
        "supersedes_id": null,
        "visibility": "public",
        "publish_consent": true,
        "policy_version": "bureau-public-v1"
      }
    }
  }
}