seatmesh 1.0.2 → 1.0.4

package/dist/ui/banner.d.ts

@@ -3,7 +3,22 @@ export type BannerOpts = {
     subtitle?: string;
     /** Shown centered under the title block (default text: SEATMESH_TAGLINE). */
     tagline?: boolean | string;
+    /** Print even if this terminal already saw the logo. */
+    force?: boolean;
 };
-/** Brand header: logo + title + optional centered tagline. */
-export declare function printSeatmeshBanner(opts?: string | BannerOpts): void;
+/** Stable id for this terminal: tmux pane, else tty device. */
+export declare function terminalBannerKey(): string;
+/**
+ * First call in this terminal → true (and marks shown). Later calls → false.
+ * SEATMESH_BANNER=1 force show; =0 force skip. Empty key (no tty) → false.
+ */
+export declare function consumeTerminalBannerSlot(): boolean;
+/** Whether this invocation should print the brand logo (once per terminal). */
+export declare function shouldPrintSeatmeshBanner(force?: boolean): boolean;
+/**
+ * Brand header: logo + title + optional centered tagline.
+ * Once per terminal (TTY / tmux pane) unless `force` or SEATMESH_BANNER=1.
+ * Returns true if the logo was printed.
+ */
+export declare function printSeatmeshBanner(opts?: string | BannerOpts): boolean;
 //# sourceMappingURL=banner.d.ts.map

package/dist/ui/banner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAgB7D,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B,CAAC;AA0EF,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAyCpE"}
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAgB7D,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAqFF,+DAA+D;AAC/D,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAOD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAsBnD;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,KAAK,UAAQ,GAAG,OAAO,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CA6CvE"}

package/dist/ui/banner.js

@@ -1,9 +1,15 @@
 import boxen from "boxen";
 import cfonts from "cfonts";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
 import { renderLogoMark } from "./logo-art.js";
 import { terminalStyleEnabled, tintBrandBlueGradient } from "./logo-color.js";
 export const SEATMESH_TAGLINE = "tmux multi-agent workbench";
 const TITLE_FONT = "block";
