@mvanhorn/printing-press-library 0.1.6

package/dist/src/registry.d.ts

@@ -0,0 +1,44 @@
+export declare const DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/mvanhorn/printing-press-library/main/registry.json";
+export interface MCPBlock {
+    binary: string;
+    transports: string[];
+    tool_count: number;
+    public_tool_count?: number;
+    auth_type: string;
+    env_vars: string[];
+    mcp_ready?: string;
+}
+export interface RegistryEntry {
+    name: string;
+    category: string;
+    api: string;
+    description: string;
+    path: string;
+    mcp?: MCPBlock;
+}
+export interface Registry {
+    schema_version: number;
+    entries: RegistryEntry[];
+}
+type RegistryFetch = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Parse a raw registry payload into a typed Registry.
+ *
+ * Per-entry validation errors are surfaced as warnings to `warn` (defaulting to
+ * stderr) and the offending entry is skipped. The remainder of the registry is
+ * returned intact. This is the defense-in-depth that paired with the library-side
+ * `--validate` gate keeps a single malformed upstream entry from breaking every
+ * installer call (the original lawhub failure mode).
+ *
+ * Registry-level shape failures (non-object payload, unsupported schema_version,
+ * non-array entries) still throw because they signal a wrong-protocol payload
+ * the installer cannot recover from.
+ */
+export declare function parseRegistry(value: unknown, warn?: (message: string) => void): Registry;
+export declare function fetchRegistry(url?: string, fetchImpl?: RegistryFetch): Promise<Registry>;
+export declare function fetchGoModulePath(entryPath: string, registryUrl?: string, fetchImpl?: RegistryFetch): Promise<string | null>;
+export declare function lookupByName(registry: Registry, name: string): RegistryEntry | null;
+export declare function cliSkillName(entry: RegistryEntry): string;
+export declare function cliBinaryName(entry: RegistryEntry): string;
+export declare function parseGoModulePath(goMod: string): string | null;
+export {};

package/dist/src/registry.js

