cli

type AgentCmd struct {
	Start AgentStartCmd `cmd:"" help:"Launch a declared agent (config.yaml command + prompts), heartbeating while it runs."`
	Ls    AgentLsCmd    `cmd:"" aliases:"list" help:"List declared agents (config) with an active indicator."`
	Show  AgentShowCmd  `cmd:"" help:"Show one agent's full record."`
	Gc    AgentGcCmd    `cmd:"" help:"Forcibly drop stale active_agents rows (older than --stale-seconds)."`
}

type AgentGcCmd struct {
	StaleSec int64 `name:"stale-seconds" default:"30" help:"Delete rows older than this."`
}

type AgentLsCmd struct {
	StaleSec int64 `name:"stale-seconds" default:"30" help:"Consider rows older than this dead."`
}

type AgentShowCmd struct {
	Name string `arg:"" help:"Agent name."`
}

type AgentStartCmd struct {
	Name  string   `arg:"" help:"Agent name (declared in config.yaml)."`
	Print bool     `name:"print" aliases:"dry-run" help:"Print the assembled command and exit without launching."`
	Rest  []string `arg:"" optional:"" name:"args" passthrough:"" help:"Extra arguments forwarded to the agent command."`
}

type ApproveCmd struct {
	ID     string `arg:"" help:"Checkpoint issue ID."`
	As     string `` /* 198-byte string literal not displayed */
	Reason string `name:"reason" help:"Optional note appended to the issue when approving."`
}

type AssignCmd struct {
	ID string `arg:"" help:"Issue ID."`
	To string `arg:"" optional:"" help:"Assignee name (empty clears)."`
}

type BatchCmd struct {
	File       string `arg:"" optional:"" help:"JSON file (default: stdin)."`
	Docs       bool   `name:"docs" help:"Print the full batch JSON format reference (fields, semantics, example) and exit."`
	DryRun     bool   `name:"dry-run" help:"Validate and report stats without writing anything."`
	Group      string `` /* 180-byte string literal not displayed */
	OnExisting string `` /* 178-byte string literal not displayed */
	Agent      string `short:"a" name:"agent" default:"${user}" help:"Identity recorded as the actor on the created issues' audit events."`
}

type BlockedCmd struct {
	Limit int    `short:"n" name:"limit" default:"20" help:"Limit results (0 = unlimited)."`
	Agent string `short:"a" help:"Lane to query (default: unassigned)."`
}

type BriefCmd struct{}

