agentworkshop 0.2.1

package/server/services/workshop/dcw/recipe-rollback.repo.ts

@@ -0,0 +1,197 @@
+/**
+ * RecipeRollBackRepo —— 调控闭环持久化仓库(dcw-rollback.json)。
+ *
+ * 两个集合:
+ *  - anchors[]  参数变更锚点(append-only 无上限:参数全量在册,永不淘汰)
+ *  - records[]  Agent 优化记录(cap 2000 环形;一次调控 step 的完整档案)
+ *
+ * 与 dcw-line.repo 同构(loadJson/saveJson + 单例);写经 flushDebounced
+ * 防落盘放大,启动 restore() 重放(对齐 line-run.ts 崩溃恢复模式)。
+ */
+
+import { randomUUID } from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import type { DcwJournalAnchor, OptimizationRecord } from '../../../../shared/dcw-protocol'
+
+const DATA_DIR = process.cwd().endsWith('server')
+  ? 'data'
+  : path.join(process.cwd(), 'server', 'data')
+const ROLLBACK_PATH = path.join(DATA_DIR, 'dcw-rollback.json')
+
+const RECORDS_CAP = 2000
+
+interface RollbackDb {
+  anchors: DcwJournalAnchor[]
+  records: OptimizationRecord[]
+}
+
+function loadDb(): RollbackDb {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(ROLLBACK_PATH, 'utf-8')) as Partial<RollbackDb>
+    return { anchors: parsed.anchors ?? [], records: parsed.records ?? [] }
+  }
+  catch {
+    return { anchors: [], records: [] }
+  }
+}
+
+export class RecipeRollBackRepo {
+  private db: RollbackDb = loadDb()
+  private flushTimer: NodeJS.Timeout | null = null
+
+  constructor() {
+    this.restore()
+  }
+
+  /** 启动重放(崩溃恢复;对齐 line-run.ts 模式) */
+  restore(): void {
+    // 构造即 loadDb;open 记录保持 open,由 manager 的 sweep 评估继续接管
+    if (this.db.records.some(r => r.status === 'open')) {
+      console.log(`[recipe-rollback] 恢复 ${this.db.anchors.length} 锚 / ${this.db.records.filter(r => r.status === 'open').length} 条 open 优化记录`)
+    }
+  }
+
+  private flushDebounced(): void {
+    if (this.flushTimer)
+      return
+    this.flushTimer = setTimeout(() => {
+      this.flushTimer = null
+      this.flushNow()
+    }, 1500)
+    this.flushTimer.unref?.()
+  }
+
+  flushNow(): void {
+    try {
+      fs.mkdirSync(path.dirname(ROLLBACK_PATH), { recursive: true })
+      fs.writeFileSync(ROLLBACK_PATH, JSON.stringify(this.db, null, 2), 'utf-8')
+    }
+    catch (err) {
+      console.error('[recipe-rollback] 落盘失败:', err)
+    }
+  }
+
+  // ---------- anchors(append-only) ----------
+
+  appendAnchor(a: Omit<DcwJournalAnchor, 'id' | 'at'> & { id?: string, at?: string }): DcwJournalAnchor {
+    const anchor: DcwJournalAnchor = { ...a, id: a.id ?? `anc-${randomUUID().slice(0, 8)}`, at: a.at ?? new Date().toISOString() }
+    this.db.anchors.push(anchor)
+    this.flushDebounced()
+    return anchor
+  }
+
+  lastAnchorOf(nodeId: string): DcwJournalAnchor | undefined {
+    for (let i = this.db.anchors.length - 1; i >= 0; i--) {
+      if (this.db.anchors[i]!.nodeId === nodeId)
+        return this.db.anchors[i]
+    }
+    return undefined
+  }
+
+  /** 该节点上一个「有效基线」锚:prevValue≠newValue 的最近一条(单步回退目标) */
+  lastStableAnchor(nodeId: string): DcwJournalAnchor | undefined {
+    for (let i = this.db.anchors.length - 1; i >= 0; i--) {
+      const a = this.db.anchors[i]!
+      if (a.nodeId === nodeId && a.prevValue != null && a.prevValue !== a.newValue)
+        return a
+    }
+    return undefined
+  }
+
+  anchorById(id: string): DcwJournalAnchor | undefined {
+    return this.db.anchors.find(a => a.id === id)
+  }
+
+  /** 指定时刻之前该节点最近的稳定锚(批次级回退用) */
+  lastStableBefore(nodeId: string, atMs: number): DcwJournalAnchor | undefined {
+    for (let i = this.db.anchors.length - 1; i >= 0; i--) {
+      const a = this.db.anchors[i]!
+      if (a.nodeId !== nodeId || a.prevValue == null || a.prevValue === a.newValue)
+        continue
+      if (Date.parse(a.at) <= atMs)
+        return a
+    }
+    return undefined
+  }
+
+  listAnchors(filter: { nodeId?: string, lineId?: string, source?: string, limit?: number }): DcwJournalAnchor[] {
+    let list = [...this.db.anchors].reverse()
+    if (filter.nodeId)
+      list = list.filter(a => a.nodeId === filter.nodeId)
+    if (filter.lineId)
+      list = list.filter(a => a.lineId === filter.lineId)
+    if (filter.source)
+      list = list.filter(a => a.source === filter.source)
+    return list.slice(0, filter.limit ?? 100)
+  }
+
+  /** 最近一次回退锚(冷却判断用) */
+  lastRollbackAnchor(nodeId: string): DcwJournalAnchor | undefined {
+    for (let i = this.db.anchors.length - 1; i >= 0; i--) {
+      const a = this.db.anchors[i]!
+      if (a.nodeId === nodeId && a.source === 'rollback')
+        return a
+    }
+    return undefined
+  }
+
+  // ---------- records(优化记录) ----------
+
+  insertRecord(r: Omit<OptimizationRecord, 'id' | 'createdAt'> & { id?: string, createdAt?: string }): OptimizationRecord {
+    const record: OptimizationRecord = { ...r, id: r.id ?? `opt-${randomUUID().slice(0, 8)}`, createdAt: r.createdAt ?? new Date().toISOString() }
+    this.db.records.push(record)
+    if (this.db.records.length > RECORDS_CAP)
+      this.db.records.splice(0, this.db.records.length - RECORDS_CAP)
+    this.flushDebounced()
+    return record
+  }
+
+  byId(id: string): OptimizationRecord | undefined {
+    return this.db.records.find(r => r.id === id)
+  }
+
+  openRecordOf(nodeId: string): OptimizationRecord | undefined {
+    return this.db.records.find(r => r.nodeId === nodeId && r.status === 'open')
+  }
+
+  updateRecord(id: string, patch: Partial<OptimizationRecord>): OptimizationRecord | undefined {
+    const r = this.byId(id)
+    if (!r)
+      return undefined
+    Object.assign(r, patch)
+    this.flushDebounced()
+    return r
+  }
+
+  listRecords(filter: { lineId?: string, recipeId?: string, nodeId?: string, status?: string, agentId?: string, limit?: number }): OptimizationRecord[] {
+    let list = [...this.db.records].reverse()
+    if (filter.lineId)
+      list = list.filter(r => r.lineId === filter.lineId)
+    if (filter.recipeId)
+      list = list.filter(r => r.recipeId === filter.recipeId)
+    if (filter.nodeId)
+      list = list.filter(r => r.nodeId === filter.nodeId)
+    if (filter.status)
+      list = list.filter(r => r.status === filter.status)
+    if (filter.agentId)
+      list = list.filter(r => r.agentId === filter.agentId)
+    return list.slice(0, filter.limit ?? 100)
+  }
+
+  /** 该节点的自动回退链长(防乒乓:链上已发生的回退记录数) */
+  chainRollbackCount(nodeId: string): number {
+    return this.db.records.filter(r => r.nodeId === nodeId && r.status === 'rolled-back').length
+  }
+
+  stats(): { anchors: number, records: number, open: number } {
+    return { anchors: this.db.anchors.length, records: this.db.records.length, open: this.db.records.filter(r => r.status === 'open').length }
+  }
+}
+
+const g = globalThis as typeof globalThis & { __recipeRollBackRepo?: RecipeRollBackRepo }
+
+export function getRecipeRollBackRepo(): RecipeRollBackRepo {
+  g.__recipeRollBackRepo ??= new RecipeRollBackRepo()
+  return g.__recipeRollBackRepo
+}

