← Commit history
README.md+2−4
@@ -53,13 +53,11 @@ If a bigger delta is ever wanted, the knob is the fg anchor in the generator (on  The design intent (John, 2026-08-02): the active tab should share the chat body's background so the active conversation reads front-and-center, the tab flowing into its content. -**Status: PASS as of 2.2.0, by design.** Measured live in the workbench (computed DOM colors, not eyeballs): the active tab background equals the Claude chat body exactly in all five themes.--How we got here: the chat body is painted by Claude Code's webview with `--vscode-sideBar-background` (their `.fullEditor` variant uses the editor background but is not applied in this hosting mode; stock Dark 2026 shows the identical seam, see the control column). Rather than changing VS Code or Claude, the THEMES adapt to that reality (the tab contract, 2.2.0): `tab.activeBackground` takes `sideBar.background` (the chat's color), while the tab strip and inactive tabs drop to the editor ground, so the active tab is the one lit card and inactive tabs obviously recede. A file editor's active tab now carries a subtle cap seam over its body; that trade was accepted deliberately, chats are what you read all day.+**Status: PASS as of 2.3.0, by the one-ground contract.** Claude chats paint `sideBar.background` when resumed from history and `editor.background` in fullEditor (command-opened) mode, so the only rule that makes the active tab flow into EVERY chat, both modes, plus every file editor, is to unify the grounds: `sideBar.background`/`foreground` take the editor ground and text in all five themes. The active tab keeps 2026's anchor equality with the editor ground, so tab == chat == file body everywhere, and inactive tabs keep the raised 2026 chrome tone so the active one is unmistakable. (The interim 2.2.0 contract matched only the history mode; superseded the same day once the fullEditor mode was measured.) The sidebar/editor boundary is carried by the border, not a fill change.  ![Active tab vs chat body, measured, all themes + control](https://wiki.adom.inc/api/pages/adom/adom-theme/files/docs/seam-validation-v2.png) -One more measured nuance (2026-08-02): Claude Code has TWO chat surface modes. Chats resumed from the session history (the normal user path) paint `sideBar.background`, which is what the tab contract matches, verified above. Chats opened programmatically via the `claude-code.open` command (prefilled-prompt flows) get Claude's `fullEditor` styling and paint `editor.background` instead, so those tabs show a seam. If HD's own chat-opening flows ever standardize on the command path, revisit the tab contract.+One more measured nuance (2026-08-02): Claude Code has TWO chat surface modes, history-resumed (paints `sideBar.background`) and fullEditor/command-opened (paints `editor.background`). The one-ground contract above makes them identical by construction, so the mode difference is invisible in Adom themes.  Two operational notes for future auditors: VS Code caches computed theme data per extension VERSION, so editing theme files under an unchanged version renders nothing (bump to bust); and right after a theme switch, webviews restyle asynchronously, so tabs can wear different themes for a beat. Both are normal. 
package.json+1−1
@@ -1,7 +1,7 @@ {   "slug": "adom-theme",   "name": "adom-theme",-  "version": "2.2.5",+  "version": "2.3.0",   "type": "skill",   "description": "THE Adom application theme: five colour schemes with exact tokens, slugs vs labels, font pairings, the VS Code theme pack (adom.adom-theme, version-locked to this package), migration rules, and the guards. Hydrogen Desktop is the reference implementation.",   "discovery_triggers": [
page.json+4−2
@@ -52,7 +52,7 @@     "path": "screenshots/hero-v5.png"   },   "name": "adom-theme",-  "version": "2.2.5",+  "version": "2.3.0",   "description": "THE Adom application theme: five colour schemes with exact tokens, slugs vs labels, font pairings, the VS Code theme pack (adom.adom-theme, version-locked to this package), migration rules, and the guards. Hydrogen Desktop is the reference implementation.",   "discovery_pitch": "Implementing or matching Adom's look in any app: load this first. Exact tokens for all five schemes, the slug/label contract, font pairings and delivery traps, and the guard scripts.",   "files": [@@ -83,7 +83,9 @@     "reference/install-brand-fonts.sh",     "reference/check-scheme-parity.sh",     "reference/check-installed-themes.sh",-    "reference/check-vscode-theme-names.sh"+    "reference/check-vscode-theme-names.sh",+    "reference/gen-adom-studio-v2.mjs",+    "reference/reference-2026-dark.json"   ],   "scripts": {     "install": "./install.sh",
reference/gen-adom-studio-v2.mjs+12−14
@@ -152,19 +152,17 @@ function buildTheme({ bgNew, name, file, fgNew = FG_NEW, syntaxMinRatio = 0 }) {     colors['editor.background'] = bgNew;     colors['editor.foreground'] = fgNew; -    // THE TAB CONTRACT (John 2026-08-02): the active tab must FLOW into the Claude-    // chat body, and Claude's chat paints sideBar.background (measured live; stock-    // Dark 2026 has the same seam). We adapt the THEME to that reality, never the-    // apps: active tab takes the chat's color, and the strip + inactive tabs drop-    // to the editor ground so the active tab reads as the one lit card. A file-    // editor's active tab now carries a subtle cap seam over its body; accepted-    // trade (John: chats are what you look at all day).-    const chatBody = colors['sideBar.background'];-    colors['tab.activeBackground'] = chatBody;-    colors['tab.unfocusedActiveBackground'] = chatBody;-    colors['tab.inactiveBackground'] = bgNew;-    if (ref.colors['tab.unfocusedInactiveBackground'] !== undefined) colors['tab.unfocusedInactiveBackground'] = bgNew;-    colors['editorGroupHeader.tabsBackground'] = bgNew;+    // THE ONE-GROUND CONTRACT (John 2026-08-02, superseding the same-day tab+    // contract): Claude chats paint sideBar.background in history-resumed mode and+    // editor.background in fullEditor mode, so the ONLY way the active tab can flow+    // into EVERY chat (and every file editor) is to unify the two grounds:+    // sideBar takes the editor ground and text. The active tab keeps 2026's anchor+    // equality (== editor ground == both chat modes == file bodies), and inactive+    // tabs/strip keep their natural RAISED 2026 chrome tone, so the active tab+    // reads as the sunken/merged one - exactly Dark 2026's architecture. The+    // sidebar/editor boundary is carried by sideBar.border, not a fill change.+    colors['sideBar.background'] = bgNew;+    colors['sideBar.foreground'] = fgNew;      // Syntax lift (Bright only): raise lightness WITHIN the hue until the colour clears     // syntaxMinRatio against the ground. Hue and saturation are untouched -- semantics@@ -201,7 +199,7 @@ function buildTheme({ bgNew, name, file, fgNew = FG_NEW, syntaxMinRatio = 0 }) {     console.log('  ' + rel('tab.inactiveBackground', 'editor.background'));     console.log('  ' + rel('editorWidget.background', 'editor.background'));     console.log('  ' + rel('input.background', 'editor.background'));-    console.log('  active tab == CHAT body (sideBar):', colors['tab.activeBackground'] === colors['sideBar.background'], ' inactive == strip == ground:', colors['tab.inactiveBackground'] === colors['editor.background'] && colors['editorGroupHeader.tabsBackground'] === colors['editor.background']);+    console.log('  one ground (activeTab==sideBar==editor):', colors['tab.activeBackground'] === colors['editor.background'] && colors['sideBar.background'] === colors['editor.background'], ' inactive raised + distinct:', colors['tab.inactiveBackground'] !== colors['tab.activeBackground']);     console.log('  chrome sample:', colors['tab.inactiveBackground'], ' overlay sample:', colors['editorWidget.background'], ' accent sample:', colors['tab.activeBorderTop']); } 
reference/gen-vscode-themes.mjs+6−11
@@ -414,17 +414,12 @@ const unmapped = new Set(); for (const v of VARIANTS) {     const theme = retintTheme(template, v.scheme, v.label, unmapped, v.brighten === true);     enforceSurfaceDistinction(theme.colors, v.label, v.scheme);-    // THE TAB CONTRACT (John 2026-08-02, same override as gen-adom-studio-v2): the-    // active tab flows into the Claude chat body (which paints sideBar.background);-    // strip + inactive tabs drop to the editor ground so the active tab is the one-    // lit card. Applied post-retint so both generators emit the identical contract.-    const chatBody = theme.colors['sideBar.background'];-    const ground = theme.colors['editor.background'];-    theme.colors['tab.activeBackground'] = chatBody;-    theme.colors['tab.unfocusedActiveBackground'] = chatBody;-    theme.colors['tab.inactiveBackground'] = ground;-    if (theme.colors['tab.unfocusedInactiveBackground'] !== undefined) theme.colors['tab.unfocusedInactiveBackground'] = ground;-    theme.colors['editorGroupHeader.tabsBackground'] = ground;+    // THE ONE-GROUND CONTRACT (John 2026-08-02, same rule as gen-adom-studio-v2):+    // unify sideBar onto the editor ground so BOTH Claude chat modes, file bodies,+    // and the active tab all share one color; inactive tabs/strip keep the raised+    // chrome tone. See gen-adom-studio-v2.mjs for the full rationale.+    theme.colors['sideBar.background'] = theme.colors['editor.background'];+    theme.colors['sideBar.foreground'] = theme.colors['editor.foreground'];     writeFileSync(         join(outDir, 'themes', `${v.file}-color-theme.json`),         JSON.stringify(theme, null, 2) + '\n'
vscode/package.json+1−1
@@ -2,7 +2,7 @@   "name": "adom-theme",   "displayName": "Adom Theme",   "publisher": "adom",-  "version": "2.2.5",+  "version": "2.3.0",   "description": "The Adom brand theme family for VS Code. Generated from the Adom theme tokens and version-locked to the adom-theme wiki package, so the editor and the app can never disagree about a colour.",   "engines": {     "vscode": "^1.70.0"
vscode/themes/adom-kickstand-color-theme.json+6−6
@@ -30,8 +30,8 @@     "activityBar.border": "#3d3f46",     "activityBarBadge.background": "#00b8b1",     "activityBarBadge.foreground": "#003c3f",-    "sideBar.background": "#202127",-    "sideBar.foreground": "#97a0aa",+    "sideBar.background": "#191919",+    "sideBar.foreground": "#d7dde3",     "sideBar.border": "#3d3f46",     "sideBarTitle.foreground": "#f5f7f9",     "sideBarSectionHeader.background": "#191919",@@ -46,12 +46,12 @@     "statusBarItem.remoteBackground": "#00b8b1",     "statusBarItem.remoteForeground": "#003c3f",     "statusBarItem.hoverBackground": "#282a30",-    "editorGroupHeader.tabsBackground": "#191919",+    "editorGroupHeader.tabsBackground": "#202127",     "editorGroupHeader.noTabsBackground": "#191919",     "editorGroupHeader.tabsBorder": "#3d3f46",     "editorGroup.border": "#3d3f46",-    "tab.activeBackground": "#202127",-    "tab.inactiveBackground": "#191919",+    "tab.activeBackground": "#191919",+    "tab.inactiveBackground": "#202127",     "tab.activeForeground": "#f5f7f9",     "tab.inactiveForeground": "#97a0aa",     "tab.border": "#3d3f46",@@ -163,7 +163,7 @@     "textPreformat.foreground": "#8fd3d4",     "welcomePage.background": "#191919",     "welcomePage.tileBackground": "#202127",-    "tab.unfocusedActiveBackground": "#202127",+    "tab.unfocusedActiveBackground": "#191919",     "widget.shadow": "#0a0a0aaa",     "quickInput.border": "#3d3f46",     "notificationCenter.border": "#3d3f46"
vscode/themes/adom-slate-color-theme.json+6−6
@@ -30,8 +30,8 @@     "activityBar.border": "#3d4754",     "activityBarBadge.background": "#00b8b1",     "activityBarBadge.foreground": "#04211f",-    "sideBar.background": "#202a37",-    "sideBar.foreground": "#93a6bd",+    "sideBar.background": "#17212e",+    "sideBar.foreground": "#d3e0ef",     "sideBar.border": "#3d4754",     "sideBarTitle.foreground": "#f0f6fc",     "sideBarSectionHeader.background": "#17212e",@@ -46,12 +46,12 @@     "statusBarItem.remoteBackground": "#00b8b1",     "statusBarItem.remoteForeground": "#04211f",     "statusBarItem.hoverBackground": "#28323f",-    "editorGroupHeader.tabsBackground": "#17212e",+    "editorGroupHeader.tabsBackground": "#202a37",     "editorGroupHeader.noTabsBackground": "#17212e",     "editorGroupHeader.tabsBorder": "#3d4754",     "editorGroup.border": "#3d4754",-    "tab.activeBackground": "#202a37",-    "tab.inactiveBackground": "#17212e",+    "tab.activeBackground": "#17212e",+    "tab.inactiveBackground": "#202a37",     "tab.activeForeground": "#f0f6fc",     "tab.inactiveForeground": "#93a6bd",     "tab.border": "#3d4754",@@ -163,7 +163,7 @@     "textPreformat.foreground": "#5fe6de",     "welcomePage.background": "#17212e",     "welcomePage.tileBackground": "#202a37",-    "tab.unfocusedActiveBackground": "#202a37",+    "tab.unfocusedActiveBackground": "#17212e",     "widget.shadow": "#090d12aa",     "quickInput.border": "#3d4754",     "notificationCenter.border": "#3d4754"
vscode/themes/adom-studio-bright-color-theme.json+7−7
@@ -57,7 +57,7 @@     "dropdown.listBackground": "#18191c",     "editor.findMatchBackground": "#257a7690",     "editorGroup.border": "#feffff17",-    "editorGroupHeader.tabsBackground": "#0d1117",+    "editorGroupHeader.tabsBackground": "#18191c",     "editorGroupHeader.tabsBorder": "#2b2e33FF",     "editorGutter.addedBackground": "#72c892",     "editorGutter.deletedBackground": "#f28772",@@ -99,9 +99,9 @@     "settings.dropdownBorder": "#3d434b",     "settings.headerForeground": "#feffff",     "settings.modifiedItemIndicator": "#bb800966",-    "sideBar.background": "#18191c",+    "sideBar.background": "#0d1117",     "sideBar.border": "#2b2e33FF",-    "sideBar.foreground": "#edeef1",+    "sideBar.foreground": "#e6edf3",     "sideBarSectionHeader.foreground": "#edeef1",     "statusBar.background": "#18191c",     "statusBar.border": "#2b2e33FF",@@ -114,14 +114,14 @@     "statusBar.noFolderBackground": "#18191c",     "statusBarItem.focusBorder": "#37b7b0B3",     "statusBarItem.prominentBackground": "#37b7b0",-    "tab.activeBackground": "#18191c",+    "tab.activeBackground": "#0d1117",     "tab.activeBorder": "#0d1117",     "tab.activeBorderTop": "#37b7b0",     "tab.activeForeground": "#edeef1",     "tab.selectedBorderTop": "#67ded8",     "tab.border": "#2b2e33FF",     "tab.hoverBackground": "#0d1117",-    "tab.inactiveBackground": "#0d1117",+    "tab.inactiveBackground": "#18191c",     "tab.inactiveForeground": "#9da9b8",     "tab.unfocusedActiveBorder": "#1e2023",     "tab.unfocusedActiveBorderTop": "#2b2e34",@@ -236,9 +236,9 @@     "statusBarItem.prominentForeground": "#feffff",     "statusBarItem.prominentHoverBackground": "#37b7b0",     "tab.hoverForeground": "#edeef1",-    "tab.unfocusedActiveBackground": "#18191c",+    "tab.unfocusedActiveBackground": "#0d1117",     "tab.unfocusedActiveForeground": "#9da9b8",-    "tab.unfocusedInactiveBackground": "#0d1117",+    "tab.unfocusedInactiveBackground": "#18191c",     "tab.unfocusedInactiveForeground": "#454c56",     "breadcrumb.foreground": "#9da9b8",     "breadcrumb.background": "#0d1117",
vscode/themes/adom-studio-color-theme.json+7−7
@@ -57,7 +57,7 @@     "dropdown.listBackground": "#1f2125",     "editor.findMatchBackground": "#23757090",     "editorGroup.border": "#feffff17",-    "editorGroupHeader.tabsBackground": "#161b22",+    "editorGroupHeader.tabsBackground": "#1f2125",     "editorGroupHeader.tabsBorder": "#2d3237FF",     "editorGutter.addedBackground": "#72c892",     "editorGutter.deletedBackground": "#f28772",@@ -99,9 +99,9 @@     "settings.dropdownBorder": "#3e434b",     "settings.headerForeground": "#feffff",     "settings.modifiedItemIndicator": "#bb800966",-    "sideBar.background": "#1f2125",+    "sideBar.background": "#161b22",     "sideBar.border": "#2d3237FF",-    "sideBar.foreground": "#cdd3db",+    "sideBar.foreground": "#c9d1d9",     "sideBarSectionHeader.foreground": "#cdd3db",     "statusBar.background": "#1f2125",     "statusBar.border": "#2d3237FF",@@ -114,14 +114,14 @@     "statusBar.noFolderBackground": "#1f2125",     "statusBarItem.focusBorder": "#33a8a2B3",     "statusBarItem.prominentBackground": "#33a8a2",-    "tab.activeBackground": "#1f2125",+    "tab.activeBackground": "#161b22",     "tab.activeBorder": "#161b22",     "tab.activeBorderTop": "#33a8a2",     "tab.activeForeground": "#cdd3db",     "tab.selectedBorderTop": "#2ccbc3",     "tab.border": "#2d3237FF",     "tab.hoverBackground": "#161b22",-    "tab.inactiveBackground": "#161b22",+    "tab.inactiveBackground": "#1f2125",     "tab.inactiveForeground": "#8d9aac",     "tab.unfocusedActiveBorder": "#23262a",     "tab.unfocusedActiveBorderTop": "#2d3237",@@ -236,9 +236,9 @@     "statusBarItem.prominentForeground": "#feffff",     "statusBarItem.prominentHoverBackground": "#33a8a2",     "tab.hoverForeground": "#cdd3db",-    "tab.unfocusedActiveBackground": "#1f2125",+    "tab.unfocusedActiveBackground": "#161b22",     "tab.unfocusedActiveForeground": "#8d9aac",-    "tab.unfocusedInactiveBackground": "#161b22",+    "tab.unfocusedInactiveBackground": "#1f2125",     "tab.unfocusedInactiveForeground": "#454b55",     "breadcrumb.foreground": "#8d9aac",     "breadcrumb.background": "#161b22",
vscode/themes/adom-studio-dark-color-theme.json+7−7
@@ -57,7 +57,7 @@     "dropdown.listBackground": "#17191c",     "editor.findMatchBackground": "#22716d90",     "editorGroup.border": "#feffff17",-    "editorGroupHeader.tabsBackground": "#0d1117",+    "editorGroupHeader.tabsBackground": "#17191c",     "editorGroupHeader.tabsBorder": "#282b30FF",     "editorGutter.addedBackground": "#72c892",     "editorGutter.deletedBackground": "#f28772",@@ -99,9 +99,9 @@     "settings.dropdownBorder": "#393e46",     "settings.headerForeground": "#feffff",     "settings.modifiedItemIndicator": "#bb800966",-    "sideBar.background": "#17191c",+    "sideBar.background": "#0d1117",     "sideBar.border": "#282b30FF",-    "sideBar.foreground": "#cdd3db",+    "sideBar.foreground": "#c9d1d9",     "sideBarSectionHeader.foreground": "#cdd3db",     "statusBar.background": "#17191c",     "statusBar.border": "#282b30FF",@@ -114,14 +114,14 @@     "statusBar.noFolderBackground": "#17191c",     "statusBarItem.focusBorder": "#32a6a0B3",     "statusBarItem.prominentBackground": "#32a6a0",-    "tab.activeBackground": "#17191c",+    "tab.activeBackground": "#0d1117",     "tab.activeBorder": "#0d1117",     "tab.activeBorderTop": "#32a6a0",     "tab.activeForeground": "#cdd3db",     "tab.selectedBorderTop": "#2ccac2",     "tab.border": "#282b30FF",     "tab.hoverBackground": "#0d1117",-    "tab.inactiveBackground": "#0d1117",+    "tab.inactiveBackground": "#17191c",     "tab.inactiveForeground": "#8b98ab",     "tab.unfocusedActiveBorder": "#1c1f22",     "tab.unfocusedActiveBorderTop": "#282c30",@@ -236,9 +236,9 @@     "statusBarItem.prominentForeground": "#feffff",     "statusBarItem.prominentHoverBackground": "#32a6a0",     "tab.hoverForeground": "#cdd3db",-    "tab.unfocusedActiveBackground": "#17191c",+    "tab.unfocusedActiveBackground": "#0d1117",     "tab.unfocusedActiveForeground": "#8b98ab",-    "tab.unfocusedInactiveBackground": "#0d1117",+    "tab.unfocusedInactiveBackground": "#17191c",     "tab.unfocusedInactiveForeground": "#414750",     "breadcrumb.foreground": "#8b98ab",     "breadcrumb.background": "#0d1117",