@lesliechan721/aw 0.1.0-beta.5 → 0.1.0-beta.50

package/dist/src/utils/codex-reconciler.d.ts

@@ -0,0 +1,126 @@
+import type { CodexSharedNativeInspection } from './codex-shared-native.js';
+import type { CodexSurfaceAnalysis, CodexSurfaceComponent } from './codex-surface-analysis.js';
+import type { PluginIntentState } from './plugin-intent-state.js';
+import type { CodexOperationRequirement, Scope } from '../types.js';
+export type CodexReconcileOperation = 'install' | 'uninstall' | 'reinstall' | 'cleanup' | 'sync';
+export type CodexSharedNativeAction = 'reuse' | 'install' | 'replace' | 'repair' | 'none';
+export type CodexActivationAction = 'enable' | 'disable' | 'remove' | 'none';
+export interface CodexReconcilerCatalogTarget {
+    pluginId: string;
+    pluginName: string;
+    codexPluginId: string;
+    version: string;
+    payloadDigest: string;
+    relation: 'requested' | 'dependency';
+    resolvedScope: Scope;
+    desiredScopes?: Scope[];
+    intentScopes?: Scope[];
+    surface: CodexSurfaceAnalysis;
+}
+export type CodexLiveExtensionState = 'absent' | 'present' | 'drifted' | 'foreign';
+export interface CodexReconcilerLiveEvidence {
+    codexPluginId: string;
+    sharedNative: CodexSharedNativeInspection;
+    activations: {
+        user?: boolean;
+        project?: boolean;
+    };
+    extensions?: Array<{
+        componentKey: string;
+        scope: Scope;
+        state: CodexLiveExtensionState;
+        owner?: string;
+    }>;
+    projectionDigest?: string;
+}
+export interface CodexReconcilerInput {
+    scope: Scope;
+    cwd: string;
+    operation: CodexReconcileOperation;
+    intentBefore: PluginIntentState;
+    intentAfter: PluginIntentState;
+    relatedIntentBefore?: PluginIntentState;
+    relatedIntentAfter?: PluginIntentState;
+    catalogClosure: CodexReconcilerCatalogTarget[];
+    liveEvidence: CodexReconcilerLiveEvidence[];
+    activationSupport?: 'observed' | 'assumed';
+}
+export interface CodexSharedNativePlanAction {
+    pluginId: string;
+    codexPluginId: string;
+    action: CodexSharedNativeAction;
+    desiredVersion: string;
+    affectsOtherScopes: boolean;
+}
+export interface CodexActivationPlanAction {
+    pluginId: string;
+    codexPluginId: string;
+    scope: Scope;
+    action: CodexActivationAction;
+    desired: boolean;
+}
+export interface CodexExtensionPlanAction {
+    pluginId: string;
+    componentKey: string;
+    kind: CodexSurfaceComponent['kind'];
+    scope: Scope;
+    action: 'write' | 'remove';
+}
+export interface CodexReconcilePostcheckDescriptor {
+    requirement: CodexOperationRequirement;
+    support: 'observed' | 'assumed';
+    plugins: Array<{
+        pluginId: string;
+        codexPluginId: string;
+        expectedUserEnabled: boolean;
+        expectedProjectEnabled: boolean;
+        exactCwd: string;
+        neutralCwdRequired: boolean;
+    }>;
+}
+export interface CodexReconcileReviewDescriptor {
+    requiresConfirmation: boolean;
+    sharedImpact: {
+        pluginIds: string[];
+        warning?: string;
+    };
+}
+export interface CodexReconcilePlan {
+    requirement: CodexOperationRequirement;
+    desiredTargets: Array<{
+        pluginId: string;
+        scopes: Scope[];
+    }>;
+    sharedNativeActions: CodexSharedNativePlanAction[];
+    activationActions: {
+        user: CodexActivationPlanAction[];
+        project: CodexActivationPlanAction[];
+    };
+    extensionWrites: CodexExtensionPlanAction[];
+    extensionRemovals: CodexExtensionPlanAction[];
+    staleActivationRemovals: Array<{
+        scope: Scope;
+        codexPluginId: string;
+    }>;
+    managedInventory: {
+        before: string[];
+        desired: string[];
+        ownershipSuperset: string[];
+        converged: string[];
+        related: {
+            before: string[];
+            desired: string[];
+            ownershipSuperset: string[];
+            converged: string[];
+        };
+    };
+    warnings: string[];
+    postcheck: CodexReconcilePostcheckDescriptor;
+    review: CodexReconcileReviewDescriptor;
+}
+export declare class CodexReconcilePlanError extends Error {
+    readonly code: 'codexSharedNativeForeign' | 'codexSharedNativeCorrupt' | 'codexExtensionScopeConflict' | 'codexSurfaceOwnerCollision' | 'codexReconcileEvidenceInvalid';
+    constructor(code: CodexReconcilePlanError['code'], detail: string);
+}
+export declare function createCodexReconcilePlan(input: CodexReconcilerInput): CodexReconcilePlan;
+export declare const planCodexReconciliation: typeof createCodexReconcilePlan;

