RevAIse Integration

prismAId can optionally document review workflows using RevAIse data objects. RevAIse support is disabled by default. When enabled, prismAId reads a user-provided RevAIse review record, merges the current stage output into it, and saves the updated record.

Normal prismAId outputs are unchanged. Screening results, extraction tables, downloaded files, and logs are still written as usual.

Shared Record Workflow

Use the same record_file path across stages to build one cumulative RevAIse review record:

Zotero download adds a full-text artifact reference.
A pilot screening run adds one screening round.
A full screening run adds another screening round.
A pilot extraction run adds one data extraction stage.
A full extraction run adds another extraction stage or updates the configured extraction run.

If the RevAIse file already exists, prismAId updates it instead of overwriting it from scratch.

Backups

When RevAIse updates are enabled, backups are enabled by default. Before prismAId modifies an existing record, it writes a timestamped snapshot to .revaise-backups next to the record file.

Example:

review.revaise.json
.revaise-backups/review.revaise.20260603T143012.123456789Z.bak.json

To disable backups explicitly:

[revaise]
enabled = true
record_file = "review.revaise.json"
backup = false

If backup is omitted, backups remain enabled.

Common Configuration

Add this block to any supported stage configuration:

[revaise]
enabled = true
record_file = "review.revaise.json"
format = "json"
schema_version = "0.5.0"

format may be json or yaml. If omitted, prismAId detects the format from record_file; JSON is the default.

Screening Rounds

Each screening run needs an explicit round identity. Reusing the same round_id updates the existing round. Using a new round_id appends a new round.

Pilot screening:

[revaise]
enabled = true
record_file = "review.revaise.json"

[revaise.stage]
stage_type = "screening_title_abstract"
stage_label = "Title and abstract screening"

[revaise.screening_round]
round_id = "ta_pilot_001"
round_type = "TITLE_ABSTRACT"
round_number = 1
round_label = "Pilot title and abstract screening"
reviewer_id = "prismaid"

Full screening on already screened records:

[revaise]
enabled = true
record_file = "review.revaise.json"

[revaise.stage]
stage_type = "screening_title_abstract"
stage_label = "Title and abstract screening"

[revaise.screening_round]
round_id = "ta_full_001"
round_type = "TITLE_ABSTRACT"
round_number = 2
round_label = "Full title and abstract screening"
reviewer_id = "prismaid"

Review and Extraction Runs

The review tool maps prismAId structured extraction results to a RevAIse data_extraction stage. Each run needs an explicit run_id.

Pilot extraction:

[revaise]
enabled = true
record_file = "review.revaise.json"

[revaise.stage]
stage_type = "data_extraction"
stage_label = "Pilot AI-assisted extraction"

[revaise.extraction_run]
run_id = "pilot_extraction_001"
label = "Pilot extraction on calibration papers"
form_id = "slca_extraction_form_v1"
form_name = "SLCA extraction form"
form_version = "1"
extractor_id = "prismaid"

Full extraction:

[revaise]
enabled = true
record_file = "review.revaise.json"

[revaise.stage]
stage_type = "data_extraction"
stage_label = "Full AI-assisted extraction"

[revaise.extraction_run]
run_id = "full_extraction_001"
label = "Full extraction on included studies"
form_id = "slca_extraction_form_v1"
form_name = "SLCA extraction form"
form_version = "1"
extractor_id = "prismaid"

Zotero Download

Zotero download configuration can also update the shared RevAIse record. The current integration records output_dir as a full-text artifact. It does not yet fetch full parent-item Zotero bibliographic metadata.

[zotero]
user = "your_zotero_user_id"
api_key = "your_api_key"
group = "Your Group/Collection"
output_dir = "papers/zotero"

[revaise]
enabled = true
record_file = "review.revaise.json"

[revaise.stage]
stage_type = "search"
stage_label = "Zotero full-text download"

Supported Updates

Current RevAIse hooks:

Screening TOML: ScreeningStage, ScreeningRound, screening decisions, inclusion and exclusion lists, screening statistics, literature records.
Review TOML: ExtractionStage, extraction form, extracted studies, extracted data points, AI assistance metadata, extraction output artifact.
Zotero download TOML: full-text output artifact for zotero.output_dir.

Unsupported hooks are ignored unless implemented in a future release.