feat(workbench): 补 POST /artifact,成果可以不经契约行直接登记
- 路由 12 → 13;带 revisesArtifactId 时版本号自动 +1,跨项目引用仍 CROSS_PROJECT - 新增路由测试:首版 revision=1、未注入 fileExists 时 existence 如实为 unknown、修订版 revision=2 - 契约文档补两张接口表行;218/218
This commit is contained in:
parent
b72efd7093
commit
ee43e5df42
|
|
@ -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`
|
||||
|
|
|
|||
|
|
@ -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 }) => {
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
Loading…
Reference in New Issue