@joekytc/dsh-swarm 0.3.8 → 0.3.10

package/lib/wiki/page-path.d.ts

@@ -1,5 +1,5 @@
 /** 命名空间提示（报错/工具 description 文案单一来源，禁止散落硬编码）。 */
-export declare const KB_PAGE_NAMESPACES_HINT = "projects/<repoSlug>/checklists/\u3001projects/<repoSlug>/learnings/\u3001projects/<repoSlug>/ch_*/learnings/\u3001projects/<repoSlug>/ch_*/t_*.md\u3001projects/<repoSlug>/ch_*/review/\u3001projects/<repoSlug>/reviews/<topic>-<ymd>/";
+export declare const KB_PAGE_NAMESPACES_HINT = "projects/<repoSlug>/checklists/\u3001projects/<repoSlug>/source-docs/\u3001projects/<repoSlug>/learnings/\u3001projects/<repoSlug>/ch_*/learnings/\u3001projects/<repoSlug>/ch_*/t_*.md\u3001projects/<repoSlug>/ch_*/review/\u3001projects/<repoSlug>/reviews/<topic>-<ymd>/";
 /** 从需求名（回退 problem）派生 URL 安全 slug：ASCII 化、空格/特殊字符→-、限长 40；全非 ASCII（如中文）兜底 'req'。 */
 export declare function buildChecklistSlug(name: string): string;
 export declare function isAllowedWikiPagePath(pagePath: string): boolean;
@@ -8,6 +8,7 @@ export declare function isLearningsPath(pagePath: string): boolean;
 /** 工具边界硬校验：不符白名单直接抛 kb-rejected（wiki_write 用）。 */
 export declare function assertAllowedWikiPagePath(pagePath: string): void;
 export declare const LOCAL_CHECKLIST_PREFIX = "wiki/queries/checklists/";
+export declare const LOCAL_SOURCE_DOCS_PREFIX = "wiki/queries/source-docs/";
 export declare const LOCAL_LEARNING_BASE = "wiki/synthesis/learnings/";
 /** 本地模式交付白名单：KB 库根下 wiki/** 相对路径（拒绝对象路径、.. 穿越、空串）。 */
 export declare function isLocalKbPagePath(pagePath: string): boolean;

package/lib/wiki/page-path.js

@@ -2,6 +2,7 @@
 // KB 页面路径统一规则（单一来源）：一级段 = repoSlug（buildRepoSlug(workspaceDir) 派生），
 // 知识库内按目标仓库分组定位。旧全局命名空间（projects/checklists|learnings|ch_* 直挂根）已断代，不兼容。
 //   需求清单      projects/<repoSlug>/checklists/<slug>-<ts>.md  （planning_checklist_save，代码强制）
+//   PRD 原文切片  projects/<repoSlug>/source-docs/<slug>-part-NN.md  （planning_prd_collect，代码强制）
 //   实施计划/结果 projects/<repoSlug>/ch_<id>/t_<id>.md          （W2/W3 wiki_write，工具边界强制）
 //   DT 评审页     projects/<repoSlug>/ch_<id>/review/<name>.md   （DT wiki_write + 写护栏强制）
 //   独立评审报告  projects/<repoSlug>/reviews/<topic>-<ymd>/     （独立 DT 模式 wiki_write，形态由 domain/ocr-review 判定）
@@ -9,9 +10,9 @@
 import { WikiError } from './wiki-vault-client.js';
 import { isStandaloneReviewNamespacePath } from '../domain/ocr-review.js';
 /** 命名空间提示（报错/工具 description 文案单一来源，禁止散落硬编码）。 */
-export const KB_PAGE_NAMESPACES_HINT = 'projects/<repoSlug>/checklists/、projects/<repoSlug>/learnings/、projects/<repoSlug>/ch_*/learnings/、projects/<repoSlug>/ch_*/t_*.md、projects/<repoSlug>/ch_*/review/、projects/<repoSlug>/reviews/<topic>-<ymd>/';
-/** 白名单：projects/<repoSlug>/ 下五类命名空间（repoSlug=[a-z0-9-]+，杜绝 LLM 自造路径）。 */
-const KB_PAGE_PATH_RE = /^projects\/[a-z0-9-]+\/(?:checklists\/|learnings\/|ch_[0-9a-z_]+\/(?:t_[0-9a-z_]+\.md|review\/|learnings\/))/;
+export const KB_PAGE_NAMESPACES_HINT = 'projects/<repoSlug>/checklists/、projects/<repoSlug>/source-docs/、projects/<repoSlug>/learnings/、projects/<repoSlug>/ch_*/learnings/、projects/<repoSlug>/ch_*/t_*.md、projects/<repoSlug>/ch_*/review/、projects/<repoSlug>/reviews/<topic>-<ymd>/';
+/** 白名单：projects/<repoSlug>/ 下六类命名空间（repoSlug=[a-z0-9-]+，杜绝 LLM 自造路径）。 */
+const KB_PAGE_PATH_RE = /^projects\/[a-z0-9-]+\/(?:checklists\/|learnings\/|source-docs\/|ch_[0-9a-z_]+\/(?:t_[0-9a-z_]+\.md|review\/|learnings\/))/;
 /** 从需求名（回退 problem）派生 URL 安全 slug：ASCII 化、空格/特殊字符→-、限长 40；全非 ASCII（如中文）兜底 'req'。 */
 export function buildChecklistSlug(name) {
     const slug = name
@@ -33,11 +34,12 @@ export function isLearningsPath(pagePath) {
 /** 工具边界硬校验：不符白名单直接抛 kb-rejected（wiki_write 用）。 */
 export function assertAllowedWikiPagePath(pagePath) {
     if (!isAllowedWikiPagePath(pagePath)) {
-        throw new WikiError('kb-rejected', undefined, `page path outside allowed namespaces (${KB_PAGE_NAMESPACES_HINT}): ${pagePath}`);
+        throw new WikiError('kb-rejected', undefined, `kb-rejected: page path outside allowed namespaces (${KB_PAGE_NAMESPACES_HINT}): ${pagePath}`);
     }
 }
 // ── 本地 KB（llm-wiki）路径规则（双模式）──────────────────────────────
 export const LOCAL_CHECKLIST_PREFIX = 'wiki/queries/checklists/';
+export const LOCAL_SOURCE_DOCS_PREFIX = 'wiki/queries/source-docs/';
 export const LOCAL_LEARNING_BASE = 'wiki/synthesis/learnings/';
 /** 本地模式交付白名单：KB 库根下 wiki/** 相对路径（拒绝对象路径、.. 穿越、空串）。 */
 export function isLocalKbPagePath(pagePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joekytc/dsh-swarm",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "A governed swarm of six specialist DSH agents (orchestrator, planner, knowledge-base bridge, developer and two reviewers) that turns a requirement into a strict phase pipeline with machine-verified delivery evidence, review-gated merges, a full audit-log event stream and a live kanban tab; design inspired by the Hermes Agent kanban",
   "license": "MIT",
   "author": "joekytc",
@@ -90,4 +90,4 @@
     "typescript": "^5.8.0",
     "vitest": "^3.0.0"
   }
-}
+}

