@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/runtime/plugin-launch-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-launch-roots.js","sourceRoot":"","sources":["../../src/runtime/plugin-launch-roots.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,EAAE,IAAI;IACxB,WAAW,EAAE,IAAI;IACjB,kBAAkB,EAAE,IAAI;IACxB,WAAW,EAAE,IAAI;IACjB,kBAAkB,EAAE,IAAI;CAChB,CAAC;AAKX,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;AAC/E,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/runtime/published-package-receipt.d.ts

@@ -0,0 +1,35 @@
+export type PublishedPackageReceipt = Readonly<{
+    packageName: string;
+    version: string;
+    registryIntegrity: `sha512-${string}`;
+    installedTreeDigest: `sha256:${string}`;
+    license: "MIT";
+    licenseSha256: string;
+    releaseTag: string;
+    releaseCommit: string;
+    upstreamBaseCommit: string;
+    nodeEngine: string;
+    piPeerRange: string;
+    requiredExports: readonly string[];
+    piExtensions: readonly string[];
+}>;
+export type PublishedPackageProbeResult = Readonly<{
+    kind: "verified";
+    packageRoot: string;
+    entry: string;
+}> | Readonly<{
+    kind: "unavailable";
+    code: "PACKAGE_MISSING" | "PACKAGE_DRIFT";
+}>;
+/**
+ * Hash package-owned installed bytes. npm-created dependency trees are excluded:
+ * their own lock/SRI rows are separate authorities and are not tar entries of
+ * the package being qualified.
+ */
+export declare function digestPublishedPackageTree(packageRoot: string): Promise<`sha256:${string}`>;
+/** Resolve without importing, verify exact installed bytes, then hand the entry to a package-specific loader. */
+export declare function probePublishedPackage(input: Readonly<{
+    entrySpecifier: string;
+    receipt: PublishedPackageReceipt;
+    signal: AbortSignal;
+}>): Promise<PublishedPackageProbeResult>;

package/node_modules/@nklisch/pi-plugins/dist/runtime/published-package-receipt.js

