@sebastienrousseau/dotfiles 0.2.499 → 0.2.501

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (567) hide show
  1. package/CHANGELOG.md +452 -0
  2. package/LICENSE +1283 -0
  3. package/README.md +322 -0
  4. package/docs/.vitepress/reports/localization-readability-audit.md +73 -0
  5. package/docs/AI.md +108 -0
  6. package/docs/CNAME +1 -0
  7. package/docs/COPYRIGHT +4 -3
  8. package/docs/NAMING_CONVENTIONS.md +102 -0
  9. package/docs/README.md +82 -0
  10. package/docs/_config.yml +59 -0
  11. package/docs/adr/ADR-001-ci-cd-pipeline.md +118 -0
  12. package/docs/adr/ADR-002-shell-performance.md +130 -0
  13. package/docs/adr/ADR-003-security-first.md +158 -0
  14. package/docs/adr/ADR-004-cli-architecture.md +171 -0
  15. package/docs/adr/ADR-005-chezmoi-choice.md +99 -0
  16. package/docs/adr/ADR-006-shell-selection.md +124 -0
  17. package/docs/adr/ADR-007-multi-shell-parity.md +62 -0
  18. package/docs/adr/ADR-008-alias-system-architecture.md +95 -0
  19. package/docs/adr/ADR-009-wallpaper-driven-theming.md +131 -0
  20. package/docs/adr/ADR-010-starship-transient-prompt.md +144 -0
  21. package/docs/adr/ADR-011-nushell-tier3-keep.md +144 -0
  22. package/docs/adr/README.md +39 -0
  23. package/docs/architecture/ARCHITECTURE.md +117 -0
  24. package/docs/architecture/INTEROP.md +44 -0
  25. package/docs/architecture/REPO_LAYOUT.md +241 -0
  26. package/docs/architecture/WALKTHROUGH.md +86 -0
  27. package/docs/architecture/fleet-deployment.md +77 -0
  28. package/docs/archive/EUXIS_2026_REVIEW.md +127 -0
  29. package/docs/archive/LEGACY_ROADMAP.md +160 -0
  30. package/docs/archive/MILESTONE_v0.2.493.md +47 -0
  31. package/docs/{PLAN.md → archive/PLAN.md} +50 -12
  32. package/docs/archive/REPO_AUDIT.md +31 -0
  33. package/docs/guides/INSTALL.md +144 -0
  34. package/docs/guides/NEOVIM_IDE_GUIDE.md +61 -0
  35. package/docs/guides/THEMING.md +230 -0
  36. package/docs/guides/TROUBLESHOOTING.md +176 -0
  37. package/docs/guides/WSL2_NIX_TROUBLESHOOTING.md +792 -0
  38. package/docs/index.md +43 -0
  39. package/docs/interop/A2A.md +39 -0
  40. package/docs/interop/POWERSHELL.md +102 -0
  41. package/docs/manual/00-introduction.md +89 -0
  42. package/docs/manual/01-concepts/01-architecture.md +138 -0
  43. package/docs/manual/01-concepts/02-trust-model.md +182 -0
  44. package/docs/manual/01-concepts/03-theme-engine.md +186 -0
  45. package/docs/manual/01-concepts/04-fleet.md +148 -0
  46. package/docs/manual/01-concepts/05-self-healing.md +204 -0
  47. package/docs/manual/02-tutorials/01-first-install.md +197 -0
  48. package/docs/manual/02-tutorials/02-add-wallpaper.md +216 -0
  49. package/docs/manual/02-tutorials/03-create-profile.md +244 -0
  50. package/docs/manual/02-tutorials/04-encrypt-secret.md +281 -0
  51. package/docs/manual/02-tutorials/05-deploy-fleet.md +283 -0
  52. package/docs/manual/03-reference/01-dot-cli.md +417 -0
  53. package/docs/manual/03-reference/02-config-files.md +265 -0
  54. package/docs/manual/03-reference/03-environment.md +124 -0
  55. package/docs/manual/03-reference/04-templates.md +190 -0
  56. package/docs/manual/03-reference/05-feature-flags.md +128 -0
  57. package/docs/manual/04-cookbook/01-recipes.md +285 -0
  58. package/docs/manual/04-cookbook/02-troubleshooting.md +351 -0
  59. package/docs/manual/04-cookbook/03-faq.md +175 -0
  60. package/docs/manual/05-appendices/A-platform-matrix.md +101 -0
  61. package/docs/manual/05-appendices/B-security-checklist.md +84 -0
  62. package/docs/manual/05-appendices/C-glossary.md +40 -0
  63. package/docs/manual/05-appendices/D-bibliography.md +58 -0
  64. package/docs/manual/05-appendices/E-license.md +38 -0
  65. package/docs/manual/_toc.yml +58 -0
  66. package/docs/manual/command-index.md +62 -0
  67. package/docs/manual/concept-index.md +168 -0
  68. package/docs/operations/ATTESTATION.md +44 -0
  69. package/docs/operations/CI_CADENCE.md +107 -0
  70. package/docs/operations/CI_COMPOSITES.md +156 -0
  71. package/docs/operations/COMPLETIONS.md +123 -0
  72. package/docs/operations/COVERAGE.md +148 -0
  73. package/docs/operations/DRIFT.md +107 -0
  74. package/docs/operations/MAINTENANCE.md +63 -0
  75. package/docs/operations/MIGRATION.md +109 -0
  76. package/docs/operations/OPERATIONS.md +188 -0
  77. package/docs/operations/PERFORMANCE.md +133 -0
  78. package/docs/operations/RELIABILITY.md +122 -0
  79. package/docs/{ROADMAP.md → operations/ROADMAP.md} +57 -39
  80. package/docs/operations/TESTING.md +199 -0
  81. package/docs/operations/TRACEABILITY.md +35 -0
  82. package/docs/operations/TRUSTED_AGENT_WORKSTATION.md +65 -0
  83. package/docs/operations/VERSION_SYNC.md +393 -0
  84. package/docs/reference/ALIASES.md +131 -0
  85. package/docs/reference/ALIASES_CHEATSHEET.md +32 -0
  86. package/docs/reference/ALIASES_DEPRECATIONS.md +13 -0
  87. package/docs/reference/FEATURES.md +66 -0
  88. package/docs/reference/FONTS.md +112 -0
  89. package/docs/reference/PROFILES.md +69 -0
  90. package/docs/reference/SCREENSHOTS.md +121 -0
  91. package/docs/reference/SCRIPTS.md +71 -0
  92. package/docs/reference/SUPPORT_MATRIX.md +80 -0
  93. package/docs/reference/THEMES.md +117 -0
  94. package/docs/reference/TOOLS.md +109 -0
  95. package/docs/reference/UTILS.md +155 -0
  96. package/docs/security/AI_ACT_COMPLIANCE.md +94 -0
  97. package/docs/security/AUDIT_BYPASS.md +103 -0
  98. package/docs/security/AUTOMATION_SECRETS.md +26 -0
  99. package/docs/security/CI_EGRESS_ALLOWLIST.md +127 -0
  100. package/docs/security/COMPLIANCE.md +458 -0
  101. package/docs/security/DEPS_DEV_EXCEPTIONS.md +86 -0
  102. package/docs/security/ENCRYPTION.md +57 -0
  103. package/docs/security/FMEA.md +159 -0
  104. package/docs/security/HISTORY_FILTERING.md +132 -0
  105. package/docs/security/INCIDENT_RESPONSE.md +579 -0
  106. package/docs/security/INSTALL_VERIFICATION.md +122 -0
  107. package/docs/security/KEYS.md +49 -0
  108. package/docs/security/KEY_ROTATION.md +223 -0
  109. package/docs/security/MCP_POLICY.md +78 -0
  110. package/docs/security/POLICY_RELEASES.md +37 -0
  111. package/docs/security/README.md +28 -0
  112. package/docs/security/SCORECARD.md +80 -0
  113. package/docs/security/SECRETS.md +158 -0
  114. package/docs/security/SECURITY.md +45 -0
  115. package/docs/security/SECURITY_CHECKLIST.md +55 -0
  116. package/docs/security/SHELL_EXEMPTIONS.md +145 -0
  117. package/docs/security/SOUP_REGISTER.md +36 -0
  118. package/docs/security/THREAT_MODEL.md +130 -0
  119. package/docs/security/VERIFICATION_VALIDATION.md +228 -0
  120. package/docs/themes/README.md +10 -0
  121. package/docs/themes/VISUAL_INTEGRITY_REPORT.md +30 -0
  122. package/docs/themes/hero-shot.svg +78 -0
  123. package/dot_config/.module-manifest.json +69 -0
  124. package/dot_config/ai/identity.md +23 -0
  125. package/dot_config/ai/patterns/architect.md +16 -0
  126. package/dot_config/ai/patterns/hardener.md +15 -0
  127. package/dot_config/ai/patterns/refactor.md +15 -0
  128. package/dot_config/aider/aider.conf.yml +32 -0
  129. package/dot_config/alacritty/alacritty.toml.tmpl +55 -0
  130. package/dot_config/ansible/ansible.cfg +11 -0
  131. package/dot_config/atuin/config.toml.tmpl +47 -0
  132. package/dot_config/bat/config +23 -0
  133. package/dot_config/brave-flags.conf.tmpl +7 -0
  134. package/dot_config/btop/btop.conf +16 -0
  135. package/dot_config/btop/themes/tokyonight.theme +34 -0
  136. package/dot_config/bun/bunfig.toml.tmpl +33 -0
  137. package/dot_config/claude/mcp_servers.json +20 -0
  138. package/dot_config/containers/containers.conf +14 -0
  139. package/dot_config/curl/dot_curlrc +18 -0
  140. package/dot_config/dlv/config.yml +39 -0
  141. package/dot_config/docker/config.json +15 -0
  142. package/dot_config/dotfiles/agent-card.json +29 -0
  143. package/dot_config/dotfiles/agent-profiles.json +92 -0
  144. package/dot_config/dotfiles/boot/README.md +13 -0
  145. package/dot_config/dotfiles/grub/README.md +13 -0
  146. package/dot_config/dotfiles/lock/README.md +13 -0
  147. package/dot_config/dotfiles/mcp-lock.json +33 -0
  148. package/dot_config/dotfiles/mcp-policy.json +52 -0
  149. package/dot_config/dotfiles/mcp-registry.json +47 -0
  150. package/dot_config/dotfiles/model-registry.json +20 -0
  151. package/dot_config/dotfiles/policy-bundles.json +38 -0
  152. package/dot_config/dotfiles/prompt-registry.json +16 -0
  153. package/dot_config/dotfiles/versions.env +18 -0
  154. package/dot_config/duf/duf.conf +6 -0
  155. package/dot_config/duti/defaults.duti +5 -0
  156. package/dot_config/emoji/emoji.txt +34 -0
  157. package/dot_config/environment.d/50-ssh-agent.conf +2 -0
  158. package/dot_config/environment.d/90-wayland.conf +19 -0
  159. package/dot_config/fastfetch/config.jsonc +28 -0
  160. package/dot_config/firefox/user.js.tmpl +58 -0
  161. package/dot_config/fish/completions/dot-theme-sync.fish.tmpl +9 -0
  162. package/dot_config/fish/completions/dot.fish.tmpl +115 -0
  163. package/dot_config/fish/conf.d/000-perf-cache.fish +56 -0
  164. package/dot_config/fish/conf.d/aliases.fish.tmpl +77 -0
  165. package/dot_config/fish/conf.d/env.fish.tmpl +48 -0
  166. package/dot_config/fish/conf.d/functions.fish.tmpl +22 -0
  167. package/dot_config/fish/conf.d/init.fish.tmpl +172 -0
  168. package/dot_config/fish/config.fish.tmpl +44 -0
  169. package/dot_config/fish/fish_plugins +1 -0
  170. package/dot_config/fish/functions/_.fish +3 -0
  171. package/dot_config/fish/functions/_cached_eval.fish +131 -0
  172. package/dot_config/fish/functions/_cached_eval_clear.fish +17 -0
  173. package/dot_config/fish/functions/als.fish +46 -0
  174. package/dot_config/fish/functions/bg-upgrade.fish +7 -0
  175. package/dot_config/fish/functions/c.fish +3 -0
  176. package/dot_config/fish/functions/cat.fish +9 -0
  177. package/dot_config/fish/functions/d.fish +7 -0
  178. package/dot_config/fish/functions/dot.fish +34 -0
  179. package/dot_config/fish/functions/h.fish +3 -0
  180. package/dot_config/fish/functions/l.fish +7 -0
  181. package/dot_config/fish/functions/la.fish +7 -0
  182. package/dot_config/fish/functions/ll.fish +7 -0
  183. package/dot_config/fish/functions/log_error.fish +13 -0
  184. package/dot_config/fish/functions/log_info.fish +13 -0
  185. package/dot_config/fish/functions/lr.fish +7 -0
  186. package/dot_config/fish/functions/lra.fish +7 -0
  187. package/dot_config/fish/functions/ls.fish +7 -0
  188. package/dot_config/fish/functions/lt.fish +7 -0
  189. package/dot_config/fish/functions/lta.fish +7 -0
  190. package/dot_config/fish/functions/notify-run.fish +11 -0
  191. package/dot_config/fish/functions/q.fish +3 -0
  192. package/dot_config/fish/functions/silent-run.fish +7 -0
  193. package/dot_config/fish/functions/yy.fish +8 -0
  194. package/dot_config/flatpak/flatpak.list +4 -0
  195. package/dot_config/fontconfig/fonts.conf.tmpl +57 -0
  196. package/dot_config/foot/foot.ini.tmpl +33 -0
  197. package/dot_config/fuzzel/fuzzel.ini.tmpl +18 -0
  198. package/dot_config/fzf/fzf.zsh +48 -0
  199. package/dot_config/gem/gemrc +9 -0
  200. package/dot_config/gh/config.yml +12 -0
  201. package/dot_config/ghostty/config.tmpl +165 -0
  202. package/dot_config/git/allowed_signers.tmpl +18 -0
  203. package/dot_config/git/attributes +12 -0
  204. package/dot_config/git/commit-template +10 -0
  205. package/dot_config/git/hooks/executable_commit-msg +146 -0
  206. package/dot_config/git/ignore +27 -0
  207. package/dot_config/gnupg/gpg-agent.conf +11 -0
  208. package/dot_config/go/golangci.yml +118 -0
  209. package/dot_config/go/gopls.json +30 -0
  210. package/dot_config/goose/config.yaml +29 -0
  211. package/dot_config/gtk-3.0/gtk.css.tmpl +184 -0
  212. package/dot_config/gtk-3.0/settings.ini.tmpl +27 -0
  213. package/dot_config/gtk-4.0/gtk.css.tmpl +252 -0
  214. package/dot_config/gtk-4.0/settings.ini.tmpl +18 -0
  215. package/dot_config/htop/htoprc +20 -0
  216. package/dot_config/inputrc +2 -0
  217. package/dot_config/ipython/profile_default/ipython_config.py +19 -0
  218. package/dot_config/just/justfile +122 -0
  219. package/dot_config/k9s/config.yaml +65 -0
  220. package/dot_config/k9s/skins/catppuccin-mocha.yaml +116 -0
  221. package/dot_config/kanshi/config.tmpl +22 -0
  222. package/dot_config/karabiner/karabiner.json +14 -0
  223. package/dot_config/kitty/kitty.conf.tmpl +53 -0
  224. package/dot_config/lazydocker/config.yml +186 -0
  225. package/dot_config/lazygit/config.yml +35 -0
  226. package/dot_config/mako/config +47 -0
  227. package/dot_config/mas/masapps.txt +5 -0
  228. package/dot_config/micro/settings.json +3 -0
  229. package/dot_config/mimeapps.list +77 -0
  230. package/dot_config/minikube/config.json +13 -0
  231. package/dot_config/mise/config.toml +99 -0
  232. package/dot_config/mongosh/mongoshrc.js +68 -0
  233. package/dot_config/mpv/input.conf +47 -0
  234. package/dot_config/mpv/mpv.conf +47 -0
  235. package/dot_config/mycli/myclirc +67 -0
  236. package/dot_config/nano/nanorc +28 -0
  237. package/dot_config/ncdu/config +12 -0
  238. package/dot_config/niri/config.kdl.tmpl +327 -0
  239. package/dot_config/nushell/aliases.nu +18 -0
  240. package/dot_config/nushell/cached_eval.nu +80 -0
  241. package/dot_config/nushell/completions.nu.tmpl +52 -0
  242. package/dot_config/nushell/config.nu.tmpl +86 -0
  243. package/dot_config/nushell/env.nu.tmpl +102 -0
  244. package/dot_config/nushell/functions.nu.tmpl +17 -0
  245. package/dot_config/nvim/init.lua +18 -0
  246. package/dot_config/nvim/lazy-lock.json +58 -0
  247. package/dot_config/nvim/lua/config/autocmds.lua +107 -0
  248. package/dot_config/nvim/lua/config/keymaps.lua +92 -0
  249. package/dot_config/nvim/lua/config/lazy.lua +44 -0
  250. package/dot_config/nvim/lua/config/options.lua +49 -0
  251. package/dot_config/nvim/lua/plugins/ai.lua +75 -0
  252. package/dot_config/nvim/lua/plugins/coding.lua +216 -0
  253. package/dot_config/nvim/lua/plugins/completion.lua +60 -0
  254. package/dot_config/nvim/lua/plugins/dap.lua +412 -0
  255. package/dot_config/nvim/lua/plugins/editor.lua +55 -0
  256. package/dot_config/nvim/lua/plugins/git.lua +10 -0
  257. package/dot_config/nvim/lua/plugins/lsp.lua +156 -0
  258. package/dot_config/nvim/lua/plugins/markdown.lua +18 -0
  259. package/dot_config/nvim/lua/plugins/rust.lua +34 -0
  260. package/dot_config/nvim/lua/plugins/sessions.lua +33 -0
  261. package/dot_config/nvim/lua/plugins/ui.lua +509 -0
  262. package/dot_config/paru/paru.conf +10 -0
  263. package/dot_config/pip/pip.conf.tmpl +32 -0
  264. package/dot_config/powershell/Microsoft.PowerShell_profile.ps1.tmpl +81 -0
  265. package/dot_config/pueue/pueue.yml +34 -0
  266. package/dot_config/pypoetry/config.toml +6 -0
  267. package/dot_config/pyrightconfig.json +5 -0
  268. package/dot_config/raycast/README.md +13 -0
  269. package/dot_config/redis/redisclirc +41 -0
  270. package/dot_config/ripgrep/ripgreprc +21 -0
  271. package/dot_config/shell/00-core-paths.sh.tmpl +134 -0
  272. package/dot_config/shell/05-core-safety.sh +48 -0
  273. package/dot_config/shell/10-secrets.sh +41 -0
  274. package/dot_config/shell/40-fzf-defaults.sh.tmpl +17 -0
  275. package/dot_config/shell/40-ls-colors.sh +49 -0
  276. package/dot_config/shell/50-logic-functions-core.sh.tmpl +11 -0
  277. package/dot_config/shell/50-logic-functions.sh.tmpl +11 -0
  278. package/dot_config/shell/51-logic-functions-extra.sh.tmpl +65 -0
  279. package/dot_config/shell/90-ux-aliases.sh.tmpl +121 -0
  280. package/dot_config/shell/91-ux-aliases-lazy.sh.tmpl +55 -0
  281. package/dot_config/shell/Brewfile +207 -0
  282. package/dot_config/shell/Brewfile.cask +92 -0
  283. package/dot_config/shell/Brewfile.cli +127 -0
  284. package/dot_config/shell/README.md +284 -0
  285. package/dot_config/shell/als_data.txt.tmpl +65 -0
  286. package/dot_config/shell/custom/auto_ls.zsh +20 -0
  287. package/dot_config/shell/custom/context_suggest.zsh +68 -0
  288. package/dot_config/shell/custom/error_analysis.zsh +45 -0
  289. package/dot_config/sops/dot_sops.yaml +23 -0
  290. package/dot_config/starship.toml.tmpl +202 -0
  291. package/dot_config/swaylock/config +43 -0
  292. package/dot_config/systemd/user/dotfiles-maintenance.service +8 -0
  293. package/dot_config/systemd/user/dotfiles-maintenance.timer +11 -0
  294. package/dot_config/systemd/user/pueued.service +12 -0
  295. package/dot_config/systemd/user/ssh-agent.service +12 -0
  296. package/dot_config/task/Taskfile.yml +86 -0
  297. package/dot_config/tflint/tflint.hcl +9 -0
  298. package/dot_config/tmux/tmux.conf.tmpl +223 -0
  299. package/dot_config/topgrade.toml.tmpl +54 -0
  300. package/dot_config/user-dirs.dirs +10 -0
  301. package/dot_config/vscode/extensions.txt +11 -0
  302. package/dot_config/vscode/settings.json.tmpl +82 -0
  303. package/dot_config/waybar/config.jsonc.tmpl +90 -0
  304. package/dot_config/waybar/style.css.tmpl +211 -0
  305. package/dot_config/wezterm/wezterm.lua.tmpl +64 -0
  306. package/dot_config/wget/wgetrc +12 -0
  307. package/dot_config/xdg-desktop-portal/niri-portals.conf +5 -0
  308. package/dot_config/yarn/yarnrc.yml +36 -0
  309. package/dot_config/yazi/keymap.toml +67 -0
  310. package/dot_config/yazi/theme.toml +102 -0
  311. package/dot_config/yazi/yazi.toml +40 -0
  312. package/dot_config/zathura/zathurarc +52 -0
  313. package/dot_config/zellij/config.kdl.tmpl +79 -0
  314. package/dot_config/zsh/dot_zprofile +7 -0
  315. package/dot_config/zsh/dot_zshenv +5 -0
  316. package/dot_config/zsh/dot_zshrc.tmpl +635 -0
  317. package/dot_config/zsh/rc.d/00-alias-shims.zsh +99 -0
  318. package/dot_config/zsh/rc.d/05-ssh-agent.zsh +18 -0
  319. package/dot_config/zsh/rc.d/10-env.zsh.tmpl +28 -0
  320. package/dot_config/zsh/rc.d/20-zinit.zsh +65 -0
  321. package/dot_config/zsh/rc.d/30-options.zsh.tmpl +214 -0
  322. package/dot_config/zsh/rc.d/40-bell.zsh +20 -0
  323. package/dot_config/zsh/rc.d/50-login-fortune.zsh +9 -0
  324. package/dot_config/zsh/rc.d/99-alias-wrapper.zsh +32 -0
  325. package/dot_local/bin/executable_ai-update +195 -0
  326. package/dot_local/bin/executable_ai_core +152 -0
  327. package/dot_local/bin/executable_antigravity +11 -0
  328. package/dot_local/bin/executable_b64 +84 -0
  329. package/dot_local/bin/executable_bm +79 -0
  330. package/dot_local/bin/executable_cb +39 -0
  331. package/dot_local/bin/executable_dot +596 -0
  332. package/dot_local/bin/executable_dot-ai +36 -0
  333. package/dot_local/bin/executable_dot-bootstrap +77 -0
  334. package/dot_local/bin/executable_dot-launch-or-focus +52 -0
  335. package/dot_local/bin/executable_dot-load-benchmark +31 -0
  336. package/dot_local/bin/executable_dot-load-benchmark-pty +77 -0
  337. package/dot_local/bin/executable_dot-theme-sync +952 -0
  338. package/dot_local/bin/executable_dot_completion +57 -0
  339. package/dot_local/bin/executable_dtags +28 -0
  340. package/dot_local/bin/executable_epoch +67 -0
  341. package/dot_local/bin/executable_extract +41 -0
  342. package/dot_local/bin/executable_gbd +52 -0
  343. package/dot_local/bin/executable_gd +42 -0
  344. package/dot_local/bin/executable_git-ai-commit +175 -0
  345. package/dot_local/bin/executable_git-ai-diff +169 -0
  346. package/dot_local/bin/executable_gl +101 -0
  347. package/dot_local/bin/executable_hash +161 -0
  348. package/dot_local/bin/executable_hashsum +160 -0
  349. package/dot_local/bin/executable_hex +115 -0
  350. package/dot_local/bin/executable_jsonv +78 -0
  351. package/dot_local/bin/executable_jwt +94 -0
  352. package/dot_local/bin/executable_kill-port +75 -0
  353. package/dot_local/bin/executable_lorem +118 -0
  354. package/dot_local/bin/executable_mkscript +35 -0
  355. package/dot_local/bin/executable_monitor +56 -0
  356. package/dot_local/bin/executable_myip +51 -0
  357. package/dot_local/bin/executable_notify +24 -0
  358. package/dot_local/bin/executable_open +38 -0
  359. package/dot_local/bin/executable_pw +27 -0
  360. package/dot_local/bin/executable_rec-start +46 -0
  361. package/dot_local/bin/executable_rec-stop +35 -0
  362. package/dot_local/bin/executable_regex +132 -0
  363. package/dot_local/bin/executable_start-niri +8 -0
  364. package/dot_local/bin/executable_tmux-sessionizer +314 -0
  365. package/dot_local/bin/executable_tour +177 -0
  366. package/dot_local/bin/executable_up +23 -0
  367. package/dot_local/bin/executable_update +142 -0
  368. package/dot_local/bin/executable_uuid +87 -0
  369. package/dot_local/bin/executable_win +32 -0
  370. package/dot_local/bin/executable_yamlv +57 -0
  371. package/dot_local/share/bash-completion/completions/dot +72 -0
  372. package/dot_local/share/icons/hicolor/128x128/apps/rousseau.png +0 -0
  373. package/dot_local/share/icons/hicolor/16x16/apps/rousseau.png +0 -0
  374. package/dot_local/share/icons/hicolor/24x24/apps/rousseau.png +0 -0
  375. package/dot_local/share/icons/hicolor/256x256/apps/rousseau.png +0 -0
  376. package/dot_local/share/icons/hicolor/32x32/apps/rousseau.png +0 -0
  377. package/dot_local/share/icons/hicolor/48x48/apps/rousseau.png +0 -0
  378. package/dot_local/share/icons/hicolor/512x512/apps/rousseau.png +0 -0
  379. package/dot_local/share/icons/hicolor/64x64/apps/rousseau.png +0 -0
  380. package/dot_local/share/icons/hicolor/96x96/apps/rousseau.png +0 -0
  381. package/dot_local/share/icons/hicolor/scalable/apps/rousseau.png +0 -0
  382. package/dot_local/share/man/man1/dot.1 +149 -0
  383. package/dot_local/share/mise/plugins/kiro-cli/bin/executable_download +64 -0
  384. package/dot_local/share/mise/plugins/kiro-cli/bin/executable_install +18 -0
  385. package/dot_local/share/mise/plugins/kiro-cli/bin/executable_list-all +13 -0
  386. package/dot_local/share/wayland-sessions/niri.desktop.tmpl +6 -0
  387. package/dot_local/share/zsh/completions/.keep +0 -0
  388. package/dot_local/share/zsh/completions/_dot +283 -0
  389. package/install.sh +350 -0
  390. package/package.json +1 -1
  391. package/scripts/ci/check-copyright-headers.sh +96 -0
  392. package/scripts/ci/check-dangerous-chmod.sh +19 -0
  393. package/scripts/ci/check-deps-dev.sh +236 -0
  394. package/scripts/ci/check-insecure-tls.sh +61 -0
  395. package/scripts/ci/check-regression-traceability.sh +67 -0
  396. package/scripts/ci/check-shell-preamble.sh +106 -0
  397. package/scripts/ci/guard-gitleaks-checkout.sh +57 -0
  398. package/scripts/ci/install-chezmoi-verified.sh +64 -0
  399. package/scripts/ci/run-coverage.sh +362 -0
  400. package/scripts/ci/validate-chezmoidata.sh +25 -0
  401. package/scripts/ci/validate-ci-config.sh +224 -0
  402. package/scripts/demo/record.sh +42 -0
  403. package/scripts/diagnostics/a2a-conformance.sh +162 -0
  404. package/scripts/diagnostics/alias-governance.sh +137 -0
  405. package/scripts/diagnostics/aliases-cheatsheet.sh +73 -0
  406. package/scripts/diagnostics/aliases-manifest.sh +31 -0
  407. package/scripts/diagnostics/benchmark.sh +381 -0
  408. package/scripts/diagnostics/conflicts.sh +72 -0
  409. package/scripts/diagnostics/doctor-unified.sh +38 -0
  410. package/scripts/diagnostics/doctor.sh +709 -0
  411. package/scripts/diagnostics/drift-dashboard.sh +201 -0
  412. package/scripts/diagnostics/health.sh +614 -0
  413. package/scripts/diagnostics/history-analysis.sh +85 -0
  414. package/scripts/diagnostics/mcp-doctor.sh +575 -0
  415. package/scripts/diagnostics/perf.sh +452 -0
  416. package/scripts/diagnostics/scorecard.sh +118 -0
  417. package/scripts/diagnostics/secret-governance.sh +58 -0
  418. package/scripts/diagnostics/security-score.sh +438 -0
  419. package/scripts/diagnostics/smoke-test.sh +87 -0
  420. package/scripts/diagnostics/snapshot.sh +89 -0
  421. package/scripts/diagnostics/verify.sh +107 -0
  422. package/scripts/{verify_state.sh → diagnostics/verify_state.sh} +22 -22
  423. package/scripts/diagnostics/version-locks.sh +79 -0
  424. package/scripts/diagnostics/workstation-attestation.sh +186 -0
  425. package/scripts/docs/build-manual.sh +883 -0
  426. package/scripts/docs/check-manual.sh +213 -0
  427. package/scripts/dot/commands/agent.sh +474 -0
  428. package/scripts/dot/commands/ai.sh +481 -0
  429. package/scripts/dot/commands/aliases.sh +250 -0
  430. package/scripts/dot/commands/appearance.sh +80 -0
  431. package/scripts/dot/commands/core.sh +185 -0
  432. package/scripts/dot/commands/diagnostics.sh +229 -0
  433. package/scripts/dot/commands/fleet.sh +399 -0
  434. package/scripts/dot/commands/lint.sh +177 -0
  435. package/scripts/dot/commands/manual.sh +168 -0
  436. package/scripts/dot/commands/meta.sh +248 -0
  437. package/scripts/dot/commands/patterns.sh +54 -0
  438. package/scripts/dot/commands/restore.sh +231 -0
  439. package/scripts/dot/commands/secrets.sh +223 -0
  440. package/scripts/dot/commands/security.sh +76 -0
  441. package/scripts/dot/commands/tools.sh +469 -0
  442. package/scripts/dot/data/alias-deprecations.tsv +2 -0
  443. package/scripts/dot/lib/bento.sh +50 -0
  444. package/scripts/dot/lib/log.sh +200 -0
  445. package/scripts/dot/lib/platform.sh +99 -0
  446. package/scripts/dot/lib/ui.sh +518 -0
  447. package/scripts/dot/lib/utils.sh +377 -0
  448. package/scripts/fonts/install-nerd-fonts.sh +68 -0
  449. package/scripts/fonts/patch-fonts.sh +35 -0
  450. package/scripts/git-hooks/install.sh +11 -0
  451. package/scripts/git-hooks/pre-commit +12 -0
  452. package/scripts/git-hooks/pre-commit-audit.sh +145 -0
  453. package/scripts/git-hooks/pre-push +92 -0
  454. package/scripts/git-hooks/prepare-commit-msg +29 -0
  455. package/scripts/lib/secrets_provider.sh +158 -0
  456. package/scripts/maintenance/check-updates.sh +131 -0
  457. package/scripts/ops/ai-setup.sh +55 -0
  458. package/scripts/ops/bundle.sh +77 -0
  459. package/scripts/ops/chaos.sh +49 -0
  460. package/scripts/ops/chezmoi-apply.sh +270 -0
  461. package/scripts/ops/chezmoi-diff.sh +15 -0
  462. package/scripts/ops/chezmoi-remove.sh +45 -0
  463. package/scripts/ops/chezmoi-update.sh +48 -0
  464. package/scripts/ops/heal-chezmoi.sh +86 -0
  465. package/scripts/ops/heal-system.sh +128 -0
  466. package/scripts/ops/heal-tools.sh +340 -0
  467. package/scripts/ops/heal.sh +222 -0
  468. package/scripts/ops/post-apply-repair.sh +106 -0
  469. package/scripts/ops/prewarm.sh +127 -0
  470. package/scripts/ops/release.sh +252 -0
  471. package/scripts/ops/rollback.sh +589 -0
  472. package/scripts/ops/setup.sh +137 -0
  473. package/scripts/ops/teleport.sh +33 -0
  474. package/scripts/qa/coverage-baseline.sh +60 -0
  475. package/scripts/qa/docs-coverage.sh +111 -0
  476. package/scripts/qa/powershell-contract.ps1 +95 -0
  477. package/scripts/qa/reliability-audit.sh +138 -0
  478. package/scripts/qa/traceability-coverage.sh +116 -0
  479. package/scripts/qa/validate-examples.sh +26 -0
  480. package/scripts/qa/wsl-contract.sh +11 -0
  481. package/scripts/release/package-policy-bundles.sh +125 -0
  482. package/scripts/secrets/age-init.sh +70 -0
  483. package/scripts/secrets/create-secrets-file.sh +45 -0
  484. package/scripts/secrets/encrypt-ssh-key.sh +43 -0
  485. package/scripts/security/backup.sh +57 -0
  486. package/scripts/security/dns-doh.sh +51 -0
  487. package/scripts/security/encryption-check.sh +54 -0
  488. package/scripts/security/enforce-policies.sh +334 -0
  489. package/scripts/security/firewall.sh +90 -0
  490. package/scripts/security/lock-configs.sh +57 -0
  491. package/scripts/security/lock-screen.sh +55 -0
  492. package/scripts/security/manage-secrets.sh +428 -0
  493. package/scripts/security/ssh-cert.sh +203 -0
  494. package/scripts/security/telemetry-kill.sh +50 -0
  495. package/scripts/security/usb-safety.sh +51 -0
  496. package/scripts/theme/apply-gnome-theme.sh +328 -0
  497. package/scripts/theme/extract-theme.py +677 -0
  498. package/scripts/theme/install-boot-logo.sh +62 -0
  499. package/scripts/theme/install-catppuccin-themes.sh +370 -0
  500. package/scripts/theme/install-cursors.sh +25 -0
  501. package/scripts/theme/install-file-icons.sh +26 -0
  502. package/scripts/theme/install-grub-theme.sh +61 -0
  503. package/scripts/theme/install-lock-icon.sh +30 -0
  504. package/scripts/theme/merge-wallpaper.sh +145 -0
  505. package/scripts/theme/rebuild-themes.sh +309 -0
  506. package/scripts/theme/switch.sh +431 -0
  507. package/scripts/theme/wallpaper-rotate.sh +136 -0
  508. package/scripts/theme/wallpaper-sync.sh +397 -0
  509. package/scripts/tools/cmatrix.sh +21 -0
  510. package/scripts/{detect-collisions.py → tools/detect-collisions.py} +2 -2
  511. package/scripts/tools/emoji-picker.sh +48 -0
  512. package/scripts/tools/figlet-banner.sh +18 -0
  513. package/scripts/tools/log-rotate.sh +30 -0
  514. package/scripts/tools/lolcat-wrap.sh +19 -0
  515. package/scripts/tools/pipes.sh +48 -0
  516. package/scripts/tuning/linux.sh +185 -0
  517. package/scripts/tuning/macos.sh +55 -0
  518. package/scripts/uninstall.sh +85 -0
  519. package/scripts/version-sync.sh +487 -0
  520. package/templates/chezmoi-data/geekom-a9.toml.example +21 -0
  521. package/templates/chezmoi-data/mac-m1.toml.example +16 -0
  522. package/templates/chezmoi-data/mac-t2-linux.toml.example +21 -0
  523. package/templates/chezmoi-data/surface-pro-7p.toml.example +21 -0
  524. package/templates/projects/go/.github/workflows/ci.yml +31 -0
  525. package/templates/projects/go/README.md +4 -0
  526. package/templates/projects/go/cmd/__PROJECT_NAME__/main.go +1 -0
  527. package/templates/projects/go/go.sum +0 -0
  528. package/templates/projects/molecule/README.md +7 -0
  529. package/templates/projects/molecule/converge.yml +7 -0
  530. package/templates/projects/molecule/molecule.yml +16 -0
  531. package/templates/projects/node/.github/workflows/ci.yml +30 -0
  532. package/templates/projects/node/README.md +4 -0
  533. package/templates/projects/node/package-lock.json +12 -0
  534. package/templates/projects/node/src/index.js +1 -0
  535. package/templates/projects/packer/README.md +15 -0
  536. package/templates/projects/packer/main.pkr.hcl +15 -0
  537. package/templates/projects/python/.github/workflows/ci.yml +34 -0
  538. package/templates/projects/python/README.md +4 -0
  539. package/templates/projects/python/pyproject.toml +15 -0
  540. package/templates/projects/python/src/__PROJECT_NAME__/__init__.py +1 -0
  541. package/templates/projects/python/tests/test_basic.py +1 -0
  542. package/docs/ARCHITECTURE.md +0 -62
  543. package/docs/COMPLIANCE.md +0 -47
  544. package/docs/OPERATIONS.md +0 -103
  545. package/docs/PR_DESCRIPTION.md +0 -150
  546. package/docs/ROADMAP_legacy.md +0 -556
  547. package/docs/SECURITY_CHECKLIST.md +0 -25
  548. package/docs/TASK.md +0 -99
  549. package/docs/WALKTHROUGH.md +0 -46
  550. package/scripts/backup.sh +0 -142
  551. package/scripts/banner.sh +0 -20
  552. package/scripts/benchmark.sh +0 -20
  553. package/scripts/build.sh +0 -41
  554. package/scripts/clean.sh +0 -31
  555. package/scripts/compile.sh +0 -54
  556. package/scripts/copy.sh +0 -108
  557. package/scripts/doctor.sh +0 -79
  558. package/scripts/dotfiles.sh +0 -63
  559. package/scripts/download.sh +0 -35
  560. package/scripts/help.sh +0 -57
  561. package/scripts/lock-configs.sh +0 -57
  562. package/scripts/package.sh +0 -46
  563. package/scripts/ssh.sh +0 -55
  564. package/scripts/teleport.sh +0 -23
  565. package/scripts/test-aliases.sh +0 -25
  566. package/scripts/test_smoke.sh +0 -88
  567. package/scripts/unpack.sh +0 -28
