heddle discuss

A discussion is a multi-author conversation anchored to a (file, symbol) pair on a specific state. It is how reviewers and agents ask each other questions inside the code without going to a separate review tool.

open takes three positionals: . Optional flags anchor and scope it: --state (defaults to HEAD), --visibility, --thread. append adds a turn.

resolve requires --mode, and there are exactly two modes: by-edit (resolved by a code change, at --state, defaulting to HEAD) and dismiss (closed without action, requiring a non-empty --reason). Any other value exits 64. A resolution that turned out to be wrong is reopened with discuss reopen --reason.

list filters by --state, --file, --symbol or --status; show prints one discussion with its turns. Orphaned discussions are ones whose target symbol no longer exists at the anchor state.

Like context annotations, discussions are a native Heddle feature and are not projected into Git.

Examples

Open a discussion on a function

bash$ heddle discuss open src/auth/mod.rs "fn authorize" "should this short-circuit on scope mismatch?"

Resolve it, by edit or by dismissal

bash$ heddle discuss resolve dsc-2qpsr7 --mode by-edit --state hd-d01a8b4e7m9k$ heddle discuss resolve dsc-2qpsr7 --mode dismiss --reason "superseded by the scope rewrite"

See also

• heddle context
• heddle review

Subcommands

• discuss open Open a new discussion anchored to a (file, symbol)
• discuss append Append a turn to an existing discussion
• discuss resolve Resolve a discussion via --mode (by-edit | dismiss)
• discuss reopen Reopen a resolved discussion
• discuss list List discussions filtered by state, symbol, or status
• discuss show Show a single discussion with its turns