@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/pi/manager/text-input-surface.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/native-control-human.d.ts

@@ -0,0 +1,7 @@
+import type { NativeControlEnvelope } from "../application/native-control-contract.js";
+/**
+ * Produce useful human output from the already-safe public control envelope.
+ * Command summaries are labels, not results, so they are omitted whenever
+ * structured owner data or diagnostics can tell the user what actually happened.
+ */
+export declare function nativeControlHumanLines(envelope: NativeControlEnvelope): readonly string[];

package/node_modules/@nklisch/pi-plugins/dist/pi/native-control-human.js

@@ -0,0 +1,103 @@
+import { HostStatusSnapshotSchema } from "../application/host-observation-contract.js";
+import { NativeLifecycleOperationResultSchema } from "../application/native-lifecycle-operation-contract.js";
+import { NativeControlHelpSchema } from "../application/native-control-help.js";
+import { NativeInspectionPageSchema } from "../application/native-inspection-contract.js";
+import { NativeControlCommandRegistry } from "../application/native-control-registry.js";
+import { NativeControlMarketplaceCatalogResponseSchema, NativeControlMarketplaceListResponseSchema, } from "../application/native-control-safe-projection.js";
+import { NativeUpdateNotificationPageSchema } from "../application/native-update-contract.js";
+import { plainLifecycleFailure, plainLifecyclePhase } from "./plain-language.js";
+function lifecycleLines(envelope) {
+    const parsed = NativeLifecycleOperationResultSchema.safeParse(envelope.data);
+    if (!parsed.success)
+        return undefined;
+    const value = parsed.data;
+    if (value.kind === "expired" || value.kind === "disposed") {
+        return Object.freeze([`${envelope.command.path.join(" ") || "plugin"} · ${value.kind}`]);
+    }
+    const target = "before" in value ? value.before : "target" in value ? value.target : "restored" in value ? value.restored : undefined;
+    const subject = target === undefined ? value.operation : `${target.plugin} · ${value.operation}`;
+    const lines = [`${subject} · ${value.kind}`];
+    if (value.kind === "current-state")
+        lines.push("already in the wanted state — nothing to do");
+    if (value.kind === "needs-action")
+        lines.push(`${value.actions.length} project sync action${value.actions.length === 1 ? "" : "s"} need attention`);
+    if (value.kind === "cancelled")
+        lines.push(`cancelled during ${plainLifecyclePhase(value.phase)}`);
+    if (value.kind === "stale" || value.kind === "conflict")
+        lines.push("things changed — refresh and try again");
+    if (value.kind === "rejected" || value.kind === "failed")
+        lines.push(plainLifecycleFailure(value.code));
+    if (value.kind === "recovery-required")
+        lines.push("setup didn't finish — run recovery to complete it");
+    if (value.kind === "rolled-back")
+        lines.push(`${plainLifecycleFailure(value.failure)} · ${value.restored.plugin} was restored`);
+    if (value.kind === "succeeded" && value.cleanup !== undefined) {
+        lines.push(`persistent data ${value.cleanup.persistentData} · configuration ${value.cleanup.configuration} · trust ${value.cleanup.trust}`);
+    }
+    for (const diagnostic of [...value.diagnostics, ...envelope.diagnostics]) {
+        lines.push(`${diagnostic.severity} ${diagnostic.code} · ${diagnostic.action}`);
+    }
+    return Object.freeze(lines);
+}
+/**
+ * Produce useful human output from the already-safe public control envelope.
+ * Command summaries are labels, not results, so they are omitted whenever
+ * structured owner data or diagnostics can tell the user what actually happened.
+ */
+export function nativeControlHumanLines(envelope) {
+    const help = NativeControlHelpSchema.safeParse(envelope.command.id === "help" ? envelope.data : undefined);
+    if (help.success) {
+        return Object.freeze(help.data.commands.map((command) => {
+            const path = command.path.join(" ");
+            const positionals = command.positionals.map((entry) => entry.required ? `<${entry.name}>${entry.repeatable ? "..." : ""}` : `[${entry.name}${entry.repeatable ? "..." : ""}]`);
+            return `${[path, ...positionals].filter(Boolean).join(" ")} — ${command.summary.text}`;
+        }));
+    }
+    const installed = NativeInspectionPageSchema.safeParse(envelope.command.id === "inspection.list" ? envelope.data : undefined);
+    if (installed.success)
+        return Object.freeze(installed.data.items.length === 0
+            ? ["No plugins added."]
+            : installed.data.items.map((item) => `${item.plugin} · ${item.scope.kind} · ${item.condition} · ${item.revision.installed?.text ?? "not installed"}`));
+    const sources = NativeControlMarketplaceListResponseSchema.safeParse(envelope.command.id === "marketplace.list" ? envelope.data : undefined);
+    if (sources.success)
+        return Object.freeze(sources.data.registrations.length === 0
+            ? ["No plugin sources configured."]
+            : sources.data.registrations.map((source) => `${source.marketplace} · ${source.source.kind} · ${source.cache.kind}`));
+    const catalog = NativeControlMarketplaceCatalogResponseSchema.safeParse(envelope.command.id === "browse" ? envelope.data : undefined);
+    if (catalog.success)
+        return Object.freeze(catalog.data.candidates.length === 0
+            ? ["No plugins available from configured sources."]
+            : catalog.data.candidates.map((candidate) => `${candidate.plugin} · ${candidate.scope.kind} · ${candidate.availability}`));
+    const notices = NativeUpdateNotificationPageSchema.safeParse(envelope.command.id === "updates.notices.list" ? envelope.data : undefined);
+    if (notices.success)
+        return Object.freeze(notices.data.notices.length === 0
+            ? ["No pending plugin updates."]
+            : notices.data.notices.map((notice) => `${notice.plugin} · ${notice.installed} → ${notice.available} · ${notice.disposition}`));
+    const status = HostStatusSnapshotSchema.safeParse(envelope.command.id === "status" ? envelope.data : undefined);
+    if (status.success) {
+        const value = status.data;
+        return Object.freeze([
+            `Host ${value.status} · recovery ${value.local.recovery} · runtime ${value.local.runtime}`,
+            `Updates ${value.update.state} · ${value.update.unreadCount} unread · ${value.update.unresolvedCount} unresolved`,
+            ...Object.entries(value.capabilities).map(([name, capability]) => `${name}: ${capability.status} · ${capability.explanation}`),
+            ...(value.blocked.length === 0 ? [] : value.blocked.map((blocked) => `blocked ${blocked.plugin}: ${blocked.code}`)),
+            ...envelope.diagnostics.map((entry) => `${entry.severity.toUpperCase()} ${entry.code} · ${entry.action}`),
+        ]);
+    }
+    const lifecycle = lifecycleLines(envelope);
+    if (lifecycle !== undefined)
+        return lifecycle;
+    // Never dump raw result JSON: the envelope's safe human fields and
+    // diagnostics are the presentation contract, and anything else reduces to
+    // one status line.
+    const summary = NativeControlCommandRegistry[envelope.command.id].summary.text;
+    const human = envelope.human
+        .map((field) => field.text)
+        .filter((line) => line !== summary);
+    const diagnostics = envelope.diagnostics.map((entry) => `${entry.severity.toUpperCase()} ${entry.code} · ${entry.action}`);
+    const lines = [...human, ...diagnostics];
+    return Object.freeze(lines.length > 0
+        ? lines
+        : [`${envelope.command.path.join(" ") || "plugin"}: ${envelope.status}`]);
+}
+//# sourceMappingURL=native-control-human.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/native-control-human.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-control-channel.d.ts

