debug-stream

name	debug-stream
description	Debug Arizona stream operations. Use when investigating stream insert/delete/update/move/sort/reset behavior.
argument-hint	["handler_module"]
allowed-tools	Read, Grep, Glob

Debug stream operations in $ARGUMENTS.

1. Stream setup

Find how the stream is created in mount/1:

• Key function used in arizona_stream:new/1,2,3
• Initial items and order
• Limit and on_limit options

2. Template binding

Find the ?each(Fun, Source) call in render/1:

• How items are mapped to dynamics
• Template structure for each item (statics, dynamics)

3. Mutations

Find handle_event/3 clauses that modify the stream:

• Which arizona_stream functions are called (insert, delete, update, move, sort, reset)
• What pending ops each mutation generates
• How clear_stream_pending/2 is called after diff

4. Diff path

Trace how arizona_diff:diff_stream/4 processes pending ops:

• Queue processing order
• Op generation: OP_INSERT, OP_REMOVE, OP_ITEM_PATCH, OP_MOVE
• Limit reconciliation via apply_limit/5
• Reorder via LIS algorithm (compute_reorder_ops)

Reference files:

• Stream data structure: src/arizona_stream.erl
• Stream eval: src/arizona_eval.erl (render_stream_item, eval_stream_items)
• Stream diff: src/arizona_diff.erl (diff_stream, diff_stream_pending, diff_stream_op)