pi-lxmf 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.1.1] - 2026-09-24
+
+### Added
+
+- Startup notification to the owner (work doc #5): once the daemon is
+  fully available (LXMF destination announcing, `pi --mode rpc` ready), it
+  sends `🟢 pi-lxmf ready — listening for messages.` to the configured
+  owner — plus a `Resuming session <file>.` line when a session pointer
+  was resumed. Best-effort: a failed delivery is noted and carried by the
+  next successful reply.
+
 ## [0.1.0] - 2026-09-24
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-lxmf",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Drive the Pi coding agent over LXMF messaging (Reticulum mesh) from a headless server.",
   "license": "EUPL-1.2",
   "author": "Henri Bergius <henri.bergius@iki.fi>",

package/src/bin.js

@@ -210,6 +210,10 @@ async function main() {
   process.on("SIGINT", () => shutdown("SIGINT"));
   process.on("SIGTERM", () => shutdown("SIGTERM"));
 
+  // The daemon is fully available: tell the owner (they may be waiting on
+  // a restart). Delivery failures are noted, not fatal.
+  await bridge.notifyStartup(sessionPointer?.sessionFile ?? null);
+
   // Run until signalled or shut down over LXMF.
   await new Promise(() => {});
 }

package/src/bridge.js

@@ -13,6 +13,7 @@
  * before falling back to a "done (no reply)" nudge.
  */
 
+import { basename } from "node:path";
 import {
   bridgeCommands,
   EMPTY_REPLY_RECOVERY_PROMPT,
@@ -554,6 +555,23 @@ export class Bridge {
     }
   }
 
+  /**
+   * Tells the owner the bridge has started and is accepting messages
+   * (the startup case of SPEC §13 proactive notifications). Called by the
+   * daemon once the mesh side is announcing and the RPC child is ready.
+   * Best-effort via {@link deliver}: a failure is noted and carried by
+   * the next successful delivery instead of being lost.
+   *
+   * @param {string|null} [resumedSessionFile] - Absolute path of the
+   *   session resumed from the persisted pointer, when one exists.
+   */
+  async notifyStartup(resumedSessionFile = null) {
+    const resumed = resumedSessionFile
+      ? `\nResuming session ${basename(resumedSessionFile)}.`
+      : "";
+    await this.deliver(`🟢 pi-lxmf ready — listening for messages.${resumed}`);
+  }
+
   /**
    * @param {string} reason
    */