@@ -0,0 +1,15 @@
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { Writable } from "node:stream";
+import { type NativeControlFrame } from "../application/native-control-progress.js";
+import type { NativeControlExecutionReport, NativeControlFrameSink } from "../application/ports/native-control-execution.js";
+export interface PiControlChannel {
+    createSink(context: ExtensionCommandContext, mode: ExtensionContext["mode"]): NativeControlFrameSink;
+    publishReport(context: ExtensionContext, report: NativeControlExecutionReport): Promise<void>;
+    publishCollision(context: ExtensionContext, invocationName: string): void;
+    takeFrames(context: ExtensionCommandContext): readonly NativeControlFrame[];
+}
+/** Pi-safe delivery for the one application control facade. */
+export declare function createPiControlChannel(options: Readonly<{
+    pi: ExtensionAPI;
+    output?: Writable;
+}>): PiControlChannel;

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-control-channel.js

@@ -0,0 +1,132 @@
+import { NativeControlFrameSchema } from "../application/native-control-progress.js";
+import { nativeControlHumanLines } from "./native-control-human.js";
+const CONTROL_REPORT_ENTRY = "plugin-host:control-report-v1";
+const CONTROL_FRAME_ENTRY = "plugin-host:control-frame-v1";
+const MAX_PRINT_LINES = 512;
+const MAX_PRINT_LINE_SCALARS = 1_024;
+const MAX_PRINT_SCALARS = 65_536;
+function boundedLine(value) {
+    let result = "";
+    let count = 0;
+    for (const scalar of value) {
+        const code = scalar.codePointAt(0);
+        const unsafe = code === 0x1b || code <= 0x1f || (code >= 0x7f && code <= 0x9f) ||
+            (code >= 0x202a && code <= 0x202e) || (code >= 0x2066 && code <= 0x2069);
+        result += unsafe ? "�" : scalar;
+        count += 1;
+        if (count >= MAX_PRINT_LINE_SCALARS)
+            break;
+    }
+    return result;
+}
+function frameLines(frame) {
+    if (frame.type === "accepted")
+        return [];
+    if (frame.type === "progress") {
+        return [`${frame.phase} ${frame.state}${frame.code === undefined ? "" : ` ${frame.code}`}`];
+    }
+    return nativeControlHumanLines(frame.result);
+}
+async function write(output, text, signal) {
+    signal.throwIfAborted();
+    await new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason ?? new DOMException("aborted", "AbortError"));
+        signal.addEventListener("abort", abort, { once: true });
+        try {
+            output.write(text, (error) => {
+                signal.removeEventListener("abort", abort);
+                if (error === undefined || error === null)
+                    resolve();
+                else
+                    reject(error);
+            });
+        }
+        catch (error) {
+            signal.removeEventListener("abort", abort);
+            reject(error);
+        }
+    });
+}
+/** Pi-safe delivery for the one application control facade. */
+export function createPiControlChannel(options) {
+    const output = options.output ?? process.stdout;
+    const frames = new WeakMap();
+    const channel = {
+        createSink(context, mode) {
+            let printedScalars = 0;
+            let printedLines = 0;
+            let closed = false;
+            return Object.freeze({
+                async write(frameInput, signal) {
+                    if (closed)
+                        throw new Error("Pi control output is closed");
+                    const frame = NativeControlFrameSchema.parse(frameInput);
+                    const retained = frames.get(context) ?? [];
+                    if (retained.length < MAX_PRINT_LINES)
+                        retained.push(frame);
+                    frames.set(context, retained);
+                    if (mode === "rpc" || mode === "json") {
+                        options.pi.appendEntry(CONTROL_FRAME_ENTRY, frame);
+                        return;
+                    }
+                    if (mode !== "print")
+                        return;
+                    for (const raw of frameLines(frame)) {
+                        if (printedLines >= MAX_PRINT_LINES || printedScalars >= MAX_PRINT_SCALARS)
+                            break;
+                        const line = boundedLine(raw).slice(0, Math.max(0, MAX_PRINT_SCALARS - printedScalars));
+                        printedLines += 1;
+                        printedScalars += line.length;
+                        await write(output, `${line}\n`, signal);
+                    }
+                },
+                async close() { closed = true; },
+            });
+        },
+        async publishReport(context, report) {
+            if (context.mode === "print") {
+                // Parse/help/presentation failures are produced before a frame sink is
+                // admitted. Print mode still owes the caller a useful terminal result,
+                // while admitted reports were already delivered through their sink.
+                if (report.deliveredThrough >= 0)
+                    return;
+                const signal = context.signal ?? new AbortController().signal;
+                const lines = nativeControlHumanLines(report.envelope).slice(0, MAX_PRINT_LINES);
+                let scalars = 0;
+                for (const raw of lines) {
+                    if (scalars >= MAX_PRINT_SCALARS)
+                        break;
+                    const line = boundedLine(raw).slice(0, Math.min(MAX_PRINT_LINE_SCALARS, MAX_PRINT_SCALARS - scalars));
+                    scalars += line.length;
+                    await write(output, `${line}\n`, signal);
+                }
+                return;
+            }
+            if (context.mode === "rpc" || context.mode === "json") {
+                // appendEntry is Pi's structured protocol/session channel. The envelope
+                // has already crossed the facade's redaction and JSON-schema boundary.
+                options.pi.appendEntry(CONTROL_REPORT_ENTRY, {
+                    schemaVersion: 1,
+                    envelope: report.envelope,
+                    delivery: report.delivery,
+                    deliveredThrough: report.deliveredThrough,
+                });
+                return;
+            }
+            const kind = report.envelope.exit.code === 0 ? "info" : report.envelope.exit.code < 6 ? "warning" : "error";
+            context.ui.notify(`${report.envelope.command.path.join(" ") || "plugin manager"}: ${report.envelope.status}`, kind);
+        },
+        publishCollision(context, invocationName) {
+            if (!context.hasUI)
+                return;
+            context.ui.notify(`Plugin Host command collision: use /${boundedLine(invocationName)} for this package.`, "warning");
+        },
+        takeFrames(context) {
+            const retained = Object.freeze([...(frames.get(context) ?? [])]);
+            frames.delete(context);
+            return retained;
+        },
+    };
+    return Object.freeze(channel);
+}
+//# sourceMappingURL=pi-control-channel.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-control-channel.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-manager-reload-handoff.d.ts

