@path58/p58-n8n 0.2.11 → 0.2.12

package/CHANGELOG.md

@@ -5,6 +5,7 @@ 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
 ## [0.2.11] - 2026-03-11
 
 ### Added

package/README.md

@@ -126,9 +126,9 @@ p58-n8n uses 80% less token context than n8n-mcp by serving structured catalog d
 
 ---
 
-## 35 Tools in 7 Tiers
+## 35 MCP Tools in 8 Categories
 
-### Tier 1 — Validation & Analysis
+### Schema & Node Intelligence
 
 | Tool | What it does |
 |------|-------------|
@@ -136,66 +136,71 @@ p58-n8n uses 80% less token context than n8n-mcp by serving structured catalog d
 | `get_operation_schema` | Exact parameter requirements for any node operation (ground truth, not LLM guesses) |
 | `check_parameter` | Real-time parameter validation — type checking, enum validation, typo detection |
 | `suggest_fix` | Concrete fix suggestions for validation issues — rename, add, remove, or replace |
-| `list_nodes` | Browse and search 1,545 n8n nodes by category or keyword |
+| `list_nodes` | Browse and search 1,982 n8n nodes by category or keyword |
 | `list_operations` | All operations for a node type, grouped by resource |
-| `get_node_info` | Full node details — operations, credentials, properties, version |
+| `get_node_info` | Full node details — operations, credentials, properties, config examples, version info |
 | `find_similar_pattern` | Search 10,003 real workflows for working examples |
 
-### Tier 2 — Server CRUD
+### Workflow CRUD
 
 | Tool | What it does |
 |------|-------------|
-| `get_workflow` | Fetch a workflow from your n8n instance by ID |
+| `create_workflow` | Create a workflow on your n8n server (L1-L4 validation gate) |
+| `get_workflow` | Fetch a deployed workflow by ID |
 | `list_workflows` | List all workflows with filtering and pagination |
-| `create_workflow` | Create a workflow on your n8n server |
 | `update_workflow` | Replace a workflow entirely |
-| `delete_workflow` | Delete a workflow (safe — checks for dependents) |
-| `execute_workflow` | Trigger workflow execution |
-| `get_execution_result` | Fetch the result of a completed execution |
+| `delete_workflow` | Delete a workflow (idempotent) |
+| `execute_workflow` | Trigger workflow execution (webhook, schedule, or manual) |
+| `get_execution_result` | Fetch execution details with per-node debug data |
 
-### Tier 3 — Advanced Operations
+### Smart Deploy
 
 | Tool | What it does |
 |------|-------------|
-| `validated_create` | Validate + deploy in one step — rejects invalid JSON before it hits your server |
-| `validated_update` | Validate + update in one step |
+| `validated_create` | Validate → autofix → auto-wire credentials → inject config → deploy atomically |
+| `validated_update` | Validate → autofix → update atomically |
 | `activate_workflow` | Toggle workflow active/inactive state |
-| `get_session_metrics` | Token usage and cost tracking for the current session |
 | `server_health` | Check your n8n instance connectivity and status |
+| `get_session_metrics` | Token usage and cost tracking for the current session |
 
-### Tier 4 — Tool Parity
+### Test & Iterate
 
 | Tool | What it does |
 |------|-------------|
-| `test_workflow` | Sandbox-test a workflow using K2 mock responses (no real credentials needed) |
-| `server_autofix` | Run all 35 auto-fixers on a workflow and return the repaired JSON |
-| `partial_update_workflow` | Diff-based partial updates — change one node without replacing the whole workflow |
-| `manage_executions` | List, filter, and delete workflow execution history |
-| `deploy_template` | Deploy a pre-built template from the workflow library |
+| `test_workflow` | Auto-detect trigger type and execute (respondToWebhook-aware, safe deactivation) |
+| `server_autofix` | Closed-loop: deploy → test → validate → fix → update → re-test (up to 10 iterations) |
+| `partial_update_workflow` | Diff-based surgical updates — 6 operations, atomic pre-validation |
+| `manage_executions` | List, get, or delete execution records with batch support |
+| `deploy_template` | Fetch and deploy a template from the public n8n template library |
 
-### Tier 5 — Workflow Generation
+### Workflow Generation
 
 | Tool | What it does |
 |------|-------------|
-| `plan_workflow` | Generate a structured workflow plan from a natural language description |
-| `build_workflow` | Build a complete workflow JSON from a plan — uses catalog data for correct parameters |
+| `plan_workflow` | Research templates, schemas, credentials, and architecture before building |
+| `build_workflow` | Assemble → validate → autofix → deploy → test from a structured spec |
 
-### Tier 6 — Credential Management
+### Credential Lifecycle
 
 | Tool | What it does |
 |------|-------------|
-| `list_credentials` | List n8n server credentials with optional schema enrichment |
+| `list_credentials` | List n8n server credentials with optional schema enrichment and node filtering |
 | `get_credential_schema` | Required and optional fields for any of 679 credential types (fuzzy match) |
-| `create_credential` | Create credentials with 5-step validation |
-| `test_credential` | Health-check probe — verifies connectivity for top credential types |
-| `update_credential` | Partial update — GET → merge → PATCH (preserves unmodified fields) |
+| `create_credential` | Schema-validated credential creation with duplicate detection |
+| `test_credential` | Health-check probe for 25 credential types (HTTP + TCP) |
+| `update_credential` | Rename a credential on the server |
 | `delete_credential` | Safe deletion with dependent workflow scan |
 
-### Tier 7 — Config Intelligence
+### Runtime Configuration
+
+| Tool | What it does |
+|------|-------------|
+| `collect_config` | Interactive config collection — spreadsheet IDs, webhook URLs, channel IDs, etc. |
+
+### Diagnostics
 
 | Tool | What it does |
 |------|-------------|
-| `collect_config` | Detect missing node configuration from your live n8n instance (covers 2,494 known gaps) |
 | `setup_check` | Diagnostic report — server version, n8n connectivity, credential count, tool availability |
 
 Full reference with input/output schemas: [docs/TOOLS.md](docs/TOOLS.md)