local-skills-mcp 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 0.3.0 (2025-11-10)
+
+- feat: automate version syncing with generated server.json ([ad12154](https://github.com/kdpa-llc/local-skills-mcp/commit/ad12154))
+
+## <small>0.2.2 (2025-11-10)</small>
+
+- fix: trigger 0.2.2 release ([cce30a5](https://github.com/kdpa-llc/local-skills-mcp/commit/cce30a5))
+- chore: bump version to 0.2.2 ([1e26933](https://github.com/kdpa-llc/local-skills-mcp/commit/1e26933))
+
+## <small>0.2.1 (2025-11-09)</small>
+
+- fix: resolve symlink issue in entry point detection for npm global installs (#49) ([629ea38](https://github.com/kdpa-llc/local-skills-mcp/commit/629ea38)), closes [#49](https://github.com/kdpa-llc/local-skills-mcp/issues/49) [#48](https://github.com/kdpa-llc/local-skills-mcp/issues/48)
+
+## 0.2.0 (2025-11-08)
+
+- feat: add code quality tools (ESLint, Prettier, Husky) (#16) ([870a240](https://github.com/kdpa-llc/local-skills-mcp/commit/870a240)), closes [#16](https://github.com/kdpa-llc/local-skills-mcp/issues/16) [#16](https://github.com/kdpa-llc/local-skills-mcp/issues/16)
+- feat: add GitHub Actions CI/CD workflows (#15) ([bc95dbf](https://github.com/kdpa-llc/local-skills-mcp/commit/bc95dbf)), closes [#15](https://github.com/kdpa-llc/local-skills-mcp/issues/15) [#15](https://github.com/kdpa-llc/local-skills-mcp/issues/15)
+- feat: configure Dependabot for automated dependency management (#18) ([44a4eb0](https://github.com/kdpa-llc/local-skills-mcp/commit/44a4eb0)), closes [#18](https://github.com/kdpa-llc/local-skills-mcp/issues/18) [#18](https://github.com/kdpa-llc/local-skills-mcp/issues/18)
+- feat: implement semantic-release for automated versioning (#19) ([af79614](https://github.com/kdpa-llc/local-skills-mcp/commit/af79614)), closes [#19](https://github.com/kdpa-llc/local-skills-mcp/issues/19) [#19](https://github.com/kdpa-llc/local-skills-mcp/issues/19)
+- feat: Include package built-in skills as default base (#7) ([b18f61f](https://github.com/kdpa-llc/local-skills-mcp/commit/b18f61f)), closes [#7](https://github.com/kdpa-llc/local-skills-mcp/issues/7) [#7](https://github.com/kdpa-llc/local-skills-mcp/issues/7)
+- feat: npm publishing with OIDC trusted publishers and initial v0.1.0 release (#46) ([b660431](https://github.com/kdpa-llc/local-skills-mcp/commit/b660431)), closes [#46](https://github.com/kdpa-llc/local-skills-mcp/issues/46)
+- Add comprehensive API documentation (#23) ([6434598](https://github.com/kdpa-llc/local-skills-mcp/commit/6434598)), closes [#23](https://github.com/kdpa-llc/local-skills-mcp/issues/23) [Hi#level](https://github.com/Hi/issues/level) [#23](https://github.com/kdpa-llc/local-skills-mcp/issues/23)
+- Add comprehensive test suite achieving 95%+ coverage with unit, integration, and E2E tests (#29) ([5971d31](https://github.com/kdpa-llc/local-skills-mcp/commit/5971d31)), closes [#29](https://github.com/kdpa-llc/local-skills-mcp/issues/29)
+- Add GitHub Sponsors funding option ([d86f368](https://github.com/kdpa-llc/local-skills-mcp/commit/d86f368))
+- Add project documentation for Claude Code ([4c5683d](https://github.com/kdpa-llc/local-skills-mcp/commit/4c5683d))
+- Add repository-specific example skills and comprehensive usage guide ([e3ca56d](https://github.com/kdpa-llc/local-skills-mcp/commit/e3ca56d)), closes [hi#quality](https://github.com/hi/issues/quality)
+- Claude/enable full hot reload 011 c us6 eneh bty xhds km xyqv (#45) ([0cc9740](https://github.com/kdpa-llc/local-skills-mcp/commit/0cc9740)), closes [#45](https://github.com/kdpa-llc/local-skills-mcp/issues/45)
+- Configure branch protection and repository settings (#21) ([d9919bc](https://github.com/kdpa-llc/local-skills-mcp/commit/d9919bc)), closes [#21](https://github.com/kdpa-llc/local-skills-mcp/issues/21) [#21](https://github.com/kdpa-llc/local-skills-mcp/issues/21)
+- Enhance contributor experience with automation (#22) ([b3ac1ad](https://github.com/kdpa-llc/local-skills-mcp/commit/b3ac1ad)), closes [#22](https://github.com/kdpa-llc/local-skills-mcp/issues/22) [#22](https://github.com/kdpa-llc/local-skills-mcp/issues/22)
+- Enhance README with badges, ToC, demo section, and comprehensive FAQ ([3986194](https://github.com/kdpa-llc/local-skills-mcp/commit/3986194))
+- Fix repository references and optimize npm packaging ([3944ca4](https://github.com/kdpa-llc/local-skills-mcp/commit/3944ca4))
+- Fix version numbers in SECURITY.md ([06a14e3](https://github.com/kdpa-llc/local-skills-mcp/commit/06a14e3))
+- Streamline and fix README documentation ([43cce88](https://github.com/kdpa-llc/local-skills-mcp/commit/43cce88))
+- Streamline and refine README (#4) ([cb04ece](https://github.com/kdpa-llc/local-skills-mcp/commit/cb04ece)), closes [#4](https://github.com/kdpa-llc/local-skills-mcp/issues/4)
+- Update repository URLs from moscaverd to kdpa-llc organization ([da739be](https://github.com/kdpa-llc/local-skills-mcp/commit/da739be))
+- fix: resolve linting errors and sync fork with upstream (#41) ([dc6965c](https://github.com/kdpa-llc/local-skills-mcp/commit/dc6965c)), closes [#41](https://github.com/kdpa-llc/local-skills-mcp/issues/41)
+- fix: resolve test file handle leaks and improve cross-platform compatibility ([ccc2408](https://github.com/kdpa-llc/local-skills-mcp/commit/ccc2408))
+- ci(deps): bump actions/checkout from 4 to 5 ([a0fa14f](https://github.com/kdpa-llc/local-skills-mcp/commit/a0fa14f))
+- ci(deps): bump actions/setup-node from 4 to 6 ([75eac33](https://github.com/kdpa-llc/local-skills-mcp/commit/75eac33))
+- ci(deps): bump codecov/codecov-action from 4 to 5 ([d8a95e3](https://github.com/kdpa-llc/local-skills-mcp/commit/d8a95e3))
+- ci(deps): bump github/codeql-action from 3 to 4 ([2b2820e](https://github.com/kdpa-llc/local-skills-mcp/commit/2b2820e))
+- chore: exclude CLAUDE.md from git and npm, add .tmp/ for temporary files ([7c2f06d](https://github.com/kdpa-llc/local-skills-mcp/commit/7c2f06d))
+- chore(deps-dev): bump @types/node from 22.18.13 to 24.10.0 ([af8bc4f](https://github.com/kdpa-llc/local-skills-mcp/commit/af8bc4f))
+- chore(deps-dev): bump the development-dependencies group with 2 updates (#37) ([6ce77d2](https://github.com/kdpa-llc/local-skills-mcp/commit/6ce77d2)), closes [#37](https://github.com/kdpa-llc/local-skills-mcp/issues/37)
+- docs: replace hardcoded values with dynamic references (#20) ([45a8d80](https://github.com/kdpa-llc/local-skills-mcp/commit/45a8d80)), closes [#20](https://github.com/kdpa-llc/local-skills-mcp/issues/20) [#20](https://github.com/kdpa-llc/local-skills-mcp/issues/20)
+
+# Changelog
+
 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.0.0/),
@@ -8,11 +58,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
+
 - Package built-in skills directory as base default for all MCP instances
 - Self-documenting capabilities: `local-skills-mcp-usage`, `local-skills-mcp-guide`, and `skill-creator` skills
 - Skills are now available immediately after installation with zero configuration
 
 ### Changed
+
 - Directory aggregation priority updated to include package built-in skills as lowest priority (first in list)
 - Updated documentation to reflect new built-in skills feature
 
@@ -25,16 +77,19 @@ This is the initial public release of Local Skills MCP - a proof of concept for
 ### Features
 
 #### Universal LLM/Agent Support
+
 - Works with any MCP-compatible client (Claude Code, Claude Desktop, Cline, Continue.dev, custom agents)
 - Portable skills that work across multiple AI systems
 - LLM-agnostic design (Claude, GPT, Gemini, local models, etc.)
 
 #### Efficient Context Management
+
 - Lazy loading: only skill names and descriptions initially visible (~50 tokens per skill)
 - Full content loads on-demand, preserving 95%+ of context window
 - Progressive disclosure pattern optimized for context efficiency
 
 #### Powerful Skill Management
+
 - Standard SKILL.md format with YAML frontmatter
 - Automatic aggregation from multiple directories (~/.claude/skills, ./.claude/skills, ./skills, custom)
 - Dynamic discovery: tool description updates in real-time with available skills
@@ -42,6 +97,7 @@ This is the initial public release of Local Skills MCP - a proof of concept for
 - Ultra-simple API: single `get_skill` tool with built-in discovery
 
 #### Open Source Best Practices
+
 - Comprehensive contribution guidelines (CONTRIBUTING.md)
 - Code of Conduct (Contributor Covenant v2.0)
 - Security policy and vulnerability reporting (SECURITY.md)
@@ -50,6 +106,7 @@ This is the initial public release of Local Skills MCP - a proof of concept for
 - MIT License
 
 ### Technical Implementation
+
 - TypeScript with Node.js 18+
 - Model Context Protocol SDK integration
 - Version centralized in package.json (single source of truth)
@@ -63,31 +120,37 @@ This is the initial public release of Local Skills MCP - a proof of concept for
 The following versions were internal development iterations before the public release:
 
 ### [Internal 2.2.0] - 2025-11-01
+
 - Simplified to single tool (removed list_skills)
 - Generic, utilization-focused tool descriptions
 - Dynamic skill list in get_skill description
 
 ### [Internal 2.1.0] - 2025-11-01
+
 - Enhanced tool descriptions following Claude Skills best practices
 - Added comprehensive documentation on skill description patterns
 - Improved trigger keyword matching
 
 ### [Internal 2.0.0] - 2025-10-30
+
 - Changed to official Claude Skills format (SKILL.md)
 - Added multi-directory skill aggregation
 - Removed custom skill.json format
 
 ### [Internal 1.0.0] - 2025-10-29
+
 - Initial prototype with custom format
 - Four MCP tools with parameter interpolation
 
 ---
 
 <!-- Version Links -->
+
 [0.1.0]: https://github.com/kdpa-llc/local-skills-mcp/releases/tag/v0.1.0
 [unreleased]: https://github.com/kdpa-llc/local-skills-mcp/compare/v0.1.0...HEAD
 
 <!-- Reference Links -->
+
 [repo]: https://github.com/kdpa-llc/local-skills-mcp
 [issues]: https://github.com/kdpa-llc/local-skills-mcp/issues
 [pulls]: https://github.com/kdpa-llc/local-skills-mcp/pulls

package/dist/index.js

@@ -254,7 +254,8 @@ export class LocalSkillsServer {
 }
 // Start the server only if this module is being run directly
 /* istanbul ignore if */
-if (import.meta.url === `file://${process.argv[1]}`) {
+if (import.meta.url === `file://${process.argv[1]}` ||
+    (process.argv[1] && __filename === fs.realpathSync(process.argv[1]))) {
     const server = new LocalSkillsServer();
     server.run().catch((error) => {
         console.error("Fatal error running server:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-skills-mcp",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Universal MCP server enabling any LLM or AI agent to utilize expert skills from your local filesystem. Reduces context consumption through lazy loading - only skill names visible initially, full content loads on-demand. Works with Claude, Cline, custom agents, and any MCP-compatible client.",
   "type": "module",
   "main": "dist/index.js",
@@ -37,6 +37,7 @@
     "format:check": "prettier --check \"**/*.{ts,json,md}\"",
     "typecheck": "tsc --noEmit",
     "verify:links": "node scripts/verify-links.js",
+    "generate:server-json": "node scripts/generate-server-json.js",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch"
   },
@@ -91,6 +92,7 @@
     "@eslint/js": "^9.39.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^12.0.1",
     "@semantic-release/npm": "^13.1.1",