@seat-mesh/core 0.1.2

package/dist/role-index.js

@@ -0,0 +1,97 @@
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+function mergeRoleIndex(base, role) {
+    const readFirst = [...(base.read_first ?? []), ...(role.read_first ?? [])];
+    const seen = new Set();
+    const dedupedReadFirst = readFirst.filter((item) => {
+        if (seen.has(item.path))
+            return false;
+        seen.add(item.path);
+        return true;
+    });
+    return {
+        ...role,
+        banner: [...(base.banner ?? []), ...(role.banner ?? [])],
+        read_first: dedupedReadFirst,
+        policies: [...(base.policies ?? []), ...(role.policies ?? [])],
+        files: [...new Set([...(base.files ?? []), ...(role.files ?? [])])],
+        inject: [...(base.inject ?? []), ...(role.inject ?? [])],
+        vars: { ...(base.vars ?? {}), ...(role.vars ?? {}) },
+    };
+}
+/** Deprecated alias: prefer "manager" not "master" for the coordinator pane. */
+function normalizeRoleKind(kind) {
+    return kind === "master" ? "manager" : kind;
+}
+export function loadRoleIndex(rolesDir, kind) {
+    const normalized = normalizeRoleKind(kind);
+    const file = path.join(rolesDir, `${normalized}.yaml`);
+    if (!fs.existsSync(file)) {
+        throw new Error(`role index missing: ${file}`);
+    }
+    let common = {};
+    const commonFile = path.join(rolesDir, "common.yaml");
+    if (fs.existsSync(commonFile)) {
+        common = YAML.parse(fs.readFileSync(commonFile, "utf8"));
+    }
+    const data = YAML.parse(fs.readFileSync(file, "utf8"));
+    if (!data.kind)
+        data.kind = normalized;
+    return mergeRoleIndex(common, data);
+}
+function substituteVars(text, vars) {
+    return text.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] ?? "");
+}
+export function renderRoleIndex(index, vars = {}, opts = {}) {
+    const lines = [];
+    if (!opts.skipBanner) {
+        for (const line of index.banner ?? []) {
+            lines.push(substituteVars(line, vars));
+        }
+    }
+    for (const item of index.read_first ?? []) {
+        const p = substituteVars(item.path, vars);
+        const note = item.note ? substituteVars(item.note, vars) : "";
+        lines.push(`file=${p}${note ? ` | ${note}` : ""}`);
+    }
+    for (const pol of index.policies ?? []) {
+        if (pol.path) {
+            lines.push(`policy_${pol.id}=${substituteVars(pol.path, vars)}${pol.rule ? ` | ${substituteVars(pol.rule, vars)}` : ""}`);
+        }
+        else if (pol.text) {
+            lines.push(`policy_${pol.id}=${substituteVars(pol.text, vars)}`);
+        }
+        else if (pol.cmd) {
+            lines.push(`policy_${pol.id}=${substituteVars(pol.cmd, vars)}`);
+        }
+    }
+    for (const f of index.files ?? []) {
+        lines.push(`file=${substituteVars(f, vars)}`);
+    }
+    for (const [k, v] of Object.entries(index.vars ?? {})) {
+        lines.push(`${k}=${substituteVars(v, vars)}`);
+    }
+    for (const line of index.inject ?? []) {
+        lines.push(`inject=${substituteVars(line, vars)}`);
+    }
+    return lines.join("\n");
+}
+export function validateRoleIndex(index, workspace) {
+    const missing = [];
+    const check = (rel) => {
+        const p = path.isAbsolute(rel) ? rel : path.resolve(workspace, rel);
+        if (!fs.existsSync(p))
+            missing.push(rel);
+    };
+    for (const item of index.read_first ?? [])
+        check(item.path);
+    for (const pol of index.policies ?? []) {
+        if (pol.path)
+            check(pol.path);
+    }
+    for (const f of index.files ?? [])
+        check(f);
+    return { ok: missing.length === 0, missing };
+}
+//# sourceMappingURL=role-index.js.map

package/dist/role-index.js.map

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

package/dist/runtime-paths.d.ts

