Files
dacli/tests/unit/checkpoint_k_semantics.test.ts
T
ssw bfd9e43e6a fix(gates): T9 — AppContext 字段映射修正, K gate 子命令接入, designResources 落地校验
1. buildContextSummary 字段名映射修复 (实 AppContext schema):
   - full.currentSystemId → summary.systemId (不是 full.systemId)
   - full.currentUser → summary.user (不是 full.user)
   - tokenStatus union: 'valid' | 'expired' | 'unknown' (不是 'ok')
   - resourceCounts 从 releasedForms/unreleasedForms/modifiedAfterPublishForms/workflowList/menus/existingTables 派生
2. wire dacli gate k 子命令 (CLI 最小接入, 走 checkKCheckpoint)
3. _checkpoint_k.ts 实际使用 designResources: phase=summary 校验
   summaryResources ⊇ designResources (design→delivery 一致性)
4. 加 4 新单测: 真实 AppContext literal / currentUser undefined / designed but not delivered / 全交付
2026-07-28 20:38:13 +08:00

108 lines
3.6 KiB
TypeScript

/**
* tests/unit/checkpoint_k_semantics.test.ts
*
* 覆盖 src/commands/_gates/_checkpoint_k.ts
* (webapi hardening: K 关卡 phase 感知 + designResources 落地校验)
*
* 设计:
* - phase='design': summaryResources 为空 → not-applicable (退出 0)
* - phase='summary': summaryResources 全部 lookup 成功 → ok
* - phase='summary': 某资源 lookup 失败 → failure + 列出 missing (reason='no longer exists')
* - phase='summary': designResources 未落地 → failure + 列出 missing (reason='designed but not delivered')
* - phase='summary': designResources ⊆ summaryResources + 全部 lookup 成功 → ok
*
* v0.23+ (Task 9, webapi hardening): K 关卡 phase 语义修复, 防止总结阶段引用已删资源或漏交付
*/
import { describe, expect, it } from 'vitest'
import { checkKCheckpoint } from '../../src/commands/_gates/_checkpoint_k.ts'
describe('K 关卡语义 (Task 9b)', () => {
it('设计阶段 (resources=[]) → not-applicable', async () => {
const r = await checkKCheckpoint({
phase: 'design',
appCode: 'tdd5',
designResources: [],
summaryResources: [],
})
expect(r.status).toBe('not-applicable')
expect(r.exitCode).toBe(0)
})
it('总结阶段有 summaryResources → 校验每个资源仍在', async () => {
const r = await checkKCheckpoint({
phase: 'summary',
appCode: 'tdd5',
designResources: [],
summaryResources: [
{ kind: 'form', id: 'F1' },
{ kind: 'flow', id: 'W1' },
{ kind: 'menu', id: 'M1' },
],
liveLookup: async (res) => res.id, // 模拟 lookup
})
expect(r.status).toBe('ok')
expect(r.exitCode).toBe(0)
})
it('总结阶段某资源 lookup 失败 → failure + 列出 missing (no longer exists)', async () => {
const r = await checkKCheckpoint({
phase: 'summary',
appCode: 'tdd5',
designResources: [],
summaryResources: [
{ kind: 'form', id: 'F1' },
{ kind: 'flow', id: 'MISSING' },
],
liveLookup: async (res) => (res.id === 'F1' ? 'F1' : null),
})
expect(r.status).toBe('failure')
expect(r.exitCode).toBe(1)
expect(r.missing).toEqual([
{ kind: 'flow', id: 'MISSING', reason: 'no longer exists' },
])
})
// 设计资源落地校验: designResources ⊆ summaryResources (设计阶段说要做的事, 总结必须看到交付)
it('设计阶段说有 3 form, 总结阶段只交 2 个 → missing F3 (designed but not delivered)', async () => {
const r = await checkKCheckpoint({
phase: 'summary',
appCode: 'tdd5',
designResources: [
{ kind: 'form', id: 'F1' },
{ kind: 'form', id: 'F2' },
{ kind: 'form', id: 'F3' },
],
summaryResources: [
{ kind: 'form', id: 'F1' },
{ kind: 'form', id: 'F2' },
],
liveLookup: async (res) => res.id,
})
expect(r.status).toBe('failure')
expect(r.exitCode).toBe(1)
expect(r.missing).toEqual([
{ kind: 'form', id: 'F3', reason: 'designed but not delivered' },
])
})
// 完整通过: 设计资源全部交付 + 全部存活
it('设计阶段 3 form + 总结阶段 3 form 全部 lookup 成功 → ok', async () => {
const r = await checkKCheckpoint({
phase: 'summary',
appCode: 'tdd5',
designResources: [
{ kind: 'form', id: 'F1' },
{ kind: 'form', id: 'F2' },
{ kind: 'form', id: 'F3' },
],
summaryResources: [
{ kind: 'form', id: 'F1' },
{ kind: 'form', id: 'F2' },
{ kind: 'form', id: 'F3' },
],
liveLookup: async (res) => res.id,
})
expect(r.status).toBe('ok')
expect(r.exitCode).toBe(0)
})
})