@@ -0,0 +1,28 @@
+import type { SessionShutdownEvent } from "@earendil-works/pi-coding-agent";
+import type { NativeControlExecutionReport } from "../application/ports/native-control-execution.js";
+export type PluginManagerDestination = "installed" | "install-result" | "operation-result";
+export type PiManagerHandoffTicket = Readonly<{
+    id: string;
+}>;
+export type PiManagerHandoffClaim = Readonly<{
+    destination: PluginManagerDestination;
+    result: Promise<NativeControlExecutionReport>;
+}>;
+export interface PiManagerReloadHandoff {
+    open(input: Readonly<{
+        sessionId: string;
+        cwd: string;
+        destination: PluginManagerDestination;
+    }>): PiManagerHandoffTicket;
+    claimSuccessor(input: Readonly<{
+        sessionId: string;
+        cwd: string;
+    }>): PiManagerHandoffClaim | undefined;
+    publish(ticket: PiManagerHandoffTicket, report: NativeControlExecutionReport): "local" | "successor";
+    fail(ticket: PiManagerHandoffTicket, error?: unknown): void;
+    closeSession(sessionId: string, reason: SessionShutdownEvent["reason"]): void;
+}
+/** Process-local plain-data bridge. No Pi/TUI/context object can enter a slot. */
+export declare function createPiManagerReloadHandoff(options?: Readonly<{
+    namespace?: string;
+}>): PiManagerReloadHandoff;

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-manager-reload-handoff.js

