From 28b4a0f776e2510f821a7c9d912c3c348857a729 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sat, 9 Mar 2024 16:10:53 +0100
Subject: [PATCH 01/48] feat: allow printing datafile per environment (#275)

---
 docs/building-datafiles.md                 |  8 ++++-
 packages/core/src/builder/buildDatafile.ts | 34 +++++++++++++++++++-
 packages/core/src/builder/buildProject.ts  | 17 +++++-----
 packages/core/src/tester/testFeature.ts    | 37 +++-------------------
 4 files changed, 53 insertions(+), 43 deletions(-)

diff --git a/docs/building-datafiles.md b/docs/building-datafiles.md
index 0633a5bb..2b7fec01 100644
--- a/docs/building-datafiles.md
+++ b/docs/building-datafiles.md
@@ -54,12 +54,18 @@ $ featurevisor build --revision 1.2.3
 
 ## Printing
 
-You can print the contents of a datafile for a single feature without writing anything to disk by passing these flags:
+You can print the contents of a datafile for a single feature in/or an environment without writing anything to disk by passing these flags:
 
 ```
 $ featurevisor build --feature=foo --environment=production --print --pretty
 ```
 
+Or if you with to print datafile containing all features for a specific environment:
+
+```
+$ featurevisor build --environment=production --print --pretty
+```
+
 This is useful primarily for debugging and testing purposes.
 
 If you are an SDK developer in other languages besides JavaScript, you may want to use this handy command to get the generated datafile content in JSON format that you can use in your own [test runner](/docs/testing).
diff --git a/packages/core/src/builder/buildDatafile.ts b/packages/core/src/builder/buildDatafile.ts
index c7ef3d49..d64d4e64 100644
--- a/packages/core/src/builder/buildDatafile.ts
+++ b/packages/core/src/builder/buildDatafile.ts
@@ -19,13 +19,45 @@ import {
   VariableSchema,
 } from "@featurevisor/types";
 
-import { ProjectConfig } from "../config";
+import { ProjectConfig, SCHEMA_VERSION } from "../config";
 import { Datasource } from "../datasource";
 import { extractAttributeKeysFromConditions, extractSegmentKeysFromGroupSegments } from "../utils";
 
 import { getTraffic } from "./traffic";
 import { getFeatureRanges } from "./getFeatureRanges";
 
+export interface CustomDatafileOptions {
+  featureKey?: string;
+  environment: string;
+  projectConfig: ProjectConfig;
+  datasource: Datasource;
+  revision?: string;
+}
+
+export async function getCustomDatafile(options: CustomDatafileOptions): Promise<DatafileContent> {
+  let featuresToInclude;
+
+  if (options.featureKey) {
+    const requiredChain = await options.datasource.getRequiredFeaturesChain(options.featureKey);
+    featuresToInclude = Array.from(requiredChain);
+  }
+
+  const existingState = await options.datasource.readState(options.environment);
+  const datafileContent = await buildDatafile(
+    options.projectConfig,
+    options.datasource,
+    {
+      schemaVersion: SCHEMA_VERSION,
+      revision: options.revision || "tester",
+      environment: options.environment,
+      features: featuresToInclude,
+    },
+    existingState,
+  );
+
+  return datafileContent;
+}
+
 export interface BuildOptions {
   schemaVersion: string;
   revision: string;
diff --git a/packages/core/src/builder/buildProject.ts b/packages/core/src/builder/buildProject.ts
index bf7164d6..1b44638a 100644
--- a/packages/core/src/builder/buildProject.ts
+++ b/packages/core/src/builder/buildProject.ts
@@ -2,8 +2,7 @@ import * as path from "path";
 
 import { SCHEMA_VERSION } from "../config";
 
-import { buildDatafile } from "./buildDatafile";
-import { getDatafileForFeature } from "../tester";
+import { buildDatafile, getCustomDatafile } from "./buildDatafile";
 import { Dependencies } from "../dependencies";
 
 export interface BuildCLIOptions {
@@ -23,20 +22,20 @@ export async function buildProject(deps: Dependencies, cliOptions: BuildCLIOptio
    * This build process does not write to disk, and prints only to stdout.
    *
    * This is ideally for test runners in other languages,
-   * when they wish to get datafile for a single feature,
+   * when they wish to get datafile for a single feature and/or environment,
    * so they can run tests against their own SDKs in other languages.
    *
    * This way we centralize the datafile generation in one place,
    * while tests can be run anywhere else.
    */
-  if (cliOptions.environment && cliOptions.feature && cliOptions.print) {
-    const datafileContent = await getDatafileForFeature(
-      cliOptions.feature,
-      cliOptions.environment,
+  if (cliOptions.environment && cliOptions.print) {
+    const datafileContent = await getCustomDatafile({
+      featureKey: cliOptions.feature,
+      environment: cliOptions.environment,
       projectConfig,
       datasource,
-      cliOptions.revision,
-    );
+      revision: cliOptions.revision,
+    });
 
     if (cliOptions.pretty) {
       console.log(JSON.stringify(datafileContent, null, 2));
diff --git a/packages/core/src/tester/testFeature.ts b/packages/core/src/tester/testFeature.ts
index 44c7456d..8c873b23 100644
--- a/packages/core/src/tester/testFeature.ts
+++ b/packages/core/src/tester/testFeature.ts
@@ -9,39 +9,12 @@ import { createInstance, MAX_BUCKETED_NUMBER } from "@featurevisor/sdk";
 
 import { Datasource } from "../datasource";
 import { ProjectConfig } from "../config";
-import { buildDatafile } from "../builder";
-import { SCHEMA_VERSION } from "../config";
+import { getCustomDatafile } from "../builder";
 
 import { checkIfArraysAreEqual } from "./checkIfArraysAreEqual";
 import { checkIfObjectsAreEqual } from "./checkIfObjectsAreEqual";
 import { getFeatureAssertionsFromMatrix } from "./matrix";
 
-export async function getDatafileForFeature(
-  featureKey: string,
-  environment: string,
-  projectConfig: ProjectConfig,
-  datasource: Datasource,
-  revision: string = "testing",
-): Promise<DatafileContent> {
-  const requiredChain = await datasource.getRequiredFeaturesChain(featureKey);
-  const featuresToInclude = Array.from(requiredChain);
-
-  const existingState = await datasource.readState(environment);
-  const datafileContent = await buildDatafile(
-    projectConfig,
-    datasource,
-    {
-      schemaVersion: SCHEMA_VERSION,
-      revision,
-      environment: environment,
-      features: featuresToInclude,
-    },
-    existingState,
-  );
-
-  return datafileContent;
-}
-
 export async function testFeature(
   datasource: Datasource,
   projectConfig: ProjectConfig,
@@ -85,12 +58,12 @@ export async function testFeature(
       const datafileContent =
         typeof datafileContentByEnvironment[assertion.environment] !== "undefined"
           ? datafileContentByEnvironment[assertion.environment]
-          : await getDatafileForFeature(
-              test.feature,
-              assertion.environment,
+          : await getCustomDatafile({
+              featureKey: test.feature,
+              environment: assertion.environment,
               projectConfig,
               datasource,
-            );
+            });
 
       if (options.showDatafile) {
         console.log("");

From 1cbcd14baff3d689a425571e72e4c8bc82888053 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Sat, 9 Mar 2024 15:13:39 +0000
Subject: [PATCH 02/48] v1.9.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 |  8 +++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 97 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c69338d2..f230c24e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+
+### Features
+
+* allow printing datafile per environment ([#275](https://github.com/featurevisor/featurevisor/issues/275)) ([28b4a0f](https://github.com/featurevisor/featurevisor/commit/28b4a0f776e2510f821a7c9d912c3c348857a729))
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index f4145eb3..de67ad03 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index e2fdee0f..7cff33dd 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.8.0"
+    "@featurevisor/cli": "^1.9.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 84f786ac..f853d33a 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index e8c03d86..b6473b7f 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.8.0"
+    "@featurevisor/cli": "^1.9.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 02e0c191..b03e783a 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index cbc20078..c9b4144d 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.8.0",
+    "@featurevisor/cli": "^1.9.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 91e8bcdd..33f23953 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 99d4978c..5afc8862 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.8.0"
+    "@featurevisor/cli": "^1.9.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index d3daabd1..1911ee52 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 8c0d9171..7aeebda1 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.8.0"
+    "@featurevisor/cli": "^1.9.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index a5746a11..61edca3e 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.8.0"
+  "version": "1.9.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 8e6b5edf..1140becb 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.8.0"
+        "@featurevisor/cli": "^1.9.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.8.0"
+        "@featurevisor/cli": "^1.9.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.8.0",
+        "@featurevisor/cli": "^1.9.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.8.0"
+        "@featurevisor/cli": "^1.9.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.8.0"
+        "@featurevisor/cli": "^1.9.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.8.0",
+        "@featurevisor/core": "^1.9.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.8.0",
+      "version": "1.9.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.3.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index d324bd1d..e6726dbe 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+**Note:** Version bump only for package @featurevisor/cli
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 7cce9e78..a9d8a983 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.8.0",
+    "@featurevisor/core": "^1.9.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 0d931bda..8c9ab45c 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
+
+
+### Features
+
+* allow printing datafile per environment ([#275](https://github.com/featurevisor/featurevisor/issues/275)) ([28b4a0f](https://github.com/featurevisor/featurevisor/commit/28b4a0f776e2510f821a7c9d912c3c348857a729))
+
+
+
+
+
 # [1.8.0](https://github.com/featurevisor/featurevisor/compare/v1.7.3...v1.8.0) (2024-02-26)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 249ea9cb..f0a30377 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From cefab8f8c0eb091c10bee213039920d55fa3957a Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sun, 10 Mar 2024 18:53:27 +0100
Subject: [PATCH 03/48] feat: allow showing only failed specs in test runner
 (#276)

---
 docs/testing.md                         |  8 ++++++++
 packages/cli/src/index.ts               |  1 +
 packages/core/src/tester/testProject.ts | 16 ++++++++++++++--
 3 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/docs/testing.md b/docs/testing.md
index c0643a30..1c061a13 100644
--- a/docs/testing.md
+++ b/docs/testing.md
@@ -204,6 +204,14 @@ $ featurevisor test --showDatafile
 
 Printing datafile content for each and every tested feature can be very verbose, so we recommend using this option with `--keyPattern` to filter tests.
 
+### `onlyFailures`
+
+If you are interested to see only the test specs that fail:
+
+```
+$ featurevisor test --onlyFailures
+```
+
 ### `fast`
 
 By default, Featurevisor's test runner would generate a datafile for your feature against the desired environment for each assertion.
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index b58c75c5..830c0fb5 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -149,6 +149,7 @@ async function main() {
           verbose: options.verbose || false,
           showDatafile: options.showDatafile || false,
           fast: options.fast || false,
+          onlyFailures: options.onlyFailures || false,
         };
 
         const hasError = await testProject(deps, testOptions);
diff --git a/packages/core/src/tester/testProject.ts b/packages/core/src/tester/testProject.ts
index 479a563f..9bafdf5b 100644
--- a/packages/core/src/tester/testProject.ts
+++ b/packages/core/src/tester/testProject.ts
@@ -17,6 +17,7 @@ export interface TestProjectOptions {
   assertionPattern?: string;
   verbose?: boolean;
   showDatafile?: boolean;
+  onlyFailures?: boolean;
   fast?: boolean;
 }
 
@@ -88,7 +89,15 @@ export async function executeTest(
     );
   }
 
-  printTestResult(testResult, testFilePath, rootDirectoryPath);
+  if (!options.onlyFailures) {
+    // show all
+    printTestResult(testResult, testFilePath, rootDirectoryPath);
+  } else {
+    // show failed only
+    if (!testResult.passed) {
+      printTestResult(testResult, testFilePath, rootDirectoryPath);
+    }
+  }
 
   if (!testResult.passed) {
     executionResult.passed = false;
@@ -185,7 +194,10 @@ export async function testProject(
 
   const diffInMs = Date.now() - startTime;
 
-  console.log("\n---\n");
+  if (options.onlyFailures !== true || hasError) {
+    console.log("\n---");
+  }
+  console.log("");
 
   const testSpecsMessage = `Test specs: ${passedTestsCount} passed, ${failedTestsCount} failed`;
   const testAssertionsMessage = `Assertions: ${passedAssertionsCount} passed, ${failedAssertionsCount} failed`;

From d64bb9d1e56a7e1f776d66a70284f894128a7cfe Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Sun, 10 Mar 2024 17:56:11 +0000
Subject: [PATCH 04/48] v1.10.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f230c24e..19c101ea 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+
+### Features
+
+* allow showing only failed specs in test runner ([#276](https://github.com/featurevisor/featurevisor/issues/276)) ([cefab8f](https://github.com/featurevisor/featurevisor/commit/cefab8f8c0eb091c10bee213039920d55fa3957a))
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index de67ad03..ddfd3fc0 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 7cff33dd..2124364d 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.9.0"
+    "@featurevisor/cli": "^1.10.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index f853d33a..58296cd8 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index b6473b7f..e49232b6 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.9.0"
+    "@featurevisor/cli": "^1.10.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index b03e783a..f0d67426 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index c9b4144d..baf6e1fe 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.9.0",
+    "@featurevisor/cli": "^1.10.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 33f23953..529e5de3 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 5afc8862..87ef0ae0 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.9.0"
+    "@featurevisor/cli": "^1.10.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 1911ee52..bc74df7e 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 7aeebda1..c3149a1f 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.9.0"
+    "@featurevisor/cli": "^1.10.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index 61edca3e..211e22bb 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.9.0"
+  "version": "1.10.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 1140becb..d6b499c9 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.9.0"
+        "@featurevisor/cli": "^1.10.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.9.0"
+        "@featurevisor/cli": "^1.10.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.9.0",
+        "@featurevisor/cli": "^1.10.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.9.0"
+        "@featurevisor/cli": "^1.10.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.9.0"
+        "@featurevisor/cli": "^1.10.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.9.0",
+        "@featurevisor/core": "^1.10.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.3.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index e6726dbe..d70ce192 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+
+### Features
+
+* allow showing only failed specs in test runner ([#276](https://github.com/featurevisor/featurevisor/issues/276)) ([cefab8f](https://github.com/featurevisor/featurevisor/commit/cefab8f8c0eb091c10bee213039920d55fa3957a))
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 **Note:** Version bump only for package @featurevisor/cli
diff --git a/packages/cli/package.json b/packages/cli/package.json
index a9d8a983..957b161f 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.9.0",
+    "@featurevisor/core": "^1.10.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 8c9ab45c..3815780c 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
+
+
+### Features
+
+* allow showing only failed specs in test runner ([#276](https://github.com/featurevisor/featurevisor/issues/276)) ([cefab8f](https://github.com/featurevisor/featurevisor/commit/cefab8f8c0eb091c10bee213039920d55fa3957a))
+
+
+
+
+
 # [1.9.0](https://github.com/featurevisor/featurevisor/compare/v1.8.0...v1.9.0) (2024-03-09)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index f0a30377..4fed1a42 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From 1e46d7992a632ce956e8821dbaae9677bef59a43 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sun, 10 Mar 2024 19:16:00 +0100
Subject: [PATCH 05/48] fix: init command (#277)

---
 packages/cli/src/index.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 830c0fb5..c56395b3 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -44,8 +44,9 @@ function requireAndGetProjectConfig(rootDirectoryPath) {
   return getProjectConfig(rootDirectoryPath);
 }
 
+const rootDirectoryPath = process.cwd();
+
 async function getDependencies(options): Promise<Dependencies> {
-  const rootDirectoryPath = process.cwd();
   const projectConfig = requireAndGetProjectConfig(rootDirectoryPath);
   const datasource = new Datasource(projectConfig, rootDirectoryPath);
 
@@ -67,8 +68,7 @@ async function main() {
     .command({
       command: "init",
       handler: async function (options) {
-        const deps = await getDependencies(options);
-        const hasError = await initProject(deps.rootDirectoryPath, options.example);
+        const hasError = await initProject(rootDirectoryPath, options.example);
 
         if (hasError) {
           process.exit(1);

From bd13be0f41f544340ee68f92d5c9661e3399f3f3 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Sun, 10 Mar 2024 18:18:35 +0000
Subject: [PATCH 06/48] v1.10.1

---
 CHANGELOG.md                              | 11 +++++++++++
 examples/example-1/CHANGELOG.md           |  8 ++++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 ++++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 ++++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 ++++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 ++++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 22 +++++++++++-----------
 packages/cli/CHANGELOG.md                 | 11 +++++++++++
 packages/cli/package.json                 |  2 +-
 15 files changed, 85 insertions(+), 23 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 19c101ea..cd787c00 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+
+### Bug Fixes
+
+* init command ([#277](https://github.com/featurevisor/featurevisor/issues/277)) ([1e46d79](https://github.com/featurevisor/featurevisor/commit/1e46d7992a632ce956e8821dbaae9677bef59a43))
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index ddfd3fc0..c66df284 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 2124364d..19912369 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.0"
+    "@featurevisor/cli": "^1.10.1"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 58296cd8..63b88f91 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index e49232b6..196608aa 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.0"
+    "@featurevisor/cli": "^1.10.1"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index f0d67426..b99e0ea8 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index baf6e1fe..d2b11624 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.0",
+    "@featurevisor/cli": "^1.10.1",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 529e5de3..0b097605 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 87ef0ae0..aba640b4 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.0"
+    "@featurevisor/cli": "^1.10.1"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index bc74df7e..306b9907 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index c3149a1f..133b9fc9 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.0"
+    "@featurevisor/cli": "^1.10.1"
   }
 }
diff --git a/lerna.json b/lerna.json
index 211e22bb..21526b64 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.10.0"
+  "version": "1.10.1"
 }
diff --git a/package-lock.json b/package-lock.json
index d6b499c9..e4ca5104 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.10.0",
+      "version": "1.10.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.0"
+        "@featurevisor/cli": "^1.10.1"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.10.0",
+      "version": "1.10.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.0"
+        "@featurevisor/cli": "^1.10.1"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.10.0",
+      "version": "1.10.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.0",
+        "@featurevisor/cli": "^1.10.1",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.10.0",
+      "version": "1.10.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.0"
+        "@featurevisor/cli": "^1.10.1"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.10.0",
+      "version": "1.10.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.0"
+        "@featurevisor/cli": "^1.10.1"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,7 +18779,7 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.10.0",
+      "version": "1.10.1",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/core": "^1.10.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index d70ce192..a16ff64e 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
+
+
+### Bug Fixes
+
+* init command ([#277](https://github.com/featurevisor/featurevisor/issues/277)) ([1e46d79](https://github.com/featurevisor/featurevisor/commit/1e46d7992a632ce956e8821dbaae9677bef59a43))
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 957b161f..95ff170d 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",

From 6a175d1be01c1ab78661bbd93d535de69af47135 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sun, 10 Mar 2024 19:42:03 +0100
Subject: [PATCH 07/48] feat: revisioning info moved to its own file (#274)

---
 README.md                                     | 14 ++---
 docs/building-datafiles.md                    |  8 +--
 docs/cli.md                                   | 42 +++++++-------
 docs/code-generation.md                       |  2 +-
 docs/deployment.md                            | 22 +++----
 docs/integrations/cloudflare-pages.md         | 47 +++++++--------
 docs/integrations/github-actions.md           | 57 +++++++++++--------
 docs/linting.md                               |  6 +-
 docs/quick-start.md                           | 28 +++------
 docs/site.md                                  |  4 +-
 docs/state-files.md                           |  2 +-
 docs/testing.md                               | 14 ++---
 docs/use-cases/microfrontends.md              |  2 +-
 packages/cli/README.md                        | 24 ++++----
 packages/core/src/builder/buildProject.ts     | 18 ++++--
 packages/core/src/builder/revision.spec.ts    | 22 +++++++
 packages/core/src/builder/revision.ts         | 22 +++++++
 packages/core/src/datasource/adapter.ts       |  4 ++
 packages/core/src/datasource/datasource.ts    | 11 ++++
 .../core/src/datasource/filesystemAdapter.ts  | 39 +++++++++++++
 20 files changed, 237 insertions(+), 151 deletions(-)
 create mode 100644 packages/core/src/builder/revision.spec.ts
 create mode 100644 packages/core/src/builder/revision.ts

diff --git a/README.md b/README.md
index 071fe937..245ac781 100644
--- a/README.md
+++ b/README.md
@@ -102,17 +102,13 @@ The whole process can be broken down into 3 steps:
 
 ## Step 1: Create a Featurevisor project
 
-Install Featurevisor CLI globally (or use `npx @featurevisor/cli`):
-
-```
-$ npm install -g @featurevisor/cli
-```
-
-Initialize a new Featurevisor project:
+Use `npx` to scaffold a new Featurevisor project:
 
 ```
 $ mkdir my-featurevisor-project && cd my-featurevisor-project
-$ featurevisor init
+
+$ npx @featurevisor/cli init
+$ npm install
 ```
 
 You can now create and manage your feature flags, experiments, and remote config in this directory expressed as YAMLs.
@@ -128,7 +124,7 @@ See the building block guides here:
 Once the project is ready, you can build your datafiles (JSON files containing configuration of your feature flags):
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 You will find the output in `dist` directory, that you can upload to your CDN.
diff --git a/docs/building-datafiles.md b/docs/building-datafiles.md
index 2b7fec01..623cbb93 100644
--- a/docs/building-datafiles.md
+++ b/docs/building-datafiles.md
@@ -10,7 +10,7 @@ Datafiles are JSON files that are created against combinations of tags and envir
 Use Featurevisor CLI to build your datafiles:
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 ## Output
@@ -49,7 +49,7 @@ By default, Featurevisor will use the `version` as exists in `package.json` of t
 You can optionally customize the `revision` value in datafiles by passing a `--revision` flag when building:
 
 ```
-$ featurevisor build --revision 1.2.3
+$ npx featurevisor build --revision 1.2.3
 ```
 
 ## Printing
@@ -57,13 +57,13 @@ $ featurevisor build --revision 1.2.3
 You can print the contents of a datafile for a single feature in/or an environment without writing anything to disk by passing these flags:
 
 ```
-$ featurevisor build --feature=foo --environment=production --print --pretty
+$ npx featurevisor build --feature=foo --environment=production --print --pretty
 ```
 
 Or if you with to print datafile containing all features for a specific environment:
 
 ```
-$ featurevisor build --environment=production --print --pretty
+$ npx featurevisor build --environment=production --print --pretty
 ```
 
 This is useful primarily for debugging and testing purposes.
diff --git a/docs/cli.md b/docs/cli.md
index 0b7474d5..d7ab4eb4 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -8,33 +8,29 @@ Beyond just initializing a project and building datafiles, Featurevisor CLI can
 
 ## Installation
 
-Install with `npm`:
+Use `npx` to initialize a project first:
 
 ```
-$ npm install -g @featurevisor/cli
+$ mkdir my-featurevisor-project && cd my-featurevisor-project
+$ npx @featurevisor/cli init
 ```
 
-Or use `npx` to run the CLI without installing it:
+If you wish to initialize a specific example as available in the [monorepo](https://github.com/featurevisor/featurevisor/tree/main/examples):
 
 ```
-$ npx @featurevisor/cli <command>
+$ npx @featurevisor/cli init --example <name>
 ```
 
-Rest of the documentation assumes that you have installed the CLI globally.
-
-## Initializing a project
-
-Scaffold a new project in your working directory:
+After you have installed the dependencies in the project:
 
 ```
-$ mkdir my-project && cd my-project
-$ featurevisor init
-```
+$ npm install
+``
 
-If you wish to initialize a specific example as available in the [monorepo](https://github.com/featurevisor/featurevisor/tree/main/examples):
+You can access the Featurevisor CLI from inside the project via:
 
 ```
-$ featurevisor init --example <name>
+$ npx featurevisor
 ```
 
 Learn more in [Quick start](/docs/quick-start).
@@ -44,7 +40,7 @@ Learn more in [Quick start](/docs/quick-start).
 Check if the YAML files have any syntax or structural errors:
 
 ```
-$ featurevisor lint
+$ npx featurevisor lint
 ```
 
 Lear more in [Linting](/docs/linting).
@@ -54,7 +50,7 @@ Lear more in [Linting](/docs/linting).
 Generate JSON files on a per environment and tag combination as exists in project [configuration](/docs/configuration):
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 Learn more in [Building datafiles](/docs/building-datafiles).
@@ -64,7 +60,7 @@ Learn more in [Building datafiles](/docs/building-datafiles).
 Test your features and segments:
 
 ```
-$ featurevisor test
+$ npx featurevisor test
 ```
 
 Learn more in [Testing](/docs/testing).
@@ -76,7 +72,7 @@ Building datafiles also generates [state files](/docs/state-files).
 To restore them to last known state in Git, run:
 
 ```
-$ featurevisor restore
+$ npx featurevisor restore
 ```
 
 ## Generate static site
@@ -84,19 +80,19 @@ $ featurevisor restore
 Build the site:
 
 ```
-$ featurevisor site export
+$ npx featurevisor site export
 ```
 
 Serve the built site (defaults to port 3000):
 
 ```
-$ featurevisor site serve
+$ npx featurevisor site serve
 ```
 
 Serve it in a specific port:
 
 ```
-$ featurevisor site serve -p 3000
+$ npx featurevisor site serve -p 3000
 ```
 
 Learn more in [Status site](/docs/status-site).
@@ -107,7 +103,7 @@ Learn more in [Status site](/docs/status-site).
 Generate TypeScript code from your YAMLs:
 
 ```
-$ featurevisor generate-code --language typescript --out-dir ./src
+$ npx featurevisor generate-code --language typescript --out-dir ./src
 ```
 
 See output in `./src` directory.
@@ -121,5 +117,5 @@ It is possible to end up with multiple segments having same conditions in larger
 We can find these duplicates early on by running:
 
 ```
-$ featurevisor find-duplicate-segments
+$ npx featurevisor find-duplicate-segments
 ```
diff --git a/docs/code-generation.md b/docs/code-generation.md
index cffa8002..8391989d 100644
--- a/docs/code-generation.md
+++ b/docs/code-generation.md
@@ -27,7 +27,7 @@ Support for other languages is planned in future, as Featurevisor SDK becomes av
 From the root of your Featurevisor project directory, use the [CLI](/docs/cli) for generating code in a specified directory:
 
 ```
-$ featurevisor generate-code --language typescript --out-dir ./src
+$ npx featurevisor generate-code --language typescript --out-dir ./src
 ```
 
 The generated files can be found in `./src` directory.
diff --git a/docs/deployment.md b/docs/deployment.md
index 92ceab15..f7074c63 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -11,36 +11,36 @@ We recommend that you set up a CI/CD pipeline to automate the build and deployme
 
 When a new Pull Request (branch) is merged, the CI/CD pipeline should:
 
-### Lint your files
+### Linting
 
 Lint all the attributes, segments, and feature definitions:
 
 ```
-$ fearurevisor lint
+$ npx featurevisor lint
 ```
 
-### Version your project
+### Testing
+
+Test all the features and segments:
 
 ```
-$ npm version patch
+$ npx featurevisor test
 ```
 
-The new `version` value as available in `package.json` file will be used when building datafiles.
-
 ### Build the datafiles
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 ### Commit the state files
 
 ```
-$ git add .
-$ git commit -m "State files"
+$ git add .featurevisor/*
+$ git commit -m "[skip ci] Revision $(cat .featurevisor/REVISION)"
 ```
 
-Only the state files should be committed as available under `.featurevisor` directory. The generated datafiles in `dist` directory are ignored.
+Only the [state files](/docs/state-files) should be committed as available under `.featurevisor` directory. The generated datafiles in `dist` directory are ignored from Git.
 
 ### Upload to your CDN
 
@@ -53,7 +53,7 @@ You can use the `dist` directory as the root directory for your CDN.
 We want to make sure the next Pull Request merge will be on top of the latest version and state files.
 
 ```
-$ git push origin main --tags
+$ git push origin main
 ```
 
 If any of the steps above fail, the CI/CD pipeline should stop and notify the team.
diff --git a/docs/integrations/cloudflare-pages.md b/docs/integrations/cloudflare-pages.md
index 864430c9..3e53adea 100644
--- a/docs/integrations/cloudflare-pages.md
+++ b/docs/integrations/cloudflare-pages.md
@@ -14,15 +14,11 @@ This guide assumes you have created a new Featurevisor project using the CLI:
 
 ```
 $ mkdir my-featurevisor-project && cd my-featurevisor-project
+
 $ npx @featurevisor/cli init
+$ npm install
 ```
 
-The initialized project will already contain the npm scripts for linting, building, and testing your project:
-
-- `lint`: `featurevisor lint`
-- `build`: `featurevisor build`
-- `test`: `featurevisor test`
-
 ## Cloudflare Pages
 
 We are going to be uploading to and serving our datafiles from [Cloudflare Pages](https://pages.cloudflare.com/).
@@ -78,13 +74,13 @@ jobs:
         run: npm ci
 
       - name: Lint
-        run: npm run lint
-
-      - name: Build
-        run: npm run build
+        run: npx featurevisor lint
 
       - name: Test specs
-        run: npm test
+        run: npx featurevisor test
+
+      - name: Build
+        run: npx featurevisor build
 ```
 
 ### Publish
@@ -117,21 +113,13 @@ jobs:
         run: npm ci
 
       - name: Lint
-        run: npm run lint
-
-      - name: Git configs
-        run: |
-          git config user.name "${{ github.actor }}"
-          git config user.email "${{ github.actor }}@users.noreply.github.com"
+        run: npx featurevisor lint
 
-      - name: Version
-        run: npm version patch
+      - name: Test specs
+        run: npx featurevisor test
 
       - name: Build
-        run: npm run build
-
-      - name: Test specs
-        run: npm test
+        run: npx featurevisor build
 
       - name: Upload to Cloudflare Pages
         run: |
@@ -141,10 +129,15 @@ jobs:
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
 
+      - name: Git configs
+        run: |
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor }}@users.noreply.github.com"
+
       - name: Push back to origin
         run: |
           git add .featurevisor/*
-          git commit --amend --no-edit
+          git commit -m "[skip ci] Revision $(cat .featurevisor/REVISION)"
           git push
 ```
 
@@ -154,8 +147,12 @@ Once uploaded, the your datafiles will be accessible as: `https://<your-project>
 
 You may want to take it a step further by setting up custom domains (or subdomains) for your Cloudflare Pages project. Otherwise, you are good to go.
 
-Learn how too consume datafiles from URLs directly using [SDKs](/docs/sdks).
+Learn how to consume datafiles from URLs directly using [SDKs](/docs/sdks).
 
 ## Full example
 
 You can find a fully functional repository based on this guide here: [https://github.com/featurevisor/featurevisor-example-cloudflare](https://github.com/featurevisor/featurevisor-example-cloudflare).
+
+## Sequential builds
+
+In case you are worried about simultaneous builds triggered by multiple Pull Requests merged in quick succession, you can learn about mitigating any unintended issues [here](/docs/integrations/github-actions/#sequential-builds).
diff --git a/docs/integrations/github-actions.md b/docs/integrations/github-actions.md
index e1ae40bc..c2db331c 100644
--- a/docs/integrations/github-actions.md
+++ b/docs/integrations/github-actions.md
@@ -14,15 +14,11 @@ This guide assumes you have created a new Featurevisor project using the CLI:
 
 ```
 $ mkdir my-featurevisor-project && cd my-featurevisor-project
+
 $ npx @featurevisor/cli init
+$ npm install
 ```
 
-The initialized project will already contain the npm scripts for linting, building, and testing your project:
-
-- `lint`: `featurevisor lint`
-- `build`: `featurevisor build`
-- `test`: `featurevisor test`
-
 ## Repository settings
 
 Make sure you have `Read and write permissions` enabled in your GitHub repository's `Settings > Actions > General > Workflow permissions` section.
@@ -63,13 +59,13 @@ jobs:
         run: npm ci
 
       - name: Lint
-        run: npm run lint
-
-      - name: Build
-        run: npm run build
+        run: npx featurevisor lint
 
       - name: Test specs
-        run: npm test
+        run: npx featurevisor test
+
+      - name: Build
+        run: npx featurevisor build
 ```
 
 ### Publish
@@ -102,33 +98,46 @@ jobs:
         run: npm ci
 
       - name: Lint
-        run: npm run lint
+        run: npx featurevisor lint
 
-      - name: Git configs
-        run: |
-          git config user.name "${{ github.actor }}"
-          git config user.email "${{ github.actor }}@users.noreply.github.com"
-
-      - name: Version
-        run: npm version patch
+      - name: Test specs
+        run: npx featurevisor test
 
       - name: Build
-        run: npm run build
-
-      - name: Test specs
-        run: npm test
+        run: npx featurevisor build
 
       - name: Upload datafiles
         run: echo "Uploading..."
         # Update it accordingly based on your CDN set up
 
+      - name: Git configs
+        run: |
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor }}@users.noreply.github.com"
+
       - name: Push back to origin
         run: |
           git add .featurevisor/*
-          git commit --amend --no-edit
+          git commit -m "[skip ci] Revision $(cat .featurevisor/REVISION)"
           git push
 ```
 
 After generating new datafiles and uploading them, the workflow will also take care of pushing the Featurevisor [state files](/docs/state-files) back to the repository, so that future builds will be built on top of latest state.
 
 If you want an example of an actual uploading step, see [Cloudflare Pages](/docs/integrations/cloudflare-pages/) integration guide.
+
+## Sequential builds
+
+It is possible you might want to run the publish workflow sequentially for every merged Pull Requests, in case multiple Pull Requests are merged in quick succession.
+
+### Queue
+
+You can consider using [softprops/turnstyle](https://github.com/softprops/turnstyle) GitHub Action to run publish workflow of all your merged Pull Requests sequentially.
+
+### Branch protection rules
+
+Next to it, you can also make it stricter by requiring all Pull Request authors to have their branches up to date from latest main branch before merging:
+
+- [Managing suggestions to update pull request branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-suggestions-to-update-pull-request-branches)
+- [Create branch protection rule](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule#creating-a-branch-protection-rule) (see #7)
+  -  Require branches to be up to date before merging
diff --git a/docs/linting.md b/docs/linting.md
index 9ee85129..8a690376 100644
--- a/docs/linting.md
+++ b/docs/linting.md
@@ -10,7 +10,7 @@ Featurevisor provides a CLI command to lint your definition files, making sure t
 Run:
 
 ```
-$ featurevisor lint
+$ npx featurevisor lint
 ```
 
 And it will show you the errors in your definition files, if any.
@@ -24,7 +24,7 @@ If any errors are found, it will terminate with a non-zero exit code.
 You can also filter keys using regex patterns:
 
 ```
-$ featurevisor lint --keyPattern="myKeyHere"
+$ npx featurevisor lint --keyPattern="myKeyHere"
 ```
 
 ### `entityType`
@@ -32,7 +32,7 @@ $ featurevisor lint --keyPattern="myKeyHere"
 If you want to filter it down further by entity type:
 
 ```
-$ featurevisor lint --keyPattern="myKeyHere" --entityType="feature"
+$ npx featurevisor lint --keyPattern="myKeyHere" --entityType="feature"
 ```
 
 Possible values for `--entityType`:
diff --git a/docs/quick-start.md b/docs/quick-start.md
index 4367193f..f65e591a 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -8,20 +8,6 @@ ogImage: /img/og/docs-quick-start.png
 
 - [Node.js](https://nodejs.org/en/) >= 16.0.0
 
-## Installation
-
-Easiest way to get started is by using the Featurevisor CLI.
-
-```
-$ npm install -g @featurevisor/cli
-```
-
-If you want to avoid global installation, you can use `npx` instead:
-
-```
-$ npx @featurevisor/cli <command>
-```
-
 ## Initialize your project
 
 This is meant to be a completely separate repository from your application code.
@@ -31,21 +17,21 @@ The idea is to be able to decouple your application deployments from releasing y
 Run the following command to initialize your project:
 
 ```
-$ mkdir my-project && cd my-project
-$ featurevisor init
+$ mkdir my-featurevisor-project && cd my-featurevisor-project
+$ npx @featurevisor/cli init
 ```
 
 If you want to initialize a specific example:
 
 ```
-$ featurevisor init --example <name>
+$ npx @featurevisor/cli init --example <name>
 ```
 
 You can find all available examples [here](/docs/examples).
 
-## Dependencies
+## Installation
 
-We start by installing all the necessary local dependencies:
+Once your project has been initialized, install all the dependencies:
 
 ```
 $ npm install
@@ -153,7 +139,7 @@ environments:
 We can lint the content of all our files to make sure they are all valid:
 
 ```
-$ featurevisor lint
+$ npx featurevisor lint
 ```
 
 Learn more in [Linting](/docs/linting).
@@ -165,7 +151,7 @@ Datafiles are JSON files that we expect our client-side applications to consume
 Now that we have all the configuration in place, we can build the project:
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 This will generate datafiles in the `dist` directory for each of your tags against each environment as defined in your `featurevisor.config.js` file.
diff --git a/docs/site.md b/docs/site.md
index b9c77251..b75ea622 100644
--- a/docs/site.md
+++ b/docs/site.md
@@ -24,7 +24,7 @@ The git repo also needs to have an `origin` remote set up, in order for the edit
 Use Featurevisor CLI:
 
 ```
-$ featurevisor site export
+$ npx featurevisor site export
 ```
 
 The generated static site will be available in the `out` directory.
@@ -34,7 +34,7 @@ The generated static site will be available in the `out` directory.
 Run:
 
 ```
-$ featurevisor site serve
+$ npx featurevisor site serve
 ```
 
 ## Screenshots
diff --git a/docs/state-files.md b/docs/state-files.md
index 7a5f0570..f9ac9406 100644
--- a/docs/state-files.md
+++ b/docs/state-files.md
@@ -22,7 +22,7 @@ We will learn more about it in [Deployment](/docs/deployment).
 If you have already built your datafiles, you can restore the state files to the last known state in Git by running:
 
 ```
-$ featurevisor restore
+$ npx featurevisor restore
 ```
 
 This will only work if the state files already exist in the Git repository.
diff --git a/docs/testing.md b/docs/testing.md
index 1c061a13..0d8db677 100644
--- a/docs/testing.md
+++ b/docs/testing.md
@@ -163,7 +163,7 @@ This helps us cover more scenarios by having to write less code in our specs.
 Use the Featurevisor CLI to run your tests:
 
 ```
-$ featurevisor test
+$ npx featurevisor test
 ```
 
 If any of your assertions fail in any test specs, it will terminate with a non-zero exit code.
@@ -175,7 +175,7 @@ If any of your assertions fail in any test specs, it will terminate with a non-z
 You can also filter tests by feature or segment keys using regex patterns:
 
 ```
-$ featurevisor test --keyPattern="myKeyHere"
+$ npx featurevisor test --keyPattern="myKeyHere"
 ```
 
 ### `assertionPattern`
@@ -183,7 +183,7 @@ $ featurevisor test --keyPattern="myKeyHere"
 If you are writing assertion descriptions, then you can filter them further using regex patterns:
 
 ```
-$ featurevisor test --keyPattern="myKeyHere" --assertionPattern="text..."
+$ npx featurevisor test --keyPattern="myKeyHere" --assertionPattern="text..."
 ```
 
 ### `verbose`
@@ -191,7 +191,7 @@ $ featurevisor test --keyPattern="myKeyHere" --assertionPattern="text..."
 For debugging purposes, you can enable verbose mode to see more details of your assertion evaluations
 
 ```
-$ featurevisor test --verbose
+$ npx featurevisor test --verbose
 ```
 
 ### `showDatafile`
@@ -199,7 +199,7 @@ $ featurevisor test --verbose
 For more advanced debugging, you can print the datafile content used by test runner:
 
 ```
-$ featurevisor test --showDatafile
+$ npx featurevisor test --showDatafile
 ```
 
 Printing datafile content for each and every tested feature can be very verbose, so we recommend using this option with `--keyPattern` to filter tests.
@@ -209,7 +209,7 @@ Printing datafile content for each and every tested feature can be very verbose,
 If you are interested to see only the test specs that fail:
 
 ```
-$ featurevisor test --onlyFailures
+$ npx featurevisor test --onlyFailures
 ```
 
 ### `fast`
@@ -219,7 +219,7 @@ By default, Featurevisor's test runner would generate a datafile for your featur
 If you have a lot of tests, this can be time-consuming. You can use the `--fast` option to generate datafiles for each environment early packing all the features in the project together, and then run the assertions:
 
 ```
-$ featurevisor test --fast
+$ npx featurevisor test --fast
 ```
 
 **Note**: This approach is memory intensive and therefore not the default behaviour yet.
diff --git a/docs/use-cases/microfrontends.md b/docs/use-cases/microfrontends.md
index f7f5dbc7..d5d1fe05 100644
--- a/docs/use-cases/microfrontends.md
+++ b/docs/use-cases/microfrontends.md
@@ -102,7 +102,7 @@ module.exports = {
 Once this configuration is in place, we can [build](/docs/building-datafiles) our datafiles:
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 And it will output the following datafiles in the `dist` directory:
diff --git a/packages/cli/README.md b/packages/cli/README.md
index 80c3792b..75fe1679 100644
--- a/packages/cli/README.md
+++ b/packages/cli/README.md
@@ -7,13 +7,7 @@ Visit [https://featurevisor.com/docs/cli](https://featurevisor.com/docs/cli) for
 ## Installation
 
 ```
-$ npm install -g @featurevisor/cli
-```
-
-Or via `npx`:
-
-```
-$ npx featurevisor <command>
+$ npm install --save-dev @featurevisor/cli
 ```
 
 ## Usage
@@ -23,13 +17,15 @@ $ npx featurevisor <command>
 Initialize your project.
 
 ```
-$ featurevisor init
+$ mkdir my-featurevisor-project && cd my-featurevisor-project
+$ npx @featurevisor/cli init
+$ npm install
 ```
 
 If you want to initialize your project with a specific example:
 
 ```
-$ featurevisor init --example <name>
+$ npx @featurevisor/cli init --example <name>
 ```
 
 Examples found [here](../../examples).
@@ -39,7 +35,7 @@ Examples found [here](../../examples).
 Check if your YAMLs are valid.
 
 ```
-$ featurevisor lint
+$ npx featurevisor lint
 ```
 
 
@@ -48,7 +44,7 @@ $ featurevisor lint
 Build your datafiles.
 
 ```
-$ featurevisor build
+$ npx featurevisor build
 ```
 
 ### `test`
@@ -56,7 +52,7 @@ $ featurevisor build
 Test your generated datafiles using the SDK, against specs written in YAMLs.
 
 ```
-$ featurevisor test
+$ npx featurevisor test
 ```
 
 See test specs in YAMLs [here](../../examples/example-1/tests) for inspiration.
@@ -66,8 +62,8 @@ See test specs in YAMLs [here](../../examples/example-1/tests) for inspiration.
 Start a local server to view your project's site.
 
 ```
-$ featurevisor site export
-$ featurevisor site serve
+$ npx featurevisor site export
+$ npx featurevisor site serve
 ```
 
 ## License
diff --git a/packages/core/src/builder/buildProject.ts b/packages/core/src/builder/buildProject.ts
index 1b44638a..34fd9df3 100644
--- a/packages/core/src/builder/buildProject.ts
+++ b/packages/core/src/builder/buildProject.ts
@@ -1,7 +1,6 @@
-import * as path from "path";
-
 import { SCHEMA_VERSION } from "../config";
 
+import { getNextRevision } from "./revision";
 import { buildDatafile, getCustomDatafile } from "./buildDatafile";
 import { Dependencies } from "../dependencies";
 
@@ -16,7 +15,7 @@ export interface BuildCLIOptions {
 }
 
 export async function buildProject(deps: Dependencies, cliOptions: BuildCLIOptions = {}) {
-  const { rootDirectoryPath, projectConfig, datasource } = deps;
+  const { projectConfig, datasource } = deps;
 
   /**
    * This build process does not write to disk, and prints only to stdout.
@@ -52,7 +51,11 @@ export async function buildProject(deps: Dependencies, cliOptions: BuildCLIOptio
   const tags = projectConfig.tags;
   const environments = projectConfig.environments;
 
-  const pkg = require(path.join(rootDirectoryPath, "package.json"));
+  const currentRevision = await datasource.readRevision();
+  console.log("\nCurrent revision:", currentRevision);
+
+  const nextRevision =
+    (cliOptions.revision && cliOptions.revision.toString()) || getNextRevision(currentRevision);
 
   for (const environment of environments) {
     console.log(`\nBuilding datafiles for environment: ${environment}`);
@@ -67,7 +70,7 @@ export async function buildProject(deps: Dependencies, cliOptions: BuildCLIOptio
         datasource,
         {
           schemaVersion: SCHEMA_VERSION,
-          revision: cliOptions.revision || pkg.version,
+          revision: nextRevision,
           environment: environment,
           tag: tag,
         },
@@ -83,5 +86,10 @@ export async function buildProject(deps: Dependencies, cliOptions: BuildCLIOptio
 
     // write state for environment
     await datasource.writeState(environment, existingState);
+
+    // write revision
+    await datasource.writeRevision(nextRevision);
   }
+
+  console.log("\nLatest revision:", nextRevision);
 }
diff --git a/packages/core/src/builder/revision.spec.ts b/packages/core/src/builder/revision.spec.ts
new file mode 100644
index 00000000..f573409b
--- /dev/null
+++ b/packages/core/src/builder/revision.spec.ts
@@ -0,0 +1,22 @@
+import { getNextRevision } from "./revision";
+
+describe("core: Revision", function () {
+  it("should be a function", function () {
+    expect(typeof getNextRevision).toEqual("function");
+  });
+
+  it("should return next version number", function () {
+    // string-string
+    expect(getNextRevision("")).toEqual("1");
+    expect(getNextRevision("random text")).toEqual("1");
+
+    // string-numeric
+    expect(getNextRevision("1")).toEqual("2");
+    expect(getNextRevision("2024")).toEqual("2025");
+
+    // string-semver
+    expect(getNextRevision("1.0.0")).toEqual("1");
+    expect(getNextRevision("0.0.0")).toEqual("1");
+    expect(getNextRevision("0.0.1523")).toEqual("1524");
+  });
+});
diff --git a/packages/core/src/builder/revision.ts b/packages/core/src/builder/revision.ts
new file mode 100644
index 00000000..b96a09e8
--- /dev/null
+++ b/packages/core/src/builder/revision.ts
@@ -0,0 +1,22 @@
+export function getNextRevision(currentRevision: string) {
+  // If the string is empty or can't be parsed with parseInt(), return "1".
+  if (!currentRevision || isNaN(parseInt(currentRevision, 10))) {
+    return "1";
+  }
+
+  // If the string is like an integer, increment it by 1 and return the value.
+  if (currentRevision.indexOf(".") === -1) {
+    return (parseInt(currentRevision, 10) + 1).toString();
+  }
+
+  // If the string is a semver, parse the patch version out of it, increment it by one and return it.
+  const parts = currentRevision.split(".");
+  const lastPart = parseInt(parts[parts.length - 1], 10);
+
+  if (!isNaN(lastPart)) {
+    return (lastPart + 1).toString();
+  }
+
+  // If the string can't be parsed as a semver, return "1".
+  return "1";
+}
diff --git a/packages/core/src/datasource/adapter.ts b/packages/core/src/datasource/adapter.ts
index a1b4ed28..970006db 100644
--- a/packages/core/src/datasource/adapter.ts
+++ b/packages/core/src/datasource/adapter.ts
@@ -29,6 +29,10 @@ export abstract class Adapter {
   abstract readDatafile(options: DatafileOptions): Promise<DatafileContent>;
   abstract writeDatafile(datafileContent: DatafileContent, options: DatafileOptions): Promise<void>;
 
+  // revision
+  abstract readRevision(): Promise<string>;
+  abstract writeRevision(revision: string): Promise<void>;
+
   // history
   abstract listHistoryEntries(entityType?: EntityType, entityKey?: string): Promise<HistoryEntry[]>;
   abstract readCommit(
diff --git a/packages/core/src/datasource/datasource.ts b/packages/core/src/datasource/datasource.ts
index 182c4b8f..584df3d4 100644
--- a/packages/core/src/datasource/datasource.ts
+++ b/packages/core/src/datasource/datasource.ts
@@ -40,6 +40,17 @@ export class Datasource {
     return this.adapter.writeState(environment, existingState);
   }
 
+  /**
+   * Revision
+   */
+  readRevision() {
+    return this.adapter.readRevision();
+  }
+
+  writeRevision(revision: string) {
+    return this.adapter.writeRevision(revision);
+  }
+
   /**
    * Datafile
    */
diff --git a/packages/core/src/datasource/filesystemAdapter.ts b/packages/core/src/datasource/filesystemAdapter.ts
index a72f9a03..816d33a2 100644
--- a/packages/core/src/datasource/filesystemAdapter.ts
+++ b/packages/core/src/datasource/filesystemAdapter.ts
@@ -28,6 +28,10 @@ export function getExistingStateFilePath(
   return path.join(projectConfig.stateDirectoryPath, `existing-state-${environment}.json`);
 }
 
+export function getRevisionFilePath(projectConfig: ProjectConfig): string {
+  return path.join(projectConfig.stateDirectoryPath, `REVISION`);
+}
+
 export class FilesystemAdapter extends Adapter {
   private parser: CustomParser;
 
@@ -136,6 +140,41 @@ export class FilesystemAdapter extends Adapter {
     fs.writeFileSync(filePath, JSON.stringify(existingState, null, 2));
   }
 
+  /**
+   * Revision
+   */
+  async readRevision(): Promise<string> {
+    const filePath = getRevisionFilePath(this.config);
+
+    if (fs.existsSync(filePath)) {
+      return fs.readFileSync(filePath, "utf8");
+    }
+
+    // maintain backwards compatibility
+    try {
+      const pkg = require(path.join(this.rootDirectoryPath as string, "package.json"));
+      const pkgVersion = pkg.version;
+
+      if (pkgVersion) {
+        return pkgVersion;
+      }
+
+      return "0";
+    } catch (e) {
+      return "0";
+    }
+  }
+
+  async writeRevision(revision: string): Promise<void> {
+    const filePath = getRevisionFilePath(this.config);
+
+    if (!fs.existsSync(this.config.stateDirectoryPath)) {
+      mkdirp.sync(this.config.stateDirectoryPath);
+    }
+
+    fs.writeFileSync(filePath, revision);
+  }
+
   /**
    * Datafile
    */

From 92ff9153a53a9a2182c3dc3994dbdca9f76e3dc5 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Sun, 10 Mar 2024 18:44:44 +0000
Subject: [PATCH 08/48] v1.11.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cd787c00..bcf19141 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+
+### Features
+
+* revisioning info moved to its own file ([#274](https://github.com/featurevisor/featurevisor/issues/274)) ([6a175d1](https://github.com/featurevisor/featurevisor/commit/6a175d1be01c1ab78661bbd93d535de69af47135))
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index c66df284..fb8dbddb 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 19912369..81d78488 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.1"
+    "@featurevisor/cli": "^1.11.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 63b88f91..99363c3e 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 196608aa..d221caaf 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.1"
+    "@featurevisor/cli": "^1.11.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index b99e0ea8..fa6f3753 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index d2b11624..b98f5c7f 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.1",
+    "@featurevisor/cli": "^1.11.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 0b097605..f547dc1c 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index aba640b4..cebb6c4b 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.1"
+    "@featurevisor/cli": "^1.11.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 306b9907..7d32874f 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 133b9fc9..c7fa4d97 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.10.1"
+    "@featurevisor/cli": "^1.11.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index 21526b64..ff802f0d 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.10.1"
+  "version": "1.11.0"
 }
diff --git a/package-lock.json b/package-lock.json
index e4ca5104..0cceb446 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.1"
+        "@featurevisor/cli": "^1.11.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.1"
+        "@featurevisor/cli": "^1.11.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.1",
+        "@featurevisor/cli": "^1.11.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.1"
+        "@featurevisor/cli": "^1.11.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.10.1"
+        "@featurevisor/cli": "^1.11.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.10.1",
+      "version": "1.11.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.10.0",
+        "@featurevisor/core": "^1.11.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.10.0",
+      "version": "1.11.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.3.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index a16ff64e..fcdcafe5 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+
+### Features
+
+* revisioning info moved to its own file ([#274](https://github.com/featurevisor/featurevisor/issues/274)) ([6a175d1](https://github.com/featurevisor/featurevisor/commit/6a175d1be01c1ab78661bbd93d535de69af47135))
+
+
+
+
+
 ## [1.10.1](https://github.com/featurevisor/featurevisor/compare/v1.10.0...v1.10.1) (2024-03-10)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 95ff170d..de4d6d64 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.10.0",
+    "@featurevisor/core": "^1.11.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 3815780c..2d26a40e 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
+
+
+### Features
+
+* revisioning info moved to its own file ([#274](https://github.com/featurevisor/featurevisor/issues/274)) ([6a175d1](https://github.com/featurevisor/featurevisor/commit/6a175d1be01c1ab78661bbd93d535de69af47135))
+
+
+
+
+
 # [1.10.0](https://github.com/featurevisor/featurevisor/compare/v1.9.0...v1.10.0) (2024-03-10)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 4fed1a42..8f5b14e2 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From a9f5c157e30487f14aea7e217884881044176a2c Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sun, 10 Mar 2024 20:07:28 +0100
Subject: [PATCH 09/48] docs: fix code block

---
 docs/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/cli.md b/docs/cli.md
index d7ab4eb4..268ce5a8 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -25,7 +25,7 @@ After you have installed the dependencies in the project:
 
 ```
 $ npm install
-``
+```
 
 You can access the Featurevisor CLI from inside the project via:
 

From d5847de089dae8096c42865a42dd08110ef5e76d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?B=C5=82a=C5=BCej=20Che=C5=82kowski?= <bchelkow@gmail.com>
Date: Sun, 10 Mar 2024 20:16:44 +0100
Subject: [PATCH 10/48] docs: add Roku SDK documentation (#272)

---
 docs/sdks/index.md          |   3 +-
 docs/sdks/roku.md           | 509 ++++++++++++++++++++++++++++++++++++
 docs/sidebarNavigation.json |   3 +-
 3 files changed, 513 insertions(+), 2 deletions(-)
 create mode 100644 docs/sdks/roku.md

diff --git a/docs/sdks/index.md b/docs/sdks/index.md
index a3565faf..f7db36d3 100644
--- a/docs/sdks/index.md
+++ b/docs/sdks/index.md
@@ -5,11 +5,12 @@ description: Learn how to use Featurevisor SDKs
 
 SDKs are meant to be used in your own applications, where you want to evaluate features in the application runtime. {% .lead %}
 
-JavaScript environments are supported first:
+Supported environments:
 
 - [JavaScript](/docs/sdks/javascript)
 - [Node.js](/docs/sdks/nodejs)
 - [Browser](/docs/sdks/browser)
+- [Roku](/docs/sdks/roku)
 
 With other languages to follow very soon:
 
diff --git a/docs/sdks/roku.md b/docs/sdks/roku.md
new file mode 100644
index 00000000..4d38115c
--- /dev/null
+++ b/docs/sdks/roku.md
@@ -0,0 +1,509 @@
+---
+title: Roku SDK
+description: Learn how to use Featurevisor Roku SDK
+ogImage: /img/og/docs-sdks-roku.png
+---
+
+BrightScript SDK for Roku is meant to be used with [kopytko-framework](https://github.com/getndazn/kopytko-framework). {% .lead %}
+
+However, if you don't use it, you can simply copy all SDK files and their dependencies to your project (a version will be prepared in the future if anyone is interested).
+
+## Installation
+
+Install with npm:
+
+```bash
+npm i -P @featurevisor/roku
+```
+
+## Introduction
+
+The BrightScript implementation is a bit different than the JS one, as in BrightScript to be able to keep our instance separated and keep it globally, the SDK would need to be a SceneGraph Node. But to provide a bit similar API to the JS SDK we have introduced 2 main entities. One is the `FeaturevisorInstance` node, and the other is the function `FeaturevisorSDK` (that returns an object with methods mirroring JS SDK functions). The `FeaturevisorSDK` operates on the `FeaturevisorInstance` that is created by it or passed to it.
+
+**That's why all functions presented in this documentation are `FeaturevisorSDK` methods (or exactly, of the object returned by `FeaturevisorSDK()`)**
+
+There are a couple of methods to handle Featurevisor in your Roku App, for example:
+
+- create a new SceneGraph Node that will save in its context the FeaturevisorSDK() and create your abstraction based on FeaturevisorSDK. Later save this whole node globally
+- create with FeaturevisorSDK an instance that you will save globally and later pass each time to `FeaturevisorSDK().createInstance({}, existingInstance)` before using its methods.
+
+For this documentation, we assume there will be a new node created for the integration (first variant).
+We will call it `MyFeaturevisorInstance` and all code will be invoked inside this node (in the `MyFeaturevisorInstance.brs` for the below example).
+The value returned by `FeaturevisorSDK()` will be called `f`, or if needed saved in the context - `m.f`.
+
+XML definition:
+
+```xml
+<?xml version="1.0" encoding="utf-8" ?>
+
+<component name="MyFeaturevisorInstance" extends="Node">
+  <interface>
+    <!-- Fields and Functions you want to expose -->
+  </interface>
+
+  <script type="text/brightscript" uri="MyFeaturevisorInstance.brs" />
+</component>
+```
+
+## Initialization
+
+The SDK can create a new instance or accept an existing one to be able to invoke its methods using this instance.
+
+{% callout type="note" title="Understanding datafiles" %}
+You are recommended to learn more about [building datafiles](/docs/building-datafiles) before proceeding further.
+{% /callout %}
+
+Create a new instance (creates `FeaturevisorInstance` node):
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    datafileUrl: "<featurevisor-datafile-url>",
+  })
+end sub
+```
+
+Or use existing instance:
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  ' define existingInstance
+
+  f = FeaturevisorSDK()
+  f.createInstance({}, existingInstance)
+end sub
+```
+
+## Context
+
+Contexts are [attribute](/docs/attributes) values that we pass to SDK for evaluating [features](/docs/features).
+
+They are objects where keys are the attribute keys, and values are the attribute values.
+
+```brightscirpt
+context = {
+  myAttributeKey: "myAttributeValue",
+  anotherAttributeKey: "anotherAttributeValue",
+}
+```
+
+Methods using the context (attributes) described above:
+
+- `f.isEnabled(featureKey as String, context = {} as Object) as Boolean`
+- `f.getVariation(feature as Dynamic, context = {} as Object) as Dynamic`
+- `f.getVariable(feature as Dynamic, variableKey as String, context = {} as Object) as Object`
+- `f.getVariableBoolean(feature as Dynamic, variableKey as String, context = {} as Object) as Boolean`
+- `f.getVariableString(feature as Dynamic, variableKey as String, context = {} as Object) as Dynamic`
+- `f.getVariableInteger(feature as Dynamic, variableKey as String, context = {} as Object) as Integer`
+- `f.getVariableDouble(feature as Dynamic, variableKey as String, context = {} as Object) as Float`
+- `f.getVariableArray(feature as Dynamic, variableKey as String, context = {} as Object) as Object`
+- `f.getVariableObject(feature as Dynamic, variableKey as String, context = {} as Object) as Object`
+- `f.getVariableJSON(feature as Dynamic, variableKey as String, context = {} as Object) as Dynamic`
+
+## Checking if enabled
+
+Once the SDK is initialized, you can check if a feature is enabled or not:
+
+```brightscript
+function isMyFeatureEnabled() as Boolean
+  ' m.f is a FeaturevisorSDK with an initialized FeaturevisorInstance
+
+  featureKey = "my_feature"
+  context = {
+    userId: "123",
+    country: "nl",
+  }
+
+  return m.f.isEnabled(featureKey, context)
+end function
+```
+
+## Getting variations
+
+If your feature has any [variations](/docs/features/#variations) defined, you can get evaluate them as follows:
+
+```brightscript
+function getMyFeatureVariation() as Dynamic
+  ' m.f is a FeaturevisorSDK with an initialized FeaturevisorInstance
+
+  featureKey = "my_feature"
+  context = {
+    userId: "123",
+    country: "nl",
+  }
+
+  return m.f.getVariation(featureKey, context)
+end function
+```
+
+## Getting variables
+
+Your features may also include [variables](/docs/features/#variables):
+
+```brightscript
+function getBgColorValue() as Dynamic
+  ' m.f is a FeaturevisorSDK with an initialized FeaturevisorInstance
+
+  featureKey = "my_feature"
+  variableKey = "bgColor"
+  context = {
+    userId: "123",
+    country: "nl",
+  }
+
+  return m.f.getVariable(featureKey, variableKey, context)
+end function
+```
+
+## Type specific methods
+
+Next to generic `f.getVariable(feature as Dynamic, variableKey as String, context = {} as Object) as Object` methods, there are also type specific methods available for convenience:
+
+### `boolean`
+
+```brightscript
+f.getVariableBoolean(feature as Dynamic, variableKey as String, context = {} as Object) as Boolean
+```
+
+### `string`
+
+```brightscript
+f.getVariableString(feature as Dynamic, variableKey as String, context = {} as Object) as Dynamic
+```
+
+### `integer`
+
+```brightscript
+f.getVariableInteger(feature as Dynamic, variableKey as String, context = {} as Object) as Integer
+```
+
+### `double`
+
+```brightscript
+f.getVariableDouble(feature as Dynamic, variableKey as String, context = {} as Object) as Float
+```
+
+### `array`
+
+```brightscript
+f.getVariableArray(feature as Dynamic, variableKey as String, context = {} as Object) as Object
+```
+
+### `object`
+
+```brightscript
+f.getVariableObject(feature as Dynamic, variableKey as String, context = {} as Object) as Object
+```
+
+### `json`
+
+```brightscript
+f.getVariableJSON(feature as Dynamic, variableKey as String, context = {} as Object) as Dynamic
+```
+
+## Observe initialization
+
+**Remember that if defined with `f.onReady` method, it should be called before `createInstance`**
+
+By the `f.onReady(func as Function, context = Invalid as Object)`
+
+```brightscript
+' @import /components/libs/featurevisor/Featurevisor.facade.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.onReady(sub ()
+    ' instance has been initialized and it is ready
+  end sub) ' context can be added as an optional second argument
+end sub
+```
+
+By the `f.createInstance(options as Object)` options:
+
+```brightscript
+' @import /components/libs/featurevisor/Featurevisor.facade.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    onReady: {
+      callback: sub ()
+        ' instance has been initialized and it is ready
+      end sub,
+      context: {}, ' optional context for the callback
+    },
+  })
+end sub
+```
+
+## Activation
+
+Activation is useful when you want to track what features and their variations are exposed to your users.
+
+It works the same as `f.getVariation()` method, but it will also bubble an event up that you can listen to.
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.onActivation(sub (data as Object)
+    ' feature has been activated
+  end sub) ' context can be added as an optional second argument
+end sub
+```
+
+or
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    onActivation: {
+      callback: sub (data as Object)
+        ' feature has been activated
+      end sub,
+      context: {}, ' optional context for the callback
+    },
+  })
+end sub
+```
+
+`data` Object fields:
+
+- `captureContext` - attributes that you want to capture, marked as `capture: true` in Attribute YAMLs
+- `feature` - activated feature
+- `context` - all the attributes used for evaluating
+- `variationValue` - variation of the activated feature
+
+## Initial features
+
+You may want to initialize your SDK with a set of features before SDK has successfully fetched the datafile (if using `datafileUrl` option).
+
+This helps in cases when you fail to fetch the datafile, but you still wish your SDK instance to continue serving a set of sensible default values. And as soon as the datafile is fetched successfully, the SDK will start serving values from there.
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    ' ...
+    initialFeatures: {
+      myFeatureKey: {
+        enabled: true,
+
+        ' optional
+        variation: "treatment",
+        variables: {
+          myVariableKey: "my-variable-value",
+        },
+      },
+    },
+  })
+end sub
+```
+
+## Stickiness
+
+Featurevisor relies on consistent bucketing making sure the same user always sees the same variation in a deterministic way. You can learn more about it in [Bucketing](/docs/bucketing) section.
+
+But there are times when your targeting conditions (segments) can change and this may lead to some users being re-bucketed into a different variation. This is where stickiness becomes important.
+
+If you have already identified your user in your application, and know what features should be exposed to them in what variations, you can initialize the SDK with a set of sticky features:
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    ' ...
+    stickyFeatures: {
+      myFeatureKey: {
+        enabled: true,
+
+        ' optional
+        variation: "treatment",
+        variables: {
+          myVariableKey: "my-variable-value",
+        },
+      },
+    },
+  })
+end sub
+```
+
+Once initialized with sticky features, the SDK will look for values there first before evaluating the targeting conditions and going through the bucketing process.
+
+You can also set sticky features after the SDK is initialized:
+
+```brightscript
+f.setStickyFeatures({
+  myFeatureKey: {
+    enabled: true,
+    variation: "treatment",
+    variables: {},
+  },
+  anotherFeatureKey: {
+    enabled: false,
+  }
+})
+```
+
+This will be handy when you want to:
+
+- update sticky features in the SDK without re-initializing it (or restarting the app), and
+- handle evaluation of features for multiple users from the same instance of the SDK (e.g. in a server dealing with incoming requests from multiple users)
+
+## Intercepting context
+
+You can intercept context before they are used for evaluation:
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  defaultContext = {
+    platform: "roku",
+    locale: "en_US",
+    country: "US",
+    timezone: "America/New_York",
+  }
+  f = FeaturevisorSDK()
+  f.createInstance({
+    configureAndInterceptStaticContext: defaultContext,
+    interceptContext: function (context as Object) as Object
+      joinedContext = {}
+      joinedContext.append(m) ' defaultContext
+      joinedContext.append(context)
+
+      return joinedContext
+    end function,
+  })
+end sub
+```
+
+This is useful when you wish to add a default set of attributes as context for all your evaluations, giving you the convenience of not having to pass them in every time.
+
+## Refreshing datafile
+
+Refreshing the datafile is convenient when you want to update the datafile in runtime, for example when you want to update the feature variations and variables config without having to restart your application.
+
+It is only possible to refresh datafile in Featurevisor if you are using the `datafileUrl` option when creating your SDK instance.
+
+### Manual refresh
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  m.f = FeaturevisorSDK()
+  m.f.createInstance({
+    datafileUrl: "<featurevisor-datafile-url>",
+  })
+end sub
+
+sub refresh()
+  m.f.refresh()
+end sub
+```
+
+### Refresh by interval
+
+If you want to refresh your datafile every X number of seconds, you can pass the `refreshInterval` option when creating your SDK instance:
+
+```brightscript
+' @import /components/libs/featurevisor/FeaturevisorSDK.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    datafileUrl: "<featurevisor-datafile-url>",
+    refreshInterval: 60 * 5, ' every 5 minutes
+  })
+end sub
+```
+
+You can stop the interval by calling:
+
+```brightscript
+f.stopRefreshing()
+```
+
+If you want to resume refreshing:
+
+```brightscript
+f.startRefreshing()
+```
+
+### Listening for updates
+
+Every successful refresh will trigger the `onRefresh()` option:
+
+```brightscript
+' @import /components/libs/featurevisor/Featurevisor.facade.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.onRefresh(sub ()
+    ' datafile has been refreshed
+  end sub) ' context can be added as an optional second argument
+end sub
+```
+
+or
+
+```brightscript
+' @import /components/libs/featurevisor/Featurevisor.facade.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    onRefresh: {
+      callback: sub ()
+        ' datafile has been refreshed
+      end sub,
+      context: {}, ' optional context for the callback
+    },
+  })
+end sub
+```
+
+Not every refresh is going to be of a new datafile version. If you want to know if datafile content has changed in any particular refresh, you can listen to `onUpdate` option:
+
+```brightscript
+' @import /components/libs/featurevisor/Featurevisor.facade.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.onUpdate(sub ()
+    ' datafile has been updated (the revision has changed)
+  end sub) ' context can be added as an optional second argument
+end sub
+```
+
+or
+
+```brightscript
+' @import /components/libs/featurevisor/Featurevisor.facade.brs from @featurevisor/roku
+
+sub init()
+  f = FeaturevisorSDK()
+  f.createInstance({
+    onUpdate: {
+      callback: sub ()
+        ' datafile has been updated (the revision has changed)
+      end sub,
+      context: {}, ' optional context for the callback
+    },
+  })
+end sub
+```
diff --git a/docs/sidebarNavigation.json b/docs/sidebarNavigation.json
index dc5c3811..424c7646 100644
--- a/docs/sidebarNavigation.json
+++ b/docs/sidebarNavigation.json
@@ -39,7 +39,8 @@
     "links": [
       { "title": "JavaScript", "href": "/docs/sdks/javascript" },
       { "title": "Node.js", "href": "/docs/sdks/nodejs" },
-      { "title": "Browser", "href": "/docs/sdks/browser" }
+      { "title": "Browser", "href": "/docs/sdks/browser" },
+      { "title": "Roku", "href": "/docs/sdks/roku" }
     ]
   },
   {

From 72737e1850d62c04ee407134c4189b9ee650e263 Mon Sep 17 00:00:00 2001
From: Jagadeesh Gade <79077571+jagadeeshgade008@users.noreply.github.com>
Date: Mon, 11 Mar 2024 00:51:39 +0530
Subject: [PATCH 11/48] docs: Fastify integration (#270)

---
 docs/frameworks/fastify.md  | 149 ++++++++++++++++++++++++++++++++++++
 docs/sidebarNavigation.json |   3 +-
 2 files changed, 151 insertions(+), 1 deletion(-)
 create mode 100644 docs/frameworks/fastify.md

diff --git a/docs/frameworks/fastify.md b/docs/frameworks/fastify.md
new file mode 100644
index 00000000..2a69f9d8
--- /dev/null
+++ b/docs/frameworks/fastify.md
@@ -0,0 +1,149 @@
+---
+title: Fastify
+description: Learn how to integrate Featurevisor in Fastify applications for evaluating feature flags
+ogImage: /img/og/docs-frameworks-fastify.png
+---
+
+Set up Featurevisor SDK instance in a Fastify application using a custom decorator, including TypeScript integration for evaluating feature flags. {% .lead %}
+
+## Hello World application
+
+Before going into Featurevisor integration, let's create a simple Hello World [Fastify](https://www.fastify.io/) application.
+
+We start by installing the package:
+
+```
+$ npm install --save fastify
+```
+
+```js
+// index.js
+const fastify = require("fastify")({ logger: true });
+
+const PORT = 3000;
+
+fastify.get("/", async (request, reply) => {
+  return "Hello World!";
+});
+
+fastify.listen(PORT, () => {
+  console.log(`Example app listening on port ${PORT}`);
+});
+```
+
+We can start the server with this command:
+
+```
+$ node index.js
+Example app listening on port 3000
+```
+
+## Featurevisor integration
+
+We install the Featurevisor SDK first:
+
+```
+$ npm install --save @featurevisor/sdk
+```
+
+We can now create an instance of the SDK and use it in our application:
+
+```js
+// Require the fastify framework and instantiate it
+const fastify = require('fastify')({
+    logger: true
+})
+
+// Featurevisor SDK
+const { createInstance } = require("@featurevisor/sdk");
+const DATAFILE_URL = "https://featurevisor-example-cloudflare.pages.dev/production/datafile-tag-all.json"; // replace with yoursite cdn
+const REFRESH_INTERVAL = 60 * 5; // every 5 minutes
+
+const f = createInstance({
+    datafileUrl: DATAFILE_URL,
+
+    // optionally refresh the datafile every 5 minutes,
+    // without having to restart the server
+    refreshInterval: REFRESH_INTERVAL,
+});
+
+// Declare a route
+fastify.get('/', async (request, reply) => {
+    const featureKey = "my_feature";
+    const context = { userId: "123", country: "nl" };
+
+    const isEnabled = f.isEnabled(featureKey, context);
+
+    if (isEnabled) {
+        reply.send("Hello World!");
+    } else {
+        reply.send("Not enabled yet!");
+    }
+})
+
+// Run the server!
+const start = async () => {
+    fastify.listen({ port: 3000 }, function (err, address) {
+        if (err) {
+            fastify.log.error(err)
+            process.exit(1)
+        }
+        fastify.log.info(`server listening on ${fastify.server.address().port}`)
+    })
+}
+start()
+```
+
+## Decorator
+
+It is very unlikely that we will have all our routes defined in the same index.js file, making it difficult for us to use the same Featurevisor SDK instance in all of them.
+
+To solve this problem, we can create a custom decorator that will set the Featurevisor SDK instance to the request object, so that we can use the same instance in all our routes throughout the lifecycle of this application.
+
+```js
+// index.js
+
+// ...
+
+fastify.decorateRequest('f', f);
+
+// ...
+```
+
+Now from anywhere in our application (either in index.js or some other module), we can access the Featurevisor SDK instance via request.f:
+
+```js
+fastify.get("/my-route", async (request, reply) => {
+    const featureKey = "my_feature";
+    const context = { userId: "123", country: "nl" };
+
+    const isEnabled = request.f.isEnabled(featureKey, context);
+
+  if (isEnabled) {
+    reply.send("Hello World!");
+  } else {
+    reply.send("Not enabled yet!");
+  }
+});
+```
+
+## TypeScript usage
+
+If you are using TypeScript, you can extend the `Request` interface to add the `f` property for Featurevisor SDK's instance.
+
+Create a new `custom.d.ts` file and make sure to add it in `tsconfig.json`'s `files` section:
+
+```ts
+import { FeaturevisorInstance } from "@featurevisor/sdk";
+import { FastifyInstance } from "fastify";
+
+declare module 'fastify' {
+  interface FastifyInstance {
+    f: FeaturevisorInstance;
+  }
+}
+```
+
+## Working repository
+
+You can find a fully functional example of this integration on GitHub: [https://github.com/featurevisor/featurevisor-example-fastify](https://github.com/featurevisor/featurevisor-example-fastify).
diff --git a/docs/sidebarNavigation.json b/docs/sidebarNavigation.json
index 424c7646..609b8bf3 100644
--- a/docs/sidebarNavigation.json
+++ b/docs/sidebarNavigation.json
@@ -52,7 +52,8 @@
       { "title": "Vue.js", "href": "/docs/vue" },
       { "title": "Nuxt", "href": "/docs/frameworks/nuxt" },
       { "title": "Astro", "href": "/docs/frameworks/astro" },
-      { "title": "Express.js", "href": "/docs/frameworks/express" }
+      { "title": "Express.js", "href": "/docs/frameworks/express" },
+      { "title": "Fastify", "href": "/docs/frameworks/fastify" }
     ]
   },
   {

From 8a6e7fdbbb6924696756e0019fada6d92169e9da Mon Sep 17 00:00:00 2001
From: Meir Roth <12494197+meirroth@users.noreply.github.com>
Date: Thu, 14 Mar 2024 18:35:23 +0200
Subject: [PATCH 12/48] docs: note about automatic deployments (#280)

---
 docs/integrations/cloudflare-pages.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/integrations/cloudflare-pages.md b/docs/integrations/cloudflare-pages.md
index 3e53adea..6b2ffbee 100644
--- a/docs/integrations/cloudflare-pages.md
+++ b/docs/integrations/cloudflare-pages.md
@@ -27,6 +27,10 @@ Cloudflare Pages is a product that allows you to host your static sites and apps
 
 Make sure you already have a Cloudflare Pages project set up, and then use it in the publish workflow later.
 
+{% callout type="note" title="Note about Cloudflare Pages automatic deployments" %}
+Cloudflare Pages is set to auto-deploy your site on every push. This could interfere with our GitHub publish action. To prevent this, you can turn off auto deployment by following the steps in this [Cloudflare documentation](https://developers.cloudflare.com/pages/configuration/branch-build-controls/).
+{% /callout %}
+
 ## Secrets
 
 Follow the guide [here](https://developers.cloudflare.com/pages/how-to/use-direct-upload-with-continuous-integration/), and set up these two secrets in your GitHub repository's `Settings > Secrets and variables > Actions` section:

From 9f198e2303498c2c74fb2a9a2fcfa5c320acf93f Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Thu, 14 Mar 2024 18:02:16 +0100
Subject: [PATCH 13/48] fix: move to next condition if parsing fails (#279)

---
 examples/example-1/features/showHeader.yml   |  29 +
 examples/example-1/segments/desktop.yml      |   5 +
 examples/example-1/segments/version_gt5.yml  |   5 +
 examples/example-1/tests/showHeader.spec.yml |  40 ++
 packages/core/src/tester/testSegment.ts      |   5 +-
 packages/sdk/src/conditions.spec.ts          | 550 ++++++++++++-------
 packages/sdk/src/conditions.ts               |  24 +-
 packages/sdk/src/feature.ts                  |  16 +-
 packages/sdk/src/instance.ts                 |  17 +-
 packages/sdk/src/segments.spec.ts            |  84 ++-
 packages/sdk/src/segments.ts                 |  16 +-
 11 files changed, 551 insertions(+), 240 deletions(-)
 create mode 100644 examples/example-1/features/showHeader.yml
 create mode 100644 examples/example-1/segments/desktop.yml
 create mode 100644 examples/example-1/segments/version_gt5.yml
 create mode 100644 examples/example-1/tests/showHeader.spec.yml

diff --git a/examples/example-1/features/showHeader.yml b/examples/example-1/features/showHeader.yml
new file mode 100644
index 00000000..5f5c6a85
--- /dev/null
+++ b/examples/example-1/features/showHeader.yml
@@ -0,0 +1,29 @@
+description: For testing wrong semver parsing
+tags:
+  - all
+
+bucketBy:
+  - userId
+
+environments:
+  staging:
+    rules:
+      - key: "1"
+        segments: "*"
+        percentage: 100
+  production:
+    rules:
+      - key: "desktop"
+        segments:
+          - version_gt5
+          - desktop
+        percentage: 100
+
+      - key: "mobile"
+        segments:
+          - mobile
+        percentage: 100
+
+      - key: "all"
+        segments: "*"
+        percentage: 0
diff --git a/examples/example-1/segments/desktop.yml b/examples/example-1/segments/desktop.yml
new file mode 100644
index 00000000..db667011
--- /dev/null
+++ b/examples/example-1/segments/desktop.yml
@@ -0,0 +1,5 @@
+description: desktop users
+conditions:
+  - attribute: device
+    operator: equals
+    value: desktop
diff --git a/examples/example-1/segments/version_gt5.yml b/examples/example-1/segments/version_gt5.yml
new file mode 100644
index 00000000..33a2fc20
--- /dev/null
+++ b/examples/example-1/segments/version_gt5.yml
@@ -0,0 +1,5 @@
+description: Version greater than 5
+conditions:
+  - attribute: version
+    operator: semverGreaterThan
+    value: 5.0.0
diff --git a/examples/example-1/tests/showHeader.spec.yml b/examples/example-1/tests/showHeader.spec.yml
new file mode 100644
index 00000000..ca7e8c59
--- /dev/null
+++ b/examples/example-1/tests/showHeader.spec.yml
@@ -0,0 +1,40 @@
+feature: showHeader
+assertions:
+  - description: "should be disabled for desktop users below v5"
+    at: 80
+    environment: production
+    context:
+      device: desktop
+      version: 1.2.3
+    expectedToBeEnabled: false
+
+  - description: "should be enabled for desktop users above v5"
+    at: 80
+    environment: production
+    context:
+      device: desktop
+      version: 5.5.0
+    expectedToBeEnabled: true
+
+  - description: "should be enabled for mobile users when passing valid semver"
+    at: 80
+    environment: production
+    context:
+      device: mobile
+      version: 1.2.3
+    expectedToBeEnabled: true
+
+  - description: "should be enabled for mobile users when passing invalid semver"
+    at: 80
+    environment: production
+    context:
+      device: mobile
+      version: 7.0.A101.99gbm.lg
+    expectedToBeEnabled: true
+
+  - description: "should be disabled for tablets"
+    at: 80
+    environment: production
+    context:
+      device: tablet
+    expectedToBeEnabled: false
diff --git a/packages/core/src/tester/testSegment.ts b/packages/core/src/tester/testSegment.ts
index d3fb0c72..3534240a 100644
--- a/packages/core/src/tester/testSegment.ts
+++ b/packages/core/src/tester/testSegment.ts
@@ -5,7 +5,7 @@ import {
   TestResultAssertion,
   TestResultAssertionError,
 } from "@featurevisor/types";
-import { allConditionsAreMatched } from "@featurevisor/sdk";
+import { allConditionsAreMatched, createLogger } from "@featurevisor/sdk";
 
 import { Datasource } from "../datasource";
 
@@ -41,6 +41,7 @@ export async function testSegment(
 
   const parsedSegment = await datasource.readSegment(segmentKey);
   const conditions = parsedSegment.conditions as Condition | Condition[];
+  const logger = createLogger();
 
   test.assertions.forEach(function (assertion, aIndex) {
     const assertions = getSegmentAssertionsFromMatrix(aIndex, assertion);
@@ -59,7 +60,7 @@ export async function testSegment(
       }
 
       const expected = assertion.expectedToMatch;
-      const actual = allConditionsAreMatched(conditions, assertion.context);
+      const actual = allConditionsAreMatched(conditions, assertion.context, logger);
       const passed = actual === expected;
 
       if (!passed) {
diff --git a/packages/sdk/src/conditions.spec.ts b/packages/sdk/src/conditions.spec.ts
index 84b3d987..0e1fe1a9 100644
--- a/packages/sdk/src/conditions.spec.ts
+++ b/packages/sdk/src/conditions.spec.ts
@@ -1,7 +1,11 @@
-import { allConditionsAreMatched } from "./conditions";
 import { Condition } from "@featurevisor/types";
 
+import { allConditionsAreMatched } from "./conditions";
+import { createLogger } from "./logger";
+
 describe("sdk: Conditions", function () {
+  const logger = createLogger();
+
   it("should be a function", function () {
     expect(typeof allConditionsAreMatched).toEqual("function");
   });
@@ -17,10 +21,12 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" }, logger)).toEqual(
+        false,
+      );
     });
 
     it("should match with operator: notEquals", function () {
@@ -33,10 +39,14 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" }, logger)).toEqual(
+        true,
+      );
 
       // not match
-      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" }, logger)).toEqual(
+        false,
+      );
     });
 
     it("should match with operator: startsWith", function () {
@@ -49,11 +59,11 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { name: "Hello World" })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { name: "Hello Universe" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Hello World" }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Hello Universe" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { name: "Hi World" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { name: "Hi World" }, logger)).toEqual(false);
     });
 
     it("should match with operator: endsWith", function () {
@@ -66,11 +76,11 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { name: "Hello World" })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { name: "Hi World" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Hello World" }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Hi World" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { name: "Hi Universe" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { name: "Hi Universe" }, logger)).toEqual(false);
     });
 
     it("should match with operator: contains", function () {
@@ -83,11 +93,11 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { name: "Hello World" })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { name: "Yo! Hello!" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Hello World" }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Yo! Hello!" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { name: "Hi World" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { name: "Hi World" }, logger)).toEqual(false);
     });
 
     it("should match with operator: notContains", function () {
@@ -100,11 +110,11 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { name: "Hi World" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { name: "Hi World" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { name: "Hello World" })).toEqual(false);
-      expect(allConditionsAreMatched(conditions, { name: "Yo! Hello!" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { name: "Hello World" }, logger)).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { name: "Yo! Hello!" }, logger)).toEqual(false);
     });
 
     it("should match with operator: in", function () {
@@ -117,12 +127,16 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" }, logger)).toEqual(
+        true,
+      );
 
       // not match
-      expect(allConditionsAreMatched(conditions, { browser_type: "edge" })).toEqual(false);
-      expect(allConditionsAreMatched(conditions, { browser_type: "safari" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { browser_type: "edge" }, logger)).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { browser_type: "safari" }, logger)).toEqual(
+        false,
+      );
     });
 
     it("should match with operator: notIn", function () {
@@ -135,12 +149,16 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { browser_type: "edge" })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { browser_type: "safari" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { browser_type: "edge" }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { browser_type: "safari" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" })).toEqual(false);
-      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { browser_type: "chrome" }, logger)).toEqual(
+        false,
+      );
+      expect(allConditionsAreMatched(conditions, { browser_type: "firefox" }, logger)).toEqual(
+        false,
+      );
     });
 
     it("should match with operator: greaterThan", function () {
@@ -153,10 +171,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { age: 19 })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { age: 19 }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { age: 17 })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { age: 17 }, logger)).toEqual(false);
     });
 
     it("should match with operator: greaterThanOrEquals", function () {
@@ -169,12 +187,12 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { age: 18 })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { age: 19 })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { age: 18 }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { age: 19 }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { age: 17 })).toEqual(false);
-      expect(allConditionsAreMatched(conditions, { age: 16 })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { age: 17 }, logger)).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { age: 16 }, logger)).toEqual(false);
     });
 
     it("should match with operator: lessThan", function () {
@@ -187,10 +205,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { age: 17 })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { age: 17 }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { age: 19 })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { age: 19 }, logger)).toEqual(false);
     });
 
     it("should match with operator: lessThanOrEquals", function () {
@@ -203,12 +221,12 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { age: 17 })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { age: 18 })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { age: 17 }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { age: 18 }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { age: 19 })).toEqual(false);
-      expect(allConditionsAreMatched(conditions, { age: 20 })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { age: 19 }, logger)).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { age: 20 }, logger)).toEqual(false);
     });
 
     it("should match with operator: semverEquals", function () {
@@ -221,10 +239,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { version: "1.0.0" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "1.0.0" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { version: "2.0.0" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { version: "2.0.0" }, logger)).toEqual(false);
     });
 
     it("should match with operator: semverNotEquals", function () {
@@ -237,10 +255,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { version: "2.0.0" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "2.0.0" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { version: "1.0.0" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { version: "1.0.0" }, logger)).toEqual(false);
     });
 
     it("should match with operator: semverGreaterThan", function () {
@@ -253,10 +271,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { version: "2.0.0" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "2.0.0" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { version: "0.9.0" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { version: "0.9.0" }, logger)).toEqual(false);
     });
 
     it("should match with operator: semverGreaterThanOrEquals", function () {
@@ -269,11 +287,11 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { version: "1.0.0" })).toEqual(true);
-      expect(allConditionsAreMatched(conditions, { version: "2.0.0" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "1.0.0" }, logger)).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "2.0.0" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { version: "0.9.0" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { version: "0.9.0" }, logger)).toEqual(false);
     });
 
     it("should match with operator: semverLessThan", function () {
@@ -286,10 +304,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { version: "0.9.0" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "0.9.0" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { version: "1.1.0" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { version: "1.1.0" }, logger)).toEqual(false);
     });
 
     it("should match with operator: semverLessThanOrEquals", function () {
@@ -302,10 +320,10 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { version: "1.0.0" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { version: "1.0.0" }, logger)).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { version: "1.1.0" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { version: "1.1.0" }, logger)).toEqual(false);
     });
 
     it("should match with operator: before", function () {
@@ -318,15 +336,19 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { date: "2023-05-12T00:00:00Z" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { date: "2023-05-12T00:00:00Z" }, logger)).toEqual(
+        true,
+      );
       expect(
-        allConditionsAreMatched(conditions, { date: new Date("2023-05-12T00:00:00Z") }),
+        allConditionsAreMatched(conditions, { date: new Date("2023-05-12T00:00:00Z") }, logger),
       ).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { date: "2023-05-14T00:00:00Z" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { date: "2023-05-14T00:00:00Z" }, logger)).toEqual(
+        false,
+      );
       expect(
-        allConditionsAreMatched(conditions, { date: new Date("2023-05-14T00:00:00Z") }),
+        allConditionsAreMatched(conditions, { date: new Date("2023-05-14T00:00:00Z") }, logger),
       ).toEqual(false);
     });
 
@@ -340,15 +362,19 @@ describe("sdk: Conditions", function () {
       ];
 
       // match
-      expect(allConditionsAreMatched(conditions, { date: "2023-05-14T00:00:00Z" })).toEqual(true);
+      expect(allConditionsAreMatched(conditions, { date: "2023-05-14T00:00:00Z" }, logger)).toEqual(
+        true,
+      );
       expect(
-        allConditionsAreMatched(conditions, { date: new Date("2023-05-14T00:00:00Z") }),
+        allConditionsAreMatched(conditions, { date: new Date("2023-05-14T00:00:00Z") }, logger),
       ).toEqual(true);
 
       // not match
-      expect(allConditionsAreMatched(conditions, { date: "2023-05-12T00:00:00Z" })).toEqual(false);
+      expect(allConditionsAreMatched(conditions, { date: "2023-05-12T00:00:00Z" }, logger)).toEqual(
+        false,
+      );
       expect(
-        allConditionsAreMatched(conditions, { date: new Date("2023-05-12T00:00:00Z") }),
+        allConditionsAreMatched(conditions, { date: new Date("2023-05-12T00:00:00Z") }, logger),
       ).toEqual(false);
     });
   });
@@ -365,9 +391,13 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions[0], {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions[0],
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(true);
     });
 
@@ -382,9 +412,13 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(true);
     });
 
@@ -393,16 +427,24 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+          },
+          logger,
+        ),
       ).toEqual(true);
     });
 
