@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/lifecycle-completion.d.ts

@@ -3,43 +3,43 @@
  *
  * Resolves actual-completion timestamps and plans evidence-only legacy backfills.
  */
-import type { HistoryEntry, ItemMetadata } from "../types/index.js";
+import type { HistoryEntry,ItemMetadata } from "../types/index.js";
 /** Provenance of the timestamp selected for completion-aware reporting. */
 export type CompletionTimestampSource = "completed_at" | "closed_at" | "updated_at";
 /** A resolved completion timestamp together with its explicit compatibility source. */
 export interface ResolvedCompletionTimestamp {
 /** Discriminator proving that timestamp and source are present. */
-resolved: true;
+resolved:true;
 /** ISO timestamp selected for reporting. */
-timestamp: string;
+timestamp:string;
 /** Metadata field that supplied the timestamp. */
-source: CompletionTimestampSource;
+source:CompletionTimestampSource;
 /** Whether a legacy fallback was required. */
-fallback: boolean;
+fallback:boolean;
 }
 /** Explicit outcome when legacy metadata contains no completion timestamp. */
 export interface UnresolvedCompletionTimestamp {
 /** Discriminator proving that no metadata field supplied a timestamp. */
-resolved: false;
+resolved:false;
 /** Resolved-only timestamp is impossible on this branch. */
-timestamp?: never;
+timestamp?:never;
 /** Resolved-only provenance is impossible on this branch. */
-source?: never;
+source?:never;
 /** Fallback disclosure is meaningful only after a field supplied a value. */
-fallback?: never;
+fallback?:never;
 }
 /** Exhaustive completion-time resolution result. */
 export type CompletionTimestampResolution = ResolvedCompletionTimestamp | UnresolvedCompletionTimestamp;
 /** One lossless backfill supported by terminal-transition history evidence. */
 export interface CompletedAtBackfillCandidate {
 /** Item whose missing completed_at can be corrected. */
-id: string;
+id:string;
 /** Evidence-backed timestamp proposed for completed_at. */
-completed_at: string;
+completed_at:string;
 /** History operation that recorded the terminal transition. */
-history_op: string;
+history_op:string;
 }
 /** Resolve reporting time while disclosing every legacy fallback. */
-export declare function resolveCompletionTimestamp(item: Partial<Pick<ItemMetadata, "completed_at" | "closed_at" | "updated_at">>): CompletionTimestampResolution;
+export declare function resolveCompletionTimestamp(item:Partial<Pick<ItemMetadata,"completed_at" | "closed_at" | "updated_at">>):CompletionTimestampResolution;
 /** Plan only backfills proven by a transition into a terminal status. */
-export declare function planCompletedAtBackfill(items: readonly ItemMetadata[], historyById: ReadonlyMap<string, readonly HistoryEntry[]>, terminalStatuses: ReadonlySet<string>): CompletedAtBackfillCandidate[];
+export declare function planCompletedAtBackfill(items:readonly ItemMetadata[],historyById:ReadonlyMap<string,readonly HistoryEntry[]>,terminalStatuses:ReadonlySet<string>):CompletedAtBackfillCandidate[];

package/dist/sdk/lifecycle-policy.d.ts