package/personas/kanban-dt/agent.cordis.yml

@@ -36,7 +36,10 @@
       feature branch from the parent handoff metadata.branch; you may pass background with a
       one-line business context distilled from the spec card / task description); silently
       fall back to the delegate flow when status is not completed or the tool returns
-      managed-not-configured guidance. When ocr is not installed the tool returns install guidance (installable
+      managed-not-configured guidance. ocr_review targets the session working directory ({{cwd}}) when you
+      omit repo — pass repo=<absolute path> explicitly whenever the review target is not that directory
+      (e.g. D's worktree from the parent handoff metadata.worktree_dir, or another repo / temp clone).
+      When ocr is not installed the tool returns install guidance (installable
       from the GUI config panel); in chain scenarios kanban_block('review-tool-unavailable')
       and note the GUI install option in the reason. Standalone review mode (no bound chain
       task): review user-specified local dirs, branch ranges (--from/--to), single commits,

package/personas/persona-dt.md

@@ -18,7 +18,8 @@
 
 ## open-code-review（ocr）评审引擎（双模）
 - 评审引擎由配置面板 reviewEngine.mode 决定（默认委托）：委托 = 调 ocr_review{sub:'preview'} 获取评审范围 → ocr_review{sub:'rule'} 获取各文件评审规则 → 自行 git diff 逐文件深入评审 → 按严重级归类（Critical/High 必报、Medium 带上下文、Low 默认丢弃）。
-- 托管 = 调 ocr_review{sub:'managed', from:<TARGET_BRANCH>, to:<branch>}（branch 取 D 交接 metadata.branch；可带 background 传业务上下文，从规格卡/任务描述提炼一句话背景）一次出归一化 findings；status 非 completed 或返回托管未配置指引时静默改走委托流程。
+- 托管 = 调 ocr_review{sub:'managed', from:<TARGET_BRANCH>, to:<branch>}（branch 取 D 交接 metadata.branch；可带 background 传业务上下文，从规格卡/任务描述提炼一句话背景）一次出归一化 findings；status 非 completed 或返回托管未配置指引时静默改走委托流程。托管返回「未配置 LLM」指引但配置面板已选好提供方/模型时，提示用户点「应用到 ocr」。
+- repo 参数（三子命令通用）：省略 = 当前会话工作目录（链上 DT 会话即链工作区）；评审目标不在该目录内（D 的 worktree / 其他仓库 / 临时 clone）时必须显式传 repo=<目标仓库绝对路径>（D 工作区取父交接 metadata.worktree_dir 或规格卡 file-prefetch 附件 ref）。
 - ocr 未安装时工具自动返回中文安装指引（可在 GUI 配置面板安装）；链上场景按规则 kanban_block('review-tool-unavailable') 并在 reason 注明 GUI 可安装。
 
 ## 独立评审模式

package/skills/grill-me/SKILL.md

@@ -42,6 +42,13 @@ Each round the user answers reshapes the tree: settled decisions push the fronti
 
 Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The _decisions_ are the user's: put each to them and wait.
 
+## Clarification record standard (hard rule)
+
+- Every recorded Q&A must carry its full decision body: field names, API paths, enum values, component names, placement rules. Never record shorthand like "按推荐" / "同上" / "see above" — a fresh context must be able to work from the record alone.
+- Requirement sources (TAPD/Jira links) are recorded up front; if none exists, record "no source + reason" explicitly.
+- When the user provides PRD/requirement-doc links, collect them before grilling; if collection is blocked, stop and surface the categorized fix (login / missing skill / dead link) — never guess content, never skip.
+- Every decision is traceable to at least one of: clarification Q&A number, repo source path, or a location in the requirement/API doc. Where a confirmed decision contradicts the original doc value, mark it 【已调整】/【已确认】; never record unconfirmed values without an explicit 「待确认」 mark. With no source record, a decision reads as agent-defaulted.
+
 ## Closing deliverable
 
 The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed, and the user confirms you have reached a shared understanding. Do not act on the plan until the user confirms. Once they confirm, produce the closing deliverable: