@modootoday/pmcp 0.13.1 → 0.14.1

package/plugins/emittery-2/skills/emittery/SKILL.md

@@ -0,0 +1,234 @@
+---
+name: emittery
+description: Use Emittery 2.x for asynchronous typed event emission, subscriptions, one-shot waits, async iterables, and listener lifecycle management.
+---
+
+Verified against emittery@2.0.0 on 2026-09-08. 9 of 9 examples executed.
+
+# Emittery 2.x
+
+## Version and runtime
+
+This skill targets `emittery` `^2.0.0`. Emittery 2 requires Node.js 22. It works in browsers when bundled, but this skill's examples are standalone Bun scripts.
+
+There is no package-specific runner or CLI documented here. Use the programmatic `Emittery` API.
+
+## Critical v2 migration rule
+
+Emittery 2 passes an event object to listeners, not the raw event data:
+
+```ts
+emitter.on('event', ({name, data}) => {
+	// ...
+});
+```
+
+This applies to `on`, `onAny`, `once` results, `events()`, and `anyEvent()`. Code written for v1 commonly still uses `data => ...`, `(eventName, eventData) => ...`, or `const data = await emitter.once(...)`; those shapes are incorrect in v2.
+
+Emission is asynchronous. `emit()` runs listeners concurrently and must be awaited when ordering or errors matter. `emitSerial()` waits for each listener before invoking the next one.
+
+## Basic subscription and removal
+
+`on(eventName, listener, options?)` returns an unsubscribe function. The listener may be synchronous or asynchronous. `off(eventName, listener)` removes a listener explicitly. Both methods accept one event name or a readonly array of event names.
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const received: unknown[] = [];
+
+const listener = ({name, data}: {name: string; data: unknown}) => {
+	received.push([name, data]);
+};
+
+const off = emitter.on('message', listener);
+await emitter.emit('message', 'hello');
+off();
+await emitter.emit('message', 'ignored');
+
+assert.deepEqual(received, [['message', 'hello']]);
+```
+
+An `AbortSignal` can be supplied to `on`; aborting it removes the subscription.
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const controller = new AbortController();
+let count = 0;
+
+emitter.on('tick', () => {
+	count++;
+}, {signal: controller.signal});
+
+await emitter.emit('tick');
+controller.abort();
+await emitter.emit('tick');
+
+assert.equal(count, 1);
+```
+
+## One-shot listeners
+
+`once(eventName, predicate?)` returns a promise resolving to the v2 event object. Destructure `{data}` rather than treating the resolved value as the data itself. The predicate also receives the event object.
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const result = emitter.once('data', ({data}: {name: string; data: {ok: boolean; value: number}}) => data.ok);
+
+await emitter.emit('data', {ok: false, value: 1});
+await emitter.emit('data', {ok: true, value: 2});
+
+const {name, data} = await result;
+assert.equal(name, 'data');
+assert.deepEqual(data, {ok: true, value: 2});
+```
+
+## Concurrent and serial emission
+
+`emit(name, data?)` invokes all matching listeners asynchronously and concurrently. If listeners reject, all listeners still run and the returned promise rejects with an `AggregateError`; listener errors are available as `error.errors`.
+
+`emitSerial(name, data?)` waits between listeners, so use it when listener order or completion order is significant.
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const order: string[] = [];
+
+emitter.on('event', async () => {
+	order.push('first-start');
+	await Promise.resolve();
+	order.push('first-end');
+});
+emitter.on('event', () => {
+	order.push('second');
+});
+
+await emitter.emitSerial('event');
+assert.deepEqual(order, ['first-start', 'first-end', 'second']);
+```
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+let completed = 0;
+
+emitter.on('event', () => {
+	completed++;
+});
+emitter.on('event', async () => {
+	throw new Error('listener failure');
+});
+
+await assert.rejects(
+	emitter.emit('event'),
+	(error: any) => error instanceof AggregateError
+		&& Array.isArray(error.errors)
+		&& error.errors.length === 1
+		&& completed === 1,
+);
+```
+
+## Async event streams
+
+`events(eventName)` returns an async iterable for one event name. `anyEvent()` returns an async iterable of `{name, data}` for all events. Break the loop when the desired event has been received.
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const values: unknown[] = [];
+
+const stream = emitter.events('message');
+const consuming = (async () => {
+	for await (const {data} of stream) {
+		values.push(data);
+		if (data === 'stop') {
+			break;
+		}
+	}
+})();
+
+await emitter.emit('message', 'one');
+await emitter.emit('message', 'stop');
+await consuming;
+
+assert.deepEqual(values, ['one', 'stop']);
+```
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const seen: unknown[] = [];
+
+const consuming = (async () => {
+	for await (const {name, data} of emitter.anyEvent()) {
+		seen.push([name, data]);
+		break;
+	}
+})();
+
+await emitter.emit('ready', 42);
+await consuming;
+assert.deepEqual(seen, [['ready', 42]]);
+```
+
+## Any-event listeners and listener inspection
+
+`onAny(listener)` receives one `{name, data}` object. `offAny(listener)` removes it. `listenerCount(eventName?)` reports listeners associated with the event, including an `onAny` listener when an event name is supplied. `clearListeners(eventName?)` clears listeners.
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const emitter = new Emittery();
+const seen: unknown[] = [];
+const listener = ({name, data}: {name: string; data: unknown}) => {
+	seen.push([name, data]);
+};
+
+emitter.onAny(listener);
+assert.equal(emitter.listenerCount('event'), 1);
+await emitter.emit('event', 1);
+assert.deepEqual(seen, [['event', 1]]);
+
+emitter.offAny(listener);
+emitter.on('event', () => {});
+assert.equal(emitter.listenerCount('event'), 1);
+emitter.clearListeners('event');
+assert.equal(emitter.listenerCount('event'), 0);
+```
+
+## Other documented API
+
+The instance also exposes `init`, `logIfDebugEnabled`, and `bindMethods`. `bindMethods(object)` binds Emittery methods onto another object:
+
+```ts pmcp-example
+import Emittery from 'emittery';
+import assert from 'node:assert/strict';
+
+const object: Record<string, any> = {};
+new Emittery().bindMethods(object);
+
+assert.equal(typeof object.emit, 'function');
+assert.equal(typeof object.on, 'function');
+```
+
+The type declarations export `EventName`, `EmitteryEvent`, `DebugLogger`, `DebugOptions`, `Options`, `EmitteryOncePromise`, `UnsubscribeFunction`, and `ListenerChangedData`. The default export is `Emittery`; its documented runtime static members include `isDebugEnabled`, `listenerAdded`, `listenerRemoved`, and `mixin`.
+
+## Not covered
+
+The research does not specify the signatures or behavior of `init`/`deinit`, debug configuration and logging, the static members, `mixin`, decorator support, disposable integrations, typed `AllEventData` declaration patterns, or the exact cancellation behavior of one-shot operations. Consult the package's v2 declarations and documentation before using those areas.