package/dist/src/utils/codex-reconciler.js

@@ -0,0 +1,298 @@
+import { getCodexOperationRequirement } from './agent-version.js';
+export class CodexReconcilePlanError extends Error {
+    code;
+    constructor(code, detail) {
+        super(`${code}: ${detail}`);
+        this.name = 'CodexReconcilePlanError';
+        this.code = code;
+    }
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function canonicalStrings(values) {
+    return [...new Set(values)].sort(compareText);
+}
+function targetKey(target) {
+    return `${target.pluginId}\0${target.codexPluginId}`;
+}
+function desiredScopes(target) {
+    return [...new Set(target.desiredScopes ?? [target.resolvedScope])].sort(compareText);
+}
+function assertTarget(target) {
+    if (!target.surface.ok) {
+        throw new CodexReconcilePlanError('codexSurfaceOwnerCollision', `${target.pluginId} has an ambiguous or unsupported Codex surface.`);
+    }
+    if (!target.codexPluginId.includes('@')) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `${target.pluginId} has an invalid Codex plugin ID.`);
+    }
+    if (!/^sha256:[0-9a-f]{64}$/u.test(target.payloadDigest)) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `${target.pluginId} has an invalid payload digest.`);
+    }
+}
+function nativeAction(options) {
+    const { operation, target, evidence } = options;
+    const requiresNative = target.surface.nativeKinds.length > 0
+        && desiredScopes(target).length > 0;
+    if (!requiresNative || operation === 'uninstall')
+        return 'none';
+    const state = evidence.sharedNative;
+    if (state.state === 'unobserved') {
+        return operation === 'cleanup' ? 'none' : 'install';
+    }
+    if (state.state === 'blocked') {
+        throw new CodexReconcilePlanError(state.reason === 'foreign' ? 'codexSharedNativeForeign' : 'codexSharedNativeCorrupt', `${target.codexPluginId} shared native state is ${state.reason}.`);
+    }
+    if (operation === 'reinstall') {
+        return state.state === 'missing' ? 'install' : 'replace';
+    }
+    if (state.state === 'missing')
+        return 'install';
+    if (state.state === 'replaceable') {
+        return state.reason === 'damaged' ? 'repair' : 'replace';
+    }
+    return 'reuse';
+}
+function activationAction(options) {
+    if (options.desired)
+        return options.actual === true ? 'none' : 'enable';
+    if (options.scope === 'user' && options.nativeDesiredSomewhere) {
+        return options.actual === false ? 'none' : 'disable';
+    }
+    return options.actual === undefined ? 'none' : 'remove';
+}
+function liveExtensionState(evidence, componentKey, scope) {
+    return evidence.extensions?.find((entry) => entry.componentKey === componentKey && entry.scope === scope)?.state ?? 'absent';
+}
+function addExtensionActions(options) {
+    const scopes = desiredScopes(options.target);
+    const awComponents = options.target.surface.components.filter((component) => component.owner === 'aw');
+    if (awComponents.length > 0 && scopes.includes('user') && scopes.includes('project')) {
+        throw new CodexReconcilePlanError('codexExtensionScopeConflict', `${options.target.pluginId} has AW-owned output at both user and project scope.`);
+    }
+    for (const component of awComponents) {
+        for (const scope of ['user', 'project']) {
+            const state = liveExtensionState(options.evidence, component.key, scope);
+            if (state === 'foreign') {
+                throw new CodexReconcilePlanError('codexSurfaceOwnerCollision', `${options.target.pluginId} extension ${component.key} is foreign at ${scope} scope.`);
+            }
+            const desired = scopes.includes(scope) && component.scopes.includes(scope);
+            const refreshOnSync = options.input.operation === 'sync'
+                && component.dynamic
+                && (component.refreshKeys?.length ?? 0) > 0;
+            const shouldWrite = desired && (state !== 'present'
+                || options.input.operation === 'reinstall'
+                || refreshOnSync);
+            if (shouldWrite) {
+                options.writes.push({
+                    pluginId: options.target.pluginId,
+                    componentKey: component.key,
+                    kind: component.kind,
+                    scope,
+                    action: 'write',
+                });
+            }
+            else if (!desired && state !== 'absent') {
+                options.removals.push({
+                    pluginId: options.target.pluginId,
+                    componentKey: component.key,
+                    kind: component.kind,
+                    scope,
+                    action: 'remove',
+                });
+            }
+        }
+    }
+}
+function sortActivationActions(actions) {
+    actions.sort((left, right) => compareText(`${left.codexPluginId}\0${left.pluginId}`, `${right.codexPluginId}\0${right.pluginId}`));
+}
+function sortExtensionActions(actions) {
+    actions.sort((left, right) => compareText(`${left.scope}\0${left.pluginId}\0${left.componentKey}`, `${right.scope}\0${right.pluginId}\0${right.componentKey}`));
+}
+function evidenceFor(target, evidenceById) {
+    const evidence = evidenceById.get(target.codexPluginId);
+    if (!evidence) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `Missing live evidence for ${target.codexPluginId}.`);
+    }
+    return evidence;
+}
+export function createCodexReconcilePlan(input) {
+    const sortedTargets = [...input.catalogClosure].sort((left, right) => compareText(targetKey(left), targetKey(right)));
+    const duplicateTarget = sortedTargets.find((target, index) => index > 0 && targetKey(sortedTargets[index - 1]) === targetKey(target));
+    if (duplicateTarget) {
+        throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `Duplicate catalog target ${duplicateTarget.pluginId}.`);
+    }
+    sortedTargets.forEach(assertTarget);
+    const ownersByCodexPluginId = new Map();
+    for (const target of sortedTargets) {
+        const owners = ownersByCodexPluginId.get(target.codexPluginId) ?? new Set();
+        owners.add(target.pluginId);
+        ownersByCodexPluginId.set(target.codexPluginId, owners);
+    }
+    const ownerCollision = [...ownersByCodexPluginId.entries()].find(([, owners]) => owners.size > 1);
+    if (ownerCollision) {
+        throw new CodexReconcilePlanError('codexSurfaceOwnerCollision', `${ownerCollision[0]} has multiple Catalog owners: ${[...ownerCollision[1]].sort(compareText).join(', ')}.`);
+    }
+    const evidenceById = new Map();
+    for (const evidence of input.liveEvidence) {
+        if (evidenceById.has(evidence.codexPluginId)) {
+            throw new CodexReconcilePlanError('codexReconcileEvidenceInvalid', `Duplicate live evidence for ${evidence.codexPluginId}.`);
+        }
+        evidenceById.set(evidence.codexPluginId, evidence);
+    }
+    const sharedNativeActions = [];
+    const userActions = [];
+    const projectActions = [];
+    const extensionWrites = [];
+    const extensionRemovals = [];
+    const warnings = [];
+    const postcheckPlugins = [];
+    let projectContractRequired = input.scope === 'project'
+        || sortedTargets.some((target) => target.resolvedScope === 'project');
+    for (const target of sortedTargets) {
+        const evidence = evidenceFor(target, evidenceById);
+        const scopes = desiredScopes(target);
+        const hasNative = target.surface.nativeKinds.length > 0;
+        const userDesired = hasNative && scopes.includes('user');
+        const projectDesired = hasNative && scopes.includes('project');
+        const nativeDesiredSomewhere = userDesired || projectDesired;
+        projectContractRequired ||= projectDesired;
+        const action = nativeAction({ operation: input.operation, target, evidence });
+        if (hasNative || action !== 'none') {
+            sharedNativeActions.push({
+                pluginId: target.pluginId,
+                codexPluginId: target.codexPluginId,
+                action,
+                desiredVersion: target.version,
+                affectsOtherScopes: action === 'replace' || action === 'repair',
+            });
+        }
+        if (action === 'replace' || action === 'repair') {
+            warnings.push(`codexSharedNativeAffectsOtherScopes:${target.codexPluginId}`);
+        }
+        const userAction = {
+            pluginId: target.pluginId,
+            codexPluginId: target.codexPluginId,
+            scope: 'user',
+            action: activationAction({
+                actual: evidence.activations.user,
+                desired: userDesired,
+                scope: 'user',
+                nativeDesiredSomewhere,
+            }),
+            desired: userDesired,
+        };
+        const projectAction = {
+            pluginId: target.pluginId,
+            codexPluginId: target.codexPluginId,
+            scope: 'project',
+            action: activationAction({
+                actual: evidence.activations.project,
+                desired: projectDesired,
+                scope: 'project',
+                nativeDesiredSomewhere,
+            }),
+            desired: projectDesired,
+        };
+        userActions.push(userAction);
+        projectActions.push(projectAction);
+        addExtensionActions({
+            input,
+            target,
+            evidence,
+            writes: extensionWrites,
+            removals: extensionRemovals,
+        });
+        if (hasNative && (userDesired || projectDesired)) {
+            postcheckPlugins.push({
+                pluginId: target.pluginId,
+                codexPluginId: target.codexPluginId,
+                expectedUserEnabled: userDesired,
+                expectedProjectEnabled: projectDesired,
+                exactCwd: input.cwd,
+                neutralCwdRequired: projectDesired,
+            });
+        }
+    }
+    const actualDesiredIds = canonicalStrings(sortedTargets.flatMap((target) => target.surface.nativeKinds.length > 0 && desiredScopes(target).length > 0
+        ? [target.codexPluginId]
+        : []));
+    const desiredIds = canonicalStrings(sortedTargets.flatMap((target) => (target.intentScopes ?? desiredScopes(target)).includes(input.scope)
+        ? [target.codexPluginId]
+        : []));
+    const relatedScope = input.scope === 'user' ? 'project' : 'user';
+    const relatedDesiredIds = canonicalStrings(sortedTargets.flatMap((target) => (target.intentScopes ?? desiredScopes(target)).includes(relatedScope)
+        ? [target.codexPluginId]
+        : []));
+    const beforeIds = [];
+    const relatedBeforeIds = [];
+    const nativeReconciledPluginIds = new Set(sortedTargets.flatMap((target) => target.surface.nativeKinds.length > 0 ? [target.codexPluginId] : []));
+    const reconciledPluginIds = new Set(sortedTargets.map((target) => target.codexPluginId));
+    const staleActivationRemovals = canonicalStrings([...beforeIds, ...relatedBeforeIds].filter((pluginId) => nativeReconciledPluginIds.has(pluginId)
+        && !actualDesiredIds.includes(pluginId))).flatMap((codexPluginId) => [
+        { scope: 'user', codexPluginId },
+        { scope: 'project', codexPluginId },
+    ]);
+    const requirement = getCodexOperationRequirement(projectContractRequired ? 'project' : 'user');
+    const support = input.activationSupport ?? 'observed';
+    if (support === 'assumed')
+        warnings.push('codexProjectActivationAssumed');
+    sharedNativeActions.sort((left, right) => compareText(left.codexPluginId, right.codexPluginId));
+    sortActivationActions(userActions);
+    sortActivationActions(projectActions);
+    sortExtensionActions(extensionWrites);
+    sortExtensionActions(extensionRemovals);
+    postcheckPlugins.sort((left, right) => compareText(left.codexPluginId, right.codexPluginId));
+    const ownershipSuperset = canonicalStrings([...beforeIds, ...desiredIds]);
+    const convergedIds = canonicalStrings([
+        ...beforeIds.filter((pluginId) => !reconciledPluginIds.has(pluginId)),
+        ...desiredIds,
+    ]);
+    const relatedOwnershipSuperset = canonicalStrings([...relatedBeforeIds, ...relatedDesiredIds]);
+    const relatedConvergedIds = canonicalStrings([
+        ...relatedBeforeIds.filter((pluginId) => !reconciledPluginIds.has(pluginId)),
+        ...relatedDesiredIds,
+    ]);
+    const planDescriptor = {
+        requirement,
+        desiredTargets: sortedTargets.map((target) => ({
+            pluginId: target.pluginId,
+            scopes: desiredScopes(target),
+        })),
+        sharedNativeActions,
+        activationActions: { user: userActions, project: projectActions },
+        extensionWrites,
+        extensionRemovals,
+        staleActivationRemovals,
+        managedInventory: {
+            before: beforeIds,
+            desired: desiredIds,
+            ownershipSuperset,
+            converged: convergedIds,
+            related: {
+                before: relatedBeforeIds,
+                desired: relatedDesiredIds,
+                ownershipSuperset: relatedOwnershipSuperset,
+                converged: relatedConvergedIds,
+            },
+        },
+        warnings: canonicalStrings(warnings),
+        postcheck: { requirement, support, plugins: postcheckPlugins },
+    };
+    const sharedImpactPluginIds = sharedNativeActions.flatMap((entry) => entry.affectsOtherScopes ? [entry.codexPluginId] : []);
+    return {
+        ...planDescriptor,
+        review: {
+            requiresConfirmation: sharedImpactPluginIds.length > 0,
+            sharedImpact: {
+                pluginIds: sharedImpactPluginIds,
+                ...(sharedImpactPluginIds.length > 0 ? {
+                    warning: 'Replacing or reinstalling shared Codex native state can affect other projects.',
+                } : {}),
+            },
+        },
+    };
+}
+export const planCodexReconciliation = createCodexReconcilePlan;
+//# sourceMappingURL=codex-reconciler.js.map