+/** Stamp TTL — new login / long-lived pts still get a fresh logo occasionally. */
+const BANNER_STAMP_TTL_MS = 12 * 60 * 60 * 1000;
 function stripAnsi(text) {
     return text.replace(/\x1b\[[0-9;]*m/g, "");
 }
@@ -69,9 +75,76 @@ function resolveBannerOpts(opts) {
         return { subtitle: opts };
     return opts ?? {};
 }
-/** Brand header: logo + title + optional centered tagline. */
+function bannerCacheDir() {
+    if (process.env.SEATMESH_BANNER_CACHE_DIR?.trim()) {
+        return process.env.SEATMESH_BANNER_CACHE_DIR.trim();
+    }
+    const base = process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache");
+    return path.join(base, "seatmesh", "banner-once");
+}
+/** Stable id for this terminal: tmux pane, else tty device. */
+export function terminalBannerKey() {
+    const pane = process.env.TMUX_PANE?.trim();
+    if (pane)
+        return `tmux:${pane}`;
+    const r = spawnSync("tty", { encoding: "utf8" });
+    const tty = (r.stdout ?? "").trim();
+    if (r.status === 0 && tty && tty !== "not a tty")
+        return `tty:${tty}`;
+    // Non-interactive / piped — treat as always-plain (no logo spam in scripts).
+    return "";
+}
+function bannerStampPath(key) {
+    const safe = key.replace(/[^a-zA-Z0-9._+-]/g, "_");
+    return path.join(bannerCacheDir(), `${safe}.stamp`);
+}
+/**
+ * First call in this terminal → true (and marks shown). Later calls → false.
+ * SEATMESH_BANNER=1 force show; =0 force skip. Empty key (no tty) → false.
+ */
+export function consumeTerminalBannerSlot() {
+    const force = process.env.SEATMESH_BANNER?.trim();
+    if (force === "0" || force === "false" || force === "off")
+        return false;
+    if (force === "1" || force === "true" || force === "always")
+        return true;
+    const key = terminalBannerKey();
+    if (!key)
+        return false;
+    const stamp = bannerStampPath(key);
+    try {
+        const st = fs.statSync(stamp);
+        if (Date.now() - st.mtimeMs < BANNER_STAMP_TTL_MS)
+            return false;
+    }
+    catch {
+        /* missing — first show */
+    }
+    try {
+        fs.mkdirSync(path.dirname(stamp), { recursive: true });
+        fs.writeFileSync(stamp, `${new Date().toISOString()}\n`);
+    }
+    catch {
+        /* still show once even if stamp fails */
+    }
+    return true;
+}
+/** Whether this invocation should print the brand logo (once per terminal). */
+export function shouldPrintSeatmeshBanner(force = false) {
+    if (force)
+        return true;
+    return consumeTerminalBannerSlot();
+}
+/**
+ * Brand header: logo + title + optional centered tagline.
+ * Once per terminal (TTY / tmux pane) unless `force` or SEATMESH_BANNER=1.
+ * Returns true if the logo was printed.
+ */
 export function printSeatmeshBanner(opts) {
-    const { subtitle, tagline: taglineOpt } = resolveBannerOpts(opts);
+    const resolved = resolveBannerOpts(opts);
+    if (!shouldPrintSeatmeshBanner(Boolean(resolved.force)))
+        return false;
+    const { subtitle, tagline: taglineOpt } = resolved;
     const tagline = taglineOpt === true
         ? SEATMESH_TAGLINE
         : typeof taglineOpt === "string"
@@ -109,5 +182,6 @@ export function printSeatmeshBanner(opts) {
     if (subtitle)
         console.log(frameSubtitle(subtitle));
     console.log("");
+    return true;
 }
 //# sourceMappingURL=banner.js.map

package/dist/ui/banner.js.map

@@ -1 +1 @@
-{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"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"}

package/dist/ui/banner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=banner.test.d.ts.map

package/dist/ui/banner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.test.d.ts","sourceRoot":"","sources":["../../src/ui/banner.test.ts"],"names":[],"mappings":""}

package/dist/ui/banner.test.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { consumeTerminalBannerSlot } from "./banner.js";
+describe("consumeTerminalBannerSlot", () => {
+    let tmp = "";
+    const prevCache = process.env.SEATMESH_BANNER_CACHE_DIR;
+    const prevBanner = process.env.SEATMESH_BANNER;
+    const prevPane = process.env.TMUX_PANE;
+    afterEach(() => {
+        if (tmp)
+            fs.rmSync(tmp, { recursive: true, force: true });
+        if (prevCache === undefined)
+            delete process.env.SEATMESH_BANNER_CACHE_DIR;
+        else
+            process.env.SEATMESH_BANNER_CACHE_DIR = prevCache;
+        if (prevBanner === undefined)
+            delete process.env.SEATMESH_BANNER;
+        else
+            process.env.SEATMESH_BANNER = prevBanner;
+        if (prevPane === undefined)
+            delete process.env.TMUX_PANE;
+        else
+            process.env.TMUX_PANE = prevPane;
+    });
+    it("shows once per terminal then skips", () => {
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "sm-banner-"));
+        process.env.SEATMESH_BANNER_CACHE_DIR = tmp;
+        delete process.env.SEATMESH_BANNER;
+        process.env.TMUX_PANE = "%test-banner-once";
+        expect(consumeTerminalBannerSlot()).toBe(true);
+        expect(consumeTerminalBannerSlot()).toBe(false);
+        expect(consumeTerminalBannerSlot()).toBe(false);
+    });
+    it("SEATMESH_BANNER=1 always shows; =0 never", () => {
+        tmp = fs.mkdtempSync(path.join(os.tmpdir(), "sm-banner-"));
+        process.env.SEATMESH_BANNER_CACHE_DIR = tmp;
+        process.env.TMUX_PANE = "%test-banner-force";
+        process.env.SEATMESH_BANNER = "0";
+        expect(consumeTerminalBannerSlot()).toBe(false);
+        process.env.SEATMESH_BANNER = "1";
+        expect(consumeTerminalBannerSlot()).toBe(true);
+        expect(consumeTerminalBannerSlot()).toBe(true);
+    });
+});
+//# sourceMappingURL=banner.test.js.map

