@unbrained/pm-cli 2026.10.10 → 2026.10.12

package/docs/performance/scale-100k-report.json

@@ -1,418 +1 @@
-{
-  "version": 1,
-  "generated_at": "2026-07-12T14:38:34.397Z",
-  "node_version": "v26.4.0",
-  "platform": "linux",
-  "architecture": "x64",
-  "iterations": 3,
-  "fixture": {
-    "version": 1,
-    "generated_at": "2026-07-12T14:35:41.484Z",
-    "workspace_root": "/tmp/pm-scale-benchmark-JQMrH2",
-    "pm_root": "/tmp/pm-scale-benchmark-JQMrH2/.agents/pm",
-    "item_count": 100000,
-    "history_stream_count": 100000,
-    "seed": 42,
-    "mode": "direct",
-    "generation_ms": 38993,
-    "sample_ids": {
-      "get": "pm-s0000000",
-      "open": [
-        "pm-s0000000",
-        "pm-s000000h",
-        "pm-s000000i",
-        "pm-s000000k",
-        "pm-s0000011",
-        "pm-s0000012",
-        "pm-s0000014",
-        "pm-s000001l",
-        "pm-s000001m",
-        "pm-s000001o",
-        "pm-s0000025",
-        "pm-s0000026",
-        "pm-s0000028",
-        "pm-s000002p",
-        "pm-s000002q",
-        "pm-s000002s",
-        "pm-s0000039",
-        "pm-s000003a",
-        "pm-s000003c",
-        "pm-s000003t",
-        "pm-s000003u",
-        "pm-s000003w",
-        "pm-s000004d",
-        "pm-s000004e",
-        "pm-s000004g",
-        "pm-s000004x",
-        "pm-s000004y",
-        "pm-s0000050",
-        "pm-s000005h",
-        "pm-s000005i",
-        "pm-s000005k",
-        "pm-s0000061",
-        "pm-s0000062",
-        "pm-s0000064",
-        "pm-s000006l",
-        "pm-s000006m",
-        "pm-s000006o",
-        "pm-s0000075",
-        "pm-s0000076",
-        "pm-s0000078",
-        "pm-s000007p",
-        "pm-s000007q",
-        "pm-s000007s",
-        "pm-s0000089",
-        "pm-s000008a",
-        "pm-s000008c",
-        "pm-s000008t",
-        "pm-s000008u",
-        "pm-s000008w",
-        "pm-s000009d",
-        "pm-s000009e",
-        "pm-s000009g",
-        "pm-s000009x",
-        "pm-s000009y",
-        "pm-s00000a0",
-        "pm-s00000ah",
-        "pm-s00000ai",
-        "pm-s00000ak",
-        "pm-s00000b1",
-        "pm-s00000b2",
-        "pm-s00000b4",
-        "pm-s00000bl",
-        "pm-s00000bm",
-        "pm-s00000bo",
-        "pm-s00000c5",
-        "pm-s00000c6",
-        "pm-s00000c8",
-        "pm-s00000cp",
-        "pm-s00000cq",
-        "pm-s00000cs",
-        "pm-s00000d9",
-        "pm-s00000da",
-        "pm-s00000dc",
-        "pm-s00000dt",
-        "pm-s00000du",
-        "pm-s00000dw",
-        "pm-s00000ed",
-        "pm-s00000ee",
-        "pm-s00000eg",
-        "pm-s00000ex",
-        "pm-s00000ey",
-        "pm-s00000f0",
-        "pm-s00000fh",
-        "pm-s00000fi",
-        "pm-s00000fk",
-        "pm-s00000g1",
-        "pm-s00000g2",
-        "pm-s00000g4",
-        "pm-s00000gl",
-        "pm-s00000gm",
-        "pm-s00000go",
-        "pm-s00000h5",
-        "pm-s00000h6",
-        "pm-s00000h8",
-        "pm-s00000hp",
-        "pm-s00000hq",
-        "pm-s00000hs",
-        "pm-s00000i9",
-        "pm-s00000ia",
-        "pm-s00000ic"
-      ]
-    }
-  },
-  "product_target": {
-    "target": {
-      "p95_ms": 1000,
-      "max_estimated_tokens": 5000
-    },
-    "commands": [
-      {
-        "transport": "cli",
-        "command": "list",
-        "p95_ms": 1868,
-        "max_estimated_tokens": 878,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "cli",
-        "command": "get",
-        "p95_ms": 1274,
-        "max_estimated_tokens": 257,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "cli",
-        "command": "next",
-        "p95_ms": 3724,
-        "max_estimated_tokens": 4454,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "cli",
-        "command": "context",
-        "p95_ms": 3720,
-        "max_estimated_tokens": 1292,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "cli",
-        "command": "search",
-        "p95_ms": 3464,
-        "max_estimated_tokens": 961,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "cli",
-        "command": "create",
-        "p95_ms": 682,
-        "max_estimated_tokens": 149,
-        "latency_ok": true,
-        "tokens_ok": true
-      },
-      {
-        "transport": "cli",
-        "command": "claim",
-        "p95_ms": 813,
-        "max_estimated_tokens": 303,
-        "latency_ok": true,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "list",
-        "p95_ms": 800,
-        "max_estimated_tokens": 827,
-        "latency_ok": true,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "get",
-        "p95_ms": 404,
-        "max_estimated_tokens": 230,
-        "latency_ok": true,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "next",
-        "p95_ms": 1830,
-        "max_estimated_tokens": 2920,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "context",
-        "p95_ms": 1994,
-        "max_estimated_tokens": 892,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "search",
-        "p95_ms": 1566,
-        "max_estimated_tokens": 636,
-        "latency_ok": false,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "create",
-        "p95_ms": 8,
-        "max_estimated_tokens": 112,
-        "latency_ok": true,
-        "tokens_ok": true
-      },
-      {
-        "transport": "sdk",
-        "command": "claim",
-        "p95_ms": 7,
-        "max_estimated_tokens": 235,
-        "latency_ok": true,
-        "tokens_ok": true
-      }
-    ]
-  },
-  "transports": {
-    "cli": {
-      "list": {
-        "runs": 3,
-        "p50_ms": 1760,
-        "p95_ms": 1868,
-        "min_ms": 1689,
-        "max_ms": 1868,
-        "max_peak_rss_bytes": 392499200,
-        "max_output_bytes": 3510,
-        "max_estimated_tokens": 878,
-        "warmup_ms": 29059,
-        "warmup_peak_rss_bytes": 1802010624
-      },
-      "get": {
-        "runs": 3,
-        "p50_ms": 1272,
-        "p95_ms": 1274,
-        "min_ms": 1248,
-        "max_ms": 1274,
-        "max_peak_rss_bytes": 412712960,
-        "max_output_bytes": 1028,
-        "max_estimated_tokens": 257,
-        "warmup_ms": 1208,
-        "warmup_peak_rss_bytes": 404037632
-      },
-      "next": {
-        "runs": 3,
-        "p50_ms": 3452,
-        "p95_ms": 3724,
-        "min_ms": 3360,
-        "max_ms": 3724,
-        "max_peak_rss_bytes": 576307200,
-        "max_output_bytes": 17815,
-        "max_estimated_tokens": 4454,
-        "warmup_ms": 27274,
-        "warmup_peak_rss_bytes": 1519861760
-      },
-      "context": {
-        "runs": 3,
-        "p50_ms": 3398,
-        "p95_ms": 3720,
-        "min_ms": 3117,
-        "max_ms": 3720,
-        "max_peak_rss_bytes": 561909760,
-        "max_output_bytes": 5167,
-        "max_estimated_tokens": 1292,
-        "warmup_ms": 4747,
-        "warmup_peak_rss_bytes": 496168960
-      },
-      "search": {
-        "runs": 3,
-        "p50_ms": 3348,
-        "p95_ms": 3464,
-        "min_ms": 3073,
-        "max_ms": 3464,
-        "max_peak_rss_bytes": 494133248,
-        "max_output_bytes": 3843,
-        "max_estimated_tokens": 961,
-        "warmup_ms": 31438,
-        "warmup_peak_rss_bytes": 1497698304
-      },
-      "create": {
-        "runs": 3,
-        "p50_ms": 604,
-        "p95_ms": 682,
-        "min_ms": 570,
-        "max_ms": 682,
-        "max_peak_rss_bytes": 149639168,
-        "max_output_bytes": 596,
-        "max_estimated_tokens": 149,
-        "warmup_ms": 572,
-        "warmup_peak_rss_bytes": 146526208
-      },
-      "claim": {
-        "runs": 3,
-        "p50_ms": 606,
-        "p95_ms": 813,
-        "min_ms": 530,
-        "max_ms": 813,
-        "max_peak_rss_bytes": 153124864,
-        "max_output_bytes": 1212,
-        "max_estimated_tokens": 303,
-        "warmup_ms": 1052,
-        "warmup_peak_rss_bytes": 159031296
-      }
-    },
-    "sdk": {
-      "list": {
-        "runs": 3,
-        "p50_ms": 764,
-        "p95_ms": 800,
-        "min_ms": 718,
-        "max_ms": 800,
-        "max_peak_rss_bytes": 974884864,
-        "max_output_bytes": 3305,
-        "max_estimated_tokens": 827,
-        "warmup_ms": 4268,
-        "warmup_peak_rss_bytes": 914722816
-      },
-      "get": {
-        "runs": 3,
-        "p50_ms": 369,
-        "p95_ms": 404,
-        "min_ms": 342,
-        "max_ms": 404,
-        "max_peak_rss_bytes": 1169551360,
-        "max_output_bytes": 918,
-        "max_estimated_tokens": 230,
-        "warmup_ms": 356,
-        "warmup_peak_rss_bytes": 950661120
-      },
-      "next": {
-        "runs": 3,
-        "p50_ms": 1818,
-        "p95_ms": 1830,
-        "min_ms": 1699,
-        "max_ms": 1830,
-        "max_peak_rss_bytes": 1561702400,
-        "max_output_bytes": 11679,
-        "max_estimated_tokens": 2920,
-        "warmup_ms": 4264,
-        "warmup_peak_rss_bytes": 1212788736
-      },
-      "context": {
-        "runs": 3,
-        "p50_ms": 1737,
-        "p95_ms": 1994,
-        "min_ms": 1682,
-        "max_ms": 1994,
-        "max_peak_rss_bytes": 1574739968,
-        "max_output_bytes": 3566,
-        "max_estimated_tokens": 892,
-        "warmup_ms": 1988,
-        "warmup_peak_rss_bytes": 1471062016
-      },
-      "search": {
-        "runs": 3,
-        "p50_ms": 1471,
-        "p95_ms": 1566,
-        "min_ms": 1401,
-        "max_ms": 1566,
-        "max_peak_rss_bytes": 1257529344,
-        "max_output_bytes": 2541,
-        "max_estimated_tokens": 636,
-        "warmup_ms": 4453,
-        "warmup_peak_rss_bytes": 1553682432
-      },
-      "create": {
-        "runs": 3,
-        "p50_ms": 6,
-        "p95_ms": 8,
-        "min_ms": 5,
-        "max_ms": 8,
-        "max_peak_rss_bytes": 1257951232,
-        "max_output_bytes": 447,
-        "max_estimated_tokens": 112,
-        "warmup_ms": 20,
-        "warmup_peak_rss_bytes": 1257951232
-      },
-      "claim": {
-        "runs": 3,
-        "p50_ms": 5,
-        "p95_ms": 7,
-        "min_ms": 5,
-        "max_ms": 7,
-        "max_peak_rss_bytes": 1257951232,
-        "max_output_bytes": 938,
-        "max_estimated_tokens": 235,
-        "warmup_ms": 6,
-        "warmup_peak_rss_bytes": 1257951232
-      }
-    }
-  }
-}
+{"version":1,"generated_at":"2026-07-12T14:38:34.397Z","node_version":"v26.4.0","platform":"linux","architecture":"x64","iterations":3,"fixture":{"version":1,"generated_at":"2026-07-12T14:35:41.484Z","workspace_root":"/tmp/pm-scale-benchmark-JQMrH2","pm_root":"/tmp/pm-scale-benchmark-JQMrH2/.agents/pm","item_count":100000,"history_stream_count":100000,"seed":42,"mode":"direct","generation_ms":38993,"sample_ids":{"get":"pm-s0000000","open":["pm-s0000000","pm-s000000h","pm-s000000i","pm-s000000k","pm-s0000011","pm-s0000012","pm-s0000014","pm-s000001l","pm-s000001m","pm-s000001o","pm-s0000025","pm-s0000026","pm-s0000028","pm-s000002p","pm-s000002q","pm-s000002s","pm-s0000039","pm-s000003a","pm-s000003c","pm-s000003t","pm-s000003u","pm-s000003w","pm-s000004d","pm-s000004e","pm-s000004g","pm-s000004x","pm-s000004y","pm-s0000050","pm-s000005h","pm-s000005i","pm-s000005k","pm-s0000061","pm-s0000062","pm-s0000064","pm-s000006l","pm-s000006m","pm-s000006o","pm-s0000075","pm-s0000076","pm-s0000078","pm-s000007p","pm-s000007q","pm-s000007s","pm-s0000089","pm-s000008a","pm-s000008c","pm-s000008t","pm-s000008u","pm-s000008w","pm-s000009d","pm-s000009e","pm-s000009g","pm-s000009x","pm-s000009y","pm-s00000a0","pm-s00000ah","pm-s00000ai","pm-s00000ak","pm-s00000b1","pm-s00000b2","pm-s00000b4","pm-s00000bl","pm-s00000bm","pm-s00000bo","pm-s00000c5","pm-s00000c6","pm-s00000c8","pm-s00000cp","pm-s00000cq","pm-s00000cs","pm-s00000d9","pm-s00000da","pm-s00000dc","pm-s00000dt","pm-s00000du","pm-s00000dw","pm-s00000ed","pm-s00000ee","pm-s00000eg","pm-s00000ex","pm-s00000ey","pm-s00000f0","pm-s00000fh","pm-s00000fi","pm-s00000fk","pm-s00000g1","pm-s00000g2","pm-s00000g4","pm-s00000gl","pm-s00000gm","pm-s00000go","pm-s00000h5","pm-s00000h6","pm-s00000h8","pm-s00000hp","pm-s00000hq","pm-s00000hs","pm-s00000i9","pm-s00000ia","pm-s00000ic"]}},"product_target":{"target":{"p95_ms":1000,"max_estimated_tokens":5000},"commands":[{"transport":"cli","command":"list","p95_ms":1868,"max_estimated_tokens":878,"latency_ok":false,"tokens_ok":true},{"transport":"cli","command":"get","p95_ms":1274,"max_estimated_tokens":257,"latency_ok":false,"tokens_ok":true},{"transport":"cli","command":"next","p95_ms":3724,"max_estimated_tokens":4454,"latency_ok":false,"tokens_ok":true},{"transport":"cli","command":"context","p95_ms":3720,"max_estimated_tokens":1292,"latency_ok":false,"tokens_ok":true},{"transport":"cli","command":"search","p95_ms":3464,"max_estimated_tokens":961,"latency_ok":false,"tokens_ok":true},{"transport":"cli","command":"create","p95_ms":682,"max_estimated_tokens":149,"latency_ok":true,"tokens_ok":true},{"transport":"cli","command":"claim","p95_ms":813,"max_estimated_tokens":303,"latency_ok":true,"tokens_ok":true},{"transport":"sdk","command":"list","p95_ms":800,"max_estimated_tokens":827,"latency_ok":true,"tokens_ok":true},{"transport":"sdk","command":"get","p95_ms":404,"max_estimated_tokens":230,"latency_ok":true,"tokens_ok":true},{"transport":"sdk","command":"next","p95_ms":1830,"max_estimated_tokens":2920,"latency_ok":false,"tokens_ok":true},{"transport":"sdk","command":"context","p95_ms":1994,"max_estimated_tokens":892,"latency_ok":false,"tokens_ok":true},{"transport":"sdk","command":"search","p95_ms":1566,"max_estimated_tokens":636,"latency_ok":false,"tokens_ok":true},{"transport":"sdk","command":"create","p95_ms":8,"max_estimated_tokens":112,"latency_ok":true,"tokens_ok":true},{"transport":"sdk","command":"claim","p95_ms":7,"max_estimated_tokens":235,"latency_ok":true,"tokens_ok":true}]},"transports":{"cli":{"list":{"runs":3,"p50_ms":1760,"p95_ms":1868,"min_ms":1689,"max_ms":1868,"max_peak_rss_bytes":392499200,"max_output_bytes":3510,"max_estimated_tokens":878,"warmup_ms":29059,"warmup_peak_rss_bytes":1802010624},"get":{"runs":3,"p50_ms":1272,"p95_ms":1274,"min_ms":1248,"max_ms":1274,"max_peak_rss_bytes":412712960,"max_output_bytes":1028,"max_estimated_tokens":257,"warmup_ms":1208,"warmup_peak_rss_bytes":404037632},"next":{"runs":3,"p50_ms":3452,"p95_ms":3724,"min_ms":3360,"max_ms":3724,"max_peak_rss_bytes":576307200,"max_output_bytes":17815,"max_estimated_tokens":4454,"warmup_ms":27274,"warmup_peak_rss_bytes":1519861760},"context":{"runs":3,"p50_ms":3398,"p95_ms":3720,"min_ms":3117,"max_ms":3720,"max_peak_rss_bytes":561909760,"max_output_bytes":5167,"max_estimated_tokens":1292,"warmup_ms":4747,"warmup_peak_rss_bytes":496168960},"search":{"runs":3,"p50_ms":3348,"p95_ms":3464,"min_ms":3073,"max_ms":3464,"max_peak_rss_bytes":494133248,"max_output_bytes":3843,"max_estimated_tokens":961,"warmup_ms":31438,"warmup_peak_rss_bytes":1497698304},"create":{"runs":3,"p50_ms":604,"p95_ms":682,"min_ms":570,"max_ms":682,"max_peak_rss_bytes":149639168,"max_output_bytes":596,"max_estimated_tokens":149,"warmup_ms":572,"warmup_peak_rss_bytes":146526208},"claim":{"runs":3,"p50_ms":606,"p95_ms":813,"min_ms":530,"max_ms":813,"max_peak_rss_bytes":153124864,"max_output_bytes":1212,"max_estimated_tokens":303,"warmup_ms":1052,"warmup_peak_rss_bytes":159031296}},"sdk":{"list":{"runs":3,"p50_ms":764,"p95_ms":800,"min_ms":718,"max_ms":800,"max_peak_rss_bytes":974884864,"max_output_bytes":3305,"max_estimated_tokens":827,"warmup_ms":4268,"warmup_peak_rss_bytes":914722816},"get":{"runs":3,"p50_ms":369,"p95_ms":404,"min_ms":342,"max_ms":404,"max_peak_rss_bytes":1169551360,"max_output_bytes":918,"max_estimated_tokens":230,"warmup_ms":356,"warmup_peak_rss_bytes":950661120},"next":{"runs":3,"p50_ms":1818,"p95_ms":1830,"min_ms":1699,"max_ms":1830,"max_peak_rss_bytes":1561702400,"max_output_bytes":11679,"max_estimated_tokens":2920,"warmup_ms":4264,"warmup_peak_rss_bytes":1212788736},"context":{"runs":3,"p50_ms":1737,"p95_ms":1994,"min_ms":1682,"max_ms":1994,"max_peak_rss_bytes":1574739968,"max_output_bytes":3566,"max_estimated_tokens":892,"warmup_ms":1988,"warmup_peak_rss_bytes":1471062016},"search":{"runs":3,"p50_ms":1471,"p95_ms":1566,"min_ms":1401,"max_ms":1566,"max_peak_rss_bytes":1257529344,"max_output_bytes":2541,"max_estimated_tokens":636,"warmup_ms":4453,"warmup_peak_rss_bytes":1553682432},"create":{"runs":3,"p50_ms":6,"p95_ms":8,"min_ms":5,"max_ms":8,"max_peak_rss_bytes":1257951232,"max_output_bytes":447,"max_estimated_tokens":112,"warmup_ms":20,"warmup_peak_rss_bytes":1257951232},"claim":{"runs":3,"p50_ms":5,"p95_ms":7,"min_ms":5,"max_ms":7,"max_peak_rss_bytes":1257951232,"max_output_bytes":938,"max_estimated_tokens":235,"warmup_ms":6,"warmup_peak_rss_bytes":1257951232}}}}

