kanban-lite 1.2.9 → 1.2.11

package/dist/cli.js

@@ -42,6 +42,44 @@ function getTitleFromContent(content) {
   const firstLine = content.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
   return firstLine || "Untitled";
 }
+function getMetadataPathValue(metadata, path24) {
+  if (!metadata || !path24.trim())
+    return void 0;
+  return path24.split(".").reduce((current, key) => {
+    if (current === null || current === void 0 || typeof current !== "object") {
+      return void 0;
+    }
+    return current[key];
+  }, metadata);
+}
+function stringifyDisplayTitlePrefix(value) {
+  if (value === null || value === void 0)
+    return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    const parts = value.map((item) => stringifyDisplayTitlePrefix(item)).filter((item) => Boolean(item));
+    return parts.length > 0 ? parts.join(", ") : null;
+  }
+  if (typeof value === "object") {
+    const json2 = JSON.stringify(value);
+    return json2 && json2 !== "{}" && json2 !== "[]" ? json2 : null;
+  }
+  return null;
+}
+function getDisplayTitleFromContent(content, metadata, titleFields) {
+  const title = getTitleFromContent(content);
+  if (!titleFields || titleFields.length === 0) {
+    return title;
+  }
+  const prefixes = titleFields.map((field) => stringifyDisplayTitlePrefix(getMetadataPathValue(metadata, field))).filter((value) => Boolean(value));
+  return prefixes.length > 0 ? `${prefixes.join(" ")} ${title}` : title;
+}
 function generateSlug(title) {
   return title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 50) || "card";
 }
@@ -6515,6 +6553,7 @@ function listBoards(ctx) {
     columns: board.columns,
     actions: board.actions,
     metadata: board.metadata,
+    title: board.title,
     forms: config2.forms
   }));
 }
@@ -6589,6 +6628,8 @@ function updateBoard(ctx, { boardId, updates }) {
     board.defaultPriority = updates.defaultPriority;
   if (updates.metadata !== void 0)
     board.metadata = updates.metadata;
+  if (updates.title !== void 0)
+    board.title = updates.title;
   writeConfig(ctx.workspaceRoot, config2);
   return board;
 }