package/plugins/eslint-10/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "eslint-10",
+  "version": "10.0.0",
+  "description": "Verify flat lint configuration against ESLint 10 and preserve upgrade boundaries.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/eslint-10/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/eslint-10/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/eslint-10/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "eslint-10", "version": "10.0.0" }

package/plugins/eslint-10/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "eslint-10",
+  "version": "10.0.0",
+  "description": "Verify flat lint configuration against ESLint 10 and preserve upgrade boundaries.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/eslint-10/skills/eslint/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: eslint
+description: Configure and run ESLint 10 flat-config workflows, account for file-relative configuration lookup and removed legacy APIs, and verify JavaScript fixes or TypeScript project-aware diagnostics using compatible plugins.
+---
+
+# ESLint 10 flat configuration
+
+Read the installed versions and their engine/peer ranges. The fixture targets
+ESLint 10.10.0, typescript-eslint 8.70.0 and TypeScript 5.9.3. That ESLint version's
+Node range is ^20.19.0, ^22.13.0 or >=24; do not assume every newer odd-numbered
+Node release between those ranges is supported.
+
+## Account for major-specific lookup
+
+ESLint 10 requires flat configuration and removes legacy eslintrc support.
+Configuration lookup starts from the linted file's directory rather than always
+from the process working directory. In a monorepo, inspect the config applying to
+each target file before moving config files or changing the invocation root.
+
+```js
+import { defineConfig } from "eslint/config";
+
+export default defineConfig(
+  { ignores: ["generated/**"] },
+  { files: ["src/**/*.js"], rules: { "no-unused-vars": "error" } },
+);
+```
+
+Use explicit files globs and global ignore objects. --print-config on a real
+target and a narrowly scoped CLI invocation reveal configuration-selection issues
+more reliably than whether importing eslint succeeds.
+
+## Scope typed configuration
+
+```js
+import { defineConfig } from "eslint/config";
+import tseslint from "typescript-eslint";
+
+export default defineConfig({
+  files: ["src/**/*.ts"],
+  extends: [tseslint.configs.recommendedTypeChecked],
+  languageOptions: {
+    parserOptions: {
+      projectService: true,
+      tsconfigRootDir: import.meta.dirname,
+    },
+  },
+});
+```
+
+Check plugin compatibility with ESLint 10. Parsing TypeScript alone does not
+provide the project information required by typed rules. Keep the file within
+its intended tsconfig and avoid broad default-project fallbacks that increase
+memory or conceal an incorrect project boundary.
+
+Custom plugins may depend on context or SourceCode methods removed in ESLint 10.
+Update the plugin's supported API rather than disabling unrelated diagnostics.
+The major also changes JSX reference tracking and recommended rules; inspect
+new diagnostics during an explicitly requested migration.
+
+## Run and verify
+
+Use the installed CLI. Exit 0 means no failures under the configured thresholds,
+1 means lint violations and 2 means configuration/execution failure. Inspect
+structured diagnostics and verify --fix output with another lint invocation.
+Preserve the project's formatter and typecheck boundaries.
+
+The fixture performs actual flat-config and typed linting, a bounded JavaScript
+fix, and clean validation with malformed ignored input excluded. It does not
+establish compatibility with every third-party rule or legacy configuration.
+
+## Sources
+
+- [ESLint 10 migration and removed APIs](https://eslint.org/docs/latest/use/migrate-to-10.0.0)
+- [Flat configuration](https://eslint.org/docs/latest/use/configure/configuration-files)
+- [CLI exit codes and fixes](https://eslint.org/docs/latest/use/command-line-interface)
+- [typescript-eslint typed linting](https://typescript-eslint.io/getting-started/typed-linting/)

package/plugins/eslint-9/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "eslint-9",
+  "version": "9.0.0",
+  "description": "Configure and verify flat lint rules using the installed ESLint 9 toolchain.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/eslint-9/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/eslint-9/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/eslint-9/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "eslint-9", "version": "9.0.0" }

package/plugins/eslint-9/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "eslint-9",
+  "version": "9.0.0",
+  "description": "Configure and verify flat lint rules using the installed ESLint 9 toolchain.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}