@lsctech/polaris 0.5.6 → 0.5.8

package/dist/autoresearch/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatRecommendationsCli = exports.recommendationToProposal = exports.recommendationsToProposals = exports.generateRecommendations = exports.formatReportCli = exports.generateReport = exports.getHistoryFilePath = exports.buildSnapshot = exports.loadSnapshots = exports.appendSnapshot = exports.computeSolScoreReport = exports.computeWorkerScore = exports.computeForemanScore = exports.aggregateSolEvidence = exports.routeProposals = exports.validateDiagnosisReport = exports.loadDiagnosisReport = exports.buildProposals = exports.FIX_ZONE_MAP = exports.ALL_GATES = exports.buildDiagnosisHints = exports.computeScore = exports.loadRunArtifacts = exports.scoreRun = exports.assertPolarisDevContext = exports.isPolarisDevContext = void 0;
+exports.scorecardToRecommendationSummary = exports.formatRecommendationsCli = exports.recommendationToProposal = exports.recommendationsToProposals = exports.generateRecommendations = exports.renderSolMarkdown = exports.getSolMarkdownReportPath = exports.getScorecardPath = exports.getEvaluationRecordPath = exports.getSolReportsDir = exports.getSolScorecardsDir = exports.getSolEvaluationsDir = exports.writeSolMarkdownReport = exports.writeScorecardSet = exports.writeScorecard = exports.writeEvaluationRecord = exports.buildEvaluationRecord = exports.formatReportCli = exports.generateReport = exports.getHistoryFilePath = exports.buildSnapshot = exports.loadSnapshots = exports.appendSnapshot = exports.buildRoutingRawMetrics = exports.buildModelRawMetrics = exports.buildProviderRawMetrics = exports.buildWorkerRawMetrics = exports.buildForemanRawMetrics = exports.computeAllScorecards = exports.computeRoutingScorecard = exports.computeModelScorecard = exports.computeProviderScorecard = exports.computeWorkerScorecard = exports.computeForemanScorecard = exports.computeSolScoreReport = exports.computeWorkerScore = exports.computeForemanScore = exports.aggregateSolEvidence = exports.routeProposals = exports.validateDiagnosisReport = exports.loadDiagnosisReport = exports.buildProposals = exports.FIX_ZONE_MAP = exports.ALL_GATES = exports.buildDiagnosisHints = exports.computeScore = exports.loadRunArtifacts = exports.scoreRun = exports.assertPolarisDevContext = exports.isPolarisDevContext = void 0;
+exports.scorecardsToRecommendationSummaries = void 0;
 var dev_gate_js_1 = require("./dev-gate.js");
 Object.defineProperty(exports, "isPolarisDevContext", { enumerable: true, get: function () { return dev_gate_js_1.isPolarisDevContext; } });
 Object.defineProperty(exports, "assertPolarisDevContext", { enumerable: true, get: function () { return dev_gate_js_1.assertPolarisDevContext; } });
@@ -24,6 +25,18 @@ var sol_scorer_js_1 = require("./sol-scorer.js");
 Object.defineProperty(exports, "computeForemanScore", { enumerable: true, get: function () { return sol_scorer_js_1.computeForemanScore; } });
 Object.defineProperty(exports, "computeWorkerScore", { enumerable: true, get: function () { return sol_scorer_js_1.computeWorkerScore; } });
 Object.defineProperty(exports, "computeSolScoreReport", { enumerable: true, get: function () { return sol_scorer_js_1.computeSolScoreReport; } });
