From 3ff73c5254cd9ff9a41c0c73aff17843cda167b7 Mon Sep 17 00:00:00 2001 From: Stefano Guerrini Date: Tue, 2 Jun 2026 14:36:53 +0200 Subject: [PATCH] chore: add Claude Code marketplace manifest for 0.5.4 Adds `.claude-plugin/marketplace.json` so the repo is installable as a Claude Code plugin marketplace. Without this file, the existing `.claude-plugin/plugin.json` is invisible to `/plugin install` flows; users get "Marketplace not found" errors when trying to install the plugin. Also aligns `.claude-plugin/plugin.json` `version` field with the rest of the repo. The plugin manifest had been stuck at 0.4.0 since the 0.4.0 release even though `package.json` and `memory/pam.version.json` bumped through 0.5.0, 0.5.1, 0.5.2, and 0.5.3. After 0.5.4 lands: /plugin marketplace add github:NestDevLab/portable-agent-memory /plugin install pam@portable-agent-memory Bumps `package.json`, `memory/pam.version.json`, and `.claude-plugin/plugin.json` to 0.5.4; adds `claudeMarketplaceManifest` feature flag and the required `migrations/0.5.3-to-0.5.4-marketplace-manifest.md` migration guide so `migrations:check` stays clean. Rebased twice as main absorbed the LLM-retrieval-benchmark (0.5.1), benchmark-threshold-gate (0.5.2), and tight-benchmark-regression-gate (0.5.3) patch slots in succession. --- .claude-plugin/marketplace.json | 13 ++++ .claude-plugin/plugin.json | 2 +- CHANGELOG.md | 32 ++++++++++ memory/pam.version.json | 5 +- .../0.5.3-to-0.5.4-marketplace-manifest.md | 63 +++++++++++++++++++ package.json | 2 +- 6 files changed, 113 insertions(+), 4 deletions(-) create mode 100644 .claude-plugin/marketplace.json create mode 100644 migrations/0.5.3-to-0.5.4-marketplace-manifest.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..1a1fc4f --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,13 @@ +{ + "name": "portable-agent-memory", + "owner": { + "name": "NestDevLab" + }, + "plugins": [ + { + "name": "pam", + "source": "./", + "description": "Portable Agent Memory: MCP server, curator/scribe subagents, slash commands, and hooks for Claude Code." + } + ] +} diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index b326cac..f68cf8c 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "pam", "displayName": "Portable Agent Memory", - "version": "0.4.0", + "version": "0.5.4", "description": "Persistent, portable memory workspace for AI agents: graph + markdown logs, hygiene tooling, and Claude Code integration (MCP server, agents, slash commands, hooks).", "author": { "name": "Stefano Guerrini" diff --git a/CHANGELOG.md b/CHANGELOG.md index e86dd49..4c1a4b6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,38 @@ ## Unreleased +## 0.5.4 - 2026-06-02 + +PAM 0.5.4 makes the repo installable as a Claude Code plugin marketplace. +No runtime or schema behavior changes. + +### Added + +- `.claude-plugin/marketplace.json` listing the single `pam` plugin with + `"source": "./"` so Claude Code discovers the existing + `.claude-plugin/plugin.json` at repo root. +- `claudeMarketplaceManifest` feature flag in `memory/pam.version.json`. +- Migration guide `migrations/0.5.3-to-0.5.4-marketplace-manifest.md`. + +### Fixed + +- `.claude-plugin/plugin.json` `version` field was stuck at `0.4.0` since + the 0.4.0 release; bumped to `0.5.4` to align with `package.json` and + `memory/pam.version.json`. + +### Install + +```text +/plugin marketplace add github:NestDevLab/portable-agent-memory +/plugin install pam@portable-agent-memory +``` + +### Compatibility + +- `memoryFormat` remains `graph-v1`. +- `graphSchemaVersion` remains `pam-graph-v1`. +- Existing 0.5.3 graph JSONL files remain valid. + ## 0.5.0 - 2026-05-27 PAM 0.5.0 adds a measurable file-only retrieval gate for agents that cannot use diff --git a/memory/pam.version.json b/memory/pam.version.json index c8115b1..b28f0d5 100644 --- a/memory/pam.version.json +++ b/memory/pam.version.json @@ -1,5 +1,5 @@ { - "pamVersion": "0.5.3", + "pamVersion": "0.5.4", "memoryFormat": "graph-v1", "graphSchemaVersion": "pam-graph-v1", "features": { @@ -16,7 +16,8 @@ "fileOnlyCoverage": true, "llmRetrievalBenchmark": true, "benchmarkThresholdGate": true, - "tightBenchmarkRegressionGate": true + "tightBenchmarkRegressionGate": true, + "claudeMarketplaceManifest": true }, "updated": "2026-06-02" } diff --git a/migrations/0.5.3-to-0.5.4-marketplace-manifest.md b/migrations/0.5.3-to-0.5.4-marketplace-manifest.md new file mode 100644 index 0000000..09b4df0 --- /dev/null +++ b/migrations/0.5.3-to-0.5.4-marketplace-manifest.md @@ -0,0 +1,63 @@ +# PAM 0.5.3 -> 0.5.4 Migration: Claude Code Marketplace Manifest + +PAM 0.5.4 adds `.claude-plugin/marketplace.json` so the repo is discoverable +as a Claude Code plugin marketplace. This is a packaging/distribution +migration; no runtime or schema behavior changes. + +## Who Should Apply This + +Apply this migration when a workspace is on PAM 0.5.3 and either: + +- ships the PAM plugin to Claude Code users via `/plugin marketplace add` + and `/plugin install`, or +- consumes the PAM plugin in Claude Code using the same flow. + +Workspaces that only use the MCP server directly (Cursor, Codex, Kimi, or +bare `node tools/pam-mcp-server.mjs`) can skip the install steps and apply +only the version bump. + +## Changes + +- Update `package.json`, `memory/pam.version.json`, and + `.claude-plugin/plugin.json` to `0.5.4`. The plugin manifest had + drifted at `0.4.0` since the 0.4.0 release; this migration aligns it + with the other version surfaces. +- Enable the `claudeMarketplaceManifest` feature flag. +- Add `.claude-plugin/marketplace.json` listing the single `pam` plugin + with `"source": "./"` so the existing `.claude-plugin/plugin.json` at + repo root is discovered as that plugin's manifest. + +## Procedure + +1. Update the workspace to PAM 0.5.4. +2. Run `npm run migrations:check` to confirm the chain + `0.5.3 -> 0.5.4` is contiguous. +3. Run `npm run memory:graph:validate`. +4. (Claude Code users) Register the marketplace and install the plugin: + + ```text + /plugin marketplace add github:NestDevLab/portable-agent-memory + /plugin install pam@portable-agent-memory + ``` + + Restart Claude Code after install. + +## Validation + +The migration is complete when: + +- `package.json` version is `0.5.4`. +- `memory/pam.version.json` has `pamVersion: "0.5.4"`. +- `.claude-plugin/plugin.json` has `"version": "0.5.4"`. +- `memory/pam.version.json` has `features.claudeMarketplaceManifest: true`. +- `.claude-plugin/marketplace.json` exists and lists the `pam` plugin. +- `npm run migrations:check` passes. +- `npm run memory:graph:validate` passes. + +## Compatibility + +- `memoryFormat` remains `graph-v1`. +- `graphSchemaVersion` remains `pam-graph-v1`. +- Existing 0.5.3 graph JSONL files remain valid. +- The MCP server, subagents, and Claude Code plugin runtime are unchanged. + Only the marketplace discovery surface is new. diff --git a/package.json b/package.json index 4723ca4..bb69632 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "portable-agent-memory", - "version": "0.5.3", + "version": "0.5.4", "private": false, "description": "Markdown-first portable memory, wiki, and maintenance toolkit for AI agents.", "type": "module",