cmd

type ApprovalsApproveCmd struct {
	IDs   []int64 `arg:"" optional:"" help:"Time entry IDs to approve"`
	Week  bool    `help:"Approve all submitted entries for current week" short:"w"`
	User  string  `help:"Filter by user ID when using --week"`
	Force bool    `help:"Skip confirmation" short:"f"`
}

type ApprovalsCmd struct {
	List     ApprovalsListCmd     `cmd:"" help:"List time entries pending approval"`
	Submit   ApprovalsSubmitCmd   `cmd:"" help:"Submit time entries for approval"`
	Approve  ApprovalsApproveCmd  `cmd:"" help:"Approve submitted time entries (manager)"`
	Reject   ApprovalsRejectCmd   `cmd:"" help:"Reject submitted time entries (manager)"`
	Unsubmit ApprovalsUnsubmitCmd `cmd:"" help:"Unsubmit entries back to draft"`
}

type ApprovalsListCmd struct {
	Status string `help:"Filter by status" enum:"submitted,unsubmitted,approved" default:"submitted"`
	User   string `help:"Filter by user ID or 'me'"`
	Week   bool   `help:"Show current week only"`
	From   string `help:"Start date (YYYY-MM-DD or 'today')" short:"f"`
	To     string `help:"End date" short:"t"`
	All    bool   `help:"Fetch all history instead of defaulting to the last 30 days"`
}

type ApprovalsRejectCmd struct {
	IDs   []int64 `arg:"" help:"Time entry IDs to reject"`
	Force bool    `help:"Skip confirmation" short:"f"`
}

type ApprovalsSubmitCmd struct {
	IDs   []int64 `arg:"" optional:"" help:"Time entry IDs to submit"`
	Week  bool    `help:"Submit all unsubmitted entries for current week" short:"w"`
	Force bool    `help:"Skip confirmation" short:"f"`
}

type ApprovalsUnsubmitCmd struct {
	IDs   []int64 `arg:"" optional:"" help:"Time entry IDs to unsubmit"`
	Week  bool    `help:"Unsubmit all submitted entries for current week" short:"w"`
	Force bool    `help:"Skip confirmation" short:"f"`
}

type AuthCmd struct {
	Setup  AuthSetupCmd  `cmd:"" help:"Store OAuth client credentials"`
	Login  AuthLoginCmd  `cmd:"" help:"Authenticate with Harvest"`
	Logout AuthLogoutCmd `cmd:"" help:"Remove stored authentication"`
	Status AuthStatusCmd `cmd:"" help:"Show authentication status"`
	List   AuthListCmd   `cmd:"" help:"List authenticated accounts"`
	Switch AuthSwitchCmd `cmd:"" help:"Switch default account"`
}

type AuthListCmd struct{}

type AuthLoginCmd struct {
	ClientName   string `help:"OAuth client name" default:"default" name:"client-name"`
	ForceConsent bool   `help:"Force consent prompt even if already authorized" name:"force-consent"`
	Manual       bool   `help:"Manual authorization (paste URL instead of callback server)"`
	PAT          bool   `help:"Use Personal Access Token instead of OAuth" name:"pat"`
}

type AuthLogoutCmd struct {
	Email      string `help:"Email/account to log out" name:"email"`
	ClientName string `help:"OAuth client name" default:"default" name:"client-name"`
	All        bool   `help:"Log out all accounts"`
}

type AuthSetupCmd struct {
	ClientID     string `arg:"" optional:"" help:"OAuth client ID"`
	ClientSecret string `help:"OAuth client secret (for non-interactive use)" name:"client-secret"`
	ClientName   string `help:"Client name (default: default)" default:"default" name:"client-name"`
}

type AuthStatusCmd struct {
	ClientName string `help:"OAuth client name" default:"default" name:"client-name"`
}

type AuthSwitchCmd struct {
	Account string `arg:"" help:"Account email or alias to set as default"`
}

type BulkCmd struct {
	Export BulkExportCmd `cmd:"" help:"Export time entries to CSV"`
	Import BulkImportCmd `cmd:"" help:"Import time entries from CSV"`
}

type BulkExportCmd struct {
	From    string `help:"Start date (required)" short:"f" required:""`
	To      string `help:"End date (required)" short:"t" required:""`
	Project string `help:"Filter by project ID or name" short:"p"`
	User    string `help:"Filter by user ID or 'me'" short:"u"`
	Output  string `help:"Output file path (default: stdout)" short:"o"`
}

