@aipt/platform-kernel 0.1.5

package/dist/package-release.d.ts

@@ -0,0 +1,42 @@
+export type PackageReleaseMaturity = "candidate" | "stable" | "deprecated";
+export interface PackageReleaseArtifact {
+    readonly fileName: string;
+    readonly digest: string;
+    readonly integrity: string;
+    readonly fileCount: number;
+    readonly unpackedBytes: number;
+}
+export interface PackageRelease {
+    readonly schemaVersion: 1;
+    readonly kind: "PackageRelease";
+    readonly packageName: string;
+    readonly version: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly maturity: PackageReleaseMaturity;
+    readonly source: {
+        readonly repository: string;
+        readonly path: string;
+        readonly revision: string;
+        readonly treeDigest: string;
+    };
+    readonly artifact: PackageReleaseArtifact | null;
+    readonly compatibility: {
+        readonly node: string;
+        readonly packageManager: string;
+    };
+    readonly exports: readonly string[];
+    readonly documentation: {
+        readonly readme: string;
+        readonly knowledgeRef?: string;
+    };
+    readonly consumerEvidence: readonly string[];
+    readonly releaseDigest: string;
+}
+export declare class PackageReleaseError extends Error {
+    readonly code: "PACKAGE_RELEASE_INVALID" | "PACKAGE_RELEASE_MODIFIED";
+    constructor(code: "PACKAGE_RELEASE_INVALID" | "PACKAGE_RELEASE_MODIFIED", message: string);
+}
+export declare function createPackageRelease(input: Omit<PackageRelease, "schemaVersion" | "kind" | "releaseDigest">): PackageRelease;
+export declare function parsePackageRelease(value: unknown): PackageRelease;
+//# sourceMappingURL=package-release.d.ts.map

package/dist/package-release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-release.d.ts","sourceRoot":"","sources":["../src/package-release.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,GAAG,0BAA0B;gBAA5D,IAAI,EAAE,yBAAyB,GAAG,0BAA0B,EAAE,OAAO,EAAE,MAAM;CAGnG;AAkDD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,GAAG,MAAM,GAAG,eAAe,CAAC,GAAG,cAAc,CAc5H;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAMlE"}

package/dist/package-release.js

