Oko/Docs

Invocation#

Command

oko requirements submit --session S FILE|- [--json]

Inputs and options#

Oko runs no model for the reading and asks no other product: the judgment of a window is the agent session's that takes it, the model that session already runs on.
FILE (or - for standard input) holds {windows: [{window, summary, items, accounting, resolutions}]} in the shape take prints: each item with key, kind (requirement, standard, rule, preference, correction, complaint, failure, noticed or promise), statement, product, quotes [{index, text}], consent, the defect terms (title, impact, repair, criterion) a correction, complaint, failure or noticed item needs, and same (a held requirement it states again) with changed.

Every quote must stand verbatim, white space aside, in the message whose index it names, in the window or the agent's text that opens it; his items need his words or the agent's proposal with his consent, the agent's need the agent's words or what its tools showed. An item with a quote that does not stand is refused, kept beside the accepted ones with why. Every message of his the window lists needs an item or a reason; a reading that leaves one out is refused whole, naming the message and why each item was refused, and the window waits for its session to submit again.
A kept reading records the session that wrote it; coverage and status say who read what. His corrections, complaints and reported failures become Oko defects when kept; a problem the agent noticed becomes one once a later window of its transcript was read without resolving it. A statement naming a held requirement joins it, the latest wording standing where it changes it; a requirement he stated again is a defect, each later statement noted on it as a recurrence. Prints session, accepted ({window, items, refused, refusedResolutions, resolutions}), refused ({window, why}), defectsRecorded, requirements and merged.

`oko requirements submit: the file is not the shape take hands (<cause>); the shape is <shape>` and `oko requirements submit: no window of the file was kept: <window>: <why>; …` exit 1; a window id nobody handed, a window another session already read, and a window whose words changed since it was taken are refused by name. A missing file is `oko requirements submit requires the file the session wrote, or - to read it from standard input` and a second one `oko requirements submit reads one file; it was also given <word>, which it would not read` (exit 2).