@modootoday/pmcp 0.13.0 → 0.14.0

package/plugins/commander-15/skills/commander/SKILL.md

@@ -0,0 +1,204 @@
+---
+name: commander
+description: Use Commander 15.0.0 for ESM command-line parsing, options, arguments, subcommands, and custom option definitions.
+---
+
+Verified against commander@15.0.0 on 2026-09-07. 8 of 8 examples executed.
+
+# Commander 15
+
+## Runtime and module shape
+
+Commander `^15.0.0` is ESM-only and requires Node.js `>=22.12.0`. Import from the package with ESM syntax:
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { Command } from 'commander';
+
+const command = new Command();
+assert.ok(command instanceof Command);
+```
+
+Do not copy the older CommonJS shape:
+
+```js
+const { Command } = require('commander');
+```
+
+Commander 15 removed the deprecated `commander/esm.mjs` entry point. CommonJS consumers can therefore encounter module or tooling configuration problems.
+
+## Parse a command
+
+`program.parse(arguments)` parses the supplied argument array; when no argument is supplied, it defaults to `process.argv`. Parsed options are read with `.opts()`, and unconsumed arguments are in `.args`.
+
+Use the documented post-v7 option-access shape by default:
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { program } from 'commander';
+
+program
+  .option('--first')
+  .option('-s, --separator <char>')
+  .argument('<string>');
+
+program.parse(['node', 'string-util', '--first', '-s', ':', 'a:b:c']);
+
+const options = program.opts();
+assert.equal(options.first, true);
+assert.equal(options.separator, ':');
+assert.deepEqual(program.args, ['a:b:c']);
+
+const limit = options.first ? 1 : undefined;
+assert.deepEqual(program.args[0].split(options.separator, limit), ['a']);
+```
+
+The split limit is a JavaScript `String.prototype.split` limit: with `--first`, a limit of `1` produces only the first substring.
+
+The older property-access style is not the default. It is available only when explicitly enabled for unmodified legacy code:
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { Command } from 'commander';
+
+const command = new Command();
+command.storeOptionsAsProperties().option('-d, --debug');
+command.parse(['node', 'tool', '--debug']);
+
+assert.equal(command.debug, true);
+assert.equal(command.opts().debug, true);
+```
+
+## Define options and arguments
+
+Use `Command` methods for straightforward definitions. A required option value uses `<value>`; an optional value uses `[value]`.
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { Command } from 'commander';
+
+const command = new Command();
+command
+  .name('string-util')
+  .description('String utilities')
+  .version('0.8.0')
+  .argument('<string>')
+  .option('--first')
+  .option('-s, --separator <char>', 'separator character', ',');
+
+command.parse(['node', 'string-util', '-s', ':', 'a:b:c']);
+const options = command.opts();
+assert.equal(command.name(), 'string-util');
+assert.equal(options.separator, ':');
+assert.equal(options.first, undefined);
+assert.deepEqual(command.args, ['a:b:c']);
+```
+
+Actions receive parsed command arguments followed by the command options. A command with an action runs in the same process and can be exercised from a plain script:
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { Command } from 'commander';
+
+const command = new Command();
+let received: unknown;
+command
+  .command('split')
+  .argument('<string>')
+  .option('--first')
+  .action((value, options) => {
+    received = [value, options];
+  });
+
+command.parse(['node', 'tool', 'split', '--first', 'a,b']);
+assert.deepEqual(received, ['a,b', { first: true }]);
+```
+
+## Custom `Option` definitions
+
+Use `Option` when you need defaults, allowed choices, environment variables, optional-value presets, or argument parsing. Options can also be hidden, made mutually exclusive with `.conflicts()`, or made dependent with `.implies()`.
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { Command, Option } from 'commander';
+
+const command = new Command();
+command
+  .addOption(new Option('-s, --secret').hideHelp())
+  .addOption(new Option('-t, --timeout <delay>').default(60, 'one minute'))
+  .addOption(new Option('-d, --drink <size>').choices(['small', 'medium', 'large']))
+  .addOption(new Option('--donate [amount]').preset('20').argParser(parseFloat))
+  .addOption(new Option('--disable-server').conflicts('timeout'))
+  .addOption(new Option('--free-drink').implies({ drink: 'small' }));
+
+command.parse(['node', 'tool', '--drink', 'large', '--donate', '3.5']);
+const options = command.opts();
+assert.equal(options.drink, 'large');
+assert.equal(options.donate, 3.5);
+assert.equal(options.timeout, 60);
+```
+
+An option can read its value from an environment variable with `.env('NAME')`:
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import { Command, Option } from 'commander';
+
+const command = new Command();
+command.addOption(new Option('-p, --port <number>').env('PORT'));
+command.parse(['node', 'tool'], { from: 'node' });
+
+assert.equal(command.opts().port, undefined);
+```
+
+## Constructors and factory functions
+
+The documented root exports include `Command`, `Option`, `Argument`, `Help`, `CommanderError`, `InvalidArgumentError`, the deprecated alias `InvalidOptionArgumentError`, `program`, `createCommand`, `createOption`, and `createArgument`. The factories create the corresponding objects without requiring direct construction.
+
+```ts pmcp-example
+import { strict as assert } from 'node:assert';
+import {
+  Argument,
+  Command,
+  Option,
+  createArgument,
+  createCommand,
+  createOption,
+  program,
+} from 'commander';
+
+assert.ok(program instanceof Command);
+assert.ok(new Command() instanceof Command);
+assert.ok(new Option('--verbose') instanceof Option);
+assert.ok(new Argument('<file>') instanceof Argument);
+assert.ok(createCommand('tool') instanceof Command);
+assert.ok(createOption('--verbose') instanceof Option);
+assert.ok(createArgument('<file>') instanceof Argument);
+```
+
+## Subcommands
+
+There are two different `.command()` forms:
+
+- A command with a callback/action can be defined in the same process.
+- A command with a description and no action is a stand-alone executable subcommand. Commander searches beside the entry script for names such as `command-subcommand`, tries common extensions, and launches the executable as a child process.
+
+For stand-alone executables, declare their options in the executable itself. Top-level options are not declared for them, and the `.command()` argument syntax is the argument-declaration method available for stand-alone executables.
+
+A stand-alone definition has this shape:
+
+```js
+program
+  .command('install [package-names...]', 'install one or more packages')
+  .command('update', 'update installed packages', {
+    executableFile: 'myUpdateSubCommand'
+  });
+```
+
+A `.ts` stand-alone executable requires invocation through Node with `ts-node`, for example `node -r ts-node/register pm.ts`.
+
+When passing arguments through `npm run-script`, use `--`, for example `npm run-script <command> [-- <args>]`.
+
+## Does not cover
+
+This skill does not cover Commander APIs or behaviors not established by the supplied research, including detailed help customization, error-handling flows, asynchronous parsing, the full `Help`/error-class API, or the exact executable-discovery rules beyond the documented summary above. Stand-alone executable subcommands are not exercised by the self-contained examples because they require separate files and process invocation.

package/plugins/content-type-3/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "content-type-3",
+  "version": "3.0.0",
+  "description": "Use content-type 3.x as an ESM-only parser and formatter for HTTP Content-Type header values. Covers parse options, formatting, validation boundaries, and migration away from older CommonJS/request-response examples.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/content-type-3/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/content-type-3/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/content-type-3/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "content-type-3", "version": "3.0.0" }

package/plugins/content-type-3/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "content-type-3",
+  "version": "3.0.0",
+  "description": "Use content-type 3.x as an ESM-only parser and formatter for HTTP Content-Type header values. Covers parse options, formatting, validation boundaries, and migration away from older CommonJS/request-response examples.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/content-type-3/skills/content-type/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: content-type
+description: Use content-type 3.x as an ESM-only parser and formatter for HTTP Content-Type header values. Covers parse options, formatting, validation boundaries, and migration away from older CommonJS/request-response examples.
+---
+
+Verified against content-type@3.0.0 on 2026-09-08. 5 of 5 examples executed.
+
+# content-type
+
+## Scope
+
+This skill targets `content-type` `^3.0.0` (3.0.0). The package is ESM-only and requires Node.js `>=22`.
+
+Import the package as an ESM namespace:
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as contentType from "content-type";
+
+const parsed = contentType.parse("image/svg+xml; charset=utf-8");
+
+assert.equal(parsed.type, "image/svg+xml");
+assert.equal(parsed.parameters.charset, "utf-8");
+```
+
+## Parse a Content-Type string
+
+Use `parse(string, options?)`. The result contains `type` and `parameters`. Parameter names are lower case.
+
+The parser is lenient and does not error. Validate the returned `type` and `parameters` before trusting them.
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as contentType from "content-type";
+
+const parsed = contentType.parse("Text/Plain; CHARSET=utf-8");
+
+assert.equal(parsed.type, "text/plain");
+assert.equal(parsed.parameters.charset, "utf-8");
+```
+
+## Parse options
+
+The documented options are:
+
+- `parameters: true` by default. Set it to `false` to skip parameters.
+- `comma: false` by default. Set it to `true` to stop parsing at a comma.
+- `start: 0` by default. Set it to the index from which parsing should begin.
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as contentType from "content-type";
+
+const withoutParameters = contentType.parse(
+  "text/plain; charset=utf-8",
+  { parameters: false },
+);
+assert.equal(withoutParameters.type, "text/plain");
+assert.deepEqual(withoutParameters.parameters, {});
+
+const firstValue = contentType.parse(
+  "text/plain, application/json",
+  { comma: true },
+);
+assert.equal(firstValue.type, "text/plain");
+
+const fromOffset = contentType.parse(
+  "prefix text/html; charset=utf-8",
+  { start: "prefix ".length },
+);
+assert.equal(fromOffset.type, "text/html");
+assert.equal(fromOffset.parameters.charset, "utf-8");
+```
+
+## Format a Content-Type value
+
+Use `format({ type, parameters? })` to create a Content-Type header string. `parameters` is optional.
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as contentType from "content-type";
+
+assert.equal(
+  contentType.format({
+    type: "image/svg+xml",
+    parameters: { charset: "utf-8" },
+  }),
+  "image/svg+xml; charset=utf-8",
+);
+
+assert.equal(
+  contentType.format({ type: "application/json" }),
+  "application/json",
+);
+```
+
+`format` throws `TypeError` for an invalid media type or invalid parameter name. Treat this as validation at the formatting boundary rather than relying on the lenient parser to validate input.
+
+```ts pmcp-example
+import * as assert from "node:assert/strict";
+import * as contentType from "content-type";
+
+assert.throws(
+  () => contentType.format({ type: "not a valid type" }),
+  TypeError,
+);
+
+assert.throws(
+  () => contentType.format({
+    type: "text/plain",
+    parameters: { "invalid parameter name": "value" },
+  }),
+  TypeError,
+);
+```
+
+## Migration traps
+
+- Do not use the older CommonJS shape (`require('content-type')`) with version 3.0.0. This release is ESM-only; use `import * as contentType from "content-type"`.
+- Do not assume the older 1.x request/response overloads are part of the current documented API. The current documented call is `parse(string, options?)`, not `parse(req)` or `parse(res)`.
+- Do not assume parsing validates input. The parser is documented as lenient and non-throwing; validate its returned `type` and `parameters` before trusting them.
+- Do not treat repository development commands such as `build`, `test`, `specs`, `bench`, or `format` as application APIs.
+
+## What this skill does not cover
+
+The research does not specify the complete grammar accepted by the parser, every edge-case result for malformed input, exact error messages, TypeScript type details, or integration with HTTP request/response objects. It also does not cover a CLI or runner API; none is documented for this package.

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

@@ -0,0 +1,9 @@
+{
+  "name": "croner-10",
+  "version": "10.0.0",
+  "description": "Use Croner 10.x (^10.0.0, documented at 10.0.1) to calculate, match, schedule, and control cron jobs in plain JavaScript/TypeScript scripts.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/croner-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/croner-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/croner-10/gemini-extension.json

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

package/plugins/croner-10/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "croner-10",
+  "version": "10.0.0",
+  "description": "Use Croner 10.x (^10.0.0, documented at 10.0.1) to calculate, match, schedule, and control cron jobs in plain JavaScript/TypeScript scripts.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}