package/dist/ui/banner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.test.js","sourceRoot":"","sources":["../../src/ui/banner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,GAAG;YAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;;YACrE,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,SAAS,CAAC;QACvD,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;;YAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,UAAU,CAAC;QAC9C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;;YACpD,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,GAAG,CAAC;QAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,mBAAmB,CAAC;QAE5C,MAAM,CAAC,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,CAAC,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,GAAG,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,oBAAoB,CAAC;QAE7C,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC;QAClC,MAAM,CAAC,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhD,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC;QAClC,MAAM,CAAC,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,yBAAyB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ui/version-nudge.d.ts

@@ -1,6 +1,9 @@
-/** Public npm release track (shown in upgrade hint). */
-export declare const SEATMESH_RELEASE_NOTE = "Latest: seatmesh@1.0.2 (2026-09-14).";
+/** @deprecated Prefer dynamic registry check via {@link formatHelpVersionBlock}. */
+export declare const SEATMESH_RELEASE_NOTE = "See: seatmesh version --check-registry";
 export declare function readInstalledCliVersion(): string;
+/** Last `seatmesh update` stamp in a profile dir — not the running CLI version. */
+export declare function readProfileSeatmeshVersion(profileDir: string): string | null;
+export declare function installKindLabel(): "dev checkout" | "npx cache" | "global/npm";
 /** True for global / npx installs — skip git monorepo `packages/cli/dist` dev path. */
 export declare function isRegistrySeatmeshInstall(): boolean;
 /**
@@ -13,6 +16,17 @@ export declare function formatInstallStatusLine(installed: string, latest: strin
 export declare function semverLess(a: string, b: string): boolean;
 export declare function resolveLatestRegistryVersion(force?: boolean): string | null;
 export declare function formatVersionUpgradeHint(installed: string, latest: string): string;
+/**
+ * Lines under the bare `npx seatmesh` / `--help` logo: installed vs registry + how to update.
+ */
+export declare function formatHelpVersionBlock(installed: string, latest: string | null, kind?: ReturnType<typeof installKindLabel>): string[];
+export interface VersionInfoOptions {
+    profileDir?: string;
+    json?: boolean;
+    forceRegistryCheck?: boolean;
+}
+/** `seatmesh version` — installed CLI vs npm latest vs profile stamp. */
+export declare function printVersionInfo(opts?: VersionInfoOptions): void;
 /** stderr hint when registry has a newer seatmesh (registry/npx/global installs only). */
 export declare function maybePrintVersionNudge(opts?: {
     forceCheck?: boolean;

package/dist/ui/version-nudge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-nudge.d.ts","sourceRoot":"","sources":["../../src/ui/version-nudge.ts"],"names":[],"mappings":"AASA,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAE5E,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,IAAI,OAAO,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQxF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxD;AA2CD,wBAAgB,4BAA4B,CAAC,KAAK,UAAQ,GAAG,MAAM,GAAG,IAAI,CAUzE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAS5E"}
+{"version":3,"file":"version-nudge.d.ts","sourceRoot":"","sources":["../../src/ui/version-nudge.ts"],"names":[],"mappings":"AASA,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,2CAA2C,CAAC;AAE9E,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5E;AAED,wBAAgB,gBAAgB,IAAI,cAAc,GAAG,WAAW,GAAG,YAAY,CAI9E;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,IAAI,OAAO,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQxF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxD;AA2CD,wBAAgB,4BAA4B,CAAC,KAAK,UAAQ,GAAG,MAAM,GAAG,IAAI,CAUzE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,IAAI,GAAE,UAAU,CAAC,OAAO,gBAAgB,CAAsB,GAC7D,MAAM,EAAE,CA2BV;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,kBAAuB,GAAG,IAAI,CA+BpE;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAS5E"}

package/dist/ui/version-nudge.js

@@ -5,14 +5,29 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 const CACHE_TTL_MS = 6 * 60 * 60 * 1000;
 const NPM_REGISTRY = "https://registry.npmjs.org";
-/** Public npm release track (shown in upgrade hint). */
-export const SEATMESH_RELEASE_NOTE = "Latest: seatmesh@1.0.2 (2026-09-14).";
+/** @deprecated Prefer dynamic registry check via {@link formatHelpVersionBlock}. */
+export const SEATMESH_RELEASE_NOTE = "See: seatmesh version --check-registry";
 export function readInstalledCliVersion() {
     // version-nudge.ts lives in src/ui/ (dist/ui/); package.json is at the package root.
     const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
     const raw = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
     return raw.version?.trim() || "0.0.0";
 }
+/** Last `seatmesh update` stamp in a profile dir — not the running CLI version. */
+export function readProfileSeatmeshVersion(profileDir) {
+    const p = path.join(profileDir, ".seatmesh-version");
+    if (!fs.existsSync(p))
+        return null;
+    const v = fs.readFileSync(p, "utf8").trim();
+    return v || null;
+}
+export function installKindLabel() {
+    if (!isRegistrySeatmeshInstall())
+        return "dev checkout";
+    if (isNpxEphemeralInstall())
+        return "npx cache";
+    return "global/npm";
+}
 /** True for global / npx installs — skip git monorepo `packages/cli/dist` dev path. */
 export function isRegistrySeatmeshInstall() {
     const dir = path.dirname(fileURLToPath(import.meta.url));
@@ -90,9 +105,71 @@ export function resolveLatestRegistryVersion(force = false) {
     return latest;
 }
 export function formatVersionUpgradeHint(installed, latest) {
-    return (`seatmesh: installed ${installed}; npm latest ${latest}. ${SEATMESH_RELEASE_NOTE} ` +
+    return (`seatmesh: this ${installed}; npm latest ${latest}. ` +
         `Upgrade: npm install -g seatmesh@latest  or  npx seatmesh@latest <cmd…>`);
 }
+/**
+ * Lines under the bare `npx seatmesh` / `--help` logo: installed vs registry + how to update.
+ */
+export function formatHelpVersionBlock(installed, latest, kind = installKindLabel()) {
+    const lines = [];
+    if (latest) {
+        if (semverLess(installed, latest)) {
+            lines.push(`version ${installed}  ·  npm latest ${latest}  ·  update available`);
+        }
+        else if (semverLess(latest, installed)) {
+            lines.push(`version ${installed}  ·  npm latest ${latest}  ·  ahead of npm`);
+        }
+        else {
+            lines.push(`version ${installed}  ·  npm latest ${latest}  ·  up to date`);
+        }
+    }
+    else {
+        lines.push(`version ${installed}  ·  npm latest (offline / check failed)`);
+    }
+    if (kind === "dev checkout") {
+        lines.push(`install: dev checkout`);
+    }
+    else if (kind === "npx cache") {
+        lines.push(`install: npx cache (ephemeral) — prefer: npm install -g seatmesh@latest`);
+    }
+    else {
+        lines.push(`install: global/npm`);
+    }
+    if (latest && semverLess(installed, latest)) {
+        lines.push(`update:  npm install -g seatmesh@latest`);
+        lines.push(`     or:  npx seatmesh@latest update`);
+    }
+    else {
+        lines.push(`update:  npm install -g seatmesh@latest  ·  npx seatmesh@latest update`);
+    }
+    return lines;
+}
+/** `seatmesh version` — installed CLI vs npm latest vs profile stamp. */
+export function printVersionInfo(opts = {}) {
+    const installed = readInstalledCliVersion();
+    const latest = resolveLatestRegistryVersion(Boolean(opts.forceRegistryCheck));
+    const kind = installKindLabel();
+    const profileStamp = opts.profileDir ? readProfileSeatmeshVersion(opts.profileDir) : null;
+    if (opts.json) {
+        console.log(JSON.stringify({
+            cli: installed,
+            npmLatest: latest,
+            install: kind,
+            profileSeatmeshVersion: profileStamp,
+            upToDate: !latest || !semverLess(installed, latest),
+        }, null, 2));
+        return;
+    }
+    console.log(formatInstallStatusLine(installed, latest));
+    console.log(`  install: ${kind}`);
+    if (profileStamp != null) {
+        console.log(`  profile .seatmesh-version: ${profileStamp} (last profile update, not this CLI)`);
+    }
+    if (kind === "npx cache") {
+        console.log("  hint: npm install -g seatmesh@latest for a pinned CLI on PATH");
+    }
+}
 /** stderr hint when registry has a newer seatmesh (registry/npx/global installs only). */
 export function maybePrintVersionNudge(opts) {
     if (process.env.SEATMESH_SKIP_VERSION_CHECK === "1")

package/dist/ui/version-nudge.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-nudge.js","sourceRoot":"","sources":["../../src/ui/version-nudge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"version-nudge.js","sourceRoot":"","sources":["../../src/ui/version-nudge.ts"],"names":[],"mappings":"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"}

package/dist/ui/version-nudge.test.js

@@ -1,5 +1,8 @@
-import { describe, expect, it } from "vitest";
-import { formatVersionUpgradeHint, semverLess } from "./version-nudge.js";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { formatHelpVersionBlock, formatVersionUpgradeHint, readProfileSeatmeshVersion, semverLess, } from "./version-nudge.js";
 describe("version-nudge", () => {
     it("semverLess compares patch releases", () => {
         expect(semverLess("0.1.19", "0.1.20")).toBe(true);
@@ -10,7 +13,32 @@ describe("version-nudge", () => {
         const line = formatVersionUpgradeHint("0.1.18", "0.1.20");
         expect(line).toContain("npm install -g seatmesh@latest");
         expect(line).toContain("npx seatmesh@latest");
-        expect(line).toContain("2026-09-14");
+        expect(line).toContain("this 0.1.18");
+        expect(line).toContain("npm latest 0.1.20");
+    });
+    it("help version block shows installed, latest, and update howto", () => {
+        const behind = formatHelpVersionBlock("1.0.2", "1.0.3", "global/npm");
+        expect(behind.some((l) => l.includes("version 1.0.2"))).toBe(true);
+        expect(behind.some((l) => l.includes("npm latest 1.0.3"))).toBe(true);
+        expect(behind.some((l) => l.includes("update available"))).toBe(true);
+        expect(behind.some((l) => l.includes("npm install -g seatmesh@latest"))).toBe(true);
+        const current = formatHelpVersionBlock("1.0.3", "1.0.3", "dev checkout");
+        expect(current.some((l) => l.includes("up to date"))).toBe(true);
+        expect(current.some((l) => l.includes("dev checkout"))).toBe(true);
+        const ahead = formatHelpVersionBlock("1.0.3", "1.0.2", "dev checkout");
+        expect(ahead.some((l) => l.includes("ahead of npm"))).toBe(true);
+    });
+    describe("readProfileSeatmeshVersion", () => {
+        let tmp = "";
+        afterEach(() => {
+            if (tmp)
+                fs.rmSync(tmp, { recursive: true, force: true });
+        });
+        it("reads profile stamp file", () => {
+            tmp = fs.mkdtempSync(path.join(os.tmpdir(), "sm-ver-"));
+            fs.writeFileSync(path.join(tmp, ".seatmesh-version"), "1.0.1\n");
+            expect(readProfileSeatmeshVersion(tmp)).toBe("1.0.1");
+        });
     });
 });
 //# sourceMappingURL=version-nudge.test.js.map

package/dist/ui/version-nudge.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-nudge.test.js","sourceRoot":"","sources":["../../src/ui/version-nudge.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1E,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAAG,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"version-nudge.test.js","sourceRoot":"","sources":["../../src/ui/version-nudge.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seatmesh",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "engines": {
     "node": ">=22"
   },
@@ -24,11 +24,11 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.8.0",
-    "@seat-mesh/connectivity": "1.0.2",
-    "@seat-mesh/core": "1.0.2",
-    "@seat-mesh/daemon": "1.0.2",
-    "@seat-mesh/providers": "1.0.2",
-    "@seat-mesh/tmux": "1.0.2",
+    "@seat-mesh/connectivity": "1.0.4",
+    "@seat-mesh/core": "1.0.4",
+    "@seat-mesh/daemon": "1.0.4",
+    "@seat-mesh/providers": "1.0.4",
+    "@seat-mesh/tmux": "1.0.4",
     "boxen": "^8.0.1",
     "cfonts": "^3.3.1",
     "commander": "^15.0.0"

package/profiles/minimal/roles/common.yaml

@@ -5,7 +5,10 @@ banner:
   - "comms=enqueue only; inbox daemon injects — no raw tmux send-keys"
   - "inbox_inject_not_dan=[mesh-inbox] lines are daemon steering — shell/seat files only; not a new user task"
   - "slot_vs_mini=slot-N = worker seat; mini-N = minis window only — NOT the same pane"
+  - "operator_eyes=beta: seatmesh agent notify \"…\" \"…\" --url <link> | notify yesno \"<title>\" \"<body>\""
 read_first:
+  - path: .sm/AGENTS.md
+    note: seatmesh CLI gateway — agent <cmd>; notify for operator eyes + --url
   - path: .sm/README.md
     note: dotdir layout + seats.root
   - path: docs/ONE-PATH.md

package/templates/init/AGENTS.md

@@ -0,0 +1,87 @@
+# Seatmesh CLI (default for every agent)
+
+**Engine-owned.** Do not invent alternate CLIs. Discover with `agent`, then run only what it lists.
+
+## Every turn
+
+```bash
+seatmesh agent whoami
+seatmesh agent          # can / cannot for THIS pane
+```
+
+Default config is workspace `.sm/` (walk-up). No `--profile` needed.
+
+Multi-config (rare): `seatmesh --profile .sm-<name> agent …` after `seatmesh session init <sm-name>`.
+
+Run work through the gateway:
+
+```bash
+seatmesh agent <cmd> …
+```
+
+Unknown or not allowed for your seat → console `UNAUTHORIZED` (exit 2). Fix: run `agent` and pick from **can**.
+
+## When you need the operator's eyes (beta)
+
+**Beta** — use notify; fall back to peer/room if toast fails.
+
+Do **not** ask the operator in chat to “look”. Prefer **notify**.
+
+### Craft an Info link (local UI — markdown + actionables)
+
+Agents write **simple markdown** (or richer md + images). Info opens the **seatmesh UI card** (`/act/card/…`) — not mdview — so the same page can hold **Yes/No**.
+
+```bash
+# Info only (markdown on local UI)
+seatmesh agent notify info "Landing CTA" --body "## Options\n\n- A terracotta\n- B black"
+
+# Info + Yes/No on the same UI card
+seatmesh agent notify yesno "Ship terracotta?" "Quick call" \
+  --md ./brief.md --image shot.png --target manager
+```
+
+Aliases: `notify info` · `notify md` · `notify details`
+
+### Eyes-only (existing link)
+
+```bash
+seatmesh agent notify "<session>" "<check>" --url "<link>"
+```
+
+| Piece | Agent crafts | Operator gets |
+|-------|----------------|---------------|
+| **Info** | `--md` / `--body` / `--image` → local `/act/card` UI | Rendered markdown + Yes/No on same page |
+| **Yes / No** | (built-in) | Peer to reply seat as `PRIORITY [operator-decide]` |
+
+Never: “please check my pane” without notify.
+
+## Common cmds (still via `agent`)
+
+| Job | Command |
+|-----|---------|
+| Craft Info link | `agent notify info\|md "<title>" --md <file>\|--body "…"` |
+| Info + Yes/No | `agent notify yesno "<title>" "<blurb>" [--md file]` |
+| Eyes + URL | `agent notify "<session>" "<check>" [--url <link>]` |
+| Reply / ask | `agent peer <target> "<msg>" [--ended <ack-id>]` |
+| Close ask | `agent ack <id> "<note>"` |
+| List / stop checkback | `agent cb list` · `agent cb cancel <id>` |
+| Room | `agent room tail [-r slug]` · `agent room say …` |
+| Peek | `agent peek <target> status\|full` |
+| Agent vs terminal | `agent kind <target>` (aliases: `what`, `typeof`) |
+| Seats snapshot | `agent contexts` |
+
+Lead-only extras (manager/secretary) appear on your `agent` card — spawn/assign/inbox restart are not universal.
+
+## Outside `agent` (operator / shared)
+
+Humans and session ops only — not the pane default path:
+
+`session` · `session init <sm-name>` · `update` · `init` · `report` · `layout` · `save` · `inbox restart` · `target`
+
+## Hard rules
+
+- Enqueue only — no raw `tmux send-keys` for mesh mail.
+- `[mesh-inbox]` / DIGEST lines are daemon steering, not a new human task.
+- Inject copy = mesh-copy consts. Never paste `patterns.md` into a pane.
+- Chat prose does not clear ACK or cancel checkback — use `ack` / `cb cancel`.
+- Operator eyeball/approve/prove/decide → **notify (beta)** first; do not ask chat for a toast.

package/templates/init/mesh.config.yaml

@@ -58,12 +58,12 @@ seats:
     mini: "mini-{n}"
 
 state:
-  meshAgentsJson: .sm/mesh-agents.json
-  agentsJson: .sm/agents.json
+  meshAgentsJson: mesh-agents.json
+  agentsJson: mesh-agents.json
   autoScrapeIntervalMs: 600000
 
 data:
-  root: .sm/runtime
+  root: runtime
 
 roles:
   dir: roles
@@ -87,7 +87,7 @@ ports:
   worker: "30{n}0/30{n}1"
 
 chatRooms:
-  root: .sm/chat-rooms
+  root: chat-rooms
   globalSlug: global
   checkback:
     duration: 5m

package/templates/init/roles/common.yaml

@@ -1,8 +1,11 @@
 # Whoami-only. Standing rules live in always-on host dots, not this file.
 banner:
   - "prompts=mesh-copy.ts consts only — never paste patterns.md into a pane"
-  - "fresh_summon=./sm.sh whoami first; later peer is a task"
+  - "fresh_summon=seatmesh agent whoami first; later peer is a task"
   - "no_reconfirm=finish open TODOs; do not ask operator to continue"
+  - "operator_eyes=beta: seatmesh agent notify \"…\" \"…\" --url <link> | notify yesno \"<title>\" \"<body>\""
 read_first:
+  - path: .sm/AGENTS.md
+    note: seatmesh CLI gateway — agent <cmd>; notify for operator eyes + --url
   - path: docs/ONE-PATH.md
     note: one command per job

package/templates/init/roles/manager.yaml

@@ -1,7 +1,7 @@
 kind: manager
 extends: common
 banner:
-  - "cold_start=./sm.sh whoami --validate | coordination; spawn/review minis; PROPOSAL gate"
+  - "cold_start=seatmesh --profile .sm agent whoami --validate | coordination; spawn/review minis; PROPOSAL gate"
 read_first:
   - path: .sm/mesh.config.yaml
     note: layout + daemon port + seats.root
@@ -18,6 +18,6 @@ policies:
   - id: manager_throughput
     text: spawn minis for long generate; master stays coordination + PROPOSAL gate
   - id: peer
-    cmd: ./sm.sh peer <target> "<msg>"
+    cmd: 'seatmesh --profile .sm agent peer <target> "<msg>"'
   - id: minis
-    cmd: ./sm.sh mini list
+    cmd: "seatmesh --profile .sm agent mini list"