@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/application/ports/lifecycle-transition-store.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { GenerationSchema, } from "../../domain/state/config-state.js";
+import { PendingTransitionRefSchema, } from "../../domain/state/references.js";
+import { ScopeReferenceSchema, } from "../../domain/state/scope.js";
+import { PluginKeySchema } from "../../domain/identity.js";
+import { LifecycleOperationSchema, LifecycleOriginSchema, LifecyclePluginStateSchema, LifecycleRetainedDataSchema, deriveLifecyclePendingTransitionRef, } from "../plugin-lifecycle-contract.js";
+import { EpochMillisecondsSchema } from "./lifecycle-clock.js";
+import { ProjectionExpectationSchema, } from "./runtime-projection.js";
+export const LifecycleTransitionRecordSchemaV1 = z.object({
+    schemaVersion: z.literal(1),
+    reference: PendingTransitionRefSchema,
+    operationId: z.string().uuid(),
+    operation: LifecycleOperationSchema,
+    origin: LifecycleOriginSchema,
+    scope: ScopeReferenceSchema,
+    plugin: PluginKeySchema,
+    startingGeneration: GenerationSchema,
+    previous: LifecyclePluginStateSchema.nullable(),
+    candidate: LifecyclePluginStateSchema,
+    final: LifecyclePluginStateSchema.nullable(),
+    previousProjection: ProjectionExpectationSchema,
+    candidateProjection: ProjectionExpectationSchema,
+    retainedData: LifecycleRetainedDataSchema,
+}).strict().readonly().superRefine((record, context) => {
+    if (record.previous !== null && record.previous.plugin !== record.plugin)
+        context.addIssue({ code: "custom", path: ["previous", "plugin"], message: "previous state belongs to another plugin" });
+    if (record.candidate.plugin !== record.plugin)
+        context.addIssue({ code: "custom", path: ["candidate", "plugin"], message: "candidate state belongs to another plugin" });
+    if (record.final !== null && record.final.plugin !== record.plugin)
+        context.addIssue({ code: "custom", path: ["final", "plugin"], message: "final state belongs to another plugin" });
+    for (const [name, projection] of [["previousProjection", record.previousProjection], ["candidateProjection", record.candidateProjection]]) {
+        const valid = projection.kind === "active"
+            ? projection.projection.plugin === record.plugin && JSON.stringify(projection.projection.scope) === JSON.stringify(record.scope)
+            : projection.plugin === record.plugin && JSON.stringify(projection.scope) === JSON.stringify(record.scope);
+        if (!valid)
+            context.addIssue({ code: "custom", path: [name], message: "projection evidence does not belong to the transition target" });
+    }
+});
+export const LifecycleTransitionStatusSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("prepared") }).strict().readonly(),
+    z.object({ kind: z.literal("recovery-required"), generation: GenerationSchema.optional() }).strict().readonly(),
+    z.object({ kind: z.enum(["completed", "rolled-back", "abandoned"]), generation: GenerationSchema.optional() }).strict().readonly(),
+    z.object({ kind: z.literal("quarantined"), code: z.literal("TRANSITION_JOURNAL_CORRUPT") }).strict().readonly(),
+]);
+export const LifecycleTransitionJournalEntrySchemaV1 = z.object({
+    schemaVersion: z.literal(1),
+    record: LifecycleTransitionRecordSchemaV1,
+    status: LifecycleTransitionStatusSchema,
+    preparedAt: EpochMillisecondsSchema,
+    statusAt: EpochMillisecondsSchema,
+    collectionCompletedAt: EpochMillisecondsSchema.optional(),
+}).strict().readonly();
+export const LifecycleUninstallCleanupStatusSchema = z.enum(["not-required", "pending-data-delete", "completed", "recovery-required"]);
+export const LifecycleTransitionJournalEntrySchemaV2 = z.object({
+    schemaVersion: z.literal(2),
+    record: LifecycleTransitionRecordSchemaV1,
+    status: LifecycleTransitionStatusSchema,
+    cleanup: LifecycleUninstallCleanupStatusSchema,
+    preparedAt: EpochMillisecondsSchema,
+    statusAt: EpochMillisecondsSchema,
+    collectionCompletedAt: EpochMillisecondsSchema.optional(),
+}).strict().readonly();
+export function lifecycleCleanupStatus(record, status) {
+    if (record.operation !== "uninstall" || record.retainedData !== "delete-confirmed" || status.kind === "rolled-back" || status.kind === "abandoned")
+        return "not-required";
+    return "pending-data-delete";
+}
+export function migrateLifecycleTransitionJournalEntryV1(input) {
+    const entry = LifecycleTransitionJournalEntrySchemaV1.parse(input);
+    return LifecycleTransitionJournalEntrySchemaV2.parse({ ...entry, schemaVersion: 2, cleanup: lifecycleCleanupStatus(entry.record, entry.status) });
+}
+export const LifecycleTransitionPrepareResultSchema = z.enum(["stored", "already-present"]);
+export const LifecycleTransitionOutcomeSchema = z.enum(["completed", "rolled-back", "abandoned", "recovery-required"]);
+export const LifecycleTransitionSettleRequestSchema = z.object({
+    scope: ScopeReferenceSchema.optional(),
+    reference: PendingTransitionRefSchema,
+    outcome: LifecycleTransitionOutcomeSchema,
+    generation: GenerationSchema.optional(),
+    at: EpochMillisecondsSchema.optional(),
+}).strict().readonly();
+export const TransitionJournalReadResultSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("missing") }).strict().readonly(),
+    z.object({ kind: z.literal("found"), entry: LifecycleTransitionJournalEntrySchemaV2 }).strict().readonly(),
+    z.object({
+        kind: z.literal("corrupt"),
+        code: z.literal("TRANSITION_JOURNAL_CORRUPT"),
+    }).strict().readonly(),
+]);
+export const LifecycleTransitionCollectionSchema = z.object({
+    entries: z.array(LifecycleTransitionJournalEntrySchemaV2).readonly(),
+    complete: z.boolean(),
+    diagnostics: z.array(z.object({ code: z.literal("TRANSITION_JOURNAL_CORRUPT"), scope: ScopeReferenceSchema.optional() }).strict().readonly()).readonly(),
+}).strict().readonly();
+function legacyProjection(input) {
+    const previousProjection = input.previousProjection ?? input.projection;
+    const candidateProjection = input.candidateProjection ?? input.projection;
+    if (previousProjection === undefined || candidateProjection === undefined)
+        throw new TypeError("transition projections are required");
+    return { previousProjection, candidateProjection };
+}
+/** Construct a transition record and prove its precomputed opaque reference. */
+export function createLifecycleTransitionRecord(input) {
+    const projections = legacyProjection(input);
+    const value = LifecycleTransitionRecordSchemaV1.parse({
+        schemaVersion: 1,
+        reference: input.reference ?? "pending-transition-v1:sha256:" + "0".repeat(64),
+        operationId: input.operationId,
+        operation: input.operation,
+        origin: input.origin,
+        scope: input.scope,
+        plugin: input.plugin,
+        startingGeneration: input.startingGeneration,
+        previous: input.previous,
+        candidate: input.candidate,
+        final: input.final,
+        ...projections,
+        retainedData: input.retainedData,
+    });
+    const expected = deriveLifecyclePendingTransitionRef({
+        operationId: value.operationId,
+        scope: value.scope,
+        plugin: value.plugin,
+        startingGeneration: value.startingGeneration,
+    }, input.sha256);
+    if (input.reference !== undefined && input.reference !== expected)
+        throw new Error("lifecycle transition reference does not match its identity");
+    return LifecycleTransitionRecordSchemaV1.parse({ ...value, reference: expected });
+}
+//# sourceMappingURL=lifecycle-transition-store.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/ports/lifecycle-transition-store.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/application/ports/marketplace-registration.d.ts

