@modootoday/pmcp 0.13.0 → 0.14.0

package/plugins/inquirer-14/skills/inquirer/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: inquirer
+description: Use Inquirer.js 14's legacy prompt API correctly, including v14 prompt registration behavior, prompt-module creation, separators, and interactive-terminal limitations.
+---
+
+Verified against inquirer@14.2.2 on 2026-09-08. 3 of 3 examples executed.
+
+# inquirer (`^14.0.0`)
+
+## Scope and package shape
+
+This package is the legacy/maintenance Inquirer.js API. The newer prompt API is provided by `@inquirer/prompts`; both packages may be used together during migration.
+
+The version range resolves within major 14. The versioned documentation and source checked here are for `inquirer@14.0.2`.
+
+The default export is the `inquirer` object. Its documented surface includes:
+
+- `prompt(questions, answers)`
+- `createPromptModule()`
+- `registerPrompt(name, prompt)`
+- `restoreDefaultPrompts()`
+- `ui.Prompt`
+- `Separator`
+
+The built-in prompt types documented for the legacy API are `input`, `number`, `confirm`, `list`, `rawlist`, `expand`, `checkbox`, `password`, and `editor`. The v14 source also registers `search` and `select`.
+
+## The important v14 behavior change
+
+In v14, an unregistered prompt `type` throws. Older examples commonly rely on unknown types falling back to `input`; do not rely on that behavior. Register a custom prompt before asking a question that uses it:
+
+```ts pmcp-example
+import inquirer from 'inquirer';
+import assert from 'node:assert/strict';
+
+assert.equal(typeof inquirer.prompt, 'function');
+assert.equal(typeof inquirer.registerPrompt, 'function');
+assert.equal(typeof inquirer.createPromptModule, 'function');
+assert.equal(typeof inquirer.restoreDefaultPrompts, 'function');
+assert.equal(typeof inquirer.Separator, 'function');
+```
+
+The registration API is:
+
+```ts
+inquirer.registerPrompt('custom', customPrompt);
+const answers = await inquirer.prompt([
+  { type: 'custom', ...config },
+]);
+```
+
+The supplied research does not specify the custom prompt implementation contract. Use the contract required by the custom prompt package or source being integrated rather than assuming the old fallback behavior.
+
+## Asking questions
+
+The usual API is:
+
+```ts
+inquirer.prompt(questions, answers)
+```
+
+It returns a Promise. `questions` can be a question object, an array or map of questions, or an RxJS-compatible Observable. `answers` defaults to `{}`.
+
+Question objects commonly use these fields:
+
+- `type`, `name`, `message`, `default`, `choices`
+- `validate`, `filter`, `transformer`, `when`
+- `pageSize`, `prefix`, `suffix`
+- `askAnswered`, `loop`, `waitUserInput`
+
+Do not copy a test-runner example into a plain script. `describe`, `it`, and `expect` are not supplied by this package. A direct script must call `inquirer.prompt(...)` itself.
+
+## Non-interactive environments
+
+`prompt()` requires an interactive environment where `process.stdin.isTTY === true`. In a plain non-interactive process or CI process, it rejects with an error whose `isTtyError` property is true. However, invoking it in an environment that unexpectedly exposes a TTY can block waiting for input, so do not use a standalone non-interactive example to simulate a prompt.
+
+Handle the two error categories in application code like this:
+
+```ts
+inquirer.prompt(questions)
+  .then((answers) => {
+    // consume answers
+  })
+  .catch((error) => {
+    if (error.isTtyError) {
+      // The prompt could not be rendered in the current environment.
+    } else {
+      // Another error occurred.
+    }
+  });
+```
+
+The actual prompt interaction must be exercised by Inquirer's tool in an interactive environment. A plain script run as `bun example.ts` cannot safely provide a fake interactive transcript.
+
+## Prompt modules
+
+Use `createPromptModule()` when code needs a reusable prompt function:
+
+```ts pmcp-example
+import inquirer from 'inquirer';
+import assert from 'node:assert/strict';
+
+const prompt = inquirer.createPromptModule();
+assert.equal(typeof prompt, 'function');
+assert.notEqual(prompt, inquirer.prompt);
+```
+
+The returned function accepts the same question input described for `inquirer.prompt`; it still requires a TTY when it is actually called.
+
+## Separators in choices
+
+Use `new inquirer.Separator()` in a choice list to insert a visual separator:
+
+```ts pmcp-example
+import inquirer from 'inquirer';
+import assert from 'node:assert/strict';
+
+const separator = new inquirer.Separator();
+assert.ok(separator instanceof inquirer.Separator);
+assert.deepEqual(['Choice A', separator, 'Choice B'].length, 3);
+```
+
+## Reactive questions
+
+`prompt()` accepts an RxJS-compatible Observable of questions. The documented pattern is to send questions through the Observable and then complete it:
+
+```ts
+const prompts = new Rx.Subject();
+inquirer.prompt(prompts);
+prompts.next({ /* question */ });
+prompts.complete();
+```
+
+The returned prompt exposes `ui.process.subscribe(...)`. The required RxJS-compatible Observable implementation is not part of the package surface covered by the supplied research, so no standalone executable example is provided for this form.
+
+## Built-in prompt details and environment caveats
+
+The built-in types include the legacy types listed above; v14 source also registers `search` and `select`.
+
+Setting `INQUIRER_KEYBINDINGS=vim,emacs` enables user-selected keybindings. This disables `select` search.
+
+The `editor` prompt uses the user's `$VISUAL` or `$EDITOR`, with an OS fallback: `notepad` on Windows and `vim` on Linux/macOS.
+
+## Migration and v14 notes
+
+- Treat `inquirer` as the legacy API; prefer `@inquirer/prompts` for the newer API when the surrounding project permits it.
+- Keep the older question-object shape when maintaining existing `inquirer` code.
+- Do not expect an unknown prompt type to become an `input` prompt in v14.
+- v14 also fixed cursor positioning around line wraps.
+
+## Not covered
+
+This skill does not cover the implementation contract for custom prompt packages, the complete behavior or option set of each individual interactive prompt, an RxJS installation or Observable implementation, terminal key handling beyond the documented environment variable, or how to automate an interactive TTY. The `prompt()` and prompt-module execution paths are only safely exercised by the tool in an interactive environment; the standalone examples here cover the package surface that can be reached without interactive input.

