@tinyrack/devsync 1.1.0 → 1.3.0

package/README.md

@@ -1,30 +1,48 @@
 # devsync
 
-A personal CLI tool for git-backed configuration sync.
+`devsync` is a cross-platform CLI for managing the configuration files in your home directory with git and syncing them across multiple machines.
 
-`devsync` is a Node.js + TypeScript command-line utility for managing a synced configuration repository under your XDG config directory. It tracks files and directories under `HOME`, stores plain and encrypted artifacts in a git-backed sync repo, and can push local state into that repo or pull the repo back onto the machine.
+Instead of treating the repository as the source of truth, `devsync` treats your actual local config as the truth. You choose files and directories under `HOME`, `devsync` mirrors them into a git-backed sync repository, and later restores that repository onto another machine when you need it.
 
-## Features
+## 1. Purpose and how it differs
 
-- Flat sync-focused CLI: `init`, `add`, `set`, `forget`, `list`, `status`, `doctor`, `push`, `pull`, `cd`
-- Git-backed sync repository under `~/.config/devsync/sync`
-- Age-encrypted secret file support
-- Rule-based `normal`, `secret`, and `ignore` modes
-- Direct TypeScript execution with Node.js 24+
-- Shell autocomplete via oclif
+Most dotfiles tools start from the repository and ask you to shape your local machine around it.
 
-## Requirements
+`devsync` takes the opposite approach:
+
+- Your real config under `HOME` is the source of truth.
+- The git repository is a sync artifact, not the primary authoring location.
+- `push` captures your current machine state into the repository.
+- `pull` applies the repository back onto another machine.
+
+That makes `devsync` a good fit when you want to:
+
+- manage existing dotfiles and app configs without reorganizing your home directory,
+- keep machine-specific config workflows intact,
+- sync plain files and encrypted secrets together,
+- use normal git remotes as the transport layer between PCs.
+
+Core capabilities:
+
+- track files and directories under your home directory,
+- store synced artifacts in `~/.config/devsync/sync`,
+- mark paths as `normal`, `secret`, or `ignore`,
+- encrypt secret artifacts with `age`,
+- preview both directions with `status`, `push --dry-run`, and `pull --dry-run`.
+
+## 2. Installation
+
+Requirements:
 
 - Node.js 24+
 - npm
 - git
 
-## Installation
-
 Install globally:
 
 ```bash
 npm install -g @tinyrack/devsync
+devsync --help
 ```
 
 Run without installing globally:
@@ -33,64 +51,177 @@ Run without installing globally:
 npx @tinyrack/devsync --help
 ```
 
-Run the CLI locally:
+Run from this checkout:
 
 ```bash
+npm install
 npm run start -- --help
 ```
 
-For development with file watching:
+The published package name is `@tinyrack/devsync`, and the installed command is `devsync`.
+
+## 3. Quickstart
+
+Initialize a local sync repository:
 
 ```bash
-npm run dev
+devsync init
 ```
 
-The published package name is `@tinyrack/devsync`, but the installed command is still `devsync`.
+Track a few configs:
+
+```bash
+devsync add ~/.gitconfig
+devsync add ~/.zshrc
+devsync add ~/.config/mytool --secret
+```
 
-If you want the `devsync` command available from this checkout during development:
+Review what would be captured:
 
 ```bash
-npm link
+devsync status
+devsync push --dry-run
 ```
 
-## Release
+Write your current local config into the sync repository:
+
+```bash
+devsync push
+```
 
-- CI runs on every push and pull request with `npm run check` on Node.js 24.
-- npm publishing runs automatically when a Git tag matching `v*.*.*` is pushed.
-- The release workflow uses npm Trusted Publishing, so npm access is granted through GitHub Actions OIDC instead of an `NPM_TOKEN` secret.
-- The release workflow fails if the pushed tag does not match `package.json` `version`.
+Open the sync repository and publish it with git:
 
-Typical release flow:
+```bash
+devsync cd
+git status
+git add .
+git commit -m "Update synced config"
+git push
+```
+
+On another machine, clone and restore from the same repo:
 
 ```bash