type BulkImportCmd struct {
	File   string `arg:"" help:"CSV file path"`
	DryRun bool   `help:"Show what would be created without creating" short:"n"`
}

type CLI struct {
	RootFlags `embed:""`

	Version    kong.VersionFlag `help:"Print version and exit"`
	VersionCmd VersionCmd       `cmd:"" name:"version" help:"Show version information"`
	Auth       AuthCmd          `cmd:"" help:"Authentication commands"`
	Config     ConfigCmd        `cmd:"" help:"Configuration commands"`
	Time       TimeCmd          `cmd:"" help:"Time entry commands"`
	Timer      TimerCmd         `cmd:"" help:"Timer commands"`
	Projects   ProjectsCmd      `cmd:"" help:"Project commands"`
	Clients    ClientsCmd       `cmd:"" help:"Client commands"`
	Tasks      TasksCmd         `cmd:"" help:"Task commands"`
	Users      UsersCmd         `cmd:"" help:"User management commands"`
	Expenses   ExpensesCmd      `cmd:"" help:"Expense commands"`
	Estimates  EstimatesCmd     `cmd:"" help:"Estimate commands"`
	Invoices   InvoicesCmd      `cmd:"" help:"Invoice commands"`
	Reports    ReportsCmd       `cmd:"" help:"Report commands"`
	Company    CompanyCmd       `cmd:"" help:"Show company information"`
	Approvals  ApprovalsCmd     `cmd:"" help:"Approval workflow commands"`
	Bulk       BulkCmd          `cmd:"" help:"Bulk import/export operations"`
	Completion CompletionCmd    `cmd:"" help:"Generate shell completions"`
	Dashboard  DashboardCmd     `cmd:"" help:"Show weekly time tracking summary"`
}

type ClientsAddCmd struct {
	Name     string `arg:"" help:"Client name"`
	Address  string `help:"Client address"`
	Currency string `help:"Currency code (e.g., USD, EUR)"`
	Active   *bool  `help:"Is active (default: true)"`
}

type ClientsCmd struct {
	List   ClientsListCmd   `cmd:"" help:"List all clients"`
	Show   ClientsShowCmd   `cmd:"" help:"Show a client"`
	Add    ClientsAddCmd    `cmd:"" help:"Create a client"`
	Edit   ClientsEditCmd   `cmd:"" help:"Update a client"`
	Remove ClientsRemoveCmd `cmd:"" help:"Delete a client"`
}

type ClientsEditCmd struct {
	ID       int64  `arg:"" help:"Client ID"`
	Name     string `help:"Client name"`
	Address  string `help:"Client address"`
	Currency string `help:"Currency code"`
	Active   *bool  `help:"Is active"`
}

type ClientsListCmd struct {
	Active       *bool  `help:"Filter by active status"`
	UpdatedSince string `help:"Filter by updated since (ISO datetime)"`
}

