Download Operational Truth™ - Quality Assurance Module
Quality Assurance Module - powered by Qualityfolio
Operational Truth™ is a downloadable software platform for continuous compliance. The Quality Assurance module (powered by Qualityfolio) must be installed on a local workstation or server environment. The software is not web-based and requires local installation to operate. To install Qualityfolio, users must first set up the required software dependencies and then download and install the primary Qualityfolio application package by following the provided installation instructions.
Overview
This guide outlines the step-by-step setup of Qualityfolio, which delivers Operational Truth through Test-Management-as-Code (TMaC) system powered by Spry’s Axiom-based execution pattern and Surveilr’s ingestion, transformation, and ETL pipeline.
Welcome to Qualityfolio - a Markdown-native Test Management system backed by Spry’s ontology engine and Surveilr’s data ingestion pipeline. Qualityfolio follows a Test Management as Code (TMaC) approach, where test artifacts, execution evidence, and dashboards are all derived from structured files under version control.
System Requirements
- Runtime: Deno 2.x or later (required)
- Package Manager: Homebrew (required)
- Tools: Spry, Surveilr (required)
Dependencies
Ensure the following tools and files are available on your system before proceeding:
- Deno – runtime required by Spry
- Homebrew (brew) – package manager for installing dependencies
- Spry – runbook and SQLPage orchestration engine
- Surveilr – ingestion and transformation engine
- Qualityfolio Extension – Visual Studio Code Extension/ Cursor IDE Extension which simplifies editing Evidence Block values
Installation Commands
To work with Spry and the Surveilr-based Qualityfolio framework, you need to download and install Deno, Homebrew, Spry, and Surveilr, and ensure the required Qualityfolio files are available in your workspace.
Download and Install Steps on Linux
Open your terminal and switch to your working directory:
1. Install Deno
Install Deno using the following command:
curl -fsSL https://deno.com/install.sh | shVerify your Deno installation:
deno --versionUpgrade Deno to the latest version:
deno upgrade2. Install Homebrew (if not already installed)
Homebrew is required to install Spry.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Verify Homebrew installation:
brew --version3. Install Spry
If you are a first-time Spry user:
brew install programmablemd/packages/spryUpgrade Spry, if Spry is already installed:
brew uninstall spry
brew untap programmablemd/packages
brew install programmablemd/packages/spryVerify your Spry installation:
spry --versionFor more details on Spry installation and usage, refer to the official Spry documentation.
4. Install Surveilr
If you are a first-time Surveilr user, download Surveilr version 3.10.0 or higher (the following example uses version 3.23.0):
wget https://github.com/surveilr/packages/releases/download/3.23.0/surveilr_3.23.0_x86_64-unknown-linux-gnu.tar.gzExtract the archive:
tar -xzf surveilr_3.23.0_x86_64-unknown-linux-gnu.tar.gzMove Surveilr to /usr/local/bin/:
sudo mv surveilr /usr/local/bin/Upgrade Surveilr, if Surveilr is already installed:
sudo surveilr upgradeVerify Surveilr installation and ensure the version is v3.10.0 or above:
surveilr --versionFor more details on Surveilr installation and usage, refer to the official Surveilr documentation.
Download and Install Steps on macOS
Open your terminal and switch to your working directory:
1. Install Deno
Install Deno using the following command:
curl -fsSL https://deno.com/install.sh | shVerify your Deno installation:
deno --versionUpgrade Deno to the latest version:
deno upgrade2. Install Homebrew (if not already installed)
Homebrew is required to install Spry.
curl -fsSL -o install.sh https://raw.githubusercontent.com/Homebrew/install/HEAD/install.shVerify Homebrew installation:
brew --version3. Install Spry
If you are a first-time Spry user:
brew install programmablemd/packages/spryUpgrade Spry, if Spry is already installed:
brew uninstall spry
brew untap programmablemd/packages
brew install programmablemd/packages/spryVerify your Spry installation:
spry --versionFor more details on Spry installation and usage, refer to the official Spry documentation.
4. Install Surveilr
If you are a first-time Surveilr user:
brew tap surveilr/tap && brew install surveilrUpgrade Surveilr, if Surveilr is already installed:
sudo surveilr upgradeVerify Surveilr installation and ensure the version is v3.10.0 or higher:
surveilr --versionFor more details on Surveilr installation and usage, refer to the official Surveilr documentation.
Objectives
Qualityfolio is designed to:
- Generate an SQLite database from test artifacts and execution evidence files.
- Test Artifacts Preview with real-time ontology parsing, live reload, and structural validation.
- Generate a Test Management Dashboard for test metrics, traceability, and execution insights.
Install Qualityfolio Extension (for Visual Studio Code/ Cursor IDE)
To install Qualityfolio extension, download and install the pre-packaged extension for Visual Studio Code or Cursor IDE from the links below:
For Visual Studio Code:
1. Download the Qualityfolio extension package:
wget https://raw.githubusercontent.com/programmablemd/assurance-prime/main/extension/run-spry-markdown-0.0.1.vsix2. Install the extension package:
code --install-extension ./run-spry-markdown-0.0.1.vsixFor Cursor IDE:
1. Download the Qualityfolio extension package:
wget https://raw.githubusercontent.com/programmablemd/assurance-prime/main/extension/run-spry-markdown-0.0.1.vsix2. Install the extension:
cursor --install-extension run-spry-markdown-0.0.1.vsixFor Visual Studio Code:
1. Download the Qualityfolio extension package:
curl -L -o run-spry-markdown-0.0.1.vsix \
https://raw.githubusercontent.com/programmablemd/assurance-prime/main/extension/run-spry-markdown-0.0.1.vsix2. Install the extension package:
code --install-extension ./run-spry-markdown-0.0.1.vsixFor Cursor IDE:
1. Download the Qualityfolio extension package:
curl -L -o run-spry-markdown-0.0.1.vsix \
https://raw.githubusercontent.com/programmablemd/assurance-prime/main/extension/run-spry-markdown-0.0.1.vsix2. Install the extension:
cursor --install-extension ./run-spry-markdown-0.0.1.vsixFor more details on Qualityfolio extension usage and updates, refer the documentation.
How is this guide?
Last updated on
Introduction
Evidence-driven assurance framework delivering Operational Truth™ through Test-Management-as-Code (TMaC) for quality, security, reliability, and compliance.
Quick Start Guide
Step-by-step quick start guide to setting up Qualityfolio, authoring Markdown-based test artifacts, generating evidence-backed SQLite databases, and launching test management dashboards.