@@ -0,0 +1,43 @@
+import type { MeshProfile } from "./schema/profile.js";
+import type { LoadedProfile } from "./profile.js";
+import type { StorageBackend } from "./paths-manifest.js";
+/** Stable short id for a workspace root (tmux session suffix, port offset). */
+export declare function workspaceScopeId(workspace: string, length?: number): string;
+/** Tmux session name: `mesh-a3f91c` when scope=workspace, else yaml `session.name`. */
+export declare function resolveSessionName(profile: MeshProfile, workspace: string): string;
+/** Inbox HTTP port — unique per workspace when portScope=workspace. */
+export declare function resolveDaemonPort(profile: MeshProfile, workspace: string): number;
+export declare function resolveDataRoot(profile: MeshProfile, workspace: string): string;
+export interface MeshRuntimePaths {
+    dataRoot: string;
+    daemonDir: string;
+    sqlitePath: string;
+    storageBackend: StorageBackend;
+    inboxJsonl: string;
+    peerJsonl: string;
+    checkbackJsonl: string;
+    paneOpsJsonl: string;
+    callsJsonl: string;
+    meshInboxMeta: string;
+    meshInboxStop: string;
+    meshInboxLog: string;
+    coldStartState: string;
+    ppaState: string;
+    wifiProbeLock: string;
+    minisJson: string;
+    miniDone: string;
+    miniManifest: string;
+    gateQueue: string;
+}
+export declare function meshRuntimePaths(loaded: LoadedProfile): MeshRuntimePaths;
+/** Workspace-relative path for agent-visible hints (whoami, checkback). */
+export declare function runtimePathHint(workspace: string, absPath: string): string;
+export interface ResolvedConnectivityHooks {
+    status?: string;
+    up?: string;
+    rotate?: string;
+    smartRestart?: string;
+}
+/** Resolve hook scripts to absolute paths (profile hooks only — no driver branches). */
+export declare function resolveConnectivityHooks(profile: MeshProfile, workspace: string): ResolvedConnectivityHooks | null;
+//# sourceMappingURL=runtime-paths.d.ts.map

package/dist/runtime-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.d.ts","sourceRoot":"","sources":["../src/runtime-paths.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAGtE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUjF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAwBxE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB,yBAAyB,GAAG,IAAI,CAkBlC"}

package/dist/runtime-paths.js

@@ -0,0 +1,94 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { resolveFromWorkspace } from "./paths.js";
+import { buildResolvedPaths } from "./paths-manifest.js";
+/** Outside common dev 3000-3099 (product FE/BE slots, legacy harness). */
+const DEFAULT_DAEMON_PORT_BASE = 31670;
+const DEFAULT_DAEMON_PORT_RANGE = 90;
+/** Stable short id for a workspace root (tmux session suffix, port offset). */
+export function workspaceScopeId(workspace, length = 6) {
+    const resolved = path.resolve(workspace);
+    return createHash("sha256").update(resolved).digest("hex").slice(0, length);
+}
+/** Tmux session name: `mesh-a3f91c` when scope=workspace, else yaml `session.name`. */
+export function resolveSessionName(profile, workspace) {
+    const base = profile.session.name;
+    const scope = profile.session.scope ?? "workspace";
+    if (scope === "global")
+        return base;
+    const len = profile.session.idLength ?? 6;
+    return `${base}-${workspaceScopeId(workspace, len)}`;
+}
+/** Inbox HTTP port — unique per workspace when portScope=workspace. */
+export function resolveDaemonPort(profile, workspace) {
+    const daemon = profile.daemon;
+    const scope = daemon?.portScope ?? "workspace";
+    if (scope === "profile") {
+        return daemon?.port ?? DEFAULT_DAEMON_PORT_BASE;
+    }
+    const base = daemon?.portBase ?? DEFAULT_DAEMON_PORT_BASE;
+    const range = daemon?.portRange ?? DEFAULT_DAEMON_PORT_RANGE;
+    const offset = parseInt(workspaceScopeId(workspace, 8), 16) % range;
+    return base + offset;
+}
+export function resolveDataRoot(profile, workspace) {
+    const rel = profile.data?.root ?? "runtime";
+    const scope = profile.paths?.scope ?? "profile";
+    if (scope === "workspace")
+        return resolveFromWorkspace(workspace, rel);
+    return rel;
+}
+export function meshRuntimePaths(loaded) {
+    const resolved = buildResolvedPaths(loaded);
+    const { dataRoot, daemonDir, sqlitePath, storageBackend } = resolved;
+    return {
+        dataRoot,
+        daemonDir,
+        sqlitePath,
+        storageBackend,
+        inboxJsonl: path.join(daemonDir, "INBOX.jsonl"),
+        peerJsonl: path.join(daemonDir, "PEER.jsonl"),
+        checkbackJsonl: path.join(daemonDir, "CHECKBACK.jsonl"),
+        paneOpsJsonl: path.join(daemonDir, "PANE_OPS.jsonl"),
+        callsJsonl: path.join(daemonDir, "CALLS.jsonl"),
+        meshInboxMeta: path.join(daemonDir, "mesh-inbox.json"),
+        meshInboxStop: path.join(daemonDir, "mesh-inbox.stop"),
+        meshInboxLog: path.join(daemonDir, "mesh-inbox.log"),
+        coldStartState: path.join(daemonDir, "cold-start.json"),
+        ppaState: path.join(daemonDir, "ppa-state.json"),
+        wifiProbeLock: path.join(daemonDir, "cpe-wifi-probe.lock"),
+        minisJson: path.join(dataRoot, "minis.json"),
+        miniDone: path.join(dataRoot, "MINI-DONE.md"),
+        miniManifest: path.join(dataRoot, "mini-manifest.json"),
+        gateQueue: path.join(dataRoot, "GATE-QUEUE.md"),
+    };
+}
+/** Workspace-relative path for agent-visible hints (whoami, checkback). */
+export function runtimePathHint(workspace, absPath) {
+    const rel = path.relative(workspace, absPath);
+    return rel && !rel.startsWith("..") ? rel : absPath;
+}
+/** Resolve hook scripts to absolute paths (profile hooks only — no driver branches). */
+export function resolveConnectivityHooks(profile, workspace) {
+    const conn = profile.connectivity;
+    if (!conn?.enabled)
+        return null;
+    const rel = (p) => {
+        if (!p)
+            return undefined;
+        const abs = resolveFromWorkspace(workspace, p);
+        return fs.existsSync(abs) ? abs : abs;
+    };
+    const hooks = conn.hooks;
+    if (!hooks?.up && !hooks?.rotate && !hooks?.smartRestart && !hooks?.status) {
+        return null;
+    }
+    return {
+        status: rel(hooks.status),
+        up: rel(hooks.up),
+        rotate: rel(hooks.rotate),
+        smartRestart: rel(hooks.smartRestart),
+    };
+}
+//# sourceMappingURL=runtime-paths.js.map