@@ -1,91 +1,101 @@
-import { type PmCliErrorRecoveryPayload } from "../core/shared/errors.js";
 import type { ItemMetadata } from "../types/index.js";
 /** The author-controlled field from which a terminal reason was derived. */
 export type TerminalReasonSource = "explicit" | "duplicate" | "resolution" | "message" | "none";
 /** Controls lifecycle semantics independently of CLI flag parsing. */
 export interface TerminalTransitionPolicy {
 /** Refuse terminal transitions that do not carry an author-controlled reason. */
-requireCloseReason: boolean;
+requireCloseReason:boolean;
 /** Decide whether predecessor edges remain queryable after terminal transition. */
-orderingEdges: "preserve" | "remove";
+orderingEdges:"preserve" | "remove";
 }
 /** Presentation-independent options for the public close-item operation. */
 export interface CloseOperationOptions {
 /** Author recorded in immutable history. */
-author?: string;
+author?:string;
 /** Human-readable history message. */
-message?: string;
+message?:string;
 /** Closure validation mode. */
-validateClose?: string;
+validateClose?:string;
 /** Permit an intentional repeat terminal transition. */
-force?: boolean;
+force?:boolean;
 /** Structured resolution evidence. */
-resolution?: string;
+resolution?:string;
 /** Expected outcome evidence. */
-expectedResult?: string;
+expectedResult?:string;
 /** Actual outcome evidence. */
-actualResult?: string;
+actualResult?:string;
 /** Canonical item when closing a duplicate. */
-duplicateOf?: string;
+duplicateOf?:string;
 /** Actual completion time, distinct from tracker mutation time. */
-completedAt?: string;
+completedAt?:string;
 /** SDK-only lifecycle overrides; CLI and MCP use workspace defaults. */
-lifecyclePolicy?: Partial<TerminalTransitionPolicy>;
+lifecyclePolicy?:Partial<TerminalTransitionPolicy>;
 }
 /** Result returned by the public close-item operation. */
 export interface CloseOperationResult {
 /** Closed item projected as a stable record. */
-item: Record<string, unknown>;
+item:Record<string,unknown>;
 /** Metadata fields changed by the transition. */
-changed_fields: string[];
+changed_fields:string[];
 /** Evidence-only update guidance when a successful warning close leaves acceptance fields missing. */
-recovery?: PmCliErrorRecoveryPayload;
+follow_up?:CloseEvidenceFollowUp;
 /** Validation and lifecycle policy receipts. */
-warnings: string[];
+warnings:string[];
+}
+/** Optional evidence completion after a successful, durable close. */
+export interface CloseEvidenceFollowUp {
+/** Close succeeded; this guidance does not request another close attempt. */
+kind:"complete_close_evidence";
+/** Only the evidence flags that remain missing. */
+missing:string[];
+/** Readable evidence-only update command. */
+suggested_command:string;
+/** Authoritative argument vector retaining the tracker and item identity. */
+suggested_command_args:string[];
 }
 /** Candidate author-controlled sources for one terminal transition reason. */
 export interface TerminalReasonInput {
 /** Explicit reason supplied by the operation caller. */
-explicit?: string;
+explicit?:string;
 /** Canonical item id when this transition closes a duplicate. */
-duplicateOf?: string;
+duplicateOf?:string;
 /** Structured resolution supplied by the caller. */
-resolution?: string;
+resolution?:string;
 /** History message supplied by the caller. */
-message?: string;
+message?:string;
 }
 /** Resolved terminal reason together with durable source provenance. */
 export interface TerminalReasonResolution {
 /** Normalized author-controlled reason, if one was supplied. */
-closeReason?: string;
+closeReason?:string;
 /** Field that supplied the resolved reason. */
-source: TerminalReasonSource;
+source:TerminalReasonSource;
 }
 /** Presentation context used to make terminal-policy recovery actionable. */
 export interface TerminalReasonRecoveryContext {
 /** Operation whose input failed terminal-reason governance. */
-operation: "close" | "create";
+operation:"close" | "create";
 /** Terminal status requested by a create operation. */
-status?: string;
+status?:string;
 }
 /** Result of applying ordering-edge lifecycle policy to mutable item metadata. */
 export interface TerminalOrderingMutation {
 /** Metadata fields changed by the policy. */
-changedFields: string[];
+changedFields:string[];
 /** Agent-readable policy receipts emitted by the operation. */
-warnings: string[];
+warnings:string[];
 }
 /** Default terminal policy shared by CLI, SDK, and MCP operations. */
-export declare const DEFAULT_TERMINAL_TRANSITION_POLICY: Readonly<TerminalTransitionPolicy>;
+export declare const DEFAULT_TERMINAL_TRANSITION_POLICY:Readonly<TerminalTransitionPolicy>;
 /** Resolve the first author-controlled terminal reason in canonical precedence order. */
-export declare function resolveTerminalReason(input: TerminalReasonInput): TerminalReasonResolution;
+export declare function resolveTerminalReason(input:TerminalReasonInput):TerminalReasonResolution;
 /** Enforce close-reason governance without inventing immutable history content. */
-export declare function requireTerminalReason(input: TerminalReasonInput, required: boolean): TerminalReasonResolution;
+export declare function requireTerminalReason(input:TerminalReasonInput,required:boolean):TerminalReasonResolution;
 /** Enforce close-reason governance with recovery for a specific operation. */
