@plurnk/plurnk-hooks 1.5.0

package/.env.defaults

@@ -0,0 +1,11 @@
+# --- @plurnk/plurnk-hooks : exact command lifecycle hooks ---
+
+# Hooks are disabled until both an exact executable and explicit event selection
+# are configured. Arguments are a JSON array; no shell command is interpreted.
+# PLURNK_HOOKS_COMMAND=/usr/bin/node
+# PLURNK_HOOKS_ARGS=["/absolute/path/to/plurnk-hook.mjs"]
+# PLURNK_HOOKS_EVENTS=loop/terminated,loop/proposal,notice/event
+
+# One hook process receives one event envelope on stdin. This positive integer
+# bounds each delivery; expiry terminates that process without affecting the loop.
+PLURNK_HOOKS_TIMEOUT_MS=30000

package/README.md

@@ -0,0 +1,66 @@
+# @plurnk/plurnk-hooks
+
+First-party local command hooks for
+[Plurnk](https://github.com/plurnk/plurnk-service). The module selects existing
+core lifecycle events and delivers each unchanged event envelope to one exact
+executable on stdin. It does not define another event bus or invoke a shell.
+
+## Configure
+
+Put the following in `~/.plurnk/.env`:
+
+```dotenv
+PLURNK_HOOKS_COMMAND=/usr/bin/node
+PLURNK_HOOKS_ARGS=["/absolute/path/to/plurnk-hook.mjs"]
+PLURNK_HOOKS_EVENTS=loop/terminated,loop/proposal,notice/event
+```
+
+`PLURNK_HOOKS_ARGS` is a JSON string array. `PLURNK_HOOKS_EVENTS` is an
+explicit comma-separated selection from:
+
+```text
+log/entry
+loop/proposal
+loop/terminated
+notice/event
+stream/concluded
+stream/event
+workspace/branch-batch
+workspace/created
+```
+
+Each process receives one line such as:
+
+```json
+{"workspaceId":42,"method":"loop/terminated","params":{"workerId":7,"loopId":9,"result":{"status":200}}}
+```
+
+Workspace scope and event-owned worker/loop coordinates are passed through;
+the module does not infer missing coordinates. Standard output and error are
+inherited from the daemon. A spawn, stdin, nonzero-exit, signal, or timeout
+failure is reported to daemon diagnostics without changing loop control flow.
+Event payloads retain the core contract and may contain project or model
+content; treat the command and any downstream sink as trusted.
+
+## Test one hook
+
+Save this as the script path named in `PLURNK_HOOKS_ARGS`:
+
+```js
+let input = "";
+process.stdin.setEncoding("utf8");
+for await (const chunk of process.stdin) input += chunk;
+const event = JSON.parse(input);
+process.stdout.write(`${event.method} workspace=${String(event.workspaceId)}\n`);
+```
+
+Test it before restarting the daemon:
+
+```sh
+printf '%s\n' '{"workspaceId":42,"method":"loop/terminated","params":{}}' \
+  | /usr/bin/node /absolute/path/to/plurnk-hook.mjs
+```
+
+The complete contract and event-to-core mapping live in
+[`SPEC.md`](./SPEC.md). Portable defaults live in
+[`.env.defaults`](./.env.defaults).

package/SPEC.md

@@ -0,0 +1,48 @@
+# Plurnk command hooks specification
+
+## §hooks-command-delivery Exact command delivery
+
+One selected core event starts one configured executable with its configured
+argument array and `shell: false`. The child receives one complete
+`{ workspaceId, method, params }` JSON envelope followed by a newline on stdin.
+The core-supplied workspace scope and payload pass through without inferred
+coordinates or payload translation. The child inherits the daemon's working
+directory and environment; its standard output and error remain visible in the
+daemon's streams.
+
+## §hooks-selection Event selection
+
+`PLURNK_HOOKS_EVENTS` is a comma-separated set from the following closed
+inventory. These are core event names, not a hook-local vocabulary or filter
+language.
+
+| Exposed event | Owning core notification |
+|---|---|
+| `log/entry` | `{§notifications-log-entry-notify}` |
+| `loop/proposal` | `{§notifications-loop-proposal}` |
+| `loop/terminated` | `{§notifications-loop-terminated}` |
+| `notice/event` | `{§notifications-notice-event}` |
+| `stream/concluded` | `{§notifications-stream-concluded}` |
+| `stream/event` | `{§notifications-stream-event-on-channel-change}` |
+| `workspace/branch-batch` | `{§notifications-workspace-branch-batch}` |
+| `workspace/created` | `{§notifications-workspace-created}` |
+
+## §hooks-failure-isolation Failure isolation
+
+Configuration errors fail module construction. Delivery runs outside the core
+subscriber call. Spawn, stdin, nonzero-exit, signal, and timeout failures are
+reported to daemon diagnostics and cannot alter loop state or event dispatch.
+Module close first unsubscribes, then settles admitted deliveries; the required
+positive timeout bounds each child process.
+
+## §hooks-config Operator configuration
+
+| Variable | Contract |
+|---|---|
+| `PLURNK_HOOKS_COMMAND` | One executable; absent disables hooks |
+| `PLURNK_HOOKS_ARGS` | Optional JSON string array; invalid JSON or non-string members fail startup |
+| `PLURNK_HOOKS_EVENTS` | Required with a command; explicit comma-separated names from {§hooks-selection} |
+| `PLURNK_HOOKS_TIMEOUT_MS` | Required positive integer delivery bound |
+
+Arguments or events without a command, unknown or duplicate event names,
+shell-shaped command text, and malformed timeouts fail at this module boundary.

package/dist/Module.d.ts

@@ -0,0 +1,16 @@
+interface HooksSeam {
+    subscribeToEvents(handler: (workspaceId: number | null, method: string, params: unknown) => void): () => void;
+}
+export interface ModuleOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly report?: (message: string, cause: unknown) => void;
+}
+export default class Module {
+    #private;
+    static init(options?: ModuleOptions): Module;
+    private constructor();
+    start(seam: HooksSeam): void;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=Module.d.ts.map

package/dist/Module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AAGA,UAAU,SAAS;IACf,iBAAiB,CACb,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAC/E,MAAM,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IAOvB,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAK/C;IAED,OAAO,eAGN;IAED,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAkB3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;CAyBJ"}

package/dist/Module.js

@@ -0,0 +1,69 @@
+import { spawn } from "node:child_process";
+import { hookConfig } from "./config.js";
+export default class Module {
+    #config;
+    #report;
+    #active = new Set();
+    #unsubscribe = null;
+    #started = false;
+    static init(options = {}) {
+        return new Module(hookConfig(options.env ?? process.env), options.report ?? ((message, cause) => { console.error(`${message}:`, cause); }));
+    }
+    constructor(config, report) {
+        this.#config = config;
+        this.#report = report;
+    }
+    start(seam) {
+        if (this.#started)
+            throw new Error("hooks module already started");
+        this.#started = true;
+        if (this.#config === null)
+            return;
+        this.#unsubscribe = seam.subscribeToEvents((workspaceId, method, params) => {
+            if (!this.#config?.events.has(method))
+                return;
+            let observed;
+            observed = this.#deliver({ workspaceId, method, params })
+                .catch((cause) => {
+                try {
+                    this.#report(`hook command failed for ${method}`, cause);
+                }
+                catch (reportCause) {
+                    console.error(`hook failure reporter failed for ${method}:`, reportCause);
+                }
+            })
+                .finally(() => { this.#active.delete(observed); });
+            this.#active.add(observed);
+        });
+    }
+    async close() {
+        this.#unsubscribe?.();
+        this.#unsubscribe = null;
+        await Promise.all(this.#active);
+    }
+    #deliver(envelope) {
+        const config = this.#config;
+        if (config === null)
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            const child = spawn(config.command, config.args, {
+                shell: false,
+                stdio: ["pipe", "inherit", "inherit"],
+                signal: AbortSignal.timeout(config.timeoutMs),
+                killSignal: "SIGKILL",
+            });
+            child.once("error", reject);
+            child.once("close", (code, signal) => {
+                if (code === 0)
+                    resolve();
+                else
+                    reject(new Error(signal === null
+                        ? `hook command exited with status ${String(code)}`
+                        : `hook command exited on ${signal}`));
+            });
+            child.stdin.once("error", reject);
+            child.stdin.end(`${JSON.stringify(envelope)}\n`, "utf8");
+        });
+    }
+}
+//# sourceMappingURL=Module.js.map

package/dist/Module.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export declare const HOOK_EVENTS: readonly ["log/entry", "loop/proposal", "loop/terminated", "notice/event", "stream/concluded", "stream/event", "workspace/branch-batch", "workspace/created"];
+export type HookEvent = typeof HOOK_EVENTS[number];
+export interface HookConfig {
+    readonly command: string;
+    readonly args: string[];
+    readonly events: ReadonlySet<HookEvent>;
+    readonly timeoutMs: number;
+}
+export declare const hookConfig: (environment?: NodeJS.ProcessEnv) => HookConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,YACpB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,CACb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAwCD,eAAO,MAAM,UAAU,iBAAiB,MAAM,CAAC,UAAU,KAAiB,UAAU,GAAG,IAqBtF,CAAC"}

package/dist/config.js

@@ -0,0 +1,69 @@
+export const HOOK_EVENTS = [
+    "log/entry",
+    "loop/proposal",
+    "loop/terminated",
+    "notice/event",
+    "stream/concluded",
+    "stream/event",
+    "workspace/branch-batch",
+    "workspace/created",
+];
+const hookArgs = (raw) => {
+    if (raw === undefined || raw.length === 0)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new Error("PLURNK_HOOKS_ARGS must be a JSON array of strings.", { cause });
+    }
+    if (!Array.isArray(parsed) || !parsed.every((value) => typeof value === "string")) {
+        throw new Error("PLURNK_HOOKS_ARGS must be a JSON array of strings.");
+    }
+    return parsed;
+};
+const hookEvents = (raw) => {
+    if (raw === undefined || raw.trim().length === 0) {
+        throw new Error("PLURNK_HOOKS_EVENTS must select at least one event.");
+    }
+    const known = new Set(HOOK_EVENTS);
+    const selected = new Set();
+    for (const event of raw.split(",").map((value) => value.trim())) {
+        if (!known.has(event))
+            throw new Error(`PLURNK_HOOKS_EVENTS names unknown core event '${event}'.`);
+        if (selected.has(event)) {
+            throw new Error(`PLURNK_HOOKS_EVENTS selects '${event}' more than once.`);
+        }
+        selected.add(event);
+    }
+    return selected;
+};
+const hookTimeoutMs = (raw) => {
+    const timeoutMs = Number(raw);
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1) {
+        throw new Error(`PLURNK_HOOKS_TIMEOUT_MS must be a positive integer; got ${JSON.stringify(raw)}.`);
+    }
+    return timeoutMs;
+};
+export const hookConfig = (environment = process.env) => {
+    const timeoutMs = hookTimeoutMs(environment.PLURNK_HOOKS_TIMEOUT_MS);
+    const command = environment.PLURNK_HOOKS_COMMAND?.trim() ?? "";
+    if (command.length === 0) {
+        if ((environment.PLURNK_HOOKS_ARGS?.length ?? 0) > 0
+            || (environment.PLURNK_HOOKS_EVENTS?.length ?? 0) > 0) {
+            throw new Error("PLURNK_HOOKS configuration has companions but no PLURNK_HOOKS_COMMAND.");
+        }
+        return null;
+    }
+    if (/\s/.test(command)) {
+        throw new Error("PLURNK_HOOKS_COMMAND must contain one executable; put arguments in PLURNK_HOOKS_ARGS.");
+    }
+    return {
+        command,
+        args: hookArgs(environment.PLURNK_HOOKS_ARGS),
+        events: hookEvents(environment.PLURNK_HOOKS_EVENTS),
+        timeoutMs,
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { default as Module } from "./Module.ts";
+export { default } from "./Module.ts";
+export type { ModuleOptions } from "./Module.ts";
+export { hookConfig, HOOK_EVENTS } from "./config.ts";
+export type { HookConfig, HookEvent } from "./config.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { default as Module } from "./Module.js";
+export { default } from "./Module.js";
+export { hookConfig, HOOK_EVENTS } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@plurnk/plurnk-hooks",
+    "version": "1.5.0",
+    "description": "Deliver selected Plurnk lifecycle events to exact local commands.",
+    "keywords": [
+        "plurnk",
+        "hooks",
+        "notifications",
+        "automation"
+    ],
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-hooks#readme",
+    "bugs": {
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-hooks"
+    },
+    "engines": {
+        "node": ">=26"
+    },
+    "license": "MIT",
+    "author": "@wikitopian",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "plurnk-dev": "./src/index.ts",
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "SPEC.md",
+        ".env.defaults"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --conditions=plurnk-dev --test \"src/**/*.test.ts\"",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:clean": "rm -rf dist",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:clean && npm run build:dist",
+        "prepack": "npm run build",
+        "prepublishOnly": "npm audit --audit-level=moderate && npm test"
+    }
+}