pub(super) const REPORTS_HELP: &str = r#"Write reviewer-first report projections from explicit artifacts.
Usage:
ripr reports index [--root PATH] [--reports-dir PATH] [--review-dir PATH] [--receipts-dir PATH] [--workflow-dir PATH] [--agent-dir PATH] [--pilot-dir PATH] [--ci-dir PATH] [--out PATH] [--out-md PATH]
ripr reports gap-ledger --records PATH [--root PATH] [--out PATH] [--out-md PATH]
ripr reports gap-ledger --check-output PATH [--root PATH] [--out PATH] [--out-md PATH]
Index options:
--root PATH Workspace root label. Defaults to current directory.
--reports-dir PATH Directory containing report artifacts. Defaults to target/ripr/reports.
--review-dir PATH Directory containing PR guidance artifacts. Defaults to target/ripr/review.
--receipts-dir PATH Directory containing receipt artifacts. Defaults to target/ripr/receipts.
--workflow-dir PATH Directory containing workflow repair artifacts. Defaults to target/ripr/workflow.
--agent-dir PATH Directory containing agent handoff artifacts. Defaults to target/ripr/agent.
--pilot-dir PATH Directory containing pilot artifacts. Defaults to target/ripr/pilot.
--ci-dir PATH Directory containing CI context artifacts. Defaults to target/ci.
--out PATH JSON output path. Defaults to target/ripr/reports/index.json.
--out-md PATH Markdown output path. Defaults to target/ripr/reports/index.md.
Gap ledger options:
--records PATH Explicit GapRecord JSON, gap_records JSON, or fixture corpus JSON.
--repo-exposure PATH Derive repo-scoped Rust GapRecords from seams[].evidence_record.
--check-output PATH Derive PR-local presentation/output contract gaps from finding_alignment.items.
--root PATH Workspace root label. Defaults to current directory.
--out PATH JSON output path. Defaults to target/ripr/reports/gap-decision-ledger.json.
--out-md PATH Markdown output path. Defaults to target/ripr/reports/gap-decision-ledger.md.
The report-packet index is a read-only advisory map over explicit existing
RIPR artifacts. It groups reports by reviewer use, names the start-here
artifact, preserves gate-decision as the configured pass/fail authority,
lists missing expected surfaces with regeneration commands when known, and
does not rerun analysis, edit source, generate tests, call providers, run
mutation testing, publish inline comments, or make CI blocking by default.
The gap decision ledger command is a read-only advisory renderer for explicit
GapRecord input or existing repo-exposure evidence records. It normalizes
supplied or derived gap records into JSON and Markdown,
summarizes projection eligibility, preserves gate-decision as the configured
pass/fail authority, and does not rerun hidden analysis, publish comments,
edit source, generate tests, call providers, run mutation testing, or change
default CI blocking.
"#;
pub(super) const COVERAGE_GRIP_HELP: &str = r#"Report whether line coverage and behavior evidence moved together.
Usage: ripr coverage-grip frontier (--ledger PATH|--baseline-delta PATH|--zero-status PATH) [--coverage PATH] [--out PATH] [--out-md PATH]
Frontier options:
--coverage PATH Optional coverage summary JSON.
--ledger PATH Optional PR evidence ledger JSON from `ripr pr-ledger record`.
--baseline-delta PATH Optional baseline-debt-delta JSON from `ripr baseline diff`.
--zero-status PATH Optional RIPR Zero status JSON from `ripr zero status`.
--out PATH JSON output path. Defaults to target/ripr/reports/coverage-grip-frontier.json.
--out-md PATH Markdown output path. Defaults to target/ripr/reports/coverage-grip-frontier.md.
The coverage/grip frontier report is read-only advisory evidence. It keeps
line execution coverage and RIPR behavioral grip movement as separate axes. It
does not treat coverage as adequacy, run mutation testing, change gate policy,
or make CI blocking by default.
"#;
pub(super) const ASSISTANT_LOOP_HELP: &str = r#"Produce or summarize advisory agent proof and proof-loop health.
Usage:
ripr assistant-loop proof [--pr-guidance PATH] [--agent-packet PATH] [--before PATH] [--after PATH] [--receipt PATH] [--ledger PATH] [--coverage-frontier PATH] [--gate-decision PATH] [--out PATH] [--out-md PATH]
ripr assistant-loop health --proof PATH [--proof PATH ...] [--out PATH] [--out-md PATH]
Proof options:
--root PATH Workspace root label. Defaults to current directory.
--pr-guidance PATH Optional PR guidance JSON from `ripr review-comments`.
--agent-packet PATH Optional editor/agent handoff JSON from `ripr agent brief`.
--before PATH Optional before repo-exposure JSON snapshot.
--after PATH Optional after repo-exposure JSON snapshot.
--receipt PATH Optional agent receipt JSON from `ripr agent receipt`.
--ledger PATH Optional PR evidence ledger JSON from `ripr pr-ledger record`.
--coverage-frontier PATH Optional coverage/grip frontier JSON.
--gate-decision PATH Optional gate-decision JSON from `ripr gate evaluate`.
--out PATH JSON output path. Defaults to target/ripr/reports/test-oracle-assistant-proof.json.
--out-md PATH Markdown output path. Defaults to target/ripr/reports/test-oracle-assistant-proof.md.
The assistant-loop proof report is read-only advisory evidence over explicit
Campaign 20 artifacts. It requires at least one supplied artifact input, joins
PR guidance, agent handoff packets, before and after static evidence, receipts,
and optional CI projection artifacts, and marks missing proof pieces as
incomplete or unknown. It does not rerun analysis, post comments, edit source,
generate tests, call a provider, run mutation testing, change gate policy, or
make CI blocking by default.
Health options:
--root PATH Workspace root label. Defaults to current directory.
--proof PATH Explicit test-oracle assistant proof JSON. Repeatable.
--out PATH JSON output path. Defaults to target/ripr/reports/assistant-loop-health.json.
--out-md PATH Markdown output path. Defaults to target/ripr/reports/assistant-loop-health.md.
The assistant-loop health report is read-only advisory evidence over explicit
test-oracle assistant proof JSON artifacts. It summarizes proof completeness,
missing inputs, static movement, recurring warnings, and bounded repair queues.
It does not rerun analysis, inspect source to infer missing data, edit source,
generate tests, call a provider, run mutation testing, change gate policy, or
make CI blocking by default.
"#;
pub(super) const FIRST_ACTION_HELP: &str = r#"Recommend the next focused test to add from existing review artifacts.
Usage: ripr first-action [--root PATH] [--pr-guidance PATH] [--assistant-proof PATH] [--gap-ledger PATH] [--ledger PATH] [--baseline-delta PATH] [--receipt PATH] [--gate-decision PATH] [--coverage-frontier PATH] [--editor-context PATH] [--out PATH] [--out-md PATH]
Options:
--root PATH Workspace root label. Defaults to current directory.
--pr-guidance PATH Optional PR guidance JSON from `ripr review-comments`.
--assistant-proof PATH Optional proof JSON from `ripr assistant-loop proof`.
--gap-ledger PATH Optional gap decision ledger JSON from `ripr reports gap-ledger`.
--ledger PATH Optional PR evidence ledger JSON from `ripr pr-ledger record`.
--baseline-delta PATH Optional baseline-debt-delta JSON from `ripr baseline diff`.
--receipt PATH Optional agent receipt JSON from `ripr agent receipt`.
--gate-decision PATH Optional gate-decision JSON from `ripr gate evaluate`.
--coverage-frontier PATH Optional coverage/grip frontier JSON.
--editor-context PATH Optional editor evidence context packet JSON.
--out PATH JSON output path. Defaults to target/ripr/reports/first-useful-action.json.
--out-md PATH Markdown output path. Defaults to target/ripr/reports/first-useful-action.md.
The first-action report is a read-only advisory router over explicit existing
RIPR artifacts. It writes one next useful test action or one fallback reason
for developers, reviewers, or coding agents. It does not rerun analysis, post
comments, edit source, generate tests, call a provider, run mutation testing,
invent policy, or make CI blocking by default.
"#;
pub(super) const CALIBRATE_HELP: &str = r#"Import cargo-mutants outcomes as advisory calibration over static evidence.
Usage: ripr calibrate cargo-mutants --mutants-json PATH --repo-exposure-json PATH [--format md|json] [--out PATH]
Options:
--mutants-json PATH cargo-mutants JSON file, or directory containing outcomes.json and/or mutants.json.
--repo-exposure-json PATH RIPR repo-exposure-json snapshot to join against.
--format FORMAT md, markdown, text, or json. Defaults to md.
--out PATH Write the rendered calibration report to a file instead of stdout.
The calibration report is advisory. It imports already-produced runtime
mutation data and joins it to static seam evidence by seam_id first, then by
unambiguous file/line. It does not run mutation testing, alter static
classifications, or configure CI policy.
"#;