@@ -0,0 +1,110 @@
+import { randomUUID } from "node:crypto";
+import { NativeControlEnvelopeSchema } from "../application/native-control-contract.js";
+function key(sessionId, cwd) { return `${sessionId}\0${cwd}`; }
+function registry(namespace) {
+    const symbol = Symbol.for(`@nklisch/pi-plugins/manager-handoff-v1/${namespace}`);
+    const root = globalThis;
+    const existing = root[symbol];
+    if (existing !== undefined)
+        return existing;
+    const created = { byId: new Map(), bySession: new Map() };
+    Object.defineProperty(root, symbol, { value: created, configurable: false, enumerable: false });
+    return created;
+}
+function validIdentity(value, label) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 8_192 || /[\u0000-\u001f\u007f-\u009f]/u.test(value)) {
+        throw new TypeError(`${label} is invalid`);
+    }
+}
+/** Process-local plain-data bridge. No Pi/TUI/context object can enter a slot. */
+export function createPiManagerReloadHandoff(options = {}) {
+    const state = registry(options.namespace ?? "default");
+    function owned(ticket) {
+        const slot = state.byId.get(ticket.id);
+        if (slot === undefined || slot.settled)
+            throw new Error("Pi manager reload handoff is settled or unknown");
+        return slot;
+    }
+    function remove(slot) {
+        state.byId.delete(slot.ticket.id);
+        if (state.bySession.get(key(slot.sessionId, slot.cwd)) === slot)
+            state.bySession.delete(key(slot.sessionId, slot.cwd));
+    }
+    function reject(slot) {
+        if (slot.settled)
+            return;
+        slot.settled = true;
+        slot.reject?.(new Error("Pi manager reload handoff closed"));
+        remove(slot);
+        slot.resolve = undefined;
+        slot.reject = undefined;
+    }
+    const handoff = {
+        open(input) {
+            validIdentity(input.sessionId, "session id");
+            validIdentity(input.cwd, "cwd");
+            const sessionKey = key(input.sessionId, input.cwd);
+            if (state.bySession.has(sessionKey))
+                throw new Error("Pi manager reload handoff is already pending for this session");
+            const ticket = Object.freeze({ id: `pi-manager-handoff-v1:${randomUUID()}` });
+            const slot = { ticket, sessionId: input.sessionId, cwd: input.cwd, destination: input.destination, claimed: false, settled: false, resolve: undefined, reject: undefined };
+            state.byId.set(ticket.id, slot);
+            state.bySession.set(sessionKey, slot);
+            return ticket;
+        },
+        claimSuccessor(input) {
+            const slot = state.bySession.get(key(input.sessionId, input.cwd));
+            if (slot === undefined || slot.claimed || slot.settled)
+                return undefined;
+            slot.claimed = true;
+            const result = new Promise((resolve, rejectPromise) => {
+                slot.resolve = resolve;
+                slot.reject = rejectPromise;
+            });
+            // The lifecycle attaches immediately, but this guard prevents an
+            // unhandled rejection if Pi tears down the successor in the same turn.
+            void result.catch(() => undefined);
+            return Object.freeze({ destination: slot.destination, result });
+        },
+        publish(ticket, report) {
+            const slot = owned(ticket);
+            const plain = JSON.parse(JSON.stringify(report));
+            if (plain === null || typeof plain !== "object" || Array.isArray(plain))
+                throw new TypeError("Pi manager reload report is invalid");
+            const value = plain;
+            const delivery = value.delivery;
+            const deliveredThrough = value.deliveredThrough;
+            if ((delivery !== "complete" && delivery !== "closed" && delivery !== "failed") ||
+                !Number.isSafeInteger(deliveredThrough) || deliveredThrough < -1) {
+                throw new TypeError("Pi manager reload report is invalid");
+            }
+            const validated = Object.freeze({
+                envelope: NativeControlEnvelopeSchema.parse(structuredClone(value.envelope)),
+                delivery,
+                deliveredThrough: deliveredThrough,
+            });
+            slot.settled = true;
+            if (!slot.claimed) {
+                remove(slot);
+                return "local";
+            }
+            slot.resolve?.(validated);
+            remove(slot);
+            slot.resolve = undefined;
+            slot.reject = undefined;
+            return "successor";
+        },
+        fail(ticket, _error) {
+            reject(owned(ticket));
+        },
+        closeSession(sessionId, reason) {
+            if (reason === "reload")
+                return;
+            for (const slot of [...state.byId.values()])
+                if (slot.sessionId === sessionId)
+                    reject(slot);
+        },
+    };
+    return Object.freeze(handoff);
+}
+//# sourceMappingURL=pi-manager-reload-handoff.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-manager-reload-handoff.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-project-context.d.ts