package/dist/src/utils/codex-reconciler.js.map

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

package/dist/src/utils/codex-shared-native.d.ts

@@ -0,0 +1,43 @@
+import type { CodexMarketplaceSnapshot } from './codex-config.js';
+import type { CodexNativePluginObservation } from './codex-native-observation.js';
+export type CodexSharedNativeDiagnostic = 'staleCacheObserved' | 'marketplaceRegistrationForeign' | 'marketplacePathUnsafe' | 'pluginListUnavailable' | 'pluginListDuplicate' | 'pluginNameCollision' | 'pluginListVersionMismatch' | 'manifestMissing' | 'manifestUnreadable' | 'manifestIdentityMismatch' | 'manifestVersionInvalid' | 'payloadPathUnsafe' | 'payloadDigestMismatch' | 'projectionReceiptMissing' | 'projectionReceiptUnreadable' | 'projectionExpectedPayloadDigestMissing' | 'projectionReceiptIdentityMismatch' | 'projectionPayloadDigestMismatch' | 'projectionRenderDrift';
+export type CodexSharedNativeState = 'missing' | 'usable' | 'replaceable' | 'blocked' | 'unobserved';
+export type CodexSharedNativeInspection = {
+    state: 'unobserved';
+    staleCacheObserved?: true;
+} | {
+    state: 'missing';
+    staleCacheObserved?: true;
+} | {
+    state: 'usable';
+    version?: string;
+} | {
+    state: 'replaceable';
+    reason: 'outdated' | 'damaged' | 'renderDrift';
+    version?: string;
+    desiredVersion?: string;
+    diagnostic?: CodexSharedNativeDiagnostic;
+} | {
+    state: 'blocked';
+    reason: 'foreign' | 'unreadable';
+    diagnostic: CodexSharedNativeDiagnostic;
+};
+export interface CodexSharedNativeEvidence {
+    pluginName: string;
+    pluginId: string;
+    marketplaceName: string;
+    canonicalMarketplaceRoot: string;
+    desiredVersion: string;
+    expectedPayloadDigest?: string;
+    marketplaceRegistration?: CodexMarketplaceSnapshot;
+    marketplacePathSafe: boolean;
+    observation: CodexNativePluginObservation;
+    sourceProjection?: 'current' | 'drifted';
+    sourceProjectionIssue?: {
+        reason: 'damaged' | 'foreign' | 'unreadable';
+        diagnostic: CodexSharedNativeDiagnostic;
+    };
+}
+export declare function isCanonicalCodexMarketplaceRegistration(registration: CodexMarketplaceSnapshot | undefined, canonicalMarketplaceRoot: string): boolean;
+export declare function inspectCodexSharedNative(evidence: CodexSharedNativeEvidence): CodexSharedNativeInspection;
+export declare const classifyCodexSharedNativeEvidence: typeof inspectCodexSharedNative;

