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

package/dist/src/utils/plugin-config-impact.js

@@ -0,0 +1,298 @@
+import crypto from 'node:crypto';
+import { canonicalizePluginConfigValues, stablePluginConfigStringify, } from '@lesliechan721/aw-plugin-core/manifest';
+import { coercePluginConfigUpdates, readPluginConfigStore, resolveAwProjectRoot, resolveEffectivePluginConfigFromStores, } from './plugin-config.js';
+function configIdentity(plugin) {
+    return plugin.sourceId ? {
+        sourceId: plugin.sourceId,
+        sourceIdentity: plugin.sourceIdentity,
+        logicalIdentity: plugin.catalogLogicalIdentity,
+    } : {};
+}
+function targetKey(target) {
+    return `${target.platform}\0${target.scope}\0${target.projectKey ?? ''}`;
+}
+function dedupeTargets(targets) {
+    const output = new Map();
+    for (const target of targets)
+        output.set(targetKey(target), target);
+    return [...output.values()];
+}
+function configValuesEqual(left, right, keys = [...new Set([...Object.keys(left), ...Object.keys(right)])]) {
+    return keys.every((key) => {
+        const leftHas = Object.hasOwn(left, key);
+        const rightHas = Object.hasOwn(right, key);
+        return leftHas === rightHas
+            && (!leftHas || stablePluginConfigStringify(left[key]) === stablePluginConfigStringify(right[key]));
+    });
+}
+function storeEvidence(store) {
+    return {
+        exists: store.exists,
+        state: store.state,
+        ...(store.rawDigest ? { rawDigest: store.rawDigest } : {}),
+    };
+}
+function digestStores(stores) {
+    return `sha256:${crypto.createHash('sha256').update(JSON.stringify({
+        user: storeEvidence(stores.user),
+        ...(stores.project ? { project: storeEvidence(stores.project) } : {}),
+    })).digest('hex')}`;
+}
+function cloneStore(store, values) {
+    const canonical = canonicalizePluginConfigValues(values);
+    return {
+        path: store.path,
+        exists: Object.keys(canonical).length > 0,
+        state: Object.keys(canonical).length > 0 ? 'ready' : 'missing',
+        values: canonical,
+        issues: [],
+    };
+}
+function targetArtifactDeclarations(plugin, target) {
+    return (plugin.manifest.artifacts?.targets ?? []).filter((declaration) => declaration.platform === target.platform
+        && (declaration.target === 'codex.skill'
+            && declaration.delivery.mode === 'codex-native'
+            || declaration.scopes.includes(target.scope)));
+}
+function nativeDeclaration(declaration) {
+    return declaration.target === 'codex.skill'
+        && declaration.delivery.mode === 'codex-native'
+        && typeof declaration.skillKey === 'string';
+}
+function rendererProjectionEqual(before, after, refreshKeys) {
+    const keys = new Set(refreshKeys);
+    if (!configValuesEqual(before.values, after.values, refreshKeys))
+        return false;
+    if ([...keys].some((key) => before.sources[key] !== after.sources[key]))
+        return false;
+    const issueProjection = (config) => config.issues
+        .filter((issue) => keys.has(issue.key))
+        .map((issue) => JSON.stringify(issue))
+        .sort((left, right) => left.localeCompare(right, 'en'));
+    return JSON.stringify(issueProjection(before)) === JSON.stringify(issueProjection(after));
+}
+function unknownImpact(options) {
+    const affectedTargets = dedupeTargets(options.visibleTargets);
+    const sharedNativeRenderTargets = new Map();
+    for (const target of affectedTargets) {
+        if (options.scope !== 'user')
+            continue;
+        for (const declaration of targetArtifactDeclarations(options.plugin, target)) {
+            if (!nativeDeclaration(declaration) || declaration.refreshKeys.length === 0)
+                continue;
+            sharedNativeRenderTargets.set(declaration.id, {
+                id: declaration.id,
+                skillKey: declaration.skillKey,
+                refreshKeys: [...declaration.refreshKeys],
+            });
+        }
+    }
+    return {
+        impactState: 'unknown',
+        noEffectiveChange: false,
+        storeChanged: options.storeChanged,
+        storeDigest: digestStores(options.stores),
+        changedKeys: options.changedKeys,
+        updatedKeys: options.updatedKeys,
+        removedKeys: options.removedKeys,
+        staleRemovedKeys: options.staleRemovedKeys,
+        affectedTargets,
+        sharedNativeRenderTargets: [...sharedNativeRenderTargets.values()],
+    };
+}
+export async function analyzePluginConfigMutationImpact(options) {
+    const schema = options.plugin.manifest.config?.fields;
+    const needsProjectStore = options.scope === 'project'
+        || options.visibleTargets.some((target) => target.scope === 'project');
+    const identity = configIdentity(options.plugin);
+    const readStore = async (scope) => {
+        try {
+            return await readPluginConfigStore({
+                ...identity,
+                pluginName: options.plugin.manifest.name,
+                scope,
+                cwd: options.cwd,
+                env: options.env,
+                schema,
+            });
+        }
+        catch {
+            return {
+                path: '',
+                exists: true,
+                state: 'invalid',
+                values: {},
+                invalidCode: 'invalidValues',
+                issues: ['The store cannot be read.'],
+            };
+        }
+    };
+    const [userStore, projectStore] = await Promise.all([
+        readStore('user'),
+        needsProjectStore
+            ? readStore('project')
+            : undefined,
+    ]);
+    const stores = { user: userStore, ...(projectStore ? { project: projectStore } : {}) };
+    const editedStore = options.scope === 'user' ? userStore : projectStore;
+    const requestedRemoveKeys = [...new Set(options.mutation.kind === 'patch' ? options.mutation.removeKeys ?? [] : [])];
+    let updatedKeys = [];
+    let removedKeys = [];
+    let staleRemovedKeys = [];
+    let coercedUpdates = {};
+    let storeChanged = options.mutation.kind === 'reset' && editedStore.exists;
+    if (editedStore.state !== 'invalid' && options.mutation.kind === 'reset') {
+        removedKeys = Object.keys(editedStore.values);
+        staleRemovedKeys = schema
+            ? removedKeys.filter((key) => !schema[key])
+            : [...removedKeys];
+    }
+    if (editedStore.state !== 'invalid' && options.mutation.kind === 'patch' && schema) {
+        coercedUpdates = await coercePluginConfigUpdates({
+            schema,
+            updates: options.mutation.updates ?? {},
+            cwd: options.cwd,
+        });
+        for (const key of requestedRemoveKeys) {
+            if (!schema[key] && !Object.hasOwn(editedStore.values, key)) {
+                throw new Error(`Unknown config key "${key}".`);
+            }
+        }
+        removedKeys = requestedRemoveKeys.filter((key) => Object.hasOwn(editedStore.values, key));
+        staleRemovedKeys = removedKeys.filter((key) => !schema[key]);
+        updatedKeys = Object.entries(coercedUpdates)
+            .filter(([key, value]) => !Object.hasOwn(editedStore.values, key)
+            || stablePluginConfigStringify(editedStore.values[key])
+                !== stablePluginConfigStringify(value))
+            .map(([key]) => key);
+        storeChanged = updatedKeys.length > 0 || removedKeys.length > 0;
+    }
+    const changedKeys = [...updatedKeys, ...removedKeys];
+    if (!schema || editedStore.state === 'invalid') {
+        return unknownImpact({
+            stores,
+            plugin: options.plugin,
+            scope: options.scope,
+            visibleTargets: options.visibleTargets,
+            storeChanged: options.mutation.kind === 'reset' ? editedStore.exists : true,
+            changedKeys: changedKeys.length > 0
+                ? changedKeys
+                : options.mutation.kind === 'patch'
+                    ? [...Object.keys(options.mutation.updates ?? {}), ...requestedRemoveKeys]
+                    : [],
+            updatedKeys,
+            removedKeys,
+            staleRemovedKeys,
+        });
+    }
+    if (!storeChanged) {
+        return {
+            impactState: 'known',
+            noEffectiveChange: true,
+            storeChanged: false,
+            storeDigest: digestStores(stores),
+            changedKeys: [],
+            updatedKeys: [],
+            removedKeys: [],
+            staleRemovedKeys: [],
+            affectedTargets: [],
+            sharedNativeRenderTargets: [],
+        };
+    }
+    const nextValues = options.mutation.kind === 'reset' ? {} : { ...editedStore.values };
+    if (options.mutation.kind === 'patch') {
+        for (const key of requestedRemoveKeys)
+            delete nextValues[key];
+        for (const [key, value] of Object.entries(coercedUpdates))
+            nextValues[key] = value;
+    }
+    const afterStores = {
+        user: options.scope === 'user' ? cloneStore(userStore, nextValues) : userStore,
+        ...(projectStore ? {
+            project: options.scope === 'project' ? cloneStore(projectStore, nextValues) : projectStore,
+        } : {}),
+    };
+    const projectRoot = resolveAwProjectRoot(options.cwd);
+    const resolved = new Map();
+    const resolveScope = async (scope) => {
+        const existing = resolved.get(scope);
+        if (existing)
+            return existing;
+        const pair = {
+            before: await resolveEffectivePluginConfigFromStores({
+                pluginName: options.plugin.manifest.name,
+                manifest: options.plugin.manifest,
+                targetScope: scope,
+                projectRoot,
+                stores,
+            }),
+            after: await resolveEffectivePluginConfigFromStores({
+                pluginName: options.plugin.manifest.name,
+                manifest: options.plugin.manifest,
+                targetScope: scope,
+                projectRoot,
+                stores: afterStores,
+            }),
+        };
+        resolved.set(scope, pair);
+        return pair;
+    };
+    try {
+        const affectedTargets = [];
+        const sharedNativeRenderTargets = new Map();
+        for (const target of dedupeTargets(options.visibleTargets)) {
+            let affected = false;
+            const declarations = targetArtifactDeclarations(options.plugin, target);
+            if (options.plugin.manifest.scripts?.preApply
+                || (options.plugin.manifest.dependencies?.length ?? 0) > 0) {
+                const config = await resolveScope(target.scope);
+                affected = !configValuesEqual(config.before.values, config.after.values);
+            }
+            for (const declaration of declarations) {
+                if (declaration.refreshKeys.length === 0)
+                    continue;
+                const renderScope = nativeDeclaration(declaration) ? 'user' : target.scope;
+                const config = await resolveScope(renderScope);
+                const changed = !rendererProjectionEqual(config.before, config.after, declaration.refreshKeys);
+                if (!changed)
+                    continue;
+                affected = true;
+                if (nativeDeclaration(declaration)) {
+                    sharedNativeRenderTargets.set(declaration.id, {
+                        id: declaration.id,
+                        skillKey: declaration.skillKey,
+                        refreshKeys: [...declaration.refreshKeys],
+                    });
+                }
+            }
+            if (affected)
+                affectedTargets.push(target);
+        }
+        return {
+            impactState: 'known',
+            noEffectiveChange: affectedTargets.length === 0,
+            storeChanged: true,
+            storeDigest: digestStores(stores),
+            changedKeys,
+            updatedKeys,
+            removedKeys,
+            staleRemovedKeys,
+            affectedTargets,
+            sharedNativeRenderTargets: [...sharedNativeRenderTargets.values()],
+        };
+    }
+    catch {
+        return unknownImpact({
+            stores,
+            plugin: options.plugin,
+            scope: options.scope,
+            visibleTargets: options.visibleTargets,
+            storeChanged: true,
+            changedKeys,
+            updatedKeys,
+            removedKeys,
+            staleRemovedKeys,
+        });
+    }
+}
+//# sourceMappingURL=plugin-config-impact.js.map

