claude-mpm 5.3.0 → 5.4.31

package/LICENSE

@@ -1,21 +1,94 @@
-MIT License
-
-Copyright (c) 2025 Claude MPM Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Elastic License 2.0
+
+Copyright (c) 2024-2025 Bob Matsuoka
+Contact: bob@matsuoka.com
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of legal
+claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -141,17 +141,28 @@ claude --version
 # Basic installation
 pip install claude-mpm
 
+# Or with uv (faster)
+uv tool install claude-mpm
+
 # Install with monitoring dashboard (recommended)
 pip install "claude-mpm[monitor]"
+uv tool install "claude-mpm[monitor]"
 ```
 
-Or with pipx (recommended for isolated installation):
+Or with pipx/uvx (recommended for isolated installation):
 ```bash
 # Basic installation
 pipx install claude-mpm
 
+# Or with uv tool (permanent installation)
+uv tool install claude-mpm
+
+# Or with uvx (one-off execution)
+uvx claude-mpm
+
 # Install with monitoring dashboard (recommended)
 pipx install "claude-mpm[monitor]"
+uv tool install "claude-mpm[monitor]"
 ```
 
 ### Verify Installation
@@ -203,6 +214,8 @@ Claude MPM works excellently with these complementary MCP tools. While optional,
 **Installation:**
 ```bash
 pipx install kuzu-memory
+# Or with uv
+uv tool install kuzu-memory
 ```
 
 **Benefits with Claude MPM:**
@@ -225,6 +238,8 @@ pipx install kuzu-memory
 **Installation:**
 ```bash
 pipx install mcp-vector-search
+# Or with uv
+uv tool install mcp-vector-search
 ```
 
 **Benefits with Claude MPM:**
@@ -249,6 +264,10 @@ Install both recommended tools in one go:
 ```bash
 pipx install kuzu-memory
 pipx install mcp-vector-search
+
+# Or with uv
+uv tool install kuzu-memory
+uv tool install mcp-vector-search
 ```
 
 Then verify they're working:
@@ -263,12 +282,12 @@ claude-mpm verify
 
 ## Cache Management
 
-Claude MPM maintains a local cache of agent templates at `~/.claude-mpm/cache/remote-agents/`.
+Claude MPM maintains a local cache of agent templates at `~/.claude-mpm/cache/agents/`.
 
 ### Cache Structure
 
 ```
-~/.claude-mpm/cache/remote-agents/
+~/.claude-mpm/cache/agents/
 └── bobmatnyc/
     └── claude-mpm-agents/
         ├── .git/              # Git repository
@@ -276,6 +295,8 @@ Claude MPM maintains a local cache of agent templates at `~/.claude-mpm/cache/re
         └── docs/
 ```
 
+> **Note**: Prior to v5.4.23, agents were cached to `~/.claude-mpm/cache/remote-agents/`. This has been standardized to `~/.claude-mpm/cache/agents/`. Existing caches are automatically migrated.
+
 ### Git Workflow (Optional)
 
 If your cache is a git repository, you can manage agents with git operations:
@@ -611,7 +632,19 @@ Claude MPM includes 15 specialized agents:
 - **Code Analyzer** - Static code analysis with AST and tree-sitter
 
 ### Agent Memory System
-Agents learn project-specific patterns using a simple list format and can update memories via JSON response fields (`remember` for incremental updates, `MEMORIES` for complete replacement). Initialize with `claude-mpm memory init`.
+
+**NEW in v5.4.13**: Runtime memory loading for instant updates and better efficiency.
+
+**How It Works:**
+- **Memory Files**: Store agent memories in `.claude-mpm/memories/{agent_id}.md` (e.g., `engineer.md`, `qa.md`)
+- **Runtime Loading**: Memories loaded dynamically when agents are delegated to (no restart required)
+- **Instant Updates**: Memory changes take effect immediately
+- **Event Observability**: Memory loading tracked via EventBus (`agent.memory.loaded` events)
+
+**Memory Format:**
+Agents learn project-specific patterns using a simple markdown list format and can update memories via JSON response fields (`remember` for incremental updates, `MEMORIES` for complete replacement).
+
+**See:** [Memory Flow Architecture](docs/architecture/memory-flow.md) for complete technical details.
 
 ### Skills System
 
@@ -810,6 +843,16 @@ See [docs/reference/MEMORY.md](docs/reference/MEMORY.md) and [docs/developer/11-
 
 See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/user/MIGRATION.md](docs/user/MIGRATION.md) for upgrade instructions.
 
+## 📜 License
+
+[![License](https://img.shields.io/badge/License-Elastic_2.0-blue.svg)](LICENSE)
+
+Licensed under the [Elastic License 2.0](LICENSE) - free for internal use and commercial products.
+
+**Main restriction:** Cannot offer as a hosted SaaS service without a commercial license.
+
+📖 [Licensing FAQ](LICENSE-FAQ.md) | 💼 Commercial licensing: bob@matsuoka.com
+
 ## Development
 
 ### Quick Development Setup
@@ -843,9 +886,6 @@ Contributions are welcome! Please see our [project structure guide](docs/referen
 ### Project Structure
 See [docs/reference/STRUCTURE.md](docs/reference/STRUCTURE.md) for codebase organization.
 
-### License
-MIT License - see [LICENSE](LICENSE) file.
-
 ## Credits
 
 - Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mpm",
-  "version": "5.3.0",
+  "version": "5.4.31",
   "description": "NPM wrapper for claude-mpm Python package - Requires Python 3.8+. Orchestrate Claude with agent delegation and ticket tracking",
   "keywords": [
     "claude",
@@ -52,6 +52,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
+    "@playwright/test": "^1.57.0",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "@vitejs/plugin-react": "^4.2.0",
@@ -61,6 +62,7 @@
   },
   "dependencies": {
     "playwright": "^1.55.0",
+    "puppeteer": "^24.34.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-window": "^1.8.8",