feat(ql3): establish 3.0 incubation baseline

packages/ql3-local-owner-cli/src/plugin-package/pluginPackageWorkflowCli.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+import { runLocalPluginPackageWorkflowCommandFile } from './pluginPackageWorkflowCommand';
+
+const USAGE =
+  'Usage: ql3-workflow run --command-file /absolute/private-command.json';
+
+async function main(argv: readonly string[]): Promise<void> {
+  if (argv.length === 1 && (argv[0] === '--help' || argv[0] === '-h')) {
+    process.stdout.write(`${USAGE}\n`);
+    return;
+  }
+  const commandFilePath = argv[2];
+  if (
+    argv.length !== 3 ||
+    argv[0] !== 'run' ||
+    argv[1] !== '--command-file' ||
+    commandFilePath === undefined
+  ) {
+    process.stderr.write(
+      `${JSON.stringify({
+        code: 'LOCAL_PLUGIN_PACKAGE_WORKFLOW_CLI_USAGE_INVALID',
+        message: USAGE,
+      })}\n`,
+    );
+    process.exitCode = 64;
+    return;
+  }
+  try {
+    const result = await runLocalPluginPackageWorkflowCommandFile(
+      commandFilePath,
+    );
+    process.stdout.write(`${JSON.stringify(result)}\n`);
+  } catch (error) {
+    const candidate = error as {
+      readonly code?: unknown;
+      readonly name?: unknown;
+    };
+    process.stderr.write(
+      `${JSON.stringify({
+        code:
+          typeof candidate.code === 'string'
+            ? candidate.code
+            : 'LOCAL_PLUGIN_PACKAGE_WORKFLOW_CLI_FAILED',
+        name: typeof candidate.name === 'string' ? candidate.name : 'Error',
+      })}\n`,
+    );
+    process.exitCode = 1;
+  }
+}
+
+void main(process.argv.slice(2));