type CLI struct {
	Dir   string `` /* 197-byte string literal not displayed */
	JSON  bool   `name:"json" help:"Emit machine-readable JSON instead of human output."`
	Quiet bool   `short:"q" name:"quiet" help:"Suppress non-essential output (errors still go to stderr)."`

	// --- issues: the core CRUD + state loop ---
	Init    InitCmd    `cmd:"" group:"issues" help:"Initialize the database in the current directory."`
	Create  CreateCmd  `cmd:"" group:"issues" help:"Create a new issue."`
	List    ListCmd    `cmd:"" group:"issues" aliases:"ls" help:"List issues."`
	Ready   ReadyCmd   `cmd:"" group:"issues" help:"List issues that are ready to work on."`
	Blocked BlockedCmd `cmd:"" group:"issues" help:"List issues that have at least one open dependency."`
	Show    ShowCmd    `cmd:"" group:"issues" help:"Show details for one issue."`
	Claim   ClaimCmd   `cmd:"" group:"issues" help:"Claim the next ready issue (or a specific one)."`
	Close   CloseCmd   `cmd:"" group:"issues" help:"Close an issue."`
	Cancel  CancelCmd  `cmd:"" group:"issues" help:"Cancel an issue and all its transitive dependents."`
	Reopen  ReopenCmd  `cmd:"" group:"issues" help:"Reopen a closed issue."`
	Update  UpdateCmd  `cmd:"" group:"issues" help:"Update fields on an issue."`

	// --- edits: sugar + relations ---
	Assign   AssignCmd   `cmd:"" group:"edits" help:"Assign an issue (sugar for 'update --assignee')."`
	Priority PriorityCmd `cmd:"" group:"edits" help:"Set an issue's priority (sugar for 'update -p N')."`
	Describe DescribeCmd `cmd:"" group:"edits" help:"Set or clear an issue's description (sugar for 'update --description')."`
	Note     NoteCmd     `cmd:"" group:"edits" help:"Manage an issue's freeform notes."`
	Comment  CommentCmd  `cmd:"" group:"edits" help:"Manage comments on an issue."`
	Label    LabelCmd    `cmd:"" group:"edits" help:"Manage labels on an issue."`
	Tag      TagCmd      `cmd:"" group:"edits" help:"Add labels to an issue (alias for 'label add')."`
	Dep      DepCmd      `cmd:"" group:"edits" help:"Manage dependency edges."`
	Link     LinkCmd     `cmd:"" group:"edits" help:"Add a dependency edge (alias for 'dep add')."`
	Defer    DeferCmd    `cmd:"" group:"edits" help:"Defer an issue until a later time."`
	Undefer  UndeferCmd  `cmd:"" group:"edits" help:"Clear an issue's deferral."`

	// --- coordination: agents, brief, locks, mailbox ---
	Agent  AgentCmd  `cmd:"" group:"coord" help:"Manage agents — list declared (config.yaml) and live (heartbeat) state."`
	Brief  BriefCmd  `cmd:"" group:"coord" help:"Print agent workflow context: AGENTS.md, declared agents, who's live, persisted memories."`
	Lock   LockCmd   `cmd:"" group:"coord" help:"Acquire a named lock for ad-hoc coordination (deploy slots, build dirs, shared resources)."`
	Unlock UnlockCmd `cmd:"" group:"coord" help:"Release a named lock."`
	Locks  LocksCmd  `cmd:"" group:"coord" help:"List current locks (live and stale)."`
	Ping   PingCmd   `cmd:"" group:"coord" help:"Send a fire-and-forget message to another agent's mailbox (TTL'd, doesn't pollute the work log)."`
	Inbox  InboxCmd  `cmd:"" group:"coord" help:"Read pings addressed to you (the mailbox). Marks read on consume unless --peek."`

	// --- workflows ---
	Run        RunCmd        `cmd:"" group:"workflow" help:"Instantiate a workflow template into issues + deps."`
	Template   TemplateCmd   `cmd:"" group:"workflow" help:"Inspect and validate workflow templates."`
	Checkpoint CheckpointCmd `cmd:"" group:"workflow" help:"Pass or fail a checkpoint step."`
	Approve    ApproveCmd    `cmd:"" group:"workflow" help:"Approve a checkpoint (sugar for 'checkpoint pass')."`

	// --- inspection: read-only diagnostics ---
	History  HistoryCmd  `cmd:"" group:"inspect" help:"Show the audit trail for one issue (oldest first)."`
	Log      LogCmd      `cmd:"" group:"inspect" help:"Show the global event stream, newest first (filter by --actor/--kind/--issue/--since)."`
	Count    CountCmd    `cmd:"" group:"inspect" help:"Count issues matching the same filters as 'list'."`
	Stats    StatsCmd    `cmd:"" group:"inspect" help:"Show issue counts grouped by status, agent, and type."`
	Info     InfoCmd     `cmd:"" group:"inspect" help:"Show database path, schema version, and a summary of issues."`
	Doctor   DoctorCmd   `cmd:"" group:"inspect" help:"Run integrity and health checks against the database."`
	Statuses StatusesCmd `cmd:"" group:"inspect" help:"List valid issue statuses."`
	Types    TypesCmd    `cmd:"" group:"inspect" help:"List valid issue types."`

	// --- data + servers ---
	KV     KVCmd     `cmd:"" group:"data" help:"Manage a generic key-value store (feature flags, env, scratch data)."`
	Export ExportCmd `cmd:"" group:"data" help:"Export all issues + deps + labels as JSONL."`
	Import ImportCmd `cmd:"" group:"data" help:"Import JSONL produced by 'clu export'."`
	Sync   SyncCmd   `cmd:"" group:"data" help:"Sync issue state to a branch-independent git ref (refs/clu/store)."`
	Batch  BatchCmd  `cmd:"" group:"data" help:"Instantiate a whole issue graph from one JSON doc, atomically (validated, alias-resolved)."`
	SQL    SqlCmd    `cmd:"" group:"data" name:"sql" help:"Run an ad-hoc SQL query (read-only by default; pass --write for DML/DDL)."`
	Cron   CronCmd   `cmd:"" group:"data" help:"Schedule recurring clu invocations (drive from OS cron / launchd)."`
	HTTP   HTTPCmd   `cmd:"" group:"data" name:"http" help:"Start a REST API server backed by the project's store."`
	Web    WebCmd    `cmd:"" group:"data" name:"web" help:"Launch the web UI (REST API in-process + TanStack Start server)."`

	// --- environments: git worktrees and their bootstrap ---
	Worktree WorktreeCmd `cmd:"" group:"coord" help:"Manage git worktrees with project-defined bootstrap (copy files, run setup commands)."`

	// --- meta ---
	Version    VersionCmd    `cmd:"" group:"meta" help:"Print version information."`
	Completion CompletionCmd `cmd:"" group:"meta" help:"Generate a shell completion script."`
}