+var sol_scorecard_calculator_js_1 = require("./sol-scorecard-calculator.js");
+Object.defineProperty(exports, "computeForemanScorecard", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.computeForemanScorecard; } });
+Object.defineProperty(exports, "computeWorkerScorecard", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.computeWorkerScorecard; } });
+Object.defineProperty(exports, "computeProviderScorecard", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.computeProviderScorecard; } });
+Object.defineProperty(exports, "computeModelScorecard", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.computeModelScorecard; } });
+Object.defineProperty(exports, "computeRoutingScorecard", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.computeRoutingScorecard; } });
+Object.defineProperty(exports, "computeAllScorecards", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.computeAllScorecards; } });
+Object.defineProperty(exports, "buildForemanRawMetrics", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.buildForemanRawMetrics; } });
+Object.defineProperty(exports, "buildWorkerRawMetrics", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.buildWorkerRawMetrics; } });
+Object.defineProperty(exports, "buildProviderRawMetrics", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.buildProviderRawMetrics; } });
+Object.defineProperty(exports, "buildModelRawMetrics", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.buildModelRawMetrics; } });
+Object.defineProperty(exports, "buildRoutingRawMetrics", { enumerable: true, get: function () { return sol_scorecard_calculator_js_1.buildRoutingRawMetrics; } });
 var sol_history_js_1 = require("./sol-history.js");
 Object.defineProperty(exports, "appendSnapshot", { enumerable: true, get: function () { return sol_history_js_1.appendSnapshot; } });
 Object.defineProperty(exports, "loadSnapshots", { enumerable: true, get: function () { return sol_history_js_1.loadSnapshots; } });
@@ -32,8 +45,24 @@ Object.defineProperty(exports, "getHistoryFilePath", { enumerable: true, get: fu
 var sol_report_js_1 = require("./sol-report.js");
 Object.defineProperty(exports, "generateReport", { enumerable: true, get: function () { return sol_report_js_1.generateReport; } });
 Object.defineProperty(exports, "formatReportCli", { enumerable: true, get: function () { return sol_report_js_1.formatReportCli; } });
+var sol_evaluation_writer_js_1 = require("./sol-evaluation-writer.js");
+Object.defineProperty(exports, "buildEvaluationRecord", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.buildEvaluationRecord; } });
+Object.defineProperty(exports, "writeEvaluationRecord", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.writeEvaluationRecord; } });
+Object.defineProperty(exports, "writeScorecard", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.writeScorecard; } });
+Object.defineProperty(exports, "writeScorecardSet", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.writeScorecardSet; } });
+Object.defineProperty(exports, "writeSolMarkdownReport", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.writeSolMarkdownReport; } });
+Object.defineProperty(exports, "getSolEvaluationsDir", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.getSolEvaluationsDir; } });
+Object.defineProperty(exports, "getSolScorecardsDir", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.getSolScorecardsDir; } });
+Object.defineProperty(exports, "getSolReportsDir", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.getSolReportsDir; } });
+Object.defineProperty(exports, "getEvaluationRecordPath", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.getEvaluationRecordPath; } });
+Object.defineProperty(exports, "getScorecardPath", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.getScorecardPath; } });
+Object.defineProperty(exports, "getSolMarkdownReportPath", { enumerable: true, get: function () { return sol_evaluation_writer_js_1.getSolMarkdownReportPath; } });
+var sol_report_renderer_js_1 = require("./sol-report-renderer.js");
+Object.defineProperty(exports, "renderSolMarkdown", { enumerable: true, get: function () { return sol_report_renderer_js_1.renderSolMarkdown; } });
 var sol_recommendations_js_1 = require("./sol-recommendations.js");
 Object.defineProperty(exports, "generateRecommendations", { enumerable: true, get: function () { return sol_recommendations_js_1.generateRecommendations; } });
 Object.defineProperty(exports, "recommendationsToProposals", { enumerable: true, get: function () { return sol_recommendations_js_1.recommendationsToProposals; } });
 Object.defineProperty(exports, "recommendationToProposal", { enumerable: true, get: function () { return sol_recommendations_js_1.recommendationToProposal; } });
 Object.defineProperty(exports, "formatRecommendationsCli", { enumerable: true, get: function () { return sol_recommendations_js_1.formatRecommendationsCli; } });
+Object.defineProperty(exports, "scorecardToRecommendationSummary", { enumerable: true, get: function () { return sol_recommendations_js_1.scorecardToRecommendationSummary; } });
+Object.defineProperty(exports, "scorecardsToRecommendationSummaries", { enumerable: true, get: function () { return sol_recommendations_js_1.scorecardsToRecommendationSummaries; } });

