@marsken/dsh-studio 0.0.0-stage → 0.1.0

package/src/host/routes/connect.js

@@ -0,0 +1,166 @@
+import { INTEGRATION, feishuPush, gitlabReady, gitlabRequest, gitlabSync, healthReport, projectReady } from '../integrations.js'
+import { cleanId } from '../domain.js'
+const INJECTED = ["applyConfig","installedPackages","publicState","readJsonBody","resolvePackageName","runPluginCli","sendJson","getSyncTimer","upsertById"]
+let host = {
+  applyConfig: () => {},
+  installedPackages: () => {},
+  publicState: () => {},
+  readJsonBody: () => {},
+  resolvePackageName: () => {},
+  runPluginCli: () => {},
+  sendJson: () => {},
+  getSyncTimer: () => undefined,
+  upsertById: () => {},
+}
+/** 市场、集成健康、GitLab 同步、仓库与飞书机器人。宿主能力由 configureConnectRoutes() 注入。 */
+export function configureConnectRoutes(services) {
+  host = { ...host, ...(services ?? {}) }
+}
+
+export async function handleConnectRoute({ method, route, req, res, store, url }) {
+if (method === 'GET' && route === '/market') {
+  host.sendJson(res, 200, {
+    ok: true,
+    title: store.snapshot().config.market.title,
+    items: store.snapshot().config.market.items,
+    installed: await host.installedPackages(),
+  })
+  return true
+}
+if (method === 'POST' && route === '/market/install') {
+  const body = await host.readJsonBody(req)
+  const item = store.snapshot().config.market.items.find(entry => entry.id === String(body.id ?? ''))
+  if (item === undefined) throw new Error('unknown market item')
+  const result = await host.runPluginCli(['add', item.spec])
+  host.sendJson(res, 200, { ok: result.ok, result, installed: await host.installedPackages(), restartRequired: result.ok })
+  return true
+}
+if (method === 'POST' && route === '/market/uninstall') {
+  const body = await host.readJsonBody(req)
+  const item = store.snapshot().config.market.items.find(entry => entry.id === String(body.id ?? ''))
+  const requested = String(body.pkg ?? '').trim()
+  const pkg = requested.length > 0 ? requested : (item === undefined ? undefined : await host.resolvePackageName(item.spec))
+  if (pkg === undefined) throw new Error('unknown market item')
+  const result = await host.runPluginCli(['remove', pkg])
+  host.sendJson(res, 200, { ok: result.ok, pkg, result, installed: await host.installedPackages(), restartRequired: result.ok })
+  return true
+}
+if (method === 'GET' && route === '/integrations') {
+  const config = store.snapshot().config
+  host.sendJson(res, 200, {
+    ok: true,
+    gitlab: {
+      ready: gitlabReady(config),
+      syncing: host.getSyncTimer() !== undefined,
+      projects: (config.gitlab.projects ?? []).map(project => ({
+        id: project.id,
+        ready: projectReady(config, project),
+        lastSyncAt: project.lastSyncAt,
+        lastSyncError: project.lastSyncError,
+      })),
+    },
+    feishu: {
+      ready: (config.feishu.bots ?? []).some(bot => bot.enabled && bot.webhook.length > 0),
+      lastError: INTEGRATION.lastPushError,
+    },
+    health: healthReport(),
+  })
+  return true
+}
+if (method === 'GET' && route === '/integrations/health') {
+  host.sendJson(res, 200, { ok: true, ...healthReport() })
+  return true
+}
+if (method === 'POST' && route === '/gitlab/sync') {
+  const body = await host.readJsonBody(req).catch(() => ({}))
+  const summary = await gitlabSync(store, body.project === undefined ? undefined : String(body.project))
+  host.sendJson(res, 200, { ok: true, summary, state: host.publicState(store) })
+  return true
+}
+if (method === 'POST' && route === '/repos/save') {
+  const body = await host.readJsonBody(req)
+  // 老前端发 {project}，新脚本发 {repo}，两个都认。
+  const incoming = body.repo ?? body.project ?? body
+  if (String(incoming.name ?? incoming.project ?? '').trim() === '') {
+    throw new Error('仓库至少要填一个名字（或者 GitLab 项目路径），否则存下来是一条空记录')
+  }
+  const existing = store.snapshot().config.gitlab.projects
+  const wantedId = cleanId(incoming.id ?? incoming.name ?? incoming.project, 'repo')
+  const saved = existing.find(item => item.id === wantedId)
+  const merged = {
+    ...incoming,
+    id: wantedId,
+    // An empty token field means "keep the one already stored".
+    token: String(incoming.token ?? '').trim() || (saved?.token ?? ''),
+  }
+  await host.applyConfig(store, { gitlab: { projects: host.upsertById(existing, merged) } })
+  // 只回公开视图：token 不能出现在响应里。
+  const state = host.publicState(store)
+  host.sendJson(res, 200, { ok: true, repos: state.config.gitlab.projects, state })
+  return true
+}
+if (method === 'POST' && route === '/repos/delete') {
+  const body = await host.readJsonBody(req)
+  const id = cleanId(body.id, 'repo')
+  await host.applyConfig(store, { gitlab: { projects: store.snapshot().config.gitlab.projects.filter(entry => entry.id !== id) } })
+  host.sendJson(res, 200, { ok: true, state: host.publicState(store) })
+  return true
+}
+if (method === 'POST' && route === '/repos/test') {
+  const body = await host.readJsonBody(req)
+  const config = store.snapshot().config
+  const project = config.gitlab.projects.find(entry => entry.id === cleanId(body.id, 'repo'))
+  if (project === undefined) throw new Error('unknown project')
+  if (!projectReady(config, project)) throw new Error('这个仓库还没填全：地址 / 项目路径 / 访问令牌')
+  const info = await gitlabRequest(config, project, '/issues?per_page=1')
+  host.sendJson(res, 200, { ok: true, reachable: true, sample: Array.isArray(info) ? info.length : 0 })
+  return true
+}
+if (method === 'POST' && route === '/bots/save') {
+  const body = await host.readJsonBody(req)
+  const incoming = body.bot ?? body
+  const existing = store.snapshot().config.feishu.bots
+  const wantedId = cleanId(incoming.id ?? incoming.name, 'bot')
+  const saved = existing.find(item => item.id === wantedId)
+  const merged = {
+    ...incoming,
+    id: wantedId,
+    // An empty webhook field means "keep the one already stored".
+    webhook: String(incoming.webhook ?? '').trim() || (saved?.webhook ?? ''),
+  }
+  await host.applyConfig(store, { feishu: { bots: host.upsertById(existing, merged) } })
+  const state = host.publicState(store)
+  host.sendJson(res, 200, { ok: true, bots: state.config.feishu.bots, state })
+  return true
+}
+if (method === 'POST' && route === '/bots/delete') {
+  const body = await host.readJsonBody(req)
+  const id = cleanId(body.id, 'bot')
+  await host.applyConfig(store, { feishu: { bots: store.snapshot().config.feishu.bots.filter(entry => entry.id !== id) } })
+  host.sendJson(res, 200, { ok: true, state: host.publicState(store) })
+  return true
+}
+if (method === 'POST' && route === '/feishu/test') {
+  const body = await host.readJsonBody(req).catch(() => ({}))
+  const config = store.snapshot().config
+  const wanted = body.id === undefined ? '' : cleanId(body.id, 'bot')
+  const bots = (config.feishu.bots ?? []).filter(bot => wanted.length === 0 || bot.id === wanted)
+  const results = []
+  for (const bot of bots) {
+    try {
+      const result = await feishuPush(bot.webhook, '【需求&任务工作空间】这是一条测试消息，收到即说明群通知已接通。')
+      results.push({ bot: bot.id, name: bot.name, ...result })
+    } catch (error) {
+      results.push({ bot: bot.id, name: bot.name, ok: false, error: String(error?.message ?? error).slice(0, 200) })
+    }
+  }
+  host.sendJson(res, 200, { ok: results.some(entry => entry.ok === true), results })
+  return true
+}
+if (method === 'POST' && route === '/reset') {
+  await store.mutate(state => { state.tasks = [] })
+  host.sendJson(res, 200, { ok: true, state: host.publicState(store) })
+  return true
+}
+  return false
+}

