@tinyrack/dotweave 0.39.4

package/dist/services/terminal/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/services/terminal/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,aAAa,EAAE,MAAM,SAAS,CAAC;AAI9D,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAKK,EAAE,EACI,EAAE;IACb,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,aAAa,EAAE;YACb,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK;YACpD,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,KAAK;SACZ;QACD,KAAK,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC1E,CAAC,CAAC"}

package/dist/services/terminal/path-completion.d.ts

@@ -0,0 +1,3 @@
+import type { DotweaveCliContext } from "#app/services/terminal/cli-runtime.ts";
+export declare const proposePathCompletions: (this: DotweaveCliContext, partial: string) => Promise<string[]>;
+//# sourceMappingURL=path-completion.d.ts.map

package/dist/services/terminal/path-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-completion.d.ts","sourceRoot":"","sources":["../../../src/services/terminal/path-completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AA8IhF,eAAO,MAAM,sBAAsB,GACjC,MAAM,kBAAkB,EACxB,SAAS,MAAM,sBA0BhB,CAAC"}

package/dist/services/terminal/path-completion.js

@@ -0,0 +1,108 @@
+const HOME_PREFIX = "~";
+const HIDDEN_ENTRY_PREFIX = ".";
+const RECOVERABLE_ERROR_CODES = new Set([
+    "EACCES",
+    "ENOENT",
+    "ENOTDIR",
+]);
+const SHELL_PATH_SEPARATOR = "/";
+const isRecoverableCompletionError = (error) => {
+    return (error instanceof Error &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        RECOVERABLE_ERROR_CODES.has(error.code));
+};
+const buildRelativeCompletionBase = (partial, context) => {
+    const lastSeparatorIndex = partial.lastIndexOf(SHELL_PATH_SEPARATOR);
+    const displayPrefix = lastSeparatorIndex < 0 ? "" : partial.slice(0, lastSeparatorIndex + 1);
+    const entryPrefix = lastSeparatorIndex < 0 ? partial : partial.slice(lastSeparatorIndex + 1);
+    return {
+        absoluteDirectory: context.path.resolve(context.process.cwd(), displayPrefix === "" ? "." : displayPrefix),
+        displayPrefix,
+        entryPrefix,
+    };
+};
+const buildAbsoluteCompletionBase = (partial, context) => {
+    const lastSeparatorIndex = partial.lastIndexOf(SHELL_PATH_SEPARATOR);
+    const displayPrefix = lastSeparatorIndex < 0
+        ? SHELL_PATH_SEPARATOR
+        : partial.slice(0, lastSeparatorIndex + 1);
+    const entryPrefix = lastSeparatorIndex < 0 ? partial : partial.slice(lastSeparatorIndex + 1);
+    return {
+        absoluteDirectory: context.path.resolve(displayPrefix),
+        displayPrefix,
+        entryPrefix,
+    };
+};
+const buildHomeCompletionBase = (partial, context) => {
+    if (partial === HOME_PREFIX) {
+        return {
+            absoluteDirectory: context.os.homedir(),
+            displayPrefix: `${HOME_PREFIX}${SHELL_PATH_SEPARATOR}`,
+            entryPrefix: "",
+        };
+    }
+    if (!partial.startsWith(`${HOME_PREFIX}${SHELL_PATH_SEPARATOR}`)) {
+        return undefined;
+    }
+    const homeRelativePath = partial.slice(2);
+    const lastSeparatorIndex = homeRelativePath.lastIndexOf(SHELL_PATH_SEPARATOR);
+    const directorySuffix = lastSeparatorIndex < 0
+        ? ""
+        : homeRelativePath.slice(0, lastSeparatorIndex + 1);
+    const entryPrefix = lastSeparatorIndex < 0
+        ? homeRelativePath
+        : homeRelativePath.slice(lastSeparatorIndex + 1);
+    return {
+        absoluteDirectory: context.path.resolve(context.os.homedir(), directorySuffix === "" ? "." : directorySuffix),
+        displayPrefix: `${HOME_PREFIX}${SHELL_PATH_SEPARATOR}${directorySuffix}`,
+        entryPrefix,
+    };
+};
+const resolveCompletionBase = (partial, context) => {
+    if (partial.startsWith(HOME_PREFIX)) {
+        return buildHomeCompletionBase(partial, context);
+    }
+    if (partial.startsWith(SHELL_PATH_SEPARATOR)) {
+        return buildAbsoluteCompletionBase(partial, context);
+    }
+    return buildRelativeCompletionBase(partial, context);
+};
+const shouldIncludeEntry = (name, entryPrefix) => {
+    if (!name.startsWith(entryPrefix)) {
+        return false;
+    }
+    if (!entryPrefix.startsWith(HIDDEN_ENTRY_PREFIX) &&
+        name.startsWith(HIDDEN_ENTRY_PREFIX)) {
+        return false;
+    }
+    return true;
+};
+const buildCompletionValue = (base, entryName, isDirectory) => {
+    const completion = `${base.displayPrefix}${entryName}`;
+    return isDirectory ? `${completion}${SHELL_PATH_SEPARATOR}` : completion;
+};
+export const proposePathCompletions = async function (partial) {
+    const base = resolveCompletionBase(partial, this);
+    if (base === undefined) {
+        return [];
+    }
+    try {
+        const entries = await this.fs.promises.readdir(base.absoluteDirectory, {
+            withFileTypes: true,
+        });
+        return entries
+            .filter((entry) => shouldIncludeEntry(entry.name, base.entryPrefix))
+            .map((entry) => {
+            return buildCompletionValue(base, entry.name, entry.isDirectory());
+        })
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch (error) {
+        if (isRecoverableCompletionError(error)) {
+            return [];
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=path-completion.js.map

package/dist/services/terminal/path-completion.js.map

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

package/dist/services/terminal/shell.d.ts

@@ -0,0 +1,24 @@
+import type { PlatformKey } from "#app/config/platform.ts";
+type ShellCommand = Readonly<{
+    args: readonly string[];
+    command: string;
+}>;
+type WindowsProcessInfo = Readonly<{
+    commandLine?: string;
+    executablePath?: string;
+    name?: string;
+    parentProcessId: number;
+    processId: number;
+}>;
+type ResolveShellCommandOptions = Readonly<{
+    initialWindowsProcessId?: number;
+    inspectWindowsProcess?: (processId: number) => Promise<WindowsProcessInfo | undefined>;
+}>;
+export declare const resolveShellCommandForPlatform: (platformKey: PlatformKey, options?: ResolveShellCommandOptions) => Promise<ShellCommand>;
+export declare const resolveShellCommand: () => Promise<Readonly<{
+    args: readonly string[];
+    command: string;
+}>>;
+export declare const launchShellInDirectory: (directory: string) => Promise<void>;
+export {};
+//# sourceMappingURL=shell.d.ts.map

package/dist/services/terminal/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/services/terminal/shell.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,KAAK,YAAY,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,KAAK,kBAAkB,GAAG,QAAQ,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,KAAK,0BAA0B,GAAG,QAAQ,CAAC;IACzC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,CACtB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;CAC9C,CAAC,CAAC;AA6NH,eAAO,MAAM,8BAA8B,GACzC,aAAa,WAAW,EACxB,UAAS,0BAA+B,KACvC,OAAO,CAAC,YAAY,CAStB,CAAC;AAEF,eAAO,MAAM,mBAAmB;UA5PxB,SAAS,MAAM,EAAE;aACd,MAAM;GA6PhB,CAAC;AA4BF,eAAO,MAAM,sBAAsB,GAAU,WAAW,MAAM,kBA8C7D,CAAC"}

package/dist/services/terminal/shell.js

@@ -0,0 +1,227 @@
+import { spawn } from "node:child_process";
+import { resolveCurrentPlatformKey } from "#app/config/runtime-env.ts";
+import { ENV } from "#app/lib/env.ts";
+import { DotweaveError } from "#app/lib/error.ts";
+const windowsShellNames = new Set([
+    "bash",
+    "cmd",
+    "fish",
+    "nu",
+    "powershell",
+    "pwsh",
+    "sh",
+    "zsh",
+]);
+const windowsProcessQueryScript = [
+    "$processId = [int]$args[0]",
+    '$process = Get-CimInstance Win32_Process -Filter ("ProcessId = " + $processId)',
+    "if ($null -eq $process) { exit 0 }",
+    "$encode = {",
+    "  param([string]$value)",
+    '  if ([string]::IsNullOrEmpty($value)) { return "" }',
+    "  return [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($value))",
+    "}",
+    "[Console]::Out.WriteLine($process.ProcessId)",
+    "[Console]::Out.WriteLine($process.ParentProcessId)",
+    "[Console]::Out.WriteLine((& $encode $process.Name))",
+    "[Console]::Out.WriteLine((& $encode $process.ExecutablePath))",
+    "[Console]::Out.WriteLine((& $encode $process.CommandLine))",
+].join(";");
+const trimConfiguredValue = (value) => {
+    const trimmed = value?.trim();
+    return trimmed === undefined || trimmed === "" ? undefined : trimmed;
+};
+const decodeWindowsProcessField = (value) => {
+    const trimmed = trimConfiguredValue(value);
+    if (trimmed === undefined) {
+        return undefined;
+    }
+    return Buffer.from(trimmed, "base64").toString("utf8");
+};
+const normalizeProcessName = (value) => {
+    const trimmed = trimConfiguredValue(value);
+    if (trimmed === undefined) {
+        return undefined;
+    }
+    const filename = trimmed
+        .replaceAll("\\", "/")
+        .split("/")
+        .at(-1)
+        ?.toLowerCase();
+    if (filename === undefined || filename === "") {
+        return undefined;
+    }
+    return filename.endsWith(".exe") ? filename.slice(0, -4) : filename;
+};
+const stripSingleTrailingLineEnding = (value) => {
+    if (value.endsWith("\r\n")) {
+        return value.slice(0, -2);
+    }
+    if (value.endsWith("\n")) {
+        return value.slice(0, -1);
+    }
+    return value;
+};
+const parseWindowsProcessInfo = (output) => {
+    const normalized = stripSingleTrailingLineEnding(output);
+    if (normalized === "") {
+        return undefined;
+    }
+    const lines = normalized.split(/\r?\n/u);
+    if (lines.length < 5) {
+        return undefined;
+    }
+    const [processIdLine, parentProcessIdLine, nameValue, executablePathValue, commandLineValue,] = lines;
+    const processId = Number.parseInt(processIdLine ?? "", 10);
+    const parentProcessId = Number.parseInt(parentProcessIdLine ?? "", 10);
+    if (!Number.isSafeInteger(processId) ||
+        processId <= 0 ||
+        !Number.isSafeInteger(parentProcessId) ||
+        parentProcessId < 0) {
+        return undefined;
+    }
+    return {
+        commandLine: decodeWindowsProcessField(commandLineValue),
+        executablePath: decodeWindowsProcessField(executablePathValue),
+        name: decodeWindowsProcessField(nameValue),
+        parentProcessId,
+        processId,
+    };
+};
+const inspectWindowsProcess = async (processId) => {
+    return await new Promise((resolve) => {
+        const child = spawn("powershell.exe", [
+            "-NoLogo",
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            windowsProcessQueryScript,
+            String(processId),
+        ], {
+            env: process.env,
+            stdio: ["ignore", "pipe", "ignore"],
+            windowsHide: true,
+        });
+        let stdout = "";
+        child.stdout?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.on("error", () => {
+            resolve(undefined);
+        });
+        child.on("close", (code) => {
+            resolve(code === 0 ? parseWindowsProcessInfo(stdout) : undefined);
+        });
+    });
+};
+const isWrapperCmdProcess = (processInfo) => {
+    return /(?:^|\s)\/c(?:\s|$)/iu.test(processInfo.commandLine ?? "");
+};
+const createShellCommandFromProcess = (processInfo) => {
+    const command = trimConfiguredValue(processInfo.executablePath) ??
+        trimConfiguredValue(processInfo.name);
+    const processName = normalizeProcessName(command);
+    if (command === undefined ||
+        processName === undefined ||
+        !windowsShellNames.has(processName)) {
+        return undefined;
+    }
+    if (processName === "cmd" && isWrapperCmdProcess(processInfo)) {
+        return undefined;
+    }
+    return {
+        args: [],
+        command,
+    };
+};
+const resolveWindowsShellCommand = async (options) => {
+    const inspect = options.inspectWindowsProcess ?? inspectWindowsProcess;
+    const visited = new Set();
+    let processId = options.initialWindowsProcessId ?? process.ppid;
+    while (Number.isSafeInteger(processId) &&
+        processId > 0 &&
+        !visited.has(processId) &&
+        visited.size < 16) {
+        visited.add(processId);
+        const processInfo = await inspect(processId);
+        if (processInfo === undefined) {
+            break;
+        }
+        const shellCommand = createShellCommandFromProcess(processInfo);
+        if (shellCommand !== undefined) {
+            return shellCommand;
+        }
+        processId = processInfo.parentProcessId;
+    }
+    return {
+        args: [],
+        command: trimConfiguredValue(ENV.COMSPEC) ?? "cmd.exe",
+    };
+};
+export const resolveShellCommandForPlatform = async (platformKey, options = {}) => {
+    if (platformKey === "win") {
+        return await resolveWindowsShellCommand(options);
+    }
+    return {
+        args: [],
+        command: trimConfiguredValue(ENV.SHELL) ?? "/bin/sh",
+    };
+};
+export const resolveShellCommand = async () => {
+    return await resolveShellCommandForPlatform(resolveCurrentPlatformKey());
+};
+const createShellFailureHint = () => {
+    return resolveCurrentPlatformKey() === "win"
+        ? "Set COMSPEC to a valid shell executable."
+        : "Set SHELL to a valid shell executable.";
+};
+const createShellExitError = (command, code, signal) => {
+    const error = new DotweaveError(signal === null
+        ? `Shell exited with code ${code ?? "unknown"}.`
+        : `Shell exited due to signal ${signal}.`, {
+        details: [`Shell: ${command}`],
+        hint: "Exit the spawned shell normally when you're done.",
+    });
+    error.exitCode = code ?? 1;
+    return error;
+};
+export const launchShellInDirectory = async (directory) => {
+    const { args, command } = await resolveShellCommand();
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, [...args], {
+            cwd: directory,
+            env: process.env,
+            stdio: "inherit",
+        });
+        let settled = false;
+        const finish = (handler) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            handler();
+        };
+        child.on("error", (error) => {
+            finish(() => {
+                reject(new DotweaveError("Failed to launch shell.", {
+                    details: [
+                        `Shell: ${command}`,
+                        error instanceof Error ? error.message : String(error),
+                    ],
+                    hint: createShellFailureHint(),
+                }));
+            });
+        });
+        child.on("close", (code, signal) => {
+            if (code === 0) {
+                finish(resolve);
+                return;
+            }
+            finish(() => {
+                reject(createShellExitError(command, code, signal));
+            });
+        });
+    });
+};
+//# sourceMappingURL=shell.js.map

