Files
2026-09-24 10:40:57 +08:00

40 lines
2.1 KiB
Python

"""Persist only genuine user decisions, preserving the legacy question list."""
from .quality_models import ClarificationQuestion
def save_questions(job, items, kind='design_decision'):
parsed=[i if isinstance(i,ClarificationQuestion) else ClarificationQuestion.model_validate(i) for i in items]
job.write('clarification.json',{'kind':kind,'questions':[i.question for i in parsed],
'items':[i.model_dump() for i in parsed]})
def pause_for_decisions(job, brief):
if not brief.clarification_questions: return
from .constraint_audit import NeedsClarification
save_questions(job,brief.clarification_questions)
raise NeedsClarification('存在会改变关键设计的用户选择,已保存需求')
def review_decision_errors(review, brief, text):
"""Questions discovered during review must point back to actual user requirements."""
ids = {r.id for r in brief.requirements}
errors = []
for item in review.clarification_questions:
if set(item.requirement_ids) - ids:
errors.append('提问必须关联已有需求,不能把程序内部错误交给用户')
if any(not quote.strip() or quote not in text for quote in item.source_quotes):
errors.append('提问依据必须逐字摘录原始用户要求;测量不足或候选缺陷应由程序处理')
if any(r.requirement_id in item.requirement_ids and r.status == 'pass' for r in review.items):
errors.append('需要用户决定的要求不能同时标为通过')
return errors
def pause_for_review_decisions(job, review):
if not review.clarification_questions:
return
from .constraint_audit import NeedsClarification
job.write('review_decisions.json', [q.model_dump() for q in review.clarification_questions])
save_questions(job, [ClarificationQuestion(question=q.question, reason=q.reason, options=q.options)
for q in review.clarification_questions], 'review_design_decision')
raise NeedsClarification('核对时发现需要用户决定的原始要求,候选和原始需求均已保留')