@@ -0,0 +1,180 @@
+import { createHash } from "node:crypto";
+import { constants as fsConstants } from "node:fs";
+import { lstat, open, readFile, readdir, realpath } from "node:fs/promises";
+import { dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+const TREE_GRAMMAR = "pi-plugin-host-published-tree-v1\0";
+const SHA256_HEX = /^[a-f0-9]{64}$/u;
+const COMMIT = /^[a-f0-9]{40}$/u;
+function inside(parent, child) {
+    const path = relative(parent, child);
+    return path === "" || path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path);
+}
+function receiptShape(receipt) {
+    if (receipt === null || typeof receipt !== "object" || receipt.license !== "MIT" ||
+        !SHA256_HEX.test(receipt.licenseSha256) || !COMMIT.test(receipt.releaseCommit) ||
+        !COMMIT.test(receipt.upstreamBaseCommit) || typeof receipt.releaseTag !== "string" ||
+        receipt.releaseTag.length === 0 || !/^sha256:[a-f0-9]{64}$/u.test(receipt.installedTreeDigest) ||
+        !Array.isArray(receipt.requiredExports) || !Array.isArray(receipt.piExtensions))
+        return false;
+    if (!receipt.registryIntegrity.startsWith("sha512-"))
+        return false;
+    const encoded = receipt.registryIntegrity.slice("sha512-".length);
+    try {
+        const bytes = Buffer.from(encoded, "base64");
+        if (bytes.length !== 64 || bytes.toString("base64") !== encoded)
+            return false;
+    }
+    catch {
+        return false;
+    }
+    return [receipt.packageName, receipt.version, receipt.nodeEngine, receipt.piPeerRange]
+        .every((value) => typeof value === "string" && value.length > 0);
+}
+function safeRelativePath(path) {
+    return path.length > 0 && !path.startsWith("/") && !path.includes("\\") && !path.includes("\0") &&
+        path.split("/").every((part) => part.length > 0 && part !== "." && part !== "..");
+}
+/**
+ * Hash package-owned installed bytes. npm-created dependency trees are excluded:
+ * their own lock/SRI rows are separate authorities and are not tar entries of
+ * the package being qualified.
+ */
+export async function digestPublishedPackageTree(packageRoot) {
+    const root = await realpath(packageRoot);
+    const hash = createHash("sha256").update(TREE_GRAMMAR);
+    const entries = [];
+    const canonicalPaths = new Set();
+    async function visit(directory, prefix) {
+        const children = await readdir(directory, { withFileTypes: true });
+        children.sort((left, right) => Buffer.from(left.name).compare(Buffer.from(right.name)));
+        for (const child of children) {
+            // node_modules is installation structure, not a package-owned tar entry.
+            if (prefix === "" && child.name === "node_modules")
+                continue;
+            const relativePath = prefix === "" ? child.name : `${prefix}/${child.name}`;
+            if (!safeRelativePath(relativePath))
+                throw new TypeError("published package path is invalid");
+            const collisionKey = relativePath.normalize("NFC").toLocaleLowerCase("en-US");
+            if (canonicalPaths.has(collisionKey))
+                throw new TypeError("published package path collision detected");
+            canonicalPaths.add(collisionKey);
+            const absolute = join(directory, child.name);
+            const info = await lstat(absolute);
+            if (info.isSymbolicLink())
+                throw new TypeError("published package contains a symbolic link");
+            if (info.isDirectory()) {
+                entries.push({ path: relativePath, kind: "directory", executable: false });
+                await visit(absolute, relativePath);
+                continue;
+            }
+            if (!info.isFile())
+                throw new TypeError("published package contains a special file");
+            const handle = await open(absolute, fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW ?? 0));
+            try {
+                const current = await handle.stat();
+                if (!current.isFile())
+                    throw new TypeError("published package entry changed type during verification");
+                entries.push({
+                    path: relativePath,
+                    kind: "file",
+                    executable: (current.mode & 0o111) !== 0,
+                    bytes: await handle.readFile(),
+                });
+            }
+            finally {
+                await handle.close();
+            }
+        }
+    }
+    await visit(root, "");
+    entries.sort((left, right) => Buffer.from(left.path).compare(Buffer.from(right.path)));
+    for (const entry of entries) {
+        const bytes = entry.bytes ?? Buffer.alloc(0);
+        hash.update(entry.kind).update("\0").update(entry.path).update("\0")
+            .update(entry.executable ? "1" : "0").update("\0")
+            .update(String(bytes.length)).update("\0").update(bytes).update("\0");
+    }
+    return `sha256:${hash.digest("hex")}`;
+}
+async function findPackageRoot(entry, receipt) {
+    let current = dirname(entry);
+    const filesystemRoot = parse(current).root;
+    for (;;) {
+        const manifestPath = join(current, "package.json");
+        try {
+            const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+            if (manifest.name === receipt.packageName)
+                return current;
+        }
+        catch { /* continue toward the filesystem root */ }
+        if (current === filesystemRoot)
+            return undefined;
+        current = dirname(current);
+    }
+}
+function exportPresent(exportsValue, key) {
+    if (key === "." && (typeof exportsValue === "string" || Array.isArray(exportsValue)))
+        return true;
+    return exportsValue !== null && typeof exportsValue === "object" &&
+        Object.prototype.hasOwnProperty.call(exportsValue, key);
+}
+async function verifyManifest(packageRoot, entry, receipt) {
+    const manifest = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8"));
+    const engines = manifest.engines;
+    const peers = manifest.peerDependencies;
+    const pi = manifest.pi;
+    const extensions = pi?.extensions;
+    if (manifest.name !== receipt.packageName || manifest.version !== receipt.version ||
+        manifest.license !== receipt.license || engines?.node !== receipt.nodeEngine ||
+        peers?.["@earendil-works/pi-coding-agent"] !== receipt.piPeerRange ||
+        JSON.stringify(extensions) !== JSON.stringify(receipt.piExtensions) ||
+        receipt.requiredExports.some((key) => !exportPresent(manifest.exports, key)))
+        return false;
+    const root = await realpath(packageRoot);
+    const canonicalEntry = await realpath(entry);
+    if (!inside(root, canonicalEntry))
+        return false;
+    for (const resource of receipt.piExtensions) {
+        if (!resource.startsWith("./") || !safeRelativePath(resource.slice(2)))
+            return false;
+        const resourcePath = resolve(root, resource);
+        if (!inside(root, resourcePath) || !(await lstat(resourcePath)).isFile())
+            return false;
+    }
+    const license = await readFile(join(root, "LICENSE"));
+    if (createHash("sha256").update(license).digest("hex") !== receipt.licenseSha256)
+        return false;
+    return await digestPublishedPackageTree(root) === receipt.installedTreeDigest;
+}
+/** Resolve without importing, verify exact installed bytes, then hand the entry to a package-specific loader. */
+export async function probePublishedPackage(input) {
+    input.signal.throwIfAborted();
+    if (!receiptShape(input.receipt))
+        return Object.freeze({ kind: "unavailable", code: "PACKAGE_DRIFT" });
+    let entry;
+    try {
+        const resolvedEntry = import.meta.resolve(input.entrySpecifier);
+        if (!resolvedEntry.startsWith("file:"))
+            return Object.freeze({ kind: "unavailable", code: "PACKAGE_DRIFT" });
+        entry = fileURLToPath(resolvedEntry);
+    }
+    catch {
+        return Object.freeze({ kind: "unavailable", code: "PACKAGE_MISSING" });
+    }
+    input.signal.throwIfAborted();
+    try {
+        const packageRoot = await findPackageRoot(entry, input.receipt);
+        if (packageRoot === undefined || !await verifyManifest(packageRoot, entry, input.receipt)) {
+            return Object.freeze({ kind: "unavailable", code: "PACKAGE_DRIFT" });
+        }
+        input.signal.throwIfAborted();
+        return Object.freeze({ kind: "verified", packageRoot, entry });
+    }
+    catch {
+        if (input.signal.aborted)
+            throw input.signal.reason;
+        return Object.freeze({ kind: "unavailable", code: "PACKAGE_DRIFT" });
+    }
+}
+//# sourceMappingURL=published-package-receipt.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/published-package-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"published-package-receipt.js","sourceRoot":"","sources":["../../src/runtime/published-package-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAsBzC,MAAM,YAAY,GAAG,oCAAoC,CAAC;AAC1D,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACrC,MAAM,MAAM,GAAG,iBAAiB,CAAC;AAEjC,SAAS,MAAM,CAAC,MAAc,EAAE,KAAa;IAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,OAAgC;IACpD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;QAC5E,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAC9E,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;QAClF,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;QAC9F,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAClG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACnE,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;IACzB,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC;SACnF,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7F,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAmB;IAClE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,OAAO,GAAuG,EAAE,CAAC;IACvH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,KAAK,UAAU,KAAK,CAAC,SAAiB,EAAE,MAAc;QACpD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,yEAAyE;YACzE,IAAI,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAS;YAC7D,MAAM,YAAY,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5E,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;YAC9F,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC9E,IAAI,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;YACvG,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,cAAc,EAAE;gBAAE,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;YAC7F,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC3E,MAAM,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBACpC,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;gBAAE,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,GAAG,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;oBAAE,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;gBACvG,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,MAAM;oBACZ,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;oBACxC,KAAK,EAAE,MAAM,MAAM,CAAC,QAAQ,EAAE;iBAC/B,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;aACjE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;aACjD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,KAAa,EAAE,OAAgC;IAC5E,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IAC3C,SAAS,CAAC;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAA4B,CAAC;YAC7F,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,WAAW;gBAAE,OAAO,OAAO,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC,CAAC,yCAAyC,CAAC,CAAC;QACrD,IAAI,OAAO,KAAK,cAAc;YAAE,OAAO,SAAS,CAAC;QACjD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,YAAqB,EAAE,GAAW;IACvD,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,OAAO,YAAY,KAAK,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ;QAC9D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,WAAmB,EACnB,KAAa,EACb,OAAgC;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;IAClH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA8C,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,gBAAuD,CAAC;IAC/E,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAyC,CAAC;IAC9D,MAAM,UAAU,GAAG,EAAE,EAAE,UAAU,CAAC;IAClC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;QAC7E,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,UAAU;QAC5E,KAAK,EAAE,CAAC,iCAAiC,CAAC,KAAK,OAAO,CAAC,WAAW;QAClE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;QACnE,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/F,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACrF,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,KAAK,CAAC;IACzF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAC/F,OAAO,MAAM,0BAA0B,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,mBAAmB,CAAC;AAChF,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAI1C;IACA,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACvG,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7G,KAAK,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,MAAM,cAAc,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1F,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QACpD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/lifecycle-participant.d.ts