type CancelCmd struct {
	IDs    []string `arg:"" required:"" name:"id" help:"Issue IDs to cancel (cascades to dependents)."`
	Reason string   `name:"reason" short:"r" help:"Optional comment posted on each root issue before cancel."`
	Agent  string   `short:"a" name:"agent" default:"${user}" help:"Author for --reason comments. Defaults to $USER."`
}

type CheckpointCmd struct {
	Pass CheckpointPassCmd `cmd:"" help:"Mark a checkpoint as passed (clears the wait, closes the issue, unblocks downstream)."`
	Fail CheckpointFailCmd `cmd:"" help:"Mark a checkpoint as failed (closes the issue with checkpoint:failed; downstream stays blocked)."`
}

type CheckpointFailCmd struct {
	ID     string `arg:"" help:"Checkpoint issue ID."`
	As     string `short:"a" name:"agent" default:"${user}" help:"Caller identity (defaults to $USER)."`
	Reason string `name:"reason" help:"Optional note appended to the issue when failing."`
}

type CheckpointPassCmd struct {
	ID     string `arg:"" help:"Checkpoint issue ID."`
	As     string `` /* 198-byte string literal not displayed */
	Reason string `name:"reason" help:"Optional note appended to the issue when passing."`
}

type ClaimCmd struct {
	Agent     string        `` /* 140-byte string literal not displayed */
	Wait      bool          `help:"Block until something is claimable."`
	Interval  time.Duration `default:"250ms" help:"Poll interval when --wait is set."`
	Heartbeat bool          `` /* 127-byte string literal not displayed */
	Context   bool          `` /* 136-byte string literal not displayed */
	Depth     int           `name:"context-depth" help:"Cap how far up the dependency chain --context walks (0 = unlimited)."`
	ID        string        `arg:"" optional:"" help:"Specific issue to claim; omit for next ready."`
}

type CloseCmd struct {
	IDs    []string `arg:"" required:"" name:"id" help:"One or more issue IDs to close."`
	Reason string   `name:"reason" short:"r" help:"Optional comment posted on each issue before close. Avoids the comment-then-close two-step."`
	Agent  string   `short:"a" name:"agent" default:"${user}" help:"Author for --reason comments. Defaults to $USER."`
}

type CommentAddCmd struct {
	ID     string   `arg:"" help:"Issue ID."`
	Body   []string `arg:"" optional:"" help:"Comment body. Use '-' or omit (with piped stdin) to read from stdin."`
	Author string   `short:"a" name:"agent" default:"${user}" help:"Agent identity used as the comment author. Defaults to $USER."`
}

