Commit Graph

22 Commits

Author SHA1 Message Date
czlonkowski
c3b691cedf feat(telemetry): capture error messages with security hardening
## Summary
Enhanced telemetry system to capture actual error messages for debugging
while implementing comprehensive security hardening to protect sensitive data.

## Changes
- Added optional errorMessage parameter to trackError() method
- Implemented sanitizeErrorMessage() with 7-layer security protection
- Updated all production and test call sites (atomic change)
- Added 18 new security-focused tests

## Security Fixes
- ReDoS Prevention: Early truncation + simplified regex patterns
- Full URL Redaction: Changed [URL]/path → [URL] to prevent leakage
- Credential Detection: AWS keys, GitHub tokens, JWT, Bearer tokens
- Correct Sanitization Order: URLs → credentials → emails → generic
- Error Handling: Try-catch wrapper with [SANITIZATION_FAILED] fallback

## Impact
- Resolves 272+ weekly errors with no error messages
- Protects against ReDoS attacks
- Prevents API structure and credential leakage
- 90.75% test coverage, 269 tests passing

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-03 15:53:13 +02:00
czlonkowski
2a9a3b9410 chore: release v2.15.2 with 100% test coverage
- Bump version to 2.15.2
- Add comprehensive changelog entry documenting all improvements
- Add 31 new unit tests achieving 100% coverage for changed code
- Fix flaky integration tests with deterministic ordering

Test Coverage Improvements:
- buildMetadataFilterConditions: All filter combinations (11 tests)
- Performance logging validation (3 tests)
- ID filtering edge cases (7 tests)
- getMetadataSearchCount: Shared helper usage (7 tests)
- Two-phase optimization verification (3 tests)

Coverage increased from 36.58% to 100% for patch

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-03 14:44:53 +02:00
czlonkowski
bf999232a3 docs(changelog): add test suite documentation to v2.15.0
Document comprehensive test coverage added for P0-R3 feature.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-02 22:31:13 +02:00
czlonkowski
711cecb90d docs(changelog): document P0-R3 fixes and enhancements
- Added --extract-only mode documentation
- Documented searchNodesLIKE includeExamples fix
- Added auto-table-creation feature

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-02 21:30:44 +02:00
czlonkowski
997cc93a0a feat(p0-r3): implement pre-extracted template configurations system
Major Features:
- Pre-extracted 197 node configurations from 2,646 workflow templates
- Removed get_node_for_task tool (28% failure rate, 31 tasks)
- Enhanced search_nodes and get_node_essentials with includeExamples parameter
- 30-60x faster queries (<1ms vs 30-60ms)

Database Schema:
- New table: template_node_configs with optimized indexes
- New view: ranked_node_configs for top 5 configs per node
- Migration script: add-template-node-configs.sql

Template Processing:
- extractNodeConfigs: Extract configs from workflow templates
- detectExpressions: Identify n8n expressions ({{...}}, $json, $node)
- insertAndRankConfigs: Rank by popularity, keep top 10 per node

Tool Enhancements:
- search_nodes: Added includeExamples parameter (top 2 configs)
- get_node_essentials: Added includeExamples parameter (top 3 configs)

CLI Features:
- --extract-only: Extract configs without fetching new templates
- Automatic table creation if missing

Breaking Changes:
- Removed get_node_for_task tool
- Use search_nodes({includeExamples: true}) or get_node_essentials({includeExamples: true}) instead

Performance:
- Query time: <1ms for pre-extracted configs
- 85x more examples (2,646 vs 31)
- Database size increase: ~197 configs stored

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-02 20:24:09 +02:00
czlonkowski
aef9d983e2 chore: bump version to 2.14.7 and update CHANGELOG
Release v2.14.7 with critical P0 fixes:

- P0-R1: Universal node type normalization (80% error reduction)
- Issue #248: Settings validation error fix
- Issue #249: Enhanced addConnection error messages

Changes:
- Bump version from 2.14.6 to 2.14.7
- Add comprehensive CHANGELOG entry for v2.14.7
- Update PR #247 description with complete summary

Impact:
- Expected overall error rate reduction from 5-10% to <2%
- 183 tests passing (100% coverage for new code)
- All CI checks passing

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-02 15:29:21 +02:00
czlonkowski
cb5691f17d chore: bump version to 2.14.6 and update CHANGELOG
- Bump version from 2.14.5 to 2.14.6
- Add comprehensive CHANGELOG entry for webhook error message enhancements
- Document new error formatting functions
- Highlight benefits: fast, efficient, safe, actionable debugging guidance
2025-10-01 11:56:27 +02:00
czlonkowski
ec0d2e8a6e feat: add intelligent execution data filtering to n8n_get_execution tool
Implements comprehensive execution data filtering system to enable AI agents
to inspect large workflow executions without exceeding token limits.

Features:
- Preview mode: Shows structure, counts, and size estimates (~500 tokens)
- Summary mode: Returns 2 sample items per node (~2-5K tokens)
- Filtered mode: Granular control with itemsLimit and nodeNames
- Full mode: Complete data retrieval (explicit opt-in)
- Smart recommendations based on data size analysis
- Structure-only mode (itemsLimit: 0) for schema inspection
- 100% backward compatibility with legacy includeData parameter

