portel-dev/ncp releases

Major Features

🎯 Photon-Core 2.9.4 Integration

PhotonWatcher - Battle-tested file monitoring with symlink resolution, debouncing, and automatic hot-reload

• Replace chokidar with production-ready watcher
• Symlink resolution for macOS compatibility
• Temp file filtering and debouncing built-in

DaemonBroker - Cross-process event routing via Unix sockets

• Photons emit events with await this.emit()
• Subscribe with @notify-on annotations
• Graceful fallback to local-only when daemon not running

InstanceStore - State persistence across execution sessions

• Photons implement getState()/setState() for automatic persistence
• State saved to ~/.photon/state/{photonName}/
• State restored on load automatically

StatefulExecution - Execution tracking with runId and StateLog

• Every code execution gets unique runId
• JSONL logs stored at ~/.photon/runs/{runId}.jsonl
• Foundation for Code-to-Photon workflow

🔄 Code-to-Photon Workflow

Three new MCP tools enable permanent automation:

• code:run - Execute TypeScript with full MCP access
• code:list-runs - List recent executions
• code:get-run - Inspect execution details
• code:save-as-photon - Convert code → .photon.ts file

Workflow: Write code → Execute → Success! → Save as Photon → Use forever

📱 MCP Apps Protocol Support

Groundwork for visual components in tool results. Detects client capabilities for future UI rendering.

Security

• Applied 24 npm security fixes
• Remaining 19 vulnerabilities are unfixable at npm level (mostly in devDependencies)
• Upgraded mcp-server-kubernetes to 3.3.0 (fixes deprecated request package chain)

Documentation

Four comprehensive guides created:

• Code-to-Photon - Workflow automation
• Stateful Execution - State persistence
• Daemon Integration - Event routing
• NCP 2.3.0 Features - Feature overview

Testing

✅ 13/13 critical protocol tests pass
✅ 6/6 integration tests pass
✅ 4/4 DXT entry point tests pass

Installation

npm install -g @portel/[email protected]
# or
npm install @portel/[email protected]

Full changelog: See CHANGELOG.md

Bug Fixes