type CommentCmd struct {
	Add  CommentAddCmd  `cmd:"" help:"Add a comment to an issue. Pass body as args, '-', or via stdin (heredoc)."`
	Edit CommentEditCmd `cmd:"" help:"Replace the body of an existing comment."`
	Ls   CommentLsCmd   `cmd:"" aliases:"list" help:"List comments on an issue, chronological."`
	Rm   CommentRmCmd   `cmd:"" aliases:"remove" help:"Remove a comment by its numeric ID."`
}

type CommentEditCmd struct {
	ID    int64    `arg:"" help:"Comment ID (numeric, as shown in 'clu comment ls')."`
	Body  []string `arg:"" optional:"" help:"New body. Same input modes as 'comment add' (positional, '-', or stdin)."`
	Agent string   `short:"a" name:"agent" default:"${user}" help:"Agent identity recorded as the actor for this edit. Defaults to $USER."`
}

type CommentLsCmd struct {
	ID string `arg:"" help:"Issue ID."`
}

type CommentRmCmd struct {
	ID    int64  `arg:"" help:"Comment ID (numeric, as shown in 'cli comment ls')."`
	Agent string `short:"a" name:"agent" default:"${user}" help:"Agent identity recorded as the actor for this removal. Defaults to $USER."`
}

type CompletionCmd struct {
	Shell string `arg:"" enum:"bash,zsh,fish" help:"Target shell (bash, zsh, or fish)."`
}

type CountCmd struct {
	// contains filtered or unexported fields
}

type CreateCmd struct {
	Priority    int      `short:"p" default:"2" help:"Priority (0=highest)."`
	Type        string   `short:"t" default:"task" help:"Issue type."`
	Agent       string   `short:"a" help:"Assign directly to an agent lane (e.g. code-reviewer)."`
	Capability  []string `` /* 139-byte string literal not displayed */
	Dep         []string `` /* 170-byte string literal not displayed */
	Description string   `name:"description" help:"Long description. Set atomically with the issue (avoids the race between create + 'clu describe')."`
	Notes       string   `name:"notes" help:"Initial working notes. Set atomically with the issue."`
	Title       []string `arg:"" required:"" help:"Issue title."`
}

type CronAddCmd struct {
	Name     string   `arg:"" help:"Unique job name."`
	Schedule string   `name:"schedule" required:"" help:"+Nh/+Nd/+Nw or @hourly/@daily/@weekly/@monthly."`
	Args     []string `arg:"" passthrough:"" help:"After '--': the cli args to invoke (e.g. -- create -a infra-agent 'Check CI')."`
	StartNow bool     `name:"start-now" help:"Treat next_run as now; the first execution happens on the next 'cron run'."`
}

type CronCmd struct {
	Add     CronAddCmd     `cmd:"" help:"Add a scheduled job."`
	List    CronListCmd    `cmd:"" aliases:"ls" help:"List all scheduled jobs."`
	Rm      CronRmCmd      `cmd:"" aliases:"delete,remove" help:"Delete a scheduled job."`
	Enable  CronEnableCmd  `cmd:"" help:"Enable a scheduled job."`
	Disable CronDisableCmd `cmd:"" help:"Disable a scheduled job (keeps the row, skips it on run)."`
	Run     CronRunCmd     `cmd:"" help:"Run every job whose next_run has elapsed. Invoke periodically from OS cron / launchd."`
}

type CronDisableCmd struct {
	Name string `arg:"" help:"Job name."`
}

type CronEnableCmd struct {
	Name string `arg:"" help:"Job name."`
}

type CronListCmd struct{}

type CronRmCmd struct {
	Name string `arg:"" help:"Job name."`
}

type CronRunCmd struct {
	Force  string `name:"force" help:"Run this one job regardless of schedule (ignores enabled bit too)."`
	DryRun bool   `name:"dry-run" help:"Print what would run; don't execute or advance schedules."`
}

type DeferCmd struct {
	ID   string `arg:"" help:"Issue ID."`
	When string `arg:"" help:"When to wake up: YYYY-MM-DD, RFC3339, or relative (+6h, +2d, +1w, tomorrow)."`
}

