@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/sdk/context-packing.d.ts

@@ -8,18 +8,18 @@
 /** Detail levels a context candidate may occupy inside a bounded packet. */
 export type ContextProjectionLevel = "identity" | "summary" | "full";
 /** Stable intent-keyed policies for risk, diversity, and safety-aware packing. */
-export declare const CONTEXT_PACKING_PROFILES: {
-readonly balanced: {
-readonly redundancyPenalty: 0.35;
-readonly uncertaintyPenalty: 0.2;
+export declare const CONTEXT_PACKING_PROFILES:{
+readonly balanced:{
+readonly redundancyPenalty:0.35;
+readonly uncertaintyPenalty:0.2;
 };
-readonly context: {
-readonly redundancyPenalty: 0.45;
-readonly uncertaintyPenalty: 0.15;
+readonly context:{
+readonly redundancyPenalty:0.45;
+readonly uncertaintyPenalty:0.15;
 };
-readonly next: {
-readonly redundancyPenalty: 0.25;
-readonly uncertaintyPenalty: 0.3;
+readonly next:{
+readonly redundancyPenalty:0.25;
+readonly uncertaintyPenalty:0.3;
 };
 };
 /** Built-in task-set profiles selected from the triggering command intent. */
@@ -27,83 +27,83 @@ export type ContextPackingProfile = keyof typeof CONTEXT_PACKING_PROFILES;
 /** Token costs for the monotone projection levels of one candidate. */
 export interface ContextProjectionCosts {
 /** Stable identity-only representation cost. */
-identity: number;
+identity:number;
 /** Compact summary representation cost. */
-summary: number;
+summary:number;
 /** Full representation cost. */
-full: number;
+full:number;
 }
 /** One ranked candidate offered to the context packet optimizer. */
 export interface ContextPackingCandidate<TItem> {
 /** Stable candidate identifier. */
-id: string;
+id:string;
 /** Caller-owned value returned unchanged for selected candidates. */
-item: TItem;
+item:TItem;
 /** One-based relevance rank; lower is better. */
-rank: number;
+rank:number;
 /** Normalized relevance score. */
-score: number;
+score:number;
 /** Projection-specific token estimates. */
-token_costs: ContextProjectionCosts;
+token_costs:ContextProjectionCosts;
 /** Candidates sharing a cluster compete through a redundancy penalty. */
-cluster?: string;
+cluster?:string;
 /** Required anchors are admitted before optional candidates. */
-required?: boolean;
+required?:boolean;
 /** Optional credible-width estimate used for risk-adjusted value. */
-uncertainty?: number;
+uncertainty?:number;
 /** Optional lineage identity used to suppress superseded duplicates. */
-lineage?: string;
+lineage?:string;
 }
 /** One selected candidate and the projection depth bought for it. */
 export interface PackedContextCandidate<TItem> extends ContextPackingCandidate<TItem> {
 /** Projection depth selected by the packer. */
-projection: ContextProjectionLevel;
+projection:ContextProjectionLevel;
 /** Tokens charged to the packet. */
-tokens: number;
+tokens:number;
 /** Risk- and redundancy-adjusted value used for selection. */
-marginal_value: number;
+marginal_value:number;
 }
 /** Accounting and completeness metadata for one packed context packet. */
 export interface ContextPackingReport<TItem> {
 /** Selected candidates in deterministic relevance order. */
-included: PackedContextCandidate<TItem>[];
+included:PackedContextCandidate<TItem>[];
 /** Ranked candidate identifiers omitted after projection degradation. */
-omitted_ids: string[];
+omitted_ids:string[];
 /** Explicit packet token budget. */
-token_budget: number;
+token_budget:number;
 /** Estimated tokens consumed by selected projections. */
-used_tokens: number;
+used_tokens:number;
 /** Tokens left unspent. */
-remaining_tokens: number;
+remaining_tokens:number;
 /** True when every candidate fit at full detail. */
-complete: boolean;
+complete:boolean;
 /** Whether selection inspected every optional candidate before its deadline. */
-selection_complete: boolean;
+selection_complete:boolean;
 /** Machine-readable reason selection stopped. */
-termination_reason: "exhausted" | "latency_budget";
+termination_reason:"exhausted" | "latency_budget";
 /** Candidate comparisons completed by the bounded selector. */
-evaluated_candidates: number;
+evaluated_candidates:number;
 /** Explicit selection latency budget, or null when unbounded. */
-latency_budget_ms: number | null;
+latency_budget_ms:number | null;
 /** Stable task-set profile disclosed to downstream evaluation. */
-profile: ContextPackingProfile;
+profile:ContextPackingProfile;
 /** Projection degradation order used by the optimizer. */
-degradation_ladder: ContextProjectionLevel[];
+degradation_ladder:ContextProjectionLevel[];
 }
 /** Options controlling deterministic packet selection. */
 export interface PackContextCandidatesOptions {
 /** Maximum estimated tokens available to the packet. */
-tokenBudget: number;
+tokenBudget:number;
 /** Task-set profile disclosed in the result envelope. */
-profile?: ContextPackingProfile;
+profile?:ContextPackingProfile;
 /** Penalty applied when a cluster or lineage is already represented. */
-redundancyPenalty?: number;
+redundancyPenalty?:number;
 /** Risk-aversion coefficient applied to candidate uncertainty. */
-uncertaintyPenalty?: number;
+uncertaintyPenalty?:number;
 /** Maximum selector wall-clock time; required anchors remain mask-immune. */
-latencyBudgetMs?: number;
+latencyBudgetMs?:number;
 /** Monotonic clock override for deterministic hosts and tests. */
-readClock?: () => number;
+readClock?:() => number;
 }
 /**
  * Packs ranked candidates under an explicit token budget. Required anchors are
@@ -111,4 +111,4 @@ readClock?: () => number;
  * selected rows are upgraded from identity to summary to full detail. This
  * guarantees projection degradation happens before omission.
  */
-export declare function packContextCandidates<TItem>(candidates: readonly ContextPackingCandidate<TItem>[], options: PackContextCandidatesOptions): ContextPackingReport<TItem>;
+export declare function packContextCandidates<TItem>(candidates:readonly ContextPackingCandidate<TItem>[],options:PackContextCandidatesOptions):ContextPackingReport<TItem>;

package/dist/sdk/context-relevance.d.ts

@@ -4,294 +4,294 @@ import type { HistoryEventClass } from "../core/history/event-classification.js"
 import { type PmReadOutputResult } from "./read-output-contracts.js";
 import type { PmContextIntentReceipt } from "./context-intent-contracts.js";
 /** Canonical signal keys understood by the built-in relevance model. */
-export declare const CONTEXT_RELEVANCE_SIGNAL_NAMES: readonly ["structural", "recency", "activity_density", "graph_proximity", "claim_focus", "priority_pressure", "risk_pressure", "deadline_pressure", "knowledge_density", "author_affinity", "usage_affinity", "semantic_similarity"];
+export declare const CONTEXT_RELEVANCE_SIGNAL_NAMES:readonly ["structural","recency","activity_density","graph_proximity","claim_focus","priority_pressure","risk_pressure","deadline_pressure","knowledge_density","author_affinity","usage_affinity","semantic_similarity"];
 /** A normalized signal consumed by the built-in context relevance scorer. */
 export type ContextRelevanceSignalName = (typeof CONTEXT_RELEVANCE_SIGNAL_NAMES)[number];
 /** Normalized candidate features; omitted signals are excluded from weighting. */
-export type ContextRelevanceSignals = Partial<Record<Exclude<ContextRelevanceSignalName, "structural">, number>>;
+export type ContextRelevanceSignals = Partial<Record<Exclude<ContextRelevanceSignalName,"structural">,number>>;
 /** Authoritative coordinate and fallback that produced an item's recency. */
 export interface ContextRecencyEvidence {
 /** Source selected by the canonical fallback ladder. */
-source: "substantive_history" | "release_cohort" | "created_at";
+source:"substantive_history" | "release_cohort" | "created_at";
 /** ISO coordinate used for deterministic recency ordering. */
-coordinate: string;
+coordinate:string;
 /** Immutable operation selected from history when source is substantive_history. */
-history_op?: string;
+history_op?:string;
 /** Declared class selected from history when source is substantive_history. */
-event_class?: HistoryEventClass;
+event_class?:HistoryEventClass;
 }
 /** Per-signal provenance exposed by explained relevance results. */
 export interface ContextSignalProvenance {
 /** Evidence for the canonical temporal component. */
-recency: ContextRecencyEvidence;
+recency:ContextRecencyEvidence;
 }
 /** A project-management object and its derived relevance signals. */
 export interface ContextRelevanceCandidate<TItem> {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports item for this contract. */
-item: TItem;
+item:TItem;
 /** Value that configures or reports signals for this contract. */
-signals?: ContextRelevanceSignals;
+signals?:ContextRelevanceSignals;
 /** Authoritative source details for explainable derived signals. */
-signal_provenance?: ContextSignalProvenance;
+signal_provenance?:ContextSignalProvenance;
 }
 /** Item candidate whose built-in metadata derivation always supplies signals. */
 export interface ItemContextRelevanceCandidate extends ContextRelevanceCandidate<ItemMetadata> {
 /** Complete built-in derivation result, with unavailable signals omitted by value. */
-signals: ContextRelevanceSignals;
+signals:ContextRelevanceSignals;
 /** Built-in recency derivation always discloses its source. */
-signal_provenance: ContextSignalProvenance;
+signal_provenance:ContextSignalProvenance;
 }
 /** Inputs that make item-signal derivation deterministic and host-configurable. */
 export interface BuildItemContextRelevanceCandidatesOptions {
 /** Workspace lifecycle registry, including custom in-progress aliases. */
-statusRegistry: RuntimeStatusRegistry;
+statusRegistry:RuntimeStatusRegistry;
 /** Stable clock used for deadline pressure. */
-now: string;
+now:string;
 /** Optional caller identity used for assignment affinity. */
-author?: string;
+author?:string;
 /** Optional derived served-then-used affinity by item id. */
-usageAffinity?: Readonly<Record<string, number>>;
+usageAffinity?:Readonly<Record<string,number>>;
 /** Optional caller-derived semantic similarity by item id. */
-semanticSimilarity?: Readonly<Record<string, number>>;
+semanticSimilarity?:Readonly<Record<string,number>>;
 /** Optional index-derived activity density by item id. */
-activityDensity?: Readonly<Record<string, number>>;
+activityDensity?:Readonly<Record<string,number>>;
 /** Optional index-derived graph proximity by item id. */
-graphProximity?: Readonly<Record<string, number>>;
+graphProximity?:Readonly<Record<string,number>>;
 /** Optional host-derived claim or focus affinity by item id. */
-claimFocus?: Readonly<Record<string, number>>;
+claimFocus?:Readonly<Record<string,number>>;
 /** Optional index-derived knowledge density by item id. */
-knowledgeDensity?: Readonly<Record<string, number>>;
+knowledgeDensity?:Readonly<Record<string,number>>;
 /** Optional history-derived author affinity by item id. */
-authorAffinity?: Readonly<Record<string, number>>;
+authorAffinity?:Readonly<Record<string,number>>;
 /** Latest substantive history evidence keyed by item id. */
-recencyEvidence?: Readonly<Record<string, ContextRecencyEvidence>>;
+recencyEvidence?:Readonly<Record<string,ContextRecencyEvidence>>;
 }
 /**
  * Derive the canonical metadata signals consumed by `pm context` and `pm next`.
  * Extensions can pair this with {@link scoreContextCandidatesWithActiveExtensions}
  * to reproduce built-in ranking without private imports or subprocesses.
  */
-export declare function buildItemContextRelevanceCandidates(items: readonly ItemMetadata[], options: BuildItemContextRelevanceCandidatesOptions): ItemContextRelevanceCandidate[];
+export declare function buildItemContextRelevanceCandidates(items:readonly ItemMetadata[],options:BuildItemContextRelevanceCandidatesOptions):ItemContextRelevanceCandidate[];
 /** Per-signal weighted contributions used to explain a ranked result. */
-export type ContextRelevanceContributions = Record<string, number>;
+export type ContextRelevanceContributions = Record<string,number>;
 /** One ranked candidate with deterministic score and explanation metadata. */
 export interface RankedContextCandidate<TItem> extends ContextRelevanceCandidate<TItem> {
 /** Value that configures or reports baseline rank for this contract. */
-baseline_rank: number;
+baseline_rank:number;
 /** Value that configures or reports rank for this contract. */
-rank: number;
+rank:number;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 /** Value that configures or reports contributions for this contract. */
-contributions: ContextRelevanceContributions;
+contributions:ContextRelevanceContributions;
 }
 /** Complete output from a context relevance scorer. */
 export interface ContextRelevanceReport<TItem> {
 /** Value that configures or reports model for this contract. */
-model: string;
+model:string;
 /** Value that configures or reports available signals for this contract. */
-available_signals: ContextRelevanceSignalName[];
+available_signals:ContextRelevanceSignalName[];
 /** Value that configures or reports ranked for this contract. */
-ranked: RankedContextCandidate<TItem>[];
+ranked:RankedContextCandidate<TItem>[];
 /** Value that configures or reports warnings for this contract. */
-warnings?: string[];
+warnings?:string[];
 }
 /** Minimal custom score returned by a replacement or wrapper scorer. */
 export interface ContextRelevanceCustomScore {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 }
 /** Input provided to a custom scorer, including the deterministic default. */
 export interface ContextRelevanceScorerInput<TItem> {
 /** Value that configures or reports candidates for this contract. */
-candidates: readonly ContextRelevanceCandidate<TItem>[];
+candidates:readonly ContextRelevanceCandidate<TItem>[];
 /** Fallback report used when callers do not provide an override. */
-default_report: ContextRelevanceReport<TItem>;
+default_report:ContextRelevanceReport<TItem>;
 }
 /** Replaceable package/extension scorer contract. */
-export type ContextRelevanceScorer<TItem> = (input: ContextRelevanceScorerInput<TItem>) => readonly ContextRelevanceCustomScore[] | Promise<readonly ContextRelevanceCustomScore[]>;
+export type ContextRelevanceScorer<TItem> = (input:ContextRelevanceScorerInput<TItem>) => readonly ContextRelevanceCustomScore[] | Promise<readonly ContextRelevanceCustomScore[]>;
 /** Options for the built-in or replaceable context relevance scorer. */
 export interface ScoreContextCandidatesOptions<TItem> {
 /** Value that configures or reports weights for this contract. */
-weights?: Partial<Record<ContextRelevanceSignalName, number>>;
+weights?:Partial<Record<ContextRelevanceSignalName,number>>;
 /** Value that configures or reports scorer for this contract. */
-scorer?: ContextRelevanceScorer<TItem>;
+scorer?:ContextRelevanceScorer<TItem>;
 }
 /** Governed extension service used to replace or wrap context ranking. */
-export declare const CONTEXT_RELEVANCE_SERVICE: "context_relevance";
+export declare const CONTEXT_RELEVANCE_SERVICE:"context_relevance";
 /** Command surface requesting an active extension relevance override. */
 export type ContextRelevanceSurface = "context" | "next";
 /** Score candidates with pm's deterministic weighted model. Candidate order is the structural baseline and remains unchanged when no advanced signals exist. */
-export declare function defaultScoreContextCandidates<TItem>(candidates: readonly ContextRelevanceCandidate<TItem>[], options?: Pick<ScoreContextCandidatesOptions<TItem>, "weights">): ContextRelevanceReport<TItem>;
+export declare function defaultScoreContextCandidates<TItem>(candidates:readonly ContextRelevanceCandidate<TItem>[],options?:Pick<ScoreContextCandidatesOptions<TItem>,"weights">):ContextRelevanceReport<TItem>;
 /** Score candidates with the default model or a validated replacement/wrapper. */
-export declare function scoreContextCandidates<TItem>(candidates: readonly ContextRelevanceCandidate<TItem>[], options?: ScoreContextCandidatesOptions<TItem>): Promise<ContextRelevanceReport<TItem>>;
+export declare function scoreContextCandidates<TItem>(candidates:readonly ContextRelevanceCandidate<TItem>[],options?:ScoreContextCandidatesOptions<TItem>):Promise<ContextRelevanceReport<TItem>>;
 /** Score command candidates through the public default model and then the active governed `context_relevance` service override, when one is registered. */
-export declare function scoreContextCandidatesWithActiveExtensions<TItem>(surface: ContextRelevanceSurface, candidates: readonly ContextRelevanceCandidate<TItem>[], options?: Pick<ScoreContextCandidatesOptions<TItem>, "weights">): Promise<ContextRelevanceReport<TItem>>;
+export declare function scoreContextCandidatesWithActiveExtensions<TItem>(surface:ContextRelevanceSurface,candidates:readonly ContextRelevanceCandidate<TItem>[],options?:Pick<ScoreContextCandidatesOptions<TItem>,"weights">):Promise<ContextRelevanceReport<TItem>>;
 /** Input for rank-aware context/next quality evaluation. */
 export interface ContextRankingEvaluationInput {
 /** Value that configures or reports ranked ids for this contract. */
-ranked_ids: string[];
+ranked_ids:string[];
 /** Value that configures or reports judgments for this contract. */
-judgments: Record<string, number>;
+judgments:Record<string,number>;
 /** Value that configures or reports required ids for this contract. */
-required_ids?: string[];
+required_ids?:string[];
 /** Value that configures or reports continuity ids for this contract. */
-continuity_ids?: string[];
+continuity_ids?:string[];
 /** Value that configures or reports actual tokens for this contract. */
-actual_tokens: number;
+actual_tokens:number;
 /** Value that configures or reports token budget for this contract. */
-token_budget: number;
+token_budget:number;
 }
 /** Rank-quality, continuity, recall, and token-budget metrics for one scenario. */
 export interface ContextRankingEvaluation {
 /** Value that configures or reports ndcg for this contract. */
-ndcg: number;
+ndcg:number;
 /** Value that configures or reports reciprocal rank for this contract. */
-reciprocal_rank: number;
+reciprocal_rank:number;
 /** Value that configures or reports required recall for this contract. */
-required_recall: number;
+required_recall:number;
 /** Value that configures or reports continuity coverage for this contract. */
-continuity_coverage: number;
+continuity_coverage:number;
 /** Value that configures or reports token budget adherence for this contract. */
-token_budget_adherence: number;
+token_budget_adherence:number;
 /** Value that configures or reports within token budget for this contract. */
-within_token_budget: boolean;
+within_token_budget:boolean;
 }
 /** Flexible read options accepted by context evaluation scenarios. */
 export interface ContextEvaluationReadOptions {
 /** Value that configures or reports explain ranking for this contract. */
-explainRanking?: boolean;
-[key: string]: unknown;
+explainRanking?:boolean;
+[key:string]:unknown;
 }
 /** Minimal item identity consumed by the context evaluation runner. */
 export interface ContextEvaluationResultItem {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 }
 /** Optional scorer attribution returned by an evaluated read primitive. */
 export interface ContextEvaluationResultRanking {
 /** Value that configures or reports items for this contract. */
-items?: Array<{
-id: string;
-contributions: ContextRelevanceContributions;
+items?:Array<{
+id:string;
+contributions:ContextRelevanceContributions;
 }>;
 }
 /** Structural context result consumed by the evaluation runner. */
 export interface ContextEvaluationContextResult {
 /** Value that configures or reports high level for this contract. */
-high_level?: ContextEvaluationResultItem[];
+high_level?:ContextEvaluationResultItem[];
 /** Value that configures or reports low level for this contract. */
-low_level?: ContextEvaluationResultItem[];
+low_level?:ContextEvaluationResultItem[];
 /** Value that configures or reports blocked fallback for this contract. */
-blocked_fallback?: ContextEvaluationResultItem[];
+blocked_fallback?:ContextEvaluationResultItem[];
 /** Value that configures or reports ranking for this contract. */
-ranking?: ContextEvaluationResultRanking;
+ranking?:ContextEvaluationResultRanking;
 /** Intent receipt retained so whole-result omissions cannot be graded. */
-context_intent?: Pick<PmContextIntentReceipt, "result_omitted">;
-[key: string]: unknown;
+context_intent?:Pick<PmContextIntentReceipt,"result_omitted">;
+[key:string]:unknown;
 }
 /** Structural next result consumed by the evaluation runner. */
 export interface ContextEvaluationNextResult {
 /** Value that configures or reports recommended for this contract. */
-recommended?: ContextEvaluationResultItem | null;
+recommended?:ContextEvaluationResultItem | null;
 /** Value that configures or reports ready for this contract. */
-ready?: ContextEvaluationResultItem[];
+ready?:ContextEvaluationResultItem[];
 /** Value that configures or reports ranking for this contract. */
-ranking?: ContextEvaluationResultRanking;
+ranking?:ContextEvaluationResultRanking;
 /** Intent receipt retained so whole-result omissions cannot be graded. */
-context_intent?: Pick<PmContextIntentReceipt, "result_omitted">;
-[key: string]: unknown;
+context_intent?:Pick<PmContextIntentReceipt,"result_omitted">;
+[key:string]:unknown;
 }
-type ContextEvaluationContextFields = Pick<ContextEvaluationContextResult, "high_level" | "low_level" | "blocked_fallback" | "ranking" | "context_intent">;
-type ContextEvaluationNextFields = Pick<ContextEvaluationNextResult, "recommended" | "ready" | "ranking" | "context_intent">;
+type ContextEvaluationContextFields = Pick<ContextEvaluationContextResult,"high_level" | "low_level" | "blocked_fallback" | "ranking" | "context_intent">;
+type ContextEvaluationNextFields = Pick<ContextEvaluationNextResult,"recommended" | "ready" | "ranking" | "context_intent">;
 /** Read-only SDK surface required by the context evaluation runner. */
 export interface ContextEvaluationReader {
 /** Value that configures or reports context for this contract. */
-context(options?: ContextEvaluationReadOptions): Promise<PmReadOutputResult<ContextEvaluationContextFields>>;
+context(options?:ContextEvaluationReadOptions):Promise<PmReadOutputResult<ContextEvaluationContextFields>>;
 /** Value that configures or reports next for this contract. */
-next(options?: ContextEvaluationReadOptions): Promise<PmReadOutputResult<ContextEvaluationNextFields>>;
+next(options?:ContextEvaluationReadOptions):Promise<PmReadOutputResult<ContextEvaluationNextFields>>;
 }
 /** One graded context or next scenario evaluated against a real SDK reader. */
 export interface ContextEvaluationScenario {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports surface for this contract. */
-surface: ContextRelevanceSurface;
+surface:ContextRelevanceSurface;
 /** Value that configures or reports options for this contract. */
-options?: ContextEvaluationReadOptions;
+options?:ContextEvaluationReadOptions;
 /** Value that configures or reports judgments for this contract. */
-judgments: Record<string, number>;
+judgments:Record<string,number>;
 /** Value that configures or reports required ids for this contract. */
-required_ids?: string[];
+required_ids?:string[];
 /** Value that configures or reports continuity ids for this contract. */
-continuity_ids?: string[];
+continuity_ids?:string[];
 /** Value that configures or reports token budget for this contract. */
-token_budget: number;
+token_budget:number;
 /** Value that configures or reports rationale for this contract. */
-rationale: string;
+rationale:string;
 }
 /** Per-item signal attribution retained by a context evaluation report. */
 export interface ContextEvaluationAttribution {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports contributions for this contract. */
-contributions: ContextRelevanceContributions;
+contributions:ContextRelevanceContributions;
 }
 /** Result of executing and grading one context evaluation scenario. */
 export interface ContextEvaluationScenarioReport {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports surface for this contract. */
-surface: ContextRelevanceSurface;
+surface:ContextRelevanceSurface;
 /** Value that configures or reports rationale for this contract. */
-rationale: string;
+rationale:string;
 /** Value that configures or reports ranked ids for this contract. */
-ranked_ids: string[];
+ranked_ids:string[];
 /** Value that configures or reports actual tokens for this contract. */
-actual_tokens: number;
+actual_tokens:number;
 /** Value that configures or reports metrics for this contract. */
-metrics: ContextRankingEvaluation;
+metrics:ContextRankingEvaluation;
 /** Value that configures or reports attribution for this contract. */
-attribution: ContextEvaluationAttribution[];
+attribution:ContextEvaluationAttribution[];
 }
 /** Minimum acceptable aggregate metrics for a context evaluation corpus. */
 export interface ContextEvaluationThresholds {
 /** Value that configures or reports ndcg for this contract. */
-ndcg: number;
+ndcg:number;
 /** Value that configures or reports reciprocal rank for this contract. */
-reciprocal_rank: number;
+reciprocal_rank:number;
 /** Value that configures or reports required recall for this contract. */
-required_recall: number;
+required_recall:number;
 /** Value that configures or reports continuity coverage for this contract. */
-continuity_coverage: number;
+continuity_coverage:number;
 /** Value that configures or reports token budget adherence for this contract. */
-token_budget_adherence: number;
+token_budget_adherence:number;
 }
 /** Canonical aggregate metrics required by every context evaluation corpus. */
-export declare const CONTEXT_EVALUATION_METRIC_NAMES: readonly ["ndcg", "reciprocal_rank", "required_recall", "continuity_coverage", "token_budget_adherence"];
+export declare const CONTEXT_EVALUATION_METRIC_NAMES:readonly ["ndcg","reciprocal_rank","required_recall","continuity_coverage","token_budget_adherence"];
 /** Aggregate context evaluation report suitable for a CI quality gate. */
 export interface ContextEvaluationCorpusReport {
 /** Number of scenario entries represented by this result. */
-scenario_count: number;
+scenario_count:number;
 /** Value that configures or reports aggregate for this contract. */
-aggregate: ContextEvaluationThresholds;
+aggregate:ContextEvaluationThresholds;
 /** Value that configures or reports scenarios for this contract. */
-scenarios: ContextEvaluationScenarioReport[];
+scenarios:ContextEvaluationScenarioReport[];
 /** Value that configures or reports passed for this contract. */
-passed: boolean;
+passed:boolean;
 /** Value that configures or reports failures for this contract. */
-failures: string[];
+failures:string[];
 }
 /** Evaluate one ranked context packet against graded human judgments. */
-export declare function evaluateContextRanking(input: ContextRankingEvaluationInput): ContextRankingEvaluation;
+export declare function evaluateContextRanking(input:ContextRankingEvaluationInput):ContextRankingEvaluation;
 /** Execute one graded scenario through public SDK context/next read primitives. */
-export declare function runContextEvaluationScenario(scenario: ContextEvaluationScenario, reader: ContextEvaluationReader): Promise<ContextEvaluationScenarioReport>;
+export declare function runContextEvaluationScenario(scenario:ContextEvaluationScenario,reader:ContextEvaluationReader):Promise<ContextEvaluationScenarioReport>;
 /** Aggregate scenario reports and evaluate every metric against explicit thresholds. */
-export declare function summarizeContextEvaluationReports(reports: readonly ContextEvaluationScenarioReport[], thresholds: ContextEvaluationThresholds): ContextEvaluationCorpusReport;
+export declare function summarizeContextEvaluationReports(reports:readonly ContextEvaluationScenarioReport[],thresholds:ContextEvaluationThresholds):ContextEvaluationCorpusReport;
 /** Execute a same-workspace scenario corpus through public SDK read primitives. */
-export declare function runContextEvaluationCorpus(scenarios: readonly ContextEvaluationScenario[], reader: ContextEvaluationReader, thresholds: ContextEvaluationThresholds): Promise<ContextEvaluationCorpusReport>;
+export declare function runContextEvaluationCorpus(scenarios:readonly ContextEvaluationScenario[],reader:ContextEvaluationReader,thresholds:ContextEvaluationThresholds):Promise<ContextEvaluationCorpusReport>;
 export {};