@@ -0,0 +1,22 @@
+import type { CommandRunner } from "../application/ports/process-runner.js";
+import type { ProjectRootAuthorityPort, ProjectRootResolutionPort } from "../application/ports/project-root-authority.js";
+import type { CurrentProjectRuntimeContext, ProjectTrustPort } from "../application/ports/project-trust.js";
+import type { PiSessionBindingPort } from "../composition/packaged-plugin-host-contract.js";
+import { type ScopeContext } from "../domain/state/scope.js";
+import type { Sha256 } from "../domain/source.js";
+export type PiProjectContextAdapters = Readonly<{
+    resolution: ProjectRootResolutionPort;
+    authority: ProjectRootAuthorityPort;
+    trust: ProjectTrustPort;
+    scope: Extract<ScopeContext, {
+        kind: "project";
+    }>;
+    revalidate(signal: AbortSignal): Promise<CurrentProjectRuntimeContext>;
+    current(): CurrentProjectRuntimeContext;
+}>;
+/** Build exact project identity and live Pi trust from one bound session. */
+export declare function createPiProjectContextAdapters(input: Readonly<{
+    binding: PiSessionBindingPort;
+    sha256: Sha256;
+    git?: Pick<CommandRunner, "run">;
+}>): Promise<PiProjectContextAdapters>;

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-project-context.js