type DepAddCmd struct {
	Child  string `arg:"" help:"Child issue (the one that depends)."`
	Parent string `arg:"" help:"Parent issue (the blocker)."`
}

type DepCmd struct {
	Add DepAddCmd `cmd:"" help:"Add a dependency edge."`
	Rm  DepRmCmd  `cmd:"" aliases:"remove" help:"Remove a dependency edge."`
	Ls  DepLsCmd  `cmd:"" aliases:"list" help:"List dependency edges for an issue (parents it needs + children it blocks)."`
}

type DepLsCmd struct {
	ID string `arg:"" help:"Issue ID."`
}

type DepRmCmd struct {
	Child  string `arg:"" help:"Child issue."`
	Parent string `arg:"" help:"Parent issue."`
}

type DescribeCmd struct {
	ID   string `arg:"" help:"Issue ID."`
	Text string `arg:"" optional:"" help:"Description text (empty clears)."`
}

type DoctorCmd struct {
	StuckHours int `name:"stuck-hours" default:"24" help:"Flag in-progress issues not updated in this many hours (0 disables)."`
}

type ExportCmd struct {
	Out string `` /* 157-byte string literal not displayed */
}

type HTTPCmd struct {
	Bind string `name:"bind" default:"127.0.0.1" help:"Interface to bind. Defaults to loopback; use 0.0.0.0 to share across the LAN."`
	Port int    `name:"port" default:"7777" help:"TCP port. 0 picks a free port and prints it on startup."`
}

type HistoryCmd struct {
	ID string `arg:"" help:"Issue ID."`
}

type ImportCmd struct {
	File    string `arg:"" optional:"" help:"Path to JSONL file (default: stdin)."`
	Lenient bool   `name:"lenient" help:"Skip lines that fail to parse instead of erroring."`
}

type InboxCmd struct {
	Agent    string        `short:"a" name:"agent" default:"${user}" help:"Whose inbox to read (defaults to $USER). Ignored when --global is set."`
	Global   bool          `short:"A" name:"global" help:"Tail/list every recipient's pings (system-wide). Never marks as read; --peek is implied."`
	All      bool          `name:"all" help:"Include already-read pings (default: unread only)."`
	Since    string        `name:"since" help:"Only pings newer than this (e.g. 1h, 2d, 1w). Empty = no floor."`
	Peek     bool          `name:"peek" help:"Read without marking as read. Default: listing marks them."`
	Clear    bool          `name:"clear" help:"Mark every unread ping as read without listing them. Mutually exclusive with --peek and --watch."`
	Watch    bool          `short:"w" name:"watch" help:"Keep emitting as new pings arrive; redraws the screen on each tick. Ctrl+C to exit."`
	Tail     bool          `` /* 142-byte string literal not displayed */
	Interval time.Duration `name:"interval" default:"1s" help:"Poll interval when --watch or --tail is set."`
	Limit    int           `short:"n" default:"50" help:"Max rows to list (0 = unlimited)."`

	Topic    []string      `` /* 198-byte string literal not displayed */
	NoTopic  []string      `name:"no-topic" help:"Unsubscribe from a topic pattern. Repeatable."`
	TopicTTL time.Duration `name:"topic-ttl" default:"15m" help:"How long a subscription lives between refreshes. Capped at 168h."`
	Topics   bool          `` /* 127-byte string literal not displayed */
}

type InfoCmd struct{}

type InitCmd struct {
	Prefix  string `name:"prefix" help:"ID prefix for newly-created issues (only used on first init; ignored if config.yaml already exists)."`
	Stealth bool   `` /* 227-byte string literal not displayed */
}

type KVClearCmd struct {
	Key string `arg:"" help:"Key to delete."`
}

type KVCmd struct {
	Set   KVSetCmd   `cmd:"" help:"Set (or overwrite) a key."`
	Get   KVGetCmd   `cmd:"" help:"Print the value of a key."`
	Clear KVClearCmd `cmd:"" aliases:"rm,delete,unset" help:"Delete a key."`
	List  KVListCmd  `cmd:"" aliases:"ls" help:"List every key=value pair."`
}

