@detergent-software/atk 0.12.1-dev.2

package/build/lib/lockfile.js

@@ -0,0 +1,437 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { normalizeLockfilePath } from './paths.js';
+import { LockfileSchema } from './schemas/lockfile.js';
+const LOCKFILE_NAME = '.atk-lock.json';
+const LOCK_SENTINEL_NAME = '.atk-lock.json.lock';
+const CURRENT_LOCK_VERSION = 1;
+/** Default timeout (ms) after which a lock is considered stale even if the PID is alive. */
+const DEFAULT_STALE_TIMEOUT_MS = 60_000;
+/** Default interval (ms) between retry attempts when the lock is held. */
+const DEFAULT_RETRY_INTERVAL_MS = 200;
+/** Default maximum time (ms) to wait to acquire the lock before giving up. */
+const DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000;
+export class LockfileError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LockfileError';
+    }
+}
+export class LockfileLockedError extends Error {
+    constructor(pid, sentinelPath) {
+        super(`Lockfile is held by PID ${pid} (sentinel: ${sentinelPath})`);
+        this.name = 'LockfileLockedError';
+    }
+}
+/**
+ * Acquire an advisory lock on the lockfile.
+ *
+ * Creates a sentinel file (`.atk-lock.json.lock`) atomically using the `'wx'`
+ * flag. If the sentinel already exists the function will:
+ *   1. Read the sentinel to get the holding PID and timestamp.
+ *   2. If the holding PID is dead **or** the lock is older than `staleTimeout`,
+ *      remove the stale sentinel and retry immediately.
+ *   3. Otherwise wait `retryInterval` ms and retry, up to `acquireTimeout` ms total.
+ *
+ * @throws {LockfileLockedError} if the lock cannot be acquired within the timeout.
+ */
+export async function acquireLockfileLock(projectDir, options) {
+    const sentinelPath = getLockSentinelPath(projectDir);
+    const acquireTimeout = options?.acquireTimeout ?? DEFAULT_ACQUIRE_TIMEOUT_MS;
+    const retryInterval = options?.retryInterval ?? DEFAULT_RETRY_INTERVAL_MS;
+    const staleTimeout = options?.staleTimeout ?? DEFAULT_STALE_TIMEOUT_MS;
+    const deadline = Date.now() + acquireTimeout;
+    while (true) {
+        try {
+            const data = { pid: process.pid, timestamp: Date.now() };
+            await writeFile(sentinelPath, JSON.stringify(data), { flag: 'wx' });
+            // Sentinel created successfully — lock acquired.
+            return;
+        }
+        catch (err) {
+            if (!isEnoentOrExist(err, 'EEXIST')) {
+                throw err;
+            }
+            // Sentinel already exists — inspect it.
+            let existing;
+            try {
+                const raw = await readFile(sentinelPath, 'utf-8');
+                existing = JSON.parse(raw);
+            }
+            catch {
+                // If we cannot read/parse the sentinel, treat it as stale and
+                // remove it so we can retry on the next iteration.
+                try {
+                    await unlink(sentinelPath);
+                }
+                catch {
+                    // Another process may have already removed it — ignore.
+                }
+                continue;
+            }
+            const isStale = !isProcessAlive(existing.pid) || Date.now() - existing.timestamp > staleTimeout;
+            if (isStale) {
+                try {
+                    await unlink(sentinelPath);
+                }
+                catch {
+                    // Another process may have already removed it — ignore.
+                }
+                continue;
+            }
+            // Lock is held by a live process and is not stale — wait and retry.
+            if (Date.now() >= deadline) {
+                throw new LockfileLockedError(existing.pid, sentinelPath);
+            }
+            await delay(retryInterval);
+            if (Date.now() >= deadline) {
+                throw new LockfileLockedError(existing.pid, sentinelPath);
+            }
+        }
+    }
+}
+/**
+ * Add an installed asset to the lockfile.
+ * If the asset already exists, it is replaced (updated).
+ */
+export function addAssetToLockfile(lockfile, asset) {
+    const filtered = (lockfile.assets ?? []).filter((a) => !(a.name === asset.name && a.type === asset.type));
+    return {
+        ...lockfile,
+        assets: [...filtered, asset],
+    };
+}
+/**
+ * Find all orphaned dependency assets in the lockfile.
+ * An asset is orphaned if it was installed as a dependency but no longer has
+ * a valid reverse dependency chain leading to a direct-install root.
+ */
+export function findAllOrphanedAssets(lockfile) {
+    return (lockfile.assets ?? []).filter((asset) => {
+        if ((asset.installReason ?? 'direct') !== 'dependency')
+            return false;
+        const result = traceDependencyChain(lockfile, asset.name, asset.type);
+        return result.status === 'orphaned';
+    });
+}
+/**
+ * Find installed assets that depend on the given asset.
+ * Returns those whose `dependencies` array includes the given asset name (and optionally type).
+ */
+export function findDependents(lockfile, assetName, assetType) {
+    return (lockfile.assets ?? []).filter((a) => (a.dependencies ?? []).some((d) => d.name === assetName && (!assetType || d.type === assetType)));
+}
+/**
+ * Find an installed asset in the lockfile.
+ */
+export function findInstalledAsset(lockfile, name, type) {
+    return (lockfile.assets ?? []).find((a) => a.name === name && (!type || a.type === type));
+}
+/**
+ * Find dependencies of assetBeingRemoved that would become orphaned after removal.
+ * A dependency is orphaned if:
+ * (a) it has installReason === 'dependency', and
+ * (b) no other remaining installed asset (excluding those in otherNamesBeingRemoved) lists it in dependencies.
+ */
+export function findOrphanedDependencies(lockfile, assetBeingRemoved, otherNamesBeingRemoved = []) {
+    const orphans = [];
+    const beingRemoved = new Set([assetBeingRemoved.name, ...otherNamesBeingRemoved]);
+    for (const dep of assetBeingRemoved.dependencies ?? []) {
+        const depAsset = findInstalledAsset(lockfile, dep.name, dep.type);
+        if (!depAsset)
+            continue;
+        // Only auto-remove dependencies that were installed as dependencies
+        if ((depAsset.installReason ?? 'direct') !== 'dependency')
+            continue;
+        // Check if any other remaining asset still depends on this
+        const otherDependents = (lockfile.assets ?? []).filter((a) => !beingRemoved.has(a.name) && (a.dependencies ?? []).some((d) => d.name === dep.name && d.type === dep.type));
+        if (otherDependents.length === 0) {
+            orphans.push(depAsset);
+        }
+    }
+    return orphans;
+}
+/**
+ * Get all installed assets, optionally filtered by type.
+ */
+export function getInstalledAssets(lockfile, type) {
+    const assets = lockfile.assets ?? [];
+    if (!type) {
+        return assets;
+    }
+    return assets.filter((a) => a.type === type);
+}
+/**
+ * Get the count of installed assets.
+ */
+export function getInstalledCount(lockfile, type) {
+    return getInstalledAssets(lockfile, type).length;
+}
+/**
+ * Get the path to the lockfile in the given project directory.
+ */
+export function getLockfilePath(projectDir) {
+    return join(projectDir, LOCKFILE_NAME);
+}
+/**
+ * Get the path to the lock sentinel file for the given project directory.
+ */
+export function getLockSentinelPath(projectDir) {
+    return join(projectDir, LOCK_SENTINEL_NAME);
+}
+/**
+ * Check if an asset is installed.
+ */
+export function isInstalled(lockfile, name, type) {
+    return findInstalledAsset(lockfile, name, type) !== undefined;
+}
+/**
+ * Check whether an asset has a pinned version in the lockfile.
+ * Returns `true` if the asset exists and has a truthy `pinnedVersion`, `false` otherwise.
+ * This is a read-only query that never throws.
+ */
+export function isPinned(lockfile, name, type) {
+    const asset = findInstalledAsset(lockfile, name, type);
+    return asset !== undefined && !!asset.pinnedVersion;
+}
+/**
+ * Pin an installed asset to a specific version.
+ * Only direct installs can be pinned; pinning a dependency throws an error.
+ *
+ * @throws {LockfileError} if the asset is not found or is not a direct install
+ */
+export function pinAssetVersion(lockfile, name, version, type) {
+    const asset = findInstalledAsset(lockfile, name, type);
+    if (!asset) {
+        throw new LockfileError(`Asset '${name}' is not installed`);
+    }
+    if ((asset.installReason ?? 'direct') === 'dependency') {
+        throw new LockfileError(`Asset '${name}' is a dependency and cannot be pinned — only directly installed assets can be pinned`);
+    }
+    return {
+        ...lockfile,
+        assets: (lockfile.assets ?? []).map((a) => {
+            if (a.name === name && (!type || a.type === type)) {
+                return { ...a, pinnedVersion: version };
+            }
+            return a;
+        }),
+    };
+}
+/**
+ * Read the lockfile from the project directory.
+ * Returns a default empty lockfile if none exists.
+ */
+export async function readLockfile(projectDir, tool) {
+    const lockfilePath = getLockfilePath(projectDir);
+    if (!existsSync(lockfilePath)) {
+        return { assets: [], lockVersion: CURRENT_LOCK_VERSION, tool };
+    }
+    const raw = await readFile(lockfilePath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new LockfileError(`Invalid lockfile at ${lockfilePath}: Invalid JSON`);
+    }
+    const result = LockfileSchema.safeParse(parsed);
+    if (result.success) {
+        const lockfile = result.data;
+        // Defensive normalization: convert any backslash paths (from pre-P0 lockfiles) to forward slashes.
+        // This is a pure in-memory transformation — the lockfile on disk is not modified.
+        for (const asset of lockfile.assets ?? []) {
+            for (const file of asset.files) {
+                file.installedPath = normalizeLockfilePath(file.installedPath);
+            }
+            for (const entry of asset.configEntries ?? []) {
+                entry.file = normalizeLockfilePath(entry.file);
+            }
+        }
+        return lockfile;
+    }
+    throw new LockfileError(`Invalid lockfile at ${lockfilePath}: ${result.error.issues.map((i) => i.message).join(', ')}`);
+}
+/**
+ * Release the advisory lock by removing the sentinel file.
+ * Silently ignores `ENOENT` (the sentinel was already removed).
+ */
+export async function releaseLockfileLock(projectDir) {
+    const sentinelPath = getLockSentinelPath(projectDir);
+    try {
+        await unlink(sentinelPath);
+    }
+    catch (err) {
+        if (!isEnoentOrExist(err, 'ENOENT')) {
+            throw err;
+        }
+    }
+}
+/**
+ * Remove an asset from the lockfile by name and optional type.
+ */
+export function removeAssetFromLockfile(lockfile, name, type) {
+    return {
+        ...lockfile,
+        assets: (lockfile.assets ?? []).filter((a) => !(a.name === name && (!type || a.type === type))),
+    };
+}
+/**
+ * Trace the reverse dependency chain from a given asset upward to all
+ * direct-install roots.
+ *
+ * Returns a discriminated union indicating whether the asset is:
+ * - `direct`: explicitly installed by the user
+ * - `dependency`: pulled in as a dependency, with chain(s) to direct root(s)
+ * - `not_installed`: not found in the lockfile
+ * - `orphaned`: installed as a dependency but no path to a direct root exists
+ */
+export function traceDependencyChain(lockfile, assetName, assetType) {
+    const asset = findInstalledAsset(lockfile, assetName, assetType);
+    if (!asset) {
+        return { name: assetName, status: 'not_installed' };
+    }
+    if ((asset.installReason ?? 'direct') === 'direct') {
+        return { asset, status: 'direct' };
+    }
+    // Walk the reverse dependency graph upward to find direct-install roots
+    const visiting = new Set();
+    const chains = buildReverseChains(lockfile, asset, visiting);
+    if (chains.length === 0) {
+        return { asset, status: 'orphaned' };
+    }
+    return { asset, chains, status: 'dependency' };
+}
+/**
+ * Remove the version pin from an installed asset.
+ *
+ * @throws {LockfileError} if the asset is not found
+ */
+export function unpinAssetVersion(lockfile, name, type) {
+    const asset = findInstalledAsset(lockfile, name, type);
+    if (!asset) {
+        throw new LockfileError(`Asset '${name}' is not installed`);
+    }
+    return {
+        ...lockfile,
+        assets: (lockfile.assets ?? []).map((a) => {
+            if (a.name === name && (!type || a.type === type)) {
+                const { pinnedVersion: _, ...rest } = a;
+                return rest;
+            }
+            return a;
+        }),
+    };
+}
+/**
+ * Upgrade an asset's installReason from 'dependency' to 'direct'.
+ * Used when a user explicitly installs something that was previously auto-installed.
+ */
+export function upgradeToDirectInstall(lockfile, name, type) {
+    return {
+        ...lockfile,
+        assets: (lockfile.assets ?? []).map((a) => {
+            if (a.name === name && (!type || a.type === type)) {
+                return { ...a, installReason: 'direct' };
+            }
+            return a;
+        }),
+    };
+}
+/**
+ * Execute `fn` while holding the advisory lockfile lock.
+ * The lock is always released in a `finally` block, even if `fn` throws.
+ */
+export async function withLockfileLock(projectDir, fn) {
+    await acquireLockfileLock(projectDir);
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseLockfileLock(projectDir);
+    }
+}
+/**
+ * Write the lockfile to the project directory.
+ */
+export async function writeLockfile(projectDir, lockfile) {
+    const lockfilePath = getLockfilePath(projectDir);
+    const dir = dirname(lockfilePath);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    await writeFile(lockfilePath, JSON.stringify(lockfile, null, '\t') + '\n', 'utf-8');
+}
+/**
+ * Recursively build reverse dependency chain nodes by finding all dependents
+ * of the given asset and walking upward until reaching direct-install roots.
+ *
+ * Uses a `visiting` set with `type:name` composite keys for cycle protection,
+ * mirroring the pattern in resolver.ts.
+ */
+function buildReverseChains(lockfile, asset, visiting) {
+    const key = `${asset.type}:${asset.name}`;
+    // Cycle protection: if we're already visiting this asset, stop recursion
+    if (visiting.has(key)) {
+        return [];
+    }
+    visiting.add(key);
+    const dependents = findDependents(lockfile, asset.name, asset.type);
+    const nodes = [];
+    for (const dependent of dependents) {
+        const reason = (dependent.installReason ?? 'direct');
+        if (reason === 'direct') {
+            // Reached a direct-install root — this is a leaf in our chain
+            nodes.push({
+                children: [],
+                installReason: 'direct',
+                name: dependent.name,
+                type: dependent.type,
+                version: dependent.version,
+            });
+        }
+        else {
+            // Continue walking upward through this dependency
+            const children = buildReverseChains(lockfile, dependent, visiting);
+            // Only include this node if it leads to at least one direct root
+            if (children.length > 0) {
+                nodes.push({
+                    children,
+                    installReason: 'dependency',
+                    name: dependent.name,
+                    type: dependent.type,
+                    version: dependent.version,
+                });
+            }
+        }
+    }
+    visiting.delete(key);
+    return nodes;
+}
+/**
+ * Type-guard that checks whether an unknown `err` is a Node.js filesystem
+ * error with the specified `code` (`'EEXIST'` or `'ENOENT'`).
+ */
+function isEnoentOrExist(err, code) {
+    return err instanceof Error && err.code === code;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a process with the given PID is still running.
+ * Uses `process.kill(pid, 0)` which sends no signal but throws if the
+ * process does not exist.
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=lockfile.js.map

package/build/lib/lockfile.js.map

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

package/build/lib/markdown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert markdown text to chalk-styled terminal output.
+ *
+ * Performs line-by-line transformations for common markdown constructs:
+ * headings, fenced code blocks, unordered lists, inline bold, and inline code.
+ * Lines that don't match any pattern pass through unchanged.
+ */
+export declare function renderMarkdown(text: string): string;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsDnD"}

package/build/lib/markdown.js

@@ -0,0 +1,67 @@
+import chalk from 'chalk';
+/**
+ * Convert markdown text to chalk-styled terminal output.
+ *
+ * Performs line-by-line transformations for common markdown constructs:
+ * headings, fenced code blocks, unordered lists, inline bold, and inline code.
+ * Lines that don't match any pattern pass through unchanged.
+ */
+export function renderMarkdown(text) {
+    const lines = text.split('\n');
+    const result = [];
+    let inCodeBlock = false;
+    for (const line of lines) {
+        // Toggle fenced code block state on ``` delimiters
+        if (line.trimStart().startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            // Render the delimiter itself as dim
+            result.push(chalk.dim(line));
+            continue;
+        }
+        // Lines inside a fenced code block are rendered dim
+        if (inCodeBlock) {
+            result.push(chalk.dim(line));
+            continue;
+        }
+        // H3 headings (### ...)
+        const h3Match = /^###\s+(.*)$/.exec(line);
+        if (h3Match) {
+            result.push(chalk.bold(h3Match[1]));
+            continue;
+        }
+        // H2 headings (## ...)
+        const h2Match = /^##\s+(.*)$/.exec(line);
+        if (h2Match) {
+            result.push(chalk.bold(h2Match[1]));
+            continue;
+        }
+        // H1 headings (# ...)
+        const h1Match = /^#\s+(.*)$/.exec(line);
+        if (h1Match) {
+            result.push(chalk.bold(h1Match[1]));
+            continue;
+        }
+        // Unordered list items (- ... or * ...)
+        const listMatch = /^(\s*)[-*]\s+(.*)$/.exec(line);
+        if (listMatch) {
+            const formatted = applyInlineFormatting(listMatch[2]);
+            result.push(`${listMatch[1]}\u2022 ${formatted}`);
+            continue;
+        }
+        // All other lines — apply inline formatting only
+        result.push(applyInlineFormatting(line));
+    }
+    return result.join('\n');
+}
+/**
+ * Apply inline markdown formatting (bold and inline code) to a single line.
+ */
+function applyInlineFormatting(line) {
+    let formatted = line;
+    // Inline bold: **text**
+    formatted = formatted.replace(/\*\*([^*]+)\*\*/g, (_match, content) => chalk.bold(content));
+    // Inline code: `text` (but not fenced code block delimiters)
+    formatted = formatted.replace(/`([^`]+)`/g, (_match, content) => chalk.dim(content));
+    return formatted;
+}
+//# sourceMappingURL=markdown.js.map

package/build/lib/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mDAAmD;QACnD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,qCAAqC;YACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,oDAAoD;QACpD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,wBAAwB;QACxB,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,sBAAsB;QACtB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,wCAAwC;QACxC,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QAED,iDAAiD;QACjD,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,wBAAwB;IACxB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpG,6DAA6D;IAC7D,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAE7F,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/build/lib/parse-json.d.ts

@@ -0,0 +1,34 @@
+import type { z } from 'zod';
+/**
+ * Result type for the non-throwing `safeParseJson` variant.
+ */
+export type SafeParseJsonResult<T> = {
+    data: T;
+    success: true;
+} | {
+    error: string;
+    success: false;
+};
+/**
+ * Parse a raw JSON string and validate against a Zod schema.
+ * Throws with a formatted error message on failure.
+ *
+ * @param raw - The raw JSON string to parse
+ * @param schema - The Zod schema to validate against
+ * @param context - A descriptive context string included in error messages (e.g. "Invalid config at /path")
+ * @returns The validated and typed data
+ * @throws Error with formatted message including context, JSON parse errors, or Zod validation issues
+ */
+export declare function parseAndValidate<T>(raw: string, schema: z.ZodType<T>, context: string): T;
+/**
+ * Parse a raw JSON string and validate against a Zod schema.
+ * Returns a result object instead of throwing, for use in contexts
+ * where failure is non-fatal (e.g. cache reads, diagnostic loading).
+ *
+ * @param raw - The raw JSON string to parse
+ * @param schema - The Zod schema to validate against
+ * @param context - A descriptive context string included in the error message
+ * @returns An object with `success: true` and `data`, or `success: false` and `error`
+ */
+export declare function safeParseJson<T>(raw: string, schema: z.ZodType<T>, context: string): SafeParseJsonResult<T>;
+//# sourceMappingURL=parse-json.d.ts.map

package/build/lib/parse-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["../../src/lib/parse-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpG;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAczF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAiB3G"}

package/build/lib/parse-json.js

@@ -0,0 +1,52 @@
+/**
+ * Parse a raw JSON string and validate against a Zod schema.
+ * Throws with a formatted error message on failure.
+ *
+ * @param raw - The raw JSON string to parse
+ * @param schema - The Zod schema to validate against
+ * @param context - A descriptive context string included in error messages (e.g. "Invalid config at /path")
+ * @returns The validated and typed data
+ * @throws Error with formatted message including context, JSON parse errors, or Zod validation issues
+ */
+export function parseAndValidate(raw, schema, context) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${context}: Invalid JSON`);
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`${context}: ${result.error.issues.map((i) => i.message).join(', ')}`);
+    }
+    return result.data;
+}
+/**
+ * Parse a raw JSON string and validate against a Zod schema.
+ * Returns a result object instead of throwing, for use in contexts
+ * where failure is non-fatal (e.g. cache reads, diagnostic loading).
+ *
+ * @param raw - The raw JSON string to parse
+ * @param schema - The Zod schema to validate against
+ * @param context - A descriptive context string included in the error message
+ * @returns An object with `success: true` and `data`, or `success: false` and `error`
+ */
+export function safeParseJson(raw, schema, context) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { error: `${context}: Invalid JSON`, success: false };
+    }
+    const result = schema.safeParse(parsed);
+    if (!result.success) {
+        return {
+            error: `${context}: ${result.error.issues.map((i) => i.message).join(', ')}`,
+            success: false,
+        };
+    }
+    return { data: result.data, success: true };
+}
+//# sourceMappingURL=parse-json.js.map

package/build/lib/parse-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.js","sourceRoot":"","sources":["../../src/lib/parse-json.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAI,GAAW,EAAE,MAAoB,EAAE,OAAe;IACpF,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAI,GAAW,EAAE,MAAoB,EAAE,OAAe;IACjF,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC5E,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/build/lib/paths.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Replace all backslashes with forward slashes in a path string.
+ * Used to normalize Windows-style paths for consistent lockfile storage.
+ */
+export declare function normalizeLockfilePath(p: string): string;
+/**
+ * Convert an absolute path to a project-relative path with forward slashes.
+ * Used to store portable paths in the lockfile.
+ */
+export declare function toRelativePosix(projectDir: string, absolutePath: string): string;
+/**
+ * Walk up from `startDir` looking for project root markers.
+ *
+ * Discovery priority:
+ *   1. `.atk-lock.json` file
+ *   2. `.claude/` directory
+ *   3. `.git/` directory
+ *   4. Fallback to the resolved `startDir`
+ *
+ * Results are cached per starting directory for the lifetime of the process.
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * Clear the project-root cache. Intended for use in tests so each test
+ * can control the filesystem layout without stale cached values.
+ */
+export declare function resetProjectRootCache(): void;
+//# sourceMappingURL=paths.d.ts.map