@@ -0,0 +1,194 @@
+export const DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/mvanhorn/printing-press-library/main/registry.json";
+/**
+ * Parse a raw registry payload into a typed Registry.
+ *
+ * Per-entry validation errors are surfaced as warnings to `warn` (defaulting to
+ * stderr) and the offending entry is skipped. The remainder of the registry is
+ * returned intact. This is the defense-in-depth that paired with the library-side
+ * `--validate` gate keeps a single malformed upstream entry from breaking every
+ * installer call (the original lawhub failure mode).
+ *
+ * Registry-level shape failures (non-object payload, unsupported schema_version,
+ * non-array entries) still throw because they signal a wrong-protocol payload
+ * the installer cannot recover from.
+ */
+export function parseRegistry(value, warn = defaultWarn) {
+    if (!isRecord(value)) {
+        throw new Error("registry payload must be an object");
+    }
+    if (value.schema_version !== 2) {
+        throw new Error(`unsupported registry schema_version: ${String(value.schema_version)}`);
+    }
+    if (!Array.isArray(value.entries)) {
+        throw new Error("registry entries must be an array");
+    }
+    const entries = [];
+    let skipped = 0;
+    for (let i = 0; i < value.entries.length; i++) {
+        const raw = value.entries[i];
+        try {
+            entries.push(parseRegistryEntry(raw));
+        }
+        catch (error) {
+            const name = isRecord(raw) && typeof raw.name === "string" && raw.name.trim() !== ""
+                ? raw.name
+                : `(unnamed at index ${i})`;
+            const message = error instanceof Error ? error.message : String(error);
+            warn(`[printing-press-library] skipping malformed registry entry: ${name}: ${message}`);
+            skipped++;
+        }
+    }
+    if (skipped > 0) {
+        const word = skipped === 1 ? "entry" : "entries";
+        warn(`[printing-press-library] skipped ${skipped} malformed registry ${word}; install/search may be missing items.`);
+    }
+    return {
+        schema_version: 2,
+        entries,
+    };
+}
+function defaultWarn(message) {
+    process.stderr.write(message + "\n");
+}
+export async function fetchRegistry(url = DEFAULT_REGISTRY_URL, fetchImpl = fetch) {
+    const response = await fetchImpl(url, githubRequestInit(url));
+    if (!response.ok) {
+        const authHint = response.status === 404 || response.status === 401
+            ? " If the catalog repository is private, set GITHUB_TOKEN or GH_TOKEN."
+            : "";
+        throw new Error(`failed to fetch registry: HTTP ${response.status}.${authHint}`);
+    }
+    return parseRegistry(await response.json());
+}
+export async function fetchGoModulePath(entryPath, registryUrl = DEFAULT_REGISTRY_URL, fetchImpl = fetch) {
+    const goModUrl = goModUrlForRegistryEntry(registryUrl, entryPath);
+    if (!goModUrl) {
+        return null;
+    }
+    const response = await fetchImpl(goModUrl, githubRequestInit(goModUrl));
+    if (!response.ok) {
+        return null;
+    }
+    const goMod = await response.text();
+    return parseGoModulePath(goMod);
+}
+export function lookupByName(registry, name) {
+    const normalized = normalizeName(name);
+    return (registry.entries.find((entry) => {
+        const entryName = normalizeName(entry.name);
+        return entryName === normalized || normalizeName(entry.api) === normalized;
+    }) ?? null);
+}
+export function cliSkillName(entry) {
+    return `pp-${entry.name.replace(/-pp-cli$/, "")}`;
+}
+export function cliBinaryName(entry) {
+    return entry.name.endsWith("-pp-cli") ? entry.name : `${entry.name}-pp-cli`;
+}
+function parseRegistryEntry(value) {
+    if (!isRecord(value)) {
+        throw new Error("registry entry must be an object");
+    }
+    const entry = {
+        name: requiredString(value, "name"),
+        category: requiredString(value, "category"),
+        api: requiredString(value, "api"),
+        description: requiredString(value, "description"),
+        path: requiredString(value, "path"),
+    };
+    return isRecord(value.mcp)
+        ? {
+            ...entry,
+            mcp: {
+                binary: requiredString(value.mcp, "binary"),
+                transports: requiredStringArray(value.mcp, "transports"),
+                tool_count: requiredNumber(value.mcp, "tool_count"),
+                public_tool_count: typeof value.mcp.public_tool_count === "number" ? value.mcp.public_tool_count : undefined,
+                auth_type: requiredString(value.mcp, "auth_type"),
+                env_vars: Array.isArray(value.mcp.env_vars) ? value.mcp.env_vars.map(String) : [],
+                mcp_ready: typeof value.mcp.mcp_ready === "string" ? value.mcp.mcp_ready : undefined,
+            },
+        }
+        : entry;
+}
+function normalizeName(value) {
+    return value.toLowerCase().replace(/^pp-/, "").replace(/-pp-cli$/, "").replace(/[^a-z0-9]+/g, "-");
+}
+function requiredString(value, key) {
+    if (typeof value[key] !== "string" || value[key].trim() === "") {
+        throw new Error(`registry entry missing string field: ${key}`);
+    }
+    return value[key];
+}
+function requiredNumber(value, key) {
+    if (typeof value[key] !== "number") {
+        throw new Error(`registry entry missing number field: ${key}`);
+    }
+    return value[key];
+}
+function requiredStringArray(value, key) {
+    const raw = value[key];
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw new Error(`registry entry missing non-empty string array field: ${key}`);
+    }
+    const out = [];
+    for (const item of raw) {
+        if (typeof item !== "string" || item.trim() === "") {
+            throw new Error(`registry entry has non-string value in array field: ${key}`);
+        }
+        out.push(item);
+    }
+    return out;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function parseGoModulePath(goMod) {
+    for (const line of goMod.split(/\r?\n/)) {
+        const match = line.match(/^module\s+(\S+)/);
+        if (match) {
+            return match[1];
+        }
+    }
+    return null;
+}
+function goModUrlForRegistryEntry(registryUrl, entryPath) {
+    let parsed;
+    try {
+        parsed = new URL(registryUrl);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.hostname !== "raw.githubusercontent.com") {
+        return null;
+    }
+    const parts = parsed.pathname.split("/").filter(Boolean);
+    if (parts.length < 4 || parts.at(-1) !== "registry.json") {
+        return null;
+    }
+    parsed.pathname = `/${parts.slice(0, -1).join("/")}/${entryPath}/go.mod`;
+    return parsed.toString();
+}
+function githubRequestInit(url) {
+    const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+    if (!token || !isTrustedGitHubUrl(url)) {
+        return undefined;
+    }
+    return {
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "X-GitHub-Api-Version": "2022-11-28",
+        },
+    };
+}
+function isTrustedGitHubUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.hostname === "raw.githubusercontent.com" || parsed.hostname === "api.github.com";
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/src/skill.d.ts

