agentln 0.1.0

package/dist/logger.js

@@ -0,0 +1,29 @@
+import pc from "picocolors";
+export function createLogger(verbose) {
+    return {
+        info(msg) {
+            process.stdout.write(`${pc.cyan("›")} ${msg}\n`);
+        },
+        success(msg) {
+            process.stdout.write(`${pc.green("✓")} ${msg}\n`);
+        },
+        warn(msg) {
+            process.stderr.write(`${pc.yellow("!")} ${msg}\n`);
+        },
+        error(msg) {
+            process.stderr.write(`${pc.red("✗")} ${msg}\n`);
+        },
+        debug(msg) {
+            if (verbose)
+                process.stdout.write(`${pc.dim("·")} ${pc.dim(msg)}\n`);
+        },
+        raw(msg) {
+            process.stdout.write(`${msg}\n`);
+        },
+        step(label, detail) {
+            const head = pc.magenta(label);
+            process.stdout.write(detail ? `${head} ${pc.dim(detail)}\n` : `${head}\n`);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAY5B,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;QACL,IAAI,CAAC,GAAG;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,GAAG;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,GAAG;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,GAAG;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,GAAG;YACP,IAAI,OAAO;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,GAAG,CAAC,GAAG;YACL,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,MAAM;YAChB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAC7E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/planner.d.ts

@@ -0,0 +1,22 @@
+import { type DirState, type PlannedAction, type SourceName } from "./types.js";
+export interface PlanInput {
+    root: string;
+    source: SourceName;
+    dirs: DirState[];
+    /**
+     * True for Case D (neither existed at root). Triggers creation of an empty
+     * root source file before linking.
+     */
+    bootstrapRoot: boolean;
+    force: boolean;
+}
+export interface Plan {
+    actions: PlannedAction[];
+    /** Directories that needed no changes (everything already correct). */
+    cleanCount: number;
+    /** Directories skipped because there's nothing to link in either direction. */
+    emptyCount: number;
+}
+export declare function buildPlan(input: PlanInput): Plan;
+export declare function describeAction(action: PlannedAction): string;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CA2EhD;AAuDD,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAoB5D"}

package/dist/planner.js

@@ -0,0 +1,136 @@
+import path from "node:path";
+import { AGENTS_FILE, CLAUDE_FILE, } from "./types.js";
+function linkName(source) {
+    return source === CLAUDE_FILE ? AGENTS_FILE : CLAUDE_FILE;
+}
+function entryFor(dir, name) {
+    return name === CLAUDE_FILE ? dir.claude : dir.agents;
+}
+export function buildPlan(input) {
+    const { root, source, dirs, bootstrapRoot, force } = input;
+    const actions = [];
+    let cleanCount = 0;
+    let emptyCount = 0;
+    const otherName = linkName(source);
+    if (bootstrapRoot) {
+        actions.push({
+            type: "create-root-source",
+            sourcePath: path.join(root, source),
+        });
+    }
+    for (const dir of dirs) {
+        const isRootDir = dir.dir === root;
+        const sourceEntry = entryFor(dir, source);
+        const linkEntry = entryFor(dir, otherName);
+        const sourcePresent = sourceEntry.kind === "regular-file" ||
+            (sourceEntry.kind === "correct-symlink" && !isRootDir) ||
+            // After bootstrap the root source will exist on disk by the time we run.
+            (isRootDir && bootstrapRoot);
+        const linkPresent = linkEntry.kind !== "missing";
+        // Nothing in this directory to manage.
+        if (!sourcePresent && !linkPresent) {
+            emptyCount++;
+            continue;
+        }
+        // Source exists (or will after bootstrap). Just ensure the link mirrors it.
+        if (sourcePresent) {
+            const desired = ensureLink({
+                sourceName: source,
+                linkName: otherName,
+                linkEntry,
+                dir: dir.dir,
+                force,
+            });
+            if (desired === "ok") {
+                cleanCount++;
+            }
+            else {
+                actions.push(desired);
+            }
+            continue;
+        }
+        // No source file in this directory but the link file exists as a regular
+        // file (or stale/broken symlink). Promote it to source, then link back.
+        if (linkEntry.kind === "regular-file" ||
+            linkEntry.kind === "incorrect-symlink" ||
+            linkEntry.kind === "broken-symlink") {
+            const sourcePath = path.join(dir.dir, source);
+            actions.push({
+                type: "promote-to-source",
+                fromPath: linkEntry.path,
+                toPath: sourcePath,
+                linkBack: true,
+            });
+        }
+        else {
+            actions.push({
+                type: "skip",
+                path: linkEntry.path,
+                reason: `unexpected entry kind: ${linkEntry.kind}`,
+            });
+        }
+    }
+    return { actions, cleanCount, emptyCount };
+}
+function ensureLink(args) {
+    const { sourceName, linkEntry, dir, force } = args;
+    const sourcePath = path.join(dir, sourceName);
+    const linkPath = linkEntry.path;
+    if (linkEntry.kind === "correct-symlink")
+        return "ok";
+    if (linkEntry.kind === "missing") {
+        return {
+            type: "create-symlink",
+            linkPath,
+            sourcePath,
+            replacesExisting: false,
+            replacesRegularFile: false,
+        };
+    }
+    if (linkEntry.kind === "incorrect-symlink" ||
+        linkEntry.kind === "broken-symlink") {
+        return {
+            type: "create-symlink",
+            linkPath,
+            sourcePath,
+            replacesExisting: true,
+            replacesRegularFile: false,
+        };
+    }
+    if (linkEntry.kind === "regular-file") {
+        return {
+            type: "create-symlink",
+            linkPath,
+            sourcePath,
+            replacesExisting: true,
+            replacesRegularFile: !force,
+        };
+    }
+    return {
+        type: "skip",
+        path: linkPath,
+        reason: `unexpected entry kind: ${linkEntry.kind}`,
+    };
+}
+export function describeAction(action) {
+    switch (action.type) {
+        case "create-root-source":
+            return `create empty source file → ${action.sourcePath}`;
+        case "create-symlink": {
+            const rel = path.relative(path.dirname(action.linkPath), action.sourcePath);
+            const verb = action.replacesExisting
+                ? action.replacesRegularFile
+                    ? "replace regular file"
+                    : "replace stale symlink"
+                : "create symlink";
+            return `${verb} ${action.linkPath} → ${rel}`;
+        }
+        case "promote-to-source": {
+            const rel = path.relative(path.dirname(action.fromPath), action.toPath);
+            return `rename ${action.fromPath} → ${action.toPath}, then link ${path.basename(action.fromPath)} → ${rel}`;
+        }
+        case "skip":
+            return `skip ${action.path} (${action.reason})`;
+    }
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,13 @@
+import { type DirState, type SourceName } from "./types.js";
+export type RootCase = "only-claude" | "only-agents" | "both" | "neither";
+export interface RootDecision {
+    source: SourceName;
+    bootstrapRoot: boolean;
+}
+export declare function classifyRoot(root: DirState): RootCase;
+export declare function decideRoot(rootState: DirState, options: {
+    yes: boolean;
+    sourceFlag?: SourceName;
+}): Promise<RootDecision>;
+export declare function confirmPlan(message: string): Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAOrD;AASD,wBAAsB,UAAU,CAC9B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE;IACP,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,GACA,OAAO,CAAC,YAAY,CAAC,CAwFvB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWnE"}

package/dist/prompts.js

@@ -0,0 +1,106 @@
+import prompts from "prompts";
+import pc from "picocolors";
+import { AGENTS_FILE, CLAUDE_FILE, } from "./types.js";
+export function classifyRoot(root) {
+    const hasClaude = root.claude.kind !== "missing";
+    const hasAgents = root.agents.kind !== "missing";
+    if (hasClaude && hasAgents)
+        return "both";
+    if (hasClaude)
+        return "only-claude";
+    if (hasAgents)
+        return "only-agents";
+    return "neither";
+}
+function cancel() {
+    process.stdout.write(pc.dim("\nCancelled.\n"));
+    process.exit(0);
+}
+const onCancel = () => cancel();
+export async function decideRoot(rootState, options) {
+    const rootCase = classifyRoot(rootState);
+    // Honour explicit --source flag without prompting.
+    if (options.sourceFlag) {
+        return {
+            source: options.sourceFlag,
+            bootstrapRoot: rootCase === "neither",
+        };
+    }
+    switch (rootCase) {
+        case "only-claude": {
+            if (options.yes)
+                return { source: CLAUDE_FILE, bootstrapRoot: false };
+            const { confirm } = await prompts({
+                type: "confirm",
+                name: "confirm",
+                message: `Found ${pc.bold(CLAUDE_FILE)} at repository root. Use ${pc.bold(CLAUDE_FILE)} as the source of truth across the repository?`,
+                initial: true,
+            }, { onCancel });
+            if (!confirm)
+                cancel();
+            return { source: CLAUDE_FILE, bootstrapRoot: false };
+        }
+        case "only-agents": {
+            if (options.yes)
+                return { source: AGENTS_FILE, bootstrapRoot: false };
+            const { confirm } = await prompts({
+                type: "confirm",
+                name: "confirm",
+                message: `Found ${pc.bold(AGENTS_FILE)} at repository root. Use ${pc.bold(AGENTS_FILE)} as the source of truth across the repository?`,
+                initial: true,
+            }, { onCancel });
+            if (!confirm)
+                cancel();
+            return { source: AGENTS_FILE, bootstrapRoot: false };
+        }
+        case "both": {
+            if (options.yes) {
+                // Without an explicit choice, default to CLAUDE.md when both exist.
+                return { source: CLAUDE_FILE, bootstrapRoot: false };
+            }
+            const { choice } = await prompts({
+                type: "select",
+                name: "choice",
+                message: `Both ${pc.bold(CLAUDE_FILE)} and ${pc.bold(AGENTS_FILE)} exist at repository root. Which one should be the source of truth for the repository?`,
+                choices: [
+                    { title: `Keep ${CLAUDE_FILE}`, value: CLAUDE_FILE },
+                    { title: `Keep ${AGENTS_FILE}`, value: AGENTS_FILE },
+                    { title: "Cancel", value: "__cancel" },
+                ],
+                initial: 0,
+            }, { onCancel });
+            if (!choice || choice === "__cancel")
+                cancel();
+            return { source: choice, bootstrapRoot: false };
+        }
+        case "neither": {
+            if (options.yes)
+                return { source: CLAUDE_FILE, bootstrapRoot: true };
+            process.stdout.write(pc.dim(`No ${CLAUDE_FILE} or ${AGENTS_FILE} found at repository root.\n`));
+            const { choice } = await prompts({
+                type: "select",
+                name: "choice",
+                message: "Which file should become the repository standard?",
+                choices: [
+                    { title: CLAUDE_FILE, value: CLAUDE_FILE },
+                    { title: AGENTS_FILE, value: AGENTS_FILE },
+                    { title: "Cancel", value: "__cancel" },
+                ],
+                initial: 0,
+            }, { onCancel });
+            if (!choice || choice === "__cancel")
+                cancel();
+            return { source: choice, bootstrapRoot: true };
+        }
+    }
+}
+export async function confirmPlan(message) {
+    const { ok } = await prompts({
+        type: "confirm",
+        name: "ok",
+        message,
+        initial: true,
+    }, { onCancel });
+    return Boolean(ok);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,25 @@
+import { type DirState, type EntryState, type SourceName } from "./types.js";
+export declare const DEFAULT_IGNORED_DIRS: Set<string>;
+export interface ScanOptions {
+    ignoredDirs?: Set<string>;
+    followHiddenDirs?: boolean;
+}
+/**
+ * Classify a single CLAUDE.md/AGENTS.md candidate path. Resolves the symlink
+ * target without following it, so we can decide whether it already points to
+ * its sibling source file.
+ */
+export declare function classifyEntry(filePath: string, expectedSiblingSource: SourceName | null): Promise<EntryState>;
+/**
+ * Build the per-directory state for the two managed files. `source` is the
+ * repository-wide source-of-truth name; the other file is the link.
+ */
+export declare function readDirState(dir: string, source: SourceName): Promise<DirState>;
+/**
+ * Walk the repo recursively and yield every directory that contains at least
+ * one of the managed filenames (CLAUDE.md / AGENTS.md). Ignored directories
+ * are pruned cheaply.
+ */
+export declare function scanRepository(root: string, source: SourceName, options?: ScanOptions): Promise<DirState[]>;
+export declare function describeEntry(state: EntryState): string;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,oBAAoB,aAiB/B,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,qBAAqB,EAAE,UAAU,GAAG,IAAI,GACvC,OAAO,CAAC,UAAU,CAAC,CAgDrB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsCrB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAmBvD"}

package/dist/scanner.js

@@ -0,0 +1,147 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { AGENTS_FILE, CLAUDE_FILE, } from "./types.js";
+export const DEFAULT_IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    "coverage",
+    "vendor",
+    ".turbo",
+    ".cache",
+    ".parcel-cache",
+    ".svelte-kit",
+    ".nuxt",
+    ".output",
+    ".vercel",
+    ".idea",
+    ".vscode",
+]);
+/**
+ * Classify a single CLAUDE.md/AGENTS.md candidate path. Resolves the symlink
+ * target without following it, so we can decide whether it already points to
+ * its sibling source file.
+ */
+export async function classifyEntry(filePath, expectedSiblingSource) {
+    let lstat;
+    try {
+        lstat = await fs.lstat(filePath);
+    }
+    catch {
+        return { path: filePath, kind: "missing" };
+    }
+    if (lstat.isDirectory()) {
+        return { path: filePath, kind: "directory" };
+    }
+    if (lstat.isSymbolicLink()) {
+        let target;
+        try {
+            target = await fs.readlink(filePath);
+        }
+        catch {
+            return { path: filePath, kind: "broken-symlink" };
+        }
+        let stat;
+        try {
+            stat = await fs.stat(filePath);
+        }
+        catch {
+            return { path: filePath, kind: "broken-symlink", linkTarget: target };
+        }
+        if (!stat.isFile()) {
+            return { path: filePath, kind: "incorrect-symlink", linkTarget: target };
+        }
+        if (expectedSiblingSource) {
+            // We accept either the bare filename or "./<filename>" as correct.
+            const normalised = target.replace(/^\.[\\/]/, "");
+            if (normalised === expectedSiblingSource) {
+                return { path: filePath, kind: "correct-symlink", linkTarget: target };
+            }
+            return { path: filePath, kind: "incorrect-symlink", linkTarget: target };
+        }
+        return { path: filePath, kind: "incorrect-symlink", linkTarget: target };
+    }
+    if (lstat.isFile()) {
+        return { path: filePath, kind: "regular-file" };
+    }
+    return { path: filePath, kind: "other" };
+}
+/**
+ * Build the per-directory state for the two managed files. `source` is the
+ * repository-wide source-of-truth name; the other file is the link.
+ */
+export async function readDirState(dir, source) {
+    const linkName = source === CLAUDE_FILE ? AGENTS_FILE : CLAUDE_FILE;
+    const [claude, agents] = await Promise.all([
+        classifyEntry(path.join(dir, CLAUDE_FILE), source === CLAUDE_FILE ? null : linkName === CLAUDE_FILE ? source : null),
+        classifyEntry(path.join(dir, AGENTS_FILE), source === AGENTS_FILE ? null : linkName === AGENTS_FILE ? source : null),
+    ]);
+    return { dir, claude, agents };
+}
+/**
+ * Walk the repo recursively and yield every directory that contains at least
+ * one of the managed filenames (CLAUDE.md / AGENTS.md). Ignored directories
+ * are pruned cheaply.
+ */
+export async function scanRepository(root, source, options = {}) {
+    const ignored = options.ignoredDirs ?? DEFAULT_IGNORED_DIRS;
+    const results = [];
+    async function walk(dir, isRoot) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        let hasClaude = false;
+        let hasAgents = false;
+        const childDirs = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (ignored.has(entry.name))
+                    continue;
+                if (!options.followHiddenDirs && entry.name.startsWith("."))
+                    continue;
+                childDirs.push(path.join(dir, entry.name));
+            }
+            else if (entry.isFile() || entry.isSymbolicLink()) {
+                if (entry.name === CLAUDE_FILE)
+                    hasClaude = true;
+                else if (entry.name === AGENTS_FILE)
+                    hasAgents = true;
+            }
+        }
+        if (isRoot || hasClaude || hasAgents) {
+            results.push(await readDirState(dir, source));
+        }
+        for (const child of childDirs) {
+            await walk(child, false);
+        }
+    }
+    await walk(root, true);
+    return results;
+}
+export function describeEntry(state) {
+    switch (state.kind) {
+        case "missing":
+            return "missing";
+        case "regular-file":
+            return "regular file";
+        case "correct-symlink":
+            return `symlink → ${state.linkTarget ?? "?"} (current)`;
+        case "incorrect-symlink":
+            return `symlink → ${state.linkTarget ?? "?"} (stale)`;
+        case "broken-symlink":
+            return `broken symlink → ${state.linkTarget ?? "?"}`;
+        case "directory":
+            return "directory (unexpected)";
+        case "other":
+            return "non-regular file (unexpected)";
+        default:
+            return "unknown";
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export declare const CLAUDE_FILE = "CLAUDE.md";
+export declare const AGENTS_FILE = "AGENTS.md";
+export type SourceName = typeof CLAUDE_FILE | typeof AGENTS_FILE;
+export interface CliOptions {
+    root: string;
+    yes: boolean;
+    dryRun: boolean;
+    force: boolean;
+    verbose: boolean;
+    help: boolean;
+    version: boolean;
+    source?: SourceName;
+    copyFallback: boolean;
+    noCopyFallback: boolean;
+}
+export type EntryKind = "missing" | "regular-file" | "correct-symlink" | "incorrect-symlink" | "broken-symlink" | "directory" | "other";
+export interface EntryState {
+    /** Absolute path to the file. */
+    path: string;
+    kind: EntryKind;
+    /** For symlinks, the raw link target (relative or absolute as stored). */
+    linkTarget?: string;
+}
+export interface DirState {
+    /** Absolute directory path. */
+    dir: string;
+    claude: EntryState;
+    agents: EntryState;
+}
+export type PlannedAction = {
+    type: "create-symlink";
+    /** The link file we will create (e.g. AGENTS.md in some dir). */
+    linkPath: string;
+    /** The source file the link should point at (absolute path). */
+    sourcePath: string;
+    /** Whether the link file currently exists and must be removed first. */
+    replacesExisting: boolean;
+    /** Whether existing entry is a regular file (vs a stale symlink). */
+    replacesRegularFile: boolean;
+} | {
+    type: "promote-to-source";
+    /** Existing file that will be renamed (e.g. AGENTS.md in a folder where CLAUDE.md is source). */
+    fromPath: string;
+    /** New name for that file (e.g. CLAUDE.md). */
+    toPath: string;
+    /** Then create symlink at fromPath -> toPath. */
+    linkBack: true;
+} | {
+    type: "create-root-source";
+    /** Create an empty source file at the repository root. */
+    sourcePath: string;
+} | {
+    type: "skip";
+    reason: string;
+    path: string;
+};
+export interface ActionResult {
+    action: PlannedAction;
+    ok: boolean;
+    message: string;
+    fellBackToCopy?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,WAAW,cAAc,CAAC;AAEvC,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,GAAG,OAAO,WAAW,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,mBAAmB,EAAE,OAAO,CAAC;CAC9B,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,EAAE,IAAI,CAAC;CAChB,GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+export const CLAUDE_FILE = "CLAUDE.md";
+export const AGENTS_FILE = "AGENTS.md";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC"}