revisium 2.4.0 → 2.5.0-alpha.1

package/.github/workflows/build.yml

@@ -3,36 +3,17 @@ name: Build
 on:
   workflow_dispatch:
 
-env:
-  IMAGE_NAME: ${{ github.event.repository.name }}
+permissions:
+  contents: read
 
 jobs:
   build-and-push-image:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Log in to the Container registry
-        uses: docker/login-action@184bdaa0721073962dff0199f1fb9940f07167d1 #docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-
-      - name: Extract metadata (tags, labels) for Docker
-        id: meta
-        uses: docker/metadata-action@c1e51972afc2121e065aed6d45c65596fe445f3f #docker/metadata-action@v5
-        with:
-          images: ${{ secrets.DOCKERHUB_USERNAME }}/${{ env.IMAGE_NAME }}
-
-      - name: Build and push Docker image
-        uses: docker/build-push-action@ca052bb54ab0790a636c9b5f226502c73d547a25 #docker/build-push-action@v5
-        with:
-          context: .
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
+    uses: revisium/revisium-actions/.github/workflows/docker-build.yml@184b609dcbc1e23f14021141f29226d4e6a0f1ac # v0.3.6
+    with:
+      image_name: ${{ github.event.repository.name }}
+      context: .
+      dockerfile: Dockerfile
+      emit_latest_tag: ${{ startsWith(github.ref, 'refs/tags/v') }}
+    secrets:
+      DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
+      DOCKERHUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }}

package/.github/workflows/ci.yml

@@ -88,9 +88,3 @@ jobs:
         uses: SonarSource/sonarqube-scan-action@8c71dc039c2dd71d3821e89a2b58ecc7fee6ced9 #SonarSource/sonarqube-scan-action@v5
         env:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
-
-      - name: Upload results to Codecov
-        uses: codecov/codecov-action@18283e04ce6e62d37312384ff67231eb8fd56d24 #codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: ./coverage/lcov.info

package/.github/workflows/npm-publish.yml

@@ -6,84 +6,19 @@ on:
       - 'v*'
 
 jobs:
