@aipt/platform-kernel 0.1.5

package/dist/example-recipe.d.ts

@@ -0,0 +1,147 @@
+import { type ErrorObject } from "ajv/dist/2020.js";
+export type ExampleRecipe = {
+    schemaVersion: 1;
+    recipeId: string;
+    version: string;
+    integrity: string;
+    title: string;
+    locale: "zh-CN";
+    rootProfile: {
+        capabilityId: string;
+        version: string;
+    };
+    capabilities: Array<{
+        capabilityId: string;
+        version: string;
+        channel: "development";
+    }>;
+    expectedEntrypoint: string;
+    verifiers: string[];
+    manualAcceptance: string[];
+    cleanup: {
+        ownedStateDirectories: string[];
+    };
+};
+export declare const exampleRecipeSchema: {
+    readonly $id: "https://schemas.dyyto.dev/platform/example-recipe-v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["schemaVersion", "recipeId", "version", "integrity", "title", "locale", "rootProfile", "capabilities", "expectedEntrypoint", "verifiers", "manualAcceptance", "cleanup"];
+    readonly properties: {
+        readonly schemaVersion: {
+            readonly const: 1;
+        };
+        readonly recipeId: {
+            readonly type: "string";
+            readonly pattern: "^[a-z0-9]+(?:[.-][a-z0-9]+)*$";
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+        };
+        readonly integrity: {
+            readonly type: "string";
+            readonly pattern: "^sha256:[a-f0-9]{64}$";
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 80;
+        };
+        readonly locale: {
+            readonly const: "zh-CN";
+        };
+        readonly rootProfile: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["capabilityId", "version"];
+            readonly properties: {
+                readonly capabilityId: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$";
+                };
+                readonly version: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+            };
+        };
+        readonly capabilities: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 16;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["capabilityId", "version", "channel"];
+                readonly properties: {
+                    readonly capabilityId: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$";
+                    };
+                    readonly version: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly channel: {
+                        readonly const: "development";
+                    };
+                };
+            };
+        };
+        readonly expectedEntrypoint: {
+            readonly type: "string";
+            readonly pattern: "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[^\\u0000]+$";
+            readonly maxLength: 240;
+        };
+        readonly verifiers: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 16;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "string";
+                readonly pattern: "^[a-z0-9]+(?:[.-][a-z0-9]+)*$";
+            };
+        };
+        readonly manualAcceptance: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 32;
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 240;
+            };
+        };
+        readonly cleanup: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["ownedStateDirectories"];
+            readonly properties: {
+                readonly ownedStateDirectories: {
+                    readonly type: "array";
+                    readonly maxItems: 8;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[^\\u0000]+$";
+                        readonly maxLength: 240;
+                    };
+                };
+            };
+        };
+    };
+};
+export declare class ExampleRecipeError extends Error {
+    readonly code: "EXAMPLE_RECIPE_INVALID" | "EXAMPLE_RECIPE_INTEGRITY_MISMATCH";
+    readonly issues: ErrorObject[];
+    constructor(code: "EXAMPLE_RECIPE_INVALID" | "EXAMPLE_RECIPE_INTEGRITY_MISMATCH", issues?: ErrorObject[]);
+}
+export declare function calculateExampleRecipeIntegrity(recipe: Omit<ExampleRecipe, "integrity">): string;
+export declare function parseExampleRecipe(value: unknown): ExampleRecipe;
+export declare function loadExampleRecipe(directoryInput: string): Promise<ExampleRecipe>;
+//# sourceMappingURL=example-recipe.d.ts.map

package/dist/example-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-recipe.d.ts","sourceRoot":"","sources":["../src/example-recipe.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI7D,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,YAAY,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IACvF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE;QAAE,qBAAqB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC9C,CAAC;AAKF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAatB,CAAC;AAGX,qBAAa,kBAAmB,SAAQ,KAAK;IAAe,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,mCAAmC;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE;gBAApG,IAAI,EAAE,wBAAwB,GAAG,mCAAmC,EAAW,MAAM,GAAE,WAAW,EAAO;CAAoB;AAClM,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,MAAM,CAA+C;AAChJ,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAMhE;AACD,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQtF"}

package/dist/example-recipe.js

