heddle discuss

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

open takes three positionals: . Optional flags: --state (anchor state, defaults to HEAD), --visibility (public/internal/team:NAME/restricted:LABEL), --thread (group with a thread). append adds a turn.

resolve requires --mode — one of into-annotation (convert the conclusion into a context annotation; requires --annotation-kind, --annotation-content, optional --annotation-tags), by-edit (resolved by code change at --state), or dismiss (closed without action; requires --reason).

list filters discussions by --state, --file, --symbol, or --status (open/resolved/all/orphaned; default all). show prints one discussion with its turns. Orphaned discussions are ones whose target symbol no longer exists at the anchor state.

Examples

Open a discussion on a function

bash$ heddle discuss open src/auth/mod.rs "fn authorize" "should this short-circuit on scope mismatch?"discussion dsc-2qpsr7  anchor: src/auth/mod.rs:fn authorize  state: hd-d01a8b4e  visibility: internal  status: open

Resolve by converting the conclusion into a rationale

bash$ heddle discuss resolve dsc-2qpsr7 --mode into-annotation --annotation-kind rationale --annotation-content "scope before role; documented for the next agent"discussion dsc-2qpsr7  status: resolved_into_annotation

See also

• heddle review
• heddle context

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 (into-annotation | by-edit | dismiss)
• discuss list List discussions filtered by state, symbol, or status
• discuss show Show a single discussion with its turns