api-spec-cli 0.2.3 → 0.2.4

package/src/commands/grep.js

@@ -1,64 +1,67 @@
-import { out } from "../output.js";
-import { parseArgs } from "../args.js";
-import { getRegistry, getEntry, getCachedSpec, saveCachedSpec } from "../registry.js";
-import { fetchSpec } from "./fetch.js";
-import { matchGlob } from "../glob.js";
-
-export async function grepCmd(args) {
-  const { flags, positional } = parseArgs(args);
-  const pattern = positional[0];
-  if (!pattern) throw new Error(
-    "Usage: spec grep <pattern> [--spec <name>]\n" +
-    "  Glob patterns: * matches anything, ? matches one char\n" +
-    "  Plain text: substring match across name and description"
-  );
-
-  const entries = flags.spec
-    ? [getEntry(flags.spec)]
-    : getRegistry().filter((e) => e.enabled);
-
-  if (entries.length === 0) throw new Error("No registered specs. Run 'spec add' first.");
-
-  const results = [];
-
-  for (const entry of entries) {
-    let spec = getCachedSpec(entry.name);
-    if (!spec) {
-      spec = await fetchSpec(entry);
-      saveCachedSpec(entry.name, spec);
-    }
-
-    const matches = [];
-
-    if (spec.type === "mcp") {
-      for (const tool of spec.tools) {
-        const nameMatch = matchGlob(pattern, tool.name);
-        const descMatch = tool.description && matchGlob(pattern, tool.description);
-        if (nameMatch || descMatch) {
-          matches.push({ id: tool.name, description: tool.description });
-        }
-      }
-    } else if (spec.type === "openapi") {
-      for (const op of spec.operations) {
-        if (matchGlob(pattern, op.id) || matchGlob(pattern, op.path) ||
-            (op.summary && matchGlob(pattern, op.summary))) {
-          matches.push({ id: op.id, method: op.method, path: op.path });
-        }
-      }
-    } else if (spec.type === "graphql") {
-      for (const op of spec.operations) {
-        if (matchGlob(pattern, op.name) ||
-            (op.description && matchGlob(pattern, op.description))) {
-          matches.push({ id: op.name, kind: op.kind });
-        }
-      }
-    }
-
-    if (matches.length > 0) {
-      results.push({ spec: entry.name, type: spec.type, matches });
-    }
-  }
-
-  const total = results.reduce((s, r) => s + r.matches.length, 0);
-  out({ pattern, total, results });
-}
+import { out } from "../output.js";
+import { parseArgs } from "../args.js";
+import { getRegistry, getEntry, getCachedSpec, saveCachedSpec, allEntries } from "../registry.js";
+import { fetchSpec } from "./fetch.js";
+import { matchGlob } from "../glob.js";
+
+export async function grepCmd(args) {
+  const { flags, positional } = parseArgs(args);
+  const pattern = positional[0];
+  if (!pattern)
+    throw new Error(
+      "Usage: spec grep <pattern> [--spec <name>]\n" +
+        "  Glob patterns: * matches anything, ? matches one char\n" +
+        "  Plain text: substring match across name and description"
+    );
+
+  const entries = flags.spec
+    ? [getEntry(flags.spec)]
+    : allEntries(getRegistry()).filter((e) => e.enabled);
+
+  if (entries.length === 0) throw new Error("No registered specs. Run 'spec add' first.");
+
+  const results = [];
+
+  for (const entry of entries) {
+    let spec = getCachedSpec(entry.name);
+    if (!spec) {
+      spec = await fetchSpec(entry);
+      saveCachedSpec(entry.name, spec);
+    }
+
+    const matches = [];
+
+    if (spec.type === "mcp") {
+      for (const tool of spec.tools) {
+        const nameMatch = matchGlob(pattern, tool.name);
+        const descMatch = tool.description && matchGlob(pattern, tool.description);
+        if (nameMatch || descMatch) {
+          matches.push({ id: tool.name, description: tool.description });
+        }
+      }
+    } else if (spec.type === "openapi") {
+      for (const op of spec.operations) {
+        if (
+          matchGlob(pattern, op.id) ||
+          matchGlob(pattern, op.path) ||
+          (op.summary && matchGlob(pattern, op.summary))
+        ) {
+          matches.push({ id: op.id, method: op.method, path: op.path });
+        }
+      }
+    } else if (spec.type === "graphql") {
+      for (const op of spec.operations) {
+        if (matchGlob(pattern, op.name) || (op.description && matchGlob(pattern, op.description))) {
+          matches.push({ id: op.name, kind: op.kind });
+        }
+      }
+    }
+
+    if (matches.length > 0) {
+      results.push({ spec: entry.name, type: spec.type, matches });
+    }
+  }
+
+  const total = results.reduce((s, r) => s + r.matches.length, 0);
+  out({ pattern, total, results });
+}