@@ -0,0 +1,58 @@
+import { readFile, realpath } from "node:fs/promises";
+import path from "node:path";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { capabilityIdPattern, sha256Pattern } from "./contracts.js";
+import { canonicalize, sha256Digest } from "./integrity.js";
+const identityPattern = "^[a-z0-9]+(?:[.-][a-z0-9]+)*$";
+const relativePathPattern = "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[^\\u0000]+$";
+export const exampleRecipeSchema = {
+    $id: "https://schemas.dyyto.dev/platform/example-recipe-v1.json",
+    type: "object", additionalProperties: false,
+    required: ["schemaVersion", "recipeId", "version", "integrity", "title", "locale", "rootProfile", "capabilities", "expectedEntrypoint", "verifiers", "manualAcceptance", "cleanup"],
+    properties: {
+        schemaVersion: { const: 1 }, recipeId: { type: "string", pattern: identityPattern }, version: { type: "string", minLength: 1, maxLength: 128 }, integrity: { type: "string", pattern: sha256Pattern }, title: { type: "string", minLength: 1, maxLength: 80 }, locale: { const: "zh-CN" },
+        rootProfile: { type: "object", additionalProperties: false, required: ["capabilityId", "version"], properties: { capabilityId: { type: "string", pattern: capabilityIdPattern }, version: { type: "string", minLength: 1, maxLength: 128 } } },
+        capabilities: { type: "array", minItems: 1, maxItems: 16, items: { type: "object", additionalProperties: false, required: ["capabilityId", "version", "channel"], properties: { capabilityId: { type: "string", pattern: capabilityIdPattern }, version: { type: "string", minLength: 1, maxLength: 128 }, channel: { const: "development" } } } },
+        expectedEntrypoint: { type: "string", pattern: relativePathPattern, maxLength: 240 },
+        verifiers: { type: "array", minItems: 1, maxItems: 16, uniqueItems: true, items: { type: "string", pattern: identityPattern } },
+        manualAcceptance: { type: "array", minItems: 1, maxItems: 32, items: { type: "string", minLength: 1, maxLength: 240 } },
+        cleanup: { type: "object", additionalProperties: false, required: ["ownedStateDirectories"], properties: { ownedStateDirectories: { type: "array", maxItems: 8, uniqueItems: true, items: { type: "string", pattern: relativePathPattern, maxLength: 240 } } } },
+    },
+};
+const validate = new Ajv2020({ allErrors: true, strict: true }).compile(exampleRecipeSchema);
+export class ExampleRecipeError extends Error {
+    code;
+    issues;
+    constructor(code, issues = []) {
+        super(code);
+        this.code = code;
+        this.issues = issues;
+    }
+}
+export function calculateExampleRecipeIntegrity(recipe) { return sha256Digest(canonicalize(recipe)); }
+export function parseExampleRecipe(value) {
+    if (!validate(value))
+        throw new ExampleRecipeError("EXAMPLE_RECIPE_INVALID", validate.errors ?? []);
+    const recipe = value;
+    const identities = [recipe.rootProfile.capabilityId, ...recipe.capabilities.map((item) => item.capabilityId)];
+    if (new Set(identities).size !== identities.length || recipe.capabilities.some((item) => item.version.includes("workspace:") || item.capabilityId.includes("ai-education-poc")))
+        throw new ExampleRecipeError("EXAMPLE_RECIPE_INVALID");
+    return recipe;
+}
+export async function loadExampleRecipe(directoryInput) {
+    const directory = await realpath(path.resolve(directoryInput));
+    let recipe;
+    try {
+        recipe = parseExampleRecipe(JSON.parse(await readFile(path.join(directory, "recipe.json"), "utf8")));
+    }
+    catch (error) {
+        if (error instanceof ExampleRecipeError)
+            throw error;
+        throw new ExampleRecipeError("EXAMPLE_RECIPE_INVALID");
+    }
+    const { integrity, ...content } = recipe;
+    if (calculateExampleRecipeIntegrity(content) !== integrity)
+        throw new ExampleRecipeError("EXAMPLE_RECIPE_INTEGRITY_MISMATCH");
+    return recipe;
+}
+//# sourceMappingURL=example-recipe.js.map

package/dist/example-recipe.js.map

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

package/dist/feature-planner.d.ts