@@ -0,0 +1,160 @@
1
+ ---
2
+ render_with_liquid: false
3
+ ---
4
+
5
+ # The Ultimate Developer Environment Roadmap
6
+
7
+ This roadmap outlines the path to a high-performance, super-efficient development machine designed for Rust, Python, and AI on Linux (Zorin OS / T2 Mac hardware).
8
+
9
+ ## Phase 1: Foundation (Completed)
10
+
11
+ - **Core Shell**: Zsh + Oh My Zsh.
12
+ - **Modern Prompt**: Starship (hooked & active).
13
+ - **Language Managers**: `rustup` (Rust) and `fnm` (Node.js).
14
+ - **Ultra-Fast Python**: `uv` installed.
15
+ - **Basic Modern Tools**: `eza` (ls), `bat` (cat), `fd` (find), `ripgrep` (grep).
16
+ - **Git Enhancements**: `lazygit` (TUI) and `delta` (Diffs).
17
+ - **Multiplexer**: `zellij` installed.
18
+ - **AI**: `ollama` installed locally.
19
+ - **Security**: Firewall (`ufw`) enabled.
20
+
21
+ ---
22
+
23
+ ## Phase 2: Speed & Navigation (Completed)
24
+
25
+ Focus: Reduce friction in filesystem navigation and build times.
26
+
27
+ ### 1. Navigation
28
+
29
+ - [x] **Zoxide**: Smarter `cd` command that learns your habits (`z directory`).
30
+ - [x] **FZF**: Command-line fuzzy finder. Essential for search history, files, and replacing standard completion.
31
+ - [x] **Yazi**: Blazing fast terminal file manager (Rust-based).
32
+
33
+ ### 2. Rust Optimization
34
+
35
+ - [x] **Mold**: Use the `mold` linker to speed up Rust compile times by 3x-10x.
36
+ - [x] **Sccache**: Shared compilation cache to speed up recompilations across projects.
37
+ - [x] **Bacon**: Background rust compiler that gives instant feedback on errors.
38
+
39
+ ### 3. Python Optimization
40
+
41
+ - [x] **Ruff**: Extremely fast Python linter and formatter (replace flake8/black).
42
+ - [x] **Global Config**: Set `uv` to use system Python or managed Python preferences.
43
+
44
+ ### 4. Code Search
45
+
46
+ - [x] **Ripgrep-all (rga)**: Search inside PDFs, E-Books, zip files, etc.
47
+
48
+ ---
49
+
50
+ ## Phase 3: AI Power User (Completed)
51
+
52
+ Focus: Integrate AI deeply into the workflow.
53
+
54
+ - [x] **Fabric**: Open-source framework for augmenting humans using AI (installed via `cmd` path).
55
+ - [x] **Open WebUI**: A beautiful web interface for `ollama` (requires Docker).
56
+ - [x] **GitHub Copilot CLI**: Integrate AI assistance directly into the terminal commands.
57
+ - [x] **Local RAG**: Setup tools to chat with your own documents locally (Open WebUI).
58
+
59
+ ---
60
+
61
+ ## Phase 4: System Tuning & Hardening (Completed)
62
+
63
+ Focus: Squeeze every ounce of performance and security from the hardware.
64
+
65
+ - [x] **Kernel Tuning**: Increase file descriptor limits and optimize TCP stack for lower latency.
66
+ - [x] **Swap Optimization**: Configure `zram` for memory compression (improves performance on 16GB RAM).
67
+ - [x] **Flatpak Overrides**: Secure Flatpak permissions using `Flatseal`.
68
+ - [x] **Automated Updates**: Configure `unattended-upgrades` for security patches.
69
+
70
+ ---
71
+
72
+ ## Phase 5: Final Polish (Completed)
73
+
74
+ - [x] **Global UV Config**: Created `~/.config/uv/uv.toml` for managed python preference.
75
+ - [x] **Roadmap Completion**: Verified all items are 100% complete.
76
+
77
+ ---
78
+
79
+ ## Maintenance & Updates
80
+
81
+ - **Update System**: `sudo apt update && sudo apt upgrade`
82
+ - **Update Rust**: `rustup update`
83
+ - **Update Node**: `fnm install --lts`
84
+ - **Update UV**: `uv self update`
85
+ - **Update Firmware**: `fwupdmgr get-updates`
86
+
87
+ ---
88
+
89
+ ## Phase 6: Desktop Environment (Completed)
90
+
91
+ Focus: Clean, bloat-free, and supercharged GNOME/Zorin experience.
92
+
93
+ - [x] **Bloatware Removal**: Removed games (`aisleriot`, `mines`, etc.) and media apps (`rhythmbox`, `totem`).
94
+ - [x] **Menu Cleanup**: Created `hide_menu_entries.sh` to deduplicate and hide unwanted entries.
95
+ - [x] **GNOME Extensions**: Installed productivity boosters via `gnome-extensions-cli`:
96
+ - [x] `Clipboard Indicator`: History management.
97
+ - [x] `Caffeine`: Prevent auto-suspend.
98
+ - [x] `Impatience`: Speed up animations.
99
+ - [x] `Vitals`: System monitoring in top bar.
100
+ - [x] **Memory Tuning**: Optimize GNOME Shell performance.
101
+
102
+ ---
103
+
104
+ ## Phase 7: Browser Optimization (Completed)
105
+
106
+ Focus: Chrome tuned for development and memory efficiency.
107
+
108
+ - [x] **Settings**: Enable "Memory Saver" and "Energy Saver" via Managed Policies.
109
+ - [x] **Extensions**: Automated installation of developer stack (uBlock, JSON Viewer, React DevTools, Vimium, Refined GitHub).
110
+ - [x] **Profile Separation**: Separate Personal and Work profiles (Manual setup recommendation).
111
+
112
+ ---
113
+
114
+ ## Phase 8: Neovim IDE (Completed)
115
+
116
+ Focus: Building a terminal-based IDE that rivals VS Code for Rust, Python, and AI.
117
+
118
+ - [x] **Latest Version**: Installed Neovim v0.12.0-dev (Nightly) to resolve plugin stability issues.
119
+ - [x] **Plugin Manager**: Setup `lazy.nvim` with modular config (Restored from **PR #62**).
120
+ - [x] **Core Plugins**:
121
+ - [x] `Telescope`: Fuzzy finding.
122
+ - [x] `Treesitter`: Syntax highlighting.
123
+ - [x] `Harpoon`: Fast file switching.
124
+ - [x] `Neo-tree`: File explorer.
125
+ - [x] **UI/UX Menus**: Added `dressing.nvim` and `telescope-ui-select.nvim` for modern, searchable selection lists and floating inputs.
126
+ - [x] **LSP & Autocomplete**:
127
+ - [x] `Mason`: Managing LSPs (rust-analyzer, pyright, ruff).
128
+ - [x] `Cmp`: Autocompletion engine.
129
+ - [x] **Language Specifics**:
130
+ - [x] **Rust**: `rustaceanvim` configured.
131
+ - [x] **Python**: `pyright` + `ruff`.
132
+ - [x] **AI Integration**:
133
+ - [x] `Copilot.lua`: Enabled (needs `:Copilot auth`).
134
+ - [x] `CopilotChat.nvim`: Sidebar chat (VS Code style).
135
+ - [ ] `Avante.nvim`: Skipped (Removed due to complexity/instability).
136
+ - [x] **VS Code Parity Pack**:
137
+ - [x] `Trouble`: Problems panel.
138
+ - [x] `Spectre`: Search/Replace.
139
+ - [x] `Autopairs`: Auto-close brackets.
140
+ - [x] `Todo-Comments`: TODO/FIXME highlighting.
141
+ - [x] `Persistence`: Session management.
142
+
143
+ ---
144
+
145
+ ## Phase 9: Repository Polish & PR #62 (In Progress)
146
+
147
+ Focus: Finalize the `dotfiles` repository for public consumption and sync the local "Gold Standard" environment.
148
+
149
+ - [x] **Repository Sync**:
150
+ - [x] Clone official repo to `~/dotfiles`.
151
+ - [ ] Sync validated configuration (Neovim, scripts, tuning) into repository.
152
+ - [ ] **Documentation Update**:
153
+ - [ ] Refactor `README.md` for the modern architecture.
154
+ - [ ] Add "Easy Setup" and "Troubleshooting" guides.
155
+ - [ ] **Final PR Submission**:
156
+ - [ ] Verify clean diff against original PR #62.
157
+ - [ ] Push updates to PR #62 branch.
158
+
159
+
160
+
@@ -0,0 +1,47 @@
1
+ ---
2
+ render_with_liquid: false
3
+ ---
4
+
5
+ # Milestone v0.2.493 Scope
6
+
7
+ This milestone keeps scope intentionally small and operationally focused.
8
+
9
+ ## Goals
10
+
11
+ - Make post-merge verification a first-class workflow (`dot verify`).
12
+ - Keep protected-branch CI deterministic (no unsigned bot commits on `master`).
13
+ - Improve day-2 operator confidence with explicit verification guidance.
14
+
15
+ ## In Scope
16
+
17
+ - [x] Add `dot verify` command routing in diagnostics module.
18
+ - `scripts/dot/commands/diagnostics.sh`
19
+ - `dot_local/bin/executable_dot`
20
+ - [x] Add verification runner script.
21
+ - `scripts/diagnostics/verify.sh`
22
+ - Runs:
23
+ - `dot doctor`
24
+ - `dot status`
25
+ - `chezmoi diff`
26
+ - [x] Update completion surfaces for new command.
27
+ - `dot_local/share/bash-completion/completions/dot`
28
+ - `dot_local/bin/executable_dot_completion`
29
+ - [x] Harden sync-versions behavior for protected `master`.
30
+ - `.github/workflows/sync-versions.yml`
31
+ - `master` now verifies only; auto-sync commit job runs on non-master branches.
32
+ - [x] Update docs and command references.
33
+ - `README.md`
34
+ - `docs/README.md`
35
+ - `docs/OPERATIONS.md`
36
+
37
+ ## Out of Scope
38
+
39
+ - New security controls beyond existing baseline.
40
+ - Major CLI redesign or command namespace reshuffle.
41
+ - Release process automation changes outside sync-versions policy hardening.
42
+
43
+ ## Exit Criteria
44
+
45
+ - `dot verify` returns non-zero on drift/issues and zero when healthy.
46
+ - `sync-versions` workflow no longer attempts commits to protected `master`.
47
+ - Relevant unit tests and targeted command tests pass.
@@ -1,46 +1,59 @@
1
+ ---
2
+ render_with_liquid: false
3
+ ---
4
+
1
5
  # Universal Configuration Plan (Chezmoi)
2
6
 
3
7
  ... [Previous Sections Unchanged] ...
4
8
 
5
9
  # Phase 15: Operational Documentation [COMPLETED]
10
+
6
11
  - [x] **Guide**: Created `OPERATIONS.md`.
7
12
 
8
13
  # Phase 16: Final Release Verification [COMPLETED]
14
+
9
15
  - [x] **Verification**: All systems passed.
10
16
 
11
17
  # Phase 17: Structural Optimizations (v0.3.0)
12
18
 
13
19
  ## Goal
20
+
14
21
  Implement structural improvements for better organization and maintainability, anticipating v0.3.0.
15
22
 
16
23
  ## Proposed Changes
17
24
 
18
25
  ### [REFACTOR] Semantic Organization
26
+
19
27
  - **Move**: `dot_config/dotfiles` -> `dot_config/shell`.
20
28
  - **Reason**: `dotfiles` is redundant inside a dotfiles repo. `shell` describes the content (aliases, paths, functions).
21
29
  - **Update**: Update references in `dot_zshrc.tmpl` and install scripts.
22
30
 
23
31
  ### [REFACTOR] Script Installation
32
+
24
33
  - **Move**: `bin/` -> `dot_local/bin/`.
25
34
  - **Reason**: Ensures scripts are automatically installed to `~/.local/bin` (user PATH).
26
35
 
27
36
  ### [CLEANUP] Remove Legacy Files
37
+
28
38
  - **Delete**: `Makefile`, `package.json`.
29
39
  - **Reason**: Replaced by `chezmoi` and GitHub Actions.
30
40
 
31
41
  ### [REFACTOR] Script Segregation
42
+
32
43
  - **Split**: `run_onchange_install_packages.sh.tmpl` into:
33
- - `run_onchange_darwin_install-packages.sh.tmpl` (Homebrew)
34
- - `run_onchange_linux_install-packages.sh.tmpl` (Apt)
35
- - `run_onchange_after_install-vim-plug.sh.tmpl` (Universal)
44
+ - `run_onchange_darwin_install-packages.sh.tmpl` (Homebrew)
45
+ - `run_onchange_linux_install-packages.sh.tmpl` (Apt)
46
+ - `run_onchange_after_install-vim-plug.sh.tmpl` (Universal)
36
47
  - **Reason**: Improves readability and maintainability.
37
48
 
38
49
  # Phase 18: Component Documentation Polish [COMPLETED]
39
50
 
40
51
  ## Goal
52
+
41
53
  Update component documentation (`aliases`, `functions`, `paths`) to match the new `chezmoi` architecture and ensure accuracy.
42
54
 
43
55
  ## Changes
56
+
44
57
  - **Aliases**: Updated `aliases/README.md` to explain modular `*.aliases.sh` loading.
45
58
  - **Functions**: Updated `functions/README.md` to remove legacy install instructions.
46
59
  - **Paths**: Updated `paths/README.md` to clarify precedence and `chezmoi` integration.
@@ -49,10 +62,13 @@ Update component documentation (`aliases`, `functions`, `paths`) to match the ne
49
62
  # Phase 19: Toolchain Expansion [COMPLETED]
50
63
 
51
64
  ## Goal
65
+
52
66
  Add comprehensive support for modern DevOps/Cloud engineering tools.
53
67
 
54
68
  ## Proposed Changes
69
+
55
70
  ### [NEW] Aliases
71
+
56
72
  - **Kubernetes**: `kubectl` shortcuts (`k`), `helm`, `k9s`.
57
73
  - **IaC**: `terraform` (`tf`), `opentofu`, `ansible`.
58
74
  - **Languages**: `go` (`g`), `yarn`, `uv` (modern Python).
@@ -62,30 +78,38 @@ Add comprehensive support for modern DevOps/Cloud engineering tools.
62
78
  # Phase 20: Intelligent Assistance [COMPLETED]
63
79
 
64
80
  ## Goal
81
+
65
82
  Integrate AI capabilities and improved help systems.
66
83
 
67
84
  ## Proposed Changes
85
+
68
86
  ### [NEW] Functions
87
+
69
88
  - **`dothelp`**: Index and search all aliases/functions with descriptions.
70
89
  - **AI Wrappers**: Aliases for `gh copilot`, `fabric`, or generic LLM CLI tools.
71
90
 
72
91
  # Phase 22: Automated Testing [COMPLETED]
73
92
 
74
93
  ## Goal
94
+
75
95
  Verify the dotfiles work on clean Linux environments.
76
96
 
77
97
  ## Proposed Changes
98
+
78
99
  ### [CI] GitHub Actions
100
+
79
101
  - **Container Job**: Run `chezmoi init --apply` inside a localized Docker container (Ubuntu/Fedora) to prove universal compatibility.
80
102
 
81
103
  # Phase 23: Enterprise Core & Security (The Trust Layer) [COMPLETED]
82
104
 
83
105
  ## Goal
106
+
84
107
  Establish a "Trust Layer" for the dotfiles ecosystem, ensuring supply chain security and configuration integrity.
85
108
 
86
109
  ## Changes
110
+
87
111
  - **SLSA & SBOM**: Implemented `security-release.yml` for provenance and SBOM generation.
88
- - **Signing**: Created `enable-signing` wizard alias for easy GPG/SSH configuration.
112
+ - **Signing**: Created `enable-signing` wizard alias for streamlined GPG/SSH configuration.
89
113
  - **Immutability**: Created `lock-configs.sh` script and `lock-configs`/`unlock-configs` aliases.
90
114
 
91
115
  - **Immutability**: Created `lock-configs.sh` script and `lock-configs`/`unlock-configs` aliases.
@@ -93,18 +117,22 @@ Establish a "Trust Layer" for the dotfiles ecosystem, ensuring supply chain secu
93
117
  # Phase 27: Self-Healing & Diagnostics [COMPLETED]
94
118
 
95
119
  ## Goal
120
+
96
121
  Enable the system to self-diagnose and repair configuration drift.
97
122
 
98
123
  ## Changes
99
- - **Scripts**: Created `scripts/doctor.sh` for system health checks.
124
+
125
+ - **Scripts**: Created `scripts/diagnostics/doctor.sh` for system health checks.
100
126
  - **Aliases**: Added `dot doctor`, `dot drift` (`chezmoi verify`), and `dot heal` (`chezmoi apply`).
101
127
 
102
128
  # Phase 51: Regulatory Compliance [COMPLETED]
103
129
 
104
130
  ## Goal
131
+
105
132
  Document and enforce compliance with SOC2, ISO, and GDPR standards.
106
133
 
107
134
  ## Changes
135
+
108
136
  - **Documentation**: Created `COMPLIANCE.md` with control mappings.
109
137
  - **Privacy**: Added `privacy-mode` alias to disable CLI telemetry.
110
138
  - **Audit**: Added `dot audit` alias for tracking changes.
@@ -112,16 +140,20 @@ Document and enforce compliance with SOC2, ISO, and GDPR standards.
112
140
  # Phase 54: macOS Deep Integration [COMPLETED]
113
141
 
114
142
  ## Goal
143
+
115
144
  Harden and optimize the macOS environment via code.
116
145
 
117
146
  ## Changes
147
+
118
148
  - **Defaults**: Created `run_onchange_darwin_defaults.sh.tmpl` to apply secure/optimized `defaults`.
119
149
  - **Hardening**: Enabled screensaver passwords, firewall settings, and disabled guest access.
120
150
 
121
151
  ## Goal
152
+
122
153
  Ensure legal compliance and proper attribution for the open-source project.
123
154
 
124
155
  ## Changes
156
+
125
157
  - **Licensing**: Added `scan-licenses` alias (Trivy/FOSSology).
126
158
  - **Headers**: Added `add-headers` alias for automated copyright insertion.
127
159
  - **Compliance**: Added `check-cla` and `gen-notice` tools.
@@ -129,9 +161,11 @@ Ensure legal compliance and proper attribution for the open-source project.
129
161
  # Phase 59: Font Typography [COMPLETED]
130
162
 
131
163
  ## Goal
164
+
132
165
  Standardize typography and ensure high-quality font rendering across all environments.
133
166
 
134
167
  ## Proposed Changes
168
+
135
169
  - **Nerd Fonts**: Automate installation of `JetBrainsMono Nerd Font` and `Symbols Nerd Font`.
136
170
  - **Fontconfig**: Deploy XML configuration for Linux font rendering (antialiasing, hinting).
137
171
  - **Aliases**: `update-fonts` to refresh font caches (`fc-cache`).
@@ -139,23 +173,27 @@ Standardize typography and ensure high-quality font rendering across all environ
139
173
  # Phase 26: OS Bundling & Compliance [COMPLETED]
140
174
 
141
175
  ## Goal
176
+
142
177
  Prepare the dotfiles for system-wide deployment and ensure strict adherence to standards.
143
178
 
144
179
  ## Proposed Changes
180
+
145
181
  - **XDG Compliance**: Audit `00-default.paths.sh` to ensure all standard XDG variables are exported.
146
182
  - **Vendor Hooks**: Update `dot_zshrc.tmpl` to source system-level overrides from `/etc/dotfiles/defaults.d/` (Simulates "site-local" config).
147
- - **Bundling**: Create `scripts/package.sh` to create a distributable tarball and scaffold `.deb`/`.pkg` generation logic.
183
+ - **Bundling**: Create `scripts/core/package.sh` to create a distributable tarball and scaffold `.deb`/`.pkg` generation logic.
148
184
 
149
185
  # Phase 24: The Universal Installer (Zero-Dependency) [COMPLETED]
150
186
 
151
187
  ## Goal
188
+
152
189
  Provide a frictionless, "one-curl" onboarding experience and capabilities to deploy configurations remotely.
153
190
 
154
191
  ## Proposed Changes
192
+
155
193
  - **install.sh**: A standalone, zero-dependency bash script that:
156
- 1. Detects OS/Arch.
157
- 2. Installs `chezmoi` (binary or via package manager).
158
- 3. Initializes the dotfiles repo.
159
- 4. Runs `chezmoi apply`.
160
- 5. Uses ANSI colors for a polished "TUI" feel.
161
- - **Teleportation**: `scripts/teleport.sh` using `chezmoi archive` piped to SSH to ephemeralize configs on remote servers (e.g., `dot teleport user@server`).
194
+ 1. Detects OS/Arch.
195
+ 2. Installs `chezmoi` (binary or via package manager).
196
+ 3. Initializes the dotfiles repo.
197
+ 4. Runs `chezmoi apply`.
198
+ 5. Uses ANSI colors for a polished "TUI" feel.
199
+ - **Teleportation**: `scripts/ops/teleport.sh` using `chezmoi archive` piped to SSH to ephemeralize configs on remote servers (e.g., `dot teleport user@server`).
@@ -0,0 +1,31 @@
1
+ ---
2
+ render_with_liquid: false
3
+ ---
4
+
5
+ # Repo Audit
6
+
7
+ ## Source of truth
8
+
9
+ - `~/.dotfiles` (chezmoi source directory)
10
+
11
+ ## Key directories
12
+
13
+ - `.chezmoitemplates/` - templated aliases, functions, paths
14
+ - `dot_config/` - configs mapped into `~/.config`
15
+ - `dot_local/` - binaries and local data (e.g., `dot` CLI)
16
+ - `scripts/` - diagnostics, tests, tooling
17
+ - `tests/` - sandbox Dockerfile
18
+ - `nix/` - optional Nix toolchain
19
+
20
+ ## Notable dependencies
21
+
22
+ - `chezmoi`
23
+ - `zsh`, `starship`
24
+ - `neovim`
25
+ - `ripgrep`, `fd`, `bat`, `fzf`, `zoxide`
26
+ - `lazygit`
27
+
28
+ ## Notes
29
+
30
+ - Repo-only files excluded via `.chezmoiignore`.
31
+ - Secrets are handled via `age` + `dot secrets` (see `docs/SECRETS.md`).
@@ -0,0 +1,144 @@
1
+ ---
2
+ render_with_liquid: false
3
+ ---
4
+
5
+ # Install
6
+
7
+ Set up on macOS, Linux, or WSL in 3 to 5 minutes.
8
+
9
+ **You will need:** `git` and `curl`.
10
+
11
+ **Default shell:** Fish. You can change it after you install.
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ bash -c "$(
17
+ curl -fsSL https://raw.githubusercontent.com/sebastienrousseau/dotfiles/master/install.sh
18
+ )"
19
+ ```
20
+
21
+ Then restart your terminal or run `exec $SHELL`.
22
+
23
+ ## Verify
24
+
25
+ ```bash
26
+ dot --version # Confirm installation
27
+ dot doctor # Check shell, git, and tools
28
+ dot help # Browse available commands
29
+ ```
30
+
31
+ ## Choose a shell
32
+
33
+ Fish is the default shell. To switch to Zsh or Nushell, edit `~/.dotfiles/.chezmoidata.toml`:
34
+
35
+ ```toml
36
+ default_shell = "zsh"
37
+ ```
38
+
39
+ Supported values: `zsh`, `fish`, `nushell`.
40
+
41
+ Then apply the change:
42
+
43
+ ```bash
44
+ dot apply
45
+ ```
46
+
47
+ ## Feature flags
48
+
49
+ Turn optional tools on or off after setup. Edit `.chezmoidata.toml`:
50
+
51
+ ```toml
52
+ [features]
53
+ zsh = true # Zsh shell configuration
54
+ fish = true # Fish shell configuration
55
+ nushell = true # Nushell configuration
56
+ nvim = true # Neovim IDE configuration
57
+ tmux = true # Terminal multiplexer
58
+ nix = true # Nix package manager integration
59
+ ```
60
+
61
+ ## Update
62
+
63
+ ```bash
64
+ dot update
65
+ ```
66
+
67
+ ## Next steps
68
+
69
+ 1. Run `dot learn` to take a guided tour.
70
+ 2. Add your own tweaks in `~/.config/shell/custom/`.
71
+ 3. Read the [Utilities and `dot` CLI](../reference/UTILS.md) reference.
72
+
73
+ ---
74
+
75
+ ## Advanced
76
+
77
+ ### Local source install
78
+
79
+ Clone the repo first, then run the installer from your local copy:
80
+
81
+ ```bash
82
+ git clone https://github.com/sebastienrousseau/dotfiles.git ~/.dotfiles
83
+ cd ~/.dotfiles
84
+ ./install.sh
85
+ ```
86
+
87
+ ### Minimal install
88
+
89
+ Install only shells and core tools. This skips editor and terminal extras:
90
+
91
+ ```bash
92
+ ./install.sh --minimal
93
+ ```
94
+
95
+ ### Non-interactive install
96
+
97
+ Use this mode for CI or scripts that run without user input:
98
+
99
+ ```bash
100
+ DOTFILES_SILENT=1 DOTFILES_NONINTERACTIVE=1 \
101
+ bash -c "$(
102
+ curl -fsSL https://raw.githubusercontent.com/sebastienrousseau/dotfiles/master/install.sh
103
+ )"
104
+ ```
105
+
106
+ ### Nix
107
+
108
+ ```bash
109
+ nix develop ~/.dotfiles/nix
110
+ nix profile install ~/.dotfiles/nix#dot-utils
111
+ ```
112
+
113
+ ### Offline bundle
114
+
115
+ On a machine with internet access, create a bundle:
116
+
117
+ ```bash
118
+ dot bundle ~/Downloads
119
+ ```
120
+
121
+ Copy the archive to the target machine. Then unpack and install:
122
+
123
+ ```bash
124
+ tar --zstd -xf dotfiles_offline_bundle_*.tar.zst -P
125
+ cd ~/.dotfiles
126
+ ./install.sh --force
127
+ ```
128
+
129
+ ### Uninstall
130
+
131
+ ```bash
132
+ chezmoi purge
133
+ rm -rf ~/.dotfiles
134
+ rm -rf ~/.local/share/chezmoi ~/.local/share/dotfiles.log
135
+ ```
136
+
137
+ ### Signed contributions
138
+
139
+ All commits must be signed. See [Contributing](../../CONTRIBUTING.md) for details.
140
+
141
+ ---
142
+
143
+ - [Troubleshooting](TROUBLESHOOTING.md)
144
+ - [Support matrix](../reference/SUPPORT_MATRIX.md)
@@ -0,0 +1,61 @@
1
+ ---
2
+ render_with_liquid: false
3
+ ---
4
+
5
+ # Neovim
6
+
7
+ ## Modern Core
8
+
9
+ - **Requirement**: Neovim >= 0.11.2. The config checks this at startup.
10
+ - **Configuration**: Modular, lazy-loaded configuration based on `lazy.nvim`.
11
+ - **Completion**: `blink.cmp` for fast, keystroke-level completion with LSP, snippets, and path sources.
12
+ - **UI**: Snacks.nvim dashboard, notifications, status line, buffer line, and file explorer.
13
+ - **LSP**: Full LSP support for diagnostics, code actions, and more, managed by `mason.nvim`.
14
+
15
+ ## Language Support
16
+
17
+ - **Rust**: Out-of-the-box support with `rustaceanvim`.
18
+ - **Python**: Full support with `basedpyright`, `ruff`, and `venv-selector`.
19
+ - **Web**: Support for web development with `prettier` and `eslint`.
20
+
21
+ ## AI Integration
22
+
23
+ - **Copilot**: `copilot.lua` for code completion. Run `:Copilot auth` to sign in.
24
+ - **Copilot Chat**: AI sidebar for asking questions and getting help (`<leader>cc`).
25
+
26
+ ## VS Code Parity
27
+
28
+ - **Problem Panel**: `trouble.nvim` for a VS Code-like problems panel (`<leader>xx`).
29
+ - **Search & Replace**: `nvim-spectre` for project-wide search and replace (`<leader>S`).
30
+ - **Auto-Pairs**: Automatically closes brackets and pairs (via `blink.cmp` auto-brackets).
31
+ - **TODOs**: Highlights `TODO` and `FIXME` comments.
32
+ - **Session**: Auto-restores your last session.
33
+ - **Snippets**: Native `vim.snippet` engine (Neovim 0.11+).
34
+
35
+ ## Keybindings
36
+
37
+ | Key | Action |
38
+ | --- | --- |
39
+ | `<Space>ff` | Find Files |
40
+ | `<Space>fg` | Grep (Search) text |
41
+ | `<Space>fb` | File browser |
42
+ | `<Space>fp` | Projects |
43
+ | `<Space>e` | Toggle File Explorer |
44
+ | `<Space>a` | Add file to Harpoon |
45
+ | `<Ctrl>e` | Open Harpoon menu |
46
+ | `gd` | Go to Definition |
47
+ | `gr` | Go to References |
48
+ | `<leader>ca` | Code actions |
49
+ | `<leader>cf` | Format code |
50
+ | `<leader>cr` | Rename symbol |
51
+ | `<leader>tt` | Toggle terminal |
52
+ | `<leader>tn` | Test nearest |
53
+ | `<leader>tf` | Test file |
54
+ | `<leader>ts` | Test suite |
55
+ | `<F5>` | Continue (Debug) |
56
+ | `<F10>` | Step over (Debug) |
57
+ | `<F11>` | Step into (Debug) |
58
+ | `<F12>` | Step out (Debug) |
59
+ | `<leader>cc` | Toggle Copilot Chat |
60
+ | `<leader>xx` | Toggle Diagnostics (Trouble) |
61
+ | `<leader>S` | Toggle Spectre (Search/Replace) |