fix: address review comments (doc pipe escaping, chained integration test)

Agent-Logs-Url: https://github.com/crypto-vincent/cli-kiss/sessions/43b1d432-423c-4a04-817c-5c3dafc4386e

Co-authored-by: crypto-vincent <106254129+crypto-vincent@users.noreply.github.com>

Author: Copilot

docs/guide/06_run_as_cli.md

@@ -158,7 +158,7 @@ This adds two hidden flags:
 
 | Flag                          | Description                                                              |
 | ----------------------------- | ------------------------------------------------------------------------ |
-| `--completion [bash\|zsh\|fish]` | Prints a shell completion script; source it in your shell init file   |
+| `--completion [bash|zsh|fish]`  | Prints a shell completion script; source it in your shell init file       |
 | `--get-completions -- <args>` | Returns one completion per line for the given typed args (used by scripts) |
 
 ### Install the completion script

tests/unit.completion.ts

@@ -236,6 +236,22 @@ it("runAndExit completion", async function () {
   // --get-completions with partial/unknown input does not produce a parse error
   await testGetCompletionsRun(["--invalid-partial"], [], []);
 
+  // --get-completions for a commandChained root: options from both stages are present
+  const chainedRoot = commandChained(
+    { description: "Chained root" },
+    operation(
+      { options: { dbg: optionFlag({ long: "dbg" }) }, positionals: [] },
+      async (ctx) => ctx,
+    ),
+    buildCmd,
+  );
+  await testGetCompletionsRunWith(
+    chainedRoot,
+    [],
+    ["--dbg", "--verbose", "--output"],
+    [],
+  );
+
   // completionSetup not enabled → --completion is an unknown option → exit 1
   await testCompletionDisabled();
 });
@@ -269,6 +285,20 @@ async function testGetCompletionsRun(
   completedArgs: Array<string>,
   expectedToContain: Array<string>,
   expectedNotToContain: Array<string>,
+) {
+  await testGetCompletionsRunWith(
+    rootCommand,
+    completedArgs,
+    expectedToContain,
+    expectedNotToContain,
+  );
+}
+
+async function testGetCompletionsRunWith(
+  cmd: Parameters<typeof runAndExit>[3],
+  completedArgs: Array<string>,
+  expectedToContain: Array<string>,
+  expectedNotToContain: Array<string>,
 ) {
   const onLogStdOut = makeMocked<string, void>(
     Array(100).fill(null as unknown as void),
@@ -281,7 +311,7 @@ async function testGetCompletionsRun(
     "my-cli",
     ["--get-completions", "--", ...completedArgs],
     null,
-    rootCommand,
+    cmd,
     {
       completionSetup: "flag",
       buildVersion: "1.0.0",