@@ -0,0 +1,59 @@
+import type { LoadedCapabilityRelease, ProjectAdoptionLock } from "./adoption-contracts.js";
+import type { PackageDeliveryReceipt, RegistryConfigRelease, RegistryEndpointBinding } from "./catalog-source.js";
+import { type PackageArtifactInspection, type PackageLockResolution } from "./package-adoption.js";
+import type { PackageAdoptionTopology } from "./workspace-topology.js";
+import type { ChangePlan, ProjectManifest } from "./contracts.js";
+import type { ResolutionJobEvidence } from "./resolution-evidence.js";
+export declare class FeatureSelectionError extends Error {
+    readonly code: "CAPABILITY_ALREADY_SELECTED" | "CAPABILITY_DEPENDENCY_UNSATISFIED" | "CAPABILITY_KIND_UNSUPPORTED" | "CAPABILITY_RELEASE_VERSION_UNSUPPORTED" | "CAPABILITY_PACKAGE_SOURCE_INVALID";
+    constructor(code: "CAPABILITY_ALREADY_SELECTED" | "CAPABILITY_DEPENDENCY_UNSATISFIED" | "CAPABILITY_KIND_UNSUPPORTED" | "CAPABILITY_RELEASE_VERSION_UNSUPPORTED" | "CAPABILITY_PACKAGE_SOURCE_INVALID", message: string);
+}
+export declare function planAssetOnlyFeatureRemoval(input: {
+    projectRoot: string;
+    manifest: unknown;
+    release: LoadedCapabilityRelease;
+    currentLock: ProjectAdoptionLock;
+    generatedAt: string;
+    expiresAt: string;
+}): Promise<{
+    plan: ChangePlan;
+    manifest: ProjectManifest;
+    desiredContents: Map<string, Uint8Array<ArrayBufferLike>>;
+    transactionRoot: string;
+    removedSources: readonly [];
+}>;
+export declare function planFeatureAdoption(input: {
+    projectRoot: string;
+    manifest: unknown;
+    release: LoadedCapabilityRelease;
+    currentLock: ProjectAdoptionLock;
+    generatedAt: string;
+    expiresAt: string;
+    packageChannel?: "production" | "development";
+    packageSource?: {
+        registryConfigs: readonly RegistryConfigRelease[];
+        endpointBindings: readonly RegistryEndpointBinding[];
+        receipts: readonly PackageDeliveryReceipt[];
+        inspections: readonly PackageArtifactInspection[];
+        lockResolution: PackageLockResolution;
+        resolutionEvidence?: ResolutionJobEvidence;
+        resolutionWorkerReleaseId?: string;
+        topology?: PackageAdoptionTopology;
+        currentLockfile?: Uint8Array;
+        preservedImporterDigests?: readonly Readonly<{
+            importerId: string;
+            preimageDigest: string;
+            desiredDigest: string;
+        }>[];
+    };
+}): Promise<{
+    plan: ChangePlan;
+    manifest: ProjectManifest;
+    desiredContents: ReadonlyMap<string, Uint8Array>;
+    transactionRoot: string;
+    dependency: {
+        profile: string;
+        satisfied: true;
+    };
+}>;
+//# sourceMappingURL=feature-planner.d.ts.map

package/dist/feature-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-planner.d.ts","sourceRoot":"","sources":["../src/feature-planner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA6B,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvH,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAA8L,KAAK,yBAAyB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/R,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAiB,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAKjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAItE,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,IAAI,EACT,6BAA6B,GAC7B,mCAAmC,GACnC,6BAA6B,GAC7B,wCAAwC,GACxC,mCAAmC;gBAL9B,IAAI,EACT,6BAA6B,GAC7B,mCAAmC,GACnC,6BAA6B,GAC7B,wCAAwC,GACxC,mCAAmC,EACvC,OAAO,EAAE,MAAM;CAElB;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;;;;;;GAS9M;AAYD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,uBAAuB,CAAC;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;IAC9C,aAAa,CAAC,EAAE;QACd,eAAe,EAAE,SAAS,qBAAqB,EAAE,CAAC;QAClD,gBAAgB,EAAE,SAAS,uBAAuB,EAAE,CAAC;QACrD,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;QAC5C,WAAW,EAAE,SAAS,yBAAyB,EAAE,CAAC;QAClD,cAAc,EAAE,qBAAqB,CAAC;QACtC,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;QAC3C,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;QACnC,eAAe,CAAC,EAAE,UAAU,CAAC;QAC7B,wBAAwB,CAAC,EAAE,SAAS,QAAQ,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,EAAE,CAAC;KACvH,CAAC;CACH,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;CAClD,CAAC,CAkGD"}

