@marsken/dsh-studio 0.0.0-stage → 0.1.1

package/locale/en.json

@@ -0,0 +1,11 @@
+{
+  "meta": {
+    "title": "Studio",
+    "description": "Product / architect / developer / QA multi-agent collaboration with a live work board; GitLab and Feishu connections are configured in the GUI."
+  },
+  "shared": {
+    "entry": {
+      "label": "Studio"
+    }
+  }
+}

package/locale/zh.json

@@ -0,0 +1,11 @@
+{
+  "meta": {
+    "title": "需求&任务工作空间",
+    "description": "产品 / 架构 / 研发 / 测试多智能体协作与工作看板，GitLab 与飞书连接可在界面内配置。"
+  },
+  "shared": {
+    "entry": {
+      "label": "需求&任务工作空间"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@marsken/dsh-studio",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "DSH Studio: role-based multi-agent workspace (product / architect / developer / QA) with a live work board, GitLab + Feishu connection settings, all configurable from the web GUI.",
+  "main": "index.js",
+  "keywords": ["dsh", "dsh-plugin", "ai-agents", "kanban", "multi-agent", "requirements", "regression"],
+  "icon": "./icon.svg",
+  "repository": { "type": "git", "url": "git+https://github.com/marsken88/dsh-studio.git" },
+  "homepage": "https://github.com/marsken88/dsh-studio#readme",
+  "scripts": {
+    "test": "node --test tests/repo.test.mjs tests/store-boot.test.mjs tests/client-units.test.mjs tests/notify.test.mjs",
+    "check": "node --check index.js && node --check client.src.js && node --test tests/repo.test.mjs tests/store-boot.test.mjs tests/client-units.test.mjs tests/notify.test.mjs",
+    "smoke:store": "node scripts/smoke-store.mjs"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "src",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "dist/client.js",
+    "client.src.js",
+    "AGENTS.md",
+    "docs/*.md",
+    "docs/images/*.png",
+    "scripts/*.mjs"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.2-rc.1+": "compatible"
+      }
+    }
+  },
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.2-rc.1"
+  },
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "pixelmatch": "^8.0.0",
+    "pngjs": "^7.0.0",
+    "puppeteer-core": "^25.17.0",
+    "ssh2": "^1.17.0"
+  }
+}

