{
  "code": "PKG-01",
  "slug": "operation-package-format",
  "title": "Operation Package Format",
  "category": "Publication and Interchange",
  "status": "Current",
  "version": "2.0.4-wip",
  "summary": "Bundles a mission brief, authority, roles, evidence, deterministic simulation, debrief contract, conformance, migration metadata, and component checksums into one portable local record.",
  "keywords": [
    "operation package",
    "portable mission",
    "bundle",
    "checksums",
    "interchange",
    "local tools"
  ],
  "mission_phases": [
    "Task",
    "Plan",
    "Collect",
    "Validate",
    "Debrief"
  ],
  "canonical": "https://iarpg.com/standard/operation-package-format",
  "json": "https://iarpg.com/records/operation-package-format.json",
  "requirements": [
    {
      "level": "MUST",
      "text": "Include release metadata, mission brief, authority profile, role profiles, evidence packet, simulation configuration, debrief contract, conformance report, migration metadata, and component checksums."
    },
    {
      "level": "MUST",
      "text": "Preserve unknown extension fields during import, editing, migration, and export."
    },
    {
      "level": "SHOULD",
      "text": "Deep-link each component to applicable standards, mission examples, and canonical reports."
    },
    {
      "level": "MAY",
      "text": "Include local saved-work metadata that is ignored by authoritative game services."
    }
  ],
  "research": [
    {
      "label": "Deterministic contract state machines",
      "href": "/docs/report/systemic-framework-for-trustless-escrow-and-courier-contracts-in-virtual-reality-massively-multiplayer-online-#3-2-the-deterministic-contract-state-machine",
      "note": "Structured state and settlement records support portable operational packages."
    },
    {
      "label": "Ledger and telemetry",
      "href": "/docs/report/monetary-architecture-genesis-allowance-and-economic-stabilization#ledger-schema-and-telemetry",
      "note": "Immutable UTC events and reversals inform component checksums and audit records."
    }
  ],
  "related": [
    "mission-brief-contract",
    "evidence-custody",
    "deterministic-mission-state-machines",
    "debrief-product-contract",
    "release-migration-and-backward-compatibility"
  ],
  "release": "IARPG-OPS-2",
  "revised_utc": "2026-07-20T12:04:07Z",
  "purpose": "Bundles a mission brief, authority, roles, evidence, deterministic simulation, debrief contract, conformance, migration metadata, and component checksums into one portable local record.",
  "rationale": "The operations design system requires portable, inspectable, recoverable records so mission decisions and consequences can be reviewed across tools and release boundaries.",
  "game_interaction": [
    "Review structured record",
    "Load related local tool",
    "Inspect standards and report links",
    "Export normalized JSON",
    "Record UTC result"
  ],
  "inputs": [
    "Mission or package identifier",
    "Applicable authority and roles",
    "Evidence and state records",
    "Release and conformance metadata"
  ],
  "outputs": [
    "Human-readable publication view",
    "Machine-readable JSON",
    "Reason-coded validation findings",
    "Deep links to related standards and reports"
  ],
  "state_transitions": [
    "Input loaded → validated → edited or compared → exported or preserved"
  ],
  "evidence_and_provenance": [
    "Record UTC timestamps, source identifiers, component versions, and reason codes.",
    "Preserve evidence class boundaries and unknown extension data."
  ],
  "ui_requirements": [
    "Provide compact metadata and clear status.",
    "Provide local import and export without server transmission.",
    "Provide structured fallback for visual representations."
  ],
  "accessibility_requirements": [
    "Support keyboard operation and visible focus.",
    "Provide live validation status and print-readable output."
  ],
  "telemetry_events": [
    "Local tool may expose an exportable event record; no user content is transmitted by this publication."
  ],
  "abuse_and_exploit_cases": [
    "Silent field loss",
    "Non-deterministic replay",
    "False conformance claim",
    "Unreviewable transformation"
  ],
  "failure_behavior": "Reject invalid structure with explicit findings, preserve the original input, and never discard unknown fields silently.",
  "recovery_behavior": "Allow the user to repair input, restore a local draft, export preserved unmapped data, or restart from a published fixture.",
  "example_implementation": "The /package interface demonstrates this record using PHP, vanilla JavaScript, local JSON, and browser APIs.",
  "roles": [
    "Operative",
    "Handler",
    "Intelligence Analyst",
    "Technical Operator",
    "Counterintelligence Officer",
    "Liaison Officer",
    "Logistics Specialist",
    "Source Handler"
  ],
  "authority_types": [
    "Civil administration",
    "Military command",
    "Commercial intelligence service",
    "International verification body",
    "Scientific or infrastructure consortium",
    "Independent investigative network"
  ],
  "collection_disciplines": [
    "Human-source",
    "Technical",
    "Open-source",
    "Liaison",
    "Observation"
  ],
  "interaction_types": [
    "Review",
    "Validate",
    "Compare",
    "Export",
    "Handoff"
  ],
  "evidence_requirement": "Component IDs and provenance",
  "conformance_level": "Level D — Simulatable",
  "implementation_maturity": "WIP implemented",
  "related_examples": [
    "port-access-anomaly-investigation",
    "cross-border-ceasefire-verification"
  ],
  "revision_history": [
    {
      "version": "2.0.2-wip",
      "date_utc": "2026-07-19T16:42:07Z",
      "change": "Initial publication for the IARPG-OPS-2 operation-package lifecycle."
    },
    {
      "version": "2.0.3-wip",
      "date_utc": "2026-07-19T18:45:50Z",
      "note": "Reviewed for integrity-aware package verification, merge, multi-role replay, custody comparison, batch review, backup, publication preview, and release-promotion workflows."
    },
    {
      "version": "2.0.4-wip",
      "date_utc": "2026-07-20T12:04:07Z",
      "note": "Reviewed for canonicalization, round-trip portability, recovery, provenance, compatibility, accessibility, hosting evidence, and stable-promotion gates."
    }
  ]
}