@@ -417,10 +459,14 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "1.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "1.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
     });
 
@@ -440,11 +486,15 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "1.0",
-          foo: "bar",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "1.0",
+            foo: "bar",
+          },
+          logger,
+        ),
       ).toEqual(true);
     });
   });
@@ -465,16 +515,24 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
 
@@ -498,17 +556,25 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "1.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "1.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
   });
@@ -529,9 +595,13 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(true);
     });
 
@@ -555,16 +625,24 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_version: "1.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_version: "1.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
   });
@@ -585,16 +663,24 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
 
@@ -618,29 +704,45 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+          },
+          logger,
+        ),
       ).toEqual(true);
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "1.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "1.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
   });
@@ -675,31 +777,47 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "1.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "1.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "3.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "3.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
 
@@ -737,34 +855,50 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          country: "nl",
-          browser_type: "chrome",
-          browser_version: "1.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            country: "nl",
+            browser_type: "chrome",
+            browser_version: "1.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          country: "nl",
-          browser_type: "chrome",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            country: "nl",
+            browser_type: "chrome",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "3.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "3.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          country: "us",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            country: "us",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
 
@@ -797,33 +931,49 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "chrome",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "chrome",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-          device_type: "mobile",
-          orientation: "portrait",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+            device_type: "mobile",
+            orientation: "portrait",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-          device_type: "desktop",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+            device_type: "desktop",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
 