type ClientsRemoveCmd struct {
	ID    int64 `arg:"" help:"Client ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type ClientsShowCmd struct {
	ID int64 `arg:"" help:"Client ID"`
}

type CompanyCmd struct {
	Edit            bool  `help:"Edit company settings" short:"e"`
	WantsTimestamps *bool `help:"Enable timestamp timers (with --edit)" name:"timestamps"`
	WeeklyCapacity  *int  `help:"Weekly capacity in seconds (with --edit)" name:"weekly-capacity"`
}

type CompletionBashCmd struct{}

type CompletionCmd struct {
	Bash CompletionBashCmd `cmd:"" help:"Generate bash completions"`
	Zsh  CompletionZshCmd  `cmd:"" help:"Generate zsh completions"`
	Fish CompletionFishCmd `cmd:"" help:"Generate fish completions"`
}

type CompletionFishCmd struct{}

type CompletionZshCmd struct{}

type ConfigCmd struct {
	Show  ConfigShowCmd  `cmd:"" default:"1" help:"Show current configuration"`
	Set   ConfigSetCmd   `cmd:"" help:"Set a configuration value"`
	Unset ConfigUnsetCmd `cmd:"" help:"Remove a configuration value"`
	Path  ConfigPathCmd  `cmd:"" help:"Show configuration directory path"`
}

type ConfigPathCmd struct{}

type ConfigSetCmd struct {
	Key   string `arg:"" help:"Configuration key"`
	Value string `arg:"" help:"Configuration value"`
}

type ConfigShowCmd struct{}

type ConfigUnsetCmd struct {
	Key string `arg:"" help:"Configuration key to remove"`
}

type DashboardCmd struct {
	Week string `help:"Week to show (default: current)" short:"w"`
}

type EstimatesAddCmd struct {
	HarvestClient string  `help:"Client ID or name (required)" name:"harvest-client" short:"c" required:""`
	Subject       string  `help:"Estimate subject" short:"s"`
	Number        string  `help:"Estimate number (auto-generated if not set)"`
	PurchaseOrder string  `help:"Purchase order number"`
	IssueDate     string  `help:"Issue date (default: today)" short:"d"`
	Currency      string  `help:"Currency code"`
	Tax           float64 `help:"Tax percentage"`
	Tax2          float64 `help:"Second tax percentage"`
	Discount      float64 `help:"Discount percentage"`
	Notes         string  `help:"Additional notes" short:"n"`
}

type EstimatesCmd struct {
	List         EstimatesListCmd         `cmd:"" help:"List estimates"`
	Show         EstimatesShowCmd         `cmd:"" help:"Show an estimate"`
	Add          EstimatesAddCmd          `cmd:"" help:"Create an estimate"`
	Edit         EstimatesEditCmd         `cmd:"" help:"Update an estimate"`
	Remove       EstimatesRemoveCmd       `cmd:"" help:"Delete an estimate"`
	Send         EstimatesSendCmd         `cmd:"" help:"Send estimate via email"`
	MarkSent     EstimatesMarkSentCmd     `cmd:"" name:"mark-sent" help:"Mark estimate as sent"`
	MarkAccepted EstimatesMarkAcceptedCmd `cmd:"" name:"mark-accepted" help:"Mark estimate as accepted"`
	MarkDeclined EstimatesMarkDeclinedCmd `cmd:"" name:"mark-declined" help:"Mark estimate as declined"`
	MarkDraft    EstimatesMarkDraftCmd    `cmd:"" name:"mark-draft" help:"Convert estimate back to draft"`
}

type EstimatesEditCmd struct {
	ID            int64   `arg:"" help:"Estimate ID"`
	HarvestClient string  `help:"Client ID or name" name:"harvest-client" short:"c"`
	Subject       string  `help:"Estimate subject" short:"s"`
	Number        string  `help:"Estimate number"`
	PurchaseOrder string  `help:"Purchase order number"`
	IssueDate     string  `help:"Issue date" short:"d"`
	Currency      string  `help:"Currency code"`
	Tax           float64 `help:"Tax percentage"`
	Tax2          float64 `help:"Second tax percentage"`
	Discount      float64 `help:"Discount percentage"`
	Notes         string  `help:"Additional notes" short:"n"`
}

type EstimatesListCmd struct {
	HarvestClient string `help:"Filter by client ID or name" name:"harvest-client" short:"c"`
	State         string `help:"Filter by state: draft, sent, accepted, declined" enum:",draft,sent,accepted,declined" default:""`
	UpdatedSince  string `help:"Filter by updated since date"`
	From          string `help:"Filter by issue date on or after" short:"f"`
	To            string `help:"Filter by issue date on or before" short:"t"`
	All           bool   `help:"Fetch all history instead of defaulting to the last 30 days"`
}

type EstimatesMarkAcceptedCmd struct {
	ID int64 `arg:"" help:"Estimate ID"`
}

type EstimatesMarkDeclinedCmd struct {
	ID int64 `arg:"" help:"Estimate ID"`
}

type EstimatesMarkDraftCmd struct {
	ID int64 `arg:"" help:"Estimate ID"`
}

type EstimatesMarkSentCmd struct {
	ID int64 `arg:"" help:"Estimate ID"`
}

type EstimatesRemoveCmd struct {
	ID    int64 `arg:"" help:"Estimate ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type EstimatesSendCmd struct {
	ID          int64    `arg:"" help:"Estimate ID"`
	Recipients  []string `help:"Recipient emails (comma-separated or multiple flags)" short:"r" required:""`
	Subject     string   `help:"Email subject" short:"s"`
	Body        string   `help:"Email body" short:"b"`
	SendMeACopy bool     `help:"Send a copy to yourself"`
}

type EstimatesShowCmd struct {
	ID int64 `arg:"" help:"Estimate ID"`
}

