@eudiplo/cli 7.1.1 → 7.2.0-main.20c3901

package/README.md

@@ -1,7 +1,7 @@
 # EUDIPLO CLI
 
 The EUDIPLO CLI provides deployment-neutral commands for inspecting an EUDIPLO
-instance and deployment-driver commands for local Docker Compose demos.
+instance and deployment-driver commands for local Compose demos.
 
 For installation, command reference, configuration validation, standalone
 releases, and local development, see the [CLI documentation](../../docs/getting-started/cli.md).
@@ -9,34 +9,39 @@ releases, and local development, see the [CLI documentation](../../docs/getting-
 ## Quick Start
 
 This package is the npm distribution of the **EUDIPLO CLI** and requires
-Node.js 22+.
+Node.js 22.12+.
 
 For users who do not want a local Node.js dependency, use the standalone CLI
 installer instead: `curl -fsSL https://eudiplo.dev/install.sh | bash`
 
 ```bash
-npx @eudiplo/cli demo
+npx @eudiplo/cli demo ./eudiplo-demo
 npx @eudiplo/cli instance add production --url https://eudiplo.example.com
+npx @eudiplo/cli instance ls
+npx @eudiplo/cli instance show production
+npx @eudiplo/cli instance use production
 npx @eudiplo/cli doctor --instance production
 ```
 
 `demo` creates a local editable demo deployment, writes `.eudiplo.demo.env`,
-copies canonical demo configuration into `.eudiplo/demo-config`, and starts the
-`compose` driver.
+copies canonical demo configuration into `config/demo`, and starts the
+minimal `compose` stack. It always uses SQLite, local file storage,
+database-backed key management, the backend, and the web client.
 
 - Backend image: `ghcr.io/openwallet-foundation/eudiplo:<tag>`
 - Client image: `ghcr.io/openwallet-foundation/eudiplo-client:<tag>`
 
-Tag selection defaults to the CLI version. For prerelease versions containing
-`-main.`, the CLI uses the `main` tag for both images. Use `--image-tag` (or
-`EUDIPLO_IMAGE_TAG`) to override.
+Tag selection defaults to `latest` for both images. Use `--image-tag` (or
+`EUDIPLO_IMAGE_TAG`) to select `main`, a release tag, or an immutable SHA tag.
 
 The generated demo config remains editable after creation. Existing files are
 preserved unless you pass `--force`.
 
 The standalone CLI and this npm package are two distributions of the same
 `eudiplo` command. The standalone CLI removes the Node.js requirement, but
-Docker and Docker Compose are still required for the demo deployment.
+Docker and Docker Compose, or Podman and Podman Compose, are still required for
+the demo deployment. Docker is preferred by default; set
+`EUDIPLO_CONTAINER_RUNTIME=podman` to force Podman.
 
 ## Package and Binary Names
 
@@ -52,12 +57,34 @@ pnpm add -D @eudiplo/cli
 pnpm eudiplo status
 ```
 
+## Uninstall
+
+Use the removal path that matches how the CLI was installed:
+
+```bash
+# Standalone Linux/macOS installer
+rm "${EUDIPLO_INSTALL_DIR:-$HOME/.local/bin}/eudiplo"
+
+# npm global install
+npm uninstall -g @eudiplo/cli
+
+# project dependency
+pnpm remove @eudiplo/cli
+```
+
+The CLI stores instance metadata in `~/.eudiplo/config.json` by default. Remove
+`~/.eudiplo` only if you also want to delete local CLI instance registrations.
+
 ## Compose Driver Commands
 
 Compose driver commands require a `compose` instance:
 
 ```bash
-eudiplo init --target compose
+eudiplo init
+eudiplo init ./eudiplo-minimal --preset minimal
+eudiplo init ./eudiplo-standard --preset standard --start
+eudiplo init --database postgres --storage local --kms vault
+eudiplo init --preset standard --demo-tenant
 eudiplo init --target compose --demo
 eudiplo init --target compose --demo --image-tag main
 eudiplo init --target compose --no-client
@@ -67,14 +94,49 @@ eudiplo logs
 eudiplo demo --reset --force
 ```
 
-`init --target compose` writes a local `.eudiplo.env` using Compose defaults.
+In an interactive terminal, `init` opens a wizard for the project directory,
+preset, components, public URL, authentication, client, and startup choices.
+For scripts and CI, the same values can be supplied with `--directory`,
+`--preset`, `--database`, `--storage`, `--kms`, `--public-url`,
+`--auth-client-id`, and `--auth-client-secret`. The directory can also be passed
+positionally. When it is omitted, the wizard suggests `./`; non-interactive and
+`--yes` runs use `./` automatically. Its absolute path is saved with the
+instance, allowing later Compose commands to run from a different working
+directory.
+
+Interactive `demo` runs use the same directory prompt. Pass a positional
+directory, `--directory`, or `--yes` to skip it.
+
+`init --preset minimal` writes a local `.eudiplo.env` using SQLite and local
+storage. `standard` provisions PostgreSQL and MinIO, while `full` additionally
+provisions Vault. Arbitrary combinations are supported through the component
+flags.
+
+Every initialized project contains one mounted `config/` root. Global KMS
+configuration is written to `config/kms.json`, while tenant configuration is
+stored under `config/<tenant-id>/`. The demo tenant is excluded by default and
+can be added with `--demo-tenant`.
+
 `init --target compose --demo` writes demo-specific assets (`.eudiplo.demo.env`
-and `.eudiplo/demo-config`) without starting Docker Compose. Add `--no-client`
+and `config/demo`) without starting the Compose runtime. Add `--no-client`
 to generate a small Compose override that skips the web client container.
 
 `demo --reset --force` stops the managed demo stack, removes managed demo
 volumes, and recreates only CLI-managed demo assets.
 
+## Local Tenant Configuration Commands
+
+```bash
+eudiplo config tenant list
+eudiplo config tenant create acme --name "Acme GmbH"
+eudiplo config tenant create sample --template demo
+eudiplo config tenant remove acme --force
+```
+
+The aliases `ls`, `new`, `rm`, and `delete` are also supported. These commands manage
+local config-import folders only; removing a folder does not delete an already
+imported tenant from a running EUDIPLO instance.
+
 If a driver-specific command is used with an unsupported target, the CLI exits
 with a clear error, for example:
 
@@ -92,10 +154,30 @@ EUDIPLO_CLI_HOME=/tmp/eudiplo-cli eudiplo config validate
 EUDIPLO_CLI_CONFIG=/tmp/eudiplo-cli/config.json eudiplo config validate
 ```
 
+Print the resolved file path or inspect the validated configuration with:
+
+```bash
+eudiplo config path
+eudiplo config show
+eudiplo config show --json
+```
+
 Do not store secrets in the CLI config. Commands that need authenticated API
 access read credentials from environment variables such as `EUDIPLO_CLIENT_ID`
 and `EUDIPLO_CLIENT_SECRET`.
 
+## Shell Completion
+
+The CLI generates completion scripts for Bash, Zsh, Fish, and PowerShell. For
+the current shell session, use one of:
+
+```bash
+source <(eudiplo completion bash)
+source <(eudiplo completion zsh)
+eudiplo completion fish | source
+eudiplo completion powershell | Out-String | Invoke-Expression
+```
+
 ## Single Executable Application
 
 To produce a standalone CLI binary with Node.js SEA support, run:
@@ -142,6 +224,168 @@ running it:
 sha256sum -c SHA256SUMS.txt
 ```
 
-The standalone binary does not replace Docker or Docker Compose. You still need
-Docker to run the local deployment stack, but you do not need a local Node.js
-installation just to use the CLI itself.
+The standalone binary does not replace Docker, Podman, or Compose. You still
+need a container runtime to run the local deployment stack, but you do not need a
+local Node.js installation just to use the CLI itself.
+
+## Developing and Extending the CLI
+
+The CLI uses Commander and an injectable `CommandContext`. Command definitions
+are organized under `src/commands`; `src/runtime.ts` only assembles the command
+tree and connects Commander output and exit handling to the current context.
+
+### Running the CLI locally
+
+Append CLI arguments directly after the `dev` script. `init` is a root command,
+while `config` contains only configuration-related subcommands:
+
+```bash
+pnpm --filter @eudiplo/cli dev init ./eudiplo-local --yes
+pnpm --filter @eudiplo/cli dev config tenant list
+```
+
+Generated Compose projects use `latest` by default and do not derive container
+tags from `apps/cli/package.json`. Select `main` or an immutable SHA explicitly
+when testing changes that require a different backend or client build:
+
+```bash
+pnpm --filter @eudiplo/cli dev demo ./eudiplo-demo --image-tag main
+```
+
+Install the JSON Schemas bundled with the CLI into a VS Code workspace and
+associate them with the local tenant configuration tree:
+
+```bash
+eudiplo config editor setup . --config-directory ./config
+```
+
+The command merges `.vscode/settings.json` without removing unrelated settings
+or JSONC comments and can safely be rerun after a CLI upgrade.
+
+List the complete command tree or render the same reference as Markdown:
+
+```bash
+eudiplo commands
+eudiplo commands --format markdown
+```
+
+The documentation prebuild uses the Markdown renderer directly, keeping the
+published command reference synchronized with Commander definitions.
+
+Use a new project directory or add `--force` when regenerating an existing
+project, because the CLI preserves managed environment files by default. The
+`version` command still reports the CLI package version, but that value is not
+used for container image selection.
+
+```text
+src/
+├── runtime.ts                 # creates the root Commander program
+├── commands/
+│   ├── demo/
+│   │   ├── index.ts           # command registration and options
+│   │   └── action.ts          # demo workflow
+│   ├── init/
+│   │   ├── index.ts           # command registration and wizard options
+│   │   └── action.ts          # initialization workflow
+│   ├── instance/
+│   │   ├── index.ts           # command group and its subcommands
+│   │   └── action.ts          # instance persistence
+│   └── config/
+│       ├── index.ts           # config group
+│       ├── editor/            # VS Code schema setup command module
+│       ├── validate/          # validation command module
+│       └── tenant/            # tenant-config command module
+├── services/
+│   ├── cli-config.ts          # persisted CLI instance configuration
+│   ├── compose-project.ts     # generated Compose assets
+│   ├── deployment-drivers.ts  # Compose and external drivers
+│   └── diagnostics.ts         # deployment health checks
+└── types.ts                   # injectable context and shared CLI types
+```
+
+### Adding a root command
+
+Create a directory for the command with `index.ts` as its public entrypoint and
+`action.ts` for its workflow. Declare arguments, options, validation,
+descriptions, and aliases in `index.ts` so generated help remains the source of
+truth.
+
+```ts
+// commands/example/index.ts
+import { Command } from 'commander';
+import type { CommandContext } from '../../types.js';
+import type { SetExitCode } from '../shared.js';
+import { runExample } from './action.js';
+
+export function createExampleCommand(
+  context: CommandContext,
+  setExitCode: SetExitCode,
+): Command {
+  return new Command('example')
+    .description('Describe what the command does')
+    .requiredOption('--input <path>', 'input file')
+    .action(async (options) => {
+      setExitCode(await runExample(options.input, context));
+    });
+}
+```
+
+```ts
+// commands/example/action.ts
+import type { CommandContext } from '../../types.js';
+
+export async function runExample(
+  input: string,
+  context: CommandContext,
+): Promise<number> {
+  context.stdout.write(`Processing ${input}\n`);
+  return 0;
+}
+```
+
+Register the factory once in `createProgram` in `src/runtime.ts`. Do not add a
+root dispatch switch or manually maintained help text.
+
+### Adding nested commands
+
+Create a parent `Command`, add independently configured child modules with
+`addCommand`, and return the parent from its factory. Each nested command gets
+the same `index.ts` plus `action.ts` structure. `config/tenant` and
+`config/validate` are the reference patterns.
+
+Keep these boundaries when extending the command tree:
+
+- A command module owns its registration, options, action, and command-specific
+  helpers.
+- `services/` is only for infrastructure shared by multiple command modules,
+  such as config persistence, Compose generation, and instance selection.
+- Load CLI state lazily inside actions that require it; help must work without a
+  valid local configuration.
+- Write through `CommandContext.stdout` and `CommandContext.stderr`; do not call
+  `console.log` or `process.exit` from a command.
+- Throw normal errors for operational failures. Let Commander handle unknown
+  options, required arguments, choices, aliases, and contextual help.
+- Prefer a coherent command structure over preserving accidental parser
+  behavior. Document intentional breaking syntax changes in the user guides.
+
+Runtime dependencies are welcome when they materially improve usability or
+maintainability. They must support ESM, Node.js 22.12+, TypeScript, and the
+single-executable bundle. Avoid dependencies that require spawning separate
+subcommand executables, because the released CLI is also packaged as one SEA
+binary.
+
+### Testing a command change
+
+Exercise commands through `runCli(args, context)` so tests cover the real
+Commander tree while keeping output, environment variables, prompts, and
+network access injectable. Add coverage for successful execution, invalid
+arguments or options, and the relevant help level.
+
+Run the complete CLI verification before submitting a change:
+
+```bash
+pnpm --filter @eudiplo/cli test
+pnpm --filter @eudiplo/cli lint
+pnpm --filter @eudiplo/cli build
+pnpm --filter @eudiplo/cli build:sea:bundle
+```

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

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import type { CommandContext } from "../../types.js";
+export declare function createCommandsCommand(context: CommandContext, getProgram: () => Command): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,OAAO,GAC1B,OAAO,CAaT"}

package/dist/commands/commands/index.js

@@ -0,0 +1,13 @@
+import { Command, Option } from "commander";
+import { renderCommandReference, } from "./render.js";
+export function createCommandsCommand(context, getProgram) {
+    return new Command("commands")
+        .description("List every available CLI command")
+        .addOption(new Option("--format <text|markdown>", "output format")
+        .choices(["text", "markdown"])
+        .default("text"))
+        .action((options) => {
+        context.stdout.write(renderCommandReference(getProgram(), options.format));
+    });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAEH,sBAAsB,GACzB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,qBAAqB,CACjC,OAAuB,EACvB,UAAyB;IAEzB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;SACzB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,SAAS,CACN,IAAI,MAAM,CAAC,0BAA0B,EAAE,eAAe,CAAC;SAClD,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;SAC7B,OAAO,CAAC,MAAM,CAAC,CACvB;SACA,MAAM,CAAC,CAAC,OAA2C,EAAE,EAAE;QACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,sBAAsB,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CACvD,CAAC;IACN,CAAC,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/commands/render.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+export type CommandReferenceFormat = "text" | "markdown";
+export declare function renderCommandReference(program: Command, format: CommandReferenceFormat): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/commands/commands/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzD,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,sBAAsB,GAC/B,MAAM,CAIR"}

package/dist/commands/commands/render.js

@@ -0,0 +1,52 @@
+export function renderCommandReference(program, format) {
+    return format === "markdown"
+        ? renderMarkdownReference(program)
+        : renderTextReference(program);
+}
+function renderTextReference(program) {
+    const commands = collectCommands(program).slice(1);
+    const rows = commands.map((command) => ({
+        invocation: usageLine(command),
+        description: command.description(),
+    }));
+    const invocationWidth = Math.max(...rows.map((row) => row.invocation.length));
+    const lines = rows.map((row) => `  ${row.invocation.padEnd(invocationWidth)}  ${row.description}`.trimEnd());
+    return `Available commands:\n\n${lines.join("\n")}\n`;
+}
+function renderMarkdownReference(program) {
+    const sections = collectCommands(program).map((command, index) => {
+        const heading = index === 0
+            ? "# EUDIPLO CLI command reference"
+            : `## \`${commandPath(command)}\``;
+        const description = index === 0
+            ? "Generated from the CLI command definitions. Do not edit this page manually."
+            : command.description();
+        return `${heading}\n\n${description}\n\n\`\`\`text\n${command.helpInformation().trim()}\n\`\`\``;
+    });
+    return `${sections.join("\n\n")}\n`;
+}
+function collectCommands(program) {
+    const commands = [program];
+    for (const child of program.commands) {
+        if (child.name() === "help" ||
+            child._hidden === true) {
+            continue;
+        }
+        commands.push(...collectCommands(child));
+    }
+    return commands;
+}
+function usageLine(command) {
+    const firstLine = command.helpInformation().split("\n", 1)[0];
+    return firstLine.replace(/^Usage:\s*/, "");
+}
+function commandPath(command) {
+    const names = [];
+    let current = command;
+    while (current) {
+        names.unshift(current.name());
+        current = current.parent;
+    }
+    return names.join(" ");
+}
+//# sourceMappingURL=render.js.map

