docs(#10): UX interaction spec plus remaining POC issue write-back

UAT is POC, so #10 is in DOC COMPLETE. Capture knobs live on-screen, review
confidence presentation, 409/422 field recovery, taxonomy cache, portable
Call 1→Call 2, shared validation. U2Net Try harder deferred, not deleted.
This commit is contained in:
2026-09-02 00:30:47 +00:00
parent 3921a9dfa2
commit 7b7ed712c2
10 changed files with 329 additions and 79 deletions
+7 -2
View File
@@ -85,8 +85,9 @@ Return valid JSON matching this schema:
```
### Notes
- The taxonomy list (species, edge type, figure, grade) is pulled from the
synced Woo cache each time, so the options always match what's in the store.
- The taxonomy list (species, wood categories, edge type, figure, grade, feat-*) is
pulled from the **synced Woo cache only**. No hardcoded mill species list. A term
not in the cache cannot be suggested or selected.
- Brief definitions help the model distinguish ambiguous cases
(e.g., "quarter-sawn" vs "cathedral").
- Character/inclusions/voids/checks are free-text observations. The server
@@ -175,6 +176,10 @@ dimensions as measured. {geo_sentence}`
- No numeric-accuracy guardrail needed — dimensions never pass through the LLM.
- If `content_llm_enabled` is false, the LLM call is skipped and templates
are used with a generic description paragraph.
- **Portable Call 1 context (issue #2):** default is full resend of Call 1 (user
prompt + assistant JSON). Label each taxonomy value **confirmed** (user-edited)
vs **inferred** (still from Call 1). Stateful `previous_response_id` is opt-in
after `test-inference`. Fail closed if neither path works.
---