@fml-inc/fml 0.8.6 → 0.8.7-rc.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "fml",
-  "version": "0.8.6",
+  "version": "0.8.7-rc.1",
   "description": "FML agent tools for Claude Code",
   "mcpServers": {
     "fml": {

package/README.md

@@ -213,11 +213,22 @@ backlog.
 
 The handler-side inbox is a short-lived durability bridge for times when the
 observer is stopped or unavailable. It is bounded independently from the
-SQLite spool: by default it accepts at most 512 MiB or 10,000 delivery files,
-whichever is reached first. At a limit it preserves older committed files,
-refuses the newest inbox write, and still fails open for the invoking agent; a
-running observer can still accept that event directly. `fml status` reports
-the active limits and cumulative capacity refusals.
+SQLite spool: by default it accepts at most 512 MiB or 262,144 delivery files,
+whichever is reached first; the entry cap is derived from the byte budget at
+2 KiB per event, so bytes are the effective bound for any realistic event.
+Raising `FML_HOOK_INBOX_MAX_BYTES` alone re-derives the entry cap. At a limit
+it preserves older committed files, refuses the newest inbox write, and still
+fails open for the invoking agent; a running observer can still accept that
+event directly. `fml status` reports the active limits, cumulative capacity
+refusals, and the subset of refusals that no observer took either, which is
+real loss; `fml start` warns about any such loss recorded since the last
+start.
+
+To keep the bridge short, a hook that finds the observer's recorded endpoint
+no longer answering relaunches the observer in the background, at most once
+every ten minutes. An explicit `fml stop` pauses capture entirely and is never
+undone by a hook; a crash, reboot, or upgrade is. A machine where `fml start`
+never ran has no recorded endpoint and gets no daemon.
 
 Set `FML_HOOK_INBOX_MAX_BYTES` and `FML_HOOK_INBOX_MAX_ENTRIES` in the coding
 agent's environment to change these limits. Bytes accept the same `B`, `KiB`,