package/dist/feature-planner.js

@@ -0,0 +1,160 @@
+import { readFile, realpath } from "node:fs/promises";
+import path from "node:path";
+import { buildDevelopmentPackageAdoptionPlan, buildPackageAdoptionPlan, buildWorkspaceDevelopmentPackageAdoptionPlan, buildWorkspacePackageAdoptionPlan, packageAdoptionFacts, PackageAdoptionError } from "./package-adoption.js";
+import { sha256Digest } from "./integrity.js";
+import { renderMarkdownManagedRegion } from "./managed-region.js";
+import { buildChangePlan } from "./planner.js";
+import { parseProjectManifest } from "./schemas.js";
+import { renderApplicationConfigContract } from "./application-config-contract.js";
+import { renderApplicationConfigBinding } from "./application-config-binding.js";
+export class FeatureSelectionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export async function planAssetOnlyFeatureRemoval(input) {
+    const projectRoot = await realpath(path.resolve(input.projectRoot));
+    const manifest = parseProjectManifest(input.manifest);
+    const release = input.release.release;
+    const target = input.currentLock.capabilities.find((item) => item.capabilityId === release.capabilityId && item.version === release.version);
+    if (!target || target.packageAdoption !== undefined)
+        throw new FeatureSelectionError("CAPABILITY_RELEASE_VERSION_UNSUPPORTED", "Asset-only removal requires an adopted Capability without package ownership");
+    const nextManifest = parseProjectManifest({ ...manifest, capabilities: manifest.capabilities.filter((item) => item.capabilityId !== release.capabilityId) });
+    const manifestBytes = Buffer.from(`${JSON.stringify(nextManifest, null, 2)}\n`);
+    const currentManifest = await observe(projectRoot, "project-capabilities.json");
+    if (!currentManifest.exists || currentManifest.digest === undefined)
+        throw new FeatureSelectionError("CAPABILITY_DEPENDENCY_UNSATISFIED", "Project manifest is unavailable");
+    const changes = [{ path: "project-capabilities.json", kind: "replace", ownership: "owned-file", baseDigest: currentManifest.digest, desiredDigest: sha256Digest(manifestBytes) }, ...target.assets.map((asset) => ({ path: asset.path, kind: "remove", ownership: asset.ownership ?? "owned-file", baseDigest: asset.digest }))];
+    const observedAssets = await Promise.all(changes.map((change) => observe(projectRoot, change.path)));
+    const capability = { schemaVersion: 1, capabilityId: release.capabilityId, version: release.version, integrity: release.integrity, assets: target.assets.map((asset) => ({ path: asset.path, ownership: asset.ownership ?? "owned-file", desiredDigest: asset.digest })), verifiers: release.verifiers.map((item) => ({ id: item.id, kind: "file-digest" })) };
+    const plan = buildChangePlan({ action: "remove", capability, changes, observedAssets, generatedAt: input.generatedAt, expiresAt: input.expiresAt });
+    return { plan, manifest: nextManifest, desiredContents: new Map([["project-capabilities.json", manifestBytes]]), transactionRoot: projectRoot, removedSources: [] };
+}
+async function observe(projectRoot, assetPath) {
+    try {
+        const bytes = await readFile(path.join(projectRoot, ...assetPath.split("/")));
+        return { path: assetPath, exists: true, digest: sha256Digest(bytes) };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { path: assetPath, exists: false };
+        throw error;
+    }
+}
+export async function planFeatureAdoption(input) {
+    if (input.release.release.schemaVersion === 2 && input.release.release.packageSources.length > 0 && input.packageSource === undefined) {
+        throw new FeatureSelectionError("CAPABILITY_RELEASE_VERSION_UNSUPPORTED", "Capability Release v2 requires verified package source facts");
+    }
+    const projectRoot = await realpath(path.resolve(input.projectRoot));
+    const manifest = parseProjectManifest(input.manifest);
+    const release = input.release.release;
+    const topology = input.packageSource?.topology;
+    const transactionRoot = topology?.transactionRoot ?? projectRoot;
+    const prefix = (assetPath) => topology?.mode === "pnpm-shared-lockfile" ? `${topology.unitRelativeRoot}/${assetPath}` : assetPath;
+    if (release.kind !== "engineering-feature" || release.consumerProfile !== "any-project") {
+        throw new FeatureSelectionError("CAPABILITY_KIND_UNSUPPORTED", "Only an addable engineering feature can use this lifecycle");
+    }
+    if (manifest.capabilities.some((item) => item.capabilityId === release.capabilityId)) {
+        throw new FeatureSelectionError("CAPABILITY_ALREADY_SELECTED", "The capability is already selected by this project");
+    }
+    const manifestProfile = manifest.profile?.id;
+    const profile = manifestProfile === "typescript-library" ? "blank-typescript-library" : manifestProfile;
+    const requiredProfiles = release.dependencies?.profiles ?? [];
+    const lockedProfile = input.currentLock.capabilities.find((item) => item.consumerProfile === profile);
+    if (profile === undefined || !requiredProfiles.includes(profile) || lockedProfile === undefined) {
+        throw new FeatureSelectionError("CAPABILITY_DEPENDENCY_UNSATISFIED", "The project profile does not satisfy this capability dependency");
+    }
+    const requiredCapabilities = release.dependencies?.capabilities ?? [];
+    if (requiredCapabilities.some((capabilityId) => !manifest.capabilities.some((item) => item.capabilityId === capabilityId) || !input.currentLock.capabilities.some((item) => item.capabilityId === capabilityId))) {
+        throw new FeatureSelectionError("CAPABILITY_DEPENDENCY_UNSATISFIED", "A required project capability is not adopted and verified");
+    }
+    const nextManifest = parseProjectManifest({
+        ...manifest,
+        capabilities: [...manifest.capabilities, { capabilityId: release.capabilityId, version: release.version }],
+    });
+    const manifestPath = prefix("project-capabilities.json");
+    const manifestBytes = Buffer.from(`${JSON.stringify(nextManifest, null, 2)}\n`);
+    const currentManifest = await observe(transactionRoot, manifestPath);
+    if (!currentManifest.exists || currentManifest.digest === undefined) {
+        throw new FeatureSelectionError("CAPABILITY_DEPENDENCY_UNSATISFIED", "The project manifest is unavailable");
+    }
+    const changes = [{ path: manifestPath, kind: "replace", ownership: "owned-file", baseDigest: currentManifest.digest, desiredDigest: sha256Digest(manifestBytes) }];
+    const desiredContents = new Map([[manifestPath, manifestBytes]]);
+    let packageAdoption;
+    if (release.schemaVersion === 2 && release.packageSources.length > 0) {
+        if (input.packageSource === undefined)
+            throw new FeatureSelectionError("CAPABILITY_RELEASE_VERSION_UNSUPPORTED", "Capability Release v2 requires verified package source facts");
+        let packageJson;
+        try {
+            packageJson = await readFile(path.join(projectRoot, "package.json"));
+        }
+        catch {
+            throw new FeatureSelectionError("CAPABILITY_PACKAGE_SOURCE_INVALID", "项目 package.json 不可用，无法生成包采用计划");
+        }
+        try {
+            const currentLockfile = input.packageSource.currentLockfile ?? await readFile(path.join(projectRoot, "pnpm-lock.yaml")).catch((error) => error.code === "ENOENT" ? undefined : Promise.reject(error));
+            const packageTopology = input.packageSource.topology ?? { schemaVersion: 1, mode: "standalone", transactionRoot: projectRoot, unitRoot: projectRoot, unitRelativeRoot: ".", unitImporterId: ".", lockfilePath: "pnpm-lock.yaml" };
+            const workspace = packageTopology.mode === "pnpm-shared-lockfile";
+            const topologyFacts = { mode: packageTopology.mode, unitRelativeRoot: packageTopology.unitRelativeRoot, unitImporterId: packageTopology.unitImporterId, lockfilePath: packageTopology.lockfilePath, ...(packageTopology.workspaceManifestPath ? { workspaceManifestPath: packageTopology.workspaceManifestPath, workspaceManifestDigest: packageTopology.workspaceManifestDigest } : {}) };
+            const sourceFacts = { registryConfigs: input.packageSource.registryConfigs, endpointBindings: input.packageSource.endpointBindings, receipts: input.packageSource.receipts, inspections: input.packageSource.inspections };
+            if (workspace && (!input.packageSource.resolutionEvidence || !input.packageSource.resolutionWorkerReleaseId))
+                throw new PackageAdoptionError("PACKAGE_SOURCE_POLICY_VIOLATION");
+            const packagePlan = workspace
+                ? (input.packageChannel === "development" ? buildWorkspaceDevelopmentPackageAdoptionPlan : buildWorkspacePackageAdoptionPlan)({ release: release, ...sourceFacts, consumerProfile: profile, packageJson, currentLockfile: currentLockfile, generatedAt: input.generatedAt, expiresAt: input.expiresAt, topology: topologyFacts, preservedImporterDigests: input.packageSource.preservedImporterDigests ?? [], resolutionEvidence: input.packageSource.resolutionEvidence, resolutionWorkerReleaseId: input.packageSource.resolutionWorkerReleaseId })
+                : (input.packageChannel === "development" ? buildDevelopmentPackageAdoptionPlan : buildPackageAdoptionPlan)({ release: release, ...sourceFacts, lockResolution: input.packageSource.lockResolution, consumerProfile: profile, packageJson, ...(currentLockfile === undefined ? {} : { currentLockfile }), generatedAt: input.generatedAt, expiresAt: input.expiresAt });
+            packageAdoption = packageAdoptionFacts(packagePlan);
+            changes.push({ path: prefix("package.json"), kind: "replace", ownership: "owned-file", baseDigest: packagePlan.packageJsonPreimageDigest, desiredDigest: packagePlan.desiredPackageJsonDigest });
+            desiredContents.set(prefix("package.json"), packagePlan.desiredPackageJson);
+            changes.push({ path: packageTopology.lockfilePath, kind: currentLockfile === undefined ? "create" : "replace", ownership: "owned-file", ...(currentLockfile === undefined ? {} : { baseDigest: sha256Digest(currentLockfile) }), desiredDigest: packagePlan.desiredLockfileDigest });
+            desiredContents.set(packageTopology.lockfilePath, packagePlan.desiredLockfile);
+        }
+        catch (error) {
+            if (error instanceof PackageAdoptionError)
+                throw new FeatureSelectionError("CAPABILITY_PACKAGE_SOURCE_INVALID", error.code);
+            throw error;
+        }
+    }
+    for (const asset of release.assets) {
+        const fragment = input.release.contents.get(asset.path);
+        if (fragment === undefined)
+            throw new FeatureSelectionError("CAPABILITY_KIND_UNSUPPORTED", "Capability asset content is unavailable");
+        const renderedFragment = asset.renderer === "application-config-contract-v1"
+            ? renderApplicationConfigContract(manifest)
+            : asset.renderer === "application-config-binding-v1"
+                ? renderApplicationConfigBinding(manifest)
+                : fragment;
+        if (asset.ownership === "managed-region") {
+            if (asset.regionId === undefined)
+                throw new FeatureSelectionError("CAPABILITY_KIND_UNSUPPORTED", "Managed region identity is unavailable");
+            let source;
+            try {
+                source = await readFile(path.join(projectRoot, ...asset.path.split("/")));
+            }
+            catch {
+                throw new FeatureSelectionError("CAPABILITY_DEPENDENCY_UNSATISFIED", "The managed shared file is unavailable");
+            }
+            const rendered = Buffer.from(renderMarkdownManagedRegion({ source: source.toString("utf8"), regionId: asset.regionId, content: Buffer.from(renderedFragment).toString("utf8") }));
+            changes.push({ path: prefix(asset.path), kind: "merge", ownership: "managed-region", regionId: asset.regionId, baseDigest: sha256Digest(source), desiredDigest: sha256Digest(rendered) });
+            desiredContents.set(prefix(asset.path), rendered);
+        }
+        else {
+            const current = await observe(projectRoot, asset.path);
+            if (asset.ownership === "seed-file" && current.exists) {
+                const bytes = await readFile(path.join(projectRoot, ...asset.path.split("/")));
+                changes.push({ path: prefix(asset.path), kind: "create", ownership: "seed-file", desiredDigest: sha256Digest(bytes) });
+                desiredContents.set(prefix(asset.path), bytes);
+            }
+            else {
+                changes.push({ path: prefix(asset.path), kind: "create", ownership: asset.ownership, desiredDigest: sha256Digest(renderedFragment) });
+                desiredContents.set(prefix(asset.path), renderedFragment);
+            }
+        }
+    }
+    const observedAssets = await Promise.all(changes.map((change) => observe(transactionRoot, change.path)));
+    const capability = { schemaVersion: 1, capabilityId: release.capabilityId, version: release.version, integrity: release.integrity, assets: changes.filter((change) => change.path !== manifestPath && change.path !== topology?.lockfilePath).map((change) => ({ path: topology?.mode === "pnpm-shared-lockfile" ? change.path.slice(topology.unitRelativeRoot.length + 1) : change.path, ownership: change.ownership, desiredDigest: change.desiredDigest })), verifiers: release.verifiers.map((item) => ({ id: item.id, kind: "file-digest" })) };
+    const plan = buildChangePlan({ action: "adopt", capability, changes, observedAssets, generatedAt: input.generatedAt, expiresAt: input.expiresAt, ...(packageAdoption === undefined ? {} : { packageAdoption }) });
+    return { plan, manifest: nextManifest, desiredContents, transactionRoot, dependency: { profile, satisfied: true } };
+}
+//# sourceMappingURL=feature-planner.js.map

