@gaia-ai/addon-herdr 0.9.1 → 0.10.0

package/dist/src/config.d.ts

@@ -13,6 +13,12 @@ export interface StateConfig {
      */
     tabLabel?: string;
     workspaceLabel?: string;
+    /**
+     * Root-pane (panel) label template applied via `herdr pane rename` after the
+     * state tab is created (GAIA-374). Default `{title}`. Distinct from
+     * {@link tabLabel}: stop/state matching still anchors on the tab label.
+     */
+    panelLabel?: string;
     /** Extra layout panes (diff/logs); NOT the agent command. */
     panes?: PaneSpec[];
 }
@@ -47,6 +53,7 @@ export interface HerdrExecutorOptions {
 export interface ResolvedConfig {
     tabLabel: string;
     workspaceLabel: string;
+    panelLabel: string;
     panes: PaneSpec[];
 }
 export declare const BUILTIN_DEFAULTS: ResolvedConfig;

package/dist/src/config.js

@@ -1,6 +1,7 @@
 export const BUILTIN_DEFAULTS = {
     tabLabel: '{identifier} · {titleSlug}',
     workspaceLabel: '{repoName}',
+    panelLabel: '{title}',
     panes: [],
 };
 export function resolveStateConfig(options, state) {
@@ -11,6 +12,7 @@ export function resolveStateConfig(options, state) {
         workspaceLabel: stateCfg.workspaceLabel ??
             base.workspaceLabel ??
             BUILTIN_DEFAULTS.workspaceLabel,
+        panelLabel: stateCfg.panelLabel ?? base.panelLabel ?? BUILTIN_DEFAULTS.panelLabel,
         panes: stateCfg.panes ?? base.panes ?? BUILTIN_DEFAULTS.panes,
     };
 }

package/dist/src/index.js

@@ -1,6 +1,6 @@
 import { existsSync } from 'node:fs';
 import { exec, shellQuote, slugify } from '@gaia-ai/core';
-import { resolveStateConfig, } from './config.js';
+import { renderTemplate, resolveStateConfig, } from './config.js';
 import { forceRemoveDir, restoreWritable } from './fs.js';
 import { applyPaneLayout, isRecord, parseJson, } from './pane-layout.js';
 import { AGENT_SHELL_ENV, envArgs } from './panes.js';
@@ -679,6 +679,15 @@ export class HerdrExecutor {
             '--no-focus',
             ...envArgs(AGENT_SHELL_ENV),
         ]));