@@ -0,0 +1,30 @@
+import { type ProjectionExpectation } from "../../application/ports/runtime-projection.js";
+import type { Sha256 } from "../../domain/source.js";
+import { type SkillHookRuntimeCatalog, type SkillHookRuntimeSetRequest, type SkillHookReconcileResult } from "./runtime-catalog.js";
+import { type RuntimeProjectionSelection, type SkillHookSnapshotResult } from "./runtime-snapshot.js";
+import { type SkillHookSnapshotObservation } from "../skills/contribution-observation.js";
+export type SkillHookSnapshotObservationResult = Readonly<{
+    kind: "ready";
+    observation: SkillHookSnapshotObservation;
+}> | Readonly<{
+    kind: "failed";
+    code: "CATALOG_UNINITIALIZED" | "OBSERVATION_MISMATCH" | "PROJECT_UNTRUSTED" | "ADAPTER_FAILED";
+}> | Readonly<{
+    kind: "cancelled";
+}>;
+/** The source participant is deliberately not final lifecycle evidence. */
+export interface SkillHookSnapshotParticipant {
+    reconcile(request: SkillHookRuntimeSetRequest, signal: AbortSignal): Promise<SkillHookReconcileResult>;
+    observe(expectation: ProjectionExpectation, signal: AbortSignal): Promise<SkillHookSnapshotObservationResult>;
+}
+export type SkillHookLifecycleParticipant = SkillHookSnapshotParticipant;
+export declare function createSkillHookRuntimeParticipant(dependencies: Readonly<{
+    loader: Readonly<{
+        load(selection: RuntimeProjectionSelection, signal: AbortSignal): Promise<SkillHookSnapshotResult>;
+    }>;
+    sha256: Sha256;
+}>): Readonly<{
+    participant: SkillHookLifecycleParticipant;
+    catalog: SkillHookRuntimeCatalog;
+}>;
+export type { SkillHookRuntimeCatalog, SkillHookRuntimeSetRequest, SkillHookReconcileResult, };

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/lifecycle-participant.js

