@unbrained/pm-cli 2026.7.18 → 2026.7.19

package/packages/pm-vcs/extensions/vcs/manifest.json

@@ -0,0 +1,19 @@
+{
+  "name": "builtin-vcs-exemplar",
+  "version": "0.1.0",
+  "entry": "./index.ts",
+  "priority": 0,
+  "trusted": true,
+  "sandbox_profile": "restricted",
+  "permissions": {
+    "fs_read": true,
+    "fs_write": true,
+    "network": false,
+    "env_read": false,
+    "env_write": false,
+    "process_spawn": false
+  },
+  "capabilities": ["commands", "schema", "hooks"],
+  "manifest_version": 1,
+  "pm_min_version": "2026.6.24"
+}

package/packages/pm-vcs/extensions/vcs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/packages/pm-vcs/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@unbrained/pm-vcs",
+  "version": "2026.7.19",
+  "private": true,
+  "type": "module",
+  "description": "Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.",
+  "homepage": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unbraind/pm-cli.git",
+    "directory": "packages/pm-vcs"
+  },
+  "bugs": {
+    "url": "https://github.com/unbraind/pm-cli/issues"
+  },
+  "keywords": [
+    "pm-package",
+    "sdk",
+    "vcs",
+    "event-sourcing",
+    "exemplar"
+  ],
+  "pm": {
+    "aliases": [
+      "vcs"
+    ],
+    "extensions": [
+      "extensions/vcs"
+    ],
+    "catalog": {
+      "display_name": "VCS SDK Exemplar",
+      "category": "sdk",
+      "summary": "Non-PM changeset/ref workflow proving custom schema, domain commands, hooks, history replay, and typed relationship events through public SDK contracts.",
+      "tags": [
+        "sdk",
+        "vcs",
+        "event-sourcing",
+        "graph",
+        "exemplar"
+      ],
+      "links": {
+        "docs": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs#readme",
+        "repository": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs",
+        "report": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-vcs/GAP_REPORT.md"
+      }
+    },
+    "docs": [
+      "README.md",
+      "GAP_REPORT.md"
+    ],
+    "examples": [
+      "README.md"
+    ]
+  }
+}

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.7.18",
+  "version": "2026.7.19",
   "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.7.18",
+  "version": "2026.7.19",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/dist/cli-bundle/chunks/append-JHO5K6RP.js

@@ -1,11 +0,0 @@
-import {
-  runAppend
-} from "./chunk-G6MYGULG.js";
-import "./chunk-YRYYFGV3.js";
-import "./chunk-D52ZN3BF.js";
-import "./chunk-646MQXFW.js";
-import "./chunk-WACRQ26A.js";
-export {
-  runAppend
-};
-//# sourceMappingURL=append-JHO5K6RP.js.map

package/dist/cli-bundle/chunks/chunk-2BX74BAS.js

@@ -1,125 +0,0 @@
-import {
-  parseItemDocument,
-  runActiveOnWriteHooks,
-  serializeItemDocument
-} from "./chunk-646MQXFW.js";
-import {
-  TYPE_TO_FOLDER,
-  getItemFormatFromPath,
-  getItemPath,
-  readFileIfExists,
-  removeFileIfExists,
-  writeFileAtomic
-} from "./chunk-WACRQ26A.js";
-
-// dist/core/store/item-format-migration.js
-import fs from "node:fs/promises";
-import path from "node:path";
-!(function() {
-  try {
-    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "6c9f69e8-829c-5063-be06-637f9c7bf8f0");
-  } catch (e2) {
-  }
-})();
-function alternateItemFormat(_targetFormat) {
-  return "json_markdown";
-}
-function normalizeRelativePath(pmRoot, absolutePath) {
-  return path.relative(pmRoot, absolutePath).replaceAll("\\", "/");
-}
-function errorSummary(error) {
-  return String(error).replaceAll(/[^a-zA-Z0-9._-]+/g, "_").slice(0, 120);
-}
-async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:migrate", typeToFolder = TYPE_TO_FOLDER, schema) {
-  if (targetFormat !== "toon") {
-    throw new Error("Only toon item-format migration targets are supported. Markdown item files are legacy read-only input.");
-  }
-  const migratedIds = /* @__PURE__ */ new Set();
-  const removedPaths = /* @__PURE__ */ new Set();
-  const warnings = [];
-  let scanned = 0;
-  const alternateFormat = alternateItemFormat(targetFormat);
-  const typeEntries = Object.entries(typeToFolder);
-  for (const [itemType, folder] of typeEntries) {
-    const directoryPath = path.join(pmRoot, folder);
-    let files = [];
-    try {
-      files = await fs.readdir(directoryPath);
-    } catch {
-      continue;
-    }
-    const variantsById = /* @__PURE__ */ new Map();
-    for (const file of files) {
-      const absolutePath = path.join(directoryPath, file);
-      const itemFormat = getItemFormatFromPath(absolutePath);
-      if (!itemFormat) {
-        continue;
-      }
-      const extension = path.extname(file);
-      const itemId = file.slice(0, file.length - extension.length).trim();
-      if (itemId.length === 0) {
-        continue;
-      }
-      const entry = variantsById.get(itemId) ?? {};
-      entry[itemFormat] = absolutePath;
-      variantsById.set(itemId, entry);
-    }
-    const itemIds = [...variantsById.keys()].sort((left, right) => left.localeCompare(right));
-    for (const itemId of itemIds) {
-      const variants = variantsById.get(itemId);
-      scanned += 1;
-      const alternatePath = variants[alternateFormat];
-      if (!alternatePath) {
-        continue;
-      }
-      const sourcePath = variants[targetFormat] ?? alternatePath;
-      const sourceFormat = sourcePath === variants[targetFormat] ? targetFormat : alternateFormat;
-      try {
-        const sourceRaw = await fs.readFile(sourcePath, "utf8");
-        const parsedDocument = parseItemDocument(sourceRaw, {
-          format: sourceFormat,
-          schema,
-          onWarning: (warning) => warnings.push(`item_format_migration_parse_warning:${itemId}:${warning}`)
-        });
-        const targetPath = getItemPath(pmRoot, itemType, itemId, targetFormat, typeToFolder);
-        const serializedTarget = serializeItemDocument(parsedDocument, {
-          format: targetFormat,
-          schema
-        });
-        const existingTargetRaw = await readFileIfExists(targetPath);
-        if (existingTargetRaw !== serializedTarget) {
-          await writeFileAtomic(targetPath, serializedTarget);
-          warnings.push(...await runActiveOnWriteHooks({
-            path: targetPath,
-            scope: "project",
-            op
-          }));
-          migratedIds.add(itemId);
-        }
-        await removeFileIfExists(alternatePath);
-        removedPaths.add(normalizeRelativePath(pmRoot, alternatePath));
-        warnings.push(...await runActiveOnWriteHooks({
-          path: alternatePath,
-          scope: "project",
-          op: `${op}:remove`
-        }));
-        migratedIds.add(itemId);
-      } catch (error) {
-        warnings.push(`item_format_migration_skipped:${normalizeRelativePath(pmRoot, sourcePath)}:${errorSummary(error)}`);
-      }
-    }
-  }
-  return {
-    target_format: targetFormat,
-    scanned,
-    migrated: [...migratedIds].sort((left, right) => left.localeCompare(right)),
-    removed: [...removedPaths].sort((left, right) => left.localeCompare(right)),
-    warnings
-  };
-}
-
-export {
-  migrateItemFilesToFormat
-};
-//# sourceMappingURL=chunk-2BX74BAS.js.map

