docs(memory): add BDR-009 + LRN-008 (dtach menu -> ~/.bashrc, VS Code non-login)
- BDR-009: reverses BDR-007; menu moved to ~/.bashrc because VS Code Remote-SSH terminals are non-login; per-tab firing accepted over a once-per-connection sentinel. - LRN-008: VS Code Remote-SSH (Linux) terminals are non-login -> skip ~/.profile; hook ~/.bashrc for "run once at session start"; diagnose via VSCODE_IPC_HOOK_CLI + no login-bash ancestry + shopt -q login_shell. - journal: 2026-06-25 session entry. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CN1KSmsuLG6TxSeN5m8xvM
This commit is contained in:
parent
e37eb77ed5
commit
ea33e231ef
@ -60,3 +60,16 @@ grant asserted in README per FSF convention, LICENSE holds plain GPLv3 text. Alt
|
||||
(permissive — allow CLOSED derivatives, weaker open guarantee); Unlicense (public domain, no copyleft).
|
||||
Repo private (CLAUDE.md Public=no) so license optional, but user wanted one set. Reversible: swap LICENSE +
|
||||
README line if "full opensource" meant permissive. Status: done in repo (uncommitted).
|
||||
|
||||
## BDR-009 — dtach resume menu moved ~/.profile → ~/.bashrc (every interactive shell)
|
||||
2026-06-25. Reversed BDR-007. Root cause: user works in VS Code Remote-SSH; its Linux integrated terminals are
|
||||
NON-login interactive shells → read `~/.bashrc`, never `~/.profile` → login-scoped wiring (BDR-007) silently
|
||||
never fired (LRN-008). Now source dtach-router from `bashrc-linux` via `case $- in *i*) … . dtach-router`;
|
||||
fires in EVERY interactive shell (covers VS Code, plain SSH via `~/.profile`→`~/.bashrc`, tmux, new tabs).
|
||||
install.sh `wire_dtach_profile()` → `unwire_dtach_profile()`: strips any stale `~/.profile` block (marker +
|
||||
legacy) so plain SSH login (sources `~/.bashrc` via `~/.profile`) doesn't prompt twice. Trade-off ACCEPTED
|
||||
(user chose "simplest"): menu shows in each new terminal tab when sessions exist, not once-per-connection —
|
||||
the exact noise BDR-007 avoided, now tolerated for VS Code reliability. Alts rejected: (a) once-per-connection
|
||||
sentinel keyed to `SSH_CONNECTION`/`VSCODE_IPC_HOOK_CLI` in `$XDG_RUNTIME_DIR` — more code, user declined;
|
||||
(b) VS Code `terminal.integrated` `args:["-l"]` — not carried by dotfiles, same per-tab firing. Supersedes
|
||||
BDR-007. Status: done in repo; live needs `./install.sh` re-run.
|
||||
|
||||
@ -41,3 +41,12 @@ SOURCE `case $- in *i*) ... . dtach-router` via idempotent wire_dtach_profile()
|
||||
marker block, re-appends marker block). Added cc (create) / d (re-summon) aliases to bashrc-linux.
|
||||
shellcheck + bash -n CLEAN; migration simulated on real .profile copy. LRN-006 + BDR-007. README synced.
|
||||
Not committed; live ~/.profile not yet re-migrated.
|
||||
|
||||
## 2026-06-25 — dtach menu: ~/.profile → ~/.bashrc (VS Code non-login fix)
|
||||
User: dtach resume menu never fires at session start, even post-install. Root cause: user runs VS Code
|
||||
Remote-SSH → its Linux terminals are NON-login → skip ~/.profile (where BDR-007 wired it). Proven by process
|
||||
tree (VSCODE_IPC_HOOK_CLI, no sshd/login-bash) + provably-correct ~/.profile wiring + existing session yet zero
|
||||
menu. Fix: source dtach-router from bashrc-linux (every interactive shell); install.sh wire_dtach_profile() →
|
||||
unwire_dtach_profile() strips stale ~/.profile block (avoids double-prompt on plain SSH). User chose simplest
|
||||
(per-tab) over once-per-connection sentinel. shellcheck install.sh CLEAN, bash -n OK, strip proven idempotent
|
||||
on .profile copy. BDR-009 (supersedes BDR-007) + LRN-008. Live needs ./install.sh re-run.
|
||||
|
||||
@ -56,3 +56,14 @@ returned EMPTY while code-server + RDP stayed undocumented. A partial doc commit
|
||||
hides earlier feature drift. Fix: drift-detect against FEATURE commits (scan `git log` for feat/* touching
|
||||
source since the doc's last SUBSTANTIVE edit, OR cross-ref each entry-point / install-step in code vs doc
|
||||
text) — never trust doc timestamp alone. Surfaced by /doc clean this session.
|
||||
|
||||
## LRN-008 — VS Code Remote-SSH terminals are non-login → skip ~/.profile
|
||||
2026-06-25. VS Code Remote-SSH (Linux) integrated terminals = NON-login interactive bash → source `~/.bashrc`,
|
||||
NEVER `~/.profile`. Any login-scoped startup wiring (`~/.profile`, `~/.bash_profile`) silently never runs there.
|
||||
Diagnose via process tree: `VSCODE_IPC_HOOK_CLI` env + `.vscode-server/.../remote-cli` in PATH, no `sshd` /
|
||||
no `bash -l` ancestry (the launching shell reparents to systemd); confirm with `shopt -q login_shell`. For
|
||||
"run once at session start" that must work under VS Code, hook `~/.bashrc` (universal: sourced by login shells
|
||||
via `~/.profile` AND directly by non-login interactive shells), NOT `~/.profile`. Extends/corrects LRN-006
|
||||
(its `~/.profile` fix is valid only for real login shells, not IDE remotes). Deductive tell that pinned it:
|
||||
wiring proven correct + target resource (session) proven present, yet menu never fires at startup → the startup
|
||||
file is not being sourced → non-login shell. See BDR-009.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user