@clien-ai/mcp 0.13.1 → 0.13.3

package/dist/types/report.js

@@ -12,7 +12,7 @@
  * — see how research.ts handles it.
  */
 import { z } from 'zod';
-import { CONFIDENCE_BASES, CONFIDENCE_LEVELS, EVIDENCE_SUFFICIENCY_LEVELS, HYPOTHESIS_PRIORITIES, HYPOTHESIS_SEMANTICS_VERSION, LEGACY_HYPOTHESIS_SEMANTICS_VERSION, ROBUSTNESS_OUTCOMES, VERDICT_STATUSES, finalClauseCoverageMatchesIntegrity, hasCoherentRobustnessWorking, hypothesisWebReceiptAuthenticates, normalizeFinalHypothesisState, readRobustnessCounts, robustnessWorkingContradictsSummary, } from '../hypothesis-semantics.js';
+import { CONFIDENCE_BASES, CONFIDENCE_LEVELS, EVIDENCE_SUFFICIENCY_LEVELS, HYPOTHESIS_PRIORITIES, HYPOTHESIS_SEMANTICS_VERSION, LEGACY_HYPOTHESIS_SEMANTICS_VERSION, ROBUSTNESS_OUTCOMES, VERDICT_STATUSES, finalClauseCoverageMatchesIntegrity, hasCoherentRobustnessWorking, hypothesisWebReceiptAuthenticates, normalizeFinalHypothesisState, readRobustnessCounts, reportClaimNeedsIndependentMarketAuthority, robustnessWorkingContradictsSummary, sourceAuthenticatesMarketEconomics, } from '../hypothesis-semantics.js';
 // ⚠️ A types module importing from `tools/` reads backwards, and it is deliberate.
 // `content-type-display.ts` imports NOTHING — it is the package's content-type vocabulary, which
 // happens to live beside the two renderers that were its first callers, and the FUL-341 coupling
