@mzzsfy/dsh-rs-workflow 1.0.1 → 1.1.0

package/lib/release-registry.mjs

@@ -0,0 +1,134 @@
+// release-registry — 释放的注册形态(rc.1+:agentPresets.register 运行时注册,见 .compat/计划-rs-workflow-preset-rc1.md)
+// 与 release.mjs 的目录形态(0.1.2-0.1.5)并立;分派判据 = register 方法在场
+// (0.1.5 及以下的 agentPresets 是目录读取服务,同名但无 register)。
+// 运行态:flowId → 注销 disposer 的模块级单例;board 行是唯一注册方,行卸载时
+// disposeAllRegistered 统一注销(热重载 = 清空后重放,规避宿主 Duplicate 抛错)。
+import { FLOW_ID_RE, presetMeta, releaseFlowTemplate, unreleaseFlowTemplate } from './release.mjs'
+import { validateTemplate } from './template.mjs'
+import { skeletonRows } from './skeleton.mjs'
+import { loadJson, saveJson } from './storage.mjs'
+
+const PRESET_ID_PREFIX = 'rs-'
+// 注册预设排在官方 standard(order 1)之后
+const PRESET_ORDER = 100
+
+// 目录形态兜底用的家目录透传(测试注入临时目录;生产省略走 env 解析)
+export function registryFormAvailable(agentPresets) {
+  return typeof agentPresets?.register === 'function'
+}
+
+// 注册形态服务运行态:board 行注入时设置,行卸载清理时清除;template-tool 等
+// 非 board 上下文的释放动作经 currentAgentPresets 取当值分派
+let currentService
+export function setAgentPresets(service) {
+  currentService = service
+}
+export function currentAgentPresets() {
+  return currentService
+}
+
+// released 标志落盘(注册形态的释放事实源 = templates.json;目录形态事实源 =
+// 目录本身,标志仅冗余)。持久化形状与 normalizeTemplates 同约:仅 true 存字段,
+// 撤销即删字段。模板不存在时静默跳过
+export function markReleased(id, released) {
+  const raw = loadJson('templates.json', [])
+  const entry = raw.find((t) => t.id === id)
+  if (entry === undefined) return
+  if (released === true) entry.released = true
+  else delete entry.released
+  saveJson('templates.json', raw)
+}
+
+// 流程 id 校验收口(目录/注册两形态共用同一规则)
+function normalizeFlowId(entry) {
+  const flowId = typeof entry?.id === 'string' ? entry.id.trim() : ''
+  if (!FLOW_ID_RE.test(flowId)) throw new Error(`流程 id 非法: ${JSON.stringify(entry?.id)}(须匹配 ${FLOW_ID_RE.source})`)
+  return flowId
+}
+
+// 注册定义:骨架行(rows,已按 flowId 改写 templateId)+ 展示元数据
+// 注册前完成全部校验,失败不触达宿主注册表
+function buildDefinition(flowId, entry, rows) {
+  let parsed
+  try {
+    parsed = JSON.parse(entry.json)
+  } catch (error) {
+    throw new Error(`模板 JSON 解析失败: ${error.message}`)
+  }
+  const errors = validateTemplate(parsed)
+  if (errors.length > 0) throw new Error('模板校验失败:\n' + errors.map((e) => `${e.target}: ${e.message}`).join('\n'))
+  const { name, description } = presetMeta(entry, flowId)
+  return { id: PRESET_ID_PREFIX + flowId, name, description, order: PRESET_ORDER, plugins: rows }
+}
+
+const disposers = new Map()
+
+async function registerDefinition(agentPresets, definition) {
+  const previous = disposers.get(definition.id)
+  const replaced = previous !== undefined
+  if (replaced) {
+    disposers.delete(definition.id)
+    await previous()
+  }
+  const dispose = await agentPresets.register(definition)
+  disposers.set(definition.id, dispose)
+  // register 对挂载失败不抛(record.broken);回读名单把 broken 透出,防假成功。
+  // broken 是诊断不是失败:定义已注册在案,可正常注销
+  const roster = await agentPresets.list()
+  const row = roster.find((item) => item.id === definition.id)
+  return { replaced, broken: row?.broken === undefined ? undefined : String(row.broken) }
+}
+
+// 释放:注册形态优先,无 register 的宿主回落目录形态。
+// 返回 {form, outcome, presetId, broken?};outcome ∈ created|updated|removed|missing|foreign|failed
+export async function releaseTemplateVia(agentPresets, entry, rowsOf = (flowId) => skeletonRows(flowId), options = {}) {
+  if (!registryFormAvailable(agentPresets)) {
+    return { form: 'dir', outcome: releaseFlowTemplate(entry, options.dshHome) }
+  }
+  const flowId = normalizeFlowId(entry)
+  const definition = buildDefinition(flowId, entry, rowsOf(flowId))
+  try {
+    const { replaced, broken } = await registerDefinition(agentPresets, definition)
+    return { form: 'registry', outcome: replaced ? 'updated' : 'created', presetId: definition.id, ...(broken === undefined ? {} : { broken }) }
+  } catch (error) {
+    return { form: 'registry', outcome: 'failed', presetId: definition.id, broken: error.message }
+  }
+}
+
+export async function unreleaseTemplateVia(agentPresets, flowId, options = {}) {
+  if (!registryFormAvailable(agentPresets)) {
+    return { form: 'dir', outcome: unreleaseFlowTemplate(flowId, options.dshHome) }
+  }
+  const id = PRESET_ID_PREFIX + normalizeFlowId({ id: flowId })
+  const dispose = disposers.get(id)
+  if (dispose === undefined) return { form: 'registry', outcome: 'missing', presetId: id }
+  disposers.delete(id)
+  await dispose()
+  return { form: 'registry', outcome: 'removed', presetId: id }
+}
+
+// 启动重放:board 行激活时对已释放模板逐一注册。校验类失败(抛错)收敛为
+// failed 条目,不阻断其余;单条注册服务错误同理
+export async function replayReleased(agentPresets, entries, rowsOf = (flowId) => skeletonRows(flowId)) {
+  const results = []
+  for (const entry of entries) {
+    try {
+      results.push(await releaseTemplateVia(agentPresets, entry, rowsOf))
+    } catch (error) {
+      results.push({ form: 'registry', outcome: 'failed', broken: error.message })
+    }
+  }
+  return results
+}
+
+// 行卸载清理:注销全部注册定义(热重载后由重放重建)
+export async function disposeAllRegistered() {
+  const pending = [...disposers.values()]
+  disposers.clear()
+  for (const dispose of pending) {
+    try {
+      await dispose()
+    } catch { /* 单条注销失败不阻断其余 */ }
+  }
+  return pending.length
+}

