link-agents 0.9.0

package/dist/commands/doctor.js

@@ -0,0 +1,81 @@
+import chalk from "chalk";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { discoverCanonicalAssets, discoverIgnoredCursorRules, discoverLegacyAssets, groupAssetsByCanonicalKey, } from "../utils/canonical.js";
+import { readCanonicalState } from "../utils/canonicalState.js";
+import { transformContentForClient } from "../utils/frontmatter.js";
+import { formatIssueSection } from "../utils/reporting.js";
+export async function runDoctorCommand(options) {
+    const projectRoot = process.cwd();
+    const canonicalAssets = await discoverCanonicalAssets(projectRoot, options.types);
+    const legacyAssets = await discoverLegacyAssets(projectRoot, options.types);
+    const ignoredCursorRules = await discoverIgnoredCursorRules(projectRoot);
+    const state = await readCanonicalState();
+    const canonicalKeys = new Set(groupAssetsByCanonicalKey(canonicalAssets).keys());
+    const legacyKeys = groupAssetsByCanonicalKey(legacyAssets.filter((asset) => asset.type !== "rules"));
+    let issues = 0;
+    console.log(chalk.cyan("Doctor"));
+    console.log(`  Canonical assets: ${canonicalAssets.length}`);
+    console.log(`  Tracked generated targets: ${state.generated.length}`);
+    console.log();
+    const ignoredLines = formatIssueSection("Ignored legacy inputs", ignoredCursorRules.map((asset) => asset.path));
+    if (ignoredLines.length > 0) {
+        issues += ignoredCursorRules.length;
+        console.log(chalk.yellow(ignoredLines[0]));
+        for (const line of ignoredLines.slice(1)) {
+            console.log(line);
+        }
+    }
+    const bootstrapEligible = [...legacyKeys.entries()].filter(([key]) => !canonicalKeys.has(key));
+    const bootstrapLines = formatIssueSection("Missing canonical assets eligible for bootstrap", bootstrapEligible.map(([key, candidates]) => `${key} <- ${candidates.map((asset) => asset.client).join(", ")}`));
+    if (bootstrapLines.length > 0) {
+        issues += bootstrapEligible.length;
+        console.log(chalk.yellow(bootstrapLines[0]));
+        for (const line of bootstrapLines.slice(1)) {
+            console.log(line);
+        }
+    }
+    const brokenLinks = [];
+    const driftedCopies = [];
+    for (const entry of state.generated) {
+        try {
+            const stats = await fs.lstat(entry.path);
+            if (stats.isSymbolicLink()) {
+                const linkTarget = await fs.readlink(entry.path);
+                const resolved = path.resolve(path.dirname(entry.path), linkTarget);
+                await fs.access(resolved);
+            }
+            else {
+                const current = await fs.readFile(entry.path, "utf8");
+                const expected = entry.expectedContent ??
+                    transformContentForClient(await fs.readFile(entry.sourcePath, "utf8"), entry.targetClient, entry.type);
+                if (current !== expected) {
+                    driftedCopies.push(entry.path);
+                }
+            }
+        }
+        catch {
+            brokenLinks.push(entry.path);
+        }
+    }
+    const brokenLines = formatIssueSection("Broken generated links/targets", brokenLinks);
+    if (brokenLines.length > 0) {
+        issues += brokenLinks.length;
+        console.log(chalk.red(brokenLines[0]));
+        for (const line of brokenLines.slice(1)) {
+            console.log(line);
+        }
+    }
+    const driftLines = formatIssueSection("Generated copies drifted from canonical source", driftedCopies);
+    if (driftLines.length > 0) {
+        issues += driftedCopies.length;
+        console.log(chalk.yellow(driftLines[0]));
+        for (const line of driftLines.slice(1)) {
+            console.log(line);
+        }
+    }
+    if (issues === 0) {
+        console.log(chalk.green("doctor: no issues found"));
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/restore.d.ts

@@ -0,0 +1,3 @@
+import type { RestoreCommandOptions } from "../types/index.js";
+export declare function runRestoreCommand(options: RestoreCommandOptions): Promise<void>;
+//# sourceMappingURL=restore.d.ts.map

package/dist/commands/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/commands/restore.js

@@ -0,0 +1,36 @@
+import chalk from "chalk";
+import { listSnapshots, readSnapshot, restoreSnapshot, } from "../utils/snapshots.js";
+import { formatSnapshotList } from "../utils/reporting.js";
+export async function runRestoreCommand(options) {
+    if (options.list) {
+        const snapshots = await listSnapshots();
+        if (snapshots.length === 0) {
+            console.log(chalk.yellow("No snapshots available."));
+            return;
+        }
+        console.log(chalk.cyan(`Snapshots (${snapshots.length})`));
+        for (const line of formatSnapshotList(snapshots)) {
+            console.log(`  ${line}`);
+        }
+        return;
+    }
+    const snapshotId = options.id ?? (await getLatestSnapshotId());
+    const snapshot = await readSnapshot(snapshotId);
+    if (options.dryRun) {
+        console.log(chalk.yellow(`Would restore snapshot ${snapshot.id} (${snapshot.entries.length} paths)`));
+        for (const entry of snapshot.entries) {
+            console.log(`  ${entry.path} <- ${entry.state}`);
+        }
+        return;
+    }
+    await restoreSnapshot(snapshot.id);
+    console.log(chalk.green(`Restored snapshot ${snapshot.id}`));
+}
+async function getLatestSnapshotId() {
+    const snapshots = await listSnapshots();
+    if (snapshots.length === 0) {
+        throw new Error("No snapshots available.");
+    }
+    return snapshots[0].id;
+}
+//# sourceMappingURL=restore.js.map

package/dist/commands/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/commands/restore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA8B;IAE9B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;QACxC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3D,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,0BAA0B,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,CAAC,MAAM,SAAS,CAC3E,CACF,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;IACxC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzB,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,3 @@
+import type { SyncCommandOptions } from "../types/index.js";
+export declare function runSyncCommand(options: SyncCommandOptions): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AA4B3B,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkHf"}

package/dist/commands/sync.js

@@ -0,0 +1,193 @@
+import { select } from "@clack/prompts";
+import chalk from "chalk";
+import fs from "node:fs/promises";
+import { buildClientDefinitions } from "../clients/definitions.js";
+import { applyPlan } from "../utils/apply.js";
+import { buildBootstrapEntry, buildFanoutPlan, discoverCanonicalAssets, discoverIgnoredCursorRules, discoverLegacyAssets, getBootstrapChoices, groupAssetsByCanonicalKey, synthesizeCanonicalAsset, } from "../utils/canonical.js";
+import { writeCanonicalState, } from "../utils/canonicalState.js";
+import { fileExists, readFileSafe } from "../utils/fs.js";
+import { getBootstrapResolution } from "../utils/bootstrap.js";
+import { createSnapshot, restoreSnapshot } from "../utils/snapshots.js";
+import { printApplyResultLike } from "../utils/syncRuntime.js";
+import { buildDetailedPlanLines, buildSyncPlanSummaryLines, buildSyncPreflightLines, formatIssueSection, } from "../utils/reporting.js";
+export async function runSyncCommand(options) {
+    const projectRoot = process.cwd();
+    const allDefs = buildClientDefinitions(projectRoot);
+    const targetDefs = await getTargetDefinitions(allDefs);
+    const canonicalAssets = await discoverCanonicalAssets(projectRoot, options.types);
+    const legacyAssets = await discoverLegacyAssets(projectRoot, options.types);
+    const ignoredCursorRules = await discoverIgnoredCursorRules(projectRoot);
+    const canonicalByKey = groupAssetsByCanonicalKey(canonicalAssets);
+    const legacyByKey = groupAssetsByCanonicalKey(legacyAssets.filter((asset) => asset.type !== "rules"));
+    const bootstrapEntries = [];
+    const synthesizedCanonical = [...canonicalAssets];
+    for (const [, candidates] of legacyByKey.entries()) {
+        if (canonicalByKey.has(`${candidates[0].type}::${candidates[0].canonicalPath ?? candidates[0].relativePath}`)) {
+            continue;
+        }
+        const canonicalPath = candidates[0].canonicalPath ?? candidates[0].relativePath;
+        const resolution = getBootstrapResolution({
+            canonicalPath,
+            candidates,
+            bootstrapSource: options.bootstrapSource,
+        });
+        if (resolution.status === "missing") {
+            continue;
+        }
+        if (resolution.status === "ambiguous") {
+            const selected = await chooseBootstrapCandidate(canonicalPath, resolution.candidates);
+            if (!selected) {
+                throw new Error(`Bootstrap cancelled for ${canonicalPath}`);
+            }
+            bootstrapEntries.push(buildBootstrapEntry(projectRoot, selected));
+            synthesizedCanonical.push(synthesizeCanonicalAsset(projectRoot, selected));
+            continue;
+        }
+        bootstrapEntries.push(buildBootstrapEntry(projectRoot, resolution.asset));
+        synthesizedCanonical.push(synthesizeCanonicalAsset(projectRoot, resolution.asset));
+    }
+    const resolvedLinkMode = await resolveWriteMode(options);
+    const syncOptions = { ...options, link: resolvedLinkMode };
+    const fanoutPlan = buildFanoutPlan(synthesizedCanonical, targetDefs, syncOptions);
+    const plan = [...bootstrapEntries, ...fanoutPlan];
+    printPreflight({
+        canonicalCount: canonicalAssets.length,
+        bootstrapCount: bootstrapEntries.length,
+        ignoredCount: ignoredCursorRules.length,
+        targets: targetDefs.map((def) => def.name),
+        writeMode: resolvedLinkMode ? "symlink" : "copy",
+        dryRun: options.dryRun,
+        types: options.types,
+    });
+    printWarnings(ignoredCursorRules);
+    if (plan.length === 0) {
+        console.log(chalk.green("Nothing to sync."));
+        return;
+    }
+    printPlan(plan, options.verbose, options.dryRun);
+    if (options.dryRun) {
+        return;
+    }
+    const snapshot = await createSnapshot(plan
+        .filter((entry) => entry.action !== "skip")
+        .map((entry) => entry.targetPath));
+    console.log(chalk.dim(`restore-point-created ${snapshot.id}`));
+    const applyResult = await applyPlan(plan, {
+        mode: "merge",
+        dryRun: false,
+        verbose: options.verbose,
+        link: resolvedLinkMode,
+        separateClaudeMd: options.separateClaudeMd,
+    });
+    if (applyResult.failed > 0) {
+        await restoreSnapshot(snapshot.id);
+        throw new Error(`sync failed; restored snapshot ${snapshot.id}`);
+    }
+    await writeCanonicalState(await collectGeneratedStateEntries(fanoutPlan));
+    printApplyResultLike(applyResult, options.verbose);
+}
+async function chooseBootstrapCandidate(canonicalPath, candidates) {
+    if (!process.stdout.isTTY || !process.stdin.isTTY) {
+        throw new Error(`Ambiguous bootstrap for ${canonicalPath}. Re-run interactively or pass --bootstrap-source <client>.`);
+    }
+    // Sort by newest first so the suggested default is the most recent
+    const sorted = [...candidates].sort((a, b) => {
+        const ta = a.modifiedAt?.getTime() ?? 0;
+        const tb = b.modifiedAt?.getTime() ?? 0;
+        return tb - ta;
+    });
+    const choice = await select({
+        message: `Select bootstrap source for ${canonicalPath}`,
+        options: [
+            ...getBootstrapChoices(sorted),
+            { value: "__cancel__", label: "Cancel", hint: "Abort bootstrap" },
+        ],
+    });
+    if (typeof choice === "symbol" || choice === "__cancel__") {
+        return null;
+    }
+    return candidates.find((asset) => asset.path === choice) ?? null;
+}
+async function resolveWriteMode(options) {
+    if (options.link)
+        return true;
+    if (options.copy)
+        return false;
+    if (!process.stdout.isTTY || !process.stdin.isTTY)
+        return false;
+    const mode = await select({
+        message: "How should files be written?",
+        options: [
+            {
+                value: "symlink",
+                label: "Symlink",
+                hint: "Recommended when exact bytes can be reused",
+            },
+            { value: "copy", label: "Copy", hint: "Always write independent files" },
+        ],
+        initialValue: "symlink",
+    });
+    if (typeof mode === "symbol") {
+        throw new Error("Sync cancelled at write mode selection.");
+    }
+    return mode === "symlink";
+}
+function printPreflight(input) {
+    console.log(chalk.cyan("Preflight"));
+    for (const line of buildSyncPreflightLines(input)) {
+        console.log(`  ${line}`);
+    }
+    console.log();
+}
+function printWarnings(ignoredCursorRules) {
+    const lines = formatIssueSection("Ignored legacy inputs", ignoredCursorRules.map((asset) => `${asset.path} :: ignored cursor rule; manage via .agents/AGENTS.md instead`));
+    if (lines.length === 0) {
+        return;
+    }
+    console.log(chalk.yellow(lines[0]));
+    for (const line of lines.slice(1)) {
+        console.log(chalk.yellow(line));
+    }
+}
+function printPlan(plan, verbose, dryRun) {
+    console.log(chalk.cyan("Plan"));
+    for (const line of buildSyncPlanSummaryLines(plan)) {
+        console.log(`  ${line}`);
+    }
+    console.log();
+    if (!verbose && !dryRun) {
+        return;
+    }
+    console.log(chalk.dim("Detailed paths"));
+    for (const line of buildDetailedPlanLines(plan)) {
+        console.log(chalk.dim(`  ${line}`));
+    }
+    console.log();
+}
+async function collectGeneratedStateEntries(plan) {
+    const generated = [];
+    for (const entry of plan) {
+        const stats = await fs.lstat(entry.targetPath);
+        const sourceContent = await readFileSafe(entry.asset.path);
+        generated.push({
+            path: entry.targetPath,
+            sourcePath: entry.asset.path,
+            canonicalPath: entry.asset.canonicalPath ?? entry.asset.relativePath,
+            targetClient: entry.targetClient,
+            type: entry.asset.type,
+            mode: stats.isSymbolicLink() ? "symlink" : "copy",
+            expectedContent: sourceContent === entry.asset.content ? undefined : entry.asset.content,
+        });
+    }
+    return generated;
+}
+async function getTargetDefinitions(defs) {
+    const targets = [];
+    for (const def of defs) {
+        if (await fileExists(def.root)) {
+            targets.push(def);
+        }
+    }
+    return targets;
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import process from "node:process";
+import chalk from "chalk";
+import { CommanderError } from "commander";
+import { parseCliArgs } from "./cli/options.js";
+import { runSyncCommand } from "./commands/sync.js";
+import { runDoctorCommand } from "./commands/doctor.js";
+import { runRestoreCommand } from "./commands/restore.js";
+async function main() {
+    const options = parseCliArgs(process.argv);
+    if (options.command === "sync") {
+        await runSyncCommand(options);
+        return;
+    }
+    if (options.command === "doctor") {
+        await runDoctorCommand(options);
+        return;
+    }
+    await runRestoreCommand(options);
+}
+main().catch((error) => {
+    if (error instanceof CommanderError &&
+        error.code === "commander.helpDisplayed") {
+        process.exitCode = 0;
+        return;
+    }
+    console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,IACE,KAAK,YAAY,cAAc;QAC/B,KAAK,CAAC,IAAI,KAAK,yBAAyB,EACxC,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAClE,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,98 @@
+export type AgentClientName = "project" | "codex" | "claude" | "cursor" | "opencode";
+export type AssetType = "agents" | "commands" | "rules" | "skills" | "mcp" | "prompts";
+export type ManagedAssetType = "agents" | "commands" | "skills" | "mcp";
+export type SyncScope = "project" | "global" | "all";
+export type SyncDirection = "push" | "pull" | "sync";
+export type ConflictResolution = "source" | "target" | "merge" | "rename" | "skip";
+export interface AssetLocation {
+    path: string;
+    name: string;
+    type: AssetType;
+    client: AgentClientName;
+    relativePath: string;
+    canonicalPath?: string;
+}
+export interface AssetContent extends AssetLocation {
+    content: string;
+    hash: string;
+    metadata?: Record<string, unknown>;
+    modifiedAt?: Date;
+}
+export interface ClientDefinition {
+    name: AgentClientName;
+    displayName: string;
+    root: string;
+    assets: AssetPattern[];
+}
+export interface AssetPattern {
+    type: AssetType;
+    patterns: string[];
+    files?: string[];
+}
+export interface SyncOptions {
+    mode: "interactive" | "merge" | "source";
+    scope?: SyncScope;
+    direction?: SyncDirection;
+    source?: AgentClientName;
+    clients?: AgentClientName[];
+    types?: AssetType[];
+    dryRun?: boolean;
+    verbose?: boolean;
+    priority?: AgentClientName[];
+    exportCursorHistory?: boolean;
+    cursorHistoryDest?: string;
+    reset?: boolean;
+    revert?: boolean;
+    revertList?: boolean;
+    link?: boolean;
+    separateClaudeMd?: boolean;
+}
+export interface SyncCommandOptions {
+    command: "sync";
+    types?: ManagedAssetType[];
+    dryRun: boolean;
+    verbose: boolean;
+    link: boolean;
+    copy: boolean;
+    separateClaudeMd: boolean;
+    bootstrapSource?: AgentClientName;
+}
+export interface DoctorCommandOptions {
+    command: "doctor";
+    types?: ManagedAssetType[];
+    verbose: boolean;
+}
+export interface RestoreCommandOptions {
+    command: "restore";
+    latest: boolean;
+    list: boolean;
+    id?: string;
+    dryRun: boolean;
+    verbose: boolean;
+}
+export type CliCommandOptions = SyncCommandOptions | DoctorCommandOptions | RestoreCommandOptions;
+export interface SyncPlanEntry {
+    asset: AssetContent;
+    targetClient: AgentClientName;
+    targetPath: string;
+    targetRelativePath?: string;
+    action: "create" | "update" | "skip";
+    reason?: string;
+}
+export interface AssetConflict {
+    canonicalKey: string;
+    type: AssetType;
+    versions: AssetContent[];
+    resolution?: ConflictResolution;
+    resolvedContent?: string;
+    renamedPath?: string;
+    selectedVersion?: AssetContent;
+}
+export interface ScanResult {
+    client: AgentClientName;
+    displayName: string;
+    found: boolean;
+    assets: AssetContent[];
+    root: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/apply.d.ts

@@ -0,0 +1,22 @@
+import type { SyncOptions, SyncPlanEntry } from "../types/index.js";
+export interface ApplyResult {
+    applied: number;
+    skipped: number;
+    failed: number;
+    backups: string[];
+    errors: string[];
+    rolledBack: boolean;
+}
+export declare function applyPlan(plan: SyncPlanEntry[], options: SyncOptions): Promise<ApplyResult>;
+/**
+ * Cleanup old backups beyond MAX_BACKUPS limit.
+ */
+export declare function cleanupOldBackups(): Promise<number>;
+/**
+ * Update manifest with generated files and prune stale files.
+ */
+export declare function postApplyCleanup(appliedPaths: string[], verbose?: boolean): Promise<{
+    pruned: string[];
+    manifestUpdated: boolean;
+}>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/utils/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/utils/apply.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBpE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAcD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,aAAa,EAAE,EACrB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAsItB;AAqED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgCzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBzD"}