You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix(skills): valid YAML enums and stored note_type casing in schema examples
Two Codex review fixes in memory-onboarding's schema guide:
- Quote enum field values in the Picoschema YAML example — an unquoted
flow list with a trailing description is not valid YAML, so copying
the block produced schema notes that fail to parse.
- Use the stored lower-case note type in schema_validate/schema_diff/
schema_infer examples: the live API matches Entity.note_type exactly,
so note_type="Task" would find none of the seed notes written with
note_type="task".
Signed-off-by: Cody Faust <cody@luminarysol.com>
Copy file name to clipboardExpand all lines: skills/memory-onboarding/references/schema-guide.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -68,9 +68,9 @@ Schemas are notes (conventionally in a `Schemas/` folder) whose frontmatter meta
68
68
69
69
```yaml
70
70
schema:
71
-
status(enum): [open, in-progress, blocked, done], current state
71
+
status(enum): "[open, in-progress, blocked, done], current state"
72
72
due?: string, due date if any (Month D, YYYY)
73
-
priority?(enum): [low, medium, high], urgency
73
+
priority?(enum): "[low, medium, high], urgency"
74
74
project?: Project, parent project note
75
75
steps?(array): string, ordered sub-steps
76
76
```
@@ -120,9 +120,9 @@ Key points:
120
120
121
121
## Validation & drift
122
122
123
-
- `schema_validate(note_type="Task")`— check all notes of a type; also works on a single note. Reports missing required fields, unknown fields, type mismatches, invalid enum values.
124
-
- `schema_diff(note_type="Task")` — finds drift: fields notes use that the schema doesn't define (candidates to add as optional), and schema fields nobody uses (candidates to drop).
125
-
- `schema_infer(note_type="Task")`— when notes of a type already exist without a schema, infer one from their actual structure instead of designing from scratch.
123
+
- `schema_validate(note_type="task")`— check all notes of a type; also works on a single note. Reports missing required fields, unknown fields, type mismatches, invalid enum values.
124
+
- `schema_diff(note_type="task")` — finds drift: fields notes use that the schema doesn't define (candidates to add as optional), and schema fields nobody uses (candidates to drop).
125
+
- `schema_infer(note_type="task")`— when notes of a type already exist without a schema, infer one from their actual structure instead of designing from scratch.
126
126
127
127
Evolution loop: `schema_diff`→ edit the schema note (append changelog row, bump version if breaking) → `schema_validate` → fix outliers. Suggest the user run this monthly-ish once the system has real volume.
0 commit comments