feat(workbench): 补 POST /artifact,成果可以不经契约行直接登记

- 路由 12 → 13;带 revisesArtifactId 时版本号自动 +1,跨项目引用仍 CROSS_PROJECT
- 新增路由测试:首版 revision=1、未注入 fileExists 时 existence 如实为 unknown、修订版 revision=2
- 契约文档补两张接口表行;218/218
This commit is contained in:
qyh15 2026-11-10 11:43:01 +08:00
parent b72efd7093
commit ee43e5df42
4 changed files with 55 additions and 6 deletions

View File

@ -81,6 +81,8 @@ workbench/panel/… 浏览器端(右栏部门树 + 任务/成
| POST | `/dispatch` | `projectId`, `taskId`, `idempotencyKey`, `sourceRoleId?`, `targetRoleId`, `targetSessionId?`, `bindingGeneration?`, `packet?`, `sourceSessionId?`, `mode?`, `roleName?` | 派发任务单;有会话层时真投递,没有就只落账 `prepared`(UI 必须显示尚未接通) |
| POST | `/ingest` | `projectId`, `roleId`, `text` | 解析 Agent 输出里的契约行并落账(四动作) |
| POST | `/result` | `projectId`, `taskId`, `attemptId?`, `report?`, `runTerminal?`, `artifactRefs?`, `checks?`, `remainingItems?`, `blockedReason?`, `sourceMessageRef?`, `reportVersion?` | 登记结构化报告 / 运行终态;重复登记按 `attemptId+reportVersion` 与 `sourceMessageRef` 去重 |
| POST | `/artifact` | `projectId`, `taskId`, `displayName`, `mediaType?`, `fileRef?`, `versionOrHash?`, `verification?`, `sourceResultId?`, `revisesArtifactId?` | 直接登记成果(契约行 `registerArtifact` 之外的入口);带 `revisesArtifactId` 时版本号自动 +1 |
| POST | `/artifact/revision` | `projectId`, `artifactId`, `instruction`, `ownerRoleId?`, `status?` | 找主责部门改一份成果:只开一条修订任务,不重跑全链 |
| GET | `/events` | `?projectId=&since=` | 长轮询(默认 25s,内部 1s 轮询账本)增量事件;`since` 之后的才算新 |
错误码:`INVALID_INPUT` / `INVALID_ROLE` / `NOT_FOUND` / `CROSS_PROJECT` /
@ -178,7 +180,7 @@ import { createWorkbenchHost } from './workbench/host/index.mjs'
| 依赖 | 当场没有时 | 补挂方式 | 补挂后 |
|---|---|---|---|
| `webServer` | 路由不注册,`warnings` 记一条 | `ctx.inject(['webServer'], …)` 再注册一次 | 12 条接口可用 |
| `webServer` | 路由不注册,`warnings` 记一条 | `ctx.inject(['webServer'], …)` 再注册一次 | 13 条接口可用 |
| `sessionController` | 会话层为空,`hasSessions=false`,派发只落账 | `ctx.inject(['sessionController'], …)` → `shell.attachSessions(controller)` | 可以接通部门、真投递 |
两条补挂都**只做一次且幂等**:已经挂上就不再换(`attachSessions` 第二次调用返回 `true`

View File

@ -346,6 +346,21 @@ export function buildRouteTable(service, options = {}) {
returnTarget: body.returnTarget,
}),
},
[`${ROUTE_PREFIX}/artifact`]: {
method: 'POST',
handler: async ({ body }) => service.registerArtifact({
projectId: select(body),
taskId: body.taskId,
ownerRoleId: body.ownerRoleId,
fileRef: body.fileRef,
displayName: body.displayName,
mediaType: body.mediaType,
versionOrHash: body.versionOrHash,
verification: body.verification,
sourceResultId: body.sourceResultId,
revisesArtifactId: body.revisesArtifactId,
}),
},
[`${ROUTE_PREFIX}/events`]: {
method: 'GET',
handler: async ({ query, req, res }) => {

View File

@ -129,7 +129,7 @@ test('装配层:宿主先有 webServer、后有 sessionController 时,派发
const host = createWorkbenchHost(ctx, { store, startReconciler: false })
assert.equal(host.store, store)
assert.equal(host.registered, true)
assert.equal(webServer.routes.size, 12)
assert.equal(webServer.routes.size, 13)
assert.equal(host.hasSessions, false)
const project = host.service.registerProject({ hostWorkspaceId: WS }).project

View File

@ -106,10 +106,11 @@ function seedService(service) {
// ---------- 注册与降级 ----------
test('注册:十二条 exact 路由,dispose 幂等且能全部卸载', () => {
test('注册:十三条 exact 路由,dispose 幂等且能全部卸载', () => {
const { service } = makeService()
const { registered, disposed, dispose } = mount(service)
assert.deepEqual([...registered.keys()].sort(), [
`${ROUTE_PREFIX}/artifact`,
`${ROUTE_PREFIX}/artifact/revision`,
`${ROUTE_PREFIX}/bind`,
`${ROUTE_PREFIX}/bootstrap`,
@ -124,10 +125,10 @@ test('注册:十二条 exact 路由,dispose 幂等且能全部卸载', () =>
`${ROUTE_PREFIX}/task/cancel`,
])
assert.equal(dispose.registered, true)
assert.equal(dispose.paths.length, 12)
assert.equal(dispose.paths.length, 13)
dispose()
dispose()
assert.equal(disposed.length, 12, '十二条路由各卸载一次,重复调用不再卸载')
assert.equal(disposed.length, 13, '十三条路由各卸载一次,重复调用不再卸载')
})
test('注册:宿主没有 webServer 时降级为 no-op,不抛', () => {
@ -161,7 +162,7 @@ test('注册:中途失败会回滚已注册的路由', () => {
test('listWorkbenchRoutes 列出端点与方法', () => {
const rows = listWorkbenchRoutes()
assert.equal(rows.length, 12)
assert.equal(rows.length, 13)
assert.deepEqual(rows.find((row) => row.path.endsWith('/bootstrap')), {
path: `${ROUTE_PREFIX}/bootstrap`,
method: 'GET',
@ -414,6 +415,37 @@ test('project / bind / config / task 四个 POST 串起来走通', async () => {
assert.equal(task.json.value.task.status, 'queued')
})
test('artifact:直接登记成果并按修订链累加版本', async () => {
const { service } = makeService()
const { call } = mount(service)
const { a } = seedService(service)
const task = service.createTask({ projectId: a.id, title: '甲', objective: '甲', ownerRoleId: 'libu' }).task
const first = await call('POST', `${ROUTE_PREFIX}/artifact`, {
projectId: a.id,
taskId: task.id,
displayName: '预算表.xlsx',
mediaType: 'application/vnd.ms-excel',
fileRef: 'C:/tmp/预算表.xlsx',
verification: { status: 'verified' },
})
assert.equal(first.statusCode, 200)
assert.equal(first.json.value.artifact.displayName, '预算表.xlsx')
assert.equal(first.json.value.artifact.revision, 1)
// 没注入 fileExists 时不猜文件在不在,如实说未知。
assert.equal(first.json.value.artifact.existence, 'unknown')
const second = await call('POST', `${ROUTE_PREFIX}/artifact`, {
projectId: a.id,
taskId: task.id,
displayName: '预算表(改).xlsx',
revisesArtifactId: first.json.value.artifact.id,
})
assert.equal(second.statusCode, 200)
assert.equal(second.json.value.artifact.revision, 2)
assert.equal(second.json.value.artifact.revisesArtifactId, first.json.value.artifact.id)
})
test('dispatch / result / task/cancel 走通并返回去重信息', async () => {
const { service } = makeService()
const { call } = mount(service)