@unbrained/pm-cli 2026.10.13 → 2026.10.15

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

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

@@ -1,63 +1,63 @@
 import { type ContextUsageWriteReceipt } from "./context/usage-ledger.js";
-export { ContextUsageValidationError, CONTEXT_USAGE_LIMITS, type ContextUsageWriteReceipt } from "./context/usage-ledger.js";
+export { ContextUsageValidationError,CONTEXT_USAGE_LIMITS,type ContextUsageWriteReceipt } from "./context/usage-ledger.js";
 import type { ContextRelevanceSurface } from "./context-relevance.js";
 /** One propensity row disclosed when context or next serves a candidate. */
 export interface ContextUsageServingRow {
 /** Served item identifier. */
-id: string;
+id:string;
 /** One-based scorer rank. */
-rank: number;
+rank:number;
 /** Whether the packer included the item. */
-included: boolean;
+included:boolean;
 }
 /** Correlation receipt joining a pre-egress serve to its final delivery. */
 export interface ContextUsageServingReceipt {
 /** Versioned immutable serve identifier. */
-serve_id: string;
+serve_id:string;
 /** Caller whose feedback model owns the event. */
-author: string;
+author:string;
 /** Read surface that assembled the candidates. */
-surface: ContextRelevanceSurface;
+surface:ContextRelevanceSurface;
 /** Propensity-complete ranked rows assembled before egress. */
-rows: readonly ContextUsageServingRow[];
+rows:readonly ContextUsageServingRow[];
 /** Persisted sample identities; absent on legacy unsampled receipts. */
-recorded_item_ids?: readonly string[];
+recorded_item_ids?:readonly string[];
 /** Measured bounded persistence; absent on legacy receipts. */
-storage?: ContextUsageWriteReceipt;
+storage?:ContextUsageWriteReceipt;
 }
 /** Append-only serving or subsequent-touch event. */
 export type ContextUsageEvent = {
-kind: "serve";
-schema_version?: 2;
-serve_id?: string;
-at: string;
-author: string;
-surface: ContextRelevanceSurface;
-profile: string;
-rows: ContextUsageServingRow[];
+kind:"serve";
+schema_version?:2;
+serve_id?:string;
+at:string;
+author:string;
+surface:ContextRelevanceSurface;
+profile:string;
+rows:ContextUsageServingRow[];
 /** Full candidate population before deterministic prefix sampling. */
-candidate_count?: number;
+candidate_count?:number;
 /** Candidate rows excluded from this bounded feedback sample. */
-omitted_row_count?: number;
-result_omitted?: boolean;
-packed_item_ids?: string[];
+omitted_row_count?:number;
+result_omitted?:boolean;
+packed_item_ids?:string[];
 /** Legacy pre-egress field ignored by the v2 affinity fold. */
-delivered_item_ids?: string[];
+delivered_item_ids?:string[];
 } | {
-kind: "delivery";
-schema_version: 2;
-serve_id: string;
-at: string;
-author: string;
-surface: ContextRelevanceSurface;
-result_omitted: boolean;
-delivered_item_ids: string[];
+kind:"delivery";
+schema_version:2;
+serve_id:string;
+at:string;
+author:string;
+surface:ContextRelevanceSurface;
+result_omitted:boolean;
+delivered_item_ids:string[];
 } | {
-kind: "touch";
-at: string;
-author: string;
-item_id: string;
-intent: string;
+kind:"touch";
+at:string;
+author:string;
+item_id:string;
+intent:string;
 };
 /** Runtime controls for the bounded derived ledger. */
 export interface ContextUsageLedgerOptions {
@@ -66,84 +66,84 @@ export interface ContextUsageLedgerOptions {
      * ancestors must remain controlled by trusted cooperating processes during
      * ledger operations; hostile concurrent path replacement is unsupported.
      */
-pmRoot: string;
+pmRoot:string;
 /** Disable all reads and writes with zero filesystem work. */
-enabled?: boolean;
+enabled?:boolean;
 /** Maximum retained event rows. */
-maxEvents?: number;
+maxEvents?:number;
 /** Physical byte ceiling; compaction retains at most half to provide headroom. */
-maxBytes?: number;
+maxBytes?:number;
 /** Retention horizon in days. */
-retentionDays?: number;
+retentionDays?:number;
 /** Deterministic timestamp override. */
-now?: string;
+now?:string;
 }
 /** Decayed per-item affinity derived for one author. */
 export interface ContextUsageAffinity {
 /** Normalized affinity by item id. */
-affinity: Record<string, number>;
+affinity:Record<string,number>;
 /** Number of eligible served-then-touched judgments. */
-positive_judgments: number;
+positive_judgments:number;
 /** Number of retained serving events inspected. */
-serving_events: number;
+serving_events:number;
 /** Legacy serving events ignored because their inclusion cannot be trusted. */
-untrusted_serving_events: number;
+untrusted_serving_events:number;
 }
 /** Attach a JSON-invisible serving receipt to a result for later egress. */
-export declare function attachContextUsageServingReceipt(result: unknown, receipt: ContextUsageServingReceipt | null): void;
+export declare function attachContextUsageServingReceipt(result:unknown,receipt:ContextUsageServingReceipt | null):void;
 /** Copy an attached serving receipt across a result projection boundary. */
-export declare function propagateContextUsageServingReceipt(source: unknown, target: unknown): void;
+export declare function propagateContextUsageServingReceipt(source:unknown,target:unknown):void;
 /**
  * Collect every item identifier visible in a final context or next result.
  * The traversal is shape-aware so summary counters and unrelated identifier
  * fields cannot enter the privacy-minimal usage ledger.
  */
-export declare function collectContextUsageDeliveredItemIds(result: unknown, surface: ContextRelevanceSurface): string[];
+export declare function collectContextUsageDeliveredItemIds(result:unknown,surface:ContextRelevanceSurface):string[];
 /** Resolve and append one post-egress decision carried by a context result. */
-export declare function finalizeContextUsageDelivery(options: {
+export declare function finalizeContextUsageDelivery(options:{
 /** Tracker root owning the derived ledger. */
-pmRoot: string;
+pmRoot:string;
 /** Final projected response returned or rendered to the caller. */
-result: unknown;
-}): Promise<boolean>;
+result:unknown;
+}):Promise<boolean>;
 /** Records a bounded prefix of ranked context candidates with explicit sampling counts. */
-export declare function recordContextUsageServing(options: ContextUsageLedgerOptions & {
-author: string;
-surface: ContextRelevanceSurface;
-profile: string;
-rows: ContextUsageServingRow[];
-}): Promise<ContextUsageServingReceipt | null>;
+export declare function recordContextUsageServing(options:ContextUsageLedgerOptions & {
+author:string;
+surface:ContextRelevanceSurface;
+profile:string;
+rows:ContextUsageServingRow[];
+}):Promise<ContextUsageServingReceipt | null>;
 /** Append the exact post-egress delivery decision for one serving receipt. */
-export declare function recordContextUsageDelivery(options: ContextUsageLedgerOptions & {
+export declare function recordContextUsageDelivery(options:ContextUsageLedgerOptions & {
 /** Correlation receipt returned by {@link recordContextUsageServing}. */
-receipt: ContextUsageServingReceipt | null;
+receipt:ContextUsageServingReceipt | null;
 /** Item ids present in the final response payload. */
-deliveredItemIds: readonly string[];
+deliveredItemIds:readonly string[];
 /** Whether the result was suppressed by the final output budget. */
-resultOmitted: boolean;
-}): Promise<void>;
+resultOmitted:boolean;
+}):Promise<void>;
 /** Records one subsequent item read or mutation outcome. */
-export declare function recordContextUsageTouch(options: ContextUsageLedgerOptions & {
-author: string;
-itemId: string;
-intent: string;
-}): Promise<void>;
+export declare function recordContextUsageTouch(options:ContextUsageLedgerOptions & {
+author:string;
+itemId:string;
+intent:string;
+}):Promise<void>;
 /**
  * Records mutation outcomes as one append and one optional compaction pass.
  */
-export declare function recordContextUsageTouches(options: ContextUsageLedgerOptions & {
+export declare function recordContextUsageTouches(options:ContextUsageLedgerOptions & {
 /** Stable caller identity used to isolate affinity. */
-author: string;
+author:string;
 /** Item identifiers affected by the completed command. */
-itemIds: readonly string[];
+itemIds:readonly string[];
 /** Command or workflow intent associated with the touches. */
-intent: string;
-}): Promise<void>;
+intent:string;
+}):Promise<void>;
 /**
  * Derives decayed served-then-touched affinity. A small exploration floor keeps
  * ignored and unseen items eligible, preventing a popularity feedback lock-in.
  */
-export declare function readContextUsageAffinity(options: ContextUsageLedgerOptions & {
-author: string;
-horizonHours?: number;
-}): Promise<ContextUsageAffinity>;
+export declare function readContextUsageAffinity(options:ContextUsageLedgerOptions & {
+author:string;
+horizonHours?:number;
+}):Promise<ContextUsageAffinity>;

package/dist/sdk/contracts.d.ts

@@ -11,6 +11,7 @@ export * from "./context-intent-contracts.js";
 export * from "./error-code-catalog.js";
 export * from "./generated-error-code-catalog.js";
 export * from "./flag-invocation-contracts.js";
+export { resolveExtensionFlagValueContract,type ExtensionFlagValueContract } from "../core/extensions/flag-value-types.js";
 export * from "./cli-contracts/flag-lexicon-contracts.js";
 export * from "./output-token-accounting.js";
 export * from "./output-contracts.js";
@@ -21,4 +22,4 @@ export * from "../core/history/operation-contract.js";
 export * from "./agent/refusal-closure.js";
 export * from "./agent/closed-domain-contracts.js";
 export * from "./agent/tracker-preflight-contracts.js";
-export type { PmReadOutputSessionReceipt, PmReadOutputSessionState, } from "./read-output-session.js";
+export type { PmReadOutputSessionReceipt,PmReadOutputSessionState,} from "./read-output-session.js";

package/dist/sdk/contracts.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0aafe4f4-d636-597e-b594-c0a32ebced38")}catch{}})();export*from"./cli-contracts.js";export*from"./graph/query-contracts.js";export*from"./cli-contracts/grammar-contracts.js";export*from"./cli-contracts/command-exit-contracts.js";export*from"./context-intent-contracts.js";export*from"./error-code-catalog.js";export*from"./generated-error-code-catalog.js";export*from"./flag-invocation-contracts.js";export*from"./cli-contracts/flag-lexicon-contracts.js";export*from"./output-token-accounting.js";export*from"./output-contracts.js";export*from"./agent/task-transcript-contracts.js";export*from"./read-output-contracts.js";export*from"./history/attestation-contract.js";export*from"../core/history/operation-contract.js";export*from"./agent/refusal-closure.js";export*from"./agent/closed-domain-contracts.js";export*from"./agent/tracker-preflight-contracts.js";
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a7481333-4426-53a1-b04d-479d1a304ef1")}catch{}})();export*from"./cli-contracts.js";export*from"./graph/query-contracts.js";export*from"./cli-contracts/grammar-contracts.js";export*from"./cli-contracts/command-exit-contracts.js";export*from"./context-intent-contracts.js";export*from"./error-code-catalog.js";export*from"./generated-error-code-catalog.js";export*from"./flag-invocation-contracts.js";import{resolveExtensionFlagValueContract}from"../core/extensions/flag-value-types.js";export*from"./cli-contracts/flag-lexicon-contracts.js";export*from"./output-token-accounting.js";export*from"./output-contracts.js";export*from"./agent/task-transcript-contracts.js";export*from"./read-output-contracts.js";export*from"./history/attestation-contract.js";export*from"../core/history/operation-contract.js";export*from"./agent/refusal-closure.js";export*from"./agent/closed-domain-contracts.js";export*from"./agent/tracker-preflight-contracts.js";export{resolveExtensionFlagValueContract};
 //# sourceMappingURL=contracts.js.map

package/dist/sdk/core-governance.d.ts

@@ -4,8 +4,8 @@
  * Defines the shared agent-provenance and CLI-completeness governance surface
  * exposed by both the focused core entrypoint and the complete SDK barrel.
  */
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_AGENT_PROVENANCE_ADAPTERS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, listAgentProvenanceAdapters, normalizeAgentProvenanceAdapterValue, readAuthorEnvironment, registerHarnessSignalDescriptors, registerAgentProvenanceAdapters, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, type AgentClientInfo, type AgentProvenanceAdapter, type AgentModelSource, type AgentProvenance, type AgentProvenanceAbsenceReason, type AgentProvenanceObservation, type AgentProvenanceOutcome, type NormalizedAgentProvenanceAdapterValue, type AuthorSource, type DetectedAgentIdentity, type DiagnosedAgentIdentity, type HarnessDetectionSignals, type HarnessSignalDescriptor, type ResolvedAuthorIdentity, } from "../core/shared/author.js";
-export { SEMANTIC_ATTRIBUTION_LIMITS, recordClaimSemanticAttribution, recordFocusSemanticAttribution, recordReleaseSemanticAttribution, resolveSemanticLineageIds, semanticAttributionAffinity, } from "./context/semantic-session-attribution.js";
-export { explainSourceTraceability, parseSourceLineRange, type SourceDecisionPath, type SourceLineRange, type SourceTraceabilityEvidence, type SourceTraceabilityExplanation, type SourceTraceabilityRationale, type SourceTraceabilityReceipt, } from "./traceability/source-traceability.js";
-export { analyzeAgentProvenanceDescriptorCoverage, evaluateSemanticAttributionCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, type AgentEpisodeGroup, type AgentModelProvenanceCoverage, type AgentProvenanceDimensionCoverage, type AgentProvenanceDescriptorCoverage, type AgentSemanticAttributionCoverage, type AgentSemanticAttributionCoverageGate, } from "./provenance.js";
-export { analyzeSdkCliParameterCompleteness, type SdkCliActionParameterCoverage, type SdkCliCompletenessContractSource, type SdkCliParameterCoverageEntry, type SdkCliParameterDisposition, } from "./cli-contracts.js";
+export { AGENT_PROVENANCE_DIMENSIONS,BUILTIN_AGENT_PROVENANCE_ADAPTERS,BUILTIN_HARNESS_SIGNAL_DESCRIPTORS,diagnoseAgentIdentity,detectAgentIdentity,detectHarnessIdentity,listAgentProvenanceAdapters,normalizeAgentProvenanceAdapterValue,readAuthorEnvironment,registerHarnessSignalDescriptors,registerAgentProvenanceAdapters,resolveAuthorIdentity,runWithHarnessDetectionSignals,runWithWorkspaceHarnessSignalDescriptors,writeAuthorEnvironment,type AgentClientInfo,type AgentProvenanceAdapter,type AgentModelSource,type AgentProvenance,type AgentProvenanceAbsenceReason,type AgentProvenanceObservation,type AgentProvenanceOutcome,type NormalizedAgentProvenanceAdapterValue,type AuthorSource,type DetectedAgentIdentity,type DiagnosedAgentIdentity,type HarnessDetectionSignals,type HarnessSignalDescriptor,type ResolvedAuthorIdentity,} from "../core/shared/author.js";
+export { SEMANTIC_ATTRIBUTION_LIMITS,recordClaimSemanticAttribution,recordFocusSemanticAttribution,recordReleaseSemanticAttribution,resolveSemanticLineageIds,semanticAttributionAffinity,} from "./context/semantic-session-attribution.js";
+export { explainSourceTraceability,parseSourceLineRange,type SourceDecisionPath,type SourceLineRange,type SourceTraceabilityEvidence,type SourceTraceabilityExplanation,type SourceTraceabilityRationale,type SourceTraceabilityReceipt,} from "./traceability/source-traceability.js";
+export { analyzeAgentProvenanceDescriptorCoverage,evaluateSemanticAttributionCoverage,groupHistoryByEpisode,resolveHistoryEpisodeGroupIdentity,summarizeAgentProvenance,summarizeAgentModelProvenance,type AgentEpisodeGroup,type AgentModelProvenanceCoverage,type AgentProvenanceDimensionCoverage,type AgentProvenanceDescriptorCoverage,type AgentSemanticAttributionCoverage,type AgentSemanticAttributionCoverageGate,} from "./provenance.js";
+export { analyzeSdkCliParameterCompleteness,type SdkCliActionParameterCoverage,type SdkCliCompletenessContractSource,type SdkCliParameterCoverageEntry,type SdkCliParameterDisposition,} from "./cli-contracts.js";

