rcf-lite 0.8.0 → 0.10.0

package/bin/rcf-verify.js

@@ -1,122 +0,0 @@
-#!/usr/bin/env node
-// The `rcf-verify` alias bin. Post 0.7.1 packaging consolidation the
-// unified `rcf` CLI grew a `verify` subcommand that dispatches to the
-// same handlers this file wires up; `rcf-verify` remains as a
-// transition-grace alias (see docs/2026-08-06_packaging-consolidation-
-// proposal.md R3). When run directly (as `rcf-verify <verb>` rather
-// than through the routing `rcf verify <verb>`), the entrypoint emits
-// a one-line stderr deprecation notice; behaviour is otherwise
-// unchanged.
-//
-// Argv layout: `rcf-verify <subcommand> [args...]`. The first positional
-// selects the subcommand handler; global --version / --help short-circuit
-// before dispatch. The `main` export is also imported by bin/rcf.js as
-// the `verify` subcommand handler, so the dispatcher lives in one place.
-
-import { realpathSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
-import process from 'node:process';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-import { main as runMain } from '../src/verify/cli/run.js';
-import { main as reportMain } from '../src/verify/cli/report.js';
-import { main as provisionMain } from '../src/verify/cli/provision.js';
-import { main as cleanupMain } from '../src/verify/cli/cleanup.js';
-import { main as mcpMain } from '../src/verify/cli/mcp.js';
-import { main as helpMain, TOP_LEVEL_HELP } from '../src/verify/cli/help.js';
-
-const here = dirname(fileURLToPath(import.meta.url));
-
-const SUBCOMMANDS = {
-  run: runMain,
-  report: reportMain,
-  provision: provisionMain,
-  cleanup: cleanupMain,
-  mcp: mcpMain,
-  help: helpMain,
-};
-
-/**
- * @param {string[]} argv - argv minus node + script
- * @param {object} [deps]
- * @returns {Promise<number>}
- */
-export async function main(argv, deps = {}) {
-  const stdout = deps.stdout ?? process.stdout;
-  const stderr = deps.stderr ?? process.stderr;
-
-  if (argv.length === 0) {
-    stdout.write(TOP_LEVEL_HELP);
-    return 0;
-  }
-  const first = argv[0];
-  if (first === '--version' || first === '-v') {
-    stdout.write(`rcf-verify ${await readPackageVersion()}\n`);
-    return 0;
-  }
-  if (first === '--help' || first === '-h') {
-    stdout.write(TOP_LEVEL_HELP);
-    return 0;
-  }
-  const handler = SUBCOMMANDS[first];
-  if (!handler) {
-    stderr.write(`[error] usage unknown subcommand: ${first}\n`);
-    stderr.write(TOP_LEVEL_HELP);
-    return 2;
-  }
-  return await handler(argv.slice(1), deps);
-}
-
-async function readPackageVersion() {
-  try {
-    const pkgPath = resolve(here, '..', 'package.json');
-    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
-    return pkg.version ?? '0.0.0';
-  } catch {
-    return '0.0.0';
-  }
-}
-
-/**
- * Symlink-safe entry-point compare (mirrors build's bin/rcf.js). macOS `/tmp`
- * is a symlink to `/private/tmp` and every `pnpm link` shim is a symlink;
- * without realpath the isMain gate breaks and main() never runs.
- *
- * @param {string} metaUrl
- * @param {string} argvPath
- * @returns {boolean}
- */
-export function isSameEntryPoint(metaUrl, argvPath) {
-  try {
-    const metaPath = fileURLToPath(metaUrl);
-    return realpathSync(metaPath) === realpathSync(argvPath);
-  } catch {
-    try {
-      return metaUrl === pathToFileURL(argvPath).href;
-    } catch {
-      return false;
-    }
-  }
-}
-
-const isMain = process.argv[1] && isSameEntryPoint(import.meta.url, process.argv[1]);
-if (isMain) {
-  // Transition-grace deprecation notice per proposal R3. Only fires when
-  // the alias bin is invoked directly (not when bin/rcf.js routes the
-  // `verify` subcommand through the exported `main`, since the isMain
-  // guard is false in that case). Suppressible via RCF_QUIET=1 for
-  // scripted callers who cannot tolerate stderr chatter.
-  if (!process.env.RCF_QUIET) {
-    process.stderr.write(
-      '[rcf-verify] deprecation: prefer `rcf verify` (the umbrella CLI subcommand). ' +
-      'The `rcf-verify` alias will be removed in a future major. Set RCF_QUIET=1 to silence.\n',
-    );
-  }
-  main(process.argv.slice(2))
-    .then((code) => process.exit(code))
-    .catch((err) => {
-      process.stderr.write(`[rcf-verify] unexpected failure: ${err.message}\n${err.stack}\n`);
-      process.exit(1);
-    });
-}

package/src/verify/cli/help.js

@@ -1,56 +0,0 @@
-// Top-level and per-subcommand help (mirrors build's cli/help.js). British
-// English, ASCII hyphens only.
-
-import { HELP as RUN_HELP } from './run.js';
-import { HELP as REPORT_HELP } from './report.js';
-import { HELP as PROVISION_HELP } from './provision.js';
-import { HELP as CLEANUP_HELP } from './cleanup.js';
-import { HELP as MCP_HELP } from './mcp.js';
-
-export const TOP_LEVEL_HELP = `Usage: rcf-verify <command> [options]
-
-A fresh-context adversarial verifier. Given an RCF chain (the acceptance
-contract) and a running app under a declared runtime profile, it launches an
-isolated verifier agent that walks real user journeys adversarially and emits a
-structured verdict stamped with the runtime it ran against.
-
-This is an independent ship-readiness signal, not a correctness guarantee.
-
-Commands:
-  run            Run adversarial verification and emit a report artifact
-  report <path>  Re-render a prior report artifact
-  provision      Stand up prerequisite accounts/sandboxes/data standalone
-  cleanup        Tear down provisioned artefacts (all prefixed 'zzverify-')
-  mcp            Serve verify over MCP (local stdio)
-  help [command] Print help for a command
-
-Options:
-  --version      Print the package version and exit
-  --help         Print this help and exit
-
-Run 'rcf-verify help <command>' for command-specific help.
-`;
-
-const SUB_HELP = {
-  run: RUN_HELP,
-  report: REPORT_HELP,
-  provision: PROVISION_HELP,
-  cleanup: CLEANUP_HELP,
-  mcp: MCP_HELP,
-};
-
-/**
- * @param {string[]} argv
- * @param {object} [deps]
- * @returns {Promise<number>}
- */
-export async function main(argv, deps = {}) {
-  const stdout = deps.stdout ?? process.stdout;
-  const topic = argv[0];
-  if (topic && SUB_HELP[topic]) {
-    stdout.write(SUB_HELP[topic]);
-    return 0;
-  }
-  stdout.write(TOP_LEVEL_HELP);
-  return 0;
-}