@modootoday/pmcp 0.13.1 → 0.14.0

package/plugins/get-uri-8/skills/get-uri/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: get-uri
+description: Use get-uri 8.x to obtain readable streams from data, file, FTP, HTTP, and HTTPS URIs, or to validate supported protocols.
+---
+
+Verified against get-uri@8.0.1 on 2026-09-08. 4 of 4 examples executed.
+
+# get-uri 8.x
+
+## Runtime and module shape
+
+- Requires Node.js 20 or newer.
+- The package is ESM. Import named exports from `get-uri`:
+
+```ts
+import { getUri, isValidProtocol, protocols } from 'get-uri';
+```
+
+- The main API is `getUri(uri, options?)`, returning a `Promise<Readable>`.
+- Accepted URI inputs are strings and `URL` objects.
+- Supported protocols are `data`, `file`, `ftp`, `http`, and `https`.
+
+## Get a readable stream
+
+Use `getUri` when the caller needs a stream rather than a buffered value. The following uses a `data:` URI, so it requires no network or filesystem access:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { getUri } from 'get-uri';
+
+const stream = await getUri('data:text/plain,hello');
+let result = '';
+
+for await (const chunk of stream) {
+  result += chunk.toString();
+}
+
+assert.equal(result, 'hello');
+```
+
+A `URL` object is also accepted:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { getUri } from 'get-uri';
+
+const stream = await getUri(new URL('data:text/plain,from-url'));
+let result = '';
+
+for await (const chunk of stream) {
+  result += chunk.toString();
+}
+
+assert.equal(result, 'from-url');
+```
+
+For `file:` URIs, the resolved stream is an `fs.ReadStream`. HTTP and HTTPS produce streams from those protocols; FTP is also supported. Those protocols require resources outside a standalone, offline example.
+
+## Protocol helpers
+
+`isValidProtocol` is a type guard for the supported protocol names:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { isValidProtocol } from 'get-uri';
+
+assert.equal(isValidProtocol('data'), true);
+assert.equal(isValidProtocol('file'), true);
+assert.equal(isValidProtocol('ftp'), true);
+assert.equal(isValidProtocol('http'), true);
+assert.equal(isValidProtocol('https'), true);
+assert.equal(isValidProtocol('gopher'), false);
+```
+
+The `protocols` export exposes the individual protocol handlers. A handler receives a parsed `URL` and optional protocol-specific options:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { protocols } from 'get-uri';
+
+const stream = await protocols.data(new URL('data:text/plain,direct'));
+let result = '';
+
+for await (const chunk of stream) {
+  result += chunk.toString();
+}
+
+assert.equal(result, 'direct');
+```
+
+The available handlers are `protocols.data`, `protocols.file`, `protocols.ftp`, `protocols.http`, and `protocols.https`.
+
+## Caching and errors
+
+Pass a previous readable stream as `cache` in the options when using a protocol that supports caching. If the destination has not changed, the operation rejects with an error whose `code` is `"ENOTMODIFIED"`.
+
+A missing resource rejects with an error whose `code` is `"ENOTFOUND"`.
+
+Other options are passed through to the underlying protocol implementation, such as `http.get()` or `ftp.connect()`.
+
+## Common version mistakes
+
+- Do not use the older CommonJS shape or assume `require()` is the documented usage. get-uri 8.x is an ESM package.
+- Do not target Node 14 or another pre-20 runtime. Version 8 raised the minimum Node.js version to 20.
+- Do not expect only HTTP and HTTPS: `data`, `file`, and `ftp` are built in as well.
+- Do not expect `getUri` to return the contents directly. Await it to obtain a `Readable` stream.
+- Do not pass an ordinary protocol string to a protocol handler: the `protocols.*` functions take a parsed `URL`; use `getUri` when starting with a URI string.
+- Do not assume an unchanged cached resource resolves normally; it rejects with `code === "ENOTMODIFIED"`.
+
+## Not covered
+
+This skill does not cover the protocol-specific option fields, HTTP authentication or headers, FTP connection configuration, filesystem behavior, stream error handling, or running the package through a CLI or test runner. The available research also does not specify the exact data-URI encoding forms beyond the standalone examples shown here.

