@detergent-software/atk 3.0.0-dev.9 → 4.0.0

package/build/lib/search.js

@@ -1,4 +1,62 @@
 import { filterVisibleAssets } from './registry.js';
+import { AssetType } from './schemas/manifest.js';
+/**
+ * Parse and validate a type filter string.
+ * Returns 'bundle' for the bundle type, or a validated AssetType.
+ * Throws an Error if the type string is not recognized.
+ */
+export function parseTypeFilter(type) {
+    if (type === 'bundle') {
+        return 'bundle';
+    }
+    const result = AssetType.safeParse(type);
+    if (!result.success) {
+        throw new Error(`Invalid type '${type}'. Valid types are: ${AssetType.options.join(', ')}, bundle`);
+    }
+    return result.data;
+}
+/**
+ * Score an item (asset or bundle) against search terms.
+ * Higher score = better match.
+ *
+ * Accepts pre-lowercased name, description, and author strings,
+ * the raw tags array, the search terms, and the full query string.
+ */
+export function scoreItem(name, description, author, tags, terms, fullQuery) {
+    let score = 0;
+    // Exact name match — highest weight
+    if (name === fullQuery) {
+        score += 100;
+    }
+    // Name contains the full query
+    else if (name.includes(fullQuery)) {
+        score += 50;
+    }
+    // Description contains the full query
+    if (description.includes(fullQuery)) {
+        score += 20;
+    }
+    // Per-term matching
+    for (const term of terms) {
+        // Name contains term
+        if (name.includes(term)) {
+            score += 10;
+        }
+        // Description contains term
+        if (description.includes(term)) {
+            score += 5;
+        }
+        // Tag exact match
+        if (tags.some((t) => t.toLowerCase() === term)) {
+            score += 8;
+        }
+        // Author matches
+        if (author.includes(term)) {
+            score += 3;
+        }
+    }
+    return score;
+}
 /**
  * Search the registry for assets and bundles matching a query.
  * Returns results sorted by relevance score (highest first).
@@ -18,7 +76,9 @@ export function searchRegistry(registry, options) {
             if (tag && !asset.tags.some((t) => t.toLowerCase() === tag.toLowerCase()))
                 continue;
             const latestVersion = asset.versions[asset.latest];
-            if (tool && !(latestVersion?.tools.includes(tool) ?? false))
+            if (!latestVersion)
+                continue;
+            if (tool && !latestVersion.tools.includes(tool))
                 continue;
             let score = scoreAsset(asset, queryTerms, queryLower);
             // Org-scoped assets get a small scoring bonus when org is active
@@ -53,83 +113,23 @@ export function searchRegistry(registry, options) {
 }
 /**
  * Score an asset against search terms.
- * Higher score = better match.
+ * Thin wrapper that extracts fields from the asset and delegates to scoreItem.
  */
 function scoreAsset(asset, terms, fullQuery) {
-    let score = 0;
     const nameLower = asset.name.toLowerCase();
     const latestVersion = asset.versions[asset.latest];
     const descLower = (latestVersion?.description ?? '').toLowerCase();
     const authorLower = (latestVersion?.author ?? '').toLowerCase();
-    // Exact name match — highest weight
-    if (nameLower === fullQuery) {
-        score += 100;
-    }
-    // Name contains the full query
-    else if (nameLower.includes(fullQuery)) {
-        score += 50;
-    }
-    // Description contains the full query
-    if (descLower.includes(fullQuery)) {
-        score += 20;
-    }
-    // Per-term matching
-    for (const term of terms) {
-        // Name contains term
-        if (nameLower.includes(term)) {
-            score += 10;
-        }
-        // Description contains term
-        if (descLower.includes(term)) {
-            score += 5;
-        }
-        // Tag exact match
-        if (asset.tags.some((t) => t.toLowerCase() === term)) {
-            score += 8;
-        }
-        // Author matches
-        if (authorLower.includes(term)) {
-            score += 3;
-        }
-    }
-    return score;
+    return scoreItem(nameLower, descLower, authorLower, asset.tags, terms, fullQuery);
 }
 /**
  * Score a bundle against search terms.
- * Mirrors scoreAsset() but operates on flat RegistryBundle fields.
+ * Thin wrapper that extracts fields from the bundle and delegates to scoreItem.
  */
 function scoreBundle(bundle, terms, fullQuery) {
-    let score = 0;
     const nameLower = bundle.name.toLowerCase();
     const descLower = bundle.description.toLowerCase();
     const authorLower = bundle.author.toLowerCase();
-    // Exact name match — highest weight
-    if (nameLower === fullQuery) {
-        score += 100;
-    }
-    // Name contains the full query
-    else if (nameLower.includes(fullQuery)) {
-        score += 50;
-    }
-    // Description contains the full query
-    if (descLower.includes(fullQuery)) {
-        score += 20;
-    }
-    // Per-term matching
-    for (const term of terms) {
-        if (nameLower.includes(term)) {
-            score += 10;
-        }
-        if (descLower.includes(term)) {
-            score += 5;
-        }
-        if (bundle.tags.some((t) => t.toLowerCase() === term)) {
-            score += 8;
-        }
-        if (authorLower.includes(term)) {
-            score += 3;
-        }
-    }
-    return score;
+    return scoreItem(nameLower, descLower, authorLower, bundle.tags, terms, fullQuery);
 }
 //# sourceMappingURL=search.js.map