package/dist/autoresearch/proposal.js

@@ -253,6 +253,11 @@ function normalizeQcScoreSummary(raw) {
         category_breakdown: q.category_breakdown ?? {},
         recurring_child_signals: Array.isArray(q.recurring_child_signals) ? q.recurring_child_signals : [],
         recurring_provider_signals: Array.isArray(q.recurring_provider_signals) ? q.recurring_provider_signals : [],
+        repair_loop: q.repair_loop ?? null,
+        noisy_providers: Array.isArray(q.noisy_providers) ? q.noisy_providers : [],
+        has_repair_failures: q.has_repair_failures ?? false,
+        unresolved_high_severity: q.unresolved_high_severity ?? 0,
+        max_round_exhausted: q.max_round_exhausted ?? false,
     };
 }
 /**

package/dist/autoresearch/score.js

@@ -25,6 +25,7 @@ exports.scoreRun = scoreRun;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const artifacts_js_1 = require("../qc/artifacts.js");
+const store_js_1 = require("../cluster-state/store.js");
 const gates_js_1 = require("./gates.js");
 // ──────────────────────────────────────────────
 // Diagnosis hints table
@@ -196,6 +197,7 @@ function loadRunArtifacts(repoRoot, runId) {
         workerResultContracts = extractWorkerResultContracts(resultPackets);
     }
     const qcResults = loadQcArtifacts(clusterId, repoRoot);
+    const clusterState = clusterId ? (0, store_js_1.readClusterStateSync)(clusterId, repoRoot) : null;
     return {
         runId,
         runDir,
@@ -206,6 +208,7 @@ function loadRunArtifacts(repoRoot, runId) {
         workerResultContracts,
         telemetryEvents,
         qcResults,
+        clusterState,
     };
 }
 // ──────────────────────────────────────────────
@@ -247,6 +250,159 @@ function computeQcPenalty(weightedOpenScore) {
     // Soft penalty that grows with weighted severity but does not dominate the score.
     return weightedOpenScore === 0 ? 0 : weightedOpenScore / (weightedOpenScore + 20);
 }
+function zeroProviderAttemptSummary() {
+    return { total: 0, success: 0, failure: 0, fallback: 0, skipped: 0, all_providers_failed: false };
+}
+function zeroRepairLoopSummary() {
+    return {
+        status: "not-configured",
+        rounds_completed: 0,
+        max_rounds: 0,
+        packets_compiled: 0,
+        packets_completed: 0,
+        packets_failed: 0,
+        rerun_outcome: null,
+        provider_attempts: zeroProviderAttemptSummary(),
+    };
+}
+function mapTerminalOutcome(outcome) {
+    switch (outcome) {
+        case "pass":
+            return "passed";
+        case "no-repairable":
+            return "no-repairable";
+        case "max-rounds":
+            return "max-rounds";
+        case "all-providers-failed":
+            return "all-providers-failed";
+        case "operator-review":
+            return "operator-review";
+        case "medic-referral":
+            return "medic-referral";
+        case "qc-disabled":
+            return "not-configured";
+        default:
+            return "unknown";
+    }
+}
+function providerAttemptStatusFromResult(result) {
+    if (result.providerAttempt)
+        return result.providerAttempt.status;
+    if (result.allProvidersFailed || result.status === "failed")
+        return "failure";
+    if (result.status === "skipped")
+        return "skipped";
+    if (result.findings.length > 0 || result.status === "findings" || result.status === "blocked")
+        return "success";
+    if (result.status === "passed")
+        return "success";
+    return undefined;
+}
+function computeProviderAttemptSummary(qcResults, telemetryEvents) {
+    const summary = zeroProviderAttemptSummary();
+    for (const result of qcResults) {
+        const status = providerAttemptStatusFromResult(result);
+        if (status) {
+            summary.total += 1;
+            if (status === "success")
+                summary.success += 1;
+            else if (status === "failure")
+                summary.failure += 1;
+            else if (status === "fallback")
+                summary.fallback += 1;
+            else if (status === "skipped")
+                summary.skipped += 1;
+        }
+        if (result.allProvidersFailed)
+            summary.all_providers_failed = true;
+    }
+    // Telemetry fallback events augment the fallback count when providerAttempt was not written.
+    for (const ev of telemetryEvents) {
+        const rec = asRecord(ev);
+        if (rec?.["event"] === "provider-fallback-attempted")
+            summary.fallback += 1;
+    }
+    return summary;
+}
+function computeQcRepairLoopSummary(qcResults, clusterState, telemetryEvents, currentState) {
+    if (qcResults.length === 0)
+        return zeroRepairLoopSummary();
+    const currentStateRec = asRecord(currentState);
+    const loopState = currentStateRec?.["qc_repair_loop"];
+    const terminalOutcome = clusterState?.qc_repair_outcome ??
+        (loopState?.terminal_outcome ? String(loopState.terminal_outcome) : null);
+    const terminalEvents = telemetryEvents
+        .map(asRecord)
+        .filter((e) => e !== undefined && e["event"] === "qc-repair-loop-terminal");
+    const lastTerminal = terminalEvents[terminalEvents.length - 1];
+    const manifestEvents = telemetryEvents
+        .map(asRecord)
+        .filter((e) => e !== undefined && e["event"] === "qc-repair-manifest-compiled");
+    const failureEvents = telemetryEvents
+        .map(asRecord)
+        .filter((e) => e !== undefined && e["event"] === "qc-repair-worker-failures");
+    const failedPacketIds = new Set();
+    for (const ev of failureEvents) {
+        const ids = ev["failed_packet_ids"];
+        if (Array.isArray(ids)) {
+            for (const id of ids) {
+                if (typeof id === "string")
+                    failedPacketIds.add(id);
+            }
+        }
+    }
+    const rerunEvents = telemetryEvents
+        .map(asRecord)
+        .filter((e) => e !== undefined && e["event"] === "qc-repair-rerun-complete");
+    const lastRerun = rerunEvents[rerunEvents.length - 1];
+    let status;
+    if (terminalOutcome) {
+        status = mapTerminalOutcome(terminalOutcome);
+    }
+    else if (lastTerminal) {
+        status = mapTerminalOutcome(asString(lastTerminal["outcome"]));
+    }
+    else if (loopState) {
+        status = "in-progress";
+    }
+    else {
+        status = "not-run";
+    }
+    const roundsCompleted = asNumber(lastTerminal?.["rounds_completed"]) ??
+        (loopState?.current_round ?? 0);
+    const maxRounds = asNumber(lastTerminal?.["max_rounds"]) ??
+        (loopState?.max_rounds ?? 0);
+    const packetsCompiled = manifestEvents.reduce((sum, e) => {
+        const n = asNumber(e["packet_count"]);
+        return sum + (n ?? 0);
+    }, 0);
+    const packetsFailed = failedPacketIds.size;
+    const packetsCompleted = status === "not-run" || status === "not-configured"
+        ? 0
+        : Math.max(0, packetsCompiled - packetsFailed);
+    let rerunOutcome = null;
+    if (lastRerun) {
+        const action = asString(lastRerun["action"]);
+        if (action === "pass")
+            rerunOutcome = "pass";
+        else if (action === "findings")
+            rerunOutcome = "findings";
+        else if (action === "failure" || action === "error")
+            rerunOutcome = "failed";
+        else if (action === "skipped")
+            rerunOutcome = "skipped";
+    }
+    return {
+        status,
+        rounds_completed: roundsCompleted,
+        max_rounds: maxRounds,
+        packets_compiled: packetsCompiled,
+        packets_completed: packetsCompleted,
+        packets_failed: packetsFailed,
+        rerun_outcome: rerunOutcome,
+        provider_attempts: computeProviderAttemptSummary(qcResults, telemetryEvents),
+    };
+}
 /**
  * Computes a QcScoreSummary from the QC results loaded for this run.
  * Returns null when no QC results are present.
@@ -263,7 +419,7 @@ function computeQcPenalty(weightedOpenScore) {
  * a critical/high-confidence finding hurts SOL scoring more than a low-severity
  * or uncertain finding.
  */