@@ -0,0 +1,15 @@
+import type { MarketplaceRegistrationRequest, MarketplaceRegistrationResult } from "../adoption-contract.js";
+import type { MarketplaceSource } from "../../domain/source.js";
+/** The normal marketplace writer. Adoption cannot bypass catalog identity,
+ * portability, trust, state compare-and-commit, or lifecycle policy. */
+export interface MarketplaceRegistrationPort {
+    register(request: MarketplaceRegistrationRequest, signal: AbortSignal): Promise<MarketplaceRegistrationResult>;
+}
+/** Node owns realpath/lstat; registration policy only accepts the verified source. */
+export interface MarketplaceLocalSourcePort {
+    canonicalize(source: Extract<MarketplaceSource, {
+        kind: "local-git";
+    }>, signal: AbortSignal): Promise<Extract<MarketplaceSource, {
+        kind: "local-git";
+    }>>;
+}

package/node_modules/@nklisch/pi-plugins/dist/application/ports/marketplace-registration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=marketplace-registration.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/ports/marketplace-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-registration.js","sourceRoot":"","sources":["../../../src/application/ports/marketplace-registration.ts"],"names":[],"mappings":""}

package/node_modules/@nklisch/pi-plugins/dist/application/ports/mcp-launch-context.d.ts

