@unbrained/pm-cli 2026.10.14 → 2026.10.17

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,15 @@
  *
  * 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 ReleaseMutationOptions,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";
+export type { CloseEvidenceFollowUp } from "./lifecycle-policy.js";

package/dist/sdk/core.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]="484b88ea-87f1-5f53-86ca-74faee0fb9d1")}catch{}})();import{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,listAllComplete}from"./runtime.js";export*from"./core-governance.js";import{updateLinkedTest}from"./test/update.js";import{isItemAlreadyExistsError}from"./errors.js";export*from"./agent-session-context.js";import{isAlreadyClaimedError}from"./lifecycle/claim.js";import{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";import{applyReadOutputSessionReferences,attachReadOutputSessionReceipt,parseReadOutputSession,readOutputSessionRemainingTokens}from"./read-output-session.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,PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_DIMENSIONS,PM_READ_OUTPUT_OPTION_FLAGS,PM_READ_OUTPUT_SURFACE_CONTRACTS,PmCliError,PmClient,RISK_VALUES,STATUS_VALUES,aggregate,append,applyReadOutputDimensions,applyReadOutputSessionReferences,attachReadOutputSessionReceipt,canonicalDocument,claim,claimNext,classifyItemFormatVersion,close,comments,context,copy,create,createPmCliExpectedError,decodeReadOutputContinuationCursor,deleteItem,deps,docs,effectiveItemFormatVersion,emptyImportedDocument,encodeReadOutputContinuationCursor,files,filesDiscover,focus,get,graph,isAlreadyClaimedError,isItemAlreadyExistsError,isPmCliExpectedError,isReadOutputBudgetExceeded,learnings,list,listAllComplete,next,normalizeItemFormatVersion,normalizeItemId,normalizeStatusInput,notes,nowIso,parseReadOutputSession,readOutputSessionRemainingTokens,release,reopen,resolveReadOutputDimensions,resolveReadOutputEncoding,resolveReadOutputSurface,restore,runAction,search,serializeItemDocument,update,updateLinkedTest,validateReadOutputOptions};
+(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]="e59ba808-f070-50e3-ade1-222a832328ba")}catch{}})();import{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,listAllComplete}from"./runtime.js";export*from"./core-governance.js";import{updateLinkedTest}from"./test/update.js";import{isItemAlreadyExistsError}from"./errors.js";export*from"./agent-session-context.js";import{isAlreadyClaimedError}from"./lifecycle/claim.js";import{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";import{applyReadOutputSessionReferences,attachReadOutputSessionReceipt,parseReadOutputSession,readOutputSessionRemainingTokens}from"./read-output-session.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,PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_DIMENSIONS,PM_READ_OUTPUT_OPTION_FLAGS,PM_READ_OUTPUT_SURFACE_CONTRACTS,PmCliError,PmClient,RISK_VALUES,STATUS_VALUES,aggregate,append,applyReadOutputDimensions,applyReadOutputSessionReferences,attachReadOutputSessionReceipt,canonicalDocument,claim,claimNext,classifyItemFormatVersion,close,comments,context,copy,create,createPmCliExpectedError,decodeReadOutputContinuationCursor,deleteItem,deps,docs,effectiveItemFormatVersion,emptyImportedDocument,encodeReadOutputContinuationCursor,files,filesDiscover,focus,get,graph,isAlreadyClaimedError,isItemAlreadyExistsError,isPmCliExpectedError,isReadOutputBudgetExceeded,learnings,list,listAllComplete,next,normalizeItemFormatVersion,normalizeItemId,normalizeStatusInput,notes,nowIso,parseReadOutputSession,readOutputSessionRemainingTokens,release,reopen,resolveReadOutputDimensions,resolveReadOutputEncoding,resolveReadOutputSurface,restore,runAction,search,serializeItemDocument,update,updateLinkedTest,validateReadOutputOptions};
 //# sourceMappingURL=core.js.map

package/dist/sdk/corpus-shape.d.ts

