Skills optimization flight — skills/objectstack-ui: RESTRUCTURE (≈ −9,170 tok, −25%) — a 25.4k-token single entry file, dashboards taught in two sections 640 lines apart, a generated contract shipped twice, and the canonical dashboard example teaching two retired widget keys

[os-litant]

Member card of the skills catalog optimization program #14292 (maintainer mandate 2026-09-02, verbatim: 「审核所有的 skills，进行全面的优化。」). Filed by the skills lane seat (session session_01LraLgQVGq8egUwfYZpbYt1). Read-only audit at objectstack origin/main a59f78d. The full findings table is the audit record: the dev posts it verbatim as the first comment on this card at claim time (seat scratchpad audit/objectstack-ui/findings.md).

Audit summary

skills/objectstack-ui/ = 36,542 tokens, 19.5% of the shipped bundle; SKILL.md alone 25,441 — 1.75× the next-largest authored file and 1.83× objectstack-data's entry file, which covers a comparable surface with 8 rules/ files. Generated: contracts/react-blocks.contract.json 5,352 · references/react-blocks.md 3,153 · references/_index.md 1,205. Real usage (= define<X>({): defineAction 34 · definePage 29 · defineView 10 · defineReport 9 · defineDataset 6 · Dashboard literals 5 · App.create 3 · defineCube 1; page tiers structured 12 / html 3 / react 3 / slotted 1; view types grid 25 / simple 10 / kanban 4. Verdict RESTRUCTURE: single 25k entry file with no rules/; dashboards documented at :654-796 and :1437-1658; dateGranularity content filed under ### Drilldown; one generated contract shipped in two renderings.

Top findings (token-delta × confidence)