package/dist/feature-planner.js.map

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

package/dist/filesystem-contracts.d.ts

@@ -0,0 +1,77 @@
+import type { ChangePlan } from "./contracts.js";
+import type { DurabilityTraceSink } from "./durability-trace.js";
+export type { DurabilityOperation, DurabilityPathCategory, DurabilityPhase, DurabilityResult, DurabilityTraceEvent, DurabilityTraceSink, } from "./durability-trace.js";
+export type TransactionState = "preparing" | "prepared" | "applying" | "applied" | "recovery-required" | "recovering" | "recovered";
+export type JournalOperation = {
+    index: number;
+    path: string;
+    kind: "create" | "replace" | "merge" | "remove";
+    before: {
+        kind: "absent";
+    } | {
+        kind: "present";
+        digest: string;
+        mode: number;
+        preimageDigest: string;
+    };
+    desiredDigest?: string;
+    status: "pending" | "applied" | "restored";
+};
+export type TransactionJournal = {
+    schemaVersion: 1;
+    transactionId: string;
+    planId: string;
+    approvedPlanId: string;
+    projectRootDigest: string;
+    state: TransactionState;
+    createdAt: string;
+    updatedAt: string;
+    operations: JournalOperation[];
+    failure?: {
+        code: string;
+        operationIndex?: number;
+    };
+    journalDigest: string;
+};
+export type TransactionLock = {
+    schemaVersion: 1;
+    transactionId: string;
+    planId: string;
+    startedAt: string;
+    nonce: string;
+};
+declare const preparedTransactionBrand: unique symbol;
+export type PreparedTransaction = {
+    readonly [preparedTransactionBrand]: true;
+    readonly projectRoot: string;
+    readonly plan: ChangePlan;
+    readonly transactionId: string;
+};
+export type PrepareApplyInput = {
+    projectRoot: string;
+    plan: ChangePlan;
+    approvedPlanId: string;
+    desiredContents: ReadonlyMap<string, Uint8Array>;
+    now: string;
+    limits?: {
+        maxFileBytes?: number;
+        maxTransactionBytes?: number;
+    };
+};
+export type TransactionSnapshot = {
+    transactionId: string;
+    planId: string;
+    state: TransactionState;
+    operations: ReadonlyArray<JournalOperation>;
+};
+export type ApplyCheckpoint = "prepared" | "temporary-file-synced" | "target-renamed-pending-directory-sync" | "target-renamed" | "operation-applied" | "operation-journaled" | "applied";
+export type ApplyHooks = {
+    onCheckpoint?: (checkpoint: ApplyCheckpoint, operationIndex?: number) => void | Promise<void>;
+    durabilityTrace?: DurabilityTraceSink;
+};
+export type PrepareCheckpoint = "lock-created" | "preimage-written-pending-directory-sync" | "preimage-persisted" | "journal-prepared";
+export type PrepareHooks = {
+    onCheckpoint?: (checkpoint: PrepareCheckpoint, operationIndex?: number) => void | Promise<void>;
+    durabilityTrace?: DurabilityTraceSink;
+};
+//# sourceMappingURL=filesystem-contracts.d.ts.map