package/src/host/routes/exports.js

@@ -0,0 +1,122 @@
+import { REQ_STATUS_LABEL, STATUSES } from '../domain.js'
+
+let host = { sendCsv: () => {}, requirementProgress: () => null, sessions: new Map() }
+
+/** 导出类路由（CSV）。宿主能力由 configureExportRoutes() 注入，避免反向 import index.js。 */
+export function configureExportRoutes(services) {
+  host = { ...host, ...(services ?? {}) }
+}
+
+export function handleExportRoute({ method, route, url, res, store, sendJson }) {
+  if (method === 'GET' && route === '/export/tasks.csv') {
+    const snapshot = store.snapshot()
+    const rows = [['编号', '标题', '类型', '状态', '负责人', '需求', '项目', '迭代', '版本', '阻塞', '截止', '用例通过', '用例总数', '交付物', '更新时间']]
+    for (const task of snapshot.tasks) {
+      const requirement = snapshot.requirements.find(item => item.id === task.requirementId)
+      const project = snapshot.config.projects.find(item => item.id === task.project)
+      const iteration = project?.iterations.find(item => item.id === task.iteration)
+      const release = snapshot.releases.find(item => item.id === task.releaseId)
+      const cases = task.cases ?? []
+      rows.push([
+        task.code || task.id,
+        task.title,
+        task.type,
+        STATUSES.find(item => item.id === task.status)?.label ?? task.status,
+        task.owner ?? '',
+        requirement === undefined ? '' : `${requirement.code} ${requirement.title}`.trim(),
+        project?.name ?? '',
+        iteration?.name ?? '',
+        release?.version ?? '',
+        task.blocked === null || task.blocked === undefined ? '' : `是：${String(task.blocked.reason ?? '').slice(0, 60)}`,
+        task.dueAt > 0 ? new Date(task.dueAt).toISOString().slice(0, 10) : '',
+        cases.filter(item => item.result === 'pass').length,
+        cases.length,
+        (task.artifacts ?? []).length,
+        new Date(task.updatedAt).toISOString().slice(0, 19).replace('T', ' '),
+      ])
+    }
+    host.sendCsv(res, rows, 'tasks.csv')
+    return true
+  }
+  if (method === 'GET' && route === '/export/requirements.csv') {
+    const snapshot = store.snapshot()
+    const rows = [['需求编号', '标题', '状态', '负责人', '项目', '功能点', '已覆盖', '卡数', '已完成', '用例通过', '用例总数', '交付物', '签字', '更新时间']]
+    for (const requirement of snapshot.requirements) {
+      const progress = host.requirementProgress(snapshot, requirement)
+      rows.push([
+        requirement.code,
+        requirement.title,
+        REQ_STATUS_LABEL[requirement.status] ?? requirement.status,
+        requirement.owner ?? '',
+        snapshot.config.projects.find(item => item.id === requirement.project)?.name ?? '',
+        progress.gate.stats.points,
+        progress.gate.stats.coveredPoints,
+        progress.cards.total,
+        progress.cards.done,
+        progress.gate.stats.pass,
+        progress.gate.stats.cases,
+        progress.gate.stats.artifacts,
+        requirement.signoff === null ? '' : `${requirement.signoff.by} ${new Date(requirement.signoff.at).toISOString().slice(0, 10)}`,
+        new Date(requirement.updatedAt).toISOString().slice(0, 19).replace('T', ' '),
+      ])
+    }
+    host.sendCsv(res, rows, 'requirements.csv')
+    return true
+  }
+  if (method === 'GET' && route === '/audit/export.csv') {
+    const snapshot = store.snapshot()
+    const cfg = snapshot.config
+    if (cfg?.ldap?.enabled === true && cfg?.ldap?.requireLogin === true) {
+      const token = String(url.searchParams.get('token') ?? '')
+      const session = token === '' ? null : host.sessions.get(token)
+      if (session === null || (Number(session.expiresAt) || 0) <= Date.now()) {
+        sendJson(res, 401, { ok: false, error: '导出审计日志要先登录' })
+        return
+      }
+    }
+    const by = String(url.searchParams.get('by') ?? '').trim()
+    const keyword = String(url.searchParams.get('q') ?? '').trim().toLowerCase()
+    const onlyFailed = url.searchParams.get('failed') === '1'
+    const list = (snapshot.audit ?? []).filter(item => (by === '' || item.by === by)
+      && (onlyFailed === false || item.ok === false)
+      && (keyword === '' || `${item.route} ${item.by} ${item.summary}`.toLowerCase().includes(keyword)))
+    const csvRows = [['时间', '操作人', '动作', '详情', '结果']]
+    for (const item of list.slice(0, 5000)) {
+      csvRows.push([
+        new Date(item.at).toISOString().slice(0, 19).replace('T', ' '),
+        item.by,
+        item.route,
+        item.summary,
+        item.ok ? '成功' : `失败 ${item.status}`,
+      ])
+    }
+    host.sendCsv(res, csvRows, `audit-${new Date().toISOString().slice(0, 10)}.csv`)
+    return true
+  }
+  if (method === 'GET' && route === '/export/dispatch.csv') {
+    const snapshot = store.snapshot()
+    const cfg = snapshot.config
+    if (cfg?.ldap?.enabled === true && cfg?.ldap?.requireLogin === true) {
+      const token = String(url.searchParams.get('token') ?? '')
+      const session = token === '' ? null : host.sessions.get(token)
+      if (session === null || (Number(session.expiresAt) || 0) <= Date.now()) {
+        sendJson(res, 401, { ok: false, error: '导出派单日志要先登录' })
+        return
+      }
+    }
+    const keyword = String(url.searchParams.get('q') ?? '').trim().toLowerCase()
+    const onlyFailed = url.searchParams.get('failed') === '1'
+    const list = (snapshot.agents?.log ?? []).filter(entry => {
+      const line = String(entry?.line ?? '')
+      if (onlyFailed && !/失败|错误|异常|拦|拒绝/.test(line)) return false
+      return keyword === '' || line.toLowerCase().includes(keyword)
+    })
+    const csvRows = [['时间', '内容']]
+    for (const entry of list.slice(0, 2000)) {
+      csvRows.push([new Date(Number(entry.at) || 0).toISOString().slice(0, 19).replace('T', ' '), String(entry.line ?? '')])
+    }
+    host.sendCsv(res, csvRows, `dispatch-${new Date().toISOString().slice(0, 10)}.csv`)
+    return true
+  }
+  return false
+}