@@ -26310,7 +26351,7 @@ var init_KanbanSDK = __esm({
        * Lists all boards defined in the workspace configuration.
        *
        * @returns An array of {@link BoardInfo} objects containing each board's
-       *   `id`, `name`, and optional `description`.
+        *   `id`, `name`, optional `description`, and display-title metadata config.
        *
        * @example
        * ```ts
@@ -26379,7 +26420,7 @@ var init_KanbanSDK = __esm({
        * Retrieves the full configuration for a specific board.
        *
        * @param boardId - The ID of the board to retrieve.
-       * @returns The {@link BoardConfig} object containing columns, settings, and metadata.
+        * @returns The {@link BoardConfig} object containing columns, settings, metadata, and display-title metadata config.
        * @throws {Error} If the board does not exist.
        *
        * @example
@@ -26404,6 +26445,7 @@ var init_KanbanSDK = __esm({
        * @param updates.columns - Replacement column definitions.
        * @param updates.defaultStatus - New default status for new cards.
        * @param updates.defaultPriority - New default priority for new cards.
+      * @param updates.title - Ordered metadata keys whose values should prefix rendered card titles.
        * @returns The updated {@link BoardConfig} object.
        * @throws {Error} If the board does not exist.
        *
@@ -42879,6 +42921,17 @@ async function buildMcpCardStateMutationModel(sdk, unread) {
     }
   };
 }
+function getBoardTitleFieldsForMcp(sdk, boardId) {
+  const config2 = sdk.getConfigSnapshot();
+  const resolvedBoardId = boardId || config2.defaultBoard;
+  return config2.boards[resolvedBoardId]?.title;
+}
+function decorateMcpCardTitle(card, titleFields) {
+  return {
+    ...card,
+    title: getDisplayTitleFromContent(card.content, card.metadata, titleFields)
+  };
+}
 function registerCardStateMcpTools(server, options) {
   const registeredNames = [
     "get_card_state_status",
@@ -43097,6 +43150,7 @@ async function main() {
       sort: external_exports.enum(["created:asc", "created:desc", "modified:asc", "modified:desc"]).optional().describe("Sort order: created:asc, created:desc, modified:asc, or modified:desc. Defaults to board order.")
     },
     async ({ boardId, status, priority, assignee, label, labelGroup, includeDeleted, searchQuery, fuzzy, metaFilter, sort }) => {
+      const titleFields = getBoardTitleFieldsForMcp(sdk, boardId);
       let cards = await sdk.listCards(void 0, boardId, {
         metaFilter: metaFilter && Object.keys(metaFilter).length > 0 ? metaFilter : void 0,
         sort: sort || void 0,
@@ -43119,7 +43173,7 @@ async function main() {
       }
       const summary = cards.map((c) => ({
         id: c.id,
-        title: getTitleFromContent(c.content),
+        title: getDisplayTitleFromContent(c.content, c.metadata, titleFields),
         status: c.status,
         priority: c.priority,
         assignee: c.assignee,
@@ -43160,10 +43214,11 @@ async function main() {
           };
         }
       }
+      const titleFields = getBoardTitleFieldsForMcp(sdk, card.boardId ?? boardId);
       return {
         content: [{
           type: "text",
-          text: JSON.stringify(card, null, 2)
+          text: JSON.stringify(decorateMcpCardTitle(card, titleFields), null, 2)
         }]
       };
     }
@@ -43176,10 +43231,11 @@ async function main() {
     },
     async ({ boardId }) => {
       const card = await sdk.getActiveCard(boardId);
+      const titleFields = card ? getBoardTitleFieldsForMcp(sdk, card.boardId ?? boardId) : void 0;
       return {
         content: [{
           type: "text",
-          text: JSON.stringify(card, null, 2)
+          text: JSON.stringify(card ? decorateMcpCardTitle(card, titleFields) : null, null, 2)
         }]
       };
     }
@@ -88350,6 +88406,8 @@ var init_openapi_spec = __esm({
               name: { type: "string" },
               description: { type: "string" },
               columns: { type: "array", items: { $ref: "#/components/schemas/Column" } },
+              metadata: { type: "array", items: { type: "string" }, description: "Board metadata keys pinned in the card detail panel." },
+              title: { type: "array", items: { type: "string" }, description: "Ordered metadata keys whose rendered values prefix user-visible card titles." },
               defaultStatus: { type: "string" },
               defaultPriority: { type: "string", enum: ["critical", "high", "medium", "low"] }
             }
@@ -88436,7 +88494,7 @@ var init_openapi_spec = __esm({
                 "application/json": {
                   schema: {
                     type: "object",
-                    description: "Any subset of board config fields: `name`, `description`, `columns`, `defaultStatus`, `defaultPriority`."
+                    description: "Any subset of board config fields: `name`, `description`, `columns`, `metadata`, `title`, `defaultStatus`, `defaultPriority`."
                   }
                 }
               }
@@ -98614,14 +98672,17 @@ function printCardStateMutationModel(label, payload) {
     cardState: payload.cardState
   });
 }
-function formatCardRow(c) {
-  const title = getTitleFromContent(c.content);
+function getBoardTitleFieldsForCli(sdk, boardId) {
+  const config2 = sdk.getConfigSnapshot();
+  const resolvedBoardId = boardId || config2.defaultBoard;
+  return config2.boards[resolvedBoardId]?.title;
+}
+function formatCardRow(c, title = getTitleFromContent(c.content)) {
   const truncTitle = title.length > 40 ? title.slice(0, 37) + "..." : title;
   const assignee = c.assignee || "-";
   return `  ${bold(c.id.slice(0, 30).padEnd(30))}  ${colorStatus(c.status.padEnd(12))}  ${colorPriority(c.priority.padEnd(8))}  ${assignee.padEnd(12)}  ${truncTitle}`;
 }
-function formatCardDetail(c) {
-  const title = getTitleFromContent(c.content);
+function formatCardDetail(c, title = getTitleFromContent(c.content)) {
   const lines = [
     `${bold(title)}`,
     "",
@@ -98652,6 +98713,7 @@ function formatCardDetail(c) {
 }
 async function cmdList(sdk, flags) {
   const boardId = getBoardId(flags);
+  const boardTitleFields = getBoardTitleFieldsForCli(sdk, boardId);
   const searchQuery = typeof flags.search === "string" ? flags.search : void 0;
   const fuzzy = flags.fuzzy === true;
   const metaFilter = Array.isArray(flags.meta) ? (() => {
@@ -98712,13 +98774,14 @@ async function cmdList(sdk, flags) {
   console.log(`  ${dim("ID".padEnd(30))}  ${dim("STATUS".padEnd(12))}  ${dim("PRIORITY".padEnd(8))}  ${dim("ASSIGNEE".padEnd(12))}  ${dim("TITLE")}`);
   console.log(dim("  " + "-".repeat(90)));
   for (const c of cards) {
-    console.log(formatCardRow(c));
+    console.log(formatCardRow(c, getDisplayTitleFromContent(c.content, c.metadata, boardTitleFields)));
   }
   console.log(dim(`
   ${cards.length} card(s)`));
 }
 async function cmdActive(sdk, flags) {
   const boardId = getBoardId(flags);
+  const boardTitleFields = getBoardTitleFieldsForCli(sdk, boardId);
   const card = await sdk.getActiveCard(boardId);
   if (flags.json) {
     console.log(JSON.stringify(card, null, 2));
@@ -98728,7 +98791,7 @@ async function cmdActive(sdk, flags) {
     console.log(dim("  No active card."));
     return;
   }
-  console.log(formatCardDetail(card));
+  console.log(formatCardDetail(card, getDisplayTitleFromContent(card.content, card.metadata, boardTitleFields)));
 }
 async function cmdShow(sdk, positional, flags) {
   const cardId = positional[0];
@@ -98737,6 +98800,7 @@ async function cmdShow(sdk, positional, flags) {
     process.exit(1);
   }
   const boardId = getBoardId(flags);
+  const boardTitleFields = getBoardTitleFieldsForCli(sdk, boardId);
   const card = await sdk.getCard(cardId, boardId);
   if (!card) {
     const all = await sdk.listCards(void 0, boardId);
@@ -98745,7 +98809,7 @@ async function cmdShow(sdk, positional, flags) {
       if (flags.json) {
         console.log(JSON.stringify(matches[0], null, 2));
       } else {
-        console.log(formatCardDetail(matches[0]));
+        console.log(formatCardDetail(matches[0], getDisplayTitleFromContent(matches[0].content, matches[0].metadata, boardTitleFields)));
       }
       return;
     } else if (matches.length > 1) {
@@ -98760,7 +98824,7 @@ async function cmdShow(sdk, positional, flags) {
   if (flags.json) {
     console.log(JSON.stringify(card, null, 2));
   } else {
-    console.log(formatCardDetail(card));
+    console.log(formatCardDetail(card, getDisplayTitleFromContent(card.content, card.metadata, boardTitleFields)));
   }
 }
 async function cmdAdd(sdk, flags) {

package/dist/extension.js

@@ -65170,6 +65170,44 @@ function getTitleFromContent(content) {
   const firstLine = content.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
   return firstLine || "Untitled";
 }
+function getMetadataPathValue(metadata, path24) {
+  if (!metadata || !path24.trim())
+    return void 0;
+  return path24.split(".").reduce((current, key) => {
+    if (current === null || current === void 0 || typeof current !== "object") {
+      return void 0;
+    }
+    return current[key];
+  }, metadata);
+}
+function stringifyDisplayTitlePrefix(value) {
+  if (value === null || value === void 0)
+    return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    const parts = value.map((item) => stringifyDisplayTitlePrefix(item)).filter((item) => Boolean(item));
+    return parts.length > 0 ? parts.join(", ") : null;
+  }
+  if (typeof value === "object") {
+    const json2 = JSON.stringify(value);
+    return json2 && json2 !== "{}" && json2 !== "[]" ? json2 : null;
+  }
+  return null;
+}
+function getDisplayTitleFromContent(content, metadata, titleFields) {
+  const title = getTitleFromContent(content);
+  if (!titleFields || titleFields.length === 0) {
+    return title;
+  }
+  const prefixes = titleFields.map((field) => stringifyDisplayTitlePrefix(getMetadataPathValue(metadata, field))).filter((value) => Boolean(value));
+  return prefixes.length > 0 ? `${prefixes.join(" ")} ${title}` : title;
+}
 function generateSlug(title) {
   return title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 50) || "card";
 }
@@ -70030,6 +70068,7 @@ function listBoards(ctx) {
     columns: board.columns,
     actions: board.actions,
     metadata: board.metadata,
+    title: board.title,
     forms: config.forms
   }));
 }
@@ -70104,6 +70143,8 @@ function updateBoard(ctx, { boardId, updates }) {
     board.defaultPriority = updates.defaultPriority;
   if (updates.metadata !== void 0)
     board.metadata = updates.metadata;
+  if (updates.title !== void 0)
+    board.title = updates.title;
   writeConfig(ctx.workspaceRoot, config);
   return board;
 }
@@ -73756,7 +73797,7 @@ var KanbanSDK = class _KanbanSDK {
    * Lists all boards defined in the workspace configuration.
    *
    * @returns An array of {@link BoardInfo} objects containing each board's
-   *   `id`, `name`, and optional `description`.
+    *   `id`, `name`, optional `description`, and display-title metadata config.
    *
    * @example
    * ```ts
@@ -73825,7 +73866,7 @@ var KanbanSDK = class _KanbanSDK {
    * Retrieves the full configuration for a specific board.
    *
    * @param boardId - The ID of the board to retrieve.
-   * @returns The {@link BoardConfig} object containing columns, settings, and metadata.
+    * @returns The {@link BoardConfig} object containing columns, settings, metadata, and display-title metadata config.
    * @throws {Error} If the board does not exist.
    *
    * @example
@@ -73850,6 +73891,7 @@ var KanbanSDK = class _KanbanSDK {
    * @param updates.columns - Replacement column definitions.
    * @param updates.defaultStatus - New default status for new cards.
    * @param updates.defaultPriority - New default priority for new cards.
+  * @param updates.title - Ordered metadata keys whose values should prefix rendered card titles.
    * @returns The updated {@link BoardConfig} object.
    * @throws {Error} If the board does not exist.
    *
@@ -75460,6 +75502,8 @@ var KANBAN_OPENAPI_SPEC = {
           name: { type: "string" },
           description: { type: "string" },
           columns: { type: "array", items: { $ref: "#/components/schemas/Column" } },
+          metadata: { type: "array", items: { type: "string" }, description: "Board metadata keys pinned in the card detail panel." },
+          title: { type: "array", items: { type: "string" }, description: "Ordered metadata keys whose rendered values prefix user-visible card titles." },
           defaultStatus: { type: "string" },
           defaultPriority: { type: "string", enum: ["critical", "high", "medium", "low"] }
         }
@@ -75546,7 +75590,7 @@ var KANBAN_OPENAPI_SPEC = {
             "application/json": {
               schema: {
                 type: "object",
-                description: "Any subset of board config fields: `name`, `description`, `columns`, `defaultStatus`, `defaultPriority`."
+                description: "Any subset of board config fields: `name`, `description`, `columns`, `metadata`, `title`, `defaultStatus`, `defaultPriority`."
               }
             }
           }
@@ -82182,15 +82226,16 @@ var KanbanPanel = class _KanbanPanel {
       vscode.window.showErrorMessage("No card selected");
       return;
     }
-    const titleMatch = card.content.match(/^#\s+(.+)$/m);
-    const title = titleMatch ? titleMatch[1].trim() : getTitleFromContent(card.content);
+    const aiRoot = this._getWorkspaceRoot();
+    const aiConfig = aiRoot ? readConfig(aiRoot) : DEFAULT_CONFIG;
+    const activeBoardId = this._currentBoardId || aiConfig.defaultBoard;
+    const titleFields = aiConfig.boards[activeBoardId]?.title;
+    const title = getDisplayTitleFromContent(card.content, card.metadata, titleFields);
     const labels = card.labels.length > 0 ? ` [${card.labels.join(", ")}]` : "";
     const description = card.content.replace(/\n/g, " ").replace(/\s+/g, " ").trim();
     const shortDesc = description.length > 200 ? description.substring(0, 200) + "..." : description;
     const promptTarget = this._sdk?.getLocalCardPath(card) ?? `card ${card.id}`;
     const prompt = `Implement this card: "${title}" (${card.priority} priority)${labels}. ${shortDesc} See full details in: ${promptTarget}`;
-    const aiRoot = this._getWorkspaceRoot();
-    const aiConfig = aiRoot ? readConfig(aiRoot) : DEFAULT_CONFIG;
     const selectedAgent = agent || aiConfig.aiAgent || "claude";
     const selectedPermissionMode = permissionMode || "default";
     let command;
@@ -82527,10 +82572,14 @@ var SidebarViewProvider = class {
     }
     try {
       const sdk = new KanbanSDK(kanbanDir);
+      const workspaceFolders = vscode2.workspace.workspaceFolders;
+      const root = workspaceFolders?.[0]?.uri.fsPath;
+      const config = root ? readConfig(root) : void 0;
+      const defaultBoardTitleFields = config?.boards[config.defaultBoard]?.title;
       const cards = await sdk.listCards();
       this._cards = cards.map((c) => ({
         id: c.id,
-        title: getTitleFromContent(c.content),
+        title: getDisplayTitleFromContent(c.content, c.metadata, defaultBoardTitleFields),
         status: c.status,
         priority: c.priority
       }));

package/dist/mcp-server.js

@@ -17503,6 +17503,44 @@ function getTitleFromContent(content) {
   const firstLine = content.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
   return firstLine || "Untitled";
 }
+function getMetadataPathValue(metadata, path16) {
+  if (!metadata || !path16.trim())
+    return void 0;
+  return path16.split(".").reduce((current, key) => {
+    if (current === null || current === void 0 || typeof current !== "object") {
+      return void 0;
+    }
+    return current[key];
+  }, metadata);
+}
+function stringifyDisplayTitlePrefix(value) {
+  if (value === null || value === void 0)
+    return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    const parts = value.map((item) => stringifyDisplayTitlePrefix(item)).filter((item) => Boolean(item));
+    return parts.length > 0 ? parts.join(", ") : null;
+  }
+  if (typeof value === "object") {
+    const json2 = JSON.stringify(value);
+    return json2 && json2 !== "{}" && json2 !== "[]" ? json2 : null;
+  }
+  return null;
+}
+function getDisplayTitleFromContent(content, metadata, titleFields) {
+  const title = getTitleFromContent(content);
+  if (!titleFields || titleFields.length === 0) {
+    return title;
+  }
+  const prefixes = titleFields.map((field) => stringifyDisplayTitlePrefix(getMetadataPathValue(metadata, field))).filter((value) => Boolean(value));
+  return prefixes.length > 0 ? `${prefixes.join(" ")} ${title}` : title;
+}
 function generateSlug(title) {
   return title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 50) || "card";
 }
@@ -22428,6 +22466,7 @@ function listBoards(ctx) {
     columns: board.columns,
     actions: board.actions,
     metadata: board.metadata,
+    title: board.title,
     forms: config.forms
   }));
 }
@@ -22502,6 +22541,8 @@ function updateBoard(ctx, { boardId, updates }) {
     board.defaultPriority = updates.defaultPriority;
   if (updates.metadata !== void 0)
     board.metadata = updates.metadata;
+  if (updates.title !== void 0)
+    board.title = updates.title;
   writeConfig(ctx.workspaceRoot, config);
   return board;
 }
@@ -26154,7 +26195,7 @@ var KanbanSDK = class _KanbanSDK {
    * Lists all boards defined in the workspace configuration.
    *
    * @returns An array of {@link BoardInfo} objects containing each board's
-   *   `id`, `name`, and optional `description`.
+    *   `id`, `name`, optional `description`, and display-title metadata config.
    *
    * @example
    * ```ts
@@ -26223,7 +26264,7 @@ var KanbanSDK = class _KanbanSDK {
    * Retrieves the full configuration for a specific board.
    *
    * @param boardId - The ID of the board to retrieve.
-   * @returns The {@link BoardConfig} object containing columns, settings, and metadata.
+    * @returns The {@link BoardConfig} object containing columns, settings, metadata, and display-title metadata config.
    * @throws {Error} If the board does not exist.
    *
    * @example
@@ -26248,6 +26289,7 @@ var KanbanSDK = class _KanbanSDK {
    * @param updates.columns - Replacement column definitions.
    * @param updates.defaultStatus - New default status for new cards.
    * @param updates.defaultPriority - New default priority for new cards.
+  * @param updates.title - Ordered metadata keys whose values should prefix rendered card titles.
    * @returns The updated {@link BoardConfig} object.
    * @throws {Error} If the board does not exist.
    *
@@ -27640,6 +27682,17 @@ async function buildMcpCardStateMutationModel(sdk, unread) {
     }
   };
 }
+function getBoardTitleFieldsForMcp(sdk, boardId) {
+  const config = sdk.getConfigSnapshot();
+  const resolvedBoardId = boardId || config.defaultBoard;
+  return config.boards[resolvedBoardId]?.title;
+}
+function decorateMcpCardTitle(card, titleFields) {
+  return {
+    ...card,
+    title: getDisplayTitleFromContent(card.content, card.metadata, titleFields)
+  };
+}
 function registerCardStateMcpTools(server, options) {
   const registeredNames = [
     "get_card_state_status",
@@ -27858,6 +27911,7 @@ async function main() {
       sort: import_zod.z.enum(["created:asc", "created:desc", "modified:asc", "modified:desc"]).optional().describe("Sort order: created:asc, created:desc, modified:asc, or modified:desc. Defaults to board order.")
     },
     async ({ boardId, status, priority, assignee, label, labelGroup, includeDeleted, searchQuery, fuzzy, metaFilter, sort }) => {
+      const titleFields = getBoardTitleFieldsForMcp(sdk, boardId);
       let cards = await sdk.listCards(void 0, boardId, {
         metaFilter: metaFilter && Object.keys(metaFilter).length > 0 ? metaFilter : void 0,
         sort: sort || void 0,
@@ -27880,7 +27934,7 @@ async function main() {
       }
       const summary = cards.map((c) => ({
         id: c.id,
-        title: getTitleFromContent(c.content),
+        title: getDisplayTitleFromContent(c.content, c.metadata, titleFields),
         status: c.status,
         priority: c.priority,
         assignee: c.assignee,
@@ -27921,10 +27975,11 @@ async function main() {
           };
         }
       }
+      const titleFields = getBoardTitleFieldsForMcp(sdk, card.boardId ?? boardId);
       return {
         content: [{
           type: "text",
-          text: JSON.stringify(card, null, 2)
+          text: JSON.stringify(decorateMcpCardTitle(card, titleFields), null, 2)
         }]
       };
     }
@@ -27937,10 +27992,11 @@ async function main() {
     },
     async ({ boardId }) => {
       const card = await sdk.getActiveCard(boardId);
+      const titleFields = card ? getBoardTitleFieldsForMcp(sdk, card.boardId ?? boardId) : void 0;
       return {
         content: [{
           type: "text",
-          text: JSON.stringify(card, null, 2)
+          text: JSON.stringify(card ? decorateMcpCardTitle(card, titleFields) : null, null, 2)
         }]
       };
     }

package/dist/sdk/index.cjs

@@ -17502,6 +17502,7 @@ __export(sdk_exports, {
   getBoardConfig: () => getBoardConfig,
   getCardFilePath: () => getCardFilePath,
   getDefaultBoardId: () => getDefaultBoardId,
+  getDisplayTitleFromContent: () => getDisplayTitleFromContent,
   getEventsByResource: () => getEventsByResource,
   getSdkAfterEvents: () => getSdkAfterEvents,
   getSdkBeforeEvents: () => getSdkBeforeEvents,
@@ -17533,6 +17534,44 @@ function getTitleFromContent(content) {
   const firstLine = content.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
   return firstLine || "Untitled";
 }
+function getMetadataPathValue(metadata, path15) {
+  if (!metadata || !path15.trim())
+    return void 0;
+  return path15.split(".").reduce((current, key) => {
+    if (current === null || current === void 0 || typeof current !== "object") {
+      return void 0;
+    }
+    return current[key];
+  }, metadata);
+}
+function stringifyDisplayTitlePrefix(value) {
+  if (value === null || value === void 0)
+    return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    const parts = value.map((item) => stringifyDisplayTitlePrefix(item)).filter((item) => Boolean(item));
+    return parts.length > 0 ? parts.join(", ") : null;
+  }
+  if (typeof value === "object") {
+    const json2 = JSON.stringify(value);
+    return json2 && json2 !== "{}" && json2 !== "[]" ? json2 : null;
+  }
+  return null;
+}
+function getDisplayTitleFromContent(content, metadata, titleFields) {
+  const title = getTitleFromContent(content);
+  if (!titleFields || titleFields.length === 0) {
+    return title;
+  }
+  const prefixes = titleFields.map((field) => stringifyDisplayTitlePrefix(getMetadataPathValue(metadata, field))).filter((value) => Boolean(value));
+  return prefixes.length > 0 ? `${prefixes.join(" ")} ${title}` : title;
+}
 function generateSlug(title) {
   return title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 50) || "card";
 }
@@ -22395,6 +22434,7 @@ function listBoards(ctx) {
     columns: board.columns,
     actions: board.actions,
     metadata: board.metadata,
+    title: board.title,
     forms: config.forms
   }));
 }
@@ -22469,6 +22509,8 @@ function updateBoard(ctx, { boardId, updates }) {
     board.defaultPriority = updates.defaultPriority;
   if (updates.metadata !== void 0)
     board.metadata = updates.metadata;
+  if (updates.title !== void 0)
+    board.title = updates.title;
   writeConfig(ctx.workspaceRoot, config);
   return board;
 }
@@ -26121,7 +26163,7 @@ var KanbanSDK = class _KanbanSDK {
    * Lists all boards defined in the workspace configuration.
    *
    * @returns An array of {@link BoardInfo} objects containing each board's
-   *   `id`, `name`, and optional `description`.
+    *   `id`, `name`, optional `description`, and display-title metadata config.
    *
    * @example
    * ```ts
@@ -26190,7 +26232,7 @@ var KanbanSDK = class _KanbanSDK {
    * Retrieves the full configuration for a specific board.
    *
    * @param boardId - The ID of the board to retrieve.
-   * @returns The {@link BoardConfig} object containing columns, settings, and metadata.
+    * @returns The {@link BoardConfig} object containing columns, settings, metadata, and display-title metadata config.
    * @throws {Error} If the board does not exist.
    *
    * @example
@@ -26215,6 +26257,7 @@ var KanbanSDK = class _KanbanSDK {
    * @param updates.columns - Replacement column definitions.
    * @param updates.defaultStatus - New default status for new cards.
    * @param updates.defaultPriority - New default priority for new cards.
+  * @param updates.title - Ordered metadata keys whose values should prefix rendered card titles.
    * @returns The updated {@link BoardConfig} object.
    * @throws {Error} If the board does not exist.
    *
@@ -27727,6 +27770,7 @@ function getActionsByResource(resource) {
   getBoardConfig,
   getCardFilePath,
   getDefaultBoardId,
+  getDisplayTitleFromContent,
   getEventsByResource,
   getSdkAfterEvents,
   getSdkBeforeEvents,