@@ -11,132 +11,132 @@ export type BuiltinCorpusShapeName = "scratch" | "representative" | "deep-graph"
 /** One weighted relationship kind in a generated corpus. */
 export interface CorpusShapeEdgeWeight {
 /** Registered pm relationship kind. */
-kind: string;
+kind:string;
 /** Relative deterministic selection weight. */
-weight: number;
+weight:number;
 }
 /** Portable declaration of the population behind a benchmark or evaluation. */
 export interface CorpusShape {
 /** Versioned schema identity. */
-schema: typeof PM_CORPUS_SHAPE_SCHEMA;
+schema:typeof PM_CORPUS_SHAPE_SCHEMA;
 /** Stable shape name used by CLIs and reports. */
-name: string;
+name:string;
 /** Human-readable intent and expected use. */
-description: string;
+description:string;
 /** Maximum generated parent-chain depth. */
-hierarchy_depth: number;
+hierarchy_depth:number;
 /** Target maximum number of children per generated parent. */
-hierarchy_fanout: number;
+hierarchy_fanout:number;
 /** Project time spanned by generated timestamps. */
-age_span_days: number;
+age_span_days:number;
 /** History entries generated for every item. */
-history_entries_per_item: number;
+history_entries_per_item:number;
 /** Evidence comments generated per hundred items. */
-comments_per_100_items: number;
+comments_per_100_items:number;
 /** Private notes generated per hundred items. */
-notes_per_100_items: number;
+notes_per_100_items:number;
 /** Durable learnings generated per hundred items. */
-learnings_per_100_items: number;
+learnings_per_100_items:number;
 /** Weighted typed relationship population. */
-edge_kind_mix: readonly CorpusShapeEdgeWeight[];
+edge_kind_mix:readonly CorpusShapeEdgeWeight[];
 /** Number of distinct mutation authors. */
-author_cardinality: number;
+author_cardinality:number;
 /** Number of disconnected hierarchy/relationship components. */
-component_count: number;
+component_count:number;
 /** Whether deterministic back-edges should exercise cyclic graph handling. */
-include_cycles: boolean;
+include_cycles:boolean;
 /** Custom item types registered before generation. */
-custom_types: readonly string[];
+custom_types:readonly string[];
 /** Custom lifecycle statuses registered before generation. */
-custom_statuses: readonly string[];
+custom_statuses:readonly string[];
 /** Custom statuses that should use terminal lifecycle semantics. */
-terminal_statuses: readonly string[];
+terminal_statuses:readonly string[];
 /** Custom metadata fields registered before generation. */
-custom_fields: readonly string[];
+custom_fields:readonly string[];
 }
 /** Deterministic SDK plan for one generated corpus item. */
 export interface CorpusShapeItemPlan {
 /** Zero-based item position. */
-index: number;
+index:number;
 /** Stable generated item identifier. */
-id: string;
+id:string;
 /** Optional generated parent identifier. */
-parent?: string;
+parent?:string;
 /** Component assigned by the shape. */
-component: number;
+component:number;
 /** Deterministic timestamp across the declared age span. */
-timestamp: string;
+timestamp:string;
 /** Deterministic author identity. */
-author: string;
+author:string;
 /** Number of history entries to materialize. */
-history_entry_count: number;
+history_entry_count:number;
 /** Relationship kinds selected for this item. */
-dependency_kinds: readonly string[];
+dependency_kinds:readonly string[];
 /** Whether the item receives an evidence comment. */
-has_comment: boolean;
+has_comment:boolean;
 /** Whether the item receives a private note. */
-has_note: boolean;
+has_note:boolean;
 /** Whether the item receives a durable learning. */
-has_learning: boolean;
+has_learning:boolean;
 /** Custom type selected for this item, when configured. */
-custom_type?: string;
+custom_type?:string;
 /** Custom status selected for this item, when configured. */
-custom_status?: string;
+custom_status?:string;
 }
 /** Measured population profile attached to generated-corpus evidence. */
 export interface CorpusShapeProfile {
 /** Shape declaration identity. */
-shape: string;
+shape:string;
 /** Generated item count. */
-item_count: number;
+item_count:number;
 /** Observed distinct author count. */
-author_count: number;
+author_count:number;
 /** Observed hierarchy component count. */
-component_count: number;
+component_count:number;
 /** Observed maximum parent-chain depth. */
-hierarchy_depth: number;
+hierarchy_depth:number;
 /** Observed maximum number of children assigned to one parent. */
-hierarchy_fanout: number;
+hierarchy_fanout:number;
 /** Observed minimum and maximum timestamps. */
-timestamp_range: {
-first: string | null;
-last: string | null;
+timestamp_range:{
+first:string | null;
+last:string | null;
 };
 /** Observed total history entries. */
-history_entry_count: number;
+history_entry_count:number;
 /** Observed annotation totals. */
-annotations: {
-comments: number;
-notes: number;
-learnings: number;
+annotations:{
+comments:number;
+notes:number;
+learnings:number;
 };
 /** Observed relationship-kind totals. */
-edge_kinds: Record<string, number>;
+edge_kinds:Record<string,number>;
 /** True when every declared invariant represented by the plan matches. */
-matches_declaration: boolean;
+matches_declaration:boolean;
 /** Actionable mismatches, empty for a conforming plan. */
-mismatches: readonly string[];
+mismatches:readonly string[];
 }
 /** Incremental corpus-profile measurement without retaining item plans. */
 export interface CorpusShapeMeasurement {
 /** Add one generated plan in generation order. */
-add(plan: CorpusShapeItemPlan): void;
+add(plan:CorpusShapeItemPlan):void;
 /** Finish the measurement and return its conformance profile. */
-finish(): CorpusShapeProfile;
+finish():CorpusShapeProfile;
 }
-type ExactCorpusShape<Shape extends CorpusShape> = Shape & Record<Exclude<keyof Shape, keyof CorpusShape>, never>;
+type ExactCorpusShape<Shape extends CorpusShape> = Shape & Record<Exclude<keyof Shape,keyof CorpusShape>,never>;
 /** Validate, detach, and deeply freeze a portable corpus-shape declaration. */
-export declare function defineCorpusShape<const Shape extends CorpusShape>(shape: ExactCorpusShape<Shape>): Readonly<Shape>;
+export declare function defineCorpusShape<const Shape extends CorpusShape>(shape:ExactCorpusShape<Shape>):Readonly<Shape>;
 /** Canonical built-in corpus shapes used by repository and downstream gates. */
-export declare const BUILTIN_CORPUS_SHAPES: Readonly<Record<BuiltinCorpusShapeName, Readonly<CorpusShape>>>;
+export declare const BUILTIN_CORPUS_SHAPES:Readonly<Record<BuiltinCorpusShapeName,Readonly<CorpusShape>>>;
 /** Return all built-in corpus-shape declarations in stable name order. */
-export declare function listBuiltinCorpusShapes(): readonly Readonly<CorpusShape>[];
+export declare function listBuiltinCorpusShapes():readonly Readonly<CorpusShape>[];
 /** Resolve one built-in corpus shape or reject an unknown name. */
-export declare function resolveBuiltinCorpusShape(name: string): Readonly<CorpusShape>;
+export declare function resolveBuiltinCorpusShape(name:string):Readonly<CorpusShape>;
 /** Build one deterministic corpus item plan without filesystem side effects. */
-export declare function buildCorpusShapeItemPlan(shape: Readonly<CorpusShape>, index: number, itemCount: number, seed?: number): CorpusShapeItemPlan;
+export declare function buildCorpusShapeItemPlan(shape:Readonly<CorpusShape>,index:number,itemCount:number,seed?:number):CorpusShapeItemPlan;
 /** Create an incremental measurement for a generated corpus population. */
-export declare function createCorpusShapeMeasurement(shape: Readonly<CorpusShape>): CorpusShapeMeasurement;
+export declare function createCorpusShapeMeasurement(shape:Readonly<CorpusShape>):CorpusShapeMeasurement;
 /** Measure a generated plan and fail closed when declared invariants drift. */
-export declare function measureCorpusShapePlan(shape: Readonly<CorpusShape>, plans: readonly CorpusShapeItemPlan[]): CorpusShapeProfile;
+export declare function measureCorpusShapePlan(shape:Readonly<CorpusShape>,plans:readonly CorpusShapeItemPlan[]):CorpusShapeProfile;
 export {};