package/scripts/smoke-store.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/* Boot a copy of a real Studio database locally.
+
+   Motivated by a stretch of deploys where the service 502'd only on the real
+   data path (`sanitizeRelease` / `canonicalAuthor` / `ROLE_LABELS` were used
+   before they were imported). `node --check` cannot see that class of bug, and
+   an empty temp database does not exercise `#load()` deeply enough — this
+   script copies the production `.db`/`-wal`/`-shm` trio into a scratch
+   directory and runs the exact startup path against it.
+
+   Usage:
+     node scripts/smoke-store.mjs ~/.dsh/dsh-studio.db
+     npm run smoke:store -- /tmp/dsh-studio-backup-20261111-231911.db
+
+   Exits non-zero when the store cannot boot or reports no state. */
+
+import { copyFile, mkdtemp, rm } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { homedir, tmpdir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { SecretStore, StudioStore } from '../src/host/store.js'
+
+const given = process.argv[2]
+if (!given) {
+  console.error('usage: node scripts/smoke-store.mjs <path-to-dsh-studio.db|.json>')
+  process.exit(2)
+}
+
+const source = resolve(given.replace(/^~(?=$|[\\/])/, homedir()))
+const dbSource = source.endsWith('.json') ? source.replace(/\.json$/, '.db') : source
+if (!existsSync(dbSource)) {
+  console.error(`✖ database not found: ${dbSource}`)
+  process.exit(2)
+}
+
+const dir = await mkdtemp(join(tmpdir(), 'dsh-smoke-'))
+const copied = []
+try {
+  for (const suffix of ['', '-wal', '-shm']) {
+    const from = `${dbSource}${suffix}`
+    if (!existsSync(from)) continue
+    await copyFile(from, join(dir, `smoke.db${suffix}`))
+    copied.push(`smoke.db${suffix}`)
+  }
+
+  const store = new StudioStore(join(dir, 'smoke.json'), {
+    dbFile: join(dir, 'smoke.db'),
+    secrets: new SecretStore(join(dir, 'smoke-secrets.json')),
+  })
+  await store.ready
+  await store.chain
+
+  const state = store.snapshot()
+  const summary = {
+    engine: typeof store.describe === 'function' ? store.describe().engine : store.engine,
+    revision: state.revision,
+    tasks: (state.tasks ?? []).length,
+    requirements: (state.requirements ?? []).length,
+    releases: (state.releases ?? []).length,
+    audit: (state.audit ?? []).length,
+    experts: (state.config?.experts ?? []).length,
+    columns: Object.keys(state.config?.columns ?? {}).length,
+    files: copied,
+  }
+  console.log(JSON.stringify(summary))
+
+  if (!summary.tasks && !summary.requirements) {
+    console.error('✖ store booted but carries no tasks or requirements — wrong database?')
+    process.exitCode = 1
+  } else {
+    console.log(`✓ ${summary.engine} store booted from ${dbSource}`)
+  }
+  store.db?.close?.()
+} finally {
+  await rm(dir, { recursive: true, force: true }).catch(() => {})
+}

package/src/host/cases.js

@@ -0,0 +1,135 @@
+// dsh-studio · 跨卡用例的聚合与回归汇总（纯函数，不碰台账）
+// 从 domain.js 拆出来：那边有 2000 行的硬上限（tests/repo.test.mjs 会拦）。
+
+/** 一批回归跑完后的汇总记录（写给「最近回归」用，不占 state、不涨 revision）。 */
+export function summarizeRun(results, by, at = Date.now()) {
+  const rows = Array.isArray(results) ? results : []
+  const sum = key => rows.reduce((n, item) => n + (Number(item[key]) || 0), 0)
+  return {
+    at,
+    by: String(by ?? '').slice(0, 40),
+    cards: rows.length,
+    failedCards: rows.filter(item => item.ok === false).length,
+    total: sum('total'),
+    passed: sum('passed'),
+    failed: sum('failed'),
+    bugs: sum('bugs'),
+  }
+}
+
+/** 把 "taskId:caseId" 的键按卡分组（跨卡回归就是这么拆成一轮一轮跑的）；坏键直接丢掉。 */
+export function groupCaseKeys(keys) {
+  const byTask = new Map()
+  for (const key of Array.isArray(keys) ? keys : []) {
+    const raw = String(key ?? '')
+    const at = raw.indexOf(':')
+    if (at <= 0 || at === raw.length - 1) continue
+    const taskId = raw.slice(0, at)
+    const caseId = raw.slice(at + 1)
+    if (!byTask.has(taskId)) byTask.set(taskId, [])
+    byTask.get(taskId).push(caseId)
+  }
+  return byTask
+}
+
+/** 跨卡用例总览：把每张卡上的用例摊成一张表，带上卡片与需求的上下文。纯函数，方便单测。 */
+export function collectCases(state) {
+  const requirementById = new Map((state?.requirements ?? []).map(item => [item.id, item]))
+  const out = []
+  for (const task of state?.tasks ?? []) {
+    const requirement = requirementById.get(task.requirementId)
+    for (const item of task.cases ?? []) {
+      out.push({
+        key: `${task.id}:${item.id}`,
+        id: item.id,
+        title: item.title ?? '',
+        expected: item.expected ?? '',
+        result: item.result ?? 'pending',
+        type: item.type ?? 'functional',
+        priority: item.priority ?? 'p2',
+        pointId: item.pointId ?? '',
+        http: item.http !== null && item.http !== undefined,
+        lastRunAt: item.lastRun?.at ?? 0,
+        // 失败时最想看的三样：错在哪、返回了什么、上一次的结论文案。
+        lastError: String(item.lastRun?.error ?? '').slice(0, 300),
+        lastStatus: Number(item.lastRun?.status) || 0,
+        lastPreview: String(item.lastRun?.preview ?? '').slice(0, 400),
+        note: String(item.note ?? '').slice(0, 300),
+        taskId: task.id,
+        taskTitle: task.title ?? '',
+        taskCode: task.code ?? '',
+        taskStatus: task.status ?? '',
+        requirementId: task.requirementId ?? '',
+        requirementTitle: requirement?.title ?? '',
+        requirementCode: requirement?.code ?? '',
+      })
+    }
+  }
+  return out
+}
+
+
+// ---------------------------------------------------------------- 回归套件
+// 套件 = 一组规则（需求 / 优先级 / 是否接口用例）+ 手工挑的用例键。
+// 规则在跑的时候才解析成具体用例，所以新加的用例会自动进套件，不用回来改。
+
+const SUITES_KEY = 'suites'
+
+/** 建套件时的默认规则：只跑有 http 定义的，按卡串行。 */
+export const SUITE_DEFAULTS = { rules: { requirementIds: [], priorities: [], httpOnly: true }, keys: [] }
+
+/** 套件清洗：名字必有、规则白名单、手工键只留 "taskId:caseId" 形状的。 */
+export function sanitizeSuite(raw) {
+  const source = raw !== null && typeof raw === 'object' ? raw : {}
+  const rules = source.rules !== null && typeof source.rules === 'object' ? source.rules : {}
+  const id = String(source.id ?? '').trim() || `suite-${Math.random().toString(36).slice(2, 8)}`
+  return {
+    id,
+    name: String(source.name ?? '').trim().slice(0, 40) || '未命名套件',
+    note: String(source.note ?? '').slice(0, 200),
+    rules: {
+      requirementIds: (Array.isArray(rules.requirementIds) ? rules.requirementIds : []).map(String).filter(Boolean).slice(0, 20),
+      priorities: (Array.isArray(rules.priorities) ? rules.priorities : [])
+        .map(item => String(item).toLowerCase())
+        .filter(item => ['p0', 'p1', 'p2', 'p3'].includes(item))
+        .slice(0, 4),
+      httpOnly: rules.httpOnly !== false,
+    },
+    keys: (Array.isArray(source.keys) ? source.keys : []).map(String).filter(key => key.includes(':')).slice(0, 200),
+    isDefault: source.isDefault === true,
+    at: Number(source.at) || Date.now(),
+    by: String(source.by ?? '').slice(0, 40),
+  }
+}
+
+/** 套件解析成具体的用例键（去重）。 */
+export function resolveSuiteKeys(suite, cases) {
+  const rules = suite?.rules ?? {}
+  const requirementIds = Array.isArray(rules.requirementIds) ? rules.requirementIds.map(String) : []
+  const priorities = Array.isArray(rules.priorities) ? rules.priorities.map(String) : []
+  const httpOnly = rules.httpOnly !== false
+  const picked = new Set((Array.isArray(suite?.keys) ? suite.keys : []).map(String))
+  const out = new Set()
+  for (const row of Array.isArray(cases) ? cases : []) {
+    if (picked.has(row.key)) { out.add(row.key); continue }
+    if (httpOnly && row.http !== true) continue
+    if (requirementIds.length > 0 && !requirementIds.includes(row.requirementId)) continue
+    if (priorities.length > 0 && !priorities.includes(row.priority)) continue
+    out.add(row.key)
+  }
+  return [...out]
+}
+
+export async function loadSuites(store) {
+  const saved = await store.readSide(SUITES_KEY).catch(() => null)
+  return Array.isArray(saved) ? saved.map(sanitizeSuite) : []
+}
+
+/** 存整套：同一个时刻只允许一个默认套件（夜间跑的就是它）。 */
+export async function saveSuites(store, list) {
+  const suites = (Array.isArray(list) ? list : []).map(sanitizeSuite)
+  const firstDefault = suites.findIndex(item => item.isDefault === true)
+  if (firstDefault >= 0) suites.forEach((item, index) => { item.isDefault = index === firstDefault })
+  await store.writeSide(SUITES_KEY, suites).catch(() => {})
+  return suites
+}

package/src/host/design.js

@@ -0,0 +1,87 @@
+// 设计评审（一期）：卡上的设计状态 + 「进开发前必须评审过」的闸门。纯函数，方便单测。
+
+export const DESIGN_STATUS = ['pending', 'approved', 'changes_requested']
+
+/** 设计区：链接、评审状态、评审意见。没填过就是 null。 */
+export function sanitizeDesign(raw) {
+  if (raw === null || raw === undefined || typeof raw !== 'object') return null
+  const status = DESIGN_STATUS.includes(String(raw.status ?? '')) ? String(raw.status) : 'pending'
+  return {
+    link: String(raw.link ?? '').trim().slice(0, 500),
+    status,
+    note: String(raw.note ?? '').slice(0, 500),
+    by: String(raw.by ?? '').slice(0, 40),
+    at: Number(raw.at) || 0,
+    // 设计还原度：tools/visual/design-diff.mjs 算出来的差异百分比（0 = 一模一样）。
+    diff: raw.diff === null || raw.diff === undefined || typeof raw.diff !== 'object'
+      ? null
+      : {
+        percent: Math.min(100, Math.max(0, Number(raw.diff.percent) || 0)),
+        url: String(raw.diff.url ?? '').slice(0, 500),
+        at: Number(raw.diff.at) || 0,
+        by: String(raw.diff.by ?? '').slice(0, 40),
+      },
+    // 设计规范体检（design-audit.mjs）的结果摘要：查了多少元素、几处野值、最扎眼的前三条。
+    spec: raw.spec === null || raw.spec === undefined || typeof raw.spec !== 'object'
+      ? null
+      : {
+        checked: Math.max(0, Number(raw.spec.checked) || 0),
+        violations: Math.max(0, Number(raw.spec.violations) || 0),
+        at: Number(raw.spec.at) || 0,
+        by: String(raw.spec.by ?? '').slice(0, 40),
+        top: (Array.isArray(raw.spec.top) ? raw.spec.top : []).slice(0, 5).map(item => ({
+          kind: String(item?.kind ?? '').slice(0, 20),
+          value: String(item?.value ?? '').slice(0, 40),
+          count: Math.max(0, Number(item?.count) || 0),
+        })),
+      },
+  }
+}
+
+/** 还原度低于这个值就算没还原。 */
+export const FIDELITY_TARGET = 95
+
+/**
+ * 把还原度写进验收清单：找到「设计还原度」那一行就更新，没有就补一行。
+ * 低于 FIDELITY_TARGET 就留成未勾——验收时人一眼能看到差在哪。
+ */
+export function applyFidelityItem(checklist, percent) {
+  const list = Array.isArray(checklist) ? checklist : []
+  const score = Math.max(0, 100 - (Number(percent) || 0))
+  const text = `设计还原度 ≥ ${FIDELITY_TARGET}%（当前 ${score.toFixed(1)}%）`
+  const index = list.findIndex(item => String(item?.text ?? '').startsWith('设计还原度'))
+  const item = { id: index >= 0 ? list[index].id : `k-fidelity-${Date.now().toString(36)}`, text, done: score >= FIDELITY_TARGET }
+  if (index >= 0) list[index] = { ...list[index], ...item }
+  else list.push(item)
+  return list
+}
+
+/** 把规范体检结果写进验收清单：0 处才勾，有野值就留成待复核并列出前两条。 */
+export function applySpecItem(checklist, spec) {
+  const list = Array.isArray(checklist) ? checklist : []
+  const count = Math.max(0, Number(spec?.violations) || 0)
+  const top = (Array.isArray(spec?.top) ? spec.top : []).slice(0, 2).map(item => `${item.value}×${item.count}`).join('、')
+  const text = count === 0
+    ? '设计规范体检：没有野值'
+    : `设计规范体检：${count} 处待复核${top === '' ? '' : `（${top}）`}`
+  const index = list.findIndex(item => String(item?.text ?? '').startsWith('设计规范体检'))
+  const item = { id: index >= 0 ? list[index].id : `k-spec-${Date.now().toString(36)}`, text, done: count === 0 }
+  if (index >= 0) list[index] = { ...list[index], ...item }
+  else list.push(item)
+  return list
+}
+
+/**
+ * 进开发前的闸门：只有开了开关、且目标列在 columns 里才拦。
+ * 返回 { needed, ready, blockers }；override 在调用方处理（填了原因就放行）。
+ */
+export function designGate(config, task, nextStatus) {
+  const design = config?.design ?? {}
+  const columns = Array.isArray(design.columns) && design.columns.length > 0 ? design.columns : ['dev']
+  const needed = design.enabled === true && columns.includes(String(nextStatus ?? ''))
+  if (needed !== true) return { needed: false, ready: true, blockers: [] }
+  const state = String(task?.design?.status ?? '')
+  if (state === 'approved') return { needed: true, ready: true, blockers: [] }
+  const label = { pending: '还没评审', changes_requested: '评审要求修改' }[state] ?? '还没有设计记录'
+  return { needed: true, ready: false, blockers: [`设计${label}：先把设计稿放进卡片并让评审通过（或填 override 说明原因）`] }
+}