@modootoday/pmcp 0.13.0 → 0.14.0

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

@@ -0,0 +1 @@
+{ "name": "clickhouse-client-1", "version": "1.0.0" }

package/plugins/clickhouse-client-1/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "clickhouse-client-1",
+  "version": "1.0.0",
+  "description": "Insert and query typed values with parameters, streams and explicit client cleanup.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/clickhouse-client-1/skills/clickhouse-client/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: clickhouse-client
+description: Use @clickhouse/client 1 in Node.js to insert rows, bind typed parameters, preserve large integers, consume results and close clients. Use for SDK-based ClickHouse work while respecting the project's authenticated connection factory and isolated test database policy.
+---
+
+# ClickHouse JavaScript Node client 1
+
+Inspect installed SDK/server versions, the connection factory, schema and formats first. This line targets `@clickhouse/client@1.23.1`. Reuse the application's credential lifecycle; do not add raw HTTP queries or production credentials.
+
+## Query with parameters
+
+Create a client through the existing factory or `createClient` with explicitly selected URL, credentials and database. A Node client owns HTTP pooling; close it when its owning process finishes.
+
+`keep_alive.enabled` is shared with the web SDK. Node additionally supports socket settings such as `keep_alive.idle_socket_ttl`, custom `http_agent` and TLS certificate buffers. Preserve the runtime-specific connection factory when sharing query code.
+
+```ts
+import { randomUUID } from "node:crypto";
+import { createClient } from "@clickhouse/client";
+
+type Row = { id: string; label: string };
+
+export async function findRows(
+  client: ReturnType<typeof createClient>,
+  label: string,
+) {
+  const result = await client.query({
+    query: "SELECT id, label FROM rows WHERE label = {label:String}",
+    query_params: { label },
+    format: "JSONEachRow",
+    query_id: randomUUID(),
+  });
+  return await result.json<Row>();
+}
+```
+
+Use ClickHouse typed placeholders such as `{label:String}` and `{id:UInt64}`. Do not interpolate values or copy `$1`/`?` conventions. `json<Row>()` supplies static types, not runtime validation.
+
+## Insert and release
+
+Use `client.insert({ table, values, format: "JSONEachRow" })` for arrays or documented Node readable streams. Use `command` for DDL and `query` for results. Preserve project table naming and insert settings.
+
+UInt64/Int64 JSON results are strings by default. Keep values beyond JavaScript's safe integer range as strings or explicit bigint; avoid `Number(value)` and disabling quoted large integers. Precision-sensitive decimals need an explicit representation such as a `toString` expression and application validation.
+
+Consume a result once via `json`, `text` or its stream. Node streams emit chunks of row wrappers; decode each with `row.json()`. Fully consume or close abandoned results, then close the owning client. A caller timeout is not proof the server operation stopped; query IDs support tracing and operational follow-up.
+
+Use bounded `request_timeout` and server-side limits. Log query identity without credentials or sensitive parameters. SDK errors must remain visible rather than becoming fabricated empty results.
+
+The fixture uses an explicit isolated loopback endpoint and unique temporary database through the SDK. It targets inserts, literal-safe parameters, UInt64 strings, Node streams, failure propagation and the companion web client, then drops only its database. It does not establish browser CORS, Worker deployment, TLS, failover, streaming inserts or server cancellation.
+
+## Primary sources and upstream skill reuse
+
+- [Official JS client documentation](https://clickhouse.com/docs/integrations/language-clients/js/index)
+- [Official Node troubleshooting skill](https://github.com/ClickHouse/clickhouse-js/tree/2c9823bb27b428015cfb982d406381f2523429e7/skills/clickhouse-js-node-troubleshooting), Apache-2.0 licensed. Consult it for deeper Node troubleshooting; it excludes browser and Worker runtimes. These instructions are original text rather than copied upstream prose.
+- [Upstream](https://github.com/ClickHouse/clickhouse-js)

package/plugins/clickhouse-client-web-1/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "clickhouse-client-web-1",
+  "version": "1.0.0",
+  "description": "Consume Fetch streams and preserve numeric precision within the web client API.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/clickhouse-client-web-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/clickhouse-client-web-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/clickhouse-client-web-1/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "clickhouse-client-web-1", "version": "1.0.0" }

package/plugins/clickhouse-client-web-1/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "clickhouse-client-web-1",
+  "version": "1.0.0",
+  "description": "Consume Fetch streams and preserve numeric precision within the web client API.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/clickhouse-client-web-1/skills/clickhouse-client-web/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: clickhouse-client-web
+description: Use @clickhouse/client-web 1 in Fetch/Web Streams environments to insert arrays, bind typed parameters and consume query results. Use when porting Node ClickHouse code without copying Node streams, HTTP agents or privileged credentials into the browser boundary.
+---
+
+# ClickHouse JavaScript web client 1
+
+Inspect the installed client, runtime, credential boundary and connection factory first. This line targets `@clickhouse/client-web@1.23.1`. Node Fetch availability does not prove browser CORS or Worker deployment.
+
+## Use the web contract
+
+Import from `@clickhouse/client-web`. Parameter and JSON format conventions match the Node SDK; transport options and stream types do not.
+
+```ts
+import { createClient } from "@clickhouse/client-web";
+
+type Row = { id: string; label: string };
+
+export async function findRows(
+  client: ReturnType<typeof createClient>,
+  label: string,
+) {
+  const result = await client.query({
+    query: "SELECT id, label FROM rows WHERE label = {label:String}",
+    query_params: { label },
+    format: "JSONEachRow",
+  });
+  return await result.json<Row>();
+}
+```
+
+Use arrays for `insert({ table, values, format: "JSONEachRow" })`. The web client does not accept Node or Web readable insert streams. `keep_alive.enabled` is a shared option; Node socket settings such as `keep_alive.idle_socket_ttl`, custom `http_agent` and TLS certificate buffers are outside the web configuration contract.
+
+## Consume Web Streams
+
+`result.stream()` returns a WHATWG `ReadableStream` of chunks of row wrappers. Read with `getReader()` and decode each row with `row.json()`. Fully consume and release the reader lock in `finally`; when stopping early, cancel before releasing the lock. Do not consume a result again through `json` or `text`.
+
+Preserve UInt64/Int64 string values. `json<Row>()` does not validate runtime data. Bound query results rather than buffering unbounded output into an array.
+
+## Keep credentials at the runtime boundary
+
+A server-side edge worker can use platform secrets. Browser-delivered code cannot keep a database password secret; use an authenticated server endpoint or an explicitly authorized public-data service. Do not embed privileged credentials in frontend environment substitutions. Browser access also needs intentional CORS; the SDK does not bypass it.
+
+Use the SDK for data operations and preserve the project's authentication factory. Close clients at their owning lifecycle boundary and route SDK failures through the application error policy.
+
+The fixture runs this SDK under Node Fetch/Web Streams against an isolated database. It targets array inserts, parameterized JSON queries and stream consumption. Its consumer typecheck accepts shared `keep_alive.enabled` and rejects Node socket idle TTL and Node readable insert values. It does not run a browser, CORS policy, Worker binding, TLS configuration or streaming insert.
+
+## Primary sources and provenance
+
+- [Official JS client documentation](https://clickhouse.com/docs/integrations/language-clients/js/index)
+- [Web client upstream](https://github.com/ClickHouse/clickhouse-js/tree/main/packages/client-web)
+- [Official Node troubleshooting skill](https://github.com/ClickHouse/clickhouse-js/tree/2c9823bb27b428015cfb982d406381f2523429e7/skills/clickhouse-js-node-troubleshooting), Apache-2.0 licensed. Its Node-only scope is a boundary reference rather than web evidence. These web instructions are original text.

package/plugins/cliui-9/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "cliui-9",
+  "version": "9.0.0",
+  "description": "Use cliui ^9.0.0 to build terminal UI strings with rows, columns, wrapping, padding, alignment, borders, and the single-string layout DSL.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/cliui-9/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/cliui-9/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/cliui-9/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "cliui-9", "version": "9.0.0" }

package/plugins/cliui-9/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "cliui-9",
+  "version": "9.0.0",
+  "description": "Use cliui ^9.0.0 to build terminal UI strings with rows, columns, wrapping, padding, alignment, borders, and the single-string layout DSL.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}