package/plugins/google-uuid-1/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "google-uuid-1",
+  "version": "1.0.0",
+  "description": "Use the Go module github.com/google/uuid to parse UUID input, enforce canonical formatting when required, generate UUIDs with error handling and serialize identifiers. Use for application UUID boundaries; this manually loaded pilot has no npm target or automatic dependency detection.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/google-uuid-1/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/google-uuid-1/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/google-uuid-1/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "google-uuid-1", "version": "1.0.0" }

package/plugins/google-uuid-1/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "google-uuid-1",
+  "version": "1.0.0",
+  "description": "Use the Go module github.com/google/uuid to parse UUID input, enforce canonical formatting when required, generate UUIDs with error handling and serialize identifiers. Use for application UUID boundaries; this manually loaded pilot has no npm target or automatic dependency detection.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/google-uuid-1/skills/google-uuid/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: google-uuid
+description: Use the Go module github.com/google/uuid to parse UUID input, enforce canonical formatting when required, generate UUIDs with error handling and serialize identifiers. Use for application UUID boundaries; this manually loaded pilot has no npm target or automatic dependency detection.
+compatibility: "Go modules; github.com/google/uuid v1.6.0; manual loading."
+metadata:
+  ecosystem: go
+  target-identity: github.com/google/uuid
+  selected-version: "v1.6.0"
+  loading: manual
+---
+
+# Google UUID for Go
+
+Manual-loading pilot targeting `github.com/google/uuid v1.6.0`. Selected version metadata is not execution evidence. Inspect go.mod, replace directives and the installed toolchain first. A go.sum entry alone is not proof that a module version is selected in the build.
+
+## Parse application input
+
+Use `uuid.Parse` and handle its error. It accepts canonical UUIDs, URN forms, compact hex and some nonstandard forms. A successful parse alone is not a canonical-format policy.
+
+```go
+package identifiers
+
+import (
+    "fmt"
+
+    "github.com/google/uuid"
+)
+
+func ParseCanonical(value string) (uuid.UUID, error) {
+    identifier, err := uuid.Parse(value)
+    if err != nil {
+        return uuid.Nil, err
+    }
+    if identifier.String() != value {
+        return uuid.Nil, fmt.Errorf("UUID must use canonical lowercase formatting")
+    }
+    return identifier, nil
+}
+```
+
+This helper deliberately requires lowercase hyphenated formatting. If the application accepts other representations, normalize after parsing instead. `uuid.Validate` also accepts multiple formats; do not describe it as canonical-only validation.
+
+## Generate and serialize identifiers
+
+Use `uuid.NewRandom()` when the application needs to handle randomness errors explicitly. It returns a version 4 UUID; inspect `Version()` and `Variant()` when the contract depends on them. `uuid.New` and `MustParse` can panic and should not replace error handling for untrusted input.
+
+UUID values support text/JSON encoding. Test a JSON round-trip with the standard library's `encoding/json`, and handle serialization errors. Formatting or parsing an identifier does not authorize access to the resource it names. A UUID is an identifier, not a secret credential.
+
+Preserve the project's module graph. In a fixture, pin the observed module version and checksum, use an isolated cache and selected toolchain, then execute a bounded native program or test. Do not download a compiler or change the global Go environment implicitly during verification.
+
+The fixture targets canonical parse/version, malformed input, the difference between permissive parsing and canonical policy, version 4 generation/variant and JSON round-trip. It records the selected dependency from Go build information. It does not establish UUID uniqueness statistically, concurrency behavior, database adapters or the security of application authorization.
+
+## Load manually
+
+Copy this file into a chosen collection at `manual-library-skills/skills/google-uuid/SKILL.md`. Explicitly load it or merge that collection into PMCP's existing configuration:
+
+```toml
+[catalog]
+packages = ["./manual-library-skills"]
+```
+
+Local discovery requires no login. This route does not inspect Go modules or use `pmcp available/install` automatic matching. The collection folder is not a Go or npm registry target. Leave folder trust to the native runtime.
+
+## Primary sources and provenance
+
+- [Pinned parsing and validation implementation](https://github.com/google/uuid/blob/v1.6.0/uuid.go)
+- [Pinned version 4 generation](https://github.com/google/uuid/blob/v1.6.0/version4.go)
+- [Pinned BSD-3-Clause license](https://github.com/google/uuid/blob/v1.6.0/LICENSE)
+
+These instructions are original public-library guidance, with source links rather than copied upstream prose.

package/plugins/graphql-16/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "graphql-16",
+  "version": "16.0.0",
+  "description": "Validate and execute typed schemas with variables and explicit error handling.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/graphql-16/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/graphql-16/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/graphql-16/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "graphql-16", "version": "16.0.0" }

package/plugins/graphql-16/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "graphql-16",
+  "version": "16.0.0",
+  "description": "Validate and execute typed schemas with variables and explicit error handling.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/graphql-16/skills/graphql/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: graphql
+description: Use graphql 16 to validate schemas, execute operations with variables and request context, and distinguish document validation from resolver execution. Use for GraphQL.js services and Yoga/Pothos interoperability without adopting GraphQL 17 APIs.
+---
+
+# GraphQL.js 16
+
+Inspect the installed version, schema construction, server adapter and test commands first. Preserve the project's package manager, module mode and validation policy. This line targets `graphql@16.13.1`; it does not establish compatibility with GraphQL 17.
+
+## Validate and execute
+
+Call `validateSchema(schema)` before exposing a newly constructed schema. Checking only that a query type exists misses invalid names and other schema errors.
+
+`graphql({ schema, source, variableValues, contextValue })` parses, validates and executes. Await its result so asynchronous resolvers are supported. `graphqlSync` is suitable only when execution is synchronous.
+
+```ts
+import assert from "node:assert/strict";
+import { buildSchema, graphql, validateSchema } from "graphql";
+
+const schema = buildSchema("type Query { greeting(name: String!): String! }");
+assert.deepEqual(validateSchema(schema), []);
+const result = await graphql({
+  schema,
+  source: "query Greeting($name: String!) { greeting(name: $name) }",
+  variableValues: { name: "Ada" },
+  rootValue: { greeting: ({ name }: { name: string }) => `Hello ${name}` },
+});
+assert.equal(result.errors, undefined);
+assert.equal(result.data?.greeting, "Hello Ada");
+```
+
+For pre-parsed documents, use `parse(source)`, then `validate(schema, document)`, and call `execute` only after the validation errors are empty. `execute` does not replace document validation. A cached document's validation depends on the schema and validation rules as well as the document.
+
+Pass request identity and dependencies through `contextValue`; do not store request state in global resolver objects.
+
+## Test the failure boundary
+
+- A numeric value for a `String!` variable must produce an error before operation execution. Verify `errors` and absent `data` for variable coercion failure.
+- An unknown field must fail document validation. Do not call `execute` on that invalid document.
+- Resolver failures can return partial `data` with `errors`. Non-null propagation can make a parent field or all data null; inspect both fields.
+- GraphQL.js does not choose HTTP status or mask sensitive resolver details. Test those through the actual server adapter.
+
+Execution result objects may have a null prototype. Assert relevant fields or normalize through an actual JSON serialization boundary rather than assuming deep equality with an ordinary object literal.
+
+## Integrate without another schema
+
+Pothos `builder.toSchema()` produces a standard `GraphQLSchema`. Validate it, then pass that same schema to GraphQL.js or Yoga `createYoga({ schema })`. Inspect peer dependency ranges before changing the GraphQL major.
+
+The companion fixture targets schema validation, invalid variables/documents, typed Pothos resolvers, execution, request context and Yoga masking. Its HTTP requests are in process; it does not test a listener, deployment or WebSocket. Record successful execution separately from the selected version target.
+
+## Primary sources
+
+- [GraphQL.js 16 API](https://www.graphql-js.org/api-v16/graphql/)
+- [Execution API](https://www.graphql-js.org/api-v16/execution/)
+- [Pothos schema builder](https://pothos-graphql.dev/docs/guide/schema-builder)
+- [Yoga context](https://the-guild.dev/graphql/yoga-server/docs/features/context)

package/plugins/graphql-17/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "graphql-17",
+  "version": "17.0.1",
+  "description": "Practical guidance for graphql ^17.0.0: parse, print, visit, build schemas, and execute operations from standalone scripts.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}