AGENTS · CONTRACT

Integration contract

Input contract

A query contains one or more atoms with optional POS tags. Paths, encoding, boundary, and expansion remain execution options outside the query text.

Record the actual arguments after shell quoting. A natural-language description alone cannot reproduce the query.

Output contract

A match span uses source coordinates, and each atom preserves its core, token, and every origin. rulePath identifies candidate-generation rules, not semantic labels.

Identify a result by its path and span, not its JSON Lines order. Completion order across files can vary with parallel execution settings.

Failure contract

Compile errors, missing required resources, decode failures, and I/O failures appear on stderr with a failure status. Keep them distinct from a normal no-match result.

An I/O failure can occur after partial output. Accept stdout as complete only after checking the final exit status.