@detergent-software/atk 3.0.0-dev.2 → 3.0.0-dev.21

package/build/lib/sync.d.ts

@@ -0,0 +1,109 @@
+import type { InstallResult } from './installer.js';
+import type { Adapter } from './schemas/adapter.js';
+import type { ProjectConfig } from './schemas/config.js';
+import type { InstalledAsset } from './schemas/lockfile.js';
+import type { Registry } from './schemas/registry.js';
+export interface ClassifySyncEntriesOptions {
+    adapter: Adapter;
+    assets: InstalledAsset[];
+    force: boolean;
+    onProgress?: (msg: string) => void;
+    projectConfig: null | ProjectConfig;
+    projectDir: string;
+}
+export interface ClassifySyncEntriesResult {
+    frozenSkipped: number;
+    skipped: number;
+    toSync: SyncEntry[];
+}
+export interface DryRunSyncOptions {
+    force: boolean;
+    onProgress?: (msg: string) => void;
+    projectConfig: null | ProjectConfig;
+    projectDir: string;
+    tools: Array<{
+        adapter: Adapter;
+        tool: string;
+    }>;
+}
+export interface SyncAssetsOptions {
+    force: boolean;
+    onProgress?: (msg: string) => void;
+    projectConfig: null | ProjectConfig;
+    projectDir: string;
+    registry: Registry;
+    tools: Array<{
+        adapter: Adapter;
+        tool: string;
+    }>;
+}
+export interface SyncEntry {
+    asset: InstalledAsset;
+    reason: 'forced' | 'missing' | 'modified';
+    result?: InstallResult;
+}
+export interface SyncFailure {
+    assetName: string;
+    assetType: string;
+    error: string;
+    version: string;
+}
+export type SyncOutcome = {
+    outcome: 'dry-run';
+    toolResults: ToolDryRunResult[];
+} | {
+    outcome: 'synced';
+    toolResults: ToolSyncResult[];
+};
+export interface ToolDryRunResult {
+    bootstrapHint?: string;
+    frozenSkipped: number;
+    skipped: number;
+    tool: string;
+    toSync: SyncEntry[];
+}
+export interface ToolSyncResult {
+    bootstrapHint?: string;
+    failures: SyncFailure[];
+    frozenSkipped: number;
+    skipped: number;
+    synced: SyncEntry[];
+    tool: string;
+}
+/**
+ * Classify installed assets into entries that need syncing vs. those that
+ * can be skipped. This consolidates the duplicated checksum-checking loop
+ * that previously appeared in both the dry-run and live sync paths.
+ *
+ * For each asset the function:
+ *  1. Checks if the asset is frozen — if so, increments `frozenSkipped`.
+ *  2. If `force` is true, marks it as `forced` without checking checksums.
+ *  3. Otherwise, resolves installed paths via the adapter, verifies checksums,
+ *     and classifies as `missing` or `modified` when checksums fail, or
+ *     increments `skipped` when all checksums pass.
+ */
+export declare function classifySyncEntries(options: ClassifySyncEntriesOptions): Promise<ClassifySyncEntriesResult>;
+/**
+ * Perform a dry-run sync: read the lockfile (without locking), classify each
+ * tool's assets, and return the results so the UI can display what *would*
+ * be synced.
+ *
+ * This fixes finding O10.3 by populating `bootstrapHint` when a tool has no
+ * installed assets, which the original inline dry-run path in sync.tsx omitted.
+ */
+export declare function dryRunSync(options: DryRunSyncOptions): Promise<ToolDryRunResult[]>;
+/**
+ * Perform a live sync: acquire the lockfile lock, classify each tool's assets,
+ * then remove and reinstall drifted entries.
+ *
+ * Uses `removeSingleAsset()` for disk-only cleanup (no lockfile I/O) and
+ * manages lockfile state in-memory with a single read at the start and a
+ * single write at the end. This follows the same pattern established by
+ * `executeBundleUninstall()` in `uninstaller.ts`.
+ *
+ * NOTE: Sync reinstalls only the direct asset, not its dependencies. This is
+ * intentional per F4.2 — dependencies are assumed to already be installed and
+ * are not re-fetched during a sync operation.
+ */
+export declare function syncAssets(options: SyncAssetsOptions): Promise<ToolSyncResult[]>;
+//# sourceMappingURL=sync.d.ts.map