package/dist/src/utils/codex-shared-native.js

@@ -0,0 +1,81 @@
+import path from 'node:path';
+import { tryParseStrictSemVer } from './manifest.js';
+function samePath(left, right) {
+    return path.resolve(left) === path.resolve(right);
+}
+export function isCanonicalCodexMarketplaceRegistration(registration, canonicalMarketplaceRoot) {
+    return registration?.sourceType === 'local'
+        && registration.sourcePointsToManifest === false
+        && typeof registration.source === 'string'
+        && samePath(registration.source, canonicalMarketplaceRoot);
+}
+function blocked(reason, diagnostic) {
+    return { state: 'blocked', reason, diagnostic };
+}
+export function inspectCodexSharedNative(evidence) {
+    const expectedPluginId = `${evidence.pluginName}@${evidence.marketplaceName}`;
+    if (evidence.pluginId !== expectedPluginId) {
+        throw new Error(`Invalid Codex shared native identity: expected ${expectedPluginId}.`);
+    }
+    if (!tryParseStrictSemVer(evidence.desiredVersion)) {
+        throw new Error(`Invalid desired Codex shared native version: ${evidence.desiredVersion}.`);
+    }
+    if (evidence.expectedPayloadDigest !== undefined
+        && !/^sha256:[0-9a-f]{64}$/u.test(evidence.expectedPayloadDigest)) {
+        throw new Error('Invalid expected Codex shared native payload digest.');
+    }
+    if (!evidence.marketplacePathSafe)
+        return blocked('foreign', 'marketplacePathUnsafe');
+    if (evidence.observation.state === 'unobserved') {
+        return { state: 'unobserved' };
+    }
+    if (evidence.observation.state === 'failed') {
+        return blocked('unreadable', evidence.observation.reason === 'duplicate' ? 'pluginListDuplicate' : 'pluginListUnavailable');
+    }
+    if (evidence.observation.value === 'absent') {
+        return { state: 'missing' };
+    }
+    const listEntry = evidence.observation.entry;
+    if (evidence.marketplaceRegistration && !isCanonicalCodexMarketplaceRegistration(evidence.marketplaceRegistration, evidence.canonicalMarketplaceRoot)) {
+        return blocked('foreign', 'marketplaceRegistrationForeign');
+    }
+    if (!evidence.marketplaceRegistration) {
+        return blocked('foreign', 'marketplaceRegistrationForeign');
+    }
+    if (evidence.sourceProjectionIssue
+        && evidence.sourceProjectionIssue.reason !== 'damaged') {
+        return blocked(evidence.sourceProjectionIssue.reason, evidence.sourceProjectionIssue.diagnostic);
+    }
+    if (listEntry.version !== undefined && listEntry.version !== evidence.desiredVersion) {
+        return {
+            state: 'replaceable',
+            reason: 'outdated',
+            version: listEntry.version,
+            desiredVersion: evidence.desiredVersion,
+        };
+    }
+    if (evidence.sourceProjectionIssue?.reason === 'damaged') {
+        return {
+            state: 'replaceable',
+            reason: 'damaged',
+            ...(listEntry.version ? { version: listEntry.version } : {}),
+            desiredVersion: evidence.desiredVersion,
+            diagnostic: evidence.sourceProjectionIssue.diagnostic,
+        };
+    }
+    if (evidence.sourceProjection === 'drifted') {
+        return {
+            state: 'replaceable',
+            reason: 'renderDrift',
+            ...(listEntry.version ? { version: listEntry.version } : {}),
+            desiredVersion: evidence.desiredVersion,
+            diagnostic: 'projectionRenderDrift',
+        };
+    }
+    return {
+        state: 'usable',
+        ...(listEntry.version ? { version: listEntry.version } : {}),
+    };
+}
+export const classifyCodexSharedNativeEvidence = inspectCodexSharedNative;
+//# sourceMappingURL=codex-shared-native.js.map

