feat(npm): auto-install shell completion on

New npm postinstall script (scripts/postinstall.js) that runs
after every
changed 2 packages in 2s. It detects
the user's shell from $SHELL (or defaults to PowerShell on
Windows) and installs the right completion script to the
standard auto-load location for that shell:

  bash   -> ~/.local/share/bash-completion/completions/ado
  zsh    -> ~/.zsh/completions/_ado  (+ fpath/compinit in ~/.zshrc)
  fish   -> ~/.config/fish/completions/ado.fish
  pwsh   -> ~/.config/powershell/ado-completion.ps1
           (+ . -source line in $PROFILE)

The script is idempotent: re-running just refreshes the
generated completion (regenerated on every ado upgrade, so
new subcommands get auto-discovered). The zsh/pwsh config
edits check for a marker line and skip if already configured.

Opt out with:
  ADO_NO_COMPLETION=1 npm install -g @gilbertwong1996/ado

For testing, the script honors ADO_BIN env var (point at a
real binary) and falls back to the npm-resolved wrapper.

Bugs fixed in the completion generator along the way:
  - Schema.build_tree/0 returns maps with atom keys; the
    generators used string keys. Added a normalize/1 helper
    that recurses through the tree, converting all keys to
    strings. Without this, the generated scripts had empty
    subcommand lists (matching nothing).
  - Powershell's @ado_top = @("") emitted an empty string
    instead of an empty array. Now emits @() for an empty
    subcommand list.

Tests (scripts/test_postinstall.js, 5 cases):
  - bash detection + XDG path
  - zsh detection + .zshrc config edit
  - fish detection + standard path
  - ADO_NO_COMPLETION=1 skips cleanly
  - Second run is idempotent (no duplicate config lines)

Author: gilbertwong96

.gitignore

@@ -38,3 +38,4 @@ burrito/
 ado.tgz
 # Git worktrees for parallel agent work
 .worktrees/
+node_modules/

lib/ado_cli/cli/completion.ex

@@ -149,6 +149,21 @@ defmodule AdoCli.CLI.Completion do
   @spec default_shell() :: String.t()
   def default_shell, do: @default_shell
 
+  # Schema.build_tree/0 returns a map with atom keys (because
+  # node_to_map/1 builds the result with `Keyword.get` style
+  # implicit keys). The subcommands are nested maps, also with
+  # atom keys. For our string-keyed access below, normalize
+  # each node to have string keys (and recurse into nested maps
+  # and lists).
+  defp normalize(tree) do
+    tree
+    |> Enum.into(%{}, fn {k, v} -> {to_string(k), normalize_value(v)} end)
+  end
+
+  defp normalize_value(v) when is_map(v) and not is_struct(v), do: normalize(v)
+  defp normalize_value(v) when is_list(v), do: Enum.map(v, &normalize/1)
+  defp normalize_value(v), do: v
+
   @doc """
   Returns the full completion script for the given shell.
 
@@ -162,14 +177,13 @@ defmodule AdoCli.CLI.Completion do
   """
   @spec generate(String.t(), map()) :: String.t()
   def generate(shell, tree) do
-    tree = tree || %{}
-    subcommands = tree["subcommands"] || []
+    tree = normalize(tree || %{})
 
     case shell do
-      "bash" -> generate_bash(subcommands)
-      "zsh" -> generate_zsh(subcommands)
-      "fish" -> generate_fish(subcommands)
-      "powershell" -> generate_powershell(subcommands)
+      "bash" -> generate_bash(tree["subcommands"] || [])
+      "zsh" -> generate_zsh(tree["subcommands"] || [])
+      "fish" -> generate_fish(tree["subcommands"] || [])
+      "powershell" -> generate_powershell(tree["subcommands"] || [])
       other -> raise ArgumentError, "Unknown shell: #{other}"
     end
   end
@@ -439,6 +453,12 @@ defmodule AdoCli.CLI.Completion do
     candidates_ps = powershell_candidates_block(flat_list)
     top_names = Enum.map(subcommands, &last_segment(&1["name"] || ""))
 
+    top_array =
+      case top_names do
+        [] -> "@()"
+        names -> "@('" <> Enum.join(names, "', '") <> "')"
+      end
+
     """
     # PowerShell completion for the ado CLI
     # Generated by: ado completion -s powershell
@@ -448,7 +468,7 @@ defmodule AdoCli.CLI.Completion do
     using namespace System.Management.Automation.Language
 
     # Top-level candidates (also the fallback)
-    $ado_top = @('#{Enum.join(top_names, "', '")}')
+    $ado_top = #{top_array}
 
     # Path -> candidates map for nested completion
     # Generated from the CliMate command tree

npm/@gilbertwong1996-ado/package.json

@@ -23,8 +23,12 @@
   "bin": {
     "ado": "bin/ado"
   },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
   "files": [
     "bin/ado",
+    "scripts/postinstall.js",
     "README.md",
     "LICENSE"
   ],