@@ -0,0 +1,10 @@
+import { type Runner } from "./process.js";
+export interface InstallSkillOptions {
+    agents?: string[];
+    runner?: Runner;
+}
+export declare function skillSource(skillName: string): string;
+export declare function skillsAddArgs(skillName: string, options?: InstallSkillOptions): string[];
+export declare function installSkill(skillName: string, options?: InstallSkillOptions): Promise<import("./process.js").RunResult>;
+export declare function skillsRemoveArgs(skillName: string, options?: InstallSkillOptions): string[];
+export declare function removeSkill(skillName: string, options?: InstallSkillOptions): Promise<import("./process.js").RunResult>;

package/dist/src/skill.js

@@ -0,0 +1,28 @@
+import { execFileRunner } from "./process.js";
+const LIBRARY_SOURCE = "mvanhorn/printing-press-library";
+export function skillSource(skillName) {
+    return `${LIBRARY_SOURCE}/cli-skills/${skillName}`;
+}
+export function skillsAddArgs(skillName, options = {}) {
+    const args = ["-y", "skills@latest", "add", skillSource(skillName), "-g", "-y"];
+    for (const agent of options.agents ?? []) {
+        args.push("-a", agent);
+    }
+    return args;
+}
+export async function installSkill(skillName, options = {}) {
+    const runner = options.runner ?? execFileRunner;
+    return runner("npx", skillsAddArgs(skillName, options));
+}
+export function skillsRemoveArgs(skillName, options = {}) {
+    const args = ["-y", "skills@latest", "remove", skillName, "-g", "-y"];
+    for (const agent of options.agents ?? []) {
+        args.push("-a", agent);
+    }
+    return args;
+}
+export async function removeSkill(skillName, options = {}) {
+    const runner = options.runner ?? execFileRunner;
+    return runner("npx", skillsRemoveArgs(skillName, options));
+}
+//# sourceMappingURL=skill.js.map

package/dist/src/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,cAAc,CAAC;AAE3D,MAAM,cAAc,GAAG,iCAAiC,CAAC;AAOzD,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,GAAG,cAAc,eAAe,SAAS,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,UAA+B,EAAE;IAChF,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChF,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,UAA+B,EAAE;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,OAAO,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,UAA+B,EAAE;IACnF,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtE,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB,EAAE,UAA+B,EAAE;IACpF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,OAAO,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@mvanhorn/printing-press-library",
+  "version": "0.1.6",
+  "description": "Installer and catalog CLI for Printing Press-generated CLIs.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Matt Van Horn <mvanhorn@gmail.com>",
+  "contributors": [
+    "Trevin Chow <trevin@trevinchow.com>"
+  ],
+  "homepage": "https://printingpress.dev",
+  "bugs": {
+    "url": "https://github.com/mvanhorn/printing-press-library/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mvanhorn/printing-press-library.git",
+    "directory": "npm"
+  },
+  "keywords": [
+    "cli",
+    "claude",
+    "agent",
+    "go",
+    "openapi",
+    "skills",
+    "printing-press",
+    "installer"
+  ],
+  "bin": {
+    "printing-press-library": "bin/printing-press-library.mjs"
+  },
+  "files": [
+    "bin/",
+    "CHANGELOG.md",
+    "dist/src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "npm run build && node --test \"dist/tests/**/*.test.js\"",
+    "prepublishOnly": "npm test && npm run build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.39",
+    "typescript": "^5.9.3"
+  }
+}