-  validate-and-publish:
-    runs-on: ubuntu-latest
+  publish:
     permissions:
       contents: write
       id-token: write
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Validate tag format
-        run: |
-          TAG=${GITHUB_REF#refs/tags/}
-          echo "📌 Publishing for tag: $TAG"
-
-          if [[ ! $TAG =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
-            echo "❌ Invalid tag format: $TAG (expected: vX.Y.Z or vX.Y.Z-prerelease)"
-            exit 1
-          fi
-
-          VERSION=${TAG#v}
-          echo "version=$VERSION" >> $GITHUB_ENV
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Validate package.json version matches tag
-        run: |
-          PACKAGE_VERSION=$(node -p "require('./package.json').version")
-          TAG_VERSION=${{ env.version }}
-
-          echo "📦 package.json version: $PACKAGE_VERSION"
-          echo "🏷️  Tag version: $TAG_VERSION"
-
-          if [[ "$PACKAGE_VERSION" != "$TAG_VERSION" ]]; then
-            echo "❌ Version mismatch: package.json ($PACKAGE_VERSION) != tag ($TAG_VERSION)"
-            exit 1
-          fi
-
-          echo "✅ Version validation passed"
-
-      - name: Determine npm tag
-        id: npm-tag
-        run: |
-          VERSION=$(node -p "require('./package.json').version")
-          if [[ "$VERSION" =~ -alpha ]]; then
-            echo "tag=alpha" >> $GITHUB_OUTPUT
-          elif [[ "$VERSION" =~ -beta ]]; then
-            echo "tag=beta" >> $GITHUB_OUTPUT
-          elif [[ "$VERSION" =~ -rc ]]; then
-            echo "tag=rc" >> $GITHUB_OUTPUT
-          else
-            echo "tag=latest" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Publish to NPM
-        run: npm publish --provenance --access public --tag ${{ steps.npm-tag.outputs.tag }}
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
-        with:
-          tag_name: ${{ github.ref_name }}
-          name: Release ${{ github.ref_name }}
-          body: |
-            ## Changes in ${{ github.ref_name }}
-
-            This release was automatically generated from tag ${{ github.ref_name }}.
-
-            ### Installation
-            ```bash
-            npm install -g revisium@${{ env.version }}
-            ```
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    uses: revisium/revisium-actions/.github/workflows/npm-publish.yml@184b609dcbc1e23f14021141f29226d4e6a0f1ac # v0.3.6
+    with:
+      node_version: 24.11.1
+      install_command: npm ci
+      pre_publish_commands: |
+        npm run tsc
+        npm run build
+      npm_access: public
+      publish_auth: token
+      create_github_release: true
+    secrets:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/release-train.yml

@@ -0,0 +1,90 @@
+name: Release Train
+
+on:
+  workflow_dispatch:
+    inputs:
+      action:
+        description: Release train transition
+        required: true
+        type: choice
+        options:
+          - start-minor-alpha
+          - start-major-alpha
+          - start-minor-rc
+          - start-major-rc
+          - start-minor-stable
+          - start-major-stable
+          - alpha-bump
+          - promote-rc
+          - rc-bump
+          - stable
+          - patch
+          - patch-alpha-start
+          - patch-rc-start
+      dry_run:
+        description: Validate and show the computed release without pushing.
+        required: false
+        default: false
+        type: boolean
+
+concurrency:
+  group: ${{ github.repository }}-release-train
+  cancel-in-progress: false
+
+permissions:
+  actions: read
+  contents: read
+
+jobs:
+  release-train:
+    name: Release train
+    uses: revisium/revisium-actions/.github/workflows/release-train.yml@184b609dcbc1e23f14021141f29226d4e6a0f1ac # v0.3.6
+    with:
+      action: ${{ inputs.action }}
+      dry_run: ${{ inputs.dry_run }}
+      base_branch: master
+      node_version: 24.11.1
+      install_command: npm ci
+      validate_command: |
+        cleanup() {
+          status=$?
+          if [ -f .e2e-test.pid ]; then
+            kill "$(cat .e2e-test.pid)" 2>/dev/null || true
+            rm -f .e2e-test.pid
+          fi
+          rm -rf .e2e-test
+          if [ "$status" -ne 0 ] && [ -f revisium.log ]; then
+            cat revisium.log
+          fi
+          exit "$status"
+        }
+        trap cleanup EXIT
+
+        npm run lint:ci
+        npm run tsc
+        rm -rf dist
+
+        FILE_PLUGIN_PUBLIC_ENDPOINT=https://cdn.example.com npx @revisium/standalone --auth --port 8082 --data .e2e-test > revisium.log 2>&1 &
+        echo $! > .e2e-test.pid
+
+        for i in $(seq 1 300); do
+          revisium_pid="$(cat .e2e-test.pid)"
+          if ! kill -0 "$revisium_pid" 2>/dev/null; then
+            echo "Revisium exited before becoming ready"
+            exit 1
+          fi
+          if curl -sf http://localhost:8082/health/readiness > /dev/null 2>&1; then
+            echo "Revisium ready after ${i}s"
+            break
+          fi
+          if [ "$i" = 300 ]; then
+            echo "Timed out waiting for Revisium"
+            exit 1
+          fi
+          sleep 1
+        done
+
+        npm run test:all
+        npm run build
+    secrets:
+      RELEASE_BOT_PRIVATE_KEY: ${{ secrets.RELEASE_BOT_PRIVATE_KEY }}

package/AGENTS.md

@@ -0,0 +1,152 @@
+# revisium-cli — Agent Guide
+
+Context for AI coding assistants (Claude, Cursor, Copilot Workspace, Aider, etc.) working on this repository. Keep edits minimal and scoped; verify with the commands listed below.
+
+## What this is
+
+`revisium-cli` is a NestJS / `nest-commander` CLI for managing Revisium instances: schema export/import, migrations, row sync, project/endpoint bootstrap, workspace configuration, and saved API-key auth. It ships as the `revisium` npm binary.
+
+Primary command groups:
+
+- `migrate save/apply` — schema migrations
+- `schema save/create-migrations` — schema export + offline migration generation
+- `rows save/upload` — data export/import
+- `sync schema/data/all` — direct project-to-project sync
+- `instance add/list/show/remove` — workspace instance config
+- `context create/list/show/use/remove` — workspace contexts
+- `auth login/status/logout` — saved API-key credentials (OS keyring)
+- `project ensure` — idempotent project + branch creation
+- `endpoint ensure/list` — generated REST/GraphQL endpoints
+- `example bootstrap` — end-to-end project seeding from a config file
+
+## Commands
+
+| Goal              | Command                                                                                          |
+| ----------------- | ------------------------------------------------------------------------------------------------ |
+| Type-check        | `npm run tsc`                                                                                    |
+| Lint (CI mode)    | `npm run lint:ci`                                                                                |
+| Lint + autofix    | `npm run lint`                                                                                   |
+| Unit tests        | `npm test -- --runInBand`                                                                        |
+| Unit + coverage   | `npm run test:cov`                                                                               |
+| Build the binary  | `npm run build` (outputs `dist/src/main.js`)                                                     |
+| E2E (default)     | `npm run test:e2e` (expects standalone running on `localhost:8082`; bring it up with `test:e2e:up`/`test:e2e:down`) |
+| E2E matrix        | `npm run test:e2e:matrix` — opt-in; see `e2e/matrix/README.md`                                   |
+| E2E matrix (alpha) | `npm run test:e2e:matrix:alpha` — runs the matrix against the latest published alpha CLI (resolved from the `revisium@alpha` dist-tag); override with `REVISIUM_CLI_PACKAGE=revisium@<version>` |
+
+Local CLI invocation: `node dist/src/main.js <command>` (the `revisium` shim points at the same file).
+
+## Code layout
+
+```
+src/
+  app.module.ts                          # NestJS module wiring all commands + services
+  main.ts                                # CommandFactory entry point
+  commands/
+    auth/                                # auth login/status/logout, AuthCommandTarget helpers
+    instance/                            # instance add/list/show/remove
+    context/                             # context create/list/show/use/remove
+    project/                             # project ensure
+    endpoint/                            # endpoint ensure/list
+    example/                             # example bootstrap
+    migration/                           # migrate save/apply
+    schema/                              # schema save / create-migrations
+    rows/                                # rows save / upload
+    sync/                                # sync schema / data / all
+    base.command.ts                      # shared --url / --context options
+    base-sync.command.ts                 # shared sync flags
+  services/
+    bootstrap/                           # BootstrapService: ensureProject / ensureTable / ensureRow / ensureEndpoint / bootstrapExample
+    connection/                          # RevisiumApiClient + ConnectionService
+    credentials/                         # OS keyring-backed API key store + credential-target resolver
+    sync/                                # sync orchestration helpers
+    url/                                 # URL parsing / building, AuthPromptService
+    workspace/                           # .revisium/revisium-cli.config.json reader/writer
+    common/                              # logging, JSON validation, interactive prompts
+  utils/                                 # parse-boolean, env-config, error formatter, stats
+e2e/
+  tests/                                 # default e2e suite (legacy, hits docker-compose standalone)
+  matrix/                                # opt-in matrix; each suite owns a fresh @revisium/standalone
+  utils/                                 # cli-runner, standalone-runner, standalone-api, fixtures, workspace helpers
+docs/                                    # public docs surfaced from README.md
+```
+
+## Conventions
+
+- **Strict ESLint config** with `--max-warnings 0` and Prettier integration. Run `npm run lint` after edits — auto-fix handles most issues.
+- **Tests live in `__tests__/` next to the code** and end in `.spec.ts`. Existing patterns: instantiate the command/service directly with hand-rolled fakes (no Nest test module overhead). See `src/commands/auth/__tests__/auth-status.command.spec.ts` for a representative example.
+- **Coverage threshold:** SonarCloud requires `new_coverage ≥ 80%` on each PR. Add tests for new branches in the same PR.
+- **Validation errors** thrown for config-shape problems use `TypeError` (Sonar S7786). Operational errors stay as plain `Error`.
+- **No `--no-input` plumbing yet.** A common-flags PR is planned; until then, don't expose `--no-input` as a per-command option (it would be dead code).
+- **OS keyring service name** can be overridden via `REVISIUM_CREDENTIAL_STORE_SERVICE` for tests so saved keys don't bleed into the developer's keyring.
+
+## Trust-but-verify checklist
+
+After making changes, run **all** of:
+
+```sh
+npm run tsc
+npm run lint:ci
+npm test -- --runInBand
+npm run build
+```
+
+If touching e2e helpers or matrix specs, ensure the additions still type-check and lint clean (the matrix is intentionally not run on default CI).
+
+## Running the e2e matrix against an alpha CLI
+
+The matrix in `e2e/matrix/` boots a fresh `@revisium/standalone` per suite and exercises a CLI binary against it. By default that's the locally-built `dist/src/main.js`; for release validation you can swap in a published version without rebuilding.
+
+`runCli()` honours two env vars (in order of precedence):
+
+| Env var                | Effect                                                                                          |
+| ---------------------- | ----------------------------------------------------------------------------------------------- |
+| `REVISIUM_CLI_PACKAGE` | invoke via `npx -y --package=<spec> revisium ...` — accepts a dist-tag (`revisium@alpha`, `revisium@latest`) or an exact version (`revisium@2.5.0-alpha.0`) |
+| `REVISIUM_CLI_BIN`     | invoke via `node <abs-path>` — useful for a side-checkout build                                 |
+
+Stable standalone is pinned via the `@revisium/standalone` `devDependency` in `package.json`; `startStandalone()` resolves it through `npx --yes`, so `npm ci` locks the version.
+
+### Quick recipes
+
+```sh
+# Run the entire matrix against whatever revisium@alpha currently resolves to
+npm run test:e2e:matrix:alpha
+
+# Pin to a specific alpha version for the same script
+REVISIUM_CLI_PACKAGE=revisium@2.5.0-alpha.1 npm run test:e2e:matrix:alpha
+
+# Drive the matrix by hand against any spec
+REVISIUM_CLI_PACKAGE=revisium@alpha npm run test:e2e:matrix
+
+# One suite only (useful for triage)
+REVISIUM_CLI_PACKAGE=revisium@alpha npm run test:e2e:matrix -- --testPathPattern=M06
+
+# Stream standalone logs to stderr (debug startup or seeding issues)
+E2E_STANDALONE_LOGS=1 REVISIUM_CLI_PACKAGE=revisium@alpha npm run test:e2e:matrix
+```
+
+### Prompt template for triaging an alpha matrix run
+
+When a suite fails against `revisium@<alpha>`, paste this into your assistant:
+
+```text
+Run `REVISIUM_CLI_PACKAGE=revisium@<alpha-version> npm run test:e2e:matrix -- --testPathPattern=<M0X>` from the revisium-cli repo root.
+
+Goal: figure out whether the failure is
+  (a) a regression in the alpha CLI vs the previous stable, or
+  (b) a stale assumption in the matrix spec.
+
+When investigating:
+- Read the failing assertion and the surrounding `it(...)` description in `e2e/matrix/<M0X>-*.e2e-spec.ts`
+- Compare alpha behaviour against the `master` CLI by also running the same suite without `REVISIUM_CLI_PACKAGE`
+- Check the standalone version is the pinned one (`@revisium/standalone` in package.json devDependencies)
+- Inspect `process.stderr` from `runCli` (set `E2E_STANDALONE_LOGS=1` for the sandbox process)
+- Do NOT modify matrix specs to "make them pass" against the alpha unless the spec was wrong; otherwise file a regression issue against revisium-cli with the failing case.
+
+Report: failing-suite name, alpha version, root cause, and whether the fix belongs in the CLI or the spec.
+```
+
+## When to update this file
+
+Whenever a convention changes — e.g., a new command surface, a non-obvious testing pattern, a new lint rule — update both the relevant section and the commands table.
+
+> Tools that look for `CLAUDE.md` will follow the symlink in repo root to this file. Treat `AGENTS.md` as the single source of truth.

package/README.md

@@ -3,7 +3,7 @@
 # Revisium CLI
 
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=revisium_revisium-cli&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=revisium_revisium-cli)
-[![codecov](https://codecov.io/gh/revisium/revisium-cli/branch/master/graph/badge.svg?token=8XI9VJ6EQR)](https://codecov.io/gh/revisium/revisium-cli)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=revisium_revisium-cli&metric=coverage)](https://sonarcloud.io/summary/new_code?id=revisium_revisium-cli)
 [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=revisium_revisium-cli&metric=bugs)](https://sonarcloud.io/summary/new_code?id=revisium_revisium-cli)
 [![GitHub License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/revisium/revisium-cli/blob/master/LICENSE)
 [![GitHub Release](https://img.shields.io/github/v/release/revisium/revisium-cli)](https://github.com/revisium/revisium-cli/releases)
@@ -133,21 +133,37 @@ revisium sync all \
 
 ## Commands
 
-| Command | Description | Documentation |
-|---------|-------------|---------------|
-| `schema save` | Export table schemas to JSON files | [Schema Commands](docs/schema-commands.md) |
-| `schema create-migrations` | Convert schemas to migration format | [Schema Commands](docs/schema-commands.md) |
-| `migrate save` | Export migrations to JSON file | [Migrate Commands](docs/migrate-commands.md) |
-| `migrate apply` | Apply migrations from JSON file | [Migrate Commands](docs/migrate-commands.md) |
-| `rows save` | Export table data to JSON files | [Rows Commands](docs/rows-commands.md) |
-| `rows upload` | Upload table data from JSON files | [Rows Commands](docs/rows-commands.md) |
-| `sync schema` | Sync schema between projects | [Sync Commands](docs/sync-commands.md) |
-| `sync data` | Sync data between projects | [Sync Commands](docs/sync-commands.md) |
-| `sync all` | Full sync (schema + data) | [Sync Commands](docs/sync-commands.md) |
+| Command                               | Description                            | Documentation                                    |
+| ------------------------------------- | -------------------------------------- | ------------------------------------------------ |
+| `schema save`                         | Export table schemas to JSON files     | [Schema Commands](docs/schema-commands.md)       |
+| `schema create-migrations`            | Convert schemas to migration format    | [Schema Commands](docs/schema-commands.md)       |
+| `migrate save`                        | Export migrations to JSON file         | [Migrate Commands](docs/migrate-commands.md)     |
+| `migrate apply`                       | Apply migrations from JSON file        | [Migrate Commands](docs/migrate-commands.md)     |
+| `rows save`                           | Export table data to JSON files        | [Rows Commands](docs/rows-commands.md)           |
+| `rows upload`                         | Upload table data from JSON files      | [Rows Commands](docs/rows-commands.md)           |
+| `sync schema`                         | Sync schema between projects           | [Sync Commands](docs/sync-commands.md)           |
+| `sync data`                           | Sync data between projects             | [Sync Commands](docs/sync-commands.md)           |
+| `sync all`                            | Full sync (schema + data)              | [Sync Commands](docs/sync-commands.md)           |
+| `instance add/list/show/remove`       | Manage workspace Revisium instances    | [Workspace Config](docs/workspace-config.md)     |
+| `context create/list/show/use/remove` | Manage workspace Revisium contexts     | [Workspace Config](docs/workspace-config.md)     |
+| `auth login/status/logout`            | Manage saved API-key credentials       | [Authentication](docs/authentication.md)         |
+| `project ensure`                      | Ensure a project and branch exist      | [Bootstrap Commands](docs/bootstrap-commands.md) |
+| `endpoint ensure/list`                | Ensure or list generated endpoints     | [Bootstrap Commands](docs/bootstrap-commands.md) |
+| `example bootstrap`                   | Bootstrap example projects from config | [Bootstrap Commands](docs/bootstrap-commands.md) |
 
 ## Configuration
 
-Configure via environment variables or `.env` file:
+Configure via workspace config, environment variables, or `.env` file:
+
+```bash
+# Workspace-local standalone example without auth
+revisium instance add local --url revisium://localhost:9222 --auth none
+revisium context create dictionary-local \
+  --url revisium://localhost:9222/admin/dictionary/master
+revisium context use dictionary-local
+```
+
+Then single-target commands can omit `--url` in that workspace.
 
 ```env
 # Recommended: URL + Token
@@ -178,6 +194,8 @@ See [Configuration](docs/configuration.md) and [URL Format](docs/url-format.md)
 ## Documentation
 
 - [Configuration](docs/configuration.md) - Environment variables and .env files
+- [Workspace Config](docs/workspace-config.md) - non-secret instances and contexts
+- [Bootstrap Commands](docs/bootstrap-commands.md) - project, endpoint, and example bootstrap workflows
 - [URL Format](docs/url-format.md) - Revisium URL syntax
 - [Authentication](docs/authentication.md) - Token, API key, and password auth
 - [Schema Commands](docs/schema-commands.md) - schema save, create-migrations

package/dist/e2e/utils/cli-runner.d.ts

@@ -7,6 +7,7 @@ export interface CliOptions {
     env?: Record<string, string>;
     timeout?: number;
     cwd?: string;
+    stdin?: string;
 }
 export declare function runCli(args: string[], options?: CliOptions): Promise<CliResult>;
 export declare function buildUrl(projectName: string, options?: {

package/dist/e2e/utils/cli-runner.js

@@ -6,25 +6,35 @@ const child_process_1 = require("child_process");
 const fs = require("fs");
 const path = require("path");
 async function runCli(args, options = {}) {
-    const { env = {}, timeout = 60000, cwd = process.cwd() } = options;
+    const { env = {}, timeout = 60000, cwd = process.cwd(), stdin } = options;
     const isInstrumented = process.env.E2E_INSTRUMENTED === '1';
-    const mainPath = isInstrumented
-        ? 'dist-instrumented/src/main.js'
-        : 'dist/src/main.js';
-    const nycOutputDir = path.join(cwd, '.nyc_output');
+    const projectRoot = process.cwd();
+    const mainPath = path.join(projectRoot, isInstrumented ? 'dist-instrumented/src/main.js' : 'dist/src/main.js');
+    const nycOutputDir = path.join(projectRoot, '.nyc_output');
     if (isInstrumented && !fs.existsSync(nycOutputDir)) {
         fs.mkdirSync(nycOutputDir, { recursive: true });
     }
+    const effectiveEnv = {
+        ...process.env,
+        ...env,
+    };
+    const { command, commandArgs } = resolveCliInvocation(args, mainPath, effectiveEnv);
     return new Promise((resolve, reject) => {
-        const child = (0, child_process_1.spawn)('node', [mainPath, ...args], {
+        const child = (0, child_process_1.spawn)(command, commandArgs, {
             cwd,
             env: {
-                ...process.env,
-                ...env,
+                ...effectiveEnv,
                 ...(isInstrumented ? { NYC_OUTPUT_DIR: nycOutputDir } : {}),
             },
             stdio: ['pipe', 'pipe', 'pipe'],
         });
+        if (stdin !== undefined) {
+            child.stdin?.write(stdin);
+            child.stdin?.end();
+        }
+        else {
+            child.stdin?.end();
+        }
         let stdout = '';
         let stderr = '';
         child.stdout.on('data', (data) => {
@@ -51,6 +61,20 @@ async function runCli(args, options = {}) {
         });
     });
 }
+function resolveCliInvocation(args, defaultMainPath, env) {
+    const pkg = env.REVISIUM_CLI_PACKAGE;
+    if (pkg && pkg.length > 0) {
+        return {
+            command: 'npx',
+            commandArgs: ['-y', `--package=${pkg}`, 'revisium', ...args],
+        };
+    }
+    const bin = env.REVISIUM_CLI_BIN;
+    if (bin && bin.length > 0) {
+        return { command: 'node', commandArgs: [bin, ...args] };
+    }
+    return { command: 'node', commandArgs: [defaultMainPath, ...args] };
+}
 function buildUrl(projectName, options = {}) {
     const { orgId = 'admin', branch = 'master', revision, token, protocol, } = options;
     const scheme = protocol ? `revisium+${protocol}` : 'revisium';

package/dist/e2e/utils/cli-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../../../e2e/utils/cli-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../../../e2e/utils/cli-runner.ts"],"names":[],"mappings":"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"}

package/dist/e2e/utils/matrix-fixtures.d.ts

@@ -0,0 +1,26 @@
+export interface BootstrapTableConfig {
+    id: string;
+    schema: object;
+}
+export interface BootstrapRowConfig {
+    tableId: string;
+    rowId: string;
+    data: object;
+}
+export interface BootstrapConfigShape {
+    projectName?: string;
+    branchName?: string;
+    endpoints?: Array<'REST_API' | 'GRAPHQL'>;
+    tables?: BootstrapTableConfig[];
+    rows?: BootstrapRowConfig[];
+    commitMessage?: string;
+}
+export declare function tagSchema(): object;
+export declare function faqSchema(): object;
+export declare function questSchema(): object;
+export declare function tagRows(count?: number): BootstrapRowConfig[];
+export declare function faqRows(): BootstrapRowConfig[];
+export declare function questRows(count?: number): BootstrapRowConfig[];
+export declare function bootstrapConfig(partial?: BootstrapConfigShape): BootstrapConfigShape;
+export declare function tagBootstrapConfig(projectName: string): BootstrapConfigShape;
+export declare function faqBootstrapConfig(projectName: string): BootstrapConfigShape;