-function computeQcSummary(qcResults) {
+function computeQcSummary(qcResults, clusterState = null, telemetryEvents = [], currentState = null) {
     if (qcResults.length === 0)
         return null;
     let total = 0;
@@ -362,6 +518,11 @@ function computeQcSummary(qcResults) {
         .map(([provider, value]) => ({ provider, ...value }))
         .filter((s) => s.weighted_score > 0)
         .sort((a, b) => b.weighted_score - a.weighted_score || a.provider.localeCompare(b.provider));
+    const repairLoop = computeQcRepairLoopSummary(qcResults, clusterState, telemetryEvents, currentState);
+    const noisyProviders = Array.from(providerBreakdown.entries())
+        .filter(([, counts]) => counts.total >= 2 && counts.unvalidated / counts.total >= 0.5)
+        .map(([provider]) => provider)
+        .sort();
     return {
         total_findings: total,
         blocking_findings: blocking,
@@ -379,6 +540,11 @@ function computeQcSummary(qcResults) {
         category_breakdown: Object.fromEntries(categoryBreakdown),
         recurring_child_signals: recurringChildSignals,
         recurring_provider_signals: recurringProviderSignals,
+        repair_loop: repairLoop,
+        noisy_providers: noisyProviders,
+        has_repair_failures: repairLoop.packets_failed > 0 || repairLoop.status === "medic-referral",
+        unresolved_high_severity: openBySeverity.critical + openBySeverity.high,
+        max_round_exhausted: repairLoop.status === "max-rounds",
     };
 }
 function asRecord(value) {
@@ -386,6 +552,12 @@ function asRecord(value) {
         ? value
         : undefined;
 }
+function asString(value) {
+    return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+    return typeof value === "number" ? value : null;
+}
 function asStringArray(value) {
     if (!Array.isArray(value))
         return [];
@@ -485,7 +657,7 @@ function scoreRun(repoRoot, runId) {
     const score = computeScore(gateResults);
     const diagnosisHints = buildDiagnosisHints(failedGates);
     const routerOutcomes = summarizeRouterOutcomes(artifacts);
-    const qcSummary = computeQcSummary(artifacts.qcResults);
+    const qcSummary = computeQcSummary(artifacts.qcResults, artifacts.clusterState, artifacts.telemetryEvents, artifacts.currentState);
     const clusterId = artifacts.currentState &&
         typeof artifacts.currentState === "object" &&
         !Array.isArray(artifacts.currentState)

package/dist/autoresearch/sol-evaluation-writer.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * SOL evaluation artifact writer.
+ *
+ * Persists machine-readable SOL evaluation records and scorecard snapshots
+ * to deterministic local paths. All writes are append-only / generation-safe:
+ * existing source run evidence is never read or rewritten.
+ *
+ * Output locations:
+ *   - Evaluations:   .polaris/sol/evaluations/<run-id>.json
+ *   - Scorecards:    .polaris/sol/scorecards/<subject>/<scorecard-id>.json
+ *   - Reports:       smartdocs/reports/sol/<run-id>-evaluation-report.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSolEvaluationsDir = getSolEvaluationsDir;
+exports.getSolScorecardsDir = getSolScorecardsDir;
+exports.getSolReportsDir = getSolReportsDir;
+exports.buildEvaluationRecord = buildEvaluationRecord;
+exports.getEvaluationRecordPath = getEvaluationRecordPath;
+exports.writeEvaluationRecord = writeEvaluationRecord;
+exports.getScorecardPath = getScorecardPath;
+exports.writeScorecard = writeScorecard;
+exports.writeScorecardSet = writeScorecardSet;
+exports.getSolMarkdownReportPath = getSolMarkdownReportPath;
+exports.writeSolMarkdownReport = writeSolMarkdownReport;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ──────────────────────────────────────────────
+// Paths
+// ──────────────────────────────────────────────
+const EVALUATIONS_DIR = ".polaris/sol/evaluations";
+const SCORECARDS_DIR = ".polaris/sol/scorecards";
+const REPORTS_DIR = "smartdocs/reports/sol";
+function getSolEvaluationsDir(repoRoot) {
+    return (0, node_path_1.join)(repoRoot, EVALUATIONS_DIR);
+}
+function getSolScorecardsDir(repoRoot) {
+    return (0, node_path_1.join)(repoRoot, SCORECARDS_DIR);
+}
+function getSolReportsDir(repoRoot) {
+    return (0, node_path_1.join)(repoRoot, REPORTS_DIR);
+}
+// ──────────────────────────────────────────────
+// Filename safety
+// ──────────────────────────────────────────────
+function safeFilename(value) {
+    // Prevent path traversal and reserved characters while keeping readability.
+    const sanitized = value
+        .replace(/[\\/]+/g, "-")
+        .replace(/[:\?*"<>|]+/g, "-")
+        .replace(/\.{2,}/g, "-")
+        .replace(/^[.]+/, "")
+        .trim();
+    return sanitized.length > 0 ? sanitized : "unnamed";
+}
+function buildEvaluationRecord(report) {
+    return {
+        schema_version: "1.0",
+        record_type: "sol-evaluation",
+        run_id: report.run_id,
+        cluster_id: report.cluster_id,
+        scored_at: report.scored_at,
+        report,
+        generated_at: new Date().toISOString(),
+    };
+}
+function getEvaluationRecordPath(repoRoot, runId) {
+    return (0, node_path_1.join)(getSolEvaluationsDir(repoRoot), `${safeFilename(runId)}.json`);
+}
+/**
+ * Write a SOL evaluation record under .polaris/sol/evaluations/.
+ * Creates directories as needed. Overwrites only the derived record file.
+ */
+function writeEvaluationRecord(repoRoot, report) {
+    const record = buildEvaluationRecord(report);
+    const dir = getSolEvaluationsDir(repoRoot);
+    if (!(0, node_fs_1.existsSync)(dir))
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const filePath = getEvaluationRecordPath(repoRoot, report.run_id);
+    (0, node_fs_1.writeFileSync)(filePath, JSON.stringify(record, null, 2) + "\n", "utf-8");
+    return { record, path: filePath };
+}
+// ──────────────────────────────────────────────
+// Scorecard snapshots
+// ──────────────────────────────────────────────
+function scorecardSubjectDir(subject) {
+    return subject;
+}
+function getScorecardPath(repoRoot, scorecard) {
+    return (0, node_path_1.join)(getSolScorecardsDir(repoRoot), scorecardSubjectDir(scorecard.subject), `${safeFilename(scorecard.scorecard_id)}.json`);
+}
+/**
+ * Write a single scorecard snapshot under .polaris/sol/scorecards/<subject>/.
+ */
+function writeScorecard(repoRoot, scorecard) {
+    const dir = (0, node_path_1.join)(getSolScorecardsDir(repoRoot), scorecardSubjectDir(scorecard.subject));
+    if (!(0, node_fs_1.existsSync)(dir))
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const filePath = getScorecardPath(repoRoot, scorecard);
+    (0, node_fs_1.writeFileSync)(filePath, JSON.stringify(scorecard, null, 2) + "\n", "utf-8");
+    return filePath;
+}
+/**
+ * Write all scorecards in a SolScorecardSet. Returns the paths written.
+ */
+function writeScorecardSet(repoRoot, scorecardSet) {
+    const paths = [];
+    paths.push(writeScorecard(repoRoot, scorecardSet.foreman));
+    for (const s of scorecardSet.workers)
+        paths.push(writeScorecard(repoRoot, s));
+    for (const s of scorecardSet.providers)
+        paths.push(writeScorecard(repoRoot, s));
+    for (const s of scorecardSet.models)
+        paths.push(writeScorecard(repoRoot, s));
+    for (const s of scorecardSet.routing)
+        paths.push(writeScorecard(repoRoot, s));
+    return paths;
+}
+// ──────────────────────────────────────────────
+// Human-readable SmartDocs report
+// ──────────────────────────────────────────────
+function getSolMarkdownReportPath(repoRoot, runId) {
+    return (0, node_path_1.join)(getSolReportsDir(repoRoot), `${safeFilename(runId)}-evaluation-report.md`);
+}
+/**
+ * Write a rendered Markdown SOL report to smartdocs/reports/sol/.
+ */
+function writeSolMarkdownReport(repoRoot, runId, markdown) {
+    const dir = getSolReportsDir(repoRoot);
+    if (!(0, node_fs_1.existsSync)(dir))
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const filePath = getSolMarkdownReportPath(repoRoot, runId);
+    (0, node_fs_1.writeFileSync)(filePath, markdown, "utf-8");
+    return filePath;
+}

package/dist/autoresearch/sol-evidence-loader.js

@@ -293,9 +293,11 @@ function buildRouterEvidence(artifacts) {
 // QC evidence
 // ──────────────────────────────────────────────
 function buildQcEvidence(artifacts) {
+    const disabledOutcome = artifacts.clusterState?.qc_repair_outcome;
+    const isDisabled = disabledOutcome === "qc-disabled";
     if (artifacts.qcResults.length === 0) {
-        return {
-            availability: "future",
+        const base = {
+            availability: isDisabled ? "unavailable" : "future",
             qc_run_count: 0,
             total_findings: 0,
             blocking_findings: 0,
@@ -307,9 +309,32 @@ function buildQcEvidence(artifacts) {
             qc_penalty: 0,
             blocks_delivery: false,
             open_by_severity: { critical: 0, high: 0, medium: 0, low: 0, info: 0 },
+            provider_breakdown: {},
+            repair_loop: {
+                status: isDisabled ? "not-configured" : "not-run",
+                rounds_completed: 0,
+                max_rounds: 0,
+                packets_compiled: 0,
+                packets_completed: 0,
+                packets_failed: 0,
+                rerun_outcome: null,
+                provider_attempts: {
+                    total: 0,
+                    success: 0,
+                    failure: 0,
+                    fallback: 0,
+                    skipped: 0,
+                    all_providers_failed: false,
+                },
+            },
+            noisy_providers: [],
+            has_repair_failures: false,
+            unresolved_high_severity: 0,
+            max_round_exhausted: false,
         };
+        return base;
     }
-    const summary = (0, score_js_1.computeQcSummary)(artifacts.qcResults);
+    const summary = (0, score_js_1.computeQcSummary)(artifacts.qcResults, artifacts.clusterState, artifacts.telemetryEvents, artifacts.currentState);
     if (!summary) {
         // computeQcSummary only returns null when qcResults is empty; handled above.
         // ponytail: defensive branch to satisfy type narrowing
@@ -326,6 +351,12 @@ function buildQcEvidence(artifacts) {
             qc_penalty: 0,
             blocks_delivery: false,
             open_by_severity: { critical: 0, high: 0, medium: 0, low: 0, info: 0 },
+            provider_breakdown: {},
+            repair_loop: null,
+            noisy_providers: [],
+            has_repair_failures: false,
+            unresolved_high_severity: 0,
+            max_round_exhausted: false,
         };
     }
     return {
@@ -341,6 +372,12 @@ function buildQcEvidence(artifacts) {
         qc_penalty: summary.qc_penalty,
         blocks_delivery: summary.blocks_delivery,
         open_by_severity: { ...summary.open_by_severity },
+        provider_breakdown: { ...summary.provider_breakdown },
+        repair_loop: summary.repair_loop,
+        noisy_providers: [...summary.noisy_providers],
+        has_repair_failures: summary.has_repair_failures,
+        unresolved_high_severity: summary.unresolved_high_severity,
+        max_round_exhausted: summary.max_round_exhausted,
     };
 }
 // ──────────────────────────────────────────────