package/lib/release.mjs

@@ -1,183 +1,190 @@
-// release — 流程模板创建/移除/自清理(v5:模板 id 由组合名承载,orchestrator 行 templateId 锚定改写)
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { validateTemplate } from './template.mjs'
-
-const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
-const AGENT_YAML = 'agent.cordis.yml'
-const PRESET_YML = 'preset.yml'
-const FLOW_FILE = 'flow.json'
-const MARKER_NAME = '.dsh-rs-workflow-source.json'
-const PACKAGE_NAME = '@mzzsfy/dsh-rs-workflow'
-const MARKER_KIND_FLOW = 'flow'
-const PRESET_SKELETON = join(PKG_ROOT, 'preset', 'rs-workflow', AGENT_YAML)
-const USER_PRESET_DIR = '.agent-presets'
-const FLOW_PRESET_PREFIX = 'rs-'
-const STAGING_PREFIX = '.rs-workflow-staging-'
-const OLD_PREFIX = '.rs-workflow-old-'
-const ORPHAN_PREFIX = '.rs-workflow-orphan-'
-// 骨架唯一源中的 orchestrator 行 templateId 锚定;创建产物一律改写为组合承载的模板 id(恰一处)
-const TEMPLATE_ANCHOR_MAIN = 'TPL_ANCHOR'
-const FLOW_ID_RE = /^[a-z][a-z0-9-]*$/
-const DESC_MAX_CHARS = 200
-const DESC_FALLBACK = '流程工作流模板'
-const PRESET_NAME_PREFIX = '若水·'
-let PKG_VERSION = 'unknown'
-try {
-  const parsed = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8')).version
-  if (typeof parsed === 'string' && parsed.length > 0) PKG_VERSION = parsed
-} catch { /* 读包失败归 unknown */ }
-
-const nonEmpty = (v) => (typeof v === 'string' && v.trim().length > 0 ? v.trim() : null)
-
-// 预设根解析:参数 > env 根 > env home > 默认家目录,统一拼 .agent-presets
-function resolveHome(explicit) {
-  const home = nonEmpty(explicit) ?? nonEmpty(process.env.DSH_RS_WORKFLOW_PRESET_ROOT) ?? nonEmpty(process.env.DSH_HOME) ?? join(homedir(), '.dsh')
-  return resolve(home)
-}
-
-export function presetRoot(dshHome) {
-  return join(resolveHome(dshHome), USER_PRESET_DIR)
-}
-
-export function flowPresetDest(flowId, dshHome) {
-  return join(presetRoot(dshHome), FLOW_PRESET_PREFIX + flowId)
-}
-
-// 读 marker;缺失/损坏同义返回 null(无法证明归属)
-function readMarker(dir) {
-  try {
-    return JSON.parse(readFileSync(join(dir, MARKER_NAME), 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-const ownedByUs = (marker) => marker !== null && marker.package === PACKAGE_NAME
-
-const markerJson = () => JSON.stringify({ package: PACKAGE_NAME, kind: MARKER_KIND_FLOW, version: PKG_VERSION }, null, 2) + '\n'
-
-// 创建骨架:包内唯一源逐字保留,仅改写 orchestrator 行 templateId 锚定(必须恰一处)
-function releaseAgentYaml(flowId) {
-  const parts = readFileSync(PRESET_SKELETON, 'utf8').split(TEMPLATE_ANCHOR_MAIN)
-  if (parts.length !== 2) throw new Error(`创建骨架 templateId 锚定串异常(期望恰一处): ${PRESET_SKELETON}`)
-  return parts.join(flowId)
-}
-
-// preset.yml 由骨架元数据 + 模板条目生成(组合名已含模板语义,描述取模板条目)
-function presetYaml(entry, flowId) {
-  const desc = String(entry.description ?? '').replace(/\s*\n\s*/g, ' ').slice(0, DESC_MAX_CHARS) || DESC_FALLBACK
-  // name 用双引号纯量防 YAML 结构字符(: 与换行)破坏生成物
-  const name = `${PRESET_NAME_PREFIX}${entry.label || flowId}`.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\s*\n\s*/g, ' ')
-  return `name: "${name}"\ndescription: >-\n  ${desc}\n`
-}
-
-// 硬崩溃残留的 staging/备份目录清理(前缀本包独占,直接删安全;orphan 前缀永不自动删)
-function cleanStaleStaging(parentDir) {
-  let entries
-  try {
-    entries = readdirSync(parentDir)
-  } catch {
-    return
-  }
-  for (const name of entries) {
-    if (name.startsWith(STAGING_PREFIX) || name.startsWith(OLD_PREFIX)) {
-      rmSync(join(parentDir, name), { recursive: true, force: true })
-    }
-  }
-}
-
-// 原子换入:staging 组装 → 旧目录 rename 备份 → 新目录入位 → 删备份;
-// 入位失败还原,还原也失败改 orphan 前缀保留待人工处置,绝不静默销毁
-function atomicReplace(dest, existed, build) {
-  const parent = dirname(dest)
-  mkdirSync(parent, { recursive: true })
-  const stagingRoot = mkdtempSync(join(parent, STAGING_PREFIX))
-  const out = join(stagingRoot, 'out')
-  const backup = join(parent, OLD_PREFIX + Date.now())
-  let orphan = null
-  try {
-    mkdirSync(out, { recursive: true })
-    build(out)
-    const hasDest = existsSync(dest)
-    if (hasDest) renameSync(dest, backup)
-    try {
-      renameSync(out, dest)
-    } catch (error) {
-      if (hasDest) {
-        try {
-          renameSync(backup, dest)
-        } catch {
-          orphan = join(parent, ORPHAN_PREFIX + Date.now())
-          try {
-            renameSync(backup, orphan)
-          } catch {
-            orphan = backup
-          }
-          console.warn(`[rs-workflow] 创建换入失败且还原失败,旧目录保留在 ${orphan}(不会被自动清理,需人工处置)`)
-        }
-      }
-      throw error
-    }
-  } finally {
-    rmSync(stagingRoot, { recursive: true, force: true })
-    if (orphan === null) rmSync(backup, { recursive: true, force: true })
-  }
-  return existed ? 'updated' : 'created'
-}
-
-export function releaseFlowTemplate(entry, dshHome) {
-  const flowId = typeof entry?.id === 'string' ? entry.id.trim() : ''
-  if (!FLOW_ID_RE.test(flowId)) throw new Error(`流程 id 非法: ${JSON.stringify(entry?.id)}(须匹配 ${FLOW_ID_RE.source})`)
-  // 创建前重校验(设置里可能被外部改坏);v5 模板文本为严格 JSON
-  let parsed
-  try {
-    parsed = JSON.parse(entry.json)
-  } catch (error) {
-    throw new Error(`模板 JSON 解析失败: ${error.message}`)
-  }
-  const errors = validateTemplate(parsed)
-  if (errors.length > 0) throw new Error('模板校验失败:\n' + errors.map((e) => `${e.target}: ${e.message}`).join('\n'))
-  const dest = flowPresetDest(flowId, dshHome)
-  cleanStaleStaging(dirname(dest))
-  const existed = existsSync(dest)
-  if (existed && !ownedByUs(readMarker(dest))) throw new Error(`目标目录归属他人,拒绝覆盖: ${dest}`)
-  return atomicReplace(dest, existed, (out) => {
-    writeFileSync(join(out, FLOW_FILE), entry.json, 'utf8')
-    writeFileSync(join(out, PRESET_YML), presetYaml(entry, flowId), 'utf8')
-    writeFileSync(join(out, AGENT_YAML), releaseAgentYaml(flowId), 'utf8')
-    writeFileSync(join(out, MARKER_NAME), markerJson(), 'utf8')
-  })
-}
-
-export function unreleaseFlowTemplate(flowId, dshHome) {
-  const dest = flowPresetDest(String(flowId ?? '').trim(), dshHome)
-  if (!existsSync(dest)) return 'missing'
-  if (!ownedByUs(readMarker(dest))) return 'foreign'
-  rmSync(dest, { recursive: true, force: true })
-  cleanStaleStaging(dirname(dest))
-  return 'removed'
-}
-
-function isReleaseDir(root, name) {
-  return name.startsWith(FLOW_PRESET_PREFIX) && statSync(join(root, name), { throwIfNoEntry: false })?.isDirectory() === true
-}
-
-export function releasedTemplateIds(dshHome) {
-  const root = presetRoot(dshHome)
-  let entries
-  try {
-    entries = readdirSync(root)
-  } catch {
-    return []
-  }
-  const ids = []
-  for (const name of entries) {
-    if (!isReleaseDir(root, name)) continue
-    const marker = readMarker(join(root, name))
-    if (ownedByUs(marker) && marker.kind === MARKER_KIND_FLOW) ids.push(name.slice(FLOW_PRESET_PREFIX.length))
-  }
-  return ids
-}
+// release — 流程模板创建/移除/自清理(v5:模板 id 由组合名承载,orchestrator 行 templateId 锚定改写)
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { validateTemplate } from './template.mjs'
+
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const AGENT_YAML = 'agent.cordis.yml'
+const PRESET_YML = 'preset.yml'
+const FLOW_FILE = 'flow.json'
+const MARKER_NAME = '.dsh-rs-workflow-source.json'
+const PACKAGE_NAME = '@mzzsfy/dsh-rs-workflow'
+const MARKER_KIND_FLOW = 'flow'
+const PRESET_SKELETON = join(PKG_ROOT, 'preset', 'rs-workflow', AGENT_YAML)
+const USER_PRESET_DIR = '.agent-presets'
+const FLOW_PRESET_PREFIX = 'rs-'
+const STAGING_PREFIX = '.rs-workflow-staging-'
+const OLD_PREFIX = '.rs-workflow-old-'
+const ORPHAN_PREFIX = '.rs-workflow-orphan-'
+// 骨架唯一源中的 orchestrator 行 templateId 锚定;创建产物一律改写为组合承载的模板 id(恰一处)
+const TEMPLATE_ANCHOR_MAIN = 'TPL_ANCHOR'
+export const FLOW_ID_RE = /^[a-z][a-z0-9-]*$/
+const DESC_MAX_CHARS = 200
+const DESC_FALLBACK = '流程工作流模板'
+const PRESET_NAME_PREFIX = '若水·'
+let PKG_VERSION = 'unknown'
+try {
+  const parsed = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8')).version
+  if (typeof parsed === 'string' && parsed.length > 0) PKG_VERSION = parsed
+} catch { /* 读包失败归 unknown */ }
+
+const nonEmpty = (v) => (typeof v === 'string' && v.trim().length > 0 ? v.trim() : null)
+
+// 预设根解析:参数 > env 根 > env home > 默认家目录,统一拼 .agent-presets
+function resolveHome(explicit) {
+  const home = nonEmpty(explicit) ?? nonEmpty(process.env.DSH_RS_WORKFLOW_PRESET_ROOT) ?? nonEmpty(process.env.DSH_HOME) ?? join(homedir(), '.dsh')
+  return resolve(home)
+}
+
+export function presetRoot(dshHome) {
+  return join(resolveHome(dshHome), USER_PRESET_DIR)
+}
+
+export function flowPresetDest(flowId, dshHome) {
+  return join(presetRoot(dshHome), FLOW_PRESET_PREFIX + flowId)
+}
+
+// 读 marker;缺失/损坏同义返回 null(无法证明归属)
+function readMarker(dir) {
+  try {
+    return JSON.parse(readFileSync(join(dir, MARKER_NAME), 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+const ownedByUs = (marker) => marker !== null && marker.package === PACKAGE_NAME
+
+const markerJson = () => JSON.stringify({ package: PACKAGE_NAME, kind: MARKER_KIND_FLOW, version: PKG_VERSION }, null, 2) + '\n'
+
+// 创建骨架:包内唯一源逐字保留,仅改写 orchestrator 行 templateId 锚定(必须恰一处)
+function releaseAgentYaml(flowId) {
+  const parts = readFileSync(PRESET_SKELETON, 'utf8').split(TEMPLATE_ANCHOR_MAIN)
+  if (parts.length !== 2) throw new Error(`创建骨架 templateId 锚定串异常(期望恰一处): ${PRESET_SKELETON}`)
+  return parts.join(flowId)
+}
+
+// preset.yml 由骨架元数据 + 模板条目生成(组合名已含模板语义,描述取模板条目)
+// presetMeta:展示元数据的唯一权威(原始值,不转义);序列化方自行按载体转义
+export function presetMeta(entry, flowId) {
+  const desc = String(entry.description ?? '').replace(/\s*\n\s*/g, ' ').slice(0, DESC_MAX_CHARS) || DESC_FALLBACK
+  const name = `${PRESET_NAME_PREFIX}${entry.label || flowId}`
+  return { name, description: desc }
+}
+
+function presetYaml(entry, flowId) {
+  const { name, description: desc } = presetMeta(entry, flowId)
+  // name 用双引号纯量防 YAML 结构字符(: 与换行)破坏生成物
+  const escaped = name.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\s*\n\s*/g, ' ')
+  return `name: "${escaped}"\ndescription: >-\n  ${desc}\n`
+}
+
+// 硬崩溃残留的 staging/备份目录清理(前缀本包独占,直接删安全;orphan 前缀永不自动删)
+function cleanStaleStaging(parentDir) {
+  let entries
+  try {
+    entries = readdirSync(parentDir)
+  } catch {
+    return
+  }
+  for (const name of entries) {
+    if (name.startsWith(STAGING_PREFIX) || name.startsWith(OLD_PREFIX)) {
+      rmSync(join(parentDir, name), { recursive: true, force: true })
+    }
+  }
+}
+
+// 原子换入:staging 组装 → 旧目录 rename 备份 → 新目录入位 → 删备份;
+// 入位失败还原,还原也失败改 orphan 前缀保留待人工处置,绝不静默销毁
+function atomicReplace(dest, existed, build) {
+  const parent = dirname(dest)
+  mkdirSync(parent, { recursive: true })
+  const stagingRoot = mkdtempSync(join(parent, STAGING_PREFIX))
+  const out = join(stagingRoot, 'out')
+  const backup = join(parent, OLD_PREFIX + Date.now())
+  let orphan = null
+  try {
+    mkdirSync(out, { recursive: true })
+    build(out)
+    const hasDest = existsSync(dest)
+    if (hasDest) renameSync(dest, backup)
+    try {
+      renameSync(out, dest)
+    } catch (error) {
+      if (hasDest) {
+        try {
+          renameSync(backup, dest)
+        } catch {
+          orphan = join(parent, ORPHAN_PREFIX + Date.now())
+          try {
+            renameSync(backup, orphan)
+          } catch {
+            orphan = backup
+          }
+          console.warn(`[rs-workflow] 创建换入失败且还原失败,旧目录保留在 ${orphan}(不会被自动清理,需人工处置)`)
+        }
+      }
+      throw error
+    }
+  } finally {
+    rmSync(stagingRoot, { recursive: true, force: true })
+    if (orphan === null) rmSync(backup, { recursive: true, force: true })
+  }
+  return existed ? 'updated' : 'created'
+}
+
+export function releaseFlowTemplate(entry, dshHome) {
+  const flowId = typeof entry?.id === 'string' ? entry.id.trim() : ''
+  if (!FLOW_ID_RE.test(flowId)) throw new Error(`流程 id 非法: ${JSON.stringify(entry?.id)}(须匹配 ${FLOW_ID_RE.source})`)
+  // 创建前重校验(设置里可能被外部改坏);v5 模板文本为严格 JSON
+  let parsed
+  try {
+    parsed = JSON.parse(entry.json)
+  } catch (error) {
+    throw new Error(`模板 JSON 解析失败: ${error.message}`)
+  }
+  const errors = validateTemplate(parsed)
+  if (errors.length > 0) throw new Error('模板校验失败:\n' + errors.map((e) => `${e.target}: ${e.message}`).join('\n'))
+  const dest = flowPresetDest(flowId, dshHome)
+  cleanStaleStaging(dirname(dest))
+  const existed = existsSync(dest)
+  if (existed && !ownedByUs(readMarker(dest))) throw new Error(`目标目录归属他人,拒绝覆盖: ${dest}`)
+  return atomicReplace(dest, existed, (out) => {
+    writeFileSync(join(out, FLOW_FILE), entry.json, 'utf8')
+    writeFileSync(join(out, PRESET_YML), presetYaml(entry, flowId), 'utf8')
+    writeFileSync(join(out, AGENT_YAML), releaseAgentYaml(flowId), 'utf8')
+    writeFileSync(join(out, MARKER_NAME), markerJson(), 'utf8')
+  })
+}
+
+export function unreleaseFlowTemplate(flowId, dshHome) {
+  const dest = flowPresetDest(String(flowId ?? '').trim(), dshHome)
+  if (!existsSync(dest)) return 'missing'
+  if (!ownedByUs(readMarker(dest))) return 'foreign'
+  rmSync(dest, { recursive: true, force: true })
+  cleanStaleStaging(dirname(dest))
+  return 'removed'
+}
+
+function isReleaseDir(root, name) {
+  return name.startsWith(FLOW_PRESET_PREFIX) && statSync(join(root, name), { throwIfNoEntry: false })?.isDirectory() === true
+}
+
+export function releasedTemplateIds(dshHome) {
+  const root = presetRoot(dshHome)
+  let entries
+  try {
+    entries = readdirSync(root)
+  } catch {
+    return []
+  }
+  const ids = []
+  for (const name of entries) {
+    if (!isReleaseDir(root, name)) continue
+    const marker = readMarker(join(root, name))
+    if (ownedByUs(marker) && marker.kind === MARKER_KIND_FLOW) ids.push(name.slice(FLOW_PRESET_PREFIX.length))
+  }
+  return ids
+}

package/lib/skeleton.mjs

@@ -0,0 +1,136 @@
+// skeleton — rs-workflow 预设组合骨架单一源(JS 行形态)+ 规范化 yml 序列化器
+// 消费方:注册形态(buildDefinition 的 plugins)直接用 skeletonRows;目录形态
+// 仍读 preset/rs-workflow/agent.cordis.yml——该文件是 emitRows 的规范化产物,
+// 由 test/skeleton.test.mjs 对拍防漂移,两形态共享同一骨架事实源。
+// 基底是 standard 全功能编码代理行集,差异:persona 换流程模式纪律 v5;
+// delegation 组含 rs-workflow-orchestrator/template-tool 行;无 report 行
+// (trace 事件 + run-store 取代);plan-mode 组移除(规划在编排内)。
+// 行形状闭集:id/name/disabled{__jsExpr}/group/isolate/config(对象或子行数组)。
+// `!!js` 表达式在 JS 形态统一为 {__jsExpr: '表达式'},与 loader 解析语义一致。
+export const TEMPLATE_ANCHOR = 'TPL_ANCHOR'
+
+const JS_EXPR = (expr) => ({ __jsExpr: expr })
+
+const ORCHESTRATOR_CONFIG = (templateId) => ({
+  role: 'orchestrator',
+  templateId,
+})
+
+export function skeletonRows(templateId) {
+  if (typeof templateId !== 'string' || templateId.trim() === '') {
+    throw new Error(`骨架 templateId 非法: ${JSON.stringify(templateId)}`)
+  }
+  return [
+    { id: 'persona', name: '@deepseek-ai/dsh-persona', config: { prefix: PERSONA_PREFIX, suffix: 'Your working directory is {{cwd}}.' } },
+    { id: 'agent-instructions', name: '@deepseek-ai/dsh-agent-instructions', config: { maxBytes: 65536 } },
+    // 不可禁本组合 shell/fs 工具行:workflow worker 的段子代理继承组合行集,禁行使
+    // 段子代理无法落盘交付物(实测证实)。主循环不写文件由 persona 判据约束
+    { id: 'tool-bash', name: '@deepseek-ai/dsh-tool-bash', disabled: JS_EXPR('process.platform === \'win32\'') },
+    { id: 'tool-pwsh', name: '@deepseek-ai/dsh-tool-pwsh', disabled: JS_EXPR('process.platform !== \'win32\'') },
+    { id: 'tool-fs', name: '@deepseek-ai/dsh-tool-fs' },
+    { id: 'tool-fs-search', name: '@deepseek-ai/dsh-tool-fs-search', config: { sampleOverCapGlobResults: false } },
+    // 缺省连续唤醒预算 3 次且仅用户消息重置:纯自主编排每段 settle 耗 1 次,放宽到
+    // 64 段覆盖 spec 建议的 3~12 步多实例流程上限
+    { id: 'tool-jobs', name: '@deepseek-ai/dsh-tool-jobs', config: { maxConsecutiveWakes: 64 } },
+    { id: 'skill-filesystem', name: '@deepseek-ai/dsh-skill-filesystem' },
+    { id: 'tool-skill', name: '@deepseek-ai/dsh-tool-skill' },
+    { id: 'tool-web', name: '@deepseek-ai/dsh-tool-web', config: { fetch: false, searchTimeoutMs: 60000 } },
+    // 编排子代理上下文较长,保留压缩组
+    {
+      id: 'compaction', name: 'cordis:group', group: true,
+      isolate: { compaction: true, toolResultPruner: true },
+      config: [
+        { id: 'compaction-basic', name: '@deepseek-ai/dsh-compaction-basic' },
+        { id: 'command-compact', name: '@deepseek-ai/dsh-command-compact' },
+        { id: 'tool-result-pruner', name: '@deepseek-ai/dsh-compaction-tool-result-pruner', config: { thresholdChars: 8192, headChars: 4096, tailChars: 1024 } },
+      ],
+    },
+    // workflowEngine 是预设私有服务(preset 组合发布全局服务会被宿主拒绝 mount),
+    // 所有触达它的行共享一个 entry-local isolate realm;orchestrator 行模板 id 由
+    // 组合名承载(rs-<id> → <id>),目录形态经 TPL_ANCHOR 锚定改写
+    {
+      id: 'delegation', name: 'cordis:group', group: true,
+      isolate: { workflowEngine: true },
+      config: [
+        { id: 'tool-subagent-control', name: '@deepseek-ai/dsh-tool-subagent-control' },
+        { id: 'tool-subagent-list-agents', name: '@deepseek-ai/dsh-tool-subagent-control/list-agents' },
+        { id: 'tool-subagent', name: '@deepseek-ai/dsh-tool-subagent', config: { provider: 'spawn', toolName: 'subagent', backgroundMode: 'continuable' } },
+        { id: 'tool-subagent-fork', name: '@deepseek-ai/dsh-tool-subagent', config: { provider: 'fork', toolName: 'subagent_fork', backgroundMode: 'continuable' } },
+        { id: 'workflow-ptc', name: '@deepseek-ai/dsh-workflow-ptc', config: { provider: 'spawn' } },
+        { id: 'tool-workflow', name: '@deepseek-ai/dsh-tool-workflow' },
+        { id: 'tool-ralph', name: '@deepseek-ai/dsh-tool-ralph', config: { subagentProvider: 'spawn', maxRounds: 64 } },
+        { id: 'rs-workflow-orchestrator', name: '@mzzsfy/dsh-rs-workflow', config: ORCHESTRATOR_CONFIG(templateId) },
+        { id: 'rs-workflow-template-tool', name: '@mzzsfy/dsh-rs-workflow', config: { role: 'template-tool' } },
+      ],
+    },
+    { id: 'tool-ask-user', name: '@deepseek-ai/dsh-tool-ask-user' },
+    { id: 'tool-todo', name: '@deepseek-ai/dsh-tool-todo', config: { allowParallelInProgress: true } },
+  ]
+}
+
+const PERSONA_PREFIX = `你是"若水工作流"会话代理,由 {{model}} 模型驱动。你负责人机协作与编排调度;
+任务交付由流程引擎接管下的子代理完成,你不直接产出交付物。
+职责判据:
+1. 纯会话内请求(问答、解释、讨论,不产生文件)→ 直接答复,不起编排;
+2. 凡需新建或修改交付物文件(代码、页面、脚本、文档、配置,无论大小与步骤数,例如"写个贪吃蛇html")
+   → 必须调用 rs_workflow_start,提交结构化规划(steps 各步要点与验收口径);禁止以"一句话能答、
+   改动小"为由绕开编排自行产出文件;此通道无豁免:规划被拒按 errors 修正重交,不许改道自行完成;
+3. 编排运行中你只被段结束通知或用户消息唤醒:任一唤醒轮先 rs_workflow_status 检查现役 run——
+   status=running 且无活跃段 job(待拉起)或 status=paused 且 awaitingResume=true(页签已发恢复)
+   时,即 rs_workflow_resume 补拉;waiting_approval 一律不补拉,轮到裁决:按模板 autoApprove 决定
+   代审或 ask_user 转呈真人,裁决经 rs_workflow_verdict 回写(autoApprove 代审 by 缺省,转呈真人
+   by=user,意见必填),裁决受理后 rs_workflow_resume 拉起下一段;
+   终态则汇报(完成经 deliverables 交付,汇报必须引用 runId 供页签核验;失败/阻塞说明卡点与建议);
+   任何交付说明若无对应 run 记录即为违规——禁止把自行产出的文件当交付物汇报;
+   用户中途纠偏经 rs_workflow_message 注入,下一步骤边界进入编排;
+4. 你不代替子代理执行编排内步骤,不伪造产出,不跳过引擎直接交付;
+5. 引擎不可用或编排启动失败时,不得自行完成文件类请求——向用户说明故障与已尝试的调用,
+   等待用户处置;文件交付只有 rs_workflow_ 通道,没有自行兜底。`
+
+const ROW_KEYS = ['id', 'name', 'disabled', 'group', 'isolate', 'config']
+// 裸标量白名单:内部冒号(: 后非空格,如 cordis:group)合法且为宿主 preset 惯例;
+// '@' 起(保留字符)与含 ': '/尾冒号形态拒绝,BARE_RE 字符类不含 @ 且前置检查排除
+const BARE_RE = /^[A-Za-z0-9_][A-Za-z0-9_: ./+(){}|=<>~^-]*$/
+
+// 标量:数字/布尔直书;字符串裸安全(无 ': '、不以 ':' 收尾、字符类受控)则裸,
+// 否则单引号(内部 ' 翻倍)
+function scalarOf(value) {
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value)
+  const text = String(value)
+  if (!text.includes(': ') && !text.endsWith(':') && BARE_RE.test(text)) return text
+  return `'${text.replace(/'/g, '\'\'')}'`
+}
+
+// 键值行:!!js 表达式 / 块标量(多行串)|- / 映射 / 子行序列 / 标量,五形态收口
+function entryLines(key, value, indent) {
+  const pad = ' '.repeat(indent)
+  if (value !== null && typeof value === 'object' && value.__jsExpr !== undefined) {
+    return [`${pad}${key}: !!js ${value.__jsExpr}`]
+  }
+  if (typeof value === 'string' && value.includes('\n')) {
+    return [`${pad}${key}: |-`].concat(value.split('\n').map((line) => ' '.repeat(indent + 2) + line))
+  }
+  if (value !== null && typeof value === 'object') {
+    if (Array.isArray(value)) {
+      return [`${pad}${key}:`].concat(value.flatMap((row) => renderRow(row, indent + 2)))
+    }
+    return [`${pad}${key}:`].concat(
+      Object.entries(value).flatMap(([childKey, childValue]) => entryLines(childKey, childValue, indent + 2)),
+    )
+  }
+  return [`${pad}${key}: ${scalarOf(value)}`]
+}
+
+function renderRow(row, indent) {
+  const pad = ' '.repeat(indent)
+  const rest = ROW_KEYS.slice(1)
+    .filter((key) => row[key] !== undefined)
+    .flatMap((key) => entryLines(key, row[key], indent + 2))
+  return [`${pad}- id: ${scalarOf(row.id)}`].concat(rest)
+}
+
+// 规范化 yml 序列化:行集 → 确定性文本(尾随换行);与 preset/rs-workflow/
+// agent.cordis.yml 正文逐字节对拍(test/skeleton.test.mjs)
+export function emitRows(rows) {
+  return rows.flatMap((row) => renderRow(row, 0)).join('\n') + '\n'
+}