@givolt/i3-composer-agent 2.2.3 → 2.3.1

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/reviews/ReviewsPage.html

@@ -0,0 +1,3 @@
+<!-- 来源：src/reviews/ReviewsPage.vue；HTML / 原生 DOM 绑定，不含 Vue 运行时。 -->
+<div class="page-heading"><div><h1>质量与评审</h1><p>核对问题和版本证据，处理当前交付中的确认事项。</p></div><template data-component="Button" data-on-click="(router.push('/tasks'))">查看交付任务</template></div><div class="task-metrics review-metrics"><article><span>待人工确认</span><strong>{{ (store.rows.filter(r =&gt; r.status === 'pending').length) }}</strong></article><article><span>问题待处理</span><strong>{{ (store.rows.filter(r =&gt; r.status === 'blocked').length) }}</strong></article><article><span>等待复核或恢复</span><strong>{{ (store.rows.filter(r =&gt; ['checking', 'suspended'].includes(r.status)).length) }}</strong></article><article><span>已确认或机器通过</span><strong>{{ (store.rows.filter(r =&gt; ['approved', 'automatic'].includes(r.status)).length) }}</strong></article></div><template data-component="Alert" data-if="(route.query.task)" class="page-alert" type="info" show-icon="" title="正在查看指定任务的全部评审"><template data-slot="action"><template data-component="Button" data-on-click="(router.replace('/reviews'))">查看所有任务</template></template></template><section class="auth-list review-list-panel"><template data-component="Tabs" data-model-active-key="(scope)" data-bind-items="([{ key: 'pending', label: '待处理 (' + pending.length + ')' }, { key: 'done', label: '历史与已处理 (' + (store.rows.length - pending.length) + ')' }, { key: 'all', label: '全部记录' }])"></template><div class="auth-filters review-filters"><template data-component="Input" data-model-value="(query)" placeholder="搜索任务、编号或问题" aria-label="搜索评审事项" allow-clear=""></template><template data-component="Select" data-model-value="(project)" aria-label="评审 PBC 筛选" data-bind-options="([{ value: 'all', label: '全部可见 PBC' }, ...Array.from(new Map(store.rows.map(r =&gt; [r.task.binding.pbcId, { value: r.task.binding.pbcId, label: r.project }])).values())])"></template><template data-component="Select" data-model-value="(kind)" aria-label="评审类型筛选" data-bind-options="([{ value: 'all', label: '全部评审类型' }, ...Object.entries(kindLabels).map(([value, label]) =&gt; ({ value, label }))])"></template><template data-component="Select" data-model-value="(severity)" aria-label="问题严重度筛选" data-bind-options="([{ value: 'all', label: '全部严重度' }, { value: 'high', label: '严重问题' }, { value: 'medium', label: '重要问题' }, { value: 'suggestion', label: '建议' }, { value: 'none', label: '无登记问题' }])"></template><template data-component="Select" data-model-value="(resultState)" aria-label="评审状态筛选" data-bind-options="([{ value: 'all', label: '全部评审状态' }, ...Object.entries(stateLabels).map(([value, label]) =&gt; ({ value, label }))])"></template><template data-component="Button" data-on-click="(reset)">重置</template></div><div class="auth-tools"><template data-component="Space" wrap=""><span>已选择 {{ (selection.selected.value.length) }} 项</span><template data-component="Button" size="small" data-bind-disabled="(!selection.selected.value.length)" data-on-click="(selection.clear)">清空</template><template data-component="Tooltip" title="评审与批准记录属于审计证据，不能删除。"><span><template data-component="Button" size="small" disabled="">批量删除</template></span></template></template><template data-component="Space" wrap=""><template data-component="Select" data-model-value="(sort)" aria-label="评审排序" data-bind-options="([{ value: 'newest', label: '更新时间倒序' }, { value: 'oldest', label: '更新时间正序' }])"></template><template data-component="Button" data-bind-loading="(loading)" data-on-click="(refresh)">刷新</template><template data-component="ColumnSettings" data-bind-preferences="(prefs)"></template></template></div><template data-component="Alert" data-if="(store.notice)" type="warning" show-icon="" data-bind-title="(store.notice)"></template><template data-component="Alert" data-if="(store.scene === 'error')" type="error" show-icon="" title="评审列表加载失败" description="已有记录保留，重试不会生成新评审。"><template data-slot="action"><template data-component="Button" data-on-click="(refresh)">重试</template></template></template><template data-component="ProTable" data-else="" data-bind-table="(table)" data-bind-control="(false)" data-bind-table-container="(false)" data-bind-search="(async () =&gt; { })" row-key="id" data-bind-loading="(loading)" data-bind-row-selection="(selection.rowSelection.value)" data-bind-scroll="({ x: 'max-content' })" data-bind-pagination="({ showTotal: (n) =&gt; '共 ' + n + ' 项', showSizeChanger: true, pageSizeOptions: [5, 10, 20] })"></template><template data-component="Empty" data-if="(!filtered.length &amp;&amp; store.scene !== 'error')" data-bind-description="(store.rows.length ? '当前筛选范围暂无评审事项' : '当前授权范围暂无评审记录')"><template data-component="Button" data-if="(store.rows.length)" data-on-click="reset();
+scope = 'all';">查看全部记录</template></template><p class="review-footnote">评审由交付流程生成，审批记录和证据保留，不适用手工新增或删除。修改与重新规划形成新版本，生产发布另行授权。</p></section>

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/reviews/ReviewsPage.js

