@katyella/legio 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-03-02
+
+### Fixed
+- Coordinator and sling beacons now explain what legio is — previously Claude Code on fresh machines rejected thin beacons as "unrecognized" foreign content (same fix as gateway in v0.2.1)
+- Coordinator beacon startup instructions use `legio status` instead of `bd ready` / `legio group status` (doesn't assume beads is installed)
+- `legio doctor` no longer flags persistent agent identity files (coordinator, gateway, monitor) as stale — they legitimately exist outside the agent manifest
+- Gateway greeting mail ("Gateway is online and ready") is only sent after confirmed beacon delivery — previously it was sent even when the beacon was rejected
+- 2399 tests across 79 test files (up from 2397 across 79)
+
 ## [0.2.2] - 2026-03-02
 
 ### Fixed
@@ -201,7 +210,8 @@ Initial public release on npm as [`@katyella/legio`](https://www.npmjs.com/packa
 - E2E lifecycle tests via Playwright
 - Vitest test runner with forks pool for CI compatibility
 
-[Unreleased]: https://github.com/katyella/legio/compare/v0.2.2...HEAD
+[Unreleased]: https://github.com/katyella/legio/compare/v0.2.3...HEAD
+[0.2.3]: https://github.com/katyella/legio/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/katyella/legio/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/katyella/legio/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/katyella/legio/compare/v0.1.3...v0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@katyella/legio",
-	"version": "0.2.2",
+	"version": "0.2.3",
 	"description": "Multi-agent orchestration for Claude Code — spawn worker agents in git worktrees via tmux, coordinate through SQLite mail, merge with tiered conflict resolution",
 	"author": "Matthew Wojtowicz",
 	"license": "MIT",

package/src/commands/gateway.test.ts

@@ -518,8 +518,26 @@ describe("startGateway", () => {
 		expect(enterCalls).toHaveLength(2); // follow-up Enter + retry Enter
 	});
 
-	test("sends greeting mail to human after beacon delivery", async () => {
-		const { deps } = makeDeps();
+	test("sends greeting mail to human after confirmed beacon delivery", async () => {
+		const { tmux } = makeFakeTmux();
+		// Simulate hooks transitioning session out of "booting" after a few sleep calls
+		let sleepCount = 0;
+		const deps: GatewayDeps = {
+			_tmux: tmux,
+			_sleep: async () => {
+				sleepCount++;
+				// After 3 sleeps (waitForTuiReady + follow-up Enter delay + first poll),
+				// transition session to "working" like hooks would
+				if (sleepCount === 3) {
+					const { store } = openSessionStore(legioDir);
+					try {
+						store.updateState("gateway", "working");
+					} finally {
+						store.close();
+					}
+				}
+			},
+		};
 		await captureStdout(() => gatewayCommand(["start", "--no-attach"], deps));
 		// Verify mail.db has the greeting
 		const { createMailStore } = await import("../mail/store.ts");
@@ -535,6 +553,20 @@ describe("startGateway", () => {
 			mailDb.close();
 		}
 	});
+
+	test("does not send greeting mail when beacon delivery fails", async () => {
+		const { deps } = makeDeps();
+		await captureStdout(() => gatewayCommand(["start", "--no-attach"], deps));
+		// verifyBeaconDelivery returns false (session stays in "booting"), so no greeting mail
+		const { createMailStore } = await import("../mail/store.ts");
+		const mailDb = createMailStore(join(legioDir, "mail.db"));
+		try {
+			const msgs = mailDb.getAll({ from: "gateway", to: "human" });
+			expect(msgs).toHaveLength(0);
+		} finally {
+			mailDb.close();
+		}
+	});
 });
 
 describe("stopGateway", () => {

package/src/commands/gateway.ts

@@ -118,7 +118,7 @@ async function verifyBeaconDelivery(
 	tmuxSession: string,
 	beacon: string,
 	sleep: (ms: number) => Promise<void>,
-): Promise<void> {
+): Promise<boolean> {
 	const MAX_CHECKS = 10;
 	const INTERVAL_MS = 2_000;
 
@@ -127,7 +127,7 @@ async function verifyBeaconDelivery(
 		const session = store.getByName(GATEWAY_NAME);
 		if (session && session.state !== "booting") {
 			// Beacon confirmed — gateway transitioned out of booting
-			return;
+			return true;
 		}
 	}
 
@@ -142,7 +142,9 @@ async function verifyBeaconDelivery(
 	const finalSession = store.getByName(GATEWAY_NAME);
 	if (!finalSession || finalSession.state === "booting") {
 		process.stderr.write("[legio] Warning: gateway beacon delivery could not be confirmed\n");
+		return false;
 	}
+	return true;
 }
 
 /**
@@ -305,25 +307,27 @@ async function startGateway(args: string[], deps: GatewayDeps = {}): Promise<voi
 
 		// Verify delivery: poll store until state transitions out of booting.
 		// Must complete before the finally block closes the store.
-		await verifyBeaconDelivery(store, tmux, tmuxSession, beacon, sleep);
-
-		// Send greeting mail to human
-		const { createMailStore } = await import("../mail/store.ts");
-		const mailDb = createMailStore(join(legioDir, "mail.db"));
-		try {
-			mailDb.insert({
-				id: "",
-				from: GATEWAY_NAME,
-				to: "human",
-				subject: "Gateway online",
-				body: "Gateway is online and ready. Send a message to start chatting.",
-				type: "status",
-				priority: "normal",
-				threadId: null,
-				audience: "human",
-			});
-		} finally {
-			mailDb.close();
+		const confirmed = await verifyBeaconDelivery(store, tmux, tmuxSession, beacon, sleep);
+
+		// Send greeting mail to human only after confirmed beacon delivery
+		if (confirmed) {
+			const { createMailStore } = await import("../mail/store.ts");
+			const mailDb = createMailStore(join(legioDir, "mail.db"));
+			try {
+				mailDb.insert({
+					id: "",
+					from: GATEWAY_NAME,
+					to: "human",
+					subject: "Gateway online",
+					body: "Gateway is online and ready. Send a message to start chatting.",
+					type: "status",
+					priority: "normal",
+					threadId: null,
+					audience: "human",
+				});
+			} finally {
+				mailDb.close();
+			}
 		}
 
 		if (shouldAttach) {

package/src/index.ts

@@ -45,7 +45,7 @@ import { worktreeCommand } from "./commands/worktree.ts";
 import { LegioError, WorktreeError } from "./errors.ts";
 import { setQuiet } from "./logging/color.ts";
 
-const VERSION = "0.2.2";
+const VERSION = "0.2.3";
 
 const HELP = `legio v${VERSION} — Multi-agent orchestration for Claude Code