@forceuser/git-profile-switcher 0.1.4

package/dist/runtime/cli/completion.js

@@ -0,0 +1,142 @@
+import { getHelpCommandFlags, getHelpCommandNames } from "#cli/help";
+import { PROFILE_PROMPT_COLORS } from "#profiles/types";
+const COMMANDS = getHelpCommandNames();
+const GLOBAL_FLAGS = ["--help"];
+const SHELLS = ["bash", "fish", "zsh"];
+const PROMPT_FORMATS = ["auto", "identity", "profile"];
+const PROMPT_COLOR_CLEAR_VALUES = ["no-color", "none", "default"];
+const INSTALL_GROUPS = ["all", "completion", "prompt", "shell"];
+export function generateCompletionScript(shell) {
+    if (shell === "bash") {
+        return `# git-profile-switcher bash completion
+_gip_completion() {
+  local suggestions
+  suggestions="$(gip __complete --shell bash -- "\${COMP_WORDS[@]:1}")"
+  COMPREPLY=($(compgen -W "$suggestions" -- "\${COMP_WORDS[COMP_CWORD]}"))
+}
+complete -F _gip_completion gip git-profile-switcher
+`;
+    }
+    if (shell === "fish") {
+        return `# git-profile-switcher fish completion
+complete -c gip -f -a '(gip __complete --shell fish -- (commandline -opc)[2..-1])'
+complete -c git-profile-switcher -f -a '(git-profile-switcher __complete --shell fish -- (commandline -opc)[2..-1])'
+`;
+    }
+    return `#compdef gip git-profile-switcher
+# git-profile-switcher zsh completion
+_gip() {
+  local -a suggestions
+  suggestions=("\${(@f)$(gip __complete --shell zsh -- \${words[@]:1})}")
+  compadd -- "\${suggestions[@]}"
+}
+compdef _gip gip git-profile-switcher
+`;
+}
+export async function buildCompletionSuggestions(runtime, words) {
+    const rawCommand = words[0];
+    const command = normalizeCompletionCommand(rawCommand);
+    if (!rawCommand || !isKnownCommand(command)) {
+        return uniqueSorted([...COMMANDS, ...GLOBAL_FLAGS]);
+    }
+    if (words.includes("--")) {
+        return [];
+    }
+    const valueFlag = findValueFlagNeedingCompletion(words);
+    if (valueFlag) {
+        return completeFlagValue(command, valueFlag);
+    }
+    const positionalWords = words.slice(1).filter((word) => !word.startsWith("-"));
+    const positionalSuggestions = await completePositionalValue(runtime, command, positionalWords);
+    if (positionalSuggestions.length > 0) {
+        return uniqueSorted(positionalSuggestions);
+    }
+    return uniqueSorted([...getHelpCommandFlags(command), ...GLOBAL_FLAGS]);
+}
+function normalizeCompletionCommand(command) {
+    return command;
+}
+async function completePositionalValue(runtime, command, positionalWords) {
+    if (!command) {
+        return [];
+    }
+    if (command === "install") {
+        if (positionalWords.length <= 1) {
+            return [...INSTALL_GROUPS, ...SHELLS];
+        }
+        if (INSTALL_GROUPS.includes(positionalWords[0])) {
+            return positionalWords.length === 2 ? [...SHELLS] : [];
+        }
+        return [];
+    }
+    if (command === "completion" ||
+        command === "install:all" ||
+        command === "install:completion" ||
+        command === "install:prompt" ||
+        command === "install:shell" ||
+        command === "uninstall:all" ||
+        command === "uninstall:completion" ||
+        command === "uninstall:prompt" ||
+        command === "uninstall:shell" ||
+        command === "update") {
+        return positionalWords.length <= 1 ? [...SHELLS] : [];
+    }
+    if (command === "use" || command === "now" || command === "profile:remove") {
+        return positionalWords.length <= 1 ? completeProfiles(runtime) : [];
+    }
+    if (command === "profile:color") {
+        if (positionalWords.length <= 1) {
+            return completeProfiles(runtime);
+        }
+        if (positionalWords.length === 2) {
+            return [...PROMPT_COLOR_CLEAR_VALUES, ...PROFILE_PROMPT_COLORS];
+        }
+        return [];
+    }
+    if (command === "rule:add") {
+        return positionalWords.length <= 1 ? completeProfiles(runtime) : [];
+    }
+    if (command === "rule:remove") {
+        return positionalWords.length <= 1 ? completeRules(runtime) : [];
+    }
+    return [];
+}
+function completeFlagValue(command, flag) {
+    if (!command) {
+        return [];
+    }
+    if (flag === "--format" &&
+        (command === "prompt" ||
+            command === "install" ||
+            command === "install:all" ||
+            command === "install:prompt" ||
+            command === "update")) {
+        return [...PROMPT_FORMATS];
+    }
+    if (flag === "--shell") {
+        return [...SHELLS];
+    }
+    return [];
+}
+async function completeProfiles(runtime) {
+    const data = await runtime.repository.read();
+    return data.profiles.map((profile) => profile.name);
+}
+async function completeRules(runtime) {
+    const data = await runtime.repository.read();
+    return data.rules.map((rule) => rule.id);
+}
+function findValueFlagNeedingCompletion(words) {
+    const previous = words.at(-2);
+    const current = words.at(-1);
+    if (previous?.startsWith("--") && !current?.startsWith("-")) {
+        return previous;
+    }
+    return null;
+}
+function isKnownCommand(command) {
+    return Boolean(command && (COMMANDS.includes(command) || command === "__complete"));
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}