-export declare function requireTerminalReasonWithRecovery(input: TerminalReasonInput, required: boolean, recovery: TerminalReasonRecoveryContext): TerminalReasonResolution;
+export declare function requireTerminalReasonWithRecovery(input:TerminalReasonInput,required:boolean,recovery:TerminalReasonRecoveryContext):TerminalReasonResolution;
 /**
  * Apply terminal ordering policy while clearing only transient blocked-state
  * scalars. Preserving `blocked_by` dependency rows keeps predecessor history
  * available to graph traversal after the dependent item closes.
  */
-export declare function applyTerminalOrderingPolicy(metadata: ItemMetadata, policy: Pick<TerminalTransitionPolicy, "orderingEdges">): TerminalOrderingMutation;
+export declare function applyTerminalOrderingPolicy(metadata:ItemMetadata,policy:Pick<TerminalTransitionPolicy,"orderingEdges">):TerminalOrderingMutation;

package/dist/sdk/lifecycle-policy.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]="8f7d8635-ea1c-5c87-9001-bfa1d1618478")}catch{}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";const DEFAULT_TERMINAL_TRANSITION_POLICY=Object.freeze({requireCloseReason:!0,orderingEdges:"preserve"});function resolveTerminalReason(input){const candidates=[{source:"explicit",value:input.explicit},{source:"duplicate",value:input.duplicateOf===void 0?void 0:`Duplicate of ${input.duplicateOf}`},{source:"resolution",value:input.resolution},{source:"message",value:input.message}];for(const candidate of candidates){const normalized=candidate.value?.trim();if(normalized)return{closeReason:normalized,source:candidate.source}}return{source:"none"}}function requireTerminalReason(input,required){return requireTerminalReasonWithRecovery(input,required,{operation:"close"})}function requireTerminalReasonWithRecovery(input,required,recovery){const resolution=resolveTerminalReason(input);if(!required||resolution.closeReason!==void 0)return resolution;const examples=recovery.operation==="create"?[`pm create --title "<title>" --type <type> --status ${recovery.status??"closed"} --close-reason "<closing summary>"`,`pm create --title "<title>" --type <type> --status ${recovery.status??"closed"} --resolution "<resolution summary>"`,"pm create --stdin-json < item.json"]:['pm close <id> "Done: <what changed and why>"','pm close <id> --reason "<closing summary>"','pm close <id> -m "<closing summary>"',"pm close <id> --duplicate-of <canonical-id>"];throw new PmCliError("Close reason text is required because governance.require_close_reason is enabled",EXIT_CODE.USAGE,{code:"close_reason_required",required:"Provide an author-controlled closing summary as the reason, message, resolution, or duplicate target.",why:"governance.require_close_reason is enabled, so tools must not invent immutable closure evidence.",examples,nextSteps:[`Re-run the ${recovery.operation} operation with a closing summary.`,"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled"]})}function applyTerminalOrderingPolicy(metadata,policy){const previousBlockedBy=typeof metadata.blocked_by=="string"?metadata.blocked_by.trim():"",hadBlockedBy=metadata.blocked_by!==void 0,dependencies=metadata.dependencies??[],predecessorEdges=dependencies.filter(dependency=>dependency.kind==="blocked_by"),hadBlockedReason=metadata.blocked_reason!==void 0,changedFields=[];if(hadBlockedBy&&(delete metadata.blocked_by,changedFields.push("blocked_by")),hadBlockedReason&&(delete metadata.blocked_reason,changedFields.push("blocked_reason")),policy.orderingEdges==="remove"&&predecessorEdges.length>0){const removed=new Set(predecessorEdges),retained=dependencies.filter(dependency=>!removed.has(dependency));retained.length>0?metadata.dependencies=retained:delete metadata.dependencies,changedFields.push("dependencies")}if(policy.orderingEdges==="remove")return{changedFields,warnings:[...previousBlockedBy?[`closed_cleared_blocked_by:${metadata.id}:${previousBlockedBy}`]:[],...predecessorEdges.length>0?[`closed_removed_predecessors:${metadata.id}:${predecessorEdges.map(edge=>edge.id).join(",")}`,`closed_removed_predecessors_count:${metadata.id}:${predecessorEdges.length}`]:[]]};const blockerIds=[...new Set([...previousBlockedBy?[previousBlockedBy]:[],...predecessorEdges.map(dependency=>dependency.id)])];return blockerIds.length===0?{changedFields,warnings:[]}:{changedFields,warnings:[`closed_preserved_predecessors:${metadata.id}:${blockerIds.join(",")}`]}}export{DEFAULT_TERMINAL_TRANSITION_POLICY,applyTerminalOrderingPolicy,requireTerminalReason,requireTerminalReasonWithRecovery,resolveTerminalReason};
+(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]="8e07b07a-fde3-5173-bb7c-7e8ade88570c")}catch{}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";const DEFAULT_TERMINAL_TRANSITION_POLICY=Object.freeze({requireCloseReason:!0,orderingEdges:"preserve"});function resolveTerminalReason(input){const candidates=[{source:"explicit",value:input.explicit},{source:"duplicate",value:input.duplicateOf===void 0?void 0:`Duplicate of ${input.duplicateOf}`},{source:"resolution",value:input.resolution},{source:"message",value:input.message}];for(const candidate of candidates){const normalized=candidate.value?.trim();if(normalized)return{closeReason:normalized,source:candidate.source}}return{source:"none"}}function requireTerminalReason(input,required){return requireTerminalReasonWithRecovery(input,required,{operation:"close"})}function requireTerminalReasonWithRecovery(input,required,recovery){const resolution=resolveTerminalReason(input);if(!required||resolution.closeReason!==void 0)return resolution;const examples=recovery.operation==="create"?[`pm create --title "<title>" --type <type> --status ${recovery.status??"closed"} --close-reason "<closing summary>"`,`pm create --title "<title>" --type <type> --status ${recovery.status??"closed"} --resolution "<resolution summary>"`,"pm create --stdin-json < item.json"]:['pm close <id> "Done: <what changed and why>"','pm close <id> --reason "<closing summary>"','pm close <id> -m "<closing summary>"',"pm close <id> --duplicate-of <canonical-id>"];throw new PmCliError("Close reason text is required because governance.require_close_reason is enabled",EXIT_CODE.USAGE,{code:"close_reason_required",required:"Provide an author-controlled closing summary as the reason, message, resolution, or duplicate target.",why:"governance.require_close_reason is enabled, so tools must not invent immutable closure evidence.",examples,nextSteps:[`Re-run the ${recovery.operation} operation with a closing summary.`,"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled"]})}function applyTerminalOrderingPolicy(metadata,policy){const previousBlockedBy=typeof metadata.blocked_by=="string"?metadata.blocked_by.trim():"",hadBlockedBy=metadata.blocked_by!==void 0,dependencies=metadata.dependencies??[],predecessorEdges=dependencies.filter(dependency=>dependency.kind==="blocked_by"),hadBlockedReason=metadata.blocked_reason!==void 0,changedFields=[];if(hadBlockedBy&&(delete metadata.blocked_by,changedFields.push("blocked_by")),hadBlockedReason&&(delete metadata.blocked_reason,changedFields.push("blocked_reason")),policy.orderingEdges==="remove"&&predecessorEdges.length>0){const removed=new Set(predecessorEdges),retained=dependencies.filter(dependency=>!removed.has(dependency));retained.length>0?metadata.dependencies=retained:delete metadata.dependencies,changedFields.push("dependencies")}if(policy.orderingEdges==="remove")return{changedFields,warnings:[...previousBlockedBy?[`closed_cleared_blocked_by:${metadata.id}:${previousBlockedBy}`]:[],...predecessorEdges.length>0?[`closed_removed_predecessors:${metadata.id}:${predecessorEdges.map(edge=>edge.id).join(",")}`,`closed_removed_predecessors_count:${metadata.id}:${predecessorEdges.length}`]:[]]};const blockerIds=[...new Set([...previousBlockedBy?[previousBlockedBy]:[],...predecessorEdges.map(dependency=>dependency.id)])];return blockerIds.length===0?{changedFields,warnings:[]}:{changedFields,warnings:[`closed_preserved_predecessors:${metadata.id}:${blockerIds.join(",")}`]}}export{DEFAULT_TERMINAL_TRANSITION_POLICY,applyTerminalOrderingPolicy,requireTerminalReason,requireTerminalReasonWithRecovery,resolveTerminalReason};
 //# sourceMappingURL=lifecycle-policy.js.map

