@wenathlan/devthink 1.1.13 → 1.1.14

package/CHANGELOG.md

@@ -1,4 +1,16 @@
 # DevThink release notes
+## 1.1.14 — Route and local identity refinement
+
+### Added
+
+| Area | Addition |
+| --- | --- |
+| Portable Home route | Relative static builds preserve the Vite `./` base and resolve the Home route at `/` without treating `.` as a router prefix. |
+| CLI-owned person | The browser now projects the authenticated CLI-owned public user and device identity after pairing instead of storing a second browser identity. |
+| Shared public ID | `devthink identity --id <value>` and the paired web Settings panel update the same local public identifier, with compact 10–15 character validation. |
+| Shared route index | Web and CLI route maps now list the authenticated `GET` and `PUT /identity` operations alongside preferences and workspace routes. |
+| Documentation boundary | Workbench design and deployment notes moved from `/web` to `docs/`, leaving the static application tree free of planning documents. |
+
 ## 1.1.13 — Flat domain consolidation
 
 ### Added
@@ -11,6 +23,10 @@
 | Compact visual grammar | Historical workspace CSS overrides were replaced with one terminal workspace system for entry, tabs, rail, command bar, pairing, controls and error states. |
 | Control frame | Providers, projects, routes and usage share one explicitly named root control shell without a generic application directory. |
 | Preserved parity boundary | Web and Ink retain the same safe workspace destinations, settings and local gateway interactions; provider credentials remain CLI-owned. |
+| Portable Home route | Relative Vite builds now retain `./` as a relative base and normalize it to the Home router base, so `/` resolves the first workbench screen in portable static artifacts. |
+| Same local person | A paired browser reads the CLI-owned public user and device IDs through the authenticated gateway instead of creating a second browser profile. |
+| Public ID controls | `devthink identity --id <value>` and the paired web Settings panel update the same local public ID, preserving compact workspace data and temporary browser sessions. |
+| Documentation boundary | Workbench deployment and design records now live under `docs/`, leaving `/web` exclusively for browser application artifacts. |
 
 ## 1.1.12 — Page domains and tabbed interaction
 

package/devthink.ts

@@ -8,7 +8,7 @@ import { createMemoryStore, memorySummary } from "./memory.ts";
 import { listModes, modePrompt, resolveMode } from "./modes.ts";
 import { listModels, listProviders, streamChat } from "./providers.ts";
 import { appendMessage, createSession, exportSession, listSessions, loadSession, type Session } from "./session.ts";
-import { createPairing, createPairingLink, getIdentity, pairingStatus, revokeBrowserSessions } from "./identity.ts";
+import { createPairing, createPairingLink, getIdentity, pairingStatus, revokeBrowserSessions, setIdentityUserId } from "./identity.ts";
 import { readPreferences, savePreference } from "./storage.ts";
 import type { ChatEvent } from "./stream.ts";
 import { banner, box, colors, formatConfig, formatEvent, statusBar } from "./ui.ts";
