@wenathlan/devthink 1.1.9 → 1.1.11

package/CHANGELOG.md

@@ -1,107 +1,26 @@
-# Changelog
+# DevThink release notes
+## 1.1.11 — Web-CLI parity and visual renewal
 
-## 1.1.9 — Unified terminal workspace
-
-This release reconstructs DevThink as one command-first terminal workspace across its static React workbench and interactive CLI. The browser is the route-addressable React surface; the CLI is a React Ink terminal surface with the same categories, empty states, local credential boundary and command rail.
-
-| Area | Change |
-| --- | --- |
-| Shared information architecture | Aligns `features`, `bugs`, `refactor`, `snippets`, `tasks`, `notes`, `all` and `settings` across web and CLI. |
-| Browser workbench | Replaces the dashboard shell with a sparse black terminal workspace, top category strip, central canvas and bottom command rail. |
-| Interactive CLI | Adds an Ink React renderer for TTY sessions, preserving the canonical ANSI fallback for noninteractive and compatibility contexts. |
-| Binary portability | Uses Ink rather than a native TUI dependency so Bun can bundle the CLI for Linux, macOS and Windows release targets. |
-| Release metadata | Aligns the CLI, static workbench, mobile shell, extension and package adapters on version 1.1.9. |
-
-## 1.1.8 — Workflow trust boundaries and package adapters
-
-This release removes `workflow_run` as a trigger from privileged distribution workflows. Publishing jobs now check out only a release tag or a manually supplied authenticated release tag, preventing a completed workflow from selecting arbitrary source code before package or release credentials become available.
-
-| Area | Change |
-| --- | --- |
-| CodeQL remediation | Removes untrusted `workflow_run.head_sha` checkouts from npm, GitHub Packages, extension, container, GHCR and mobile publication workflows. |
-| Maven | Adds a Java 17 process adapter and a source-backed Maven publication workflow for GitHub Packages. |
-| NuGet | Adds a .NET 8 process adapter, package README and a source-backed NuGet publication workflow for GitHub Packages. |
-| RubyGems | Adds a Ruby process adapter and a source-backed RubyGems publication workflow for GitHub Packages. |
-| Release metadata | Aligns the CLI, static workbench, mobile shell, extension and adapter packages on version 1.1.8. |
-
-## 1.1.7 — Security remediation
-
-This release resolves the Trivy Dockerfile finding `DS-0026` by declaring an executable container health check that verifies the Bun-compiled DevThink CLI is available in the nonroot distroless runtime. The security workflow keeps its active Trivy, OSV, pnpm-audit and verified-secret gates; no scanner, severity threshold or release protection is weakened.
-
-| Area | Change |
-| --- | --- |
-| Container hardening | Adds a native `HEALTHCHECK` instruction that executes `devthink --help` without requiring a shell in the distroless runtime. |
-| Gateway reliability | Requests an operating-system-assigned loopback port by default, avoiding HTTP-client restricted ports during concurrent test execution in CI. |
-| Dependency review | Confirms the workbench audit has no known vulnerabilities at low, moderate, high or critical severity. |
-| Mobile dependency graph | Retains the `uuid` 11.1.1 override that removes the previously vulnerable transitive UUID version. |
-| Release metadata | Aligns the CLI, static workbench, mobile shell and browser extension on version 1.1.7. |
-
-## 1.1.6 — Mobile artifact activation
-
-This release corrects the mobile workflow's source detector for the JSON Capacitor configuration. Android development APK/AAB and iOS simulator application packaging now execute whenever the source is present.
-
-## 1.1.5 — Minimal container runtime
-
-This release replaces the container runtime with a nonroot distroless compatibility image. The image contains only the compiled DevThink binary and its required C/C++ runtime libraries, reducing the operating-system package surface scanned before GHCR publication.
-
-## 1.1.4 — Container runtime compatibility
-
-This release runs the Bun-compiled CLI in a Bun runtime image, avoiding dynamic-library mismatches during GHCR smoke tests. Security workflows retain Trivy SARIF evidence even when the configured gate detects a high-severity issue.
-
-## 1.1.3 — Distribution repair
-
-This release corrects the mobile Capacitor configuration and resolves the vulnerable UUID transitively selected by the initial mobile lockfile. It also moves the Bun container runtime to a glibc-compatible base, so the compiled CLI runs in the released image, and limits Maven, NuGet, and RubyGems publication to manual source-backed dispatches.
-
-## 1.1.2 — Distribution surfaces and artifacts
-
-This release keeps `@wenathlan/devthink` as the only npm package and adds source-backed distribution surfaces for a browser extension, a Bun-compiled container, Android development artifacts, and an iOS simulator artifact. Maven, NuGet and RubyGems remain source-gated because the repository does not contain Java, .NET, or Ruby package sources.
-
-| Area | Change |
-| --- | --- |
-| npm | Publishes only the DevThink CLI package. |
-| Browser extension | Packages the static workbench as a Manifest V3 release ZIP with explicit local-gateway host permissions. |
-| Container | Compiles the CLI with Bun in a multi-stage image and publishes a container release archive and GHCR image when triggered. |
-| Mobile | Uses Capacitor source with Bun-built web assets to produce Android development artifacts and an unsigned iOS simulator application. |
-
-## 1.1.1 — DevThink publication and workflow reconciliation
-
-This release aligns the CLI and static workbench at version 1.1.1, refreshes direct web dependencies, and updates the GitHub Actions toolchain. The workbench remains a static deployment surface and is not published as a separate npm package.
-
-| Area | Change |
-| --- | --- |
-| Distribution | Publishes only `@wenathlan/devthink` through the credential-safe npm workflow. |
-| Workflows | Updates Actions runtimes and adds source-aware guards for optional ecosystem packages. |
-| Compatibility | Raises the declared Node.js baseline to 26.7.0 and refreshes direct web dependencies to their current releases. |
-| Static web | Preserves the deployable `web/` artifact for GitHub Pages, Vercel and Netlify. |
-
-## Embedded gateway and web workbench implementation
-
-This implementation turns the audited repository context into the DevThink feature map and expands the DevThink CLI with provider-owned endpoints, normalized streaming and a local embedded gateway.
+### Added
 
