@commonlyai/cli 0.1.208 → 0.1.209

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonlyai/cli",
-  "version": "0.1.208",
+  "version": "0.1.209",
   "license": "Apache-2.0",
   "description": "The Commonly CLI — connect agents, manage pods, iterate fast",
   "type": "module",

package/src/commands/verify.js

@@ -0,0 +1,48 @@
+/** Repository verification entry point; scenario implementations live in backend. */
+import { existsSync } from 'fs';
+import { resolve, join } from 'path';
+import { spawnSync } from 'child_process';
+
+export const SCENARIOS = {
+  wave1: '__tests__/service/verify.wave1.test.js',
+  'connector-grant': '__tests__/service/verify.connectorGrant.test.js',
+};
+const testDatabase = (name) => /^(test|verify)([-_0-9]|$)|[-_]test$/.test(name || '');
+
+export const verificationPlan = (scenario, repo, env = process.env) => {
+  const suite = SCENARIOS[scenario];
+  if (!suite) throw new Error(`Unknown scenario: ${scenario}. Choose ${Object.keys(SCENARIOS).join(', ')}.`);
+  let mongoDatabase = '';
+  // MongoDB authorities can contain comma-separated seed hosts, unlike WHATWG URLs.
+  const mongoPath = /^mongodb(?:\+srv)?:\/\/[^/?#]+\/([^?#]*)/.exec(env.MONGO_URI || '');
+  try { mongoDatabase = decodeURIComponent(mongoPath?.[1] || ''); } catch { /* refused below */ }
+  if (!env.PG_HOST || !testDatabase(env.PG_DATABASE) || !testDatabase(mongoDatabase)) {
+    throw new Error('Set MONGO_URI, PG_HOST and PG_DATABASE to dedicated test/verify databases. Fixture setup clears their data.');
+  }
+  const cwd = resolve(repo, 'backend');
+  const runner = join(cwd, 'node_modules/jest/bin/jest.js');
+  if (!existsSync(join(cwd, suite)) || !existsSync(runner)) {
+    throw new Error('Use --repo with a Commonly checkout containing the scenario and installed backend dependencies.');
+  }
+  return { command: process.execPath, args: [runner, '--runInBand', '--forceExit', '--runTestsByPath', suite,
+    ...(env.COMMONLY_VERIFY_CACHE_DIR ? ['--cacheDirectory', env.COMMONLY_VERIFY_CACHE_DIR] : [])],
+    options: { cwd, stdio: 'inherit', env: { ...env, INTEGRATION_TEST: 'true' } } };
+};
+
+export const registerVerify = (program, run = spawnSync) => {
+  program.command('verify <scenario>')
+    .description(`Run shared real-HTTP scenarios against isolated test databases (${Object.keys(SCENARIOS).join(', ')})`)
+    .option('--repo <path>', 'Commonly checkout with backend test dependencies', process.cwd())
+    .addHelpText('after', '\nUse Node 22 and explicit MONGO_URI, PG_HOST and PG_DATABASE. Fixture databases are cleared.\nRun inside the bounded test container when available; this command does not build images or contact a live instance.\n')
+    .action((scenario, options) => {
+      try {
+        const plan = verificationPlan(scenario, options.repo);
+        const result = run(plan.command, plan.args, plan.options);
+        if (result.error) throw result.error;
+        process.exitCode = result.status === null ? 1 : result.status;
+      } catch (error) {
+        console.error(error.message);
+        process.exitCode = 1;
+      }
+    });
+};

package/src/index.js

@@ -20,6 +20,7 @@ import { registerAgent } from './commands/agent.js';
 import { registerDaemon } from './commands/daemon.js';
 import { registerPod } from './commands/pod.js';
 import { registerDev } from './commands/dev.js';
+import { registerVerify } from './commands/verify.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
@@ -51,6 +52,7 @@ registerPod(program);
 
 // Local dev environment
 registerDev(program);
+registerVerify(program);
 
 // Each subcommand owns its own `--instance <url>` flag; a program-level
 // duplicate shadowed the subcommand value on commander v12, causing