@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/environment/agent-environment.d.ts

@@ -1,296 +1,296 @@
 import { type WorkspaceRecipe } from "../workspace-recipe.js";
 /** Schema identifier for a portable observation contract. */
-export declare const PM_OBSERVATION_SCHEMA: "pm.agent-observation/v1";
+export declare const PM_OBSERVATION_SCHEMA:"pm.agent-observation/v1";
 /** Schema identifier for a deterministic verdict contract. */
-export declare const PM_VERDICT_SCHEMA: "pm.agent-verdict/v1";
+export declare const PM_VERDICT_SCHEMA:"pm.agent-verdict/v1";
 /** Schema identifier for a bounded agent-environment episode. */
-export declare const PM_EPISODE_SCHEMA: "pm.agent-episode/v1";
+export declare const PM_EPISODE_SCHEMA:"pm.agent-episode/v1";
 /** A JSON-compatible object used as immutable recorded workspace state. */
-export type RecordedStateObject = Readonly<Record<string, unknown>>;
+export type RecordedStateObject = Readonly<Record<string,unknown>>;
 /** One declared read and its guaranteed token ceiling. */
 export interface ObservationReadDeclaration {
 /** Public SDK or CLI command name used to collect the read. */
-command: string;
+command:string;
 /** Maximum tokens this read may consume. */
-budget_tokens: number;
+budget_tokens:number;
 }
 /** Emitted-byte calibration for a representative observation corpus. */
 export interface ObservationCalibration {
 /** Stable measurement basis; serialized payload bytes are authoritative. */
-basis: "emitted_bytes";
+basis:"emitted_bytes";
 /** Historical emitted-byte measurements used to calibrate expectations. */
-samples: readonly number[];
+samples:readonly number[];
 /** Expected serialized payload size before an observation is served. */
-expected_emitted_bytes: number;
+expected_emitted_bytes:number;
 /** Accepted drift around the expected emitted-byte measurement. */
-tolerance_bytes: number;
+tolerance_bytes:number;
 }
 /** Declares whether observation cost varies with corpus size. */
 export type ObservationCorpusDependence = {
-readonly kind: "independent";
+readonly kind:"independent";
 } | {
-readonly kind: "bounded";
-readonly dimension: string;
-readonly maximum: number;
+readonly kind:"bounded";
+readonly dimension:string;
+readonly maximum:number;
 };
 /** One ordered disclosure tier in an observation degradation ladder. */
 export interface ObservationTier {
 /** Stable tier identity included in every observation receipt. */
-id: string;
+id:string;
 /** Maximum tokens this tier is permitted to emit. */
-max_tokens: number;
+max_tokens:number;
 /** Dot-separated recorded-state fields disclosed by the tier. */
-fields: readonly string[];
+fields:readonly string[];
 }
 /** Portable declaration for a bounded, calibrated observation. */
 export interface ObservationContract {
 /** Versioned schema identity. */
-schema: typeof PM_OBSERVATION_SCHEMA;
+schema:typeof PM_OBSERVATION_SCHEMA;
 /** Stable contract identity. */
-id: string;
+id:string;
 /** Positive contract revision. */
-version: number;
+version:number;
 /** Reads whose ceilings form the guaranteed collection cost. */
-reads: readonly ObservationReadDeclaration[];
+reads:readonly ObservationReadDeclaration[];
 /** Emitted-byte calibration visible before collection starts. */
-calibration: ObservationCalibration;
+calibration:ObservationCalibration;
 /** Explicit corpus-size dependence of the cost model. */
-corpus_dependence: ObservationCorpusDependence;
+corpus_dependence:ObservationCorpusDependence;
 /** Ordered richest-to-smallest degradation ladder. */
-tiers: readonly ObservationTier[];
+tiers:readonly ObservationTier[];
 }
 /** Pre-call observation-cost description available to schedulers. */
 export interface ObservationCostDescription {
 /** Stable observation identity. */
-contract_id: string;
+contract_id:string;
 /** Observation revision. */
-contract_version: number;
+contract_version:number;
 /** Sum of all declared collection ceilings. */
-guaranteed_ceiling_tokens: number;
+guaranteed_ceiling_tokens:number;
 /** Calibrated expected serialized payload size. */
-expected_emitted_bytes: number;
+expected_emitted_bytes:number;
 /** Conservative token estimate derived from emitted bytes. */
-expected_tokens: number;
+expected_tokens:number;
 /** Accepted emitted-byte calibration drift. */
-tolerance_bytes: number;
+tolerance_bytes:number;
 /** Stable calibration basis. */
-calibration_basis: "emitted_bytes";
+calibration_basis:"emitted_bytes";
 /** Declared corpus-size dependence. */
-corpus_dependence: ObservationCorpusDependence;
+corpus_dependence:ObservationCorpusDependence;
 }
 /** Audit receipt emitted for every served or refused observation. */
 export interface ObservationReceipt {
 /** Stable observation identity. */
-contract_id: string;
+contract_id:string;
 /** Observation revision. */
-contract_version: number;
+contract_version:number;
 /** Tier whose payload was returned, or null after truthful refusal. */
-served_tier: string | null;
+served_tier:string | null;
 /** Whether a smaller tier was attempted or served. */
-degraded: boolean;
+degraded:boolean;
 /** Tier identities evaluated in deterministic order. */
-attempted_tiers: readonly string[];
+attempted_tiers:readonly string[];
 /** Exact serialized payload bytes, or null when nothing was served. */
-emitted_bytes: number | null;
+emitted_bytes:number | null;
 /** Conservative token estimate, or null when nothing was served. */
-estimated_tokens: number | null;
+estimated_tokens:number | null;
 /** Stable measurement basis. */
-calibration_basis: "emitted_bytes";
+calibration_basis:"emitted_bytes";
 }
 /** Successful bounded observation with its explicit receipt. */
 export interface ServedObservation<T> {
 /** Discriminator for a payload-bearing response. */
-status: "served";
+status:"served";
 /** Payload produced by the declared tier. */
-payload: T;
+payload:T;
 /** Cost and degradation evidence. */
-receipt: ObservationReceipt;
+receipt:ObservationReceipt;
 }
 /** Refusal returned when no declared tier can fit the caller's ceiling. */
 export interface RefusedObservation {
 /** Discriminator for a payload-free refusal. */
-status: "refused";
+status:"refused";
 /** Stable reason callers can route without parsing prose. */
-reason: "no_declared_tier_fits_budget";
+reason:"no_declared_tier_fits_budget";
 /** Cost and degradation evidence. */
-receipt: ObservationReceipt;
+receipt:ObservationReceipt;
 }
 /** Complete outcome of attempting one declared observation. */
 export type ObservationResult<T> = ServedObservation<T> | RefusedObservation;
 /** Caller-imposed ceiling for one observation response. */
 export interface ObservationRequest {
 /** Maximum response tokens accepted by the caller. */
-budget_tokens: number;
+budget_tokens:number;
 }
 /** Predicate supported by the versioned total-verdict interpreter. */
 export type VerdictPredicate = {
-readonly id: string;
-readonly kind: "field_equals";
-readonly path: string;
-readonly expected: unknown;
+readonly id:string;
+readonly kind:"field_equals";
+readonly path:string;
+readonly expected:unknown;
 } | {
-readonly id: string;
-readonly kind: "field_present";
-readonly path: string;
+readonly id:string;
+readonly kind:"field_present";
+readonly path:string;
 } | {
-readonly id: string;
-readonly kind: "field_absent";
-readonly path: string;
+readonly id:string;
+readonly kind:"field_absent";
+readonly path:string;
 };
 /** Declarative composition applied to predicate outcomes. */
 export interface VerdictComposition {
 /** Whether every or at least one referenced predicate must satisfy. */
-operator: "all" | "any";
+operator:"all" | "any";
 /** Ordered predicate identities evaluated by the total verdict. */
-predicate_ids: readonly string[];
+predicate_ids:readonly string[];
 }
 /** Portable named and versioned total-verdict declaration. */
 export interface VerdictContract {
 /** Versioned schema identity. */
-schema: typeof PM_VERDICT_SCHEMA;
+schema:typeof PM_VERDICT_SCHEMA;
 /** Stable contract identity. */
-id: string;
+id:string;
 /** Positive contract revision. */
-version: number;
+version:number;
 /** Predicates evaluated exclusively over recorded state. */
-predicates: readonly VerdictPredicate[];
+predicates:readonly VerdictPredicate[];
 /** Explicit deterministic predicate composition. */
-composition: VerdictComposition;
+composition:VerdictComposition;
 }
 /** Recorded state and stable snapshot identity supplied by an adapter. */
 export interface WorkspaceRecordedState {
 /** Stable identity of the exact state being evaluated. */
-snapshot_id: string;
+snapshot_id:string;
 /** Recorded, JSON-compatible project state. */
-state: RecordedStateObject;
+state:RecordedStateObject;
 }
 /** Per-predicate evidence in a deterministic total verdict. */
 export interface PredicateVerdict {
 /** Declared predicate identity. */
-id: string;
+id:string;
 /** Whether the predicate is satisfied by recorded state. */
-outcome: "satisfied" | "violated";
+outcome:"satisfied" | "violated";
 /** Snapshot-qualified JSON pointer to the inspected field. */
-evidence_pointer: string;
+evidence_pointer:string;
 /** Hash of the observed value without duplicating potentially private data. */
-evidence_digest: string;
+evidence_digest:string;
 }
 /** Total, reproducible result produced by a verdict contract. */
 export interface VerdictResult {
 /** Stable verdict identity. */
-contract_id: string;
+contract_id:string;
 /** Verdict revision. */
-contract_version: number;
+contract_version:number;
 /** Exact recorded-state snapshot evaluated. */
-snapshot_id: string;
+snapshot_id:string;
 /** Total outcome, including an explicit empty-contract state. */
-outcome: "satisfied" | "violated" | "not_applicable";
+outcome:"satisfied" | "violated" | "not_applicable";
 /** Satisfied fraction, or null when no predicates are declared. */
-score: number | null;
+score:number | null;
 /** Explicitly separates evaluation from reward or learning signals. */
-policy: "verdict_only_no_reward";
+policy:"verdict_only_no_reward";
 /** Stable explanation for a not-applicable verdict. */
-reason?: "no_predicates_declared";
+reason?:"no_predicates_declared";
 /** Ordered predicate evidence. */
-predicates: readonly PredicateVerdict[];
+predicates:readonly PredicateVerdict[];
 }
 /** Hard limits enforced within one isolated episode. */
 export interface EpisodeLimits {
 /** Maximum ordinary project-management actions. */
-max_actions: number;
+max_actions:number;
 /** Maximum observations, including the close-time grading read. */
-max_observations: number;
+max_observations:number;
 /** Per-observation response ceiling. */
-max_tokens_per_observation: number;
+max_tokens_per_observation:number;
 }
 /** Portable specification shared by evaluation and training harnesses. */
 export interface EpisodeSpecification {
 /** Versioned schema identity. */
-schema: typeof PM_EPISODE_SCHEMA;
+schema:typeof PM_EPISODE_SCHEMA;
 /** Stable episode identity and session provenance key. */
-id: string;
+id:string;
 /** Positive episode revision. */
-version: number;
+version:number;
 /** Consumer intent without coupling the runtime to a training framework. */
-mode: "benchmark" | "evaluation" | "training" | "scale_transfer";
+mode:"benchmark" | "evaluation" | "training" | "scale_transfer";
 /** Deterministic workspace construction recipe. */
-recipe: WorkspaceRecipe;
+recipe:WorkspaceRecipe;
 /** Canonical pm items that define the task set. */
-task_item_ids: readonly string[];
+task_item_ids:readonly string[];
 /** State fields that observations may disclose. */
-observable_fields: readonly string[];
+observable_fields:readonly string[];
 /** Grading-only fields that must never enter observations. */
-withheld_fields: readonly string[];
+withheld_fields:readonly string[];
 /** Bounded observation declaration. */
-observation: ObservationContract;
+observation:ObservationContract;
 /** Recorded-state verdict declaration. */
-verdict: VerdictContract;
+verdict:VerdictContract;
 /** Hard action and observation limits. */
-limits: EpisodeLimits;
+limits:EpisodeLimits;
 }
 /** Reset receipt returned by an episode adapter. */
 export interface EpisodeResetReceipt {
 /** Adapter-defined isolated workspace identity. */
-workspace_id: string;
+workspace_id:string;
 /** Stable state identity after reset. */
-state_id: string;
+state_id:string;
 }
 /** Action receipt returned by an episode adapter. */
 export interface EpisodeActionReceipt<TOutput> {
 /** Stable state identity after the action. */
-state_id: string;
+state_id:string;
 /** Adapter-defined ordinary command result. */
-output: TOutput;
+output:TOutput;
 }
 /** Host boundary for ordinary pm SDK actions and recorded-state reads. */
