@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/context-intent-runtime.d.ts

@@ -3,17 +3,17 @@ import { type PmContextIntentContract, type PmContextIntentRuntimeLayers } from
 export declare const PM_CONTEXT_INTENTS_FILE = "context-intents.json";
 /** Minimal active-package shape needed to discover declarative intent exports. */
 export interface PmContextIntentPackageModule {
-    /** Stable package name used in diagnostics. */
-    name: string;
-    /** Loaded extension module, which may export contextIntents. */
-    module: unknown;
+/** Stable package name used in diagnostics. */
+name: string;
+/** Loaded extension module, which may export contextIntents. */
+module: unknown;
 }
 /** Inputs for discovering workspace and active-package intent declarations. */
 export interface PmContextIntentDiscoveryOptions {
-    /** Resolved .agents/pm tracker root. */
-    pmRoot: string;
-    /** Active package modules in deterministic activation order. */
-    packages?: readonly PmContextIntentPackageModule[];
+/** Resolved .agents/pm tracker root. */
+pmRoot: string;
+/** Active package modules in deterministic activation order. */
+packages?: readonly PmContextIntentPackageModule[];
 }
 /** Parse a JSON/module declaration array and reject malformed entries before composition. */
 export declare function parseContextIntentDeclarations(value: unknown, sourceLabel: string): PmContextIntentContract[];

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

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