type KVGetCmd struct {
	Key string `arg:"" help:"Key."`
}

type KVListCmd struct{}

type KVSetCmd struct {
	Key   string   `arg:"" help:"Key."`
	Value []string `arg:"" required:"" help:"Value (joined with spaces if multiple words)."`
}

type LabelAddCmd struct {
	ID     string   `arg:"" help:"Issue ID."`
	Labels []string `arg:"" required:"" help:"Label(s) to add."`
}

type LabelCmd struct {
	Add       LabelAddCmd       `cmd:"" help:"Add labels to an issue."`
	Rm        LabelRmCmd        `cmd:"" aliases:"remove" help:"Remove labels from an issue."`
	Ls        LabelLsCmd        `cmd:"" aliases:"list" help:"List labels on an issue."`
	Propagate LabelPropagateCmd `` /* 139-byte string literal not displayed */
}

type LabelLsCmd struct {
	ID string `arg:"" help:"Issue ID."`
}

type LabelPropagateCmd struct {
	Parent string   `arg:"" name:"parent" help:"Parent issue ID."`
	Labels []string `arg:"" required:"" name:"label" help:"Label(s) to propagate."`
	Deep   bool     `name:"deep" aliases:"recursive" help:"Propagate to every transitive descendant, not just direct children."`
}

type LabelRmCmd struct {
	ID     string   `arg:"" help:"Issue ID."`
	Labels []string `arg:"" required:"" help:"Label(s) to remove."`
}

type LinkCmd struct {
	Child  string `arg:"" help:"Child issue (the one that depends)."`
	Parent string `arg:"" help:"Parent issue (the blocker)."`
}

type ListCmd struct {
	Limit         int           `short:"n" default:"50" help:"Limit results (0 = unlimited)."`
	Watch         bool          `short:"w" name:"watch" help:"Keep updating the list when matching issues change. Ctrl+C to exit."`
	WatchInterval time.Duration `name:"interval" default:"1s" help:"Poll interval when --watch is set."`
	Heartbeat     bool          `name:"heartbeat" help:"While watching, register -a <name> as a live agent in 'clu agent ls'. Requires -a. Off by default."`
	// contains filtered or unexported fields
}

type LockCmd struct {
	Name        string        `arg:"" required:"" help:"Lock name (e.g. deploy, build, test-db)."`
	Cmd         []string      `arg:"" optional:"" passthrough:"" help:"Optional command to run while holding the lock. Pass after '--'."`
	Agent       string        `short:"a" name:"agent" default:"${user}" help:"Holder identity (defaults to $USER)."`
	TTL         time.Duration `name:"ttl" default:"5m" help:"How long the lock lives if not explicitly released. Crashed holders auto-expire after this."`
	Wait        bool          `name:"wait" help:"Block until the lock becomes free, then acquire."`
	WaitTimeout time.Duration `name:"wait-timeout" default:"0" help:"Give up waiting after this (0 = forever). Only meaningful with --wait."`
	Interval    time.Duration `name:"interval" default:"500ms" help:"Poll interval when --wait is set."`
}

type LocksCmd struct{}

type LogCmd struct {
	Actor string `name:"actor" help:"Only events by this actor."`
	Kind  string `name:"kind" help:"Only events of this kind (created, claimed, closed, …)."`
	Issue string `name:"issue" help:"Only events for this issue ID."`
	Since string `name:"since" help:"Only events newer than this ago (e.g. 24h, 7d, 2w)."`
	Limit int    `name:"limit" default:"50" help:"Max events to show."`
}

type NoteAppendCmd struct {
	ID   string   `arg:"" help:"Issue ID."`
	Text []string `arg:"" required:"" help:"Note text to append."`
}

type NoteClearCmd struct {
	ID string `arg:"" help:"Issue ID."`
}

type NoteCmd struct {
	Set    NoteSetCmd    `cmd:"" help:"Replace an issue's notes."`
	Append NoteAppendCmd `cmd:"" aliases:"add" help:"Append a note to the existing notes."`
	Clear  NoteClearCmd  `cmd:"" help:"Clear an issue's notes."`
	Show   NoteShowCmd   `cmd:"" aliases:"get" help:"Print the current notes."`
}

