From 4d2ee284ff171e0fdbca8d967a6f1416612ae1e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Padez?= <andre.padez@gmail.com>
Date: Tue, 25 Aug 2026 07:46:29 +0000
Subject: [PATCH] the card shows which directory it is

a commander's card gave its name and its cost and nothing to connect it to
`commanders/<n>/` on disk. the owner is the only person who will ever look
at that directory, and finding out which one a card was meant opening it
and reading a path out of a tool call.

#40 beside the title, monospaced and muted, with the full path on hover.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Officer-Session: 656f5c85-e49a-4f1f-b9f3-042a04b4d043
---
 src/servers/api/command-hq/router.ts                   |  3 +++
 .../officerdev/src/apps/CommandHQ/CommandHqGrid.tsx    | 10 ++++++++++
 src/workspaces/officerdev/src/apps/CommandHQ/types.ts  |  2 ++
 3 files changed, 15 insertions(+)

diff --git a/src/servers/api/command-hq/router.ts b/src/servers/api/command-hq/router.ts
index 74301230..1e40c8f3 100644
--- a/src/servers/api/command-hq/router.ts
+++ b/src/servers/api/command-hq/router.ts
@@ -265,6 +265,9 @@ commandHqRouter.get('/commanders', async (ctx) => {
       // until then the transcript still reports the opening brief, and the row is the only source that is
       // right from the start.
       ...(row.name ? { title: row.name } : {}),
+      // Its directory name, which is also its id. Shown beside the title so the owner can tell which
+      // `commanders/<n>/` on disk a card is, without opening it and reading a path out of a tool call.
+      dirName: row.dirName,
       categoryId: row.categoryId,
       tagIds: tagsByRow.get(row.id) ?? [],
       running: runningById.get(row.sessionId!) ?? false,
diff --git a/src/workspaces/officerdev/src/apps/CommandHQ/CommandHqGrid.tsx b/src/workspaces/officerdev/src/apps/CommandHQ/CommandHqGrid.tsx
index 3a31678e..1438e0ff 100644
--- a/src/workspaces/officerdev/src/apps/CommandHQ/CommandHqGrid.tsx
+++ b/src/workspaces/officerdev/src/apps/CommandHQ/CommandHqGrid.tsx
@@ -72,6 +72,16 @@ const Card = ({ commander, to, selected, onDeleted }: CardProps) => {
       <div className="flex items-center gap-2 pr-6">
         <StatusDot watcherRunning={commander.watcherRunning === true} watcherArmed={commander.watcherArmed} />
         <span className="truncate text-sm font-medium">{commander.title}</span>
+        {/* Its directory name, which is its id. Nobody but the owner needs it, and the owner wants to know
+            which `commanders/<n>/` they are looking at without opening the thing to find out. */}
+        {commander.dirName && (
+          <span
+            className="shrink-0 font-mono text-[11px] text-muted-foreground"
+            title={`commanders/${commander.dirName}`}
+          >
+            #{commander.dirName}
+          </span>
+        )}
       </div>
       <div className="flex items-center justify-between text-xs text-muted-foreground">
         <span>
diff --git a/src/workspaces/officerdev/src/apps/CommandHQ/types.ts b/src/workspaces/officerdev/src/apps/CommandHQ/types.ts
index 81a2e3fd..58d642c9 100644
--- a/src/workspaces/officerdev/src/apps/CommandHQ/types.ts
+++ b/src/workspaces/officerdev/src/apps/CommandHQ/types.ts
@@ -33,6 +33,8 @@ export type CommandHqCategoryFilter = number | 'none' | undefined;
 export type CommandHqCommander = {
   id: string;
   title: string;
+  /** Its directory under `commanders/`, which is also its id — shown on the card beside the title. */
+  dirName?: string | null;
   cwd: string;
   createdAt: string;
   updatedAt: string;