From ae6cb28fb12325540436f2044f00e3c978e12e7d Mon Sep 17 00:00:00 2001
From: "Earl Tankard, Jr., Ph.D"
 <45021016+primetimetank21@users.noreply.github.com>
Date: Fri, 19 Jun 2026 02:30:43 -0400
Subject: [PATCH] docs(plans): strip stale squad-cli content from #468 plan
 (squad-cli dropped in #475)

Resolve D4 decision: remove all 11 squad-cli references from the customizable-install
plan document, including:
- R5 NOTE banner (line 126)
- squad-cli entries in Linux DEFAULT_TOOLS array (line 137)
- squad-cli entries in Windows \\\ array (line 156)
- squad-cli entry in Windows \\\ (line 213)
- squad-cli entries in current order listings (lines 495, 513)
- squad-cli rows in graceful-degradation table (lines 646-654, 661-662)

Updated prose count: "seven run_tool calls" -> "six run_tool calls" (Linux).
Updated front-matter 'updated' field to 2026-06-19.

This is the first WI in the FLAGS-FIRST #468 implementation path (WI-0, doc-only).
Backward-compat neutral: no functional changes, only documentation cleanup.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/plans/468-customizable-install.md | 25 ++++++-------------------
 1 file changed, 6 insertions(+), 19 deletions(-)

diff --git a/docs/plans/468-customizable-install.md b/docs/plans/468-customizable-install.md
index 8f8f8f8..af96eb5 100644
--- a/docs/plans/468-customizable-install.md
+++ b/docs/plans/468-customizable-install.md
@@ -3,7 +3,7 @@ issue: 468
 title: "Customizable install (pick-and-choose tools)"
 status: ready
 created: 2026-05-30
-updated: 2026-06-13
+updated: 2026-06-19
 ---
 
 # Plan: #468 -- Customizable install (pick-and-choose tools)
@@ -123,8 +123,6 @@ Manifest and prompt are explicitly out of scope -- they can layer on top later.
 
 ### Default Order (Linux)
 
-> **NOTE:** squad-cli entries below are stale pending #468 implementation.
-
 ```bash
 DEFAULT_TOOLS=(
   "prereqs"
@@ -134,7 +132,6 @@ DEFAULT_TOOLS=(
   "gh"
   "auth"
   "copilot-cli"
-  "squad-cli"
   "dotfiles"
   "git-hook"
 )
@@ -153,7 +150,6 @@ $DefaultTools = @(
   'vim'
   'psmux'
   'copilot'
-  'squad-cli'
   'dotfiles'
   'profile'
   'git-hook'
@@ -210,7 +206,6 @@ $ToolRegistry = [ordered]@{
     'vim'       = { Install-Vim }
     'psmux'     = { Install-Psmux }
     'copilot'   = { Install-CopilotCli }
-    'squad-cli' = { Install-SquadCli }
     'dotfiles'  = { Install-Dotfiles }
     'profile'   = { Write-PowerShellProfile }
     'git-hook'  = { Install-GitHook }
@@ -492,12 +487,11 @@ nvm
 gh
 auth
 copilot-cli
-squad-cli
 dotfiles
 git-hook
 ```
 
-Linux maps to `install_prerequisites` first, then the seven `run_tool` calls, then the dotfiles block, then git-hook config in `main`.
+Linux maps to `install_prerequisites` first, then the six `run_tool` calls, then the dotfiles block, then git-hook config in `main`.
 
 **Current Windows order** (from `scripts/windows/setup.ps1` `Main` execution):
 ```
@@ -510,7 +504,6 @@ auth
 vim
 psmux
 copilot
-squad-cli
 dotfiles
 profile
 git-hook
@@ -643,23 +636,17 @@ param(
 ### Graceful Degradation
 
 Tools are NOT fully independent. Known chains:
-- `copilot-cli` / `squad-cli` npm-absent behavior **differs by tool and platform** (Verified):
-
-  | Tool | Linux | Windows |
-  |------|-------|---------|
-  | `copilot-cli` | `log_warn` + `exit 0` -- warning, silent skip; run continues | `Write-Warn` + `return` -- warning, non-hard-stop; run continues |
-  | `squad-cli` | `log_warn` + `exit 0` -- warning, silent skip; run continues | `Write-Err` + `exit 1` -- hard stop with PATH/nvm diagnostics |
+- `copilot-cli` npm-absent behavior (Verified):
+  - Linux: `log_warn` + `exit 0` -- warning, silent skip; run continues
+  - Windows: `Write-Warn` + `return` -- warning, non-hard-stop; run continues
 
-  Sources: `scripts/linux/tools/copilot-cli.sh:46-49`, `scripts/linux/tools/squad-cli.sh:41-43`,
-  `scripts/windows/tools/copilot.ps1:47-50`, `scripts/windows/tools/squad-cli.ps1:37-43`.
+  Sources: `scripts/linux/tools/copilot-cli.sh:46-49`, `scripts/windows/tools/copilot.ps1:47-50`.
 
 - `auth` silently skips if `gh` not installed
 
 **npm-absent examples (fresh machine without Node):**
 - `--only=copilot-cli` Linux: `exit 0`, tool non-functional until Node available.
 - `-Only 'copilot'` Windows: `return` (non-hard-stop), tool non-functional until Node available.
-- `--only=squad-cli` Linux: `exit 0`, tool non-functional until Node available.
-- `-Only 'squad-cli'` Windows: `exit 1` (hard stop) -- actionable error guides PATH refresh / nvm troubleshooting.
 
 Documented behavior. Future DAG (out of scope) could warn.