@aipt/platform-kernel 0.1.5

package/dist/project-bootstrap.js

@@ -0,0 +1,270 @@
+import { link, open, lstat, mkdir, readFile, readdir, realpath, rm, unlink } from "node:fs/promises";
+import path from "node:path";
+import { canonicalize, sha256Digest } from "./integrity.js";
+import { buildChangePlan, calculatePlanId } from "./planner.js";
+import { parseChangePlan, parseProjectManifest } from "./schemas.js";
+import { inspectTransaction } from "./filesystem-transaction.js";
+export class ProjectBootstrapError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ProjectBootstrapError";
+    }
+}
+export const workspaceRootManifest = {
+    schemaVersion: 1,
+    profile: { id: "workspace-root", parameters: {} },
+    capabilities: [{ capabilityId: "foundation.workspace-root", version: "1.2.0" }],
+};
+export function workspaceRootManifestContents() {
+    return new TextEncoder().encode(`${JSON.stringify(workspaceRootManifest, null, 2)}\n`);
+}
+async function resolveExistingWorkspaceRoot(target, documentationOnly = false) {
+    const absolute = path.resolve(target);
+    const info = await lstat(absolute).catch(() => null);
+    if (info === null || !info.isDirectory() || info.isSymbolicLink()) {
+        throw new ProjectBootstrapError("TARGET_INVALID", "Workspace target must be a real existing directory");
+    }
+    const root = await realpath(absolute);
+    for (const marker of documentationOnly ? ["AGENTS.md", "README.md"] : ["package.json", "pnpm-workspace.yaml"]) {
+        const markerInfo = await lstat(path.join(root, marker)).catch(() => null);
+        if (markerInfo === null || !markerInfo.isFile() || markerInfo.isSymbolicLink()) {
+            throw new ProjectBootstrapError("WORKSPACE_MARKER_MISSING", `Existing workspace must contain a real ${marker}`);
+        }
+    }
+    if (await lstat(path.join(root, "project-capabilities.json")).catch(() => null)) {
+        throw new ProjectBootstrapError("MANIFEST_EXISTS", "Project manifest already exists");
+    }
+    return root;
+}
+export async function planExistingWorkspaceBootstrap(input) {
+    const projectRoot = await resolveExistingWorkspaceRoot(input.projectRoot, input.documentationOnly === true);
+    const contents = workspaceRootManifestContents();
+    const plan = buildChangePlan({
+        action: "adopt",
+        capability: {
+            schemaVersion: 1,
+            capabilityId: "foundation.workspace-root",
+            version: "1.2.0",
+            integrity: input.capabilityIntegrity,
+            assets: [],
+            verifiers: [],
+        },
+        changes: [{ path: "project-capabilities.json", kind: "create", ownership: "owned-file", desiredDigest: sha256Digest(contents) }],
+        observedAssets: [{ path: "project-capabilities.json", exists: false }],
+        generatedAt: input.generatedAt,
+        expiresAt: input.expiresAt,
+    });
+    return { projectRoot, plan, desiredContents: new Map([["project-capabilities.json", contents]]) };
+}
+async function syncDirectory(directory) {
+    const handle = await open(directory, "r");
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function atomicCreate(target, contents) {
+    const temporary = `${target}.tmp-${process.pid}-${crypto.randomUUID()}`;
+    const handle = await open(temporary, "wx", 0o600);
+    try {
+        await handle.writeFile(contents, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    try {
+        await link(temporary, target);
+        await unlink(temporary);
+        await syncDirectory(path.dirname(target));
+    }
+    catch (error) {
+        await rm(temporary, { force: true });
+        throw error;
+    }
+}
+async function prepareEmptyRoot(target) {
+    const absolute = path.resolve(target);
+    try {
+        const info = await lstat(absolute);
+        if (!info.isDirectory() || info.isSymbolicLink()) {
+            throw new ProjectBootstrapError("TARGET_INVALID", "Project target must be a real directory");
+        }
+        if ((await readdir(absolute)).length !== 0) {
+            throw new ProjectBootstrapError("TARGET_NOT_EMPTY", "Project target must be empty");
+        }
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        const parent = path.dirname(absolute);
+        const parentInfo = await lstat(parent).catch(() => null);
+        if (parentInfo === null || !parentInfo.isDirectory() || parentInfo.isSymbolicLink()) {
+            throw new ProjectBootstrapError("TARGET_INVALID", "Project target parent must be a real directory");
+        }
+        await mkdir(absolute);
+    }
+    return realpath(absolute);
+}
+export async function initializeProjectManifest(input) {
+    const manifest = parseProjectManifest(input.manifest);
+    const projectRoot = await prepareEmptyRoot(input.projectRoot);
+    const manifestPath = path.join(projectRoot, "project-capabilities.json");
+    try {
+        await atomicCreate(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    }
+    catch (error) {
+        if (error.code === "EEXIST") {
+            throw new ProjectBootstrapError("MANIFEST_EXISTS", "Project manifest already exists");
+        }
+        throw error;
+    }
+    return { projectRoot, manifest };
+}
+function assertPlanIntegrity(plan) {
+    const { planId: _planId, ...withoutId } = plan;
+    if (calculatePlanId(withoutId) !== plan.planId) {
+        throw new ProjectBootstrapError("PLAN_INTEGRITY_INVALID", "Saved plan integrity is invalid");
+    }
+}
+export async function saveProjectPlan(input) {
+    const projectRoot = await realpath(path.resolve(input.projectRoot));
+    const plan = parseChangePlan(input.plan);
+    assertPlanIntegrity(plan);
+    const plansDirectory = path.join(projectRoot, ".dyyto", "plans");
+    await mkdir(plansDirectory, { recursive: true, mode: 0o700 });
+    const planPath = path.join(plansDirectory, `${plan.planId}.json`);
+    try {
+        await atomicCreate(planPath, `${canonicalize(plan)}\n`);
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+        const existing = parseChangePlan(JSON.parse(await readFile(planPath, "utf8")));
+        assertPlanIntegrity(existing);
+        if (canonicalize(existing) !== canonicalize(plan)) {
+            throw new ProjectBootstrapError("PLAN_INTEGRITY_INVALID", "Plan ID content mismatch");
+        }
+    }
+    return planPath;
+}
+function planningFacts(plan) {
+    return canonicalize({
+        action: plan.action,
+        state: plan.state,
+        capability: plan.capability,
+        operations: plan.operations,
+        packageAdoption: plan.packageAdoption,
+    });
+}
+export async function saveOrReuseProjectPlan(input) {
+    const projectRoot = await realpath(path.resolve(input.projectRoot));
+    const transactionRoot = input.transactionRoot === undefined ? projectRoot : await realpath(path.resolve(input.transactionRoot));
+    const candidate = parseChangePlan(input.plan);
+    assertPlanIntegrity(candidate);
+    const plansDirectory = path.join(projectRoot, ".dyyto", "plans");
+    const names = await readdir(plansDirectory).catch((error) => {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    });
+    const reusable = [];
+    for (const name of names.filter((value) => value.endsWith(".json")).sort()) {
+        const stored = parseChangePlan(JSON.parse(await readFile(path.join(plansDirectory, name), "utf8")));
+        assertPlanIntegrity(stored);
+        const transactionConsumed = await lstat(path.join(transactionRoot, ".dyyto", "transactions", stored.planId)).then(() => true).catch((error) => error.code === "ENOENT" ? false : Promise.reject(error));
+        if (!transactionConsumed &&
+            Date.parse(stored.expiresAt) > Date.parse(input.now) &&
+            planningFacts(stored) === planningFacts(candidate)) {
+            reusable.push(stored);
+        }
+    }
+    reusable.sort((left, right) => left.generatedAt.localeCompare(right.generatedAt));
+    if (reusable[0] !== undefined)
+        return reusable[0];
+    await saveProjectPlan({ projectRoot, plan: candidate });
+    return candidate;
+}
+export async function readProjectPlan(input) {
+    const projectRoot = await realpath(path.resolve(input.projectRoot));
+    const planPath = path.join(projectRoot, ".dyyto", "plans", `${input.planId}.json`);
+    try {
+        const plan = parseChangePlan(JSON.parse(await readFile(planPath, "utf8")));
+        assertPlanIntegrity(plan);
+        if (plan.planId !== input.planId) {
+            throw new ProjectBootstrapError("PLAN_INTEGRITY_INVALID", "Saved plan identity mismatch");
+        }
+        return plan;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new ProjectBootstrapError("PLAN_NOT_FOUND", "Saved plan was not found");
+        }
+        throw error;
+    }
+}
+export async function readAppliedProjectPlan(projectRootInput, excludedPlanIds = [], transactionRootInput, lockedCapabilityIds = []) {
+    const projectRoot = await realpath(path.resolve(projectRootInput));
+    const transactionRoot = transactionRootInput === undefined ? projectRoot : await realpath(path.resolve(transactionRootInput));
+    const plansDirectory = path.join(projectRoot, ".dyyto", "plans");
+    const names = await readdir(plansDirectory).catch((error) => {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    });
+    const applied = [];
+    for (const name of names.filter((value) => value.endsWith(".json")).sort()) {
+        const planId = name.slice(0, -".json".length);
+        const plan = await readProjectPlan({ projectRoot, planId });
+        const transaction = await inspectTransaction({ projectRoot: transactionRoot, planId });
+        const metadataConsumed = await lstat(path.join(projectRoot, ".dyyto", "metadata-transactions", planId)).then(() => true).catch((error) => error.code === "ENOENT" ? false : Promise.reject(error));
+        if (transaction?.state === "applied" &&
+            !metadataConsumed &&
+            !excludedPlanIds.includes(plan.planId) &&
+            (!lockedCapabilityIds.includes(plan.capability.capabilityId) ||
+                plan.action === "upgrade" ||
+                plan.action === "remove" ||
+                (plan.action === "adopt" && plan.operations.every((operation) => operation.disposition === "noop")))) {
+            applied.push(plan);
+        }
+    }
+    const pending = pendingAppliedPlan(applied);
+    if (pending === undefined) {
+        throw new ProjectBootstrapError("PLAN_NOT_FOUND", applied.length === 0
+            ? "No applied plan is available for verification"
+            : "More than one applied plan requires inspection before verification");
+    }
+    return pending;
+}
+function pendingAppliedPlan(applied) {
+    if (applied.length === 1)
+        return applied[0];
+    if (applied.length === 0)
+        return undefined;
+    const capabilityId = applied[0]?.capability.capabilityId;
+    if (capabilityId === undefined || applied.some((plan) => plan.capability.capabilityId !== capabilityId))
+        return undefined;
+    return [...applied].sort((left, right) => left.generatedAt.localeCompare(right.generatedAt)).at(-1);
+}
+export async function listProjectPlans(projectRootInput) {
+    const projectRoot = await realpath(path.resolve(projectRootInput));
+    const plansDirectory = path.join(projectRoot, ".dyyto", "plans");
+    const names = await readdir(plansDirectory).catch((error) => {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    });
+    const plans = [];
+    for (const name of names.filter((value) => value.endsWith(".json")).sort()) {
+        plans.push(await readProjectPlan({
+            projectRoot,
+            planId: name.slice(0, -".json".length),
+        }));
+    }
+    return plans;
+}
+//# sourceMappingURL=project-bootstrap.js.map

package/dist/project-bootstrap.js.map

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

package/dist/project-control.d.ts

@@ -0,0 +1,149 @@
+import { type PlatformPackageSourceKind } from "./platform-package-sources.js";
+export type ManagedProjectCommand = "dev";
+export type ManagedProjectProcessState = "stopped" | "initializing" | "running" | "stopping" | "failed" | "stale";
+export type ManagedProjectProcessSnapshot = Readonly<{
+    schemaVersion: 1;
+    processId: string;
+    projectRoot: string;
+    command: ManagedProjectCommand;
+    pid: number;
+    startedAt: string;
+    logPath: string;
+    logOffset?: number;
+}>;
+export type CapabilitySelection = Readonly<{
+    capabilityId: string;
+    version: string;
+}>;
+export type LockedCapabilityIntegration = Readonly<{
+    capabilityId: string;
+    version: string;
+    evidenceIds?: readonly string[];
+}>;
+export type PlatformPackageDependency = Readonly<{
+    packageName: string;
+    version: string;
+    state: "unmanaged";
+    source: PlatformPackageSourceKind;
+}>;
+export type CapabilityIntegrationProjection = Readonly<{
+    template: Readonly<{
+        id: string;
+        version: string;
+    }> | null;
+    declared: readonly CapabilitySelection[];
+    locked: readonly LockedCapabilityIntegration[];
+    verified: readonly LockedCapabilityIntegration[];
+    platformDependencies: readonly PlatformPackageDependency[];
+}>;
+export type CapabilityIntegrationDetail = Readonly<{
+    capabilityId: string;
+    version: string;
+    status: "declared" | "locked" | "verified" | "drifted";
+    title: string;
+    purpose: string;
+    packages: readonly Readonly<{
+        packageName: string;
+        version: string;
+        usage: string;
+        installedVersion: string | null;
+        state: "matched" | "provided-by-platform" | "missing" | "version-mismatch" | "local-workspace";
+        imports: readonly Readonly<{
+            importFrom: string;
+            symbol: string;
+            referencePath?: string;
+        }>[];
+    }>[];
+    codeAssets: readonly Readonly<{
+        sourcePath: string;
+        targetPath: string;
+        ownership: string;
+    }>[];
+    evidenceIds: readonly string[];
+}>;
+export declare function auditCapabilityIntegrations(input: {
+    projection: CapabilityIntegrationProjection;
+    releases: readonly Readonly<{
+        capabilityId: string;
+        version: string;
+        integration?: {
+            title: string;
+            purpose: string;
+            packages: Array<{
+                packageName: string;
+                version: string;
+                usage: string;
+                imports: Array<{
+                    importFrom: string;
+                    symbol: string;
+                    referencePath?: string;
+                }>;
+            }>;
+            codeAssets: Array<{
+                sourcePath: string;
+                targetPath: string;
+                ownership: string;
+            }>;
+        };
+    }>[];
+    dependencies?: Readonly<Record<string, string>>;
+    hostDependencies?: Readonly<Record<string, string>>;
+}): Readonly<{
+    platformDependencies: readonly Readonly<{
+        packageName: string;
+        version: string;
+        state: "unmanaged";
+        source: PlatformPackageSourceKind;
+    }>[];
+    details: readonly Readonly<{
+        capabilityId: string;
+        version: string;
+        status: "declared" | "locked" | "verified" | "drifted";
+        title: string;
+        purpose: string;
+        packages: readonly Readonly<{
+            packageName: string;
+            version: string;
+            usage: string;
+            installedVersion: string | null;
+            state: "matched" | "provided-by-platform" | "missing" | "version-mismatch" | "local-workspace";
+            imports: readonly Readonly<{
+                importFrom: string;
+                symbol: string;
+                referencePath?: string;
+            }>[];
+        }>[];
+        codeAssets: readonly Readonly<{
+            sourcePath: string;
+            targetPath: string;
+            ownership: string;
+        }>[];
+        evidenceIds: readonly string[];
+    }>[];
+    findings: readonly {
+        code: string;
+        capabilityId: string;
+        packageName: string;
+        expected: string;
+        actual: string | null;
+    }[];
+    template: Readonly<{
+        id: string;
+        version: string;
+    }> | null;
+    declared: readonly CapabilitySelection[];
+    locked: readonly LockedCapabilityIntegration[];
+    verified: readonly LockedCapabilityIntegration[];
+}>;
+export declare class ProjectControlError extends Error {
+    readonly code: "PROJECT_COMMAND_UNSUPPORTED" | "PROJECT_PROCESS_ALREADY_RUNNING" | "PROJECT_PROCESS_IDENTITY_MISMATCH" | "PROJECT_PROCESS_START_FAILED" | "PROJECT_PROCESS_STOP_TIMEOUT";
+    constructor(code: "PROJECT_COMMAND_UNSUPPORTED" | "PROJECT_PROCESS_ALREADY_RUNNING" | "PROJECT_PROCESS_IDENTITY_MISMATCH" | "PROJECT_PROCESS_START_FAILED" | "PROJECT_PROCESS_STOP_TIMEOUT", message: string);
+}
+export declare function assertManagedProjectTransition(from: ManagedProjectProcessState, to: ManagedProjectProcessState): void;
+export declare function parseManagedProjectProcessSnapshot(value: unknown): ManagedProjectProcessSnapshot;
+export declare function projectCapabilityIntegrations(input: {
+    manifest: unknown;
+    lock?: unknown;
+    dependencies?: Readonly<Record<string, string>>;
+}): CapabilityIntegrationProjection;
+//# sourceMappingURL=project-control.d.ts.map

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

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

package/dist/project-control.js

@@ -0,0 +1,46 @@
+import { classifyPlatformPackageSpecifier } from "./platform-package-sources.js";
+export function auditCapabilityIntegrations(input) {
+    const locked = new Map(input.projection.locked.map((item) => [`${item.capabilityId}@${item.version}`, item]));
+    const verified = new Set(input.projection.verified.map((item) => `${item.capabilityId}@${item.version}`));
+    const details = input.projection.declared.map((selection) => {
+        const key = `${selection.capabilityId}@${selection.version}`;
+        const release = input.releases.find((item) => `${item.capabilityId}@${item.version}` === key);
+        const lock = locked.get(key);
+        const status = verified.has(key) ? "verified" : lock ? "locked" : "declared";
+        return Object.freeze({ capabilityId: selection.capabilityId, version: selection.version, status, title: release?.integration?.title ?? selection.capabilityId, purpose: release?.integration?.purpose ?? "该发行版尚未声明技术集成元数据。", packages: Object.freeze((release?.integration?.packages ?? []).map((item) => { const installedVersion = input.dependencies?.[item.packageName] ?? input.hostDependencies?.[item.packageName] ?? null; const hosted = input.dependencies?.[item.packageName] === undefined && input.hostDependencies?.[item.packageName] !== undefined; return Object.freeze({ ...item, imports: Object.freeze(item.imports.map((entry) => Object.freeze({ ...entry }))), installedVersion, state: hosted ? "provided-by-platform" : installedVersion === null ? "missing" : installedVersion === item.version || item.version === "workspace:*" ? "matched" : classifyPlatformPackageSpecifier(installedVersion) === "workspace" ? "local-workspace" : "version-mismatch" }); })), codeAssets: Object.freeze((release?.integration?.codeAssets ?? []).map((item) => Object.freeze({ ...item }))), evidenceIds: Object.freeze([...(lock?.evidenceIds ?? [])]) });
+    });
+    const managedPackages = new Set(details.flatMap((item) => item.packages.filter((entry) => entry.state === "matched" || entry.state === "local-workspace").map((entry) => entry.packageName)));
+    return Object.freeze({ ...input.projection, platformDependencies: Object.freeze(input.projection.platformDependencies.filter((entry) => !managedPackages.has(entry.packageName))), details: Object.freeze(details), findings: Object.freeze(details.flatMap((item) => item.packages.filter((entry) => entry.state !== "matched" && entry.state !== "provided-by-platform").map((entry) => ({ code: entry.state === "missing" ? "INTEGRATION_PACKAGE_MISSING" : entry.state === "local-workspace" ? "INTEGRATION_PACKAGE_SOURCE_LOCAL" : "INTEGRATION_PACKAGE_VERSION_MISMATCH", capabilityId: item.capabilityId, packageName: entry.packageName, expected: entry.version, actual: entry.installedVersion })))) });
+}
+export class ProjectControlError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export function assertManagedProjectTransition(from, to) {
+    const allowed = {
+        stopped: ["initializing"], initializing: ["running", "failed", "stale"], running: ["stopping", "failed", "stale"], stopping: ["stopped", "failed", "stale"], failed: ["initializing", "stopped"], stale: ["stopped"],
+    };
+    if (!allowed[from].includes(to))
+        throw new ProjectControlError("PROJECT_PROCESS_IDENTITY_MISMATCH", `Managed project process cannot transition from ${from} to ${to}`);
+}
+export function parseManagedProjectProcessSnapshot(value) {
+    if (value === null || typeof value !== "object")
+        throw new ProjectControlError("PROJECT_PROCESS_IDENTITY_MISMATCH", "Managed process snapshot is invalid");
+    const item = value;
+    if (item.schemaVersion !== 1 || typeof item.processId !== "string" || item.processId.length < 1 || typeof item.projectRoot !== "string" || item.command !== "dev" || !Number.isSafeInteger(item.pid) || item.pid < 1 || typeof item.startedAt !== "string" || Number.isNaN(Date.parse(item.startedAt)) || typeof item.logPath !== "string" || item.logOffset !== undefined && (!Number.isSafeInteger(item.logOffset) || item.logOffset < 0))
+        throw new ProjectControlError("PROJECT_PROCESS_IDENTITY_MISMATCH", "Managed process snapshot is invalid");
+    return Object.freeze(item);
+}
+export function projectCapabilityIntegrations(input) {
+    const manifest = input.manifest;
+    const declared = Array.isArray(manifest?.capabilities) ? manifest.capabilities.filter((item) => item !== null && typeof item === "object" && typeof item.capabilityId === "string" && typeof item.version === "string").map((item) => Object.freeze({ capabilityId: item.capabilityId, version: item.version })) : [];
+    const lock = input.lock;
+    const locked = Array.isArray(lock?.capabilities) ? lock.capabilities.filter((item) => item !== null && typeof item === "object" && typeof item.capabilityId === "string" && typeof item.version === "string").map((item) => Object.freeze({ capabilityId: item.capabilityId, version: item.version, ...(Array.isArray(item.evidenceIds) ? { evidenceIds: Object.freeze([...item.evidenceIds]) } : {}) })) : [];
+    const platformDependencies = Object.entries(input.dependencies ?? {}).filter(([name]) => name.startsWith("@aipt/")).sort(([left], [right]) => left.localeCompare(right)).map(([packageName, version]) => Object.freeze({ packageName, version, state: "unmanaged", source: classifyPlatformPackageSpecifier(version) }));
+    const template = manifest?.template !== undefined && typeof manifest.template.id === "string" && typeof manifest.template.version === "string" ? Object.freeze({ id: manifest.template.id, version: manifest.template.version }) : null;
+    return Object.freeze({ template, declared: Object.freeze(declared), locked: Object.freeze(locked), verified: Object.freeze(locked.filter((item) => (item.evidenceIds?.length ?? 0) > 0)), platformDependencies: Object.freeze(platformDependencies) });
+}
+//# sourceMappingURL=project-control.js.map

package/dist/project-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-control.js","sourceRoot":"","sources":["../src/project-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAkC,MAAM,+BAA+B,CAAC;AA4BjH,MAAM,UAAU,2BAA2B,CAAC,KAAmgB;IAC7iB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAkC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACzF,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QAAC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC;QAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1L,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QAC7E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,kBAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,gBAAgB,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,MAAM,GAAC,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAG,SAAS,IAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAG,SAAS,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,sBAA+B,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,gCAAgC,CAAC,gBAAgB,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,iBAA0B,CAAC,CAAC,CAAC,kBAA2B,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACppC,CAAC,CAAC,CAAC;IACH,MAAM,eAAe,GAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAC,EAAE,CAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAC,EAAE,CAAA,KAAK,CAAC,KAAK,KAAG,SAAS,IAAE,KAAK,CAAC,KAAK,KAAG,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAC,EAAE,CAAA,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAChL,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,oBAAoB,EAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAC,EAAE,CAAA,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,sBAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,iBAAiB,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,sCAAsC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjrB,CAAC;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACvB;IAArB,YAAqB,IAA+K,EAAE,OAAe;QAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAAnN,SAAI,GAAJ,IAAI,CAA2K;IAAqC,CAAC;CAC3O;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAgC,EAAE,EAA8B;IAC7G,MAAM,OAAO,GAA8E;QACzF,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC;KACrN,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,EAAE,kDAAkD,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AACzK,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,EAAE,qCAAqC,CAAC,CAAC;IAC3J,MAAM,IAAI,GAAG,KAA+C,CAAC;IAC7D,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAI,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAG,SAAS,IAAE,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAE,IAAI,CAAC,SAAS,GAAC,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,EAAE,qCAAqC,CAAC,CAAC;IAChhB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAqC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAA6F;IACzI,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAsF,CAAC;IAC9G,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAA+B,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAQ,IAA4B,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAQ,IAA4B,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrY,MAAM,IAAI,GAAG,KAAK,CAAC,IAA8C,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAuC,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAQ,IAAoC,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAQ,IAAoC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtf,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,WAAoB,EAAE,MAAM,EAAE,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAClU,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxO,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;AACzP,CAAC"}

package/dist/project-maintenance.d.ts

@@ -0,0 +1,30 @@
+export type MaintenanceCommand = "dev" | "build" | "test" | "package";
+export type EnvironmentRequirement = Readonly<{
+    name: string;
+    requirement: "optional" | "conditional";
+    secret: boolean;
+    configured: boolean;
+    source: ".env.example" | "application-config-contract";
+    configuredSource: "APP_CONFIG_DIR" | null;
+    display?: string;
+    fingerprint?: string;
+}>;
+export type ProjectMaintenanceProjection = Readonly<{
+    commands: readonly Readonly<{
+        id: MaintenanceCommand;
+        script: string;
+        mode: "managed-process" | "foreground-task";
+    }>[];
+    environment: readonly EnvironmentRequirement[];
+    environmentExample: string | null;
+    productionValidation: Readonly<{
+        contract: true;
+        live: readonly ("provider-read" | "oss-write-read-delete")[];
+    }>;
+}>;
+export declare function parseEnvironmentExample(source: string): EnvironmentRequirement[];
+export declare function projectMaintenanceProjection(input: {
+    projectRoot: string;
+    commands: Partial<Record<MaintenanceCommand, string>>;
+}): Promise<ProjectMaintenanceProjection>;
+//# sourceMappingURL=project-maintenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-maintenance.d.ts","sourceRoot":"","sources":["../src/project-maintenance.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,6BAA6B,CAAC;IAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC1R,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,QAAQ,EAAE,SAAS,QAAQ,CAAC;QAAE,EAAE,EAAE,kBAAkB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAAA;KAAE,CAAC,EAAE,CAAC;IACvH,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC/C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,EAAE,QAAQ,CAAC;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,SAAS,CAAC,eAAe,GAAG,uBAAuB,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;CAClH,CAAC,CAAC;AAKH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAShF;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAW/K"}

package/dist/project-maintenance.js

@@ -0,0 +1,29 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { projectApplicationConfig } from "./application-config-binding.js";
+const environmentName = /^[A-Z][A-Z0-9_]*$/u;
+const secretName = /(?:API_KEY|ACCESS_KEY|SECRET|TOKEN|PASSWORD|PRIVATE_KEY|DATABASE_URL|POSTGRES_URL)$/u;
+export function parseEnvironmentExample(source) {
+    const requirements = new Map();
+    for (const line of source.split(/\r?\n/u)) {
+        const match = /^([A-Z][A-Z0-9_]*)=(.*)$/u.exec(line.trim());
+        if (!match || !environmentName.test(match[1]))
+            continue;
+        const name = match[1], defaultValue = match[2].trim();
+        requirements.set(name, { name, requirement: defaultValue.length === 0 ? "conditional" : "optional", secret: secretName.test(name), configured: false, source: ".env.example", configuredSource: null });
+    }
+    return [...requirements.values()];
+}
+export async function projectMaintenanceProjection(input) {
+    const environmentExample = await readFile(path.join(input.projectRoot, ".env.example"), "utf8").then(() => ".env.example").catch(() => null);
+    const source = environmentExample ? await readFile(path.join(input.projectRoot, environmentExample), "utf8") : "";
+    const external = await projectApplicationConfig({ projectRoot: input.projectRoot }).catch(() => null);
+    const order = ["dev", "build", "test", "package"];
+    return {
+        commands: order.flatMap((id) => input.commands[id] ? [{ id, script: input.commands[id], mode: id === "dev" ? "managed-process" : "foreground-task" }] : []),
+        environment: external ? external.entries.map((entry) => ({ name: entry.name, requirement: entry.required ? "conditional" : "optional", secret: entry.kind !== "value", configured: entry.configured, source: "application-config-contract", configuredSource: "APP_CONFIG_DIR", display: entry.display, ...(entry.fingerprint ? { fingerprint: entry.fingerprint } : {}) })) : parseEnvironmentExample(source),
+        environmentExample,
+        productionValidation: { contract: true, live: ["provider-read", "oss-write-read-delete"] },
+    };
+}
+//# sourceMappingURL=project-maintenance.js.map

package/dist/project-maintenance.js.map

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

package/dist/project-recovery.d.ts

@@ -0,0 +1,31 @@
+import { type MetadataCommitState } from "./adoption-metadata.js";
+import type { TransactionSnapshot } from "./filesystem-contracts.js";
+export type ProjectRecoveryInspection = {
+    required: false;
+} | {
+    required: true;
+    kind: "filesystem" | "metadata";
+    planId: string;
+    state: TransactionSnapshot["state"] | MetadataCommitState;
+};
+export declare function inspectProjectRecovery(projectRoot: string): Promise<ProjectRecoveryInspection>;
+export declare function recoverProject(input: {
+    projectRoot: string;
+    now: string;
+}): Promise<{
+    kind: "none";
+    state: "not-required";
+} | {
+    kind: "filesystem";
+    planId: string;
+    state: TransactionSnapshot["state"];
+} | {
+    kind: "metadata";
+    planId: string;
+    state: "committed";
+}>;
+export declare function recoverProjectTransactionTopology(input: {
+    projectRoot: string;
+    now: string;
+}): Promise<Awaited<ReturnType<typeof recoverProject>>>;
+//# sourceMappingURL=project-recovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-recovery.d.ts","sourceRoot":"","sources":["../src/project-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIrE,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GACnB;IACE,QAAQ,EAAE,IAAI,CAAC;IACf,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC;CAC3D,CAAC;AAUN,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAyBpC;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CACP;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAC3D,CAaA;AAED,wBAAsB,iCAAiC,CAAC,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CASxJ"}