• Fix Windows spawn EINVAL for npx.cmd wrappers (fixes #8)
• Fix code --file test on Windows by using forward slashes in CLI arguments

Full Changelog

https://github.com/portel-dev/ncp/compare/2.0.0...2.0.1

Full Changelog: https://github.com/portel-dev/ncp/compare/1.8.0...2.0.0

Release 1.8.0

Major update with Scheduler V2, Code-Mode enhancements, and Photon architecture.

Highlights

• ⚠️ BREAKING: Scheduler V2 with timing groups (auto-migrates from V1)
• Code-Mode automation powerhouse with multi-MCP orchestration
• Photon runtime architecture
• Skills marketplace integration
• Enhanced analytics and monitoring

See CHANGELOG.md for full details.

Published to npm: https://www.npmjs.com/package/@portel/ncp/v/1.8.0

🚀 Release v1.6.0

⚡ CI/CD Optimizations

• Smart Path Filtering: CI now only runs when code/config files change, skipping documentation-only updates
• Optimized Test Matrix: Reduced test jobs from 4 to 2 (50% faster CI)
  • Removed macOS from general tests (kept for DXT-specific builds)
  • Tests now run only on Ubuntu with Node 18.x and 20.x
• Faster Feedback: Average CI run time reduced from ~10min to ~5min

🧪 Test Improvements

• Skipped flaky pagination E2E test until search query is fixed
• All critical, integration, and type-check tests passing
• Pre-commit hooks validated

📦 Downloads

• DXT (Claude Desktop): Download ncp.dxt from assets below
• npm: npm install -g @portel/ncp (will be available shortly)

🔧 Technical Details

• Package version: 1.6.0
• DXT file size: 72MB
• Tested on: macOS (Darwin 24.6.0), Node 18.x & 20.x
• CI: GitHub Actions with optimized workflows

📝 Files Changed

• .github/workflows/ci.yml: Added path filters and optimized matrix
• tests/e2e/cli-integration.test.ts: Skipped flaky pagination test
• package.json & manifest.json: Version bump to 1.6.0

Full Changelog: https://github.com/portel-dev/ncp/compare/v1.5.3...v1.6.0

Bug Fixes

• MCP Protocol Compliance: Refactored stdio listener setup to be protocol-compliant

Changes

• Extracted startStdioListener() method from run() for immediate stdio setup
• Made startStdioListener() idempotent to prevent duplicate listener registration
• Kept run() method for backwards compatibility with CLI usage
• Server now responds immediately to protocol messages after process spawn

This fix resolves connection issues with MCP clients that don't call run().

Full Changelog: https://github.com/portel-dev/ncp/compare/1.5.2...1.5.3

1.5.2 (2025-10-12)

Bug Fixes

• resolve script symlink to find actual installation directory (ad7f3c8)

1.5.1 (2025-10-12)

Bug Fixes

• enhance version utility to prefer global package version and improve local fallback logic in tests (8765c69)
• look for package.json after resolving the symlinks if found and update version in server.json (0f0c9c8)

1.5.0 (2025-10-11)

Features

• add installation metadata to server.json (fe0e25b)
• enhance MockServerManager with improved timeout management and error handling (edb0fb4)
• enhance MockServerManager with robust server startup and error handling; add Git mock server implementation (3488512)
• enhance test configurations with improved Jest settings and mock server management (ad7e893)
• implement MockServerManager to manage mock MCP server processes for tests (89d5b38)
• improve timeout handling in MCPServer and MCPHealthMonitor; enhance find command test assertions (d089f6b)
• update .npmignore and package.json to include TypeScript support and specify files for packaging (ae9bbcf)

Bug Fixes

• correct testMatch pattern to include both .js and .ts files (dec5625)

Bug fixes: mcp-name in README, updated schema to 2025-09-16, fixed dist/profiles inclusion

Bug Fixes

• Fix missing dist/profiles directory in npm package that caused module not found errors
• Update MCP registry server.json schema to 2025-09-16 (latest)

Previous Changes (1.4.x)

• Fix createWriteStream mock in orchestrator tests for CI compatibility
• Schema caching for faster tool discovery
• Improved configuration detection with Smithery support
• Session ID transparency for stateful MCP servers
• Enhanced usage message parsing for multiple arguments

Full changelog: https://github.com/portel-dev/ncp/blob/main/CHANGELOG.md

Bug Fixes

• Fix createWriteStream mock in orchestrator tests for CI compatibility

What's New in 1.4.x

• Schema caching for faster tool discovery
• Improved configuration detection with Smithery support
• Session ID transparency for stateful MCP servers
• Enhanced usage message parsing for multiple arguments

Full changelog: https://github.com/portel-dev/ncp/blob/main/CHANGELOG.md

Latest stable release with enhanced features

Current stable version featuring:

• Complete NCP Impact Analytics system
• Robust MCP orchestration and health monitoring
• Advanced tool discovery with semantic search
• Full CLI interface with comprehensive commands
• Optimized performance and reliability

Published to NPM: npm install -g @portel/[email protected]

Installation:

npm install -g @portel/[email protected]

Upgrading:

ncp update

Critical fixes and performance improvements

Hotfix release addressing:

• Improved CLI find performance and tool discovery
• Critical packaging fixes for NPM package integrity
• Better protocol compliance for MCP connections
• Restored accidentally deleted test files

Published to NPM: npm install -g @portel/[email protected]

Major feature release with NCP Impact Analytics

Significant new capabilities:

• NCP Impact Analytics system for usage tracking
• Enhanced MCP server management and health monitoring
• Improved tool discovery and orchestration
• Better CLI performance and user experience

Published to NPM: npm install -g @portel/[email protected]

Release workflow and dependency improvements

Patch release with:

• Updated release workflow for NPM Trusted Publisher
• Removed unused production dependencies
• Improved package integrity and security
• Minor bug fixes and optimizations

Published to NPM: npm install -g @portel/[email protected]

New features and architecture improvements

Major enhancements to NCP:

• Advanced tool discovery with semantic search
• Improved MCP server coordination
• Enhanced performance and reliability
• Expanded ecosystem support

Published to NPM: npm install -g @portel/[email protected]

Major feature enhancement

Significant improvements to NCP:

• Enhanced MCP discovery and management
• Improved tool orchestration capabilities
• Better error reporting and diagnostics
• Expanded CLI functionality

Published to NPM: npm install -g @portel/[email protected]

Improvements and stability fixes

Enhanced MCP orchestration with:

• Improved error handling and stability
• Better CLI argument processing
• Performance optimizations

Published to NPM: npm install -g @portel/[email protected]

Early release of NCP (Natural Context Provider)

Core MCP orchestration functionality with:

• Multi-server MCP coordination
• Basic tool discovery and execution
• Initial CLI interface

Published to NPM: npm install -g @portel/[email protected]