package/dist/commands/commands/render.js.map

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

package/dist/commands/completion/action.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../../types.js";
+export type CompletionShell = "bash" | "zsh" | "fish" | "powershell";
+export declare function runCompletion(shell: CompletionShell, context: CommandContext): number;
+export declare function runCompletionCandidates(root: Command, words: string[], context: CommandContext): number;
+//# sourceMappingURL=action.d.ts.map

package/dist/commands/completion/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;AAErE,wBAAgB,aAAa,CACzB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,GACxB,MAAM,CAGR;AAED,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,cAAc,GACxB,MAAM,CAKR"}

package/dist/commands/completion/action.js

@@ -0,0 +1,133 @@
+export function runCompletion(shell, context) {
+    context.stdout.write(`${completionScript(shell)}\n`);
+    return 0;
+}
+export function runCompletionCandidates(root, words, context) {
+    for (const candidate of completionCandidates(root, words)) {
+        context.stdout.write(`${candidate}\n`);
+    }
+    return 0;
+}
+function completionScript(shell) {
+    switch (shell) {
+        case "bash":
+            return bashCompletion();
+        case "zsh":
+            return zshCompletion();
+        case "fish":
+            return fishCompletion();
+        case "powershell":
+            return powershellCompletion();
+    }
+}
+function completionCandidates(root, words) {
+    let current = root;
+    let skipOptionValue = false;
+    for (const word of words) {
+        if (skipOptionValue) {
+            skipOptionValue = false;
+            continue;
+        }
+        const option = findOption(current, word);
+        if (option) {
+            skipOptionValue = option.required || option.optional;
+            continue;
+        }
+        if (word.startsWith("-")) {
+            continue;
+        }
+        const child = current.commands.find((command) => command.name() === word || command.aliases().includes(word));
+        if (child) {
+            current = child;
+        }
+    }
+    const lastOption = findOption(current, words.at(-1));
+    if (lastOption) {
+        const choices = optionChoices(lastOption);
+        if (choices.length > 0) {
+            return choices;
+        }
+    }
+    const candidates = ["-h", "--help"];
+    for (const command of current.commands) {
+        if (command.name() !== "_complete") {
+            candidates.push(command.name(), ...command.aliases());
+        }
+    }
+    for (const option of current.options) {
+        if (option.short) {
+            candidates.push(option.short);
+        }
+        if (option.long) {
+            candidates.push(option.long);
+        }
+    }
+    if (current.commands.length === 0 && words.at(-1) === current.name()) {
+        candidates.push(...(current.registeredArguments[0]?.argChoices ?? []));
+    }
+    return [...new Set(candidates)];
+}
+function findOption(command, word) {
+    if (!word) {
+        return undefined;
+    }
+    const flag = word.includes("=") ? word.slice(0, word.indexOf("=")) : word;
+    return command.options.find((option) => option.short === flag || option.long === flag);
+}
+function optionChoices(option) {
+    if (option.argChoices) {
+        return option.argChoices;
+    }
+    const placeholder = option.flags.match(/[<[]([^>\]]+)[>\]]/u)?.[1];
+    return placeholder?.includes("|") ? placeholder.split("|") : [];
+}
+function bashCompletion() {
+    return [
+        "_eudiplo_completion() {",
+        "    local current candidates",
+        "    local -a args",
+        '    current="${COMP_WORDS[COMP_CWORD]}"',
+        '    args=("${COMP_WORDS[@]:1:$((COMP_CWORD - 1))}")',
+        '    candidates="$(eudiplo _complete "${args[@]}" 2>/dev/null)"',
+        '    COMPREPLY=($(compgen -W "$candidates" -- "$current"))',
+        "}",
+        "complete -F _eudiplo_completion eudiplo",
+    ].join("\n");
+}
+function zshCompletion() {
+    return [
+        "#compdef eudiplo",
+        "_eudiplo() {",
+        "    local -a args candidates",
+        '    args=("${words[@]:2:$((CURRENT - 2))}")',
+        '    candidates=("${(@f)$(eudiplo _complete "${args[@]}" 2>/dev/null)}")',
+        "    compadd -- $candidates",
+        "}",
+        "compdef _eudiplo eudiplo",
+    ].join("\n");
+}
+function fishCompletion() {
+    return [
+        "function __eudiplo_candidates",
+        "    set -l tokens (commandline -opc)",
+        "    set -e tokens[1]",
+        "    eudiplo _complete $tokens 2>/dev/null",
+        "end",
+        "complete -c eudiplo -f -a '(__eudiplo_candidates)'",
+    ].join("\n");
+}
+function powershellCompletion() {
+    return [
+        "Register-ArgumentCompleter -Native -CommandName eudiplo -ScriptBlock {",
+        "    param($wordToComplete, $commandAst, $cursorPosition)",
+        "    $arguments = @($commandAst.CommandElements | Select-Object -Skip 1 | ForEach-Object { $_.ToString() })",
+        "    if ($wordToComplete -and $arguments.Count -gt 0) {",
+        "        $arguments = @($arguments | Select-Object -First ($arguments.Count - 1))",
+        "    }",
+        "    eudiplo _complete @arguments 2>$null | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {",
+        "        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)",
+        "    }",
+        "}",
+    ].join("\n");
+}
+//# sourceMappingURL=action.js.map

