@lesliechan721/aw 0.1.0-beta.3

package/dist/src/commands/options.js

@@ -0,0 +1,146 @@
+export const SCRIPT_TIMEOUT_MIN_MS = 1000;
+export const SCRIPT_TIMEOUT_MAX_MS = 300000;
+export const SCRIPT_TIMEOUT_DEFAULT_MS = 30000;
+export const CONFIG_WRITE_DEFAULT_SCOPE = 'user';
+export const CONFIG_READ_DEFAULT_RESOLUTION = 'effective';
+function renderUnsupportedValue(value) {
+    return typeof value === 'string' ? value : String(value);
+}
+export function parseScopeValue(scope) {
+    if (scope === 'project' || scope === 'user') {
+        return scope;
+    }
+    throw new Error(`Unsupported scope "${renderUnsupportedValue(scope)}".`);
+}
+export function parsePlatformValue(platform) {
+    if (platform === 'codex' || platform === 'claude' || platform === 'both') {
+        return platform;
+    }
+    throw new Error(`Unsupported platform "${renderUnsupportedValue(platform)}". Expected one of: codex, claude, both.`);
+}
+export function parseScriptTimeoutMs(value) {
+    const rendered = renderUnsupportedValue(value);
+    const parsed = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim() !== ''
+            ? Number(value)
+            : Number.NaN;
+    if (!Number.isInteger(parsed)) {
+        throw new Error(`Unsupported script timeout "${rendered}". Expected an integer between ${SCRIPT_TIMEOUT_MIN_MS} and ${SCRIPT_TIMEOUT_MAX_MS} milliseconds.`);
+    }
+    if (parsed < SCRIPT_TIMEOUT_MIN_MS || parsed > SCRIPT_TIMEOUT_MAX_MS) {
+        throw new Error(`Unsupported script timeout "${rendered}". Expected a value between ${SCRIPT_TIMEOUT_MIN_MS} and ${SCRIPT_TIMEOUT_MAX_MS} milliseconds.`);
+    }
+    return parsed;
+}
+export function resolveScriptTimeoutMs(raw) {
+    const value = raw.scriptTimeoutMs ?? raw.scriptTimeout;
+    return value === undefined ? undefined : parseScriptTimeoutMs(value);
+}
+export function resolveConfigWriteScope(scope) {
+    return scope === undefined ? CONFIG_WRITE_DEFAULT_SCOPE : parseScopeValue(scope);
+}
+export function resolveConfigReadResolution(scope) {
+    return scope === undefined ? CONFIG_READ_DEFAULT_RESOLUTION : parseScopeValue(scope);
+}
+export function resolveConfigProjectLayer(raw = {}) {
+    if (!raw.local) {
+        return 'shared';
+    }
+    if (raw.scope !== 'project') {
+        throw new Error('`--local` 只能与 `--scope project` 一起使用。');
+    }
+    return 'local';
+}
+function resolveCwd(rawCwd, defaultCwd) {
+    return rawCwd ?? defaultCwd ?? process.cwd();
+}
+export function normalizeCommandOptions(raw = {}, defaults = {}) {
+    const scriptTimeoutMs = resolveScriptTimeoutMs(raw);
+    const platformInput = raw.platform ?? defaults.defaultPlatform;
+    if (platformInput === undefined && defaults.requirePlatform) {
+        throw new Error(defaults.missingPlatformMessage ?? '命令需要显式指定 `--platform codex|claude|both`。');
+    }
+    return {
+        cwd: resolveCwd(raw.cwd, defaults.cwd),
+        scope: parseScopeValue(raw.scope ?? defaults.defaultScope ?? 'user'),
+        platform: parsePlatformValue(platformInput ?? 'both'),
+        ...(scriptTimeoutMs === undefined ? {} : { scriptTimeoutMs }),
+    };
+}
+export function normalizeInstallCommandOptions(raw = {}, defaults = {}) {
+    return {
+        ...normalizeCommandOptions(raw, {
+            defaultScope: 'user',
+            requirePlatform: true,
+            missingPlatformMessage: 'install 命令需要显式指定 `--platform codex|claude|both`。',
+            ...defaults,
+        }),
+    };
+}
+export function normalizeUpgradeCommandOptions(raw = {}, defaults = {}) {
+    return {
+        ...normalizeCommandOptions(raw, {
+            defaultScope: 'user',
+            requirePlatform: true,
+            missingPlatformMessage: 'upgrade 命令需要显式指定 `--platform codex|claude|both`。',
+            ...defaults,
+        }),
+        all: raw.all,
+    };
+}
+function parseStatusPlatformFilter(platform) {
+    if (platform === undefined) {
+        return 'both';
+    }
+    return parsePlatformValue(platform);
+}
+export function normalizeStatusCommandOptions(raw = {}, defaults = {}) {
+    const scope = raw.scope === undefined ? undefined : parseScopeValue(raw.scope);
+    const platform = parseStatusPlatformFilter(raw.platform);
+    return {
+        cwd: resolveCwd(raw.cwd, defaults.cwd),
+        ...(scope === undefined ? {} : { scope }),
+        ...(platform === undefined ? {} : { platform }),
+        verbose: raw.verbose,
+        json: raw.json,
+    };
+}
+export function normalizeUninstallCommandOptions(raw = {}, defaults = {}) {
+    return {
+        ...normalizeCommandOptions(raw, {
+            defaultScope: 'user',
+            requirePlatform: true,
+            missingPlatformMessage: 'uninstall 命令需要显式指定 `--platform codex|claude|both`。',
+            ...defaults,
+        }),
+    };
+}
+export function normalizeCleanupCommandOptions(raw = {}, defaults = {}) {
+    if (raw.scope === undefined) {
+        throw new Error('cleanup 命令需要显式指定 `--scope project|user`。');
+    }
+    const normalized = {
+        ...normalizeCommandOptions(raw, {
+            defaultScope: 'user',
+            requirePlatform: true,
+            missingPlatformMessage: 'cleanup 命令需要显式指定 `--platform codex|claude|both`。',
+            ...defaults,
+        }),
+        json: raw.json === true,
+        force: raw.force === true,
+    };
+    return normalized;
+}
+export function normalizeReinstallCommandOptions(raw = {}, defaults = {}) {
+    return {
+        ...normalizeInstallCommandOptions(raw, {
+            defaultScope: 'user',
+            requirePlatform: true,
+            missingPlatformMessage: 'reinstall 命令需要显式指定 `--platform codex|claude|both`。',
+            ...defaults,
+        }),
+        json: raw.json === true,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/src/commands/options.js.map

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

package/dist/src/commands/rebuild-command.d.ts

@@ -0,0 +1,77 @@
+import type { CatalogResolution, CommandOptions, GeneratedArtifact, PlatformName, ReceiptOverallState, ReceiptTargetResult, Scope } from '../types.js';
+import { type RebuildCommand, type RebuildResult, type RebuildTargetIdentity } from './rebuild-operations.js';
+import { type PreparedRebuildTarget, type RebuildExecutionContext } from './rebuild-integration.js';
+import type { AwHomeMutationToken } from '../utils/aw-home-mutation-lock.js';
+import { type DependencyOperationPlan } from './dependency-operation-plan.js';
+export type RebuildCommandRuntime = Partial<RebuildExecutionContext> & {
+    awHomeMutationToken?: AwHomeMutationToken;
+    catalogResolution?: CatalogResolution;
+    namespacedSource?: {
+        sourceId: string;
+        sourceIdentity: string;
+        marketplaceName: string;
+        marketplaceRoot: string;
+    };
+    expectedCatalogConfigDigest?: string;
+    reviewPreflight?: (evidence: RebuildReviewPreflightEvidence) => Promise<void> | void;
+    resolvedReviewEvidenceByPlugin?: Record<string, Omit<RebuildReviewPreflightEvidence, 'command' | 'identity'>>;
+    operationLeaseHeld?: boolean;
+    bypassDependencyPlan?: boolean;
+    dependencyReviewPreflightHandled?: boolean;
+    previewDependencyPlanOnly?: boolean;
+    targetBuiltHookHandled?: boolean;
+    preparedTarget?: PreparedRebuildTarget;
+    preparedTargetError?: unknown;
+    removeObsoleteInstallationContracts?: (directory: string) => Promise<void>;
+    corruptExclusiveDirectoryOperations?: {
+        rename?: (source: string, destination: string) => Promise<void>;
+        remove?: (target: string) => Promise<void>;
+    };
+};
+export interface RebuildReviewPreflightEvidence {
+    command: RebuildCommand;
+    identity: RebuildTargetIdentity;
+    configDigest?: string;
+    sourceId?: string;
+    sourceIdentity?: string;
+    resolvedCommit?: string;
+    manifestDigest?: string;
+    snapshotDigest?: string;
+    contentDigest?: string;
+}
+export interface RebuildCommandResult {
+    platforms: string[];
+    plugins: string[];
+    warnings: string[];
+    rebuildResults: RebuildResult[];
+    targetResults: ReceiptTargetResult[];
+    overallState: ReceiptOverallState;
+    nativePlugins: Partial<Record<PlatformName, string[]>>;
+    repoManagedArtifacts: GeneratedArtifact[];
+    receiptTargets: Array<{
+        pluginName: string;
+        pluginId?: string;
+        sourceId?: string;
+        platform: PlatformName;
+        scope: Scope;
+    }>;
+    dependencyPlan?: DependencyOperationPlan;
+}
+export interface RebuildCommandTestHooks {
+    beforeOperationLockAcquire?: (options: {
+        command: RebuildCommand;
+        identity: RebuildTargetIdentity;
+    }) => Promise<void>;
+    afterTargetBuilt?: (options: {
+        command: RebuildCommand;
+        identity: RebuildTargetIdentity;
+    }) => Promise<void>;
+}
+export declare function setRebuildCommandTestHooksForTests(hooks: RebuildCommandTestHooks | undefined): void;
+export declare function runRebuildCommand(options: {
+    command: RebuildCommand;
+    pluginNames: string[];
+    commandOptions: CommandOptions;
+    runtime?: RebuildCommandRuntime;
+    all?: boolean;
+}): Promise<RebuildCommandResult>;