package/dist/sdk/core.d.ts

@@ -3,14 +3,14 @@
  *
  * Provides the stable item lifecycle client and universal project data types.
  */
-export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, reopen, restore, search, update, type AggregateOptions, type AggregateResult, type AggregateRow, type AssuranceActionInput, type AssuranceActionResult, type AppendCommandOptions, type AppendResult, type ClaimNextOptions, type ClaimResult, type CloseResult, type CommentsCommandOptions, type CommentsResult, type ContextOptions, type ContextResult, type CopyResult, type CreateResult, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GetOptions, type GetResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type ListOptions, type ListResult, listAllComplete, type PmCompleteListOptions, type PmCompleteListResult, type NextOptions, type NextResult, type NotesCommandOptions, type NotesResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientOptions, type ReleaseResult, type PreviousTerminalEvidence, type RecurrenceReceipt, type ReopenCommandOptions, type ReopenResult, type RestoreResult, type SearchOptions, type SearchResult, type UpdateResult, } from "./runtime.js";
+export { BASELINE_ITEM_FORMAT_VERSION,BUILTIN_ITEM_TYPE_VALUES,CONFIDENCE_TEXT_VALUES,CURRENT_ITEM_FORMAT_VERSION,DEPENDENCY_KIND_VALUES,EXIT_CODE,ISSUE_SEVERITY_VALUES,ITEM_TYPE_VALUES,PM_CLI_EXPECTED_ERROR_NAME,PmCliError,PmClient,RISK_VALUES,STATUS_VALUES,canonicalDocument,classifyItemFormatVersion,createPmCliExpectedError,effectiveItemFormatVersion,emptyImportedDocument,isPmCliExpectedError,normalizeItemFormatVersion,normalizeItemId,normalizeStatusInput,nowIso,runAction,serializeItemDocument,aggregate,append,claim,claimNext,close,comments,context,copy,create,deleteItem,deps,docs,files,filesDiscover,focus,get,graph,learnings,list,next,notes,release,reopen,restore,search,update,type AggregateOptions,type AggregateResult,type AggregateRow,type AssuranceActionInput,type AssuranceActionResult,type AppendCommandOptions,type AppendResult,type ClaimNextOptions,type ClaimResult,type CloseResult,type CommentsCommandOptions,type CommentsResult,type ContextOptions,type ContextResult,type CopyResult,type CreateResult,type Dependency,type DeleteResult,type DepsCommandOptions,type DepsResult,type DocsCommandOptions,type DocsResult,type FilesCommandOptions,type FilesDiscoverOptions,type FilesDiscoverResult,type FilesResult,type FocusResult,type GetOptions,type GetResult,type ItemFormatVersionScanEntry,type ItemFormatVersionScanResult,type ItemFormatVersionStatus,type LearningsCommandOptions,type LearningsResult,type ListOptions,type ListResult,listAllComplete,type PmCompleteListOptions,type PmCompleteListResult,type NextOptions,type NextResult,type NotesCommandOptions,type NotesResult,type PmActionInput,type PmActionName,type PmActionOptions,type PmClientOptions,type ReleaseResult,type PreviousTerminalEvidence,type RecurrenceReceipt,type ReopenCommandOptions,type ReopenResult,type RestoreResult,type SearchOptions,type SearchResult,type UpdateResult,} from "./runtime.js";
 export * from "./core-governance.js";