type ExitError struct {
	Code int
	Err  error
}

type ExpensesAddCmd struct {
	Project   string  `help:"Project ID or name" short:"p" required:""`
	Category  string  `help:"Expense category ID or name" required:""`
	Date      string  `help:"Date (default: today)" short:"d"`
	TotalCost float64 `help:"Total cost amount" required:""`
	Notes     string  `help:"Notes" short:"n"`
	Units     int     `help:"Units (for unit-based categories)"`
	Billable  *bool   `help:"Whether expense is billable"`
	Receipt   string  `help:"Path to receipt file"`
}

type ExpensesCategoriesCmd struct {
	Active *bool `help:"Filter by active status"`
}

type ExpensesCmd struct {
	List       ExpensesListCmd       `cmd:"" help:"List expenses"`
	Show       ExpensesShowCmd       `cmd:"" help:"Show an expense"`
	Add        ExpensesAddCmd        `cmd:"" help:"Create an expense"`
	Edit       ExpensesEditCmd       `cmd:"" help:"Update an expense"`
	Remove     ExpensesRemoveCmd     `cmd:"" help:"Delete an expense"`
	Receipt    ExpensesReceiptCmd    `cmd:"" help:"Upload receipt to expense"`
	Categories ExpensesCategoriesCmd `cmd:"" help:"List expense categories"`
}

type ExpensesEditCmd struct {
	ID            int64   `arg:"" help:"Expense ID"`
	Project       string  `help:"Project ID or name"`
	Category      string  `help:"Expense category ID or name"`
	Date          string  `help:"Date"`
	TotalCost     float64 `help:"Total cost amount"`
	Notes         string  `help:"Notes"`
	Units         int     `help:"Units (for unit-based categories)"`
	Billable      *bool   `help:"Whether expense is billable"`
	DeleteReceipt bool    `help:"Delete the attached receipt"`
}

type ExpensesListCmd struct {
	User          string `help:"Filter by user ID or 'me'"`
	HarvestClient string `help:"Filter by client ID or name" name:"harvest-client" short:"c"`
	Project       string `help:"Filter by project ID or name" short:"p"`
	Billed        bool   `help:"Only billed expenses"`
	Unbilled      bool   `help:"Only unbilled expenses"`
	UpdatedSince  string `help:"Filter by updated since (ISO datetime)"`
	From          string `help:"Start date (YYYY-MM-DD or 'today')" short:"f"`
	To            string `help:"End date" short:"t"`
	All           bool   `help:"Fetch all history instead of defaulting to the last 30 days"`
}

type ExpensesReceiptCmd struct {
	ID      int64  `arg:"" help:"Expense ID"`
	Receipt string `arg:"" help:"Path to receipt file"`
}