package/dist/runtime-paths.js.map

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

package/dist/runtime-paths.test.d.ts

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

package/dist/runtime-paths.test.d.ts.map

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

package/dist/runtime-paths.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import path from "node:path";
+import { meshRuntimePaths, resolveDaemonPort, resolveSessionName, workspaceScopeId, } from "./runtime-paths.js";
+function stubProfile(overrides = {}) {
+    return {
+        name: "test",
+        workspace: ".",
+        session: {
+            name: "mesh",
+            scope: "workspace",
+            idLength: 6,
+            workerCount: 4,
+            miniMax: 4,
+        },
+        seats: { root: "seats", templates: ["FOCUS"], dirs: {} },
+        state: { agentsJson: "a.json", meshAgentsJson: "m.json" },
+        roles: { dir: "roles" },
+        providers: ["empty"],
+        ...overrides,
+    };
+}
+function stubLoaded(workspace, profile = stubProfile()) {
+    const workspaceId = workspaceScopeId(workspace);
+    return {
+        profile,
+        profileDir: "/tmp/profile",
+        profilePath: "/tmp/profile/mesh.config.yaml",
+        workspace,
+        workspaceId,
+        sessionName: resolveSessionName(profile, workspace),
+    };
+}
+describe("workspaceScopeId", () => {
+    it("is stable for the same path", () => {
+        const ws = "/tmp/my-project";
+        expect(workspaceScopeId(ws)).toBe(workspaceScopeId(ws));
+    });
+    it("differs across projects", () => {
+        expect(workspaceScopeId("/tmp/a")).not.toBe(workspaceScopeId("/tmp/b"));
+    });
+});
+describe("resolveSessionName", () => {
+    it("suffixes workspace hash by default", () => {
+        const ws = "/tmp/my-project";
+        const name = resolveSessionName(stubProfile(), ws);
+        expect(name).toMatch(/^mesh-[a-f0-9]{6}$/);
+        expect(name).toBe(`mesh-${workspaceScopeId(ws)}`);
+    });
+    it("returns base name when scope global", () => {
+        const p = stubProfile({ session: { ...stubProfile().session, scope: "global" } });
+        expect(resolveSessionName(p, "/tmp/x")).toBe("mesh");
+    });
+});
+describe("resolveDaemonPort", () => {
+    it("offsets port per workspace by default", () => {
+        const p = stubProfile();
+        const portA = resolveDaemonPort(p, "/tmp/project-a");
+        const portB = resolveDaemonPort(p, "/tmp/project-b");
+        expect(portA).toBeGreaterThanOrEqual(31670);
+        expect(portA).toBeLessThan(31670 + 90);
+        expect(portA).not.toBe(portB);
+    });
+    it("uses fixed port when portScope profile", () => {
+        const p = stubProfile({
+            daemon: { port: 3200, portScope: "profile" },
+        });
+        expect(resolveDaemonPort(p, "/tmp/a")).toBe(3200);
+        expect(resolveDaemonPort(p, "/tmp/b")).toBe(3200);
+    });
+});
+describe("meshRuntimePaths", () => {
+    it("places daemon under profileDir data.root when scope=profile", () => {
+        const profile = stubProfile({
+            paths: { scope: "profile" },
+            data: { root: "runtime" },
+        });
+        const loaded = stubLoaded("/tmp/ws", profile);
+        loaded.profileDir = "/tmp/profile";
+        const rt = meshRuntimePaths(loaded);
+        expect(rt.daemonDir).toBe(path.join("/tmp/profile", "runtime", "daemon"));
+        expect(rt.sqlitePath).toBe(path.join("/tmp/profile", "runtime", "mesh.sqlite"));
+        expect(rt.storageBackend).toBe("sqlite");
+        expect(rt.minisJson).toBe(path.join("/tmp/profile", "runtime", "minis.json"));
+    });
+});
+//# sourceMappingURL=runtime-paths.test.js.map

package/dist/runtime-paths.test.js.map

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