package/dist/runtime/cli/help.js

@@ -0,0 +1,288 @@
+export const COMMANDS = [
+    {
+        name: "profile:add",
+        summary: "Create or update a Git identity profile.",
+        usage: "gip profile:add [profile] [--user-name <name>] [--user-email <email>]",
+        completionFlags: ["--user-name", "--user-email", "--help"],
+        examples: [
+            "gip profile:add",
+            'gip profile:add work --user-name "Work Name" --user-email work@example.com',
+            'gip profile:add personal --user-name "Personal Name" --user-email me@example.com',
+        ],
+    },
+    {
+        name: "profile:list",
+        summary: "List saved Git identity profiles.",
+        usage: "gip profile:list [--json]",
+        completionFlags: ["--json", "--help"],
+        examples: ["gip profile:list", "gip profile:list --json"],
+    },
+    {
+        name: "profile:remove",
+        summary: "Remove a profile and its directory rules.",
+        usage: "gip profile:remove <profile>",
+        completionFlags: ["--help"],
+        examples: ["gip profile:remove old-work"],
+    },
+    {
+        name: "profile:color",
+        summary: "Set or clear the shell prompt color for a profile.",
+        usage: "gip profile:color [profile] [color|no-color]",
+        completionFlags: ["--help"],
+        examples: [
+            "gip profile:color",
+            "gip profile:color work cyan",
+            "gip profile:color work no-color",
+        ],
+    },
+    {
+        name: "rule:add",
+        summary: "Map a profile to a directory tree.",
+        usage: "gip rule:add [profile] [directory]",
+        completionFlags: ["--help"],
+        examples: [
+            "gip rule:add",
+            "gip rule:add ~/Developer/Work",
+            "gip rule:add work ~/Developer/Work",
+            "gip apply",
+        ],
+    },
+    {
+        name: "rule:list",
+        summary: "List directory rules.",
+        usage: "gip rule:list [--json]",
+        completionFlags: ["--json", "--help"],
+        examples: ["gip rule:list"],
+    },
+    {
+        name: "rule:remove",
+        summary: "Remove a directory rule.",
+        usage: "gip rule:remove <rule-id>",
+        completionFlags: ["--help"],
+        examples: ["gip rule:remove rule_abc123"],
+    },
+    {
+        name: "use",
+        summary: "Assign a profile to the current directory and apply Git config.",
+        usage: "gip use [profile] [directory] [--global|-g]",
+        completionFlags: ["--global", "-g", "--help"],
+        examples: [
+            "gip use",
+            "gip use work",
+            "gip use personal ~/Developer/personal-app",
+            "gip use work --global",
+            "gip use -g",
+        ],
+    },
+    {
+        name: "now",
+        summary: "Use a profile only in the current shell session.",
+        usage: "gip now [profile] [--clear] [--exports] [--shell <zsh|bash|fish>]",
+        completionFlags: ["--clear", "--exports", "--shell", "--help"],
+        examples: [
+            "gip now work",
+            "gip now --clear",
+            'eval "$(gip now work --exports)"',
+            "gip now work --exports --shell fish",
+        ],
+    },
+    {
+        name: "clear",
+        summary: "Clear a directory profile rule or the global Git identity.",
+        usage: "gip clear [directory] [--global|-g]",
+        completionFlags: ["--global", "-g", "--help"],
+        examples: ["gip clear", "gip clear ~/Developer/Work", "gip clear --global", "gip clear -g"],
+    },
+    {
+        name: "apply",
+        summary: "Write generated profile gitconfigs and the managed includeIf block.",
+        usage: "gip apply",
+        completionFlags: ["--help"],
+        examples: ["gip apply"],
+    },
+    {
+        name: "export",
+        summary: "Export profiles and directory rules for migration.",
+        usage: "gip export [--output <path>] [--profiles-only]\n  gip export <path>",
+        completionFlags: ["--output", "--profiles-only", "--help"],
+        examples: [
+            "gip export",
+            "gip export --profiles-only",
+            "gip export --output ./gip-profiles.backup.json",
+            "gip export ./gip.json",
+        ],
+    },
+    {
+        name: "import",
+        summary: "Import profiles and directory rules from a migration file.",
+        usage: "gip import [--input <path>] [--replace] [--profiles-only] [--no-apply]\n  gip import <path>",
+        completionFlags: ["--input", "--replace", "--profiles-only", "--no-apply", "--help"],
+        examples: [
+            "gip import",
+            "gip import --input ./gip-profiles.backup.json",
+            "gip import --profiles-only",
+            "gip import ./gip.json --replace",
+            "gip import ./gip.json --no-apply",
+        ],
+    },
+    {
+        name: "doctor",
+        summary: "Explain the effective identity for a directory.",
+        usage: "gip doctor [cwd] [--json]",
+        completionFlags: ["--json", "--help"],
+        examples: ["gip doctor", "gip doctor ~/Developer/Work/app --json"],
+    },
+    {
+        name: "prompt",
+        summary: "Print the current Git identity for shell prompts.",
+        usage: "gip prompt [--json] [--format identity|profile|auto] [--profile]",
+        completionFlags: ["--json", "--format", "--profile", "--help"],
+        examples: [
+            "gip prompt",
+            "gip prompt --format identity",
+            "gip prompt --format profile",
+            "gip prompt --format auto",
+            "gip prompt --profile",
+            "gip prompt --json",
+        ],
+    },
+    {
+        name: "install:prompt",
+        summary: "Install managed shell prompt integration.",
+        usage: "gip install:prompt [zsh|bash|fish] [--format identity|profile|auto] [--profile] [--config <path>]",
+        completionFlags: ["--format", "--profile", "--config", "--help"],
+        examples: [
+            "gip install:prompt zsh",
+            "gip install:prompt zsh --format identity",
+            "gip install:prompt zsh --format profile",
+            "gip install:prompt zsh --format auto",
+        ],
+    },
+    {
+        name: "install:all",
+        summary: "Install all managed shell integrations.",
+        usage: "gip install:all [zsh|bash|fish] [--shell <zsh|bash|fish>] [--config <path>] [--format identity|profile|auto] [--profile]",
+        completionFlags: ["--shell", "--config", "--format", "--profile", "--help"],
+        examples: ["gip install:all zsh", "gip install all zsh", "gip install --shell zsh"],
+    },
+    {
+        name: "install",
+        summary: "Install the package globally and configure shell integrations.",
+        usage: "gip install [zsh|bash|fish] [--shell <zsh|bash|fish>] [--config <path>]\n  gip install <all|completion|shell|prompt> [zsh|bash|fish] [--config <path>]",
+        completionFlags: ["--shell", "--config", "--path", "--format", "--profile", "--help"],
+        examples: [
+            "gip install",
+            "gip install zsh",
+            "gip install all zsh",
+            "gip install completion zsh",
+            "gip install shell zsh",
+        ],
+    },
+    {
+        name: "update",
+        summary: "Update the global package and refresh shell integrations.",
+        usage: "gip update [zsh|bash|fish] [--shell <zsh|bash|fish>] [--config <path>] [--format identity|profile|auto] [--profile]",
+        completionFlags: ["--shell", "--config", "--path", "--format", "--profile", "--help"],
+        examples: ["gip update", "gip update zsh", "gip update --shell zsh"],
+    },
+    {
+        name: "uninstall:prompt",
+        summary: "Remove managed shell prompt integration.",
+        usage: "gip uninstall:prompt [zsh|bash|fish] [--config <path>]",
+        completionFlags: ["--config", "--help"],
+        examples: ["gip uninstall:prompt zsh"],
+    },
+    {
+        name: "completion",
+        summary: "Generate shell completion script.",
+        usage: "gip completion [zsh|bash|fish]",
+        completionFlags: ["--help"],
+        examples: [
+            "gip completion zsh",
+            "gip completion bash",
+            "gip completion fish",
+            "source <(gip completion zsh)",
+        ],
+    },
+    {
+        name: "install:completion",
+        summary: "Install managed shell completion integration.",
+        usage: "gip install:completion [zsh|bash|fish] [--config <path>]",
+        completionFlags: ["--config", "--help"],
+        examples: ["gip install:completion zsh", "gip install:completion fish"],
+    },
+    {
+        name: "install:shell",
+        summary: "Install the managed shell wrapper for session commands.",
+        usage: "gip install:shell [zsh|bash|fish] [--config <path>]",
+        completionFlags: ["--config", "--help"],
+        examples: ["gip install:shell zsh", "gip install shell zsh"],
+    },
+    {
+        name: "uninstall:completion",
+        summary: "Remove managed shell completion integration.",
+        usage: "gip uninstall:completion [zsh|bash|fish] [--config <path>]",
+        completionFlags: ["--config", "--help"],
+        examples: ["gip uninstall:completion zsh"],
+    },
+    {
+        name: "uninstall:shell",
+        summary: "Remove the managed shell wrapper.",
+        usage: "gip uninstall:shell [zsh|bash|fish] [--config <path>]",
+        completionFlags: ["--config", "--help"],
+        examples: ["gip uninstall:shell zsh"],
+    },
+    {
+        name: "uninstall:all",
+        summary: "Remove all managed shell integrations.",
+        usage: "gip uninstall:all [zsh|bash|fish] [--shell <zsh|bash|fish>] [--config <path>]",
+        completionFlags: ["--shell", "--config", "--help"],
+        examples: ["gip uninstall:all zsh"],
+    },
+    {
+        name: "paths",
+        summary: "Print resolved storage and Git config paths.",
+        usage: "gip paths [--json]",
+        completionFlags: ["--json", "--help"],
+        examples: ["gip paths", "gip paths --json"],
+    },
+    {
+        name: "tui",
+        summary: "Open the terminal UI.",
+        usage: "gip tui",
+        completionFlags: ["--help"],
+        examples: ["gip tui"],
+    },
+];
+export function renderHelp(commandName) {
+    if (commandName) {
+        const command = COMMANDS.find((candidate) => candidate.name === commandName);
+        if (!command) {
+            return `Unknown command: ${commandName}\n\n${renderHelp()}`;
+        }
+        return [
+            `${command.name} - ${command.summary}`,
+            "",
+            `Usage: ${command.usage}`,
+            "",
+            "Examples:",
+            ...command.examples.map((example) => `  ${example}`),
+        ].join("\n");
+    }
+    return [
+        "gip - Git Profile Switcher",
+        "",
+        "Usage: gip <command> [options]",
+        "",
+        "Commands:",
+        ...COMMANDS.map((command) => `  ${command.name.padEnd(18)} ${command.summary}`),
+        "",
+        "Run `gip help <command>` for command details.",
+    ].join("\n");
+}
+export function getHelpCommandNames() {
+    return COMMANDS.map((command) => command.name);
+}
+export function getHelpCommandFlags(commandName) {
+    return COMMANDS.find((command) => command.name === commandName)?.completionFlags ?? [];
+}

package/dist/runtime/cli/parse.js

@@ -0,0 +1,41 @@
+export function parseArgs(args) {
+    const positionals = [];
+    const flags = new Map();
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "-h") {
+            flags.set("help", true);
+            continue;
+        }
+        if (arg === "-g") {
+            flags.set("global", true);
+            continue;
+        }
+        if (!arg.startsWith("--")) {
+            positionals.push(arg);
+            continue;
+        }
+        const withoutPrefix = arg.slice(2);
+        const inlineEqualsIndex = withoutPrefix.indexOf("=");
+        if (inlineEqualsIndex >= 0) {
+            flags.set(withoutPrefix.slice(0, inlineEqualsIndex), withoutPrefix.slice(inlineEqualsIndex + 1));
+            continue;
+        }
+        const next = args[index + 1];
+        if (next && !next.startsWith("--")) {
+            flags.set(withoutPrefix, next);
+            index += 1;
+        }
+        else {
+            flags.set(withoutPrefix, true);
+        }
+    }
+    return { positionals, flags };
+}
+export function getStringFlag(parsed, name) {
+    const value = parsed.flags.get(name);
+    return typeof value === "string" ? value : null;
+}
+export function hasFlag(parsed, name) {
+    return parsed.flags.get(name) === true;
+}