type ExpensesRemoveCmd struct {
	ID    int64 `arg:"" help:"Expense ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type ExpensesShowCmd struct {
	ID int64 `arg:"" help:"Expense ID"`
}

type InvoicePaymentsAddCmd struct {
	InvoiceID int64   `arg:"" help:"Invoice ID"`
	Amount    float64 `help:"Payment amount" required:""`
	PaidDate  string  `help:"Payment date (default: today)"`
	Notes     string  `help:"Payment notes"`
}

type InvoicePaymentsCmd struct {
	List   InvoicePaymentsListCmd   `cmd:"" help:"List payments for an invoice"`
	Add    InvoicePaymentsAddCmd    `cmd:"" help:"Add a payment to an invoice"`
	Remove InvoicePaymentsRemoveCmd `cmd:"" help:"Remove a payment from an invoice"`
}

type InvoicePaymentsListCmd struct {
	InvoiceID int64 `arg:"" help:"Invoice ID"`
}

type InvoicePaymentsRemoveCmd struct {
	InvoiceID int64 `arg:"" help:"Invoice ID"`
	PaymentID int64 `arg:"" help:"Payment ID"`
	Force     bool  `help:"Skip confirmation" short:"f"`
}

type InvoicesAddCmd struct {
	HarvestClient string  `help:"Client ID or name (required)" name:"harvest-client" short:"c" required:""`
	Number        string  `help:"Invoice number"`
	Subject       string  `help:"Invoice subject"`
	Notes         string  `help:"Invoice notes"`
	IssueDate     string  `help:"Issue date (default: today)"`
	DueDate       string  `help:"Due date"`
	PaymentTerm   string  `` /* 140-byte string literal not displayed */
	Currency      string  `help:"Currency code (e.g., USD, EUR)"`
	Tax           float64 `help:"Tax percentage"`
	Tax2          float64 `help:"Tax2 percentage"`
	Discount      float64 `help:"Discount percentage"`
	PurchaseOrder string  `help:"Purchase order number"`
}

type InvoicesCmd struct {
	List       InvoicesListCmd       `cmd:"" help:"List invoices"`
	Show       InvoicesShowCmd       `cmd:"" help:"Show an invoice"`
	Add        InvoicesAddCmd        `cmd:"" help:"Create an invoice"`
	Edit       InvoicesEditCmd       `cmd:"" help:"Update an invoice"`
	Remove     InvoicesRemoveCmd     `cmd:"" help:"Delete an invoice"`
	Send       InvoicesSendCmd       `cmd:"" help:"Send invoice via email"`
	MarkSent   InvoicesMarkSentCmd   `cmd:"" name:"mark-sent" help:"Mark invoice as sent"`
	MarkClosed InvoicesMarkClosedCmd `cmd:"" name:"mark-closed" help:"Mark invoice as closed"`
	MarkDraft  InvoicesMarkDraftCmd  `cmd:"" name:"mark-draft" help:"Mark invoice as draft"`
	Payments   InvoicePaymentsCmd    `cmd:"" help:"Manage invoice payments"`
}

type InvoicesEditCmd struct {
	ID            int64   `arg:"" help:"Invoice ID"`
	Number        string  `help:"Invoice number"`
	Subject       string  `help:"Invoice subject"`
	Notes         string  `help:"Invoice notes"`
	IssueDate     string  `help:"Issue date"`
	DueDate       string  `help:"Due date"`
	PaymentTerm   string  `help:"Payment term"`
	Currency      string  `help:"Currency code"`
	Tax           float64 `help:"Tax percentage"`
	Tax2          float64 `help:"Tax2 percentage"`
	Discount      float64 `help:"Discount percentage"`
	PurchaseOrder string  `help:"Purchase order number"`
}

type InvoicesListCmd struct {
	HarvestClient string `help:"Filter by client ID or name" name:"harvest-client" short:"c"`
	Project       string `help:"Filter by project ID or name" short:"p"`
	State         string `help:"Filter by state: draft, open, paid, closed" default:"" enum:",draft,open,paid,closed"`
	UpdatedSince  string `help:"Filter by updated since date"`
	From          string `help:"Filter by issue date from" short:"f"`
	To            string `help:"Filter by issue date to" short:"t"`
	All           bool   `help:"Fetch all history instead of defaulting to the last 30 days"`
}

type InvoicesMarkClosedCmd struct {
	ID int64 `arg:"" help:"Invoice ID"`
}

type InvoicesMarkDraftCmd struct {
	ID int64 `arg:"" help:"Invoice ID"`
}

type InvoicesMarkSentCmd struct {
	ID int64 `arg:"" help:"Invoice ID"`
}

type InvoicesRemoveCmd struct {
	ID    int64 `arg:"" help:"Invoice ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type InvoicesSendCmd struct {
	ID         int64    `arg:"" help:"Invoice ID"`
	Recipients []string `help:"Recipient emails (comma-separated or multiple flags)" short:"r"`
	Subject    string   `help:"Email subject"`
	Body       string   `help:"Email body"`
	AttachPDF  bool     `help:"Attach PDF to email" default:"true"`
	SendCopy   bool     `help:"Send a copy to yourself"`
}

type InvoicesShowCmd struct {
	ID int64 `arg:"" help:"Invoice ID"`
}

type ProjectsAddCmd struct {
	Name          string  `help:"Project name" short:"n" required:""`
	HarvestClient string  `help:"Client ID or name" name:"harvest-client" short:"c"`
	Code          string  `help:"Project code"`
	Billable      bool    `help:"Project is billable" default:"true"`
	BillBy        string  `help:"Bill by: none, People, Project, Tasks" default:"none" enum:"none,People,Project,Tasks"`
	BudgetBy      string  `help:"Budget by: none, person, project, task" default:"none" enum:"none,person,project,task"`
	HourlyRate    float64 `help:"Hourly rate"`
	Budget        float64 `help:"Budget amount"`
	Notes         string  `help:"Project notes"`
	StartsOn      string  `help:"Start date"`
	EndsOn        string  `help:"End date"`
	FixedFee      bool    `help:"Fixed fee project"`
}