package/dist/sdk/linked-artifacts.d.ts

@@ -3,137 +3,137 @@ import type { LinkScope } from "../types/index.js";
 /** Restricts linked artifact values accepted by command, SDK, and storage contracts. */
 export type LinkedArtifact = {
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports scope for this contract. */
-scope: LinkScope;
+scope:LinkScope;
 /** Value that configures or reports note for this contract. */
-note?: string;
+note?:string;
 };
 /** Allowed CSV/markdown keys for each structured linked-artifact option (GH-258). */
-export declare const LINKED_ARTIFACT_ADD_KEYS: readonly ["path", "scope", "note"];
+export declare const LINKED_ARTIFACT_ADD_KEYS:readonly ["path","scope","note"];
 /** Public contract for linked artifact add glob keys, shared by SDK and presentation-layer consumers. */
-export declare const LINKED_ARTIFACT_ADD_GLOB_KEYS: readonly ["pattern", "glob", "path", "scope", "note"];
+export declare const LINKED_ARTIFACT_ADD_GLOB_KEYS:readonly ["pattern","glob","path","scope","note"];
 /** Public contract for linked artifact remove keys, shared by SDK and presentation-layer consumers. */
-export declare const LINKED_ARTIFACT_REMOVE_KEYS: readonly ["path"];
+export declare const LINKED_ARTIFACT_REMOVE_KEYS:readonly ["path"];
 /** Public contract for linked artifact migrate keys, shared by SDK and presentation-layer consumers. */