type NoteSetCmd struct {
	ID   string   `arg:"" help:"Issue ID."`
	Text []string `arg:"" required:"" help:"Note text."`
}

type NoteShowCmd struct {
	ID string `arg:"" help:"Issue ID."`
}

type PingCmd struct {
	Recipient string        `arg:"" name:"recipient" help:"Agent name or topic. Direct delivery + fan-out to matching --topic subscribers."`
	Body      []string      `arg:"" optional:"" help:"Message body. Use '-' or omit (with piped stdin) to read from stdin."`
	Agent     string        `short:"a" name:"agent" default:"${user}" help:"Sender identity (defaults to $USER)."`
	TTL       time.Duration `` /* 138-byte string literal not displayed */
}

type PriorityCmd struct {
	ID    string `arg:"" help:"Issue ID."`
	Level int    `arg:"" help:"New priority (0=highest)."`
}

type ReadyCmd struct {
	Limit     int           `short:"n" name:"limit" default:"20" help:"Limit results (0 = unlimited)."`
	Agent     string        `short:"a" help:"Lane to query (default: unassigned)."`
	Wait      bool          `help:"Block until at least one issue is ready, then print and exit."`
	Watch     bool          `short:"w" name:"watch" help:"Keep emitting the ready list as it changes. Ctrl+C to exit."`
	Interval  time.Duration `default:"250ms" help:"Poll interval when --wait or --watch is set."`
	Heartbeat bool          `name:"heartbeat" help:"While waiting/watching, register -a's name as a live agent."`
}

type ReopenCmd struct {
	IDs []string `arg:"" required:"" name:"id" help:"One or more issue IDs to reopen."`
}

type RunCmd struct {
	Template string   `arg:"" help:"Template name (in .clu/templates/) or path to a .yaml file."`
	Var      []string `short:"v" name:"var" placeholder:"KEY=VALUE" help:"Variable bindings (repeatable)."`
	DryRun   bool     `name:"dry-run" help:"Validate and print the plan without writing to the DB."`
	NoPrompt bool     `name:"no-prompt" help:"Don't prompt for missing required vars; fail instead. Default: prompt when stdin is a TTY."`
}

type ShowCmd struct {
	ID      string `arg:"" help:"Issue ID."`
	Context bool   `name:"context" help:"Also print the upstream dependency chain (descriptions, notes, comments) leading up to this issue."`
	Depth   int    `name:"context-depth" help:"Cap how far up the dependency chain --context walks (0 = unlimited)."`
}

type SqlCmd struct {
	Query string `arg:"" optional:"" help:"SQL query. Use '-' to read from stdin, or pass --file."`
	Write bool   `name:"write" help:"Allow non-SELECT statements (UPDATE/DELETE/INSERT/DDL). Default refuses anything other than read queries."`
	File  string `name:"file" short:"f" help:"Read the query from this file instead of the positional arg."`
	CSV   bool   `name:"csv" help:"Emit CSV (with header) instead of a pretty table. Mutually exclusive with --json."`
}

type StatsCmd struct{}

type StatusesCmd struct{}

type SyncCmd struct {
	Push   SyncPushCmd   `cmd:"" help:"Serialize the DB onto refs/clu/store (and optionally push it)."`
	Pull   SyncPullCmd   `cmd:"" help:"Reconcile refs/clu/store back into the DB (LWW + tombstones)."`
	Status SyncStatusCmd `cmd:"" help:"Show the synced ref and how it compares to the local DB."`
	Flush  SyncFlushCmd  `cmd:"" help:"pull then push — the full round-trip (beads-rs 'sync')."`
}

type SyncFlushCmd struct {
	Remote string `name:"remote" help:"Fetch before / push after against this remote."`
}

type SyncPullCmd struct {
	Remote string `name:"remote" help:"Fetch refs/clu/store from this remote first (force; the DB is the real local state)."`
}

