@unbrained/pm-cli 2026.10.14 → 2026.10.17

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 {};

package/dist/sdk/context-signal-store.d.ts

@@ -1,4 +1,4 @@
-import { type BuildItemContextRelevanceCandidatesOptions, type ContextRelevanceCandidate, type ContextRelevanceSignals, type ContextSignalProvenance } from "./context-relevance.js";
+import { type BuildItemContextRelevanceCandidatesOptions,type ContextRelevanceCandidate,type ContextRelevanceSignals,type ContextSignalProvenance } from "./context-relevance.js";
 import type { ItemMetadata } from "../types/index.js";
 /** Current serialized feature-store envelope version. */
 export declare const CONTEXT_SIGNAL_STORE_FORMAT_VERSION = 3;
@@ -9,120 +9,120 @@ export type ContextSignalSnapshotSource = "derived_index" | "scan_fallback";
 /** One immutable item signal row. */
 export interface ContextSignalSnapshotItem {
 /** Stable item identifier. */
-id: string;
+id:string;
 /** Canonical normalized signal vector. */
-signals: ContextRelevanceSignals;
+signals:ContextRelevanceSignals;
 /** Authoritative temporal source retained for explained ranking. */
-signal_provenance: ContextSignalProvenance;
+signal_provenance:ContextSignalProvenance;
 }
 /** Rebuildable, deterministic context-signal snapshot. */
 export interface ContextSignalSnapshot {
 /** Serialized envelope version. */
-format_version: number;
+format_version:number;
 /** Signal algorithm version. */
-signal_set_version: number;
+signal_set_version:number;
 /** Authoritative history or derived-index cursor folded into this snapshot. */
-source_cursor: string;
+source_cursor:string;
 /** Deterministic digest of substantive recency provenance used by the fold. */
-recency_evidence_fingerprint: string;
+recency_evidence_fingerprint:string;
 /** Stable clock supplied by the caller. */
-generated_at: string;
+generated_at:string;
 /** Read substrate used for the fold. */
-source: ContextSignalSnapshotSource;
+source:ContextSignalSnapshotSource;
 /** Item rows sorted by canonical id. */
-items: readonly ContextSignalSnapshotItem[];
+items:readonly ContextSignalSnapshotItem[];
 }
 /** Pluggable persistence boundary for context-signal snapshots. */
 export interface ContextSignalStoreAdapter {
 /** Read the serialized snapshot, or null when none exists. */
-read(): Promise<unknown | null>;
+read():Promise<unknown | null>;
 /** Atomically replace the serialized snapshot. */
-write(snapshot: ContextSignalSnapshot): Promise<void>;
+write(snapshot:ContextSignalSnapshot):Promise<void>;
 }
 /** Options required to fold authoritative items into a snapshot. */
 export interface BuildContextSignalSnapshotOptions extends BuildItemContextRelevanceCandidatesOptions {
 /** Authoritative history or derived-index cursor. */
-sourceCursor: string;
+sourceCursor:string;
 /** Substrate used to load the authoritative items. */
-source: ContextSignalSnapshotSource;
+source:ContextSignalSnapshotSource;
 }
 /** Result of a feature-store read with explicit degradation metadata. */
 export interface ContextSignalStoreReadResult {
 /** Valid snapshot used for candidate assembly. */
-snapshot: ContextSignalSnapshot;
+snapshot:ContextSignalSnapshot;
 /** Candidates joined to the caller's authoritative item objects. */
-candidates: ContextRelevanceCandidate<ItemMetadata>[];
+candidates:ContextRelevanceCandidate<ItemMetadata>[];
 /** Whether the persisted snapshot was reused or rebuilt. */
-cache_status: "fresh" | "rebuilt";
+cache_status:"fresh" | "rebuilt";
 /** Non-fatal recovery diagnostics. */
-warnings: readonly string[];
+warnings:readonly string[];
 /** Actionable meanings and executable recovery commands for every warning. */
-warning_details?: readonly ContextSignalStoreWarningDetail[];
+warning_details?:readonly ContextSignalStoreWarningDetail[];
 }
 /** Stable recovery contract for one context signal-store warning. */
 export interface ContextSignalStoreWarningDetail {
 /** Machine-readable warning code also present in `warnings`. */
-code: "context_signal_store_invalid" | "context_signal_store_stale" | "context_signal_store_write_failed";
+code:"context_signal_store_invalid" | "context_signal_store_stale" | "context_signal_store_write_failed";
 /** Bounded explanation of the observed derived-state condition. */
-meaning: string;
+meaning:string;
 /** Safe executable command that retries or confirms recovery. */
-recovery_command: "pm context";
+recovery_command:"pm context";
 /** Expected observable effect of the recovery command. */
-recovery_effect: string;
+recovery_effect:string;
 }
 /** Canonical actionable contracts shared by CLI, SDK, MCP, and package hosts. */
