{
  "format": "contextlib/1",
  "library": {
    "created": "2026-09-01T12:00:00Z",
    "format": "contextlib/1",
    "library_id": "3f1a0c8e-9b24-4d6a-8e71-2c0b5d4a91f0"
  },
  "projects": [
    {
      "brief": "# Lighthouse App\n\n**Purpose:** Harbor dashboard that coordinates lamp status, fog signals, and vessel traffic for a fictional headland light.\n\n**Generated:** 2026-09-26T16:14:46Z\n\n## Current decisions\n\n- **Use keeper logs as the lamp-status source of truth** — Decision: Lamp status on the harbor board is taken from keeper logs, not from AIS.\n\n## Open requirements\n\n- **Fog-signal schedule must work unplugged** — Requirement: The fog-signal schedule can be read and updated with the SSD unplugged and with no network.\n- **Show live lamp character on the harbor board** — Requirement: The harbor board shows the current lamp character (for example Fl W 15s), the time it was signed, and wh...\n\n## Key facts\n\n- Fact: Mean tidal range at the headland is 3.2 metres.\n- Fact: The headland lamp character is Fl W 15s — a white flash every 15 seconds.\n\n## Recent returns\n\n- **Keeper trial 20 Sep 2026** — Return: First keeper trial, 20 September 2026.\n\n## Review due\n\n0 records due on or before 2026-09-26.\nNext review 2026-10-14.\n\n## Glossary (short)\n\n- **character** — The published flash pattern of a light, written in the light-list notation (for example Fl W 15s).\n- **watch** — A four-hour keeper shift. The harbor board groups log lines by watch.\n",
      "meta": {
        "created": "2026-09-01T12:00:00Z",
        "name": "Lighthouse App",
        "owners": [
          "mara"
        ],
        "purpose": "Harbor dashboard that coordinates lamp status, fog signals, and vessel traffic for a fictional headland light.",
        "review_defaults": {
          "brief-note": 30,
          "decision": 180,
          "fact": 30,
          "glossary": 365,
          "lesson": 365,
          "requirement": null,
          "return": null,
          "source": 90
        },
        "slug": "lighthouse-app"
      },
      "records": [
        {
          "body": "**Note:** Week of 21 September — lamp board is live; fog form is the open gap.\n\n**Load in brief:** Harbor masters should see the two current requirements and the keeper-trial return.\n\n**Review:** Revisit after the next fog, or by 2026-10-21.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "a956bf83ef17fa5288ee5d75f5fe1cb2750c7615c6c4951818e9d0bad8b39a0c",
            "created": "2026-09-21T09:30:00Z",
            "evidence": [
              {
                "ref": "project:BRIEF.md"
              },
              {
                "ref": "project:returns/2026-09-20_keeper-trial-20-sep-2026_e5f7.md"
              }
            ],
            "id": "note-20260921-a7b8",
            "project": "lighthouse-app",
            "review_by": "2026-10-21",
            "scope": {
              "lane": "brief",
              "team": "harbor-master"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "brief",
              "weekly"
            ],
            "title": "Week of 21 Sep briefing",
            "type": "brief-note"
          },
          "path": "notes/2026-09-21_week-of-21-sep-briefing_a7b8.md",
          "supersession_chain": [
            "note-20260921-a7b8"
          ]
        },
        {
          "body": "**Return:** First keeper trial, 20 September 2026.\n\n**User outcome:** Two keepers ran a full watch using the local library on an SSD. Lamp status stayed current. Fog events were logged on paper when the hut Wi-Fi dropped.\n\n**Remaining gaps:** Fog form still posted to the WAN first; offline queue was a prototype.\n\n**Next actor:** keepers, to trial the offline form on the next fog.\n",
          "meta": {
            "author": "service:capture",
            "body_sha256": "158a7071f26531af7cede68aff3554820e0e28f164d806352d7ab6f1d9285d25",
            "created": "2026-09-20T22:00:00Z",
            "evidence": [
              {
                "ref": "ssd:exports/keeper-trial.zip"
              },
              {
                "ref": "room:harbor#12"
              },
              {
                "ref": "note:two keepers, one full watch, SSD in the hut"
              }
            ],
            "id": "ret-20260920-e5f7",
            "project": "lighthouse-app",
            "review_by": null,
            "scope": {
              "lane": "trial",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "trial",
              "keepers",
              "ssd"
            ],
            "title": "Keeper trial 20 Sep 2026",
            "type": "return"
          },
          "path": "returns/2026-09-20_keeper-trial-20-sep-2026_e5f7.md",
          "supersession_chain": [
            "ret-20260920-e5f7"
          ]
        },
        {
          "body": "**Lesson:** Fog-log forms that require a network round-trip get skipped. Offline-first forms get filled.\n\n**Context:** During the 20 Sep keeper trial, three fog events were missing from the server log and present in the paper book.\n\n**What to do:** Write records to local files; sync when the link is back. Never block a keeper on HTTP.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "d8ddd1d4d3bc81ffb4d2c01cdc6b277a6f44f4be76e7c6ed3e834451abdc6dbf",
            "created": "2026-09-20T21:10:00Z",
            "evidence": [
              {
                "ref": "project:returns/2026-09-20_keeper-trial-20-sep-2026_e5f7.md"
              },
              {
                "ref": "note:three fog events in the paper book, missing from the WAN log"
              }
            ],
            "id": "les-20260920-56ef",
            "project": "lighthouse-app",
            "review_by": "2027-09-20",
            "scope": {
              "lane": "fog-signal",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "fog",
              "offline",
              "forms"
            ],
            "title": "Offline-first forms beat networked fog logs",
            "type": "lesson"
          },
          "path": "lessons/2026-09-20_offline-first-forms-beat-networked-fog-logs_56ef.md",
          "supersession_chain": [
            "les-20260920-56ef"
          ]
        },
        {
          "body": "**Fact:** Mean tidal range at the headland is 3.2 metres.\n\n**How we know:** Harbour authority tide tables for 2026, station Headland Steps.\n\n**How to verify:** Compare a spring-tide high/low pair against 3.2 m ± 0.2 m.\n",
          "meta": {
            "author": "claude:harbor-trial",
            "body_sha256": "885875ea7956fe4c6712549c39eb73dd9c8dd3dcb7276f180291bd18cabb3b26",
            "created": "2026-09-14T18:20:00Z",
            "evidence": [
              {
                "ref": "note:Harbour authority tide tables 2026, station Headland Steps"
              },
              {
                "ref": "url:https://www.iala.int/"
              }
            ],
            "id": "fact-20260914-34cd",
            "project": "lighthouse-app",
            "review_by": "2026-10-14",
            "scope": {
              "lane": "tides",
              "team": "harbor-master"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "tide",
              "headland"
            ],
            "title": "Mean tidal range at the headland is 3.2 metres",
            "type": "fact"
          },
          "path": "facts/2026-09-14_mean-tidal-range-at-the-headland-is-3-2-metres_34cd.md",
          "supersession_chain": [
            "fact-20260914-34cd"
          ]
        },
        {
          "body": "**Fact:** The headland lamp character is Fl W 15s — a white flash every 15 seconds.\n\n**How we know:** Signed keeper log 2026-09-14 and the published light list.\n\n**How to verify:** A 60-second observation contains four flashes.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "94802d454528eac4765ce48e005f0b0db98544097b703518d126c9e87e1d5ab8",
            "created": "2026-09-14T18:05:00Z",
            "evidence": [
              {
                "ref": "note:signed keeper log 2026-09-14 watch 2"
              },
              {
                "ref": "url:https://www.iala.int/"
              }
            ],
            "id": "fact-20260914-12ab",
            "project": "lighthouse-app",
            "review_by": "2026-10-14",
            "scope": {
              "lane": "harbor-board",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "lamp",
              "character"
            ],
            "title": "Lamp character is Fl W 15s",
            "type": "fact"
          },
          "path": "facts/2026-09-14_lamp-character-is-fl-w-15s_12ab.md",
          "supersession_chain": [
            "fact-20260914-12ab"
          ]
        },
        {
          "body": "**Requirement:** The fog-signal schedule can be read and updated with the SSD unplugged and with no network.\n\n**Why:** Fog does not wait for a WAN. Keepers already work from the hut with a local clone of the library.\n\n**Acceptance:** `ctxlib brief lighthouse-app` and the fog panel both load from local files. An update written offline syncs later with `ctxlib sync`.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "07bd91d04a7fdf28b5227669657a06f76816591fd687918f8fc596366c8e6c26",
            "created": "2026-09-13T08:40:00Z",
            "evidence": [
              {
                "ref": "note:hut Wi-Fi drops in fog"
              },
              {
                "ref": "ssd:exports/keeper-trial.zip"
              },
              {
                "ref": "room:harbor#4"
              }
            ],
            "id": "req-20260913-789a",
            "project": "lighthouse-app",
            "review_by": null,
            "scope": {
              "lane": "fog-signal",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "fog",
              "offline",
              "ssd"
            ],
            "title": "Fog-signal schedule must work unplugged",
            "type": "requirement"
          },
          "path": "requirements/2026-09-13_fog-signal-schedule-must-work-unplugged_789a.md",
          "supersession_chain": [
            "req-20260913-789a"
          ]
        },
        {
          "body": "**Term:** watch\n\n**Meaning:** A four-hour keeper shift. The harbor board groups log lines by watch.\n\n**Do not confuse with:** A vessel-traffic watch officer, which is a different roster.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "7cddf40411e99810e085f22606246e8161655ef69e883ddc9d9ea80cac389b00",
            "created": "2026-09-12T11:05:00Z",
            "evidence": [
              {
                "ref": "note:four-hour keeper shift on the headland roster"
              },
              {
                "ref": "project:GLOSSARY.md"
              }
            ],
            "id": "glo-20260912-90b2",
            "project": "lighthouse-app",
            "review_by": "2027-09-12",
            "scope": {
              "lane": "roster",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "glossary",
              "roster"
            ],
            "title": "watch",
            "type": "glossary"
          },
          "path": "glossary/2026-09-12_watch_90b2.md",
          "supersession_chain": [
            "glo-20260912-90b2"
          ]
        },
        {
          "body": "**Term:** character\n\n**Meaning:** The published flash pattern of a light, written in the light-list notation (for example Fl W 15s).\n\n**Do not confuse with:** The AIS aid-to-navigation type, which names the structure, not the flash pattern.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "405ea183ec43bbfda3e1a8d818958eb1a6d061fbfad818745893c6f1e4a4938e",
            "created": "2026-09-12T11:00:00Z",
            "evidence": [
              {
                "ref": "url:https://www.iala.int/"
              },
              {
                "ref": "note:light-list notation Fl W 15s"
              }
            ],
            "id": "glo-20260912-78a1",
            "project": "lighthouse-app",
            "review_by": "2027-09-12",
            "scope": {
              "lane": "harbor-board",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "glossary",
              "lamp"
            ],
            "title": "character",
            "type": "glossary"
          },
          "path": "glossary/2026-09-12_character_78a1.md",
          "supersession_chain": [
            "glo-20260912-78a1"
          ]
        },
        {
          "body": "**Requirement:** The harbor board shows the current lamp character (for example Fl W 15s), the time it was signed, and whether it is stale.\n\n**Why:** A harbor master glancing at the wall must know what the light is doing without opening the log.\n\n**Acceptance:** A signed log line appears on the board. A log older than 15 minutes shows a stale badge. The character string matches the glossary term.\n",
          "meta": {
            "author": "mara",
            "body_sha256": "9fe726fcc9a05e428d8a37ba1f0c15f8aa0460b8b71cbe4912e924b88fa704dd",
            "created": "2026-09-12T10:15:00Z",
            "evidence": [
              {
                "ref": "project:decisions/2026-09-12_use-keeper-logs-as-the-lamp-status-source-of-truth_a1b2.md"
              },
              {
                "ref": "note:harbor master wall glance in under two seconds"
              }
            ],
            "id": "req-20260912-e5f6",
            "project": "lighthouse-app",
            "review_by": null,
            "scope": {
              "lane": "harbor-board",
              "team": "harbor-master"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "lamp",
              "board",
              "character"
            ],
            "title": "Show live lamp character on the harbor board",
            "type": "requirement"
          },
          "path": "requirements/2026-09-12_show-live-lamp-character-on-the-harbor-board_e5f6.md",
          "supersession_chain": [
            "req-20260912-e5f6"
          ]
        },
        {
          "body": "**Decision:** Lamp status on the harbor board is taken from keeper logs, not from AIS.\n\n**Why:** AIS reports the ship, not the light. Keepers already record the character, eclipse, and outages in the log. The board must show what the light is doing, even when a vessel's transponder is dark.\n\n**Consequences:** The keeper log is a first-class input. AIS remains a traffic overlay. If the log is late, the board shows the last signed character and a stale badge.\n\n**How to verify:** With AIS off, posting a keeper log line updates the lamp panel within one refresh.\n",
          "meta": {
            "approved_by": "mara — \"files first, the light is what the keeper signed\"",
            "author": "mara",
            "body_sha256": "b8c437f51c86f2c028a51cb213f5ef7017f4565368b55a2467b2da155523c799",
            "created": "2026-09-12T09:00:00Z",
            "evidence": [
              {
                "ref": "note:keeper log 2026-09-12"
              },
              {
                "ref": "url:https://www.iala.int/"
              },
              {
                "ref": "project:BRIEF.md"
              }
            ],
            "id": "dec-20260912-a1b2",
            "project": "lighthouse-app",
            "review_by": "2027-03-11",
            "scope": {
              "lane": "harbor-board",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [
              "dec-20260905-c0de"
            ],
            "tags": [
              "lamp",
              "keeper-log",
              "ais"
            ],
            "title": "Use keeper logs as the lamp-status source of truth",
            "type": "decision"
          },
          "path": "decisions/2026-09-12_use-keeper-logs-as-the-lamp-status-source-of-truth_a1b2.md",
          "supersession_chain": [
            "dec-20260905-c0de",
            "dec-20260912-a1b2"
          ]
        },
        {
          "body": "**Source:** IALA NAVGUIDE — Aids to Navigation Manual.\n\n**What we take from it:** Light-character notation, fog-signal categories, and the rule that the published character is the one mariners will look for.\n\n**Locator:** url:https://www.iala.int/\n",
          "meta": {
            "author": "mara",
            "body_sha256": "3336149cd4c37aa684954549572e596f6c2dba496aa69d415fc9c91146cfbcfe",
            "created": "2026-09-10T13:00:00Z",
            "evidence": [
              {
                "ref": "url:https://www.iala.int/"
              },
              {
                "ref": "note:NAVGUIDE Aids to Navigation Manual"
              }
            ],
            "id": "src-20260910-c3d4",
            "project": "lighthouse-app",
            "review_by": "2026-12-09",
            "scope": {
              "lane": "references",
              "team": "harbor-master"
            },
            "sensitivity": "normal",
            "status": "current",
            "superseded_by": null,
            "supersedes": [],
            "tags": [
              "iala",
              "character",
              "fog"
            ],
            "title": "IALA Maritime Buoyage System",
            "type": "source"
          },
          "path": "sources/2026-09-10_iala-maritime-buoyage-system_c3d4.md",
          "supersession_chain": [
            "src-20260910-c3d4"
          ]
        },
        {
          "body": "**Decision:** Poll AIS every five seconds and treat the nearest aid-to-navigation report as lamp status.\n\n**Why:** We wanted a live feed without waiting on keepers.\n\n**Consequences:** The board lied whenever AIS lagged or an AtoN transponder was offline.\n\n**How to verify:** (superseded — see dec-20260912-a1b2)\n",
          "meta": {
            "author": "codex:lighthouse-1",
            "body_sha256": "389bcf3c92bdf74fcb0cb5c25d5b0d78d76418263daa4d54ca17bacff7e519e6",
            "created": "2026-09-05T16:20:00Z",
            "evidence": [
              {
                "ref": "note:early prototype treated AtoN reports as the lamp"
              },
              {
                "ref": "url:https://www.iala.int/"
              }
            ],
            "id": "dec-20260905-c0de",
            "project": "lighthouse-app",
            "review_by": "2027-03-04",
            "scope": {
              "lane": "harbor-board",
              "team": "keepers"
            },
            "sensitivity": "normal",
            "status": "superseded",
            "superseded_by": "dec-20260912-a1b2",
            "supersedes": [],
            "tags": [
              "lamp",
              "ais"
            ],
            "title": "Poll AIS every five seconds for lamp status",
            "type": "decision"
          },
          "path": "decisions/superseded/2026-09-05_poll-ais-every-five-seconds-for-lamp-status_c0de.md",
          "supersession_chain": [
            "dec-20260905-c0de",
            "dec-20260912-a1b2"
          ]
        }
      ]
    }
  ]
}