From 0aa5205228f83141189fcf67cb538976dcface60 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 8 Oct 2026 05:49:59 +0000 Subject: [PATCH] docs(skills): objectstack-data says what `os migrate meta --from 16` does Two published lines said the chain "strips" the retired index keys `type` and `partial` ("automatically" in rules/indexing.md). The default run writes no authored source file (the `write` flag defaults to false) and `--write` rewrites only the sites it can trace to one literal in one project file, so both lines over-promised. They now carry the house sentence: the run lists the mechanical edits, `--write` applies the ones it can prove, and the rest is applied by hand. SKILL.md sits at its token ceiling, so the longer sentence is paid by deleting the clause "Access methods and partial predicates are database-layer migrations", which the same section restates two paragraphs below ("how to build partial / gin / gist indexes at the database layer"). Co-authored-by: Claude Claude-Session: https://claude.ai/code/session_01CXydFDyiQwNbGFkmwrcRQq --- skills/objectstack-data/SKILL.md | 4 ++-- skills/objectstack-data/rules/indexing.md | 5 +++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/skills/objectstack-data/SKILL.md b/skills/objectstack-data/SKILL.md index 2d2bd842280..7220a34363d 100644 --- a/skills/objectstack-data/SKILL.md +++ b/skills/objectstack-data/SKILL.md @@ -374,8 +374,8 @@ indexes: [ > **`type` and `partial` were retired at protocol 17**: no driver > ever read either, so an authored `type` chose no access method and an authored > `partial` produced a full index with the predicate discarded. Both are now a -> `tsc` error and a parse error; `os migrate meta --from 16` strips them. Access -> methods and partial predicates are database-layer migrations. +> `tsc` error and a parse error; `os migrate meta --from 16` lists the edits; +> `--write` applies the ones it can prove, the rest by hand. > **A unique index must state its scope** — `'organization'` (one holder per > organization, NULL-safe) or `'global'` (one holder across the installation). diff --git a/skills/objectstack-data/rules/indexing.md b/skills/objectstack-data/rules/indexing.md index 1e02314ba24..72b02e1e098 100644 --- a/skills/objectstack-data/rules/indexing.md +++ b/skills/objectstack-data/rules/indexing.md @@ -28,8 +28,9 @@ and it is the whole surface *because* it is all the driver materializes: > selected no access method, and an authored `partial` produced a **full** > index with the predicate silently discarded. Writing either is now a `tsc` > error and a parse error carrying the migration prescription; run -> `os migrate meta --from 16` to strip them automatically. What to do instead -> is the subject of "Access methods and partial indexes" below. +> `os migrate meta --from 16` to list the mechanical edits; `--write` applies +> the ones it can prove, and you apply the rest by hand. What to do instead is +> the subject of "Access methods and partial indexes" below. ## Syntax