@@ -0,0 +1,62 @@
+import { computed, ref, watch } from '../../runtime/state.js';
+import { h } from '../../runtime/dom.js';
+import { useRoute, useRouter } from "../../runtime/router.js";
+import { Alert, Button, Input, Select, Space, Tabs, Tag, Tooltip, Empty } from "../../runtime/widgets.js";
+import { ProTable, useTable } from "../../runtime/widgets.js";
+import { useReviews } from "./store.js";
+import { stateLabels, stateColors, kindLabels, reviewUrl } from "./model.js";
+import { formatDate, tenantLabel } from "../shared/policy.js";
+import { useColumns } from "../shared/columns.js";
+import { useListSelection } from "../shared/listSelection.js";
+import ListMore from "../shared/ListMore.js";
+import ColumnSettings from "../shared/ColumnSettings.js";
+import { createComponent } from '../../runtime/dom.js';
+export default createComponent({ name: 'ReviewsPage', propKeys: [], template: new URL('./ReviewsPage.html', import.meta.url).href, setup(__props, __emit) {
+        const store = useReviews(), router = useRouter(), route = useRoute(), query = ref(''), scope = ref(route.query.task || route.query.pbc ? 'all' : 'pending'), project = ref(String(route.query.pbc || 'all')), kind = ref('all'), severity = ref('all'), resultState = ref('all'), sort = ref('newest'), loading = ref(false);
+        const active = ['pending', 'blocked', 'checking', 'suspended'];
+        const pending = computed(() => store.rows.filter(r => active.includes(r.status)));
+        const prefs = useColumns('reviews-v012', [{ key: 'name', label: '评审事项', locked: true }, { key: 'project', label: '所属 PBC', defaultVisible: true }, { key: 'kind', label: '评审类型', defaultVisible: true }, { key: 'status', label: '评审状态', defaultVisible: true }, { key: 'createdBy', label: '创建人', defaultVisible: true }, { key: 'createdAt', label: '创建时间', defaultVisible: true }, { key: 'updatedBy', label: '更新人' }, { key: 'updatedAt', label: '更新时间' }, { key: 'handledBy', label: '处理人' }, { key: 'handledAt', label: '处理时间' }, { key: 'tenant', label: '所属租户' }, { key: 'evidence', label: '依据版本' }, { key: 'task', label: '任务编号' }, { key: 'version', label: '记录版本' }, { key: 'actions', label: '操作', locked: true }]);
+        const url = (r) => reviewUrl(r.task.id, r.review.id);
+        function more(r) { return [{ key: 'detail', label: '查看证据详情' }, { key: 'history', label: '查看处理记录' }, { key: 'task', label: '查看交付任务' }, { key: 'pbc', label: 'PBC 交付工作区', disabled: !store.session.can('pbc:view', r.task.tenantId, r.task.binding.pbcId) }, { key: 'delete', label: '删除不适用：审批记录须保留', disabled: true }]; }
+        function action(key, r) { if (key === 'delete')
+            return; router.push(key === 'task' ? '/tasks/' + r.task.id : key === 'pbc' ? '/pbcs/' + r.task.binding.pbcId + '/workspace' : url(r) + (key === 'history' ? '?tab=history' : '')); }
+        const render = (f) => (_, row) => f(row);
+        const columns = prefs.choices.map(c => ({ key: c.key, title: c.label, width: c.key === 'name' ? 290 : c.key === 'actions' ? 140 : c.key.endsWith('At') ? 165 : 125, fixed: c.key === 'actions' ? 'right' : undefined, render: render(r => {
+                const v = r.review;
+                if (c.key === 'name')
+                    return h('div', { class: 'review-list-name' }, [h(Button, { type: 'link', onClick: () => router.push(url(r)) }, () => r.task.name), h('small', { class: 'mono muted' }, v.code), h('span', { class: 'muted' }, v.findings.length ? v.findings.length + ' 项问题 · ' + v.findings[0].title : v.title)]);
+                if (c.key === 'status')
+                    return h(Tag, { color: stateColors[r.status] }, () => stateLabels[r.status]);
+                if (c.key === 'actions')
+                    return h('div', { class: 'row-actions' }, [h(Button, { type: 'link', onClick: () => router.push(url(r)) }, () => active.includes(r.status) ? '处理' : '查看'), h(ListMore, { name: v.code, items: more(r), onAction: (k) => action(k, r) })]);
+                if (c.key === 'project')
+                    return r.project;
+                if (c.key === 'kind')
+                    return kindLabels[v.kind];
+                if (c.key === 'tenant')
+                    return tenantLabel(v.tenantId);
+                if (c.key === 'task')
+                    return r.task.code;
+                if (c.key === 'version')
+                    return 'v' + v.recordVersion;
+                if (c.key === 'evidence')
+                    return v.refs.map(i => i.name + ' v' + i.version).join('；');
+                if (c.key === 'handledBy')
+                    return v.decision?.actor || '—';
+                if (c.key === 'handledAt')
+                    return formatDate(v.decision?.at || '');
+                if (c.key.endsWith('At'))
+                    return formatDate(v[c.key]);
+                return v[c.key];
+            }) }));
+        const table = useTable({ columns, pageParam: { current: 1, pageSize: 5, total: 0 } }), allColumns = new Map(table.columns.value.map(c => [c.key, c]));
+        watch(prefs.keys, keys => table.columns.value = keys.map(k => allColumns.get(k)).filter(Boolean), { immediate: true });
+        const filtered = computed(() => store.scene === 'empty' ? [] : store.rows.filter(r => (!route.query.task || r.task.id === route.query.task) && (scope.value === 'all' || (scope.value === 'pending' ? active.includes(r.status) : !active.includes(r.status))) && (resultState.value === 'all' || r.status === resultState.value) && (project.value === 'all' || r.task.binding.pbcId === project.value) && (kind.value === 'all' || r.review.kind === kind.value) && (severity.value === 'all' || (severity.value === 'none' ? !r.review.findings.length : r.review.findings.some(f => f.severity === severity.value))) && (r.task.name + r.task.code + r.review.code + r.review.title + r.review.findings.map(f => f.title).join('')).toLowerCase().includes(query.value.trim().toLowerCase())).sort((a, b) => (sort.value === 'newest' ? -1 : 1) * a.review.updatedAt.localeCompare(b.review.updatedAt) || a.id.localeCompare(b.id)));
+        watch(() => route.query.task, () => { scope.value = 'all'; table.setPageParam({ current: 1 }); });
+        watch([query, scope, project, kind, severity, resultState, sort], () => table.setPageParam({ current: 1 }));
+        watch([filtered, () => table.pageParam.current, () => table.pageParam.pageSize], () => { const size = table.pageParam.pageSize || 5; table.pageParam.current = Math.min(table.pageParam.current || 1, Math.max(1, Math.ceil(filtered.value.length / size))); table.pageParam.total = filtered.value.length; table.dataSource.value = filtered.value.slice(((table.pageParam.current || 1) - 1) * size, (table.pageParam.current || 1) * size); }, { immediate: true });
+        const selection = useListSelection(table.dataSource, computed(() => JSON.stringify([store.session.key, query.value, scope.value, project.value, kind.value, severity.value, resultState.value, sort.value, table.pageParam.current, table.pageParam.pageSize])), computed(() => true), r => r.review.code);
+        async function refresh() { selection.clear(); loading.value = true; await new Promise(r => setTimeout(r, 180)); store.scene = 'normal'; loading.value = false; }
+        function reset() { query.value = ''; project.value = 'all'; kind.value = 'all'; severity.value = 'all'; resultState.value = 'all'; }
+        return { computed, ref, watch, h, useRoute, useRouter, Alert, Button, Input, Select, Space, Tabs, Tag, Tooltip, Empty, ProTable, useTable, useReviews, stateLabels, stateColors, kindLabels, reviewUrl, formatDate, tenantLabel, useColumns, useListSelection, ListMore, ColumnSettings, store, router, route, query, scope, project, kind, severity, resultState, sort, loading, active, pending, prefs, url, more, action, render, columns, table, allColumns, filtered, selection, refresh, reset };
+    } });

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/reviews/commands.js

