pi-post 0.6.3 → 0.7.0

package/README.md

@@ -74,7 +74,7 @@ inert.
 pi install npm:pi-post
 ```
 
-Nothing to enable; every session registers itself on startup.
+Nothing to enable; every session registers itself on startup. Once a session has started, the CLI is also available at `~/.pi/agent/post/bin/pi-post` for hooks and scripts on hosts where `pi-post` is not on `PATH`.
 
 ## Use
 

package/extensions/pi-post.ts

@@ -6,6 +6,8 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import type { FSWatcher } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
 import { canonicalPath, sessionAddress } from "../src/address.ts";
 import { createMessage, type Message } from "../src/message.ts";
 import {
@@ -31,8 +33,10 @@ import {
   writeRecord,
 } from "../src/registry.ts";
 import { resolveTargets } from "../src/resolve.ts";
+import { ensureCliShim } from "../src/cli-shim.ts";
 
 const HEARTBEAT_MS = 30_000;
+const CLI_TARGET = resolve(dirname(fileURLToPath(import.meta.url)), "../bin/pi-post.mjs");
 
 export default function (pi: ExtensionAPI) {
   const root = postRoot();
@@ -94,6 +98,7 @@ export default function (pi: ExtensionAPI) {
     process.env.PI_SESSION_ADDRESS = selfAddress;
 
     ensureDirs(root, selfAddress);
+    ensureCliShim(root, CLI_TARGET);
     writeRecord(root, {
       v: 1,
       address: selfAddress,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-post",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Messages between pi sessions — delivered mid-task or queued until they return.",
   "keywords": [
     "pi-package",

package/src/cli-shim.ts

@@ -0,0 +1,25 @@
+import { existsSync, lstatSync, mkdirSync, readlinkSync, symlinkSync, unlinkSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+/** Ensure the mailbox-owned CLI path points at the package's own executable. */
+export function ensureCliShim(baseDir: string, targetPath: string): void {
+  const shimDir = join(baseDir, "bin");
+  const shimPath = join(shimDir, "pi-post");
+  try {
+    mkdirSync(shimDir, { recursive: true, mode: 0o700 });
+
+    try {
+      if (lstatSync(shimPath).isSymbolicLink()) {
+        const linkTarget = readlinkSync(shimPath);
+        if (resolve(dirname(shimPath), linkTarget) === resolve(targetPath) && existsSync(targetPath)) return;
+      }
+      unlinkSync(shimPath);
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
+    }
+
+    symlinkSync(targetPath, shimPath);
+  } catch {
+    // A CLI convenience must never prevent a session from starting.
+  }
+}