-| Area | Change |
+| Area | Addition |
 | --- | --- |
-| Documentation | Adds the DevThink feature-map collection, correction specification, canonical audit coverage, provider families, known regressions, terminal design and web plan |
-| Gateway | Adds provider-specific endpoint overrides, embedded streaming diagnostics and secret redaction without a separate proxy subsystem |
-| Providers | Adds registry entries for DeepSeek, Groq, Mistral, xAI and Ollama while retaining OpenAI, Z.AI, Anthropic, Google, OpenRouter and Qwen |
-| CLI | Adds `gateway status`, explicit `auth login`, canonical `devthink.json` persistence and the terminal logo from `docs/logo.md` |
-| Tests | Adds embedded-gateway, nested credential-redaction and configuration-path coverage |
-| Web | Adds the DevThink browser-like workbench directly under `web/`, including tabs, provider rail, stream canvas, route inspector, command palette, responsive layout and canonical ANSI branding |
-| Security | Keeps cookie capture, CAPTCHA solving, stealth automation and anti-bot evasion outside the product core |
+| Shared workspace contract | A renderer-neutral TypeScript destination model aligns chat, history, projects, providers, usage, routes and settings across the React web workbench and React Ink CLI. |
+| Real session navigation | The web chrome now renders actual local session tabs, creates and closes tabs, and exposes a local history view without removing direct routes. |
+| CLI control views | The interactive CLI now provides keyboard and slash-command access to local history, projects, providers, usage, routes and settings. |
+| Browser rail | A responsive dark local rail keeps preserved control pages discoverable from the primary workspace while retaining their bookmarkable routes. |
+| Entry refinement | The canonical ANSI mark, product wordmark, primary composer and local suggestions form a quieter first-intention surface. |
+| Design records | Version-scoped inventory, reference synthesis and parity contract documents make the product surface and local-only security boundary explicit. |
 