@@ -0,0 +1,85 @@
+import { canonicalize, sha256Digest } from "./integrity.js";
+export class PackageReleaseError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+const digestPattern = /^sha256:[a-f0-9]{64}$/u;
+const integrityPattern = /^sha512-[A-Za-z0-9+/]{86}==$/u;
+const packagePattern = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u;
+const versionPattern = /^(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?$/u;
+const controlPattern = /[\u0000-\u001f\u007f]/u;
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+function exactKeys(value, expected) {
+    const actual = Object.keys(value).sort();
+    const sorted = [...expected].sort();
+    return actual.length === sorted.length && actual.every((key, index) => key === sorted[index]);
+}
+function text(value, maximum = 500) {
+    return typeof value === "string" && value.length > 0 && value.length <= maximum && !controlPattern.test(value);
+}
+function safeRelative(value) {
+    return text(value, 500) && !value.startsWith("/") && !value.startsWith("../") && !value.includes("/../") && !value.includes("\\");
+}
+function sortedUniqueStrings(value, maximum = 128) {
+    return Array.isArray(value) && value.length <= maximum && value.every((entry) => text(entry, 500)) && value.every((entry, index) => index === 0 || value[index - 1] < entry);
+}
+function validArtifact(value) {
+    if (value === null)
+        return true;
+    if (!record(value) || !exactKeys(value, ["fileName", "digest", "integrity", "fileCount", "unpackedBytes"]))
+        return false;
+    return safeRelative(value.fileName) && digestPattern.test(String(value.digest)) && integrityPattern.test(String(value.integrity)) && Number.isSafeInteger(value.fileCount) && Number(value.fileCount) > 0 && Number.isSafeInteger(value.unpackedBytes) && Number(value.unpackedBytes) > 0;
+}
+function releaseContent(value) {
+    if (!record(value) || !exactKeys(value, ["schemaVersion", "kind", "packageName", "version", "title", "summary", "maturity", "source", "artifact", "compatibility", "exports", "documentation", "consumerEvidence"]))
+        return false;
+    if (value.schemaVersion !== 1 || value.kind !== "PackageRelease" || !packagePattern.test(value.packageName) || !versionPattern.test(value.version))
+        return false;
+    if (!text(value.title, 120) || !text(value.summary, 1000) || !["candidate", "stable", "deprecated"].includes(value.maturity))
+        return false;
+    if (!record(value.source) || !exactKeys(value.source, ["repository", "path", "revision", "treeDigest"]) || !text(value.source.repository) || !safeRelative(value.source.path) || !text(value.source.revision, 200) || !digestPattern.test(String(value.source.treeDigest)))
+        return false;
+    if (!validArtifact(value.artifact))
+        return false;
+    if (!record(value.compatibility) || !exactKeys(value.compatibility, ["node", "packageManager"]) || !text(value.compatibility.node, 100) || !text(value.compatibility.packageManager, 100))
+        return false;
+    if (!sortedUniqueStrings(value.exports) || !sortedUniqueStrings(value.consumerEvidence))
+        return false;
+    if (!record(value.documentation))
+        return false;
+    const docKeys = value.documentation.knowledgeRef === undefined ? ["readme"] : ["readme", "knowledgeRef"];
+    if (!exactKeys(value.documentation, docKeys) || !safeRelative(value.documentation.readme) || (value.documentation.knowledgeRef !== undefined && !text(value.documentation.knowledgeRef, 500)))
+        return false;
+    return value.artifact !== null || value.maturity !== "stable";
+}
+export function createPackageRelease(input) {
+    const content = {
+        schemaVersion: 1,
+        kind: "PackageRelease",
+        ...input,
+        source: Object.freeze({ ...input.source }),
+        artifact: input.artifact === null ? null : Object.freeze({ ...input.artifact }),
+        compatibility: Object.freeze({ ...input.compatibility }),
+        exports: Object.freeze([...input.exports]),
+        documentation: Object.freeze({ ...input.documentation }),
+        consumerEvidence: Object.freeze([...input.consumerEvidence]),
+    };
+    if (!releaseContent(content))
+        throw new PackageReleaseError("PACKAGE_RELEASE_INVALID", "PackageRelease 内容无效");
+    return Object.freeze({ ...content, releaseDigest: sha256Digest(canonicalize(content)) });
+}
+export function parsePackageRelease(value) {
+    if (!record(value) || !exactKeys(value, ["schemaVersion", "kind", "packageName", "version", "title", "summary", "maturity", "source", "artifact", "compatibility", "exports", "documentation", "consumerEvidence", "releaseDigest"]) || !digestPattern.test(String(value.releaseDigest)))
+        throw new PackageReleaseError("PACKAGE_RELEASE_INVALID", "PackageRelease 结构无效");
+    const { releaseDigest, schemaVersion: _schemaVersion, kind: _kind, ...input } = value;
+    const recreated = createPackageRelease(input);
+    if (recreated.releaseDigest !== releaseDigest)
+        throw new PackageReleaseError("PACKAGE_RELEASE_MODIFIED", "PackageRelease 已被修改");
+    return recreated;
+}
+//# sourceMappingURL=package-release.js.map

package/dist/package-release.js.map

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

package/dist/plan-state.d.ts

@@ -0,0 +1,10 @@
+import type { PlanState } from "./contracts.js";
+export declare class InvalidPlanTransitionError extends Error {
+    readonly from: PlanState;
+    readonly to: PlanState;
+    readonly code = "PLAN_TRANSITION_INVALID";
+    constructor(from: PlanState, to: PlanState);
+}
+export declare function transitionPlan(from: PlanState, to: PlanState): PlanState;
+export declare function canTransitionPlan(from: PlanState, to: PlanState): boolean;
+//# sourceMappingURL=plan-state.d.ts.map

package/dist/plan-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-state.d.ts","sourceRoot":"","sources":["../src/plan-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAgBhD,qBAAa,0BAA2B,SAAQ,KAAK;IAGvC,QAAQ,CAAC,IAAI,EAAE,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,SAAS;IAF5D,QAAQ,CAAC,IAAI,6BAA6B;gBAErB,IAAI,EAAE,SAAS,EAAW,EAAE,EAAE,SAAS;CAG7D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAKxE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAEzE"}

package/dist/plan-state.js

@@ -0,0 +1,33 @@
+const transitions = {
+    created: ["reviewable", "conflicted", "expired"],
+    reviewable: ["approved", "expired"],
+    conflicted: [],
+    approved: ["applying", "expired"],
+    applying: ["applied", "failed", "recovery-required"],
+    applied: ["verified", "failed", "recovery-required"],
+    verified: [],
+    failed: ["recovery-required"],
+    "recovery-required": ["recovered"],
+    recovered: [],
+    expired: [],
+};
+export class InvalidPlanTransitionError extends Error {
+    from;
+    to;
+    code = "PLAN_TRANSITION_INVALID";
+    constructor(from, to) {
+        super(`Plan cannot transition from ${from} to ${to}`);
+        this.from = from;
+        this.to = to;
+    }
+}
+export function transitionPlan(from, to) {
+    if (!transitions[from].includes(to)) {
+        throw new InvalidPlanTransitionError(from, to);
+    }
+    return to;
+}
+export function canTransitionPlan(from, to) {
+    return transitions[from].includes(to);
+}
+//# sourceMappingURL=plan-state.js.map

package/dist/plan-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-state.js","sourceRoot":"","sources":["../src/plan-state.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAsD;IACrE,OAAO,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC;IAChD,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IACnC,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IACjC,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IACpD,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IACpD,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,CAAC,mBAAmB,CAAC;IAC7B,mBAAmB,EAAE,CAAC,WAAW,CAAC;IAClC,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAG9B;IAA0B;IAFtC,IAAI,GAAG,yBAAyB,CAAC;IAE1C,YAAqB,IAAe,EAAW,EAAa;QAC1D,KAAK,CAAC,+BAA+B,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;QADnC,SAAI,GAAJ,IAAI,CAAW;QAAW,OAAE,GAAF,EAAE,CAAW;IAE5D,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,EAAa;IAC3D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,0BAA0B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,EAAa;IAC9D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/planner.d.ts

@@ -0,0 +1,19 @@
+import type { CapabilityRelease, ChangePlan, ObservedAsset, PlanAction, ProposedChange } from "./contracts.js";
+export declare class PlanInputError extends Error {
+    readonly assetPath?: string | undefined;
+    readonly code = "PLAN_PRECONDITION_FAILED";
+    constructor(message: string, assetPath?: string | undefined);
+}
+export type BuildPlanInput = {
+    action: PlanAction;
+    capability: CapabilityRelease;
+    changes: ProposedChange[];
+    observedAssets: ObservedAsset[];
+    generatedAt: string;
+    expiresAt: string;
+    packageAdoption?: import("./contracts.js").PackageAdoptionPlanFacts;
+};
+export declare function assertSafeRelativePath(assetPath: string): void;
+export declare function buildChangePlan(input: BuildPlanInput): ChangePlan;
+export declare function calculatePlanId(plan: Omit<ChangePlan, "planId">): string;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EAEb,UAAU,EACV,cAAc,EACf,MAAM,gBAAgB,CAAC;AAGxB,qBAAa,cAAe,SAAQ,KAAK;IAGV,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAFxD,QAAQ,CAAC,IAAI,8BAA8B;gBAE/B,OAAO,EAAE,MAAM,EAAW,SAAS,CAAC,EAAE,MAAM,YAAA;CAGzD;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,gBAAgB,EAAE,wBAAwB,CAAC;CACrE,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAU9D;AAsCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CA4DjE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,MAAM,CAExE"}

package/dist/planner.js

@@ -0,0 +1,111 @@
+import path from "node:path";
+import { capabilityIdPattern } from "./contracts.js";
+import { canonicalize, sha256Digest } from "./integrity.js";
+export class PlanInputError extends Error {
+    assetPath;
+    code = "PLAN_PRECONDITION_FAILED";
+    constructor(message, assetPath) {
+        super(message);
+        this.assetPath = assetPath;
+    }
+}
+export function assertSafeRelativePath(assetPath) {
+    if (assetPath.length === 0 ||
+        path.posix.isAbsolute(assetPath) ||
+        path.win32.isAbsolute(assetPath) ||
+        assetPath.includes("\\") ||
+        assetPath.split("/").some((segment) => segment === ".." || segment === ".")) {
+        throw new PlanInputError("Asset path must be a normalized project-relative POSIX path", assetPath);
+    }
+}
+function planOperation(change, observed) {
+    assertSafeRelativePath(change.path);
+    const managedMerge = change.kind === "merge" && change.ownership === "managed-region" && change.regionId !== undefined && new RegExp(capabilityIdPattern).test(change.regionId);
+    if ((change.kind === "merge" || change.ownership === "managed-region" || change.regionId !== undefined) && !managedMerge) {
+        throw new PlanInputError("Managed regions require merge ownership and a valid region identity", change.path);
+    }
+    if (change.ownership === "user-file") {
+        return { ...change, disposition: "conflict", conflictCode: "USER_OWNED" };
+    }
+    const exists = observed?.exists ?? false;
+    const currentDigest = observed?.digest;
+    if (change.kind === "create") {
+        if (!exists)
+            return { ...change, disposition: "ready" };
+        if (change.desiredDigest !== undefined && currentDigest === change.desiredDigest) {
+            return { ...change, disposition: "noop" };
+        }
+        return { ...change, disposition: "conflict", conflictCode: "UNEXPECTED_EXISTING" };
+    }
+    if (change.kind === "remove" && !exists) {
+        return { ...change, disposition: "noop" };
+    }
+    if (change.kind !== "remove" && exists && change.desiredDigest === currentDigest) {
+        return { ...change, disposition: "noop" };
+    }
+    if (!exists || change.baseDigest === undefined || currentDigest !== change.baseDigest) {
+        return { ...change, disposition: "conflict", conflictCode: "BASE_DIGEST_MISMATCH" };
+    }
+    return { ...change, disposition: "ready" };
+}
+export function buildChangePlan(input) {
+    if (Number.isNaN(Date.parse(input.generatedAt)) || Number.isNaN(Date.parse(input.expiresAt))) {
+        throw new PlanInputError("Plan timestamps must be valid ISO date-time values");
+    }
+    if (Date.parse(input.expiresAt) <= Date.parse(input.generatedAt)) {
+        throw new PlanInputError("Plan expiry must be later than generation time");
+    }
+    const observed = new Map();
+    for (const asset of input.observedAssets) {
+        assertSafeRelativePath(asset.path);
+        if (observed.has(asset.path)) {
+            throw new PlanInputError("Observed asset paths must be unique", asset.path);
+        }
+        observed.set(asset.path, asset);
+    }
+    const seenChanges = new Set();
+    const operations = input.changes
+        .map((change) => {
+        if (seenChanges.has(change.path)) {
+            throw new PlanInputError("Proposed change paths must be unique", change.path);
+        }
+        seenChanges.add(change.path);
+        return planOperation(change, observed.get(change.path));
+    })
+        .sort((left, right) => left.path.localeCompare(right.path));
+    const inputFacts = {
+        action: input.action,
+        capability: {
+            capabilityId: input.capability.capabilityId,
+            version: input.capability.version,
+            integrity: input.capability.integrity,
+        },
+        changes: input.changes,
+        observedAssets: input.observedAssets,
+        generatedAt: input.generatedAt,
+        expiresAt: input.expiresAt,
+        ...(input.packageAdoption === undefined ? {} : { packageAdoption: input.packageAdoption }),
+    };
+    const inputDigest = sha256Digest(canonicalize(inputFacts));
+    const planWithoutId = {
+        schemaVersion: 1,
+        action: input.action,
+        state: operations.some((operation) => operation.disposition === "conflict")
+            ? "conflicted"
+            : "reviewable",
+        capability: inputFacts.capability,
+        generatedAt: input.generatedAt,
+        expiresAt: input.expiresAt,
+        inputDigest,
+        operations,
+        ...(input.packageAdoption === undefined ? {} : { packageAdoption: input.packageAdoption }),
+    };
+    return {
+        ...planWithoutId,
+        planId: sha256Digest(canonicalize(planWithoutId)),
+    };
+}
+export function calculatePlanId(plan) {
+    return sha256Digest(canonicalize(plan));
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/platform-package-sources.d.ts

@@ -0,0 +1,49 @@
+export type PlatformPackageSourceKind = "workspace" | "registry" | "other";
+export type PlatformPackageManifestField = "dependencies" | "devDependencies" | "optionalDependencies" | "peerDependencies";
+export type PlatformPackageReference = Readonly<{
+    importer: string;
+    field: PlatformPackageManifestField;
+    packageName: string;
+    specifier: string;
+    source: PlatformPackageSourceKind;
+}>;
+export type PlatformPackageSourceAudit = Readonly<{
+    scope: string;
+    required: PlatformPackageSourceKind | null;
+    references: readonly PlatformPackageReference[];
+    violations: readonly PlatformPackageReference[];
+}>;
+export declare class PlatformPackageSourceError extends Error {
+    readonly code: "PLATFORM_PACKAGE_MANIFEST_INVALID" | "PLATFORM_PACKAGE_SCOPE_INVALID" | "PLATFORM_PACKAGE_SPECIFIER_INVALID" | "PLATFORM_PACKAGE_REWRITE_UNSAFE";
+    constructor(code: "PLATFORM_PACKAGE_MANIFEST_INVALID" | "PLATFORM_PACKAGE_SCOPE_INVALID" | "PLATFORM_PACKAGE_SPECIFIER_INVALID" | "PLATFORM_PACKAGE_REWRITE_UNSAFE");
+}
+export declare function classifyPlatformPackageSpecifier(specifier: string): PlatformPackageSourceKind;
+export declare function auditPlatformPackageReferences(input: Readonly<{
+    manifests: readonly Readonly<{
+        relativeRoot: string;
+        bytes: Uint8Array;
+    }>[];
+    scope: string;
+    required?: PlatformPackageSourceKind;
+}>): PlatformPackageSourceAudit;
+export type PlatformPackageSwitchChange = Readonly<{
+    field: PlatformPackageManifestField;
+    packageName: string;
+    from: string;
+    to: string;
+}>;
+export type PlatformPackageSwitchPlan = Readonly<{
+    scope: string;
+    changes: readonly PlatformPackageSwitchChange[];
+    manifest: Uint8Array;
+}>;
+/**
+ * Rewrites only the specifier values of in-scope dependencies, leaving every other byte of the
+ * manifest untouched, then re-parses the result and fails closed unless it matches exactly.
+ */
+export declare function planPlatformPackageSwitch(input: Readonly<{
+    manifest: Uint8Array;
+    scope: string;
+    specifiers: Readonly<Record<string, string>>;
+}>): PlatformPackageSwitchPlan;
+//# sourceMappingURL=platform-package-sources.d.ts.map

package/dist/platform-package-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-package-sources.d.ts","sourceRoot":"","sources":["../src/platform-package-sources.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAC3E,MAAM,MAAM,4BAA4B,GAAG,cAAc,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;AAE5H,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,4BAA4B,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,yBAAyB,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC3C,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChD,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,mCAAmC,GAAG,gCAAgC,GAAG,oCAAoC,GAAG,iCAAiC;gBAAvJ,IAAI,EAAE,mCAAmC,GAAG,gCAAgC,GAAG,oCAAoC,GAAG,iCAAiC;CAC7K;AAMD,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAI7F;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC7D,SAAS,EAAE,SAAS,QAAQ,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,EAAE,CAAC;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,yBAAyB,CAAC;CACtC,CAAC,GAAG,0BAA0B,CAqB9B;AAED,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,4BAA4B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC3I,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAa3I;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC,GAAG,yBAAyB,CAuB3K"}

package/dist/platform-package-sources.js

@@ -0,0 +1,98 @@
+export class PlatformPackageSourceError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "PlatformPackageSourceError";
+    }
+}
+const manifestFields = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
+const externalSpecifier = /^(?:file:|link:|portal:|git(?:\+|:)|https?:|ssh:|github:)/u;
+const scopePattern = /^@[a-z0-9][a-z0-9._-]*\/$/u;
+export function classifyPlatformPackageSpecifier(specifier) {
+    if (specifier.startsWith("workspace:"))
+        return "workspace";
+    if (externalSpecifier.test(specifier))
+        return "other";
+    return "registry";
+}
+export function auditPlatformPackageReferences(input) {
+    if (!scopePattern.test(input.scope))
+        throw new PlatformPackageSourceError("PLATFORM_PACKAGE_SCOPE_INVALID");
+    const references = [];
+    for (const manifest of input.manifests) {
+        let parsed;
+        try {
+            parsed = JSON.parse(Buffer.from(manifest.bytes).toString("utf8"));
+        }
+        catch {
+            throw new PlatformPackageSourceError("PLATFORM_PACKAGE_MANIFEST_INVALID");
+        }
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+            throw new PlatformPackageSourceError("PLATFORM_PACKAGE_MANIFEST_INVALID");
+        for (const field of manifestFields) {
+            const entries = parsed[field];
+            if (entries === undefined)
+                continue;
+            if (typeof entries !== "object" || entries === null || Array.isArray(entries))
+                throw new PlatformPackageSourceError("PLATFORM_PACKAGE_MANIFEST_INVALID");
+            for (const [packageName, specifier] of Object.entries(entries)) {
+                if (!packageName.startsWith(input.scope))
+                    continue;
+                if (typeof specifier !== "string" || specifier.trim() === "")
+                    throw new PlatformPackageSourceError("PLATFORM_PACKAGE_MANIFEST_INVALID");
+                references.push(Object.freeze({ importer: manifest.relativeRoot, field, packageName, specifier, source: classifyPlatformPackageSpecifier(specifier) }));
+            }
+        }
+    }
+    references.sort((left, right) => left.importer.localeCompare(right.importer) || left.field.localeCompare(right.field) || left.packageName.localeCompare(right.packageName));
+    const required = input.required ?? null;
+    return Object.freeze({ scope: input.scope, required, references: Object.freeze(references), violations: Object.freeze(required === null ? [] : references.filter((item) => item.source !== required)) });
+}
+const specifierPattern = /^(?:workspace:[*^~]?|(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?)$/u;
+function escapeRegExp(value) { return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&"); }
+function manifestObject(bytes) {
+    let parsed;
+    try {
+        parsed = JSON.parse(Buffer.from(bytes).toString("utf8"));
+    }
+    catch {
+        throw new PlatformPackageSourceError("PLATFORM_PACKAGE_MANIFEST_INVALID");
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+        throw new PlatformPackageSourceError("PLATFORM_PACKAGE_MANIFEST_INVALID");
+    return parsed;
+}
+/**
+ * Rewrites only the specifier values of in-scope dependencies, leaving every other byte of the
+ * manifest untouched, then re-parses the result and fails closed unless it matches exactly.
+ */
+export function planPlatformPackageSwitch(input) {
+    const references = auditPlatformPackageReferences({ manifests: [{ relativeRoot: ".", bytes: input.manifest }], scope: input.scope }).references;
+    for (const specifier of Object.values(input.specifiers))
+        if (!specifierPattern.test(specifier))
+            throw new PlatformPackageSourceError("PLATFORM_PACKAGE_SPECIFIER_INVALID");
+    const missing = references.filter((item) => input.specifiers[item.packageName] === undefined);
+    if (missing.length > 0)
+        throw new PlatformPackageSourceError("PLATFORM_PACKAGE_SPECIFIER_INVALID");
+    const changes = references.filter((item) => input.specifiers[item.packageName] !== item.specifier)
+        .map((item) => Object.freeze({ field: item.field, packageName: item.packageName, from: item.specifier, to: input.specifiers[item.packageName] }));
+    if (changes.length === 0)
+        return Object.freeze({ scope: input.scope, changes: Object.freeze([]), manifest: input.manifest });
+    const original = manifestObject(input.manifest);
+    let text = Buffer.from(input.manifest).toString("utf8");
+    for (const change of new Map(changes.map((item) => [`${item.packageName}\u0000${item.from}`, item])).values())
+        text = text.replace(new RegExp(`("${escapeRegExp(JSON.stringify(change.packageName).slice(1, -1))}"\\s*:\\s*")${escapeRegExp(change.from)}(")`, "gu"), `$1${change.to}$2`);
+    const expected = { ...original };
+    for (const field of manifestFields) {
+        const entries = original[field];
+        if (entries === undefined)
+            continue;
+        expected[field] = Object.fromEntries(Object.entries(entries).map(([name, specifier]) => [name, name.startsWith(input.scope) ? input.specifiers[name] : specifier]));
+    }
+    const rewritten = new TextEncoder().encode(text);
+    if (JSON.stringify(manifestObject(rewritten)) !== JSON.stringify(expected))
+        throw new PlatformPackageSourceError("PLATFORM_PACKAGE_REWRITE_UNSAFE");
+    return Object.freeze({ scope: input.scope, changes: Object.freeze(changes), manifest: rewritten });
+}
+//# sourceMappingURL=platform-package-sources.js.map

package/dist/platform-package-sources.js.map

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

package/dist/project-bootstrap.d.ts

@@ -0,0 +1,42 @@
+import type { ChangePlan, ProjectManifest } from "./contracts.js";
+export declare class ProjectBootstrapError extends Error {
+    readonly code: "TARGET_INVALID" | "TARGET_NOT_EMPTY" | "WORKSPACE_MARKER_MISSING" | "MANIFEST_EXISTS" | "PLAN_INTEGRITY_INVALID" | "PLAN_NOT_FOUND";
+    constructor(code: "TARGET_INVALID" | "TARGET_NOT_EMPTY" | "WORKSPACE_MARKER_MISSING" | "MANIFEST_EXISTS" | "PLAN_INTEGRITY_INVALID" | "PLAN_NOT_FOUND", message: string);
+}
+export declare const workspaceRootManifest: ProjectManifest;
+export declare function workspaceRootManifestContents(): Uint8Array;
+export declare function planExistingWorkspaceBootstrap(input: {
+    projectRoot: string;
+    capabilityIntegrity: string;
+    generatedAt: string;
+    expiresAt: string;
+    documentationOnly?: boolean;
+}): Promise<{
+    projectRoot: string;
+    plan: ChangePlan;
+    desiredContents: ReadonlyMap<string, Uint8Array>;
+}>;
+export declare function initializeProjectManifest(input: {
+    projectRoot: string;
+    manifest: unknown;
+}): Promise<{
+    projectRoot: string;
+    manifest: ProjectManifest;
+}>;
+export declare function saveProjectPlan(input: {
+    projectRoot: string;
+    plan: unknown;
+}): Promise<string>;
+export declare function saveOrReuseProjectPlan(input: {
+    projectRoot: string;
+    plan: unknown;
+    now: string;
+    transactionRoot?: string;
+}): Promise<ChangePlan>;
+export declare function readProjectPlan(input: {
+    projectRoot: string;
+    planId: string;
+}): Promise<ChangePlan>;
+export declare function readAppliedProjectPlan(projectRootInput: string, excludedPlanIds?: readonly string[], transactionRootInput?: string, lockedCapabilityIds?: readonly string[]): Promise<ChangePlan>;
+export declare function listProjectPlans(projectRootInput: string): Promise<ChangePlan[]>;
+//# sourceMappingURL=project-bootstrap.d.ts.map

package/dist/project-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap.d.ts","sourceRoot":"","sources":["../src/project-bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMlE,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,IAAI,EACT,gBAAgB,GAChB,kBAAkB,GAClB,0BAA0B,GAC1B,iBAAiB,GACjB,wBAAwB,GACxB,gBAAgB;gBANX,IAAI,EACT,gBAAgB,GAChB,kBAAkB,GAClB,0BAA0B,GAC1B,iBAAiB,GACjB,wBAAwB,GACxB,gBAAgB,EACpB,OAAO,EAAE,MAAM;CAKlB;AAED,eAAO,MAAM,qBAAqB,EAAE,eAInC,CAAC;AAEF,wBAAgB,6BAA6B,IAAI,UAAU,CAE1D;AAqBD,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,CAAC,CAmBvG;AAoDD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAC,CAa9D;AASD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlB;AAYD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BtB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBtB;AAED,wBAAsB,sBAAsB,CAC1C,gBAAgB,EAAE,MAAM,EACxB,eAAe,GAAE,SAAS,MAAM,EAAO,EACvC,oBAAoB,CAAC,EAAE,MAAM,EAC7B,mBAAmB,GAAE,SAAS,MAAM,EAAO,GAC1C,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAUD,wBAAsB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiBtF"}