@lesliechan721/aw 0.1.0-beta.3 → 0.1.0-beta.31

package/dist/src/utils/catalog-generation-control-snapshot.js

@@ -0,0 +1,45 @@
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { readCatalogGenerationState } from './catalog-generation-state.js';
+import { calculateCatalogSourceIdentity } from './catalog-source-identity.js';
+import { readCatalogSourcesConfigSnapshot, } from './catalog-sources.js';
+const MAX_CONTROL_SNAPSHOT_RETRIES = 3;
+function identityMismatch() {
+    return new CatalogGenerationError({
+        code: 'catalogGenerationIdentityMismatch',
+        message: 'Catalog source configuration changed while generation state was being read. Retry the operation.',
+    });
+}
+async function sourceIdentities(snapshot) {
+    return Object.fromEntries(await Promise.all(snapshot.config.sources.map(async (source) => [
+        source.id,
+        await calculateCatalogSourceIdentity(source),
+    ])));
+}
+export async function readCatalogGenerationControlSnapshot(options = {}) {
+    const env = options.env ?? process.env;
+    if (options.configSnapshot) {
+        const generationState = await readCatalogGenerationState(env);
+        const currentConfig = await readCatalogSourcesConfigSnapshot(env);
+        if (currentConfig.digest !== options.configSnapshot.digest)
+            throw identityMismatch();
+        return {
+            configSnapshot: options.configSnapshot,
+            generationState,
+            sourceIdentities: await sourceIdentities(options.configSnapshot),
+        };
+    }
+    for (let attempt = 0; attempt <= MAX_CONTROL_SNAPSHOT_RETRIES; attempt += 1) {
+        const configSnapshot = await readCatalogSourcesConfigSnapshot(env);
+        const generationState = await readCatalogGenerationState(env);
+        const currentConfig = await readCatalogSourcesConfigSnapshot(env);
+        if (currentConfig.digest === configSnapshot.digest) {
+            return {
+                configSnapshot,
+                generationState,
+                sourceIdentities: await sourceIdentities(configSnapshot),
+            };
+        }
+    }
+    throw identityMismatch();
+}
+//# sourceMappingURL=catalog-generation-control-snapshot.js.map

package/dist/src/utils/catalog-generation-control-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generation-control-snapshot.js","sourceRoot":"","sources":["../../../src/utils/catalog-generation-control-snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EACL,gCAAgC,GAEjC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAQvC,SAAS,gBAAgB;IACvB,OAAO,IAAI,sBAAsB,CAAC;QAChC,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE,kGAAkG;KAC5G,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,QAAsC;IAEtC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;QACxF,MAAM,CAAC,EAAE;QACT,MAAM,8BAA8B,CAAC,MAAM,CAAC;KAC7C,CAAC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CAAC,UAGvD,EAAE;IACJ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,eAAe,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,gCAAgC,CAAC,GAAG,CAAC,CAAC;QAClE,IAAI,aAAa,CAAC,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM;YAAE,MAAM,gBAAgB,EAAE,CAAC;QACrF,OAAO;YACL,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,eAAe;YACf,gBAAgB,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,cAAc,CAAC;SACjE,CAAC;IACJ,CAAC;IAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,4BAA4B,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,cAAc,GAAG,MAAM,gCAAgC,CAAC,GAAG,CAAC,CAAC;QACnE,MAAM,eAAe,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,gCAAgC,CAAC,GAAG,CAAC,CAAC;QAClE,IAAI,aAAa,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YACnD,OAAO;gBACL,cAAc;gBACd,eAAe;gBACf,gBAAgB,EAAE,MAAM,gBAAgB,CAAC,cAAc,CAAC;aACzD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,gBAAgB,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/utils/catalog-generation-error.d.ts