package/dist/filesystem-contracts.d.ts.map

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

package/dist/filesystem-contracts.js

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

package/dist/filesystem-contracts.js.map

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

package/dist/filesystem-transaction.d.ts

@@ -0,0 +1,52 @@
+import type { ApplyHooks, PrepareApplyInput, PreparedTransaction, PrepareHooks, TransactionSnapshot } from "./filesystem-contracts.js";
+export type FilesystemTransactionErrorCode = "PLAN_APPROVAL_MISMATCH" | "PLAN_EXPIRED" | "PLAN_CONTENT_MISMATCH" | "PLAN_PRECONDITION_FAILED" | "PROJECT_ROOT_UNSAFE" | "PATH_SYMLINK_UNSAFE" | "OPERATION_UNSUPPORTED" | "TRANSACTION_ACTIVE" | "PREIMAGE_LIMIT_EXCEEDED" | "DESIRED_CONTENT_MISMATCH" | "APPLY_INTERRUPTED" | "RECOVERY_REQUIRED" | "JOURNAL_CORRUPTED" | "RECOVERY_CONFLICT";
+export declare class FilesystemTransactionError extends Error {
+    readonly code: FilesystemTransactionErrorCode;
+    readonly relativePath?: string | undefined;
+    readonly operationIndex?: number | undefined;
+    constructor(code: FilesystemTransactionErrorCode, message: string, relativePath?: string | undefined, operationIndex?: number | undefined);
+}
+export declare function prepareApplyWithHooks(input: PrepareApplyInput, hooks?: PrepareHooks): Promise<PreparedTransaction>;
+export declare function prepareApply(input: PrepareApplyInput): Promise<PreparedTransaction>;
+export declare function applyPreparedWithHooks(prepared: PreparedTransaction, hooks?: ApplyHooks): Promise<TransactionSnapshot>;
+export declare function applyPrepared(prepared: PreparedTransaction): Promise<TransactionSnapshot>;
+export declare function inspectTransaction(input: {
+    projectRoot: string;
+    planId: string;
+}): Promise<TransactionSnapshot | null>;
+export declare function recoverTransactionWithHooks(input: {
+    projectRoot: string;
+    planId: string;
+    now: string;
+    hooks?: ApplyHooks;
+    approvedConflicts?: readonly Readonly<{
+        path: string;
+        currentDigest: string;
+    }>[];
+}): Promise<TransactionSnapshot>;
+export declare function recoverTransaction(input: {
+    projectRoot: string;
+    planId: string;
+    now: string;
+}): Promise<TransactionSnapshot>;
+export declare function recoverTransactionWithApprovedConflicts(input: {
+    projectRoot: string;
+    planId: string;
+    now: string;
+    approvedConflicts: readonly Readonly<{
+        path: string;
+        currentDigest: string;
+    }>[];
+}): Promise<TransactionSnapshot>;
+/**
+ * Rolls back a fully applied transaction when a required external adoption step
+ * (for example package installation) fails. The same preimages and drift checks
+ * used by crash recovery apply; user changes are never overwritten.
+ */
+export declare function rollbackAppliedTransaction(input: {
+    projectRoot: string;
+    planId: string;
+    now: string;
+    failureCode: string;
+}): Promise<TransactionSnapshot>;
+//# sourceMappingURL=filesystem-transaction.d.ts.map

package/dist/filesystem-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-transaction.d.ts","sourceRoot":"","sources":["../src/filesystem-transaction.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EAGZ,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAmCnC,MAAM,MAAM,8BAA8B,GACtC,wBAAwB,GACxB,cAAc,GACd,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,yBAAyB,GACzB,0BAA0B,GAC1B,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,IAAI,EAAE,8BAA8B;IAE7C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM;gBAHvB,IAAI,EAAE,8BAA8B,EAC7C,OAAO,EAAE,MAAM,EACN,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,cAAc,CAAC,EAAE,MAAM,YAAA;CAInC;AA+RD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAkJ9B;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAEzF;AAqFD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,CAAC,EAAE,UAAU,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAoF9B;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAWD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAetC;AAWD,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,iBAAiB,CAAC,EAAE,SAAS,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,EAAG,CAAC;CACnF,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqJ/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE/B;AAED,wBAAsB,uCAAuC,CAAC,KAAK,EAAE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,SAAS,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,EAAG,CAAC;CAClF,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAG/B;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkB/B"}