@@ -0,0 +1,97 @@
+import type { McpServerComponent } from "../../domain/components.js";
+import { DomainContractError, type ErrorCode } from "../../domain/errors.js";
+import type { PluginConfiguration } from "../../domain/configuration.js";
+import type { InstalledRevisionRecord } from "../../domain/state/installed-state.js";
+import type { TrustStateRecord } from "../../domain/state/trust-state.js";
+import type { TrustCandidate } from "../../domain/trust-policy.js";
+import type { ConfigurationPathContext } from "./configuration-path.js";
+import type { CurrentProjectRuntimeContext } from "./project-trust.js";
+import type { ProjectionExpectation } from "./runtime-projection.js";
+import { type McpBridgeTransport, type McpRuntimeServerBinding, type McpSourceIdentity, type McpSourceProjectionBinding } from "./mcp-runtime.js";
+import type { ResolvedConfiguration } from "../resolved-configuration.js";
+import type { McpLaunchTemplate } from "../../domain/mcp-launch-template.js";
+export declare const McpLaunchBindingSchemaV1: import("zod").ZodReadonly<import("zod").ZodObject<{
+    schemaVersion: import("zod").ZodLiteral<1>;
+    source: import("zod").ZodReadonly<import("zod").ZodObject<{
+        schemaVersion: import("zod").ZodLiteral<1>;
+        scope: import("zod").ZodDiscriminatedUnion<[import("zod").ZodReadonly<import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"user">;
+        }, import("zod/v4/core").$strict>>, import("zod").ZodReadonly<import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"project">;
+            projectKey: import("zod/v4/core").$ZodBranded<import("zod").ZodString, "ProjectKey", "out">;
+        }, import("zod/v4/core").$strict>>], "kind">;
+        plugin: import("zod/v4/core").$ZodBranded<import("zod").ZodString, "PluginKey", "out">;
+        revision: import("zod/v4/core").$ZodBranded<import("zod").ZodString, "ContentDigest", "out">;
+        projectionDigest: import("zod/v4/core").$ZodBranded<import("zod").ZodString, "ContentDigest", "out">;
+    }, import("zod/v4/core").$strict>>;
+    serverKey: import("zod/v4/core").$ZodBranded<import("zod").ZodString, "McpRuntimeServerKey", "out">;
+    componentId: import("zod/v4/core").$ZodBranded<import("zod").ZodString, "ComponentId", "out">;
+    transport: import("zod").ZodEnum<{
+        stdio: "stdio";
+        "streamable-http": "streamable-http";
+    }>;
+}, import("zod/v4/core").$strict>>;
+export type McpLaunchBinding = McpRuntimeServerBinding;
+export type McpLaunchActiveSelection = Readonly<{
+    expectation: Extract<ProjectionExpectation, {
+        kind: "active";
+    }>;
+    revision: InstalledRevisionRecord;
+    component: McpServerComponent;
+    currentProject: CurrentProjectRuntimeContext;
+    candidate: TrustCandidate;
+    trustRecords: readonly TrustStateRecord[];
+    descriptors: PluginConfiguration;
+    pathContext: ConfigurationPathContext;
+}>;
+/**
+ * Native composition must pin this exact selection for the callback lifetime.
+ * Replacement/removal waits for it or rejects the callback; a get-only
+ * snapshot is not a conforming implementation.
+ */
+export interface McpLaunchActiveSelectionPort {
+    withSelection(binding: McpLaunchBinding, signal: AbortSignal, use: (selection: McpLaunchActiveSelection) => Promise<void>): Promise<void>;
+}
+export type ResolvedMcpLaunchContext = Readonly<{
+    binding: McpLaunchBinding;
+    pluginRoot: string;
+    pluginDataRoot: string;
+    projectRoot: string;
+    projection: McpSourceProjectionBinding;
+    template: McpLaunchTemplate;
+    configuration: ResolvedConfiguration;
+}>;
+export interface McpLaunchContextPort {
+    withContext(binding: McpLaunchBinding, signal: AbortSignal, use: (context: ResolvedMcpLaunchContext) => Promise<void>): Promise<void>;
+}
+export type McpLaunchConfigurationDependencies = Parameters<typeof import("../configuration-resolver.js").withResolvedPluginConfiguration>[1];
+export type McpLaunchContextPortDependencies = Readonly<{
+    active: McpLaunchActiveSelectionPort;
+    content: Pick<import("./content-store.js").ContentStorePort, "resolvePlugin" | "ensureDataRoot">;
+    projectRoots: import("./project-root-authority.js").ProjectRootAuthorityPort;
+    projectTrust: import("./project-trust.js").ProjectTrustPort;
+    configuration: Readonly<{
+        withResolvedPluginConfiguration: typeof import("../configuration-resolver.js").withResolvedPluginConfiguration;
+        dependencies: McpLaunchConfigurationDependencies;
+    }>;
+    sha256: import("../../domain/source.js").Sha256;
+}>;
+export declare const McpLaunchErrorCodes: {
+    readonly authorityRejected: "MCP_LAUNCH_AUTHORITY_REJECTED";
+    readonly configurationFailed: "MCP_LAUNCH_CONFIGURATION_FAILED";
+    readonly environmentFailed: "MCP_LAUNCH_ENVIRONMENT_FAILED";
+    readonly valueInvalid: "MCP_LAUNCH_VALUE_INVALID";
+    readonly cancelled: "MCP_LAUNCH_CANCELLED";
+    readonly timeout: "MCP_LAUNCH_TIMEOUT";
+    readonly cleanupFailed: "MCP_LAUNCH_CLEANUP_FAILED";
+};
+export declare class McpLaunchContextError extends DomainContractError {
+    constructor(input: Readonly<{
+        code: ErrorCode;
+        source?: McpSourceIdentity;
+        serverKey?: string;
+        componentId?: string;
+        transport?: McpBridgeTransport;
+    }>);
+}
+export type { McpBridgeTransport, McpSourceIdentity };