package/dist/src/utils/codex-shared-native.js.map

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

package/dist/src/utils/codex-skill-staging.d.ts

@@ -5,5 +5,7 @@ export declare function createCodexSkillExpectedTree(options: {
     artifact: Pick<CodexSkillArtifact, 'target' | 'skillKey' | 'state' | 'content'>;
     sourceDirs?: string[];
     requireReadme?: boolean;
+    requirementsReceipt?: Buffer;
+    sourceRequirementsReceiptPolicy?: 'reject' | 'allow' | 'ignore';
 }): Promise<CodexSkillStagingTree>;
 export declare function createCodexSkillStagingTreeContentDigest(tree: CodexSkillStagingTree): string;

package/dist/src/utils/codex-skill-staging.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-skill-staging.js","sourceRoot":"","sources":["../../../src/utils/codex-skill-staging.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,EAC9B,mCAAmC,GAEpC,MAAM,yBAAyB,CAAC;AAIjC,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,OAIlD;IACC,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,IAA2B;IAE3B,OAAO,mCAAmC,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"codex-skill-staging.js","sourceRoot":"","sources":["../../../src/utils/codex-skill-staging.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,EAC9B,mCAAmC,GAEpC,MAAM,yBAAyB,CAAC;AAIjC,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,OAMlD;IACC,OAAO,8BAA8B,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,IAA2B;IAE3B,OAAO,mCAAmC,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/utils/codex-surface-analysis.d.ts

@@ -0,0 +1,46 @@
+import type { NormalizedPluginManifest, Scope } from '../types.js';
+export declare const QUALIFIED_CODEX_NATIVE_KINDS: readonly ["skill", "mcp", "hook", "app"];
+export type CodexNativeKind = typeof QUALIFIED_CODEX_NATIVE_KINDS[number];
+export type CodexUnsupportedNativeKind = 'slashCommand';
+export type CodexExtensionKind = 'skill' | 'instruction' | 'permission' | 'agent';
+export type CodexSurfaceClassification = 'empty' | 'native' | 'aw-extension' | 'mixed' | 'unsupported';
+export type CodexSurfaceDeliveryOwner = 'none' | 'codex-native' | 'aw' | 'split' | 'unsupported';
+export type CodexScopeOverlap = 'none' | 'native-compatible' | 'aw-owned-conflict';
+export interface CodexSurfaceComponent {
+    key: string;
+    kind: CodexNativeKind | CodexExtensionKind;
+    owner: 'codex-native' | 'aw';
+    scopes: Scope[];
+    dynamic: boolean;
+    refreshKeys?: string[];
+    name?: string;
+}
+export interface CodexSurfaceOwnerCollision {
+    kind: CodexNativeKind | CodexExtensionKind;
+    name: string;
+    owners: ['codex-native', 'aw'];
+}
+export interface CodexSurfaceAnalysisOptions {
+    nativeArtifactNames?: Partial<Record<CodexNativeKind, readonly string[]>>;
+}
+export interface CodexSurfaceAnalysis {
+    ok: boolean;
+    configInputs: string[];
+    nativeKinds: CodexNativeKind[];
+    extensionKinds: CodexExtensionKind[];
+    unsupportedKinds: CodexUnsupportedNativeKind[];
+    classification: CodexSurfaceClassification;
+    deliveryOwner: CodexSurfaceDeliveryOwner;
+    scopeOverlap: CodexScopeOverlap;
+    components: CodexSurfaceComponent[];
+    collisions: CodexSurfaceOwnerCollision[];
+    missingNativeIdentityKinds: CodexNativeKind[];
+    errorCode?: 'codexSurfaceOwnerCollision' | 'codexSurfaceNativeIdentityMissing' | 'codexNativeKindUnsupported';
+}
+export declare class CodexSurfaceAnalysisError extends Error {
+    readonly code: 'codexSurfaceOwnerCollision' | 'codexSurfaceNativeIdentityMissing' | 'codexNativeKindUnsupported';
+    readonly analysis: CodexSurfaceAnalysis;
+    constructor(analysis: CodexSurfaceAnalysis);
+}
+export declare function analyzeCodexSurface(manifest: NormalizedPluginManifest, options?: CodexSurfaceAnalysisOptions): CodexSurfaceAnalysis;
+export declare function assertCodexSurfaceSupported(analysis: CodexSurfaceAnalysis): CodexSurfaceAnalysis;