package/dist/src/utils/plugin-config-impact.js.map

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

package/dist/src/utils/plugin-config-write.d.ts

@@ -1,54 +1,66 @@
-import type { RebuildCommandRuntime } from '../commands/rebuild-command.js';
-import { reinstallWriteCommand } from '../commands/write-commands.js';
-import type { ConfigReceiptFieldEntry, ConfigSchemaEvidence, PluginMeta, ReceiptOverallState, ReceiptTargetIdentity, ReceiptTargetResult, Scope } from '../types.js';
+import type { PreApplyAuthorizationTarget, RebuildCommandRuntime } from '../commands/rebuild-command.js';
+import { syncWriteCommand } from '../commands/write-commands.js';
+import { type ConfigApplyResult, type ConfigReceiptFieldEntry, type ConfigMutationCommand, type ConfigMutationReceiptBase, type ConfigSchemaEvidence, type PluginMeta, type RebuildReceiptOverallState, type ReceiptTargetIdentity, type ReceiptTargetResult, type Scope } from '../types.js';
 import { type NativeCliRunner } from './native-cli.js';
 import { summarizeEffectivePluginConfig } from './plugin-config.js';
-import { type ProjectBoundaryWarning } from './project-boundary.js';
 import { type AwHomeMutationToken } from './aw-home-mutation-lock.js';
 export interface PluginConfigWriteRequest {
     updates?: Record<string, unknown>;
     removeKeys?: string[];
 }