@@ -0,0 +1,180 @@
+import { ComponentIdSchema, } from "../../domain/components.js";
+import { ProjectionExpectationSchema, } from "../../application/ports/runtime-projection.js";
+import { createSkillHookRuntimeCatalog, hasSameCurrentProject, runtimeTargetKey, } from "./runtime-catalog.js";
+import { CurrentProjectRuntimeContextSchema, digestSkillHookContribution, } from "./runtime-snapshot.js";
+import { SkillHookSnapshotObservationSchema, } from "../skills/contribution-observation.js";
+function abortRequested(signal) {
+    return signal.aborted;
+}
+function compareCodePoint(left, right) {
+    const leftPoints = [...left];
+    const rightPoints = [...right];
+    const length = Math.min(leftPoints.length, rightPoints.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftPoint = leftPoints[index].codePointAt(0);
+        const rightPoint = rightPoints[index].codePointAt(0);
+        if (leftPoint !== rightPoint)
+            return leftPoint < rightPoint ? -1 : 1;
+    }
+    return leftPoints.length - rightPoints.length;
+}
+function snapshotOrder(snapshot) {
+    return runtimeTargetKey(snapshot.scope, snapshot.plugin);
+}
+function componentIds(values) {
+    return Object.freeze(values.map((value) => ComponentIdSchema.parse(value.id)));
+}
+function snapshotCurrentProject(snapshot) {
+    return CurrentProjectRuntimeContextSchema.parse(snapshot.currentProject);
+}
+function failure(code) {
+    return { kind: "failed", code };
+}
+function isProjectEvidenceUsable(snapshot, currentProject) {
+    return snapshot.scope.kind !== "project" ||
+        (snapshot.scope.projectKey === currentProject.projectKey && currentProject.trust.kind === "trusted");
+}
+function sameExpectation(snapshot, expectation) {
+    if (expectation.kind === "active") {
+        return snapshot.scope.kind === expectation.projection.scope.kind &&
+            (snapshot.scope.kind === "user" || expectation.projection.scope.kind === "user" || snapshot.scope.projectKey === expectation.projection.scope.projectKey) &&
+            snapshot.plugin === expectation.projection.plugin &&
+            snapshot.revision === expectation.projection.revision &&
+            snapshot.projectionDigest === expectation.projection.digest &&
+            snapshot.projectionRef === expectation.projectionRef;
+    }
+    return snapshot.scope.kind === expectation.scope.kind &&
+        (snapshot.scope.kind === "user" || expectation.scope.kind === "user" || snapshot.scope.projectKey === expectation.scope.projectKey) &&
+        snapshot.plugin === expectation.plugin;
+}
+export function createSkillHookRuntimeParticipant(dependencies) {
+    if (dependencies === null || typeof dependencies !== "object")
+        throw new TypeError("skill/hook participant dependencies are required");
+    const owned = createSkillHookRuntimeCatalog();
+    async function reconcile(request, signal) {
+        try {
+            if (abortRequested(signal))
+                return { kind: "cancelled" };
+            const currentProject = CurrentProjectRuntimeContextSchema.parse(request.currentProject);
+            const seen = new Set();
+            for (const selection of request.active) {
+                const projection = selection.prepared.projection;
+                const key = runtimeTargetKey(projection.scope, projection.plugin);
+                if (seen.has(key))
+                    return { kind: "failed", code: "TARGET_COLLISION" };
+                seen.add(key);
+            }
+            const loaded = [];
+            for (const selection of request.active) {
+                if (abortRequested(signal))
+                    return { kind: "cancelled" };
+                const result = await dependencies.loader.load(selection, signal);
+                if (result.kind === "cancelled")
+                    return { kind: "cancelled" };
+                if (result.kind !== "ready")
+                    return { kind: "failed", code: "SNAPSHOT_FAILED" };
+                const expected = selection.prepared.projection;
+                if (result.snapshot.scope.kind !== expected.scope.kind ||
+                    (result.snapshot.scope.kind === "project" && expected.scope.kind === "project" && result.snapshot.scope.projectKey !== expected.scope.projectKey) ||
+                    result.snapshot.plugin !== expected.plugin ||
+                    result.snapshot.revision !== expected.revision ||
+                    result.snapshot.projectionDigest !== expected.digest ||
+                    result.snapshot.projectionRef !== selection.prepared.expectation.projectionRef ||
+                    !hasSameCurrentProject(result.snapshot.currentProject, currentProject)) {
+                    return { kind: "failed", code: "SNAPSHOT_FAILED" };
+                }
+                loaded.push(result.snapshot);
+            }
+            if (abortRequested(signal))
+                return { kind: "cancelled" };
+            for (const snapshot of loaded) {
+                if (!isProjectEvidenceUsable(snapshot, currentProject))
+                    return { kind: "failed", code: "SNAPSHOT_FAILED" };
+            }
+            loaded.sort((left, right) => compareCodePoint(snapshotOrder(left), snapshotOrder(right)));
+            // No await occurs after this check. A successful result identifies the
+            // exact context and target set installed by the synchronous publication.
+            if (abortRequested(signal))
+                return { kind: "cancelled" };
+            owned.publish(loaded, currentProject);
+            return { kind: "applied", count: loaded.length };
+        }
+        catch (error) {
+            if (abortRequested(signal) || (error !== null && typeof error === "object" && "name" in error && error.name === "AbortError"))
+                return { kind: "cancelled" };
+            return { kind: "failed", code: "ADAPTER_FAILED" };
+        }
+    }
+    async function observe(expectationInput, signal) {
+        try {
+            if (abortRequested(signal))
+                return { kind: "cancelled" };
+            const expectation = ProjectionExpectationSchema.parse(expectationInput);
+            const state = owned.state();
+            const currentProject = state.currentProject;
+            if (!state.initialized || currentProject === undefined)
+                return failure("CATALOG_UNINITIALIZED");
+            if (expectation.kind === "active") {
+                const snapshot = owned.lookup(expectation.projection.scope, expectation.projection.plugin);
+                if (snapshot === undefined || !sameExpectation(snapshot, expectation) ||
+                    !hasSameCurrentProject(snapshotCurrentProject(snapshot), currentProject) ||
+                    !isProjectEvidenceUsable(snapshot, currentProject)) {
+                    return failure(snapshot?.scope.kind === "project" && currentProject.trust.kind !== "trusted" ? "PROJECT_UNTRUSTED" : "OBSERVATION_MISMATCH");
+                }
+                return {
+                    kind: "ready",
+                    observation: SkillHookSnapshotObservationSchema.parse({
+                        kind: "active",
+                        participant: "skills-hooks-snapshot",
+                        scope: snapshot.scope,
+                        plugin: snapshot.plugin,
+                        revision: snapshot.revision,
+                        projectionDigest: snapshot.projectionDigest,
+                        currentProject,
+                        contributionDigest: snapshot.contributionDigest,
+                        skillComponentIds: componentIds(snapshot.skills),
+                        hookComponentIds: componentIds(snapshot.hooks),
+                    }),
+                };
+            }
+            if (expectation.scope.kind === "project" &&
+                (currentProject.projectKey !== expectation.scope.projectKey || currentProject.trust.kind !== "trusted")) {
+                return failure(currentProject.trust.kind === "trusted" ? "OBSERVATION_MISMATCH" : "PROJECT_UNTRUSTED");
+            }
+            const target = owned.lookup(expectation.scope, expectation.plugin);
+            if (target !== undefined)
+                return failure("OBSERVATION_MISMATCH");
+            const contributionDigest = digestSkillHookContribution({
+                scope: expectation.scope,
+                plugin: expectation.plugin,
+                projectionDigest: expectation.digest,
+                skills: [],
+                hooks: [],
+            }, dependencies.sha256);
+            return {
+                kind: "ready",
+                observation: SkillHookSnapshotObservationSchema.parse({
+                    kind: "inactive",
+                    participant: "skills-hooks-snapshot",
+                    scope: expectation.scope,
+                    plugin: expectation.plugin,
+                    projectionDigest: expectation.digest,
+                    currentProject,
+                    contributionDigest,
+                    skillComponentIds: [],
+                    hookComponentIds: [],
+                }),
+            };
+        }
+        catch (error) {
+            if (abortRequested(signal) || (error !== null && typeof error === "object" && "name" in error && error.name === "AbortError"))
+                return { kind: "cancelled" };
+            if (error instanceof Error && error.name === "ZodError")
+                return failure("OBSERVATION_MISMATCH");
+            return failure("ADAPTER_FAILED");
+        }
+    }
+    const participant = Object.freeze({ reconcile, observe });
+    return Object.freeze({ participant, catalog: owned.catalog });
+}
+//# sourceMappingURL=lifecycle-participant.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/lifecycle-participant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-participant.js","sourceRoot":"","sources":["../../../src/runtime/skill-hook/lifecycle-participant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,2BAA2B,GAE5B,MAAM,+CAA+C,CAAC;AAEvD,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,GAIjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kCAAkC,EAClC,2BAA2B,GAK5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kCAAkC,GAEnC,MAAM,uCAAuC,CAAC;AAe/C,SAAS,cAAc,CAAC,MAAmB;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAAa;IACnD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QACrD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QACvD,IAAI,SAAS,KAAK,UAAU;YAAE,OAAO,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAC,QAAkC;IACvD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,MAAsC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAkC;IAChE,OAAO,kCAAkC,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,OAAO,CAAC,IAA+F;IAC9G,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAkC,EAAE,cAA4C;IAC/G,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;QACtC,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACzG,CAAC;AAED,SAAS,eAAe,CAAC,QAAkC,EAAE,WAAkC;IAC7F,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI;YAC9D,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;YACzJ,QAAQ,CAAC,MAAM,KAAK,WAAW,CAAC,UAAU,CAAC,MAAM;YACjD,QAAQ,CAAC,QAAQ,KAAK,WAAW,CAAC,UAAU,CAAC,QAAQ;YACrD,QAAQ,CAAC,gBAAgB,KAAK,WAAW,CAAC,UAAU,CAAC,MAAM;YAC3D,QAAQ,CAAC,aAAa,KAAK,WAAW,CAAC,aAAa,CAAC;IACzD,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI;QACnD,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;QACnI,QAAQ,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,YAGhD;IAIA,IAAI,YAAY,KAAK,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IACvI,MAAM,KAAK,GAAG,6BAA6B,EAAE,CAAC;IAE9C,KAAK,UAAU,SAAS,CAAC,OAAmC,EAAE,MAAmB;QAC/E,IAAI,CAAC;YACH,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACzD,MAAM,cAAc,GAAG,kCAAkC,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACxF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvC,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACjD,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;gBAClE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;gBACvE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,MAAM,MAAM,GAA+B,EAAE,CAAC;YAC9C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvC,IAAI,cAAc,CAAC,MAAM,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjE,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC9D,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;oBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;gBAChF,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,IAAI;oBAClD,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;oBACjJ,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;oBAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;oBAC9C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,KAAK,QAAQ,CAAC,MAAM;oBACpD,MAAM,CAAC,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa;oBAC9E,CAAC,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC3E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;gBACrD,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACzD,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;gBAC9B,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,cAAc,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;YAC7G,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1F,uEAAuE;YACvE,yEAAyE;YACzE,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACzD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACtC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAK,KAA4B,CAAC,IAAI,KAAK,YAAY,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACpL,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,gBAAuC,EAAE,MAAmB;QACjF,IAAI,CAAC;YACH,IAAI,cAAc,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACzD,MAAM,WAAW,GAAG,2BAA2B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACxE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,cAAc,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,uBAAuB,CAAC,CAAC;YAChG,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC3F,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC;oBACjE,CAAC,qBAAqB,CAAC,sBAAsB,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;oBACxE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBACvD,OAAO,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;gBAC/I,CAAC;gBACD,OAAO;oBACL,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,kCAAkC,CAAC,KAAK,CAAC;wBACpD,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,uBAAuB;wBACpC,KAAK,EAAE,QAAQ,CAAC,KAAK;wBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;wBACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;wBAC3C,cAAc;wBACd,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;wBAC/C,iBAAiB,EAAE,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAChD,gBAAgB,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;qBAC/C,CAAC;iBACH,CAAC;YACJ,CAAC;YACD,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;gBACpC,CAAC,cAAc,CAAC,UAAU,KAAK,WAAW,CAAC,KAAK,CAAC,UAAU,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;gBAC5G,OAAO,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;YACzG,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;YACnE,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,sBAAsB,CAAC,CAAC;YACjE,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;gBACrD,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,gBAAgB,EAAE,WAAW,CAAC,MAAM;gBACpC,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,EAAE;aACV,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YACxB,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,kCAAkC,CAAC,KAAK,CAAC;oBACpD,IAAI,EAAE,UAAU;oBAChB,WAAW,EAAE,uBAAuB;oBACpC,KAAK,EAAE,WAAW,CAAC,KAAK;oBACxB,MAAM,EAAE,WAAW,CAAC,MAAM;oBAC1B,gBAAgB,EAAE,WAAW,CAAC,MAAM;oBACpC,cAAc;oBACd,kBAAkB;oBAClB,iBAAiB,EAAE,EAAE;oBACrB,gBAAgB,EAAE,EAAE;iBACrB,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAK,KAA4B,CAAC,IAAI,KAAK,YAAY,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACpL,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAChG,OAAO,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAkC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACzF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/runtime-catalog.d.ts