@@ -0,0 +1,97 @@
+import { can } from "../shared/policy.js";
+import { approveTask, artifact, enter, latestArtifact, taskEvent } from "../tasks/domain.js";
+import { reviewsForTask, reviewStatus, captureDesign, actionReason, sameRequest, fingerprint, actionPermission } from "./model.js";
+export function decideReview(t, id, actor, p) {
+    const original = reviewsForTask(t).find(r => r.id === id);
+    if (!original)
+        throw Error('评审记录不存在或已不可访问。');
+    if (!can(actor, 'task:view', t.tenantId, t.binding.pbcId) || !can(actor, 'artifact:view', t.tenantId, t.binding.pbcId))
+        throw Error('没有此任务与产物的查看权限。');
+    if (!can(actor, actionPermission[p.action], t.tenantId, t.binding.pbcId))
+        throw Error('当前没有此操作权限。');
+    const replay = sameRequest(t, id, p);
+    if (replay)
+        return replay;
+    const reason = actionReason(t, original, actor, p.action);
+    if (reason)
+        throw Error(reason);
+    if (!p.requestId)
+        throw Error('缺少提交编号。');
+    if (!p.note.trim() || p.note.length > 1000)
+        throw Error('请填写 1–1000 字的处理说明。');
+    if (p.action === 'confirm' && !p.checked)
+        throw Error('请先核对当前版本及证据。');
+    if (p.action === 'edit' && (!p.content?.trim() || p.content.length > 20000))
+        throw Error('请填写设计修改内容，不超过 20000 字。');
+    if (p.action === 'replan' && (!p.impact?.trim() || p.impact.length > 2000))
+        throw Error('请填写重新规划的影响说明，不超过 2000 字。');
+    if (p.action === 'edit' && p.content.trim() === (latestArtifact(t, 'design')?.content || '设计建议（模拟）\n依据规格 v' + t.binding.spec.number + '\n' + t.binding.spec.content.requirements).trim())
+        throw Error('设计内容没有变化，请修改后再保存。');
+    t.reviews = reviewsForTask(t);
+    const r = t.reviews.find(r => r.id === id), at = new Date().toISOString();
+    const decision = { requestId: p.requestId, action: p.action, actorId: actor.id, actor: actor.name, at, note: p.note.trim(), impact: p.impact?.trim() || '', fingerprint: fingerprint(p) };
+    if (p.action === 'confirm') {
+        if (r.kind === 'prototype')
+            approveTask(t, actor.name, r.refs.find(i => i.kind === 'prototype').version, p.note);
+        else if (r.kind === 'design') {
+            t.approvedDesignVersion = r.refs.find(i => i.kind === 'design').version;
+            t.reviewApproved = true;
+            delete t.pendingDesignReview;
+            const n = t.binding.flow.body.nodes.find(n => ['agent', 'loop'].includes(n.kind));
+            enter(t, n.id);
+            t.reason = '设计 v' + t.approvedDesignVersion + ' 已确认，继续实现；随后重新执行质量检查与独立验证。';
+        }
+        else {
+            t.reason = '当前版本质量已确认，等待后续生产发布人工授权；尚未发布。';
+        }
+    }
+    else {
+        const build = t.binding.flow.body.nodes.find(n => ['agent', 'loop'].includes(n.kind));
+        const prior = latestArtifact(t, 'design')?.content || '设计建议（模拟）\n依据规格 v' + t.binding.spec.number + '\n' + t.binding.spec.content.requirements;
+        const content = p.action === 'edit' ? p.content : prior + '\n\n重新规划意见：' + p.note + '\n影响与调整范围：' + p.impact + '\n\n以上为待复核设计建议，尚未重新实现或验证。';
+        if (p.action === 'edit' && content.trim() === prior.trim())
+            throw Error('设计内容没有变化，请修改后再保存。');
+        t.reworks++;
+        t.checksPassed = false;
+        t.reviewApproved = false;
+        delete t.approvedDesignVersion;
+        const reset = (id, seen = new Set()) => { if (seen.has(id))
+            return; seen.add(id); const s = t.stages.find(s => s.nodeId === id); s.state = 'pending'; s.detail = '设计变更后待重新执行'; delete s.finishedAt; t.binding.flow.body.edges.filter(e => e.from === id).forEach(e => reset(e.to, seen)); };
+        reset(build.id);
+        t.currentId = build.id;
+        artifact(t, 'design', '实现设计说明', content, 'info', actor.name);
+        const next = captureDesign(t, actor.name);
+        t.reviews.push(next);
+        t.pendingDesignReview = next.id;
+        t.status = 'waiting';
+        t.reason = '设计 v' + latestArtifact(t, 'design').number + ' 已保存，等待本版复核及确认。';
+        t.stages.find(s => s.nodeId === build.id).state = 'active';
+        t.stages.find(s => s.nodeId === build.id).detail = t.reason;
+        decision.nextReviewId = next.id;
+        decision.newVersion = latestArtifact(t, 'design').number;
+    }
+    r.decision = decision;
+    r.updatedBy = actor.name;
+    r.updatedAt = at;
+    r.recordVersion++;
+    taskEvent(t, actor.name, { confirm: '确认评审', edit: '修改评审设计', replan: '重新规划交付' }[p.action], r.code + ' / ' + r.refs.map(x => x.name + ' v' + x.version).join('、') + '：' + p.note);
+    return decision;
+}
+export function validateDesign(t, id, outcome) {
+    const rows = reviewsForTask(t), r = rows.find(r => r.id === id);
+    if (!r || r.kind !== 'design' || t.pendingDesignReview !== id || !['checking', 'blocked'].includes(reviewStatus(t, r)))
+        throw Error('当前设计无需或不能接收新的复核结果。');
+    const verifier = t.binding.flow.body.nodes.find(n => n.kind === 'verify');
+    if (!verifier || t.binding.flow.body.nodes.some(n => ['agent', 'loop'].includes(n.kind) && n.agentId === verifier.agentId))
+        throw Error('缺少与实现职责分离的复核者。');
+    t.reviews = rows;
+    r.verifier = (t.binding.agents.find(a => a.config.id === verifier.agentId)?.config.name || '独立复核 Agent') + '（模拟）';
+    r.verificationAt = new Date().toISOString();
+    r.checks = r.checks.map(c => ({ ...c, status: outcome, detail: outcome === 'pass' ? '本次模拟复核对照设计 v' + r.refs.find(x => x.kind === 'design').version + ' 与固定规格；未运行真实服务。' : '模拟复核仍发现设计约束未覆盖，请修改或带意见重新规划。' }));
+    r.updatedBy = r.verifier;
+    r.updatedAt = r.verificationAt;
+    r.recordVersion++;
+    artifact(t, 'review', '设计复核记录', r.checks.map(c => c.name + '：' + c.detail).join('\n'), outcome, r.verifier);
+    t.reason = outcome === 'pass' ? '本版设计复核通过，等待获授权的人确认。' : '设计复核发现问题，尚不能确认。';
+    taskEvent(t, r.verifier, '接收设计复核结果', r.code + '：' + outcome + '；原型模拟');
+}

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/reviews/model.js