package/server/services/workshop/logger.ts

@@ -0,0 +1,58 @@
+/**
+ * 极简结构化日志(R4):级别 + JSON 行,env 开关。
+ * - AWSHOP_LOG_LEVEL = debug | info | warn | error(默认 info)
+ * - 输出:单行 JSON(t/level/scope/msg/args),error/warn 走 stderr,其余 stdout
+ * - 范围收敛:仅替换 server/services/workshop 目录的 console 直出
+ *   (request-log、plugins、mcp 的 console 保留,见计划 R4-2,避免全量替换的回归面)
+ */
+
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
+
+const LEVELS: Record<LogLevel, number> = { debug: 10, info: 20, warn: 30, error: 40 }
+
+function minLevel(): LogLevel {
+  const v = process.env.AWSHOP_LOG_LEVEL as LogLevel | undefined
+  return v && v in LEVELS ? v : 'info'
+}
+
+/** 安全序列化:Error → stack,循环引用降级为 [Circular],序列化失败降级 String */
+function safe(value: unknown): unknown {
+  if (value instanceof Error) return value.stack ?? String(value)
+  if (typeof value === 'object' && value !== null) {
+    try {
+      return JSON.parse(JSON.stringify(value))
+    }
+    catch {
+      return '[Unserializable]'
+    }
+  }
+  return value
+}
+
+export interface Logger {
+  debug(msg: string, ...args: unknown[]): void
+  info(msg: string, ...args: unknown[]): void
+  warn(msg: string, ...args: unknown[]): void
+  error(msg: string, ...args: unknown[]): void
+}
+
+export function createLogger(scope: string): Logger {
+  const emit = (level: LogLevel, msg: string, args: unknown[]): void => {
+    if (LEVELS[level] < LEVELS[minLevel()]) return
+    const line = JSON.stringify({
+      t: new Date().toISOString(),
+      level,
+      scope,
+      msg,
+      ...(args.length ? { args: args.map(safe) } : {}),
+    })
+    if (level === 'error' || level === 'warn') console.error(line)
+    else console.log(line)
+  }
+  return {
+    debug: (msg, ...args) => emit('debug', msg, args),
+    info: (msg, ...args) => emit('info', msg, args),
+    warn: (msg, ...args) => emit('warn', msg, args),
+    error: (msg, ...args) => emit('error', msg, args),
+  }
+}

