需求 Harness 深度解析

   8  export function serializeRequirement(r: HarnessRequirement) {
   9    return {
  10      id: r.id,
  11      excerpt: r.excerpt,
  12      description: r.description,
  13      type: r.type.toLowerCase(),
  14      severity: r.severity.toLowerCase(),
  15      locked: r.locked,
  16    };
  17  }
  18  
  19  export function serializeResult(r: HarnessResult) {
  20    return {
  21      requirement_id: r.requirementId,
  22      result: r.result,
  23      evidence: r.evidence,
  24      run_status: r.runStatus,
  25      last_verified_sha: r.lastVerifiedSha,
  26      watched_paths: r.watchedPaths,
  27      run_at: r.runAt?.toISOString() ?? null,
  28      is_stale: r.isStale,
  29    };

  62    const keptIds = incoming.filter((r) => r.id).map((r) => r.id as string);
  63  
  64    const requirements = await prisma.$transaction(async (tx) => {
  65      await tx.harnessRequirement.deleteMany({
  66        where: { projectId: id, id: { notIn: keptIds } },
  67      });
  68      return Promise.all(
  69        incoming.map((r) => {
  70          const data = {
  71            excerpt: r.excerpt?.trim() || null,
  72            description: (r.description as string).trim(),
  73            type: (r.type?.toUpperCase() ?? 'EXPLICIT') as RequirementType,
  74            severity: (r.severity?.toUpperCase() ?? 'MEDIUM') as Severity,
  75          };
  76          // A create always claims manual ownership (the user typed it). An update
  77          // only changes lock state when the client explicitly sends one — true for an
  78          // edited row, false for a reset-to-auto; an omitted flag leaves the stored
  79          // value untouched, so a partial payload can never mass-lock the whole set.
  80          const lockedProvided = typeof r.locked === 'boolean';
  81          return r.id
  82            ? tx.harnessRequirement.update({
  83                where: { id: r.id },
  84                data: { ...data, ...(lockedProvided ? { locked: r.locked } : {}) },
  85              })
  86            : tx.harnessRequirement.create({
  87                data: { id: ulid(), projectId: id, ...data, locked: r.locked ?? true },
  88              });
  89        })
  90      );
  91    });
  92  
  93    return NextResponse.json({
  94      requirements: requirements.map(serializeRequirement),
  95    });
  96  }

  69  function verdictOf(result: Result | undefined): Verdict {
  70    if (!result || !result.run_at) return 'unverified';
  71    if (result.run_status === 'INCONCLUSIVE') return 'inconclusive';
  72    return result.result === 'SUCCESS' ? 'pass' : 'fail';
  73  }
  74  
  75  function computeGate(requirements: Requirement[], verdicts: Map<string, Verdict>) {
  76    if (requirements.length === 0) {
  77      return {
  78        label: 'No requirements yet',
  79        reason: 'Add business requirements to gate this app on.',
  80        grad: 'from-slate-500 to-slate-700',
  81        Icon: Question,
  82      };
  83    }
  84    const criticals = requirements.filter((r) => r.severity === 'critical');
  85    const anyCriticalFail = criticals.some((r) => verdicts.get(r.id) === 'fail');
  86    const anyFail = requirements.some((r) => verdicts.get(r.id) === 'fail');
  87    const allCriticalPass = criticals.every((r) => verdicts.get(r.id) === 'pass');
  88  
  89    if (anyCriticalFail) {
  90      return {
  91        label: 'Do not ship',
  92        reason: 'A critical requirement is failing.',
  93        grad: 'from-red-500 to-rose-700',
  94        Icon: Prohibit,
  95      };
  96    }
  97    if (anyFail || !allCriticalPass) {
  98      return {
  99        label: 'Ship with warnings',
 100        reason: anyFail
 101          ? 'Non-critical requirements are failing.'
 102          : 'Critical requirements are not verified yet.',
 103        grad: 'from-amber-500 to-orange-600',
 104        Icon: Warning,
 105      };
 106    }
 107    return {
 108      label: 'Safe to ship',
 109      reason: 'Every critical requirement passes.',
 110      grad: 'from-emerald-500 to-green-700',
 111      Icon: RocketLaunch,
 112    };
 113  }