Technical improvements:
- New ExecutionProcessor service with intelligent filtering logic
- Type-safe implementation with Record<string, unknown> over any
- Comprehensive validation and error handling
- 33 unit tests with 78% coverage
- Constants-based thresholds for easy tuning

Bug fixes:
- Fixed preview mode API data fetching to enable structure analysis
- Validates and caps itemsLimit to prevent abuse

Impact:
- Reduces token usage by 80-95% for large datasets (50+ items)
- Prevents token overflow when inspecting workflow executions
- Enables recommended workflow: preview → recommendation → targeted fetch

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-01 00:01:59 +02:00
czlonkowski
cabda2a0f8 docs: add CHANGELOG entries for v2.14.3 and v2.14.4 2025-09-30 14:08:55 +02:00
czlonkowski
263753254a chore: bump version to 2.14.2 and update changelog
- Bumped version from 2.14.1 to 2.14.2
- Added comprehensive changelog entry for validation fixes
- Documents fixes for Google Drive fileFolder resource false positives
- Documents fixes for Code node expression validation false positives
- Documents enhanced error handling improvements from code review
2025-09-29 18:27:43 +02:00
czlonkowski
fecc584145 docs: update changelog with comprehensive v2.14.1 changes
The v2.14.1 release contains the entire telemetry system refactor with:
- Major architectural improvements (modularization)
- Security & privacy enhancements
- Performance & reliability improvements
- Test coverage increase from 63% to 91%
- Multiple bug fixes for CI/test failures
2025-09-26 19:34:39 +02:00
czlonkowski
09bbcd7001 docs: add changelog entry for v2.14.1
Document fixes for TypeScript lint errors and test failures in telemetry system
2025-09-26 19:32:44 +02:00
czlonkowski
6f21a717cd chore: bump version to 2.14.0
- Add anonymous telemetry system with Supabase integration
- Fix TypeErrors affecting 50% of tool calls
- Improve test coverage to 91%+
- Add comprehensive CHANGELOG

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-26 11:34:54 +02:00
czlonkowski
8872ca2201 move changelog 2025-06-29 19:46:28 +02:00
czlonkowski
dabee9f772 docs: create comprehensive CHANGELOG.md and update documentation
- Created complete CHANGELOG.md from v1.0.0 to v2.7.0 based on git history
- Updated README.md to fix incorrect CHANGELOG path reference
- Added n8n-docs/ directory to .gitignore (was accidentally tracked)
- Removed n8n-docs from git tracking

The CHANGELOG now follows Keep a Changelog format and includes all major features,
fixes, and improvements for each version with proper categorization.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-29 19:45:27 +02:00
czlonkowski
1907e5ce8e refactor: major cleanup of legacy and temporary files
- Removed ~965MB of temporary directories (temp/, extracted-nodes/, etc)
- Deleted outdated database files and backups (.bak files)
- Removed legacy shell scripts (mcp-server-v20.sh, rebuild-v20.sh)
- Cleaned up orphan test files and debugging scripts
- Removed duplicate schema file (src/db/schema.sql)
- Deleted old Dockerfile.old and empty database files
- Updated documentation structure in README.md
- Added n8n_diagnostic tool to documentation
- Condensed version history in CLAUDE.md
- Created release notes for v2.7.0

Total impact: Removed 34 files, saving ~965MB+ of disk space

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-29 19:06:31 +02:00
czlonkowski
d6f38dc1c4 docs: reorganize documentation files and update Docker build process 2025-06-13 17:20:31 +02:00
czlonkowski
89e1df03de feat: add HTTP server mode for remote deployment with token auth 2025-06-13 11:54:42 +02:00
czlonkowski
b476d36275 feat: implement universal Node.js compatibility with automatic database adapter fallback 2025-06-12 23:51:47 +02:00
czlonkowski
66f5d74e42 feat: implement node parser and property extractor with versioned node support 2025-06-12 18:45:20 +02:00
czlonkowski
1dd6b8e55f Clean up legacy documentation and scripts
- Remove all references to workflow execution/management features
- Delete legacy scripts for bidirectional n8n integration
- Update documentation to focus on node documentation serving only
- Remove old docker-compose files for workflow management
- Add simplified docker-compose.yml for documentation server
- Update CHANGELOG.md to reflect v2.0.0 and v2.1.0 changes
- Update Dockerfile to use v2 paths and database

The project is now clearly focused on serving n8n node documentation
to AI assistants, with no workflow execution capabilities.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-08 07:54:53 +00:00
czlonkowski
0cff8fbe6a Update documentation with AI Agent extraction features
- Updated CLAUDE.md with complete project state and capabilities
- Enhanced README.md with node extraction features and examples
- Added CHANGELOG.md to track version history
- Documented new MCP tools and resources for node source extraction
- Added special features section highlighting AI Agent capabilities

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-07 16:05:31 +00:00