package/plugins/ioredis-5/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "ioredis-5",
+  "version": "5.0.0",
+  "description": "Manage Redis commands, connection recovery and resource cleanup.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/ioredis-5/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/ioredis-5/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/ioredis-5/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "ioredis-5", "version": "5.0.0" }

package/plugins/ioredis-5/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "ioredis-5",
+  "version": "5.0.0",
+  "description": "Manage Redis commands, connection recovery and resource cleanup.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/ioredis-5/skills/ioredis/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: ioredis
+description: Use ioredis 5 for Redis connections, commands, pipelines, transactions, Pub/Sub and shutdown. Use for Node Redis integrations and BullMQ connection policies while preserving existing configuration and avoiding ioredis 6 RESP3 options.
+---
+
+# ioredis 5
+
+Inspect the installed major, endpoint source, connection ownership and retry settings first. This line targets ioredis 5.11.1. Reuse the project's connection factory; do not introduce another endpoint or change shared server settings.
+
+## Choose connection policy
+
+A request producer should fail within the caller's budget when Redis is unavailable. A long-lived BullMQ worker needs `maxRetriesPerRequest: null`; an existing ioredis connection supplied to a worker must already have it. Preserve the application's reconnect strategy and monitoring.
+
+```ts
+import Redis from "ioredis";
+
+export function createProducer(
+  redisUrl: string,
+  reportError: (error: Error) => void,
+) {
+  const client = new Redis(redisUrl, {
+    lazyConnect: true,
+    connectTimeout: 2000,
+    maxRetriesPerRequest: 1,
+    enableOfflineQueue: false,
+  });
+  client.on("error", reportError);
+  return client;
+}
+
+export async function increment(client: Redis, key: string) {
+  const results = await client
+    .pipeline()
+    .set(key, "1")
+    .incr(key)
+    .get(key)
+    .exec();
+  if (!results) throw new Error("Pipeline did not return results");
+  for (const [error] of results) {
+    if (error) throw error;
+  }
+  return results[2][1];
+}
+```
+
+For a lazy client, await `connect()` before commands with offline queuing disabled. `connectTimeout` bounds one attempt; retries, command timeouts and the caller's deadline determine the overall budget. `maxRetriesPerRequest: 1` alone does not guarantee a wall-clock timeout.
+
+## Interpret results and modes
+
+- `pipeline().exec()` returns one error/result pair per command. Inspect each pair; a resolved promise does not mean every command succeeded. Pipelines are not transactions.
+- `multi().exec()` runs a Redis transaction. Redis does not roll back successful commands when another command has a runtime error; inspect individual results.
+- Use a separate subscriber connection. Register its listener, await `subscribe`, then publish. A subscribed connection is not a general command connection.
+- Allocate a unique test namespace and delete only owned keys. Do not use `FLUSHDB`, global deletion or shared server configuration changes for routine test setup.
+
+Use `quit()` for orderly shutdown and `disconnect()` to stop reconnects when forced cleanup is necessary. Close BullMQ consumers before their connections. Ownership belongs to the creator; do not suppress connection errors or log credential-bearing URLs.
+
+The isolated fixture targets real commands, per-command errors, transactions, Pub/Sub, fail-fast writes and worker reconnection through a local TCP fault proxy. It uses an explicit loopback test endpoint and unique namespace. It does not prove Sentinel, Cluster, TLS, production failover or RESP3 behavior.
+
+## Primary sources and upstream skill reuse
+
+- [Pinned ioredis 5 README](https://github.com/redis/ioredis/blob/v5.11.1/README.md)
+- [BullMQ connections](https://docs.bullmq.io/guide/connections)
+- [Official Redis connection skill](https://github.com/redis/agent-skills/blob/d3d89fae1110012741e07b46926e91119d31e0e7/skills/redis-connections/SKILL.md), MIT licensed. Its other-language/RESP3 examples are not ioredis 5 APIs. These instructions are original text rather than copied upstream prose.

package/plugins/ioredis-6/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "ioredis-6",
+  "version": "6.0.0",
+  "description": "Use ioredis ^6.0.0 from Node.js 20+ for Redis commands, pipelines, Pub/Sub, Lua commands, streams, and RESP3-aware clients.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/ioredis-6/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/ioredis-6/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/ioredis-6/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "ioredis-6", "version": "6.0.0" }

package/plugins/ioredis-6/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "ioredis-6",
+  "version": "6.0.0",
+  "description": "Use ioredis ^6.0.0 from Node.js 20+ for Redis commands, pipelines, Pub/Sub, Lua commands, streams, and RESP3-aware clients.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}