id	span	proposal	Δ
UI-B-04	contracts/react-blocks.contract.json + references/react-blocks.md	DELETE one rendering — identical blocks, the .json has no consumer repo-wide	−5,352 (DEFERRED, #14296 item 3)
UI-D-01	SKILL.md:346-462	REWRITE-AS-CONSTRUCT — searchableFields, 1,381 tok, 0 real view usages	−900
UI-C-01	:1659-1768	MERGE-INTO objectstack-query/rules/filters.md:221-247 (query is the schema owner)	−800
UI-D-02	:528-577	RETIRE — timeSegments, 0 usages, self-declared non-spec	−583
UI-C-04	:73-126	MERGE-INTO objectstack-data/rules/relationships.md (the text already routes there at :82)	−400
UI-C-02	:1955-1981	DELETE — action ctx org/positions narration; :1979 already points at the hooks reference	−342
UI-D-05	:1626-1640	DELETE — documents a renderer block, then says dataset-bound dashboards ignore it	−215
UI-F-01	:750	ADD filterBindings construct (paid by D-05 + D-06) — 24 real usages, a documented silent-zero bug, the package's own eval asserts it	+170
UI-D-04	:1354-1362	DELETE metadata-fence rationale	−145
UI-B-06	:35-47	DELETE — restates the frontmatter	−136
UI-D-06	:1530-1535	DELETE — v17 removal narration	−125
UI-F-02	:1481	ADD widget options query keys (dateGranularity/sortBy/sortOrder/limit)	+120
UI-C-03	:173-189	MERGE-INTO objectstack-data	−120
UI-E-02	:1485	DELETE retired actionType/actionUrl on a widget	−20
UI-B-01	whole package	split into rules/ (DEFERRED, #14296 item 1)	~−15,900 moved

Incidental falsehoods (fix in this flight)

1. SKILL.md:1485 — the canonical dashboard teaches actionType: 'url', actionUrl: '…' on a widget; both are retiredKey(...) = z.never() (packages/spec/src/ui/dashboard.zod.ts:382-384; prescription :309-320 "a dashboard widget has NO action button, and never had one"). Parse error AND tsc error; the sole blocker on the largest ungated example.
2. SKILL.md:1572 — "Date bucketing lives on the dataset dimension, not the widget" — contradicted by dashboard.zod.ts:217-225: options.dateGranularity overrides the dataset dimension's default for this widget.
3. Frontmatter :13-14 — "the React renderer implementation (lives in packages/client-react)": that package is React hooks for the client SDK; the renderer is @object-ui/react-runtime (objectui).

Three funded additions

1. filterBindings construct (+170, paid by UI-D-05 + UI-D-06) — prevents the failure examples/app-showcase/src/ui/dashboards/ops-dashboard.dashboard.ts:30-49 records verbatim (four tiles and a chart read 0 for any selection).
2. Widget options query keys (+120, paid by UI-D-08 + UI-D-03) — dashboard.zod.ts:217-252.
3. os:check marks on the four highest-traffic examples (+10, paid by UI-E-02).

Flight scope

IMPLEMENT (same-file, shrink-only): every DELETE / MERGE-INTO / REWRITE-AS-CONSTRUCT / RETIRE row at HIGH or MED; the three funded additions; falsehoods 1–3; consolidate the two dashboard sections into one place inside SKILL.md (reorder is free); UI-A-02/A-03 routing-text corrections in the frontmatter (regenerate skills/README.md).

ANCHOR RULINGS: date macros / filter tokens — anchor is objectstack-query/rules/filters.md (query lists date-macros.zod.ts as a core schema); this package deletes :1659-1768 and leaves a one-line pointer; if a TRUE row here is missing from query's table, list it in the PR body under "follow-up for objectstack-query" (note: this package's :1706-1708 "unknown placeholders silently pass through" is FALSE — packages/core/src/utils/filter-tokens.ts:44,378 throws UnknownFilterTokenError — delete it, do not port it). Relationships/objects → anchor objectstack-data/rules/relationships.md (UI-C-03/C-04: delete + pointer). Action ctx → anchor objectstack-data/references/data-hooks.md. timeSegments (UI-D-02) → delete (non-spec, 0 usages); the objectui skill is the renderer's home.

DEFER (pending #14296): UI-B-01 split into rules/ (item 1); UI-B-04 generated JSON rendering (item 3 — ⛔ do not touch generated files); UI-H-01 new eval file (item 2).

Flight constraints (binding)

• ONE draft PR, first line Fixes #<this card>; governed ⇒ stays draft; review requests are the seat's step.
• Token ratchet: no ratcheted file may grow; additions paid by deletions in the SAME file; ⛔ re-wrap is not payment; ⛔ no ceiling raise; ⛔ no new files; ⛔ do not touch the ratchet script (this PR deletes no file).
• ⛔ Never edit another package's files: MERGE-INTO another package = DELETE here + one-line pointer; a missing/weaker anchor goes in the PR body under "follow-up for ".
• Generated files untouched (references/_index.md, contracts/*, references/react-blocks.md); frontmatter edits ⇒ regenerate skills/README.md (pnpm --filter @objectstack/spec gen:skill-docs).
• Live surface with zero measured usage ⇒ one row pointing at its schema, never delete the last mention; retired/tombstoned surface ⇒ delete.
• A false claim matching a spec .describe() string ⇒ file the spec-side twin as an out-of-scope card.
• Gates: node scripts/check-skills-token-ratchet.mjs, pnpm --filter @objectstack/spec check:skill-examples, pnpm check:skill-compatibility, pnpm check:skill-identifier-liveness, plus node scripts/pm/dispatch-gates.mjs --commands <changed paths>; record the head sha.
• PR body: per-item 落点 | before | after list keyed by finding id; per-file token delta; needs:contract-review on both carriers (falsehoods 1–2 are contract-semantics corrections).

Refs: #14292 · #14296 · #13658.

[os-litant]

Claim: PM loop round 1
Session: session_01LraLgQVGq8egUwfYZpbYt1
Branch: claude/issue-14298-skills-ui-optimization
Worktree: objectstack-issue-14298
Domain: domain:skills
File surface: skills/objectstack-ui/SKILL.md only (evals deferred; generated files untouched; ⛔ no ratchet-map edit — this flight deletes no file); ⛔ no other package (stop on breach; explain in the report)
Container & model: M (one 25k-token file, judgment-heavy), mode:subagent, model: opus — --tier reports no path-derived mandate; content limb applies (below), compensated by the seat's in-seat review at CONTRACT_REVIEW_TIER
Clause-②: yes — corrects published contract-semantics claims (retired actionType/actionUrl on a widget; options.dateGranularity override; the false "unknown placeholders silently pass through" claim) ⇒ needs:contract-review on both carriers at PR creation
Serial constraints cleared: sibling flights #14297 (data) and #14299 (platform) are on disjoint directories; this flight deletes its date-macro table and points at objectstack-query/rules/filters.md (query is the anchor; the query flight, not yet dispatched, keeps that table) and at objectstack-data/rules/relationships.md (stable path); no in-flight PR touches skills/objectstack-ui/** (open PR list read 2026-09-02T01:1xZ); skills/README.md not regenerated in-flight unless the drift gate demands it

Decision re-read: no maintainer ruling on this card; binding inputs = the mandate, the value gate, the ratchet discipline, and #14296 (items 1 and 3 deferred: no split, no generated-file change).

---

Generated by Claude Code

[os-litant]

Claim: os-dev (dispatched)
Session: session_01LraLgQVGq8egUwfYZpbYt1
Branch: claude/issue-14298-skills-ui-optimization (pushed empty at claim time; write probe green)
Worktree: ../objectstack-issue-14298 from origin/main
File surface: skills/objectstack-ui/SKILL.md only (+ skills/README.md only if the drift gate demands a regeneration after the frontmatter edit)
Assignee: untouched (PM owns it)

PM mechanical assumption 1 verified: git diff --stat a59f78d origin/main -- skills/objectstack-ui is EMPTY, so every audit span is byte-identical at the branch point. Note: origin/main has moved past the dispatch's d63c8a25 — the branch is cut from 909a4417 ("agents(os-dev): verify-lock non-guarantee clause…"), which does not touch skills/.

Next action: the full audit record posted verbatim as the following comment.

---

Generated by Claude Code

[os-litant]

audit-record — skills/objectstack-ui (read-only audit at a59f78d)

Audit — skills/objectstack-ui/ (read-only)

Pinned refs: objectstack origin/main = a59f78d · objectui origin/main = 67dadd6.
git diff a59f78d..HEAD -- skills/ is empty, so every span below is identical at the pinned ref.

Package price tag (node scripts/check-skills-token-ratchet.mjs)

File	tokens	ceiling
SKILL.md	25,441	25,445 (headroom 4)
contracts/react-blocks.contract.json	5,352	generated
references/react-blocks.md	3,153	generated
references/_index.md	1,205	generated
evals/analytics-inline-vs-dataset.json	1,102	1,102
evals/README.md	289	289
package total	36,542	—

Bundle context: authored total 171,406 · shipped total 187,854. This package is
19.5 % of everything a customer pays for; SKILL.md alone is 14.8 % of the
authored bundle and 1.75× the next-largest authored file (pm-dispatch 14,549).

Real-usage corpus (measured, examples/** + packages/apps/**)

grep -rhoE "= define<X>\(\{" counts of exported definitions:
defineAction 34 · definePage 29 · defineView 10 · defineReport 9 ·
defineDataset 6 · Dashboard literals 5 · App.create 3 · defineCube 1 ·
src/docs/*.md 11 (7 ```metadata fences).
Page tiers: kind:'full'/structured 12, 'html' 3, 'react' 3, 'slotted' 1.
View types: grid 25 · simple 10 · kanban 4 · chart 2 · calendar 2 · one each of
wizard/tree/timeline/tabbed/split/map/gantt/gallery.

Section token map (ceil(utf8 bytes / 4))

tokens	span	section
4,121	L968-1279	Pages — Lightning-Style Page Layouts
2,935	L190-477	Configuring a List View
2,847	L1437-1658	Dashboards (cont.)
2,570	L1813-2055	Actions
1,977	L654-796	Dashboards
1,923	L48-189	View Types
1,502	L1280-1417	Docs
1,116	L578-653	App Navigation
883	L857-924	Three Run Modes
818	L503-577	Configuring Gantt Views
752	L797-856	Report Types
686 / 603	L1659-1714 / L1715-1768	Date Macros / Context Tokens
683	L925-967	Record Presentation
487	L1769-1812	Analytics Cubes
362	L1418-1436	CRM UI Blueprint

---

Findings

id	dim	file:span	evidence (measured)	proposal	Δtok	value gate ①②③	conf	human-floor
UI-A-01	A	skills/objectstack-ui/SKILL.md:6-10	Trigger file list is *.view.ts / *.app.ts / *.dashboard.ts / *.action.ts / src/docs/*.md. The corpus's most-authored kind is *.page.ts (29 definitions, 21 files) and *.report.ts (9) / *.dataset.ts (6) are also absent, though the body teaches all three (L968, L809, L1578). An agent opening renewals-pipeline.page.ts or revenue-pulse.dataset.ts has no filename trigger.	REWRITE-AS-CONSTRUCT (add *.page.ts / *.report.ts / *.dataset.ts; drop the now-redundant trailing clause "including dataset-bound dashboard/report widgets")	−5	① yes — decides whether the package loads at all ② no ③ construct = the trigger list itself	HIGH	no
UI-A-02	A	SKILL.md:13-14	"the React renderer implementation (lives in packages/client-react, not metadata)". packages/client-react/package.json description = "React hooks for ObjectStack Client SDK"; packages/client-react/src/index.tsx:4-12 exports useQuery/useMutation/useObject/ObjectStackProvider — no renderer. The renderer is @object-ui/react-runtime per packages/spec/src/ui/page.zod.ts:656. Also decision-neutral: a customer authoring metadata touches neither.	DELETE the clause	−22	① no (it is wrong AND inert) ② yes — deletion is the fix ③ n/a	HIGH	yes (published routing text)
UI-A-03	A	SKILL.md:11-13	"interactive screen flows / wizards (those are *.flow.ts with type:'screen' — see objectstack-automation)". But wizard is a first-class UI form type here (SKILL.md:69), used at examples/app-showcase/src/ui/views/task.view.ts:387 and examples/app-showcase/src/ui/pages/new-project-wizard.page.ts:12-30 (object-form + formType:'wizard'). "Build a multi-step wizard form" routes to the wrong package.	REWRITE-AS-CONSTRUCT — "multi-step flows that branch on logic between steps; a stepped form over ONE object is this skill's formViews type:'wizard'"	+8	① yes — routing decision ② no ③ yes	HIGH	yes
UI-B-01	B	whole package (no rules/)	25,441 tokens in ONE entry file. skills/README.md:73-79 documents rules/ as the split mechanism; objectstack-data (8 rules), objectstack-platform (4), objectstack-query (3) all use it, and the sibling objectui package does the same at /home/user/objectui/skills/objectui/SKILL.md — a 9,086-byte entry file pointing at 4 rules/ + 12 guides/. objectstack-ui is the only large package with zero progressive disclosure.	RESTRUCTURE — see "Proposed split" below	~−15,900 moved out of the entry file	① yes — the entry file is what steers every session ② partly ③ construct = the pointer table	HIGH	yes
UI-B-02	B	SKILL.md:654-796 + SKILL.md:1437-1658	Dashboards documented in two sections 640 lines apart, with Reports, Three Run Modes, Record Presentation, Pages (4,121 tok) and Docs (1,502 tok) in between. L676-680 forward-references "the Production Pattern section below" — a section titled "Dashboards (cont.)".	MERGE-INTO one rules/analytics-widgets.md	0 (move)	① yes ② no ③ n/a	HIGH	yes
UI-B-03	B	SKILL.md:1641-1658	The dateGranularity → bucket-label table and the "Engine support" bullets sit under ### Drilldown (opens L1598) although they document dateGranularity, whose own ### is at L1570-1597. Content is 40 lines below its heading.	MOVE-TO after SKILL.md:1597	0 (move)	① yes — a reader scanning ### Drilldown gets bucketing ② no ③ n/a	HIGH	no
UI-B-04	B	contracts/react-blocks.contract.json + references/react-blocks.md	Two renderings of ONE generated contract. Both carry version/adr/source/note + the same 4 blocks with identical prop counts (ObjectForm 34, ListView 20, ObjectChart 18, Block 1); the note string is byte-identical (contract.json:5 vs react-blocks.md:10). SKILL.md:1153-1156 links both as if they were different documents. 8,505 tokens = 23 % of the package for a 4-component contract.	DELETE one rendering (keep the .md — it is what an LLM reads). The generator labels them "(machine)" / "(AI-facing)" (packages/spec/scripts/build-react-blocks-contract.ts:7-9), but a repo-wide grep finds no consumer of the .json — only the generator (:23), scripts/regen-artifacts.mjs:280, scripts/pm/check-governed-merges.mjs:2295, and the ratchet (scripts/check-skills-token-ratchet.mjs:688). Dropping it touches those four.	−5,352	① no — an agent reads one ② yes ③ the .md table already IS the construct	HIGH	yes (generator change)
UI-B-05	B	SKILL.md:1147, :1197, :1201, :1258 (+ references/react-blocks.md:10, contracts/react-blocks.contract.json:5)	"Do NOT use Tailwind className" stated 6 times across the package, 4 of them in SKILL.md within 111 lines.	MERGE-INTO SKILL.md:1197-1210 (the ADR-0065 anchor); replace the other three with the primitive-per-tier line only	−80	① no — repetition changes nothing after the first ② yes ③ the ADR-0065 block is already a construct	HIGH	no
UI-B-06	B	SKILL.md:35-47	"## When to Use This Skill" is 7 bullets that restate the frontmatter description the agent has already read (list view / form layout / app / dashboard / reports / actions / docs).	DELETE	−136	① no ② yes ③ n/a	HIGH	no
UI-C-01	C	SKILL.md:1659-1714 + :1715-1768 vs skills/objectstack-query/rules/filters.md:221-247	The query package's rule file already opens "Date Macros (declarative filter metadata) — Filters that travel as JSON metadata — list views, dashboards, reports, pages — cannot run code", then enumerates fixed tokens, {N_<unit>_ago} parameterised tokens, and {current_user_id}/{current_org_id}. objectstack-ui restates all of it (a 36-token table + a DO/DON'T list + a second DO/DON'T list).	MERGE-INTO objectstack-query/rules/filters.md; keep in ui ONLY the near-miss table (SKILL.md:1743-1750) and the filter-token-unknown gate (:1760-1768), which are ui-specific and not in the query file	−800	① the enumeration no; the near-miss table yes ② yes ③ keep the surviving table	MED (query's rules/ is on-demand, so the pointer must be explicit)	yes
UI-C-02	C	SKILL.md:1955-1981 vs skills/objectstack-data/references/data-hooks.md	The org-isolation + ctx.session.positions narration (blessed name, "the former ctx.session.tenantId alias was removed in v16", ADR-0090 migration window, "not an authorization input", ADR-0095 pointer). SKILL.md:1979-1981 itself says "Same two isolation axes as hooks — see the objectstack-data hooks reference."	DELETE the body, keep the pointer sentence	−342	① no — an action body author gets the same answer from the hooks reference ② yes ③ n/a	HIGH	yes
UI-C-03	C	SKILL.md:173-189 vs skills/objectstack-data/SKILL.md	The visibleWhen/readonlyWhen/requiredWhen 3-row table. objectstack-data's own frontmatter claims the surface: "Use for visibleWhen / readonlyWhen / requiredWhen rules that belong on fields."	MERGE-INTO objectstack-data; keep only the routing line "declare on the DATA MODEL field, not the form view" + the inline-grid row-by-row evaluation note (ui-specific)	−120	① routing yes, table no ② yes ③ keep the one line	HIGH	yes
UI-C-04	C	SKILL.md:73-126 vs skills/objectstack-data/rules/relationships.md	The inlineEdit ladder restates the child-relationship value semantics ('grid' / 'form' / true smart default, computed columns, ghost row, typeahead auto-fill, drag-reorder, totals stack) after already routing the reader there at :82-83 ("see the objectstack-data skill → Relationships → Inline Editing"). The ui-owned half is subforms (:93-108) and the object-master-detail-form page block (:110-112).	MERGE-INTO objectstack-data (data-model half); keep subforms + the page-block escape hatch	−400	① the data-model half no ② yes ③ keep the 3-rung ladder as the construct	MED	yes
UI-C-05	C	SKILL.md:857-923 vs /home/user/objectui/skills/objectui/guides/app-composition.md:7-11	The objectui guide asserts "It is the single source of truth for app-composition decisions … do not fork or paraphrase the decision tables elsewhere — link here instead", and its nav-target table duplicates SKILL.md:860-866. But /home/user/objectui/skills/objectui/SKILL.md:5 is user-invocable: false and its Scope is "Anything under packages/ in this repo" — a customer never loads it.	NO CHANGE in objectstack-ui (it is the customer-facing anchor). Record that the objectui guide's exclusivity claim is stale for the customer path.	0	① n/a ② n/a ③ n/a	HIGH	no
UI-D-01	D	SKILL.md:346-462	1,381 tokens on view-level searchableFields across 4 sub-sections (⛔ One bad entry 400s EVERY search, searchableFields: [] does NOT turn search off, "Searching by a related record's title"), including a 7-row diagnostic table and two verbatim error strings. Real usage of the documented surface (a view narrowing the object's set) across examples/** + packages/apps/**: 0. The only two hits are examples/app-showcase/src/data/objects/account.object.ts:35 (object-level — objectstack-data's surface) and examples/app-showcase/src/ui/pages/renewals-pipeline.page.ts:140 (a react <ListView searchableFields=…> prop).	REWRITE-AS-CONSTRUCT — keep the "what the object allows" 2-row table (:377-385), the 7-row os validate / runtime table (:400-409), and the userActions: { search: false } example; delete the two verbatim diagnostics (:411-423), the empty-array essay (:425-451) reduced to one row of the existing table, and the related-title prose (:452-462) reduced to its existing objectstack-data pointer	−900	① the tables yes, the prose no ② yes ③ two tables already exist and survive	HIGH	yes
UI-D-02	D	SKILL.md:528-577	timeSegments (排班分段) — 583 tokens, a 6-row field table and a 6-bullet behaviour list. The text itself states it "is an ObjectUI display extension, not part of the upstream GanttConfigSchema in @objectstack/spec". Repo-wide grep -rn timeSegments --include=*.ts --include=*.tsx over objectstack (excluding node_modules, dist) returns only SKILL.md; every implementation hit is in /home/user/objectui/packages/plugin-gantt/. It also carries 10 of the package's 13 CJK lines.	MOVE-TO the objectui skill (rules/ or guides/) — or RETIRE-SURFACE from the published customer package under the startup-focus principle	−583	① no customer decision measured ② yes ③ n/a	HIGH	yes (removes published capability text)
UI-D-03	D	SKILL.md:1257-1262	"Why this model: it's build-independent … collision-free … responsive-correct …" — pure justification after the rule and the example are already stated.	DELETE	−96	① no ② yes ③ n/a	HIGH	no
UI-D-04	D	SKILL.md:1354-1362	"A reader who can't open Studio (a business user, a PM, an auditor) can't see the whole shape of a process …" — rationale for the metadata fence; the 3-row type/renders/required table at :1366-1370 carries the whole decision.	DELETE	−145	① no ② yes ③ the table survives	HIGH	no
UI-D-05	D	SKILL.md:1626-1640	"> Renderer note (object/record-backed surfaces). The ObjectUI renderer exposes a richer options.drillDown block for non-dataset list/table widgets …" — 215 tokens closing with "Dataset-bound dashboards use the semantic-layer drill above and ignore the rest of this block." Every persisted widget IS dataset-bound (SKILL.md:685-694; packages/spec/src/ui/dashboard.zod.ts:171 dataset required, :175 values.min(1)). The block documents a surface it then tells the reader to ignore.	DELETE	−215	① no — it is self-negating for the authored surface ② yes ③ n/a	HIGH	yes
UI-D-06	D	SKILL.md:1530-1535	"> Removed in v17: the bare strings compareTo: 'previousPeriod' … and the { offset: … } arm. … rewritten for you by os migrate meta --from 16". The prescription is machine-readable at packages/spec/src/conversions/registry.ts:2627-2629 and replayed by the chain; objectstack-upgrade exists to run it.	DELETE	−125	① no — a NEW author never writes the removed spelling; an upgrading one loads objectstack-upgrade ② yes ③ n/a	HIGH	yes (touches retired semantics)
UI-D-07	D	SKILL.md:686-696	"The legacy per-widget inline query (object + categoryField + valueField + aggregate) was removed — a widget now requires dataset + values; the closed schema REJECTS the inline keys by name". The requirement is the decision; the removal history is not.	REWRITE-AS-CONSTRUCT — keep "a widget requires dataset + values; the closed schema rejects object/categoryField/valueField/aggregate by name"	−110	① requirement yes, history no ② yes ③ yes	HIGH	yes
UI-D-08	D	SKILL.md:1799-1812	"### Cube Best Practices" — 5 numbered practices for a surface with one real usage (examples/app-showcase/src/data/analytics/showcase.cube.ts); items 4-5 ("Keep public: true …", "One cube per object usually beats omnibus cubes") are convention restatement.	REWRITE-AS-CONSTRUCT — collapse to the two enforcement facts (sql = object name, read via cube.sql.trim(); granularities required on time dimensions)	−100	① 1-2 yes, 3-5 no ② yes ③ yes	MED	no
UI-E-01	E	SKILL.md (whole)	Fence census per packages/spec/scripts/check-skill-examples.ts (marker = <!-- os:check --> on the line directly above the fence): 33 ts/typescript/tsx fences, 11 marked (33 %). The four most-authored constructs have no gated example: structured definePage regions (:1023-1067, 12 real files), the Dashboard literal (:1442-1502, 5 real files), defineDataset (:1578-1596, 6 real files), source-tier pages (:1108-1117 html, :1168-1188 react — 6 real files).	ADD <!-- os:check --> to the four after UI-E-02/E-03 make them compile	~+10	① yes — an ungated canonical example is how rot ships ② no ③ the marker is the construct	HIGH	no
UI-E-02 ⛔	E	SKILL.md:1485	Sole blocker in the 60-line canonical dashboard (every other key checks out: header.actions[].actionType:'script' is valid — ActionType enum, packages/spec/src/ui/action.zod.ts:530; dateRange.field/defaultRange/allowCustomRange — dashboard.zod.ts:914-916). The widget carries actionType: 'url', actionUrl: '/objects/opportunity?filter=open'. On DashboardWidgetSchema both are retired: packages/spec/src/ui/dashboard.zod.ts:382-384 actionUrl/actionType/actionIcon: retiredKey(WIDGET_ACTION_RETIRED(...)), and retiredKey = z.never({error}) (packages/spec/src/shared/retired-key.ts:106-108) — a tsc error and a parse error. Prescription at dashboard.zod.ts:309-320: "a dashboard widget has NO action button, and never had one … delete all three." (:1455-1457 uses the same two keys on header.actions[], where they are correct — DashboardHeaderActionSchema, dashboard.zod.ts:91-95.)	DELETE the line	−20	① yes — copy-pasting the canonical dashboard fails the build ② yes ③ n/a	HIGH	yes (retired semantics)
UI-E-03	E	SKILL.md:1024	import { ConvertLeadAction } from '../actions/lead.actions'; — a relative import that cannot resolve in the gate's throwaway build dir (check-skill-examples.ts header: blocks are "written verbatim to a throwaway build dir and type-checked … against the built @objectstack/spec declarations"). This is why the most-used page shape (12 real files) is ungated.	REWRITE — inline a minimal defineAction or drop the header actions entry, then mark	~+0	① yes — unblocks the gate on the highest-traffic example ② no ③ n/a	HIGH	no
UI-E-04	E/G	SKILL.md:1160-1161 + :1178	Prose: "<ListView> honors objectName / fields / onRowClick / navigation"; example: <ListView key={reload} objectName="project" …>. The package's own generated contract marks it deprecated: references/react-blocks.md:61 "objectName … [DEPRECATED → data={{ provider: 'object', object }}] … this alias is removed after the deprecation window", and :62 viewType [DEPRECATED → type]; source packages/spec/src/ui/react-blocks.ts:270-288. The real corpus repeats the deprecated spelling (examples/app-showcase/src/ui/pages/crm-workbench.page.ts:88, task-desk.page.ts:44, renewals-pipeline.page.ts:169). Maintainer principle: "retired spellings retire at once; no dual-spelling grace."	REWRITE — teach data={{ provider: 'object', object: '…' }} + type in the prose and the example	+15	① yes — decides which spelling every generated react page carries ② no ③ the example is the construct	HIGH	yes (retired/deprecated semantics; the corpus would need the same change)
UI-F-01	F	SKILL.md:750 (only mention)	filterBindings is a declared widget key with a full contract in the schema — packages/spec/src/ui/dashboard.zod.ts:568-577: "Per-widget dashboard-filter bindings: filter name → this widget's field, or false to opt out", plus the default-binding rule ("absent → the filter's own field; dateRange → dateRange.field ?? 'created_at'") with 24 hits across examples/**, including a dedicated regression test (examples/app-showcase/test/dashboard-filter-vocabulary.test.ts) and a documented silent-zero failure at examples/app-showcase/src/ui/dashboards/ops-dashboard.dashboard.ts:30-49: a global filter auto-inherits onto a like-named field with a different vocabulary, so "Four tiles and a chart read 0 for any selection while the filter bar looked like it was working"; the fix is filterBindings: { task_status: false } or a re-target (region → sales_region). SKILL.md mentions the key once, in a bullet, with no shape. The package's own eval asserts must_contain: ["filterBindings"] (evals/analytics-inline-vs-dataset.json:42).	ADD an 8-line construct (broadcast rule + false opt-out + re-target + the name-not-field naming rule from ops-dashboard.dashboard.ts:63-67), paid by UI-D-05 (−215) + UI-D-06 (−125) in the same file	+170 (net −170)	① yes — prevents a whole dashboard silently reading 0 ② no ③ construct = a 4-row table	HIGH	no
UI-F-02	F	SKILL.md:1481 (only options use)	DashboardWidgetOptionsSchema (dashboard.zod.ts:217-252) declares four query-affecting keys — dateGranularity, sortBy, sortOrder, limit (+ stageOrder) — precisely so "a typo (sortDirection, granularity) is now an author-time type error instead of an option that reads as if it works and silently does nothing" (:209-211). SKILL.md uses options once, for a presentation-only icon, and documents none of the four. Top-N ("top 10 accounts") has no documented spelling.	ADD a 5-row table, paid by UI-D-08 (−100) + UI-D-03 (−96) in the same file	+120 (net −76)	① yes — top-N / per-widget bucketing has no other spelling ② no ③ yes	HIGH	no
UI-F-03	F	SKILL.md:1466-1470	globalFilters is shown as one entry with the gloss "Filters applied to ALL widgets" and no mechanism. GlobalFilterSchema also declares name ("Stable filter name (variable key); defaults to field"), scope: 'dashboard' | 'widget', and targetWidgets: string[] — none documented. Real dashboards depend on name (ops-dashboard.dashboard.ts:66-67: "filterBindings keys reference this name").	ADD 3 rows to the UI-F-01 construct	+50	① yes ② no ③ yes	HIGH	no
UI-F-04	F	(speculative surfaces)	Literal-key grep over examples/** + packages/apps/**, zero hits: timeSegments 0 · undoable 0 (SKILL.md:1848, :1870) · opensInNewTab / newTabUrl 0 (SKILL.md:2009-2039, 315 tok) · refreshInterval 0 (SKILL.md:1450) · requiresObject 0 in the corpus (one hit repo-wide, packages/objectql/src/registry-nav-contributions.test.ts:37) though SKILL.md pushes it at :625-627, :648-651, :1426 · taxRateField 0 (SKILL.md:142) · stageOrder 0 · page type:'utility' 0 (SKILL.md:986) · record:related_list 0 (SKILL.md:1017). Zero usage in the shipped examples is evidence, not proof — I grepped examples/** and packages/apps/** only.	RETIRE-SURFACE candidates for a maintainer pass; timeSegments (UI-D-02) is the only one large enough to matter alone	up to −900 combined	① unmeasured for each ② yes ③ n/a	MED	yes
UI-G-01	G	see UI-E-04	deprecated objectName/viewType taught as canonical	—	—	—	HIGH	yes
UI-G-02	G	SKILL.md:1572	"Date bucketing lives on the dataset dimension, not the widget." Contradicted by packages/spec/src/ui/dashboard.zod.ts:217-225: options.dateGranularity — "Bucket this widget's selected DATE dimensions … Overrides the dataset dimension's own dateGranularity default for this widget only", reinforced at :469 ("Date bucketing is options.dateGranularity on this widget (or the DATASET dimension's own dateGranularity default)"). The adjacent claim — categoryGranularity removed — is correct (dashboard.zod.ts:160).	REWRITE — "the dataset dimension is the default; options.dateGranularity overrides it per widget" (folds into UI-F-02)	+12	① yes — an author needing a per-widget bucket is told it is impossible ② no ③ yes	HIGH	yes
UI-G-03	G	SKILL.md:528,530,543,545,546,559,562,568,570,571,880,881,2001	13 CJK lines in an English customer-facing package; 10 are the timeSegments block (排班分段 / 白班 / 夜班 / 排班日), the rest are 给业务部门的简化界面 · 工作台 (:880-881) and 打印总表(A3) (:2001). Sibling counts: i18n 38 (legitimate), automation 3, pm-dispatch 1, upgrade 1, all others 0. The sibling objectui skill mandates English-only for published text (/home/user/objectui/skills/objectui/SKILL.md:31-33).	Resolved by UI-D-02 for 10 of 13; translate the remaining 3	−5	① no ② partly ③ n/a	HIGH	no
UI-G-04	G	SKILL.md:340,898,941,944,1095	Retired-spelling sweep found no false residue: toggle deprecated (ADR-0047), sourceView still declared (packages/spec/src/ui/page.zod.ts:434), colSpan "[legacy — prefer span]" (view.zod.ts:2250), drawerWidth "[DEPRECATED → size buckets]" (view.zod.ts:3119), kind:'jsx' alias present (page.zod.ts:594,656). Also no dead links: ./references/react-blocks.md, ./contracts/react-blocks.contract.json, ./references/_index.md all resolve; both #date-macros--filter-placeholders anchors match ## Date Macros — Filter Placeholders.	NO CHANGE	0	—	HIGH	no
UI-H-01	H	evals/ (whole)	1 fixture, 5 cases, 1,102 tokens, all on one topic (dataset envelope) for a 25,441-token package. Zero eval coverage for the corpus's top constructs: actions (34 real), pages (29), views (10), docs (11), page styling. evals/README.md:26-29 names three intended targets — "page-owned columns/sort/filterBy on interface pages, dataset-bound widgets, action locations values" — of which only the middle one exists.	ADD one fixture covering interface-page ownership + action locations/visible-vs-disabled (the two traps SKILL.md:2085-2093 says os validate catches)	+600 (new file — needs a ceiling)	① yes — evals are how the package's own claims stay honest ② no ③ the fixture is the construct	MED	yes (new ratcheted file)
UI-H-02	H	evals/analytics-inline-vs-dataset.json:26	Eval 2 asserts must_not_contain: ["dateGranularity"]. The fixture's own note (:24) concedes "It can flag an otherwise-correct answer that merely mentions the field in passing". Worse after UI-G-02: options.dateGranularity is a real widget key, so a correct escalation answer may legitimately name it while rejecting it as the fix. A string grader fails a correct answer.	REWRITE the assertion (e.g. require window/Cube and drop the negative, or scope the negative to "dateGranularity is the fix")	−10	① yes — it teaches a grader the wrong verdict ② no ③ yes	HIGH	no
UI-H-03	H	evals/analytics-inline-vs-dataset.json:42	Eval 4 asserts must_contain: ["filterBindings"] for a key SKILL.md mentions exactly once, in passing (:750), with no shape, no example, no semantics. The package cannot pass its own eval from its own text.	Resolved by UI-F-01 (ADD the construct); otherwise drop the assertion	0	① yes ② no ③ n/a	HIGH	no
UI-H-04	H	evals/analytics-inline-vs-dataset.json:47-55	Eval 5's expected <ObjectChart objectName=… aggregate={{function:'count', groupBy:'status'}} xAxis={{field:'status'}} series={[{name:'count'}]} /> matches the generated contract (references/react-blocks.md, <ObjectChart> aggregate: "Result rows are keyed by the RAW FIELD NAMES … the literal "count" for a fieldless count"). Correct row — keep.	NO CHANGE	0	—	HIGH	no
UI-I-01	I	package	36,542 tokens (19.5 % of the 187,854-token shipped bundle) against 9 distinct authored metadata kinds, ~13 view/form types and 3 page tiers. SKILL.md alone is 25,441 (14.8 % of the authored bundle), 1.75× pm-dispatch and 1.83× objectstack-data — while objectstack-data covers a comparable surface in 13,892 + 8 rules/ files. Two of the three largest sub-blocks (searchableFields 1,381 · timeSegments 583) have zero real usage of the documented surface.	RESTRUCTURE (UI-B-01) + the D/C trims	−4,199 in SKILL.md + −5,352 (UI-B-04) = −9,551, 26 % of the package	① yes ② yes ③ yes	HIGH	yes

---

Proposed split (answers the dimension-B question: what is the 80 %?)

Keep in SKILL.md (≈ 9.5k tokens) — the sections that change a decision in most
sessions, ordered by how early the decision is made:

1. Routing + file-shape map — promote CRM UI Blueprint (:1418-1436) to the top; it is
   the only one-screen "which file, which factory" construct in the package.
2. defineView container + list-view core — :192-291, :463-477.
3. View-type / form-type selection tables — :48-72.
4. Record presentation auto-derivation ladder — :925-967 (applies to every form; 683 tok).
5. App navigation + the three run modes — :578-653, :857-924.
6. Dashboard / report / dataset binding core — :654-712, :797-856.
7. Page types + the kind tier chooser table — :968-1020, :1081-1096.
8. Actions: types, locations, visible-vs-disabled, one example — :1813-1875.
9. Verify your work — :2075-2099.

Move out (≈ 15.9k tokens), each linked from the entry file with a one-line pointer:

new file	from	tokens
rules/analytics-widgets.md	:684-796, :1437-1658 (+ UI-F-01/02/03 additions)	~4,500
rules/page-source-tiers.md	:1081-1279 (html/react tiers + ADR-0065 styling)	~2,900
rules/master-detail.md	:73-172 (after UI-C-04 trim)	~1,100
rules/docs.md	:1280-1417	~1,500
rules/list-view-search.md	:346-462 (after UI-D-01 trim)	~480
rules/actions-advanced.md	:1938-2055 (ctx after UI-C-02, openIn, params)	~1,300
rules/kanban-gantt.md	:478-527 (timeSegments leaves per UI-D-02)	~460
rules/cubes.md	:1769-1812 (after UI-D-08)	~390
rules/filter-tokens.md	:1659-1768 (after UI-C-01)	~490

Incidental falsehoods (by-product; not the job)

#	span	claim	implementation truth
1	SKILL.md:1485	dashboard widget takes actionType / actionUrl	packages/spec/src/ui/dashboard.zod.ts:382-384 — retiredKey(...) = z.never() (packages/spec/src/shared/retired-key.ts:106-108); prescription dashboard.zod.ts:309-320 "a dashboard widget has NO action button, and never had one … delete all three". tsc error + parse error.
2	SKILL.md:1572	"Date bucketing lives on the dataset dimension, not the widget"	dashboard.zod.ts:217-225 — options.dateGranularity "Overrides the dataset dimension's own dateGranularity default for this widget only"; echoed :469.
3	SKILL.md:13-14 (frontmatter)	"the React renderer implementation (lives in packages/client-react)"	packages/client-react/package.json — "React hooks for ObjectStack Client SDK"; packages/client-react/src/index.tsx:4-12 exports hooks + provider only. The renderer is @object-ui/react-runtime (packages/spec/src/ui/page.zod.ts:656), in the objectui repo.

Verdict

RESTRUCTURE. Structural on its own (25,441-token single entry file, no rules/,
dashboards split across two sections 640 lines apart, one generated contract shipped
twice). Measured reducible mass: −4,199 of SKILL.md prose (16.5 % of that file)
plus −5,352 for the duplicated contract rendering = −9,551, 26 % of the package;
net ≈ −9,170 (25 %) after the +385 tokens of in-file additions (UI-F-01/02/03,
UI-G-02, UI-E-04), each of which names the same-file deletion that pays for it.
The one addition that needs a new ratcheted file (and therefore a maintainer ceiling
ruling) is UI-H-01's second eval fixture.

---

Generated by Claude Code

[os-litant]

audit-record erratum — sanitizer-eaten fragments in the comment above

The audit record was posted verbatim and read back in full (footer intact). GitHub's body sanitizer deleted every angle-bracket-shaped fragment, exactly as the dev contract's byte-discipline clause predicts — 7 fragments at 6 sites, all silently, all inside backticks. Restored here in placeholder spelling so the record stays checkable. Nothing else in the record was altered (blockquote > escapes are rendering, not loss).

site	posted as	actual bytes in findings.md (placeholder spelling)
Real-usage corpus, line 1	= define\(\{	= define + ANGLE-X + \(\{ — i.e. the grep matched define followed by a type-parameter placeholder
UI-C-01 evidence	{N__ago}	{N_ + ANGLE-UNIT + _ago} — the parameterised date-macro token
UI-D-01 evidence, last hit	(empty)	renewals-pipeline.page.ts:140 (a react ListView searchableFields=… JSX element prop)
UI-E-01 evidence + proposal	(empty), twice	the os:check marker — an HTML-comment-shaped marker containing os:check, placed on the line directly above the fence
UI-E-04 prose + example	(empty), twice	ListView (the JSX element) and the example element ListView key={reload} objectName="project" …
UI-H-04 expected answer	(empty), twice	the ObjectChart JSX element with objectName=… aggregate={{function:'count', groupBy:'status'}} xAxis={{field:'status'}} series={[{name:'count'}]}, and the bare ObjectChart element name in the contract citation

The authoritative bytes remain the seat scratchpad file (audit/objectstack-ui/findings.md, md5 20ba649a008c614c555bdc30ec674b02, 147 lines / 32,199 bytes). Every finding this flight implements is legible from the record above; the eaten fragments touch UI-E-01's marker spelling and UI-E-04/H-04 evidence only, and are restored above.

---

Generated by Claude Code