type ProjectsCmd struct {
	List   ProjectsListCmd   `cmd:"" help:"List all projects"`
	Show   ProjectsShowCmd   `cmd:"" help:"Show a project"`
	Add    ProjectsAddCmd    `cmd:"" help:"Create a project"`
	Edit   ProjectsEditCmd   `cmd:"" help:"Update a project"`
	Remove ProjectsRemoveCmd `cmd:"" help:"Delete a project"`
}

type ProjectsEditCmd struct {
	ID            int64   `arg:"" help:"Project ID"`
	Name          string  `help:"Project name" short:"n"`
	HarvestClient string  `help:"Client ID or name" name:"harvest-client" short:"c"`
	Code          string  `help:"Project code"`
	Active        string  `help:"Is active: true, false" default:"" enum:",true,false"`
	Billable      string  `help:"Is billable: true, false" default:"" enum:",true,false"`
	BillBy        string  `help:"Bill by: none, People, Project, Tasks" default:"" enum:",none,People,Project,Tasks"`
	BudgetBy      string  `help:"Budget by: none, person, project, task" default:"" enum:",none,person,project,task"`
	HourlyRate    float64 `help:"Hourly rate"`
	Budget        float64 `help:"Budget amount"`
	Notes         string  `help:"Project notes"`
	StartsOn      string  `help:"Start date"`
	EndsOn        string  `help:"End date"`
	FixedFee      string  `help:"Fixed fee: true, false" default:"" enum:",true,false"`
}

type ProjectsListCmd struct {
	Active        string `help:"Filter by active status: true, false, all" default:"all" enum:"true,false,all"`
	HarvestClient string `help:"Filter by client ID or name" name:"harvest-client" short:"c"`
	UpdatedSince  string `help:"Filter by updated since date"`
}

type ProjectsRemoveCmd struct {
	ID    int64 `arg:"" help:"Project ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type ProjectsShowCmd struct {
	ID int64 `arg:"" help:"Project ID"`
}

type ReportsBudgetCmd struct {
	Active   bool `help:"Only active projects"`
	Inactive bool `help:"Only inactive projects"`
}

type ReportsCmd struct {
	Time       ReportsTimeCmd       `cmd:"" help:"Time reports"`
	Expenses   ReportsExpensesCmd   `cmd:"" help:"Expense reports"`
	Uninvoiced ReportsUninvoicedCmd `cmd:"" help:"Uninvoiced amounts report"`
	Budget     ReportsBudgetCmd     `cmd:"" help:"Project budget report"`
}

type ReportsExpensesCmd struct {
	By   string `help:"Group by: clients, projects, categories, team" default:"projects" enum:"clients,projects,categories,team"`
	From string `help:"Start date (required)" short:"f" required:""`
	To   string `help:"End date (required)" short:"t" required:""`
}

type ReportsTimeCmd struct {
	By   string `help:"Group by: clients, projects, tasks, team" default:"projects" enum:"clients,projects,tasks,team"`
	From string `help:"Start date (required)" short:"f" required:""`
	To   string `help:"End date (required)" short:"t" required:""`
}

type ReportsUninvoicedCmd struct {
	From string `help:"Start date (required)" short:"f" required:""`
	To   string `help:"End date (required)" short:"t" required:""`
}

type RootFlags struct {
	Account   string `help:"Account email or alias" short:"a" env:"HARVESTCLI_ACCOUNT"`
	AccountID int64  `help:"Harvest account ID override" env:"HARVESTCLI_ACCOUNT_ID"`
	Client    string `help:"OAuth client name override"`
	JSON      bool   `help:"Output as JSON" short:"j"`
	Plain     bool   `help:"Output as TSV (plain text)"`
	Verbose   bool   `help:"Verbose output" short:"v"`
	Color     string `help:"Color output: auto, always, never" default:"auto" enum:"auto,always,never"`
}

type TasksAddCmd struct {
	Name              string   `arg:"" help:"Task name"`
	BillableByDefault *bool    `help:"Billable by default"`
	DefaultHourlyRate *float64 `help:"Default hourly rate"`
	IsDefault         *bool    `help:"Add to new projects by default"`
	Active            *bool    `help:"Is active (default: true)"`
}

type TasksCmd struct {
	List   TasksListCmd   `cmd:"" help:"List all tasks"`
	Show   TasksShowCmd   `cmd:"" help:"Show a task"`
	Add    TasksAddCmd    `cmd:"" help:"Create a task"`
	Edit   TasksEditCmd   `cmd:"" help:"Update a task"`
	Remove TasksRemoveCmd `cmd:"" help:"Delete a task"`
}

type TasksEditCmd struct {
	ID                int64    `arg:"" help:"Task ID"`
	Name              string   `help:"Task name"`
	BillableByDefault *bool    `help:"Billable by default"`
	DefaultHourlyRate *float64 `help:"Default hourly rate"`
	IsDefault         *bool    `help:"Add to new projects by default"`
	Active            *bool    `help:"Is active"`
}

type TasksListCmd struct {
	Active       *bool  `help:"Filter by active status"`
	UpdatedSince string `help:"Filter by updated since (ISO datetime)"`
}

type TasksRemoveCmd struct {
	ID    int64 `arg:"" help:"Task ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type TasksShowCmd struct {
	ID int64 `arg:"" help:"Task ID"`
}

