@modootoday/pmcp 0.13.1 → 0.14.0

package/plugins/wrap-ansi-10/skills/wrap-ansi/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: wrap-ansi
+description: Use wrap-ansi v10 to wrap plain or ANSI-styled strings by terminal column width.
+---
+
+Verified against wrap-ansi@10.0.1 on 2026-09-08. 6 of 6 examples executed.
+
+# wrap-ansi
+
+`wrap-ansi` v10 is a small ESM package with one runtime export: the default `wrapAnsi` function. It requires Node.js 20 or newer.
+
+```ts
+import wrapAnsi from 'wrap-ansi';
+
+wrapAnsi(string: string, columns: number, options?: {
+  readonly hard?: boolean;
+  readonly wordWrap?: boolean;
+  readonly trim?: boolean;
+}): string;
+```
+
+The package is directly callable from a plain ESM script. It has no CLI or runner API. Use a default import:
+
+```ts
+import wrapAnsi from 'wrap-ansi';
+```
+
+Do not use the older CommonJS-style `require()` shape, and do not expect named runtime exports.
+
+## Basic word wrapping
+
+By default, `wordWrap` is enabled, `hard` is disabled, and surrounding whitespace is trimmed. Words are kept together when possible, so a long word may exceed the requested width unless hard wrapping is enabled.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import wrapAnsi from 'wrap-ansi';
+
+const result = wrapAnsi('one two three four', 10);
+
+assert.equal(result, 'one two\nthree four');
+```
+
+## Hard wrapping long words
+
+Set `hard: true` to prevent long words from extending past the column width.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import wrapAnsi from 'wrap-ansi';
+
+const result = wrapAnsi('Averylongword', 5, {hard: true});
+
+assert.equal(result, 'Avery\nlongw\nord');
+```
+
+In v10, hard wrapping is subject to `wordWrap !== false`. If both options are supplied, disabling word wrapping changes the behavior; do not assume the v9 condition where `hard: true` always controlled splitting.
+
+## Disabling word wrapping
+
+Set `wordWrap: false` when the content should be filled to the column width and split without preserving word boundaries.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import wrapAnsi from 'wrap-ansi';
+
+const result = wrapAnsi('abcdef', 3, {wordWrap: false});
+
+assert.equal(result, 'abc\ndef');
+```
+
+## Whitespace trimming
+
+`trim` defaults to `true`. Set `trim: false` to preserve whitespace on all lines.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import wrapAnsi from 'wrap-ansi';
+
+assert.equal(wrapAnsi('  hi  ', 10), 'hi');
+assert.equal(wrapAnsi('  hi  ', 10, {trim: false}), '  hi  ');
+```
+
+## Newlines and tabs
+
+Newlines are normalized to `\n`. Tabs are expanded before wrapping, using 8-column tab stops. Account for the expanded spaces when choosing `columns`.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import wrapAnsi from 'wrap-ansi';
+
+assert.equal(wrapAnsi('first\r\nsecond', 20), 'first\nsecond');
+assert.equal(wrapAnsi('a\tb', 9), 'a       b');
+```
+
+## ANSI-styled strings
+
+The function measures visible terminal width rather than counting ANSI escape sequences as printable columns. It preserves the escape sequences in the result.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import wrapAnsi from 'wrap-ansi';
+
+const red = '\u001B[31mred\u001B[39m';
+
+assert.equal(wrapAnsi(red, 3), red);
+```
+
+Version 10 tracks ANSI style families, including foreground, background, underline color, and modifier closing codes. It also recognizes CSI escapes and OSC-8 hyperlinks terminated by BEL or `ESC \\`.
+
+## Version and compatibility notes
+
+- v10 requires Node.js `>=20`; v9 required Node.js `>=18`.
+- v10 uses `Intl.Segmenter` grapheme segmentation. Do not copy assumptions from older implementations that treated every JavaScript code point as a complete display unit.
+- The v9 API is deceptively similar: it also uses an ESM default export and the same three option names. Code copied from v9 may miss v10's tab expansion and its changed interaction between `hard` and `wordWrap`.
+- The package is not a command-line tool. A plain script can call the default function directly; there is no package command that needs to be launched for these examples.
+
+## Not covered
+
+This skill does not specify every edge case in terminal-width calculation, all ANSI control-sequence forms, hyperlink rendering behavior, invalid column values, or integration with Chalk or another color library. It also does not cover CommonJS interoperability, because v10's documented/exported surface is ESM.

package/plugins/yaml-2/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "yaml-2",
+  "version": "2.0.0",
+  "description": "Parse and update YAML configuration with diagnostics and bounded aliases.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/yaml-2/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/yaml-2/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/yaml-2/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "yaml-2", "version": "2.0.0" }

package/plugins/yaml-2/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "yaml-2",
+  "version": "2.0.0",
+  "description": "Parse and update YAML configuration with diagnostics and bounded aliases.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

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

@@ -0,0 +1,56 @@
+---
+name: yaml
+description: Parse, diagnose and edit YAML configuration with yaml 2, preserving document comments when needed and controlling duplicate keys, schemas and alias expansion. Use the Document API for roundtrip edits rather than reconstructing commented files from plain objects.
+---
+
+# yaml 2 configuration workflows
+
+Inspect the installed version, selected YAML schema and the configuration owner's
+validation rules. The fixture targets yaml 2.9.0. The parser does not replace the
+application's schema validation.
+
+## Parse and report diagnostics
+
+parse converts to plain values and throws on parse errors. parseDocument provides
+the document tree and errors/warnings for a diagnostic workflow. Check errors
+before consuming or writing that document; a returned object is not evidence of
+a valid configuration.
+
+```js
+import { parseDocument } from "yaml";
+
+export function updatePort(source, port) {
+  const document = parseDocument(source);
+  if (document.errors.length) throw document.errors[0];
+  document.setIn(["service", "port"], port);
+  return document.toString();
+}
+```
+
+The Document API retains comments and structure where supported. Plain
+parse→stringify regenerates representation and should not be used to promise
+comment-preserving edits. Review the written diff when formatting or anchors
+matter to the owner.
+
+## Choose schema and conversion boundaries
+
+YAML 1.2 is the default. YAML 1.1 has different scalar interpretation, so select
+it only when the consumer requires it. Quote ambiguous scalar strings when their
+intended type should be explicit.
+
+Duplicate keys are errors by default. Do not disable that check to accept an
+ambiguous configuration silently. Alias conversion is controlled by
+maxAliasCount; zero disallows alias expansion, while a negative value disables
+the limit. Keep the caller's intended bounded policy for untrusted inputs.
+
+Validate the resulting plain object before applying it. Avoid merging user data
+into global configuration with an unrestricted recursive merge merely because
+the YAML syntax parsed. Custom schemas and tags need their own conversion tests.
+
+The fixture verifies a commented document update, duplicate-key diagnostics and
+alias-conversion limits. It does not validate arbitrary application schemas.
+
+## Sources
+
+- [yaml Document API, parsing options and diagnostics](https://eemeli.org/yaml/)
+- [yaml source and package releases](https://github.com/eemeli/yaml)

package/plugins/yargs-18/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "yargs-18",
+  "version": "18.0.0",
+  "description": "Use yargs ^18.0.0 as a factory-based argument parser in supported Node runtimes.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/yargs-18/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/yargs-18/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/yargs-18/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "yargs-18", "version": "18.0.0" }

package/plugins/yargs-18/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "yargs-18",
+  "version": "18.0.0",
+  "description": "Use yargs ^18.0.0 as a factory-based argument parser in supported Node runtimes.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}