package/docs/schemas/extension-manifest.schema.json

@@ -1,165 +1 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://raw.githubusercontent.com/unbraind/pm-cli/main/docs/schemas/extension-manifest.schema.json",
-  "title": "pm extension manifest",
-  "description": "Schema for a pm extension's manifest.json. The loader tolerates unknown fields (including $schema), so additionalProperties stays true; only the fields listed here are read. Note: sandbox_profile and permissions are advisory, declaration-based load gates — pm does not isolate extension code at runtime (ADR pm-6ef3).",
-  "type": "object",
-  "required": ["name", "version", "entry"],
-  "additionalProperties": true,
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "Optional pointer to this schema for inline IDE validation. Ignored by the loader."
-    },
-    "name": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Unique extension name. A project-layer extension with the same name overrides a global-layer one."
-    },
-    "version": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Extension version (semver recommended)."
-    },
-    "entry": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Path to the entry module, relative to the extension directory. Must resolve inside the extension directory."
-    },
-    "priority": {
-      "type": "integer",
-      "description": "Load-order priority within a layer (lower loads first). Defaults to 100."
-    },
-    "manifest_version": {
-      "type": "integer",
-      "enum": [1, 2],
-      "description": "Optional manifest format version."
-    },
-    "pm_min_version": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Minimum compatible pm CLI version. A leading \">=\" prefix is accepted. Unmet minimums block loading.",
-      "examples": ["2026.5.0", ">=2026.5.0"]
-    },
-    "pm_max_version": {
-      "type": "string",
-      "minLength": 1,
-      "pattern": "^[^<>=~^]",
-      "description": "Maximum compatible pm CLI version as an exact version (range prefixes like >=, <, ~, ^ are rejected). Exceeding it blocks loading by default; extensions.policy.pm_max_version_exceeded_mode can relax this to warn-only.",
-      "examples": ["2026.12.31"]
-    },
-    "engines": {
-      "type": "object",
-      "description": "Engine compatibility declarations (e.g. pm, node). Every value must be a non-empty string.",
-      "additionalProperties": {
-        "type": "string",
-        "minLength": 1
-      }
-    },
-    "trusted": {
-      "type": "boolean",
-      "description": "Declares the extension as trusted for extensions.policy.trust_mode evaluation."
-    },
-    "provenance": {
-      "type": "object",
-      "description": "Optional provenance metadata used by require_provenance policy checks.",
-      "properties": {
-        "source": { "type": "string", "minLength": 1 },
-        "signature": { "type": "string", "minLength": 1 },
-        "attestation": { "type": "string", "minLength": 1 },
-        "verified": { "type": "boolean" }
-      }
-    },
-    "sandbox_profile": {
-      "type": "string",
-      "enum": ["none", "restricted", "strict"],
-      "description": "Advisory sandbox profile evaluated against declared permissions when extensions.policy.mode is active. Declaration-based load gate only — not runtime isolation (ADR pm-6ef3)."
-    },
-    "permissions": {
-      "type": "object",
-      "description": "Advisory runtime permission declarations checked against the sandbox profile. Not enforced at runtime (ADR pm-6ef3).",
-      "properties": {
-        "fs_read": { "type": "boolean" },
-        "fs_write": { "type": "boolean" },
-        "network": { "type": "boolean" },
-        "env_read": { "type": "boolean" },
-        "env_write": { "type": "boolean" },
-        "process_spawn": { "type": "boolean" }
-      }
-    },
-    "capabilities": {
-      "type": "array",
-      "description": "Capabilities the extension's registrations may use. Known: commands, renderers, hooks, schema, importers, search, parser, preflight, services (legacy aliases migration/validation map to schema). Unknown values only warn.",
-      "items": {
-        "type": "string",
-        "examples": [
-          "commands",
-          "renderers",
-          "hooks",
-          "schema",
-          "importers",
-          "search",
-          "parser",
-          "preflight",
-          "services"
-        ]
-      }
-    },
-    "activation": {
-      "type": "object",
-      "description": "Lazy-activation metadata.",
-      "properties": {
-        "commands": {
-          "type": "array",
-          "description": "Command names that trigger activation.",
-          "items": { "type": "string" }
-        }
-      }
-    },
-    "contributions": {
-      "type": "object",
-      "description": "Versioned static inventory of extension registrations. pm install derives and persists this inventory from the real activation result.",
-      "required": ["schema_version"],
-      "properties": {
-        "schema_version": { "const": 1 },
-        "commands": { "$ref": "#/definitions/stringList" },
-        "command_overrides": { "$ref": "#/definitions/stringList" },
-        "command_handlers": { "$ref": "#/definitions/stringList" },
-        "hooks": { "$ref": "#/definitions/stringList" },
-        "flag_commands": { "$ref": "#/definitions/stringList" },
-        "item_types": { "$ref": "#/definitions/stringList" },
-        "item_fields": { "$ref": "#/definitions/stringList" },
-        "relationship_kinds": { "$ref": "#/definitions/stringList" },
-        "migrations": { "$ref": "#/definitions/stringList" },
-        "profiles": { "$ref": "#/definitions/stringList" },
-        "importers": { "$ref": "#/definitions/stringList" },
-        "exporters": { "$ref": "#/definitions/stringList" },
-        "search_providers": { "$ref": "#/definitions/stringList" },
-        "vector_store_adapters": { "$ref": "#/definitions/stringList" },
-        "parser_overrides": { "$ref": "#/definitions/stringList" },
-        "service_overrides": { "$ref": "#/definitions/stringList" },
-        "renderer_overrides": { "$ref": "#/definitions/stringList" },
-        "renderer_ownership": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["format", "commands", "result_discriminator"],
-            "properties": {
-              "format": { "enum": ["toon", "json"] },
-              "commands": { "$ref": "#/definitions/stringList" },
-              "result_discriminator": { "type": "boolean" }
-            }
-          }
-        },
-        "preflight_overrides": { "type": "integer", "minimum": 0 }
-      }
-    }
-  },
-  "definitions": {
-    "stringList": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 },
-      "uniqueItems": true
-    }
-  }
-}
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://raw.githubusercontent.com/unbraind/pm-cli/main/docs/schemas/extension-manifest.schema.json","title":"pm extension manifest","description":"Schema for a pm extension's manifest.json. The loader tolerates unknown fields (including $schema), so additionalProperties stays true; only the fields listed here are read. Note: sandbox_profile and permissions are advisory, declaration-based load gates — pm does not isolate extension code at runtime (ADR pm-6ef3).","type":"object","required":["name","version","entry"],"additionalProperties":true,"properties":{"$schema":{"type":"string","description":"Optional pointer to this schema for inline IDE validation. Ignored by the loader."},"name":{"type":"string","minLength":1,"description":"Unique extension name. A project-layer extension with the same name overrides a global-layer one."},"version":{"type":"string","minLength":1,"description":"Extension version (semver recommended)."},"entry":{"type":"string","minLength":1,"description":"Path to the entry module, relative to the extension directory. Must resolve inside the extension directory."},"priority":{"type":"integer","description":"Load-order priority within a layer (lower loads first). Defaults to 100."},"manifest_version":{"type":"integer","enum":[1,2],"description":"Optional manifest format version."},"pm_min_version":{"type":"string","minLength":1,"description":"Minimum compatible pm CLI version. A leading \">=\" prefix is accepted. Unmet minimums block loading.","examples":["2026.5.0",">=2026.5.0"]},"pm_max_version":{"type":"string","minLength":1,"pattern":"^[^<>=~^]","description":"Maximum compatible pm CLI version as an exact version (range prefixes like >=, <, ~, ^ are rejected). Exceeding it blocks loading by default; extensions.policy.pm_max_version_exceeded_mode can relax this to warn-only.","examples":["2026.12.31"]},"engines":{"type":"object","description":"Engine compatibility declarations (e.g. pm, node). Every value must be a non-empty string.","additionalProperties":{"type":"string","minLength":1}},"trusted":{"type":"boolean","description":"Declares the extension as trusted for extensions.policy.trust_mode evaluation."},"provenance":{"type":"object","description":"Optional provenance metadata used by require_provenance policy checks.","properties":{"source":{"type":"string","minLength":1},"signature":{"type":"string","minLength":1},"attestation":{"type":"string","minLength":1},"verified":{"type":"boolean"}}},"sandbox_profile":{"type":"string","enum":["none","restricted","strict"],"description":"Advisory sandbox profile evaluated against declared permissions when extensions.policy.mode is active. Declaration-based load gate only — not runtime isolation (ADR pm-6ef3)."},"permissions":{"type":"object","description":"Advisory runtime permission declarations checked against the sandbox profile. Not enforced at runtime (ADR pm-6ef3).","properties":{"fs_read":{"type":"boolean"},"fs_write":{"type":"boolean"},"network":{"type":"boolean"},"env_read":{"type":"boolean"},"env_write":{"type":"boolean"},"process_spawn":{"type":"boolean"}}},"capabilities":{"type":"array","description":"Capabilities the extension's registrations may use. Known: commands, renderers, hooks, schema, importers, search, parser, preflight, services (legacy aliases migration/validation map to schema). Unknown values only warn.","items":{"type":"string","examples":["commands","renderers","hooks","schema","importers","search","parser","preflight","services"]}},"activation":{"type":"object","description":"Lazy-activation metadata.","properties":{"commands":{"type":"array","description":"Command names that trigger activation.","items":{"type":"string"}}}},"contributions":{"type":"object","description":"Versioned static inventory of extension registrations. pm install derives and persists this inventory from the real activation result.","required":["schema_version"],"properties":{"schema_version":{"const":1},"commands":{"$ref":"#/definitions/stringList"},"command_overrides":{"$ref":"#/definitions/stringList"},"command_handlers":{"$ref":"#/definitions/stringList"},"hooks":{"$ref":"#/definitions/stringList"},"flag_commands":{"$ref":"#/definitions/stringList"},"item_types":{"$ref":"#/definitions/stringList"},"item_fields":{"$ref":"#/definitions/stringList"},"relationship_kinds":{"$ref":"#/definitions/stringList"},"migrations":{"$ref":"#/definitions/stringList"},"profiles":{"$ref":"#/definitions/stringList"},"importers":{"$ref":"#/definitions/stringList"},"exporters":{"$ref":"#/definitions/stringList"},"search_providers":{"$ref":"#/definitions/stringList"},"vector_store_adapters":{"$ref":"#/definitions/stringList"},"parser_overrides":{"$ref":"#/definitions/stringList"},"service_overrides":{"$ref":"#/definitions/stringList"},"renderer_overrides":{"$ref":"#/definitions/stringList"},"renderer_ownership":{"type":"array","items":{"type":"object","required":["format","commands","result_discriminator"],"properties":{"format":{"enum":["toon","json"]},"commands":{"$ref":"#/definitions/stringList"},"result_discriminator":{"type":"boolean"}}}},"preflight_overrides":{"type":"integer","minimum":0}}}},"definitions":{"stringList":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true}}}

package/marketplace.json

@@ -1,36 +1 @@
-{
-  "name": "pm",
-  "owner": {
-    "name": "unbrained",
-    "url": "https://github.com/unbraind/pm-cli"
-  },
-  "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-  "version": "2026.10.10",
-  "plugins": [
-    {
-      "name": "pm-claude",
-      "source": "./plugins/pm-claude",
-      "description": "Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.10.10",
-      "author": {
-        "name": "unbrained",
-        "url": "https://github.com/unbraind/pm-cli"
-      },
-      "homepage": "https://github.com/unbraind/pm-cli",
-      "repository": "https://github.com/unbraind/pm-cli",
-      "license": "MIT",
-      "keywords": [
-        "pm-cli",
-        "project-management",
-        "mcp",
-        "tasks",
-        "agents",
-        "workflows",
-        "git-native",
-        "task-tracker",
-        "ai"
-      ],
-      "category": "productivity"
-    }
-  ]
-}
+{"name":"pm","owner":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"description":"Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.","version":"2026.10.12","plugins":[{"name":"pm-claude","source":"./plugins/pm-claude","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.","version":"2026.10.12","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"],"category":"productivity"}]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.10.10",
+  "version": "2026.10.12",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",