Initial commit: NetMesh smart ops platform with 3D topology, inspection reports, RCA and AI ops assistant

packages/plugin-cli/src/cli.ts

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+import process from "node:process";
+
+import { checkPluginCompatibility } from "./compatibility.js";
+import { buildPlugin, initPlugin, packPlugin, validateTarget } from "./commands.js";
+
+const USAGE = `Netcatty plugin CLI (API 0.1.0-internal)
+
+Usage:
+  netcatty-plugin init <directory> --id <reverse.dns.id> [--name <display name>]
+  netcatty-plugin validate <directory|package.ncpkg>
+  netcatty-plugin compatibility <directory|package.ncpkg> --netcatty <version> [--api <version>] [--features <id,id,...>]
+  netcatty-plugin build <directory>
+  netcatty-plugin pack <directory> [--out <package.ncpkg>]
+`;
+
+function optionValue(args: readonly string[], name: string): string | undefined {
+  const index = args.indexOf(name);
+  if (index === -1) return undefined;
+  const value = args[index + 1];
+  if (!value || value.startsWith("--")) throw new Error(`Missing value for ${name}`);
+  return value;
+}
+
+async function main(args: readonly string[]): Promise<void> {
+  const [command, target] = args;
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    process.stdout.write(USAGE);
+    return;
+  }
+  if (!target) throw new Error(`Missing target for ${command}`);
+
+  if (command === "init") {
+    const id = optionValue(args, "--id");
+    if (!id) throw new Error("init requires --id <reverse.dns.id>");
+    const directory = await initPlugin(target, { id, name: optionValue(args, "--name") });
+    process.stdout.write(`Initialized plugin in ${directory}\n`);
+    return;
+  }
+  if (command === "validate") {
+    const result = await validateTarget(target);
+    process.stdout.write(
+      `Valid ${result.kind}: ${result.manifest.id}@${result.manifest.version}\n`,
+    );
+    return;
+  }
+  if (command === "compatibility") {
+    const netcattyVersion = optionValue(args, "--netcatty");
+    if (!netcattyVersion) {
+      throw new Error("compatibility requires --netcatty <version>");
+    }
+    const targetResult = await validateTarget(target);
+    const features = optionValue(args, "--features")
+      ?.split(",")
+      .map((feature) => feature.trim())
+      .filter(Boolean);
+    const result = checkPluginCompatibility(targetResult.manifest, {
+      netcattyVersion,
+      apiVersion: optionValue(args, "--api"),
+      features,
+    });
+    if (!result.compatible) {
+      throw new Error(`Plugin is incompatible:\n- ${result.errors.join("\n- ")}`);
+    }
+    const featureSummary = result.enabledFeatures.length > 0
+      ? result.enabledFeatures.join(", ")
+      : "none";
+    process.stdout.write(
+      `Compatible: ${targetResult.manifest.id}@${targetResult.manifest.version}\nEnabled features: ${featureSummary}\n`,
+    );
+    return;
+  }
+  if (command === "build") {
+    await buildPlugin(target);
+    process.stdout.write("Plugin build completed.\n");
+    return;
+  }
+  if (command === "pack") {
+    const result = await packPlugin(target, optionValue(args, "--out"));
+    process.stdout.write(
+      `Packed ${result.fileCount} files to ${result.outputPath}\nSHA-256 ${result.sha256}\n`,
+    );
+    return;
+  }
+  throw new Error(`Unknown command: ${command}`);
+}
+
+main(process.argv.slice(2)).catch((error: unknown) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});