@@ -861,36 +1011,52 @@ describe("sdk: Conditions", function () {
 
       // match
       expect(
-        allConditionsAreMatched(conditions, {
-          country: "nl",
-          browser_type: "chrome",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            country: "nl",
+            browser_type: "chrome",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          country: "nl",
-          browser_type: "firefox",
-          device_type: "mobile",
-          orientation: "portrait",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            country: "nl",
+            browser_type: "firefox",
+            device_type: "mobile",
+            orientation: "portrait",
+          },
+          logger,
+        ),
       ).toEqual(true);
 
       // not match
       expect(
-        allConditionsAreMatched(conditions, {
-          browser_type: "firefox",
-          browser_version: "2.0",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            browser_type: "firefox",
+            browser_version: "2.0",
+          },
+          logger,
+        ),
       ).toEqual(false);
 
       expect(
-        allConditionsAreMatched(conditions, {
-          country: "de",
-          browser_type: "firefox",
-          device_type: "desktop",
-        }),
+        allConditionsAreMatched(
+          conditions,
+          {
+            country: "de",
+            browser_type: "firefox",
+            device_type: "desktop",
+          },
+          logger,
+        ),
       ).toEqual(false);
     });
   });
diff --git a/packages/sdk/src/conditions.ts b/packages/sdk/src/conditions.ts
index 3f3d9d08..9d34a2bf 100644
--- a/packages/sdk/src/conditions.ts
+++ b/packages/sdk/src/conditions.ts
@@ -2,6 +2,8 @@ import { compareVersions } from "compare-versions";
 
 import { Context, Condition, PlainCondition } from "@featurevisor/types";
 
+import { Logger } from "./logger";
+
 export function conditionIsMatched(condition: PlainCondition, context: Context): boolean {
   const { attribute, operator, value } = condition;
 
@@ -75,17 +77,30 @@ export function conditionIsMatched(condition: PlainCondition, context: Context):
 export function allConditionsAreMatched(
   conditions: Condition[] | Condition,
   context: Context,
+  logger: Logger,
 ): boolean {
   if ("attribute" in conditions) {
-    return conditionIsMatched(conditions, context);
+    try {
+      return conditionIsMatched(conditions, context);
+    } catch (e) {
+      logger.warn(e.message, {
+        error: e,
+        details: {
+          condition: conditions,
+          context,
+        },
+      });
+
+      return false;
+    }
   }
 
   if ("and" in conditions && Array.isArray(conditions.and)) {
-    return conditions.and.every((c) => allConditionsAreMatched(c, context));
+    return conditions.and.every((c) => allConditionsAreMatched(c, context, logger));
   }
 
   if ("or" in conditions && Array.isArray(conditions.or)) {
-    return conditions.or.some((c) => allConditionsAreMatched(c, context));
+    return conditions.or.some((c) => allConditionsAreMatched(c, context, logger));
   }
 
   if ("not" in conditions && Array.isArray(conditions.not)) {
@@ -96,12 +111,13 @@ export function allConditionsAreMatched(
             and: conditions.not,
           },
           context,
+          logger,
         ) === false,
     );
   }
 
   if (Array.isArray(conditions)) {
-    return conditions.every((c) => allConditionsAreMatched(c, context));
+    return conditions.every((c) => allConditionsAreMatched(c, context, logger));
   }
 
   return false;
diff --git a/packages/sdk/src/feature.ts b/packages/sdk/src/feature.ts
index 1c39760b..83f4b8c3 100644
--- a/packages/sdk/src/feature.ts
+++ b/packages/sdk/src/feature.ts
@@ -2,6 +2,7 @@ import { Allocation, Context, Traffic, Feature, Force } from "@featurevisor/type
 import { DatafileReader } from "./datafileReader";
 import { allGroupSegmentsAreMatched } from "./segments";
 import { allConditionsAreMatched } from "./conditions";