-npm version patch
-git push --follow-tags
+devsync init https://example.com/my-sync-repo.git
+devsync status
+devsync pull --dry-run
+devsync pull
 ```
 
-## Storage Layout
+Notes:
+
+- `push` updates the sync repository contents only; it does not create git commits or push to a remote.
+- `pull` updates local files only.
+- Secret paths are stored encrypted in the repository and require the configured `age` identity to decrypt on restore.
+
+## 4. Detailed docs
+
+### How tracking works
+
+- You add files or directories that live under your home directory.
+- `devsync` mirrors them into `~/.config/devsync/sync/default/<repoPath>` for the default profile, or `~/.config/devsync/sync/<profile>/<repoPath>` for a named profile.
+- Plain artifacts are stored as-is.
+- Secret artifacts are stored with the `.devsync.secret` suffix.
+
+Storage layout:
 
 - Sync repo: `~/.config/devsync/sync`
-- Default age identity file: `$XDG_CONFIG_HOME/devsync/age/keys.txt`
-- Tracked artifacts live under `~/.config/devsync/sync/files`
-- Secret file artifacts use the suffix `.devsync.secret`, for example `token.json.devsync.secret`
+- Default profile artifacts: `~/.config/devsync/sync/default/<repoPath>`
+- Named profile artifacts: `~/.config/devsync/sync/<profile>/<repoPath>`
+- Default age identity: `$XDG_CONFIG_HOME/devsync/age/keys.txt`
+
+### Sync modes
 
-## Usage
+Each tracked path can use one of three modes:
+
+- `normal`: store and restore plain content
+- `secret`: encrypt before storing in the repo
+- `ignore`: skip during push and pull
+
+You can apply modes to tracked roots or nested paths inside tracked directories.
+
+Profile-specific behavior inherits the tracked root mode and only changes nested paths inside tracked directories.
+
+Examples:
 
 ```bash
-devsync <command>
+devsync set secret ~/.config/mytool/token.json
+devsync set ignore ~/.config/mytool/cache --recursive
+devsync set normal ~/.config/mytool/public.json
+devsync set secret ~/.config/mytool/token.json --profile work
 ```
 
-Or without linking:
+### Profile-specific overrides
+
+- Track the root once without `--profile`.
+- Use `devsync set --profile <name>` only for child paths inside tracked directories.
+- Profile-specific rules inherit the parent root mode and only override nested paths.
+- Named profile artifacts are stored under `<profile>/<repoPath>`.
+- `default` is reserved for the base layout and cannot be used as a named profile.
+- Standalone profiled roots and profiled file entries are not supported.
+
+Example `config.json`:
+
+```json
+{
+  "version": 1,
+  "age": {
+    "identityFile": "$XDG_CONFIG_HOME/devsync/age/keys.txt",
+    "recipients": ["age1example..."]
+  },
+  "entries": [
+    {
+      "kind": "directory",
+      "localPath": "~/.config/mytool",
+      "mode": "normal",
+      "overrides": {
+        "cache/": "ignore"
+      },
+      "profiles": {
+        "work": {
+          "overrides": {
+            "token.json": "secret"
+          }
+        }
+      },
+      "repoPath": ".config/mytool"
+    }
+  ]
+}
+```
+
+### Common workflow
+
+Check what changed:
+
+```bash
+devsync status
+```
+
+Capture local config into the repository:
+
+```bash
+devsync push
+```
+
+Restore repository state onto the machine:
+
+```bash
+devsync pull
+```
+
+Use dry runs when you want to review first:
 
 ```bash
-npm run start -- <command>
+devsync push --dry-run
+devsync pull --dry-run
 ```
 
-## Commands
+### Command reference
 
-### `init`
+#### `init`
 
-Initialize the git-backed sync directory.
+Create or connect the local sync repository.
 
 ```bash
 devsync init
@@ -98,91 +229,115 @@ devsync init https://example.com/my-sync-repo.git
 devsync init --identity "$XDG_CONFIG_HOME/devsync/age/keys.txt" --recipient age1...
 ```
 
-### `add`
+#### `add`
 
-Track a local file or directory under your home directory.
+Track a file or directory under your home directory.
 
 ```bash
 devsync add ~/.gitconfig
-devsync add ./.zshrc
+devsync add ~/.config/mytool
 devsync add ~/.config/mytool --secret
 ```
 
-### `set`
+`add --profile` is not supported for tracked roots. Track the root first, then use `set --profile` for child overrides.
+
+#### `set`
 
-Set mode for a tracked directory root, child file, or child subtree.
+Change the sync mode for a tracked root, child path, or subtree.
 
 ```bash
 devsync set secret ~/.config/mytool/token.json
 devsync set ignore ~/.config/mytool/cache --recursive
