agentln 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 abaktiar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# agentln
+
+Cross-platform CLI that keeps `CLAUDE.md` and `AGENTS.md` in sync across an
+entire repository by managing **relative symlinks** between them.
+
+You make **one decision at the repository root** — which filename is the source
+of truth — and `agentln` applies that decision recursively to every directory
+in the repo.
+
+- Works on macOS, Linux, and Windows (PowerShell, Git Bash, WSL).
+- Uses Node's native `fs` symlink APIs. Never shells out to `ln`, `bash`, or
+  PowerShell.
+- Designed for monorepos: Nx, Turborepo, pnpm workspaces, and nested apps.
+
+## Install / Run
+
+```bash
+# One-shot
+npx agentln
+pnpm dlx agentln
+
+# Or install globally
+npm i -g agentln
+agentln
+```
+
+Requires Node.js 18+.
+
+## What it does
+
+At the repository root, `agentln` looks for `CLAUDE.md` and `AGENTS.md` and
+asks you a single question based on what it finds:
+
+| Root state                  | Question                                                                       |
+| --------------------------- | ------------------------------------------------------------------------------ |
+| Only `CLAUDE.md`            | Use `CLAUDE.md` as the source of truth across the repository?                  |
+| Only `AGENTS.md`            | Use `AGENTS.md` as the source of truth across the repository?                  |
+| Both exist                  | Which one should be the source of truth? `CLAUDE.md` / `AGENTS.md` / Cancel.   |
+| Neither exists              | Which file should become the repository standard? `CLAUDE.md` / `AGENTS.md`.   |
+
+Once you pick a source of truth (call it `SRC`), every directory in the repo
+that contains either file is reconciled to the same convention:
+
+| Directory contents     | Result                                                                |
+| ---------------------- | --------------------------------------------------------------------- |
+| `SRC` only             | Create `OTHER` as a symlink → `SRC`.                                  |
+| `OTHER` only           | Rename `OTHER` → `SRC` (preserve content), then link `OTHER` → `SRC`. |
+| Both exist             | Preserve `SRC`. Replace `OTHER` with a symlink → `SRC`.               |
+| Neither                | Do nothing.                                                           |
+
+`agentln` is idempotent. Running it twice in a row will say "already in sync."
+
+### Symlink format
+
+Symlinks are always **relative** (`AGENTS.md → CLAUDE.md`), never absolute.
+This keeps the repo portable across machines and clones.
+
+### Ignored directories
+
+The scanner skips common build / vendor folders by default:
+
+`node_modules`, `.git`, `dist`, `build`, `.next`, `coverage`, `vendor`,
+`.turbo`, `.cache`, `.parcel-cache`, `.svelte-kit`, `.nuxt`, `.output`,
+`.vercel`, `.idea`, `.vscode`, and any other dotfile-prefixed directory.
+
+## CLI flags
+
+```text
+agentln [options]
+
+--root <path>        Repository root (default: current working directory).
+--source <name>      Use CLAUDE.md or AGENTS.md as source of truth (skips prompt).
+-y, --yes            Non-interactive mode. Accepts defaults for every prompt.
+--dry-run            Show planned changes without writing anything.
+--force              Overwrite divergent regular files when replacing with a symlink.
+--copy-fallback      On Windows, copy the file instead of failing when symlink
+                     creation is denied.
+--no-copy-fallback   Disable the copy fallback (default).
+--verbose            Print debug-level information.
+-h, --help           Show help.
+-v, --version        Show version.
+```
+
+### Examples
+
+```bash
+# Preview what would happen
+npx agentln --dry-run
+
+# Non-interactive, default to CLAUDE.md when both exist
+npx agentln --yes --source CLAUDE.md
+
+# Target a different repo
+npx agentln --root ~/code/my-monorepo
+
+# Replace existing AGENTS.md regular files (not just symlinks)
+npx agentln --force
+```
+
+## Windows notes
+
+Creating symbolic links on Windows requires either:
+
+- **Developer Mode** enabled (Settings → Privacy & security → For developers), or
+- an elevated shell, or
+- the `SeCreateSymbolicLinkPrivilege` granted to your user.
+
+If `agentln` cannot create a symlink, you have two options:
+
+1. Re-run after enabling one of the above (recommended — symlinks keep both
+   filenames in sync automatically).
+2. Pass `--copy-fallback` to write a regular file copy instead. The two files
+   will then diverge on subsequent edits until you reconcile them.
+
+The fallback is **off by default** so you never silently lose the "single
+source of truth" guarantee.
+
+## Use cases
+
+- Tools like Claude Code expect `CLAUDE.md`; other tools expect `AGENTS.md`.
+  Symlink them so both worlds read the same file.
+- Monorepos with multiple workspaces, each having their own per-package
+  instructions: `agentln` reconciles every workspace in one pass.
+
+## Publishing
+
+```bash
+npm run build
+npm publish --access public
+```
+
+The `prepublishOnly` script rebuilds `dist/` and ships only `dist/` plus the
+README and license.
+
+## License
+
+MIT

