@path58/p58-n8n 0.2.12 → 0.2.13

package/AGENT_INSTALL.md

@@ -8,10 +8,21 @@
 
 ## What is p58-n8n?
 
-p58-n8n is an MCP server that gives LLMs the ability to validate, build, deploy, and manage n8n workflows. It provides 35 tools organized in tiers:
+p58-n8n is an MCP server that gives LLMs the ability to validate, build, deploy, and manage n8n workflows. It provides 12 tools in the default configuration (35 total registered, 11 offline-capable), organized in tiers:
 
-- **Tier 1 (offline):** `validate_workflow`, `list_nodes`, `get_operation_schema`, `suggest_fix`, `check_parameter` — work immediately, no env vars needed
-- **Tier 2-7 (require n8n):** `build_workflow`, `list_credentials`, `activate_workflow`, `execute_workflow`, `test_workflow`, `plan_workflow`, etc. — require connection to user's n8n instance
+- **Public/basic (offline-capable):** planning, node and operation discovery, credential schema discovery, and public-safe validation work immediately from bundled catalog assets
+- **Public/basic + n8n:** build, deploy, test, workflow CRUD, and credential CRUD work against the user's own n8n instance
+- **Friends & Family Full (optional):** an allowlisted `P58_USER_EMAIL` plus `P58_DATABASE_URL` unlocks deeper private Path58 intelligence without changing the MCP tool list
+
+## Runtime Modes
+
+Use this mental model when installing:
+
+- **Public Local:** no Path58 DB env vars. Uses the local public bundle that ships in npm.
+- **Connected:** the user's own n8n is configured, and `P58_DATABASE_URL` may also be present, but private intelligence is still locked.
+- **Friends & Family Full:** `P58_DATABASE_URL` plus allowlisted `P58_USER_EMAIL` unlock the private Path58 layer.
+
+The public npm package does not include raw Path58 `parameters` or `connections`.
 
 ---
 
@@ -19,12 +30,16 @@ p58-n8n is an MCP server that gives LLMs the ability to validate, build, deploy,
 
 ```
 Does the user have n8n running?
-├── YES → Full install (N8N_API_URL + N8N_API_KEY)
-│         All 34 tools work: validate, build, deploy, execute
+├── YES → Public/basic full journey (N8N_API_URL + N8N_API_KEY)
+│         Plan, build, validate, deploy, test, and manage workflows
 │
-└── NO / DON'T KNOW → Minimal install (no env vars)
-                       Tier 1 tools only: validate, list, check params
-                       User can add n8n config later
+└── NO / DON'T KNOW → Public Local install (no env vars)
+                       Planning, discovery, credential schema lookup,
+                       and public-safe validation work immediately
+
+Does the user also have Friends & Family access?
+└── YES → Add P58_DATABASE_URL + allowlisted P58_USER_EMAIL
+          to unlock private Path58 intelligence
 ```
 
 ---
@@ -167,6 +182,24 @@ Read the existing config file, then add p58-n8n inside the `mcpServers` object.
 }
 ```
 
+**Friends & Family Full (optional private layer):**
+```json
+{
+  "mcpServers": {
+    "p58-n8n": {
+      "command": "npx",
+      "args": ["-y", "@path58/p58-n8n"],
+      "env": {
+        "N8N_API_URL": "http://localhost:5678/api/v1",
+        "N8N_API_KEY": "<paste-api-key-here>",
+        "P58_DATABASE_URL": "<friend-and-family-db-url>",
+        "P58_USER_EMAIL": "friend@example.com"
+      }
+    }
+  }
+}
+```
+
 ### For Claude Code (CLI)
 
 **Full config:**
@@ -184,6 +217,16 @@ claude mcp add p58-n8n \
 claude mcp add p58-n8n -- npx -y @path58/p58-n8n
 ```
 
+**Friends & Family Full (optional private layer):**
+```bash
+claude mcp add p58-n8n \
+  -e N8N_API_URL=http://localhost:5678/api/v1 \
+  -e N8N_API_KEY=<paste-api-key-here> \
+  -e P58_DATABASE_URL=<friend-and-family-db-url> \
+  -e P58_USER_EMAIL=friend@example.com \
+  -- npx -y @path58/p58-n8n
+```
+
 ---
 
 ## Step 5: Restart the Client
