@xirang-ai/dsh-teamflow 0.1.1 → 0.1.3

package/lib/client.js

@@ -1,4 +1,4 @@
-/* @xirang-ai/dsh-teamflow 0.1.1 — generated by scripts/build.mjs, do not edit. */
+/* @xirang-ai/dsh-teamflow 0.1.3 — generated by scripts/build.mjs, do not edit. */
 window.__ModuleLoader__.load({
 	id: "@xirang-ai/dsh-teamflow",
 	factory: (require) => {
@@ -341,6 +341,7 @@ window.__ModuleLoader__.load({
 		  "delete.statusMissing": "—",
 		  "delete.summary": "{total} record(s), {deletable} deletable",
 		  "detail.branch": "Branch",
+		  "detail.bugDiscussion": "Discuss this bug in a new session",
 		  "detail.bugBody": "What happened",
 		  "detail.completedAt": "Completed",
 		  "detail.description": "Description",
@@ -356,6 +357,7 @@ window.__ModuleLoader__.load({
 		  "detail.discussionNewDetail": "Discuss the detailed design in a new conversation",
 		  "detail.discussionNewSplit": "Split Stories in a new conversation",
 		  "detail.discussionOpen": "Open",
+		  "detail.storyDiscussion": "Discuss this story in a new session",
 		  "detail.discussionStarting": "Creating conversation…",
 		  "detail.docs": "Detailed design",
 		  "detail.docsEmpty": "No detailed design written yet.",
@@ -424,6 +426,7 @@ window.__ModuleLoader__.load({
 		  "page.retry": "Retry",
 		  "page.subtitle": "Defects come first, then running work, work waiting to start, and requirements still in discussion.",
 		  "page.title": "Xirang Workbench",
+		  "page.version": "v{version}",
 		  panel: "Xirang Workbench",
 		  "remote.bugId.empty": "A bug id is required.",
 		  "remote.doc.notFound": "Detailed-design document {id} does not exist.",
@@ -679,6 +682,7 @@ window.__ModuleLoader__.load({
 		  "delete.statusMissing": "—",
 		  "delete.summary": "共 {total} 条，可删除 {deletable} 条",
 		  "detail.branch": "分支",
+		  "detail.bugDiscussion": "在新会话中进行缺陷讨论",
 		  "detail.bugBody": "缺陷说明",
 		  "detail.completedAt": "完成时间",
 		  "detail.description": "故事说明",
@@ -694,6 +698,7 @@ window.__ModuleLoader__.load({
 		  "detail.discussionNewDetail": "在新会话中进行详细设计讨论",
 		  "detail.discussionNewSplit": "在新会话中进行故事拆分",
 		  "detail.discussionOpen": "打开",
+		  "detail.storyDiscussion": "在新会话中进行故事讨论",
 		  "detail.discussionStarting": "正在创建会话…",
 		  "detail.docs": "详细设计",
 		  "detail.docsEmpty": "还没有写详细设计。",
@@ -762,6 +767,7 @@ window.__ModuleLoader__.load({
 		  "page.retry": "重试",
 		  "page.subtitle": "缺陷优先；其下依次是执行中的需求与故事、待开始的工作，以及仍在讨论的需求。",
 		  "page.title": "息壤工作台",
+		  "page.version": "v{version}",
 		  panel: "息壤工作台",
 		  "remote.bugId.empty": "缺少缺陷编号。",
 		  "remote.doc.notFound": "详细设计 {id} 不存在。",
@@ -897,6 +903,7 @@ window.__ModuleLoader__.load({
 		  cancelStory: "cancelStory",
 		  completeBug: "completeBug",
 		  prepareRequirementSession: "prepareRequirementSession",
+		  prepareDiscussionSession: "prepareDiscussionSession",
 		  sessionPermissionTier: "sessionPermissionTier",
 		  previewDelete: "previewDelete",
 		  deleteRecords: "deleteRecords",
@@ -1034,6 +1041,21 @@ window.__ModuleLoader__.load({
 		    ]),
 		    result: JSON_CODEC
 		  }),
+		  Object.freeze({
+		    id: `${PACKAGE_NAME}#${METHODS.prepareDiscussionSession}`,
+		    service: SERVICE_KEY,
+		    namespace: NAMESPACE,
+		    method: METHODS.prepareDiscussionSession,
+		    invocation: { kind: "direct" },
+		    parameters: Object.freeze([
+		      parameter("subjectType", "Discussion subject: requirement, story or bug"),
+		      parameter("subjectId", "Requirement, story or defect the discussion belongs to"),
+		      parameter("sessionId", "Newly created conversation to link"),
+		      parameter("kind", "Discussion kind: discuss for stories and defects, the requirement kinds otherwise"),
+		      LOCALE_PARAMETER
+		    ]),
+		    result: JSON_CODEC
+		  }),
 		  Object.freeze({
 		    id: `${PACKAGE_NAME}#${METHODS.sessionPermissionTier}`,
 		    service: SERVICE_KEY,
@@ -1151,6 +1173,15 @@ window.__ModuleLoader__.load({
 		  }
 		  return ["【继续讨论需求与概要设计】", "", "我的补充："].join("\n");
 		}
+		var STORY_DISCUSSION_PRESET = "xirang-story";
+		var BUG_DISCUSSION_PRESET = "xirang-bug";
+		function presetForRecordDiscussion(kind) {
+		  return kind === "bug" ? BUG_DISCUSSION_PRESET : STORY_DISCUSSION_PRESET;
+		}
+		function buildRecordDiscussionPrompt(kind, title) {
+		  const heading = kind === "bug" ? "【继续讨论缺陷】" : "【继续讨论故事】";
+		  return [heading, title, "", "我的补充："].join("\n");
+		}
 
 		// src/client/composer-kind.ts
 		var COMPOSER_KINDS = [...CREATE_KINDS, "design", "detail", "split"];
@@ -1213,6 +1244,14 @@ window.__ModuleLoader__.load({
 		.tf-head { display: flex; align-items: flex-start; gap: 16px; padding: 20px 0 14px; }
 		.tf-head-main { min-width: 0; flex: 1 1 auto; }
 		.tf-title { margin: 0; font-size: 18px; font-weight: 650; letter-spacing: -0.01em; }
+		.tf-version {
+		  margin-left: 7px;
+		  font-size: 11px;
+		  font-weight: 500;
+		  color: var(--dsw-alias-label-tertiary, inherit);
+		  font-variant-numeric: tabular-nums;
+		  white-space: nowrap;
+		}
 		.tf-sub { margin: 3px 0 0; font-size: 12px; color: var(--dsw-alias-label-tertiary, inherit); }
 		.tf-head-actions { display: flex; align-items: center; gap: 8px; flex: 0 0 auto; padding-top: 2px; }
 		.tf-error {
@@ -2886,6 +2925,13 @@ window.__ModuleLoader__.load({
 		  const pad = (value2) => String(value2).padStart(2, "0");
 		  return `${pad(at.getMonth() + 1)}-${pad(at.getDate())} ${pad(at.getHours())}:${pad(at.getMinutes())}`;
 		}
+		function discussionNodes(sessions) {
+		  return sessions.map((session) => ({
+		    sessionId: session.sessionId,
+		    kind: session.kind,
+		    at: session.linkedAt ?? session.preparedAt ?? session.createdAt
+		  }));
+		}
 		var EMPTY_BOARD = { requirements: [], standalone: [], bugs: [] };
 		var STORY_RUNNING = ["developing", "self_testing"];
 		var STORY_DONE = ["done", "completed", "cancelled"];
@@ -3016,7 +3062,8 @@ window.__ModuleLoader__.load({
 		      acceptance: parsed.acceptance,
 		      bodyMissing: story.bodyMissing,
 		      ...last === void 0 ? {} : { lastRun: { status: last.status, at: last.at } },
-		      runs
+		      runs,
+		      sessions: discussionNodes(story.sessions)
 		    };
 		    if (story.requirementId === null) {
 		      standalone.push({ kind: "story", id: story.id, workspaceId: node.workspaceId, story: node });
@@ -3037,12 +3084,8 @@ window.__ModuleLoader__.load({
 		    const finished = stories.length > 0 && stories.every((story) => story.status === "completed");
 		    const state = requirement.status === "archived" ? "done" : running ? "running" : requirement.status === "completed" || finished ? "done" : "ready";
 		    const branch = runs.find((run) => run.branch.length > 0)?.branch;
-		    const sessions = snapshot.requirementSessions.filter((session) => session.requirementId === requirement.id).map(
-		      (session) => ({
-		        sessionId: session.sessionId,
-		        kind: session.kind,
-		        at: session.linkedAt ?? session.preparedAt ?? session.createdAt
-		      })
+		    const sessions = discussionNodes(
+		      snapshot.requirementSessions.filter((session) => session.requirementId === requirement.id)
 		    );
 		    const latestDesign = sessions.find((session) => session.kind === "design");
 		    return {
@@ -3081,7 +3124,8 @@ window.__ModuleLoader__.load({
 		      updatedAt: bug.updatedAt,
 		      ...last?.sessionId === void 0 ? {} : { sessionId: last.sessionId },
 		      ...bug.createSessionId === null ? {} : { createSessionId: bug.createSessionId },
-		      runs
+		      runs,
+		      sessions: discussionNodes(bug.sessions)
 		    };
 		  });
 		  return { requirements, standalone, bugs };
@@ -3206,6 +3250,9 @@ window.__ModuleLoader__.load({
 		  return title !== void 0 && title.trim() !== "" ? title : sessionId;
 		}
 
+		// src/client/version.ts
+		var PLUGIN_VERSION = "0.1.3";
+
 		// src/dev.ts
 		var DEV_PRESET = "xirang-dev";
 		function buildDevPrompt(story, requirement) {
@@ -14108,6 +14155,7 @@ window.__ModuleLoader__.load({
 		  const [createBusy, setCreateBusy] = (0, import_react10.useState)(false);
 		  const [createError, setCreateError] = (0, import_react10.useState)(null);
 		  const [discussionBusy, setDiscussionBusy] = (0, import_react10.useState)(null);
+		  const [recordDiscussionBusy, setRecordDiscussionBusy] = (0, import_react10.useState)(null);
 		  const [cleanup, setCleanup] = (0, import_react10.useState)(false);
 		  const [selected2, setSelected] = (0, import_react10.useState)(/* @__PURE__ */ new Set());
 		  const [confirm, setConfirm] = (0, import_react10.useState)(null);
@@ -14611,14 +14659,59 @@ window.__ModuleLoader__.load({
 		    },
 		    [data, openConversation2, showToast, t]
 		  );
+		  const startRecordDiscussion = (0, import_react10.useCallback)(
+		    (subject) => {
+		      const open = openConversation2;
+		      if (open === void 0) {
+		        showToast(t("toast.startUnavailable"));
+		        return;
+		      }
+		      setRecordDiscussionBusy(subject.kind);
+		      open(subject.workspaceId, buildRecordDiscussionPrompt(subject.kind, subject.title), {
+		        agentPreset: presetForRecordDiscussion(subject.kind),
+		        autoSend: false,
+		        composerKind: subject.kind
+		      }).then(async (outcome) => {
+		        if (outcome.status === "unavailable") {
+		          if (mounted.current) {
+		            showToast(outcome.message ?? t("toast.discussionFailed", { title: subject.title }));
+		          }
+		          return;
+		        }
+		        if (outcome.sessionId === void 0) {
+		          if (mounted.current) {
+		            showToast(t("toast.discussionDrafted", { title: subject.title }));
+		          }
+		          return;
+		        }
+		        try {
+		          await data.prepareDiscussionSession(subject.kind, subject.id, outcome.sessionId, "discuss");
+		          if (!mounted.current) return;
+		          showToast(
+		            outcome.status === "drafted" ? t("toast.discussionDrafted", { title: subject.title }) : t("toast.discussionStarted", { title: subject.title })
+		          );
+		        } catch (failure) {
+		          if (!mounted.current) return;
+		          showToast(
+		            t("toast.discussionLinkFailed", {
+		              title: subject.title,
+		              message: failureMessage(failure)
+		            })
+		          );
+		        }
+		      }).catch(() => {
+		        if (mounted.current) showToast(t("toast.discussionFailed", { title: subject.title }));
+		      }).finally(() => {
+		        if (mounted.current) setRecordDiscussionBusy(null);
+		      });
+		    },
+		    [data, openConversation2, showToast, t]
+		  );
 		  const requirementAction = (0, import_react10.useCallback)(
 		    (requirement) => {
 		      if (requirement.state === "running") {
 		        return { label: t("row.open"), tone: "live", icon: ICONS.live };
 		      }
-		      if (requirement.state === "done") {
-		        return { label: t("row.history"), tone: "ghost", icon: ICONS.ghost };
-		      }
 		      const lone = loneReadyStory(requirement);
 		      return lone === void 0 ? null : { label: t("row.start"), tone: "soft", icon: ICONS.soft };
 		    },
@@ -14713,11 +14806,7 @@ window.__ModuleLoader__.load({
 		    }
 		  };
 		  const storyAction = (0, import_react10.useCallback)(
-		    (story) => {
-		      if (story.state === "running") return { label: t("row.open"), tone: "live", icon: ICONS.live };
-		      if (story.state === "done") return { label: t("row.history"), tone: "ghost", icon: ICONS.ghost };
-		      return { label: t("row.start"), tone: "soft", icon: ICONS.soft };
-		    },
+		    (story) => story.state === "ready" ? { label: t("row.start"), tone: "soft", icon: ICONS.soft } : null,
 		    [t]
 		  );
 		  const runStoryAction = (0, import_react10.useCallback)(
@@ -14998,7 +15087,10 @@ window.__ModuleLoader__.load({
 		      view.kind === "list" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(import_jsx_runtime10.Fragment, { children: [
 		        /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("header", { className: "tf-head", children: [
 		          /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "tf-head-main", children: [
-		            /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("h1", { className: "tf-title", children: t("page.title") }),
+		            /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("h1", { className: "tf-title", children: [
+		              t("page.title"),
+		              /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { className: "tf-version", children: t("page.version", { version: PLUGIN_VERSION }) })
+		            ] }),
 		            /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { className: "tf-sub", children: t("page.subtitle") })
 		          ] }),
 		          /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "tf-head-actions", children: [
@@ -15243,7 +15335,14 @@ window.__ModuleLoader__.load({
 		          onDelete: () => openDelete([{ kind: "bug", id: activeBug.id }]),
 		          onComplete: () => setDecision({ kind: "complete-bug", bug: activeBug, busy: false, error: null }),
 		          onStartFix: (tier) => startBugFix(activeBug, tier),
-		          onCancelFix: () => cancelBugFix(activeBug)
+		          onCancelFix: () => cancelBugFix(activeBug),
+		          onNewDiscussion: () => startRecordDiscussion({
+		            kind: "bug",
+		            id: activeBug.id,
+		            title: activeBug.title,
+		            workspaceId: activeBug.workspaceId
+		          }),
+		          discussionBusy: recordDiscussionBusy === "bug"
 		        }
 		      ) : null,
 		      view.kind === "story" && activeStory !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -15263,7 +15362,14 @@ window.__ModuleLoader__.load({
 		          onCancelRun: () => setDecision({ kind: "cancel-run", story: activeStory, busy: false, error: null }),
 		          onOpenSession: (sessionId) => openSession(sessionId),
 		          onOpenPath: openFile,
-		          onMissing: (path) => showToast(t("doc.linkMissing", { path }))
+		          onMissing: (path) => showToast(t("doc.linkMissing", { path })),
+		          onNewDiscussion: () => startRecordDiscussion({
+		            kind: "story",
+		            id: activeStory.id,
+		            title: activeStory.title,
+		            workspaceId: activeStory.workspaceId
+		          }),
+		          discussionBusy: recordDiscussionBusy === "story"
 		        }
 		      ) : null
 		    ] }) }),
@@ -16140,6 +16246,8 @@ window.__ModuleLoader__.load({
 		  onComplete,
 		  onStartFix,
 		  onCancelFix,
+		  onNewDiscussion,
+		  discussionBusy = false,
 		  readOnly = false
 		}) {
 		  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(import_jsx_runtime10.Fragment, { children: [
@@ -16166,27 +16274,42 @@ window.__ModuleLoader__.load({
 		      readOnly ? null : /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("button", { className: "tf-btn tf-danger", "data-tone": "ghost", type: "button", onClick: onDelete, style: { flex: "0 0 auto" }, children: [
 		        /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(TrashGlyph, {}),
 		        t("delete.action")
-		      ] }),
-		      readOnly || bug.sessionId === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
-		        "button",
-		        {
-		          className: "tf-btn",
-		          "data-tone": "live",
-		          type: "button",
-		          onClick: () => onOpenSession(bug.sessionId),
-		          style: { flex: "0 0 auto" },
-		          children: [
-		            /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(ChatGlyph, {}),
-		            t("row.open")
-		          ]
-		        }
-		      )
+		      ] })
 		    ] }),
 		    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "tf-grid", children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { children: [
 		        /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("section", { className: "tf-card", children: [
-		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(SectionHead, { title: t("detail.bugBody") }),
-		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "tf-doc-body", children: bug.bodyMissing ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { className: "tf-card-hint", children: t("body.missingGeneric") }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(MarkdownBody, { text: bug.content.join("\n"), t }) })
+		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
+		            SectionHead,
+		            {
+		              title: t("detail.bugBody"),
+		              action: readOnly || onNewDiscussion === void 0 ? void 0 : /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
+		                "button",
+		                {
+		                  className: "tf-btn tf-btn-sm",
+		                  "data-tone": "soft",
+		                  type: "button",
+		                  disabled: discussionBusy,
+		                  onClick: onNewDiscussion,
+		                  children: [
+		                    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(PlusGlyph, {}),
+		                    discussionBusy ? t("detail.discussionStarting") : t("detail.bugDiscussion")
+		                  ]
+		                }
+		              )
+		            }
+		          ),
+		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "tf-doc-body", children: bug.bodyMissing ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { className: "tf-card-hint", children: t("body.missingGeneric") }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(MarkdownBody, { text: bug.content.join("\n"), t }) }),
+		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
+		            DiscussionSessions,
+		            {
+		              t,
+		              sessions: bug.sessions,
+		              sessionTitle,
+		              onOpenSession,
+		              readOnly
+		            }
+		          )
 		        ] }),
 		        /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("section", { className: "tf-card", children: [
 		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -16262,6 +16385,8 @@ window.__ModuleLoader__.load({
 		  onOpenSession,
 		  onOpenPath,
 		  onMissing,
+		  onNewDiscussion,
+		  discussionBusy = false,
 		  readOnly = false
 		}) {
 		  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(import_jsx_runtime10.Fragment, { children: [
@@ -16311,7 +16436,26 @@ window.__ModuleLoader__.load({
 		    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "tf-grid", children: [
 		      /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { children: [
 		        /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("section", { className: "tf-card", children: [
-		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(SectionHead, { title: t("detail.storyBody") }),
+		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
+		            SectionHead,
+		            {
+		              title: t("detail.storyBody"),
+		              action: readOnly || onNewDiscussion === void 0 ? void 0 : /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
+		                "button",
+		                {
+		                  className: "tf-btn tf-btn-sm",
+		                  "data-tone": "soft",
+		                  type: "button",
+		                  disabled: discussionBusy,
+		                  onClick: onNewDiscussion,
+		                  children: [
+		                    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(PlusGlyph, {}),
+		                    discussionBusy ? t("detail.discussionStarting") : t("detail.storyDiscussion")
+		                  ]
+		                }
+		              )
+		            }
+		          ),
 		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "tf-doc-body", children: story.bodyMissing ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { className: "tf-card-hint", style: { margin: 0 }, children: t("body.missing", { path: story.path }) }) : story.body.trim() === "" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("p", { className: "tf-card-hint", style: { margin: 0 }, children: t("detail.noDescription") }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
 		            MarkdownBody,
 		            {
@@ -16321,7 +16465,17 @@ window.__ModuleLoader__.load({
 		              onOpenPath,
 		              onMissing
 		            }
-		          ) })
+		          ) }),
+		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
+		            DiscussionSessions,
+		            {
+		              t,
+		              sessions: story.sessions,
+		              sessionTitle,
+		              onOpenSession,
+		              readOnly
+		            }
+		          )
 		        ] }),
 		        /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("section", { className: "tf-card", children: [
 		          /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -17091,6 +17245,9 @@ window.__ModuleLoader__.load({
 		    prepareRequirementSession: async (requirementId, sessionId, kind) => callRemote(
 		      (await ready.promise).prepareRequirementSession(requirementId, sessionId, kind, locale())
 		    ),
+		    prepareDiscussionSession: async (subjectType, subjectId, sessionId, kind) => callRemote(
+		      (await ready.promise).prepareDiscussionSession(subjectType, subjectId, sessionId, kind, locale())
+		    ),
 		    sessionPermissionTier: async (sessionId) => callRemote((await ready.promise).sessionPermissionTier(sessionId, locale())),
 		    previewDelete: async (targets) => callRemote((await ready.promise).previewDelete(targets, locale())),
 		    deleteRecords: async (targets) => callRemote((await ready.promise).deleteRecords(targets, locale())),

package/lib/index.d.ts

@@ -16,6 +16,11 @@ export interface Config {
      * which is the only location this plugin owns.
      */
     dataDir: string;
+    /**
+     * Document root override. Empty uses `<dataDir>/docs`, next to the database;
+     * relative paths resolve against the working directory and `~/` is expanded.
+     */
+    docsDir: string;
     /** SQLite busy timeout in milliseconds; a second instance waits this long for the write lock. */
     busyTimeoutMs: number;
 }
@@ -32,7 +37,8 @@ export declare function apply(ctx: Context, config: Config): void;
 export type { TeamflowDatabase, StartupReport, Role } from './store/db.ts';
 export type { SchemaComment } from './store/schema.ts';
 export { WorkflowStore } from './store/workflow.ts';
-export { DOC_ROOT, docPath, ensureDocTree, resolveDocPath } from './store/docs.ts';
+export { docPath, ensureDocTree, resolveDocPath } from './store/docs.ts';
+export { DOCS_DIRNAME, defaultDocsDir, resolveDocsDir } from './store/paths.ts';
 export type { DocKind as DocFileKind } from './store/docs.ts';
 export type { WorkflowStoreOptions } from './store/workflow.ts';
 export { WorkflowError } from './store/model.ts';

package/lib/index.js

@@ -7,6 +7,9 @@ export const Config = Schema.object({
     dataDir: Schema.string()
         .default('')
         .description('Workbench data directory. Empty uses $DSH_HOME/xirang-ai/dsh-teamflow.'),
+    docsDir: Schema.string()
+        .default('')
+        .description('Document root for requirement, design, story and bug bodies. Empty uses <dataDir>/docs; relative paths and ~/ are supported.'),
     busyTimeoutMs: Schema.number()
         .min(0)
         .max(60_000)
@@ -28,11 +31,13 @@ export function apply(ctx, config) {
         error: (message) => logger.error(message),
     };
     ctx.effect(() => {
-        // Document bodies live in the workspace directory, not the database, so the
-        // panel reads them by `content_path` through the live registry. Without the
-        // registry the store falls back to rows registered by the tool layer.
+        // Document bodies live below the plugin-owned document root, not the
+        // database and not the user's workspace; the panel reads them by
+        // `content_path` relative to that one root. The registry stays wired for
+        // workspace display only.
         const database = openTeamflowDatabase({
             dataDir: config.dataDir,
+            docsDir: config.docsDir,
             busyTimeoutMs: config.busyTimeoutMs,
             // Resolved lazily: the optional registry may register after this effect runs.
             workspaceRoot: (workspaceId) => ctx.get('workspaceRegistry')?.get(workspaceId)?.path,
@@ -66,6 +71,7 @@ export function apply(ctx, config) {
     }, 'teamflow: workbench database');
 }
 export { WorkflowStore } from "./store/workflow.js";
-export { DOC_ROOT, docPath, ensureDocTree, resolveDocPath } from "./store/docs.js";
+export { docPath, ensureDocTree, resolveDocPath } from "./store/docs.js";
+export { DOCS_DIRNAME, defaultDocsDir, resolveDocsDir } from "./store/paths.js";
 export { WorkflowError } from "./store/model.js";
 export { MAX_DELETE_TARGETS } from "./store/workflow.js";

package/lib/remote/contract.d.ts

@@ -36,7 +36,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
         register(contribution: HostContribution): TypertDisposer;
     }
 }
-import type { BugSeverity, BugStatus, DeletePreview, DeleteReport, DeleteTarget, DocKind, RequirementSessionKind, RequirementStatus, RunKind, RunStatus, StorySize, StoryStatus } from '../store/model.ts';
+import type { BugSeverity, BugStatus, DeletePreview, DiscussionSubjectType, DeleteReport, DeleteTarget, DocKind, RequirementSessionKind, RequirementStatus, RunKind, RunStatus, StorySize, StoryStatus } from '../store/model.ts';
 /** npm package that owns these Remote methods. */
 export declare const PACKAGE_NAME = "@xirang-ai/dsh-teamflow";
 /**
@@ -89,6 +89,8 @@ export interface SnapshotStory {
     readonly completedAt: string | null;
     /** Conversation that created the story; null when it was not recorded. */
     readonly createSessionId: string | null;
+    /** Confirmed discussions of this story, newest first. */
+    readonly sessions: readonly SnapshotDiscussionSession[];
 }
 /** One 详细设计 document; its body is fetched on demand by {@link readDoc}. */
 export interface SnapshotDoc {
@@ -121,6 +123,8 @@ export interface SnapshotBug {
     readonly completedAt: string | null;
     /** Conversation that created the defect; null when it was not recorded. */
     readonly createSessionId: string | null;
+    /** Confirmed discussions of this defect, newest first. */
+    readonly sessions: readonly SnapshotDiscussionSession[];
 }
 /** One development or fix run; `sessionId` is the conversation it happened in. */
 export interface SnapshotRun {
@@ -148,6 +152,17 @@ export interface SnapshotRequirementSession {
     readonly linkedAt: string | null;
     readonly createdAt: string;
 }
+/** One discussion conversation attached to a story or a defect. */
+export interface SnapshotDiscussionSession {
+    readonly sessionId: string;
+    /** `discuss` for stories and defects; requirements keep their own kinds. */
+    readonly kind: string;
+    /** Browser preparation time; null only for conversations that skipped it. */
+    readonly preparedAt: string | null;
+    /** Agent confirmation time; null while the discussion is pending. */
+    readonly linkedAt: string | null;
+    readonly createdAt: string;
+}
 /** Everything the list, the design tree and the defect list need in one frame. */
 export interface WorkbenchSnapshot {
     /** When the Host read the rows; the panel shows it next to the refresh button. */
@@ -226,6 +241,16 @@ export interface RequirementSessionReply {
     readonly preparedAt: string | null;
     readonly linkedAt: string | null;
 }
+/** One discussion row as stored; `linkedAt` is null until the Agent confirms. */
+export interface DiscussionSessionReply {
+    readonly subjectType: DiscussionSubjectType;
+    readonly subjectId: string;
+    readonly sessionId: string;
+    readonly kind: string;
+    readonly preparedAt: string | null;
+    readonly linkedAt: string | null;
+    readonly createdAt: string;
+}
 /** Success or failure envelope the browser mounts produce. */
 export type RemoteResult<Value> = {
     readonly ok: true;
@@ -323,6 +348,13 @@ export interface WorkbenchRemote {
      * of the snapshot until `teamflow_link_requirement_session` writes `linkedAt`.
      */
     prepareRequirementSession(requirementId: string, sessionId: string, kind: RequirementSessionKind, locale?: string): Promise<RemoteResult<RequirementSessionReply>>;
+    /**
+     * Register a newly created session as a pending discussion of any subject.
+     *
+     * Same two-phase contract as {@link prepareRequirementSession}, extended to
+     * stories and defects; this method never writes `linkedAt`.
+     */
+    prepareDiscussionSession(subjectType: DiscussionSubjectType, subjectId: string, sessionId: string, kind: string, locale?: string): Promise<RemoteResult<DiscussionSessionReply>>;
     /**
      * Read the tier a conversation was started with, for the session header.
      *
@@ -357,6 +389,7 @@ export declare const METHODS: {
     readonly cancelStory: "cancelStory";
     readonly completeBug: "completeBug";
     readonly prepareRequirementSession: "prepareRequirementSession";
+    readonly prepareDiscussionSession: "prepareDiscussionSession";
     readonly sessionPermissionTier: "sessionPermissionTier";
     readonly previewDelete: "previewDelete";
     readonly deleteRecords: "deleteRecords";

package/lib/remote/contract.js

@@ -22,6 +22,7 @@ export const METHODS = {
     cancelStory: 'cancelStory',
     completeBug: 'completeBug',
     prepareRequirementSession: 'prepareRequirementSession',
+    prepareDiscussionSession: 'prepareDiscussionSession',
     sessionPermissionTier: 'sessionPermissionTier',
     previewDelete: 'previewDelete',
     deleteRecords: 'deleteRecords',
@@ -170,6 +171,21 @@ export const DESCRIPTORS = Object.freeze([
         ]),
         result: JSON_CODEC,
     }),
+    Object.freeze({
+        id: `${PACKAGE_NAME}#${METHODS.prepareDiscussionSession}`,
+        service: SERVICE_KEY,
+        namespace: NAMESPACE,
+        method: METHODS.prepareDiscussionSession,
+        invocation: { kind: 'direct' },
+        parameters: Object.freeze([
+            parameter('subjectType', 'Discussion subject: requirement, story or bug'),
+            parameter('subjectId', 'Requirement, story or defect the discussion belongs to'),
+            parameter('sessionId', 'Newly created conversation to link'),
+            parameter('kind', 'Discussion kind: discuss for stories and defects, the requirement kinds otherwise'),
+            LOCALE_PARAMETER,
+        ]),
+        result: JSON_CODEC,
+    }),
     Object.freeze({
         id: `${PACKAGE_NAME}#${METHODS.sessionPermissionTier}`,
         service: SERVICE_KEY,

package/lib/remote/service.d.ts

@@ -10,9 +10,9 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import type { DeletePreview, DeleteReport, DeleteTarget, RequirementSessionKind } from '../store/model.ts';
+import type { DeletePreview, DeleteReport, DeleteTarget, DiscussionSubjectType, RequirementSessionKind } from '../store/model.ts';
 import type { WorkflowStore } from '../store/workflow.ts';
-import type { AttachmentPolicy, BugRunReply, BugStatusReply, CancelRunReply, DocBody, RequirementSessionReply, RequirementStatusReply, SessionTierReply, StartRunReply, StoryStatusReply, WorkbenchSnapshot } from './contract.ts';
+import type { AttachmentPolicy, BugRunReply, BugStatusReply, CancelRunReply, DiscussionSessionReply, DocBody, RequirementSessionReply, RequirementStatusReply, SessionTierReply, StartRunReply, StoryStatusReply, WorkbenchSnapshot } from './contract.ts';
 /**
  * Remote face of the workbench.
  *
@@ -134,6 +134,19 @@ export declare class WorkbenchService extends TypertRemoteService {
      * @returns the stored pending row.
      */
     prepareRequirementSession(requirementId: string, sessionId: string, kind?: RequirementSessionKind, locale?: string): RequirementSessionReply;
+    /**
+     * Register a newly created conversation as a pending discussion of any subject.
+     *
+     * Same two-phase contract as {@link prepareRequirementSession}: the Agent
+     * confirms with `teamflow_link_session`, and this method never writes the
+     * confirmation time itself.
+     * @param subjectType - requirement, story or bug.
+     * @param subjectId - record the discussion belongs to.
+     * @param sessionId - session created by the browser for this discussion.
+     * @param kind - `discuss` for stories and defects; requirement kinds otherwise.
+     * @returns the stored pending row.
+     */
+    prepareDiscussionSession(subjectType: DiscussionSubjectType, subjectId: string, sessionId: string, kind: string, locale?: string): DiscussionSessionReply;
     /**
      * Compute deletion impact without writing anything.
      * @param targets - records the user selected in the panel.