package/build/lib/search.js.map

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

package/build/lib/setup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Regex for valid org identifiers. Must start with a letter, then letters,
+ * digits, or hyphens. Matches the constraint in the manifest schema.
+ */
+export declare const ORG_PATTERN: RegExp;
+export interface SetupCreationOptions {
+    orgLocked: boolean;
+    orgValue: string;
+    projectDir: string;
+    selectedTools: string[];
+}
+export interface SetupCreationResult {
+    actions: SummaryAction[];
+    warnings: string[];
+}
+export interface SummaryAction {
+    detail?: string;
+    label: string;
+}
+/**
+ * Perform the setup creation step: write project config, write/update the
+ * lockfile, and ensure gitignore entries are present for the selected tools.
+ *
+ * This is the extracted business logic from the `useSetupState` creating
+ * effect, made independently testable without React rendering overhead.
+ */
+export declare function performSetupCreation(options: SetupCreationOptions): Promise<SetupCreationResult>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/lib/setup.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,eAAO,MAAM,WAAW,QAA4B,CAAC;AAMrD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiFtG"}

package/build/lib/setup.js

@@ -0,0 +1,98 @@
+import { existsSync } from 'node:fs';
+import { loadAdapter } from './adapter.js';
+import { saveProjectConfig } from './config.js';
+import { ensureGitignoreEntries, ensureGitignorePatterns } from './gitignore.js';
+import { getLockfilePath, readLockfile, writeLockfile } from './lockfile.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Regex for valid org identifiers. Must start with a letter, then letters,
+ * digits, or hyphens. Matches the constraint in the manifest schema.
+ */
+export const ORG_PATTERN = /^[a-zA-Z][a-zA-Z0-9-]*$/;
+// ---------------------------------------------------------------------------
+// Main function
+// ---------------------------------------------------------------------------
+/**
+ * Perform the setup creation step: write project config, write/update the
+ * lockfile, and ensure gitignore entries are present for the selected tools.
+ *
+ * This is the extracted business logic from the `useSetupState` creating
+ * effect, made independently testable without React rendering overhead.
+ */
+export async function performSetupCreation(options) {
+    const { orgLocked, orgValue, projectDir, selectedTools } = options;
+    const actions = [];
+    const warnings = [];
+    const resolvedOrg = orgLocked ? orgValue.trim() : orgValue.trim() || undefined;
+    // Validate org format when non-empty
+    if (resolvedOrg !== undefined && !ORG_PATTERN.test(resolvedOrg)) {
+        throw new Error(`Invalid org "${resolvedOrg}": must start with a letter and contain only letters, digits, or hyphens.`);
+    }
+    // 1. Write .atkrc.json with { tools: [...] }
+    await saveProjectConfig(projectDir, { tools: selectedTools });
+    actions.push({ detail: `tools: ${selectedTools.join(', ')}`, label: 'Wrote .atkrc.json' });
+    // 2. Write/update .atk-lock.json
+    const lockfilePath = getLockfilePath(projectDir);
+    if (existsSync(lockfilePath)) {
+        // Preserve existing assets and org
+        const existing = await readLockfile(projectDir);
+        // Only update org if it's not already set and we have a new one
+        const updatedLockfile = {
+            ...existing,
+            lockVersion: 1,
+            ...(resolvedOrg !== undefined && !existing.org ? { org: resolvedOrg } : {}),
+        };
+        await writeLockfile(projectDir, updatedLockfile);
+        actions.push({
+            detail: `${(existing.assets ?? []).length} existing asset(s) preserved`,
+            label: 'Updated .atk-lock.json',
+        });
+    }
+    else {
+        await writeLockfile(projectDir, {
+            assets: [],
+            lockVersion: 1,
+            ...(resolvedOrg !== undefined ? { org: resolvedOrg } : {}),
+        });
+        actions.push({
+            detail: resolvedOrg ? `org: ${resolvedOrg}` : 'no org',
+            label: 'Created .atk-lock.json',
+        });
+    }
+    // 3. Ensure .atkrc.json is in .gitignore via the adapters' gitignore entries
+    const allAdded = [];
+    let anyAdapterLoaded = false;
+    for (const tool of selectedTools) {
+        try {
+            const adapter = await loadAdapter(tool);
+            anyAdapterLoaded = true;
+            const { added } = await ensureGitignoreEntries(projectDir, adapter);
+            allAdded.push(...added);
+        }
+        catch (err) {
+            // Individual adapter load failure is non-fatal; record warning and continue
+            const message = err instanceof Error ? err.message : String(err);
+            warnings.push(`Failed to load adapter for "${tool}": ${message}`);
+        }
+    }
+    if (!anyAdapterLoaded) {
+        // If no adapters could be loaded, manually ensure critical files are gitignored
+        try {
+            const { added } = await ensureGitignorePatterns(projectDir, ['.atkrc.json', '.atk-lock.json.lock']);
+            allAdded.push(...added);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            warnings.push(`Failed to update .gitignore: ${message}`);
+        }
+    }
+    if (allAdded.length > 0) {
+        // Deduplicate entries
+        const uniqueAdded = [...new Set(allAdded)];
+        actions.push({ detail: uniqueAdded.join(', '), label: 'Updated .gitignore' });
+    }
+    return { actions, warnings };
+}
+//# sourceMappingURL=setup.js.map

package/build/lib/setup.js.map

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

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,217 @@
+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