@@ -231,6 +274,8 @@ Ask: "List my n8n credentials"
 | `N8N_API_KEY` | For Tier 2-7 tools | n8n API authentication key | n8n → Settings → API Keys |
 | `N8N_USER_EMAIL` | For `test_credential` | n8n login email (REST session auth) | Same email you use to log into n8n UI |
 | `N8N_USER_PASSWORD` | For `test_credential` | n8n login password (REST session auth) | Same password you use to log into n8n UI |
+| `P58_DATABASE_URL` | Optional | Friends & Family private intelligence connection | Provided directly by Path58 |
+| `P58_USER_EMAIL` | Optional with `P58_DATABASE_URL` | Allowlist identity for unlocking private intelligence | Must match the allowlisted email |
 
 > **Note:** `N8N_API_BASE_URL` is accepted as a fallback for `N8N_API_URL`. If neither is set, defaults to `http://localhost:5678/api/v1`.
 
@@ -271,4 +316,4 @@ Once installed, the user can ask their AI assistant to:
 
 ---
 
-**Package:** `@path58/p58-n8n` | **npm:** https://www.npmjs.com/package/@path58/p58-n8n | **Version:** 0.2.6+
+**Package:** `@path58/p58-n8n` | **npm:** https://www.npmjs.com/package/@path58/p58-n8n | **Version:** 0.2.13+

package/CHANGELOG.md

@@ -5,7 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-<<<<<<< HEAD
+## [Unreleased]
+
+## [0.2.13] - 2026-03-28
+
+### Added
+
+- **Public catalog bundle** — `src/data/public-catalog/` now ships in the npm tarball, giving every user immediate access to 1,545 nodes, 12,619 operations, 679 credential types, 1,209 credential fields, and 4,629 node-credential relationships — no Path58 database required.
+
+### Fixed
+
+- **Circuit breaker false positives** — `isAuthOrConnectionError()` matched bare `'timeout'`, causing pool-acquisition and statement timeouts to be misclassified as infrastructure failures. Narrowed to `'connection timeout'` and `'connect etimedout'` only. Supabase logs confirmed zero actual DB errors during trips.
+- **MCP pool exhaustion** — Default pool size for catalog-only (MCP) mode reduced from 3→1. MCP tools are request/response and don't need concurrent connections. With `max=3`, just 5 orphaned processes exhausted the `mcp_user` 15-slot limit.
+- **Stale comment** — `validatorQuery` JSDoc said "3 failures / 2 min" but actual thresholds are 10 failures / 60s cooldown.
+- **`SETUP_GUIDE_URL` in n8n-guard** — Fixed URL pointing to `docs/AGENT_INSTALL.md` (which doesn't exist); now correctly points to `AGENT_INSTALL.md` at repo root.
+
+### Changed
+
+- **`mcp_user` CONNECTION LIMIT** — Raised from 15→30 via `ALTER ROLE`. Combined with pool `max=1`, supports up to 30 orphaned MCP processes before hitting the limit.
+
+### Performance
+
+- **Benchmark parity verified** — 100% pass rate across all three model tiers (Haiku 4.5, Sonnet 4.6, Opus 4.6) in competitive 25-prompt shootout. p58 Haiku: $0.24/pass vs n8n-mcp $6.02/pass.
+
 ## [0.2.11] - 2026-03-11
 
 ### Added
@@ -187,6 +209,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - npm package published as `@path58/p58-n8n`
 - ESM module support with shebang for direct `npx` execution
 
+[0.2.13]: https://github.com/tsvika58/p58-n8n/releases/tag/v0.2.13
 [0.2.7]: https://github.com/tsvika58/p58-n8n/releases/tag/v0.2.7
 [0.2.6]: https://github.com/tsvika58/p58-n8n/releases/tag/v0.2.6
 [0.2.5]: https://github.com/tsvika58/p58-n8n/releases/tag/v0.2.5

package/LICENSE

@@ -1,21 +1,96 @@
-MIT License
-
-Copyright (c) 2026 Path58
-
-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.
+License text copyright (c) 2023 MariaDB plc, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB plc.
+
+Parameters
+
+Licensor:             Path58 (Tsvi Vagman)
+Licensed Work:        p58-n8n
+                      The Licensed Work is (c) 2026 Path58
+Additional Use Grant: You may use the Licensed Work for any purpose,
+                      including production use, EXCEPT for providing a
+                      commercial n8n workflow automation MCP server product
+                      that competes with Path58's offerings.
+
+Change Date:          2028-03-28
+
+Change License:       MIT License
+
+For information about alternative licensing arrangements for the Software,
+please visit: https://path58.com
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.