@@ -74,7 +74,7 @@ function printHelp(): void {
     "  auth status               Show redacted configured credential sources",
     "  auth clear <provider>     Remove a stored provider credential",
     "  auth migrate              Move legacy config credentials into auth.json",
-    "  identity                  Show local public user and device identifiers",
+    "  identity [--id <value>]   Show or set the local public user identifier",
     "  pair create               Create an automatic one-time link for the web workbench",
     "  pair revoke               Revoke current paired browser sessions",
     "  sync status               Show local snapshot and remote adapter readiness",
@@ -212,13 +212,15 @@ async function handleAuth(parsed: ParsedArgs, runtime: ReturnType<typeof loadRun
   throw new Error("Supported auth actions: login, status, clear, migrate.");
 }
 
-function handleIdentity(runtime: ReturnType<typeof loadRuntime>): void {
-  console.log(JSON.stringify({ identity: getIdentity(runtime.paths), pairing: pairingStatus(runtime.paths) }, null, 2));
+function handleIdentity(parsed: ParsedArgs, runtime: ReturnType<typeof loadRuntime>): void {
+  const requestedUserId = stringFlag(parsed, "id");
+  const identity = requestedUserId ? setIdentityUserId(runtime.paths, requestedUserId) : getIdentity(runtime.paths);
+  console.log(JSON.stringify({ identity, pairing: pairingStatus(runtime.paths) }, null, 2));
 }
 
 function handlePairing(parsed: ParsedArgs, runtime: ReturnType<typeof loadRuntime>): void {
   const action = parsed.positional[1] || "create";
-  if (action === "status") return handleIdentity(runtime);
+  if (action === "status") return handleIdentity(parsed, runtime);
   if (action === "revoke") return console.log(`Revoked ${revokeBrowserSessions(runtime.paths)} paired browser session(s).`);
   if (action !== "create") throw new Error("Supported pair actions: create, status, revoke.");
   const pairing = createPairing(runtime.paths);
@@ -278,7 +280,7 @@ function handleUsage(runtime: ReturnType<typeof loadRuntime>): void {
 }
 
 function handleRoutes(): void {
-  console.log(["web: /", "web: /providers", "web: /projects", "web: /routes", "web: /usage", "web: /w/:workspaceId/s/:sessionId/t/:tabId/:sectionId", "gateway: GET /health", "gateway: GET /providers", "gateway: GET /workspaces", "gateway: GET /usage", "gateway: GET /preferences", "gateway: PATCH /preferences", "gateway: POST /sessions", "gateway: POST /chat"].join("\n"));
+  console.log(["web: /", "web: /providers", "web: /projects", "web: /routes", "web: /usage", "web: /w/:workspaceId/s/:sessionId/t/:tabId/:sectionId", "gateway: GET /health", "gateway: GET /identity", "gateway: PUT /identity", "gateway: GET /providers", "gateway: GET /workspaces", "gateway: GET /usage", "gateway: GET /preferences", "gateway: PATCH /preferences", "gateway: POST /sessions", "gateway: POST /chat"].join("\n"));
 }
 
 async function interactive(runtime: ReturnType<typeof loadRuntime>): Promise<void> {
@@ -351,7 +353,7 @@ export async function main(argv = process.argv.slice(2)): Promise<void> {
   if (command === "modes") return console.log(listModes().map((mode) => `${mode.id}  ${mode.purpose}`).join("\n"));
   if (command === "config") return handleConfig(parsed, runtime);
   if (command === "auth") return handleAuth(parsed, runtime);
-  if (command === "identity") return handleIdentity(runtime);
+  if (command === "identity") return handleIdentity(parsed, runtime);
   if (command === "pair") return handlePairing(parsed, runtime);
   if (command === "sync") return handleSync(parsed, runtime);
   if (command === "gateway") return handleGateway(runtime);

package/identity.ts

@@ -13,6 +13,12 @@ const codeLength = 8;
 const pairingLifetimeMs = 5 * 60 * 1000;
 const browserSessionLifetimeMs = 15 * 60 * 1000;
 
+export function normalizePublicUserId(value: string): string {
+  const userId = value.trim().toLowerCase();
+  if (!/^[a-z][a-z0-9]{9,14}$/.test(userId)) throw new Error("Public user ID must contain 10-15 lowercase letters or numbers and start with a letter.");
+  return userId;
+}
+
 function digest(value: string): string {
   return createHash("sha256").update(value).digest("hex");
 }
@@ -44,6 +50,20 @@ export function getIdentity(paths: DevThinkPaths): DevThinkIdentity {
   return identity;
 }
 
+/** Updates the public local-person identifier and migrates active local pairing records. */
+export function setIdentityUserId(paths: DevThinkPaths, requestedUserId: string): DevThinkIdentity {
+  const current = getIdentity(paths);
+  const userId = normalizePublicUserId(requestedUserId);
+  if (current.userId === userId) return current;
+  const next = { ...current, userId };
+  privateWrite(paths.identity, next);
+  const store = readStore(paths);
+  for (const record of store.pairings) if (record.userId === current.userId) record.userId = userId;
+  for (const session of store.sessions) if (session.userId === current.userId) session.userId = userId;
+  writeStore(paths, store);
+  return next;
+}
+
 function readStore(paths: DevThinkPaths): PairingStore {
   try {
     if (existsSync(paths.pairings)) {

package/package.json

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

package/server.ts

@@ -3,7 +3,7 @@ import { randomInt } from "node:crypto";
 import { isAllowedOrigin } from "./compatibility.ts";
 import { listModels, listProviders, streamChat, type ChatMessage } from "./providers.ts";
 import { ensurePaths, resolvePaths, saveConfig, type DevThinkConfig, type DevThinkPaths } from "./config.ts";
-import { consumePairing, getIdentity, pairingStatus, revokeBrowserSessions, verifyBrowserSession } from "./identity.ts";
+import { consumePairing, getIdentity, pairingStatus, revokeBrowserSessions, setIdentityUserId, verifyBrowserSession } from "./identity.ts";
 import { appendMessage, createSession, createTab, listSessions, loadSession, loadWorkspace, updateTab, type SessionSection } from "./session.ts";
 import { readPreferences, savePreference } from "./storage.ts";
 
@@ -138,6 +138,12 @@ async function route(request: IncomingMessage, response: ServerResponse, config:
   const browserSession = origin ? verifyBrowserSession(paths, bearerToken(request)) : undefined;
   if (origin && !browserSession) return writeJson(response, 401, { error: "A current browser pairing token is required." }, origin);
   if (request.method === "GET" && url.pathname === "/identity") return writeJson(response, 200, { identity: getIdentity(paths), pairing: pairingStatus(paths) }, origin);
+  if (request.method === "PUT" && url.pathname === "/identity") {
+    const body = await readBody(request);
+    if (typeof body.userId !== "string") return writeJson(response, 400, { error: "userId is required." }, origin);
+    try { return writeJson(response, 200, { identity: setIdentityUserId(paths, body.userId), pairing: pairingStatus(paths) }, origin); }
+    catch (error) { return writeJson(response, 400, { error: error instanceof Error ? error.message : "Identity update was rejected." }, origin); }
+  }
   if (request.method === "POST" && url.pathname === "/pairings/revoke") return writeJson(response, 200, { revoked: revokeBrowserSessions(paths) }, origin);
   if (request.method === "GET" && url.pathname === "/sessions") return writeJson(response, 200, { sessions: listSessions(paths) }, origin);
   if (request.method === "GET" && url.pathname === "/workspaces") {

package/terminal-ui.tsx

@@ -1,9 +1,10 @@
-/** Design: DevThink v1.1.13 — Ink shares the compact local workspace grammar, destinations, settings and command language with the flat React workbench. */
+/** Design: DevThink v1.1.14 — Ink shares the compact local workspace grammar, identity, destinations, settings and command language with the paired React workbench. */
 import { Box, Text, render, useApp, useInput, useWindowSize } from "ink";
 import { useMemo, useState } from "react";
 import { listProviders } from "./providers.ts";
 import { listSessions, type Session } from "./session.ts";
 import { readPreferences, savePreference } from "./storage.ts";
+import { getIdentity } from "./identity.ts";
 import type { DevThinkConfig, DevThinkPaths } from "./config.ts";
 import type { ChatEvent } from "./stream.ts";
 import { isWorkspaceDestination, workspaceDestination, workspaceDestinations, type WorkspaceDestination } from "./workspace.ts";
@@ -20,9 +21,9 @@ 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 }) {
+function TerminalEntry({ draft, provider, userId, width }: { draft: string; provider: string; userId: 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 justifyContent="space-between"><Text color="#807970">✦ DEVTHINK</Text><Text color="#8ab4f8">{userId}</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>;
@@ -45,7 +46,8 @@ function viewRows(view: WorkspaceDestination, runtime: Runtime, session: Session
   if (view === "routes") return ["GET /health", "GET /providers", "GET /workspaces", "GET /usage", "GET /preferences", "PATCH /preferences", "POST /sessions", "POST /chat"];
   if (view === "settings") {
     const preferences = Object.fromEntries(Object.entries(readPreferences(runtime.paths)).map(([key, preference]) => [key, preference.value]));
-    return [`theme ${preferences.theme || "dark"}`, `railMode ${preferences.railMode || "auto"}`, `interfaceZoom ${preferences.interfaceZoom || "100"}`, "edit: /settings set theme dark|light", "edit: /settings set railMode always|auto|off", "edit: /settings set interfaceZoom 80-150", "credentials remain in ~/.config/devthink/auth.json"];
+    const identity = getIdentity(runtime.paths);
+    return [`userId ${identity.userId}`, `deviceId ${identity.deviceId}`, `theme ${preferences.theme || "dark"}`, `railMode ${preferences.railMode || "auto"}`, `interfaceZoom ${preferences.interfaceZoom || "100"}`, "edit identity: devthink identity --id <10-15 lowercase chars>", "edit: /settings set theme dark|light", "edit: /settings set railMode always|auto|off", "edit: /settings set interfaceZoom 80-150", "credentials remain in ~/.config/devthink/auth.json"];
   }
   if (session) return [`workspace ${session.workspaceId}`, `session ${session.id}`, `tab ${session.activeTabId}`];
   return ["Describe the next feature, bug or piece of work below."];
@@ -63,6 +65,7 @@ function TerminalWorkspace({ runtime, execute, version }: { runtime: Runtime; ex
   const [pending, setPending] = useState(false);
   const [preferenceRevision, setPreferenceRevision] = useState(0);
   const provider = runtime.config.activeProvider || runtime.config.provider || "local";
+  const identity = getIdentity(runtime.paths);
   const model = runtime.config.activeModel || runtime.config.model || "not configured";
   const compact = columns < 100;
   const terminalWidth = Math.max(38, columns - (compact ? 2 : 6));
@@ -127,10 +130,10 @@ function TerminalWorkspace({ runtime, execute, version }: { runtime: Runtime; ex
     if (!key.ctrl && !key.meta && input) setDraft((current) => current + input);
   });
 
-  if (!entered) return <TerminalEntry draft={draft} provider={provider} width={terminalWidth} />;
+  if (!entered) return <TerminalEntry draft={draft} provider={provider} userId={identity.userId} width={terminalWidth} />;
 
   return <Box flexDirection="column" width="100%" height="100%" minHeight={20} paddingX={compact ? 1 : 3} paddingY={1}>
-    <Box justifyContent="space-between"><Text color="#a19a91">✦ DEVTHINK <Text color="#746f66">/ {workspaceDestination(view).label}</Text></Text><Text color="#8ab4f8">◉ {provider.toUpperCase()}</Text></Box>
+    <Box justifyContent="space-between"><Text color="#a19a91">✦ DEVTHINK <Text color="#746f66">/ {workspaceDestination(view).label}</Text></Text><Text color="#8ab4f8">◉ {identity.userId}</Text></Box>
     <Text color="#282724">{"─".repeat(terminalWidth)}</Text>
     <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>