bug-report

Bug Report

Collect runtime state from the current waved test session and file a structured GitHub issue against this repository.

Body discipline (read before collecting anything)

The point of this skill is to give the team a report they can act on in under a minute, not a dump of everything the daemon knows. Target the final issue body at ≤ 5 KB / ~100 lines. If a section is bigger than the failure it's documenting, trim it.

Concrete rules:

• The body leads with what failed and why (Summary + Failure sequence), not with environment metadata.
• The "Failure sequence" is a curated excerpt of the log — the 5–10 lines that actually trace the bug. Strip routine state-machine ticks, polling loops, and unrelated subsystems.
• The full session log goes in a gist, not in the body (see step 8a). The body links to it. If gist upload fails, note the local log path and stop — do not paste hundreds of lines inline.
• Wallet state: only the failing entry's relevant fields. Do not paste the whole list JSON.
• Environment: platform + arch + go version + daemon commit + network
  • wallet backend. Not the full uname -srvm, not PID, not IPv6 address unless the bug is network-layer.
• Reproduction steps: write the actual steps that produced the bug. If the only honest thing you can write is a TODO, ask the user before filing.
• Cut secondary observations into separate issues. One issue, one bug.

Steps

1. Get the description

If the user provided an argument, use it as the issue title. If not, ask for one sentence describing what went wrong before collecting anything.

2. Detect the active network and chain backend

Do not assume a network (mainnet/testnet/signet/regtest/simnet) or a chain backend (lwwallet+Esplora / btcwallet+neutrino / lnd). Detect both from config first, then cross-check against the most recent daemon log.

CONF=~/.waved/waved.conf

# Helper: read a key from the conf file (uncommented), strip whitespace and
# surrounding quotes. Returns empty if missing.
conf_get() {
  grep -E "^[[:space:]]*$1[[:space:]]*=" "$CONF" 2>/dev/null \
    | tail -1 | cut -d= -f2- \
    | sed -E 's/^[[:space:]]+//; s/[[:space:]]+$//; s/^"(.*)"$/\1/'
}

# Config-derived values. Defaults match waved/config.go:
#   network defaults to mainnet, wallet.type defaults to lwwallet.
NETWORK=$(conf_get network)
NETWORK=${NETWORK:-mainnet}
WALLET_TYPE=$(conf_get wallet.type)
WALLET_TYPE=${WALLET_TYPE:-lwwallet}

# Cross-check against the actual log directory tree. If the config-derived
# network has no log file but another network's log does, prefer the
# directory that has a recent log — the operator may have switched
# networks without updating the conf, or the conf may be elsewhere.
LOG_ROOT=~/.waved/logs
LOG="$LOG_ROOT/$NETWORK/waved.log"
if [ ! -f "$LOG" ]; then
  ALT=$(ls -t "$LOG_ROOT"/*/waved.log 2>/dev/null | head -1)
  if [ -n "$ALT" ]; then
    LOG="$ALT"
    # Re-derive network from the directory name so the report is
    # consistent with the log we actually read.
    NETWORK=$(basename "$(dirname "$ALT")")
  fi
fi