package/node_modules/@nklisch/pi-plugins/dist/application/ports/mcp-launch-context.js

@@ -0,0 +1,30 @@
+import { ErrorCodeRegistry, DomainContractError } from "../../domain/errors.js";
+import { McpRuntimeServerBindingSchemaV1, } from "./mcp-runtime.js";
+export const McpLaunchBindingSchemaV1 = McpRuntimeServerBindingSchemaV1;
+export const McpLaunchErrorCodes = {
+    authorityRejected: ErrorCodeRegistry.mcpLaunchAuthorityRejected,
+    configurationFailed: ErrorCodeRegistry.mcpLaunchConfigurationFailed,
+    environmentFailed: ErrorCodeRegistry.mcpLaunchEnvironmentFailed,
+    valueInvalid: ErrorCodeRegistry.mcpLaunchValueInvalid,
+    cancelled: ErrorCodeRegistry.mcpLaunchCancelled,
+    timeout: ErrorCodeRegistry.mcpLaunchTimeout,
+    cleanupFailed: ErrorCodeRegistry.mcpLaunchCleanupFailed,
+};
+export class McpLaunchContextError extends DomainContractError {
+    constructor(input) {
+        super({
+            code: input.code,
+            operation: "resolveMcpLaunchContext",
+            message: "MCP launch context is unavailable",
+            ...(input.source === undefined ? {} : { plugin: input.source.plugin }),
+            details: {
+                ...(input.source === undefined ? {} : { source: input.source }),
+                ...(input.serverKey === undefined ? {} : { serverKey: input.serverKey }),
+                ...(input.componentId === undefined ? {} : { componentId: input.componentId }),
+                ...(input.transport === undefined ? {} : { transport: input.transport }),
+            },
+        });
+        this.name = "McpLaunchContextError";
+    }
+}
+//# sourceMappingURL=mcp-launch-context.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/ports/mcp-launch-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-launch-context.js","sourceRoot":"","sources":["../../../src/application/ports/mcp-launch-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAkB,MAAM,wBAAwB,CAAC;AAQhG,OAAO,EACL,+BAA+B,GAKhC,MAAM,kBAAkB,CAAC;AAI1B,MAAM,CAAC,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AA6DxE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,iBAAiB,EAAE,iBAAiB,CAAC,0BAA0B;IAC/D,mBAAmB,EAAE,iBAAiB,CAAC,4BAA4B;IACnE,iBAAiB,EAAE,iBAAiB,CAAC,0BAA0B;IAC/D,YAAY,EAAE,iBAAiB,CAAC,qBAAqB;IACrD,SAAS,EAAE,iBAAiB,CAAC,kBAAkB;IAC/C,OAAO,EAAE,iBAAiB,CAAC,gBAAgB;IAC3C,aAAa,EAAE,iBAAiB,CAAC,sBAAsB;CAC/C,CAAC;AAEX,MAAM,OAAO,qBAAsB,SAAQ,mBAAmB;IAC5D,YAAY,KAMV;QACA,KAAK,CAAC;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,yBAAyB;YACpC,OAAO,EAAE,mCAAmC;YAC5C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACtE,OAAO,EAAE;gBACP,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC/D,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;gBACxE,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC9E,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;aACzE;SACF,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/node_modules/@nklisch/pi-plugins/dist/application/ports/mcp-launch-environment.d.ts

@@ -0,0 +1,11 @@
+export interface ResolvedMcpLaunchEnvironment {
+    has(name: string): boolean;
+    substitute(template: string): string;
+    redact(text: string): string;
+    toString(): "[REDACTED]";
+    toJSON(): "[REDACTED]";
+}
+/** Requested-name-only, callback-scoped ambient environment custody. */
+export interface McpLaunchEnvironmentPort {
+    withResolved(names: readonly string[], signal: AbortSignal, use: (environment: ResolvedMcpLaunchEnvironment) => Promise<void>): Promise<void>;
+}

package/node_modules/@nklisch/pi-plugins/dist/application/ports/mcp-launch-environment.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-launch-environment.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/ports/mcp-launch-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-launch-environment.js","sourceRoot":"","sources":["../../../src/application/ports/mcp-launch-environment.ts"],"names":[],"mappings":""}