@@ -0,0 +1,35 @@
+import { type PluginKey } from "../../domain/identity.js";
+import { type ScopeReference } from "../../domain/state/scope.js";
+import { type CurrentProjectRuntimeContext } from "../../application/ports/project-trust.js";
+import type { SkillHookRuntimeSnapshot } from "./runtime-snapshot.js";
+export type SkillHookRuntimeSetRequest = Readonly<{
+    active: readonly import("./runtime-snapshot.js").RuntimeProjectionSelection[];
+    currentProject: CurrentProjectRuntimeContext;
+}>;
+export type SkillHookReconcileResult = Readonly<{
+    kind: "applied";
+    count: number;
+}> | Readonly<{
+    kind: "failed";
+    code: "TARGET_COLLISION" | "SNAPSHOT_FAILED" | "ADAPTER_FAILED";
+}> | Readonly<{
+    kind: "cancelled";
+}>;
+export interface SkillHookRuntimeCatalog {
+    list(): readonly SkillHookRuntimeSnapshot[];
+    get(scope: ScopeReference, plugin: PluginKey): SkillHookRuntimeSnapshot | undefined;
+    currentProject(): CurrentProjectRuntimeContext | undefined;
+}
+export type RuntimeCatalogState = Readonly<{
+    initialized: boolean;
+    currentProject?: CurrentProjectRuntimeContext;
+}>;
+export type MutableSkillHookRuntimeCatalog = Readonly<{
+    catalog: SkillHookRuntimeCatalog;
+    state(): RuntimeCatalogState;
+    lookup(scope: ScopeReference, plugin: PluginKey): SkillHookRuntimeSnapshot | undefined;
+    publish(snapshots: readonly SkillHookRuntimeSnapshot[], currentProject: CurrentProjectRuntimeContext): void;
+}>;
+export declare function createSkillHookRuntimeCatalog(): MutableSkillHookRuntimeCatalog;
+export declare function hasSameCurrentProject(left: CurrentProjectRuntimeContext, right: CurrentProjectRuntimeContext): boolean;
+export declare function runtimeTargetKey(scope: ScopeReference, plugin: PluginKey): string;

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/runtime-catalog.js

