Troubleshoot 5

[granawkins]

No description provided.

[mentatai]

The changes are mostly about version bumping and detailed documentation and commentary added to clarify validation processes, particularly around issues with invalid parent chunk handling. Keep ensuring code readability and maintainability when adding elaborate comments.

Butler is in closed beta. Reply with feedback or to ask Butler to review other parts of the PR. Please give feedback with emoji reacts.

[mentatai]

When using multiline comments in Python, it's best to handle them as triple-quoted strings for better readability and maintainability.

Suggested change

	"""
	"""
	The LLM sometimes returns invalid parents (i.e. path/to/file.ext:parent.chunk).
	There are 3 cases why they might be invalid:
	A) The LLM made a typo here. In that case, return False to try again.
	B) The LLM made a typo when parsing the parent in a previous batch. In that case,
	go back and redo the previous batch. We distinguish this from case A) by checking
	if multiple chunks reference the same invalid parent.
	C) An edge case where our schema breaks down, e.g. Javascript event handlers
	usually try to set "document" as their parent, but that won't be a node.
	Case A) should be resolved by Spice's validator loop, i.e. this function returning
	"False". For Case B), raise a special exception and step back one batch in the
	chunk_document loop. Any chunks still referencing invalid parents after these two
	loops are exhausted (including case C)) will just be accepted and linked to
	path/to/file.ext:BASE.
	"""