type SyncPushCmd struct {
	Remote  string `name:"remote" help:"Also push refs/clu/store to this git remote (e.g. origin)."`
	Message string `name:"message" short:"m" help:"Commit subject for the ref commit." default:"clu sync"`
}

type SyncStatusCmd struct{}

type TagCmd struct {
	ID     string   `arg:"" help:"Issue ID."`
	Labels []string `arg:"" required:"" help:"Label(s) to add."`
}

type TemplateCmd struct {
	Ls       TemplateLsCmd       `cmd:"" aliases:"list" help:"List available templates."`
	Show     TemplateShowCmd     `cmd:"" help:"Print one template as parsed YAML."`
	Validate TemplateValidateCmd `cmd:"" help:"Validate a template's structure."`
}

type TemplateLsCmd struct{}

type TemplateShowCmd struct {
	Name string `arg:"" help:"Template name (in .clu/templates/) or path to a .yaml file."`
}

type TemplateValidateCmd struct {
	Name string `arg:"" help:"Template name (in .clu/templates/) or path to a .yaml file."`
}

type TypesCmd struct{}

type UndeferCmd struct {
	IDs []string `arg:"" required:"" name:"id" help:"One or more issue IDs to undefer."`
}

type UnlockCmd struct {
	Name  string `arg:"" required:"" help:"Lock name to release."`
	Agent string `` /* 140-byte string literal not displayed */
	Force bool   `name:"force" help:"Release the lock even if held by another holder. Use to clear a stuck lock after a crash."`
}

type UpdateCmd struct {
	ID            string  `arg:"" help:"Issue ID."`
	Priority      *int    `short:"p" help:"New priority (0=highest)."`
	Status        *string `help:"New status."`
	Assignee      *string `short:"a" name:"assignee" help:"Set assignee. The 'agent lane' is just the assignee on an open issue."`
	Unassign      bool    `help:"Clear assignee."`
	Title         *string `help:"New title."`
	Description   *string `help:"Set description."`
	NoDescription bool    `name:"no-description" help:"Clear description."`
}

type VersionCmd struct{}

type WebCmd struct {
	APIPort   int    `name:"api-port" default:"7777" help:"Port for the REST API. 0 picks a free port."`
	WebPort   int    `` /* 156-byte string literal not displayed */
	Bind      string `name:"bind" default:"127.0.0.1" help:"Interface to bind both servers."`
	Dev       bool   `name:"dev" help:"Use 'pnpm dev' (HMR) instead of the built output. Default tries built output first, falls back to dev."`
	NoBrowser bool   `name:"no-browser" help:"Don't try to open a browser window."`
	WebDir    string `` /* 135-byte string literal not displayed */
	Install   bool   `` /* 193-byte string literal not displayed */
}

type WorktreeAddCmd struct {
	Path      string `arg:"" help:"Path to create the worktree at (relative or absolute)."`
	Ref       string `arg:"" optional:"" help:"Branch or commit-ish to check out (default: current HEAD)."`
	Branch    string `name:"branch" short:"b" help:"Create a new branch at <ref> for this worktree (passes -b to git worktree add)."`
	Bootstrap bool   `name:"bootstrap" help:"After creating the worktree, run config.yaml's worktree.copy + worktree.commands."`
}

type WorktreeBootstrapCmd struct {
	Path string `arg:"" help:"Path of the worktree to bootstrap. Must be a git worktree."`
}

type WorktreeCmd struct {
	Add       WorktreeAddCmd       `cmd:"" help:"Create a new git worktree (and optionally run the bootstrap recipe)."`
	Bootstrap WorktreeBootstrapCmd `cmd:"" help:"Run the worktree.copy + worktree.commands recipe against an existing worktree."`
	Remove    WorktreeRemoveCmd    `cmd:"" aliases:"rm" help:"Remove a git worktree after checking for uncommitted/unpushed work."`
}

type WorktreeRemoveCmd struct {
	Path  string `arg:"" help:"Path of the worktree to remove."`
	Force bool   `name:"force" short:"f" help:"Skip the safety checks and pass --force to git worktree remove."`
}