-## 1.0.0 — 2026-08-19
+## 1.1.10 — Entry and browser-workspace redesign
 
 ### Added
 
-DevThink v1.0.0 introduces a compact AI development CLI with a provider-neutral transport layer, streaming responses, local sessions, internal memory, 20 operational modes, local plugins, ANSI terminal design, and a loopback HTTP API.
-
-The first release supports OpenAI-compatible providers, Z.AI through its documented API endpoint, Anthropic Messages streaming, Google Gemini `streamGenerateContent`, OpenRouter, and a configurable Qwen-compatible transport. Credentials are resolved from environment variables or local configuration and are redacted from status output, sessions, logs, and release artifacts.
-
-The CLI includes `chat`, `providers`, `models`, `modes`, `config`, `auth`, `sessions`, `serve`, `init`, and `interactive` commands. Machine-readable JSON output is available for scripted calls, while the interactive terminal includes slash commands, a status panel, a spinner vocabulary, and a consistent Nord-inspired color system.
-
-### Security
-
-This release deliberately excludes browser-cookie capture, undocumented web-session automation, CAPTCHA solving, anti-bot evasion, device-fingerprint forgery, and credential extraction. Provider failures are surfaced explicitly, and the release workflow scans product files for common embedded-secret patterns before publishing.
-
-### Distribution
-
-GitHub Actions builds self-contained Bun binaries for Linux x64, macOS arm64, and Windows x64 from version tags. The workflow reads the release version from `package.json`, runs tests, generates SHA-256 checksums, and attaches artifacts to the GitHub release.
+| Area | Addition |
+| --- | --- |
+| Landing entry | A first-command introduction with the canonical DevThink ANSI mark behind an oversized wordmark and one focused command field. |
+| First-command transition | A submitted natural-language intention creates a local identity, records the first session intent and opens the workspace. |
+| Browser workspace | A two-level navigation model with browser-shaped session chrome, an active local tab, task-category pills and a persistent command rail. |
+| Visual system | Original black editorial surfaces, layered charcoal browser material, intentional orange states and orb-blue local connection signals. |
+| CLI parity | The Ink renderer now starts on the same command-first entry surface and opens the same local workspace semantics after the first command. |
+| Release packaging | Locked CLI dependencies are installed before Bun binary compilation and inside the container build so the React Ink renderer is included consistently. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenathlan/devthink",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "repository": {
     "type": "git",
     "url": "https://github.com/wenathlan/devthink"

package/terminal-ui.tsx

@@ -1,14 +1,17 @@
-/** Style: DevThink Unified Terminal Workspace — Ink renders the same sparse categories, canvas and command rail as web/TerminalWorkspace. */
+/** Design: DevThink v1.1.11 — Ink shares local workspace destinations, tab semantics and command language with the React web workbench. */
 import { Box, Text, render, useApp, useInput, useWindowSize } from "ink";
-import { useState } from "react";
-import type { DevThinkConfig } from "./config.ts";
+import { useMemo, useState } from "react";
+import { listProviders } from "./providers.ts";
+import { listSessions, type Session } from "./session.ts";
+import type { DevThinkConfig, DevThinkPaths } from "./config.ts";
 import type { ChatEvent } from "./stream.ts";
-import type { Session } from "./session.ts";
+import { isWorkspaceDestination, workspaceDestination, workspaceDestinations, type WorkspaceDestination } from "./workspace.ts";
 
