Repository navigation
Commit a4e6f8c
docs(authoring): the jsonb ladder's vectorScores example had the wrong rung
The worked example taught
{ "field.map": { "name": "vectorScores", "@valueType": "double" } } // writer: dict[str, float]
against a real, named field whose writer is a LIST, not a map:
`vector_scores: list[float] | None` on both the recorder and the mapper
signature, constructed as `[r.score for r in final[:10]] or None`. Nothing
anywhere declares it dict-shaped — the only `dict` in reach is a defensive
`isinstance(x, (dict, list))` in a debug dumper.
That is the worst kind of error in this particular block. The ladder's whole
claim is "the test is mechanical: read the signature of the function that
WRITES the column" — and then it demonstrated the method on a field whose
signature says something else. Following it declares `Record<string, number>`
where the writer sends `number[]`: a contract the writers do not honor, which
is the exact failure the section warns about two paragraphs earlier.
Moves `vectorScores` to the isArray rung where it belongs, and gives the
scalar-valued-map rung an example that is genuinely a dict of scalars
(path -> file content). The `@objectRef` map example was checked and is
correct — `preferences` really is `dict[str, Preference]` over a generated
value object, so it stays.
Found by using the ladder to classify an estate rather than by reading it.
Corpus regenerated in the same commit, as before.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NTcEKXTQMYt84fAjuw5A2M1 parent d27c73a commit a4e6f8c
6 files changed
Lines changed: 12 additions & 6 deletions
File tree
- agent-context/skills/metaobjects-authoring
- fixtures/agent-context-conformance
- java-kotlin-react-tanstack/expected/.claude/skills/metaobjects-authoring
- java-react/expected/.claude/skills/metaobjects-authoring
- python/expected/.claude/skills/metaobjects-authoring
- ts-react-tanstack/expected/.claude/skills/metaobjects-authoring
- ts-requirements/expected/.claude/skills/metaobjects-authoring
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
558 | 558 | | |
559 | 559 | | |
560 | 560 | | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | | - | |
| 564 | + | |
564 | 565 | | |
565 | 566 | | |
566 | 567 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
558 | 558 | | |
559 | 559 | | |
560 | 560 | | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | | - | |
| 564 | + | |
564 | 565 | | |
565 | 566 | | |
566 | 567 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
558 | 558 | | |
559 | 559 | | |
560 | 560 | | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | | - | |
| 564 | + | |
564 | 565 | | |
565 | 566 | | |
566 | 567 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
558 | 558 | | |
559 | 559 | | |
560 | 560 | | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | | - | |
| 564 | + | |
564 | 565 | | |
565 | 566 | | |
566 | 567 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
558 | 558 | | |
559 | 559 | | |
560 | 560 | | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | | - | |
| 564 | + | |
564 | 565 | | |
565 | 566 | | |
566 | 567 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
558 | 558 | | |
559 | 559 | | |
560 | 560 | | |
| 561 | + | |
561 | 562 | | |
562 | 563 | | |
563 | | - | |
| 564 | + | |
564 | 565 | | |
565 | 566 | | |
566 | 567 | | |
| |||
0 commit comments