package/dist/cli-bundle/chunks/chunk-2BX74BAS.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../core/store/item-format-migration.ts"],
-  "sourcesContent": ["/**\n * @module core/store/item-format-migration\n *\n * Reads and writes tracker storage with format-aware helpers for Item Format Migration.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runActiveOnWriteHooks } from \"../extensions/index.js\";\nimport {\n  readFileIfExists,\n  removeFileIfExists,\n  writeFileAtomic,\n} from \"../fs/fs-utils.js\";\nimport {\n  parseItemDocument,\n  serializeItemDocument,\n} from \"../item/item-format.js\";\nimport { TYPE_TO_FOLDER } from \"../shared/constants.js\";\nimport { getItemFormatFromPath, getItemPath } from \"./paths.js\";\nimport type {\n  ItemFormat,\n  ItemType,\n  RuntimeSchemaSettings,\n} from \"../../types/index.js\";\n\ninterface ItemPathVariants {\n  json_markdown?: string;\n  toon?: string;\n}\n\n/** Documents the item format migration result payload exchanged by command, SDK, and package integrations. */\nexport interface ItemFormatMigrationResult {\n  /** Value that configures or reports target format for this contract. */\n  target_format: ItemFormat;\n  /** Value that configures or reports scanned for this contract. */\n  scanned: number;\n  /** Value that configures or reports migrated for this contract. */\n  migrated: string[];\n  /** Value that configures or reports removed for this contract. */\n  removed: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\nfunction alternateItemFormat(_targetFormat: ItemFormat): ItemFormat {\n  return \"json_markdown\";\n}\n\nfunction normalizeRelativePath(pmRoot: string, absolutePath: string): string {\n  return path.relative(pmRoot, absolutePath).replaceAll(\"\\\\\", \"/\");\n}\n\nfunction errorSummary(error: unknown): string {\n  return String(error)\n    .replaceAll(/[^a-zA-Z0-9._-]+/g, \"_\")\n    .slice(0, 120);\n}\n\n/** Implements migrate item files to format for the public runtime surface of this module. */\nexport async function migrateItemFilesToFormat(\n  pmRoot: string,\n  targetFormat: ItemFormat,\n  op = \"item_format:migrate\",\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemFormatMigrationResult> {\n  if (targetFormat !== \"toon\") {\n    throw new Error(\n      \"Only toon item-format migration targets are supported. Markdown item files are legacy read-only input.\",\n    );\n  }\n  const migratedIds = new Set<string>();\n  const removedPaths = new Set<string>();\n  const warnings: string[] = [];\n  let scanned = 0;\n  const alternateFormat = alternateItemFormat(targetFormat);\n  const typeEntries = Object.entries(typeToFolder) as Array<[ItemType, string]>;\n\n  for (const [itemType, folder] of typeEntries) {\n    const directoryPath = path.join(pmRoot, folder);\n    let files: string[] = [];\n    try {\n      files = await fs.readdir(directoryPath);\n    } catch {\n      continue;\n    }\n\n    const variantsById = new Map<string, ItemPathVariants>();\n    for (const file of files) {\n      const absolutePath = path.join(directoryPath, file);\n      const itemFormat = getItemFormatFromPath(absolutePath);\n      if (!itemFormat) {\n        continue;\n      }\n      const extension = path.extname(file);\n      const itemId = file.slice(0, file.length - extension.length).trim();\n      if (itemId.length === 0) {\n        continue;\n      }\n      const entry = variantsById.get(itemId) ?? {};\n      entry[itemFormat] = absolutePath;\n      variantsById.set(itemId, entry);\n    }\n\n    const itemIds = [...variantsById.keys()].sort((left, right) =>\n      left.localeCompare(right),\n    );\n    for (const itemId of itemIds) {\n      const variants = variantsById.get(itemId) as ItemPathVariants;\n      scanned += 1;\n      // Items already present only in the target format need no migration: there\n      // is no legacy alternate-format file to convert or remove. Skip the\n      // read/parse/serialize/compare round-trip for them. This is the dominant\n      // cost of the pre-mutation format sync, which runs on every mutation and\n      // would otherwise re-parse the entire corpus (O(items)) each time.\n      const alternatePath = variants[alternateFormat];\n      if (!alternatePath) {\n        continue;\n      }\n      const sourcePath = variants[targetFormat] ?? alternatePath;\n      const sourceFormat =\n        sourcePath === variants[targetFormat] ? targetFormat : alternateFormat;\n      try {\n        const sourceRaw = await fs.readFile(sourcePath, \"utf8\");\n        const parsedDocument = parseItemDocument(sourceRaw, {\n          format: sourceFormat,\n          schema,\n          onWarning: (warning) =>\n            warnings.push(\n              `item_format_migration_parse_warning:${itemId}:${warning}`,\n            ),\n        });\n        const targetPath = getItemPath(\n          pmRoot,\n          itemType,\n          itemId,\n          targetFormat,\n          typeToFolder,\n        );\n        const serializedTarget = serializeItemDocument(parsedDocument, {\n          format: targetFormat,\n          schema,\n        });\n        const existingTargetRaw = await readFileIfExists(targetPath);\n        if (existingTargetRaw !== serializedTarget) {\n          await writeFileAtomic(targetPath, serializedTarget);\n          warnings.push(\n            ...(await runActiveOnWriteHooks({\n              path: targetPath,\n              scope: \"project\",\n              op,\n            })),\n          );\n          migratedIds.add(itemId);\n        }\n\n        // The legacy alternate (.md) was enumerated from disk above and is always\n        // a distinct path from the .toon target, so once the parse succeeds we\n        // remove it unconditionally. removeFileIfExists tolerates a concurrently\n        // removed file, so no pre-check is needed.\n        await removeFileIfExists(alternatePath);\n        removedPaths.add(normalizeRelativePath(pmRoot, alternatePath));\n        warnings.push(\n          ...(await runActiveOnWriteHooks({\n            path: alternatePath,\n            scope: \"project\",\n            op: `${op}:remove`,\n          })),\n        );\n        migratedIds.add(itemId);\n      } catch (error) {\n        warnings.push(\n          `item_format_migration_skipped:${normalizeRelativePath(pmRoot, sourcePath)}:${errorSummary(error)}`,\n        );\n      }\n    }\n  }\n\n  return {\n    target_format: targetFormat,\n    scanned,\n    migrated: [...migratedIds].sort((left, right) => left.localeCompare(right)),\n    removed: [...removedPaths].sort((left, right) => left.localeCompare(right)),\n    warnings,\n  };\n}\n"],
-  "mappings": "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",
-  "names": []
-}