package/src/commands/list.js

@@ -1,80 +1,78 @@
-import { out } from "../output.js";
-import { parseArgs } from "../args.js";
-import { resolveSpec } from "../resolve.js";
-
-export async function listOperations(args) {
-  const opts = parseArgs(args);
-  const { flags } = opts;
-
-  const { spec } = await resolveSpec(flags);
-
-  const filter = flags.filter?.toLowerCase();
-  const compact = flags.compact !== "false";
-  const limit = parseInt(flags.limit) || 0;
-  const offset = parseInt(flags.offset) || 0;
-  const tag = flags.tag?.toLowerCase();
-
-  let operations;
-
-  if (spec.type === "openapi") {
-    let source = spec.operations;
-    if (tag) {
-      source = source.filter((op) => op.tags?.some((t) => t.toLowerCase().includes(tag)));
-    }
-    operations = source.map((op) =>
-      compact
-        ? { id: op.id, method: op.method, path: op.path }
-        : {
-            id: op.id,
-            method: op.method,
-            path: op.path,
-            summary: op.summary,
-            tags: op.tags,
-            deprecated: op.deprecated,
-          }
-    );
-  } else if (spec.type === "mcp") {
-    operations = spec.tools.map((t) =>
-      compact
-        ? { id: t.name, description: t.description }
-        : { id: t.name, description: t.description, inputSchema: t.inputSchema }
-    );
-  } else {
-    // graphql
-    operations = spec.operations.map((op) =>
-      compact
-        ? { id: op.name, kind: op.kind }
-        : {
-            id: op.name,
-            kind: op.kind,
-            description: op.description,
-            args: op.args.map((a) => a.name),
-            returnType: op.returnType,
-            isDeprecated: op.isDeprecated,
-          }
-    );
-
-    if (tag) {
-      operations = operations.filter((op) => op.kind === tag);
-    }
-  }
-
-  if (filter) {
-    operations = operations.filter((op) =>
-      JSON.stringify(op).toLowerCase().includes(filter)
-    );
-  }
-
-  const total = operations.length;
-
-  if (offset > 0) operations = operations.slice(offset);
-  if (limit > 0)  operations = operations.slice(0, limit);
-
-  out({
-    type: spec.type,
-    total,
-    showing: operations.length,
-    offset: offset || 0,
-    operations,
-  });
-}
+import { out } from "../output.js";
+import { parseArgs } from "../args.js";
+import { resolveSpec } from "../resolve.js";
+
+export async function listOperations(args) {
+  const opts = parseArgs(args);
+  const { flags } = opts;
+
+  const { spec } = await resolveSpec(flags);
+
+  const filter = flags.filter?.toLowerCase();
+  const compact = flags.compact !== "false";
+  const limit = parseInt(flags.limit) || 0;
+  const offset = parseInt(flags.offset) || 0;
+  const tag = flags.tag?.toLowerCase();
+
+  let operations;
+
+  if (spec.type === "openapi") {
+    let source = spec.operations;
+    if (tag) {
+      source = source.filter((op) => op.tags?.some((t) => t.toLowerCase().includes(tag)));
+    }
+    operations = source.map((op) =>
+      compact
+        ? { id: op.id, method: op.method, path: op.path }
+        : {
+            id: op.id,
+            method: op.method,
+            path: op.path,
+            summary: op.summary,
+            tags: op.tags,
+            deprecated: op.deprecated,
+          }
+    );
+  } else if (spec.type === "mcp") {
+    operations = spec.tools.map((t) =>
+      compact
+        ? { id: t.name, description: t.description }
+        : { id: t.name, description: t.description, inputSchema: t.inputSchema }
+    );
+  } else {
+    // graphql
+    operations = spec.operations.map((op) =>
+      compact
+        ? { id: op.name, kind: op.kind }
+        : {
+            id: op.name,
+            kind: op.kind,
+            description: op.description,
+            args: op.args.map((a) => a.name),
+            returnType: op.returnType,
+            isDeprecated: op.isDeprecated,
+          }
+    );
+
+    if (tag) {
+      operations = operations.filter((op) => op.kind === tag);
+    }
+  }
+
+  if (filter) {
+    operations = operations.filter((op) => JSON.stringify(op).toLowerCase().includes(filter));
+  }
+
+  const total = operations.length;
+
+  if (offset > 0) operations = operations.slice(offset);
+  if (limit > 0) operations = operations.slice(0, limit);
+
+  out({
+    type: spec.type,
+    total,
+    showing: operations.length,
+    offset: offset || 0,
+    operations,
+  });
+}