-const categories = ["features", "bugs", "refactor", "snippets", "tasks", "notes", "all", "settings"] as const;
-const categoryGlyphs: Record<(typeof categories)[number], string> = { features: "ϟ", bugs: "⊗", refactor: "◌", snippets: "◫", tasks: "☑", notes: "□", all: "◉", settings: "⚙" };
+const categories = ["features", "bugs", "refactor", "snippets", "tasks", "notes", "all"] as const;
+const categoryGlyphs: Record<(typeof categories)[number], string> = { features: "ϟ", bugs: "⊗", refactor: "◌", snippets: "◫", tasks: "☑", notes: "□", all: "◉" };
+const entryArt = ["                 +++++", "          +++++++++++++++", "      ++++++     ++++++", "    +++++         +++++", "   +++++           +++++", "    +++++         +++++", "      ++++++   ++++++", "          +++++++++++++", "                 +++++"];
 
-type Runtime = { config: DevThinkConfig };
+type Runtime = { config: DevThinkConfig; paths: DevThinkPaths };
 type Execute = (prompt: string, current: Session | undefined, onEvent: (event: ChatEvent) => void) => Promise<Session | undefined>;
 type Entry = { role: "user" | "devthink" | "error"; title: string; body: string };
 
@@ -16,10 +19,40 @@ function clip(value: string, width: number): string {
   return value.length > width ? `${value.slice(0, Math.max(0, width - 1))}…` : value;
 }
 