@@ -21,6 +21,7 @@ import { CONFIDENCE_BASES, CONFIDENCE_LEVELS, EVIDENCE_SUFFICIENCY_LEVELS, HYPOT
 import { CONTENT_TYPE_EXCLUSIONS, CONTENT_TYPE_STATES } from '../tools/content-type-display.js';
 import { parseReceiptId } from '../tools/receipt-children.js';
 import { readSemanticTheme } from './semantic-theme.js';
+import { isDisplaySuitableExcerpt } from '../lib/excerpt-suitability.js';
 export { CONFIDENCE_BASES, CONFIDENCE_LEVELS, EVIDENCE_SUFFICIENCY_LEVELS, HYPOTHESIS_SEMANTICS_VERSION, ROBUSTNESS_OUTCOMES, VERDICT_STATUSES, } from '../hypothesis-semantics.js';
 /**
  * A competitor discovered during the research run.
@@ -690,6 +691,7 @@ export const ReportEvidenceSchema = z
         'source type is genuinely unknown, NOT checked and found benign. ' +
         CONTENT_TYPE_EXCLUSIONS),
     publisherSubjectRelationship: z.enum(['independent', 'self', 'unknown']).optional(),
+    marketEconomicsAuthority: z.enum(['independent', 'commercial_report_seller', 'unknown']).optional(),
 })
     .passthrough();
 /**
@@ -1130,6 +1132,114 @@ export function sanitizeMcpReportTitle(value) {
     const words = latinWords.filter((word) => !/[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u.test(word)).length + cjkCharacters.length;
     return words >= 6 && words <= 12 ? title : 'Report';
 }
+export const MCP_REPORT_DECISION_SPINE_VERSION = 1;
+export const MCP_REPORT_DECISION_ACTION_METHODS = [
+    'target_user_test',
+    'independent_market_evidence',
+];
+export const MCP_REPORT_DECISION_ACTION_PREFIXES = {
+    target_user_test: 'Test ',
+    independent_market_evidence: 'Collect independent market evidence for ',
+};
+export const MCP_REPORT_MIN_EXECUTIVE_SUMMARY_WORDS = 150;
+export const MCP_REPORT_MAX_EXECUTIVE_SUMMARY_WORDS = 250;
+export const MCP_REPORT_MIN_RECOMMENDATIONS = 2;
+export const MCP_REPORT_MAX_RECOMMENDATIONS = 8;
+/** Mirrors the producer's CJK-aware decision-summary counter at this package boundary. */
+export function countMcpReportWords(value) {
+    const cjk = /[぀-ヿ㐀-䶿一-鿿豈-﫿ｦ-ﾟᄀ-ᇿ㄰-㆏가-힣]/gu;
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return 0;
+    const cjkCharacters = trimmed.match(cjk)?.length ?? 0;
+    if (cjkCharacters === 0)
+        return trimmed.split(/\s+/u).length;
+    return cjkCharacters + trimmed.split(/\s+/u).filter((word) => word.replace(cjk, '') !== '').length;
+}
+export const MCP_REPORT_DECISION_SPINE_LABELS = [
+    'Decision:',
+    'Strongest support:',
+    'Strongest contradiction:',
+    'Market and community context:',
+    'Material uncertainty:',
+    'Next learning step:',
+];
+function authenticatesMcpDecisionSpine(record, projectedRows, projectedRecommendations, reconciledIds) {
+    if (record.reportDecisionSpineVersion !== MCP_REPORT_DECISION_SPINE_VERSION || reconciledIds.size === 0)
+        return false;
+    if (typeof record.executiveSummary !== 'string')
+        return false;
+    const summary = record.executiveSummary.trim();
+    if (countMcpReportWords(summary) < MCP_REPORT_MIN_EXECUTIVE_SUMMARY_WORDS ||
+        countMcpReportWords(summary) > MCP_REPORT_MAX_EXECUTIVE_SUMMARY_WORDS)
+        return false;
+    let labelOffset = -1;
+    for (const label of MCP_REPORT_DECISION_SPINE_LABELS) {
+        labelOffset = summary.indexOf(label, labelOffset + 1);
+        if (labelOffset < 0)
+            return false;
+    }
+    const knownIds = new Set();
+    for (const rawRow of projectedRows) {
+        if (rawRow === null || typeof rawRow !== 'object' || Array.isArray(rawRow))
+            return false;
+        const id = rawRow.hypothesisId;
+        if (typeof id !== 'string' || !id.trim() || knownIds.has(id))
+            return false;
+        knownIds.add(id);
+    }
+    if (!Array.isArray(record.recommendations) ||
+        projectedRecommendations !== record.recommendations ||
+        record.recommendations.length < MCP_REPORT_MIN_RECOMMENDATIONS ||
+        record.recommendations.length > MCP_REPORT_MAX_RECOMMENDATIONS)
+        return false;
+    const recommendations = [];
+    for (const rawRecommendation of record.recommendations) {
+        if (rawRecommendation === null || typeof rawRecommendation !== 'object' || Array.isArray(rawRecommendation))
+            return false;
+        const recommendation = rawRecommendation;
+        if (typeof recommendation.action !== 'string' || !recommendation.action.trim())
+            return false;
+        if (!Array.isArray(recommendation.relatedHypotheses) || recommendation.relatedHypotheses.length === 0)
+            return false;
+        const relatedHypotheses = recommendation.relatedHypotheses;
+        if (!relatedHypotheses.every((id) => typeof id === 'string' && knownIds.has(id)))
+            return false;
+        recommendations.push({ action: recommendation.action.trim(), relatedHypotheses });
+    }
+    const rawMethods = record.reportDecisionActionMethods;
+    const rawPrimaryActions = record.reportDecisionPrimaryActions;
+    if (rawMethods === null || typeof rawMethods !== 'object' || Array.isArray(rawMethods) ||
+        rawPrimaryActions === null || typeof rawPrimaryActions !== 'object' || Array.isArray(rawPrimaryActions))
+        return false;
+    const methods = new Map();
+    const primaryActions = new Map();
+    for (const [id, rawMethod] of Object.entries(rawMethods)) {
+        if (!knownIds.has(id) || !MCP_REPORT_DECISION_ACTION_METHODS.includes(rawMethod))
+            return false;
+        methods.set(id, rawMethod);
+    }
+    for (const [id, rawAction] of Object.entries(rawPrimaryActions)) {
+        if (!knownIds.has(id) || typeof rawAction !== 'string' || !rawAction.trim())
+            return false;
+        primaryActions.set(id, rawAction);
+    }
+    if (methods.size !== reconciledIds.size || primaryActions.size !== reconciledIds.size ||
+        [...methods.keys()].some((id) => !reconciledIds.has(id)) ||
+        [...primaryActions.keys()].some((id) => !reconciledIds.has(id)))
+        return false;
+    for (const id of reconciledIds) {
+        const method = methods.get(id);
+        const primaryAction = primaryActions.get(id);
+        const expectedPrefix = method ? MCP_REPORT_DECISION_ACTION_PREFIXES[method] : null;
+        const matchingRecommendations = recommendations.filter((recommendation) => recommendation.relatedHypotheses.length === 1 &&
+            recommendation.relatedHypotheses[0] === id &&
+            recommendation.action === primaryAction);
+        if (!expectedPrefix || !primaryAction?.startsWith(expectedPrefix) || matchingRecommendations.length !== 1)
+            return false;
+    }
+    return true;
+}
 export function projectReportDataForMcp(raw) {
     if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
         return raw;
@@ -1153,6 +1263,9 @@ export function projectReportDataForMcp(raw) {
         value.replace(/[\p{C}\p{Z}\p{Default_Ignorable_Code_Point}]/gu, '').length > 0;
     const hasHighlights = Object.prototype.hasOwnProperty.call(record, 'interviewHighlights');
     const hasHypothesisResults = Object.prototype.hasOwnProperty.call(record, 'hypothesisResults');
+    const hasClaims = Object.prototype.hasOwnProperty.call(record, 'claims');
+    const hasReportClaims = Object.prototype.hasOwnProperty.call(record, 'reportClaims');
+    const hasReportEvidence = Object.prototype.hasOwnProperty.call(record, 'reportEvidence');
     const hasReportTitle = Object.prototype.hasOwnProperty.call(record, 'reportTitle');
     const hasOverview = Object.prototype.hasOwnProperty.call(record, 'marketOverview') ||
         Object.prototype.hasOwnProperty.call(record, 'communityOverview');
@@ -1160,15 +1273,88 @@ export function projectReportDataForMcp(raw) {
     const hasPersonas = Object.prototype.hasOwnProperty.call(record, 'personas');
     const hasForumResearch = Object.prototype.hasOwnProperty.call(record, 'forumResearch');
     const hasHypothesisSemanticsVersion = Object.prototype.hasOwnProperty.call(record, 'hypothesisSemanticsVersion');
+    const hasDecisionSpineMetadata = Object.prototype.hasOwnProperty.call(record, 'reportDecisionSpineVersion') ||
+        Object.prototype.hasOwnProperty.call(record, 'reportDecisionActionMethods') ||
+        Object.prototype.hasOwnProperty.call(record, 'reportDecisionPrimaryActions');
     const methodology = record.methodology;
     const hasRedditNote = methodology !== null &&
         typeof methodology === 'object' &&
         !Array.isArray(methodology) &&
         Object.prototype.hasOwnProperty.call(methodology, 'redditRetrieval');
-    if (!hasHighlights && !hasRedditNote && !hasHypothesisResults && !hasOverview && !hasReportTitle && !hasCrossCutting && !hasPersonas && !hasForumResearch && !hasHypothesisSemanticsVersion)
+    if (!hasHighlights && !hasRedditNote && !hasHypothesisResults && !hasClaims && !hasReportClaims && !hasReportEvidence && !hasOverview && !hasReportTitle && !hasCrossCutting && !hasPersonas && !hasForumResearch && !hasHypothesisSemanticsVersion && !hasDecisionSpineMetadata)
         return raw;
     const projected = { ...record };
+    // These fields authenticate producer-owned repair, but are not report evidence and never cross
+    // the public MCP boundary on either the typed or schema-drift exit.
+    delete projected.reportDecisionSpineVersion;
+    delete projected.reportDecisionActionMethods;
+    delete projected.reportDecisionPrimaryActions;
+    // Source excerpts are immutable evidence in storage, but every MCP channel is a display
+    // surface. Rebuild only the containers which can carry verbatim source text, preserving safe
+    // strings byte-for-byte and omitting an unsafe exact receipt rather than repairing its text.
+    const projectReceipts = (value) => {
+        if (!Array.isArray(value))
+            return undefined;
+        const safeReceipts = [];
+        for (const rawReceipt of value) {
+            const receipt = asProjectionRecord(rawReceipt);
+            if (!receipt || typeof receipt.excerpt !== 'string')
+                return undefined;
+            if (isDisplaySuitableExcerpt(receipt.excerpt))
+                safeReceipts.push({ ...receipt });
+        }
+        return safeReceipts;
+    };
+    const projectSource = (rawSource) => {
+        const source = asProjectionRecord(rawSource);
+        if (!source)
+            return rawSource;
+        const next = { ...source };
+        if (Object.prototype.hasOwnProperty.call(source, 'quote')) {
+            if (typeof source.quote === 'string' && !isDisplaySuitableExcerpt(source.quote)) {
+                // `undefined` is absent on the JSON wire but remains distinguishable from a historical
+                // source which never had a quote, so renderers can downgrade the dependent receipt.
+                next.quote = undefined;
+            }
+            else if (typeof source.quote !== 'string') {
+                delete next.quote;
+            }
+        }
+        if (Object.prototype.hasOwnProperty.call(source, 'receipts')) {
+            const receipts = projectReceipts(source.receipts);
+            if (receipts === undefined)
+                delete next.receipts;
+            else
+                next.receipts = receipts;
+        }
+        return next;
+    };
+    if (hasReportEvidence) {
+        projected.reportEvidence = Array.isArray(record.reportEvidence)
+            ? record.reportEvidence.map(projectSource)
+            : [];
+    }
+    const reportEvidence = Array.isArray(projected.reportEvidence) ? projected.reportEvidence : [];
+    const rejectedMarketEconomics = (Array.isArray(record.reportClaims) ? record.reportClaims : [])
+        .some((rawClaim) => {
+        const claim = asProjectionRecord(rawClaim);
+        if (!claim || !reportClaimNeedsIndependentMarketAuthority(claim.section, claim.text))
+            return false;
+        const state = claim.state;
+        const attestation = asProjectionRecord(claim.attestation);
+        const sourceId = state === 'GROUNDED'
+            ? claim.sourceId
+            : state === 'NO_RECEIPT' && hasProjectionVisibleContent(attestation?.quote)
+                ? attestation?.sourceId
+                : null;
+        const match = typeof sourceId === 'string' ? /^RRCP-s(0|[1-9]\d*)$/.exec(sourceId) : null;
+        const source = match ? asProjectionRecord(reportEvidence[Number(match[1])]) : null;
+        return Boolean(source && !sourceAuthenticatesMarketEconomics(source));
+    });
+    if (rejectedMarketEconomics)
+        delete projected.recommendations;
     let clauseSemanticsFailure = false;
+    const reconciledClauseDowngradeIds = new Set();
     const outerVersion = record.hypothesisSemanticsVersion;
     const outerVersionPresent = hasHypothesisSemanticsVersion;
     const rawHypothesisRows = Array.isArray(record.hypothesisResults) ? record.hypothesisResults : [];
@@ -1192,6 +1378,10 @@ export function projectReportDataForMcp(raw) {
             if (!persona)
                 return rawPersona;
             const nextPersona = { ...persona };
+            if (Array.isArray(persona.sources))
+                nextPersona.sources = persona.sources.map(projectSource);
+            else if (Object.prototype.hasOwnProperty.call(persona, 'sources'))
+                delete nextPersona.sources;
             const portrait = ReportPortraitSchema.safeParse(persona.portrait);
             if (portrait.success)
                 nextPersona.portrait = portrait.data;
@@ -1219,6 +1409,19 @@ export function projectReportDataForMcp(raw) {
                     if (!thread)
                         return rawThread;
                     const nextThread = { ...thread };
+                    if (Array.isArray(thread.relevantQuotes)) {
+                        nextThread.relevantQuotes = thread.relevantQuotes.filter(isDisplaySuitableExcerpt);
+                    }
+                    else if (Object.prototype.hasOwnProperty.call(thread, 'relevantQuotes')) {
+                        delete nextThread.relevantQuotes;
+                    }
+                    if (Object.prototype.hasOwnProperty.call(thread, 'receipts')) {
+                        const receipts = projectReceipts(thread.receipts);
+                        if (receipts === undefined)
+                            delete nextThread.receipts;
+                        else
+                            nextThread.receipts = receipts;
+                    }
                     const theme = typeof thread.title === 'string'
                         ? readSemanticTheme(thread.theme, thread.title)
                         : null;
@@ -1240,6 +1443,105 @@ export function projectReportDataForMcp(raw) {
             delete projected.forumResearch;
         }
     }
+    const projectionSupportsSpan = (excerpt, span) => {
+        if (!isDisplaySuitableExcerpt(excerpt))
+            return false;
+        if (span === undefined || span === null)
+            return true;
+        if (typeof span !== 'string')
+            return false;
+        const normalize = (value) => value
+            .normalize('NFC')
+            .replace(/\s+/gu, ' ')
+            .trim()
+            .toLocaleLowerCase('en-US');
+        const normalizedSpan = normalize(span);
+        return normalizedSpan.length > 0 && normalize(excerpt).includes(normalizedSpan);
+    };
+    const omitClaimReceipt = (claim) => {
+        const next = { ...claim };
+        delete next.sourceId;
+        delete next.receiptId;
+        delete next.quoteSpan;
+        delete next.attestation;
+        return next;
+    };
+    if (hasReportClaims) {
+        projected.reportClaims = Array.isArray(record.reportClaims)
+            ? record.reportClaims.map((rawClaim) => {
+                const claim = asProjectionRecord(rawClaim);
+                if (!claim)
+                    return rawClaim;
+                if (claim.state === 'GROUNDED') {
+                    const hasSourceId = Object.prototype.hasOwnProperty.call(claim, 'sourceId');
+                    const match = typeof claim.sourceId === 'string'
+                        ? /^RRCP-s(0|[1-9]\d*)$/.exec(claim.sourceId)
+                        : null;
+                    const rawSource = match
+                        ? asProjectionRecord(Array.isArray(record.reportEvidence)
+                            ? record.reportEvidence[Number(match[1])]
+                            : undefined)
+                        : null;
+                    if (!hasSourceId && Object.prototype.hasOwnProperty.call(claim, 'quoteSpan')) {
+                        return omitClaimReceipt(claim);
+                    }
+                    if (hasSourceId && (!rawSource || !projectionSupportsSpan(rawSource.quote, claim.quoteSpan))) {
+                        return omitClaimReceipt(claim);
+                    }
+                }
+                else if (claim.state === 'NO_RECEIPT') {
+                    const attestation = asProjectionRecord(claim.attestation);
+                    if (attestation && !isDisplaySuitableExcerpt(attestation.quote)) {
+                        const next = { ...claim };
+                        delete next.attestation;
+                        return next;
+                    }
+                }
+                return { ...claim };
+            })
+            : [];
+    }
+    if (Object.prototype.hasOwnProperty.call(record, 'claims')) {
+        projected.claims = Array.isArray(record.claims)
+            ? record.claims.map((rawClaim) => {
+                const claim = asProjectionRecord(rawClaim);
+                if (!claim || claim.state !== 'GROUNDED')
+                    return rawClaim;
+                const hasSourceId = Object.prototype.hasOwnProperty.call(claim, 'sourceId');
+                const match = typeof claim.sourceId === 'string'
+                    ? /^RCP-p(0|[1-9]\d*)-s(0|[1-9]\d*)$/.exec(claim.sourceId)
+                    : null;
+                const personas = Array.isArray(record.personas) ? record.personas : [];
+                const persona = match ? asProjectionRecord(personas[Number(match[1])]) : null;
+                const sources = Array.isArray(persona?.sources) ? persona.sources : [];
+                const source = match ? asProjectionRecord(sources[Number(match[2])]) : null;
+                if (!hasSourceId && Object.prototype.hasOwnProperty.call(claim, 'quoteSpan')) {
+                    return omitClaimReceipt(claim);
+                }
+                if (hasSourceId && !source)
+                    return omitClaimReceipt(claim);
+                if (!source)
+                    return { ...claim };
+                const receipts = Array.isArray(source.receipts) ? source.receipts : [];
+                const hasReceiptId = Object.prototype.hasOwnProperty.call(claim, 'receiptId');
+                if (hasReceiptId) {
+                    const matches = receipts.filter((rawReceipt) => asProjectionRecord(rawReceipt)?.receiptId === claim.receiptId);
+                    const receipt = matches.length === 1 ? asProjectionRecord(matches[0]) : null;
+                    return receipt && projectionSupportsSpan(receipt.excerpt, claim.quoteSpan)
+                        ? { ...claim }
+                        : omitClaimReceipt(claim);
+                }
+                if (typeof source.quote === 'string' &&
+                    !projectionSupportsSpan(source.quote, claim.quoteSpan)) {
+                    return omitClaimReceipt(claim);
+                }
+                if (claim.quoteSpan !== undefined && typeof source.quote !== 'string') {
+                    return omitClaimReceipt(claim);
+                }
+                return { ...claim };
+            })
+            : [];
+    }
     const projectOverviewRef = (rawRef) => {
         if (rawRef === null || typeof rawRef !== 'object' || Array.isArray(rawRef))
             return null;
@@ -1288,6 +1590,32 @@ export function projectReportDataForMcp(raw) {
                 const safeRef = projectOverviewRef(rawRef);
                 if (!safeRef)
                     continue;
+                if (safeRef.kind === 'report_evidence') {
+                    const match = typeof safeRef.sourceId === 'string'
+                        ? /^RRCP-s(0|[1-9]\d*)$/.exec(safeRef.sourceId)
+                        : null;
+                    const source = match
+                        ? asProjectionRecord(Array.isArray(projected.reportEvidence)
+                            ? projected.reportEvidence[Number(match[1])]
+                            : undefined)
+                        : null;
+                    if (!source || !projectionSupportsSpan(source.quote, claim.span))
+                        continue;
+                }
+                if (safeRef.kind === 'forum_receipt') {
+                    const matches = (Array.isArray(asProjectionRecord(projected.forumResearch)?.threads)
+                        ? asProjectionRecord(projected.forumResearch).threads
+                        : []).flatMap((rawThread) => {
+                        const thread = asProjectionRecord(rawThread);
+                        return (Array.isArray(thread?.receipts) ? thread.receipts : []).filter((rawReceipt) => {
+                            const receipt = asProjectionRecord(rawReceipt);
+                            return receipt !== null && receipt.receiptId === safeRef.receiptId &&
+                                projectionSupportsSpan(receipt.excerpt, claim.span);
+                        });
+                    });
+                    if (matches.length !== 1)
+                        continue;
+                }
                 const refKey = safeRef.kind === 'report_evidence'
                     ? `${safeRef.kind}:${safeRef.sourceId}`
                     : safeRef.kind === 'forum_receipt'
@@ -1303,13 +1631,13 @@ export function projectReportDataForMcp(raw) {
             return [{
                     span: claim.span,
                     claimType: claim.claimType,
-                    evidenceRefsTruncated: rawEvidenceRefs.length > MCP_OVERVIEW_REF_CAP,
+                    evidenceRefsTruncated: claim.evidenceRefsTruncated === true || rawEvidenceRefs.length > MCP_OVERVIEW_REF_CAP,
                     evidenceRefs,
                 }];
         });
         projected[key] = {
             text: overviewRecord.text,
-            claimSpansTruncated: overviewRecord.claimSpans.length > MCP_OVERVIEW_SPAN_CAP,
+            claimSpansTruncated: overviewRecord.claimSpansTruncated === true || overviewRecord.claimSpans.length > MCP_OVERVIEW_SPAN_CAP,
             claimSpans,
         };
     }
@@ -1330,22 +1658,24 @@ export function projectReportDataForMcp(raw) {
         const resolvesCrossCuttingRef = (ref) => {
             if (ref.kind === 'report_evidence') {
                 const match = /^RRCP-s(0|[1-9]\d*)$/.exec(ref.sourceId ?? '');
-                const source = match && asProjectionRecord(Array.isArray(record.reportEvidence)
-                    ? record.reportEvidence[Number(match[1])]
+                const source = match && asProjectionRecord(Array.isArray(projected.reportEvidence)
+                    ? projected.reportEvidence[Number(match[1])]
                     : undefined);
                 return Boolean(source &&
                     safeProjectionUrl(source.url) &&
+                    (!Object.prototype.hasOwnProperty.call(source, 'quote') ||
+                        isDisplaySuitableExcerpt(source.quote)) &&
                     (source.section === 'market' || source.section === 'competitor' || source.section === 'summary'));
             }
             if (ref.kind === 'forum_receipt') {
-                const matches = (Array.isArray(asProjectionRecord(record.forumResearch)?.threads)
-                    ? asProjectionRecord(record.forumResearch).threads
+                const matches = (Array.isArray(asProjectionRecord(projected.forumResearch)?.threads)
+                    ? asProjectionRecord(projected.forumResearch).threads
                     : []).flatMap((rawThread) => {
                     const thread = asProjectionRecord(rawThread);
                     return (Array.isArray(thread?.receipts) ? thread.receipts : []).filter((rawReceipt) => {
                         const receipt = asProjectionRecord(rawReceipt);
                         return Boolean(receipt && receipt.receiptId === ref.receiptId &&
-                            hasProjectionVisibleContent(receipt.excerpt));
+                            isDisplaySuitableExcerpt(receipt.excerpt));
                     });
                 });
                 return matches.length === 1;
@@ -1493,12 +1823,23 @@ export function projectReportDataForMcp(raw) {
                     ? { ...safeRow, final: { version: HYPOTHESIS_SEMANTICS_VERSION } }
                     : safeRow;
                 const normalized = normalizeFinalHypothesisState(rowForNormalization);
-                if (semanticsMismatch ||
+                const isCoherentIntentionalDowngrade = Boolean(!semanticsMismatch &&
+                    !clauseIntegrityMismatch &&
+                    normalized?.clauseCoverage !== undefined &&
+                    normalized.clauseCoverage !== 'invalid' &&
+                    normalized.clauseCoverage !== 'complete' &&
+                    normalized.originalVerdict !== normalized.verdict);
+                if (isCoherentIntentionalDowngrade) {
+                    if (typeof safeRow.hypothesisId === 'string' && safeRow.hypothesisId.trim()) {
+                        reconciledClauseDowngradeIds.add(safeRow.hypothesisId);
+                    }
+                    else {
+                        clauseSemanticsFailure = true;
+                    }
+                }
+                else if (semanticsMismatch ||
                     clauseIntegrityMismatch ||
                     normalized?.clauseCoverage === 'invalid' ||
-                    (normalized?.clauseCoverage !== undefined &&
-                        normalized.clauseCoverage !== 'complete' &&
-                        normalized.originalVerdict !== normalized.verdict) ||
                     (requiresClauseIntegrity && normalized === null))
                     clauseSemanticsFailure = true;
                 if (normalized)
@@ -1552,6 +1893,9 @@ export function projectReportDataForMcp(raw) {
             return safeRow;
         });
     }
+    if (reconciledClauseDowngradeIds.size > 0 &&
+        !authenticatesMcpDecisionSpine(record, Array.isArray(projected.hypothesisResults) ? projected.hypothesisResults : [], projected.recommendations, reconciledClauseDowngradeIds))
+        clauseSemanticsFailure = true;
     if (clauseSemanticsFailure) {
         projected.executiveSummary = 'This run did not establish every material part of at least one hypothesis. Treat the affected hypotheses as unresolved.';
         projected.verdictSummary = projected.executiveSummary;