Bash Refactor State 3

Related plan: Bash Refactor Plan 3

---

• Task 1 — Register forge-bash in librechat.yaml
• Task 2 — Update FORGE.md
  • Remove PERMISSION RULE paragraph
  • Remove project session workflow step 2 (shell-permissions.yaml)
  • Replace uvilo-shell MCP server instructions with forge-bash
  • Update other uvilo-shell references
• Task 3 — Update /end-session Command
  • Remove shell-permissions commit step from commands.md
  • Check referenced skill files for shell-permissions references
• Task 4 — Write TypeScript Migration Evaluation
  • Create Bash_Refactor_TS_Migration_Evaluation.md
  • Add sidebar entry
  • Build to verify
• Task 5 — Update Project Research Skill
  • Replace append-only rule with “no historical residue” rule
• Task 6 — Verify No Stale References Remain
  • grep for ‘PERMISSION REQUIRED’
  • grep for ‘shell-permissions’
  • grep for ‘grant.*parameter’
  • Clean up any disallowed hits
  • Commit, build, push

---

Evaluation — Plan 3

#	Type	Description	Status	Disposition
E1	Defect	Forge/Configs/LibreChat_Service/librechat.yaml has no forge-bash entry — only the debian copy was updated.	🟢 Resolved	Reject — only Configs-debian is in scope
E2	Defect	Both librechat.yaml files still have uvilo-shell entry with permission-language serverInstructions.	🟢 Resolved	Reject — language needed for uvilo-shell to remain functional
E3	Gap	AGENTS.md still references uvilo-shell.py and shell-permissions.yaml in Knowledge section.	🟢 Resolved	Update — Knowledge section removed
E4	Gap	README.md still says “Refactor the uvilo-shell MCP server…” without mentioning forge-bash.	🟢 Resolved	Update — README updated
E5	Gap	Forge/Configs-debian/FORGE.md missing Update_Infrastructure from Skills list.	🟢 Resolved	Update — Skills list synced
E6	Variance	Stale references in Forge_Optimizer asset and archived Plan Shell doc.	🟢 Resolved	Reject — archived is always out of scope
E7	Variance	uvilo-shell.py source files still exist in both Configs directories.	🟢 Resolved	Reject — intentional per Plan Task 1