package/dist/commands/completion/action.js.map

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

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

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+import type { CommandContext } from "../../types.js";
+import type { SetExitCode } from "../shared.js";
+export declare function createCompletionCommand(context: CommandContext, setExitCode: SetExitCode): Command;
+export declare function createCompletionCandidatesCommand(context: CommandContext, setExitCode: SetExitCode): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/completion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAqB,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,WAAW,GACzB,OAAO,CAWT;AAED,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,WAAW,GACzB,OAAO,CAUT"}

package/dist/commands/completion/index.js

@@ -0,0 +1,23 @@
+import { Argument, Command } from "commander";
+import { runCompletion, runCompletionCandidates, } from "./action.js";
+const supportedShells = ["bash", "zsh", "fish", "powershell"];
+export function createCompletionCommand(context, setExitCode) {
+    return new Command("completion")
+        .description("Generate shell completion scripts")
+        .addArgument(new Argument("<shell>", "shell to generate completion for").choices(supportedShells))
+        .action((shell) => {
+        setExitCode(runCompletion(shell, context));
+    });
+}
+export function createCompletionCandidatesCommand(context, setExitCode) {
+    return new Command("_complete")
+        .argument("[words...]")
+        .allowUnknownOption(true)
+        .action((words, _options, command) => {
+        if (!command.parent) {
+            throw new Error("Completion command is not attached to the CLI root.");
+        }
+        setExitCode(runCompletionCandidates(command.parent, words, context));
+    });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/completion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAqB,MAAM,WAAW,CAAC;AAGjE,OAAO,EACH,aAAa,EACb,uBAAuB,GAE1B,MAAM,aAAa,CAAC;AAErB,MAAM,eAAe,GAAsB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAEjF,MAAM,UAAU,uBAAuB,CACnC,OAAuB,EACvB,WAAwB;IAExB,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;SAC3B,WAAW,CAAC,mCAAmC,CAAC;SAChD,WAAW,CACR,IAAI,QAAQ,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAC,OAAO,CAC/D,eAAe,CAClB,CACJ;SACA,MAAM,CAAC,CAAC,KAAsB,EAAE,EAAE;QAC/B,WAAW,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC7C,OAAuB,EACvB,WAAwB;IAExB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;SAC1B,QAAQ,CAAC,YAAY,CAAC;SACtB,kBAAkB,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,KAAe,EAAE,QAAsB,EAAE,OAAgB,EAAE,EAAE;QAClE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC3E,CAAC;QACD,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/config/action.d.ts

@@ -0,0 +1,4 @@
+import type { CliConfig, CommandContext } from "../../types.js";
+export declare function runConfigPath(context: CommandContext): number;
+export declare function runConfigShow(configPath: string, config: CliConfig, json: boolean, context: CommandContext): number;
+//# sourceMappingURL=action.d.ts.map

package/dist/commands/config/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/config/action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAEhF,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAG7D;AAED,wBAAgB,aAAa,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACxB,MAAM,CAuBR"}