type TimeAddCmd struct {
	Project       string  `help:"Project ID or name" short:"p"`
	Task          string  `help:"Task ID or name"`
	Date          string  `help:"Date (default: today)" short:"d"`
	Hours         float64 `help:"Hours (duration mode)" short:"h"`
	Start         string  `help:"Start time (timestamp mode)"`
	End           string  `help:"End time (timestamp mode)"`
	Notes         string  `help:"Notes" short:"n"`
	Duration      bool    `help:"Use duration mode (hours)"`
	Timestamp     bool    `help:"Use timestamp mode (start/end)"`
	ExtRefID      string  `help:"External reference ID (e.g., JIRA-123)" name:"external-ref-id"`
	ExtRefGroupID string  `help:"External reference group ID" name:"external-ref-group-id"`
	ExtRefURL     string  `help:"External reference URL" name:"external-ref-url"`
	ExtRefService string  `help:"External reference service name (e.g., jira, asana)" name:"external-ref-service"`
}

type TimeCmd struct {
	List   TimeListCmd   `cmd:"" help:"List time entries"`
	Show   TimeShowCmd   `cmd:"" help:"Show a time entry"`
	Add    TimeAddCmd    `cmd:"" help:"Create a time entry"`
	Edit   TimeEditCmd   `cmd:"" help:"Update a time entry"`
	Remove TimeRemoveCmd `cmd:"" help:"Delete a time entry"`
	Log    TimeLogCmd    `cmd:"" help:"Quick time entry (wizard if no args)"`
}

type TimeEditCmd struct {
	ID            int64   `arg:"" help:"Time entry ID"`
	Project       string  `help:"Project ID or name"`
	Task          string  `help:"Task ID or name"`
	Date          string  `help:"Date"`
	Hours         float64 `help:"Hours"`
	Start         string  `help:"Start time"`
	End           string  `help:"End time"`
	Notes         string  `help:"Notes"`
	ExtRefID      string  `help:"External reference ID (e.g., JIRA-123)" name:"external-ref-id"`
	ExtRefGroupID string  `help:"External reference group ID" name:"external-ref-group-id"`
	ExtRefURL     string  `help:"External reference URL" name:"external-ref-url"`
	ExtRefService string  `help:"External reference service name (e.g., jira, asana)" name:"external-ref-service"`
}

type TimeListCmd struct {
	From           string `help:"Start date (YYYY-MM-DD or 'today')" short:"f"`
	To             string `help:"End date" short:"t"`
	User           string `help:"Filter by user ID or 'me'"`
	Project        string `help:"Filter by project ID or name"`
	HarvestClient  string `help:"Filter by client ID or name" name:"harvest-client" short:"c"`
	Task           string `help:"Filter by task ID"`
	Billed         bool   `help:"Only billed entries"`
	Unbilled       bool   `help:"Only unbilled entries"`
	Running        bool   `help:"Only running timers"`
	ApprovalStatus string `help:"Filter by approval status" enum:",unsubmitted,submitted,approved" default:""`
	All            bool   `help:"Fetch all history instead of defaulting to the last 30 days"`
}

