mirror of
https://github.com/morluto/rea.git
synced 2026-11-16 11:43:20 +00:00
* fix: retain address context cleanup failures * fix!: preserve address context input errors BREAKING CHANGE: Strict clients that cached the previous full inspect_address_context output schema must refresh tools/list and accept the typed error field on unavailable facets. * test: use session contract for address context * fix!: preserve address context resource recovery BREAKING CHANGE: Clients validating unavailable context facets against a cached strict full output schema must refresh tools/list to accept resource_constraint errors. * fix: expose authenticated records refused by the evidence ledger (#8426) * fix: preserve completed evidence on retention refusal * fix: preserve context when unretained evidence exceeds delivery limits * fix(mcp): recover oversized context from session evidence * fix(evidence): preserve completed atomic write results * fix: retain completed results when source publication fails * test: cover bounded recovery with unknown retention * fix(evidence): preserve recovery identity and finalization facts * fix(evidence): clarify retention of omitted observations * test(evidence): compare omission guidance with its owner * fix(evidence): preserve completed composed workflows * fix(evidence): clarify unretained recovery export * test(evidence): cover mixed recovery guidance * fix(evidence): preserve caller scope in secondary failures * refactor(evidence): remove superseded cleanup projection * test(evidence): align recovery checks with owners * fix: preserve cleanup on partial recovery limits * test: use owners for diagnostic wording * fix: admit completed analysis before evidence construction * fix: preserve selected paths when reusing evidence * fix(cli): preserve caller path in unretained evidence * fix(evidence): preserve recovery metadata and admission bounds * refactor: consolidate evidence closure imports * style(test): format CLI help default annotations (#9280) * test(mcp): keep recovery checks focused on contract facts * fix(evidence): preserve feature trace replay revision * test: align evidence recovery checks with ownership * test: align partial recovery and cleanup diagnostics * fix(evidence): preserve nested partials during cleanup * fix(evidence): respect outer recovery ownership * fix(capture): discard rejected nested observations * test(frida): assert inline evidence recovery --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com>
91 lines
3.0 KiB
TypeScript
91 lines
3.0 KiB
TypeScript
import {
|
|
createEvidence,
|
|
evidenceEnvelopeForAdmission,
|
|
type Evidence,
|
|
type EvidenceCreationOptions,
|
|
type EvidenceLocation,
|
|
type EvidenceProvider,
|
|
type EvidenceSubjectTarget,
|
|
} from "./evidence.js";
|
|
import type { AnalysisProfileCommitment } from "./analysisProfile.js";
|
|
import type { JsonValue } from "./jsonValue.js";
|
|
import type { RelationshipCoverage } from "./relationshipCoverage.js";
|
|
|
|
/** Provider observations that can be committed to Evidence. */
|
|
export interface AnalysisObservation {
|
|
readonly result: JsonValue;
|
|
readonly rawResult: JsonValue | null;
|
|
readonly provider: EvidenceProvider;
|
|
readonly analysisProfile?: AnalysisProfileCommitment;
|
|
readonly limitations: readonly string[];
|
|
/** Provider-owned completeness assessment for caller/callee observations. */
|
|
readonly relationshipCoverage?: RelationshipCoverage;
|
|
readonly locations: readonly EvidenceLocation[];
|
|
/** Atomic source records supplied by the producer, with links derived from their identities. */
|
|
readonly sourceEvidence?: readonly Evidence[];
|
|
/**
|
|
* Missing means the selected operation's default subject should be bound by
|
|
* its caller. Explicit null means the observation has no file subject.
|
|
*/
|
|
readonly subject?: EvidenceSubjectTarget | null;
|
|
}
|
|
|
|
/** Build the single borrowed observation used for admission and commitment. */
|
|
const analysisExecutionEvidenceInput = (
|
|
operation: string,
|
|
input: unknown,
|
|
execution: AnalysisObservation,
|
|
confidence: "observed" | "derived",
|
|
) => ({
|
|
operation,
|
|
parameters: input,
|
|
result: execution.result,
|
|
rawResult: execution.rawResult,
|
|
limitations: execution.limitations,
|
|
...(execution.analysisProfile === undefined
|
|
? {}
|
|
: { analysisProfile: execution.analysisProfile }),
|
|
...(execution.relationshipCoverage === undefined
|
|
? {}
|
|
: { relationshipCoverage: execution.relationshipCoverage }),
|
|
locations: execution.locations,
|
|
confidence,
|
|
});
|
|
|
|
/** Borrow the Evidence envelope with links left empty for incremental admission accounting. */
|
|
export const analysisExecutionEnvelopeForAdmission = (
|
|
operation: string,
|
|
input: unknown,
|
|
execution: AnalysisObservation,
|
|
confidence: "observed" | "derived",
|
|
) =>
|
|
evidenceEnvelopeForAdmission(
|
|
execution.subject ?? undefined,
|
|
execution.provider,
|
|
analysisExecutionEvidenceInput(operation, input, execution, confidence),
|
|
);
|
|
|
|
/** Commit identical facts on success and when retaining a completed observation after cancellation. */
|
|
export const createAnalysisExecutionEvidence = (
|
|
operation: string,
|
|
input: unknown,
|
|
execution: AnalysisObservation,
|
|
confidence: "observed" | "derived",
|
|
options?: EvidenceCreationOptions,
|
|
): Evidence =>
|
|
createEvidence(
|
|
execution.subject ?? undefined,
|
|
execution.provider,
|
|
{
|
|
...analysisExecutionEvidenceInput(
|
|
operation,
|
|
input,
|
|
execution,
|
|
confidence,
|
|
),
|
|
evidenceLinks:
|
|
execution.sourceEvidence?.map(({ evidence_id }) => evidence_id) ?? [],
|
|
},
|
|
options,
|
|
);
|