package/dist/args.d.ts

@@ -0,0 +1,4 @@
+import { type CliOptions } from "./types.js";
+export declare function parseArgs(argv: string[]): CliOptions;
+export declare function helpText(): string;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAqBpB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoEpD;AAsBD,wBAAgB,QAAQ,IAAI,MAAM,CAEjC"}

package/dist/args.js

@@ -0,0 +1,110 @@
+import path from "node:path";
+import { AGENTS_FILE, CLAUDE_FILE, } from "./types.js";
+const HELP_TEXT = `agentln — manage CLAUDE.md ⇄ AGENTS.md symlinks across a repo
+
+Usage:
+  npx agentln [options]
+  pnpm dlx agentln [options]
+
+Options:
+  --root <path>        Repository root (default: current working directory).
+  --source <name>      Use CLAUDE.md or AGENTS.md as source of truth (skips prompt).
+  -y, --yes            Non-interactive mode (assume defaults for every prompt).
+  --dry-run            Show planned changes without writing anything.
+  --force              Overwrite divergent regular files when replacing with a symlink.
+  --copy-fallback      On Windows, fall back to a file copy if symlink creation is denied.
+  --no-copy-fallback   Disable the copy fallback (default).
+  --verbose            Print debug-level information.
+  -h, --help           Show this help.
+  -v, --version        Show version.
+`;
+export function parseArgs(argv) {
+    const opts = {
+        root: process.cwd(),
+        yes: false,
+        dryRun: false,
+        force: false,
+        verbose: false,
+        help: false,
+        version: false,
+        copyFallback: false,
+        noCopyFallback: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case "-h":
+            case "--help":
+                opts.help = true;
+                break;
+            case "-v":
+            case "--version":
+                opts.version = true;
+                break;
+            case "-y":
+            case "--yes":
+                opts.yes = true;
+                break;
+            case "--dry-run":
+                opts.dryRun = true;
+                break;
+            case "--force":
+                opts.force = true;
+                break;
+            case "--verbose":
+                opts.verbose = true;
+                break;
+            case "--copy-fallback":
+                opts.copyFallback = true;
+                break;
+            case "--no-copy-fallback":
+                opts.noCopyFallback = true;
+                opts.copyFallback = false;
+                break;
+            case "--root": {
+                const next = argv[++i];
+                if (!next)
+                    throw new Error("--root requires a path argument");
+                opts.root = path.resolve(next);
+                break;
+            }
+            case "--source": {
+                const next = argv[++i];
+                opts.source = parseSource(next);
+                break;
+            }
+            default: {
+                if (arg.startsWith("--root=")) {
+                    opts.root = path.resolve(arg.slice("--root=".length));
+                }
+                else if (arg.startsWith("--source=")) {
+                    opts.source = parseSource(arg.slice("--source=".length));
+                }
+                else {
+                    throw new Error(`Unknown argument: ${arg}`);
+                }
+            }
+        }
+    }
+    return opts;
+}
+function parseSource(value) {
+    if (!value)
+        throw new Error("--source requires a value (CLAUDE.md or AGENTS.md)");
+    const normalised = value.trim();
+    if (normalised === CLAUDE_FILE ||
+        normalised.toLowerCase() === "claude" ||
+        normalised.toLowerCase() === "claude.md") {
+        return CLAUDE_FILE;
+    }
+    if (normalised === AGENTS_FILE ||
+        normalised.toLowerCase() === "agents" ||
+        normalised.toLowerCase() === "agents.md") {
+        return AGENTS_FILE;
+    }
+    throw new Error(`Invalid --source value: ${value}. Expected CLAUDE.md or AGENTS.md.`);
+}
+export function helpText() {
+    return HELP_TEXT;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { run } from "./cli.js";
+run().then((code) => process.exit(code), (err) => {
+    process.stderr.write(`agentln: unexpected error: ${err.stack ?? String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,GAAG,EAAE,CAAC,IAAI,CACR,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAG,EAAE,EAAE;IACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA+B,GAAa,CAAC,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function run(argv?: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA0BA,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAuIjF"}

package/dist/cli.js

@@ -0,0 +1,130 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+import { helpText, parseArgs } from "./args.js";
+import { executeAction, isWindowsHost, platformLabel } from "./executor.js";
+import { createLogger } from "./logger.js";
+import { buildPlan, describeAction } from "./planner.js";
+import { classifyRoot, decideRoot } from "./prompts.js";
+import { describeEntry, scanRepository } from "./scanner.js";
+async function readPackageVersion() {
+    try {
+        const here = fileURLToPath(new URL(".", import.meta.url));
+        const pkgPath = path.join(here, "..", "package.json");
+        const raw = await fs.readFile(pkgPath, "utf8");
+        const pkg = JSON.parse(raw);
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+export async function run(argv = process.argv.slice(2)) {
+    let options;
+    try {
+        options = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`${pc.red("✗")} ${err.message}\n`);
+        process.stderr.write(helpText());
+        return 2;
+    }
+    if (options.help) {
+        process.stdout.write(helpText());
+        return 0;
+    }
+    if (options.version) {
+        process.stdout.write(`${await readPackageVersion()}\n`);
+        return 0;
+    }
+    const logger = createLogger(options.verbose);
+    const root = path.resolve(options.root);
+    logger.step("agentln", `${root}`);
+    logger.debug(`Platform: ${platformLabel()}`);
+    // Verify the root directory exists before doing anything else.
+    try {
+        const stat = await fs.stat(root);
+        if (!stat.isDirectory()) {
+            logger.error(`${root} is not a directory.`);
+            return 1;
+        }
+    }
+    catch {
+        logger.error(`Cannot read ${root}. Does the path exist?`);
+        return 1;
+    }
+    // First pass: just read the root state so we can ask the right question.
+    // We do this with an arbitrary source (CLAUDE) — the answer doesn't depend
+    // on which file the user later picks, only on which files are present.
+    const initialScan = await scanRepository(root, "CLAUDE.md");
+    const rootState = initialScan.find((d) => d.dir === root);
+    if (!rootState) {
+        logger.error(`Failed to scan repository root at ${root}.`);
+        return 1;
+    }
+    logger.debug(`Root CLAUDE.md: ${describeEntry(rootState.claude)}`);
+    logger.debug(`Root AGENTS.md: ${describeEntry(rootState.agents)}`);
+    const rootCase = classifyRoot(rootState);
+    logger.debug(`Root case: ${rootCase}`);
+    const decision = await decideRoot(rootState, {
+        yes: options.yes,
+        sourceFlag: options.source,
+    });
+    logger.info(`Source of truth: ${pc.bold(decision.source)}${decision.bootstrapRoot ? pc.dim(" (will be created at root)") : ""}`);
+    // Re-scan now that we know the actual source, so entry classification can
+    // judge whether existing symlinks point at the right sibling.
+    const dirs = await scanRepository(root, decision.source);
+    logger.debug(`Scanned ${dirs.length} relevant director${dirs.length === 1 ? "y" : "ies"}.`);
+    const plan = buildPlan({
+        root,
+        source: decision.source,
+        dirs,
+        bootstrapRoot: decision.bootstrapRoot,
+        force: options.force,
+    });
+    if (plan.actions.length === 0) {
+        logger.success(`Nothing to do. ${plan.cleanCount} director${plan.cleanCount === 1 ? "y is" : "ies are"} already in sync.`);
+        return 0;
+    }
+    logger.step(options.dryRun ? "Planned changes (dry run)" : "Planned changes", `${plan.actions.length} action${plan.actions.length === 1 ? "" : "s"}`);
+    for (const action of plan.actions) {
+        logger.raw(`  ${pc.dim("•")} ${describeAction(action)}`);
+    }
+    if (options.dryRun) {
+        logger.info("Dry run complete. No changes were written.");
+        return 0;
+    }
+    if (isWindowsHost() && !options.copyFallback) {
+        logger.debug("Tip: pass --copy-fallback to write a regular file copy if symlink creation is denied on Windows.");
+    }
+    let failures = 0;
+    let copyFallbacks = 0;
+    for (const action of plan.actions) {
+        const result = await executeAction(action, {
+            dryRun: false,
+            force: options.force,
+            copyFallback: options.copyFallback,
+        });
+        if (result.fellBackToCopy)
+            copyFallbacks++;
+        if (!result.ok) {
+            failures++;
+            logger.error(`${describeAction(action)} — ${result.message}`);
+        }
+        else {
+            logger.success(`${describeAction(action)} — ${result.message}`);
+        }
+    }
+    if (copyFallbacks > 0) {
+        logger.warn(`${copyFallbacks} file${copyFallbacks === 1 ? "" : "s"} written as a copy instead of a symlink. ` +
+            "Edits to one file will not propagate to the other until real symlinks are restored.");
+    }
+    if (failures > 0) {
+        logger.error(`${failures} action${failures === 1 ? "" : "s"} failed.`);
+        return 1;
+    }
+    logger.success(`Done. ${plan.actions.length} action${plan.actions.length === 1 ? "" : "s"} applied.`);
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,11 @@
+import type { ActionResult, PlannedAction } from "./types.js";
+export interface ExecuteOptions {
+    dryRun: boolean;
+    force: boolean;
+    /** If true, fall back to copying the file when symlink creation fails. */
+    copyFallback: boolean;
+}
+export declare function executeAction(action: PlannedAction, options: ExecuteOptions): Promise<ActionResult>;
+export declare function isWindowsHost(): boolean;
+export declare function platformLabel(): string;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,OAAO,CAAC;CACvB;AAgCD,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAsHvB;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/executor.js

@@ -0,0 +1,163 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const IS_WINDOWS = process.platform === "win32";
+/**
+ * On Windows, `fs.symlink` needs an explicit type hint. We always use `file`
+ * for our use case (linking a single file). On POSIX systems the type arg is
+ * ignored.
+ */
+async function createRelativeSymlink(linkPath, sourcePath) {
+    const target = path.relative(path.dirname(linkPath), sourcePath);
+    await fs.symlink(target, linkPath, IS_WINDOWS ? "file" : undefined);
+}
+async function safeUnlink(p) {
+    try {
+        await fs.unlink(p);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== "ENOENT")
+            throw err;
+    }
+}
+async function copyFile(sourcePath, destPath) {
+    await fs.copyFile(sourcePath, destPath);
+}
+function isSymlinkPermissionError(err) {
+    const code = err?.code;
+    return code === "EPERM" || code === "EACCES" || code === "ENOSYS";
+}
+export async function executeAction(action, options) {
+    switch (action.type) {
+        case "skip":
+            return { action, ok: true, message: `skipped (${action.reason})` };
+        case "create-root-source": {
+            if (options.dryRun) {
+                return { action, ok: true, message: "would create empty source file" };
+            }
+            try {
+                const handle = await fs.open(action.sourcePath, "wx");
+                await handle.close();
+                return { action, ok: true, message: "created empty source file" };
+            }
+            catch (err) {
+                const code = err.code;
+                if (code === "EEXIST") {
+                    return { action, ok: true, message: "source file already exists" };
+                }
+                return { action, ok: false, message: errorMessage(err) };
+            }
+        }
+        case "create-symlink": {
+            if (options.dryRun) {
+                const verb = action.replacesExisting ? "replace" : "create";
+                return { action, ok: true, message: `would ${verb} symlink` };
+            }
+            try {
+                if (action.replacesExisting)
+                    await safeUnlink(action.linkPath);
+                await createRelativeSymlink(action.linkPath, action.sourcePath);
+                return { action, ok: true, message: "symlink created" };
+            }
+            catch (err) {
+                if (IS_WINDOWS && isSymlinkPermissionError(err) && options.copyFallback) {
+                    try {
+                        await safeUnlink(action.linkPath);
+                        await copyFile(action.sourcePath, action.linkPath);
+                        return {
+                            action,
+                            ok: true,
+                            message: "symlink not permitted on this system; wrote a file copy instead. " +
+                                "Re-run after enabling Developer Mode or with admin privileges " +
+                                "to use real symlinks.",
+                            fellBackToCopy: true,
+                        };
+                    }
+                    catch (copyErr) {
+                        return { action, ok: false, message: errorMessage(copyErr) };
+                    }
+                }
+                if (IS_WINDOWS && isSymlinkPermissionError(err)) {
+                    return {
+                        action,
+                        ok: false,
+                        message: "creating a symlink was denied by the OS. On Windows, enable " +
+                            "Developer Mode or run an elevated shell, or re-run with " +
+                            "--copy-fallback to write a regular file copy instead.",
+                    };
+                }
+                return { action, ok: false, message: errorMessage(err) };
+            }
+        }
+        case "promote-to-source": {
+            if (options.dryRun) {
+                return {
+                    action,
+                    ok: true,
+                    message: `would rename ${path.basename(action.fromPath)} → ${path.basename(action.toPath)} and link back`,
+                };
+            }
+            try {
+                // If the target source path already exists (race or stale state) and
+                // we'd otherwise overwrite, bail out unless --force was requested.
+                let targetExists = false;
+                try {
+                    await fs.lstat(action.toPath);
+                    targetExists = true;
+                }
+                catch {
+                    targetExists = false;
+                }
+                if (targetExists && !options.force) {
+                    return {
+                        action,
+                        ok: false,
+                        message: `${action.toPath} already exists; refusing to overwrite without --force.`,
+                    };
+                }
+                if (targetExists)
+                    await safeUnlink(action.toPath);
+                await fs.rename(action.fromPath, action.toPath);
+                await createRelativeSymlink(action.fromPath, action.toPath);
+                return {
+                    action,
+                    ok: true,
+                    message: "promoted file to source and linked back",
+                };
+            }
+            catch (err) {
+                if (IS_WINDOWS && isSymlinkPermissionError(err) && options.copyFallback) {
+                    try {
+                        await copyFile(action.toPath, action.fromPath);
+                        return {
+                            action,
+                            ok: true,
+                            message: "symlink not permitted; wrote a file copy as fallback. The " +
+                                "two files will diverge on subsequent edits.",
+                            fellBackToCopy: true,
+                        };
+                    }
+                    catch (copyErr) {
+                        return { action, ok: false, message: errorMessage(copyErr) };
+                    }
+                }
+                return { action, ok: false, message: errorMessage(err) };
+            }
+        }
+    }
+}
+export function isWindowsHost() {
+    return IS_WINDOWS;
+}
+export function platformLabel() {
+    return `${process.platform} (${os.release()})`;
+}
+function errorMessage(err) {
+    if (err instanceof Error) {
+        const code = err.code;
+        return code ? `${code}: ${err.message}` : err.message;
+    }
+    return String(err);
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+export interface Logger {
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+    raw(msg: string): void;
+    step(label: string, detail?: string): void;
+}
+export declare function createLogger(verbose: boolean): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAyBrD"}