@@ -0,0 +1,147 @@
+import { can } from "../shared/policy.js";
+import { clone, currentNode, latestArtifact } from "../tasks/domain.js";
+export const kindLabels = { prototype: '交互原型确认', quality: '质量与交付评审', design: '设计修订确认' };
+export const stateLabels = { pending: '待人工确认', checking: '待重新验证', blocked: '问题待处理', suspended: '任务已暂停', approved: '已确认', edited: '已修改', replanned: '已重新规划', superseded: '版本已更新', automatic: '机器检查已通过' };
+export const stateColors = { pending: 'orange', checking: 'blue', blocked: 'red', suspended: 'default', approved: 'green', edited: 'blue', replanned: 'purple', superseded: 'default', automatic: 'cyan' };
+export const dimensions = [{ id: 'SEC', label: '安全' }, { id: 'ROB', label: '逻辑健壮性' }, { id: 'ARC', label: '架构与数据' }, { id: 'CON', label: '框架规范' }, { id: 'PRF', label: '性能' }, { id: 'QLT', label: '代码质量' }];
+export const actionPermission = { confirm: 'workflow:approve', edit: 'review:edit', replan: 'review:replan' };
+export const canReadReview = (actor, t) => !t.isDeleted && can(actor, 'task:view', t.tenantId, t.binding.pbcId) && can(actor, 'artifact:view', t.tenantId, t.binding.pbcId);
+export function evidenceVersion(t, ref) { return t.artifacts.find(a => a.id === ref.id)?.versions.find(v => v.number === ref.version); }
+export function refsOf(t, kinds) { return t.artifacts.filter(a => a.kind !== 'review' && (!kinds || kinds.includes(a.kind)) && a.versions.length).map(a => ({ id: a.id, name: a.name, kind: a.kind, version: a.versions.at(-1).number })); }
+function base(t, kind, refs, at, by) {
+    const key = refs.map(r => r.id + '-' + r.version).join('_'), id = kind + '-' + t.reworks + '-' + key;
+    return { id, code: 'REV-' + t.code.replace('DEL-', '') + '-' + (kind === 'prototype' ? 'P' : kind === 'quality' ? 'Q' : 'D') + '-' + (refs.find(r => r.kind === (kind === 'quality' ? 'code' : kind === 'design' ? 'design' : 'prototype'))?.version || 1) + '-' + t.reworks, taskId: t.id, kind, title: kindLabels[kind], stageId: t.currentId, iteration: t.reworks, refs: clone(refs), checks: [], findings: [], verifier: '待复核', createdById: t.createdById, createdBy: by, createdAt: at, createdDept: t.createdDept, updatedBy: by, updatedAt: at, tenantId: t.tenantId, recordVersion: 1, isDeleted: false, humanRequired: true, policyReason: kind === 'prototype' ? '绑定流程要求人工确认交互原型' : kind === 'design' ? '设计内容已改变，复核后确认本版，再恢复实现' : '当前交付样例保留人工质量确认；生产发布另行授权', grade: t.reviewPolicy?.grade };
+}
+function prototypeRecord(t) {
+    const v = latestArtifact(t, 'prototype');
+    if (!v)
+        return;
+    const r = base(t, 'prototype', refsOf(t, ['spec', 'prototype']), v.at, v.by);
+    r.iteration = 0;
+    r.id = 'prototype-' + v.number;
+    r.stageId = t.binding.flow.body.nodes.find(n => n.kind === 'human' && n.gate !== 'production')?.id || v.stageId;
+    r.checks = [{ id: 'input', name: '绑定规格与原型已提供', status: 'pass', required: true, detail: '阅读以下固定版本后，由获授权的人核对确认；此处没有实际启动研发 Agent。' }];
+    const e = t.events.find(e => e.action === '确认交互原型' && e.detail.includes('原型 v' + v.number + '：'));
+    if (e)
+        r.decision = { requestId: e.id, action: 'confirm', actorId: 'legacy', actor: e.actor, at: e.at, note: e.detail, impact: '', fingerprint: 'legacy' };
+    return r;
+}
+export function captureQuality(t) {
+    const test = latestArtifact(t, 'test'), verify = latestArtifact(t, 'verify'), code = latestArtifact(t, 'code');
+    if (!test && !verify)
+        return;
+    const r = base(t, 'quality', refsOf(t), verify?.at || test.at, verify?.by || test.by);
+    const current = (v) => !!v && v.iteration === t.reworks && !!code && v.inputs.some(i => i.id === 'code' && i.version === code.number);
+    const testOk = current(test), verifyOk = current(verify);
+    const verifier = t.binding.flow.body.nodes.find(n => n.kind === 'verify');
+    const independent = !!verifier && !t.binding.flow.body.nodes.some(n => ['agent', 'loop'].includes(n.kind) && n.agentId === verifier.agentId);
+    r.verifier = verifyOk ? verify.by : '等待独立验证';
+    r.verificationAt = verifyOk ? verify.at : undefined;
+    r.checks = [{ id: 'quality', name: '质量检查汇总', status: testOk ? test.result === 'pass' ? 'pass' : 'fail' : 'pending', required: true, detail: testOk ? test.content : '本轮代码尚无有效质量检查报告。' },
+        { id: 'independent', name: '独立验证', status: verifyOk ? verify.result === 'pass' ? 'pass' : 'fail' : 'pending', required: true, detail: verifyOk ? verify.content : '须在当前代码、设计与测试版本上重新执行独立验证。' },
+        { id: 'separation', name: '实现与验证职责分离', status: independent ? 'pass' : 'fail', required: true, detail: independent ? '绑定流程使用不同实现与验证 Agent；原型没有启动真实隔离上下文。' : '验证者与实现者重合或缺失，禁止以自我验证通过。' },
+        ...['构建', '功能测试', '接口契约', 'evals'].map((name, i) => ({ id: 'item-' + i, name, status: 'unavailable', required: false, detail: '历史任务样例只提供汇总报告，未提供该分项独立证据；不能解读为本项已经通过。' }))];
+    if (verifyOk && verify.result === 'fail')
+        r.findings.push({ id: 'ROB-AC003.2', dimension: 'ROB', severity: 'high', title: '重复确认可能重复派单', detail: verify.content, artifactId: 'code', version: code.number });
+    else if (testOk && test.result === 'fail')
+        r.findings.push({ id: 'ROB-CHECK-01', dimension: 'ROB', severity: 'high', title: '质量检查执行未通过', detail: test.content, artifactId: 'test', version: test.number });
+    if (t.reviewPolicy) {
+        r.humanRequired = t.reviewPolicy.humanQuality;
+        r.policyReason = t.reviewPolicy.reason;
+        if (t.reviewPolicy.veto)
+            r.checks.push({ id: 'veto', name: '敏感领域停点', status: 'fail', required: true, detail: '该任务登记了不可自动放行的敏感停点；请回到任务处理，不能通过确认绕过。' });
+    }
+    return r;
+}
+export function captureDesign(t, by) {
+    const v = latestArtifact(t, 'design'), r = base(t, 'design', refsOf(t, ['spec', 'prototype', 'design']), v.at, by);
+    r.id = 'design-' + v.number + '-' + t.reworks;
+    r.checks = [{ id: 'source', name: '来源与版本一致性', status: 'pending', required: true, detail: '新设计需对照本任务绑定的规格及原型。' }, { id: 'decision', name: '设计修改复核', status: 'pending', required: true, detail: '保存修改不是复核通过；等待针对本版本的检查结果。' }];
+    return r;
+}
+export function reviewsForTask(t) {
+    if (t.isDeleted || !t.startedAt)
+        return [];
+    const rows = clone(t.reviews || []);
+    for (const r of [prototypeRecord(t), captureQuality(t)])
+        if (r && !rows.some(x => x.id === r.id))
+            rows.push(r);
+    return rows.sort((a, b) => b.createdAt.localeCompare(a.createdAt) || a.id.localeCompare(b.id));
+}
+export function reviewStatus(t, r) {
+    if (r.decision)
+        return { confirm: 'approved', edit: 'edited', replan: 'replanned' }[r.decision.action];
+    if (r.superseded || r.refs.some(ref => !evidenceVersion(t, ref)))
+        return 'superseded';
+    if (r.kind === 'prototype') {
+        if (latestArtifact(t, 'prototype')?.number !== r.refs.find(i => i.kind === 'prototype')?.version)
+            return 'superseded';
+        if (t.prototypeApproved)
+            return 'superseded';
+    }
+    else if (r.kind === 'design') {
+        if (t.pendingDesignReview !== r.id)
+            return 'superseded';
+    }
+    else if (t.pendingDesignReview || r.id !== captureQuality(t)?.id || r.iteration !== t.reworks || r.refs.some(ref => latestArtifact(t, ref.kind)?.number !== ref.version))
+        return 'superseded';
+    if (['paused', 'manual'].includes(t.status))
+        return 'suspended';
+    if (r.checks.some(c => c.required && c.status === 'fail'))
+        return 'blocked';
+    if (r.checks.some(c => c.required && c.status !== 'pass'))
+        return 'checking';
+    if (r.kind === 'quality' && !r.humanRequired)
+        return 'automatic';
+    if (r.kind === 'prototype' && !(t.status === 'waiting' && currentNode(t)?.gate !== 'production'))
+        return 'checking';
+    return 'pending';
+}
+export const actionableReview = (t) => reviewsForTask(t).find(r => ['pending', 'blocked', 'checking', 'suspended'].includes(reviewStatus(t, r)) && ((r.kind === 'design' && t.pendingDesignReview === r.id) || !t.pendingDesignReview));
+export function reviewBudget(t) { const n = t.binding.flow.body.nodes.find(n => ['agent', 'loop'].includes(n.kind)); return n?.kind === 'loop' ? Math.min(t.retryLimit, n.limit || 1) : t.retryLimit; }
+export function actionReason(t, r, actor, action) {
+    if (!canReadReview(actor, t))
+        return '没有此任务与产物的查看权限，或超出授权范围。';
+    if (!can(actor, actionPermission[action], t.tenantId, t.binding.pbcId))
+        return action === 'confirm' ? '缺少此 PBC 的交付人工确认权限。' : '缺少此 PBC 的' + (action === 'edit' ? '修改评审设计' : '重新规划交付') + '权限，请由权限管理员配置。';
+    const status = reviewStatus(t, r);
+    if (['approved', 'edited', 'replanned', 'automatic'].includes(status))
+        return '该记录已处理，请查看结果或当前版本。';
+    if (status === 'superseded')
+        return '依据版本已变化，请打开当前评审；历史记录不能继续提交。';
+    if (status === 'suspended')
+        return '任务已暂停或人工接管，请先恢复到原阶段。';
+    if (action === 'confirm' && status !== 'pending')
+        return r.checks.find(c => c.required && c.status !== 'pass')?.detail || '当前阶段尚未具备确认条件。';
+    if (action !== 'confirm' && r.kind === 'prototype')
+        return '此记录用于确认交互原型；设计修改与重新规划在原型确认后的交付评审中处理。';
+    if (action !== 'confirm' && t.reworks >= reviewBudget(t))
+        return '已达到本原型有限处理次数，请进入任务人工接管；接管不等于验证通过。';
+    if (action !== 'confirm' && !t.binding.flow.body.nodes.some(n => ['agent', 'loop'].includes(n.kind)))
+        return '绑定流程没有可返回的实现阶段。';
+    return '';
+}
+export const fingerprint = (p) => JSON.stringify([p.action, p.note.trim(), p.content || '', p.impact?.trim() || '']);
+export function sameRequest(t, id, p) { const r = t.reviews?.find(r => r.decision?.requestId === p.requestId); if (r) {
+    if (r.id !== id || r.decision.fingerprint !== fingerprint(p))
+        throw Error('同一提交编号不能用于不同记录或内容，请先核实原结果。');
+    return r.decision;
+} }
+export function retainReviews(before, after) {
+    const previous = before ? reviewsForTask(before) : [];
+    const rows = after.reviews || [];
+    for (const r of previous)
+        if (!rows.some(x => x.id === r.id))
+            rows.push(r);
+    after.reviews = rows;
+    const derived = prototypeRecord(after);
+    if (derived?.decision) {
+        const old = rows.find(r => r.id === derived.id);
+        if (old && !old.decision)
+            old.decision = derived.decision;
+    }
+    for (const r of reviewsForTask(after))
+        if (!rows.some(x => x.id === r.id))
+            rows.push(r);
+}
+export const reviewUrl = (t, r) => '/reviews/' + t + '/' + encodeURIComponent(r);

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/reviews/store.js

