Tags: hamr0/flightlog

release: v0.6.2 — ship shared Implementation Guide (docs-only)

Add IMPLEMENTATION_GUIDE.md (restructured from the repo-only observability
playbook) to the package files allowlist and link it from the README and
context. Two standalone parts (Part A flightlog / Part B pulselog) so either
tool adopts alone. Identical guide ships in both packages, no dependency
between them.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HuCdMrMqqUx3GYuYPTE5yT

release: v0.6.1 — drop README Docs section (docs-only)

Remove the ## Docs table (Integration Guide / Examples / PRD / CHANGELOG
links) from the README. Docs/packaging only — no code or API change. Also
restores the stale CHANGELOG compare-link footer (0.4.0–0.6.1).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HuCdMrMqqUx3GYuYPTE5yT

flightlog v0.6.0 — fatal-exit stderr breadcrumb

v0.4.0 — captureSync returns WriteResult; examples/read.js; security …

…hardening

- captureSync now returns { ok, errno? } (additive; PRD §15.4)
- examples/read.js reference reader (repo-only, sibling to ship.js)
- Security audit (PRD §16): ship.js HTTPS-fail-closed, read.js control-char
  + paste-safe jq hint hardening
- Suite 38 → 49; tsc clean

See CHANGELOG [0.4.0].

0.3.1: ship the corrected context.md API header

Doc-only patch. 0.2.0/0.3.0 tarballs carried a stale context.md API section
(`install → { capture }`, pre-captureSync); the fix was on main (9908093) but
not yet on npm. This publishes the corrected adopter contract.

CHANGELOG dated 0.3.1; PRD status line refreshed (34 green; release line
0.1.0 → 0.2.0 → 0.3.0 → 0.3.1). No code or behavior change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

0.3.0: bootCheck option — non-fatal boot for short-lived processes

Second-round gitdone feedback. receive.js runs per-message as a Postfix pipe;
flightlog's boot-time writability probe is fatal by design (fail loud at boot),
so an unwritable log dir made every inbound message exit non-zero and Postfix
defer ALL mail. The fatal boot is the one intentional exception to "never
becomes the bug" — right for a long-lived server, wrong for a per-invocation
process where a broken error sink takes down the real work.

- bootCheck (default true): when false, an unwritable file at install warns once
  to stderr and the sink degrades to swallow-on-write instead of throwing. Same
  family as exitOnUncaught/exitOnRejection: server-shaped default preserved,
  opt-out for the short-lived shape. ~6 lines in sink.js + plumbing.

Confirmed needed across the user's stack (multiple Postfix-fronted apps), so it
belongs in the library, not patched per-app. Nuance recorded (PRD §14.1): for a
mail pipe the default (defer-and-retry) is often safer than the opt-out
(deliver-blind) — the knob is the general fix, not blanket advice to flip it.

Docs synced: CHANGELOG, PRD (§5/§6/§14.1), context.md, README, CLAUDE.md.
Tests 33 -> 34 (bad path with bootCheck:false survives + warns once). tsc clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

0.2.0: captureSync + exitOnRejection for short-lived processes

First-adopter (gitdone) integration feedback. All gaps were about
short-lived capture-then-exit processes; the core was solid.

- captureSync(err, extra?): synchronous manual capture, surfaced from the
  sink's existing writeSync. capture-then-exit no longer loses the line.
  Same record/merge as capture, kind stays 'manual', never throws/exits.
- exitOnRejection (default false): opt-in fatal rejections — log sync then
  exit(1) — so a short-lived process dies non-zero instead of a silent
  exit-0. Default false preserves the log-only server contract. Mirrors
  exitOnUncaught. Re-opened the litigated refusal in PRD §14 (the default
  is unchanged; this is a documented escape hatch, not a re-added feature).
- CJS: declined a dual-build (fluff); documented ESM-only + the Node >=22.12
  require(esm) floor / await import() fallback. engines stays >=18 (honest
  for the supported ESM path).

Docs synced: CHANGELOG, PRD (§5/§6/§14), context.md, README, CLAUDE.md.
Tests 31 -> 33 (captureSync survives immediate exit; exitOnRejection fatal).
tsc clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

flightlog 0.1.0 — first functional release (published to npm 2026-05-31)