vcluster-yaml-mcp-server 1.0.1 → 1.0.2

package/README.md

@@ -76,6 +76,11 @@ npx -p vcluster-yaml-mcp-server vcluster-yaml query sync --format table
 # Or install globally
 npm install -g vcluster-yaml-mcp-server
 vcluster-yaml query sync --format table
+
+# Validate configurations with ease
+vcluster-yaml validate my-config.yaml
+cat my-config.yaml | vcluster-yaml validate -
+vcluster-yaml validate my-config.yaml --schema-version v0.24.0
 ```
 
 📖 **[Full CLI Documentation →](docs/CLI.md)**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vcluster-yaml-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for querying vcluster YAML configurations using jq",
   "main": "src/index.js",
   "type": "module",

package/src/cli-utils.js

@@ -0,0 +1,44 @@
+/**
+ * CLI utility functions
+ * Provides helpers for stdin reading and file operations
+ */
+
+import { readFile } from 'fs/promises';
+import { stdin } from 'process';
+
+/**
+ * Read content from stdin
+ * Used for piping content to CLI commands
+ * @returns {Promise<string>} The content read from stdin
+ */
+export async function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = '';
+
+    stdin.setEncoding('utf8');
+    stdin.on('data', chunk => data += chunk);
+    stdin.on('end', () => resolve(data));
+    stdin.on('error', reject);
+  });
+}
+
+/**
+ * Read content from a file or stdin based on the file argument
+ * @param {string|undefined} file - File path, '-' for stdin, or undefined for stdin
+ * @returns {Promise<{content: string, source: string}>} The content and its source
+ */
+export async function readContentSource(file) {
+  // Read from stdin if no file provided or file is '-'
+  if (!file || file === '-') {
+    const content = await readStdin();
+    return { content, source: 'stdin' };
+  }
+
+  // Read from file
+  try {
+    const content = await readFile(file, 'utf-8');
+    return { content, source: file };
+  } catch (error) {
+    throw new Error(`Cannot read file '${file}': ${error.message}`);
+  }
+}

package/src/cli.js

@@ -9,6 +9,7 @@
 import { Command } from 'commander';
 import { handleQuery, handleListVersions, handleValidate } from './cli-handlers.js';
 import { formatOutput } from './formatters.js';
+import { readContentSource } from './cli-utils.js';
 
 const program = new Command();
 
@@ -22,8 +23,14 @@ program
   .command('query <query>')
   .description('Search for vCluster configuration fields')
   .option('--file <file>', 'Configuration file to search', 'chart/values.yaml')
-  .option('--version <version>', 'vCluster version or branch', 'main')
+  .option('-s, --schema-version <version>', 'vCluster version or branch', 'main')
   .option('-f, --format <format>', 'Output format (json, yaml, table)', 'json')
+  .addHelpText('after', `
+Examples:
+  $ vcluster-yaml query sync
+  $ vcluster-yaml query sync --schema-version v0.24.0
+  $ vcluster-yaml query "controlPlane.replicas" --format table
+  `)
   .action(async (query, options) => {
     try {
       // Validate format option
@@ -32,9 +39,15 @@ program
         process.exit(1);
       }
 
+      // Add validation for empty query
+      if (!query || query.trim() === '') {
+        console.error(`Error: Query cannot be empty. Try 'vcluster-yaml query sync' or see examples with --help`);
+        process.exit(1);
+      }
+
       const result = await handleQuery(query, {
         file: options.file,
-        version: options.version
+        version: options.schemaVersion
       });
 
       if (!result.success) {
@@ -91,11 +104,22 @@ program
 
 // Validate command
 program
-  .command('validate <content>')
+  .command('validate [file]')
   .description('Validate vCluster configuration')
-  .option('--version <version>', 'vCluster version for schema', 'main')
+  .option('-s, --schema-version <version>', 'vCluster version for schema', 'main')
   .option('-f, --format <format>', 'Output format (json, yaml, table)', 'json')
-  .action(async (content, options) => {
+  .addHelpText('after', `
+Arguments:
+  file                   YAML file to validate (use '-' for stdin, omit to read from stdin)
+
+Examples:
+  $ vcluster-yaml validate vcluster.yaml
+  $ vcluster-yaml validate vcluster.yaml --schema-version v0.24.0
+  $ cat vcluster.yaml | vcluster-yaml validate -
+  $ vcluster-yaml validate - < vcluster.yaml
+  $ vcluster-yaml validate vcluster.yaml --format table
+  `)
+  .action(async (file, options) => {
     try {
       // Validate format option
       if (!['json', 'yaml', 'table'].includes(options.format)) {
@@ -103,8 +127,24 @@ program
         process.exit(1);
       }
 
+      // Read content from file or stdin
+      let content;
+      try {
+        const result = await readContentSource(file);
+        content = result.content;
+      } catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+      }
+
+      // Check for empty content
+      if (!content || content.trim() === '') {
+        console.error(`Error: No content to validate. Please provide a file path or pipe content via stdin.`);
+        process.exit(1);
+      }
+
       const result = await handleValidate(content, {
-        version: options.version
+        version: options.schemaVersion
       });
 
       // For validation, always output the result (even if not successful)