-export interface EpisodeRuntimeAdapter<TAction, TOutput = unknown> {
+export interface EpisodeRuntimeAdapter<TAction,TOutput = unknown> {
 /** Construct a fresh isolated workspace using the declared recipe. */
-reset(recipe: WorkspaceRecipe): Promise<EpisodeResetReceipt>;
+reset(recipe:WorkspaceRecipe):Promise<EpisodeResetReceipt>;
 /** Execute one ordinary action, normally by calling `PmClient.run`. */
-execute(action: TAction): Promise<EpisodeActionReceipt<TOutput>>;
+execute(action:TAction):Promise<EpisodeActionReceipt<TOutput>>;
 /** Read immutable grading state from the workspace system of record. */
-readRecordedState(): Promise<WorkspaceRecordedState>;
+readRecordedState():Promise<WorkspaceRecordedState>;
 }
 /** One deterministic entry in a portable episode trajectory. */
 export interface EpisodeTrajectoryEntry {
 /** Monotonic event number within the isolated episode. */
-sequence: number;
+sequence:number;
 /** Stable event classification. */
-kind: "reset" | "observation" | "action" | "verdict" | "close";
+kind:"reset" | "observation" | "action" | "verdict" | "close";
 /** Snapshot, state, or observation tier associated with the event. */
-state_id: string;
+state_id:string;
 }
 /** Closed episode evidence without reward or framework-specific shaping. */
 export interface ClosedEpisode {
 /** Deterministic total verdict. */
-verdict: VerdictResult;
+verdict:VerdictResult;
 /** Complete bounded trajectory. */
-trajectory: readonly EpisodeTrajectoryEntry[];
+trajectory:readonly EpisodeTrajectoryEntry[];
 /** Explicitly absent to prevent verdicts from becoming reward signals. */
-reward?: never;
+reward?:never;
 }
 /** Isolated runtime returned for one declared agent episode. */
-export interface PmEpisodeSession<TAction, TOutput> {
+export interface PmEpisodeSession<TAction,TOutput> {
 /** Observe recorded state through the declared disclosure ladder. */
-observe(): Promise<ObservationResult<RecordedStateObject>>;
+observe():Promise<ObservationResult<RecordedStateObject>>;
 /** Execute one bounded ordinary project-management action. */
-step(action: TAction): Promise<EpisodeActionReceipt<TOutput>>;
+step(action:TAction):Promise<EpisodeActionReceipt<TOutput>>;
 /** Evaluate the current recorded state without closing the session. */
-score(): Promise<VerdictResult>;
+score():Promise<VerdictResult>;
 /** Evaluate and close the episode, returning immutable evidence. */
-close(): Promise<ClosedEpisode>;
+close():Promise<ClosedEpisode>;
 }
 /** Validate, clone, and freeze a portable observation declaration. */
-export declare function defineObservationContract(declaration: ObservationContract): ObservationContract;
+export declare function defineObservationContract(declaration:ObservationContract):ObservationContract;
 /** Describe guaranteed and calibrated observation cost before collection. */
-export declare function describeObservationCost(contract: ObservationContract): ObservationCostDescription;
+export declare function describeObservationCost(contract:ObservationContract):ObservationCostDescription;
 /** Serve the richest declared tier that fits both caller and tier ceilings. */
-export declare function serveDeclaredObservation<T>(contract: ObservationContract, collect: (tier: ObservationTier) => Promise<T>, request: ObservationRequest): Promise<ObservationResult<T>>;
+export declare function serveDeclaredObservation<T>(contract:ObservationContract,collect:(tier:ObservationTier) => Promise<T>,request:ObservationRequest):Promise<ObservationResult<T>>;
 /** Validate, clone, and freeze a portable total-verdict declaration. */
-export declare function defineVerdictContract(declaration: VerdictContract): VerdictContract;
+export declare function defineVerdictContract(declaration:VerdictContract):VerdictContract;
 /** Evaluate a total verdict exclusively from one immutable recorded snapshot. */
-export declare function evaluateVerdictContract(contract: VerdictContract, recorded: WorkspaceRecordedState): VerdictResult;
+export declare function evaluateVerdictContract(contract:VerdictContract,recorded:WorkspaceRecordedState):VerdictResult;
 /** Validate, clone, and freeze a portable episode specification. */
-export declare function defineEpisodeSpecification(declaration: EpisodeSpecification): EpisodeSpecification;
+export declare function defineEpisodeSpecification(declaration:EpisodeSpecification):EpisodeSpecification;
 /** Open one isolated, deterministic episode around an adapter's ordinary actions. */
-export declare function openPmEpisode<TAction, TOutput = unknown>(specification: EpisodeSpecification, adapter: EpisodeRuntimeAdapter<TAction, TOutput>): Promise<PmEpisodeSession<TAction, TOutput>>;
+export declare function openPmEpisode<TAction,TOutput = unknown>(specification:EpisodeSpecification,adapter:EpisodeRuntimeAdapter<TAction,TOutput>):Promise<PmEpisodeSession<TAction,TOutput>>;

package/dist/sdk/environment/host-environment-errors.d.ts

@@ -2,4 +2,4 @@
  * @module sdk/host-environment-errors
  * Public SDK compatibility surface for path-redacted host filesystem refusals.
  */
-export { classifyHostEnvironmentFault, translateHostEnvironmentFault, withHostEnvironmentBoundary, type HostEnvironmentBoundaryOptions, type HostEnvironmentFaultCodeOverrides, } from "../../core/fs/host-environment-errors.js";
+export { classifyHostEnvironmentFault,translateHostEnvironmentFault,withHostEnvironmentBoundary,type HostEnvironmentBoundaryOptions,type HostEnvironmentFaultCodeOverrides,} from "../../core/fs/host-environment-errors.js";

package/dist/sdk/environment/project-runtime-compatibility.d.ts

@@ -5,79 +5,81 @@ export declare const HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN = "2026.8.31";
 /** One discovered project pin that can prove the active executable is stale. */
 export interface ProjectRuntimeVersionPin {
 /** Representative date-version extracted from the project declaration. */
-version: string;
+version:string;
 /** Redaction-safe origin of the pin. */
-source: "package.json" | "installed-package" | "package-lock.json" | "pnpm-lock.yaml" | "yarn.lock";
+source:"package.json" | "installed-package" | "package-lock.json" | "pnpm-lock.yaml" | "yarn.lock";
 /** Whether the declaration selects one runtime, a minimum, or a bounded range. */
-constraint: "exact" | "minimum" | "range";
+constraint:"exact" | "minimum" | "range";
 /** Original package declaration when it conveys more than the representative version. */
-declaration?: string;
+declaration?:string;
 /** Whether the declaration permits a reader that understands history item-hash epoch 3. */
-history_epoch_compatible?: boolean;
+history_epoch_compatible?:boolean;
 }
 /** Structured result returned by the read-only compatibility probe. */
 export interface ProjectRuntimeCompatibilityResult {
 /** Whether the invocation can write with the active runtime. */
-compatible: boolean;
+compatible:boolean;
 /** Active executable package version. */
-executing_version: string;
+executing_version:string;
 /** Highest project pin discovered without exposing local paths. */
-project_version?: string;
+project_version?:string;
 /** Origin of the highest project pin. */
-source?: ProjectRuntimeVersionPin["source"];
+source?:ProjectRuntimeVersionPin["source"];
 /** Canonical command selected from the invocation. */
-command?: string;
+command?:string;
 /** Whether the selected invocation can mutate project state. */
-mutating: boolean;
+mutating:boolean;
 /** Whether the active executable is older than the strongest project pin. */
-stale?: boolean;
+stale?:boolean;
 /** Whether this mutation would write a history epoch a project pin cannot read. */
-history_epoch_incompatible?: boolean;
+history_epoch_incompatible?:boolean;
 /** Item-hash epoch the executing runtime writes. */
-writer_item_hash_version?: 2 | 3;
+writer_item_hash_version?:2 | 3;
 /** Project runtime declaration that cannot read the writer epoch. */
-incompatible_project_version?: string;
+incompatible_project_version?:string;
 /** Origin of the incompatible project runtime declaration. */
-incompatible_source?: ProjectRuntimeVersionPin["source"];
+incompatible_source?:ProjectRuntimeVersionPin["source"];
 /** Non-blocking diagnostic attached to stale read-only invocations. */
-warning?: ProjectRuntimeCompatibilityWarning;
+warning?:ProjectRuntimeCompatibilityWarning;
 /** Whether the explicit one-invocation recovery override was accepted. */
-override_applied: boolean;
+override_applied:boolean;
 }
 /** Structured, package-manager-neutral warning returned for a stale read. */
 export interface ProjectRuntimeCompatibilityWarning {
 /** Stable warning code for filtering and automation. */
-code: "project_runtime_stale_read";
+code:"project_runtime_stale_read";
 /** Active executable package version. */
-executing_version: string;
+executing_version:string;
 /** Strongest newer project version pin. */
-project_version: string;
+project_version:string;
 /** Redaction-safe origin of the project pin. */
-source: ProjectRuntimeVersionPin["source"];
+source:ProjectRuntimeVersionPin["source"];
 /** Concise explanation of the mismatch. */
-message: string;
+message:string;
 /** Package-manager-neutral recovery actions. */
-next_steps: string[];
+next_steps:string[];
 }
 /** Compare pm date versions without accepting arbitrary semver-like prose. */
-export declare function comparePmDateVersions(left: string, right: string): number | null;
+export declare function comparePmDateVersions(left:string,right:string):number | null;
 /** Resolve the item-hash epoch written by a known pm runtime release. */
-export declare function historyItemHashVersionForRuntime(version: string): 2 | 3;
+export declare function historyItemHashVersionForRuntime(version:string):2 | 3;
 /** Discover declared, installed, and lock-resolved versions without network I/O. */
-export declare function discoverProjectRuntimeVersionPins(projectRoot: string): ProjectRuntimeVersionPin[];
+export declare function discoverProjectRuntimeVersionPins(projectRoot:string):ProjectRuntimeVersionPin[];
+/** Refuse guarded-format writes while the owning project still selects a host predating format admission. */
+export declare function assertProjectRuntimeFormatGuard(projectRoot:string,formatVersion:number):void;
 /** Classify mutation-capable invocations while preserving explicit read modes. */
-export declare function isProjectMutatingInvocation(argv: readonly string[]): boolean;
+export declare function isProjectMutatingInvocation(argv:readonly string[]):boolean;
 /** Inspect whether one invocation is compatible with the project's newest pin. */
-export declare function inspectProjectRuntimeCompatibility(options: {
-executingVersion: string;
-projectRoot: string;
-argv: readonly string[];
-allowStale?: boolean;
-}): ProjectRuntimeCompatibilityResult;
+export declare function inspectProjectRuntimeCompatibility(options:{
+executingVersion:string;
+projectRoot:string;
+argv:readonly string[];
+allowStale?:boolean;
+}):ProjectRuntimeCompatibilityResult;
 /** Refuse stale mutations with a stable SDK error and package-neutral recovery. */
-export declare function assertProjectRuntimeCompatibility(options: {
-executingVersion: string;
-projectRoot: string;
-argv: readonly string[];
-allowStale?: boolean;
-}): ProjectRuntimeCompatibilityResult;
+export declare function assertProjectRuntimeCompatibility(options:{
+executingVersion:string;
+projectRoot:string;
+argv:readonly string[];
+allowStale?:boolean;
+}):ProjectRuntimeCompatibilityResult;

package/dist/sdk/environment/project-runtime-compatibility.js

@@ -1,3 +1,3 @@
-(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]="2d40ac36-0627-5636-9679-5669dbacf06b")}catch{}})();import fs from"node:fs";import path from"node:path";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";const PACKAGE_NAME="@unbrained/pm-cli",MUTATING_COMMANDS=new Set(["append","claim","changelog","close","close-many","close-task","comments","config","copy","create","dedupe-merge","delete","deps","docs","extension","event","events","files","focus","gc","history-author-acknowledge","history-compact","history-redact","history-repair","init","install","item","learnings","meet","merge","normalize","notes","package","packages","pause-task","plan","profile","reindex","release","remind","restore","schema","start-task","test","test-all","test-runs","test-runs-worker","telemetry","templates","twin","update","update-many","upgrade","vcs","workspace"]),GLOBAL_VALUE_FLAGS=new Set(["--author","--output-budget","--output-format","--output-include","--output-limit","--output-session","--path","--pm-path"]),VERSION_PATTERN=/\b(\d{4})\.(\d{1,2})\.(\d{1,2})(?:-(\d+))?\b/u,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN="2026.8.31";function hasAnyToken(argv,tokens){return argv.some(token=>tokens.includes(token.split("=",1)[0]))}function isPackageMutation(argv,positionals){return["activate","adopt","adopt-all","deactivate","init","install","migrate","reload","uninstall"].includes(positionals[0]??"")||hasAnyToken(argv,["--activate","--adopt","--adopt-all","--deactivate","--fix-managed-state","--init","--install","--output","--reload","--scaffold","--uninstall"])}const MIXED_COMMAND_CLASSIFIERS={changelog:(argv,positionals)=>{if(positionals[0]==="generate")return!hasAnyToken(argv,["--check"]);const exportIndex=argv.indexOf("export");return positionals[0]==="export"&&(hasAnyToken(argv,["--output"])||exportIndex>=0&&argv[exportIndex+1]!==void 0&&!argv[exportIndex+1].startsWith("-"))},comments:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),config:(_argv,positionals)=>(positionals[0]==="project"||positionals[0]==="global"?positionals[1]:positionals[0])==="set",deps:()=>!1,docs:argv=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"]),duplicates:()=>!1,events:()=>!1,extension:isPackageMutation,files:(argv,positionals)=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"])||positionals[0]==="discover"&&hasAnyToken(argv,["--apply"]),health:argv=>!hasAnyToken(argv,["--check-only","--no-refresh","--skip-vectors"]),learnings:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),merge:(_argv,positionals)=>positionals[0]!=="report",notes:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),package:isPackageMutation,packages:isPackageMutation,profile:(_argv,positionals)=>positionals[0]==="apply",schema:(argv,positionals)=>["add-field","add-status","add-type","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type"].includes(positionals[0]??"")&&!(hasAnyToken(argv,["--infer"])&&!hasAnyToken(argv,["--apply"])),telemetry:(_argv,positionals)=>positionals.slice(0,2).some(token=>["clear","flush"].includes(token)),templates:(_argv,positionals)=>positionals[0]==="save",test:argv=>hasAnyToken(argv,["--add","--add-json","--background","--measure","--remove","--resume","--run","--stop"]),validate:argv=>hasAnyToken(argv,["--auto-fix","--prune-missing"]),vcs:(_argv,positionals)=>["abandon","create","merge","propose","ref-create"].includes(positionals[0]??""),workspace:(_argv,positionals)=>positionals[0]==="snapshot"&&["create","delete","restore"].includes(positionals[1]??"")};function parseDateVersion(value){const match=value.match(VERSION_PATTERN);return match?[Number(match[1]),Number(match[2]),Number(match[3]),Number(match[4]??0)]:null}function comparePmDateVersions(left,right){const leftParts=parseDateVersion(left),rightParts=parseDateVersion(right);if(!leftParts||!rightParts)return null;for(let index=0;index<leftParts.length;index+=1){const delta=leftParts[index]-rightParts[index];if(delta!==0)return Math.sign(delta)}return 0}function historyItemHashVersionForRuntime(version){return comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1?3:2}function findIncompatibleHistoryEpochPin(pins,writerItemHashVersion){if(writerItemHashVersion===3)return pins.filter(pin=>pin.history_epoch_compatible===!1).map(pin=>({...pin,declaration:pin.declaration??pin.version})).sort((left,right)=>comparePmDateVersions(left.version,right.version))[0]}function readJsonRecord(filePath){try{const parsed=JSON.parse(fs.readFileSync(filePath,"utf8"));return typeof parsed=="object"&&parsed!==null&&!Array.isArray(parsed)?parsed:null}catch{return null}}function rangeUpperBounds(alternative){const comparators=[...alternative.matchAll(/(<=|<)\s*v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/gu)].map(match=>({inclusive:match[1]==="<=",version:match[2]})),hyphen=alternative.match(/\b\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?\s+-\s+v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/u);return hyphen?[...comparators,{inclusive:!0,version:hyphen[1]}]:comparators}function analyzeHistoryEpochRange(specification){const alternativeBounds=specification.split("||").map(alternative=>rangeUpperBounds(alternative));return{bounded:alternativeBounds.some(bounds=>bounds.length>0),compatible:alternativeBounds.some(bounds=>bounds.every(bound=>{const comparison=comparePmDateVersions(HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,bound.version);return comparison!==null&&(bound.inclusive?comparison!==1:comparison===-1)}))}}function dependencyPins(packageJson){return["dependencies","devDependencies","optionalDependencies","peerDependencies"].flatMap(field=>{const dependencies=packageJson[field];if(typeof dependencies!="object"||dependencies===null)return[];const value=dependencies[PACKAGE_NAME],specification=typeof value=="string"?value.trim():"",version=/^[<!]/u.test(specification)?void 0:specification.match(VERSION_PATTERN)?.[0];if(!version)return[];const exact=/^(?:=|v)?\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?$/u.test(specification),range=analyzeHistoryEpochRange(specification);return[{version,constraint:exact?"exact":range.bounded?"range":"minimum",...exact?{}:{declaration:specification},history_epoch_compatible:exact?comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1:range.compatible}]})}function packageLockPin(projectRoot){const packages=readJsonRecord(path.join(projectRoot,"package-lock.json"))?.packages;if(typeof packages!="object"||packages===null)return;const installed=packages["node_modules/@unbrained/pm-cli"];if(typeof installed!="object"||installed===null)return;const version=installed.version;return typeof version=="string"?version:void 0}function textLockPin(projectRoot,file){try{const lines=fs.readFileSync(path.join(projectRoot,file),"utf8").split(/\r?\n/u),packageLineIndex=lines.findIndex(line=>line.includes(PACKAGE_NAME));if(packageLineIndex<0)return;const packageIndent=lines[packageLineIndex].match(/^\s*/u)[0].length,entry=[lines[packageLineIndex]];for(let index=packageLineIndex+1;index<lines.length;index+=1){const line=lines[index],trimmed=line.trim(),indent=line.match(/^\s*/u)[0].length;if(trimmed.length>0&&indent<=packageIndent)break;entry.push(line)}return entry.join(`
-`).match(/^\s*version(?::\s*|\s+)["']?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/mu)?.[1]??entry[0].match(VERSION_PATTERN)?.[0]}catch{return}}function discoverProjectRuntimeVersionPins(projectRoot){const pins=[],projectPackage=readJsonRecord(path.join(projectRoot,"package.json"));projectPackage&&pins.push(...dependencyPins(projectPackage).map(pin=>({...pin,source:"package.json"})));const installedVersion=readJsonRecord(path.join(projectRoot,"node_modules","@unbrained","pm-cli","package.json"))?.version;typeof installedVersion=="string"&&parseDateVersion(installedVersion)&&pins.push({version:installedVersion,source:"installed-package",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(installedVersion)===3});const packageLockVersion=packageLockPin(projectRoot);packageLockVersion&&parseDateVersion(packageLockVersion)&&pins.push({version:packageLockVersion,source:"package-lock.json",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(packageLockVersion)===3});for(const file of["pnpm-lock.yaml","yarn.lock"]){const version=textLockPin(projectRoot,file);version&&pins.push({version,source:file,constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(version)===3})}return pins}function commandTokenFromArgv(argv){for(let index=0;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}if(!token.startsWith("-"))return{command:token.toLowerCase(),index}}}function isProjectMutatingInvocation(argv){const commandToken=commandTokenFromArgv(argv);if(!commandToken||hasAnyToken(argv,["--help","-h","--dry-run"]))return!1;const{command,index:commandIndex}=commandToken,positionals=[];for(let index=commandIndex+1;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}token.startsWith("-")||positionals.push(token.toLowerCase())}const mixedClassifier=MIXED_COMMAND_CLASSIFIERS[command];return mixedClassifier?mixedClassifier(argv,positionals):MUTATING_COMMANDS.has(command)}function inspectProjectRuntimeCompatibility(options){const command=commandTokenFromArgv(options.argv)?.command,mutating=isProjectMutatingInvocation(options.argv),pins=discoverProjectRuntimeVersionPins(options.projectRoot).filter(pin=>comparePmDateVersions(pin.version,options.executingVersion)!==null).sort((left,right)=>comparePmDateVersions(right.version,left.version)),newest=pins[0],stale=newest!==void 0&&comparePmDateVersions(options.executingVersion,newest.version)===-1,writerItemHashVersion=historyItemHashVersionForRuntime(options.executingVersion),incompatibleEpochPin=findIncompatibleHistoryEpochPin(pins,writerItemHashVersion),historyEpochIncompatible=mutating&&incompatibleEpochPin!==void 0,warning=stale&&!mutating?{code:"project_runtime_stale_read",executing_version:options.executingVersion,project_version:newest.version,source:newest.source,message:"This read is using an older pm runtime than the project requires.",next_steps:[`Run the command through the project's installed ${PACKAGE_NAME} ${newest.version}.`,"Install the project dependencies with its declared package manager if the local executable is missing."]}:void 0;return{compatible:!mutating||!stale&&!historyEpochIncompatible||options.allowStale===!0,executing_version:options.executingVersion,...newest?{project_version:newest.version,source:newest.source}:{},...command?{command}:{},mutating,stale,history_epoch_incompatible:historyEpochIncompatible,writer_item_hash_version:writerItemHashVersion,...incompatibleEpochPin?{incompatible_project_version:incompatibleEpochPin.declaration,incompatible_source:incompatibleEpochPin.source}:{},...warning?{warning}:{},override_applied:mutating&&(stale||historyEpochIncompatible)&&options.allowStale===!0}}function assertProjectRuntimeCompatibility(options){const result=inspectProjectRuntimeCompatibility(options);if(result.compatible)return result;throw result.history_epoch_incompatible?new PmCliError(`pm ${result.executing_version} cannot write item-hash epoch ${result.writer_item_hash_version} into a project pinned to pm ${result.incompatible_project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_history_epoch_incompatible",reason:result.incompatible_source,why:`The pinned runtime cannot read item_hash_version ${result.writer_item_hash_version}; allowing the write would break its health and validation gates.`,nextSteps:[`Upgrade the project's ${PACKAGE_NAME} pin to ${HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN} or newer before mutating tracker history.`,"For an intentional coordinated migration only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]}):new PmCliError(`pm ${result.executing_version} cannot mutate a project pinned to newer pm ${result.project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_stale_mutation",reason:result.source,why:"An older runtime can write storage, history, and merge contracts it does not understand.",nextSteps:[`Run this command through the project's installed ${PACKAGE_NAME} ${result.project_version}.`,"For an intentional recovery only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]})}export{HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,PmCliError,assertProjectRuntimeCompatibility,comparePmDateVersions,discoverProjectRuntimeVersionPins,historyItemHashVersionForRuntime,inspectProjectRuntimeCompatibility,isProjectMutatingInvocation};
+(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]="19d9b802-1efa-5716-8176-ecbf5b153ff0")}catch{}})();import fs from"node:fs";import path from"node:path";import{createRequire}from"node:module";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";const PACKAGE_NAME="@unbrained/pm-cli",MUTATING_COMMANDS=new Set(["append","claim","changelog","close","close-many","close-task","comments","config","copy","create","dedupe-merge","delete","deps","docs","extension","event","events","files","focus","gc","history-author-acknowledge","history-compact","history-redact","history-repair","init","install","item","learnings","meet","merge","normalize","notes","package","packages","pause-task","plan","profile","reindex","release","remind","restore","schema","start-task","test","test-all","test-runs","test-runs-worker","telemetry","templates","twin","update","update-many","upgrade","vcs","workspace"]),GLOBAL_VALUE_FLAGS=new Set(["--author","--output-budget","--output-format","--output-include","--output-limit","--output-session","--path","--pm-path"]),VERSION_PATTERN=/\b(\d{4})\.(\d{1,2})\.(\d{1,2})(?:-(\d+))?\b/u,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN="2026.8.31";function hasAnyToken(argv,tokens){return argv.some(token=>tokens.includes(token.split("=",1)[0]))}function isPackageMutation(argv,positionals){return["activate","adopt","adopt-all","deactivate","init","install","migrate","reload","uninstall"].includes(positionals[0]??"")||hasAnyToken(argv,["--activate","--adopt","--adopt-all","--deactivate","--fix-managed-state","--init","--install","--output","--reload","--scaffold","--uninstall"])}const MIXED_COMMAND_CLASSIFIERS={changelog:(argv,positionals)=>{if(positionals[0]==="generate")return!hasAnyToken(argv,["--check"]);const exportIndex=argv.indexOf("export");return positionals[0]==="export"&&(hasAnyToken(argv,["--output"])||exportIndex>=0&&argv[exportIndex+1]!==void 0&&!argv[exportIndex+1].startsWith("-"))},comments:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),config:(_argv,positionals)=>(positionals[0]==="project"||positionals[0]==="global"?positionals[1]:positionals[0])==="set",deps:()=>!1,docs:argv=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"]),duplicates:()=>!1,events:()=>!1,extension:isPackageMutation,files:(argv,positionals)=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"])||positionals[0]==="discover"&&hasAnyToken(argv,["--apply"]),health:argv=>!hasAnyToken(argv,["--check-only","--no-refresh","--skip-vectors"]),learnings:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),merge:(_argv,positionals)=>positionals[0]!=="report",notes:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),package:isPackageMutation,packages:isPackageMutation,profile:(_argv,positionals)=>positionals[0]==="apply",schema:(argv,positionals)=>["add-field","add-status","add-type","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type"].includes(positionals[0]??"")&&!(hasAnyToken(argv,["--infer"])&&!hasAnyToken(argv,["--apply"])),telemetry:(_argv,positionals)=>positionals.slice(0,2).some(token=>["clear","flush"].includes(token)),templates:(_argv,positionals)=>positionals[0]==="save",test:argv=>hasAnyToken(argv,["--update","--update-index","--add","--add-json","--background","--measure","--remove","--resume","--run","--stop"]),validate:argv=>hasAnyToken(argv,["--auto-fix","--prune-missing"]),vcs:(_argv,positionals)=>["abandon","create","merge","propose","ref-create"].includes(positionals[0]??""),workspace:(_argv,positionals)=>positionals[0]==="snapshot"&&["create","delete","restore"].includes(positionals[1]??"")};function parseDateVersion(value){const match=value.match(VERSION_PATTERN);return match?[Number(match[1]),Number(match[2]),Number(match[3]),Number(match[4]??0)]:null}function comparePmDateVersions(left,right){const leftParts=parseDateVersion(left),rightParts=parseDateVersion(right);if(!leftParts||!rightParts)return null;for(let index=0;index<leftParts.length;index+=1){const delta=leftParts[index]-rightParts[index];if(delta!==0)return Math.sign(delta)}return 0}function historyItemHashVersionForRuntime(version){return comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1?3:2}function findIncompatibleHistoryEpochPin(pins,writerItemHashVersion){if(writerItemHashVersion===3)return pins.filter(pin=>pin.history_epoch_compatible===!1).map(pin=>({...pin,declaration:pin.declaration??pin.version})).sort((left,right)=>comparePmDateVersions(left.version,right.version))[0]}function readJsonRecord(filePath){try{const parsed=JSON.parse(fs.readFileSync(filePath,"utf8"));return typeof parsed=="object"&&parsed!==null&&!Array.isArray(parsed)?parsed:null}catch{return null}}function rangeUpperBounds(alternative){const comparators=[...alternative.matchAll(/(<=|<)\s*v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/gu)].map(match=>({inclusive:match[1]==="<=",version:match[2]})),hyphen=alternative.match(/\b\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?\s+-\s+v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/u);return hyphen?[...comparators,{inclusive:!0,version:hyphen[1]}]:comparators}function analyzeHistoryEpochRange(specification){const alternativeBounds=specification.split("||").map(alternative=>rangeUpperBounds(alternative));return{bounded:alternativeBounds.some(bounds=>bounds.length>0),compatible:alternativeBounds.some(bounds=>bounds.every(bound=>{const comparison=comparePmDateVersions(HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,bound.version);return comparison!==null&&(bound.inclusive?comparison!==1:comparison===-1)}))}}function dependencyDeclarations(packageJson){return["dependencies","devDependencies","optionalDependencies","peerDependencies"].flatMap(field=>{const dependencies=packageJson[field];if(typeof dependencies!="object"||dependencies===null)return[];const value=dependencies[PACKAGE_NAME];return typeof value=="string"?[value.trim()]:[]})}function dependencyPins(packageJson){return dependencyDeclarations(packageJson).flatMap(specification=>{const version=/^[<!]/u.test(specification)?void 0:specification.match(VERSION_PATTERN)?.[0];if(!version)return[];const exact=/^(?:=|v)?\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?$/u.test(specification),range=analyzeHistoryEpochRange(specification);return[{version,constraint:exact?"exact":range.bounded?"range":"minimum",...exact?{}:{declaration:specification},history_epoch_compatible:exact?comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1:range.compatible}]})}function packageLockPin(projectRoot){const packages=readJsonRecord(path.join(projectRoot,"package-lock.json"))?.packages;if(typeof packages!="object"||packages===null)return;const installed=packages["node_modules/@unbrained/pm-cli"];if(typeof installed!="object"||installed===null)return;const version=installed.version;return typeof version=="string"?version:void 0}function textLockPin(projectRoot,file){try{const lines=fs.readFileSync(path.join(projectRoot,file),"utf8").split(/\r?\n/u),packageLineIndex=lines.findIndex(line=>line.includes(PACKAGE_NAME));if(packageLineIndex<0)return;const packageIndent=lines[packageLineIndex].match(/^\s*/u)[0].length,entry=[lines[packageLineIndex]];for(let index=packageLineIndex+1;index<lines.length;index+=1){const line=lines[index],trimmed=line.trim(),indent=line.match(/^\s*/u)[0].length;if(trimmed.length>0&&indent<=packageIndent)break;entry.push(line)}return entry.join(`
+`).match(/^\s*version(?::\s*|\s+)["']?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/mu)?.[1]??entry[0].match(VERSION_PATTERN)?.[0]}catch{return}}function discoverProjectRuntimeVersionPins(projectRoot){const pins=[],projectPackage=readJsonRecord(path.join(projectRoot,"package.json"));projectPackage&&pins.push(...dependencyPins(projectPackage).map(pin=>({...pin,source:"package.json"})));const installedVersion=readJsonRecord(path.join(projectRoot,"node_modules","@unbrained","pm-cli","package.json"))?.version;typeof installedVersion=="string"&&parseDateVersion(installedVersion)&&pins.push({version:installedVersion,source:"installed-package",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(installedVersion)===3});const packageLockVersion=packageLockPin(projectRoot);packageLockVersion&&parseDateVersion(packageLockVersion)&&pins.push({version:packageLockVersion,source:"package-lock.json",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(packageLockVersion)===3});for(const file of["pnpm-lock.yaml","yarn.lock"]){const version=textLockPin(projectRoot,file);version&&pins.push({version,source:file,constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(version)===3})}return pins}function assertProjectRuntimeFormatGuard(projectRoot,formatVersion){if(formatVersion<=1)return;const{minVersion,lt}=createRequire(import.meta.url)("semver"),declaration=dependencyDeclarations(readJsonRecord(path.join(projectRoot,"package.json"))??{}).find(specification=>{try{const minimum=minVersion(specification);return minimum!==null&&lt(minimum,"2026.10.10")}catch{return!1}}),incompatible=declaration===void 0?discoverProjectRuntimeVersionPins(projectRoot).find(pin=>comparePmDateVersions(pin.version,"2026.10.10")===-1):{version:declaration,source:"package.json"};if(incompatible)throw new PmCliError(`The project selects pm ${incompatible.version}, which cannot safely refuse item format ${formatVersion}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_item_format_incompatible",reason:incompatible.source,required:"Upgrade project pins, installed SDKs, CI hosts and Git merge drivers before writing guarded item formats.",nextSteps:["Use a pm runtime supporting the required item format throughout the project; preserve original item and history bytes, and never re-anchor history to satisfy an older host."]})}function commandTokenFromArgv(argv){for(let index=0;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}if(!token.startsWith("-"))return{command:token.toLowerCase(),index}}}function isProjectMutatingInvocation(argv){const commandToken=commandTokenFromArgv(argv);if(!commandToken||hasAnyToken(argv,["--help","-h","--dry-run"]))return!1;const{command,index:commandIndex}=commandToken,positionals=[];for(let index=commandIndex+1;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}token.startsWith("-")||positionals.push(token.toLowerCase())}const mixedClassifier=MIXED_COMMAND_CLASSIFIERS[command];return mixedClassifier?mixedClassifier(argv,positionals):MUTATING_COMMANDS.has(command)}function inspectProjectRuntimeCompatibility(options){const command=commandTokenFromArgv(options.argv)?.command,mutating=isProjectMutatingInvocation(options.argv),pins=discoverProjectRuntimeVersionPins(options.projectRoot).filter(pin=>comparePmDateVersions(pin.version,options.executingVersion)!==null).sort((left,right)=>comparePmDateVersions(right.version,left.version)),newest=pins[0],stale=newest!==void 0&&comparePmDateVersions(options.executingVersion,newest.version)===-1,writerItemHashVersion=historyItemHashVersionForRuntime(options.executingVersion),incompatibleEpochPin=findIncompatibleHistoryEpochPin(pins,writerItemHashVersion),historyEpochIncompatible=mutating&&incompatibleEpochPin!==void 0,warning=stale&&!mutating?{code:"project_runtime_stale_read",executing_version:options.executingVersion,project_version:newest.version,source:newest.source,message:"This read is using an older pm runtime than the project requires.",next_steps:[`Run the command through the project's installed ${PACKAGE_NAME} ${newest.version}.`,"Install the project dependencies with its declared package manager if the local executable is missing."]}:void 0;return{compatible:!mutating||!stale&&!historyEpochIncompatible||options.allowStale===!0,executing_version:options.executingVersion,...newest?{project_version:newest.version,source:newest.source}:{},...command?{command}:{},mutating,stale,history_epoch_incompatible:historyEpochIncompatible,writer_item_hash_version:writerItemHashVersion,...incompatibleEpochPin?{incompatible_project_version:incompatibleEpochPin.declaration,incompatible_source:incompatibleEpochPin.source}:{},...warning?{warning}:{},override_applied:mutating&&(stale||historyEpochIncompatible)&&options.allowStale===!0}}function assertProjectRuntimeCompatibility(options){const result=inspectProjectRuntimeCompatibility(options);if(result.compatible)return result;throw result.history_epoch_incompatible?new PmCliError(`pm ${result.executing_version} cannot write item-hash epoch ${result.writer_item_hash_version} into a project pinned to pm ${result.incompatible_project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_history_epoch_incompatible",reason:result.incompatible_source,why:`The pinned runtime cannot read item_hash_version ${result.writer_item_hash_version}; allowing the write would break its health and validation gates.`,nextSteps:[`Upgrade the project's ${PACKAGE_NAME} pin to ${HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN} or newer before mutating tracker history.`,"For an intentional coordinated migration only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]}):new PmCliError(`pm ${result.executing_version} cannot mutate a project pinned to newer pm ${result.project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_stale_mutation",reason:result.source,why:"An older runtime can write storage, history, and merge contracts it does not understand.",nextSteps:[`Run this command through the project's installed ${PACKAGE_NAME} ${result.project_version}.`,"For an intentional recovery only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]})}export{HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,PmCliError,assertProjectRuntimeCompatibility,assertProjectRuntimeFormatGuard,comparePmDateVersions,discoverProjectRuntimeVersionPins,historyItemHashVersionForRuntime,inspectProjectRuntimeCompatibility,isProjectMutatingInvocation};
 //# sourceMappingURL=project-runtime-compatibility.js.map

package/dist/sdk/environment/source-context.d.ts

@@ -13,11 +13,11 @@ export type SourceContextAccessMode = "read_only" | "write";
 /** Structured policy used by SDK adapters before selecting source coordinates. */
 export interface SourceContextWritePolicy {
 /** Declared access mode, with absent legacy context retaining write behavior. */
-access: SourceContextAccessMode;
+access:SourceContextAccessMode;
 /** Whether the one-invocation write override was accepted. */
-write_override_applied: boolean;
+write_override_applied:boolean;
 /** Whether a mutation may select inherited source coordinates. */
-source_writes_allowed: boolean;
+source_writes_allowed:boolean;
 }
 /** Resolve inherited source-coordinate write policy without reading filesystem state. */
-export declare function resolveSourceContextWritePolicy(environment: Readonly<Record<string, string | undefined>>): SourceContextWritePolicy;
+export declare function resolveSourceContextWritePolicy(environment:Readonly<Record<string,string | undefined>>):SourceContextWritePolicy;