-cd ~/.ssh && devsync set ignore known_hosts
-devsync set normal .config/mytool/public.json
+devsync set secret ~/.config/mytool/token.json --profile work
 ```
 
-### `forget`
+With `--profile`, the target must be a child path inside a tracked directory, and `default` cannot be used as the profile name. Profile-specific root mode changes are not supported.
 
-Remove a tracked local path or repository path from sync config.
+#### `forget`
+
+Remove a tracked path or nested override from config.
 
 ```bash
 devsync forget ~/.gitconfig
-cd ~/mytool && devsync forget ./settings.json
-devsync forget .config/mytool
+devsync forget ~/.config/mytool
+devsync forget .config/mytool/token.json --profile work
 ```
 
-### `list`
+#### `list`
 
-Show tracked entries, modes, and override rules.
+Show tracked entries, default modes, root overrides, and profile-specific child overrides.
 
 ```bash
 devsync list
 ```
 
-### `status`
+#### `status`
 
-Show planned push and pull changes for the current sync config.
+Preview planned push and pull changes.
 
 ```bash
 devsync status
 ```
 
-### `doctor`
+#### `doctor`
 
-Check the sync repository, config, age identity, and tracked local paths.
+Validate repo state, config, tracked paths, and secret setup.
 
 ```bash
 devsync doctor
 ```
 
-### `push`
+#### `push`
 
-Mirror local config into the sync repository.
+Write local state into the sync repository.
 
 ```bash
 devsync push
 devsync push --dry-run
 ```
 
-### `pull`
+#### `pull`
 
-Apply the sync repository to local config paths.
+Apply repository state back onto the local machine.
 
 ```bash
 devsync pull
 devsync pull --dry-run
 ```
 
-### `cd`
+#### `cd`
 
-Print the sync directory in non-interactive mode, or open a shell there in interactive mode.
+Open the sync repository in your shell, or print its path.
 
 ```bash
 devsync cd
 devsync cd --print
 ```
 
+For flag-level details, use built-in help:
+
+```bash
+devsync --help
+devsync init --help
+devsync add --help
+devsync set --help
+```
+
 ## Development
 
-Validation commands:
+Run the CLI locally:
+
+```bash
+npm run start -- --help
+```
+
+Watch mode:
+
+```bash
+npm run dev
+```
+
+Validation:
 
 ```bash
 npm run typecheck
