@modootoday/pmcp 0.13.1 → 0.14.1

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/"
+}

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

@@ -0,0 +1,182 @@
+---
+name: croner
+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.
+---
+
+Verified against croner@10.0.1 on 2026-09-07. 4 of 4 examples executed.
+
+# croner
+
+## Scope and version
+
+This skill targets Croner 10.x, specifically the documented 10.0.1 line. It is a library, not a separate runner or CLI: import `Cron` and use it from your program. Documented runtime targets include Node.js >=18, Deno >=2, Bun >=1, and browsers.
+
+## Import correctly
+
+Use the named export and instantiate it with `new`:
+
+```ts
+import { Cron } from "croner";
+```
+
+CommonJS uses:
+
+```ts
+const { Cron } = require("croner");
+```
+
+Do not use `import Cron from "croner"`; the default export was removed in v9. Do not omit `new`.
+
+## Constructing jobs
+
+The constructor accepts a cron pattern, a JavaScript `Date`, or an ISO 8601 string as its first argument. A `Date` or ISO string creates a one-shot job. The second argument is optional options, and the third is an optional callback:
+
+```ts
+const job = new Cron("* * * * * *", { maxRuns: 1 }, () => {
+  // called by the schedule
+});
+```
+
+A callback can instead be supplied as the second argument:
+
+```ts
+const job = new Cron("*/5 * * * * *", () => {
+  // every fifth second
+});
+```
+
+Jobs schedule immediately unless `{ paused: true }` is supplied. Use `paused: true` when constructing a job for inspection or when you intend to start it explicitly.
+
+## Calculation and enumeration
+
+These methods calculate dates without waiting for timers:
+
+- `nextRun(startFromDate?)` returns a `Date`.
+- `nextRuns(count, startFromDate?)` returns scheduled `Date[]`.
+- `previousRuns(count, referenceDate?)` returns scheduled `Date[]`.
+- `previousRun()` returns the previous scheduled date.
+- `msToNext(startFromDate?)` returns milliseconds until the next execution.
+- `currentRun()` returns the current run information exposed by the job.
+
+```ts pmcp-example
+import { Cron } from "croner";
+import assert from "node:assert/strict";
+
+const job = new Cron("0 0 0 * * 7", { paused: true });
+const from = new Date("2025-01-01T00:00:00Z");
+const runs = job.nextRuns(2, from);
+
+assert.equal(runs.length, 2);
+assert.ok(runs[0] instanceof Date);
+assert.ok(runs[1] > runs[0]);
+assert.ok(job.nextRun(from) instanceof Date);
+assert.ok(job.msToNext(from) >= 0);
+assert.equal(job.previousRuns(1, from).length, 1);
+```
+
+## Matching dates
+
+`match(date)` checks whether a `Date` or date string satisfies the pattern. This was added in 10.0.0.
+
+```ts pmcp-example
+import { Cron } from "croner";
+import assert from "node:assert/strict";
+
+const monday = new Cron("0 0 0 * * MON", { paused: true });
+assert.equal(monday.match("2024-01-01T00:00:00"), true);
+assert.equal(monday.match("2024-01-02T00:00:00"), false);
+assert.equal(monday.match(new Date("2024-01-01T00:00:00")), true);
+```
+
+## One-shot dates and time zones
+
+An ISO local time can be interpreted in a specified IANA time zone:
+
+```ts
+const job = new Cron("2024-01-23T00:00:00", {
+  timezone: "Asia/Kolkata",
+  paused: true,
+});
+```
+
+The `timezone` option supports names such as `Europe/Stockholm`. `getOnce()` returns the original one-shot value as a `Date`, represented in the runtime’s date format; compare its timestamp or ISO representation rather than comparing it with the original string.
+
+```ts pmcp-example
+import { Cron } from "croner";
+import assert from "node:assert/strict";
+
+const job = new Cron("2030-01-23T00:00:00", {
+  timezone: "Asia/Kolkata",
+  paused: true,
+});
+
+assert.ok(job.getOnce() instanceof Date);
+assert.equal(job.getOnce()?.toISOString(), "2030-01-22T18:30:00.000Z");
+assert.ok(job.nextRun() instanceof Date);
+```
+
+## Triggering and controlling a job
+
+The control methods are `trigger()`, `pause()`, `resume()`, and `stop()`. Status methods include `isRunning()`, `isStopped()`, and `isBusy()`.
+
+`stop()` is permanent: a stopped job cannot be resumed. It also removes a named job from the exported `scheduledJobs` array. The documented import examples show `Cron`; do not assume the named-jobs array is available from the same documented import shape without checking the installed package.
+
+```ts pmcp-example
+import { Cron } from "croner";
+import assert from "node:assert/strict";
+
+let calls = 0;
+const job = new Cron("* * * * * *", { paused: true }, () => {
+  calls += 1;
+});
+
+assert.equal(job.isRunning(), false);
+assert.equal(job.isStopped(), false);
+assert.equal(job.isBusy(), false);
+assert.equal(job.getPattern(), "* * * * * *");
+assert.equal(job.getOnce(), null);
+
+job.trigger();
+assert.equal(calls, 1);
+job.pause();
+job.resume();
+job.stop();
+assert.equal(job.isStopped(), true);
+```
+
+The callback-based scheduling API requires the host runtime to remain alive for timer execution. `unref` is documented for Node.js and Deno, not browsers.
+
+## 10.x syntax and options
+
+10.x adds an optional seventh year field, `W` for nearest weekday, and `+` for explicit day-of-month AND day-of-week logic. Examples include:
+
+```ts
+new Cron("0 12 * * * * 2025", { paused: true });
+new Cron("0 12 15W * *", { paused: true });
+new Cron("0 12 15 * +FRI", { paused: true });
+```
+
+`?` is now a wildcard alias for `*`; it no longer has the older behavior of replacing fields with current-time values.
+
+Use `domAndDow` rather than deprecated `legacyMode`: `domAndDow: false` is OR logic (the default), while `domAndDow: true` is AND logic.
+
+Strict stepping is now the default. Forms such as `*/10`, `0-59/10`, and `30-50/10` are valid; legacy forms `/10`, `0/10`, and `30/30` require `{ sloppyRanges: true }`.
+
+Other documented 10.x options include `dayOffset`, `mode`, and `alternativeWeekdays`. `mode` can be `"auto"`, `"5-part"`, `"6-part"`, `"7-part"`, `"5-or-6-parts"`, or `"6-or-7-parts"`.
+
+## Migration traps
+
+Code copied from older majors commonly uses names that no longer exist:
+
+- `next()` became `nextRun()`.
+- `enumerate()` became `nextRuns()`.
+- `current()` became `currentRun()`.
+- `previous()` became `previousRun()`.
+- `running()` became `isRunning()`.
+- `busy()` became `isBusy()`.
+
+Also account for the v9 removal of the default export and optional `new`.
+
+## Not covered
+
+This skill does not cover undocumented exports such as the exact shape or import path of `scheduledJobs`, callback argument/context details, browser bundler configuration, or behavior requiring a long-lived timer run. It also does not cover package-specific CLI or runner usage because the research documents none.

package/plugins/css-tree-3/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "css-tree-3",
+  "version": "3.0.0",
+  "description": "Use css-tree 3.x to parse, traverse, transform, generate, and lex CSS ASTs. Covers the v3 AST/API changes that commonly break v2-era code.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

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

@@ -0,0 +1 @@
+{ "name": "css-tree-3", "version": "3.0.0" }

package/plugins/css-tree-3/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "css-tree-3",
+  "version": "3.0.0",
+  "description": "Use css-tree 3.x to parse, traverse, transform, generate, and lex CSS ASTs. Covers the v3 AST/API changes that commonly break v2-era code.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}