type TimeLogCmd struct {
	Notes   string  `arg:"" optional:"" help:"Entry notes"`
	Project string  `help:"Project ID or name" short:"p"`
	Task    string  `help:"Task ID or name"`
	Hours   float64 `help:"Hours" short:"h"`
	Date    string  `help:"Date (default: today)" short:"d"`
}

type TimeRemoveCmd struct {
	ID    int64 `arg:"" help:"Time entry ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type TimeShowCmd struct {
	ID int64 `arg:"" help:"Time entry ID"`
}

type TimerCmd struct {
	Status  TimerStatusCmd  `cmd:"" default:"1" help:"Show running timer"`
	Start   TimerStartCmd   `cmd:"" help:"Start a timer"`
	Stop    TimerStopCmd    `cmd:"" help:"Stop running timer"`
	Restart TimerRestartCmd `cmd:"" help:"Restart a stopped timer"`
	Toggle  TimerToggleCmd  `cmd:"" help:"Toggle timer (stop if running, start last if not)"`
}

type TimerRestartCmd struct {
	ID int64 `arg:"" help:"Time entry ID to restart"`
}

type TimerStartCmd struct {
	Project string `help:"Project ID or name" short:"p"`
	Task    string `help:"Task ID or name"`
	Notes   string `help:"Notes" short:"n"`
}

type TimerStatusCmd struct{}

type TimerStopCmd struct{}

type TimerToggleCmd struct {
	Project string `help:"Project for new timer if starting" short:"p"`
	Task    string `help:"Task for new timer"`
}

type UsersAddCmd struct {
	Email                        string   `help:"User email" required:""`
	FirstName                    string   `help:"First name" required:"" name:"first-name"`
	LastName                     string   `help:"Last name" required:"" name:"last-name"`
	Timezone                     string   `help:"Timezone"`
	HasAccessToAllFutureProjects *bool    `help:"Has access to all future projects" name:"access-all-projects"`
	IsContractor                 *bool    `help:"Is contractor" name:"contractor"`
	IsActive                     *bool    `help:"Is active" name:"active"`
	WeeklyCapacity               *int     `help:"Weekly capacity (seconds)" name:"weekly-capacity"`
	DefaultHourlyRate            *float64 `help:"Default hourly rate" name:"hourly-rate"`
	CostRate                     *float64 `help:"Cost rate" name:"cost-rate"`
	Roles                        []string `help:"Roles (comma-separated)"`
	AccessRoles                  []string `help:"Access roles (comma-separated)" name:"access-roles"`
}

type UsersCmd struct {
	List   UsersListCmd   `cmd:"" help:"List all users"`
	Show   UsersShowCmd   `cmd:"" help:"Show a user by ID"`
	Me     UsersMeCmd     `cmd:"" help:"Show current authenticated user"`
	Add    UsersAddCmd    `cmd:"" help:"Create a new user"`
	Edit   UsersEditCmd   `cmd:"" help:"Update a user"`
	Remove UsersRemoveCmd `cmd:"" help:"Delete/deactivate a user"`
}

type UsersEditCmd struct {
	ID                           int64    `arg:"" help:"User ID"`
	Email                        string   `help:"User email"`
	FirstName                    string   `help:"First name" name:"first-name"`
	LastName                     string   `help:"Last name" name:"last-name"`
	Timezone                     string   `help:"Timezone"`
	HasAccessToAllFutureProjects *bool    `help:"Has access to all future projects" name:"access-all-projects"`
	IsContractor                 *bool    `help:"Is contractor" name:"contractor"`
	IsActive                     *bool    `help:"Is active" name:"active"`
	WeeklyCapacity               *int     `help:"Weekly capacity (seconds)" name:"weekly-capacity"`
	DefaultHourlyRate            *float64 `help:"Default hourly rate" name:"hourly-rate"`
	CostRate                     *float64 `help:"Cost rate" name:"cost-rate"`
	Roles                        []string `help:"Roles (comma-separated)"`
	AccessRoles                  []string `help:"Access roles (comma-separated)" name:"access-roles"`
}

type UsersListCmd struct {
	Active       *bool  `help:"Filter by active status"`
	UpdatedSince string `help:"Filter by updated_since (ISO 8601)"`
}

type UsersMeCmd struct{}

type UsersRemoveCmd struct {
	ID    int64 `arg:"" help:"User ID"`
	Force bool  `help:"Skip confirmation" short:"f"`
}

type UsersShowCmd struct {
	ID int64 `arg:"" help:"User ID"`
}

type VersionCmd struct{}