-export declare const LINKED_ARTIFACT_MIGRATE_KEYS: readonly ["from", "to"];
+export declare const LINKED_ARTIFACT_MIGRATE_KEYS:readonly ["from","to"];
 /** Documents the linked artifact command options payload exchanged by command, SDK, and package integrations. */
 export interface LinkedArtifactCommandOptions {
 /** Value that configures or reports add for this contract. */
-add?: string[];
+add?:string[];
 /** Value that configures or reports add glob for this contract. */
-addGlob?: string[];
+addGlob?:string[];
 /** Value that configures or reports remove for this contract. */
-remove?: string[];
+remove?:string[];
 /** Value that configures or reports migrate for this contract. */
-migrate?: string[];
+migrate?:string[];
 /** GH-170 (pm-pfnx): standalone note applied to every link added by --add / --add-glob in the same invocation. A per-entry embedded note (the `path=...,note=...` pair syntax) takes precedence over this flag. Requires at least one --add/--add-glob; rejected otherwise. */
-note?: string;
+note?:string;
 /** Value that configures or reports list for this contract. */
-list?: boolean;
+list?:boolean;
 /** Value that configures or reports append stable for this contract. */
-appendStable?: boolean;
+appendStable?:boolean;
 /** Value that configures or reports validate paths for this contract. */
-validatePaths?: boolean;
+validatePaths?:boolean;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports force for this contract. */
-force?: boolean;
+force?:boolean;
 }
 /** Documents the path migration payload exchanged by command, SDK, and package integrations. */
 export interface PathMigration {
 /** Value that configures or reports from for this contract. */
-from: string;
+from:string;
 /** Value that configures or reports to for this contract. */
-to: string;
+to:string;
 }
 /** Documents the add glob entry payload exchanged by command, SDK, and package integrations. */
 export interface AddGlobEntry {
 /** Value that configures or reports pattern for this contract. */
-pattern: string;
+pattern:string;
 /** Value that configures or reports scope for this contract. */
-scope: LinkScope;
+scope:LinkScope;
 /** Value that configures or reports note for this contract. */
-note?: string;
+note?:string;
 }
 /** Documents the linked path validation payload exchanged by command, SDK, and package integrations. */
 export interface LinkedPathValidation {
 /** Value that configures or reports checked for this contract. */
-checked: number;
+checked:number;
 /** Value that configures or reports existing files for this contract. */
-existing_files: string[];
+existing_files:string[];
 /** Value that configures or reports missing paths for this contract. */
-missing_paths: string[];
+missing_paths:string[];
 /** Value that configures or reports non file paths for this contract. */
-non_file_paths: string[];
+non_file_paths:string[];
 /** Remote references (https:// URLs and other `scheme://` paths) recorded as links — most often a PR/issue/design-doc URL added via `pm docs --add`. These are not local files, so they bypass the existence probe and are reported here rather than counted as missing. */
-remote_references: string[];
+remote_references:string[];
 }
 /** Documents the linked artifact result payload exchanged by command, SDK, and package integrations. */
 export interface LinkedArtifactResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports changed for this contract. */