-export declare const CONTEXT_SIGNAL_STORE_WARNING_DETAILS: {
-readonly context_signal_store_invalid: {
-readonly code: "context_signal_store_invalid";
-readonly meaning: "The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.";
-readonly recovery_command: "pm context";
-readonly recovery_effect: "Re-read context and confirm the rebuilt snapshot can be loaded without the warning.";
+export declare const CONTEXT_SIGNAL_STORE_WARNING_DETAILS:{
+readonly context_signal_store_invalid:{
+readonly code:"context_signal_store_invalid";
+readonly meaning:"The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.";
+readonly recovery_command:"pm context";
+readonly recovery_effect:"Re-read context and confirm the rebuilt snapshot can be loaded without the warning.";
 };
-readonly context_signal_store_stale: {
-readonly code: "context_signal_store_stale";
-readonly meaning: "The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.";
-readonly recovery_command: "pm context";
-readonly recovery_effect: "Re-read context and confirm the rebuilt snapshot is now fresh.";
+readonly context_signal_store_stale:{
+readonly code:"context_signal_store_stale";
+readonly meaning:"The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.";
+readonly recovery_command:"pm context";
+readonly recovery_effect:"Re-read context and confirm the rebuilt snapshot is now fresh.";
 };
-readonly context_signal_store_write_failed: {
-readonly code: "context_signal_store_write_failed";
-readonly meaning: "Context signals were rebuilt in memory, but the derived snapshot could not be persisted.";
-readonly recovery_command: "pm context";
-readonly recovery_effect: "Retry the derived snapshot write and confirm the warning clears after storage access is restored.";
+readonly context_signal_store_write_failed:{
+readonly code:"context_signal_store_write_failed";
+readonly meaning:"Context signals were rebuilt in memory, but the derived snapshot could not be persisted.";
+readonly recovery_command:"pm context";
+readonly recovery_effect:"Retry the derived snapshot write and confirm the warning clears after storage access is restored.";
 };
 };
 /** Workspace-bound feature-store options used by CLI, MCP, and SDK readers. */
 export interface ReadWorkspaceContextSignalsOptions extends BuildItemContextRelevanceCandidatesOptions {
 /** Tracker root containing rebuildable runtime state. */
-pmRoot: string;
+pmRoot:string;
 /** Explicit cursor for custom SDK hosts; the stock host reads the metadata index. */
-sourceCursor?: string;
+sourceCursor?:string;
 /** Explicit source classification paired with sourceCursor. */
-source?: ContextSignalSnapshotSource;
+source?:ContextSignalSnapshotSource;
 /** Stable projection namespace when one workspace serves distinct candidate corpora. */
-storeKey?: string;
+storeKey?:string;
 }
 /** Validate an untrusted serialized snapshot without accepting partial envelopes. */
-export declare function parseContextSignalSnapshot(value: unknown): ContextSignalSnapshot | null;
+export declare function parseContextSignalSnapshot(value:unknown):ContextSignalSnapshot | null;
 /** Fold authoritative items into a deterministic, immutable signal snapshot. */
-export declare function buildContextSignalSnapshot(items: readonly ItemMetadata[], options: BuildContextSignalSnapshotOptions): ContextSignalSnapshot;
+export declare function buildContextSignalSnapshot(items:readonly ItemMetadata[],options:BuildContextSignalSnapshotOptions):ContextSignalSnapshot;
 /** Filesystem adapter using same-directory atomic replacement. */
 export declare class JsonFileContextSignalStoreAdapter implements ContextSignalStoreAdapter {
 private readonly filePath;
 /** Create an adapter for an explicit derived-state file path. */
-constructor(filePath: string);
+constructor(filePath:string);
 /** Read and decode the JSON snapshot, returning null when it does not exist. */
-read(): Promise<unknown | null>;
+read():Promise<unknown | null>;
 /** Write a complete snapshot through a unique same-directory temporary file. */
-write(snapshot: ContextSignalSnapshot): Promise<void>;
+write(snapshot:ContextSignalSnapshot):Promise<void>;
 }
 /** Cursor-aware feature store that self-heals from absent, stale, or corrupt state. */
 export declare class ContextSignalStore {
 private readonly adapter;
 /** Bind the store to a caller-selected persistence adapter. */
-constructor(adapter: ContextSignalStoreAdapter);
+constructor(adapter:ContextSignalStoreAdapter);
 /** Read matching signals or rebuild them from authoritative items. */
-readOrRebuild(items: readonly ItemMetadata[], options: BuildContextSignalSnapshotOptions): Promise<ContextSignalStoreReadResult>;
+readOrRebuild(items:readonly ItemMetadata[],options:BuildContextSignalSnapshotOptions):Promise<ContextSignalStoreReadResult>;
 }
 /** Read cursor-bound workspace signals with deterministic scan fallback. */
-export declare function readWorkspaceContextSignals(items: readonly ItemMetadata[], options: ReadWorkspaceContextSignalsOptions): Promise<ContextSignalStoreReadResult>;
+export declare function readWorkspaceContextSignals(items:readonly ItemMetadata[],options:ReadWorkspaceContextSignalsOptions):Promise<ContextSignalStoreReadResult>;