@unbrained/pm-cli 2026.8.23 → 2026.8.24

package/packages/pm-guide-shell/extensions/guide-shell/index.ts

@@ -93,6 +93,8 @@ function guideCommand(): CommandDefinition {
   return {
     name: "guide",
     action: "guide",
+    tier: "core",
+    family: "context",
     description: "Show migration and usage guidance for pm command families.",
     intent: "Read focused local guidance for one pm workflow.",
     arguments: [
@@ -108,6 +110,8 @@ function completionCommand(): CommandDefinition {
   return {
     name: "completion",
     action: "completion",
+    tier: "standard",
+    family: "automation",
     description: "Generate shell completion scripts for bash, zsh, and fish.",
     intent: "Generate a completion script for the selected shell.",
     arguments: [
@@ -127,6 +131,8 @@ function completionTagsCommand(): CommandDefinition {
   return {
     name: "completion-tags",
     action: "completion-tags",
+    tier: "internal",
+    family: "internal",
     description: "Print known tags for completion filters.",
     intent: "List tag values for lazy shell completion.",
     run: async (context) => runCompletionTagsPackage(context.global),
@@ -137,6 +143,8 @@ function completionStatusesCommand(): CommandDefinition {
   return {
     name: "completion-statuses",
     action: "completion-statuses",
+    tier: "internal",
+    family: "internal",
     description: "Print runtime status IDs for completion filters.",
     intent: "List runtime status values for shell completion.",
     run: async (context) => runCompletionStatusesPackage(context.global),
@@ -147,6 +155,8 @@ function completionTypesCommand(): CommandDefinition {
   return {
     name: "completion-types",
     action: "completion-types",
+    tier: "internal",
+    family: "internal",
     description: "Print runtime item type IDs for completion filters.",
     intent: "List runtime item types for shell completion.",
     run: async (context) => runCompletionTypesPackage(context.global),

package/packages/pm-guide-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm package for guide and shell completion workflows.",

package/packages/pm-kanban/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-kanban",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.",

package/packages/pm-lifecycle-hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-lifecycle-hooks",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

package/packages/pm-linked-test-adapters/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-linked-test-adapters",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

package/packages/pm-search-advanced/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm package for semantic, hybrid, and reindex search workflows.",

package/packages/pm-templates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-templates",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm package for reusable create templates.",

package/packages/pm-todos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-todos",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",

package/packages/pm-vcs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-vcs-sdk-exemplar",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.",

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-claude",
   "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-codex",
-  "version": "2026.8.23",
+  "version": "2026.8.24",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/scripts/generate-agent-capability-surfaces.mjs

@@ -6,7 +6,20 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { renderPmCommandVisibilityMarkdown } from "../dist/sdk/agent-capability-contracts.js";
+import {
+  renderPmCapabilityRoutingMarkdown,
+  renderPmCommandVisibilityMarkdown,
+} from "../dist/sdk/agent-capability-contracts.js";
+import { listCoreClosedDomainContracts } from "../dist/sdk/agent/closed-domain-contracts.js";
+import {
+  buildPmRefusalClosureCensus,
+  renderPmRefusalClosureCensusMarkdown,
+} from "../dist/sdk/agent/refusal-closure-census.js";
+import {
+  listPmRequiredArgumentRefusalContracts,
+  listPmSubcommandRefusalContracts,
+} from "../dist/sdk/agent/refusal-corpus-contracts.js";
+import { PM_ERROR_CODE_CATALOG } from "../dist/sdk/generated-error-code-catalog.js";
 import { renderPmFlagLexiconMarkdown } from "../dist/sdk/cli-contracts/flag-lexicon-contracts.js";
 
 const repositoryRoot = path.resolve(
@@ -17,9 +30,22 @@ export async function main(
   root = repositoryRoot,
   args = process.argv.slice(2),
 ) {
+  const refusalClosureCensus = buildPmRefusalClosureCensus(
+    PM_ERROR_CODE_CATALOG,
+    listCoreClosedDomainContracts(),
+    [
+      ...listPmRequiredArgumentRefusalContracts(),
+      ...listPmSubcommandRefusalContracts(),
+    ],
+  );
   const outputs = [
     ["AGENT_COMMAND_SURFACE.md", renderPmCommandVisibilityMarkdown()],
+    ["AGENT_CAPABILITY_ROUTING.md", renderPmCapabilityRoutingMarkdown()],
     ["FLAG_LEXICON_BUDGETS.md", renderPmFlagLexiconMarkdown()],
+    [
+      "REFUSAL_CLOSURE_CENSUS.md",
+      renderPmRefusalClosureCensusMarkdown(refusalClosureCensus),
+    ],
   ];
   if (args.includes("--check")) {
     for (const [filename, expected] of outputs) {

package/sdk/public-surface.json

@@ -1108,6 +1108,79 @@
       ],
       "package_version": "2026.8.22",
       "reason": "Additive optional provenance_invalid marker preserves fail-closed storage state without widening the existing provenance source_kind union; two trust helpers are newly exported for CLI-consumer parity."
+    },
+    {
+      "changes": [
+        "signature ./sdk:CommandDefinition",
+        "signature ./sdk:RegisteredExtensionCommandDefinition",
+        "signature ./sdk/authoring:CommandDefinition"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Add optional tier and family metadata to extension command definitions while preserving existing producer call shapes; expose additive explicit-registry projections and refusal-census contracts."
+    },
+    {
+      "changes": [
+        "signature ./sdk:WorkspaceExtensionCommandContract",
+        "signature ./sdk/runtime:WorkspaceExtensionCommandContract"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Require tier and family metadata on projected workspace extension command contracts so every consumer receives explicit visibility and capability routing."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmCommandCapabilityFamily"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Capability-family literals are unchanged; the public alias now derives from the canonical extension metadata contract to prevent type drift."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmBulkMutationFilterOptions",
+        "signature ./sdk/contracts:PmBulkMutationFilterOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Bulk mutation ids now also accept source-compatible readonly string arrays."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE",
+        "signature ./sdk:PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Refusal closure ratchets now include three executable bulk ID input states."
+    },
+    {
+      "changes": [
+        "signature ./sdk:CliFlagInvocationContract",
+        "signature ./sdk/contracts:CliFlagInvocationContract"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Expose the optional file_token_prefix metadata field for @path CLI inputs; existing consumers remain source-compatible"
+    },
+    {
+      "changes": [
+        "signature ./sdk:normalizeBulkIdsValue",
+        "signature ./sdk:PmBulkMutationFilterOptions",
+        "signature ./sdk/contracts:PmBulkMutationFilterOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Restore source-compatible numeric scalar IDs while retaining transport-native ID arrays"
+    },
+    {
+      "changes": [
+        "signature ./sdk:normalizeBulkIdsValue",
+        "signature ./sdk:PmBulkMutationFilterOptions",
+        "signature ./sdk/contracts:PmBulkMutationFilterOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Expand bulk ID contracts to finite numeric array members and fail closed on unsupported explicit selectors"
+    },
+    {
+      "changes": [
+        "signature ./sdk:HistoryCompactBulkCommandOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Align history-compaction SDK ID inputs with bulk transport contracts and fail closed on invalid explicit selectors"
     }
   ],
   "entrypoints": {
@@ -2788,6 +2861,12 @@
           "name": "buildPmActionToolInputSchema",
           "signature": "(action: PmToolAction, options?: PmActionToolInputSchemaOptions) => Record<string, unknown> | calls: (action: PmToolAction, options?: PmActionToolInputSchemaOptions) => Record<string, unknown>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "buildPmRefusalClosureCensus",
+          "signature": "(catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]) => PmRefusalClosureCensusReport | calls: (catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]) => PmRefusalClosureCensusReport"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -2878,6 +2957,30 @@
           "name": "BuiltinCorpusShapeName",
           "signature": "export type BuiltinCorpusShapeName = \"scratch\" | \"representative\" | \"deep-graph\" | \"multi-decade\" | \"disconnected-archive\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "BulkIdsFileReader",
+          "signature": "export type BulkIdsFileReader = (path: string) => Promise<string>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "BulkIdsInputReaders",
+          "signature": "export interface BulkIdsInputReaders { readFile?: BulkIdsFileReader; readStdin?: BulkIdsStdinReader; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "BulkIdsStdinReader",
+          "signature": "export type BulkIdsStdinReader = (optionName: string) => Promise<string>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "BulkIdsValue",
+          "signature": "export type BulkIdsValue = string | number | readonly (string | number)[] | undefined;"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -3128,7 +3231,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "CliFlagInvocationContract",
-          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; }"
+          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; file_token_prefix?: \"@\"; }"
         },
         {
           "classification": "contract_data",
@@ -3356,7 +3459,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommandDefinition",
-          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; family?: ExtensionCommandCapabilityFamily; }"
         },
         {
           "classification": "contract_data",
@@ -7124,7 +7227,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "HistoryCompactBulkCommandOptions",
-          "signature": "export interface HistoryCompactBulkCommandOptions { ids?: string[]; scope?: HistoryCompactScope; allOver?: number; minEntries?: number; dryRun?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface HistoryCompactBulkCommandOptions { ids?: BulkIdsValue; scope?: HistoryCompactScope; allOver?: number; minEntries?: number; dryRun?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -8818,6 +8921,12 @@
           "name": "normalizeBootstrapInvocation",
           "signature": "(argv: string[]) => BootstrapInvocationNormalizationResult | calls: (argv: string[]) => BootstrapInvocationNormalizationResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "normalizeBulkIdsValue",
+          "signature": "(value: BulkIdsValue) => string | undefined | calls: (value: BulkIdsValue) => string | undefined"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -9274,6 +9383,12 @@
           "name": "parseBootstrapTypeValue",
           "signature": "(argv: string[]) => string | undefined | calls: (argv: string[]) => string | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "parseBulkIdsText",
+          "signature": "(raw: string) => string[] | calls: (raw: string) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -10144,6 +10259,18 @@
           "name": "PM_RECOVERY_REFERENCE_KINDS",
           "signature": "readonly [\"suggested_retry\", \"candidate_command\", \"example\", \"next_step\", \"migration_hint\", \"restore_with\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE",
+          "signature": "readonly [\"bulk_ids_input_empty\", \"bulk_ids_input_missing_path\", \"bulk_ids_input_unreadable\", \"invalid_argument_value\", \"missing_lifecycle_target\", \"missing_required_argument\", \"projection_options_mutually_exclusive\", \"tracker_not_initialized\", \"tracker_root_missing\", \"tracker_root_not_directory\", \"tracker_root_unreadable\", \"unknown_context_intent\", \"unknown_field_projection\", \"unknown_option\", \"unknown_subcommand\"]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE",
+          "signature": "16"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -10244,7 +10371,7 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmBulkMutationFilterOptions",
-          "signature": "export type PmBulkMutationFilterOptions = OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>;"
+          "signature": "export type PmBulkMutationFilterOptions = Omit<OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>, \"ids\"> & { ids?: string | number | readonly (string | number)[]; };"
         },
         {
           "classification": "supported",
@@ -10370,7 +10497,7 @@
           "classification": "advanced_export",
           "kind": "type",
           "name": "PmCommandCapabilityFamily",
-          "signature": "export type PmCommandCapabilityFamily = \"workspace\" | \"intake\" | \"context\" | \"lifecycle\" | \"evidence\" | \"graph\" | \"quality\" | \"automation\" | \"extensions\" | \"internal\";"
+          "signature": "export type PmCommandCapabilityFamily = ExtensionCommandCapabilityFamily;"
         },
         {
           "classification": "contract_data",
@@ -11080,6 +11207,18 @@
           "name": "PmRecoveryReferenceSemantics",
           "signature": "export type PmRecoveryReferenceSemantics = \"recovery\" | \"replacement\" | \"behavior_preserving\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalClosureCensusReport",
+          "signature": "export interface PmRefusalClosureCensusReport { ok: boolean; catalog_error_code_count: number; executable_error_code_count: number; uncovered_error_code_count: number; coverage_fraction: number; closed_domain_probe_count: number; grammar_probe_count: number; uncovered_error_codes: string[]; rows: PmRefusalClosureCensusRow[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalClosureCensusRow",
+          "signature": "export interface PmRefusalClosureCensusRow { code: string; canonical_code: string; disposition: \"executable\" | \"uncovered\"; evidence_kinds: PmRefusalEvidenceKind[]; probe_ids: string[]; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -11098,6 +11237,12 @@
           "name": "PmRefusalClosureReport",
           "signature": "export interface PmRefusalClosureReport { ok: boolean; probe_count: number; closed_probe_count: number; closure_fraction: number; findings: readonly PmRefusalClosureFinding[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "PmRefusalEvidenceKind",
+          "signature": "export type PmRefusalEvidenceKind = \"owned_state\" | \"closed_domain\" | \"grammar\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -11278,6 +11423,18 @@
           "name": "prepareSimilarityText",
           "signature": "(value: string) => PreparedSimilarityText | calls: (value: string) => PreparedSimilarityText"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "preserveMutationStdinTokenFields",
+          "signature": "<T extends object>(options: T, fields: readonly PropertyKey[]) => T | calls: <T extends object>(options: T, fields: readonly PropertyKey[]) => T"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "preserveMutationStdinTokenLiterals",
+          "signature": "<T extends object>(options: T) => T | calls: <T extends object>(options: T) => T"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -12146,7 +12303,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "RegisteredExtensionCommandDefinition",
-          "signature": "export interface RegisteredExtensionCommandDefinition { layer: ExtensionLayer; name: string; source_package?: string; command: string; action: string; description?: string; intent?: string; examples: string[]; failure_hints: string[]; arguments: ExtensionCommandArgumentDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface RegisteredExtensionCommandDefinition { layer: ExtensionLayer; name: string; source_package?: string; command: string; action: string; description?: string; intent?: string; examples: string[]; failure_hints: string[]; arguments: ExtensionCommandArgumentDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; family?: ExtensionCommandCapabilityFamily; }"
         },
         {
           "classification": "supported",
@@ -13006,6 +13163,12 @@
           "name": "renderPmFlagLexiconMarkdown",
           "signature": "() => string | calls: () => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "renderPmRefusalClosureCensusMarkdown",
+          "signature": "(report: PmRefusalClosureCensusReport) => string | calls: (report: PmRefusalClosureCensusReport) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13168,6 +13331,12 @@
           "name": "resolveClaimPrincipal",
           "signature": "(author: string) => string | calls: (author: string) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveCliBulkIdsInput",
+          "signature": "(value: string | undefined, optionName?: string, readers?: BulkIdsInputReaders) => Promise<string | undefined> | calls: (value: string | undefined, optionName?: string, readers?: BulkIdsInputReaders) => Promise<string | undefined>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -15496,6 +15665,18 @@
           "name": "shouldPersistDurableGraphCache",
           "signature": "(itemCount: number, envelopeExists: boolean) => boolean | calls: (itemCount: number, envelopeExists: boolean) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "shouldResolveMutationStdinTokenField",
+          "signature": "(options: object, field: PropertyKey) => boolean | calls: (options: object, field: PropertyKey) => boolean"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "shouldResolveMutationStdinTokens",
+          "signature": "(options: object) => boolean | calls: (options: object) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -16402,6 +16583,12 @@
           "name": "toReplayDocument",
           "signature": "(document: ItemDocument) => ReplayDocument | calls: (document: ItemDocument) => ReplayDocument"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "transferMutationStdinTokenPolicy",
+          "signature": "<T extends object>(source: object, target: T) => T | calls: <T extends object>(source: object, target: T) => T"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -16816,6 +17003,18 @@
           "name": "verifyPmRecoveryReferences",
           "signature": "(obligations: readonly PmRecoveryReferenceObligation[], observations: readonly PmRecoveryReferenceObservation[]) => PmRecoveryReferenceReport | calls: (obligations: readonly PmRecoveryReferenceObligation[], observations: readonly PmRecoveryReferenceObservation[]) => PmRecoveryReferenceReport"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyPmRefusalClosureIdentityRatchet",
+          "signature": "(report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]) => { ok: boolean; required_canonical_codes: string[]; missing_required_canonical_codes: string[]; } | calls: (report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]) => { ok: boolean; required_canonical_codes: string[]; missing_required_canonical_codes: string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyPmRefusalClosureRatchet",
+          "signature": "(report: PmRefusalClosureCensusReport, baseline?: number) => { ok: boolean; baseline: number; actual: number; } | calls: (report: PmRefusalClosureCensusReport, baseline?: number) => { ok: boolean; baseline: number; actual: number; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -16892,7 +17091,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "WorkspaceExtensionCommandContract",
-          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; family: PmCommandCapabilityFamily; }"
         },
         {
           "classification": "advanced_export",
@@ -17276,7 +17475,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommandDefinition",
-          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; family?: ExtensionCommandCapabilityFamily; }"
         },
         {
           "classification": "supported",
@@ -18710,7 +18909,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "CliFlagInvocationContract",
-          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; }"
+          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; file_token_prefix?: \"@\"; }"
         },
         {
           "classification": "contract_data",
@@ -19682,7 +19881,7 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmBulkMutationFilterOptions",
-          "signature": "export type PmBulkMutationFilterOptions = OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>;"
+          "signature": "export type PmBulkMutationFilterOptions = Omit<OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>, \"ids\"> & { ids?: string | number | readonly (string | number)[]; };"
         },
         {
           "classification": "contract_data",
@@ -29600,7 +29799,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "WorkspaceExtensionCommandContract",
-          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; family: PmCommandCapabilityFamily; }"
         },
         {
           "classification": "advanced_export",
@@ -30225,6 +30424,9 @@
     "body_file_missing_path",
     "body_file_unreadable",
     "budget_exceeded",
+    "bulk_ids_input_empty",
+    "bulk_ids_input_missing_path",
+    "bulk_ids_input_unreadable",
     "bundle_integrity_torn_install",
     "capability_undeclared",
     "capability_unused",
@@ -30364,6 +30566,8 @@
     "malformed_plan_step_evidence",
     "manifest_capabilities_absent",
     "manifest_unknown_key",
+    "mcp_annotation_file_unavailable",
+    "mcp_stdin_unavailable",
     "merge_conflict_markers_detected",
     "merge_decisions_unreviewed",
     "merge_git_config_unwritable",