package/server/services/workshop/ops/ops.ts

@@ -0,0 +1,78 @@
+/**
+ * 合规/运维仓储接线(全局注入,模式同 bindDcwBroadcast):
+ * plugins/workshop.ts 装配时 bind;业务侧经 getOps() 读取(未装配 = 测试/降级 → null)。
+ * 附 audit() 兜底助手:审计写入失败永不击穿主链路。
+ */
+import type { createApprovalHistoryRepo, createAlarmEventRepo, createAuditRepo, createApprovalRequestRepo } from '../db/ops.repo'
+import { broadcastSceneEvent } from '../scene-events'
+
+export interface OpsRepos {
+  approvalHistory: ReturnType<typeof createApprovalHistoryRepo>
+  alarmEvents: ReturnType<typeof createAlarmEventRepo>
+  audit: ReturnType<typeof createAuditRepo>
+  approvalRequests: ReturnType<typeof createApprovalRequestRepo>
+}
+
+const g = globalThis as typeof globalThis & { __opsRepos?: OpsRepos }
+
+export function bindOpsRepos(repos: OpsRepos): void {
+  g.__opsRepos = repos
+}
+
+export function getOps(): OpsRepos | null {
+  return g.__opsRepos ?? null
+}
+
+/** 审计埋点(R1):失败静默,绝不影响业务主路径 */
+export function audit(entry: Parameters<ReturnType<typeof createAuditRepo>['append']>[0]): void {
+  try {
+    getOps()?.audit.append(entry)
+  }
+  catch {
+    // 审计失败不阻断业务(如需告警接入 R4 指标)
+  }
+}
+
+/** 运维日志事件帧(WS 实时事件轨渲染摘要;完整详情落 audit_log 由日志管理页查询) */
+export interface OpsLogFrame {
+  at: string
+  actor: string
+  actorName: string
+  actorKind: 'user' | 'agent' | 'system'
+  action: string
+  kind: string
+  summary: string
+  targetKind: string
+  targetId: string
+  lineId: string
+  productId: string
+  recipeId: string
+}
+
+/**
+ * 全操作记录(统一入口):落 audit_log + 广播 ops.log 实时帧。
+ * summary 人读摘要供实时事件直接渲染;结构化详情在 audit_log.detail_json。
+ * 失败静默 —— 日志永不击穿业务主链路。
+ */
+export function recordOps(entry: Parameters<ReturnType<typeof createAuditRepo>['append']>[0]): void {
+  try {
+    getOps()?.audit.append(entry)
+    broadcastSceneEvent('ops.log', {
+      at: entry.at ?? new Date().toISOString(),
+      actor: entry.actor,
+      actorName: entry.actorName ?? '',
+      actorKind: entry.actorKind ?? 'user',
+      action: entry.action,
+      kind: entry.kind ?? '',
+      summary: entry.summary ?? entry.action,
+      targetKind: entry.targetKind ?? '',
+      targetId: entry.targetId ?? '',
+      lineId: entry.lineId ?? '',
+      productId: entry.productId ?? '',
+      recipeId: entry.recipeId ?? '',
+    } satisfies OpsLogFrame)
+  }
+  catch {
+    // 日志失败不阻断业务
+  }
+}

package/server/services/workshop/prompts/loader.ts

