docs(m3): reconcile the remaining docs with the settled design

Docs written before this thread still carried the three-source copy model and
the Call 2 fields it implied.

- REQUIREMENTS.md REVIEW-10: title and short description are deterministic; the
  description comes from the model or the server.
- CREATE.md: primary category declared before Call 2; deterministic copy; the
  prompt revision interface; the slug; auth row in out-of-scope.
- API.md: infer-content inputs and result are the long description only.
- UAT-PRACTICE.md: the walk no longer tells the owner to leave copy for
  templates.
- README.md: the deploy section duplicated docs/DEPLOYMENT.md and
  deploy/INVENTORY.md; it now points at them.
- DEPLOYMENT.md: the prompt seed is stated per METADATA-105.

Both gates pass.
This commit is contained in:
2026-09-19 12:38:39 -07:00
parent 35848fe0e6
commit 5a210c47b0
6 changed files with 44 additions and 39 deletions
+7 -4
View File
@@ -137,16 +137,19 @@ taxonomy, and the user metadata. Returns `202`; the client polls. A failure or t
runtime failure rule (recoverable offers Retry, unrecoverable explains).
### `POST /api/v1/slabs/{id}/infer-content`
Runs Call 2 on user action only. Fresh request carrying the full Call 1 context; no provider
thread id. Requires `test-inference` `ok`. Returns `202`; the client polls. The model writes prose
only and never touches dimensions.
Runs Call 2 on user action only. Fresh request carrying the processed photos, the review-confirmed
metadata, the primary and secondary wood categories, the parent-category path, the dimension fact
block, and brand/geo context; no provider thread id and no raw Call 1 result. Requires
`test-inference` `ok`. Returns `202`; the client polls. The model writes the long description only
and never touches dimensions.
Call 1 result fields: `species_id`, `species_confidence`, `wood_category_ids`,
`edge_type_term_id`, `figure_term_ids`, `figure_confidence`, `grade_term_id`, `grade_confidence`,
`character`, `inclusions`, `voids`, `checks`. Free-text observations map to synced `feat-*` tags
only.
Call 2 result fields: `title`, `short_description`, `description`.
Call 2 result field: `description`. The name and short description are assembled by the server from
the primary wood category's patterns, not returned by the call.
## 7. Publish