// Copyright 2025 WIT.COM Inc Licensed GPL 3.0

syntax = "proto3";

package argvpb;

import "google/protobuf/timestamp.proto"; // Import the well-known type for Timestamp
import "google/protobuf/duration.proto"; // for duration

message App {
        string                      APPNAME          = 1;
        string                      VERSION          = 2;
        string                      BUILDTIME        = 3;
}

message StructEntry {
        string                      structName       = 1;  // 'Force', 'Verbose', 'SortCmd'
        string                      structType       = 2;  // 'string', 'int', '[]string', '*FindCmd'
        string                      defaultVal       = 3;  // "true"
        string                      helpText         = 4;  // "This will help you"
        string                      matchText        = 5;  //  "--help-me
}

message ArgTree {
        repeated StructEntry        Structs          = 1;  // a tree of the argv structs in argv.go
        string                      mainArgvName     = 2;  // name to use in main.go
}

message Argv {                                             // `autogenpb:marshal` `autogenpb:sort` `autogenpb:nomutex`
        google.protobuf.Timestamp   ctime            = 1;  // when the user tried this autocomplete
        google.protobuf.Duration    duration         = 2;  // time since the last autocomplete
        App                         appInfo          = 3;
        repeated string             args             = 4;  // a copy of os.Args
        repeated string             real             = 5;  // what will really be sent to the application
        string                      subcmd           = 6;  // the subcommand being processed. For "git pull <tab>", cmd would be "pull"
        string                      partial          = 7;  // if the user has only partially inputed something
        bool                        fast             = 8;  // is autocomplete running quickly?
        string                      stdout           = 9;  // all output is loaded here before being sent to the shell
        string                      stderr           = 10; // all output is loaded here before being sent to the shell
        int32                       helpCounter      = 11; // counter to track if the help text has been sent to Stderr
        string                      uuid             = 12; // all output is loaded here before being sent to the shell
}

message Argvs {                                            // `autogenpb:marshal` `autogenpb:sort` `autogenpb:nomutex`
        string                      uuid             = 1;  // `autogenpb:uuid:1e6e765c-0c77-4c81-a622-0d819bfcce9a`
        string                      version          = 2;  // `autogenpb:version:v0.0.5`
        repeated Argv               argvs            = 3;
        string                      filename         = 4;  // `autogenpb:save` -- this enables autogenerated pb.Load() and pb.Save()
}