@@ -0,0 +1,112 @@
+/**
+ * Prompt 外置化管理 — `.AgentWorkShop/prompts/` 下的 md 文件为唯一 prompt 事实源。
+ *
+ * 设计:
+ *  - 后端代码零硬编码 prompt:所有注入 harness 的指令文本均从外置文件加载
+ *  - 模板变量:{{var}} 占位(容忍 {{ var }} 空白变体);缺省变量渲染为空串
+ *  - 缓存:mtime 感知(文件修改即刻生效,dev/HMR 友好;stat 开销可忽略)
+ *  - host-tools.json:结构化工具定义(name/label/description/parameters),
+ *    JSON 承载 schema,与叙事型 md 并置同一目录统一管理
+ *  - 目录解析:AW_PROMPTS_DIR 环境变量 → process.cwd()/.AgentWorkShop/prompts;
+ *    启动即校验(缺文件 fail-fast,防静默降级为无 prompt 裸跑)
+ */
+import { readFileSync, statSync, existsSync, readdirSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { AppError } from '../../../utils/errors'
+
+/** 模板变量值(字符串化注入) */
+export type PromptVars = Record<string, string | number | boolean | undefined | null>
+
+interface CacheEntry {
+  mtimeMs: number
+  content: string
+}
+
+const cache = new Map<string, CacheEntry>()
+
+/** prompts 目录(AW_PROMPTS_DIR 覆盖 → cwd 相对) */
+export function promptsDir(): string {
+  const base = process.env.AW_PROMPTS_DIR
+    ? resolve(process.env.AW_PROMPTS_DIR)
+    : resolve(process.cwd(), '.AgentWorkShop', 'prompts')
+  if (!existsSync(base)) {
+    throw new AppError(500, 'PROMPTS_DIR_MISSING', `prompts 目录不存在: ${base}(外置 prompt 为必需;可用 AW_PROMPTS_DIR 指定)`)
+  }
+  return base
+}
+
+/** 读取 md 原文(mtime 缓存;文件缺失 fail-fast) */
+export function loadPrompt(name: string): string {
+  const file = join(promptsDir(), `${name}.md`)
+  let mtimeMs: number
+  try {
+    mtimeMs = statSync(file).mtimeMs
+  }
+  catch {
+    throw new AppError(500, 'PROMPT_FILE_MISSING', `prompt 文件缺失: ${file}`)
+  }
+  const hit = cache.get(name)
+  if (hit && hit.mtimeMs === mtimeMs) return hit.content
+  const content = readFileSync(file, 'utf-8')
+  cache.set(name, { mtimeMs, content })
+  return content
+}
+
+/**
+ * 渲染 prompt:{{var}} 替换(缺省变量 → 空串);规范化首尾空白。
+ * 变量值中的 $ 具有字面义(替换用函数形式,不解释 $ 模式)。
+ */
+export function renderPrompt(name: string, vars: PromptVars = {}): string {
+  const raw = loadPrompt(name)
+  return raw
+    .replace(/\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g, (_m, key: string) => {
+      const v = vars[key]
+      return v === undefined || v === null ? '' : String(v)
+    })
+    .replace(/^\s+|\s+$/g, '')
+}
+
+/** 全部 prompt 名(去 .md 后缀;测试与自检用) */
+export function listPromptNames(): string[] {
+  const dir = promptsDir()
+  return readdirSync(dir)
+    .filter(f => f.endsWith('.md'))
+    .map(f => f.slice(0, -3))
+    .sort()
+}
+
+// ===== host tools 结构化定义(host-tools.json) =====
+
+export interface HostToolDef {
+  name: string
+  label?: string
+  description: string
+  parameters: Record<string, unknown>
+  hidden?: boolean
+}
+
+let hostToolsCache: { mtimeMs: number, tools: HostToolDef[] } | null = null
+
+/** 加载 host 工具定义(name/label/description/parameters;缺文件 fail-fast) */
+export function loadHostToolDefs(): HostToolDef[] {
+  const file = join(promptsDir(), 'host-tools.json')
+  let mtimeMs: number
+  try {
+    mtimeMs = statSync(file).mtimeMs
+  }
+  catch {
+    throw new AppError(500, 'HOST_TOOLS_MISSING', `host 工具定义缺失: ${file}`)
+  }
+  if (hostToolsCache && hostToolsCache.mtimeMs === mtimeMs) return hostToolsCache.tools
+  const parsed = JSON.parse(readFileSync(file, 'utf-8')) as HostToolDef[]
+  if (!Array.isArray(parsed) || parsed.length === 0) {
+    throw new AppError(500, 'HOST_TOOLS_INVALID', 'host-tools.json 必须为非空数组')
+  }
+  for (const t of parsed) {
+    if (!t.name || !t.description || !t.parameters) {
+      throw new AppError(500, 'HOST_TOOLS_INVALID', `host 工具定义不完整: ${JSON.stringify(t).slice(0, 80)}`)
+    }
+  }
+  hostToolsCache = { mtimeMs, tools: parsed }
+  return parsed
+}