@@ -0,0 +1,16 @@
+export type CatalogGenerationErrorCode = 'catalogSourcesConfigInvalid' | 'catalogSourcesConfigRecoveryStale' | 'catalogSourcesConfigRecoveryFailed' | 'catalogGenerationStateInvalid' | 'catalogGenerationMetadataInvalid' | 'catalogGenerationUnavailable' | 'catalogGenerationSourceMissing' | 'catalogGenerationIdentityMismatch' | 'catalogGenerationReviewStale' | 'catalogReplaceDamagedRequired' | 'catalogGenerationActiveComparisonUnavailable' | 'catalogLogicalIdentityChanged' | 'catalogVersionConflict' | 'catalogRollbackDetected' | 'catalogImpactConfirmationRequired' | 'catalogGenerationRefreshFailed' | 'catalogGenerationPublishFailed';
+export declare class CatalogGenerationError extends Error {
+    readonly code: CatalogGenerationErrorCode;
+    readonly sourceId?: string;
+    readonly impact?: CatalogSourceImpact;
+    constructor(options: {
+        code: CatalogGenerationErrorCode;
+        message: string;
+        sourceId?: string;
+        cause?: unknown;
+        impact?: CatalogSourceImpact;
+    });
+}
+export declare function catalogGenerationErrorCode(error: unknown): string;
+export declare function isOfflineCleanupCatalogGenerationError(error: unknown): boolean;
+import type { CatalogSourceImpact } from '../types.js';

package/dist/src/utils/catalog-generation-error.js