+import { Logger } from "./logger";
 
 export function getMatchedAllocation(
   traffic: Traffic,
@@ -30,10 +31,16 @@ export function getMatchedTraffic(
   traffic: Traffic[],
   context: Context,
   datafileReader: DatafileReader,
+  logger: Logger,
 ): Traffic | undefined {
   return traffic.find((t) => {
     if (
-      !allGroupSegmentsAreMatched(parseFromStringifiedSegments(t.segments), context, datafileReader)
+      !allGroupSegmentsAreMatched(
+        parseFromStringifiedSegments(t.segments),
+        context,
+        datafileReader,
+        logger,
+      )
     ) {
       return false;
     }
@@ -52,12 +59,14 @@ export function getMatchedTrafficAndAllocation(
   context: Context,
   bucketValue: number,
   datafileReader: DatafileReader,
+  logger: Logger,
 ): MatchedTrafficAndAllocation {
   const matchedTraffic = traffic.find((t) => {
     return allGroupSegmentsAreMatched(
       parseFromStringifiedSegments(t.segments),
       context,
       datafileReader,
+      logger,
     );
   });
 
@@ -80,6 +89,7 @@ export function findForceFromFeature(
   feature: Feature,
   context: Context,
   datafileReader: DatafileReader,
+  logger: Logger,
 ): Force | undefined {
   if (!feature.force) {
     return undefined;
@@ -87,11 +97,11 @@ export function findForceFromFeature(
 
   return feature.force.find((f: Force) => {
     if (f.conditions) {
-      return allConditionsAreMatched(f.conditions, context);
+      return allConditionsAreMatched(f.conditions, context, logger);
     }
 
     if (f.segments) {
-      return allGroupSegmentsAreMatched(f.segments, context, datafileReader);
+      return allGroupSegmentsAreMatched(f.segments, context, datafileReader, logger);
     }
 
     return false;
diff --git a/packages/sdk/src/instance.ts b/packages/sdk/src/instance.ts
index aeb850e5..aa4d50e7 100644
--- a/packages/sdk/src/instance.ts
+++ b/packages/sdk/src/instance.ts
@@ -521,7 +521,7 @@ export class FeaturevisorInstance {
       const finalContext = this.interceptContext ? this.interceptContext(context) : context;
 
       // forced
-      const force = findForceFromFeature(feature, context, this.datafileReader);
+      const force = findForceFromFeature(feature, context, this.datafileReader, this.logger);
 
       if (force && typeof force.enabled !== "undefined") {
         evaluation = {
@@ -579,7 +579,12 @@ export class FeaturevisorInstance {
       // bucketing
       const bucketValue = this.getBucketValue(feature, finalContext);
 
-      const matchedTraffic = getMatchedTraffic(feature.traffic, finalContext, this.datafileReader);
+      const matchedTraffic = getMatchedTraffic(
+        feature.traffic,
+        finalContext,
+        this.datafileReader,
+        this.logger,
+      );
 
       if (matchedTraffic) {
         // check if mutually exclusive
@@ -774,7 +779,7 @@ export class FeaturevisorInstance {
       const finalContext = this.interceptContext ? this.interceptContext(context) : context;
 
       // forced
-      const force = findForceFromFeature(feature, context, this.datafileReader);
+      const force = findForceFromFeature(feature, context, this.datafileReader, this.logger);
 
       if (force && force.variation) {
         const variation = feature.variations.find((v) => v.value === force.variation);
@@ -800,6 +805,7 @@ export class FeaturevisorInstance {
         finalContext,
         bucketValue,
         this.datafileReader,
+        this.logger,
       );
 
       if (matchedTraffic) {
@@ -1040,7 +1046,7 @@ export class FeaturevisorInstance {
       const finalContext = this.interceptContext ? this.interceptContext(context) : context;
 
       // forced
-      const force = findForceFromFeature(feature, context, this.datafileReader);
+      const force = findForceFromFeature(feature, context, this.datafileReader, this.logger);
 
       if (force && force.variables && typeof force.variables[variableKey] !== "undefined") {
         evaluation = {
@@ -1064,6 +1070,7 @@ export class FeaturevisorInstance {
         finalContext,
         bucketValue,
         this.datafileReader,
+        this.logger,
       );
 
       if (matchedTraffic) {
@@ -1109,6 +1116,7 @@ export class FeaturevisorInstance {
                     return allConditionsAreMatched(
                       typeof o.conditions === "string" ? JSON.parse(o.conditions) : o.conditions,
                       finalContext,
+                      this.logger,
                     );
                   }
 
@@ -1117,6 +1125,7 @@ export class FeaturevisorInstance {
                       parseFromStringifiedSegments(o.segments),
                       finalContext,
                       this.datafileReader,
+                      this.logger,
                     );
                   }
 
diff --git a/packages/sdk/src/segments.spec.ts b/packages/sdk/src/segments.spec.ts
index 5a75ba32..9176ba49 100644
--- a/packages/sdk/src/segments.spec.ts
+++ b/packages/sdk/src/segments.spec.ts
@@ -1,6 +1,8 @@
+import { DatafileContent, GroupSegment } from "@featurevisor/types";
+
 import { DatafileReader } from "./datafileReader";
 import { allGroupSegmentsAreMatched } from "./segments";
-import { DatafileContent, GroupSegment } from "@featurevisor/types";
+import { createLogger } from "./logger";
 
 interface Group {
   key: string;
@@ -8,6 +10,8 @@ interface Group {
 }
 
 describe("sdk: Segments", function () {
+  const logger = createLogger();
+
   it("should be a function", function () {
     expect(typeof allGroupSegmentsAreMatched).toEqual("function");
   });
@@ -178,13 +182,13 @@ describe("sdk: Segments", function () {
       const group = groups.find((g) => g.key === "*") as Group;
 
       // match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(true);
-      expect(allGroupSegmentsAreMatched(group.segments, { foo: "foo" }, datafileReader)).toEqual(
-        true,
-      );
-      expect(allGroupSegmentsAreMatched(group.segments, { bar: "bar" }, datafileReader)).toEqual(
-        true,
-      );
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(true);
+      expect(
+        allGroupSegmentsAreMatched(group.segments, { foo: "foo" }, datafileReader, logger),
+      ).toEqual(true);
+      expect(
+        allGroupSegmentsAreMatched(group.segments, { bar: "bar" }, datafileReader, logger),
+      ).toEqual(true);
     });
 
     it("should match dutchMobileUsers", function () {
@@ -196,6 +200,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -203,16 +208,18 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
 
       // not match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(false);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(false);
       expect(
         allGroupSegmentsAreMatched(
           group.segments,
           { country: "de", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
     });
@@ -226,6 +233,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -233,16 +241,18 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
 
       // not match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(false);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(false);
       expect(
         allGroupSegmentsAreMatched(
           group.segments,
           { country: "de", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
     });
@@ -256,6 +266,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -263,6 +274,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -270,6 +282,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "desktop" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -277,16 +290,18 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "desktop", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
 
       // not match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(false);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(false);
       expect(
         allGroupSegmentsAreMatched(
           group.segments,
           { country: "de", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
       expect(
@@ -294,6 +309,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "de", deviceType: "desktop" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
     });
@@ -307,6 +323,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -314,6 +331,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "mobile", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -321,6 +339,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "desktop" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -328,16 +347,18 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "nl", deviceType: "desktop", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
 
       // not match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(false);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(false);
       expect(
         allGroupSegmentsAreMatched(
           group.segments,
           { country: "de", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
       expect(
@@ -345,6 +366,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "de", deviceType: "desktop" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
     });
@@ -358,6 +380,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "de", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -365,16 +388,18 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "de", deviceType: "mobile", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
 
       // not match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(false);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(false);
       expect(
         allGroupSegmentsAreMatched(
           group.segments,
           { country: "nl", deviceType: "mobile" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
     });
@@ -388,6 +413,7 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "de", deviceType: "desktop" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
       expect(
@@ -395,16 +421,18 @@ describe("sdk: Segments", function () {
           group.segments,
           { country: "de", deviceType: "desktop", browser: "chrome" },
           datafileReader,
+          logger,
         ),
       ).toEqual(true);
 
       // not match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(false);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(false);
       expect(
         allGroupSegmentsAreMatched(
           group.segments,
           { country: "nl", deviceType: "desktop" },
           datafileReader,
+          logger,
         ),
       ).toEqual(false);
     });
@@ -413,28 +441,28 @@ describe("sdk: Segments", function () {
       const group = groups.find((g) => g.key === "notVersion5.5") as Group;
 
       // match
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(true);
-      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader)).toEqual(true);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(true);
+      expect(allGroupSegmentsAreMatched(group.segments, {}, datafileReader, logger)).toEqual(true);
+      expect(
+        allGroupSegmentsAreMatched(group.segments, { version: "5.6" }, datafileReader, logger),
+      ).toEqual(true);
       expect(
-        allGroupSegmentsAreMatched(group.segments, { version: "5.6" }, datafileReader),
+        allGroupSegmentsAreMatched(group.segments, { version: 5.6 }, datafileReader, logger),
       ).toEqual(true);
-      expect(allGroupSegmentsAreMatched(group.segments, { version: 5.6 }, datafileReader)).toEqual(
-        true,
-      );
       expect(
-        allGroupSegmentsAreMatched(group.segments, { version: "5.7" }, datafileReader),
+        allGroupSegmentsAreMatched(group.segments, { version: "5.7" }, datafileReader, logger),
+      ).toEqual(true);
+      expect(
+        allGroupSegmentsAreMatched(group.segments, { version: 5.7 }, datafileReader, logger),
       ).toEqual(true);
-      expect(allGroupSegmentsAreMatched(group.segments, { version: 5.7 }, datafileReader)).toEqual(
-        true,
-      );
 
       // not match
       expect(
-        allGroupSegmentsAreMatched(group.segments, { version: "5.5" }, datafileReader),
+        allGroupSegmentsAreMatched(group.segments, { version: "5.5" }, datafileReader, logger),
+      ).toEqual(false);
+      expect(
+        allGroupSegmentsAreMatched(group.segments, { version: 5.5 }, datafileReader, logger),
       ).toEqual(false);
-      expect(allGroupSegmentsAreMatched(group.segments, { version: 5.5 }, datafileReader)).toEqual(
-        false,
-      );
     });
   });
 });
diff --git a/packages/sdk/src/segments.ts b/packages/sdk/src/segments.ts
index 5ee42a8d..e20a7d3f 100644
--- a/packages/sdk/src/segments.ts
+++ b/packages/sdk/src/segments.ts
@@ -1,15 +1,17 @@
 import { Context, GroupSegment, Segment, Condition } from "@featurevisor/types";
 import { allConditionsAreMatched } from "./conditions";
 import { DatafileReader } from "./datafileReader";
+import { Logger } from "./logger";
 
-export function segmentIsMatched(segment: Segment, context: Context): boolean {
-  return allConditionsAreMatched(segment.conditions as Condition | Condition[], context);
+export function segmentIsMatched(segment: Segment, context: Context, logger: Logger): boolean {
+  return allConditionsAreMatched(segment.conditions as Condition | Condition[], context, logger);
 }
 
 export function allGroupSegmentsAreMatched(
   groupSegments: GroupSegment | GroupSegment[] | "*",
   context: Context,
   datafileReader: DatafileReader,
+  logger: Logger,
 ): boolean {
   if (groupSegments === "*") {
     return true;
@@ -19,7 +21,7 @@ export function allGroupSegmentsAreMatched(
     const segment = datafileReader.getSegment(groupSegments);
 
     if (segment) {
-      return segmentIsMatched(segment, context);
+      return segmentIsMatched(segment, context, logger);
     }
 
     return false;
@@ -28,27 +30,27 @@ export function allGroupSegmentsAreMatched(
   if (typeof groupSegments === "object") {
     if ("and" in groupSegments && Array.isArray(groupSegments.and)) {
       return groupSegments.and.every((groupSegment) =>
-        allGroupSegmentsAreMatched(groupSegment, context, datafileReader),
+        allGroupSegmentsAreMatched(groupSegment, context, datafileReader, logger),
       );
     }
 
     if ("or" in groupSegments && Array.isArray(groupSegments.or)) {
       return groupSegments.or.some((groupSegment) =>
-        allGroupSegmentsAreMatched(groupSegment, context, datafileReader),
+        allGroupSegmentsAreMatched(groupSegment, context, datafileReader, logger),
       );
     }
 
     if ("not" in groupSegments && Array.isArray(groupSegments.not)) {
       return groupSegments.not.every(
         (groupSegment) =>
-          allGroupSegmentsAreMatched(groupSegment, context, datafileReader) === false,
+          allGroupSegmentsAreMatched(groupSegment, context, datafileReader, logger) === false,
       );
     }
   }
 
   if (Array.isArray(groupSegments)) {
     return groupSegments.every((groupSegment) =>
-      allGroupSegmentsAreMatched(groupSegment, context, datafileReader),
+      allGroupSegmentsAreMatched(groupSegment, context, datafileReader, logger),
     );
   }
 

From b0de54112d2af4ba4af13dc7a554b18a60b2a574 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Thu, 14 Mar 2024 17:05:02 +0000
Subject: [PATCH 14/48] v1.11.1

---
 CHANGELOG.md                              | 11 +++++++
 examples/example-1/CHANGELOG.md           | 11 +++++++
 examples/example-1/package.json           |  4 +--
 examples/example-json/CHANGELOG.md        |  8 +++++
 examples/example-json/package.json        |  4 +--
 examples/example-toml/CHANGELOG.md        |  8 +++++
 examples/example-toml/package.json        |  4 +--
 examples/example-yml-include/CHANGELOG.md |  8 +++++
 examples/example-yml-include/package.json |  4 +--
 examples/example-yml/CHANGELOG.md         |  8 +++++
 examples/example-yml/package.json         |  4 +--
 lerna.json                                |  2 +-
 package-lock.json                         | 38 +++++++++++------------
 packages/cli/CHANGELOG.md                 |  8 +++++
 packages/cli/package.json                 |  4 +--
 packages/core/CHANGELOG.md                | 11 +++++++
 packages/core/package.json                |  4 +--
 packages/react/CHANGELOG.md               |  8 +++++
 packages/react/package.json               |  4 +--
 packages/sdk/CHANGELOG.md                 | 11 +++++++
 packages/sdk/package.json                 |  2 +-
 packages/vue/CHANGELOG.md                 |  8 +++++
 packages/vue/package.json                 |  4 +--
 23 files changed, 139 insertions(+), 39 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bcf19141..2e7fd137 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+
+### Bug Fixes
+
+* move to next condition if parsing fails ([#279](https://github.com/featurevisor/featurevisor/issues/279)) ([9f198e2](https://github.com/featurevisor/featurevisor/commit/9f198e2303498c2c74fb2a9a2fcfa5c320acf93f))
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index fb8dbddb..ec3a5206 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+
+### Bug Fixes
+
+* move to next condition if parsing fails ([#279](https://github.com/featurevisor/featurevisor/issues/279)) ([9f198e2](https://github.com/featurevisor/featurevisor/commit/9f198e2303498c2c74fb2a9a2fcfa5c320acf93f))
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 81d78488..95bf95f2 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.0"
+    "@featurevisor/cli": "^1.11.1"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 99363c3e..03aaeedd 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index d221caaf..d37edb0c 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.0"
+    "@featurevisor/cli": "^1.11.1"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index fa6f3753..b218dbef 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index b98f5c7f..42c1cfa3 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.0",
+    "@featurevisor/cli": "^1.11.1",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index f547dc1c..b9abc009 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index cebb6c4b..3e3d0f92 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.0"
+    "@featurevisor/cli": "^1.11.1"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 7d32874f..ced8743c 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index c7fa4d97..a25453fe 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.0"
+    "@featurevisor/cli": "^1.11.1"
   }
 }
diff --git a/lerna.json b/lerna.json
index ff802f0d..136b5678 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.11.0"
+  "version": "1.11.1"
 }
diff --git a/package-lock.json b/package-lock.json
index 0cceb446..37ad1a6b 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.0"
+        "@featurevisor/cli": "^1.11.1"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.0"
+        "@featurevisor/cli": "^1.11.1"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.0",
+        "@featurevisor/cli": "^1.11.1",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.0"
+        "@featurevisor/cli": "^1.11.1"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.0"
+        "@featurevisor/cli": "^1.11.1"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.11.0",
+        "@featurevisor/core": "^1.11.1",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,10 +18829,10 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.11.0",
+      "version": "1.11.1",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.3.0",
+        "@featurevisor/sdk": "^1.11.1",
         "@featurevisor/site": "^1.7.1",
         "@featurevisor/types": "^1.3.0",
         "axios": "^1.3.4",
@@ -18893,10 +18893,10 @@
     },
     "packages/react": {
       "name": "@featurevisor/react",
-      "version": "1.3.0",
+      "version": "1.11.1",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.3.0",
+        "@featurevisor/sdk": "^1.11.1",
         "@featurevisor/types": "^1.3.0"
       },
       "devDependencies": {
@@ -18907,7 +18907,7 @@
     },
     "packages/sdk": {
       "name": "@featurevisor/sdk",
-      "version": "1.3.0",
+      "version": "1.11.1",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/types": "^1.3.0",
@@ -19145,10 +19145,10 @@
     },
     "packages/vue": {
       "name": "@featurevisor/vue",
-      "version": "1.3.0",
+      "version": "1.11.1",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.3.0",
+        "@featurevisor/sdk": "^1.11.1",
         "@featurevisor/types": "^1.3.0",
         "vue": "^3.3.4"
       },
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index fcdcafe5..fb497f05 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/cli
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index de4d6d64..0fd76571 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.11.0",
+    "@featurevisor/core": "^1.11.1",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 2d26a40e..28f14554 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+
+### Bug Fixes
+
+* move to next condition if parsing fails ([#279](https://github.com/featurevisor/featurevisor/issues/279)) ([9f198e2](https://github.com/featurevisor/featurevisor/commit/9f198e2303498c2c74fb2a9a2fcfa5c320acf93f))
+
+
+
+
+
 # [1.11.0](https://github.com/featurevisor/featurevisor/compare/v1.10.1...v1.11.0) (2024-03-10)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 8f5b14e2..d6bc24c4 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,7 +44,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/sdk": "^1.3.0",
+    "@featurevisor/sdk": "^1.11.1",
     "@featurevisor/site": "^1.7.1",
     "@featurevisor/types": "^1.3.0",
     "axios": "^1.3.4",
diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
index a5ee4206..c2edf7b8 100644
--- a/packages/react/CHANGELOG.md
+++ b/packages/react/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/react
+
+
+
+
+
 # [1.3.0](https://github.com/featurevisor/featurevisor/compare/v1.2.4...v1.3.0) (2024-01-23)
 
 **Note:** Version bump only for package @featurevisor/react
diff --git a/packages/react/package.json b/packages/react/package.json
index 476015a7..54824e8e 100644
--- a/packages/react/package.json
+++ b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/react",
-  "version": "1.3.0",
+  "version": "1.11.1",
   "description": "React package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.3.0",
+    "@featurevisor/sdk": "^1.11.1",
     "@featurevisor/types": "^1.3.0"
   },
   "license": "MIT",
diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md
index ef58bd18..a4628698 100644
--- a/packages/sdk/CHANGELOG.md
+++ b/packages/sdk/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+
+### Bug Fixes
+
+* move to next condition if parsing fails ([#279](https://github.com/featurevisor/featurevisor/issues/279)) ([9f198e2](https://github.com/featurevisor/featurevisor/commit/9f198e2303498c2c74fb2a9a2fcfa5c320acf93f))
+
+
+
+
+
 # [1.3.0](https://github.com/featurevisor/featurevisor/compare/v1.2.4...v1.3.0) (2024-01-23)
 
 **Note:** Version bump only for package @featurevisor/sdk
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 54fa29ea..e9059ef8 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/sdk",
-  "version": "1.3.0",
+  "version": "1.11.1",
   "description": "Featurevisor SDK for Node.js and the browser",
   "main": "dist/index.js",
   "module": "lib/index.js",
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
index 1c649598..da0738a7 100644
--- a/packages/vue/CHANGELOG.md
+++ b/packages/vue/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
+
+**Note:** Version bump only for package @featurevisor/vue
+
+
+
+
+
 # [1.3.0](https://github.com/featurevisor/featurevisor/compare/v1.2.4...v1.3.0) (2024-01-23)
 
 **Note:** Version bump only for package @featurevisor/vue
diff --git a/packages/vue/package.json b/packages/vue/package.json
index b56dd5bc..3344bb91 100644
--- a/packages/vue/package.json
+++ b/packages/vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/vue",
-  "version": "1.3.0",
+  "version": "1.11.1",
   "description": "Vue.js package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.3.0",
+    "@featurevisor/sdk": "^1.11.1",
     "@featurevisor/types": "^1.3.0",
     "vue": "^3.3.4"
   },

From e219fff1db78fa64fce85b06380eb6730b6cc0dc Mon Sep 17 00:00:00 2001
From: Meir Roth <12494197+meirroth@users.noreply.github.com>
Date: Thu, 14 Mar 2024 19:40:54 +0200
Subject: [PATCH 15/48] chore: Bump GitHub action dependencies (#283)

---
 .github/workflows/checks.yml          |  6 +++---
 .github/workflows/publish.yml         |  6 +++---
 docs/integrations/cloudflare-pages.md | 12 ++++++------
 docs/integrations/github-actions.md   | 12 ++++++------
 4 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/checks.yml b/.github/workflows/checks.yml
index 960e7ec3..36d09a91 100644
--- a/.github/workflows/checks.yml
+++ b/.github/workflows/checks.yml
@@ -15,14 +15,14 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v4
         with:
           node-version-file: '.nvmrc'
 
       - name: Cache dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: ~/.npm
           key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 2df15079..f99c3d02 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -11,16 +11,16 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v4
         with:
           node-version-file: ".nvmrc"
 
       - name: Cache dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: ~/.npm
           key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
diff --git a/docs/integrations/cloudflare-pages.md b/docs/integrations/cloudflare-pages.md
index 6b2ffbee..833c02f8 100644
--- a/docs/integrations/cloudflare-pages.md
+++ b/docs/integrations/cloudflare-pages.md
@@ -68,11 +68,11 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v4
         with:
-          node-version: 16
+          node-version: 20
 
       - name: Install dependencies
         run: npm ci
@@ -107,11 +107,11 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v4
         with:
-          node-version: 16
+          node-version: 20
 
       - name: Install dependencies
         run: npm ci
diff --git a/docs/integrations/github-actions.md b/docs/integrations/github-actions.md
index c2db331c..4c149ad3 100644
--- a/docs/integrations/github-actions.md
+++ b/docs/integrations/github-actions.md
@@ -49,11 +49,11 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v4
         with:
-          node-version: 16
+          node-version: 20
 
       - name: Install dependencies
         run: npm ci
@@ -88,11 +88,11 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v4
         with:
-          node-version: 16
+          node-version: 20
 
       - name: Install dependencies
         run: npm ci

From 6bebaad997737221458c02554dadb54b7060359d Mon Sep 17 00:00:00 2001
From: Meir Roth <12494197+meirroth@users.noreply.github.com>
Date: Sun, 17 Mar 2024 19:19:41 +0200
Subject: [PATCH 16/48] docs: GitHub Pages Setup Guide (#284)

---
 docs/deployment.md                    |   2 +-
 docs/integrations/cloudflare-pages.md |   2 +-
 docs/integrations/github-pages.md     | 169 ++++++++++++++++++++++++++
 docs/sidebarNavigation.json           |   1 +
 4 files changed, 172 insertions(+), 2 deletions(-)
 create mode 100644 docs/integrations/github-pages.md

diff --git a/docs/deployment.md b/docs/deployment.md
index f7074c63..4514f439 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -60,6 +60,6 @@ If any of the steps above fail, the CI/CD pipeline should stop and notify the te
 
 ## Fully functional example
 
-You can refer to the CI/CD guide for [GitHub Actions](/docs/integrations/github-actions) and [Cloudflare Pages](/docs/integrations/cloudflare-pages) if you want a fully functional real-world example of setting up a Featurevisor project.
+You can refer to the CI/CD guide for [GitHub Actions](/docs/integrations/github-actions) and either [Cloudflare Pages](/docs/integrations/cloudflare-pages) or [GitHub Pages](/docs/integrations/github-pages) if you want a fully functional real-world example of setting up a Featurevisor project.
 
 Repo is available here: [https://github.com/featurevisor/featurevisor-example-cloudflare](https://github.com/featurevisor/featurevisor-example-cloudflare).
diff --git a/docs/integrations/cloudflare-pages.md b/docs/integrations/cloudflare-pages.md
index 833c02f8..326d8df4 100644
--- a/docs/integrations/cloudflare-pages.md
+++ b/docs/integrations/cloudflare-pages.md
@@ -147,7 +147,7 @@ jobs:
 
 After generating new datafiles and uploading them, the workflow will also take care of pushing the Featurevisor [state files](/docs/state-files) back to the repository, so that future builds will be built on top of latest state.
 
-Once uploaded, the your datafiles will be accessible as: `https://<your-project>.pages.dev/<environment>/datafile-tag-<your-tag>.json`.
+Once uploaded, your datafiles will be accessible as: `https://<your-project>.pages.dev/<environment>/datafile-tag-<your-tag>.json`.
 
 You may want to take it a step further by setting up custom domains (or subdomains) for your Cloudflare Pages project. Otherwise, you are good to go.
 
diff --git a/docs/integrations/github-pages.md b/docs/integrations/github-pages.md
new file mode 100644
index 00000000..29db655c
--- /dev/null
+++ b/docs/integrations/github-pages.md
@@ -0,0 +1,169 @@
+---
+title: GitHub Pages
+description: Learn how to upload Featurevisor datafiles to GitHub Pages
+# TODO: Fix image
+ogImage: /img/og/docs-integrations-github-pages.png
+---
+
+Set up continuous integration and deployment of your Feaurevisor project with GitHub Actions and GitHub Pages. {% .lead %}
+
+See more about GitHub Actions set up in previous guide [here](/docs/integrations/github-actions).
+
+## Creating a new project
+
+This guide assumes you have created a new Featurevisor project using the CLI:
+
+```
+$ mkdir my-featurevisor-project && cd my-featurevisor-project
+
+$ npx @featurevisor/cli init
+$ npm install
+```
+
+## GitHub Pages
+
+We are going to be uploading to and serving our datafiles from [GitHub Pages](https://pages.github.com/).
+
+GitHub Pages is a product that allows you to host your static sites and apps on GitHub's global network. Given Featurevisor project generates static datafiles (JSON files), it is a great fit for our use case.
+
+## Workflows
+
+We will be covering two workflows for our set up with GitHub Actions.
+
+### Checks
+
+This workflow will be triggered on every push to the repository targeting any non-master or non-main branches.
+
+This will help identify any issues with your Pull Requests early before you merge them to your main branch.
+
+```yml
+# .github/workflows/checks.yml
+name: Checks
+
+on:
+  push:
+    branches-ignore:
+      - main
+      - master
+
+jobs:
+  checks:
+    name: Checks
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npx featurevisor lint
+
+      - name: Test specs
+        run: npx featurevisor test
+
+      - name: Build
+        run: npx featurevisor build
+```
+
+### Publish
+
+This workflow is intended to be run on every push to your main (or master) branch, and is supposed to handle publishing your generated datafiles to GitHub Pages:
+
+```yml
+# .github/workflows/publish.yml
+name: Publish
+
+on:
+  push:
+    branches:
+      - main
+      - master
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    name: Publish
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npx featurevisor lint
+
+      - name: Test specs
+        run: npx featurevisor test
+
+      - name: Build
+        run: npx featurevisor build
+
+      - name: Create index.html
+        run: echo "<html><body>It works.</body></html>" > dist/index.html
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'dist'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+      - name: Git configs
+        run: |
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor }}@users.noreply.github.com"
+
+      - name: Push back to origin
+        run: |
+          git add .featurevisor/*
+          git commit -m "[skip ci] Revision $(cat .featurevisor/REVISION)"
+          git push
+```
+
+After generating new datafiles and uploading them, the workflow will also take care of pushing the Featurevisor [state files](/docs/state-files) back to the repository, so that future builds will be built on top of latest state.
+
+Once uploaded, your datafiles will be accessible as: `https://<username>.github.io/<repo>/<environment>/datafile-tag-<your-tag>.json`.
+
+You may want to take it a step further by [setting up custom domains (or subdomains)](https://docs.github.com/articles/using-a-custom-domain-with-github-pages/) for your GitHub Pages project. Otherwise, you are good to go.
+
+Learn how to consume datafiles from URLs directly using [SDKs](/docs/sdks).
+
+## Full example
+
+You can find a fully functional repository based on this guide here: [https://github.com/meirroth/featurevisor-example-github](https://github.com/meirroth/featurevisor-example-github).
+
+## Sequential builds
+
+In case you are worried about simultaneous builds triggered by multiple Pull Requests merged in quick succession, you can learn about mitigating any unintended issues [here](/docs/integrations/github-actions/#sequential-builds).
diff --git a/docs/sidebarNavigation.json b/docs/sidebarNavigation.json
index 609b8bf3..5c80e346 100644
--- a/docs/sidebarNavigation.json
+++ b/docs/sidebarNavigation.json
@@ -91,6 +91,7 @@
     "title": "CI/CD guides",
     "links": [
       { "title": "GitHub Actions", "href": "/docs/integrations/github-actions" },
+      { "title": "GitHub Pages", "href": "/docs/integrations/github-pages" },
       { "title": "Cloudflare Pages", "href": "/docs/integrations/cloudflare-pages" },
       { "title": "PartyKit", "href": "/docs/integrations/partykit" }
     ]

From 6754f747439885978f57aa84bfd7b334b540b0cf Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sat, 23 Mar 2024 18:22:05 +0100
Subject: [PATCH 17/48] docs: updates to node.js guide (#288)

---
 docs/sdks/nodejs.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/sdks/nodejs.md b/docs/sdks/nodejs.md
index b611f1b6..8ab0827b 100644
--- a/docs/sdks/nodejs.md
+++ b/docs/sdks/nodejs.md
@@ -37,3 +37,27 @@ And then `require()` it in your code:
 ```js
 require("isomorphic-fetch");
 ```
+
+## Consuming the SDK
+
+### Require
+
+If you are not dealing with ES Modules in Node.js, you can use `require()` as usual:
+
+```js
+const { createInstance } = require("@featurevisor/sdk");
+```
+
+### Import
+
+If you want to take advantage of ES Modules, you can import the SDK directly:
+
+```js
+import FeaturevisorSDK from "@featurevisor/sdk";
+
+const { createInstance } = FeaturevisorSDK;
+```
+
+## Example repository
+
+You can refer to this repository that shows a fully working Node.js application using Featurevisor SDK: [https://github.com/featurevisor/featurevisor-example-nodejs](https://github.com/featurevisor/featurevisor-example-nodejs),

From 4323595541f9c88e2851865a5a44f2735719aac5 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sat, 23 Mar 2024 18:38:43 +0100
Subject: [PATCH 18/48] docs: roadmap doc updated

---
 docs/roadmap.md     | 13 ++++++++++++-
 docs/state-files.md | 14 ++++++++++++--
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/docs/roadmap.md b/docs/roadmap.md
index 45e3f75b..a16e2c24 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -9,7 +9,18 @@ Feature requests on [GitHub](https://github.com/featurevisor/featurevisor/issues
 
 ## Past milestones
 
-Most recent first:
+For full changelog, visit [GitHub](https://github.com/featurevisor/featurevisor/blob/main/CHANGELOG.md).
+
+Notable changes:
+
+### 2024
+
+- March 10th, 2024: [Revisioning info moved to state files](/docs/state-files)
+- February 26th, 2024: [Test runner made 100x faster](/docs/testing/#fast)
+- February 11th, 2024: [Linter overhauled using Zod](/docs/linting)
+- January 16th, 2024: [Matrix for test specs](/docs/testing/#matrix)
+
+### 2023
 
 - December 13th, 2023: [v1.0 stable released](/blog/v1-release) 🎉
 - September 24th, 2023: [Custom parsers API](/docs/advanced/custom-parsers)
diff --git a/docs/state-files.md b/docs/state-files.md
index f9ac9406..30a6fb5c 100644
--- a/docs/state-files.md
+++ b/docs/state-files.md
@@ -7,9 +7,19 @@ When you build your datafiles, Featurevisor generates some additional JSON files
 
 ## Location
 
-They are located in the `.featurevisor` directory.
+They are located in the `.featurevisor` directory. You don't have to deal with them directly ever.
 
-You don't have to deal with them directly ever, but they contain valuable rollout information for the next build to maintain [consistent bucketing](/docs/bucketing) of your users against features.
+## What do they contain?
+
+### Traffic allocation
+
+Traffic allocation information is important to keep track of so that the next build can maintain [consistent bucketing](/docs/bucketing) for your users against individual features.
+
+### Revision
+
+Next to the JSON files for traffic allocation, it will also create and maintain a `REVISION` file which an integer value incremented by every successful build.
+
+This revision number will be present in your [generated datafiles](/docs/building-datafiles).
 
 ## Committing state files
 

From 4e82293ecfa25fb8b7f503f4d4328ea4ed240024 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sat, 23 Mar 2024 18:44:10 +0100
Subject: [PATCH 19/48] chore: license year updated

---
 LICENSE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/LICENSE b/LICENSE
index 99e7bbf3..a1e0d939 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2023 Fahad Heylaal (https://fahad19.com)
+Copyright (c) 2024 Fahad Heylaal (https://fahad19.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

From 96bd2309da6b45c44efdec764ff0a4f63d885fa6 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sat, 23 Mar 2024 19:37:59 +0100
Subject: [PATCH 20/48] feat: introduce new project config stringify (#286)

---
 docs/configuration.md                      |  8 ++++++++
 examples/example-1/featurevisor.config.js  |  1 +
 packages/core/src/builder/buildDatafile.ts | 22 ++++++++++++++++------
 packages/core/src/builder/traffic.ts       |  7 ++-----
 packages/core/src/config/projectConfig.ts  |  5 ++++-
 5 files changed, 31 insertions(+), 12 deletions(-)

diff --git a/docs/configuration.md b/docs/configuration.md
index 786356ca..4f6365ad 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -75,6 +75,14 @@ Set to `true` or `false` to enable or disable pretty-printing of datafiles.
 
 Defaults to `false`.
 
+### `stringify`
+
+By default, Featurevisor will stringify conditions and segments in generated datafiles so that they are parsed only when needed by the SDKs. This optimization technique works well when datafiles are too large in client-side devices (think browsers) and you are only dealing with one user in the runtime.
+
+This kind of optimization though can bring opposite results if you are using the SDKs in server-side (think Node.js) serving many different users.
+
+To disable this stringification, you can set it to `false`.
+
 ### `parser`
 
 By default, Featurevisor expects YAML for all definitions. You can change this to JSON by setting `parser: "json"`.
diff --git a/examples/example-1/featurevisor.config.js b/examples/example-1/featurevisor.config.js
index 9290aacf..a35a06dd 100644
--- a/examples/example-1/featurevisor.config.js
+++ b/examples/example-1/featurevisor.config.js
@@ -3,4 +3,5 @@ module.exports = {
   environments: ["staging", "production"],
   tags: ["all", "checkout"],
   prettyState: true,
+  prettyDatafile: true,
 };
diff --git a/packages/core/src/builder/buildDatafile.ts b/packages/core/src/builder/buildDatafile.ts
index d64d4e64..73bbd83e 100644
--- a/packages/core/src/builder/buildDatafile.ts
+++ b/packages/core/src/builder/buildDatafile.ts
@@ -159,7 +159,9 @@ export async function buildDatafile(
                     );
 
                     return {
-                      conditions: JSON.stringify(override.conditions),
+                      conditions: projectConfig.stringify
+                        ? JSON.stringify(override.conditions)
+                        : override.conditions,
                       value: override.value,
                     };
                   }
@@ -174,9 +176,9 @@ export async function buildDatafile(
 
                     return {
                       segments:
-                        typeof override.segments === "string"
-                          ? override.segments
-                          : JSON.stringify(override.segments),
+                        typeof override.segments !== "string" && projectConfig.stringify
+                          ? JSON.stringify(override.segments)
+                          : override.segments,
                       value: override.value,
                     };
                   }
@@ -195,7 +197,15 @@ export async function buildDatafile(
           parsedFeature.environments[options.environment].rules,
           existingState.features[featureKey],
           featureRanges.get(featureKey) || [],
-        ),
+        ).map((t: Traffic) => {
+          return {
+            ...t,
+            segments:
+              typeof t.segments !== "string" && projectConfig.stringify
+                ? JSON.stringify(t.segments)
+                : t.segments,
+          };
+        }),
         ranges: featureRanges.get(featureKey) || undefined,
       };
 
@@ -278,7 +288,7 @@ export async function buildDatafile(
       const segment: Segment = {
         key: segmentKey,
         conditions:
-          typeof parsedSegment.conditions !== "string"
+          typeof parsedSegment.conditions !== "string" && projectConfig.stringify === true
             ? JSON.stringify(parsedSegment.conditions)
             : parsedSegment.conditions,
       };
diff --git a/packages/core/src/builder/traffic.ts b/packages/core/src/builder/traffic.ts
index 4d7eefe3..6e337bf3 100644
--- a/packages/core/src/builder/traffic.ts
+++ b/packages/core/src/builder/traffic.ts
@@ -79,11 +79,8 @@ export function getTraffic(
     const rulePercentage = parsedRule.percentage; // 0 - 100
 
     const traffic: Traffic = {
-      key: parsedRule.key, // @TODO: not needed in datafile. keep it for now
-      segments:
-        typeof parsedRule.segments !== "string"
-          ? JSON.stringify(parsedRule.segments)
-          : parsedRule.segments,
+      key: parsedRule.key,
+      segments: parsedRule.segments,
       percentage: rulePercentage * (MAX_BUCKETED_NUMBER / 100),
       allocation: [],
     };
diff --git a/packages/core/src/config/projectConfig.ts b/packages/core/src/config/projectConfig.ts
index c835edbb..6b1cdda6 100644
--- a/packages/core/src/config/projectConfig.ts
+++ b/packages/core/src/config/projectConfig.ts
@@ -42,6 +42,7 @@ export interface ProjectConfig {
   parser: Parser;
   prettyState: boolean;
   prettyDatafile: boolean;
+  stringify: boolean;
   siteExportDirectoryPath: string;
   adapter: any; // @TODO: type this properly later
 }
@@ -66,6 +67,7 @@ export function getProjectConfig(rootDirectoryPath: string): ProjectConfig {
 
     prettyState: DEFAULT_PRETTY_STATE,
     prettyDatafile: DEFAULT_PRETTY_DATAFILE,
+    stringify: true,
 
     siteExportDirectoryPath: path.join(rootDirectoryPath, SITE_EXPORT_DIRECTORY_NAME),
 
@@ -78,7 +80,8 @@ export function getProjectConfig(rootDirectoryPath: string): ProjectConfig {
   const mergedConfig = {};
 
   Object.keys(baseConfig).forEach((key) => {
-    mergedConfig[key] = customConfig[key] || baseConfig[key];
+    mergedConfig[key] =
+      typeof customConfig[key] !== "undefined" ? customConfig[key] : baseConfig[key];
 
     if (key.endsWith("Path") && mergedConfig[key].indexOf(ROOT_DIR_PLACEHOLDER) !== -1) {
       mergedConfig[key] = mergedConfig[key].replace(ROOT_DIR_PLACEHOLDER, rootDirectoryPath);

From 399f2ddc2575ce783f175dab4bd5c761666bd7b4 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Sat, 23 Mar 2024 18:40:36 +0000
Subject: [PATCH 21/48] v1.12.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           | 11 ++++++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 |  8 +++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2e7fd137..537c2ef1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+
+### Features
+
+* introduce new project config stringify ([#286](https://github.com/featurevisor/featurevisor/issues/286)) ([96bd230](https://github.com/featurevisor/featurevisor/commit/96bd2309da6b45c44efdec764ff0a4f63d885fa6))
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index ec3a5206..f39f61dd 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+
+### Features
+
+* introduce new project config stringify ([#286](https://github.com/featurevisor/featurevisor/issues/286)) ([96bd230](https://github.com/featurevisor/featurevisor/commit/96bd2309da6b45c44efdec764ff0a4f63d885fa6))
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 95bf95f2..67987fab 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.1"
+    "@featurevisor/cli": "^1.12.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 03aaeedd..b92bb12b 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index d37edb0c..139b8dfb 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.1"
+    "@featurevisor/cli": "^1.12.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index b218dbef..62b4b8e2 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 42c1cfa3..8b0813aa 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.1",
+    "@featurevisor/cli": "^1.12.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index b9abc009..9969c941 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 3e3d0f92..81dbbb9c 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.1"
+    "@featurevisor/cli": "^1.12.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index ced8743c..2e294ab3 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index a25453fe..d212f311 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.11.1"
+    "@featurevisor/cli": "^1.12.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index 136b5678..f85a4ffd 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.11.1"
+  "version": "1.12.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 37ad1a6b..9c58dad9 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.1"
+        "@featurevisor/cli": "^1.12.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.1"
+        "@featurevisor/cli": "^1.12.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.1",
+        "@featurevisor/cli": "^1.12.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.1"
+        "@featurevisor/cli": "^1.12.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.11.1"
+        "@featurevisor/cli": "^1.12.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.11.1",
+        "@featurevisor/core": "^1.12.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.11.1",
+      "version": "1.12.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.11.1",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index fb497f05..d778fa2b 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+**Note:** Version bump only for package @featurevisor/cli
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/cli
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 0fd76571..098a0ae3 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.11.1",
+    "@featurevisor/core": "^1.12.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 28f14554..443cfd08 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
+
+
+### Features
+
+* introduce new project config stringify ([#286](https://github.com/featurevisor/featurevisor/issues/286)) ([96bd230](https://github.com/featurevisor/featurevisor/commit/96bd2309da6b45c44efdec764ff0a4f63d885fa6))
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index d6bc24c4..6e1e0af6 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From c1319b32d46ae7bbb03eb7b7e5dd19e37f2be51d Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Tue, 26 Mar 2024 22:42:45 +0100
Subject: [PATCH 22/48] feat: find usage of segments and attributes (#289)

---
 docs/cli.md                           |  28 +++
 packages/cli/src/index.ts             |  31 ++-
 packages/core/src/find-usage/index.ts | 279 ++++++++++++++++++++++++++
 packages/core/src/index.ts            |   1 +
 4 files changed, 338 insertions(+), 1 deletion(-)
 create mode 100644 packages/core/src/find-usage/index.ts

diff --git a/docs/cli.md b/docs/cli.md
index 268ce5a8..85055ee1 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -119,3 +119,31 @@ We can find these duplicates early on by running:
 ```
 $ npx featurevisor find-duplicate-segments
 ```
+
+## Find usage
+
+Learn where/if certain segments and attributes are used in.
+
+### Segment usage
+
+```
+$ npx featurevisor find-usage --segment=my_segment
+```
+
+### Attribute usage
+
+```
+$ npx featurevisor find-usage --attribute=my_attribute
+```
+
+### Unused segments
+
+```
+$ npx featurevisor find-usage --unusedSegments
+```
+
+### Unused attributes
+
+```
+$ npx featurevisor find-usage --unusedAttributes
+```
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index c56395b3..8648969c 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -14,6 +14,7 @@ import {
   serveSite,
   generateCodeForProject,
   findDuplicateSegmentsInProject,
+  findUsageInProject,
   BuildCLIOptions,
   GenerateCodeCLIOptions,
   TestProjectOptions,
@@ -230,7 +231,35 @@ async function main() {
         }
       },
     })
-    .example("$0 generate-code", "generate code from YAMLs")
+    .example("$0 find-duplicate-segments", "list segments with same conditions")
+
+    /**
+     * Find usage
+     */
+    .command({
+      command: "find-usage",
+      handler: async function (options) {
+        const deps = await getDependencies(options);
+
+        try {
+          await findUsageInProject(deps, {
+            segment: options.segment,
+            attribute: options.attribute,
+
+            unusedSegments: options.unusedSegments,
+            unusedAttributes: options.unusedAttributes,
+          });
+        } catch (e) {
+          console.error(e.message);
+          process.exit(1);
+        }
+      },
+    })
+    .example("$0 find-usage", "find usage of segments and attributes")
+    .example("$0 find-usage --segment=my_segment", "find usage of segment")
+    .example("$0 find-usage --attribute=my_attribute", "find usage of attribute")
+    .example("$0 find-usage --unusedSegments", "find unused segments")
+    .example("$0 find-usage --unusedAttributes", "find unused attributes")
 
     /**
      * Options
diff --git a/packages/core/src/find-usage/index.ts b/packages/core/src/find-usage/index.ts
new file mode 100644
index 00000000..2e19a611
--- /dev/null
+++ b/packages/core/src/find-usage/index.ts
@@ -0,0 +1,279 @@
+import { Condition, FeatureKey, SegmentKey, AttributeKey } from "@featurevisor/types";
+
+import { Dependencies } from "../dependencies";
+import {
+  extractAttributeKeysFromConditions,
+  extractSegmentKeysFromGroupSegments,
+} from "../utils/extractKeys";
+
+export async function findSegmentUsage(
+  deps: Dependencies,
+  segmentKey: SegmentKey,
+): Promise<Set<FeatureKey>> {
+  const { datasource, projectConfig } = deps;
+
+  const featureKeys = await datasource.listFeatures();
+
+  const usedInFeatures = new Set<FeatureKey>();
+
+  for (const featureKey of featureKeys) {
+    const feature = await datasource.readFeature(featureKey);
+    const segmentKeys = new Set<SegmentKey>();
+
+    // variable overrides inside variations
+    projectConfig.environments.forEach((environment) => {
+      if (feature.variations) {
+        feature.variations.forEach((variation) => {
+          if (variation.variables) {
+            variation.variables.forEach((variable) => {
+              if (variable.overrides) {
+                variable.overrides.forEach((override) => {
+                  if (override.segments) {
+                    extractSegmentKeysFromGroupSegments(override.segments).forEach((segmentKey) =>
+                      segmentKeys.add(segmentKey),
+                    );
+                  }
+                });
+              }
+            });
+          }
+        });
+      }
+
+      // force
+      if (feature.environments[environment].force) {
+        feature.environments[environment].force?.forEach((force) => {
+          if (force.segments) {
+            extractSegmentKeysFromGroupSegments(force.segments).forEach((segmentKey) =>
+              segmentKeys.add(segmentKey),
+            );
+          }
+        });
+      }
+
+      // rules
+      if (feature.environments[environment].rules) {
+        feature.environments[environment].rules?.forEach((rule) => {
+          extractSegmentKeysFromGroupSegments(rule.segments).forEach((segmentKey) =>
+            segmentKeys.add(segmentKey),
+          );
+        });
+      }
+    });
+
+    if (segmentKeys.has(segmentKey)) {
+      usedInFeatures.add(featureKey);
+    }
+  }
+
+  return usedInFeatures;
+}
+
+export interface AttributeUsage {
+  features: Set<FeatureKey>;
+  segments: Set<SegmentKey>;
+}
+
+export async function findAttributeUsage(
+  deps: Dependencies,
+  attributeKey: AttributeKey,
+): Promise<AttributeUsage> {
+  const { datasource, projectConfig } = deps;
+
+  const usedIn: AttributeUsage = {
+    features: new Set<FeatureKey>(),
+    segments: new Set<SegmentKey>(),
+  };
+
+  // features
+  const featureKeys = await datasource.listFeatures();
+  for (const featureKey of featureKeys) {
+    const feature = await datasource.readFeature(featureKey);
+    const attributeKeys = new Set<AttributeKey>();
+
+    // variable overrides inside variations
+    projectConfig.environments.forEach((environment) => {
+      if (feature.variations) {
+        feature.variations.forEach((variation) => {
+          if (variation.variables) {
+            variation.variables.forEach((variable) => {
+              if (variable.overrides) {
+                variable.overrides.forEach((override) => {
+                  if (override.conditions) {
+                    extractAttributeKeysFromConditions(override.conditions).forEach(
+                      (attributeKey) => attributeKeys.add(attributeKey),
+                    );
+                  }
+                });
+              }
+            });
+          }
+        });
+      }
+
+      // force
+      if (feature.environments[environment].force) {
+        feature.environments[environment].force?.forEach((force) => {
+          if (force.conditions) {
+            extractAttributeKeysFromConditions(force.conditions).forEach((attributeKey) =>
+              attributeKeys.add(attributeKey),
+            );
+          }
+        });
+      }
+    });
+
+    if (attributeKeys.has(attributeKey)) {
+      usedIn.features.add(featureKey);
+    }
+  }
+
+  // segments
+  const segmentKeys = await datasource.listSegments();
+  for (const segmentKey of segmentKeys) {
+    const segment = await datasource.readSegment(segmentKey);
+    const attributeKeys = new Set<AttributeKey>();
+
+    extractAttributeKeysFromConditions(segment.conditions as Condition | Condition[]).forEach(
+      (attributeKey) => {
+        attributeKeys.add(attributeKey);
+      },
+    );
+
+    if (attributeKeys.has(attributeKey)) {
+      usedIn.segments.add(segmentKey);
+    }
+  }
+
+  return usedIn;
+}
+
+export async function findUnusedSegments(deps: Dependencies): Promise<Set<SegmentKey>> {
+  const { datasource } = deps;
+
+  const segmentKeys = await datasource.listSegments();
+  const unusedSegments = new Set<SegmentKey>();
+
+  for (const segmentKey of segmentKeys) {
+    const usedInFeatures = await findSegmentUsage(deps, segmentKey);
+
+    if (usedInFeatures.size === 0) {
+      unusedSegments.add(segmentKey);
+    }
+  }
+
+  return unusedSegments;
+}
+
+export async function findUnusedAttributes(deps: Dependencies): Promise<Set<AttributeKey>> {
+  const { datasource } = deps;
+
+  const attributeKeys = await datasource.listAttributes();
+  const unusedAttributes = new Set<AttributeKey>();
+
+  for (const attributeKey of attributeKeys) {
+    const usedIn = await findAttributeUsage(deps, attributeKey);
+
+    if (usedIn.features.size === 0 && usedIn.segments.size === 0) {
+      unusedAttributes.add(attributeKey);
+    }
+  }
+
+  return unusedAttributes;
+}
+
+export interface FindUsageOptions {
+  segment?: string;
+  attribute?: string;
+
+  unusedSegments?: boolean;
+  unusedAttributes?: boolean;
+}
+
+export async function findUsageInProject(deps: Dependencies, options: FindUsageOptions) {
+  console.log("");
+
+  // segment
+  if (options.segment) {
+    const usedInFeatures = await findSegmentUsage(deps, options.segment);
+
+    if (usedInFeatures.size === 0) {
+      console.log(`Segment "${options.segment}" is not used in any features.`);
+    } else {
+      console.log(`Segment "${options.segment}" is used in the following features:\n`);
+
+      usedInFeatures.forEach((featureKey) => {
+        console.log(`  - ${featureKey}`);
+      });
+    }
+
+    return;
+  }
+
+  // attribute
+  if (options.attribute) {
+    const usedIn = await findAttributeUsage(deps, options.attribute);
+
+    if (usedIn.features.size === 0 && usedIn.segments.size === 0) {
+      console.log(`Attribute "${options.attribute}" is not used in any features or segments.`);
+
+      return;
+    }
+
+    if (usedIn.features.size > 0) {
+      console.log(`Attribute "${options.attribute}" is used in the following features:\n`);
+
+      usedIn.features.forEach((featureKey) => {
+        console.log(`  - ${featureKey}`);
+      });
+
+      console.log("");
+    }
+
+    if (usedIn.segments.size > 0) {
+      console.log(`Attribute "${options.attribute}" is used in the following segments:\n`);
+
+      usedIn.segments.forEach((segmentKey) => {
+        console.log(`  - ${segmentKey}`);
+      });
+    }
+
+    return;
+  }
+
+  // unused segments
+  if (options.unusedSegments) {
+    const unusedSegments = await findUnusedSegments(deps);
+
+    if (unusedSegments.size === 0) {
+      console.log("No unused segments found.");
+    } else {
+      console.log("Unused segments:\n");
+
+      unusedSegments.forEach((segmentKey) => {
+        console.log(`  - ${segmentKey}`);
+      });
+    }
+
+    return;
+  }
+
+  // unused attributes
+  if (options.unusedAttributes) {
+    const unusedAttributes = await findUnusedAttributes(deps);
+
+    if (unusedAttributes.size === 0) {
+      console.log("No unused attributes found.");
+    } else {
+      console.log("Unused attributes:\n");
+
+      unusedAttributes.forEach((attributeKey) => {
+        console.log(`  - ${attributeKey}`);
+      });
+    }
+
+    return;
+  }
+
+  console.log("Please specify a segment or attribute.");
+}
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index b16cfdc1..90a2c60c 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -7,5 +7,6 @@ export * from "./site";
 export * from "./generate-code";
 export * from "./restore";
 export * from "./find-duplicate-segments";
+export * from "./find-usage";
 export * from "./dependencies";
 export * from "./datasource";

From 4958688cc7892edeb54583ef5920975a2e6674e7 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Tue, 26 Mar 2024 21:45:20 +0000
Subject: [PATCH 23/48] v1.13.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 537c2ef1..bc9a186d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+
+### Features
+
+* find usage of segments and attributes ([#289](https://github.com/featurevisor/featurevisor/issues/289)) ([c1319b3](https://github.com/featurevisor/featurevisor/commit/c1319b32d46ae7bbb03eb7b7e5dd19e37f2be51d))
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index f39f61dd..c474910d 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 67987fab..4b7fc178 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.12.0"
+    "@featurevisor/cli": "^1.13.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index b92bb12b..c129e162 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 139b8dfb..9683d690 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.12.0"
+    "@featurevisor/cli": "^1.13.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 62b4b8e2..567e0b58 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 8b0813aa..46f8b756 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.12.0",
+    "@featurevisor/cli": "^1.13.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 9969c941..040347b9 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 81dbbb9c..b3688f90 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.12.0"
+    "@featurevisor/cli": "^1.13.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 2e294ab3..c2ffe49a 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index d212f311..7d6f662d 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.12.0"
+    "@featurevisor/cli": "^1.13.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index f85a4ffd..788698ac 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.12.0"
+  "version": "1.13.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 9c58dad9..af0bf74a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.12.0"
+        "@featurevisor/cli": "^1.13.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.12.0"
+        "@featurevisor/cli": "^1.13.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.12.0",
+        "@featurevisor/cli": "^1.13.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.12.0"
+        "@featurevisor/cli": "^1.13.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.12.0"
+        "@featurevisor/cli": "^1.13.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.12.0",
+        "@featurevisor/core": "^1.13.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.12.0",
+      "version": "1.13.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.11.1",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index d778fa2b..4bf417b7 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+
+### Features
+
+* find usage of segments and attributes ([#289](https://github.com/featurevisor/featurevisor/issues/289)) ([c1319b3](https://github.com/featurevisor/featurevisor/commit/c1319b32d46ae7bbb03eb7b7e5dd19e37f2be51d))
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 **Note:** Version bump only for package @featurevisor/cli
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 098a0ae3..380f9fba 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.12.0",
+    "@featurevisor/core": "^1.13.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 443cfd08..70d69fb2 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
+
+
+### Features
+
+* find usage of segments and attributes ([#289](https://github.com/featurevisor/featurevisor/issues/289)) ([c1319b3](https://github.com/featurevisor/featurevisor/commit/c1319b32d46ae7bbb03eb7b7e5dd19e37f2be51d))
+
+
+
+
+
 # [1.12.0](https://github.com/featurevisor/featurevisor/compare/v1.11.1...v1.12.0) (2024-03-23)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 6e1e0af6..e3092118 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From 070d7eced9c20cbfdd4839345234dbafda39c1e3 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Wed, 27 Mar 2024 18:50:17 +0100
Subject: [PATCH 24/48] fix: internal improvements for finding usage (#290)

---
 packages/core/src/find-usage/index.ts | 207 ++++++++++++++++----------
 1 file changed, 131 insertions(+), 76 deletions(-)

diff --git a/packages/core/src/find-usage/index.ts b/packages/core/src/find-usage/index.ts
index 2e19a611..2fa95f66 100644
--- a/packages/core/src/find-usage/index.ts
+++ b/packages/core/src/find-usage/index.ts
@@ -6,19 +6,49 @@ import {
   extractSegmentKeysFromGroupSegments,
 } from "../utils/extractKeys";
 
-export async function findSegmentUsage(
-  deps: Dependencies,
-  segmentKey: SegmentKey,
-): Promise<Set<FeatureKey>> {
+export interface UsageInFeatures {
+  [featureKey: string]: {
+    features: Set<FeatureKey>;
+    segments: Set<SegmentKey>;
+    attributes: Set<AttributeKey>;
+  };
+}
+
+export async function findAllUsageInFeatures(deps: Dependencies): Promise<UsageInFeatures> {
   const { datasource, projectConfig } = deps;
+  const usageInFeatures: UsageInFeatures = {};
 
   const featureKeys = await datasource.listFeatures();
 
-  const usedInFeatures = new Set<FeatureKey>();
-
   for (const featureKey of featureKeys) {
     const feature = await datasource.readFeature(featureKey);
-    const segmentKeys = new Set<SegmentKey>();
+    usageInFeatures[featureKey] = {
+      features: new Set<FeatureKey>(),
+      segments: new Set<SegmentKey>(),
+      attributes: new Set<AttributeKey>(),
+    };
+
+    // required
+    if (feature.required) {
+      feature.required.forEach((required) => {
+        if (typeof required === "string") {
+          usageInFeatures[featureKey].features.add(required);
+        } else if (typeof required === "object" && required.key) {
+          usageInFeatures[featureKey].features.add(required.key);
+        }
+      });
+    }
+
+    // bucketBy
+    if (feature.bucketBy) {
+      if (typeof feature.bucketBy === "string") {
+        usageInFeatures[featureKey].attributes.add(feature.bucketBy);
+      } else if (Array.isArray(feature.bucketBy)) {
+        feature.bucketBy.forEach((b) => usageInFeatures[featureKey].attributes.add(b));
+      } else if (typeof feature.bucketBy === "object" && feature.bucketBy.or) {
+        feature.bucketBy.or.forEach((b) => usageInFeatures[featureKey].attributes.add(b));
+      }
+    }
 
     // variable overrides inside variations
     projectConfig.environments.forEach((environment) => {
@@ -30,7 +60,13 @@ export async function findSegmentUsage(
                 variable.overrides.forEach((override) => {
                   if (override.segments) {
                     extractSegmentKeysFromGroupSegments(override.segments).forEach((segmentKey) =>
-                      segmentKeys.add(segmentKey),
+                      usageInFeatures[featureKey].segments.add(segmentKey),
+                    );
+                  }
+
+                  if (override.conditions) {
+                    extractAttributeKeysFromConditions(override.conditions).forEach(
+                      (attributeKey) => usageInFeatures[featureKey].attributes.add(attributeKey),
                     );
                   }
                 });
@@ -45,7 +81,13 @@ export async function findSegmentUsage(
         feature.environments[environment].force?.forEach((force) => {
           if (force.segments) {
             extractSegmentKeysFromGroupSegments(force.segments).forEach((segmentKey) =>
-              segmentKeys.add(segmentKey),
+              usageInFeatures[featureKey].segments.add(segmentKey),
+            );
+          }
+
+          if (force.conditions) {
+            extractAttributeKeysFromConditions(force.conditions).forEach((attributeKey) =>
+              usageInFeatures[featureKey].attributes.add(attributeKey),
             );
           }
         });
@@ -55,13 +97,54 @@ export async function findSegmentUsage(
       if (feature.environments[environment].rules) {
         feature.environments[environment].rules?.forEach((rule) => {
           extractSegmentKeysFromGroupSegments(rule.segments).forEach((segmentKey) =>
-            segmentKeys.add(segmentKey),
+            usageInFeatures[featureKey].segments.add(segmentKey),
           );
         });
       }
     });
+  }
 
-    if (segmentKeys.has(segmentKey)) {
+  return usageInFeatures;
+}
+
+export interface UsageInSegments {
+  [segmentKey: string]: {
+    attributes: Set<AttributeKey>;
+  };
+}
+
+export async function findAllUsageInSegments(deps: Dependencies): Promise<UsageInSegments> {
+  const { datasource } = deps;
+  const usageInSegments: UsageInSegments = {};
+
+  const segmentKeys = await datasource.listSegments();
+
+  for (const segmentKey of segmentKeys) {
+    const segment = await datasource.readSegment(segmentKey);
+    usageInSegments[segmentKey] = {
+      attributes: new Set<AttributeKey>(),
+    };
+
+    extractAttributeKeysFromConditions(segment.conditions as Condition | Condition[]).forEach(
+      (attributeKey) => {
+        usageInSegments[segmentKey].attributes.add(attributeKey);
+      },
+    );
+  }
+
+  return usageInSegments;
+}
+
+export async function findSegmentUsage(
+  deps: Dependencies,
+  segmentKey: SegmentKey,
+): Promise<Set<FeatureKey>> {
+  const usedInFeatures = new Set<FeatureKey>();
+
+  const usageInFeatures = await findAllUsageInFeatures(deps);
+
+  for (const featureKey in usageInFeatures) {
+    if (usageInFeatures[featureKey].segments.has(segmentKey)) {
       usedInFeatures.add(featureKey);
     }
   }
@@ -78,69 +161,22 @@ export async function findAttributeUsage(
   deps: Dependencies,
   attributeKey: AttributeKey,
 ): Promise<AttributeUsage> {
-  const { datasource, projectConfig } = deps;
-
   const usedIn: AttributeUsage = {
     features: new Set<FeatureKey>(),
     segments: new Set<SegmentKey>(),
   };
 
-  // features
-  const featureKeys = await datasource.listFeatures();
-  for (const featureKey of featureKeys) {
-    const feature = await datasource.readFeature(featureKey);
-    const attributeKeys = new Set<AttributeKey>();
+  const usageInFeatures = await findAllUsageInFeatures(deps);
+  const usageInSegments = await findAllUsageInSegments(deps);
 
-    // variable overrides inside variations
-    projectConfig.environments.forEach((environment) => {
-      if (feature.variations) {
-        feature.variations.forEach((variation) => {
-          if (variation.variables) {
-            variation.variables.forEach((variable) => {
-              if (variable.overrides) {
-                variable.overrides.forEach((override) => {
-                  if (override.conditions) {
-                    extractAttributeKeysFromConditions(override.conditions).forEach(
-                      (attributeKey) => attributeKeys.add(attributeKey),
-                    );
-                  }
-                });
-              }
-            });
-          }
-        });
-      }
-
-      // force
-      if (feature.environments[environment].force) {
-        feature.environments[environment].force?.forEach((force) => {
-          if (force.conditions) {
-            extractAttributeKeysFromConditions(force.conditions).forEach((attributeKey) =>
-              attributeKeys.add(attributeKey),
-            );
-          }
-        });
-      }
-    });
-
-    if (attributeKeys.has(attributeKey)) {
+  for (const featureKey in usageInFeatures) {
+    if (usageInFeatures[featureKey].attributes.has(attributeKey)) {
       usedIn.features.add(featureKey);
     }
   }
 
-  // segments
-  const segmentKeys = await datasource.listSegments();
-  for (const segmentKey of segmentKeys) {
-    const segment = await datasource.readSegment(segmentKey);
-    const attributeKeys = new Set<AttributeKey>();
-
-    extractAttributeKeysFromConditions(segment.conditions as Condition | Condition[]).forEach(
-      (attributeKey) => {
-        attributeKeys.add(attributeKey);
-      },
-    );
-
-    if (attributeKeys.has(attributeKey)) {
+  for (const segmentKey in usageInSegments) {
+    if (usageInSegments[segmentKey].attributes.has(attributeKey)) {
       usedIn.segments.add(segmentKey);
     }
   }
@@ -150,34 +186,53 @@ export async function findAttributeUsage(
 
 export async function findUnusedSegments(deps: Dependencies): Promise<Set<SegmentKey>> {
   const { datasource } = deps;
-
-  const segmentKeys = await datasource.listSegments();
   const unusedSegments = new Set<SegmentKey>();
 
-  for (const segmentKey of segmentKeys) {
-    const usedInFeatures = await findSegmentUsage(deps, segmentKey);
+  const allSegmentKeys = await datasource.listSegments();
+  const usageInFeatures = await findAllUsageInFeatures(deps);
+  const usedSegmentKeys = new Set<SegmentKey>();
 
-    if (usedInFeatures.size === 0) {
+  for (const featureKey in usageInFeatures) {
+    usageInFeatures[featureKey].segments.forEach((segmentKey) => {
+      usedSegmentKeys.add(segmentKey);
+    });
+  }
+
+  allSegmentKeys.forEach((segmentKey) => {
+    if (!usedSegmentKeys.has(segmentKey)) {
       unusedSegments.add(segmentKey);
     }
-  }
+  });
 
   return unusedSegments;
 }
 
 export async function findUnusedAttributes(deps: Dependencies): Promise<Set<AttributeKey>> {
   const { datasource } = deps;
-
-  const attributeKeys = await datasource.listAttributes();
   const unusedAttributes = new Set<AttributeKey>();
 
-  for (const attributeKey of attributeKeys) {
-    const usedIn = await findAttributeUsage(deps, attributeKey);
+  const allAttributeKeys = await datasource.listAttributes();
+  const usageInFeatures = await findAllUsageInFeatures(deps);
+  const usageInSegments = await findAllUsageInSegments(deps);
+  const usedAttributeKeys = new Set<AttributeKey>();
 
-    if (usedIn.features.size === 0 && usedIn.segments.size === 0) {
+  for (const featureKey in usageInFeatures) {
+    usageInFeatures[featureKey].attributes.forEach((attributeKey) => {
+      usedAttributeKeys.add(attributeKey);
+    });
+  }
+
+  for (const segmentKey in usageInSegments) {
+    usageInSegments[segmentKey].attributes.forEach((attributeKey) => {
+      usedAttributeKeys.add(attributeKey);
+    });
+  }
+
+  allAttributeKeys.forEach((attributeKey) => {
+    if (!usedAttributeKeys.has(attributeKey)) {
       unusedAttributes.add(attributeKey);
     }
-  }
+  });
 
   return unusedAttributes;
 }

From 806b52ab8a519b05f31362f48cdb134d5a794976 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Wed, 27 Mar 2024 17:52:59 +0000
Subject: [PATCH 25/48] v1.13.1

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 |  8 +++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 97 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bc9a186d..d0bba953 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+
+### Bug Fixes
+
+* internal improvements for finding usage ([#290](https://github.com/featurevisor/featurevisor/issues/290)) ([070d7ec](https://github.com/featurevisor/featurevisor/commit/070d7eced9c20cbfdd4839345234dbafda39c1e3))
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index c474910d..007a27e7 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 4b7fc178..e61db6f2 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.0"
+    "@featurevisor/cli": "^1.13.1"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index c129e162..2f3d493a 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 9683d690..19230bbd 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.0"
+    "@featurevisor/cli": "^1.13.1"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 567e0b58..aec96f8c 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 46f8b756..f56aea84 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.0",
+    "@featurevisor/cli": "^1.13.1",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 040347b9..9d34b334 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index b3688f90..ac38aa12 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.0"
+    "@featurevisor/cli": "^1.13.1"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index c2ffe49a..e2682531 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 7d6f662d..2dc613bb 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.0"
+    "@featurevisor/cli": "^1.13.1"
   }
 }
diff --git a/lerna.json b/lerna.json
index 788698ac..ad0a823b 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.13.0"
+  "version": "1.13.1"
 }
diff --git a/package-lock.json b/package-lock.json
index af0bf74a..b809fdc1 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.0"
+        "@featurevisor/cli": "^1.13.1"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.0"
+        "@featurevisor/cli": "^1.13.1"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.0",
+        "@featurevisor/cli": "^1.13.1",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.0"
+        "@featurevisor/cli": "^1.13.1"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.0"
+        "@featurevisor/cli": "^1.13.1"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.13.0",
+        "@featurevisor/core": "^1.13.1",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.13.0",
+      "version": "1.13.1",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.11.1",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 4bf417b7..0653c022 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+**Note:** Version bump only for package @featurevisor/cli
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 380f9fba..7a345923 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.13.0",
+    "@featurevisor/core": "^1.13.1",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 70d69fb2..b0dbcadd 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
+
+
+### Bug Fixes
+
+* internal improvements for finding usage ([#290](https://github.com/featurevisor/featurevisor/issues/290)) ([070d7ec](https://github.com/featurevisor/featurevisor/commit/070d7eced9c20cbfdd4839345234dbafda39c1e3))
+
+
+
+
+
 # [1.13.0](https://github.com/featurevisor/featurevisor/compare/v1.12.0...v1.13.0) (2024-03-26)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index e3092118..755e0f1e 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From 6abcecc3a92f00ccea7dcb542676126b6eb3b778 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Tue, 2 Apr 2024 18:11:29 +0200
Subject: [PATCH 26/48] feat: benchmarking option in CLI (#292)

---
 docs/cli.md                          |  44 ++++++++
 packages/cli/src/index.ts            |  48 +++++++++
 packages/core/src/benchmark/index.ts | 150 +++++++++++++++++++++++++++
 packages/core/src/index.ts           |   1 +
 4 files changed, 243 insertions(+)
 create mode 100644 packages/core/src/benchmark/index.ts

diff --git a/docs/cli.md b/docs/cli.md
index 85055ee1..cf59204a 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -147,3 +147,47 @@ $ npx featurevisor find-usage --unusedSegments
 ```
 $ npx featurevisor find-usage --unusedAttributes
 ```
+
+## Benchmarking
+
+You can measure how fast or slow your SDK evaluations are for particular features.
+
+The `--n` option is used to specify the number of iterations to run the benchmark for.
+
+### Feature
+
+To benchmark evaluating a feature itself if it is enabled or disabled via SDK's `.isEnabled()` method:
+
+```
+$ npx featurevisor benchmark \
+  --environment=production \
+  --feature=my_feature \
+  --context='{"userId": "123"}' \
+  --n=1000
+```
+
+### Variation
+
+To benchmark evaluating a feature's variation via SDKs's `.getVariation()` method:
+
+```
+$ npx featurevisor benchmark \
+  --environment=production \
+  --feature=my_feature \
+  --variation \
+  --context='{"userId": "123"}' \
+  --n=1000
+```
+
+### Variable
+
+To benchmark evaluating a feature's variable via SDKs's `.getVariable()` method:
+
+```
+$ npx featurevisor benchmark \
+  --environment=production \
+  --feature=my_feature \
+  --variable=my_variable_key \
+  --context='{"userId": "123"}' \
+  --n=1000
+```
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 8648969c..ad6654fb 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -22,6 +22,7 @@ import {
   restoreProject,
   Dependencies,
   Datasource,
+  benchmarkFeature,
 } from "@featurevisor/core";
 
 process.on("unhandledRejection", (reason) => {
@@ -261,6 +262,53 @@ async function main() {
     .example("$0 find-usage --unusedSegments", "find unused segments")
     .example("$0 find-usage --unusedAttributes", "find unused attributes")
 
+    /**
+     * Benchmark features
+     */
+    .command({
+      command: "benchmark",
+      handler: async function (options) {
+        if (!options.environment) {
+          console.error("Please specify an environment with --environment flag.");
+          process.exit(1);
+        }
+
+        if (!options.feature) {
+          console.error("Please specify a feature with --feature flag.");
+          process.exit(1);
+        }
+
+        const deps = await getDependencies(options);
+
+        try {
+          await benchmarkFeature(deps, {
+            environment: options.environment,
+            feature: options.feature,
+            n: parseInt(options.n, 10) || 1,
+            context: options.context ? JSON.parse(options.context) : {},
+            variation: options.variation || undefined,
+            variable: options.variable || undefined,
+          });
+        } catch (e) {
+          console.error(e.message);
+          process.exit(1);
+        }
+      },
+    })
+    .example("$0 benchmark", "benchmark feature evaluations")
+    .example(
+      "$0 benchmark --environment=production --feature=my_feature --context='{}' -n=100",
+      "benchmark feature flag evaluation",
+    )
+    .example(
+      "$0 benchmark --environment=production --feature=my_feature --context='{}' --variation -n=100",
+      "benchmark feature variation evaluation",
+    )
+    .example(
+      "$0 benchmark --environment=production --feature=my_feature --context='{}' --variable=my_variable_key -n=100",
+      "benchmark feature variable evaluation",
+    )
+
     /**
      * Options
      */
diff --git a/packages/core/src/benchmark/index.ts b/packages/core/src/benchmark/index.ts
new file mode 100644
index 00000000..bd0f97a2
--- /dev/null
+++ b/packages/core/src/benchmark/index.ts
@@ -0,0 +1,150 @@
+import { Context } from "@featurevisor/types";
+import { FeaturevisorInstance, createInstance } from "@featurevisor/sdk";
+
+import { SCHEMA_VERSION } from "../config";
+import { buildDatafile } from "../builder";
+import { Dependencies } from "../dependencies";
+import { prettyDuration } from "../tester/prettyDuration";
+
+export interface BenchmarkOutput {
+  value: any;
+  duration: number; // ms
+}
+
+export function benchmarkFeatureFlag(
+  f: FeaturevisorInstance,
+  featureKey: string,
+  context: Record<string, unknown>,
+  n: number,
+): BenchmarkOutput {
+  const start = Date.now();
+  let value: any;
+
+  for (let i = 0; i < n; i++) {
+    value = f.isEnabled(featureKey, context as Context);
+  }
+
+  const duration = Date.now() - start;
+
+  return {
+    value,
+    duration,
+  };
+}
+
+export function benchmarkFeatureVariation(
+  f: FeaturevisorInstance,
+  featureKey: string,
+  context: Record<string, unknown>,
+  n: number,
+): BenchmarkOutput {
+  const start = Date.now();
+  let value: any;
+
+  for (let i = 0; i < n; i++) {
+    value = f.getVariation(featureKey, context as Context);
+  }
+
+  const duration = Date.now() - start;
+
+  return {
+    value,
+    duration,
+  };
+}
+
+export function benchmarkFeatureVariable(
+  f: FeaturevisorInstance,
+  featureKey: string,
+  variableKey: string,
+  context: Record<string, unknown>,
+  n: number,
+): BenchmarkOutput {
+  const start = Date.now();
+  let value: any;
+
+  for (let i = 0; i < n; i++) {
+    value = f.getVariable(featureKey, variableKey, context as Context);
+  }
+
+  const duration = Date.now() - start;
+
+  return {
+    value,
+    duration,
+  };
+}
+
+export interface BenchmarkOptions {
+  environment: string;
+  feature: string;
+  n: number;
+  context: Record<string, unknown>;
+  variation?: boolean;
+  variable?: string;
+}
+
+export async function benchmarkFeature(
+  deps: Dependencies,
+  options: BenchmarkOptions,
+): Promise<void> {
+  const { datasource, projectConfig } = deps;
+
+  console.log("");
+  console.log(`Running benchmark for feature "${options.feature}"...`);
+
+  console.log("");
+
+  console.log(`Building datafile containing all features for "${options.environment}"...`);
+  const datafileBuildStart = Date.now();
+  const existingState = await datasource.readState(options.environment);
+  const datafileContent = await buildDatafile(
+    projectConfig,
+    datasource,
+    {
+      schemaVersion: SCHEMA_VERSION,
+      revision: "include-all-features",
+      environment: options.environment,
+    },
+    existingState,
+  );
+  const datafileBuildDuration = Date.now() - datafileBuildStart;
+  console.log(`Datafile build duration: ${datafileBuildDuration}ms`);
+
+  console.log("");
+
+  const f = createInstance({
+    datafile: datafileContent,
+  });
+  console.log("...SDK initialized");
+
+  console.log("");
+  console.log(`Against context: ${JSON.stringify(options.context)}`);
+
+  let output: BenchmarkOutput;
+  if (options.variable) {
+    // variable
+    console.log(`Evaluating variable "${options.variable}" ${options.n} times...`);
+    output = benchmarkFeatureVariable(
+      f,
+      options.feature,
+      options.variable,
+      options.context,
+      options.n,
+    );
+  } else if (options.variation) {
+    // variation
+    console.log(`Evaluating variation ${options.n} times...`);
+    output = benchmarkFeatureVariation(f, options.feature, options.context, options.n);
+  } else {
+    // flag
+    console.log(`Evaluating flag ${options.n} times...`);
+    output = benchmarkFeatureFlag(f, options.feature, options.context, options.n);
+  }
+
+  console.log("");
+
+  console.log(`Evaluated value : ${JSON.stringify(output.value)}`);
+  console.log(`Total duration  : ${prettyDuration(output.duration)}`);
+  console.log(`Average duration: ${prettyDuration(output.duration / options.n)}`);
+}
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 90a2c60c..a1a93bf3 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -10,3 +10,4 @@ export * from "./find-duplicate-segments";
 export * from "./find-usage";
 export * from "./dependencies";
 export * from "./datasource";
+export * from "./benchmark";

From 22d022a6f9b05f3b70ffcd95cab1779bd74292f2 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Tue, 2 Apr 2024 16:14:08 +0000
Subject: [PATCH 27/48] v1.14.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d0bba953..46d8fcd4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+
+### Features
+
+* benchmarking option in CLI ([#292](https://github.com/featurevisor/featurevisor/issues/292)) ([6abcecc](https://github.com/featurevisor/featurevisor/commit/6abcecc3a92f00ccea7dcb542676126b6eb3b778))
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index 007a27e7..b6b3076c 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index e61db6f2..fe0e93ec 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.1"
+    "@featurevisor/cli": "^1.14.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 2f3d493a..42b4a514 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 19230bbd..a900cfbe 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.1"
+    "@featurevisor/cli": "^1.14.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index aec96f8c..0f8de867 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index f56aea84..8517d158 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.1",
+    "@featurevisor/cli": "^1.14.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 9d34b334..2a062af5 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index ac38aa12..d5247c10 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.1"
+    "@featurevisor/cli": "^1.14.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index e2682531..f02133b6 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 2dc613bb..35d6a75c 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.13.1"
+    "@featurevisor/cli": "^1.14.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index ad0a823b..b0e6ec05 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.13.1"
+  "version": "1.14.0"
 }
diff --git a/package-lock.json b/package-lock.json
index b809fdc1..b14114dd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.1"
+        "@featurevisor/cli": "^1.14.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.1"
+        "@featurevisor/cli": "^1.14.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.1",
+        "@featurevisor/cli": "^1.14.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.1"
+        "@featurevisor/cli": "^1.14.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.13.1"
+        "@featurevisor/cli": "^1.14.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.13.1",
+        "@featurevisor/core": "^1.14.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.13.1",
+      "version": "1.14.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.11.1",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 0653c022..cc5fcaef 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+
+### Features
+
+* benchmarking option in CLI ([#292](https://github.com/featurevisor/featurevisor/issues/292)) ([6abcecc](https://github.com/featurevisor/featurevisor/commit/6abcecc3a92f00ccea7dcb542676126b6eb3b778))
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 **Note:** Version bump only for package @featurevisor/cli
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 7a345923..561a8f99 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.13.1",
+    "@featurevisor/core": "^1.14.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index b0dbcadd..361f2ca2 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
+
+
+### Features
+
+* benchmarking option in CLI ([#292](https://github.com/featurevisor/featurevisor/issues/292)) ([6abcecc](https://github.com/featurevisor/featurevisor/commit/6abcecc3a92f00ccea7dcb542676126b6eb3b778))
+
+
+
+
+
 ## [1.13.1](https://github.com/featurevisor/featurevisor/compare/v1.13.0...v1.13.1) (2024-03-27)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 755e0f1e..94208aa9 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From a83f6fa4d21012b2e0c0d97ab6bb182f9aa4c1af Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Thu, 4 Apr 2024 18:31:20 +0200
Subject: [PATCH 28/48] feat: show project configuration via CLI (#293)

---
 docs/cli.md                               | 14 ++++++
 packages/cli/src/index.ts                 | 19 +++++++++
 packages/core/src/config/projectConfig.ts | 52 ++++++++++++++++++-----
 3 files changed, 74 insertions(+), 11 deletions(-)

diff --git a/docs/cli.md b/docs/cli.md
index cf59204a..47ccddd6 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -191,3 +191,17 @@ $ npx featurevisor benchmark \
   --context='{"userId": "123"}' \
   --n=1000
 ```
+
+## Configuration
+
+To view the project [configuration](/docs/configuration):
+
+```
+$ npx featurevisor config
+```
+
+Printing configuration as JSON:
+
+```
+$ npx featurevisor config --print --pretty
+```
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index ad6654fb..a9e319d1 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -23,6 +23,7 @@ import {
   Dependencies,
   Datasource,
   benchmarkFeature,
+  showProjectConfig,
 } from "@featurevisor/core";
 
 process.on("unhandledRejection", (reason) => {
@@ -309,6 +310,24 @@ async function main() {
       "benchmark feature variable evaluation",
     )
 
+    /**
+     * Show config
+     */
+    .command({
+      command: "config",
+      handler: async function (options) {
+        const projectConfig = requireAndGetProjectConfig(rootDirectoryPath);
+
+        showProjectConfig(projectConfig, {
+          print: options.print,
+          pretty: options.pretty,
+        });
+      },
+    })
+    .example("$0 config", "show project configuration")
+    .example("$0 config --print", "print project configuration as JSON")
+    .example("$0 config --print --pretty", "print project configuration as prettified JSON")
+
     /**
      * Options
      */
diff --git a/packages/core/src/config/projectConfig.ts b/packages/core/src/config/projectConfig.ts
index 6b1cdda6..ac1a0279 100644
--- a/packages/core/src/config/projectConfig.ts
+++ b/packages/core/src/config/projectConfig.ts
@@ -50,15 +50,6 @@ export interface ProjectConfig {
 // rootDirectoryPath: path to the root directory of the project (without ending with a slash)
 export function getProjectConfig(rootDirectoryPath: string): ProjectConfig {
   const baseConfig: ProjectConfig = {
-    featuresDirectoryPath: path.join(rootDirectoryPath, FEATURES_DIRECTORY_NAME),
-    segmentsDirectoryPath: path.join(rootDirectoryPath, SEGMENTS_DIRECTORY_NAME),
-    attributesDirectoryPath: path.join(rootDirectoryPath, ATTRIBUTES_DIRECTORY_NAME),
-    groupsDirectoryPath: path.join(rootDirectoryPath, GROUPS_DIRECTORY_NAME),
-    testsDirectoryPath: path.join(rootDirectoryPath, TESTS_DIRECTORY_NAME),
-
-    stateDirectoryPath: path.join(rootDirectoryPath, STATE_DIRECTORY_NAME),
-    outputDirectoryPath: path.join(rootDirectoryPath, OUTPUT_DIRECTORY_NAME),
-
     environments: DEFAULT_ENVIRONMENTS,
     tags: DEFAULT_TAGS,
     defaultBucketBy: "userId",
@@ -69,9 +60,16 @@ export function getProjectConfig(rootDirectoryPath: string): ProjectConfig {
     prettyDatafile: DEFAULT_PRETTY_DATAFILE,
     stringify: true,
 
-    siteExportDirectoryPath: path.join(rootDirectoryPath, SITE_EXPORT_DIRECTORY_NAME),
-
     adapter: FilesystemAdapter,
+
+    featuresDirectoryPath: path.join(rootDirectoryPath, FEATURES_DIRECTORY_NAME),
+    segmentsDirectoryPath: path.join(rootDirectoryPath, SEGMENTS_DIRECTORY_NAME),
+    attributesDirectoryPath: path.join(rootDirectoryPath, ATTRIBUTES_DIRECTORY_NAME),
+    groupsDirectoryPath: path.join(rootDirectoryPath, GROUPS_DIRECTORY_NAME),
+    testsDirectoryPath: path.join(rootDirectoryPath, TESTS_DIRECTORY_NAME),
+    stateDirectoryPath: path.join(rootDirectoryPath, STATE_DIRECTORY_NAME),
+    outputDirectoryPath: path.join(rootDirectoryPath, OUTPUT_DIRECTORY_NAME),
+    siteExportDirectoryPath: path.join(rootDirectoryPath, SITE_EXPORT_DIRECTORY_NAME),
   };
 
   const configModulePath = path.join(rootDirectoryPath, CONFIG_MODULE_NAME);
@@ -101,3 +99,35 @@ export function getProjectConfig(rootDirectoryPath: string): ProjectConfig {
 
   return finalConfig as ProjectConfig;
 }
+
+export interface ShowProjectConfigOptions {
+  print?: boolean;
+  pretty?: boolean;
+}
+
+export function showProjectConfig(
+  projectConfig: ProjectConfig,
+  options: ShowProjectConfigOptions = {},
+) {
+  if (options.print) {
+    console.log(
+      options.pretty ? JSON.stringify(projectConfig, null, 2) : JSON.stringify(projectConfig),
+    );
+
+    return;
+  }
+
+  console.log("\nProject configuration:\n");
+
+  const keys = Object.keys(projectConfig);
+  const longestKeyLength = keys.reduce((acc, key) => (key.length > acc ? key.length : acc), 0);
+  const ignoreKeys = ["adapter", "parser"];
+
+  for (const key of keys) {
+    if (ignoreKeys.indexOf(key) !== -1) {
+      continue;
+    }
+
+    console.log(`  - ${key.padEnd(longestKeyLength, " ")}: ${projectConfig[key]}`);
+  }
+}

From 243244cba5128205779b4b87237e442740d65db6 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Thu, 4 Apr 2024 16:34:01 +0000
Subject: [PATCH 29/48] v1.15.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 46d8fcd4..145efc97 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+
+### Features
+
+* show project configuration via CLI ([#293](https://github.com/featurevisor/featurevisor/issues/293)) ([a83f6fa](https://github.com/featurevisor/featurevisor/commit/a83f6fa4d21012b2e0c0d97ab6bb182f9aa4c1af))
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index b6b3076c..ad9eedb4 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index fe0e93ec..0281812e 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.14.0"
+    "@featurevisor/cli": "^1.15.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 42b4a514..ecacee6a 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index a900cfbe..30e0799e 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.14.0"
+    "@featurevisor/cli": "^1.15.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 0f8de867..684e105f 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 8517d158..a72ee9f9 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.14.0",
+    "@featurevisor/cli": "^1.15.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 2a062af5..f0e8dc00 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index d5247c10..b0c821fd 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.14.0"
+    "@featurevisor/cli": "^1.15.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index f02133b6..a4262c6c 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 35d6a75c..0c399805 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.14.0"
+    "@featurevisor/cli": "^1.15.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index b0e6ec05..6d5d21ac 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.14.0"
+  "version": "1.15.0"
 }
diff --git a/package-lock.json b/package-lock.json
index b14114dd..5f739a6c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.14.0"
+        "@featurevisor/cli": "^1.15.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.14.0"
+        "@featurevisor/cli": "^1.15.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.14.0",
+        "@featurevisor/cli": "^1.15.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.14.0"
+        "@featurevisor/cli": "^1.15.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.14.0"
+        "@featurevisor/cli": "^1.15.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.14.0",
+        "@featurevisor/core": "^1.15.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.14.0",
+      "version": "1.15.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.11.1",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index cc5fcaef..91925c24 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+
+### Features
+
+* show project configuration via CLI ([#293](https://github.com/featurevisor/featurevisor/issues/293)) ([a83f6fa](https://github.com/featurevisor/featurevisor/commit/a83f6fa4d21012b2e0c0d97ab6bb182f9aa4c1af))
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 561a8f99..b40a6966 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.14.0",
+    "@featurevisor/core": "^1.15.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 361f2ca2..5454f883 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
+
+
+### Features
+
+* show project configuration via CLI ([#293](https://github.com/featurevisor/featurevisor/issues/293)) ([a83f6fa](https://github.com/featurevisor/featurevisor/commit/a83f6fa4d21012b2e0c0d97ab6bb182f9aa4c1af))
+
+
+
+
+
 # [1.14.0](https://github.com/featurevisor/featurevisor/compare/v1.13.1...v1.14.0) (2024-04-02)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 94208aa9..8f1e83ac 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From aaf0afcf18a6bdad7d82349d70ac052c9f288ca0 Mon Sep 17 00:00:00 2001
From: Hasan Ali <122746025+dev-hans-programmer@users.noreply.github.com>
Date: Fri, 5 Apr 2024 21:32:41 +0530
Subject: [PATCH 30/48] feat: Added export of emitter module (#294)

---
 packages/sdk/src/index.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/sdk/src/index.ts b/packages/sdk/src/index.ts
index 7d1687de..b07d8205 100644
--- a/packages/sdk/src/index.ts
+++ b/packages/sdk/src/index.ts
@@ -2,3 +2,4 @@ export * from "./bucket";
 export * from "./instance";
 export * from "./logger";
 export * from "./conditions";
+export * from "./emitter";

From 9d73296020b22eab52d9d511cb933199551b5a21 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Fri, 5 Apr 2024 16:05:22 +0000
Subject: [PATCH 31/48] v1.16.0

---
 CHANGELOG.md                              | 11 +++++++
 examples/example-1/CHANGELOG.md           |  8 +++++
 examples/example-1/package.json           |  4 +--
 examples/example-json/CHANGELOG.md        |  8 +++++
 examples/example-json/package.json        |  4 +--
 examples/example-toml/CHANGELOG.md        |  8 +++++
 examples/example-toml/package.json        |  4 +--
 examples/example-yml-include/CHANGELOG.md |  8 +++++
 examples/example-yml-include/package.json |  4 +--
 examples/example-yml/CHANGELOG.md         |  8 +++++
 examples/example-yml/package.json         |  4 +--
 lerna.json                                |  2 +-
 package-lock.json                         | 38 +++++++++++------------
 packages/cli/CHANGELOG.md                 |  8 +++++
 packages/cli/package.json                 |  4 +--
 packages/core/CHANGELOG.md                |  8 +++++
 packages/core/package.json                |  4 +--
 packages/react/CHANGELOG.md               |  8 +++++
 packages/react/package.json               |  4 +--
 packages/sdk/CHANGELOG.md                 | 11 +++++++
 packages/sdk/package.json                 |  2 +-
 packages/vue/CHANGELOG.md                 |  8 +++++
 packages/vue/package.json                 |  4 +--
 23 files changed, 133 insertions(+), 39 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 145efc97..24779ca4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+
+### Features
+
+* Added export of emitter module ([#294](https://github.com/featurevisor/featurevisor/issues/294)) ([aaf0afc](https://github.com/featurevisor/featurevisor/commit/aaf0afcf18a6bdad7d82349d70ac052c9f288ca0))
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index ad9eedb4..e9169ff5 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 0281812e..3a6a255a 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.15.0"
+    "@featurevisor/cli": "^1.16.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index ecacee6a..248e1bfa 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 30e0799e..79bc1997 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.15.0"
+    "@featurevisor/cli": "^1.16.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 684e105f..65f99747 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index a72ee9f9..55976652 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.15.0",
+    "@featurevisor/cli": "^1.16.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index f0e8dc00..0c9e4f26 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index b0c821fd..5f3d3092 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.15.0"
+    "@featurevisor/cli": "^1.16.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index a4262c6c..3aa24038 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 0c399805..2b2d6726 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.15.0"
+    "@featurevisor/cli": "^1.16.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index 6d5d21ac..ae246e70 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.15.0"
+  "version": "1.16.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 5f739a6c..c9794b82 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.15.0"
+        "@featurevisor/cli": "^1.16.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.15.0"
+        "@featurevisor/cli": "^1.16.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.15.0",
+        "@featurevisor/cli": "^1.16.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.15.0"
+        "@featurevisor/cli": "^1.16.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.15.0"
+        "@featurevisor/cli": "^1.16.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.15.0",
+        "@featurevisor/core": "^1.16.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,10 +18829,10 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.15.0",
+      "version": "1.16.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.11.1",
+        "@featurevisor/sdk": "^1.16.0",
         "@featurevisor/site": "^1.7.1",
         "@featurevisor/types": "^1.3.0",
         "axios": "^1.3.4",
@@ -18893,10 +18893,10 @@
     },
     "packages/react": {
       "name": "@featurevisor/react",
-      "version": "1.11.1",
+      "version": "1.16.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.11.1",
+        "@featurevisor/sdk": "^1.16.0",
         "@featurevisor/types": "^1.3.0"
       },
       "devDependencies": {
@@ -18907,7 +18907,7 @@
     },
     "packages/sdk": {
       "name": "@featurevisor/sdk",
-      "version": "1.11.1",
+      "version": "1.16.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/types": "^1.3.0",
@@ -19145,10 +19145,10 @@
     },
     "packages/vue": {
       "name": "@featurevisor/vue",
-      "version": "1.11.1",
+      "version": "1.16.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.11.1",
+        "@featurevisor/sdk": "^1.16.0",
         "@featurevisor/types": "^1.3.0",
         "vue": "^3.3.4"
       },
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 91925c24..1de8ab15 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/cli
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index b40a6966..ec2c83f7 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.15.0",
+    "@featurevisor/core": "^1.16.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 5454f883..a9d339f4 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/core
+
+
+
+
+
 # [1.15.0](https://github.com/featurevisor/featurevisor/compare/v1.14.0...v1.15.0) (2024-04-04)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 8f1e83ac..f8750a65 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,7 +44,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/sdk": "^1.11.1",
+    "@featurevisor/sdk": "^1.16.0",
     "@featurevisor/site": "^1.7.1",
     "@featurevisor/types": "^1.3.0",
     "axios": "^1.3.4",
diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
index c2edf7b8..b727dce0 100644
--- a/packages/react/CHANGELOG.md
+++ b/packages/react/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/react
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/react
diff --git a/packages/react/package.json b/packages/react/package.json
index 54824e8e..1cbc22b9 100644
--- a/packages/react/package.json
+++ b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/react",
-  "version": "1.11.1",
+  "version": "1.16.0",
   "description": "React package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.11.1",
+    "@featurevisor/sdk": "^1.16.0",
     "@featurevisor/types": "^1.3.0"
   },
   "license": "MIT",
diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md
index a4628698..2d792ad2 100644
--- a/packages/sdk/CHANGELOG.md
+++ b/packages/sdk/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+
+### Features
+
+* Added export of emitter module ([#294](https://github.com/featurevisor/featurevisor/issues/294)) ([aaf0afc](https://github.com/featurevisor/featurevisor/commit/aaf0afcf18a6bdad7d82349d70ac052c9f288ca0))
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index e9059ef8..e602e918 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/sdk",
-  "version": "1.11.1",
+  "version": "1.16.0",
   "description": "Featurevisor SDK for Node.js and the browser",
   "main": "dist/index.js",
   "module": "lib/index.js",
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
index da0738a7..137dfc2d 100644
--- a/packages/vue/CHANGELOG.md
+++ b/packages/vue/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
+
+**Note:** Version bump only for package @featurevisor/vue
+
+
+
+
+
 ## [1.11.1](https://github.com/featurevisor/featurevisor/compare/v1.11.0...v1.11.1) (2024-03-14)
 
 **Note:** Version bump only for package @featurevisor/vue
diff --git a/packages/vue/package.json b/packages/vue/package.json
index 3344bb91..68bfd3bd 100644
--- a/packages/vue/package.json
+++ b/packages/vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/vue",
-  "version": "1.11.1",
+  "version": "1.16.0",
   "description": "Vue.js package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.11.1",
+    "@featurevisor/sdk": "^1.16.0",
     "@featurevisor/types": "^1.3.0",
     "vue": "^3.3.4"
   },

From 5a3332a226a3b4901445fe2fe04baa8320e94f48 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sun, 7 Apr 2024 23:38:06 +0200
Subject: [PATCH 32/48] feat: evaluate features in CLI (#295)

---
 docs/cli.md                         |  28 ++++++
 packages/cli/src/index.ts           |  39 ++++++++
 packages/core/src/evaluate/index.ts | 149 ++++++++++++++++++++++++++++
 packages/core/src/index.ts          |   1 +
 packages/core/src/utils/index.ts    |   1 +
 packages/core/src/utils/pretty.ts   |   3 +
 packages/sdk/src/feature.ts         |  40 ++++++--
 packages/sdk/src/instance.ts        | 111 ++++++++++++++++-----
 8 files changed, 337 insertions(+), 35 deletions(-)
 create mode 100644 packages/core/src/evaluate/index.ts
 create mode 100644 packages/core/src/utils/pretty.ts

diff --git a/docs/cli.md b/docs/cli.md
index 47ccddd6..d1ddc40d 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -205,3 +205,31 @@ Printing configuration as JSON:
 ```
 $ npx featurevisor config --print --pretty
 ```
+
+## Evaluate
+
+To learn why certain values (like feature and its variation or variables) are evaluated as they are:
+
+```
+$ npx featurevisor evaluate \
+  --environment=production \
+  --feature=my_feature \
+  --context='{"userId": "123", "country": "nl"}'
+```
+
+This will show you full [evaluation details](/docs/sdks/javascript/#evaluation-details) helping you debug better in case of any confusion.
+
+It is similar to [logging](/docs/sdks/javascript/#logging) in SDKs with `debug` level. But here instead, we are doing it at CLI directly in our Featurevisor project without having to involve our application(s).
+
+If you wish to print the evaluation details in plain JSON, you can pass `--print` at the end:
+
+```
+$ npx featurevisor evaluate \
+  --environment=production \
+  --feature=my_feature \
+  --context='{"userId": "123", "country": "nl"}' \
+  --print \
+  --pretty
+```
+
+The `--pretty` flag is optional.
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index a9e319d1..53355c19 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -24,6 +24,7 @@ import {
   Datasource,
   benchmarkFeature,
   showProjectConfig,
+  evaluateFeature,
 } from "@featurevisor/core";
 
 process.on("unhandledRejection", (reason) => {
@@ -328,6 +329,44 @@ async function main() {
     .example("$0 config --print", "print project configuration as JSON")
     .example("$0 config --print --pretty", "print project configuration as prettified JSON")
 
+    /**
+     * Evaluate
+     */
+    .command({
+      command: "evaluate",
+      handler: async function (options) {
+        if (!options.environment) {
+          console.error("Please specify an environment with --environment flag.");
+          process.exit(1);
+        }
+
+        if (!options.feature) {
+          console.error("Please specify a feature with --feature flag.");
+          process.exit(1);
+        }
+
+        const deps = await getDependencies(options);
+
+        try {
+          await evaluateFeature(deps, {
+            environment: options.environment,
+            feature: options.feature,
+            context: options.context ? JSON.parse(options.context) : {},
+            print: options.print,
+            pretty: options.pretty,
+          });
+        } catch (e) {
+          console.error(e.message);
+          process.exit(1);
+        }
+      },
+    })
+    .example("$0 evaluate", "evaluate a feature along with its variation and variables")
+    .example(
+      "$0 evaluate --environment=production --feature=my_feature --context='{}'",
+      "evaluate a feature against provided context",
+    )
+
     /**
      * Options
      */
diff --git a/packages/core/src/evaluate/index.ts b/packages/core/src/evaluate/index.ts
new file mode 100644
index 00000000..e85361c8
--- /dev/null
+++ b/packages/core/src/evaluate/index.ts
@@ -0,0 +1,149 @@
+import { Context } from "@featurevisor/types";
+import { Evaluation, createInstance, createLogger } from "@featurevisor/sdk";
+
+import { Dependencies } from "../dependencies";
+import { SCHEMA_VERSION } from "../config";
+import { buildDatafile } from "../builder";
+
+function printEvaluationDetails(evaluation: Evaluation) {
+  const ignoreKeys = ["featureKey", "variableKey", "traffic", "force"];
+
+  for (const [key, value] of Object.entries(evaluation)) {
+    if (ignoreKeys.indexOf(key) !== -1) {
+      continue;
+    }
+
+    if (key === "variation") {
+      console.log(`-`, `${key}:`, value?.value);
+      continue;
+    }
+
+    if (key === "variableSchema") {
+      console.log(`-`, `variableType:`, value.type);
+      console.log(`-`, `defaultValue:`, value.defaultValue);
+      continue;
+    }
+
+    console.log(`-`, `${key}:`, value);
+  }
+}
+
+function printHeader(message: string) {
+  console.log("\n\n###############");
+  console.log(`# ${message}`);
+  console.log("###############\n");
+}
+
+export interface EvaluateOptions {
+  environment: string;
+  feature: string;
+  context: Record<string, unknown>;
+  print?: boolean;
+  pretty?: boolean;
+}
+
+export async function evaluateFeature(deps: Dependencies, options: EvaluateOptions) {
+  const { datasource, projectConfig } = deps;
+
+  const existingState = await datasource.readState(options.environment);
+  const datafileContent = await buildDatafile(
+    projectConfig,
+    datasource,
+    {
+      schemaVersion: SCHEMA_VERSION,
+      revision: "include-all-features",
+      environment: options.environment,
+    },
+    existingState,
+  );
+
+  const logs: Array<any> = [];
+  const f = createInstance({
+    datafile: datafileContent,
+    logger: createLogger({
+      levels: ["error", "warn", "info", "debug"],
+      handler: (level, message, details) => {
+        logs.push({
+          level,
+          message,
+          details,
+        });
+      },
+    }),
+  });
+
+  const flagEvaluation = f.evaluateFlag(options.feature, options.context as Context);
+  const variationEvaluation = f.evaluateVariation(options.feature, options.context as Context);
+  const variableEvaluations: Record<string, Evaluation> = {};
+
+  const feature = f.getFeature(options.feature);
+  if (feature?.variablesSchema) {
+    feature.variablesSchema.forEach((v) => {
+      const variableEvaluation = f.evaluateVariable(
+        options.feature,
+        v.key,
+        options.context as Context,
+      );
+      variableEvaluations[v.key] = variableEvaluation;
+    });
+  }
+
+  const allEvaluations = {
+    flag: flagEvaluation,
+    variation: variationEvaluation,
+    variables: variableEvaluations,
+  };
+
+  if (options.print) {
+    console.log(
+      options.pretty ? JSON.stringify(allEvaluations, null, 2) : JSON.stringify(allEvaluations),
+    );
+
+    return;
+  }
+
+  console.log("");
+  console.log(`Evaluating feature "${options.feature}" in environment "${options.environment}"...`);
+  console.log(`Against context: ${JSON.stringify(options.context)}`);
+
+  // flag
+  printHeader("Is enabled?");
+
+  console.log("Value:", flagEvaluation.enabled);
+  console.log("\nDetails:\n");
+
+  printEvaluationDetails(flagEvaluation);
+
+  // variation
+  printHeader("Variation");
+
+  if (feature?.variations) {
+    console.log("Value:", JSON.stringify(variationEvaluation.variation?.value));
+    console.log("\nDetails:\n");
+
+    printEvaluationDetails(variationEvaluation);
+  } else {
+    console.log("No variations defined.");
+  }
+
+  // variables
+  if (feature?.variablesSchema) {
+    for (const [key, value] of Object.entries(variableEvaluations)) {
+      printHeader(`Variable: ${key}`);
+
+      console.log(
+        "Value:",
+        typeof value.variableValue !== "undefined"
+          ? JSON.stringify(value.variableValue)
+          : value.variableValue,
+      );
+      console.log("\nDetails:\n");
+
+      printEvaluationDetails(value);
+    }
+  } else {
+    printHeader("Variables");
+
+    console.log("No variables defined.");
+  }
+}
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index a1a93bf3..f6202ef8 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -11,3 +11,4 @@ export * from "./find-usage";
 export * from "./dependencies";
 export * from "./datasource";
 export * from "./benchmark";
+export * from "./evaluate";
diff --git a/packages/core/src/utils/index.ts b/packages/core/src/utils/index.ts
index e6bd61af..1d271a13 100644
--- a/packages/core/src/utils/index.ts
+++ b/packages/core/src/utils/index.ts
@@ -1,2 +1,3 @@
 export * from "./extractKeys";
 export * from "./git";
+export * from "./pretty";
diff --git a/packages/core/src/utils/pretty.ts b/packages/core/src/utils/pretty.ts
new file mode 100644
index 00000000..c5954efe
--- /dev/null
+++ b/packages/core/src/utils/pretty.ts
@@ -0,0 +1,3 @@
+export function prettyNumber(n: number) {
+  return n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
diff --git a/packages/sdk/src/feature.ts b/packages/sdk/src/feature.ts
index 83f4b8c3..b6d3a878 100644
--- a/packages/sdk/src/feature.ts
+++ b/packages/sdk/src/feature.ts
@@ -85,25 +85,47 @@ export function getMatchedTrafficAndAllocation(
   };
 }
 
+export interface ForceResult {
+  force?: Force;
+  forceIndex?: number;
+}
+
 export function findForceFromFeature(
   feature: Feature,
   context: Context,
   datafileReader: DatafileReader,
   logger: Logger,
-): Force | undefined {
+): ForceResult {
+  const result: ForceResult = {
+    force: undefined,
+    forceIndex: undefined,
+  };
+
   if (!feature.force) {
-    return undefined;
+    return result;
   }
 
-  return feature.force.find((f: Force) => {
-    if (f.conditions) {
-      return allConditionsAreMatched(f.conditions, context, logger);
+  for (let i = 0; i < feature.force.length; i++) {
+    const currentForce = feature.force[i];
+
+    if (
+      currentForce.conditions &&
+      allConditionsAreMatched(currentForce.conditions, context, logger)
+    ) {
+      result.force = currentForce;
+      result.forceIndex = i;
+      break;
     }
 
-    if (f.segments) {
-      return allGroupSegmentsAreMatched(f.segments, context, datafileReader, logger);
+    if (
+      currentForce.segments &&
+      allGroupSegmentsAreMatched(currentForce.segments, context, datafileReader, logger)
+    ) {
+      result.force = currentForce;
+      result.forceIndex = i;
+      break;
     }
+  }
 
-    return false;
-  });
+  return result;
 }
diff --git a/packages/sdk/src/instance.ts b/packages/sdk/src/instance.ts
index aa4d50e7..85ce69f6 100644
--- a/packages/sdk/src/instance.ts
+++ b/packages/sdk/src/instance.ts
@@ -17,6 +17,8 @@ import {
   RuleKey,
   VariableKey,
   VariableSchema,
+  Force,
+  Required,
 } from "@featurevisor/types";
 
 import { createLogger, Logger, LogLevel } from "./logger";
@@ -104,11 +106,15 @@ export interface Evaluation {
   reason: EvaluationReason;
 
   // common
+  bucketKey?: BucketKey;
   bucketValue?: BucketValue;
   ruleKey?: RuleKey;
   error?: Error;
   enabled?: boolean;
   traffic?: Traffic;
+  forceIndex?: number;
+  force?: Force;
+  required?: Required[];
   sticky?: OverrideFeature;
   initial?: OverrideFeature;
 
@@ -368,16 +374,27 @@ export class FeaturevisorInstance {
     return result;
   }
 
-  private getBucketValue(feature: Feature, context: Context): BucketValue {
+  private getBucketValue(
+    feature: Feature,
+    context: Context,
+  ): { bucketKey: BucketKey; bucketValue: BucketValue } {
     const bucketKey = this.getBucketKey(feature, context);
 
     const value = getBucketedNumber(bucketKey);
 
     if (this.configureBucketValue) {
-      return this.configureBucketValue(feature, context, value);
+      const configuredValue = this.configureBucketValue(feature, context, value);
+
+      return {
+        bucketKey,
+        bucketValue: configuredValue,
+      };
     }
 
-    return value;
+    return {
+      bucketKey,
+      bucketValue: value,
+    };
   }
 
   /**
@@ -470,8 +487,8 @@ export class FeaturevisorInstance {
         evaluation = {
           featureKey: key,
           reason: EvaluationReason.STICKY,
-          enabled: this.stickyFeatures[key].enabled,
           sticky: this.stickyFeatures[key],
+          enabled: this.stickyFeatures[key].enabled,
         };
 
         this.logger.debug("using sticky enabled", evaluation);
@@ -490,8 +507,8 @@ export class FeaturevisorInstance {
         evaluation = {
           featureKey: key,
           reason: EvaluationReason.INITIAL,
-          enabled: this.initialFeatures[key].enabled,
           initial: this.initialFeatures[key],
+          enabled: this.initialFeatures[key].enabled,
         };
 
         this.logger.debug("using initial enabled", evaluation);
@@ -521,12 +538,19 @@ export class FeaturevisorInstance {
       const finalContext = this.interceptContext ? this.interceptContext(context) : context;
 
       // forced
-      const force = findForceFromFeature(feature, context, this.datafileReader, this.logger);
+      const { force, forceIndex } = findForceFromFeature(
+        feature,
+        context,
+        this.datafileReader,
+        this.logger,
+      );
 
       if (force && typeof force.enabled !== "undefined") {
         evaluation = {
           featureKey: feature.key,
           reason: EvaluationReason.FORCED,
+          forceIndex,
+          force,
           enabled: force.enabled,
         };
 
@@ -567,6 +591,7 @@ export class FeaturevisorInstance {
           evaluation = {
             featureKey: feature.key,
             reason: EvaluationReason.REQUIRED,
+            required: feature.required,
             enabled: requiredFeaturesAreEnabled,
           };
 
@@ -577,7 +602,7 @@ export class FeaturevisorInstance {
       }
 
       // bucketing
-      const bucketValue = this.getBucketValue(feature, finalContext);
+      const { bucketKey, bucketValue } = this.getBucketValue(feature, finalContext);
 
       const matchedTraffic = getMatchedTraffic(
         feature.traffic,
@@ -598,9 +623,12 @@ export class FeaturevisorInstance {
             evaluation = {
               featureKey: feature.key,
               reason: EvaluationReason.ALLOCATED,
+              bucketKey,
+              bucketValue,
+              ruleKey: matchedTraffic.key,
+              traffic: matchedTraffic,
               enabled:
                 typeof matchedTraffic.enabled === "undefined" ? true : matchedTraffic.enabled,
-              bucketValue,
             };
 
             this.logger.debug("matched", evaluation);
@@ -612,8 +640,9 @@ export class FeaturevisorInstance {
           evaluation = {
             featureKey: feature.key,
             reason: EvaluationReason.OUT_OF_RANGE,
-            enabled: false,
+            bucketKey,
             bucketValue,
+            enabled: false,
           };
 
           this.logger.debug("not matched", evaluation);
@@ -626,10 +655,11 @@ export class FeaturevisorInstance {
           evaluation = {
             featureKey: feature.key,
             reason: EvaluationReason.OVERRIDE,
-            enabled: matchedTraffic.enabled,
+            bucketKey,
             bucketValue,
             ruleKey: matchedTraffic.key,
             traffic: matchedTraffic,
+            enabled: matchedTraffic.enabled,
           };
 
           this.logger.debug("override from rule", evaluation);
@@ -642,10 +672,11 @@ export class FeaturevisorInstance {
           evaluation = {
             featureKey: feature.key,
             reason: EvaluationReason.RULE,
-            enabled: true,
+            bucketKey,
             bucketValue,
             ruleKey: matchedTraffic.key,
             traffic: matchedTraffic,
+            enabled: true,
           };
 
           this.logger.debug("matched traffic", evaluation);
@@ -657,9 +688,10 @@ export class FeaturevisorInstance {
       // nothing matched
       evaluation = {
         featureKey: feature.key,
-        reason: EvaluationReason.ERROR,
-        enabled: false,
+        reason: EvaluationReason.ERROR, // @TODO: any better reason?
+        bucketKey,
         bucketValue,
+        enabled: false,
       };
 
       this.logger.debug("nothing matched", evaluation);
@@ -779,7 +811,12 @@ export class FeaturevisorInstance {
       const finalContext = this.interceptContext ? this.interceptContext(context) : context;
 
       // forced
-      const force = findForceFromFeature(feature, context, this.datafileReader, this.logger);
+      const { force, forceIndex } = findForceFromFeature(
+        feature,
+        context,
+        this.datafileReader,
+        this.logger,
+      );
 
       if (force && force.variation) {
         const variation = feature.variations.find((v) => v.value === force.variation);
@@ -788,6 +825,8 @@ export class FeaturevisorInstance {
           evaluation = {
             featureKey: feature.key,
             reason: EvaluationReason.FORCED,
+            forceIndex,
+            force,
             variation,
           };
 
@@ -798,7 +837,7 @@ export class FeaturevisorInstance {
       }
 
       // bucketing
-      const bucketValue = this.getBucketValue(feature, finalContext);
+      const { bucketKey, bucketValue } = this.getBucketValue(feature, finalContext);
 
       const { matchedTraffic, matchedAllocation } = getMatchedTrafficAndAllocation(
         feature.traffic,
@@ -817,9 +856,11 @@ export class FeaturevisorInstance {
             evaluation = {
               featureKey: feature.key,
               reason: EvaluationReason.RULE,
-              variation,
+              bucketKey,
               bucketValue,
               ruleKey: matchedTraffic.key,
+              traffic: matchedTraffic,
+              variation,
             };
 
             this.logger.debug("override from rule", evaluation);
@@ -836,7 +877,10 @@ export class FeaturevisorInstance {
             evaluation = {
               featureKey: feature.key,
               reason: EvaluationReason.ALLOCATED,
+              bucketKey,
               bucketValue,
+              ruleKey: matchedTraffic.key,
+              traffic: matchedTraffic,
               variation,
             };
 
@@ -850,7 +894,8 @@ export class FeaturevisorInstance {
       // nothing matched
       evaluation = {
         featureKey: feature.key,
-        reason: EvaluationReason.ERROR,
+        reason: EvaluationReason.ERROR, // @TODO: any better reason?
+        bucketKey,
         bucketValue,
       };
 
@@ -1046,12 +1091,19 @@ export class FeaturevisorInstance {
       const finalContext = this.interceptContext ? this.interceptContext(context) : context;
 
       // forced
-      const force = findForceFromFeature(feature, context, this.datafileReader, this.logger);
+      const { force, forceIndex } = findForceFromFeature(
+        feature,
+        context,
+        this.datafileReader,
+        this.logger,
+      );
 
       if (force && force.variables && typeof force.variables[variableKey] !== "undefined") {
         evaluation = {
           featureKey: feature.key,
           reason: EvaluationReason.FORCED,
+          forceIndex,
+          force,
           variableKey,
           variableSchema,
           variableValue: force.variables[variableKey],
@@ -1063,7 +1115,7 @@ export class FeaturevisorInstance {
       }
 
       // bucketing
-      const bucketValue = this.getBucketValue(feature, finalContext);
+      const { bucketKey, bucketValue } = this.getBucketValue(feature, finalContext);
 
       const { matchedTraffic, matchedAllocation } = getMatchedTrafficAndAllocation(
         feature.traffic,
@@ -1082,11 +1134,13 @@ export class FeaturevisorInstance {
           evaluation = {
             featureKey: feature.key,
             reason: EvaluationReason.RULE,
+            bucketKey,
+            bucketValue,
+            ruleKey: matchedTraffic.key,
+            traffic: matchedTraffic,
             variableKey,
             variableSchema,
             variableValue: matchedTraffic.variables[variableKey],
-            bucketValue,
-            ruleKey: matchedTraffic.key,
           };
 
           this.logger.debug("override from rule", evaluation);
@@ -1136,11 +1190,13 @@ export class FeaturevisorInstance {
                   evaluation = {
                     featureKey: feature.key,
                     reason: EvaluationReason.OVERRIDE,
+                    bucketKey,
+                    bucketValue,
+                    ruleKey: matchedTraffic.key,
+                    traffic: matchedTraffic,
                     variableKey,
                     variableSchema,
                     variableValue: override.value,
-                    bucketValue,
-                    ruleKey: matchedTraffic.key,
                   };
 
                   this.logger.debug("variable override", evaluation);
@@ -1153,11 +1209,13 @@ export class FeaturevisorInstance {
                 evaluation = {
                   featureKey: feature.key,
                   reason: EvaluationReason.ALLOCATED,
+                  bucketKey,
+                  bucketValue,
+                  ruleKey: matchedTraffic.key,
+                  traffic: matchedTraffic,
                   variableKey,
                   variableSchema,
                   variableValue: variableFromVariation.value,
-                  bucketValue,
-                  ruleKey: matchedTraffic.key,
                 };
 
                 this.logger.debug("allocated variable", evaluation);
@@ -1173,10 +1231,11 @@ export class FeaturevisorInstance {
       evaluation = {
         featureKey: feature.key,
         reason: EvaluationReason.DEFAULTED,
+        bucketKey,
+        bucketValue,
         variableKey,
         variableSchema,
         variableValue: variableSchema.defaultValue,
-        bucketValue,
       };
 
       this.logger.debug("using default value", evaluation);

From 41b21ee48a1508fad58824b255403125ce175f95 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Sun, 7 Apr 2024 21:40:44 +0000
Subject: [PATCH 33/48] v1.17.0

---
 CHANGELOG.md                              | 11 +++++++
 examples/example-1/CHANGELOG.md           |  8 +++++
 examples/example-1/package.json           |  4 +--
 examples/example-json/CHANGELOG.md        |  8 +++++
 examples/example-json/package.json        |  4 +--
 examples/example-toml/CHANGELOG.md        |  8 +++++
 examples/example-toml/package.json        |  4 +--
 examples/example-yml-include/CHANGELOG.md |  8 +++++
 examples/example-yml-include/package.json |  4 +--
 examples/example-yml/CHANGELOG.md         |  8 +++++
 examples/example-yml/package.json         |  4 +--
 lerna.json                                |  2 +-
 package-lock.json                         | 38 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 +++++++
 packages/cli/package.json                 |  4 +--
 packages/core/CHANGELOG.md                | 11 +++++++
 packages/core/package.json                |  4 +--
 packages/react/CHANGELOG.md               |  8 +++++
 packages/react/package.json               |  4 +--
 packages/sdk/CHANGELOG.md                 | 11 +++++++
 packages/sdk/package.json                 |  2 +-
 packages/vue/CHANGELOG.md                 |  8 +++++
 packages/vue/package.json                 |  4 +--
 23 files changed, 139 insertions(+), 39 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 24779ca4..20c9d935 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+
+### Features
+
+* evaluate features in CLI ([#295](https://github.com/featurevisor/featurevisor/issues/295)) ([5a3332a](https://github.com/featurevisor/featurevisor/commit/5a3332a226a3b4901445fe2fe04baa8320e94f48))
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index e9169ff5..16ab4d4d 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 3a6a255a..c862b714 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.16.0"
+    "@featurevisor/cli": "^1.17.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 248e1bfa..78e6f5a7 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 79bc1997..939920aa 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.16.0"
+    "@featurevisor/cli": "^1.17.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 65f99747..2ca5a82f 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 55976652..eab5749d 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.16.0",
+    "@featurevisor/cli": "^1.17.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 0c9e4f26..37a8eee3 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 5f3d3092..5774b265 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.16.0"
+    "@featurevisor/cli": "^1.17.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 3aa24038..233fbc9c 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 2b2d6726..715c961e 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.16.0"
+    "@featurevisor/cli": "^1.17.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index ae246e70..f97d33cf 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.16.0"
+  "version": "1.17.0"
 }
diff --git a/package-lock.json b/package-lock.json
index c9794b82..043a11ba 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.16.0"
+        "@featurevisor/cli": "^1.17.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.16.0"
+        "@featurevisor/cli": "^1.17.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.16.0",
+        "@featurevisor/cli": "^1.17.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.16.0"
+        "@featurevisor/cli": "^1.17.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.16.0"
+        "@featurevisor/cli": "^1.17.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.16.0",
+        "@featurevisor/core": "^1.17.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,10 +18829,10 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.16.0",
+        "@featurevisor/sdk": "^1.17.0",
         "@featurevisor/site": "^1.7.1",
         "@featurevisor/types": "^1.3.0",
         "axios": "^1.3.4",
@@ -18893,10 +18893,10 @@
     },
     "packages/react": {
       "name": "@featurevisor/react",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.16.0",
+        "@featurevisor/sdk": "^1.17.0",
         "@featurevisor/types": "^1.3.0"
       },
       "devDependencies": {
@@ -18907,7 +18907,7 @@
     },
     "packages/sdk": {
       "name": "@featurevisor/sdk",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/types": "^1.3.0",
@@ -19145,10 +19145,10 @@
     },
     "packages/vue": {
       "name": "@featurevisor/vue",
-      "version": "1.16.0",
+      "version": "1.17.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.16.0",
+        "@featurevisor/sdk": "^1.17.0",
         "@featurevisor/types": "^1.3.0",
         "vue": "^3.3.4"
       },
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 1de8ab15..7e0a2150 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+
+### Features
+
+* evaluate features in CLI ([#295](https://github.com/featurevisor/featurevisor/issues/295)) ([5a3332a](https://github.com/featurevisor/featurevisor/commit/5a3332a226a3b4901445fe2fe04baa8320e94f48))
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/cli
diff --git a/packages/cli/package.json b/packages/cli/package.json
index ec2c83f7..87f7fcf7 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.16.0",
+    "@featurevisor/core": "^1.17.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index a9d339f4..075efaae 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+
+### Features
+
+* evaluate features in CLI ([#295](https://github.com/featurevisor/featurevisor/issues/295)) ([5a3332a](https://github.com/featurevisor/featurevisor/commit/5a3332a226a3b4901445fe2fe04baa8320e94f48))
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/core
diff --git a/packages/core/package.json b/packages/core/package.json
index f8750a65..22e6f9e3 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,7 +44,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/sdk": "^1.16.0",
+    "@featurevisor/sdk": "^1.17.0",
     "@featurevisor/site": "^1.7.1",
     "@featurevisor/types": "^1.3.0",
     "axios": "^1.3.4",
diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
index b727dce0..14e0add1 100644
--- a/packages/react/CHANGELOG.md
+++ b/packages/react/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/react
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/react
diff --git a/packages/react/package.json b/packages/react/package.json
index 1cbc22b9..233a5321 100644
--- a/packages/react/package.json
+++ b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/react",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "React package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.16.0",
+    "@featurevisor/sdk": "^1.17.0",
     "@featurevisor/types": "^1.3.0"
   },
   "license": "MIT",
diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md
index 2d792ad2..2db6cc2c 100644
--- a/packages/sdk/CHANGELOG.md
+++ b/packages/sdk/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+
+### Features
+
+* evaluate features in CLI ([#295](https://github.com/featurevisor/featurevisor/issues/295)) ([5a3332a](https://github.com/featurevisor/featurevisor/commit/5a3332a226a3b4901445fe2fe04baa8320e94f48))
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index e602e918..1dd99781 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/sdk",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Featurevisor SDK for Node.js and the browser",
   "main": "dist/index.js",
   "module": "lib/index.js",
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
index 137dfc2d..d76def0e 100644
--- a/packages/vue/CHANGELOG.md
+++ b/packages/vue/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
+
+**Note:** Version bump only for package @featurevisor/vue
+
+
+
+
+
 # [1.16.0](https://github.com/featurevisor/featurevisor/compare/v1.15.0...v1.16.0) (2024-04-05)
 
 **Note:** Version bump only for package @featurevisor/vue
diff --git a/packages/vue/package.json b/packages/vue/package.json
index 68bfd3bd..7dc67567 100644
--- a/packages/vue/package.json
+++ b/packages/vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/vue",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Vue.js package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.16.0",
+    "@featurevisor/sdk": "^1.17.0",
     "@featurevisor/types": "^1.3.0",
     "vue": "^3.3.4"
   },

From 0ae5c90e2093e7a47447e0da041c28e5786cabff Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sun, 14 Apr 2024 20:28:11 +0200
Subject: [PATCH 34/48] docs: updates

---
 docs/features.md    | 2 +-
 docs/quick-start.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/features.md b/docs/features.md
index 38185591..910fa62b 100644
--- a/docs/features.md
+++ b/docs/features.md
@@ -74,7 +74,7 @@ The `bucketBy` property is used to determine how the feature will be bucketed. M
 bucketBy: userId
 ```
 
-Given we used `userId` attribute as the `bucketBy` value, it means no matter which application or device the user is using, as long as the `userId` attribute's value is the same, the same variation of the feature will be consistently assigned to that particular user.
+Given we used `userId` attribute as the `bucketBy` value, it means no matter which application or device the user is using, as long as the `userId` attribute's value is the same, the same value(s) of the feature will be consistently assigned to that particular user.
 
 If you want to bucket users against multiple attributes together, you can do as follows:
 
diff --git a/docs/quick-start.md b/docs/quick-start.md
index f65e591a..b93324fe 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -241,6 +241,6 @@ const bannerVariation = f.getVariation(featureKey, context);
 const myVariable = f.getVariable(featureKey, "myVariableKey", context);
 ```
 
-Featurevisor SDK will take care of computing the right variation for you against the given `userId` and `country` attributes as context.
+Featurevisor SDK will take care of computing the right value(s) for you against the provided `userId` and `country` attributes as context.
 
 Find more examples of SDK usage [here](/docs/sdks).

From 2063ad9a5408071bfb1636c748cabe616065191d Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Tue, 16 Apr 2024 18:41:40 +0200
Subject: [PATCH 35/48] feat: assess traffic distribution via CLI (#297)

---
 docs/cli.md                                   |  32 +++-
 packages/cli/src/index.ts                     |  42 +++++
 .../core/src/assess-distribution/index.ts     | 167 ++++++++++++++++++
 packages/core/src/index.ts                    |   1 +
 packages/core/src/utils/pretty.ts             |   9 +
 5 files changed, 249 insertions(+), 2 deletions(-)
 create mode 100644 packages/core/src/assess-distribution/index.ts

diff --git a/docs/cli.md b/docs/cli.md
index d1ddc40d..80f5e686 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -156,7 +156,7 @@ The `--n` option is used to specify the number of iterations to run the benchmar
 
 ### Feature
 
-To benchmark evaluating a feature itself if it is enabled or disabled via SDK's `.isEnabled()` method:
+To benchmark evaluating a feature itself if it is enabled or disabled via SDK's `.isEnabled()` method against provided [context](/docs/sdks/javascript/#context):
 
 ```
 $ npx featurevisor benchmark \
@@ -208,7 +208,7 @@ $ npx featurevisor config --print --pretty
 
 ## Evaluate
 
-To learn why certain values (like feature and its variation or variables) are evaluated as they are:
+To learn why certain values (like feature and its variation or variables) are evaluated as they are against provided [context](/docs/sdks/javascript/#context):
 
 ```
 $ npx featurevisor evaluate \
@@ -233,3 +233,31 @@ $ npx featurevisor evaluate \
 ```
 
 The `--pretty` flag is optional.
+
+## Assess distribution
+
+To check if the gradual rollout of a feature and the weight distribution of its variations (if any exists) are going to work as expected in a real world application with real traffic against provided [context](/docs/sdks/javascript/#context), we can imitate that by running:
+
+```
+$ npx featurevisor assess-distribution \
+  --environment=production \
+  --feature=my_feature \
+  --context='{"country": "nl"}' \
+  --populateUuid=userId \
+  --n=1000
+```
+
+The `--n` option controls the number of iterations to run, and the `--populateUuid` option is used to simulate different users in each iteration in this particular case.
+
+Further details about all the options:
+
+- `--environment`: the environment name
+- `--feature`: the feature key
+- `--context`: the common [context](/docs/sdks/javascript/#context) object in stringified form
+- `--populateUuid`: attribute key that should be populated with a new UUID, and merged with provided context.
+  - You can pass multiple attributes in your command: `--populateUuid=userId --populateUuid=deviceId`
+- `--n`: the number of iterations to run the assessment for
+  - The higher the number, the more accurate the distribution will be
+- `--verbose`: print the merged context for better debugging
+
+Everything is happening locally in memory without modifying any content anywhere. This command exists only to add to our confidence if questions arise about how effective traffic distribution in Featurevisor is.
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 53355c19..1c7816ca 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -25,6 +25,7 @@ import {
   benchmarkFeature,
   showProjectConfig,
   evaluateFeature,
+  assessDistribution,
 } from "@featurevisor/core";
 
 process.on("unhandledRejection", (reason) => {
@@ -367,6 +368,47 @@ async function main() {
       "evaluate a feature against provided context",
     )
 
+    /**
+     * Assess distribution
+     */
+    .command({
+      command: "assess-distribution",
+      handler: async function (options) {
+        if (!options.environment) {
+          console.error("Please specify an environment with --environment flag.");
+          process.exit(1);
+        }
+
+        if (!options.feature) {
+          console.error("Please specify a feature with --feature flag.");
+          process.exit(1);
+        }
+
+        const deps = await getDependencies(options);
+
+        try {
+          await assessDistribution(deps, {
+            environment: options.environment,
+            feature: options.feature,
+            context: options.context ? JSON.parse(options.context) : {},
+            populateUuid: Array.isArray(options.populateUuid)
+              ? options.populateUuid
+              : [options.populateUuid as string].filter(Boolean),
+            n: parseInt(options.n, 10) || 1,
+            verbose: options.verbose,
+          });
+        } catch (e) {
+          console.error(e.message);
+          process.exit(1);
+        }
+      },
+    })
+    .example("$0 assess-distribution", "test traffic distribution of a feature")
+    .example(
+      "$0 assess-distribution --environment=production --feature=my_feature --context='{}' --populateUuid=userId --n=100",
+      "test traffic distribution a feature against provided context",
+    )
+
     /**
      * Options
      */
diff --git a/packages/core/src/assess-distribution/index.ts b/packages/core/src/assess-distribution/index.ts
new file mode 100644
index 00000000..1f9e6a61
--- /dev/null
+++ b/packages/core/src/assess-distribution/index.ts
@@ -0,0 +1,167 @@
+import { randomBytes } from "crypto";
+
+import { FeatureKey, AttributeKey, Context } from "@featurevisor/types";
+import { createInstance } from "@featurevisor/sdk";
+
+import { Dependencies } from "../dependencies";
+import { buildDatafile } from "../builder";
+import { SCHEMA_VERSION } from "../config";
+import { prettyPercentage, prettyNumber } from "../utils";
+
+const UUID_LENGTHS = [4, 2, 2, 2, 6];
+
+function generateUUID(): string {
+  return UUID_LENGTHS.map((len) => randomBytes(len).toString("hex")).join("-");
+}
+
+type EvaluationsCount = Record<string, number>;
+
+function printCounts(evaluations: EvaluationsCount, n: number, sort = true) {
+  let entries = Object.entries(evaluations);
+
+  if (sort) {
+    entries = entries.sort((a, b) => {
+      if (a[1] > b[1]) {
+        return -1;
+      }
+
+      if (a[1] < b[1]) {
+        return 1;
+      }
+
+      return 0;
+    });
+  }
+
+  const longestValueLength = Object.keys(evaluations).reduce(
+    (acc, curr) => (curr.length > acc ? curr.length : acc),
+    0,
+  );
+
+  const highestCount = Object.values(evaluations).reduce(
+    (acc, curr) => (curr > acc ? curr : acc),
+    0,
+  );
+  const prettyHighestCountLength = prettyNumber(highestCount).length;
+
+  for (const [value, count] of entries) {
+    console.log(
+      `  - ${value}:`.padEnd(longestValueLength + 5, " "),
+      `\t${prettyNumber(count).padStart(prettyHighestCountLength, " ")}`,
+      `\t${prettyPercentage(count, n).padStart(7, " ")}`,
+    );
+  }
+}
+
+function createContext(providedContext: Context, populateUuid?: AttributeKey[]): Context {
+  const context = { ...providedContext };
+
+  if (populateUuid) {
+    for (const key of populateUuid) {
+      context[key] = generateUUID();
+    }
+  }
+
+  return context;
+}
+
+export interface AssessDistributionOptions {
+  environment: string;
+  feature: FeatureKey;
+  context: Context;
+  n: number;
+
+  populateUuid?: AttributeKey[];
+  verbose?: boolean;
+}
+
+export async function assessDistribution(deps: Dependencies, options: AssessDistributionOptions) {
+  const { projectConfig, datasource } = deps;
+
+  console.log(`\nAssessing distribution for feature: "${options.feature}"...`);
+
+  /**
+   * Prepare datafile
+   */
+  const datafileBuildStart = Date.now();
+  console.log(`\n\nBuilding datafile containing all features for "${options.environment}"...`);
+  const existingState = await datasource.readState(options.environment);
+  const datafileContent = await buildDatafile(
+    projectConfig,
+    datasource,
+    {
+      schemaVersion: SCHEMA_VERSION,
+      revision: "include-all-features",
+      environment: options.environment,
+    },
+    existingState,
+  );
+  const datafileBuildDuration = Date.now() - datafileBuildStart;
+  console.log(`Datafile build duration: ${datafileBuildDuration}ms`);
+
+  /**
+   * Initialize SDK
+   */
+  const f = createInstance({
+    datafile: datafileContent,
+  });
+  console.log("\n\n...SDK initialized\n");
+
+  /**
+   * Evaluations
+   */
+  let hasVariations = false;
+  const feature = f.getFeature(options.feature);
+
+  if (feature && feature.variations) {
+    hasVariations = true;
+  }
+
+  const flagEvaluations: EvaluationsCount = {
+    enabled: 0,
+    disabled: 0,
+  };
+
+  const variationEvaluations: EvaluationsCount = {};
+
+  console.log(`\nEvaluating ${prettyNumber(options.n)} times...`);
+
+  for (let i = 0; i < options.n; i++) {
+    const context = createContext(options.context, options.populateUuid);
+    if (options.verbose) {
+      console.log(`[${i + 1}/${options.n}] Evaluating against context: ${JSON.stringify(context)}`);
+    }
+
+    // flag
+    const flagEvaluation = f.isEnabled(options.feature, context);
+
+    if (flagEvaluation) {
+      flagEvaluations.enabled++;
+    } else {
+      flagEvaluations.disabled++;
+    }
+
+    // variation
+    if (hasVariations) {
+      const variationEvaluation = f.getVariation(options.feature, context) as string;
+
+      if (!variationEvaluations[variationEvaluation]) {
+        variationEvaluations[variationEvaluation] = 0;
+      }
+
+      variationEvaluations[variationEvaluation]++;
+    }
+  }
+
+  /**
+   * Print results
+   */
+
+  console.log("\n\nFlag evaluations:\n");
+  printCounts(flagEvaluations, options.n);
+
+  if (hasVariations) {
+    console.log("\n\nVariation evaluations:\n");
+    printCounts(variationEvaluations, options.n);
+  }
+}
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index f6202ef8..4488427f 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -12,3 +12,4 @@ export * from "./dependencies";
 export * from "./datasource";
 export * from "./benchmark";
 export * from "./evaluate";
+export * from "./assess-distribution";
diff --git a/packages/core/src/utils/pretty.ts b/packages/core/src/utils/pretty.ts
index c5954efe..9059bb3c 100644
--- a/packages/core/src/utils/pretty.ts
+++ b/packages/core/src/utils/pretty.ts
@@ -1,3 +1,12 @@
 export function prettyNumber(n: number) {
   return n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
 }
+
+export function prettyPercentage(
+  value: number,
+  total: number,
+  precision: number = 2,
+  suffix: string = "%",
+): string {
+  return `${((value / total) * 100).toFixed(precision)}${suffix}`;
+}

From beedecac433ebb53ec5c856ecdf5bf8c5ea159fd Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Tue, 16 Apr 2024 16:44:19 +0000
Subject: [PATCH 36/48] v1.18.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 20c9d935..88ea10ad 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+
+### Features
+
+* assess traffic distribution via CLI ([#297](https://github.com/featurevisor/featurevisor/issues/297)) ([2063ad9](https://github.com/featurevisor/featurevisor/commit/2063ad9a5408071bfb1636c748cabe616065191d))
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index 16ab4d4d..9008f6b3 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index c862b714..453c758f 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.17.0"
+    "@featurevisor/cli": "^1.18.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 78e6f5a7..7b0bab32 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 939920aa..6b784b4a 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.17.0"
+    "@featurevisor/cli": "^1.18.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 2ca5a82f..a977a8e8 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index eab5749d..7d9ae4db 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.17.0",
+    "@featurevisor/cli": "^1.18.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 37a8eee3..5983a3d1 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 5774b265..6280ad44 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.17.0"
+    "@featurevisor/cli": "^1.18.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 233fbc9c..48b56470 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 715c961e..12e70115 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.17.0"
+    "@featurevisor/cli": "^1.18.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index f97d33cf..004d1514 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.17.0"
+  "version": "1.18.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 043a11ba..bf4841c9 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.17.0"
+        "@featurevisor/cli": "^1.18.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.17.0"
+        "@featurevisor/cli": "^1.18.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.17.0",
+        "@featurevisor/cli": "^1.18.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.17.0"
+        "@featurevisor/cli": "^1.18.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.17.0"
+        "@featurevisor/cli": "^1.18.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.17.0",
+        "@featurevisor/core": "^1.18.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.17.0",
+      "version": "1.18.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.17.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 7e0a2150..7d7f2b84 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+
+### Features
+
+* assess traffic distribution via CLI ([#297](https://github.com/featurevisor/featurevisor/issues/297)) ([2063ad9](https://github.com/featurevisor/featurevisor/commit/2063ad9a5408071bfb1636c748cabe616065191d))
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 87f7fcf7..a12392f9 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.17.0",
+    "@featurevisor/core": "^1.18.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 075efaae..7063cb18 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
+
+
+### Features
+
+* assess traffic distribution via CLI ([#297](https://github.com/featurevisor/featurevisor/issues/297)) ([2063ad9](https://github.com/featurevisor/featurevisor/commit/2063ad9a5408071bfb1636c748cabe616065191d))
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index 22e6f9e3..c28ebacb 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From 1676e7ea325a60bf482205dc32a91f77eba96655 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Tue, 23 Apr 2024 17:41:01 +0200
Subject: [PATCH 37/48] fix: search features by any case in generated site
 (#298)

---
 packages/site/src/utils/index.ts | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/site/src/utils/index.ts b/packages/site/src/utils/index.ts
index 13814231..3135c39a 100644
--- a/packages/site/src/utils/index.ts
+++ b/packages/site/src/utils/index.ts
@@ -129,7 +129,10 @@ export function getFeaturesByQuery(query: Query, data: SearchIndex) {
     .filter((feature) => {
       let matched = true;
 
-      if (query.keyword.length > 0 && feature.key.indexOf(query.keyword.toLowerCase()) === -1) {
+      if (
+        query.keyword.length > 0 &&
+        feature.key.toLowerCase().indexOf(query.keyword.toLowerCase()) === -1
+      ) {
         matched = false;
       }
 

From 5a1572d908a0aa9fcdcb5fe208cee8c0f17f7b4f Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Tue, 23 Apr 2024 15:43:37 +0000
Subject: [PATCH 38/48] v1.18.1

---
 CHANGELOG.md                              | 11 +++++++++
 examples/example-1/CHANGELOG.md           |  8 ++++++
 examples/example-1/package.json           |  4 +--
 examples/example-json/CHANGELOG.md        |  8 ++++++
 examples/example-json/package.json        |  4 +--
 examples/example-toml/CHANGELOG.md        |  8 ++++++
 examples/example-toml/package.json        |  4 +--
 examples/example-yml-include/CHANGELOG.md |  8 ++++++
 examples/example-yml-include/package.json |  4 +--
 examples/example-yml/CHANGELOG.md         |  8 ++++++
 examples/example-yml/package.json         |  4 +--
 lerna.json                                |  2 +-
 package-lock.json                         | 30 +++++++++++------------
 packages/cli/CHANGELOG.md                 |  8 ++++++
 packages/cli/package.json                 |  4 +--
 packages/core/CHANGELOG.md                |  8 ++++++
 packages/core/package.json                |  4 +--
 packages/site/CHANGELOG.md                | 11 +++++++++
 packages/site/package.json                |  2 +-
 19 files changed, 109 insertions(+), 31 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 88ea10ad..99f8341e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+
+### Bug Fixes
+
+* search features by any case in generated site ([#298](https://github.com/featurevisor/featurevisor/issues/298)) ([1676e7e](https://github.com/featurevisor/featurevisor/commit/1676e7ea325a60bf482205dc32a91f77eba96655))
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index 9008f6b3..1b3755a9 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 453c758f..7a567dc2 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.0"
+    "@featurevisor/cli": "^1.18.1"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 7b0bab32..03ac1242 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index 6b784b4a..bb0043ee 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.0"
+    "@featurevisor/cli": "^1.18.1"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index a977a8e8..a288e693 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 7d9ae4db..efd8288f 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.0",
+    "@featurevisor/cli": "^1.18.1",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 5983a3d1..05d1d8a7 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 6280ad44..0a231418 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.0"
+    "@featurevisor/cli": "^1.18.1"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 48b56470..c15b65c8 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 12e70115..b37f2aec 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.0"
+    "@featurevisor/cli": "^1.18.1"
   }
 }
diff --git a/lerna.json b/lerna.json
index 004d1514..9668fe78 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.18.0"
+  "version": "1.18.1"
 }
diff --git a/package-lock.json b/package-lock.json
index bf4841c9..18211e29 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.0"
+        "@featurevisor/cli": "^1.18.1"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.0"
+        "@featurevisor/cli": "^1.18.1"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.0",
+        "@featurevisor/cli": "^1.18.1",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.0"
+        "@featurevisor/cli": "^1.18.1"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.0"
+        "@featurevisor/cli": "^1.18.1"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.18.0",
+        "@featurevisor/core": "^1.18.1",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,11 +18829,11 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.17.0",
-        "@featurevisor/site": "^1.7.1",
+        "@featurevisor/site": "^1.18.1",
         "@featurevisor/types": "^1.3.0",
         "axios": "^1.3.4",
         "js-yaml": "^4.1.0",
@@ -18917,7 +18917,7 @@
     },
     "packages/site": {
       "name": "@featurevisor/site",
-      "version": "1.7.1",
+      "version": "1.18.1",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/types": "^1.3.0"
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 7d7f2b84..ce634c8d 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/cli
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index a12392f9..ed473e71 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.18.0",
+    "@featurevisor/core": "^1.18.1",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 7063cb18..f9f2f5b1 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+**Note:** Version bump only for package @featurevisor/core
+
+
+
+
+
 # [1.18.0](https://github.com/featurevisor/featurevisor/compare/v1.17.0...v1.18.0) (2024-04-16)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index c28ebacb..7a1082f3 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -45,7 +45,7 @@
   "license": "MIT",
   "dependencies": {
     "@featurevisor/sdk": "^1.17.0",
-    "@featurevisor/site": "^1.7.1",
+    "@featurevisor/site": "^1.18.1",
     "@featurevisor/types": "^1.3.0",
     "axios": "^1.3.4",
     "js-yaml": "^4.1.0",
diff --git a/packages/site/CHANGELOG.md b/packages/site/CHANGELOG.md
index c26af4f2..62298117 100644
--- a/packages/site/CHANGELOG.md
+++ b/packages/site/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
+
+
+### Bug Fixes
+
+* search features by any case in generated site ([#298](https://github.com/featurevisor/featurevisor/issues/298)) ([1676e7e](https://github.com/featurevisor/featurevisor/commit/1676e7ea325a60bf482205dc32a91f77eba96655))
+
+
+
+
+
 ## [1.7.1](https://github.com/featurevisor/featurevisor/compare/v1.7.0...v1.7.1) (2024-02-15)
 
 
diff --git a/packages/site/package.json b/packages/site/package.json
index 891a7138..830503c5 100644
--- a/packages/site/package.json
+++ b/packages/site/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/site",
-  "version": "1.7.1",
+  "version": "1.18.1",
   "description": "Static site for Featurevisor",
   "main": "dist",
   "scripts": {

From 5008066128fb7c732b633856dcffcb768f52c88c Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Fri, 26 Apr 2024 18:55:27 +0200
Subject: [PATCH 39/48] feat: find duplicate segments with authors info (#299)

---
 docs/cli.md                                   |  6 +++
 packages/cli/src/index.ts                     | 17 ++++---
 .../findDuplicateSegments.ts                  | 48 +++++++++++++++++--
 .../core/src/find-duplicate-segments/index.ts | 23 ++++++---
 4 files changed, 77 insertions(+), 17 deletions(-)

diff --git a/docs/cli.md b/docs/cli.md
index 80f5e686..6d52261c 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -120,6 +120,12 @@ We can find these duplicates early on by running:
 $ npx featurevisor find-duplicate-segments
 ```
 
+If we want to know the names of authors who worked on the duplicate segments, we can pass `--authors`:
+
+```
+$ npx featurevisor find-duplicate-segments --authors
+```
+
 ## Find usage
 
 Learn where/if certain segments and attributes are used in.
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 1c7816ca..a76d146e 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -1,8 +1,6 @@
 import * as fs from "fs";
 import * as path from "path";
 
-import * as yargs from "yargs";
-
 import {
   CONFIG_MODULE_NAME,
   getProjectConfig,
@@ -28,6 +26,8 @@ import {
   assessDistribution,
 } from "@featurevisor/core";
 
+const yargs = require("yargs"); // eslint-disable-line @typescript-eslint/no-var-requires
+
 process.on("unhandledRejection", (reason) => {
   console.error(reason);
   process.exit(1);
@@ -52,11 +52,13 @@ function requireAndGetProjectConfig(rootDirectoryPath) {
 const rootDirectoryPath = process.cwd();
 
 async function getDependencies(options): Promise<Dependencies> {
-  const projectConfig = requireAndGetProjectConfig(rootDirectoryPath);
-  const datasource = new Datasource(projectConfig, rootDirectoryPath);
+  const useRootDirectoryPath = options.rootDirectoryPath || rootDirectoryPath;
+
+  const projectConfig = requireAndGetProjectConfig(useRootDirectoryPath);
+  const datasource = new Datasource(projectConfig, useRootDirectoryPath);
 
   return {
-    rootDirectoryPath,
+    rootDirectoryPath: useRootDirectoryPath,
     projectConfig,
     datasource,
     options,
@@ -228,7 +230,9 @@ async function main() {
         const deps = await getDependencies(options);
 
         try {
-          await findDuplicateSegmentsInProject(deps);
+          await findDuplicateSegmentsInProject(deps, {
+            authors: options.authors,
+          });
         } catch (e) {
           console.error(e.message);
           process.exit(1);
@@ -236,6 +240,7 @@ async function main() {
       },
     })
     .example("$0 find-duplicate-segments", "list segments with same conditions")
+    .example("$0 find-duplicate-segments --authors", "show the duplicates along with author names")
 
     /**
      * Find usage
diff --git a/packages/core/src/find-duplicate-segments/findDuplicateSegments.ts b/packages/core/src/find-duplicate-segments/findDuplicateSegments.ts
index 72e4a3a0..399757b1 100644
--- a/packages/core/src/find-duplicate-segments/findDuplicateSegments.ts
+++ b/packages/core/src/find-duplicate-segments/findDuplicateSegments.ts
@@ -1,10 +1,24 @@
 import * as crypto from "crypto";
 
-import { SegmentKey } from "@featurevisor/types";
+import { HistoryEntry, SegmentKey } from "@featurevisor/types";
 
-import { Datasource } from "../datasource";
+import { Dependencies } from "../dependencies";
+
+export interface DuplicateSegmentsOptions {
+  authors?: boolean;
+}
+
+export interface DuplicateSegmentsResult {
+  segments: SegmentKey[];
+  authors?: string[];
+}
+
+export async function findDuplicateSegments(
+  deps: Dependencies,
+  options: DuplicateSegmentsOptions = {},
+): Promise<DuplicateSegmentsResult[]> {
+  const { datasource } = deps;
 
-export async function findDuplicateSegments(datasource: Datasource): Promise<SegmentKey[][]> {
   const segments = await datasource.listSegments();
 
   const segmentsWithHash: { segmentKey: SegmentKey; hash: string }[] = [];
@@ -30,7 +44,33 @@ export async function findDuplicateSegments(datasource: Datasource): Promise<Seg
     {},
   );
 
-  const result = Object.values(groupedSegments).filter((segmentKeys) => segmentKeys.length > 1);
+  const duplicateSegments = Object.values(groupedSegments).filter(
+    (segmentKeys) => segmentKeys.length > 1,
+  );
+  const result: DuplicateSegmentsResult[] = [];
+
+  for (const segmentKeys of duplicateSegments) {
+    const entry: DuplicateSegmentsResult = {
+      segments: segmentKeys,
+    };
+
+    if (options.authors) {
+      const historyEntries: HistoryEntry[] = [];
+
+      for (const segmentKey of segmentKeys) {
+        const entries = await datasource.listHistoryEntries("segment", segmentKey);
+
+        entries.forEach((entry) => {
+          historyEntries.push(entry);
+        });
+      }
+
+      const authors = Array.from(new Set(historyEntries.map((entry) => entry.author)));
+      entry.authors = authors;
+    }
+
+    result.push(entry);
+  }
 
   return result;
 }
diff --git a/packages/core/src/find-duplicate-segments/index.ts b/packages/core/src/find-duplicate-segments/index.ts
index 2c1810d9..61e7723b 100644
--- a/packages/core/src/find-duplicate-segments/index.ts
+++ b/packages/core/src/find-duplicate-segments/index.ts
@@ -1,19 +1,28 @@
-import { findDuplicateSegments } from "./findDuplicateSegments";
+import { findDuplicateSegments, DuplicateSegmentsOptions } from "./findDuplicateSegments";
 import { Dependencies } from "../dependencies";
 
-export async function findDuplicateSegmentsInProject(deps: Dependencies) {
-  const { datasource } = deps;
+export async function findDuplicateSegmentsInProject(
+  deps: Dependencies,
+  options: DuplicateSegmentsOptions = {},
+) {
+  const duplicates = await findDuplicateSegments(deps, options);
 
-  const duplicates = await findDuplicateSegments(datasource);
+  console.log("");
 
   if (duplicates.length === 0) {
     console.log("No duplicate segments found");
     return;
   }
 
-  console.log(`Found ${duplicates.length} duplicates:\n`);
+  console.log(`Found ${duplicates.length} duplicate(s):\n`);
 
-  duplicates.forEach((segmentKeys) => {
-    console.log(`  - ${segmentKeys.join(", ")}`);
+  duplicates.forEach((entry) => {
+    if (options.authors) {
+      console.log(`  - Segments: ${entry.segments.join(", ")}`);
+      console.log(`    Authors:  ${entry.authors && entry.authors.join(", ")}`);
+      console.log("");
+    } else {
+      console.log(`  - ${entry.segments.join(", ")}`);
+    }
   });
 }

From 7164b8bdd056f9302ead794acf7424df98345f45 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Fri, 26 Apr 2024 16:58:09 +0000
Subject: [PATCH 40/48] v1.19.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 99f8341e..ffc224f6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+
+### Features
+
+* find duplicate segments with authors info ([#299](https://github.com/featurevisor/featurevisor/issues/299)) ([5008066](https://github.com/featurevisor/featurevisor/commit/5008066128fb7c732b633856dcffcb768f52c88c))
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index 1b3755a9..1835b406 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 7a567dc2..f5f3cd0e 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.1"
+    "@featurevisor/cli": "^1.19.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 03ac1242..7ed31aa5 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index bb0043ee..c5f36dae 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.1"
+    "@featurevisor/cli": "^1.19.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index a288e693..44795b59 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index efd8288f..baf5c64b 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.1",
+    "@featurevisor/cli": "^1.19.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 05d1d8a7..ad3ee4e7 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 0a231418..2d65a537 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.1"
+    "@featurevisor/cli": "^1.19.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index c15b65c8..21f24786 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index b37f2aec..5e4a9933 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.18.1"
+    "@featurevisor/cli": "^1.19.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index 9668fe78..f851759a 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.18.1"
+  "version": "1.19.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 18211e29..ed9564bf 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.1"
+        "@featurevisor/cli": "^1.19.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.1"
+        "@featurevisor/cli": "^1.19.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.1",
+        "@featurevisor/cli": "^1.19.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.1"
+        "@featurevisor/cli": "^1.19.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.18.1"
+        "@featurevisor/cli": "^1.19.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.18.1",
+        "@featurevisor/core": "^1.19.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.18.1",
+      "version": "1.19.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.17.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index ce634c8d..2f9d3b4d 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+
+### Features
+
+* find duplicate segments with authors info ([#299](https://github.com/featurevisor/featurevisor/issues/299)) ([5008066](https://github.com/featurevisor/featurevisor/commit/5008066128fb7c732b633856dcffcb768f52c88c))
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/cli
diff --git a/packages/cli/package.json b/packages/cli/package.json
index ed473e71..5240c770 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.18.1",
+    "@featurevisor/core": "^1.19.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index f9f2f5b1..d21b3287 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
+
+
+### Features
+
+* find duplicate segments with authors info ([#299](https://github.com/featurevisor/featurevisor/issues/299)) ([5008066](https://github.com/featurevisor/featurevisor/commit/5008066128fb7c732b633856dcffcb768f52c88c))
+
+
+
+
+
 ## [1.18.1](https://github.com/featurevisor/featurevisor/compare/v1.18.0...v1.18.1) (2024-04-23)
 
 **Note:** Version bump only for package @featurevisor/core
diff --git a/packages/core/package.json b/packages/core/package.json
index 7a1082f3..dba7d2da 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From e2e59e35a17b9239b5c671e5e0b9fceb29415e25 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Sat, 27 Apr 2024 18:58:24 +0200
Subject: [PATCH 41/48] docs: glossary (#291)

---
 docs/glossary.md            | 771 ++++++++++++++++++++++++++++++++++++
 docs/sidebarNavigation.json |   1 +
 2 files changed, 772 insertions(+)
 create mode 100644 docs/glossary.md

diff --git a/docs/glossary.md b/docs/glossary.md
new file mode 100644
index 00000000..5f803af0
--- /dev/null
+++ b/docs/glossary.md
@@ -0,0 +1,771 @@
+---
+title: Glossary
+description: Glossary of terms that you will come across when adopting feature management principles with Featurevisor
+ogImage: /img/og/docs-glossary.png
+---
+
+Featurevisor is a tool that helps you adopt feature management practices in your organization and applications. This also introduces a lot of new terms, and this glossary is aimed at helping you understand quickly what they are all about. {% .lead %}
+
+## A/B Test
+
+An A/B test is a method of comparing two (or more) variations of a feature to determine which one performs better.
+
+It involves dividing users into two (or more) groups and showing each group a different variation of the feature. The feature could be the colour or placement of a call to action button in a landing page for example.
+
+The performance of each variation is then measured based on user behavior, such as click-through rates or conversion rates, to determine which variation is more effective.
+
+Learn more in [Experiments](/docs/use-cases/experiments) guide.
+
+## Activation
+
+When a particular user is exposed to an [experiment](#experiment), applications are required to activate that experiment for that user by tracking it accordingly.
+
+The payload for tracking that activation event usually includes:
+
+- The experiment key
+- The evaluated variation
+- The user's ID
+
+This then helps measure the performance of the experiment itself later against your [conversion goals](#conversion-goal).
+
+See how SDKs help with tracking activations [here](/docs/sdks/javascript/#activation).
+
+## Application
+
+An application could either be your:
+
+- Web application
+- iOS app
+- Android app
+- Backend service
+- Command line tool
+- ...or anything else that you build
+
+Featurevisor provides [SDKs](/docs/sdks/) in a few different programming languages to help you evaluate your features.
+
+## Approval
+
+Because Featurevisor adopts [GitOps](/docs/concepts/gitops) principles, all changes are made via [Pull Requests](#pull-request).
+
+When you send Pull Requests, you often require approvals from your peers before [merging](#merge) them (applying the changes).
+
+## Archive
+
+Featurevisor [entities](#entity) can be archived at your convenience:
+
+- [Archiving an attribute](/docs/attributes/#archiving)
+- [Archiving a segment](/docs/segments/#archiving)
+- [Archiving a feature](/docs/features/#archiving)
+
+Archiving here means that we still keep our entity definitions in place, but not serving their configuration to our applications via generated [datafiles](#datafile) any more.
+
+## Array
+
+Arrays are a data structure that allowing you to define a list of items. Featurevisor supports [variables](#variable), where `array` is one of the supported types.
+
+You can learn more about using arrays as variables [here](/docs/features/#array).
+
+## Assertion
+
+Featurevisor allows [testing](#testing) your features and segments, to make sure they are working as per your expectations before applying any changes anywhere.
+
+A single test can consist of one or more assertions. Each assertion is basically a test scenario for your feature or segment against [contexts](#context).
+
+Learn more about testing [here](/docs/testing).
+
+## Attribute
+
+An attribute is one of the core building blocks of Featurevisor. You can consider them to be like field names which are using in conditions inside [segments](#segment).
+
+Learn more about attributes [here](/docs/attributes).
+
+## Boolean
+
+A boolean type is a data type that represents two possible values: `true` and `false`. You may consider it to be like an on/off switch.
+
+In Featurevisor, it can apply to a few different areas:
+
+- If Feature itself is [enabled or disabled](/docs/sdks/javascript/#checking-if-enabled)
+- Boolean type for [variables](/docs/features/#boolean)
+
+## Branch
+
+A [Git](#git) branch is a pointer to a specific sequence of [commits](#commit) in a [repository](#repository).
+
+It represents an independent line of development in a project, allowing you to isolate changes for specific features or tasks. The default branch in Git is usually called `master` or `main`.
+
+You can create, switch to, [merge](#merge), and delete branches using various Git commands. This branching mechanism facilitates collaboration, experimentation, and non-linear development workflows.
+
+## Browser
+
+Browsers help you access web applications. If you are using Chrome, Firefox, or Safari, then you are using a browser already.
+
+## Bucketing
+
+Bucketing is the process how we make sure a particular user is consistently seeing a feature as enabled/disabled or a specific variation (if an [A/B test](#a-b-test) experiment) across all sessions and devices in your application(s).
+
+Learn more about bucketing here:
+
+- [Bucketing concept](/docs/bucketing)
+- [Configuring bucketing in features](/docs/features/#bucketing)
+
+## Build
+
+Featurevisor has a build step, where it generates [datafiles](#datafile) (JSON files) for your project against your [environments](#environment) and [tags](#tag).
+
+Learn more about building datafiles [here](/docs/building-datafiles).
+
+## CDN
+
+A CDN, or Content Delivery Network, is a system of distributed servers that deliver web content to a user based on their geographic location, the origin of the webpage, and the content delivery server itself.
+
+It's designed to reduce latency and increase the speed of web content delivery by serving content from the server closest to the user. CDNs are commonly used for serving static resources of a website like images, CSS, and JavaScript files.
+
+Featurevisor expects that its generated [datafiles](#datafile) are [served](#deployment) via a CDN.
+
+Examples of CDNs include:
+
+- AWS Cloudfront
+- Cloudflare
+- Fastly
+
+## CI/CD
+
+CI stands for Continuous Integration, which is a software development practice that involves frequently merging code changes into a shared repository. It ensures that each code change is tested and integrated with the existing codebase as early as possible.
+
+CD stands for Continuous Deployment, which is an extension of Continuous Integration. It automates the process of deploying software changes to production environments after passing the necessary tests and quality checks. It enables teams to deliver software updates quickly and frequently to end-users.
+
+## CLI
+
+CLI stands for Command Line Interface. It is a text-based interface that allows users to interact with a computer program or operating system by typing commands into a [terminal](#terminal) or command prompt.
+
+Learn more [here](/docs/cli).
+
+## Commit
+
+A [Git](#git) commit is a command that saves changes to a local [repository](#repository). It's like a snapshot of your work that you can revert to or compare with other versions later.
+
+Each commit has a unique ID (a hash), a message describing the changes, and information about the author.
+
+Commits form a linear or branched history, allowing you to track progress and understand the evolution of a project.
+
+## Condition
+
+Conditions are the building blocks of your segments. Learn more in [segments](/docs/segments).
+
+## Configuration
+
+Featurevisor manages its project configuration via `featurevisor.config.js` file.
+
+Learn more about project configuration [here](/docs/configuration).
+
+## Context
+
+When Featurevisor SDKs [evaluate](#evaluation) a feature or its variation and variables, it expects to receive some additional information about the user. Based on this information, SDKs then return you the desired value for that specific user.
+
+This additional info could be:
+
+- the User's ID
+- their location
+- browser name
+- ...etc
+
+We call this information `context`. You can learn more about how it's used in SDKs [here](/docs/sdks/javascript/#context).
+
+##  Conversion goal
+
+A conversion goal is a specific action or event that you want your users to take or achieve when interacting with your application(s).
+
+It represents a desired outcome or objective, such as making a purchase, signing up for a newsletter, or completing a form. Conversion goals are used to measure the success and effectiveness of your features or experiments by tracking the percentage of users who successfully complete the desired action.
+
+## Datafile
+
+Featurevisor generates datafiles ([JSON](#json) files) which are then consumed by [SDKs](#sdk) in your application(s).
+
+Learn more here about:
+
+- [Building datafiles](/docs/building-datafiles)
+- [Consuming datafiles](/docs/sdks/javascript/#initialization)
+
+## Deployment
+
+Once your datafiles are generated, the idea is to upload it to a [CDN](#cdn) (or a custom server) so that your applications can access and [fetch](#fetch) these files.
+
+You can learn more about deployment strategies [here](/docs/deployment).
+
+## Deprecate
+
+It can be very easy to keep creating new features, but not always a nice experience when you wish to get rid of them. The challenge mostly comes from having to figure out which [applications](#application) are already using those features (if any).
+
+This is where deprecation comes in handy. Deprecating a feature in Featurevisor means we are choosing to remove any usage of it soon, but we are not deleting it yet for not impacting any existing applications negatively.
+
+Any SDK that evaluates deprecated features will emit warnings so the developers are notified about it and are given enough time to remove the usage of those features from their applications.
+
+Learn more about it [here](/docs/features/#deprecating).
+
+## Declarative
+
+Featurevisor takes a declarative approach to defining all our configuration in the form of [attributes](#attribute), [segments](#segment), and [features](#feature).
+
+By being declarative, it means that we are only declaring (telling the system) what outcome we desire, and then Featurevisor takes care of everything else for us.
+
+These concepts can help you understand more about it:
+
+- [Infrastructure as Code (IaC)](/docs/concepts/infrastructure-as-code)
+- [GitOps](/docs/concepts/gitops)
+
+## Description
+
+All Featurevisor [entities](#entity) expect descriptions, to help document what they are intended to be used for.
+
+## Directory
+
+A directory, also known as a folder, is a container used to organize [files](#file) and other directories within a file system.
+
+## Double
+
+Featurevisor allows `double` as a data type for [variables](#variable), which allows you to have numbers with decimal places.
+
+Learn more about its usage [here](/docs/features/#double).
+
+## Entity
+
+All the building blocks of Featurevisor are called entities, which are:
+
+- [Attribute](/docs/attributes)
+- [Segment](/docs/segments)
+- [Feature](/docs/features)
+- [Group](/docs/groups)
+
+## Environment
+
+In software engineering, an environment refers to the specific configuration and settings in which a software application or system operates.
+
+If you are an application developer, it may mean:
+
+- **staging environment**: where you test your application out before deploying to production
+- **production environment**: where your real users access your application
+
+## Evaluation
+
+Evaluation is the process how Featurevisor SDKs compute the values of feature's own:
+
+- enabled/disabled status
+- its [variations](#variation), and
+- [variables](#variable)
+
+against a given [context](#context).
+
+Learn more in [SDKs](/docs/sdks/) page.
+
+## Event
+
+Featurevisor [SDKs](#sdk) emit several different kinds of events for [applications](#application) to hook into depending on their use cases.
+
+Learn more here:
+
+- [Readiness](/docs/sdks/javascript/#asynchronous)
+- [Activation](/docs/sdks/javascript/#activation)
+- [Events](/docs/sdks/javascript/#events)
+- [Logging](/docs/sdks/javascript/#logging)
+
+## Experiment
+
+Experiments can be of two types in Featurevisor:
+
+- [A/B test](#a-b-test)
+- [Multivariate tests](#multivariate-test)
+
+Even though they are experiments in traditional terms, in Featurevisor everything is defined as a feature (either it's a simple feature with enabled/disabled status, or one with also [variations](#variation)).
+
+Learn more about them in [Experiments](/docs/use-cases/experiments) guide.
+
+## Expose
+
+Exposing a feature in a specific [environment](#environment) is an advanced technique which is very handy when you are migrating away from another feature management tool to Featurevisor.
+
+There might be cases where you want Featurevisor to be used in [staging](#staging) environment for specific features first, while still using the previous existing feature management tool in [production](#production).
+
+Learn more how exposing works on a per environment basis [here](/docs/features/#expose).
+
+## Feature
+
+Either you want a:
+
+- simple feature flag with enabled/disabled status, or
+- one with [variations](#variation) to be treated as an [experiment](#experiment), or
+- one with [variables](#variable) for more complex configuration
+
+...everything is defined as a feature in Featurevisor.
+
+A feature is the core building block, and you can learn more about its anatomy [here](/docs/features).
+
+## Fetch
+
+Fetching is the process of how Featurevisor [SDKs](#sdk) pull in the latest datafiles over the network which packs all the configuration for evaluating all your features in your application against provided contexts.
+
+## File
+
+A file is a container in a computer system for storing information, often in the form of text, images, audio, or software.
+
+Featurevisor [entities](#entity) are all stored as files in their own [directories](#directory).
+
+## Flag
+
+These terms are often used interchangeably:
+
+- [Feature](#feature)
+- Feature flag
+- Flag
+
+## Force
+
+While you may set up all your [rules](#rule) inside a feature targeting various [segments](#segment), you may want to override them all for certain users, especially when you wish to test things out yourself before affecting your real users in [production](#production).
+
+This guide for testing in production will explain the use case well [here](/docs/use-cases/testing-in-production).
+
+The `force` API docs can be found [here](/docs/features/#force).
+
+## Git
+
+Git is a distributed version control system that allows multiple people to work on a project at the same time without overwriting each other's changes. It tracks changes to files in a [repository](#repository) (think a project) so you can see what was changed, who changed it, and why.
+
+Git is widely used in software development for source code management. With Featurevisor, all feature configurations are stored in a Git repository that we call our Featurevisor project.
+
+## GitHub
+
+GitHub is a web-based hosting service for version control using Git. It provides a platform for collaboration, allowing developers to contribute to projects, fork repositories, submit [pull requests](#pull-request), and manage versioned files.
+
+## GitHub Actions
+
+GitHub Actions is a CI/CD (Continuous Integration/Continuous Deployment) service provided by [GitHub](#github). It allows developers to automate, customize, and execute their software development workflows right in their GitHub repository.
+
+Actions can be used to build, test, and [deploy](#deployment) applications, manage issues, publish packages, and much more. Workflows are defined using [YAML](#yaml) syntax and can be triggered by various GitHub events such as push, [pull requests](#pull-request) or issue creation.
+
+## GitOps
+
+In its simplest form GitOps means doing operations using [Git](#git).
+
+Read our [GitOps](/docs/concepts/gitops) guide for more info.
+
+## Group
+
+When you wish to run mutually exclusive [experiments](#experiment), meaning the same user should be exposed to two or more overlapping experiments, groups come in handy.
+
+Learn more about groups [here](/docs/groups).
+
+## Hash
+
+Featurevisor [SDKs]](#sdk) rely on in-memory hashing algorithm making sure same user is bucketed into same feature and variation based on rollout rules consistently across all devices and sessions.
+
+Learn more about it in our guide for [bucketing](/docs/bucketing).
+
+## Instance
+
+Refers to the instance of the [SDK](#sdk), once initialized with your desired configuration parameters.
+
+Learn more about SDK usage [here](/docs/sdks/javascript).
+
+## Integer
+
+If you wish to define [variables](#variable) which are whole numbers (without decimal places), then `integer` type is what you need.
+
+Learn more about integer type's usage in variables [here](/docs/features/#integer).
+
+## Interval
+
+Featurevisor [SDKs](#sdk) allow refreshing datafiles, and one of the techniques can be interval based, meaning it can keep refreshing the [datafile](#datafile) every X number of seconds.
+
+You can learn more about refreshing in SDKs [here](/docs/sdks/javascript/#refreshing).
+
+## JavaScript
+
+JavaScript is a high-level, interpreted programming language primarily used for enhancing web pages to provide a more interactive user experience. It's one of the core technologies of the web, alongside HTML and CSS.
+
+Featurevisor CLI is written in JavaScript, targeting Node.js runtime.
+
+But the JavaScript SDK is universal, meaning it works in both browsers and in Node.js.
+
+## JSON
+
+JSON (JavaScript Object Notation) is a lightweight data-interchange format that is easy for humans to read and write and easy for machines to parse and generate.
+
+It's often used to transmit data between a server and an application.
+
+From Featurevisor's perspective, it builds [datafiles](#datafile) (which are JSON files). These datafiles are then [fetched](#fetch) and consumed by applications using Featurevisor [SDKs](#sdk) in various different programming languages.
+
+## Key
+
+Keys may mean the name of your Featurevisor entities like [attribute](#attribute), [segments](#segment), and [features](#feature). The names are based on their file names without their extensions (like `.yml`, or `.json`).
+
+When [variables](/docs/features/#variables) are defined inside a feature, they are also given unique keys within their features.
+
+As for [rules](/docs/features/#rules) within [environments](#environment), they also have their own keys.
+
+## Level
+
+Refers to the different levels of [logging](#logging), like:
+
+- `log`
+- `info`
+- `warn`
+- `error`
+
+## Lint
+
+Entities are expressed declaratively in Featurevisor, primarily as [YAML](#yaml) or [JSON](#json) files.
+
+To make sure they do not contain any human introduced mistakes, linting takes care of finding those issues early (if any) before proceeding with [building datafiles](/docs/building-datafiles).
+
+Learn more about linting [here](/docs/linting).
+
+## Logging
+
+Featurevisor [SDKs](#sdk) allow logging various different levels of messages which can be used for tracking, analyzing performance, troubleshooting, understanding how [evaluations](#evaluation) are done and more.
+
+Learn more about logging [here](/docs/sdks/javascript/#logging).
+
+## Merge
+
+When you send a [Pull Request](#pull-request) making changes to the configuration of your desired Featurevisor entities, you then proceed with merging it to finally apply the changes so it impacts your applications.
+
+## Multivariate Test
+
+Traditionally with A/B tests, you test a single [variation](#variation) change.
+
+With multivariate tests, multiple [variables](#variable) are modified for testing a hypothesis.
+
+Learn about it more depth in our [Experiments](/docs/use-cases/experiments) guide.
+
+## Mutually Exclusive
+
+When you do not wish to expose a single user to more than one experiment at a time from your list of predefined experiments.
+
+Featurevisor allows you to achieve that via [Groups](/docs/groups).
+
+## Name
+
+The word **name** may often be used interchangeably with **key**.
+
+Like your [feature](#feature) name or key.
+
+## Native apps
+
+Usually means applications which are built specifically for a platform, like iOS and Android apps.
+
+## Node.js
+
+JavaScript the programming language was originally introduced to work in browsers only. With the introduction of Node.js, which is an open-source, cross-platform, JavaScript runtime environment, allowed executing code written in this language outside of a web browser as well.
+
+This includes server-side and [command line applications](#cli).
+
+Featurevisor CLI is a Node.js package allowing you to use it via command line in Terminal.
+
+While Featurevisor JavaScript SDK works in both browsers and in Node.js services.
+
+## npm
+
+npm is a package manager for Node.js.
+
+Like millions of other open source packages, Featurevisor is also distributed via npm.
+
+As application builders and users of Featurevisor, we download Featurevisor [packages](#package) via npm.
+
+## Object
+
+Featurevisor allows defining flat objects (key/value pairs of data) as [variables](#variable).
+
+Learn more about its usage [here](/docs/features/#object).
+
+## Operator
+
+When we define [segments](#segment), it will contain various different [conditions](#condition). And each of those conditions will use operators like `equals`, `notEquals`, and more against your desired values.
+
+See full list of supported operators [here](/docs/segments/#operators).
+
+## Override
+
+Variations and variables inside features can be overridden in few different ways allowing more flexibility as our features grow more complex.
+
+Learn more about them here:
+
+- [Overriding variation](/docs/features/#overriding-variation)
+- [Overriding variables](/docs/features/#overriding-variables)
+
+## Package
+
+Featurevisor as a tool is a set of various different packages, which are distributed via package managers targeting different programming languages.
+
+The [CLI](#cli) is written in [JavaScript](#javascript) targeting [Node.js](#nodejs) runtime, which is distributed via [npm](#npm).
+
+## Parser
+
+By default, Featurevisor expects all [entities](#entity) will be defined as [YAML](#yaml) files. With native support of choosing [JSON](#json) as well.
+
+Next to that, the project configuration API allows you to bring in your own custom parser for different formats like TOML, XML, etc.
+
+Learn more about them here:
+
+- [Custom parsers](/docs/advanced/custom-parsers)
+- [Project configuration](/docs/configuration)
+
+## Percentage
+
+Not all releases of your features should be a big bang release affecting all your users. You may want to roll it out gradually, starting with 5%, then 10%, then 20%, and all the way up to 100% as you gain more confidence.
+
+These percentages are defined in your rollout [rules](/docs/features/#rules) inside features.
+
+Learn more about gradual rollout and progressive delivery [here](/docs/use-cases/progressive-delivery).
+
+## Pretty
+
+When machines deal with JSON files, they usually are in their most compressed form to save disk space and network bandwidth. When compressed, they also affect readability for humans negatively.
+
+For debugging (investigating) purposes, there's an option in Featurevisor's project configuration to allow for [pretty datafiles](/docs/configuration/#pretty-datafile) and [pretty state files](/docs/configuration/#pretty-state) improving readability for humans.
+
+## Production
+
+Refers to the production [environment](#environment), where your application(s) are deployed to affecting your real users.
+
+## Project
+
+Your Featurevisor project, which is usually a single independent Git [repository](#repository).
+
+See quick start guide on how to create a new project [here](/docs/quick-start).
+
+## Pull Request
+
+A pull request is a feature in version control systems like [Git](#git), and platforms like [GitHub](#github), that allows developers to propose changes to a codebase.
+
+It's a request to "pull" your changes into the main project. Pull requests show content differences, facilitate discussions, code [review](#review), and can be integrated with other testing and [CI/CD](#ci-cd) tools before the changes are [merged](#merge) into the main branch.
+
+## Push
+
+In the context of [Git](#git), "push" is a command used to upload local [repository](#repository) content to a remote repository.
+
+After [committing](#commit) changes locally, you "push" them to the remote repository to share your changes with others and synchronize your local repository with the remote. It's an essential command for collaborative work in Git.
+
+## QA
+
+Many organizations have Quality Assurance (QA) teams, making sure everything is working as expected before the changes of your applications are exposed to your real users, minimizing any potential risks.
+
+## Ready
+
+When Featurevisor SDKs are used [asynchronously](/docs/sdks/javascript/#initialization), we are delegating the responsibility of [fetching](#fetch) the [datafile](#datafile) to the SDK itself.
+
+The fetching of datafile is an asynchronous task over the network. To know when Featurevisor SDK has successfully fetched the datafile, we rely on its readiness events.
+
+Learn more about their usage here:
+
+- [onReady option](/docs/sdks/javascript/#asynchronous)
+- [isReady method](/docs/sdks/javascript/#listening-to-events)
+- [onReady method](/docs/sdks/javascript/#listening-to-events)
+
+## Refresh
+
+Featurevisor SDKs allow refreshing [datafile](#datafile) content without having to restart or reload your whole [application](#application).
+
+Learn more about refreshing [here](/docs/sdks/javascript/#refreshing).
+
+## Repository
+
+A repository, often abbreviated as "repo", is a storage location for software packages. It contains all files and directories associated with a project.
+
+From Featurevisor's perspective, a single project is usually its own independent [Git](#git) repository consisting of files which are defining various entities like [attributes](#attribute), [segments](#segment), and [features](#feature).
+
+## Review
+
+When we send [Pull Requests](#pull-request), the idea is to get it reviewed by our peers who may either [approve](#approval), reject, or request for more changes.
+
+## Revision
+
+Each successful [build](#build) of Featurevisor [datafiles](#datafile) produce a new revision number. This is in integer format (a whole number with no decimal places), and is incremented by 1 from previous build's revision.
+
+This revision number is present in all generated datafiles, so applications will know which revision they are using with provided SDKs.
+
+Learn more about it:
+
+- [Building datafiles](/docs/building-datafiles)
+- [State files](/docs/state-files)
+
+## Required
+
+Featurevisor supports defining certain features as dependencies for a particular feature.
+
+Learn more about it here:
+
+- [Managing feature dependencies](/docs/use-cases/dependencies)
+- [Defining dependencies in features](/docs/features/#required)
+
+## Rule
+
+Rollout rules are defined per [environment](#environment) for each individual [features](#feature).
+
+Learn more about rules [here](/docs/features/#rules).
+
+## Schema
+
+When [variables](#variable) are defined inside a feature, they must also provide their own schema to let Featurevisor know more about it.
+
+Learn more about variables schema [here](/docs/features/#variables).
+
+## SDK
+
+SDK stands for Software Development Kit.
+
+Featurevisor comes with [SDKs](/docs/sdks) in a few different programming languages. Their purpose is to [fetch](#fetch) [datafiles](#datafile) and [evaluate](#evaluation) values in your applications as you need them.
+
+## Segment
+
+Segments are groups of [conditions](#condition), which are then used in the rollout [rules](#rule) of your features.
+
+Learn more about segments:
+
+- [Defining segments](/docs/segments)
+- [Using segments in feature rules](/docs/features/#segments)
+
+## Site
+
+Featurevisor is also capable of generating a static read-only website based on all [entity](#entity) definitions as found in your project [repository](#repository).
+
+This generated site, once hosted, serves as a dashboard for your team and organization for understanding what's the latest state of configuration everywhere.
+
+Learn more about it [here](/docs/site).
+
+## Slot
+
+When defining mutually exclusive [experiments](#experiment) (think [features](#feature) in Featurevisor) in a [group](#group), each feature is put in a slot so they never overlap.
+
+Learn more about usage of slots in groups [here](/docs/groups).
+
+## Staging
+
+Similar to [production](#production), staging is a common [environment](#environment) in software engineering culture.
+
+This environment is meant to serve for testing things out internally within the team, before deploying the changes to production where your real users are.
+
+## State files
+
+Because there's no real database involved in Featurevisor, the tool uses [Git](#git) for storing and keeping track of all traffic allocation information against rollout rules in features, and incremental revision numbers.
+
+Learn more about them and their usage here:
+
+- [State files](/docs/state-files)
+- [Deployment](/docs/deployment)
+
+## Status
+
+A status check for a [commit](#commit) is a process in version control systems like [Git](#git), and platforms like [GitHub](#github), that verifies the commit against certain criteria before it's merged into the main [branch](#branch).
+
+This can include running automated tests, checking for code style adherence, verifying the commit message format, and more. Status checks help maintain code quality and prevent introducing errors into the main codebase. They are often integrated into the [pull request](#pull-request) process.
+
+## Sticky
+
+Applications may often decide to make certain [evaluations](#evaluation) sticky (not take fetched [datafile](#datafile) into account) for specific users against certain [features](#feature) for the lifecycle of the [SDK](#sdk).
+
+You can more about how Featurevisor SDKs allow that [here](/docs/sdks/javascript/#stickiness).
+
+## String
+
+String is a data type that's used for texts. It is one among many other data types that's supported in [variables](#variable).
+
+Learn more about it [here](/docs/features/#string).
+
+## Tag
+
+Your organization may have a single Featurevisor [project](#project), in a single Git repository, containing several hundreds or thousands of [features](#feature).
+
+But there might be 10 or more separate consumers (applications), and they each may want to fetch [datafiles](#datafile) containing only a subset of all the features found in your project.
+
+This is where tagging comes in handy. Each feature can be tagged accordingly, and datafile generator will take care of building tag specific files for your applications to consume. Each application is then able to fetch only the features they need and nothing more or less.
+
+Learn more about it here:
+
+- [Building datafiles](/docs/building-datafiles)
+- [Tags in features](/docs/features/#tags)
+
+## Terminal
+
+A Terminal, also known as a command line or console, is a text-based interface used to interact with an operating system. Users can input commands to perform operations, navigate the file system, and run scripts or applications.
+
+If you are using macOS, then this is your Terminal app.
+
+## Testing
+
+Unlike any other feature management tools, Featurevisor allows your to test your [segments](#segment) and [features](#feature) against your expectations.
+
+This is similar to "unit testing" in regular programming.
+
+Just like how features and segments are defined declaratively, you can also define your tests for them declaratively, and Featurevisor will test everything for you.
+
+If some tests are failing, it means something is wrong somewhere and we can fix it early before applying our changes.
+
+Learn more about it [here](/docs/testing).
+
+## Tracking
+
+Experiments are of no use if we are not tracking anything.
+
+Featurevisor SDKs emit [activation](#activation) events, which can be handled and then tracked accordingly using your favourite analytics service.
+
+Here are some guides regarding tracking activation events:
+
+- [Activating features](/docs/sdks/javascript/#activation)
+- [Tracking with Google Analytics / Tag Manager](/docs/tracking/google-analytics)
+
+## Usage
+
+Sometimes we create [segments](#segment) and [attributes](#attribute), and we can't always tell quickly where they are actively being used.
+
+Featurevisor CLI brings in some goodies to help find their usage, and also entities which are not used anywhere so you can take actions to clean them up.
+
+Learn more about it [here](/docs/cli/#find-usage).
+
+## Value
+
+A value can be anything. This paragraph that you are reading can itself be a value.
+
+In terms of Featurevisor, a value can be the [evaluated](#evaluation) output of a:
+
+- feature's own enabled/disabled status
+- feature's variation
+- feature's variable
+
+See how SDKs evaluate values [here](/docs/sdks/).
+
+## Variable
+
+Variables are key/value pairs of data that be defined inside individual features.
+
+Learn more about their usage here:
+
+- [Defining variables in features](/docs/features/#variables)
+- [Evaluating variables using SDKs](/docs/sdks/javascript/#getting-variables)
+- [Remote configuration](/docs/use-cases/remote-configuration)
+
+## Variation
+
+Defining variations in features allow you to turn them into [A/B](#a-b-test) or [Multivariate test](#multivariate-test) experiments.
+
+Learn more about their usage here:
+
+- [Defining variations in features](/docs/features/#variations)
+- [Evaluating variations using SDKS](/docs/sdks/javascript/#getting-variations)
+
+## Weight
+
+When we define [variations](#variation) in our features, we also have to provide weights for each variation for splitting their traffic distribution.
+
+If you have only two variations, it could be a 50-50 split or a 20-80 split, depending on your needs. It's totally up to do you define them.
+
+It's important to understand that weights of variations are something different than rule [percentages](#percentage), because rules are affecting the entire [feature](#feature).
+
+Learn more about variations [here](/docs/features/#variations).
+
+## YAML
+
+YAML, which stands for "YAML Ain't Markup Language".
+
+It's a human-friendly data serialization standard and is often used for configuration files and in applications where data is being stored or transmitted.
+
+YAML is designed to be readable and easily editable by humans, and it allows complex data structures to be expressed in a natural and minimal syntax.
diff --git a/docs/sidebarNavigation.json b/docs/sidebarNavigation.json
index 5c80e346..f04165f6 100644
--- a/docs/sidebarNavigation.json
+++ b/docs/sidebarNavigation.json
@@ -134,6 +134,7 @@
     "links": [
       { "title": "Roadmap", "href": "/docs/roadmap" },
       { "title": "FAQ", "href": "/docs/faq" },
+      { "title": "Glossary", "href": "/docs/glossary" },
       { "title": "Examples", "href": "/docs/examples" },
       { "title": "Contributing", "href": "/docs/contributing" },
       { "title": "GitHub", "href": "https://github.com/featurevisor/featurevisor" }

From 8c3a0962a5950abf424695db314ee5eeb8e6ccd5 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Tue, 30 Apr 2024 20:06:30 +0200
Subject: [PATCH 42/48] feat: allow evaluating in CLI with more verbosity
 (#300)

---
 docs/cli.md                         | 10 ++++++
 packages/cli/src/index.ts           |  1 +
 packages/core/src/evaluate/index.ts | 48 +++++++++++++++++++++++++++--
 packages/sdk/src/instance.ts        |  5 +--
 4 files changed, 60 insertions(+), 4 deletions(-)

diff --git a/docs/cli.md b/docs/cli.md
index 6d52261c..15f237e8 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -240,6 +240,16 @@ $ npx featurevisor evaluate \
 
 The `--pretty` flag is optional.
 
+To print further logs in a more verbose way, you can pass `--verbose`:
+
+```
+$ npx featurevisor evaluate \
+  --environment=production \
+  --feature=my_feature \
+  --context='{"userId": "123", "country": "nl"}' \
+  --verbose
+```
+
 ## Assess distribution
 
 To check if the gradual rollout of a feature and the weight distribution of its variations (if any exists) are going to work as expected in a real world application with real traffic against provided [context](/docs/sdks/javascript/#context), we can imitate that by running:
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index a76d146e..13a78f5f 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -360,6 +360,7 @@ async function main() {
             context: options.context ? JSON.parse(options.context) : {},
             print: options.print,
             pretty: options.pretty,
+            verbose: options.verbose,
           });
         } catch (e) {
           console.error(e.message);
diff --git a/packages/core/src/evaluate/index.ts b/packages/core/src/evaluate/index.ts
index e85361c8..151161d1 100644
--- a/packages/core/src/evaluate/index.ts
+++ b/packages/core/src/evaluate/index.ts
@@ -1,5 +1,12 @@
 import { Context } from "@featurevisor/types";
-import { Evaluation, createInstance, createLogger } from "@featurevisor/sdk";
+import {
+  Evaluation,
+  createInstance,
+  createLogger,
+  LogLevel,
+  LogMessage,
+  LogDetails,
+} from "@featurevisor/sdk";
 
 import { Dependencies } from "../dependencies";
 import { SCHEMA_VERSION } from "../config";
@@ -28,6 +35,13 @@ function printEvaluationDetails(evaluation: Evaluation) {
   }
 }
 
+function printLogs(logs: Log[]) {
+  logs.forEach((log) => {
+    console.log(`[${log.level}] ${log.message}`, log.details);
+    console.log("");
+  });
+}
+
 function printHeader(message: string) {
   console.log("\n\n###############");
   console.log(`# ${message}`);
@@ -40,6 +54,13 @@ export interface EvaluateOptions {
   context: Record<string, unknown>;
   print?: boolean;
   pretty?: boolean;
+  verbose?: boolean;
+}
+
+export interface Log {
+  level: LogLevel;
+  message: LogMessage;
+  details?: LogDetails;
 }
 
 export async function evaluateFeature(deps: Dependencies, options: EvaluateOptions) {
@@ -57,7 +78,7 @@ export async function evaluateFeature(deps: Dependencies, options: EvaluateOptio
     existingState,
   );
 
-  const logs: Array<any> = [];
+  let logs: Log[] = [];
   const f = createInstance({
     datafile: datafileContent,
     logger: createLogger({
@@ -73,8 +94,15 @@ export async function evaluateFeature(deps: Dependencies, options: EvaluateOptio
   });
 
   const flagEvaluation = f.evaluateFlag(options.feature, options.context as Context);
+  const flagEvaluationLogs = [...logs];
+  logs = [];
+
   const variationEvaluation = f.evaluateVariation(options.feature, options.context as Context);
+  const variationEvaluationLogs = [...logs];
+  logs = [];
+
   const variableEvaluations: Record<string, Evaluation> = {};
+  const variableEvaluationLogs: Record<string, Log[]> = {};
 
   const feature = f.getFeature(options.feature);
   if (feature?.variablesSchema) {
@@ -84,6 +112,10 @@ export async function evaluateFeature(deps: Dependencies, options: EvaluateOptio
         v.key,
         options.context as Context,
       );
+
+      variableEvaluationLogs[v.key] = [...logs];
+      logs = [];
+
       variableEvaluations[v.key] = variableEvaluation;
     });
   }
@@ -109,6 +141,10 @@ export async function evaluateFeature(deps: Dependencies, options: EvaluateOptio
   // flag
   printHeader("Is enabled?");
 
+  if (options.verbose) {
+    printLogs(flagEvaluationLogs);
+  }
+
   console.log("Value:", flagEvaluation.enabled);
   console.log("\nDetails:\n");
 
@@ -118,6 +154,10 @@ export async function evaluateFeature(deps: Dependencies, options: EvaluateOptio
   printHeader("Variation");
 
   if (feature?.variations) {
+    if (options.verbose) {
+      printLogs(variationEvaluationLogs);
+    }
+
     console.log("Value:", JSON.stringify(variationEvaluation.variation?.value));
     console.log("\nDetails:\n");
 
@@ -131,6 +171,10 @@ export async function evaluateFeature(deps: Dependencies, options: EvaluateOptio
     for (const [key, value] of Object.entries(variableEvaluations)) {
       printHeader(`Variable: ${key}`);
 
+      if (options.verbose) {
+        printLogs(variableEvaluationLogs[key]);
+      }
+
       console.log(
         "Value:",
         typeof value.variableValue !== "undefined"
diff --git a/packages/sdk/src/instance.ts b/packages/sdk/src/instance.ts
index 85ce69f6..b5b86d15 100644
--- a/packages/sdk/src/instance.ts
+++ b/packages/sdk/src/instance.ts
@@ -87,6 +87,7 @@ export type DatafileFetchHandler = (datafileUrl: string) => Promise<DatafileCont
 export enum EvaluationReason {
   NOT_FOUND = "not_found",
   NO_VARIATIONS = "no_variations",
+  NO_MATCH = "no_match",
   DISABLED = "disabled",
   REQUIRED = "required",
   OUT_OF_RANGE = "out_of_range",
@@ -688,7 +689,7 @@ export class FeaturevisorInstance {
       // nothing matched
       evaluation = {
         featureKey: feature.key,
-        reason: EvaluationReason.ERROR, // @TODO: any better reason?
+        reason: EvaluationReason.NO_MATCH,
         bucketKey,
         bucketValue,
         enabled: false,
@@ -894,7 +895,7 @@ export class FeaturevisorInstance {
       // nothing matched
       evaluation = {
         featureKey: feature.key,
-        reason: EvaluationReason.ERROR, // @TODO: any better reason?
+        reason: EvaluationReason.NO_MATCH,
         bucketKey,
         bucketValue,
       };

From 2a66f338222849d2a40c31424d79e080e02f4e97 Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Tue, 30 Apr 2024 18:09:11 +0000
Subject: [PATCH 43/48] v1.20.0

---
 CHANGELOG.md                              | 11 +++++++
 examples/example-1/CHANGELOG.md           |  8 +++++
 examples/example-1/package.json           |  4 +--
 examples/example-json/CHANGELOG.md        |  8 +++++
 examples/example-json/package.json        |  4 +--
 examples/example-toml/CHANGELOG.md        |  8 +++++
 examples/example-toml/package.json        |  4 +--
 examples/example-yml-include/CHANGELOG.md |  8 +++++
 examples/example-yml-include/package.json |  4 +--
 examples/example-yml/CHANGELOG.md         |  8 +++++
 examples/example-yml/package.json         |  4 +--
 lerna.json                                |  2 +-
 package-lock.json                         | 38 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 +++++++
 packages/cli/package.json                 |  4 +--
 packages/core/CHANGELOG.md                | 11 +++++++
 packages/core/package.json                |  4 +--
 packages/react/CHANGELOG.md               |  8 +++++
 packages/react/package.json               |  4 +--
 packages/sdk/CHANGELOG.md                 | 11 +++++++
 packages/sdk/package.json                 |  2 +-
 packages/vue/CHANGELOG.md                 |  8 +++++
 packages/vue/package.json                 |  4 +--
 23 files changed, 139 insertions(+), 39 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ffc224f6..6f74408b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+
+### Features
+
+* allow evaluating in CLI with more verbosity ([#300](https://github.com/featurevisor/featurevisor/issues/300)) ([8c3a096](https://github.com/featurevisor/featurevisor/commit/8c3a0962a5950abf424695db314ee5eeb8e6ccd5))
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index 1835b406..f976b76c 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index f5f3cd0e..0552b59c 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.19.0"
+    "@featurevisor/cli": "^1.20.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 7ed31aa5..f810f843 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index c5f36dae..b58ff5a1 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.19.0"
+    "@featurevisor/cli": "^1.20.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 44795b59..1a8945a1 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index baf5c64b..5902181a 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.19.0",
+    "@featurevisor/cli": "^1.20.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index ad3ee4e7..94dd6223 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 2d65a537..88fb92ef 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.19.0"
+    "@featurevisor/cli": "^1.20.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 21f24786..61c22151 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 5e4a9933..563214c0 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.19.0"
+    "@featurevisor/cli": "^1.20.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index f851759a..bd9fedd7 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.19.0"
+  "version": "1.20.0"
 }
diff --git a/package-lock.json b/package-lock.json
index ed9564bf..399ea368 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.19.0"
+        "@featurevisor/cli": "^1.20.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.19.0"
+        "@featurevisor/cli": "^1.20.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.19.0",
+        "@featurevisor/cli": "^1.20.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.19.0"
+        "@featurevisor/cli": "^1.20.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.19.0"
+        "@featurevisor/cli": "^1.20.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.19.0",
+        "@featurevisor/core": "^1.20.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,10 +18829,10 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.19.0",
+      "version": "1.20.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.17.0",
+        "@featurevisor/sdk": "^1.20.0",
         "@featurevisor/site": "^1.18.1",
         "@featurevisor/types": "^1.3.0",
         "axios": "^1.3.4",
@@ -18893,10 +18893,10 @@
     },
     "packages/react": {
       "name": "@featurevisor/react",
-      "version": "1.17.0",
+      "version": "1.20.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.17.0",
+        "@featurevisor/sdk": "^1.20.0",
         "@featurevisor/types": "^1.3.0"
       },
       "devDependencies": {
@@ -18907,7 +18907,7 @@
     },
     "packages/sdk": {
       "name": "@featurevisor/sdk",
-      "version": "1.17.0",
+      "version": "1.20.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/types": "^1.3.0",
@@ -19145,10 +19145,10 @@
     },
     "packages/vue": {
       "name": "@featurevisor/vue",
-      "version": "1.17.0",
+      "version": "1.20.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/sdk": "^1.17.0",
+        "@featurevisor/sdk": "^1.20.0",
         "@featurevisor/types": "^1.3.0",
         "vue": "^3.3.4"
       },
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 2f9d3b4d..67e2a1a1 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+
+### Features
+
+* allow evaluating in CLI with more verbosity ([#300](https://github.com/featurevisor/featurevisor/issues/300)) ([8c3a096](https://github.com/featurevisor/featurevisor/commit/8c3a0962a5950abf424695db314ee5eeb8e6ccd5))
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 5240c770..19734c1f 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.19.0",
+    "@featurevisor/core": "^1.20.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index d21b3287..761640ad 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+
+### Features
+
+* allow evaluating in CLI with more verbosity ([#300](https://github.com/featurevisor/featurevisor/issues/300)) ([8c3a096](https://github.com/featurevisor/featurevisor/commit/8c3a0962a5950abf424695db314ee5eeb8e6ccd5))
+
+
+
+
+
 # [1.19.0](https://github.com/featurevisor/featurevisor/compare/v1.18.1...v1.19.0) (2024-04-26)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index dba7d2da..b5ba6944 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,7 +44,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/sdk": "^1.17.0",
+    "@featurevisor/sdk": "^1.20.0",
     "@featurevisor/site": "^1.18.1",
     "@featurevisor/types": "^1.3.0",
     "axios": "^1.3.4",
diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
index 14e0add1..ca2b1722 100644
--- a/packages/react/CHANGELOG.md
+++ b/packages/react/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/react
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/react
diff --git a/packages/react/package.json b/packages/react/package.json
index 233a5321..671a46f2 100644
--- a/packages/react/package.json
+++ b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/react",
-  "version": "1.17.0",
+  "version": "1.20.0",
   "description": "React package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.17.0",
+    "@featurevisor/sdk": "^1.20.0",
     "@featurevisor/types": "^1.3.0"
   },
   "license": "MIT",
diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md
index 2db6cc2c..6e2c6287 100644
--- a/packages/sdk/CHANGELOG.md
+++ b/packages/sdk/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+
+### Features
+
+* allow evaluating in CLI with more verbosity ([#300](https://github.com/featurevisor/featurevisor/issues/300)) ([8c3a096](https://github.com/featurevisor/featurevisor/commit/8c3a0962a5950abf424695db314ee5eeb8e6ccd5))
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 1dd99781..c9aa3f58 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/sdk",
-  "version": "1.17.0",
+  "version": "1.20.0",
   "description": "Featurevisor SDK for Node.js and the browser",
   "main": "dist/index.js",
   "module": "lib/index.js",
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
index d76def0e..55866385 100644
--- a/packages/vue/CHANGELOG.md
+++ b/packages/vue/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
+
+**Note:** Version bump only for package @featurevisor/vue
+
+
+
+
+
 # [1.17.0](https://github.com/featurevisor/featurevisor/compare/v1.16.0...v1.17.0) (2024-04-07)
 
 **Note:** Version bump only for package @featurevisor/vue
diff --git a/packages/vue/package.json b/packages/vue/package.json
index 7dc67567..c110cbef 100644
--- a/packages/vue/package.json
+++ b/packages/vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/vue",
-  "version": "1.17.0",
+  "version": "1.20.0",
   "description": "Vue.js package for Featurevisor",
   "main": "dist/index.js",
   "module": "lib/index.js",
@@ -45,7 +45,7 @@
     "url": "https://github.com/featurevisor/featurevisor/issues"
   },
   "dependencies": {
-    "@featurevisor/sdk": "^1.17.0",
+    "@featurevisor/sdk": "^1.20.0",
     "@featurevisor/types": "^1.3.0",
     "vue": "^3.3.4"
   },

From 6ed5d0cdba99b987fea4242c54aa74202a975142 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Thu, 9 May 2024 17:49:12 +0200
Subject: [PATCH 44/48] feat: make test runner fast by default (#301)

---
 docs/testing.md                         | 10 +-------
 packages/cli/src/index.ts               |  1 -
 packages/core/src/tester/testFeature.ts | 11 +--------
 packages/core/src/tester/testProject.ts | 32 ++++++++++++-------------
 4 files changed, 17 insertions(+), 37 deletions(-)

diff --git a/docs/testing.md b/docs/testing.md
index 0d8db677..52130b80 100644
--- a/docs/testing.md
+++ b/docs/testing.md
@@ -214,15 +214,7 @@ $ npx featurevisor test --onlyFailures
 
 ### `fast`
 
-By default, Featurevisor's test runner would generate a datafile for your feature against the desired environment for each assertion.
-
-If you have a lot of tests, this can be time-consuming. You can use the `--fast` option to generate datafiles for each environment early packing all the features in the project together, and then run the assertions:
-
-```
-$ npx featurevisor test --fast
-```
-
-**Note**: This approach is memory intensive and therefore not the default behaviour yet.
+This option has been deprecated, because test runner is now fast by default.
 
 ## NPM scripts
 
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 13a78f5f..9f48652a 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -155,7 +155,6 @@ async function main() {
           assertionPattern: options.assertionPattern,
           verbose: options.verbose || false,
           showDatafile: options.showDatafile || false,
-          fast: options.fast || false,
           onlyFailures: options.onlyFailures || false,
         };
 
diff --git a/packages/core/src/tester/testFeature.ts b/packages/core/src/tester/testFeature.ts
index 8c873b23..cb4dd440 100644
--- a/packages/core/src/tester/testFeature.ts
+++ b/packages/core/src/tester/testFeature.ts
@@ -9,7 +9,6 @@ import { createInstance, MAX_BUCKETED_NUMBER } from "@featurevisor/sdk";
 
 import { Datasource } from "../datasource";
 import { ProjectConfig } from "../config";
-import { getCustomDatafile } from "../builder";
 
 import { checkIfArraysAreEqual } from "./checkIfArraysAreEqual";
 import { checkIfObjectsAreEqual } from "./checkIfObjectsAreEqual";
@@ -55,15 +54,7 @@ export async function testFeature(
         continue;
       }
 
-      const datafileContent =
-        typeof datafileContentByEnvironment[assertion.environment] !== "undefined"
-          ? datafileContentByEnvironment[assertion.environment]
-          : await getCustomDatafile({
-              featureKey: test.feature,
-              environment: assertion.environment,
-              projectConfig,
-              datasource,
-            });
+      const datafileContent = datafileContentByEnvironment[assertion.environment];
 
       if (options.showDatafile) {
         console.log("");
diff --git a/packages/core/src/tester/testProject.ts b/packages/core/src/tester/testProject.ts
index 9bafdf5b..95b735b7 100644
--- a/packages/core/src/tester/testProject.ts
+++ b/packages/core/src/tester/testProject.ts
@@ -18,7 +18,6 @@ export interface TestProjectOptions {
   verbose?: boolean;
   showDatafile?: boolean;
   onlyFailures?: boolean;
-  fast?: boolean;
 }
 
 export interface TestPatterns {
@@ -150,22 +149,21 @@ export async function testProject(
   let failedAssertionsCount = 0;
 
   const datafileContentByEnvironment: DatafileContentByEnvironment = {};
-  if (options.fast) {
-    for (const environment of projectConfig.environments) {
-      const existingState = await datasource.readState(environment);
-      const datafileContent = await buildDatafile(
-        projectConfig,
-        datasource,
-        {
-          schemaVersion: SCHEMA_VERSION,
-          revision: "include-all-features",
-          environment: environment,
-        },
-        existingState,
-      );
-
-      datafileContentByEnvironment[environment] = datafileContent;
-    }
+
+  for (const environment of projectConfig.environments) {
+    const existingState = await datasource.readState(environment);
+    const datafileContent = await buildDatafile(
+      projectConfig,
+      datasource,
+      {
+        schemaVersion: SCHEMA_VERSION,
+        revision: "include-all-features",
+        environment: environment,
+      },
+      existingState,
+    );
+
+    datafileContentByEnvironment[environment] = datafileContent;
   }
 
   for (const testFile of testFiles) {

From b12c838af9f5361f15b52bf52ef16c058e93b56c Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Thu, 9 May 2024 15:51:56 +0000
Subject: [PATCH 45/48] v1.21.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6f74408b..b9fc12a1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+
+### Features
+
+* make test runner fast by default ([#301](https://github.com/featurevisor/featurevisor/issues/301)) ([6ed5d0c](https://github.com/featurevisor/featurevisor/commit/6ed5d0cdba99b987fea4242c54aa74202a975142))
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index f976b76c..64c02885 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 0552b59c..3b07291c 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.20.0"
+    "@featurevisor/cli": "^1.21.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index f810f843..5aa85315 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index b58ff5a1..bb461c60 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.20.0"
+    "@featurevisor/cli": "^1.21.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 1a8945a1..13a1cb11 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 5902181a..96c16d98 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.20.0",
+    "@featurevisor/cli": "^1.21.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index 94dd6223..e1e4ccba 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 88fb92ef..39f1ee67 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.20.0"
+    "@featurevisor/cli": "^1.21.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index 61c22151..cf57dec9 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 563214c0..9b74859d 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.20.0"
+    "@featurevisor/cli": "^1.21.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index bd9fedd7..14d14411 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.20.0"
+  "version": "1.21.0"
 }
diff --git a/package-lock.json b/package-lock.json
index 399ea368..cf639573 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.20.0"
+        "@featurevisor/cli": "^1.21.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.20.0"
+        "@featurevisor/cli": "^1.21.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.20.0",
+        "@featurevisor/cli": "^1.21.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.20.0"
+        "@featurevisor/cli": "^1.21.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.20.0"
+        "@featurevisor/cli": "^1.21.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.20.0",
+        "@featurevisor/core": "^1.21.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.20.0",
+      "version": "1.21.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.20.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 67e2a1a1..40c1f04b 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+
+### Features
+
+* make test runner fast by default ([#301](https://github.com/featurevisor/featurevisor/issues/301)) ([6ed5d0c](https://github.com/featurevisor/featurevisor/commit/6ed5d0cdba99b987fea4242c54aa74202a975142))
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 19734c1f..c6c254af 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.20.0",
+    "@featurevisor/core": "^1.21.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 761640ad..0faa51a1 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
+
+
+### Features
+
+* make test runner fast by default ([#301](https://github.com/featurevisor/featurevisor/issues/301)) ([6ed5d0c](https://github.com/featurevisor/featurevisor/commit/6ed5d0cdba99b987fea4242c54aa74202a975142))
+
+
+
+
+
 # [1.20.0](https://github.com/featurevisor/featurevisor/compare/v1.19.0...v1.20.0) (2024-04-30)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index b5ba6944..a3d453bc 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

From 5a010e8ded7c80f7d1947c8dc32a7964422eca06 Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Mon, 13 May 2024 18:56:47 +0200
Subject: [PATCH 46/48] docs: deprecation (#302)

---
 docs/sidebarNavigation.json   |  3 +-
 docs/use-cases/deprecation.md | 80 +++++++++++++++++++++++++++++++++++
 2 files changed, 82 insertions(+), 1 deletion(-)
 create mode 100644 docs/use-cases/deprecation.md

diff --git a/docs/sidebarNavigation.json b/docs/sidebarNavigation.json
index f04165f6..cff10378 100644
--- a/docs/sidebarNavigation.json
+++ b/docs/sidebarNavigation.json
@@ -71,7 +71,8 @@
       { "title": "Establishing ownership", "href": "/docs/use-cases/establishing-ownership" },
       { "title": "Trunk-based development", "href": "/docs/use-cases/trunk-based-development" },
       { "title": "Microfrontends", "href": "/docs/use-cases/microfrontends" },
-      { "title": "Managing dependencies", "href": "/docs/use-cases/dependencies" }
+      { "title": "Managing dependencies", "href": "/docs/use-cases/dependencies" },
+      { "title": "Deprecating features", "href": "/docs/use-cases/deprecation" }
     ]
   },
   {
diff --git a/docs/use-cases/deprecation.md b/docs/use-cases/deprecation.md
new file mode 100644
index 00000000..e712d5be
--- /dev/null
+++ b/docs/use-cases/deprecation.md
@@ -0,0 +1,80 @@
+---
+title: Deprecating feature flags safely
+description: Learn how to deprecate features and experiments safely with Featurevisor
+ogImage: /img/og/docs-use-cases-deprecation.png
+---
+
+Deprecating feature flags is an essential part of feature flag lifecycle management. As our application and organization grow, some features become permanent while others may be discarded. {% .lead %}
+
+Proper management of these features and a/b test experiments prevents clutter, reduces technical debt, and maintains the efficiency and performance of our application's codebase.
+
+## What is deprecation?
+
+In software development, deprecation refers to the practice of marking certain features, functionalities, or elements in a codebase as obsolete, outdated, or no longer recommended for use.
+
+This is often done when a feature or functionality is:
+
+- replaced by a newer or more efficient version, or
+- when it's decided that the feature is no longer necessary
+
+## Deprecating feature flags
+
+Similar to any regular functionalities in software, feature flags can also be deprecated.
+
+When a feature flag is deprecated, it means that the feature flag is no longer needed and should be removed from the codebase.
+
+## Grace period
+
+When deprecating a feature flag, it's a good practice to provide a grace period for developers to remove the usage of that feature flag from the codebase.
+
+This makes sure we are not unintentionally breaking the application for users who are still using the deprecated feature.
+
+The grace period can be a few days, weeks, or months, depending on the complexity of the feature and the number of places it's used in the codebase. Ultimately it's an organization level decision.
+
+## How does it work in Featurevisor?
+
+Given Featurevisor allows us to manage both feature flags and [experiments](/docs/use-cases/experiments) as [features](/docs/features) declaratively, it makes it very convenient for us to mark some of them as [deprecated](/docs/features/#deprecating).
+
+We can do that right from the same file where we define our feature:
+
+```yml
+# features/my_feature.yml
+description: My feature description...
+tags:
+  - web
+  - ios
+  - android
+
+# we set `deprecated` to `true`
+deprecated: true
+
+# ...
+```
+
+Notice the usage of `deprecated: true` above. That's all we need to do to mark a feature as deprecated, and Featurevisor will take care of the rest.
+
+{% callout type="note" title="Deprecating attributes and segments" %}
+Unlike features, [attributes](/docs/attributes) and [segments](/docs/segments) cannot be deprecated.
+
+Featurevisor's [datafile builder](/docs/building-datafiles) is smart enough to not include attributes and segments that are not used in your desired features. That's why we don't need to worry about deprecating them, and can archive or delete them directly if needed.
+{% /callout %}
+
+## Warnings in applications
+
+When a feature is marked as deprecated, Featurevisor [SDKs](/docs/sdks/) will automatically show a warning in the applications that are evaluating the deprecated feature.
+
+This lets developers know immediately that the feature is deprecated and should be removed from the codebase.
+
+Optionally, we can take over the warning messages via the [logger API](/docs/sdks/javascript/#logging) of SDKs if we wish to customize the warning messages further or track them via our preferred logging and monitoring system.
+
+## Deleting deprecated features
+
+Once the development teams have removed the deprecated feature flags from the codebase, and no warnings are visible anywhere in the applications, we can safely [archive](/docs/features/#archiving) or delete the deprecated feature from Featurevisor.
+
+## Conclusion
+
+Creating new functionalities and having them managed via several feature flags and experiments is a common practice in modern software development. However, it's equally important to manage these features' lifecycle properly.
+
+We do not wish to find ourselves in a situation where we only keep creating new features and never take the time to clean them up. This affects both the performance and maintainability of our applications.
+
+With Featurevisor, we can embrace its highly declarative way of managing features and experiments effectively. Including deprecating them when they are no longer needed, providing a grace period for developers to remove them, and finally deleting them from the system safely.

From d94cb878f24fc4f2280c6126ab40a70aa6bebe9f Mon Sep 17 00:00:00 2001
From: Fahad Heylaal <fahad19@gmail.com>
Date: Tue, 21 May 2024 21:58:09 +0200
Subject: [PATCH 47/48] feat: show project info in CLI (#304)

---
 docs/cli.md                     |  8 ++++++
 packages/cli/src/index.ts       | 18 ++++++++++++++
 packages/core/src/index.ts      |  1 +
 packages/core/src/info/index.ts | 44 +++++++++++++++++++++++++++++++++
 4 files changed, 71 insertions(+)
 create mode 100644 packages/core/src/info/index.ts

diff --git a/docs/cli.md b/docs/cli.md
index 15f237e8..a4dec344 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -277,3 +277,11 @@ Further details about all the options:
 - `--verbose`: print the merged context for better debugging
 
 Everything is happening locally in memory without modifying any content anywhere. This command exists only to add to our confidence if questions arise about how effective traffic distribution in Featurevisor is.
+
+## Info
+
+Shows count of various entities in the project:
+
+```
+$ npx featurevisor info
+```
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 9f48652a..76823fbe 100755
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -24,6 +24,7 @@ import {
   showProjectConfig,
   evaluateFeature,
   assessDistribution,
+  showProjectInfo,
 } from "@featurevisor/core";
 
 const yargs = require("yargs"); // eslint-disable-line @typescript-eslint/no-var-requires
@@ -414,6 +415,23 @@ async function main() {
       "test traffic distribution a feature against provided context",
     )
 
+    /**
+     * Info
+     */
+    .command({
+      command: "info",
+      handler: async function (options) {
+        const deps = await getDependencies(options);
+
+        try {
+          await showProjectInfo(deps);
+        } catch (e) {
+          console.error(e.message);
+          process.exit(1);
+        }
+      },
+    })
+
     /**
      * Options
      */
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 4488427f..c7bc412c 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -13,3 +13,4 @@ export * from "./datasource";
 export * from "./benchmark";
 export * from "./evaluate";
 export * from "./assess-distribution";
+export * from "./info";
diff --git a/packages/core/src/info/index.ts b/packages/core/src/info/index.ts
new file mode 100644
index 00000000..3f9c66a2
--- /dev/null
+++ b/packages/core/src/info/index.ts
@@ -0,0 +1,44 @@
+import { Dependencies } from "../dependencies";
+import { getMatrixCombinations } from "../tester/matrix";
+
+export async function showProjectInfo(deps: Dependencies) {
+  const { datasource } = deps;
+
+  console.log("\nProject info:\n");
+
+  const revision = await datasource.readRevision();
+  console.log("  - Revision:         ", revision);
+
+  console.log("");
+
+  const attributes = await datasource.listAttributes();
+  const segments = await datasource.listSegments();
+  const features = await datasource.listFeatures();
+  const groups = await datasource.listGroups();
+
+  console.log("  - Total attributes: ", attributes.length);
+  console.log("  - Total segments:   ", segments.length);
+  console.log("  - Total features:   ", features.length);
+  console.log("  - Total groups:     ", groups.length);
+
+  console.log("");
+
+  const tests = await datasource.listTests();
+  console.log("  - Total test specs: ", tests.length);
+
+  let assertionsCount = 0;
+  for (const test of tests) {
+    const testSpec = await datasource.readTest(test);
+
+    for (const assertion of testSpec.assertions) {
+      if (assertion.matrix) {
+        const combinations = getMatrixCombinations(assertion.matrix);
+        assertionsCount += combinations.length;
+      } else {
+        assertionsCount += 1;
+      }
+    }
+  }
+
+  console.log("  - Total assertions: ", assertionsCount);
+}

From 28dfe5e2ff046e4a715877e97785d4911dd822fb Mon Sep 17 00:00:00 2001
From: fahad19 <fahad19@users.noreply.github.com>
Date: Tue, 21 May 2024 20:00:48 +0000
Subject: [PATCH 48/48] v1.22.0

---
 CHANGELOG.md                              | 11 ++++++++++
 examples/example-1/CHANGELOG.md           |  8 +++++++
 examples/example-1/package.json           |  4 ++--
 examples/example-json/CHANGELOG.md        |  8 +++++++
 examples/example-json/package.json        |  4 ++--
 examples/example-toml/CHANGELOG.md        |  8 +++++++
 examples/example-toml/package.json        |  4 ++--
 examples/example-yml-include/CHANGELOG.md |  8 +++++++
 examples/example-yml-include/package.json |  4 ++--
 examples/example-yml/CHANGELOG.md         |  8 +++++++
 examples/example-yml/package.json         |  4 ++--
 lerna.json                                |  2 +-
 package-lock.json                         | 26 +++++++++++------------
 packages/cli/CHANGELOG.md                 | 11 ++++++++++
 packages/cli/package.json                 |  4 ++--
 packages/core/CHANGELOG.md                | 11 ++++++++++
 packages/core/package.json                |  2 +-
 17 files changed, 100 insertions(+), 27 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b9fc12a1..9986aea1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+
+### Features
+
+* show project info in CLI ([#304](https://github.com/featurevisor/featurevisor/issues/304)) ([d94cb87](https://github.com/featurevisor/featurevisor/commit/d94cb878f24fc4f2280c6126ab40a70aa6bebe9f))
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 
diff --git a/examples/example-1/CHANGELOG.md b/examples/example-1/CHANGELOG.md
index 64c02885..16ede662 100644
--- a/examples/example-1/CHANGELOG.md
+++ b/examples/example-1/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+**Note:** Version bump only for package @featurevisor/example-1
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 **Note:** Version bump only for package @featurevisor/example-1
diff --git a/examples/example-1/package.json b/examples/example-1/package.json
index 3b07291c..be6046d3 100644
--- a/examples/example-1/package.json
+++ b/examples/example-1/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-1",
   "private": true,
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "For testing only",
   "scripts": {
     "lint": "featurevisor lint",
@@ -14,6 +14,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.21.0"
+    "@featurevisor/cli": "^1.22.0"
   }
 }
diff --git a/examples/example-json/CHANGELOG.md b/examples/example-json/CHANGELOG.md
index 5aa85315..2c686cba 100644
--- a/examples/example-json/CHANGELOG.md
+++ b/examples/example-json/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+**Note:** Version bump only for package @featurevisor/example-json
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 **Note:** Version bump only for package @featurevisor/example-json
diff --git a/examples/example-json/package.json b/examples/example-json/package.json
index bb461c60..3763f81a 100644
--- a/examples/example-json/package.json
+++ b/examples/example-json/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-json",
   "private": true,
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Featurevisor project with JSON definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.21.0"
+    "@featurevisor/cli": "^1.22.0"
   }
 }
diff --git a/examples/example-toml/CHANGELOG.md b/examples/example-toml/CHANGELOG.md
index 13a1cb11..1e230e47 100644
--- a/examples/example-toml/CHANGELOG.md
+++ b/examples/example-toml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+**Note:** Version bump only for package @featurevisor/example-toml
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 **Note:** Version bump only for package @featurevisor/example-toml
diff --git a/examples/example-toml/package.json b/examples/example-toml/package.json
index 96c16d98..1c755c9a 100644
--- a/examples/example-toml/package.json
+++ b/examples/example-toml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-toml",
   "private": true,
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Featurevisor project with TOML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,7 +13,7 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.21.0",
+    "@featurevisor/cli": "^1.22.0",
     "toml": "^3.0.0"
   }
 }
diff --git a/examples/example-yml-include/CHANGELOG.md b/examples/example-yml-include/CHANGELOG.md
index e1e4ccba..4e0d5515 100644
--- a/examples/example-yml-include/CHANGELOG.md
+++ b/examples/example-yml-include/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+**Note:** Version bump only for package @featurevisor/example-yml-include
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 **Note:** Version bump only for package @featurevisor/example-yml-include
diff --git a/examples/example-yml-include/package.json b/examples/example-yml-include/package.json
index 39f1ee67..a2e06fa4 100644
--- a/examples/example-yml-include/package.json
+++ b/examples/example-yml-include/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml-include",
   "private": true,
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Featurevisor project with YAML definitions and custom includes",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.21.0"
+    "@featurevisor/cli": "^1.22.0"
   }
 }
diff --git a/examples/example-yml/CHANGELOG.md b/examples/example-yml/CHANGELOG.md
index cf57dec9..41b4fcf8 100644
--- a/examples/example-yml/CHANGELOG.md
+++ b/examples/example-yml/CHANGELOG.md
@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+**Note:** Version bump only for package @featurevisor/example-yml
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 **Note:** Version bump only for package @featurevisor/example-yml
diff --git a/examples/example-yml/package.json b/examples/example-yml/package.json
index 9b74859d..dee68674 100644
--- a/examples/example-yml/package.json
+++ b/examples/example-yml/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@featurevisor/example-yml",
   "private": true,
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Featurevisor project with YAML definitions",
   "scripts": {
     "lint": "featurevisor lint",
@@ -13,6 +13,6 @@
     "find-duplicate-segments": "featurevisor find-duplicate-segments"
   },
   "dependencies": {
-    "@featurevisor/cli": "^1.21.0"
+    "@featurevisor/cli": "^1.22.0"
   }
 }
diff --git a/lerna.json b/lerna.json
index 14d14411..e939c6d7 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,5 +1,5 @@
 {
   "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "useWorkspaces": true,
-  "version": "1.21.0"
+  "version": "1.22.0"
 }
diff --git a/package-lock.json b/package-lock.json
index cf639573..414bacad 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -34,38 +34,38 @@
     },
     "examples/example-1": {
       "name": "@featurevisor/example-1",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.21.0"
+        "@featurevisor/cli": "^1.22.0"
       }
     },
     "examples/example-json": {
       "name": "@featurevisor/example-json",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.21.0"
+        "@featurevisor/cli": "^1.22.0"
       }
     },
     "examples/example-toml": {
       "name": "@featurevisor/example-toml",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.21.0",
+        "@featurevisor/cli": "^1.22.0",
         "toml": "^3.0.0"
       }
     },
     "examples/example-yml": {
       "name": "@featurevisor/example-yml",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.21.0"
+        "@featurevisor/cli": "^1.22.0"
       }
     },
     "examples/example-yml-include": {
       "name": "@featurevisor/example-yml-include",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "dependencies": {
-        "@featurevisor/cli": "^1.21.0"
+        "@featurevisor/cli": "^1.22.0"
       }
     },
     "node_modules/@aashutoshrathi/word-wrap": {
@@ -18779,10 +18779,10 @@
     },
     "packages/cli": {
       "name": "@featurevisor/cli",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "license": "MIT",
       "dependencies": {
-        "@featurevisor/core": "^1.21.0",
+        "@featurevisor/core": "^1.22.0",
         "yargs": "^17.6.2"
       },
       "bin": {
@@ -18829,7 +18829,7 @@
     },
     "packages/core": {
       "name": "@featurevisor/core",
-      "version": "1.21.0",
+      "version": "1.22.0",
       "license": "MIT",
       "dependencies": {
         "@featurevisor/sdk": "^1.20.0",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 40c1f04b..ddfea500 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+
+### Features
+
+* show project info in CLI ([#304](https://github.com/featurevisor/featurevisor/issues/304)) ([d94cb87](https://github.com/featurevisor/featurevisor/commit/d94cb878f24fc4f2280c6126ab40a70aa6bebe9f))
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index c6c254af..e15de184 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/cli",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "CLI package of Featurevisor",
   "main": "bin.js",
   "types": "lib/index.d.ts",
@@ -47,7 +47,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/core": "^1.21.0",
+    "@featurevisor/core": "^1.22.0",
     "yargs": "^17.6.2"
   },
   "devDependencies": {
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 0faa51a1..4eee49ac 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/featurevisor/featurevisor/compare/v1.21.0...v1.22.0) (2024-05-21)
+
+
+### Features
+
+* show project info in CLI ([#304](https://github.com/featurevisor/featurevisor/issues/304)) ([d94cb87](https://github.com/featurevisor/featurevisor/commit/d94cb878f24fc4f2280c6126ab40a70aa6bebe9f))
+
+
+
+
+
 # [1.21.0](https://github.com/featurevisor/featurevisor/compare/v1.20.0...v1.21.0) (2024-05-09)
 
 
diff --git a/packages/core/package.json b/packages/core/package.json
index a3d453bc..45fa6e35 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",