@tinyrack/devsync 1.1.0 → 1.2.2

package/src/cli/commands/pull.ts

@@ -1,31 +0,0 @@
-import { Command, Flags } from "@oclif/core";
-
-import { formatSyncPullResult } from "#app/cli/sync-output.ts";
-import { pullSync } from "#app/services/pull.ts";
-import { createSyncContext } from "#app/services/runtime.ts";
-
-export default class SyncPull extends Command {
-  public static override summary =
-    "Apply the git-backed sync repository to local config paths";
-
-  public static override flags = {
-    "dry-run": Flags.boolean({
-      default: false,
-      description: "Preview local config changes without writing files",
-    }),
-  };
-
-  public override async run(): Promise<void> {
-    const { flags } = await this.parse(SyncPull);
-    const output = formatSyncPullResult(
-      await pullSync(
-        {
-          dryRun: flags["dry-run"],
-        },
-        createSyncContext(),
-      ),
-    );
-
-    process.stdout.write(output);
-  }
-}

package/src/cli/commands/push.ts

@@ -1,31 +0,0 @@
-import { Command, Flags } from "@oclif/core";
-
-import { formatSyncPushResult } from "#app/cli/sync-output.ts";
-import { pushSync } from "#app/services/push.ts";
-import { createSyncContext } from "#app/services/runtime.ts";
-
-export default class SyncPush extends Command {
-  public static override summary =
-    "Mirror local config into the git-backed sync repository";
-
-  public static override flags = {
-    "dry-run": Flags.boolean({
-      default: false,
-      description: "Preview sync repository changes without writing files",
-    }),
-  };
-
-  public override async run(): Promise<void> {
-    const { flags } = await this.parse(SyncPush);
-    const output = formatSyncPushResult(
-      await pushSync(
-        {
-          dryRun: flags["dry-run"],
-        },
-        createSyncContext(),
-      ),
-    );
-
-    process.stdout.write(output);
-  }
-}

package/src/cli/commands/set.ts

@@ -1,47 +0,0 @@
-import { Args, Command, Flags } from "@oclif/core";
-
-import { formatSyncSetResult } from "#app/cli/sync-output.ts";
-import { createSyncContext } from "#app/services/runtime.ts";
-import { setSyncTargetMode } from "#app/services/set.ts";
-
-export default class SyncSet extends Command {
-  public static override summary =
-    "Set sync mode for a tracked directory root, child file, or child subtree";
-
-  public static override args = {
-    state: Args.string({
-      description: "Mode to apply: normal, secret, or ignore",
-      options: ["normal", "secret", "ignore"],
-      required: true,
-    }),
-    target: Args.string({
-      description:
-        "Tracked local path (including cwd-relative) or repository path inside a tracked directory",
-      required: true,
-    }),
-  };
-
-  public static override flags = {
-    recursive: Flags.boolean({
-      default: false,
-      description:
-        "Apply the mode to a directory subtree or update a tracked directory root default",
-    }),
-  };
-
-  public override async run(): Promise<void> {
-    const { args, flags } = await this.parse(SyncSet);
-    const output = formatSyncSetResult(
-      await setSyncTargetMode(
-        {
-          recursive: flags.recursive,
-          state: args.state as "ignore" | "normal" | "secret",
-          target: args.target,
-        },
-        createSyncContext(),
-      ),
-    );
-
-    process.stdout.write(output);
-  }
-}

package/src/cli/commands/status.ts

@@ -1,18 +0,0 @@
-import { Command } from "@oclif/core";
-
-import { formatSyncStatusResult } from "#app/cli/sync-output.ts";
-import { createSyncContext } from "#app/services/runtime.ts";
-import { getSyncStatus } from "#app/services/status.ts";
-
-export default class SyncStatus extends Command {
-  public static override summary =
-    "Show planned push and pull changes for the current sync config";
-
-  public override async run(): Promise<void> {
-    const output = formatSyncStatusResult(
-      await getSyncStatus(createSyncContext()),
-    );
-
-    process.stdout.write(output);
-  }
-}

package/src/cli/sync-output.test.ts