package/build/lib/sync.d.ts.map

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

package/build/lib/sync.js

@@ -0,0 +1,221 @@
+import { join } from 'node:path';
+import { resolveInstalledPaths } from './adapter.js';
+import { verifyChecksums } from './checksum.js';
+import { isFrozenInConfig } from './config.js';
+import { executeInstallPlan, InstallerError } from './installer.js';
+import { addAssetToLockfile, readLockfile, removeAssetFromLockfile, withLockfileErrorHandling, writeLockfile } from './lockfile.js';
+import { resolveInstallPlan, ResolverError } from './resolver.js';
+import { removeSingleAsset, UninstallerError } from './uninstaller.js';
+// ---------------------------------------------------------------------------
+// Dry-run orchestration
+// ---------------------------------------------------------------------------
+/**
+ * Classify installed assets into entries that need syncing vs. those that
+ * can be skipped. This consolidates the duplicated checksum-checking loop
+ * that previously appeared in both the dry-run and live sync paths.
+ *
+ * For each asset the function:
+ *  1. Checks if the asset is frozen — if so, increments `frozenSkipped`.
+ *  2. If `force` is true, marks it as `forced` without checking checksums.
+ *  3. Otherwise, resolves installed paths via the adapter, verifies checksums,
+ *     and classifies as `missing` or `modified` when checksums fail, or
+ *     increments `skipped` when all checksums pass.
+ */
+export async function classifySyncEntries(options) {
+    const { adapter, assets, force, onProgress, projectConfig, projectDir } = options;
+    const toSync = [];
+    let frozenSkipped = 0;
+    let skipped = 0;
+    for (const asset of assets) {
+        onProgress?.(`Checking ${asset.name}...`);
+        if (isFrozenInConfig(projectConfig, asset.name, asset.type, asset.org)) {
+            frozenSkipped++;
+            continue;
+        }
+        if (force) {
+            toSync.push({ asset, reason: 'forced' });
+            continue;
+        }
+        const resolved = resolveInstalledPaths(asset, adapter, projectDir);
+        const filesToCheck = resolved.files.map((f) => ({
+            checksum: f.checksum,
+            path: join(projectDir, f.installedPath),
+        }));
+        const checksumFailures = await verifyChecksums(filesToCheck);
+        if (checksumFailures.length === 0) {
+            skipped++;
+            continue;
+        }
+        const hasMissing = checksumFailures.some((f) => f.actual.startsWith('FILE_NOT_FOUND'));
+        toSync.push({
+            asset,
+            reason: hasMissing ? 'missing' : 'modified',
+        });
+    }
+    return { frozenSkipped, skipped, toSync };
+}
+/**
+ * Perform a dry-run sync: read the lockfile (without locking), classify each
+ * tool's assets, and return the results so the UI can display what *would*
+ * be synced.
+ *
+ * This fixes finding O10.3 by populating `bootstrapHint` when a tool has no
+ * installed assets, which the original inline dry-run path in sync.tsx omitted.
+ */
+export async function dryRunSync(options) {
+    const { force, onProgress, projectConfig, projectDir, tools } = options;
+    onProgress?.('Reading lockfile...');
+    const lockfile = await readLockfile(projectDir);
+    const toolResults = [];
+    for (const { adapter, tool: toolName } of tools) {
+        const toolAssets = lockfile.assets ?? [];
+        if (toolAssets.length === 0) {
+            toolResults.push({
+                bootstrapHint: `Run "atk install <asset>" to install assets for ${toolName}`,
+                frozenSkipped: 0,
+                skipped: 0,
+                tool: toolName,
+                toSync: [],
+            });
+            continue;
+        }
+        const classified = await classifySyncEntries({
+            adapter,
+            assets: toolAssets,
+            force,
+            onProgress: onProgress
+                ? (msg) => onProgress(`${msg} for ${toolName}`)
+                : undefined,
+            projectConfig,
+            projectDir,
+        });
+        toolResults.push({
+            frozenSkipped: classified.frozenSkipped,
+            skipped: classified.skipped,
+            tool: toolName,
+            toSync: classified.toSync,
+        });
+    }
+    return toolResults;
+}
+// ---------------------------------------------------------------------------
+// Live sync orchestration
+// ---------------------------------------------------------------------------
+/**
+ * Perform a live sync: acquire the lockfile lock, classify each tool's assets,
+ * then remove and reinstall drifted entries.
+ *
+ * Uses `removeSingleAsset()` for disk-only cleanup (no lockfile I/O) and
+ * manages lockfile state in-memory with a single read at the start and a
+ * single write at the end. This follows the same pattern established by
+ * `executeBundleUninstall()` in `uninstaller.ts`.
+ *
+ * NOTE: Sync reinstalls only the direct asset, not its dependencies. This is
+ * intentional per F4.2 — dependencies are assumed to already be installed and
+ * are not re-fetched during a sync operation.
+ */
+export async function syncAssets(options) {
+    const { force, onProgress, projectConfig, projectDir, registry, tools } = options;
+    return withLockfileErrorHandling(projectDir, async () => {
+        onProgress?.('Reading lockfile...');
+        let lockfile = await readLockfile(projectDir);
+        const toolResults = [];
+        for (const { adapter, tool: toolName } of tools) {
+            const toolAssets = lockfile.assets ?? [];
+            if (toolAssets.length === 0) {
+                toolResults.push({
+                    bootstrapHint: 'No assets installed. Run `atk setup` to initialize.',
+                    failures: [],
+                    frozenSkipped: 0,
+                    skipped: 0,
+                    synced: [],
+                    tool: toolName,
+                });
+                continue;
+            }
+            const classified = await classifySyncEntries({
+                adapter,
+                assets: toolAssets,
+                force,
+                onProgress: onProgress
+                    ? (msg) => onProgress(`${msg} for ${toolName}`)
+                    : undefined,
+                projectConfig,
+                projectDir,
+            });
+            if (classified.toSync.length === 0) {
+                toolResults.push({
+                    failures: [],
+                    frozenSkipped: classified.frozenSkipped,
+                    skipped: classified.skipped,
+                    synced: [],
+                    tool: toolName,
+                });
+                continue;
+            }
+            const failures = [];
+            for (const entry of classified.toSync) {
+                onProgress?.(`Syncing ${entry.asset.name} for ${toolName}...`);
+                // Save the original lockfile entry so we can restore it on reinstall failure
+                const originalEntry = entry.asset;
+                // Step 1: Disk-only cleanup via removeSingleAsset (no lockfile I/O).
+                // Tolerate UninstallerError (e.g., files already missing) but propagate
+                // unexpected errors.
+                try {
+                    await removeSingleAsset(originalEntry, adapter, projectDir, onProgress);
+                }
+                catch (error) {
+                    if (!(error instanceof UninstallerError)) {
+                        throw error;
+                    }
+                }
+                // Step 2: Track removal in the in-memory lockfile
+                lockfile = removeAssetFromLockfile(lockfile, originalEntry.name, originalEntry.type, originalEntry.org);
+                // Step 3: Reinstall the direct asset only (not dependencies — intentional per F4.2).
+                // Resolve the full plan but filter to just the direct asset entry.
+                try {
+                    const plan = resolveInstallPlan(registry, originalEntry.name, originalEntry.type, originalEntry.version);
+                    const directEntries = plan.entries.filter((e) => e.asset.name === originalEntry.name);
+                    const directPlan = { entries: directEntries, totalCount: directEntries.length };
+                    const results = await executeInstallPlan(directPlan, {
+                        adapter,
+                        onProgress,
+                        projectDir,
+                    });
+                    entry.result = results[0];
+                    // Step 4: After successful reinstall, re-read the lockfile from disk
+                    // to capture the state that executeInstallPlan wrote, and keep our
+                    // in-memory copy in sync.
+                    lockfile = await readLockfile(projectDir);
+                }
+                catch (error) {
+                    if (error instanceof ResolverError || error instanceof InstallerError) {
+                        // On reinstall failure, restore the original InstalledAsset entry
+                        // back into the in-memory lockfile so it is not silently dropped.
+                        lockfile = addAssetToLockfile(lockfile, originalEntry);
+                        failures.push({
+                            assetName: originalEntry.name,
+                            assetType: originalEntry.type,
+                            error: error.message,
+                            version: originalEntry.version,
+                        });
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+            toolResults.push({
+                failures,
+                frozenSkipped: classified.frozenSkipped,
+                skipped: classified.skipped,
+                synced: classified.toSync.filter((e) => e.result !== undefined),
+                tool: toolName,
+            });
+        }
+        // Write the lockfile once at the end to persist any in-memory mutations
+        // (e.g., restored entries from failed reinstalls)
+        await writeLockfile(projectDir, lockfile);
+        return toolResults;
+    });
+}
+//# sourceMappingURL=sync.js.map

package/build/lib/sync.js.map

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

package/build/lib/tool-resolver.d.ts

@@ -1,16 +1,39 @@
 import type { Adapter } from './schemas/adapter.js';
 /**
- * Resolve which tool to target, returning both the resolved tool name and its adapter config.
+ * Resolve a single tool to target, returning both the resolved tool name and its adapter config.
+ *
+ * Convenience wrapper around `resolveTools()` that returns the first result.
+ * When `toolOption` is provided, returns that specific tool.
+ * When no `toolOption`, returns the first tool from the project config `tools` array.
+ */
+export declare function resolveTool(toolOption?: string, projectDir?: string): Promise<{
+    adapter: Adapter;
+    tool: string;
+}>;
+/**
+ * Resolve targeted tool names without loading adapter JSON.
  *
  * Resolution order:
- *   1. Explicit `--tool` CLI flag
- *   2. Project config `.atkrc.json` `tool` field
+ *   1. Explicit `--tool` CLI flag → returns `[toolOption]` immediately
+ *   2. Project config `.atkrc.json` `tools` array → returns the array as-is
  *   3. Error directing user to run `atk setup`
  *
- * No auto-detection is performed — the tool must be explicitly configured.
+ * This is a lightweight alternative to `resolveTools()` for callers that only
+ * need the tool name strings and do not need the full adapter definitions.
  */
-export declare function resolveTool(toolOption: string | undefined, projectDir?: string): Promise<{
+export declare function resolveToolNames(toolOption?: string, projectDir?: string): Promise<string[]>;
+/**
+ * Resolve all targeted tools, returning an array of tool names and their adapter configs.
+ *
+ * Resolution order:
+ *   1. Explicit `--tool` CLI flag → returns only that single tool (filter behavior)
+ *   2. Project config `.atkrc.json` `tools` array → returns all configured tools
+ *   3. Error directing user to run `atk setup`
+ *
+ * No auto-detection is performed — tools must be explicitly configured.
+ */
+export declare function resolveTools(toolOption?: string, projectDir?: string): Promise<Array<{
     adapter: Adapter;
     tool: string;
-}>;
+}>>;
 //# sourceMappingURL=tool-resolver.d.ts.map

package/build/lib/tool-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/tool-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAMpD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB7C"}
+{"version":3,"file":"tool-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/tool-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAMpD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAG7C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwBpD"}

package/build/lib/tool-resolver.js

@@ -2,28 +2,67 @@ import { loadAdapter } from './adapter.js';
 import { loadProjectConfig } from './config.js';
 import { findProjectRoot } from './paths.js';
 /**
- * Resolve which tool to target, returning both the resolved tool name and its adapter config.
+ * Resolve a single tool to target, returning both the resolved tool name and its adapter config.
+ *
+ * Convenience wrapper around `resolveTools()` that returns the first result.
+ * When `toolOption` is provided, returns that specific tool.
+ * When no `toolOption`, returns the first tool from the project config `tools` array.
+ */
+export async function resolveTool(toolOption, projectDir) {
+    const results = await resolveTools(toolOption, projectDir);
+    return results[0];
+}
+/**
+ * Resolve targeted tool names without loading adapter JSON.
  *
  * Resolution order:
- *   1. Explicit `--tool` CLI flag
- *   2. Project config `.atkrc.json` `tool` field
+ *   1. Explicit `--tool` CLI flag → returns `[toolOption]` immediately
+ *   2. Project config `.atkrc.json` `tools` array → returns the array as-is
  *   3. Error directing user to run `atk setup`
  *
- * No auto-detection is performed — the tool must be explicitly configured.
+ * This is a lightweight alternative to `resolveTools()` for callers that only
+ * need the tool name strings and do not need the full adapter definitions.
  */
-export async function resolveTool(toolOption, projectDir) {
+export async function resolveToolNames(toolOption, projectDir) {
+    if (toolOption) {
+        return [toolOption];
+    }
     const resolvedDir = projectDir ?? findProjectRoot();
-    let tool = toolOption;
-    if (!tool) {
-        const projectConfig = await loadProjectConfig(resolvedDir);
-        if (projectConfig?.tool) {
-            tool = projectConfig.tool;
-        }
+    const projectConfig = await loadProjectConfig(resolvedDir);
+    const tools = projectConfig?.tools;
+    if (!tools || tools.length === 0) {
+        throw new Error('No tools configured. Run `atk setup` to select your AI coding tool.');
+    }
+    return tools;
+}
+/**
+ * Resolve all targeted tools, returning an array of tool names and their adapter configs.
+ *
+ * Resolution order:
+ *   1. Explicit `--tool` CLI flag → returns only that single tool (filter behavior)
+ *   2. Project config `.atkrc.json` `tools` array → returns all configured tools
+ *   3. Error directing user to run `atk setup`
+ *
+ * No auto-detection is performed — tools must be explicitly configured.
+ */
+export async function resolveTools(toolOption, projectDir) {
+    const resolvedDir = projectDir ?? findProjectRoot();
+    // When --tool flag is provided, return only that single tool
+    if (toolOption) {
+        const adapter = await loadAdapter(toolOption);
+        return [{ adapter, tool: toolOption }];
+    }
+    // Read all tools from project config
+    const projectConfig = await loadProjectConfig(resolvedDir);
+    const tools = projectConfig?.tools;
+    if (!tools || tools.length === 0) {
+        throw new Error('No tools configured. Run `atk setup` to select your AI coding tool.');
     }
-    if (!tool) {
-        throw new Error('No tool configured. Run `atk setup` to select your AI coding tool.');
+    const results = [];
+    for (const tool of tools) {
+        const adapter = await loadAdapter(tool);
+        results.push({ adapter, tool });
     }
-    const adapter = await loadAdapter(tool);
-    return { adapter, tool };
+    return results;
 }
 //# sourceMappingURL=tool-resolver.js.map

package/build/lib/tool-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-resolver.js","sourceRoot":"","sources":["../../src/lib/tool-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAA8B,EAC9B,UAAmB;IAEnB,MAAM,WAAW,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IAEpD,IAAI,IAAI,GAAuB,UAAU,CAAC;IAE1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,aAAa,EAAE,IAAI,EAAE,CAAC;YACxB,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"tool-resolver.js","sourceRoot":"","sources":["../../src/lib/tool-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAmB,EACnB,UAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAmB,EACnB,UAAmB;IAEnB,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,CAAC;IAEnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAmB,EACnB,UAAmB;IAEnB,MAAM,WAAW,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IAEpD,6DAA6D;IAC7D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9C,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,qCAAqC;IACrC,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,CAAC;IAEnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,OAAO,GAA8C,EAAE,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/lib/updater.d.ts

@@ -1,5 +1,6 @@
 import type { Adapter } from './schemas/adapter.js';
 import type { InstalledAsset, Lockfile } from './schemas/lockfile.js';
+import type { AssetType } from './schemas/manifest.js';
 import type { Registry } from './schemas/registry.js';
 import { type InstallResult } from './installer.js';
 export interface OutdatedAsset {
@@ -12,7 +13,7 @@ export interface OutdatedAsset {
     org?: string;
     /** Whether the asset is version-pinned. */
     pinned?: boolean;
-    type: string;
+    type: AssetType;
 }
 export interface UpdateAssetsResult {
     failures: UpdateFailure[];
@@ -25,13 +26,15 @@ export interface UpdateAssetsResult {
 export interface UpdateFailure {
     error: string;
     name: string;
-    type: string;
+    type: AssetType;
 }
 export interface UpdateOptions {
     /** Adapter for the target tool. */
     adapter: Adapter;
     /** Force update even if the asset is pinned. */
     force?: boolean;
+    /** Set of frozen asset composite keys in format `${type}:${org ?? ''}:${name}`. */
+    frozenAssets?: Set<string>;
     /** Pre-read lockfile to avoid redundant reads (used for dropped dependency cleanup). */
     lockfile?: Lockfile;
     /** Callback for progress updates. */
@@ -46,7 +49,7 @@ export interface UpdateResult {
     installResult: InstallResult;
     name: string;
     toVersion: string;
-    type: string;
+    type: AssetType;
 }
 export declare class UpdaterError extends Error {
     constructor(message: string);
@@ -56,7 +59,7 @@ export declare class UpdaterError extends Error {
  * Compares the installed version against the asset's `latest` version
  * using the version-aware `findAsset` lookup.
  */
-export declare function checkOutdated(lockfile: Lockfile, registry: Registry): OutdatedAsset[];
+export declare function checkOutdated(lockfile: Lockfile, registry: Registry, frozenNames?: Set<string>): OutdatedAsset[];
 /**
  * Update a single asset to the target version (defaults to latest).
  * Uninstalls the current version and installs the target from registry.

package/build/lib/updater.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../src/lib/updater.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMxE,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,aAAa,EAAE,CAyBrF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAsGvB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAChC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAsH7B"}
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../src/lib/updater.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMxE,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mFAAmF;IACnF,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,aAAa,EAAE,CA0BjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAwGvB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAChC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAuH7B"}

package/build/lib/updater.js

@@ -15,7 +15,7 @@ export class UpdaterError extends Error {
  * Compares the installed version against the asset's `latest` version
  * using the version-aware `findAsset` lookup.
  */
-export function checkOutdated(lockfile, registry) {
+export function checkOutdated(lockfile, registry, frozenNames) {
     const outdated = [];
     for (const installed of lockfile.assets ?? []) {
         const resolved = findAsset(registry, installed.name, installed.type, undefined, installed.org);
@@ -25,8 +25,9 @@ export function checkOutdated(lockfile, registry) {
         }
         // resolved.version is the latest version (findAsset defaults to latest)
         if (isNewer(resolved.version, installed.version)) {
+            const compositeKey = `${installed.type}:${installed.org ?? ''}:${installed.name}`;
             outdated.push({
-                frozen: installed.frozen ? true : undefined,
+                frozen: frozenNames?.has(compositeKey) ? true : undefined,
                 installedVersion: installed.version,
                 latestVersion: resolved.version,
                 name: installed.name,
@@ -43,7 +44,8 @@ export function checkOutdated(lockfile, registry) {
  * Uninstalls the current version and installs the target from registry.
  */
 export async function updateAsset(assetName, installed, registry, options) {
-    const { adapter, onProgress, projectDir, targetVersion } = options;
+    const { adapter: defaultAdapter, onProgress, projectDir, targetVersion } = options;
+    const adapter = defaultAdapter;
     // Resolve the target version — defaults to latest when targetVersion is undefined
     const resolved = findAsset(registry, assetName, installed.type, targetVersion, installed.org);
     if (!resolved) {
@@ -108,7 +110,7 @@ export async function updateAsset(assetName, installed, registry, options) {
     if (droppedDeps.length > 0) {
         const updatedLockfile = options.lockfile ?? (await readLockfile(projectDir));
         for (const dep of droppedDeps) {
-            const depAsset = findInstalledAsset(updatedLockfile, dep.name, dep.type);
+            const depAsset = findInstalledAsset(updatedLockfile, dep.name, dep.type, dep.org);
             if (!depAsset)
                 continue;
             // Only remove if it was a dependency and no other asset depends on it
@@ -144,7 +146,8 @@ export async function updateAssets(assetNames, lockfile, registry, options) {
             throw new UpdaterError(`Asset "${name}" is not installed.`);
         }
         // Check frozen state for explicitly targeted asset
-        if (installed.frozen) {
+        const compositeKey = `${installed.type}:${installed.org ?? ''}:${name}`;
+        if (options.frozenAssets?.has(compositeKey)) {
             throw new UpdaterError(`Asset "${name}" is frozen. Use "atk thaw ${name}" to unfreeze it before updating.`);
         }
         // Check pin state for explicitly targeted asset
@@ -158,7 +161,7 @@ export async function updateAssets(assetNames, lockfile, registry, options) {
         });
         return { failures: [], results: [result] };
     }
-    const outdated = checkOutdated(lockfile, registry);
+    const outdated = checkOutdated(lockfile, registry, options.frozenAssets);
     let toUpdate;
     const frozenSkipped = [];
     const skipped = [];
@@ -250,7 +253,9 @@ function isNewer(registryVersion, installedVersion) {
     if (valid(registryVersion) && valid(installedVersion)) {
         return compare(registryVersion, installedVersion) > 0;
     }
-    // Fallback: string comparison
+    // Defensive fallback: when version strings are not valid semver, treat any
+    // difference as "newer" so the change is surfaced for user review rather than
+    // silently ignored.
     return registryVersion !== installedVersion;
 }
 //# sourceMappingURL=updater.js.map