-export type ConfigApplySkippedReason = 'noVisibleTarget' | 'noConfigChange';
+export declare function buildConfigMutationReceipt<Command extends ConfigMutationCommand, Receipt extends Pick<ConfigMutationReceiptBase, 'ok' | 'overallState' | 'configWrite'>>(command: Command, receipt: Receipt): ConfigMutationReceiptBase<Command> & Receipt;
 export interface PluginConfigWriteReceipt {
     plugin: string;
     scope: Scope;
-    projectLayer: 'shared' | 'local';
     schema?: ConfigSchemaEvidence;
     updatedKeys: string[];
     removedKeys: string[];
-    effective: ReturnType<typeof summarizeEffectivePluginConfig>;
+    staleRemovedKeys: string[];
+    effective?: ReturnType<typeof summarizeEffectivePluginConfig>;
     configWrite: 'succeeded';
-    overallState: ReceiptOverallState;
-    targetResults: ReceiptTargetResult[];
-    applySkippedReason?: ConfigApplySkippedReason;
-    otherProjectsRequireReinstall: boolean;
-    warnings: Array<ProjectBoundaryWarning | string>;
+    overallState: RebuildReceiptOverallState;
+    apply: ConfigApplyResult;
+    otherProjectsMayRequireSync: boolean;
+    warnings: string[];
 }
 export interface ResetPluginConfigWriteReceipt {
     plugin: string;
     scope: Scope;
-    projectLayer: 'shared' | 'local';
     schema?: ConfigSchemaEvidence;
     existed: boolean;
     deleted: boolean;
+    resetDisposition: 'absent' | 'deletedFile' | 'unlinkedSymlink' | 'quarantinedDirectory';
+    quarantineBasename?: string;
     removedKeys: string[];
     effective?: ReturnType<typeof summarizeEffectivePluginConfig>;
     configWrite: 'succeeded';
-    overallState: ReceiptOverallState;
-    targetResults: ReceiptTargetResult[];
-    applySkippedReason?: ConfigApplySkippedReason;
-    otherProjectsRequireReinstall: boolean;
-    warnings: Array<ProjectBoundaryWarning | string>;
+    overallState: RebuildReceiptOverallState;
+    apply: ConfigApplyResult;
+    otherProjectsMayRequireSync: boolean;
+    warnings: string[];
 }