-export { updateLinkedTest, type LinkedTestUpdateSelector, type LinkedTestMetadataPatch, type UpdateLinkedTestOptions, type UpdateLinkedTestResult, } from "./test/update.js";
-export { isItemAlreadyExistsError, type PmItemAlreadyExistsError } from "./errors.js";
+export { updateLinkedTest,type LinkedTestUpdateSelector,type LinkedTestMetadataPatch,type UpdateLinkedTestOptions,type UpdateLinkedTestResult,} from "./test/update.js";
+export { isItemAlreadyExistsError,type PmItemAlreadyExistsError } from "./errors.js";
 export * from "./agent-session-context.js";
 export { isAlreadyClaimedError } from "./lifecycle/claim.js";
-export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
-export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
-export type { PmReadOutputBudgetExceeded, PmReadOutputContinuation, PmReadOutputCursorEnvelope, PmReadOutputDimension, PmReadOutputLegacyAlias, PmReadOutputOptions, PmReadOutputReceipt, PmReadOutputResult, PmReadOutputResultFor, PmReadOutputSurface, PmReadOutputSurfaceContract, } from "./read-output-contracts.js";
-export type { PmReadOutputSessionReceipt, PmReadOutputSessionReference, PmReadOutputSessionState, } from "./read-output-session.js";
-export type { ItemDocument, ItemMetadata, ItemStatus, ItemType, PmSettings, } from "../types/index.js";
+export { PM_READ_OUTPUT_DIMENSIONS,PM_READ_OUTPUT_OPTION_FLAGS,PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_SURFACE_CONTRACTS,applyReadOutputDimensions,decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor,isReadOutputBudgetExceeded,resolveReadOutputDimensions,resolveReadOutputEncoding,resolveReadOutputSurface,validateReadOutputOptions,} from "./read-output-contracts.js";
+export { applyReadOutputSessionReferences,attachReadOutputSessionReceipt,parseReadOutputSession,readOutputSessionRemainingTokens,} from "./read-output-session.js";
+export type { PmReadOutputBudgetExceeded,PmReadOutputContinuation,PmReadOutputCursorEnvelope,PmReadOutputDimension,PmReadOutputLegacyAlias,PmReadOutputOptions,PmReadOutputReceipt,PmReadOutputResult,PmReadOutputResultFor,PmReadOutputSurface,PmReadOutputSurfaceContract,} from "./read-output-contracts.js";
+export type { PmReadOutputSessionReceipt,PmReadOutputSessionReference,PmReadOutputSessionState,} from "./read-output-session.js";
+export type { ItemDocument,ItemMetadata,ItemStatus,ItemType,PmSettings,} from "../types/index.js";