package/dist/services/terminal/shell.js.map

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

package/dist/services/track.d.ts

@@ -0,0 +1,20 @@
+import { type SyncConfigEntryKind, type SyncMode } from "#app/config/sync.ts";
+export type TrackRequest = Readonly<{
+    profiles?: readonly string[];
+    mode: SyncMode;
+    repoPath?: string;
+    target: string;
+}>;
+export type TrackResult = Readonly<{
+    alreadyTracked: boolean;
+    changed: boolean;
+    configPath: string;
+    kind: SyncConfigEntryKind;
+    localPath: string;
+    profiles: readonly string[];
+    mode: SyncMode;
+    repoPath: string;
+    syncDirectory: string;
+}>;
+export declare const trackTarget: (request: TrackRequest, cwd: string) => Promise<TrackResult>;
+//# sourceMappingURL=track.d.ts.map

package/dist/services/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../src/services/track.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAmB7B,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAiHH,eAAO,MAAM,WAAW,GACtB,SAAS,YAAY,EACrB,KAAK,MAAM,KACV,OAAO,CAAC,WAAW,CAqLrB,CAAC"}

package/dist/services/track.js

@@ -0,0 +1,224 @@
+import { resolve } from "node:path";
+import { resolveDefaultIdentityFile } from "#app/config/identity-file.ts";
+import { readEnvValue } from "#app/config/runtime-env.ts";
+import { normalizeSyncProfileName, normalizeSyncRepoPath, readSyncConfig, } from "#app/config/sync.ts";
+import { expandHomePath } from "#app/config/xdg.ts";
+import { DotweaveError } from "#app/lib/error.ts";
+import { getPathStats } from "#app/lib/filesystem.ts";
+import { ensureGitRepository } from "#app/lib/git.ts";
+import { doPathsOverlap } from "#app/lib/path.ts";
+import { buildSyncConfigDocument, writeValidatedSyncConfig, } from "./config-file.js";
+import { buildConfiguredHomeLocalPath, buildRepoPathWithinRoot, } from "./paths.js";
+import { resolveSyncConfigResolutionContext, resolveSyncPaths, } from "./runtime.js";
+const buildDefaultPlatformMode = (mode) => ({
+    default: mode,
+});
+const hasPlatformSpecificModeOverride = (configuredMode) => {
+    return (configuredMode.win !== undefined ||
+        configuredMode.mac !== undefined ||
+        configuredMode.linux !== undefined ||
+        configuredMode.wsl !== undefined);
+};
+const buildDefaultPlatformRepoPath = (repoPath) => ({
+    default: normalizeSyncRepoPath(repoPath),
+});
+const buildTrackEntryCandidate = async (targetPath, syncDirectory, homeDirectory, input) => {
+    const targetStats = await getPathStats(targetPath);
+    if (targetStats === undefined) {
+        throw new DotweaveError("Sync target does not exist.", {
+            code: "TARGET_NOT_FOUND",
+            details: [`Target: ${targetPath}`],
+            hint: "Create the file or directory first, then run the command again.",
+        });
+    }
+    const kind = (() => {
+        if (targetStats.isDirectory()) {
+            return "directory";
+        }
+        if (targetStats.isFile() || targetStats.isSymbolicLink()) {
+            return "file";
+        }
+        throw new DotweaveError("Sync target type is not supported.", {
+            code: "TARGET_UNSUPPORTED_TYPE",
+            details: [`Target: ${targetPath}`],
+            hint: "Track a regular file, symlink, or directory.",
+        });
+    })();
+    if (doPathsOverlap(targetPath, syncDirectory)) {
+        throw new DotweaveError("Sync target overlaps the dotweave sync directory.", {
+            code: "TARGET_OVERLAPS_SYNC_DIR",
+            details: [`Target: ${targetPath}`, `Sync directory: ${syncDirectory}`],
+            hint: "Choose a path outside the dotweave sync directory.",
+        });
+    }
+    if (input.identityFile !== undefined &&
+        doPathsOverlap(targetPath, input.identityFile)) {
+        throw new DotweaveError("Sync target contains the configured age identity file.", {
+            code: "TARGET_OVERLAPS_IDENTITY",
+            details: [
+                `Target: ${targetPath}`,
+                `Age identity file: ${input.identityFile}`,
+            ],
+            hint: "Store age key material outside tracked sync targets.",
+        });
+    }
+    const localRepoPath = buildRepoPathWithinRoot(targetPath, homeDirectory, "Sync target");
+    const configuredLocalPath = buildConfiguredHomeLocalPath(localRepoPath);
+    const configuredRepoPath = input.repoPath === undefined
+        ? undefined
+        : buildDefaultPlatformRepoPath(input.repoPath);
+    const repoPath = configuredRepoPath?.default ?? localRepoPath;
+    return {
+        configuredLocalPath,
+        ...(configuredRepoPath === undefined ? {} : { configuredRepoPath }),
+        kind,
+        localPath: targetPath,
+        profiles: input.profiles?.map((m) => normalizeSyncProfileName(m)) ?? [],
+        profilesExplicit: input.profiles !== undefined,
+        mode: input.mode,
+        modeExplicit: true,
+        configuredMode: buildDefaultPlatformMode(input.mode),
+        permissionExplicit: false,
+        repoPath,
+    };
+};
+export const trackTarget = async (request, cwd) => {
+    const target = request.target.trim();
+    if (target.length === 0) {
+        throw new DotweaveError("Target path is required.", {
+            code: "TARGET_REQUIRED",
+            hint: "Pass a file or directory path, for example 'dotweave track ~/.gitconfig'.",
+        });
+    }
+    const { syncDirectory, configPath } = resolveSyncPaths();
+    const context = resolveSyncConfigResolutionContext();
+    await ensureGitRepository(syncDirectory);
+    const config = await readSyncConfig(syncDirectory, context);
+    const identityFile = config.age !== undefined
+        ? resolveDefaultIdentityFile(readEnvValue("HOME"), readEnvValue("XDG_CONFIG_HOME"))
+        : undefined;
+    const isProfileClear = request.profiles !== undefined &&
+        request.profiles.length === 1 &&
+        request.profiles[0] === "";
+    const effectiveProfiles = isProfileClear ? [] : request.profiles;
+    const candidate = await buildTrackEntryCandidate(resolve(cwd, expandHomePath(target, context.homeDirectory)), syncDirectory, context.homeDirectory, {
+        identityFile,
+        profiles: effectiveProfiles,
+        mode: request.mode,
+        repoPath: request.repoPath,
+    });
+    const existingEntry = config.entries.find((entry) => entry.localPath === candidate.localPath);
+    const alreadyTracked = existingEntry !== undefined && existingEntry.kind === candidate.kind;
+    if (existingEntry !== undefined && existingEntry.kind !== candidate.kind) {
+        throw new DotweaveError("Sync target conflicts with an existing tracked entry.", {
+            code: "TARGET_CONFLICT",
+            details: [
+                `Requested local path: ${candidate.localPath}`,
+                `Requested repo path: ${candidate.repoPath}`,
+                `Existing entry: ${existingEntry.localPath} -> ${existingEntry.repoPath}`,
+            ],
+            hint: "Untrack or rename the existing entry before adding this root.",
+        });
+    }
+    const nextEntry = existingEntry !== undefined && request.repoPath === undefined
+        ? {
+            ...candidate,
+            configuredRepoPath: existingEntry.configuredRepoPath,
+            repoPath: existingEntry.repoPath,
+        }
+        : candidate;
+    const repoPathConflict = config.entries.find((entry) => {
+        return (entry.repoPath === nextEntry.repoPath &&
+            entry.localPath !== nextEntry.localPath);
+    });
+    if (repoPathConflict !== undefined) {
+        throw new DotweaveError("Sync target conflicts with an existing tracked entry.", {
+            code: "TARGET_CONFLICT",
+            details: [
+                `Requested local path: ${nextEntry.localPath}`,
+                `Requested repo path: ${nextEntry.repoPath}`,
+                `Existing entry: ${repoPathConflict.localPath} -> ${repoPathConflict.repoPath}`,
+            ],
+            hint: "Change --repo-path or untrack the conflicting entry first.",
+        });
+    }
+    if (!alreadyTracked) {
+        const nextConfig = buildSyncConfigDocument({
+            ...config,
+            entries: [...config.entries, nextEntry],
+        });
+        await writeValidatedSyncConfig(syncDirectory, nextConfig, context);
+        return {
+            alreadyTracked,
+            changed: true,
+            configPath,
+            kind: nextEntry.kind,
+            localPath: nextEntry.localPath,
+            profiles: nextEntry.profiles,
+            mode: nextEntry.mode,
+            repoPath: nextEntry.repoPath,
+            syncDirectory,
+        };
+    }
+    const requestedConfiguredMode = buildDefaultPlatformMode(request.mode);
+    const modeChanged = existingEntry?.mode !== request.mode ||
+        existingEntry?.configuredMode.default !== requestedConfiguredMode.default ||
+        (existingEntry !== undefined &&
+            hasPlatformSpecificModeOverride(existingEntry.configuredMode));
+    const profilesChanged = effectiveProfiles !== undefined &&
+        (existingEntry?.profiles.length !== candidate.profiles.length ||
+            !candidate.profiles.every((m) => existingEntry?.profiles.includes(m)));
+    const repoPathChanged = request.repoPath !== undefined &&
+        (existingEntry?.repoPath !== nextEntry.repoPath ||
+            JSON.stringify(existingEntry?.configuredRepoPath) !==
+                JSON.stringify(nextEntry.configuredRepoPath));
+    const changed = modeChanged || profilesChanged || repoPathChanged;
+    if (changed) {
+        const nextConfig = buildSyncConfigDocument({
+            ...config,
+            entries: config.entries.map((entry) => {
+                if (entry.localPath !== candidate.localPath) {
+                    return entry;
+                }
+                return {
+                    ...entry,
+                    ...(repoPathChanged
+                        ? {
+                            configuredRepoPath: nextEntry.configuredRepoPath,
+                            repoPath: nextEntry.repoPath,
+                        }
+                        : {}),
+                    ...(modeChanged
+                        ? {
+                            configuredMode: requestedConfiguredMode,
+                            mode: request.mode,
+                        }
+                        : {}),
+                    ...(profilesChanged
+                        ? {
+                            profiles: candidate.profiles,
+                            profilesExplicit: candidate.profilesExplicit,
+                        }
+                        : {}),
+                };
+            }),
+        });
+        await writeValidatedSyncConfig(syncDirectory, nextConfig, context);
+    }
+    return {
+        alreadyTracked,
+        changed,
+        configPath,
+        kind: nextEntry.kind,
+        localPath: nextEntry.localPath,
+        profiles: profilesChanged
+            ? nextEntry.profiles
+            : (existingEntry?.profiles ?? []),
+        mode: modeChanged ? request.mode : (existingEntry?.mode ?? request.mode),
+        repoPath: repoPathChanged || !alreadyTracked
+            ? nextEntry.repoPath
+            : (existingEntry?.repoPath ?? nextEntry.repoPath),
+        syncDirectory,
+    };
+};
+//# sourceMappingURL=track.js.map