-type ReinstallCommand = typeof reinstallWriteCommand;
+type ReinstallCommand = typeof syncWriteCommand;
 interface ConfigRuntimeReplayReceipt {
     configWrite: 'succeeded';
-    overallState: ReceiptOverallState;
-    targetResults: ReceiptTargetResult[];
-    applySkippedReason?: ConfigApplySkippedReason;
-    otherProjectsRequireReinstall: boolean;
+    overallState: RebuildReceiptOverallState;
+    apply: ConfigApplyResult;
+    otherProjectsMayRequireSync: false;
 }
+export declare function configWriteStateForError(error: unknown): 'notStarted' | 'failed';
+export declare function resolveConfigPreApplyAuthorization(options: {
+    plugin: PluginMeta;
+    scope: Scope;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    applyTargets: ReceiptTargetIdentity[];
+    nativeCliRunner?: NativeCliRunner;
+    rebuildRuntime?: RebuildCommandRuntime;
+    reinstallCommandImpl?: ReinstallCommand;
+}): Promise<{
+    targets: PreApplyAuthorizationTarget[];
+    availableApplyTargets: ReceiptTargetIdentity[];
+    unavailableTargetResults: ReceiptTargetResult[];
+}>;
 export declare function replayConfigRuntimeWrites(options: {
     plugin: PluginMeta;
     scope: Scope;
@@ -60,13 +72,15 @@ export declare function replayConfigRuntimeWrites(options: {
     reinstallCommandImpl?: ReinstallCommand;
     rebuildRuntime?: RebuildCommandRuntime;
     awHomeMutationToken?: AwHomeMutationToken;
+    sharedNativeApplyConfirmed?: boolean;
+    preApplyConfirmed?: boolean;
+    preApplyAuthorizedTargets?: readonly PreApplyAuthorizationTarget[];
 }): Promise<ConfigRuntimeReplayReceipt>;
 type ApplyPluginConfigWriteOptions = {
     plugin?: PluginMeta | null;
     pluginError?: Error | null;
     pluginName?: string;
     scope: Scope;
-    projectLayer?: 'shared' | 'local';
     cwd: string;
     env?: NodeJS.ProcessEnv;
     applyTargets?: ReceiptTargetIdentity[];
@@ -75,32 +89,43 @@ type ApplyPluginConfigWriteOptions = {
     rebuildRuntime?: RebuildCommandRuntime;
     awHomeMutationToken?: AwHomeMutationToken;
     request: PluginConfigWriteRequest;
+    apply?: boolean;
+    sharedNativeApplyConfirmed?: boolean;
+    preApplyConfirmed?: boolean;
+    preApplyAuthorizedTargets?: readonly PreApplyAuthorizationTarget[];
     reviewPreflight?: () => Promise<void> | void;
 };
 export declare function applyPluginConfigWrite(options: ApplyPluginConfigWriteOptions): Promise<PluginConfigWriteReceipt>;
 type ResetPluginConfigWriteOptions = {
     pluginName: string;
+    sourceId?: string;
+    sourceIdentity?: string;
+    logicalIdentity?: string;
     scope: Scope;
-    projectLayer?: 'shared' | 'local';
     cwd: string;
     env?: NodeJS.ProcessEnv;
-    plugin: PluginMeta;
+    plugin?: PluginMeta | null;
+    pluginError?: Error | null;
     applyTargets?: ReceiptTargetIdentity[];
     nativeCliRunner?: NativeCliRunner;
     reinstallCommandImpl?: ReinstallCommand;
     rebuildRuntime?: RebuildCommandRuntime;
     awHomeMutationToken?: AwHomeMutationToken;
     reviewPreflight?: () => Promise<void> | void;
+    apply?: boolean;
+    sharedNativeApplyConfirmed?: boolean;
+    preApplyConfirmed?: boolean;
+    preApplyAuthorizedTargets?: readonly PreApplyAuthorizationTarget[];
 };
 export declare function resetPluginConfigWithHelper(options: ResetPluginConfigWriteOptions): Promise<ResetPluginConfigWriteReceipt>;
 export declare function describeResetAffectedFields(options: {
     sourceId?: string;
     sourceIdentity?: string;
+    logicalIdentity?: string;
     pluginName: string;
     plugin?: PluginMeta | null;
     pluginError?: Error | null;
     scope: Scope;
-    projectLayer?: 'shared' | 'local';
     cwd: string;
     env?: NodeJS.ProcessEnv;
 }): Promise<ConfigReceiptFieldEntry[]>;