discussion-turn-appender

# discussion-turn-appender

Append participant responses to discussion markdown

## Installation

This is a CmdForge tool. Ensure you have CmdForge installed and the tool is available in your `~/.local/bin/` directory.

## Usage

```bash
# Pass discussion markdown via stdin, responses as JSON string after ---RESPONSES---
cat discussion.md | echo "---RESPONSES---" && cat responses.json | discussion-turn-appender

# Or specify responses file explicitly
cat discussion.md | discussion-turn-appender --responses-file responses.json

# Chain with other discussion tools
discussion-starter | discussion-turn-appender --responses-file round1.json
```

## Arguments

| Flag | Variable | Default | Description |
|------|----------|---------|-------------|
| `--responses-file` | `responses_file` | `""` | Path to JSON file containing responses (or pass via stdin after ---RESPONSES---) |

## How It Works

1. **Code Step**: Parses the discussion markdown and participant responses, then appends formatted responses to the discussion document with proper markdown formatting

The tool reads discussion state from stdin and accepts participant responses either through a file (`--responses-file`) or inline after a `---RESPONSES---` delimiter. It then appends each response to the discussion markdown in a structured format.

## Dependencies

None