-changed: boolean;
+changed:boolean;
 /** Value that configures or reports count for this contract. */
-count: number;
+count:number;
 /** Value that configures or reports migrations applied for this contract. */
-migrations_applied?: number;
+migrations_applied?:number;
 /** Value that configures or reports validation for this contract. */
-validation?: LinkedPathValidation;
+validation?:LinkedPathValidation;
 /** Value that configures or reports artifacts for this contract. */
-artifacts: LinkedArtifact[];
+artifacts:LinkedArtifact[];
 }
 /** Replaces the generic artifacts field with a resource-specific result key while retaining the remaining result contract. */
-export type RenamedLinkedArtifactResult<Result extends LinkedArtifactResult, Key extends "files" | "docs"> = Omit<Result, "artifacts"> & {
-[Field in Key]: Result["artifacts"];
+export type RenamedLinkedArtifactResult<Result extends LinkedArtifactResult,Key extends "files" | "docs"> = Omit<Result,"artifacts"> & {
+[Field in Key]:Result["artifacts"];
 };
 /** Configuration that adapts the shared linked-artifact command core to a specific resource kind (files or docs) while preserving every behavioral detail of the original twin implementations. */
 export interface LinkedArtifactKindConfig {
 /** Metadata key under which the artifacts are stored (e.g. "files" | "docs"). */
-metadataKey: "files" | "docs";
+metadataKey:"files" | "docs";
 /** Mutation op recorded in history (e.g. "files_add" | "docs_add"). */
-op: "files_add" | "docs_add";
+op:"files_add" | "docs_add";
 /** Noun used in the "bare <noun> path" --add usage error (e.g. "file" | "doc"). */
-bareNoun: "file" | "doc";
+bareNoun:"file" | "doc";
 /** Whether this kind honors the append-stable option. files supports it; docs always sorts and must never expose append-stable behavior. */
-supportsAppendStable: boolean;
+supportsAppendStable:boolean;
 }
 /** Implements ensure scope for the public runtime surface of this module. */
-export declare function ensureScope(raw: string | undefined): LinkScope;
+export declare function ensureScope(raw:string | undefined):LinkScope;
 /** Implements looks like structured path entry for the public runtime surface of this module. */
-export declare function looksLikeStructuredPathEntry(raw: string): boolean;
+export declare function looksLikeStructuredPathEntry(raw:string):boolean;
 /** Implements parse add entries for the public runtime surface of this module. */
-export declare function parseAddEntries(raw: string[] | undefined, bareNoun: "file" | "doc"): LinkedArtifact[];
+export declare function parseAddEntries(raw:string[] | undefined,bareNoun:"file" | "doc"):LinkedArtifact[];
 /** Implements parse add glob entries for the public runtime surface of this module. */
-export declare function parseAddGlobEntries(raw: string[] | undefined): AddGlobEntry[];
+export declare function parseAddGlobEntries(raw:string[] | undefined):AddGlobEntry[];
 /** Implements parse remove entries for the public runtime surface of this module. */
-export declare function parseRemoveEntries(raw: string[] | undefined): string[];
+export declare function parseRemoveEntries(raw:string[] | undefined):string[];
 /** Implements parse migrate entries for the public runtime surface of this module. */
-export declare function parseMigrateEntries(raw: string[] | undefined): PathMigration[];
+export declare function parseMigrateEntries(raw:string[] | undefined):PathMigration[];
 /** Implements apply path migrations for the public runtime surface of this module. */
-export declare function applyPathMigrations(artifactPath: string, migrations: PathMigration[]): string;
+export declare function applyPathMigrations(artifactPath:string,migrations:PathMigration[]):string;
 /** Reject a transaction that resolves the same linked path into both add and remove sets. */
-export declare function assertLinkedArtifactMutationIsUnambiguous(adds: LinkedArtifact[], removes: string[], migrations?: PathMigration[]): void;
+export declare function assertLinkedArtifactMutationIsUnambiguous(adds:LinkedArtifact[],removes:string[],migrations?:PathMigration[]):void;
 /** Implements normalize linked path for the public runtime surface of this module. */
-export declare function normalizeLinkedPath(value: string): string;
+export declare function normalizeLinkedPath(value:string):string;
 /** Anchor a local linked path to the project workspace while preserving remote references and absolute paths. */
-export declare function anchorLinkedPath(value: string, workspaceRoot: string, invocationRoot?: string): string;
+export declare function anchorLinkedPath(value:string,workspaceRoot:string,invocationRoot?:string):string;
 /** Match files from the invocation directory, then anchor and sort each entry while retaining its scope and note. Literal directories never expand recursively. */
-export declare function expandAddGlobEntries(entries: AddGlobEntry[], workspaceRoot?: string, invocationRoot?: string): Promise<LinkedArtifact[]>;
+export declare function expandAddGlobEntries(entries:AddGlobEntry[],workspaceRoot?:string,invocationRoot?:string):Promise<LinkedArtifact[]>;
 /** GH-170 (pm-pfnx): apply a standalone --note to the links added in this invocation. Semantics (documented on pm-pfnx): the note is attached to EVERY entry added via --add/--add-glob so a single flag annotates the whole batch predictably; a per-entry embedded `note=` wins over the standalone flag; and --note without any --add/--add-glob flag is a usage error because there is nothing to annotate (it never retro-edits existing links). `hasAddFlags` reflects flag presence, not match count, so a glob that legitimately matches zero files is not an error. */
-export declare function applyStandaloneNote(adds: LinkedArtifact[], note: string | undefined, hasAddFlags: boolean): LinkedArtifact[];
+export declare function applyStandaloneNote(adds:LinkedArtifact[],note:string | undefined,hasAddFlags:boolean):LinkedArtifact[];
 /** Implements artifact key for the public runtime surface of this module. */
-export declare function artifactKey(value: Pick<LinkedArtifact, "path" | "scope">): string;
+export declare function artifactKey(value:Pick<LinkedArtifact,"path" | "scope">):string;
 /** Implements sort linked artifacts for the public runtime surface of this module. */
-export declare function sortLinkedArtifacts(artifacts: LinkedArtifact[]): LinkedArtifact[];
+export declare function sortLinkedArtifacts(artifacts:LinkedArtifact[]):LinkedArtifact[];
 /** Implements dedupe linked artifacts for the public runtime surface of this module. */
-export declare function dedupeLinkedArtifacts(artifacts: LinkedArtifact[]): LinkedArtifact[];
+export declare function dedupeLinkedArtifacts(artifacts:LinkedArtifact[]):LinkedArtifact[];
 /** Implements validate linked paths for the public runtime surface of this module. */
-export declare function validateLinkedPaths(paths: string[], workspaceRoot?: string): Promise<LinkedPathValidation>;
+export declare function validateLinkedPaths(paths:string[],workspaceRoot?:string):Promise<LinkedPathValidation>;
 /** Shared linked-artifact list/mutate command core used by runFiles and runDocs. The kind config selects metadata key, op, bare-path noun, and whether append-stable ordering is honored, preserving each twin's exact semantics. */
-export declare function runLinkedArtifacts(id: string, options: LinkedArtifactCommandOptions, global: GlobalOptions, config: LinkedArtifactKindConfig): Promise<LinkedArtifactResult>;
+export declare function runLinkedArtifacts(id:string,options:LinkedArtifactCommandOptions,global:GlobalOptions,config:LinkedArtifactKindConfig):Promise<LinkedArtifactResult>;
 /** Re-key the generic `artifacts` field to the resource-specific name (files/docs) while preserving the original key order and presence so kind-specific result shapes (and their deterministic JSON key ordering) stay byte-identical. */
-export declare function renameArtifactsResultKey<Result extends LinkedArtifactResult, const Key extends "files" | "docs">(result: Result, key: Key): RenamedLinkedArtifactResult<Result, Key>;
+export declare function renameArtifactsResultKey<Result extends LinkedArtifactResult,const Key extends "files" | "docs">(result:Result,key:Key):RenamedLinkedArtifactResult<Result,Key>;

package/dist/sdk/mcp/apps.d.ts

@@ -1,64 +1,64 @@
 import { type PmMcpRequestContext } from "./protocol.js";
 interface McpUiToolMeta {
 /** MCP App resource displayed for this tool. */
-resourceUri: string;
+resourceUri:string;
 /** Principals allowed to discover and invoke the tool. */
-visibility: Array<"model" | "app">;
+visibility:Array<"model" | "app">;
 }
 interface McpUiResourceMeta {
 /** Explicitly bounded network and embedding policy. */
-csp: {
-connectDomains: string[];
-resourceDomains: string[];
-frameDomains: string[];
+csp:{
+connectDomains:string[];
+resourceDomains:string[];
+frameDomains:string[];
 };
 /** Browser permissions requested by the app. */
-permissions: Record<string, never>;
+permissions:Record<string,never>;
 /** Whether the host should present a visible app boundary. */
-prefersBorder: boolean;
+prefersBorder:boolean;
 }
 /** Stable MCP Apps extension identifier. */
-export declare const PM_MCP_APPS_EXTENSION: "io.modelcontextprotocol/ui";
+export declare const PM_MCP_APPS_EXTENSION:"io.modelcontextprotocol/ui";
 /** Stable MCP Apps specification revision implemented by pm. */
-export declare const PM_MCP_APPS_SPEC_VERSION: "2026-01-26";
+export declare const PM_MCP_APPS_SPEC_VERSION:"2026-01-26";
 /** Official MIME type for MCP App HTML resources. */
-export declare const PM_MCP_APP_MIME_TYPE: "text/html;profile=mcp-app";
+export declare const PM_MCP_APP_MIME_TYPE:"text/html;profile=mcp-app";
 /** Server-side MCP Apps capability advertised through discovery. */
-export declare const PM_MCP_APPS_SERVER_CAPABILITY: Readonly<{
-specVersion: "2026-01-26";
-mimeTypes: "text/html;profile=mcp-app"[];
+export declare const PM_MCP_APPS_SERVER_CAPABILITY:Readonly<{
+specVersion:"2026-01-26";
+mimeTypes:"text/html;profile=mcp-app"[];
 }>;
 /**
  * Resolve whether a request negotiated MCP Apps, rejecting malformed explicit
  * declarations instead of silently serving a different extension revision.
  */
-export declare function hasPmMcpAppsCapability(context: PmMcpRequestContext): boolean;
+export declare function hasPmMcpAppsCapability(context:PmMcpRequestContext):boolean;
 /** One optional pm view and the authoritative tool that supplies its data. */
 export interface PmMcpAppContract {
 /** Stable view identifier. */
-id: "context" | "graph" | "plan" | "assurance" | "operations";
+id:"context" | "graph" | "plan" | "assurance" | "operations";
 /** Human-readable view name. */
-name: string;
+name:string;
 /** Concise purpose shown during resource discovery. */
-description: string;
+description:string;
 /** Existing SDK-backed tool whose result the view renders. */
-toolName: string;
+toolName:string;
 /** Stable MCP App resource URI. */
-uri: string;
+uri:string;
 /** Tool metadata validated against the official MCP Apps package types. */
-toolMeta: McpUiToolMeta;
+toolMeta:McpUiToolMeta;
 /** Resource sandbox and presentation metadata. */
-resourceMeta: McpUiResourceMeta;
+resourceMeta:McpUiResourceMeta;
 }
 /** Canonical optional pm MCP Apps. */
-export declare const PM_MCP_APP_CONTRACTS: readonly PmMcpAppContract[];
+export declare const PM_MCP_APP_CONTRACTS:readonly PmMcpAppContract[];
 /** Return the app contract for a resource URI. */
-export declare function findPmMcpAppByUri(uri: string): PmMcpAppContract | undefined;
+export declare function findPmMcpAppByUri(uri:string):PmMcpAppContract | undefined;
 /** Attach negotiated MCP App metadata to matching tool definitions. */
 export declare function decoratePmMcpToolsWithApps<Tool extends {
-name: string;
-_meta?: Record<string, unknown>;
-}>(tools: readonly Tool[]): Tool[];
+name:string;
+_meta?:Record<string,unknown>;
+}>(tools:readonly Tool[]):Tool[];
 /**
  * Render a self-contained, sandbox-compatible MCP App document.
  *
@@ -66,5 +66,5 @@ _meta?: Record<string, unknown>;
  * the authoritative tool input/result from the host, bounds large rendering,
  * and presents the text fallback when structured content is unavailable.
  */
-export declare function renderPmMcpAppHtml(contract: PmMcpAppContract): string;
+export declare function renderPmMcpAppHtml(contract:PmMcpAppContract):string;
 export {};