@@ -0,0 +1,13 @@
+import { computed, ref } from '../../runtime/state.js';
+import { defineStore } from "../../runtime/state.js";
+import { useTasks } from "../tasks/store.js";
+import { useSession } from "../shared/session.js";
+import { usePbcs } from "../pbc/store.js";
+import { reviewsForTask, reviewStatus, canReadReview, actionReason } from "./model.js";
+export const useReviews = defineStore('reviews', () => {
+    const tasks = useTasks(), session = useSession(), pbcs = usePbcs(), scene = ref('normal');
+    const rows = computed(() => session.state !== 'active' ? [] : tasks.records.filter(t => canReadReview(session.actor, t)).flatMap(t => reviewsForTask(t).map(review => ({ id: t.id + ':' + review.id, task: t, review, status: reviewStatus(t, review), project: session.can('pbc:view', t.tenantId, t.binding.pbcId) ? pbcs.items.find(p => p.id === t.binding.pbcId)?.name || t.binding.project : 'PBC详情未授权' }))).sort((a, b) => b.review.updatedAt.localeCompare(a.review.updatedAt) || a.id.localeCompare(b.id)));
+    const find = (taskId, id) => rows.value.find(r => r.task.id === taskId && r.review.id === id);
+    const reason = (r, action) => actionReason(r.task, r.review, session.actor, action);
+    return { rows, find, reason, scene, tasks, session, notice: computed(() => tasks.notice) };
+});

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ColumnSettings.html