+        // GAIA-374: panel label on the state root pane (best-effort). Tab --label
+        // above stays the stop/state matching string and is intentionally not the
+        // resolved StateConfig.tabLabel path.
+        await this.execHerdr([
+            'pane',
+            'rename',
+            rootPaneId,
+            renderTemplate(cfg.panelLabel, vars),
+        ]).catch(() => { });
         try {
             // 4+5. Run the agent command in the root pane, then split each configured
             // pane — the shared pane-layout primitive (same code path as the workspace

package/dist/src/workspace.d.ts

@@ -19,13 +19,39 @@ export type GitExec = (args: string[]) => Promise<string>;
  * (the executor) pre-assembles `KEY='value' <agent>` env prefixes whose values
  * may legitimately contain braces (spec D2).
  *
+ * GAIA-374: `tabLabel` / `panelLabel` are chrome strings applied after the
+ * layout via `herdr tab rename` / `herdr pane rename` ("panel label" = pane
+ * label). Defaults ship when keys are absent on an active layout; `open: {}`
+ * remains the full opt-out (no command, no splits, no labels). The overview
+ * **tab** default is `{identifier} · {title}` with `{title}` capped at
+ * {@link OPEN_TAB_TITLE_MAX} so the always-visible tab bar stays readable;
+ * the pane/panel label still gets the full title.
+ *
  * Unset → {@link DEFAULT_OPEN_LAYOUT}, the ticket deep link. `{}` → the bare
  * empty tab (`applyPaneLayout` issues no calls for an empty layout).
  */
 export interface OpenLayout {
     command?: string;
     panes?: PaneSpec[];
+    /**
+     * Overview tab label template. Default: `{identifier} · {title}` (title
+     * truncated to {@link OPEN_TAB_TITLE_MAX} when rendering).
+     */
+    tabLabel?: string;
+    /**
+     * Overview root-pane label template (`herdr pane rename`). Default:
+     * `{identifier} · {title}` (full title).
+     */
+    panelLabel?: string;
 }
+/** Max `{title}` length substituted into the overview **tab** label (GAIA-374). */
+export declare const OPEN_TAB_TITLE_MAX = 30;
+/** Cap overview-tab `{title}` and append `...` when truncated. */
+export declare function truncateOpenTabTitle(title: string): string;
+/** Default overview tab chrome (GAIA-374) — always-visible tab bar identity. */
+export declare const DEFAULT_OPEN_TAB_LABEL = "{identifier} \u00B7 {title}";
+/** Default overview pane/panel label template (GAIA-374). */
+export declare const DEFAULT_OPEN_PANEL_LABEL = "{identifier} \u00B7 {title}";
 /**
  * The shipped default open layout (GAIA-234): a fresh worktree's initial pane
  * renders the ticket it belongs to instead of an anonymous shell prompt.
@@ -72,8 +98,9 @@ export declare class HerdrWorkspace implements GaiaWorkspace {
     private readonly open;
     private readonly logger;
     /**
-     * Root pane ids captured by a FRESH `ensure` create, keyed by worktree path,
+     * Root panes captured by a FRESH `ensure` create, keyed by worktree path,
      * awaiting {@link applyOpenLayout} (GAIA-237). One-shot: consumed on apply.
+     * Optional `tabId` powers the GAIA-374 overview tab rename.
      */
     private readonly pendingRootPanes;
     /** Herdr-backed intent-level agent host for `gaia ui` (GAIA-190). */
@@ -115,6 +142,10 @@ export declare class HerdrWorkspace implements GaiaWorkspace {
      * The pane's cwd is the worktree checkout, passed explicitly on the splits
      * (the root pane's cwd is already the checkout).
      *
+     * GAIA-374 then renames the overview tab (`{identifier} · {title}` with title
+     * capped at {@link OPEN_TAB_TITLE_MAX}) and root pane (full
+     * `{identifier} · {title}`) — fresh-create only, same gate as the layout.
+     *
      * NO stored pane ⇒ silent no-op. That is the reused-worktree case: `ensure`
      * took the reuse branch, there is no fresh root pane, and re-applying would
      * start a duplicate editor process on reattach (GAIA-139). The capture is
@@ -127,7 +158,15 @@ export declare class HerdrWorkspace implements GaiaWorkspace {
     applyOpenLayout(path: string, ctx: {
         identifier: string;
         branch: string;
+        title: string;
     }): Promise<void>;
+    /**
+     * Best-effort overview tab + pane renames (GAIA-374). Skipped for the
+     * `open: {}` opt-out. A missing create-time tab id falls back to `pane get`.
+     */
+    private applyOverviewLabels;
+    /** `pane get <id>` → `result.pane.tab_id` when present. */
+    private resolveTabIdForPane;
 }
 export declare function herdrWorkspace(opts?: {
     /**

package/dist/src/workspace.js

@@ -5,6 +5,19 @@ import { herdrAgentHost } from './agents.js';
 import { renderTemplate } from './config.js';
 import { applyPaneLayout, isRecord, parseJson } from './pane-layout.js';
 import { deriveHerdrRoot } from './root-anchor.js';
+/** Max `{title}` length substituted into the overview **tab** label (GAIA-374). */
+export const OPEN_TAB_TITLE_MAX = 30;
+/** Cap overview-tab `{title}` and append `...` when truncated. */
+export function truncateOpenTabTitle(title) {
+    if (title.length <= OPEN_TAB_TITLE_MAX) {
+        return title;
+    }
+    return `${title.slice(0, OPEN_TAB_TITLE_MAX)}...`;
+}
+/** Default overview tab chrome (GAIA-374) — always-visible tab bar identity. */
+export const DEFAULT_OPEN_TAB_LABEL = '{identifier} · {title}';
+/** Default overview pane/panel label template (GAIA-374). */
+export const DEFAULT_OPEN_PANEL_LABEL = '{identifier} · {title}';
 /**
  * The shipped default open layout (GAIA-234): a fresh worktree's initial pane
  * renders the ticket it belongs to instead of an anonymous shell prompt.
@@ -19,6 +32,8 @@ import { deriveHerdrRoot } from './root-anchor.js';
  */
 export const DEFAULT_OPEN_LAYOUT = {
     command: 'gaia ui --ticket {identifier}',
+    tabLabel: DEFAULT_OPEN_TAB_LABEL,
+    panelLabel: DEFAULT_OPEN_PANEL_LABEL,
 };
 const defaultExec = (args) => exec('herdr', args);
 const defaultGitExec = (args) => exec('git', args);
@@ -61,18 +76,22 @@ function parseWorktreePath(output, command) {
     return path;
 }
 /**
- * Parse `worktree create` → the created tab's root pane id
- * (`result.root_pane.pane_id`), sibling of {@link parseWorktreePath}. Returns
- * null when the create JSON carries none, so the open-layout caller can skip
+ * Parse `worktree create` → root pane id (+ optional tab id for GAIA-374
+ * overview tab rename). Sibling of {@link parseWorktreePath}. Returns null when
+ * the create JSON carries no pane id, so the open-layout caller can skip
  * silently rather than throw (best-effort).
  */
 function parseWorktreeRootPane(output) {
     const parsed = parseJson(output, 'worktree create');
-    const paneId = isRecord(parsed)
-        ? parsed.result
-            ?.root_pane?.pane_id
-        : undefined;
-    return typeof paneId === 'string' && paneId ? paneId : null;
+    if (!isRecord(parsed) || !isRecord(parsed.result))
+        return null;
+    const result = parsed.result;
+    const paneId = result.root_pane?.pane_id;
+    if (typeof paneId !== 'string' || !paneId)
+        return null;
+    const tabIdRaw = result.root_pane?.tab_id ?? result.tab?.tab_id;
+    const tabId = typeof tabIdRaw === 'string' && tabIdRaw ? tabIdRaw : undefined;
+    return tabId !== undefined ? { paneId, tabId } : { paneId };
 }
 /** Git-safe branch validation: safe ref chars only, no leading dot, no `..`. */
 function validateBranch(branch) {
@@ -91,8 +110,9 @@ export class HerdrWorkspace {
     open;
     logger;
     /**
-     * Root pane ids captured by a FRESH `ensure` create, keyed by worktree path,
+     * Root panes captured by a FRESH `ensure` create, keyed by worktree path,
      * awaiting {@link applyOpenLayout} (GAIA-237). One-shot: consumed on apply.
+     * Optional `tabId` powers the GAIA-374 overview tab rename.
      */
     pendingRootPanes = new Map();
     /** Herdr-backed intent-level agent host for `gaia ui` (GAIA-190). */
@@ -254,9 +274,9 @@ export class HerdrWorkspace {
         // pane command needed a sentinel wait loop. The conductor now calls
         // `applyOpenLayout` after the hook; a create with no root pane in its output
         // stores nothing, so the layout is a no-op exactly as before.
-        const rootPaneId = parseWorktreeRootPane(createOutput);
-        if (rootPaneId) {
-            this.pendingRootPanes.set(path, rootPaneId);
+        const pending = parseWorktreeRootPane(createOutput);
+        if (pending) {
+            this.pendingRootPanes.set(path, pending);
         }
         // The `after_create` hook is run by the executor (GAIA-84), not here — the
         // workspace only reports that it created a fresh worktree.
@@ -269,6 +289,10 @@ export class HerdrWorkspace {
      * The pane's cwd is the worktree checkout, passed explicitly on the splits
      * (the root pane's cwd is already the checkout).
      *
+     * GAIA-374 then renames the overview tab (`{identifier} · {title}` with title
+     * capped at {@link OPEN_TAB_TITLE_MAX}) and root pane (full
+     * `{identifier} · {title}`) — fresh-create only, same gate as the layout.
+     *
      * NO stored pane ⇒ silent no-op. That is the reused-worktree case: `ensure`
      * took the reuse branch, there is no fresh root pane, and re-applying would
      * start a duplicate editor process on reattach (GAIA-139). The capture is
@@ -279,11 +303,12 @@ export class HerdrWorkspace {
      * and swallowed so a startup-command failure can NEVER wedge dispatch.
      */
     async applyOpenLayout(path, ctx) {
-        const rootPaneId = this.pendingRootPanes.get(path);
-        if (!rootPaneId) {
+        const pending = this.pendingRootPanes.get(path);
+        if (!pending) {
             return;
         }
         this.pendingRootPanes.delete(path);
+        const { paneId: rootPaneId } = pending;
         try {
             // Render the ROOT command here (spec D2). `applyPaneLayout` types its
             // root command verbatim for the executor's brace-bearing env-prefixed
@@ -292,6 +317,7 @@ export class HerdrWorkspace {
             const vars = {
                 identifier: ctx.identifier,
                 branch: ctx.branch,
+                title: ctx.title,
                 worktreePath: path,
             };
             const layout = {
@@ -301,11 +327,66 @@ export class HerdrWorkspace {
                     : {}),
             };
             await applyPaneLayout(this.execHerdr, rootPaneId, layout, path, vars);
+            await this.applyOverviewLabels(rootPaneId, pending.tabId, vars);
         }
         catch (err) {
             this.logger.warn({ branch: ctx.branch, worktree: path, err: String(err) }, 'herdr open-layout failed (best-effort, ignored)');
         }
     }
+    /**
+     * Best-effort overview tab + pane renames (GAIA-374). Skipped for the
+     * `open: {}` opt-out. A missing create-time tab id falls back to `pane get`.
+     */
+    async applyOverviewLabels(rootPaneId, createTabId, vars) {
+        const emptyOptOut = this.open.command === undefined &&
+            !this.open.panes?.length &&
+            this.open.tabLabel === undefined &&
+            this.open.panelLabel === undefined;
+        if (emptyOptOut) {
+            return;
+        }
+        // Tab bar is always visible; cap title length and mark truncation with
+        // `...`. Pane/panel label keeps the full title for pane borders.
+        const tabVars = {
+            ...vars,
+            title: truncateOpenTabTitle(vars.title ?? ''),
+        };
+        const tabLabel = renderTemplate(this.open.tabLabel ?? DEFAULT_OPEN_TAB_LABEL, tabVars);
+        const panelLabel = renderTemplate(this.open.panelLabel ?? DEFAULT_OPEN_PANEL_LABEL, vars);
+        let tabId = createTabId;
+        if (!tabId) {
+            try {
+                tabId = (await this.resolveTabIdForPane(rootPaneId)) ?? undefined;
+            }
+            catch (err) {
+                this.logger.warn({ paneId: rootPaneId, err: String(err) }, 'herdr overview tab id lookup failed (best-effort, ignored)');
+            }
+        }
+        if (tabId) {
+            try {
+                await this.execHerdr(['tab', 'rename', tabId, tabLabel]);
+            }
+            catch (err) {
+                this.logger.warn({ tabId, err: String(err) }, 'herdr overview tab rename failed (best-effort, ignored)');
+            }
+        }
+        try {
+            await this.execHerdr(['pane', 'rename', rootPaneId, panelLabel]);
+        }
+        catch (err) {
+            this.logger.warn({ paneId: rootPaneId, err: String(err) }, 'herdr overview pane rename failed (best-effort, ignored)');
+        }
+    }
+    /** `pane get <id>` → `result.pane.tab_id` when present. */
+    async resolveTabIdForPane(paneId) {
+        const output = await this.execHerdr(['pane', 'get', paneId, '--json']);
+        const parsed = parseJson(output, 'pane get');
+        const tabId = isRecord(parsed)
+            ? parsed.result?.pane
+                ?.tab_id
+            : undefined;
+        return typeof tabId === 'string' && tabId ? tabId : null;
+    }
 }
 export function herdrWorkspace(opts = {}) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/addon-herdr",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "GAIA herdr integration: spawn executor + per-ticket worktree workspace.",
   "type": "module",
   "license": "MIT",
@@ -20,10 +20,10 @@
     "directory": "gaia-cli/addons/herdr"
   },
   "dependencies": {
-    "@gaia-ai/addon-workspace-git": "^0.9.1"
+    "@gaia-ai/addon-workspace-git": "^0.10.0"
   },
   "peerDependencies": {
-    "@gaia-ai/conductor": "^0.9.1",
-    "@gaia-ai/core": "^0.9.1"
+    "@gaia-ai/conductor": "^0.10.0",
+    "@gaia-ai/core": "^0.10.0"
   }
 }