chore: add Claude Code marketplace manifest for 0.5.4

.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."
+    }
+  ]
+}

.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"

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

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"
 }

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.

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",