Skip to content

feat: SDD plans overlay, prompt upgrade, personalization suite, and docs#2

Merged
Dreamcoder08 merged 29 commits into
mainfrom
cursor/light-dark-token-system
Jul 1, 2026
Merged

feat: SDD plans overlay, prompt upgrade, personalization suite, and docs#2
Dreamcoder08 merged 29 commits into
mainfrom
cursor/light-dark-token-system

Conversation

@Dreamcoder08

Copy link
Copy Markdown
Owner

Summary

9 commits implementando 4 SDD plans para la vision overlay de dreamcoder-dots (Gentleman.Dots + ML4W + dreamcoder como capa visual).

Changes

Plan 01: Overlay Compatibility

  • SOURCE OF TRUTH comments en apply-theme-mode.sh linkeando colores kanagawa a tokens.json

Plan 02: Shell Prompt Excellence

  • Starship renderer de 11→23 módulos (status, battery, k8s, terraform, java, container, AI session)
  • AI session state detection para fish shell
  • Fix TOML escaping en kubernetes module
  • Fix battery display key (symbol→discharging_symbol)
  • Remove detect_env_vars de username (impedía mostrar el user)

Plan 03: Personalization Suite

  • 9 funciones fish: extract, dots, sysupdate, ports, killport, cheat, http, logs, tm-session
  • Modern CLI aliases con graceful fallback (eza, bat, fd, rg, zoxide, procs, btm, etc.)
  • Tmux: TPM plugins, vim-tmux-navigator, session picker, scratch terminal, tmux-resurrect
  • CLI: dreamcoder status + doctor subcommands

Plan 04: Documentation

  • README rewrite con 3-step install flow
  • INSTALL.md, COMPARISON.md, docs/ai-integration.md

SDL Plans

  • docs/superpowers/plans/4 nuevos SDD plans

Commits

  • aa5de5d fix(overlay): SOURCE OF TRUTH comments
  • 1dd4f5d feat(prompt): Starship 23 módulos
  • 14cd7fb feat(prompt): AI session detection
  • 7a4ff15 feat(shell): funciones + aliases
  • e0e268c feat(tmux): TPM + session picker
  • 7f0030b feat(cli): status + doctor
  • 5af5041 chore(sync): regenerar temas
  • 10b1164 docs(readme): install flow
  • 46a4760 fix(prompt): username + battery

Dreamcoder08 and others added 29 commits July 1, 2026 02:46
…PCA gates

Unify dark/light token parity, autogen palette_tokens from tokens.json, and propagate on_* and selection pairs across renderers with symmetric CI validation.

Co-authored-by: Cursor <cursoragent@cursor.com>
Document that the hardcoded kanagawa color overrides in apply-theme-mode.sh
must match themes/dreamcoder/tokens.json. Both dark and light mode sections
now reference tokens.json as the canonical source.

Part of Plan 01: Overlay Compatibility (Gentleman.Dots + ML4W)
Add new modules while preserving classic two-line powerline layout:
- : red ✗ on command failure
- : laptop battery indicator < 20%
- : k8s context with conditional namespace
- : terraform workspace
- : language version module
- : Docker/container indicator
- [custom.ai_session]: AI session state (Claude/OpenCode)

Restore  with show_always=true and correct U+F007 user icon.
Fix kubernetes TOML escaping: use single-quoted literal string for

Part of Plan 02: Shell Prompt Excellence
Detects active Claude Code or OpenCode sessions and writes state to
~/.cache/dreamcoder/ai-session.state for Starship's custom.ai_session
module to display in the prompt.

Shows model name and token count when Claude is active.
Falls back to OpenCode state detection when no Claude session found.

Part of Plan 02: Shell Prompt Excellence
Four independent SDD plans for the dreamcoder-dots overlay vision:
- Plan 01: Overlay Compatibility (Gentleman.Dots + ML4W)
- Plan 02: Shell Prompt Excellence (Starship with 23 modules)
- Plan 03: Personalization Suite (aliases, functions, scripts)
- Plan 04: Documentation & Developer Experience
New functions for fish shell:
- extract: universal archive extraction (tar, zip, rar, 7z, etc.)
- dots: quick cd to dreamcoder-dots repo
- sysupdate: multi-package-manager system update (pacman, brew, flatpak)
- ports: show listening ports with auto-detection
- killport: kill process on a specific port
- cheat: tldr wrapper for quick command reference
- http: HTTPie wrapper for pretty HTTP requests
- logs: journalctl wrapper for system log watching
- tm-session: fzf-based tmux session picker

Shared bash/zsh aliases in .config/shell/aliases/:
- Full git shortcut suite (gundo, gcleanup, gconflicts, groot)
- Modern CLI aliases with graceful fallback (eza, bat, fd, rg, zoxide)
- Procs, btm, dua, duf, sd, tldr wrappers

All tools gracefully degrade when not installed.

