package main import ( "flag" "fmt" "time" ) // --- custom flag set that supports short flags (-c, -f etc.) --- type ocrFlagSet struct { fs *flag.FlagSet shortMap map[string]string // maps short key "c" -> full name "commit" showHelp bool } func newOcrFlagSet(name string) *ocrFlagSet { return &ocrFlagSet{ fs: flag.NewFlagSet(name, flag.ContinueOnError), shortMap: make(map[string]string), } } // StringVarP registers --name with optional short form -s. func (a *ocrFlagSet) StringVarP(p *string, name, shorthand string, value, usage string) { suffix := "" if shorthand != "" { a.shortMap[shorthand] = name suffix = fmt.Sprintf(" (shorthand: -%s)", shorthand) } a.fs.StringVar(p, name, value, usage+suffix) } // BoolVarP registers --name with optional short form -s. func (a *ocrFlagSet) BoolVarP(p *bool, name, shorthand string, value bool, usage string) { suffix := "" if shorthand != "" { a.shortMap[shorthand] = name suffix = fmt.Sprintf(" (shorthand: -%s)", shorthand) } a.fs.BoolVar(p, name, value, usage+suffix) } func (a *ocrFlagSet) StringVar(p *string, name string, value string, usage string) { a.fs.StringVar(p, name, value, usage) } func (a *ocrFlagSet) BoolVar(p *bool, name string, value bool, usage string) { a.fs.BoolVar(p, name, value, usage) } func (a *ocrFlagSet) IntVar(p *int, name string, value int, usage string) { a.fs.IntVar(p, name, value, usage) } func (a *ocrFlagSet) DurationVar(p *time.Duration, name string, value time.Duration, usage string) { a.fs.DurationVar(p, name, value, usage) } func (a *ocrFlagSet) PrintDefaults() { a.fs.PrintDefaults() } func (a *ocrFlagSet) Parse(arguments []string) error { expanded := expandShortFlags(arguments, a.shortMap) for _, arg := range expanded { if arg == "-h" || arg == "--help" { a.showHelp = true return nil } } return a.fs.Parse(expanded) } // expandShortFlags replaces standalone -X args with their long equivalents. // Only triggers when the arg is exactly -N (single char after dash). func expandShortFlags(args []string, shortMap map[string]string) []string { out := make([]string, 0, len(args)) for _, arg := range args { if len(arg) == 2 && arg[0] == '-' && arg[1] != '-' { key := string(arg[1]) if full, ok := shortMap[key]; ok { out = append(out, "--"+full) continue } } out = append(out, arg) } return out } // --- review subcommand options --- type reviewOptions struct { toolConfigPath string rulePath string repoDir string from string to string commit string outputFormat string audience string // --audience: "human" (default) or "agent" background string // --background: optional requirement context concurrency int perFileTimeout int showHelp bool } func parseReviewFlags(args []string) (reviewOptions, error) { a := newOcrFlagSet("ocr review") opts := reviewOptions{} a.StringVar(&opts.toolConfigPath, "tools", "", "path to JSON tools config file (default: embedded)") a.StringVar(&opts.rulePath, "rule", "", "path to JSON file with system review rules") a.StringVar(&opts.repoDir, "repo", "", "root directory of the git repository (default: current dir)") a.StringVar(&opts.from, "from", "", "source ref to start diff from (e.g., 'main')") a.StringVar(&opts.to, "to", "", "target ref to end diff at (e.g., 'feature-branch')") a.StringVarP(&opts.commit, "commit", "c", "", "single commit hash or tag to review (vs its parent)") a.StringVarP(&opts.outputFormat, "format", "f", "text", "output format: text or json") a.IntVar(&opts.concurrency, "concurrency", 8, "max concurrent file reviews") a.IntVar(&opts.perFileTimeout, "timeout", 10, "concurrent task timeout in minutes") a.StringVar(&opts.audience, "audience", "human", "output audience: human (show progress) or agent (summary only)") a.StringVarP(&opts.background, "background", "b", "", "optional requirement/business context for the review") if err := a.Parse(args); err != nil { return opts, fmt.Errorf("parse flags: %w", err) } opts.showHelp = a.showHelp if opts.showHelp { return opts, nil } modeCount := 0 if opts.from != "" || opts.to != "" { modeCount++ } if opts.commit != "" { modeCount++ } // modeCount == 0 → workspace mode (no error, allowed) if modeCount > 1 { return opts, fmt.Errorf("only one review mode allowed (--from/--to or --commit)") } if opts.from != "" && opts.to == "" { return opts, fmt.Errorf("--to is required when --from is specified") } switch opts.audience { case "human", "agent": default: return opts, fmt.Errorf("invalid --audience value %q: must be 'human' or 'agent'", opts.audience) } return opts, nil } func printReviewUsage() { fmt.Println(`OpenCodeReview - AI-Powered Code Review CLI Usage: ocr review [flags] ocr r [flags] (alias) Examples: # Review staged + unstaged + untracked changes in current workspace ocr review # Review a branch against its base (merge-base mode) ocr review --from master --to dev-ref # Review a specific commit ocr review --commit abc123 ocr review -c abc123 # Output JSON format ocr review --format json ocr review -f json # Agent mode (summary only, no progress lines) ocr review --audience agent Flags: --audience string output audience: human (show progress) or agent (summary only) (default "human") -b, --background string optional requirement/business context for the review -c, --commit string single commit hash or tag to review (vs its parent) -f, --format string output format: text or json (default "text") --concurrency int max concurrent file reviews (default 8) --from string source ref to start diff from (e.g., 'main') --repo string root directory of the git repository (default: current dir) --rule string path to JSON file with system review rules --timeout int concurrent task timeout in minutes (default 10) --to string target ref to end diff at (e.g., 'feature-branch') --tools string path to JSON tools config file (default: embedded)`) } // --- config subcommand --- type configAction struct { subCmd string // "set" key string value string } func parseConfigArgs(args []string) (configAction, error) { if len(args) == 0 { return configAction{}, fmt.Errorf("usage: ocr config set \ne.g., ocr config set llm.model claude-opus-4-6") } subCmd := args[0] switch subCmd { case "set": if len(args) < 3 { return configAction{}, fmt.Errorf("usage: ocr config set \ne.g., ocr config set llm.model claude-opus-4-6") } return configAction{ subCmd: "set", key: args[1], value: args[2], }, nil default: return configAction{}, fmt.Errorf("unknown config sub-command: %s\nAvailable: set", subCmd) } } func printConfigUsage() { fmt.Println(`Configuration management. Usage: ocr config set Examples: ocr config set llm.url https://xx/v1/openai/chat/completions ocr config set llm.auth_token xxxxxxxxxx ocr config set llm.model claude-opus-4-6 ocr config set language English ocr config set telemetry.enabled true Supported keys: llm.url, llm.auth_token, llm.model, llm.use_anthropic, language, telemetry.enabled, telemetry.exporter, telemetry.otlp_endpoint, telemetry.content_logging`) }