package/src/host/routes/insights.js

@@ -0,0 +1,97 @@
+import {
+  buildDashboard,
+} from '../executor.js'
+import { runSummary } from '../dispatcher.js'
+const INJECTED = ['getDispatcher', "buildAnalytics","buildMetrics","burndownReport","sendJson","workloadReport"]
+let host = {
+  getDispatcher: () => undefined,
+  buildAnalytics: () => {},
+  buildMetrics: () => {},
+  burndownReport: () => {},
+  sendJson: () => {},
+  workloadReport: () => {},
+}
+/** 度量与工作台（指标、分析、工作量、燃尽、成本）相关路由。宿主能力由 configureInsightsRoutes() 注入。 */
+import { buildQuality } from '../quality.js'
+
+export function configureInsightsRoutes(services) {
+  host = { ...host, ...(services ?? {}) }
+}
+export async function handleInsightsRoute({ method, route, req, res, store, url }) {
+  if (method === 'GET' && route === '/metrics') {
+    host.sendJson(res, 200, { ok: true, metrics: host.buildMetrics(store.snapshot()) })
+    return true
+  }
+  if (method === 'GET' && route === '/analytics') {
+    const snapshot = store.snapshot()
+    host.sendJson(res, 200, {
+      ok: true,
+      analytics: host.buildAnalytics(snapshot, {
+        days: url.searchParams.get('days') ?? '',
+        project: url.searchParams.get('project') ?? '',
+      }),
+    })
+    return true
+  }
+  if (method === 'GET' && route === '/dashboard') {
+    // 最近一次回归（定时或人跑的）也一起给工作台，早上打开就知道昨晚跑成什么样。
+    const regressions = await store.readSide('regressions').catch(() => null)
+    host.sendJson(res, 200, {
+      ok: true,
+      dashboard: buildDashboard(store.snapshot()),
+      regression: Array.isArray(regressions) && regressions.length > 0 ? regressions[0] : null,
+    })
+    return true
+  }
+  if (method === 'GET' && route === '/quality') {
+    // AI 质量：派单量 / 一次通过率 / 返工率 / 平均耗时。成本未接入（见 README 口径）。
+    host.sendJson(res, 200, { ok: true, quality: buildQuality(store.snapshot(), runSummary()) })
+    return true
+  }
+  if (method === 'GET' && route === '/workload') {
+    const dispatcher = host.getDispatcher()
+    const running = dispatcher === undefined ? [] : [...dispatcher.running.values()]
+    host.sendJson(res, 200, { ok: true, workload: host.workloadReport(store.snapshot(), running) })
+    return true
+  }
+  if (method === 'GET' && route === '/burndown') {
+    host.sendJson(res, 200, {
+      ok: true,
+      burndown: host.burndownReport(store.snapshot(), {
+        days: url.searchParams.get('days') ?? '',
+        project: url.searchParams.get('project') ?? '',
+      }),
+    })
+    return true
+  }
+  if (method === 'GET' && route === '/costs') {
+    const summary = runSummary()
+    const budget = store.snapshot().config.costs
+    const runs = summary.total
+    const hours = Math.round(((summary.avgMs * summary.finished) / 3600_000) * 10) / 10
+    const runRate = budget.budgetRuns > 0 ? Math.min(100, Math.round((runs / budget.budgetRuns) * 100)) : 0
+    const hourRate = budget.budgetHours > 0 ? Math.min(100, Math.round((hours / budget.budgetHours) * 100)) : 0
+    const level = Math.max(runRate, hourRate) >= 100
+      ? 'over'
+      : Math.max(runRate, hourRate) >= budget.warnAt ? 'warn' : 'ok'
+    host.sendJson(res, 200, {
+      ok: true,
+      costs: summary,
+      budget: {
+        ...budget,
+        runs,
+        hours,
+        runRate,
+        hourRate,
+        level,
+        hint: level === 'over'
+          ? '已经超出预算：要么调高预算，要么停下来看看是不是有卡在空转'
+          : level === 'warn'
+            ? `已用到 ${Math.max(runRate, hourRate)}%，超过 ${budget.warnAt}% 会在这里标黄`
+            : '预算内',
+      },
+    })
+    return true
+  }
+  return false
+}