{
  "schemaVersion": 1,
  "lastUpdated": "2026-06-14",
  "title": "Bible Everyday Life Methodology, Sources and Uncertainty Guide",
  "status": "phase1_methodology_guide",
  "purpose": "Explains how the Bible Everyday Life Companion should handle approximate biblical units, manual current values, calculators, verse indexes, translation issues, and uncertainty labels.",
  "currentDataState": {
    "itemRecords": 131,
    "recordsWithConversionData": 28,
    "candidateVerseLinks": 264,
    "uniqueCandidateVerseReferences": 238,
    "certaintyCounts": {
      "debated": 2,
      "low": 1,
      "medium": 25,
      "starter": 95,
      "unspecified": 8
    },
    "reviewStatusCounts": {
      "starter": 123,
      "unspecified": 8
    },
    "categoryCounts": {
      "Depth": 1,
      "Distance": 2,
      "Dry measure": 6,
      "Hour": 4,
      "Length": 5,
      "Liquid measure": 4,
      "Money": 4,
      "Uncategorised": 95,
      "Watch": 3,
      "Watch/time marker": 1,
      "Weight": 6
    }
  },
  "uncertaintyLevels": [
    {
      "id": "high",
      "label": "High",
      "meaning": "The unit or object is comparatively clear in ordinary usage, though ancient values are still approximate."
    },
    {
      "id": "medium",
      "label": "Medium",
      "meaning": "The item is identifiable, but the modern equivalent or exact value depends on period, context, or scholarly reconstruction."
    },
    {
      "id": "low",
      "label": "Low",
      "meaning": "The item or value is uncertain enough that the page should avoid confident numerical claims."
    },
    {
      "id": "debated",
      "label": "Debated",
      "meaning": "Scholarly reconstructions or translation traditions differ in ways that materially affect interpretation."
    },
    {
      "id": "starter",
      "label": "Starter",
      "meaning": "The record is a first-build entry pending full lexical, textual, and occurrence audit."
    }
  ],
  "calculationProtocols": [
    {
      "id": "physical-conversion",
      "name": "Physical conversion",
      "rule": "Convert only when the item has a stored conversion factor, and display the result as approximate."
    },
    {
      "id": "metal-value",
      "name": "Metal value estimate",
      "rule": "Use manual metal prices from current-values.json. Do not present metal value as exact ancient purchasing power."
    },
    {
      "id": "wage-comparison",
      "name": "Wage comparison",
      "rule": "Use manually maintained modern daily-wage values. Label this as a comparison, not as a historical economic equivalence."
    },
    {
      "id": "volume-to-weight",
      "name": "Volume-to-weight estimate",
      "rule": "Dry and liquid measures are volume measures. Convert to kg/lb only after selecting a material density."
    },
    {
      "id": "time-watch",
      "name": "Time and watches",
      "rule": "Treat hours and watches as approximate time ranges tied to sunrise/sunset and ancient reckoning, not as minute-exact clock times."
    }
  ],
  "maintenanceProtocols": [
    "Update current-values.json manually when FX rates, metal prices, or daily-wage estimates are refreshed.",
    "Leave zero values in current-values.json only when a value has not yet been entered.",
    "Do not expose API keys or add live exchange-rate dependencies unless the project policy changes.",
    "Keep verse lists marked starter/candidate until a full original-language occurrence audit is completed.",
    "When adding a new item page, update its item JSON, page sidecar, manifest, sitemap, site search index, A-Z index, and verse/book/theme/original-language indexes if applicable."
  ],
  "translationCautions": [
    {
      "topic": "Old English money words",
      "note": "Terms such as penny, farthing, and mite can mislead modern readers if interpreted by present-day coin values."
    },
    {
      "topic": "Generic English measure words",
      "note": "English “measure” may translate a specific Hebrew or Greek unit in one passage and a general quantity in another."
    },
    {
      "topic": "Coin versus weight",
      "note": "In the OT, silver and gold are often weighed rather than minted as coins. Do not assume all monetary language refers to coinage."
    },
    {
      "topic": "Symbolic usage",
      "note": "Some items, such as cup, scales, sword, lamp, or plumb line, may be literal in one passage and symbolic or prophetic in another."
    }
  ],
  "doNotClaim": [
    "Do not claim exact modern values for ancient biblical currency.",
    "Do not treat calculator output as precise ancient purchasing power.",
    "Do not treat starter/candidate verse indexes as exhaustive.",
    "Do not merge symbolic and literal usage without clearly marking the distinction.",
    "Do not overwrite sitewide headers from older pages in this project unless specifically instructed."
  ]
}