@@ -0,0 +1,79 @@
+import { createProjectRootAuthorityPort } from "../composition/create-project-root-authority.js";
+import { createScopeContext } from "../domain/state/scope.js";
+import { createNodeProjectRootResolver } from "../infrastructure/project/node-project-root-resolver.js";
+/** Build exact project identity and live Pi trust from one bound session. */
+export async function createPiProjectContextAdapters(input) {
+    if (input === null || typeof input !== "object" || typeof input.sha256 !== "function") {
+        throw new TypeError("Pi project context dependencies are required");
+    }
+    const cwd = input.binding.current().cwd;
+    const resolution = createNodeProjectRootResolver({
+        cwd,
+        sha256: input.sha256,
+        ...(input.git === undefined ? {} : { git: input.git }),
+    });
+    const resolved = createScopeContext(await resolution.resolve(new AbortController().signal), input.sha256);
+    if (resolved.kind !== "project")
+        throw new Error("project resolver returned user scope");
+    const initial = resolved;
+    const authority = createProjectRootAuthorityPort(resolution, input.sha256, initial);
+    // Resolution shells out to git for the repository fingerprint. Control
+    // reads revalidate several times per command burst, so concurrent callers
+    // share one in-flight resolution. The result is never reused once settled:
+    // bound-identity replacement must fail closed on the very next call.
+    let inFlight;
+    async function revalidate(signal) {
+        signal.throwIfAborted();
+        inFlight ??= (async () => {
+            try {
+                const current = await authority.revalidateCurrent(signal);
+                if (current.kind !== "project")
+                    throw new Error("current project identity is unavailable");
+                return Object.freeze({
+                    exact: current.projectKey === initial.projectKey &&
+                        JSON.stringify(current.identity) === JSON.stringify(initial.identity),
+                });
+            }
+            finally {
+                inFlight = undefined;
+            }
+        })();
+        const current = await inFlight;
+        signal.throwIfAborted();
+        return Object.freeze({
+            identity: initial.identity,
+            projectKey: initial.projectKey,
+            trust: current.exact && input.binding.isProjectTrusted() ? { kind: "trusted" } : { kind: "untrusted" },
+        });
+    }
+    const trust = Object.freeze({
+        async assess(projectKey, signal) {
+            if (projectKey !== initial.projectKey)
+                return { kind: "untrusted" };
+            try {
+                const current = await revalidate(signal);
+                return current.trust;
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw signal.reason;
+                return { kind: "untrusted" };
+            }
+        },
+    });
+    return Object.freeze({
+        resolution,
+        authority,
+        trust,
+        scope: initial,
+        revalidate,
+        current() {
+            return Object.freeze({
+                identity: initial.identity,
+                projectKey: initial.projectKey,
+                trust: input.binding.isProjectTrusted() ? { kind: "trusted" } : { kind: "untrusted" },
+            });
+        },
+    });
+}
+//# sourceMappingURL=pi-project-context.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-project-context.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-reload-broker.d.ts

@@ -0,0 +1,24 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { ActivationObservation } from "../application/ports/lifecycle-reload.js";
+import type { PendingTransitionRef } from "../domain/state/references.js";
+import type { ScopeReference } from "../domain/state/scope.js";
+import type { PiSessionBinding } from "../composition/packaged-plugin-host-contract.js";
+export type PiReloadTicket = Readonly<{
+    id: string;
+    sessionId: string;
+    cwd: string;
+    scope: ScopeReference;
+    transition: PendingTransitionRef;
+}>;
+export type PiOperationContextPort = Readonly<{
+    /** Consume the one reload authority carried by an admitted Pi call frame. */
+    takeReloadContext(): ExtensionCommandContext | undefined;
+}>;
+export type PiReloadBroker = Readonly<{
+    open(binding: PiSessionBinding, scope: ScopeReference, transition: PendingTransitionRef): PiReloadTicket;
+    claimSuccessor(binding: PiSessionBinding): PiReloadTicket | undefined;
+    publish(ticket: PiReloadTicket, observations: readonly ActivationObservation[]): void;
+    fail(ticket: PiReloadTicket, error?: unknown): void;
+    wait(ticket: PiReloadTicket, signal: AbortSignal): Promise<readonly ActivationObservation[]>;
+}>;
+export declare function createPiReloadBroker(): PiReloadBroker;