@@ -0,0 +1,2 @@
+<!-- 来源：src/shared/ColumnSettings.vue；HTML / 原生 DOM 绑定，不含 Vue 运行时。 -->
+<template data-component="Button" aria-label="列设置" data-on-click="(open = true)"><template data-component="SettingOutlined"></template>列设置</template><template data-component="Drawer" data-bind-open="(open)" title="列设置" data-bind-size="(400)" data-on-close="(open = false)"><p class="muted">选择显示字段并调整顺序。设置按当前用户、范围和页面分别保存。</p><div data-each="(key, index) in (preferences.order.value)" data-bind-key="(key)" class="column-choice"><template data-component="Checkbox" data-bind-checked="(preferences.visible.value.includes(key))" data-bind-disabled="(preferences.choices.find(c =&gt; c.key === key)?.locked)" data-on-change="((e) =&gt; preferences.toggle(key, e.target.checked))">{{ (preferences.choices.find(c =&gt; c.key === key)?.label) }}</template><template data-component="Space" data-bind-size="(0)"><template data-component="Button" type="text" data-bind-aria-label="('上移' + preferences.choices.find(c =&gt; c.key === key)?.label)" data-bind-disabled="(index &lt;= 1 || preferences.choices.find(c =&gt; c.key === key)?.locked)" data-on-click="(preferences.move(key, -1))"><template data-component="ArrowUpOutlined"></template></template><template data-component="Button" type="text" data-bind-aria-label="('下移' + preferences.choices.find(c =&gt; c.key === key)?.label)" data-bind-disabled="(index &gt;= preferences.order.value.length - 2 || preferences.choices.find(c =&gt; c.key === key)?.locked)" data-on-click="(preferences.move(key, 1))"><template data-component="ArrowDownOutlined"></template></template></template></div><template data-component="Alert" data-if="(preferences.error.value)" type="warning" data-bind-title="(preferences.error.value)"></template><template data-slot="footer"><div class="drawer-footer"><template data-component="Button" data-on-click="(preferences.reset)">恢复默认</template><template data-component="Button" type="primary" data-on-click="(open = false)">完成</template></div></template></template>

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ColumnSettings.js

@@ -0,0 +1,9 @@
+import { ref } from '../../runtime/state.js';
+import { Alert, Button, Checkbox, Drawer, Space } from "../../runtime/widgets.js";
+import { SettingOutlined, ArrowUpOutlined, ArrowDownOutlined } from "../../runtime/icons.js";
+import { createComponent } from '../../runtime/dom.js';
+export default createComponent({ name: 'ColumnSettings', propKeys: ["preferences"], template: new URL('./ColumnSettings.html', import.meta.url).href, setup(__props, __emit) {
+        __props;
+        const open = ref(false);
+        return { ref, Alert, Button, Checkbox, Drawer, Space, SettingOutlined, ArrowUpOutlined, ArrowDownOutlined, open };
+    } });

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ListBatchBar.html

@@ -0,0 +1,2 @@
+<!-- 来源：src/shared/ListBatchBar.vue；HTML / 原生 DOM 绑定，不含 Vue 运行时。 -->
+<div class="list-batch-bar"><template data-component="Tooltip" data-bind-title="(!allowed ? '当前身份没有删除权限' : !count ? '请先勾选记录' : '')"><span><template data-component="Button" danger="" aria-label="批量删除" data-bind-disabled="(!allowed || !count)" data-on-click="($emit('remove'))"><template data-component="DeleteOutlined"></template>批量删除</template></span></template><span class="selection-count" role="status">已选 <strong>{{ (count) }}</strong> 项</span><template data-component="Button" data-if="(count)" type="text" class="link-button" data-on-click="($emit('clear'))">清空选择</template><span class="muted selection-hint">仅选择当前页</span><span class="mobile-table-hint muted">左右滑动表格，查看全部字段与操作</span></div>

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ListBatchBar.js

@@ -0,0 +1,8 @@
+import { Button, Tooltip } from "../../runtime/widgets.js";
+import { DeleteOutlined } from "../../runtime/icons.js";
+import { createComponent } from '../../runtime/dom.js';
+export default createComponent({ name: 'ListBatchBar', propKeys: ["count", "allowed"], template: new URL('./ListBatchBar.html', import.meta.url).href, setup(__props, __emit) {
+        __props;
+        __emit;
+        return { Button, Tooltip, DeleteOutlined };
+    } });

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ListDeleteDialog.html

@@ -0,0 +1,2 @@
+<!-- 来源：src/shared/ListDeleteDialog.vue；HTML / 原生 DOM 绑定，不含 Vue 运行时。 -->
+<template data-component="Modal" data-bind-open="(true)" data-bind-title="('删除' + label + '确认')" data-bind-width="(640)" data-bind-mask-closable="(false)" data-on-cancel="(!busy &amp;&amp; emit('close'))"><template data-component="Alert" show-icon="" data-bind-type="(blocked.length ? 'warning' : 'info')" data-bind-title="('已选 ' + targets.length + ' 项，可删除 ' + (targets.length - blocked.length) + ' 项，不可删除 ' + blocked.length + ' 项')" description="删除后从管理列表移除，保留记录与操作痕迹。请核对对象，本次提交将整批成功或整批不变。"></template><ul class="delete-preview" aria-label="删除对象"><li data-each="item in (checked)" data-bind-key="(item.target.id)"><div><strong>{{ (item.target.name) }}</strong><template data-component="Tag" data-bind-color="(item.reason ? 'orange' : 'green')">{{ (item.reason ? '不可删除' : '可删除') }}</template></div><p data-if="(item.reason)">{{ (item.reason) }}</p></li></ul><template data-component="Alert" data-if="(error)" type="error" show-icon="" data-bind-title="(error)" description="本次未删除任何记录。选择已保留；版本冲突时请关闭后重新核对。"></template><template data-slot="footer"><div class="delete-footer"><template data-component="Button" data-if="(blocked.length)" data-bind-disabled="(blocked.length === targets.length)" data-on-click="(keepEligible)">移除不可删除项</template><span class="footer-spacer"></span><template data-component="Button" data-bind-disabled="(busy)" data-on-click="(emit('close'))">取消</template><template data-component="Button" danger="" type="primary" data-bind-loading="(busy)" data-bind-disabled="(!!blocked.length || !targets.length)" data-on-click="(remove)">确认删除 {{ (targets.length) }} 项</template></div></template></template>

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ListDeleteDialog.js

