# if.api demo — Jira issue resolver (receipt-backed)

**Audience:** external reviewers + operators  
**Reality gate:** demo of a transformation contract, not a deployed Jira integration.

---

## Links (HTML-first)

if.trace receipt:
https://infrafabric.io/static/trace/-_QAJ3ogug9p3XICsgxiaQ

Pack (HTML view):
https://infrafabric.io/static/pack/-_QAJ3ogug9p3XICsgxiaQ

Pack (raw Markdown):
https://infrafabric.io/static/pack/-_QAJ3ogug9p3XICsgxiaQ.md

Source bundle (tgz):
https://infrafabric.io/static/source/29710e2c13d45b1bfd885544122cba6136bf390c537a4a8fa353ffec65cd5170.tgz

---

## What this proves (black/white)

This demo proves:
- a known Jira issue definition can be transformed deterministically into a normalized event envelope
- the output is bound to if.trace receipts (hash checks; signatures only where present and verifiable)

This demo does not prove:
- live Jira API calls, OAuth scopes, or issue updates
- any shipped if.bus runtime or message broker

---

## Demo artifacts

Source bundle sha256 (tgz):

    29710e2c13d45b1bfd885544122cba6136bf390c537a4a8fa353ffec65cd5170

Input JSON sha256:

    bc87a3ae816457113fb25c9e265b0c3b6d00394198531b5070a0c6987bb1f238

Normalized output JSON sha256:

    b037af336d02ab2639b019109287256ab78b0c8c0aa4c67a393e8b86130a3933

---

## How to reproduce (no internal access)

```bash
curl -fsSL -o if-api-jira-demo-source.tgz "https://infrafabric.io/static/source/29710e2c13d45b1bfd885544122cba6136bf390c537a4a8fa353ffec65cd5170.tgz"
sha256sum if-api-jira-demo-source.tgz

tar -xzf if-api-jira-demo-source.tgz
python3 resolve_jira_demo.py jira_input.json > resolved_event.json
sha256sum resolved_event.json
```

Expected `sha256sum` (source bundle):

    29710e2c13d45b1bfd885544122cba6136bf390c537a4a8fa353ffec65cd5170  if-api-jira-demo-source.tgz

Expected `sha256sum` (normalized output):

    b037af336d02ab2639b019109287256ab78b0c8c0aa4c67a393e8b86130a3933  resolved_event.json

---

## Output (normalized event envelope)

```json
{
  "event": "resolve",
  "input_sha256": "bc87a3ae816457113fb25c9e265b0c3b6d00394198531b5070a0c6987bb1f238",
  "integration": "jira.issue",
  "notes": {
    "integrity": "see if.trace receipt for output bytes",
    "live_lookup": false
  },
  "requested_at": "2026-01-07T00:00:00Z",
  "resolved_at": "2026-01-07T00:00:00Z",
  "results": [
    {
      "issue_key": "IF-101",
      "metadata": {
        "assignee": "demo.builder@example.com",
        "priority": "High",
        "status": "Done",
        "summary": "Publish receipt-backed demo pack"
      },
      "resolution_method": "synthetic-map",
      "status": "resolved",
      "target_url": "https://example.atlassian.net/browse/IF-101"
    },
    {
      "issue_key": "IF-204",
      "metadata": {
        "assignee": "demo.builder@example.com",
        "priority": "Medium",
        "status": "In Progress",
        "summary": "Validate audit trail linkages"
      },
      "resolution_method": "synthetic-map",
      "status": "resolved",
      "target_url": "https://example.atlassian.net/browse/IF-204"
    }
  ],
  "schema_version": "demo.v1"
}
```