@@ -0,0 +1,72 @@
+import { PluginKeySchema, } from "../../domain/identity.js";
+import { ScopeReferenceSchema, } from "../../domain/state/scope.js";
+import { CurrentProjectRuntimeContextSchema, } from "../../application/ports/project-trust.js";
+function scopeKey(scopeInput) {
+    const scope = ScopeReferenceSchema.parse(scopeInput);
+    return scope.kind === "user" ? "user" : `project:${scope.projectKey}`;
+}
+function targetKey(scope, plugin) {
+    return `${scopeKey(scope)}\0${PluginKeySchema.parse(plugin)}`;
+}
+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 sameProject(left, right) {
+    return JSON.stringify(canonicalize(left)) === JSON.stringify(canonicalize(right));
+}
+export function createSkillHookRuntimeCatalog() {
+    let snapshots = Object.freeze([]);
+    let initialized = false;
+    let currentProject;
+    const values = new Map();
+    function lookup(scope, plugin) {
+        return values.get(targetKey(scope, plugin));
+    }
+    function publish(next, nextProject) {
+        const parsedProject = CurrentProjectRuntimeContextSchema.parse(nextProject);
+        const map = new Map();
+        for (const snapshot of next) {
+            const parsed = snapshot;
+            if (!hasSameCurrentProject(parsed.currentProject, parsedProject)) {
+                throw new Error("runtime snapshot current-project context disagrees with the catalog");
+            }
+            const key = targetKey(parsed.scope, parsed.plugin);
+            if (map.has(key))
+                throw new Error("runtime catalog target collision");
+            map.set(key, parsed);
+        }
+        values.clear();
+        for (const [key, snapshot] of map)
+            values.set(key, snapshot);
+        snapshots = Object.freeze([...next]);
+        currentProject = parsedProject;
+        initialized = true;
+    }
+    const catalog = Object.freeze({
+        list: () => snapshots,
+        get: (scope, plugin) => lookup(scope, plugin),
+        currentProject: () => currentProject,
+    });
+    return Object.freeze({
+        catalog,
+        state: () => Object.freeze({
+            initialized,
+            ...(currentProject === undefined ? {} : { currentProject }),
+        }),
+        lookup,
+        publish,
+    });
+}
+export function hasSameCurrentProject(left, right) {
+    return sameProject(left, right);
+}
+export function runtimeTargetKey(scope, plugin) {
+    return targetKey(scope, plugin);
+}
+//# sourceMappingURL=runtime-catalog.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/runtime-catalog.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/skill-hook/runtime-snapshot.d.ts