@@ -0,0 +1,37 @@
+import { computed, ref } from '../../runtime/state.js';
+import { Alert, Button, Modal, Tag, message } from "../../runtime/widgets.js";
+import { createComponent } from '../../runtime/dom.js';
+export default createComponent({ name: 'ListDeleteDialog', propKeys: ["targets", "label", "check", "submit"], template: new URL('./ListDeleteDialog.html', import.meta.url).href, setup(__props, __emit) {
+        const props = __props;
+        const emit = __emit;
+        const busy = ref(false), error = ref('');
+        const checked = computed(() => props.targets.map(target => {
+            try {
+                props.check(target);
+                return { target, reason: '' };
+            }
+            catch (e) {
+                return { target, reason: e.message };
+            }
+        }));
+        const blocked = computed(() => checked.value.filter(item => item.reason));
+        function keepEligible() { emit('update:targets', checked.value.filter(item => !item.reason).map(item => item.target)); error.value = ''; }
+        async function remove() {
+            if (busy.value || blocked.value.length || !props.targets.length)
+                return;
+            busy.value = true;
+            error.value = '';
+            try {
+                props.submit(props.targets);
+                message.success('已删除 ' + props.targets.length + ' 项' + props.label);
+                emit('deleted');
+            }
+            catch (e) {
+                error.value = e.message;
+            }
+            finally {
+                busy.value = false;
+            }
+        }
+        return { computed, ref, Alert, Button, Modal, Tag, message, props, emit, busy, error, checked, blocked, keepEligible, remove };
+    } });

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ListMore.html

@@ -0,0 +1,2 @@
+<!-- 来源：src/shared/ListMore.vue；HTML / 原生 DOM 绑定，不含 Vue 运行时。 -->
+<template data-component="Dropdown" data-bind-menu="({ items, onClick: ({ key }) =&gt; emit('action', key) })" data-bind-trigger="(['click'])"><template data-component="Button" type="text" class="link-button" data-bind-aria-label="(name + '更多操作')">更多<template data-component="DownOutlined"></template></template></template>

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/ListMore.js

@@ -0,0 +1,8 @@
+import { Dropdown, Button } from "../../runtime/widgets.js";
+import { DownOutlined } from "../../runtime/icons.js";
+import { createComponent } from '../../runtime/dom.js';
+export default createComponent({ name: 'ListMore', propKeys: ["name", "items"], template: new URL('./ListMore.html', import.meta.url).href, setup(__props, __emit) {
+        __props;
+        const emit = __emit;
+        return { Dropdown, Button, DownOutlined, emit };
+    } });

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/RecordMetadata.html

@@ -0,0 +1,2 @@
+<!-- 来源：src/shared/RecordMetadata.vue；HTML / 原生 DOM 绑定，不含 Vue 运行时。 -->
+<section data-bind-class="(compact ? 'metadata-compact' : 'drawer-section')"><h2>基础信息</h2><template data-component="Descriptions" data-bind-items="(items)" data-bind-column="(compact ? 1 : { xs: 1, sm: 2, md: 2, lg: 2, xl: 2, xxl: 2 })" bordered="" size="small"></template><p class="muted metadata-note">创建与修改信息由系统记录，列设置只影响列表展示。</p></section>

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/RecordMetadata.js

@@ -0,0 +1,17 @@
+import { computed } from '../../runtime/state.js';
+import { Descriptions } from "../../runtime/widgets.js";
+import { formatDate, tenantLabel } from "./policy.js";
+import { createComponent } from '../../runtime/dom.js';
+export default createComponent({ name: 'RecordMetadata', propKeys: ["record", "compact"], template: new URL('./RecordMetadata.html', import.meta.url).href, setup(__props, __emit) {
+        const props = __props;
+        const items = computed(() => [
+            { key: 'scope', label: '所属范围', content: tenantLabel(props.record.tenantId) },
+            { key: 'creator', label: '创建人', content: props.record.createdBy },
+            { key: 'created', label: '创建时间', content: formatDate(props.record.createdAt) },
+            { key: 'department', label: '创建部门', content: props.record.createdDept },
+            { key: 'modifier', label: '修改人', content: props.record.updatedBy },
+            { key: 'updated', label: '修改时间', content: formatDate(props.record.updatedAt) },
+            { key: 'id', label: '记录标识', content: props.record.id, span: 'filled' },
+        ]);
+        return { computed, Descriptions, formatDate, tenantLabel, props, items };
+    } });

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/columns.js

@@ -0,0 +1,32 @@
+import { computed, ref, watch } from '../../runtime/state.js';
+import { useSession } from "./session.js";
+export function useColumns(page, choices) {
+    const session = useSession(), order = ref([]), visible = ref([]), error = ref('');
+    const key = computed(() => `i3-prototype-antdv-v010-columns:${session.key}:${page}:1`);
+    const defaults = () => ({ order: choices.map(c => c.key), visible: choices.filter(c => c.defaultVisible || c.locked).map(c => c.key) });
+    function restore() {
+        let value = defaults();
+        try {
+            const saved = JSON.parse(localStorage.getItem(key.value) || 'null');
+            if (Array.isArray(saved?.order) && Array.isArray(saved?.visible))
+                value = saved;
+        }
+        catch { /* Use schema defaults. */ }
+        order.value = [...new Set([...value.order.filter((k) => choices.some(c => c.key === k)), ...choices.map(c => c.key)])];
+        visible.value = [...new Set([...value.visible.filter((k) => choices.some(c => c.key === k)), ...choices.filter(c => c.locked).map(c => c.key)])];
+    }
+    function persist() { try {
+        localStorage.setItem(key.value, JSON.stringify({ order: order.value, visible: visible.value }));
+        error.value = '';
+    }
+    catch {
+        error.value = '浏览器无法保存列偏好，本次设置仍可使用。';
+    } }
+    function toggle(k, checked) { if (choices.find(c => c.key === k)?.locked)
+        return; visible.value = checked ? [...new Set([...visible.value, k])] : visible.value.filter(v => v !== k); persist(); }
+    function move(k, direction) { const a = [...order.value], i = a.indexOf(k), j = i + direction; if (i < 0 || j < 0 || j >= a.length || choices.find(c => c.key === k)?.locked || choices.find(c => c.key === a[j])?.locked)
+        return; [a[i], a[j]] = [a[j], a[i]]; order.value = a; persist(); }
+    function reset() { const d = defaults(); order.value = d.order; visible.value = d.visible; persist(); }
+    watch(key, restore, { immediate: true });
+    return { choices, order, visible, error, toggle, move, reset, keys: computed(() => order.value.filter(k => visible.value.includes(k))) };
+}

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/deliveryGuide.js

