oy-cli 0.13.3

Autonomous OpenCode agent and deterministic repository audit and review workflows
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! `oy review` workflow and file-backed artifact arguments.

use clap::{Args, Subcommand};
use std::path::PathBuf;

#[derive(Debug, Args, Clone)]
pub(super) struct ReviewArgs {
    #[command(subcommand)]
    pub(super) action: Option<ReviewAction>,
    #[arg(
        long,
        value_name = "PATH",
        help = "Write review findings to a workspace file (default: REVIEW.md)"
    )]
    pub(super) out: Option<PathBuf>,
    #[arg(long, value_name = "N", default_value_t = crate::review::DEFAULT_MAX_REVIEW_CHUNKS, help = "Maximum review chunks before failing closed")]
    pub(super) max_chunks: usize,
    #[arg(
        long,
        value_name = "TEXT",
        help = "Optional review focus text; can be repeated"
    )]
    pub(super) focus: Vec<String>,
    #[arg(
        value_name = "TARGET",
        help = "Optional branch/commit/ref to diff current workspace against; omitted reviews the whole workspace"
    )]
    pub(super) target: Option<String>,
}

#[derive(Debug, Clone, Subcommand)]
pub(super) enum ReviewAction {
    /// Prepare immutable review evidence under .oy/runs.
    Prepare(ReviewPrepareArgs),
    /// Validate prepared evidence and write its bound report.
    Finalize(super::audit_cmd::FinalizeArgs),
}

#[derive(Debug, Args, Clone)]
pub(super) struct ReviewPrepareArgs {
    #[arg(
        value_name = "TARGET",
        help = "Optional branch, commit, or ref; omitted reviews the workspace"
    )]
    pub(super) target: Option<String>,
    #[arg(
        long,
        value_name = "PATH",
        default_value = ".",
        help = "Workspace-relative scope when TARGET is omitted"
    )]
    pub(super) path: String,
    #[arg(
        long,
        value_name = "PATH",
        help = "Final report path (default: REVIEW.md)"
    )]
    pub(super) out: Option<PathBuf>,
    #[arg(long, value_name = "TEXT", help = "Review focus text; repeatable")]
    pub(super) focus: Vec<String>,
    #[arg(long, value_name = "N", default_value_t = crate::review::DEFAULT_MAX_REVIEW_CHUNKS, help = "Maximum evidence chunks before failing closed")]
    pub(super) max_chunks: usize,
}

pub(super) fn default_output_path() -> PathBuf {
    crate::review::default_output_path()
}