kld-sdd 2.6.13 → 2.6.14

package/skywalk-sdd/reporting/change-report-model.cjs

@@ -0,0 +1,309 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const EVIDENCE_LABELS = {
+  TASK_UPDATE_MISSING: '任务状态事件缺失',
+  TASK_TEST_EVIDENCE_MISSING: '任务验证证据缺失',
+  TDD_RED_GREEN_INCOMPLETE: 'TDD 红绿链路不完整',
+  LEGACY_TASK_PARSER: '任务文档仍使用旧格式',
+  apply_test_missing: '实现阶段缺少测试证据',
+  tdd_red_missing: 'TDD 缺少有效失败测试',
+  process_note_missing: '过程说明缺失',
+  task_update_reuse: '测试结果被重复引用',
+};
+
+function eventTimestamp(event) {
+  const raw = event?.timestamp || event?.ended_at || event?.started_at;
+  const value = Date.parse(raw || '');
+  return Number.isFinite(value) ? value : 0;
+}
+
+function extractFinalTestResult(events = [], fallback = null) {
+  const testEvents = events
+    .filter((event) => event?.type === 'test_result')
+    .sort((a, b) => eventTimestamp(b) - eventTimestamp(a));
+  const candidates = testEvents
+    .filter((event) => {
+      if (event?.type !== 'test_result') return false;
+      const result = event.details?.test_results || {};
+      return result.evidence_tier === 'strict'
+        && ['green', 'refactor', 'regression'].includes(result.tdd_phase)
+        && result.counts_known === true;
+    });
+  const event = candidates.find(item => item.details?.test_results?.snapshot_kind === 'final')
+    || candidates[0];
+  const history = testEvents
+    .filter(item => item !== event)
+    .map(item => ({
+      event_id: item.event_id || null,
+      timestamp: item.timestamp || null,
+      passed: Number.isFinite(Number(item.details?.test_results?.passed))
+        ? Number(item.details.test_results.passed)
+        : null,
+      failed: Number.isFinite(Number(item.details?.test_results?.failed))
+        ? Number(item.details.test_results.failed)
+        : null,
+      snapshot_kind: item.details?.test_results?.snapshot_kind || 'unspecified',
+      evidence_tier: item.details?.test_results?.evidence_tier || 'legacy',
+    }));
+  if (!event) {
+    return fallback || {
+      passed: null,
+      failed: null,
+      total: null,
+      status: 'unavailable',
+      source_event_id: null,
+      source: 'unavailable',
+      history,
+    };
+  }
+  const result = event.details.test_results;
+  const passed = Number(result.passed);
+  const failed = Number(result.failed);
+  const skipped = Number(result.skipped || 0);
+  return {
+    passed,
+    failed,
+    skipped,
+    total: passed + failed + skipped,
+    status: result.result === 'success' && failed === 0 ? 'passed' : 'failed',
+    source_event_id: event.event_id || null,
+    source: 'strict-test-result',
+    snapshot_kind: result.snapshot_kind || 'unspecified',
+    history,
+  };
+}
+
+function normalizeTaskSummary(report) {
+  const completion = report.archive_result?.task_completion || {};
+  const primary = completion.primary_tasks || {};
+  const documentTotal = primary.total ?? completion.total ?? null;
+  const documentCompleted = primary.completed ?? completion.completed ?? null;
+  const audit = report.apply_evidence_audit || {};
+  const auditTasks = audit.tasks || audit.summary || {};
+  const traceabilityVerified = auditTasks.with_test_evidence ?? auditTasks.verified ?? null;
+  const traceabilityTotal = auditTasks.completed ?? auditTasks.total ?? documentTotal;
+  return {
+    document: {
+      completed: documentCompleted,
+      total: documentTotal,
+      status: documentTotal == null
+        ? 'unavailable'
+        : (documentCompleted === documentTotal ? 'complete' : 'incomplete'),
+      source: 'tasks-document',
+    },
+    traceability: {
+      verified: traceabilityVerified,
+      total: traceabilityTotal,
+      status: traceabilityTotal == null || traceabilityVerified == null
+        ? 'unavailable'
+        : (traceabilityVerified === traceabilityTotal ? 'complete' : 'incomplete'),
+      source: 'strict-event-audit',
+    },
+  };
+}
+
+function normalizeEvidenceSummary(report) {
+  const alerts = report.evidence_alerts || {};
+  const alertHistory = Array.isArray(alerts.history) && alerts.history.length > 0
+    ? alerts.history
+    : [...(alerts.open || []), ...(alerts.resolved || [])];
+  const history = [
+    ...alertHistory,
+    ...(report.check_warning_dispositions || []).map(item => ({
+      ...item,
+      code: item.warning,
+      occurrences: 1,
+      status: ['fixed', 'accepted', 'waived'].includes(item.disposition) ? 'resolved' : 'open',
+      last_seen_event_id: item.evidence_event_id,
+    })),
+  ];
+  const groups = new Map();
+  for (const alert of history) {
+    const code = alert.warning || alert.code || 'UNKNOWN';
+    if (!groups.has(code)) {
+      groups.set(code, {
+        code,
+        label: EVIDENCE_LABELS[code] || code,
+        occurrence_count: 0,
+        affected_tasks: [],
+        event_ids: [],
+        dispositions: {},
+      });
+    }
+    const group = groups.get(code);
+    group.occurrence_count += Math.max(1, Number(alert.occurrences) || 1);
+    const task = alert.task_id || alert.subject;
+    if (task && !group.affected_tasks.includes(task)) group.affected_tasks.push(task);
+    for (const eventId of [alert.opened_by_event_id, alert.last_seen_event_id, alert.resolved_by_event_id]) {
+      if (eventId && !group.event_ids.includes(eventId)) group.event_ids.push(eventId);
+    }
+    const disposition = alert.disposition || (alert.status === 'resolved' ? 'fixed' : 'open');
+    group.dispositions[disposition] = (group.dispositions[disposition] || 0) + 1;
+  }
+  const categories = [...groups.values()];
+  return {
+    category_count: categories.length,
+    occurrence_count: categories.reduce((sum, item) => sum + item.occurrence_count, 0),
+    categories,
+    note: '一次任务或事件可能同时命中多条规则；命中次数不等于独立缺陷数。',
+  };
+}
+
+function normalizeChangedFiles(changedFiles = {}) {
+  const taskEventFiles = Array.isArray(changedFiles.task_event_files)
+    ? [...new Set(changedFiles.task_event_files)]
+    : null;
+  const finalOutputFiles = Array.isArray(changedFiles.final_output_files)
+    ? [...new Set(changedFiles.final_output_files)]
+    : (Array.isArray(changedFiles.files) ? [...new Set(changedFiles.files)] : null);
+  const taskCount = changedFiles.task_event_files_changed
+    ?? changedFiles.files_changed
+    ?? taskEventFiles?.length
+    ?? null;
+  const finalCount = changedFiles.final_output_files_changed
+    ?? finalOutputFiles?.length
+    ?? null;
+  const countsDiffer = taskCount != null && finalCount != null && taskCount !== finalCount;
+  return {
+    ...changedFiles,
+    task_event_files: taskEventFiles,
+    task_event_files_changed: taskCount,
+    final_output_files: finalOutputFiles,
+    final_output_files_changed: finalCount,
+    diff_source: changedFiles.diff_source || 'legacy-fields',
+    line_count_estimate: changedFiles.line_count_estimate ?? null,
+    reconciliation_note: changedFiles.reconciliation_note
+      || (countsDiffer
+        ? `任务事件累计涉及 ${taskCount} 个文件；最终输出快照包含 ${finalCount} 个文件。两者用途不同，不应合并为一个口径。`
+        : '任务事件与最终输出文件口径一致。'),
+    legacy_fields: {
+      files: { deprecated: true, ambiguous: true },
+      files_changed: { deprecated: true, ambiguous: true },
+    },
+  };
+}
+
+function resolveArtifact(projectRoot, artifactPath, options = {}) {
+  if (!artifactPath) return { path: null, exists: false, size_bytes: null, sha256: null };
+  const absolute = path.isAbsolute(artifactPath)
+    ? artifactPath
+    : path.resolve(projectRoot || process.cwd(), artifactPath);
+  try {
+    const stat = fs.statSync(absolute);
+    if (!stat.isFile()) return { path: artifactPath, exists: false, size_bytes: null, sha256: null };
+    if (options.selfReferential) {
+      return {
+        path: artifactPath,
+        exists: true,
+        size_bytes: null,
+        sha256: null,
+        integrity_note: '报告不能内嵌自身最终大小与哈希；请以归档 Manifest 为准',
+      };
+    }
+    const sha256 = crypto.createHash('sha256').update(fs.readFileSync(absolute)).digest('hex');
+    return { path: artifactPath, exists: true, size_bytes: stat.size, sha256: `sha256:${sha256}` };
+  } catch {
+    return { path: artifactPath, exists: false, size_bytes: null, sha256: null };
+  }
+}
+
+function normalizeArtifacts(report) {
+  const archive = report.archive_result || {};
+  const existing = report.artifacts || {};
+  const projectRoot = report.project_root;
+  const paths = {
+    markdown_report: archive.report_path,
+    html_report: archive.report_html_path,
+    json_report: archive.report_json_path,
+    execution_log: archive.execution_log_path
+      || existing.execution_log_path
+      || (archive.archive_path ? path.join(archive.archive_path, 'logs', 'execution-log.md') : null),
+    manifest: archive.manifest_path || existing.manifest_path,
+    archive_zip: archive.archive_zip_path
+      || archive.zip_path
+      || archive.package_path
+      || existing.archive_zip_path
+      || existing.package_path,
+  };
+  return {
+    ...existing,
+    files: Object.fromEntries(
+      Object.entries(paths).map(([name, artifactPath]) => [
+        name,
+        resolveArtifact(projectRoot, artifactPath, {
+          selfReferential: [
+            'markdown_report',
+            'html_report',
+            'json_report',
+            'manifest',
+            'archive_zip',
+          ].includes(name),
+        }),
+      ]),
+    ),
+  };
+}
+
+function buildWarningDispositions(report) {
+  const alerts = [
+    ...(report.evidence_alerts?.open || []),
+    ...(report.evidence_alerts?.resolved || []),
+    ...(report.check_warning_dispositions || []),
+  ];
+  const allowed = new Set(['fixed', 'accepted', 'waived', 'needs_input', 'open']);
+  const checkWarnings = new Set((report.check_warning_dispositions || []).map(item => item.warning));
+  const byWarning = new Map();
+  for (const alert of alerts) {
+    const inferred = alert.status === 'resolved' ? 'fixed' : 'open';
+    const disposition = allowed.has(alert.disposition) ? alert.disposition : inferred;
+    const normalized = {
+      warning: alert.warning || alert.code || 'UNKNOWN',
+      subject: alert.subject || alert.task_id || null,
+      disposition,
+      reason: alert.disposition_reason || alert.reason || alert.message || null,
+      evidence_event_id: alert.evidence_event_id || alert.resolved_by_event_id || alert.last_seen_event_id || null,
+    };
+    if (!byWarning.has(normalized.warning) || checkWarnings.has(normalized.warning)) {
+      byWarning.set(normalized.warning, normalized);
+    }
+  }
+  return [...byWarning.values()];
+}
+
+function buildChangeReportModel(report, events = []) {
+  if (!report || report.level !== 'change' || !report.change) return report;
+  const changedFiles = normalizeChangedFiles(report.changed_files);
+  const existingSummary = report.change_summary || {};
+  const changeSummary = {
+    tests: events.length > 0
+      ? extractFinalTestResult(events, report.final_test_result || existingSummary.tests || null)
+      : (existingSummary.tests || extractFinalTestResult(events, report.final_test_result || null)),
+    tasks: existingSummary.tasks || normalizeTaskSummary(report),
+    evidence: existingSummary.evidence || normalizeEvidenceSummary(report),
+  };
+  return {
+    ...report,
+    report_scope: {
+      kind: 'single-change',
+      change: report.change,
+      cross_change_data_included: false,
+    },
+    metric_provenance: report.metric_provenance || report.metric_evidence || null,
+    change_summary: changeSummary,
+    changed_files: changedFiles,
+    warning_dispositions: buildWarningDispositions(report),
+    artifacts: normalizeArtifacts(report),
+  };
+}
+
+module.exports = {
+  EVIDENCE_LABELS,
+  buildChangeReportModel,
+  extractFinalTestResult,
+  normalizeEvidenceSummary,
+  normalizeChangedFiles,
+};