+function TerminalEntry({ draft, provider, width }: { draft: string; provider: string; width: number }) {
+  return <Box flexDirection="column" width="100%" height="100%" minHeight={20} paddingX={2} paddingY={1} justifyContent="space-between">
+    <Box justifyContent="space-between"><Text color="#807970">✦ DEVTHINK</Text><Text color="#8ab4f8">LOCAL-FIRST WORKBENCH</Text></Box>
+    <Box flexDirection="column" alignItems="center"><Box flexDirection="column" alignItems="center">{entryArt.map((line, index) => <Text key={`${line}-${index}`} color="#382c23">{line}</Text>)}</Box><Box marginTop={-1}><Text color="#ff5f00" bold>DEVTHINK</Text></Box><Box marginTop={1}><Text color="#746f66">begin with one intention</Text></Box><Box marginTop={2}><Text color="#282724">┌{"─".repeat(Math.max(16, width - 2))}┐</Text></Box><Text color="#e8e1d7">│ <Text color="#ff5f00">›_ </Text><Text color={draft ? "#e8e1d7" : "#746f66"}>{clip(draft || "Ask anything…", Math.max(12, width - 22))}</Text><Text color="#8ab4f8"> {provider}</Text><Text color="#ff5f00"> [open]</Text> │</Text><Text color="#282724">└{"─".repeat(Math.max(16, width - 2))}┘</Text></Box>
+    <Text color="#746f66">enter opens a local workspace · esc exits</Text>
+  </Box>;
+}
+
+function projectRows(runtime: Runtime): string[] {
+  const projects = new Map<string, { title: string; sessions: number }>();
+  for (const session of listSessions(runtime.paths)) projects.set(session.workspaceId, { title: session.title, sessions: (projects.get(session.workspaceId)?.sessions || 0) + 1 });
+  return [...projects.entries()].map(([id, project]) => `${id}  ${project.sessions} ${project.sessions === 1 ? "session" : "sessions"}  ${project.title}`);
+}
+
+function viewRows(view: WorkspaceDestination, runtime: Runtime, session: Session | undefined): string[] {
+  if (view === "history") return listSessions(runtime.paths).map((item) => `${item.id}  ${item.title}`) || ["No saved sessions."];
+  if (view === "projects") return projectRows(runtime) || ["No local projects."];
+  if (view === "providers") return listProviders().map((provider) => `${provider.id}  ${provider.protocol}  ${provider.env}`);
+  if (view === "usage") {
+    const sessions = listSessions(runtime.paths);
+    return [`workspaces ${new Set(sessions.map((item) => item.workspaceId)).size}`, `sessions ${sessions.length}`, `tabs ${sessions.reduce((total, item) => total + item.tabs.length, 0)}`, `messages ${sessions.reduce((total, item) => total + item.messages.length, 0)}`];
+  }
+  if (view === "routes") return ["GET /health", "GET /providers", "GET /workspaces", "GET /usage", "POST /sessions", "POST /chat"];
+  if (view === "settings") return [`provider ${runtime.config.activeProvider || runtime.config.provider || "not configured"}`, "credentials remain in ~/.config/devthink/auth.json", "pair create emits a one-time local browser invitation"];
+  if (session) return [`workspace ${session.workspaceId}`, `session ${session.id}`, `tab ${session.activeTabId}`];
+  return ["Describe the next feature, bug or piece of work below."];
+}
+
 function TerminalWorkspace({ runtime, execute, version }: { runtime: Runtime; execute: Execute; version: string }) {
   const { exit } = useApp();
   const { columns } = useWindowSize();
+  const [entered, setEntered] = useState(false);
   const [active, setActive] = useState<(typeof categories)[number]>("all");
+  const [view, setView] = useState<WorkspaceDestination>("chat");
   const [entries, setEntries] = useState<Entry[]>([]);
   const [session, setSession] = useState<Session>();
   const [draft, setDraft] = useState("");
@@ -27,20 +60,32 @@ function TerminalWorkspace({ runtime, execute, version }: { runtime: Runtime; ex
   const provider = runtime.config.activeProvider || runtime.config.provider || "local";
   const model = runtime.config.activeModel || runtime.config.model || "not configured";
   const compact = columns < 100;
-  const tabLine = compact ? categories.map((category) => categoryGlyphs[category]).join(" ") : categories.map((category) => `${category === active ? "[" : ""}${categoryGlyphs[category]} ${category}${category === active ? "]" : ""}`).join("  ");
   const terminalWidth = Math.max(38, columns - (compact ? 2 : 6));
+  const tabLine = compact ? workspaceDestinations.map((destination) => destination.glyph).join(" ") : workspaceDestinations.map((destination) => `${destination.id === view ? "[" : ""}${destination.glyph} ${destination.label}${destination.id === view ? "]" : ""}`).join("  ");
+  const rows = useMemo(() => viewRows(view, runtime, session), [runtime, session, view]);
+
+  function openView(next: WorkspaceDestination) {
+    setView(next);
+    setEntries((current) => [...current, { role: "devthink", title: workspaceDestination(next).label, body: rows.join(" · ") }]);
+  }
 
   async function submit() {
     const prompt = draft.trim();
     if (!prompt || pending) return;
     if (prompt === "/exit" || prompt === "/quit") return exit();
-    if (prompt === "/clear") { setEntries([]); setDraft(""); return; }
-    if (prompt === "/new") { setSession(undefined); setEntries([]); setDraft(""); return; }
-    if (prompt === "/help") {
-      setEntries((current) => [...current, { role: "devthink", title: "command reference", body: "/new  /clear  /models  /modes  /sessions  /exit" }]);
+    if (!entered) {
+      setEntries([{ role: "user", title: "first intention", body: prompt }, { role: "devthink", title: "local workspace ready", body: "The first command opened a local DevThink session. Use arrows or /view to inspect local history, projects, providers, usage, routes and settings." }]);
       setDraft("");
+      setEntered(true);
       return;
     }
+    if (prompt === "/clear") { setEntries([]); setDraft(""); return; }
+    if (prompt === "/new") { setSession(undefined); setEntries([]); setView("chat"); setDraft(""); return; }
+    const viewMatch = prompt.match(/^\/(?:view\s+)?(chat|history|projects|providers|usage|routes|settings)$/);
+    if (viewMatch && isWorkspaceDestination(viewMatch[1])) { openView(viewMatch[1]); setDraft(""); return; }
+    if (prompt === "/sessions") { openView("history"); setDraft(""); return; }
+    if (prompt === "/help") { setEntries((current) => [...current, { role: "devthink", title: "command reference", body: "/view chat|history|projects|providers|usage|routes|settings  /new  /clear  /models  /modes  /sessions  /exit" }]); setDraft(""); return; }
+    setView("chat");
     setEntries((current) => [...current, { role: "user", title: active, body: prompt }, { role: "devthink", title: "connecting", body: "waiting for local gateway events…" }]);
     setDraft("");
     setPending(true);
@@ -59,24 +104,29 @@ function TerminalWorkspace({ runtime, execute, version }: { runtime: Runtime; ex
 
   useInput((input, key) => {
     if (key.escape || (key.ctrl && input === "c")) return exit();
-    if (key.leftArrow || key.tab) return setActive((current) => categories[(categories.indexOf(current) + categories.length - 1) % categories.length]);
-    if (key.rightArrow) return setActive((current) => categories[(categories.indexOf(current) + 1) % categories.length]);
     if (key.return) return void submit();
     if (key.backspace || key.delete) return setDraft((current) => current.slice(0, -1));
+    if (entered && key.upArrow) return setView((current) => workspaceDestinations[(workspaceDestinations.findIndex((item) => item.id === current) + workspaceDestinations.length - 1) % workspaceDestinations.length].id);
+    if (entered && key.downArrow) return setView((current) => workspaceDestinations[(workspaceDestinations.findIndex((item) => item.id === current) + 1) % workspaceDestinations.length].id);
+    if (entered && view === "chat" && (key.leftArrow || key.tab)) return setActive((current) => categories[(categories.indexOf(current) + categories.length - 1) % categories.length]);
+    if (entered && view === "chat" && key.rightArrow) return setActive((current) => categories[(categories.indexOf(current) + 1) % categories.length]);
     if (!key.ctrl && !key.meta && input) setDraft((current) => current + input);
   });
 
+  if (!entered) return <TerminalEntry draft={draft} provider={provider} width={terminalWidth} />;
+
   return <Box flexDirection="column" width="100%" height="100%" minHeight={20} paddingX={compact ? 1 : 3} paddingY={1}>
-    <Text color="#a19a91">{clip(`▣ DEVTHINK  ${tabLine}`, terminalWidth - 2)} <Text color="#8ab4f8">{provider.toUpperCase()}</Text></Text>
+    <Box justifyContent="space-between"><Text color="#a19a91">✦ DEVTHINK <Text color="#746f66">/ {workspaceDestination(view).label}</Text></Text><Text color="#8ab4f8">◉ {provider.toUpperCase()}</Text></Box>
     <Text color="#282724">{"─".repeat(terminalWidth)}</Text>
-    <Text color="#e8e1d7">{categoryGlyphs[active]} {active.toUpperCase()} ENTRIES <Text color="#746f66">· {entries.length} entries · {clip(model, 22)}</Text></Text>
-    <Box flexDirection="column" flexGrow={1} justifyContent={entries.length ? "flex-start" : "center"} alignItems={entries.length ? "flex-start" : "center"}>
-      {entries.length ? entries.map((entry, index) => <Box key={`${entry.title}-${index}`} flexDirection="column" marginBottom={1} paddingLeft={1}><Box><Text color={entry.role === "user" ? "#ff5f00" : entry.role === "error" ? "#ff6b6b" : "#8ab4f8"}>▎ {entry.title.toUpperCase()}</Text></Box><Box><Text color="#e8e1d7">{clip(entry.body, terminalWidth - 6)}</Text></Box></Box>) : <Box flexDirection="column" alignItems="center"><Box><Text color="#4b4842">no {active === "all" ? "entries" : active} planned yet.</Text></Box><Box><Text color="#625c54">think {active === "all" ? "feature add a local provider" : `${active} …`}</Text></Box><Box marginTop={2}><Text color="#ff5f00" bold>DEVTHINK</Text></Box></Box>}
+    <Text color="#746f66">{clip(tabLine, terminalWidth)}</Text>
+    <Box marginTop={1}><Text color="#e8e1d7">{workspaceDestination(view).glyph} {workspaceDestination(view).label.toUpperCase()} <Text color="#746f66">· {clip(model, 22)}</Text></Text></Box>
+    <Box flexDirection="column" flexGrow={1} justifyContent={entries.length && view === "chat" ? "flex-start" : "center"} alignItems={entries.length && view === "chat" ? "flex-start" : "center"}>
+      {view !== "chat" ? rows.map((row, index) => <Text key={`${view}-${index}`} color={index === 0 ? "#e8e1d7" : "#746f66"}>▎ {clip(row, terminalWidth - 4)}</Text>) : entries.length ? entries.map((entry, index) => <Box key={`${entry.title}-${index}`} flexDirection="column" marginBottom={1} paddingLeft={1}><Box><Text color={entry.role === "user" ? "#ff5f00" : entry.role === "error" ? "#ff6b6b" : "#8ab4f8"}>▎ {entry.title.toUpperCase()}</Text></Box><Box><Text color="#e8e1d7">{clip(entry.body, terminalWidth - 6)}</Text></Box></Box>) : <Box flexDirection="column" alignItems="center"><Text color="#4b4842">Nothing is active yet.</Text><Text color="#625c54">Describe the next feature, bug or piece of work below.</Text><Box marginTop={2}><Text color="#ff5f00" bold>DEVTHINK</Text></Box></Box>}
     </Box>
     <Text color="#282724">┌{"─".repeat(Math.max(16, terminalWidth - 2))}┐</Text>
-    <Text color="#e8e1d7">│ <Text color="#ff5f00">›_ </Text><Text color={draft ? "#e8e1d7" : "#746f66"}>{clip(draft || `think ${active === "all" ? "feature, bug, task, note…" : `${active} …`}`, Math.max(12, terminalWidth - 20))}</Text><Text color="#8ab4f8"> {provider}</Text><Text color="#ff5f00"> [run]</Text> │</Text>
+    <Text color="#e8e1d7">│ <Text color="#ff5f00">›_ </Text><Text color={draft ? "#e8e1d7" : "#746f66"}>{clip(draft || (view === "chat" ? `Ask DevThink about ${active === "all" ? "the work…" : `${active}…`}` : `Type /view chat to return…`), Math.max(12, terminalWidth - 20))}</Text><Text color="#8ab4f8"> {provider}</Text><Text color="#ff5f00"> [run]</Text> │</Text>
     <Text color="#282724">└{"─".repeat(Math.max(16, terminalWidth - 2))}┘</Text>
-    <Text color="#746f66">provider credentials stay in the local cli · v{version} · esc exit</Text>
+    <Text color="#746f66">↑↓ destinations · ←→ categories · /help commands · v{version} · esc exit</Text>
   </Box>;
 }
 

package/workspace.ts

@@ -0,0 +1,20 @@
+/** DevThink workspace contract: renderer-neutral destination names, glyphs and labels shared by web and Ink. */
+export const workspaceDestinations = [
+  { id: "chat", label: "chat", glyph: "◉" },
+  { id: "history", label: "history", glyph: "◷" },
+  { id: "projects", label: "projects", glyph: "▦" },
+  { id: "providers", label: "providers", glyph: "◌" },
+  { id: "usage", label: "usage", glyph: "◫" },
+  { id: "routes", label: "routes", glyph: "⌘" },
+  { id: "settings", label: "settings", glyph: "⚙" },
+] as const;
+
+export type WorkspaceDestination = (typeof workspaceDestinations)[number]["id"];
+
+export function isWorkspaceDestination(value: string): value is WorkspaceDestination {
+  return workspaceDestinations.some((destination) => destination.id === value);
+}
+
+export function workspaceDestination(value: WorkspaceDestination) {
+  return workspaceDestinations.find((destination) => destination.id === value) || workspaceDestinations[0];
+}