@@ -1,173 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import {
-  formatSyncAddResult,
-  formatSyncDoctorResult,
-  formatSyncForgetResult,
-  formatSyncInitResult,
-  formatSyncListResult,
-  formatSyncPullResult,
-  formatSyncPushResult,
-  formatSyncSetResult,
-  formatSyncStatusResult,
-} from "#app/cli/sync-output.ts";
-
-describe("sync output formatting", () => {
-  it("formats init results for cloned repositories", () => {
-    expect(
-      formatSyncInitResult({
-        alreadyInitialized: false,
-        configPath: "/tmp/sync/config.json",
-        entryCount: 2,
-        generatedIdentity: true,
-        gitAction: "cloned",
-        gitSource: "/tmp/remote",
-        identityFile: "/tmp/xdg/devsync/age/keys.txt",
-        recipientCount: 3,
-        ruleCount: 4,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toBe(
-      [
-        "Initialized sync directory.",
-        "Sync directory: /tmp/sync",
-        "Config file: /tmp/sync/config.json",
-        "Age identity file: /tmp/xdg/devsync/age/keys.txt",
-        "Git repository: cloned from /tmp/remote",
-        "Age bootstrap: generated a new local identity.",
-        "Summary: 3 recipients, 2 entries, 4 rules.",
-        "",
-      ].join("\n"),
-    );
-  });
-
-  it("formats add, forget, and set results", () => {
-    expect(
-      formatSyncAddResult({
-        alreadyTracked: false,
-        configPath: "/tmp/sync/config.json",
-        kind: "file",
-        localPath: "/tmp/home/.zshrc",
-        mode: "secret",
-        repoPath: ".zshrc",
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("Added sync target.\n");
-    expect(
-      formatSyncForgetResult({
-        configPath: "/tmp/sync/config.json",
-        localPath: "/tmp/home/.zshrc",
-        plainArtifactCount: 1,
-        repoPath: ".zshrc",
-        secretArtifactCount: 2,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("Removed repo artifacts: 1 plain, 2 secret.\n");
-    expect(
-      formatSyncSetResult({
-        action: "updated",
-        configPath: "/tmp/sync/config.json",
-        entryRepoPath: "bundle",
-        localPath: "/tmp/home/bundle/private.json",
-        mode: "ignore",
-        repoPath: "bundle/private.json",
-        scope: "exact",
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("Scope: exact rule\nAction: updated\n");
-  });
-
-  it("formats push and pull dry-run summaries", () => {
-    expect(
-      formatSyncPushResult({
-        configPath: "/tmp/sync/config.json",
-        deletedArtifactCount: 4,
-        directoryCount: 1,
-        dryRun: true,
-        encryptedFileCount: 2,
-        plainFileCount: 3,
-        symlinkCount: 1,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("No filesystem changes were made.\n");
-    expect(
-      formatSyncPullResult({
-        configPath: "/tmp/sync/config.json",
-        decryptedFileCount: 2,
-        deletedLocalCount: 5,
-        directoryCount: 1,
-        dryRun: true,
-        plainFileCount: 3,
-        symlinkCount: 1,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain(
-      "local paths would be removed.\nNo filesystem changes were made.\n",
-    );
-  });
-
-  it("formats list, status, and doctor results", () => {
-    expect(
-      formatSyncListResult({
-        configPath: "/tmp/sync/config.json",
-        entries: [
-          {
-            kind: "directory",
-            localPath: "/tmp/home/.config/tool",
-            mode: "normal",
-            name: ".config/tool",
-            overrides: [{ mode: "secret", selector: "token.json" }],
-            repoPath: ".config/tool",
-          },
-        ],
-        recipientCount: 1,
-        ruleCount: 1,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("override token.json: secret\n");
-    expect(
-      formatSyncStatusResult({
-        configPath: "/tmp/sync/config.json",
-        entryCount: 1,
-        pull: {
-          configPath: "/tmp/sync/config.json",
-          decryptedFileCount: 1,
-          deletedLocalCount: 2,
-          directoryCount: 1,
-          dryRun: true,
-          plainFileCount: 0,
-          preview: ["bundle", "bundle/token.txt"],
-          symlinkCount: 0,
-          syncDirectory: "/tmp/sync",
-        },
-        push: {
-          configPath: "/tmp/sync/config.json",
-          deletedArtifactCount: 1,
-          directoryCount: 1,
-          dryRun: true,
-          encryptedFileCount: 1,
-          plainFileCount: 0,
-          preview: ["bundle", "bundle/token.txt"],
-          symlinkCount: 0,
-          syncDirectory: "/tmp/sync",
-        },
-        recipientCount: 1,
-        ruleCount: 0,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("Push preview: bundle, bundle/token.txt\n");
-    expect(
-      formatSyncDoctorResult({
-        checks: [
-          { detail: "ok", level: "ok", name: "git" },
-          { detail: "warn", level: "warn", name: "entries" },
-          { detail: "fail", level: "fail", name: "age" },
-        ],
-        configPath: "/tmp/sync/config.json",
-        hasFailures: true,
-        hasWarnings: true,
-        syncDirectory: "/tmp/sync",
-      }),
-    ).toContain("Summary: 1 ok, 1 warnings, 1 failures.\n");
-  });
-});

package/src/cli/sync-output.ts

@@ -1,200 +0,0 @@
-import { ensureTrailingNewline } from "#app/lib/string.ts";
-import type { SyncAddResult } from "#app/services/add.ts";
-import type { SyncDoctorResult } from "#app/services/doctor.ts";
-import type { SyncForgetResult } from "#app/services/forget.ts";
-import type { SyncInitResult } from "#app/services/init.ts";
-import type { SyncListResult } from "#app/services/list.ts";
-import type { SyncPullResult } from "#app/services/pull.ts";
-import type { SyncPushResult } from "#app/services/push.ts";
-import type { SyncSetResult } from "#app/services/set.ts";
-import type { SyncStatusResult } from "#app/services/status.ts";
-
-export const formatSyncInitResult = (result: SyncInitResult) => {
-  const lines = [
-    result.alreadyInitialized
-      ? "Sync directory already initialized."
-      : "Initialized sync directory.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Age identity file: ${result.identityFile}`,
-    (() => {
-      switch (result.gitAction) {
-        case "cloned":
-          return `Git repository: cloned from ${result.gitSource}`;
-        case "initialized":
-          return "Git repository: initialized new repository";
-        default:
-          return "Git repository: using existing repository";
-      }
-    })(),
-    ...(result.generatedIdentity
-      ? ["Age bootstrap: generated a new local identity."]
-      : []),
-    `Summary: ${result.recipientCount} recipients, ${result.entryCount} entries, ${result.ruleCount} rules.`,
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncAddResult = (result: SyncAddResult) => {
-  const lines = [
-    result.alreadyTracked
-      ? "Sync target already tracked."
-      : "Added sync target.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Local path: ${result.localPath}`,
-    `Repository path: ${result.repoPath}`,
-    `Kind: ${result.kind}`,
-    `Mode: ${result.mode}`,
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncForgetResult = (result: SyncForgetResult) => {
-  const lines = [
-    "Forgot sync target.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Local path: ${result.localPath}`,
-    `Repository path: ${result.repoPath}`,
-    `Removed repo artifacts: ${result.plainArtifactCount} plain, ${result.secretArtifactCount} secret.`,
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-const formatSetScope = (scope: SyncSetResult["scope"]) => {
-  switch (scope) {
-    case "default":
-      return "entry default";
-    case "subtree":
-      return "subtree rule";
-    default:
-      return "exact rule";
-  }
-};
-
-export const formatSyncSetResult = (result: SyncSetResult) => {
-  const lines = [
-    result.action === "unchanged"
-      ? "Sync mode unchanged."
-      : "Updated sync mode.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Owning entry: ${result.entryRepoPath}`,
-    `Target repository path: ${result.repoPath}`,
-    `Mode: ${result.mode}`,
-    `Scope: ${formatSetScope(result.scope)}`,
-    `Action: ${result.action}`,
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncPushResult = (result: SyncPushResult) => {
-  const lines = result.dryRun
-    ? [
-        "Dry run for sync push.",
-        `Sync directory: ${result.syncDirectory}`,
-        `Config file: ${result.configPath}`,
-        `Summary: ${result.plainFileCount} plain files, ${result.encryptedFileCount} encrypted files, ${result.symlinkCount} symlinks, ${result.directoryCount} directory roots, ${result.deletedArtifactCount} stale repository artifacts would be removed.`,
-        "No filesystem changes were made.",
-      ]
-    : [
-        "Synchronized local config into the sync repository.",
-        `Sync directory: ${result.syncDirectory}`,
-        `Config file: ${result.configPath}`,
-        `Summary: ${result.plainFileCount} plain files, ${result.encryptedFileCount} encrypted files, ${result.symlinkCount} symlinks, ${result.directoryCount} directory roots, ${result.deletedArtifactCount} stale repository artifacts removed.`,
-      ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncPullResult = (result: SyncPullResult) => {
-  const lines = result.dryRun
-    ? [
-        "Dry run for sync pull.",
-        `Sync directory: ${result.syncDirectory}`,
-        `Config file: ${result.configPath}`,
-        `Summary: ${result.plainFileCount} plain files, ${result.decryptedFileCount} decrypted files, ${result.symlinkCount} symlinks, ${result.directoryCount} directory roots, ${result.deletedLocalCount} local paths would be removed.`,
-        "No filesystem changes were made.",
-      ]
-    : [
-        "Applied sync repository to local config.",
-        `Sync directory: ${result.syncDirectory}`,
-        `Config file: ${result.configPath}`,
-        `Summary: ${result.plainFileCount} plain files, ${result.decryptedFileCount} decrypted files, ${result.symlinkCount} symlinks, ${result.directoryCount} directory roots, ${result.deletedLocalCount} local paths removed.`,
-      ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncListResult = (result: SyncListResult) => {
-  const lines = [
-    "Tracked sync configuration.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Summary: ${result.recipientCount} recipients, ${result.entries.length} entries, ${result.ruleCount} rules.`,
-    ...(result.entries.length === 0
-      ? ["Entries: none"]
-      : result.entries.flatMap((entry) => {
-          return [
-            `- ${entry.repoPath} [${entry.kind}, ${entry.mode}] -> ${entry.localPath}`,
-            ...(entry.overrides.length === 0
-              ? []
-              : entry.overrides.map((override) => {
-                  return `  override ${override.selector}: ${override.mode}`;
-                })),
-          ];
-        })),
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncStatusResult = (result: SyncStatusResult) => {
-  const lines = [
-    "Sync status overview.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Summary: ${result.recipientCount} recipients, ${result.entryCount} entries, ${result.ruleCount} rules.`,
-    `Push plan: ${result.push.plainFileCount} plain files, ${result.push.encryptedFileCount} encrypted files, ${result.push.symlinkCount} symlinks, ${result.push.directoryCount} directory roots, ${result.push.deletedArtifactCount} stale repository artifacts.`,
-    ...(result.push.preview.length === 0
-      ? ["Push preview: no tracked paths"]
-      : [`Push preview: ${result.push.preview.join(", ")}`]),
-    `Pull plan: ${result.pull.plainFileCount} plain files, ${result.pull.decryptedFileCount} decrypted files, ${result.pull.symlinkCount} symlinks, ${result.pull.directoryCount} directory roots, ${result.pull.deletedLocalCount} local paths.`,
-    ...(result.pull.preview.length === 0
-      ? ["Pull preview: no tracked paths"]
-      : [`Pull preview: ${result.pull.preview.join(", ")}`]),
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};
-
-export const formatSyncDoctorResult = (result: SyncDoctorResult) => {
-  const counts = result.checks.reduce(
-    (accumulator, check) => {
-      accumulator[check.level] += 1;
-
-      return accumulator;
-    },
-    {
-      fail: 0,
-      ok: 0,
-      warn: 0,
-    },
-  );
-  const lines = [
-    result.hasFailures ? "Sync doctor found issues." : "Sync doctor passed.",
-    `Sync directory: ${result.syncDirectory}`,
-    `Config file: ${result.configPath}`,
-    `Summary: ${counts.ok} ok, ${counts.warn} warnings, ${counts.fail} failures.`,
-    ...result.checks.map((check) => {
-      return `[${check.level.toUpperCase()}] ${check.name}: ${check.detail}`;
-    }),
-  ];
-
-  return ensureTrailingNewline(lines.join("\n"));
-};