@@ -0,0 +1,49 @@
+import { can } from "./policy.js";
+import { lastVersion, confirmationBusy, unresolved } from "../intents/domain.js";
+import { currentVersion, pendingDecisions, specBusy } from "../specs/domain.js";
+export function affiliation(i, jobs, catalog, access) {
+    const j = jobs.find(j => j.intentId === i.id && j.tenantId === i.tenantId);
+    if (!j)
+        return { label: i.context.startsWith('拟归属') ? i.context : '尚未归属 PBC', key: i.context.startsWith('拟归属') ? i.context : 'unassigned', state: 'unassigned', path: '' };
+    if (!access('pbc:view', j.tenantId, j.pbc.id))
+        return { label: '已有归属记录 · 无权查看', key: 'restricted', state: 'restricted', path: '' };
+    const p = catalog.find(p => p.id === j.pbc.id && p.tenantId === j.tenantId && !p.isDeleted);
+    const prefix = j.status === 'done' ? '已归属' : j.status === 'unknown' ? '归属待核实' : ['failed', 'paused'].includes(j.status) ? '归属需处理' : '归属处理中';
+    return { label: prefix + '：' + (p?.name || j.pbc.name), key: j.status === 'done' ? 'pbc:' + j.pbc.id : 'pending:' + j.pbc.id, state: j.status, path: '/intents/' + i.id + '/pbc' };
+}
+// A presentation guide only. Existing domain commands still enforce every write condition.
+export function deliveryGuide(i, s, jobs, access) {
+    const root = '/intents/' + i.id, j = jobs.find(j => j.intentId === i.id && j.tenantId === i.tenantId);
+    const result = (stage, label, reason, path, action, allowed = true, create = false) => ({ stage, label, reason, path, action, allowed, create });
+    if (j) {
+        if (!access('pbc:view', j.tenantId, j.pbc.id))
+            return result('pbc', '已有归属记录', '当前无权查看目标 PBC，请联系业务管理员核对授权。', root, '查看意图', false);
+        return j.status === 'done' ? result('done', '已完成归属', '已有归属结果，请查看原结果或继续交付。', root + '/pbc', '查看归属结果') :
+            result('pbc', j.status === 'unknown' ? '归属待核实' : j.status === 'running' ? '归属处理中' : '归属需处理', '已有归属请求；进入原请求核实或恢复，不能重复创建。', root + '/pbc', '查看原请求');
+    }
+    if (i.status === 'closed')
+        return result('done', '意图已关闭', '关闭记录只读保留。', root, '查看记录', false);
+    if (confirmationBusy(i))
+        return result('intent', '确认待核实', '先核实原意图确认请求。', root, '核实确认结果', access('intent:confirm', i.tenantId));
+    if (i.status !== 'confirmed' || !lastVersion(i)?.confirmedAt) {
+        const ready = i.status === 'ready', pending = unresolved(i.decisions).length;
+        const op = ready && !pending ? 'intent:confirm' : 'intent:edit', allowed = access(op, i.tenantId);
+        return result('intent', ready ? (pending ? '意图待决策' : '意图待确认') : '意图待补充', !allowed ? '缺少此意图的' + (op === 'intent:confirm' ? '确认' : '编辑') + '权限。' : pending ? '仍有 ' + pending + ' 项意图决策待处理。' : '先完成并确认当前意图版本。', root + (ready ? '' : '/workspace'), ready && !pending ? '核对意图' : '完善意图', allowed);
+    }
+    if (!access('spec:view', i.tenantId))
+        return result('spec', '规格权限不足', '当前没有此需求的规格查看权限。', root, '查看意图', false);
+    const v = s && currentVersion(s);
+    if (s && specBusy(s))
+        return result('spec', '规格处理中', '生成进行中或确认结果待核实，请进入原规格处理。', root + '/spec', '查看规格');
+    if (!v || v.source.version !== lastVersion(i).number) {
+        const allowed = access('spec:generate', i.tenantId);
+        return result('spec', v ? '规格来源已变化' : '尚未生成规格', allowed ? '需要根据最新已确认意图生成规格。' : '缺少此需求的规格生成权限。', root + '/spec', '完善规格', allowed);
+    }
+    if (!v.confirmedAt) {
+        const n = pendingDecisions(v).length, allowed = access(n ? 'spec:edit' : 'spec:confirm', i.tenantId);
+        return result('spec', n ? '规格待完善' : '规格待确认', !allowed ? '缺少此规格的' + (n ? '编辑' : '确认') + '权限。' : n ? '还有 ' + n + ' 项决策需要结论和理由；保存后再确认新版本。' : '核对规格内容并确认当前版本后，才能创建 PBC。', root + '/spec' + (n ? '' : '/review'), n ? '处理未决事项' : '核对规格', allowed);
+    }
+    const view = access('pbc:view', i.tenantId), create = view && access('pbc:create', i.tenantId), link = view && access('pbc:link', i.tenantId);
+    return result('pbc', create ? '可创建 PBC' : link ? '可关联已有 PBC' : 'PBC 权限不足', create ? '规格 v' + v.number + ' 已确认，尚未提交归属。' : link ? '当前可以关联已有 PBC；新建 PBC 还需要对应租户的创建权限。' : '需要当前租户的 PBC 查看与创建/关联权限；功能授权在权限管理中配置。', create ? root + '/pbc?create=1' : link ? root + '/pbc' : root + '/spec/review', create ? '继续创建向导' : link ? '关联已有 PBC' : '查看已确认规格', create || link, create);
+}
+export const actorAccess = (actor) => (a, t, p) => can(actor, a, t, p);

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/deliveryView.js

@@ -0,0 +1,12 @@
+import { computed } from '../../runtime/state.js';
+import { useSession } from "./session.js";
+import { usePbcs } from "../pbc/store.js";
+import { useSpecs } from "../specs/store.js";
+import { useIntents } from "../intents/store.js";
+import { affiliation, deliveryGuide } from "./deliveryGuide.js";
+export function useDeliveryView() {
+    const session = useSession(), pbcs = usePbcs(), specs = useSpecs(), intents = useIntents();
+    const affiliationOf = (i) => affiliation(i, pbcs.jobs, pbcs.catalog, session.can);
+    const candidates = computed(() => intents.items.map(i => ({ id: i.id, title: i.title, code: i.code, tenantId: i.tenantId, guide: deliveryGuide(i, specs.get(i.id), pbcs.jobs, session.can), affiliation: affiliationOf(i) })));
+    return { affiliationOf, candidates };
+}

package/skills/i3-ui-prototype/assets/templates/enterprise-admin/reference/src/shared/listBatch.js

@@ -0,0 +1,15 @@
+export function assertBatch(records, targets, check) {
+    if (!targets.length)
+        throw new Error('请至少选择一条记录。');
+    if (new Set(targets.map(t => t.id)).size !== targets.length)
+        throw new Error('选择中包含重复记录，请重新选择。');
+    return targets.map(target => {
+        const record = records.find(r => r.id === target.id && !r.isDeleted);
+        if (!record)
+            throw new Error('记录已不存在或无权访问，请重新选择。');
+        check(record);
+        if (record.recordVersion !== target.recordVersion)
+            throw new Error('记录已被更新，请重新打开并核对最新内容。');
+        return record;
+    });
+}