@mellens/rave
v2026.04.02.1
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
Labels
ravereliabilityconfidenceclaimsevidencefalsificationreadiness
Contents
Quality score
How well-documented and verifiable this extension is.
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
Install
$ swamp extension pull @mellens/rave@mellens/rave/ci-evidencev2026.03.21.1rave_ci_evidence.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| evidenceId | string | |
| repo | string | |
| workflowName | string | |
| branch | string |
gatherFetch the latest GitHub Actions workflow run and record the outcome
| Argument | Type | Description |
|---|---|---|
| githubToken | string |
Resources
result(30d)— Latest CI run result for this evidence entity
@mellens/rave/claimv2026.03.22.1rave_claim.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| claimId | string |
createWrite a new claim YAML to rave/claims/ and record its initial state
| Argument | Type | Description |
|---|---|---|
| statement | string | |
| owner | string | |
| team? | string | |
| contact? | string | |
| category | string | |
| scopeType | string | |
| scopeTarget | string | |
| assumptions | array | |
| falsificationSignals | array |
getRead the current claim YAML and record a state snapshot
activateSet claim status to 'active' — use once evidence is wired up
retireSet claim status to 'retired' — freezes the confidence score
| Argument | Type | Description |
|---|---|---|
| reason? | string |
contradictSet claim status to 'contradicted' — collapses confidence to 0
| Argument | Type | Description |
|---|---|---|
| reason | string |
annotateAdd a free-text annotation to the claim YAML
| Argument | Type | Description |
|---|---|---|
| text | string | |
| author | string |
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 | Description |
|---|---|---|
| claimId | string |
computeApply the RAVE decay formula to produce an updated confidence score for this claim
| Argument | Type | Description |
|---|---|---|
| currentScore | number | |
| lastValidated | string | |
| currentStatus | string | |
| evidence | array |
revalidateReset the confidence anchor when a claim owner formally re-attests
| Argument | Type | Description |
|---|---|---|
| newScore | number | |
| revalidatedBy | string |
Resources
confidence(infinite)— Computed confidence state for this claim
@mellens/rave/falsifier-enginev2026.03.21.1rave_falsifier_engine.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| falsifierId | string | |
| conditionType | enum | |
| condition | string |
evaluateEvaluate falsifier conditions against evidence snapshots and record triggered/not-triggered
| Argument | Type | Description |
|---|---|---|
| evidence | array |
Resources
evaluation(30d)— Latest falsifier evaluation result
@mellens/rave/github-api-evidencev2026.03.22.1rave_github_api_evidence.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| evidenceId | string | |
| repo | string | |
| endpoint | string | |
| successField? | string |
gatherCall a GitHub REST API endpoint and record the outcome
| Argument | Type | Description |
|---|---|---|
| githubToken | string |
Resources
result(1d)— Latest GitHub REST API evidence result
@mellens/rave/prometheus-evidencev2026.03.21.1rave_prometheus_evidence.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| evidenceId | string | |
| baseUrl | string | |
| query | string | |
| threshold? | number | |
| operator? | enum | |
| unit? | string |
gatherExecute a PromQL instant query and record the outcome against an optional threshold
| Argument | Type | Description |
|---|---|---|
| prometheusToken | string |
Resources
result(7d)— Latest Prometheus query result
@mellens/rave/readiness-reporterv2026.03.23.1rave_readiness_reporter.ts
evaluateEvaluate readiness across all active claims by comparing confidence scores to threshold. Draft and retired claims are excluded; contradicted claims always fail.
| Argument | Type | Description |
|---|---|---|
| branchProtectionId | string | |
| branchProtectionStatus | string | |
| ciGreenId | string | |
| ciGreenStatus | string | |
| swampModelsId | string | |
| swampModelsStatus | string | |
| swampWorkflowsId | string | |
| swampWorkflowsStatus | string | |
| extensionsCompileId | string | |
| extensionsCompileStatus | string |
Resources
report(7d)— Latest readiness evaluation report