@@ -0,0 +1,57 @@
+import "zod";
+import { type ContentDigest } from "../../domain/content-manifest.js";
+import { type HookComponent, type SkillComponent } from "../../domain/components.js";
+import { type PluginKey } from "../../domain/identity.js";
+import { type InstalledRevisionRecord } from "../../domain/state/installed-state.js";
+import { type ProjectionRootRef } from "../../domain/state/references.js";
+import { type ScopeReference } from "../../domain/state/scope.js";
+import type { Sha256 } from "../../domain/source.js";
+import type { PreparedRuntimeProjection } from "../../application/runtime-projection-cache.js";
+import type { ContentStorePort, ResolvedContentRoot, WritableDataRoot } from "../../application/ports/content-store.js";
+import type { ProjectRootAuthorityPort } from "../../application/ports/project-root-authority.js";
+import { type CurrentProjectRuntimeContext, type ProjectTrustPort } from "../../application/ports/project-trust.js";
+export { CurrentProjectRuntimeContextSchema } from "../../application/ports/project-trust.js";
+export type { CurrentProjectRuntimeContext } from "../../application/ports/project-trust.js";
+export type RuntimeProjectionSelection = Readonly<{
+    prepared: PreparedRuntimeProjection;
+    revision: InstalledRevisionRecord;
+}>;
+export type SkillHookRuntimeSnapshot = Readonly<{
+    schemaVersion: 1;
+    scope: ScopeReference;
+    plugin: PluginKey;
+    revision: ContentDigest;
+    projectionDigest: ContentDigest;
+    projectionRef: ProjectionRootRef;
+    currentProject: CurrentProjectRuntimeContext;
+    content: ResolvedContentRoot;
+    data: WritableDataRoot;
+    skills: readonly SkillComponent[];
+    hooks: readonly HookComponent[];
+    contributionDigest: ContentDigest;
+}>;
+export type SkillHookSnapshotResult = Readonly<{
+    kind: "ready";
+    snapshot: SkillHookRuntimeSnapshot;
+}> | Readonly<{
+    kind: "failed";
+    code: "REVISION_MISMATCH" | "CURRENT_PROJECT_UNAVAILABLE" | "PROJECT_IDENTITY_MISMATCH" | "PROJECT_UNTRUSTED" | "CONTENT_UNAVAILABLE" | "DATA_UNAVAILABLE" | "ADAPTER_FAILED";
+}> | Readonly<{
+    kind: "cancelled";
+}>;
+export declare function digestSkillHookContribution(input: Readonly<{
+    scope: ScopeReference;
+    plugin: PluginKey;
+    revision?: ContentDigest;
+    projectionDigest: ContentDigest;
+    skills: readonly SkillComponent[];
+    hooks: readonly HookComponent[];
+}>, sha256: Sha256): ContentDigest;
+export declare function createSkillHookSnapshotLoader(dependencies: Readonly<{
+    content: Pick<ContentStorePort, "resolvePlugin" | "ensureDataRoot">;
+    projectRoots: ProjectRootAuthorityPort;
+    projectTrust: ProjectTrustPort;
+    sha256: Sha256;
+}>): Readonly<{
+    load(selection: RuntimeProjectionSelection, signal: AbortSignal): Promise<SkillHookSnapshotResult>;
+}>;