@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/guarded-command-executor.js

@@ -0,0 +1,229 @@
+import { HookEventPlanSchema } from "./event-contract.js";
+import { HookExecutionContextError } from "../../application/ports/hook-execution-context.js";
+import { HOOK_MAX_CONCURRENCY, HOOK_MAX_SELECTED_HANDLERS, HOOK_STDIN_MAX_BYTES, HOOK_STDOUT_MAX_BYTES, HOOK_STDERR_MAX_BYTES, } from "../../domain/hook-runtime-limits.js";
+import { CurrentProjectRuntimeContextSchema } from "../../application/ports/project-trust.js";
+import { parseHookHandlerOutput } from "./hook-output-parser.js";
+import { createHookRuntimeDiagnostic } from "./hook-runtime-diagnostic.js";
+import { resolveHookLaunch } from "./hook-launch-contract.js";
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === "object") {
+        const record = value;
+        return Object.fromEntries(Object.keys(record).sort().map((key) => [key, canonicalize(record[key])]));
+    }
+    return value;
+}
+function encodeInput(input) {
+    const value = new TextEncoder().encode(`${JSON.stringify(canonicalize(input))}\n`);
+    if (value.byteLength > HOOK_STDIN_MAX_BYTES)
+        throw new Error("hook input exceeds bound");
+    return value;
+}
+function bytes(value) {
+    return (async function* () { yield value; })();
+}
+function bindingOf(hook) {
+    return {
+        scope: hook.scope,
+        plugin: hook.plugin,
+        revision: hook.revision,
+        projectionDigest: hook.projectionDigest,
+        contributionDigest: hook.contributionDigest,
+        componentId: hook.component.id,
+        sourceOrder: hook.sourceOrder,
+    };
+}
+function dedupeKey(binding) {
+    return `${JSON.stringify(binding.scope)}\0${binding.plugin}\0${binding.revision}\0${binding.componentId}`;
+}
+function combineSignals(...signals) {
+    const valid = signals.filter((signal) => signal !== undefined);
+    if (valid.length === 1)
+        return valid[0];
+    return AbortSignal.any(valid);
+}
+function failureCode(error) {
+    if (error instanceof HookExecutionContextError) {
+        if (error.code === "CONFIGURATION_FAILED")
+            return { code: "HOOK_CONFIGURATION_FAILED" };
+        // The context rejection carries the exact cause (ACTIVE_BINDING_UNAVAILABLE,
+        // BINDING_MISMATCH, CURRENT_PROJECT_MISMATCH, INVALID_REQUEST); collapsing
+        // it away made startup races and stale bindings indistinguishable.
+        return { code: "HOOK_AUTHORITY_REJECTED", detail: error.code };
+    }
+    if (error !== null && typeof error === "object" && "code" in error) {
+        const code = error.code;
+        if (code === "TIMEOUT")
+            return { code: "HOOK_TIMEOUT" };
+        if (code === "OUTPUT_LIMIT")
+            return { code: "HOOK_OUTPUT_LIMIT" };
+        if (code === "CANCELLED")
+            return { code: "HOOK_CANCELLED" };
+        if (code === "SPAWN_FAILED" || code === "PIPE_FAILED" || code === "STDIN_FAILED" || code === "NULL_EXIT")
+            return { code: "HOOK_SPAWN_FAILED" };
+    }
+    if (error !== null && typeof error === "object" && "name" in error && error.name === "AbortError")
+        return { code: "HOOK_CANCELLED" };
+    return { code: "HOOK_EXECUTABLE_UNAVAILABLE" };
+}
+function isAbort(error, signal) {
+    return signal.aborted || (error !== null && typeof error === "object" && "name" in error && error.name === "AbortError");
+}
+function shellExecutable(handler) {
+    if (handler.kind !== "shell")
+        throw new Error("exec handler cannot select a shell");
+    const shell = handler.shell ?? "bash";
+    return shell === "powershell" ? (process.platform === "win32" ? "powershell.exe" : "pwsh") : (process.platform === "win32" ? "bash.exe" : "bash");
+}
+export function createGuardedCommandHookExecutor(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object" ||
+        dependencies.context === undefined || dependencies.command === undefined || dependencies.executables === undefined) {
+        throw new TypeError("guarded hook executor dependencies are required");
+    }
+    async function execute(planInput, invocation) {
+        let plan;
+        let currentProject;
+        try {
+            plan = HookEventPlanSchema.parse(planInput);
+            currentProject = CurrentProjectRuntimeContextSchema.parse(invocation.currentProject);
+            if (plan.event !== plan.input.hook_event_name)
+                throw new Error("plan event does not match input");
+        }
+        catch {
+            const first = planInput?.hooks?.[0];
+            if (first === undefined)
+                return { kind: "failed", diagnostics: [] };
+            const binding = bindingOf(first);
+            return { kind: "failed", diagnostics: [createHookRuntimeDiagnostic(binding, planInput.event, "HOOK_INVALID_PLAN")] };
+        }
+        if (plan.hooks.length > HOOK_MAX_SELECTED_HANDLERS) {
+            const first = plan.hooks[0];
+            if (first === undefined)
+                return { kind: "failed", diagnostics: [] };
+            return { kind: "failed", diagnostics: [createHookRuntimeDiagnostic(bindingOf(first), plan.event, "HOOK_SELECTED_LIMIT")] };
+        }
+        if (plan.cancellation.kind === "available" && plan.cancellation.abortedAtPlanning) {
+            const first = plan.hooks[0];
+            if (first === undefined)
+                return { kind: "cancelled", diagnostics: [] };
+            return { kind: "cancelled", diagnostics: [createHookRuntimeDiagnostic(bindingOf(first), plan.event, "HOOK_CANCELLED")] };
+        }
+        if (invocation.runtimeSignal.aborted) {
+            const first = plan.hooks[0];
+            if (first === undefined)
+                return { kind: "cancelled", diagnostics: [] };
+            return { kind: "cancelled", diagnostics: [createHookRuntimeDiagnostic(bindingOf(first), plan.event, "HOOK_CANCELLED")] };
+        }
+        const ordered = [...plan.hooks].sort((left, right) => left.sourceOrder.snapshotOrdinal - right.sourceOrder.snapshotOrdinal || left.sourceOrder.hookOrdinal - right.sourceOrder.hookOrdinal);
+        const unique = [];
+        const seen = new Set();
+        for (const hook of ordered) {
+            const key = dedupeKey(bindingOf(hook));
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push(hook);
+            }
+        }
+        if (unique.length === 0)
+            return { kind: "completed", handlers: Object.freeze([]) };
+        let stdin;
+        try {
+            stdin = encodeInput(plan.input);
+        }
+        catch {
+            const first = unique[0];
+            return { kind: "failed", diagnostics: [createHookRuntimeDiagnostic(bindingOf(first), plan.event, "HOOK_INVALID_PLAN")] };
+        }
+        const outcomes = new Array(unique.length);
+        const callerSignal = plan.cancellation.kind === "available"
+            ? combineSignals(plan.cancellation.signal, invocation.runtimeSignal)
+            : invocation.runtimeSignal;
+        let next = 0;
+        let cancelled = false;
+        async function work() {
+            while (true) {
+                const index = next++;
+                const hook = unique[index];
+                if (hook === undefined)
+                    return;
+                const binding = bindingOf(hook);
+                try {
+                    if (callerSignal.aborted) {
+                        cancelled = true;
+                        outcomes[index] = createHookRuntimeDiagnostic(binding, plan.event, "HOOK_CANCELLED");
+                        continue;
+                    }
+                    await dependencies.context.withContext({
+                        binding,
+                        sessionCwd: plan.input.cwd,
+                        plannedPluginRoot: hook.pluginRoot,
+                        plannedPluginDataRoot: hook.pluginDataRoot,
+                        currentProject,
+                    }, callerSignal, async (context) => {
+                        const paths = {
+                            CLAUDE_PLUGIN_ROOT: context.pluginRoot,
+                            PLUGIN_ROOT: context.pluginRoot,
+                            CLAUDE_PLUGIN_DATA: context.pluginDataRoot,
+                            PLUGIN_DATA: context.pluginDataRoot,
+                            CLAUDE_PROJECT_DIR: context.projectRoot,
+                        };
+                        const environment = {
+                            ...paths,
+                            ...context.configuration.environment(),
+                        };
+                        const launch = resolveHookLaunch(hook.component.handler.value, {
+                            paths,
+                            configuration: context.configuration,
+                            shellForm: hook.component.handler.value.kind === "shell",
+                        }, environment);
+                        const command = launch.kind === "shell" ? shellExecutable(hook.component.handler.value) : launch.command;
+                        const executable = await dependencies.executables.resolve({
+                            command,
+                            cwd: context.cwd,
+                            environment: { inherit: "host", values: launch.environment },
+                        }, callerSignal);
+                        const args = launch.kind === "shell"
+                            ? launch.shell === "powershell"
+                                ? ["-NoLogo", "-NoProfile", "-NonInteractive", "-Command", launch.command]
+                                : ["-c", launch.command]
+                            : [...launch.args];
+                        const result = await dependencies.command.run({
+                            executable: executable.executable,
+                            args,
+                            cwd: context.cwd,
+                            environment: { inherit: "host", values: launch.environment },
+                            stdin: bytes(stdin),
+                            timeoutMs: launch.timeoutMs,
+                            capture: {
+                                stdout: { mode: "capture", maxBytes: HOOK_STDOUT_MAX_BYTES, overflow: "error" },
+                                stderr: { maxBytes: HOOK_STDERR_MAX_BYTES, overflow: "error" },
+                            },
+                        }, callerSignal);
+                        const execution = {
+                            binding,
+                            exitCode: result.exitCode,
+                            stdout: result.stdout instanceof Uint8Array ? result.stdout : new Uint8Array(),
+                            stderr: result.stderr,
+                            stderrTruncated: result.stderrTruncated,
+                        };
+                        outcomes[index] = parseHookHandlerOutput({ event: plan.event, execution, redact: (text) => context.configuration.redact(text) });
+                    });
+                }
+                catch (error) {
+                    if (isAbort(error, callerSignal))
+                        cancelled = true;
+                    const failure = isAbort(error, callerSignal) ? { code: "HOOK_CANCELLED" } : failureCode(error);
+                    outcomes[index] = createHookRuntimeDiagnostic(binding, plan.event, failure.code, "error", failure.detail);
+                }
+            }
+        }
+        await Promise.all(Array.from({ length: Math.min(HOOK_MAX_CONCURRENCY, unique.length) }, () => work()));
+        const complete = outcomes.filter((value) => value !== undefined);
+        if (cancelled)
+            return { kind: "cancelled", diagnostics: complete.filter((value) => "code" in value) };
+        return { kind: "completed", handlers: Object.freeze(complete) };
+    }
+    return Object.freeze({ execute });
+}
+//# sourceMappingURL=guarded-command-executor.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/guarded-command-executor.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-decision-aggregator.d.ts