@@ -0,0 +1,30 @@
+export class CatalogGenerationError extends Error {
+    code;
+    sourceId;
+    impact;
+    constructor(options) {
+        super(options.message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'CatalogGenerationError';
+        this.code = options.code;
+        this.sourceId = options.sourceId;
+        this.impact = options.impact;
+    }
+}
+export function catalogGenerationErrorCode(error) {
+    return error instanceof CatalogGenerationError
+        ? error.code
+        : 'catalogGenerationFailed';
+}
+const OFFLINE_CLEANUP_ERROR_CODES = new Set([
+    'catalogSourcesConfigInvalid',
+    'catalogGenerationStateInvalid',
+    'catalogGenerationMetadataInvalid',
+    'catalogGenerationUnavailable',
+    'catalogGenerationSourceMissing',
+    'catalogGenerationIdentityMismatch',
+]);
+export function isOfflineCleanupCatalogGenerationError(error) {
+    return error instanceof CatalogGenerationError
+        && OFFLINE_CLEANUP_ERROR_CODES.has(error.code);
+}
+//# sourceMappingURL=catalog-generation-error.js.map

package/dist/src/utils/catalog-generation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-generation-error.js","sourceRoot":"","sources":["../../../src/utils/catalog-generation-error.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,CAA6B;IACjC,QAAQ,CAAU;IAClB,MAAM,CAAuB;IAEtC,YAAY,OAMX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,KAAK,YAAY,sBAAsB;QAC5C,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,yBAAyB,CAAC;AAChC,CAAC;AAED,MAAM,2BAA2B,GAA4C,IAAI,GAAG,CAAC;IACnF,6BAA6B;IAC7B,+BAA+B;IAC/B,kCAAkC;IAClC,8BAA8B;IAC9B,gCAAgC;IAChC,mCAAmC;CACpC,CAAC,CAAC;AAEH,MAAM,UAAU,sCAAsC,CAAC,KAAc;IACnE,OAAO,KAAK,YAAY,sBAAsB;WACzC,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/utils/catalog-generation-resolver.d.ts

@@ -0,0 +1,44 @@
+import type { CatalogGenerationActiveV1, CatalogGenerationSet, CatalogGenerationSetSource, PluginMeta } from '../types.js';
+import { type CatalogGenerationControlSnapshot } from './catalog-generation-control-snapshot.js';
+import { type CatalogStoreEntry } from './catalog-generation-store.js';
+export interface ResolvedActiveCatalogGeneration extends CatalogGenerationSetSource {
+    active: CatalogGenerationActiveV1;
+}
+export interface ResolvedActiveCatalogPluginShallow {
+    sourceId: string;
+    sourceIdentity: string;
+    logicalIdentity: string;
+    catalogVersion: string;
+    snapshotPath: string;
+    plugin: PluginMeta;
+}
+export declare function readValidatedCatalogGenerationStoreEntry(options: {
+    logicalIdentity: string;
+    snapshotDigest: string;
+    env: NodeJS.ProcessEnv;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+}): Promise<CatalogStoreEntry>;
+interface ResolveActiveCatalogGenerationOptions {
+    sourceId: string;
+    env?: NodeJS.ProcessEnv;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+}
+export declare function resolveActiveCatalogGeneration(options: ResolveActiveCatalogGenerationOptions): Promise<ResolvedActiveCatalogGeneration>;
+/** @internal Complete Active evidence for freshness checks before consumer compatibility gating. */
+export declare function resolveValidatedActiveCatalogGeneration(options: ResolveActiveCatalogGenerationOptions): Promise<ResolvedActiveCatalogGeneration>;
+export declare function resolveActiveCatalogPluginShallow(options: {
+    sourceId: string;
+    pluginName: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ResolvedActiveCatalogPluginShallow>;
+export declare function calculateCatalogGenerationSetDigest(configDigest: string, primarySourceId: string, sources: CatalogGenerationSetSource[]): string;
+export declare function resolveCatalogGenerationSet(options?: {
+    sourceIds?: string[];
+    env?: NodeJS.ProcessEnv;
+    controlSnapshot?: CatalogGenerationControlSnapshot;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+}): Promise<CatalogGenerationSet>;
+export {};

package/dist/src/utils/catalog-generation-resolver.js

@@ -0,0 +1,273 @@
+import crypto from 'node:crypto';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { IMPLEMENTED_AW_CAPABILITIES } from '../commands/aw-capabilities.js';
+import { projectCatalogCapabilityCompatibility } from './catalog-capability-projection.js';
+import { CatalogGenerationError } from './catalog-generation-error.js';
+import { readCatalogGenerationControlSnapshot, } from './catalog-generation-control-snapshot.js';
+import { CatalogProviderCompatibilityError } from './catalog-public-error.js';
+import { createCatalogStoreKey, readCatalogSnapshotLogicalIdentity, readCatalogStoreMetadata, readCatalogStoreEntry, resolveCatalogStoreLocation, } from './catalog-generation-store.js';
+import { calculateCatalogSourceConfigFingerprint } from './catalog-source-identity.js';
+import { validatePluginManifest } from './manifest.js';
+import { validateCatalogManifestV7 } from './catalog-manifest-v7.js';
+import { calculateFileDigest } from './bundle-integrity.js';
+import { calculateCatalogEntryArtifactDigest, calculateCatalogEntryContentDigest, } from './catalog-digests.js';
+import { CURRENT_CATALOG_MANIFEST_FILE } from '../constants.js';
+export async function readValidatedCatalogGenerationStoreEntry(options) {
+    const storeKey = createCatalogStoreKey(options.logicalIdentity, options.snapshotDigest);
+    const cached = options.validatedStoreEntries?.get(storeKey);
+    if (cached)
+        return cached;
+    let pending = options.validatingStoreEntries?.get(storeKey);
+    if (!pending) {
+        pending = readCatalogStoreEntry({
+            logicalIdentity: options.logicalIdentity,
+            snapshotDigest: options.snapshotDigest,
+            env: options.env,
+        });
+        options.validatingStoreEntries?.set(storeKey, pending);
+    }
+    try {
+        const entry = await pending;
+        options.validatedStoreEntries?.set(storeKey, entry);
+        return entry;
+    }
+    finally {
+        if (options.validatingStoreEntries?.get(storeKey) === pending) {
+            options.validatingStoreEntries.delete(storeKey);
+        }
+    }
+}
+async function assertRegularDirectory(value, label) {
+    const stats = await fs.lstat(value);
+    if (!stats.isDirectory() || stats.isSymbolicLink()) {
+        throw new Error(`${label} must be a regular directory.`);
+    }
+}
+async function assertRegularFile(value, label) {
+    const stats = await fs.lstat(value);
+    if (!stats.isFile() || stats.isSymbolicLink()) {
+        throw new Error(`${label} must be a regular file.`);
+    }
+}
+async function resolveFromState(options) {
+    if (!options.active) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationUnavailable',
+            sourceId: options.source.id,
+            message: `Catalog source "${options.source.id}" has no Active snapshot. Run aw catalog source sync ${options.source.id}.`,
+        });
+    }
+    const fingerprint = calculateCatalogSourceConfigFingerprint(options.source);
+    if (options.active.sourceIdentity !== options.sourceIdentity
+        || options.active.sourceConfigFingerprint !== fingerprint)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            sourceId: options.source.id,
+            message: `Active Catalog snapshot for source "${options.source.id}" does not match the current source configuration. Run aw catalog source sync ${options.source.id}.`,
+        });
+    const storeKey = createCatalogStoreKey(options.active.logicalIdentity, options.active.snapshotDigest);
+    const entry = await readValidatedCatalogGenerationStoreEntry({
+        logicalIdentity: options.active.logicalIdentity,
+        snapshotDigest: options.active.snapshotDigest,
+        env: options.env,
+        validatedStoreEntries: options.validatedStoreEntries,
+        validatingStoreEntries: options.validatingStoreEntries,
+    });
+    if (entry.metadata.manifestDigest !== options.active.manifestDigest) {
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationIdentityMismatch',
+            sourceId: options.source.id,
+            message: `Active Catalog snapshot for source "${options.source.id}" does not match store metadata. Run aw catalog source sync ${options.source.id}.`,
+        });
+    }
+    const compatibility = projectCatalogCapabilityCompatibility(entry.metadata.requiredAwCapabilities);
+    if (options.requireCompatibility && compatibility.state === 'unsupported') {
+        throw new CatalogProviderCompatibilityError({
+            sourceId: options.source.id,
+            requiredCapabilities: compatibility.requiredCapabilities,
+            missingCapabilities: compatibility.missingCapabilities,
+            availableCapabilities: IMPLEMENTED_AW_CAPABILITIES,
+        });
+    }
+    return {
+        sourceId: options.source.id,
+        sourceConfigFingerprint: options.active.sourceConfigFingerprint,
+        sourceIdentity: options.active.sourceIdentity,
+        logicalIdentity: options.active.logicalIdentity,
+        catalogVersion: entry.metadata.catalogVersion,
+        resolvedCommit: options.active.resolvedCommit,
+        manifestDigest: options.active.manifestDigest,
+        snapshotDigest: options.active.snapshotDigest,
+        storeKey,
+        snapshotPath: entry.snapshotRoot,
+        manifest: entry.manifest,
+        active: options.active,
+    };
+}
+async function resolveActiveCatalogGenerationWithPolicy(options, requireCompatibility) {
+    const env = options.env ?? process.env;
+    const control = await readCatalogGenerationControlSnapshot({ env });
+    const source = control.configSnapshot.config.sources.find((entry) => entry.id === options.sourceId);
+    if (!source)
+        throw new CatalogGenerationError({
+            code: 'catalogGenerationSourceMissing',
+            sourceId: options.sourceId,
+            message: `Catalog source "${options.sourceId}" is not configured.`,
+        });
+    return resolveFromState({
+        source,
+        sourceIdentity: control.sourceIdentities[source.id],
+        active: control.generationState.sources[source.id]?.active,
+        env,
+        requireCompatibility,
+        validatedStoreEntries: options.validatedStoreEntries,
+        validatingStoreEntries: options.validatingStoreEntries,
+    });
+}
+export async function resolveActiveCatalogGeneration(options) {
+    return resolveActiveCatalogGenerationWithPolicy(options, true);
+}
+/** @internal Complete Active evidence for freshness checks before consumer compatibility gating. */
+export async function resolveValidatedActiveCatalogGeneration(options) {
+    return resolveActiveCatalogGenerationWithPolicy(options, false);
+}
+export async function resolveActiveCatalogPluginShallow(options) {
+    const env = options.env ?? process.env;
+    const control = await readCatalogGenerationControlSnapshot({ env });
+    const source = control.configSnapshot.config.sources.find((entry) => entry.id === options.sourceId);
+    const active = control.generationState.sources[options.sourceId]?.active;
+    if (!source || !active)
+        throw new Error('Selected Catalog source has no Active snapshot.');
+    const sourceIdentity = control.sourceIdentities[source.id];
+    if (active.sourceIdentity !== sourceIdentity
+        || active.sourceConfigFingerprint !== calculateCatalogSourceConfigFingerprint(source)) {
+        throw new Error('Active Catalog snapshot does not match the selected source configuration.');
+    }
+    const location = resolveCatalogStoreLocation({
+        logicalIdentity: active.logicalIdentity,
+        snapshotDigest: active.snapshotDigest,
+        env,
+    });
+    const metadata = await readCatalogStoreMetadata({
+        logicalIdentity: active.logicalIdentity,
+        snapshotDigest: active.snapshotDigest,
+        env,
+    });
+    if (metadata.manifestDigest !== active.manifestDigest
+        || metadata.logicalIdentity !== active.logicalIdentity
+        || metadata.snapshotDigest !== active.snapshotDigest) {
+        throw new Error('Active Catalog snapshot does not match its content-addressed store metadata.');
+    }
+    await assertRegularDirectory(location.storeRootDir, 'Catalog store root');
+    await assertRegularDirectory(location.logicalIdentityDirectory, 'Catalog logical identity store');
+    await assertRegularDirectory(location.entryDir, 'Catalog store entry');
+    await assertRegularDirectory(location.snapshotRoot, 'Catalog snapshot');
+    if (await readCatalogSnapshotLogicalIdentity(location.snapshotRoot) !== active.logicalIdentity) {
+        throw new Error('Catalog snapshot logical identity does not match Active state.');
+    }
+    const manifestPath = path.join(location.snapshotRoot, CURRENT_CATALOG_MANIFEST_FILE);
+    await assertRegularFile(manifestPath, 'Catalog manifest');
+    if (await calculateFileDigest(manifestPath) !== active.manifestDigest) {
+        throw new Error('Catalog manifest does not match Active state.');
+    }
+    const rawManifest = await fs.readJson(manifestPath);
+    const rawEntries = Array.isArray(rawManifest.entries) ? rawManifest.entries : [];
+    const rawEntry = rawEntries.find((entry) => entry !== null
+        && typeof entry === 'object'
+        && !Array.isArray(entry)
+        && entry.name === options.pluginName);
+    if (!rawEntry)
+        throw new Error('Selected plugin is absent from the local Active snapshot.');
+    const manifest = validateCatalogManifestV7({ ...rawManifest, entries: [rawEntry] });
+    if (manifest.catalogVersion !== metadata.catalogVersion
+        || manifest.channel !== metadata.channel
+        || JSON.stringify(manifest.requires.aw.capabilities ?? [])
+            !== JSON.stringify(metadata.requiredAwCapabilities)) {
+        throw new Error('Catalog manifest does not match store metadata.');
+    }
+    const entry = manifest.entries[0];
+    const pluginsRoot = path.join(location.snapshotRoot, 'plugins');
+    const pluginRoot = path.resolve(pluginsRoot, entry.name);
+    if (path.dirname(pluginRoot) !== path.resolve(pluginsRoot)) {
+        throw new Error('Selected plugin path escapes the Catalog snapshot.');
+    }
+    await assertRegularDirectory(pluginsRoot, 'Catalog plugins root');
+    await assertRegularDirectory(pluginRoot, 'Selected plugin bundle');
+    const pluginManifestPath = path.join(pluginRoot, '.agents-plugin', 'plugin.json');
+    await assertRegularFile(pluginManifestPath, 'Selected plugin manifest');
+    const rawPluginManifest = await fs.readJson(pluginManifestPath);
+    const shallowManifestInput = { ...rawPluginManifest };
+    delete shallowManifestInput.dependencies;
+    const normalizedPluginManifest = validatePluginManifest(pluginRoot, shallowManifestInput);
+    const plugin = {
+        rootDir: pluginRoot,
+        manifestPath: pluginManifestPath,
+        manifest: normalizedPluginManifest,
+    };
+    if (plugin.manifest.name !== options.pluginName || plugin.manifest.version !== entry.version) {
+        throw new Error('Selected plugin bundle identity does not match its Catalog entry.');
+    }
+    const artifactDigest = await calculateCatalogEntryArtifactDigest(pluginRoot);
+    const contentDigest = await calculateCatalogEntryContentDigest(pluginRoot);
+    if (artifactDigest !== entry.artifactDigest
+        || contentDigest !== entry.contentDigest) {
+        throw new Error('Selected plugin bundle does not match its Catalog entry.');
+    }
+    return {
+        sourceId: source.id,
+        sourceIdentity,
+        logicalIdentity: active.logicalIdentity,
+        catalogVersion: metadata.catalogVersion,
+        snapshotPath: location.snapshotRoot,
+        plugin,
+    };
+}
+export function calculateCatalogGenerationSetDigest(configDigest, primarySourceId, sources) {
+    const identity = sources.map((source) => ({
+        sourceId: source.sourceId,
+        sourceConfigFingerprint: source.sourceConfigFingerprint,
+        logicalIdentity: source.logicalIdentity,
+        snapshotDigest: source.snapshotDigest,
+        storeKey: source.storeKey,
+    }));
+    return `sha256:${crypto.createHash('sha256').update(JSON.stringify({
+        configDigest,
+        primarySourceId,
+        sources: identity,
+    })).digest('hex')}`;
+}
+export async function resolveCatalogGenerationSet(options = {}) {
+    const env = options.env ?? process.env;
+    const control = options.controlSnapshot ?? await readCatalogGenerationControlSnapshot({ env });
+    const requested = options.sourceIds ? new Set(options.sourceIds) : undefined;
+    if (requested) {
+        const configured = new Set(control.configSnapshot.config.sources.map((source) => source.id));
+        const missing = options.sourceIds.find((sourceId) => !configured.has(sourceId));
+        if (missing)
+            throw new CatalogGenerationError({
+                code: 'catalogGenerationSourceMissing',
+                sourceId: missing,
+                message: `Catalog source "${missing}" is not configured.`,
+            });
+    }
+    const selected = control.configSnapshot.config.sources.filter((source) => !requested || requested.has(source.id));
+    const resolved = await Promise.all(selected.map((source) => resolveFromState({
+        source,
+        sourceIdentity: control.sourceIdentities[source.id],
+        active: control.generationState.sources[source.id]?.active,
+        env,
+        requireCompatibility: true,
+        validatedStoreEntries: options.validatedStoreEntries,
+        validatingStoreEntries: options.validatingStoreEntries,
+    })));
+    const sources = resolved.map(({ active: _active, ...source }) => source);
+    const primarySourceId = control.configSnapshot.config.sources.find((source) => source.primary).id;
+    return {
+        configDigest: control.configSnapshot.digest,
+        primarySourceId,
+        sources,
+        generationSetDigest: calculateCatalogGenerationSetDigest(control.configSnapshot.digest, primarySourceId, sources),
+    };
+}
+//# sourceMappingURL=catalog-generation-resolver.js.map