Part of Plan 03: Personalization Suite
Improvements:
- Add TPM with sensible, yank, vim-tmux-navigator, tmux-resurrect plugins
- Change splits to Gentleman-style: v=horizontal, d=vertical
- Add Alt+g scratch terminal popup
- Add prefix+f fzf-based session picker
- Add prefix+K to kill all other sessions
- Add tmux-resurrect auto-save on prefix+C-s
- Add prefix+K confirm-before for killing sessions
- Keep dreamcoder theme via source-file

Part of Plan 03: Personalization Suite
dreamcoder now supports:
- dreamcoder status: show theme mode, git info, timer state, AI session
- dreamcoder doctor: run full health check on all components
- dreamcoder {dark|light}: theme switching (existing)

Part of Plan 03: Personalization Suite (Task 5)
Batch commit of all auto-generated theme files from sync run.
Includes: Kitty, Ghostty, Starship, Tmux, Zellij, Warp, Codex,
Bat, Pi, Nvim, and all themes/dreamcoder/* hook files.

Also includes auto-formatting fixes from ruff and shellcheck.
…ration guide

Rewrite README with user-centric 3-step install (Gentleman → ML4W → Dreamcoder).
New files:
- INSTALL.md: detailed step-by-step with prerequisites and troubleshooting
- COMPARISON.md: feature comparison table across all three repos
- docs/ai-integration.md: how Dreamcoder integrates with Claude, OpenCode, Pi

Part of Plan 04: Documentation & DX
…y key

- Remove detect_env_vars from username section (was preventing show from
  showing when no SSH connection was detected despite show_always=true)
- Fix battery display: symbol is not a valid key in BatteryDisplay entries.
  Change to discharging_symbol with battery icon codepoint.
- Regenerated starship config

Fixes:
  [WARN] - Error in 'Battery' at 'display': Unknown key 'symbol'
  Username not showing in prompt
Regenerated after:
- Removing detect_env_vars from username section
- Fixing battery display key (symbol → discharging_symbol)
Restored the original two-line powerline layout exactly as it was:
- Format: username → directory → git_branch → git_status → fill → cmd_duration → time
- Removed battery, kubernetes, terraform, container, java from format
- Kept only:  (exit code, visible on error only)
- Kept: [custom.ai_session] (hidden until AI session active)
- All language modules preserved (bun, nodejs, python, golang, rust)
- No TOML warnings, no clutter
…er colors

When kanagawa plugin is active, only source color lines (pane-borders,
mode, message, bell) from the dreamcoder theme, skipping status-left,
status-right, status-position, and window-status formats.

This prevents the dreamcoder theme from overriding the kanagawa plugin's
status bar layout (which includes git, cpu, ram widgets).

When kanagawa is not installed, the full dreamcoder theme is applied
including status bar format.
- Change powerline start cap from square (\uECA6) to rounded (\uE0B6)
- Change separator from \uECA0 to standard powerline \uE0B0
- Change end cap from square (\uECB4) to rounded (\uE0B4)
- Remove user icon (\uf007) from username format, keep just
- Put back user icon (\uf007) on username section
- Remove directory icon (\uf0F7) from directory format
- Keep rounded powerline symbols (\uE0B6, \uE0B0, \uE0B4)
…munity templates

Automate the entire release pipeline from tag to distribution:

- GoReleaser config for 4-platform Go builds (linux/amd64, linux/arm64,
  darwin/amd64, darwin/arm64) with Homebrew formula auto-update
- Release workflow: tag → build → GitHub Release → PyPI publish
- Go CI: build + test + golangci-lint on every push/PR
- commitlint: conventional commits enforcement on PRs
- Dependabot: weekly updates for Go, Python, and GitHub Actions deps
- CODEOWNERS: code review routing
- Issue templates: bug report + feature request YAML forms
- PR template: with checklist and conventional commit types

Part of Plan 05: Release Automation & Engineering Excellence
Plan 05 covers GoReleaser, CI/CD, Dependabot, commitlint,
CODEOWNERS, issue/PR templates, and code coverage reporting.
Auto-fixes from pre-commit hooks on generated theme files.
- Fix Go CI: remove non-existent Go 1.27 from matrix
- Add ruff and mypy to pyproject.toml dev deps (CI needs them)
- Remove publish job from main CI (handled by Release workflow)
- Remove tag trigger from main CI (Release workflow handles tags)
Custom shader that adds a warm gold glow trail behind the cursor
using dreamcoder accent color (#d99555). Pulses smoothly with time.

Part of remaining improvements
- Ghostty cursor pulse shader with dreamcoder accent colors
- Skills: theme-engine + palette-tokens SKILL.md files
- AGENTS.md updated with skill registry
- PyPI publishing guide with trusted publisher setup
- Docker E2E test infra (Ubuntu, docker-test.sh)
@Dreamcoder08 Dreamcoder08 merged commit 7863818 into main Jul 1, 2026
0 of 4 checks passed
@Dreamcoder08 Dreamcoder08 deleted the cursor/light-dark-token-system branch July 2, 2026 00:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant