Rave

@mellens/ravev2026.05.01.1· 1mo agoMODELS

01README

RAVE (Reliability & Validation Engineering) — confidence scoring with exponential decay, claim lifecycle management, evidence gathering from GitHub and Prometheus, falsification detection, and readiness gating for software reliability claims

02Models8

@mellens/rave/claimv2026.03.22.1rave_claim.ts

Global Arguments

Argument	Type	Required	Description
claimId	string	yes

fn create(statement: string, owner: string, team?: string, contact?: string, category: string, scopeType: string, scopeTarget: string, assumptions: array, falsificationSignals: array)

Write a new claim YAML to rave/claims/ and record its initial state

Argument	Type	Required
statement	string	yes
owner	string	yes
team?	string	no
contact?	string	no
category	string	yes
scopeType	string	yes
scopeTarget	string	yes
assumptions	array	yes
falsificationSignals	array	yes

fn get()

Read the current claim YAML and record a state snapshot

fn activate()

Set claim status to 'active' — use once evidence is wired up

fn retire(reason?: string)

Set claim status to 'retired' — freezes the confidence score

Argument	Type	Required	Description
reason?	string	no

fn contradict(reason: string)

Set claim status to 'contradicted' — collapses confidence to 0

Argument	Type	Required	Description
reason	string	yes

fn annotate(text: string, author: string)

Add a free-text annotation to the claim YAML

Argument	Type	Required	Description
text	string	yes
author	string	yes

Resources

state(infinite)— Current claim state snapshot (mirrors key fields from the YAML)

@mellens/rave/confidence-enginev2026.03.21.1rave_confidence_engine.ts

Global Arguments

Argument	Type	Required	Description
claimId	string	yes

fn compute(currentScore?: number, lastValidated?: string, currentStatus: string, evidence: array)

Apply the RAVE decay formula to produce an updated confidence score for this claim

Argument	Type	Required
currentScore?	number	no
lastValidated?	string	no
currentStatus	string	yes
evidence	array	yes

fn revalidate(newScore: number, revalidatedBy: string)

Reset the confidence anchor when a claim owner formally re-attests

Argument	Type	Required	Description
newScore	number	yes
revalidatedBy	string	yes

Resources

confidence(infinite)— Computed confidence state for this claim

@mellens/rave/ci-evidencev2026.05.01.1rave_ci_evidence.ts

Global Arguments

Argument	Type	Required
evidenceId	string	yes
repo	string	yes
workflowName	string	yes
branch	string	yes
jobName?	string	no

fn gather(githubToken: string)

Fetch the latest GitHub Actions workflow run (or specific job) and record the outcome

Argument	Type	Required	Description
githubToken	string	yes

Resources

result(30d)— Latest CI run result for this evidence entity

@mellens/rave/github-api-evidencev2026.03.22.1rave_github_api_evidence.ts

Global Arguments

Argument	Type	Required
evidenceId	string	yes
repo	string	yes
endpoint	string	yes
successField?	string	no

fn gather(githubToken: string)

Call a GitHub REST API endpoint and record the outcome

Argument	Type	Required	Description
githubToken	string	yes

Resources

result(1d)— Latest GitHub REST API evidence result

@mellens/rave/prometheus-evidencev2026.03.21.1rave_prometheus_evidence.ts

Global Arguments

Argument	Type	Required
evidenceId	string	yes
baseUrl	string	yes
query	string	yes
threshold?	number	no
operator?	enum	no
unit?	string	no

fn gather(prometheusToken: string)

Execute a PromQL instant query and record the outcome against an optional threshold

Argument	Type	Required	Description
prometheusToken	string	yes

Resources

result(7d)— Latest Prometheus query result

@mellens/rave/falsifier-enginev2026.03.21.1rave_falsifier_engine.ts

Global Arguments

Argument	Type	Required
falsifierId	string	yes
conditionType	enum	yes
condition	string	yes

fn evaluate(evidence: array)

Evaluate falsifier conditions against evidence snapshots and record triggered/not-triggered

Argument	Type	Required	Description
evidence	array	yes

Resources

evaluation(30d)— Latest falsifier evaluation result

@mellens/rave/readiness-reporterv2026.03.23.1rave_readiness_reporter.ts

fn evaluate(branchProtectionId: string, branchProtectionStatus: string, ciGreenId: string, ciGreenStatus: string, swampModelsId: string, swampModelsStatus: string, swampWorkflowsId: string, swampWorkflowsStatus: string, extensionsCompileId: string, extensionsCompileStatus: string)

Evaluate readiness across all active claims by comparing confidence scores to threshold. Draft and retired claims are excluded; contradicted claims always fail.

Argument	Type	Required
branchProtectionId	string	yes
branchProtectionStatus	string	yes
ciGreenId	string	yes
ciGreenStatus	string	yes
swampModelsId	string	yes
swampModelsStatus	string	yes
swampWorkflowsId	string	yes
swampWorkflowsStatus	string	yes
extensionsCompileId	string	yes
extensionsCompileStatus	string	yes

Resources

report(7d)— Latest readiness evaluation report

@mellens/rave/diff-evidencev2026.04.29.1rave_diff_evidence.ts

Global Arguments

Argument	Type	Required	Description
evidenceId	string	yes
guardedGlobs	string	yes

fn gather()

Run git diff to detect mixed spec+application PRs

Resources

result(1d)— Latest diff-based tamper evidence result

03Previous Versions7

2026.04.30.1Apr 30, 2026

2026.04.29.5Apr 29, 2026

2026.04.29.4Apr 29, 2026

Added 1 models

2026.04.29.3Apr 29, 2026

2026.04.29.2Apr 29, 2026

2026.04.29.1Apr 29, 2026

2026.04.02.1Apr 2, 2026

04Stats

41 / 100

Downloads

104

Archive size

73.9 KB

Has README or module doc0/2missing
README has a code example0/1missing
README is substantive0/1pending
Most symbols documented1/1earned
No slow types1/1earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared0/1missing
Verified public repository0/2missing

05Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

06Labels

#rave #reliability #confidence #claims #evidence #falsification #readiness