package/dist/src/utils/catalog-generation-resolver.js.map

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

package/dist/src/utils/catalog-generation-service.d.ts

@@ -0,0 +1,172 @@
+import type { CatalogActivationMode, CatalogGenerationActiveV1, CatalogGenerationCandidateComparison, CatalogGenerationCandidateEvidence, CatalogGenerationLastSyncV1, CatalogGenerationSyncResult, CatalogManifestV7, CatalogSource } from '../types.js';
+import { type CatalogStoreEntry } from './catalog-generation-store.js';
+export { removeCatalogSourceGenerationState } from './catalog-generation-state.js';
+import { catalogGitProviderInternal } from './git-catalog-provider.js';
+import { catalogPathProviderInternal } from './path-catalog-provider.js';
+import { type CatalogCapabilityCompatibility } from './catalog-capability-projection.js';
+import { inspectCatalogSourceImpact } from './catalog-source-impact.js';
+export interface CatalogGenerationProviderSet {
+    git: typeof catalogGitProviderInternal.resolve;
+    path: typeof catalogPathProviderInternal.resolve;
+}
+export interface CatalogGenerationServiceRuntime {
+    providers?: CatalogGenerationProviderSet;
+    probeGitRef?: typeof catalogGitProviderInternal.probeRef;
+    now?: () => Date;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+    afterCandidateResolved?: () => Promise<void>;
+    afterRecoveryStorePublished?: () => Promise<void>;
+    afterInactiveStoreRepairPrepared?: () => Promise<void>;
+    inspectSourceImpact?: typeof inspectCatalogSourceImpact;
+}
+export interface CatalogGenerationProbeResult {
+    sourceId: string;
+    candidate: CatalogGenerationCandidateEvidence;
+    manifest: CatalogManifestV7;
+}
+export type CatalogGenerationFreshnessState = 'current' | 'updateAvailable' | 'localChangesAvailable' | 'versionConflict' | 'rollbackDetected' | 'incompatible' | 'fixed';
+export interface CatalogGenerationFreshnessResult {
+    sourceId: string;
+    state: CatalogGenerationFreshnessState;
+    activeVersion?: string;
+    activeResolvedCommit?: string;
+    candidate?: CatalogGenerationCandidateEvidence;
+    errorCode?: 'catalogLogicalIdentityChanged';
+    reusableCandidate?: CatalogGenerationReusableCandidate;
+}
+export interface CatalogGenerationReusableCandidate {
+    probe: CatalogGenerationProbeResult;
+    sourceConfigFingerprint: string;
+    activeStoreKey: string | null;
+}
+export interface CatalogGenerationStatusEntry {
+    sourceId: string;
+    configuredSourceIdentity: string;
+    active?: CatalogGenerationActiveV1;
+    activeReady: boolean;
+    configMatchesActive: boolean;
+    catalogVersion?: string;
+    channel?: 'latest' | 'beta';
+    storeKey?: string;
+    lastSync?: CatalogGenerationLastSyncV1;
+    compatibility: CatalogCapabilityCompatibility | null;
+    errorCode?: string;
+}
+export interface CatalogGenerationStatusPayload {
+    catalogGenerationStatusSchemaVersion: 2;
+    sources: CatalogGenerationStatusEntry[];
+}
+export declare function compareCatalogGenerationCandidates(expected: CatalogGenerationCandidateEvidence, actual: CatalogGenerationCandidateEvidence): CatalogGenerationCandidateComparison;
+export declare function compareCatalogGenerationFreshness(options: {
+    sourceType: CatalogSource['type'];
+    active?: {
+        logicalIdentity: string;
+        catalogVersion: string;
+        snapshotDigest: string;
+        resolvedCommit: string;
+    };
+    candidate: CatalogGenerationCandidateEvidence;
+}): Omit<CatalogGenerationFreshnessResult, 'sourceId'>;
+export declare function probeCatalogSourceGeneration(options: {
+    sourceId: string;
+    source?: CatalogSource;
+    cliVersion: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationProbeResult>;
+export declare function probeCatalogSourceRepairGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    expectedActive?: CatalogGenerationActiveV1;
+    expectedConfigDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationProbeResult>;
+export declare function probeCatalogSourceFreshness(options: {
+    sourceId: string;
+    cliVersion: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    fullValidation?: boolean;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationFreshnessResult>;
+export declare function recordCatalogGenerationCheck(options: {
+    probe: CatalogGenerationProbeResult;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function activateCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    activationMode?: CatalogActivationMode;
+    impactConfirmed?: boolean;
+    impactMode?: 'generation' | 'identityChange';
+    expectedImpactDigest?: string;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive?: CatalogGenerationActiveV1 | null;
+    expectedConfigDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function recoverCatalogGenerationStateAndActivate(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    impactConfirmed?: boolean;
+    expectedImpactDigest?: string;
+    expectedCandidate: CatalogGenerationCandidateEvidence;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function repairCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive?: CatalogGenerationActiveV1 | null;
+    expectedConfigDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function replaceDamagedCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive: CatalogGenerationActiveV1;
+    expectedConfigDigest: string;
+    impactConfirmed?: boolean;
+    expectedImpactDigest?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function syncCatalogSourceGeneration(options: {
+    sourceId: string;
+    cliVersion: string;
+    cwd?: string;
+    check?: boolean;
+    impactConfirmed?: boolean;
+    replaceDamaged?: boolean;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    runtime?: CatalogGenerationServiceRuntime;
+    expectedCandidate?: CatalogGenerationCandidateEvidence;
+    expectedActive?: CatalogGenerationActiveV1 | null;
+    expectedConfigDigest?: string;
+    expectedImpactDigest?: string;
+}): Promise<CatalogGenerationSyncResult>;
+export declare function readCatalogGenerationStatus(options?: {
+    sourceId?: string;
+    env?: NodeJS.ProcessEnv;
+    validatedStoreEntries?: Map<string, CatalogStoreEntry>;
+    validatingStoreEntries?: Map<string, Promise<CatalogStoreEntry>>;
+}): Promise<CatalogGenerationStatusPayload>;