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

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;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;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,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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@detergent-software/atk",
-	"version": "3.0.0-dev.20",
+	"version": "3.0.0-dev.21",
 	"description": "Agentic Tool Kit — CLI for managing AI coding tool assets.",
 	"type": "module",
 	"bin": {