@@ -0,0 +1,15 @@
+import type { AggregatedHookDecision, ParsedHookDecision } from "../../domain/hook-output-contract.js";
+import type { ForeignHookInput } from "./event-contract.js";
+import { type HookRuntimeDiagnostic } from "./hook-runtime-diagnostic.js";
+/**
+ * Fold source-ordered, callback-sanitized decisions. One broken hook no
+ * longer discards the explicit decisions of healthy hooks: diagnostics ride
+ * alongside the folded result so callers can warn and log while still
+ * honoring real block/permission/context decisions. The aggregate-limit
+ * collapse below remains total because partial output cannot be trusted.
+ */
+export declare function aggregateHookDecisions(input: Readonly<{
+    event: AggregatedHookDecision["event"];
+    originalInput: ForeignHookInput;
+    decisions: readonly (ParsedHookDecision | HookRuntimeDiagnostic)[];
+}>): AggregatedHookDecision;

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-decision-aggregator.js

@@ -0,0 +1,123 @@
+import { HOOK_MAX_AGGREGATED_TEXT_BYTES } from "../../domain/hook-runtime-limits.js";
+import { createHookRuntimeDiagnostic } from "./hook-runtime-diagnostic.js";
+function isDiagnostic(value) {
+    return "code" in value;
+}
+function sourceOrder(value) {
+    const order = isDiagnostic(value) ? value.sourceOrder : value.binding.sourceOrder;
+    return `${order.snapshotOrdinal.toString().padStart(12, "0")}\0${order.hookOrdinal.toString().padStart(12, "0")}`;
+}
+function utf8Bytes(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).byteLength;
+}
+function deepFreeze(value, seen = new WeakSet()) {
+    if (value === null || typeof value !== "object" || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value))
+        deepFreeze(child, seen);
+    Object.freeze(value);
+    return value;
+}
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function empty(event, diagnostics = []) {
+    return Object.freeze({
+        event,
+        contexts: Object.freeze([]),
+        systemMessages: Object.freeze([]),
+        diagnostics: Object.freeze([...diagnostics]),
+    });
+}
+/**
+ * Fold source-ordered, callback-sanitized decisions. One broken hook no
+ * longer discards the explicit decisions of healthy hooks: diagnostics ride
+ * alongside the folded result so callers can warn and log while still
+ * honoring real block/permission/context decisions. The aggregate-limit
+ * collapse below remains total because partial output cannot be trusted.
+ */
+export function aggregateHookDecisions(input) {
+    const ordered = [...input.decisions].sort((left, right) => sourceOrder(left).localeCompare(sourceOrder(right)));
+    const diagnostics = ordered.filter(isDiagnostic);
+    const contexts = [];
+    const systemMessages = [];
+    let textBytes = 0;
+    let block;
+    let permission;
+    let updatedInput;
+    let updatedToolOutput;
+    let hasToolOutput = false;
+    let stop;
+    let title;
+    let continuation;
+    const decisions = ordered.filter((value) => !isDiagnostic(value));
+    for (const decision of decisions) {
+        for (const context of decision.contexts) {
+            contexts.push(context);
+            textBytes += new TextEncoder().encode(context).byteLength;
+        }
+        for (const message of decision.systemMessages) {
+            systemMessages.push(message);
+            textBytes += new TextEncoder().encode(message).byteLength;
+        }
+        if (textBytes > HOOK_MAX_AGGREGATED_TEXT_BYTES) {
+            const source = ordered[0];
+            if (source === undefined || isDiagnostic(source))
+                return empty(input.event);
+            return empty(input.event, [createHookRuntimeDiagnostic(source.binding, input.event, "HOOK_AGGREGATE_LIMIT")]);
+        }
+        if (block === undefined && decision.block !== undefined)
+            block = decision.block;
+        if (decision.permission !== undefined) {
+            if (permission === undefined)
+                permission = decision.permission;
+            else if (permission.kind !== "deny" && decision.permission.kind === "deny")
+                permission = decision.permission;
+            else if (permission.kind === "allow" && decision.permission.kind === "ask")
+                permission = decision.permission;
+        }
+        if (decision.updatedInput !== undefined) {
+            updatedInput ??= input.originalInput.hook_event_name === "PreToolUse" ? cloneJson(input.originalInput.tool_input) : {};
+            const patch = updatedInput;
+            for (const [key, value] of Object.entries(decision.updatedInput))
+                patch[key] = cloneJson(value);
+        }
+        if (decision.updatedToolOutput !== undefined) {
+            updatedToolOutput = deepFreeze(cloneJson(decision.updatedToolOutput));
+            hasToolOutput = true;
+        }
+        if (decision.stop !== undefined)
+            stop = decision.stop;
+        if (decision.title !== undefined)
+            title = decision.title;
+        if (decision.continuation !== undefined)
+            continuation = decision.continuation;
+    }
+    if (updatedInput !== undefined && utf8Bytes(updatedInput) > HOOK_MAX_AGGREGATED_TEXT_BYTES) {
+        const source = ordered[0];
+        if (source === undefined || isDiagnostic(source))
+            return empty(input.event);
+        return empty(input.event, [createHookRuntimeDiagnostic(source.binding, input.event, "HOOK_AGGREGATE_LIMIT")]);
+    }
+    if (hasToolOutput && updatedToolOutput !== undefined && utf8Bytes(updatedToolOutput) > HOOK_MAX_AGGREGATED_TEXT_BYTES) {
+        const source = ordered[0];
+        if (source === undefined || isDiagnostic(source))
+            return empty(input.event);
+        return empty(input.event, [createHookRuntimeDiagnostic(source.binding, input.event, "HOOK_AGGREGATE_LIMIT")]);
+    }
+    return Object.freeze({
+        event: input.event,
+        contexts: Object.freeze([...contexts]),
+        systemMessages: Object.freeze([...systemMessages]),
+        ...(block === undefined ? {} : { block }),
+        ...(permission === undefined ? {} : { permission }),
+        ...(updatedInput === undefined ? {} : { updatedInput: deepFreeze(updatedInput) }),
+        ...(hasToolOutput && updatedToolOutput !== undefined ? { updatedToolOutput } : {}),
+        ...(stop === undefined ? {} : { stop }),
+        ...(title === undefined ? {} : { title }),
+        ...(continuation === undefined ? {} : { continuation }),
+        diagnostics: Object.freeze([...diagnostics]),
+    });
+}
+//# sourceMappingURL=hook-decision-aggregator.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-decision-aggregator.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-event-planner.d.ts

@@ -0,0 +1,13 @@
+import { type HookToolAliasDefinition } from "../../domain/hook-runtime-contract.js";
+import type { SkillHookRuntimeCatalog } from "../skill-hook/runtime-catalog.js";
+import { type HookPlanningResult } from "./event-contract.js";
+import { type HookBoundaryRequest } from "./event-input.js";
+import type { SubagentHookEvent } from "../../domain/hook-runtime-contract.js";
+export interface SubagentHookEventPlanner {
+    plan(request: HookBoundaryRequest): HookPlanningResult;
+    hasMatchingSubagentHooks(event: SubagentHookEvent, agentType: string): boolean;
+}
+export declare function createHookEventPlanner(input: Readonly<{
+    catalog: SkillHookRuntimeCatalog;
+    additionalToolAliases?: readonly HookToolAliasDefinition[];
+}>): SubagentHookEventPlanner;