@@ -190,8 +345,21 @@ biome check .
 npm run test
 ```
 
-Or run the full validation sequence:
+Or run everything at once:
 
 ```bash
 npm run check
 ```
+
+## Release
+
+- CI runs `npm run check` on every push and pull request.
+- npm publishing runs automatically for Git tags matching `v*.*.*`.
+- The release workflow expects the pushed tag to match `package.json` `version`.
+
+Typical release flow:
+
+```bash
+npm version patch
+git push --follow-tags
+```

package/dist/cli/base-command.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "@oclif/core";
+type CommandError = Error & {
+    exitCode?: number;
+    oclif?: {
+        exit?: number;
+    };
+};
+export declare abstract class BaseCommand extends Command {
+    protected print(output: string): void;
+    protected printError(message: Error | string): void;
+    catch(error: CommandError): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=base-command.d.ts.map

package/dist/cli/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../src/cli/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAStC,KAAK,YAAY,GAAG,KAAK,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAMF,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM;IAI9B,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM;IAItB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAQnE"}

package/dist/cli/base-command.js

@@ -0,0 +1,22 @@
+import { Command } from "@oclif/core";
+import { formatErrorMessage, writeStderr, writeStdout, } from "#app/lib/output.js";
+import { formatDevsyncError } from "#app/services/error.js";
+const resolveExitCode = (error) => {
+    return error.oclif?.exit ?? error.exitCode ?? 1;
+};
+export class BaseCommand extends Command {
+    print(output) {
+        writeStdout(output);
+    }
+    printError(message) {
+        writeStderr(formatErrorMessage(message));
+    }
+    async catch(error) {
+        if (error instanceof Error) {
+            this.printError(formatDevsyncError(error));
+            this.exit(resolveExitCode(error));
+        }
+        return super.catch(error);
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/cli/base-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../src/cli/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAS5D,MAAM,eAAe,GAAG,CAAC,KAAmB,EAAE,EAAE;IAC9C,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,OAAgB,WAAY,SAAQ,OAAO;IACrC,KAAK,CAAC,MAAc;QAC5B,WAAW,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAES,UAAU,CAAC,OAAuB;QAC1C,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,CAAC;IAEe,KAAK,CAAC,KAAK,CAAC,KAAmB;QAC7C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/cli/commands/dir.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from "#app/cli/base-command.js";
+export default class SyncDir extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=dir.d.ts.map

package/dist/cli/commands/dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IAC9C,OAAuB,OAAO,SAAmC;IAEjE,OAAuB,WAAW,SAC+G;IAEjJ,OAAuB,QAAQ,WAG7B;IAEoB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAI3C"}

package/dist/cli/commands/dir.js

@@ -0,0 +1,16 @@
+import { BaseCommand } from "#app/cli/base-command.js";
+import { resolveDevsyncSyncDirectory } from "#app/config/xdg.js";
+import { output } from "#app/lib/output.js";
+export default class SyncDir extends BaseCommand {
+    static summary = "Print the sync directory path";
+    static description = 'Print the absolute path of the local sync repository directory. Compose with your shell to navigate there, for example: cd "$(devsync dir)".';
+    static examples = [
+        "<%= config.bin %> <%= command.id %>",
+        'cd "$(<%= config.bin %> <%= command.id %>)"',
+    ];
+    async run() {
+        const syncDirectory = resolveDevsyncSyncDirectory();
+        this.print(output(syncDirectory));
+    }
+}
+//# sourceMappingURL=dir.js.map

package/dist/cli/commands/dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir.js","sourceRoot":"","sources":["../../../src/cli/commands/dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,WAAW;IACvC,MAAM,CAAU,OAAO,GAAG,+BAA+B,CAAC;IAE1D,MAAM,CAAU,WAAW,GAChC,8IAA8I,CAAC;IAE1I,MAAM,CAAU,QAAQ,GAAG;QAChC,qCAAqC;QACrC,6CAA6C;KAC9C,CAAC;IAEc,KAAK,CAAC,GAAG;QACvB,MAAM,aAAa,GAAG,2BAA2B,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IACpC,CAAC"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,8 @@
+import { BaseCommand } from "#app/cli/base-command.js";
+export default class SyncDoctor extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKvD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,OAAuB,OAAO,SAC2C;IAEzE,OAAuB,WAAW,SACsK;IAExM,OAAuB,QAAQ,WAA2C;IAEpD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3C"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,18 @@
+import { BaseCommand } from "#app/cli/base-command.js";
+import { formatSyncDoctorResult } from "#app/lib/output.js";
+import { runSyncDoctor } from "#app/services/doctor.js";
+import { createSyncContext } from "#app/services/runtime.js";
+export default class SyncDoctor extends BaseCommand {
+    static summary = "Check sync repository, config, age identity, and tracked local paths";
+    static description = "Run health checks for the local sync setup, including repository availability, config validity, age identity configuration, and whether tracked local paths still exist where devsync expects them.";
+    static examples = ["<%= config.bin %> <%= command.id %>"];
+    async run() {
+        await this.parse(SyncDoctor);
+        const result = await runSyncDoctor(createSyncContext());
+        this.print(formatSyncDoctorResult(result));
+        if (result.hasFailures) {
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IAC1C,MAAM,CAAU,OAAO,GAC5B,sEAAsE,CAAC;IAElE,MAAM,CAAU,WAAW,GAChC,qMAAqM,CAAC;IAEjM,MAAM,CAAU,QAAQ,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAE1D,KAAK,CAAC,GAAG;QACvB,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,23 @@
+import SyncDir from "#app/cli/commands/dir.js";
+import SyncDoctor from "#app/cli/commands/doctor.js";
+import SyncInit from "#app/cli/commands/init.js";
+import SyncMachineList from "#app/cli/commands/machine/list.js";
+import SyncMachineUse from "#app/cli/commands/machine/use.js";
+import SyncPull from "#app/cli/commands/pull.js";
+import SyncPush from "#app/cli/commands/push.js";
+import SyncStatus from "#app/cli/commands/status.js";
+import SyncTrack from "#app/cli/commands/track.js";
+import SyncUntrack from "#app/cli/commands/untrack.js";
+export declare const COMMANDS: {
+    dir: typeof SyncDir;
+    doctor: typeof SyncDoctor;
+    init: typeof SyncInit;
+    "machine:list": typeof SyncMachineList;
+    "machine:use": typeof SyncMachineUse;
+    pull: typeof SyncPull;
+    push: typeof SyncPush;
+    status: typeof SyncStatus;
+    track: typeof SyncTrack;
+    untrack: typeof SyncUntrack;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,UAAU,MAAM,6BAA6B,CAAC;AACrD,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,eAAe,MAAM,mCAAmC,CAAC;AAChE,OAAO,cAAc,MAAM,kCAAkC,CAAC;AAC9D,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,UAAU,MAAM,6BAA6B,CAAC;AACrD,OAAO,SAAS,MAAM,4BAA4B,CAAC;AACnD,OAAO,WAAW,MAAM,8BAA8B,CAAC;AAEvD,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWpB,CAAC"}

package/dist/cli/commands/index.js

@@ -0,0 +1,23 @@
+import SyncDir from "#app/cli/commands/dir.js";
+import SyncDoctor from "#app/cli/commands/doctor.js";
+import SyncInit from "#app/cli/commands/init.js";
+import SyncMachineList from "#app/cli/commands/machine/list.js";
+import SyncMachineUse from "#app/cli/commands/machine/use.js";
+import SyncPull from "#app/cli/commands/pull.js";
+import SyncPush from "#app/cli/commands/push.js";
+import SyncStatus from "#app/cli/commands/status.js";
+import SyncTrack from "#app/cli/commands/track.js";
+import SyncUntrack from "#app/cli/commands/untrack.js";
+export const COMMANDS = {
+    dir: SyncDir,
+    doctor: SyncDoctor,
+    init: SyncInit,
+    "machine:list": SyncMachineList,
+    "machine:use": SyncMachineUse,
+    pull: SyncPull,
+    push: SyncPush,
+    status: SyncStatus,
+    track: SyncTrack,
+    untrack: SyncUntrack,
+};
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,UAAU,MAAM,6BAA6B,CAAC;AACrD,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,eAAe,MAAM,mCAAmC,CAAC;AAChE,OAAO,cAAc,MAAM,kCAAkC,CAAC;AAC9D,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,QAAQ,MAAM,2BAA2B,CAAC;AACjD,OAAO,UAAU,MAAM,6BAA6B,CAAC;AACrD,OAAO,SAAS,MAAM,4BAA4B,CAAC;AACnD,OAAO,WAAW,MAAM,8BAA8B,CAAC;AAEvD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,OAAO;IACZ,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,QAAQ;IACd,cAAc,EAAE,eAAe;IAC/B,aAAa,EAAE,cAAc;IAC7B,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,WAAW;CACrB,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "#app/cli/base-command.js";
+export default class SyncInit extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        repository: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        identity: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        recipient: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKvD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,OAAuB,OAAO,SAA8C;IAE5E,OAAuB,WAAW,SAC8N;IAEhQ,OAAuB,QAAQ,WAI7B;IAEF,OAAuB,IAAI;;MAKzB;IAEF,OAAuB,KAAK;;;MAc1B;IAEoB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAe3C"}

package/dist/cli/commands/init.js

@@ -0,0 +1,43 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "#app/cli/base-command.js";
+import { formatSyncInitResult } from "#app/lib/output.js";
+import { initializeSync } from "#app/services/init.js";
+import { createSyncContext } from "#app/services/runtime.js";
+export default class SyncInit extends BaseCommand {
+    static summary = "Initialize the git-backed sync directory";
+    static description = "Create or connect the local devsync repository under your XDG config directory, then store the sync settings used by later pull and push operations. If you omit the repository argument, devsync initializes a local git repository in the sync directory.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> https://example.com/my-sync-repo.git",
+        '<%= config.bin %> <%= command.id %> --identity "$XDG_CONFIG_HOME/devsync/age/keys.txt" --recipient age1...',
+    ];
+    static args = {
+        repository: Args.string({
+            description: "Remote URL or local git repository path to clone",
+            required: false,
+        }),
+    };
+    static flags = {
+        identity: Flags.string({
+            helpValue: "path",
+            summary: "Persist an age identity file path",
+            description: "Store the age identity file path in manifest.json so later pull operations know which private key file to use for decrypting secret artifacts.",
+        }),
+        recipient: Flags.string({
+            helpValue: "recipient",
+            summary: "Persist an age recipient public key",
+            description: "Add an age recipient public key to manifest.json. Repeat this flag to encrypt secrets for multiple recipients during push operations.",
+            multiple: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SyncInit);
+        const output = formatSyncInitResult(await initializeSync({
+            identityFile: flags.identity,
+            recipients: flags.recipient ?? [],
+            repository: args.repository,
+        }, createSyncContext()));
+        this.print(output);
+    }
+}
+//# sourceMappingURL=init.js.map