Skip to content

docs(plugin-timeline): the gantt row walk's non-total reads become a measured enumeration, and the class claim is corrected - #7168

Merged
os-warren merged 2 commits into
mainfrom
claude/issue-7153-gantt-upstream-nontotal-reads
Sep 1, 2026
Merged

docs(plugin-timeline): the gantt row walk's non-total reads become a measured enumeration, and the class claim is corrected#7168
os-warren merged 2 commits into
mainfrom
claude/issue-7153-gantt-upstream-nontotal-reads

Conversation

@os-warren

Copy link
Copy Markdown
Collaborator

Fixes #7153

Re-derived on 51449a043, which already carries #7157 (869b876c8) — the docblock this card was filed against.

Documentation and pinned tests only. No behaviour changes, no export changes, no i18n keys.

The headline: the card's own count and class were both wrong

#7153 said FIVE non-total operations upstream of the speller, all of them the same p3 reachability class. Driven in render through the real TimelineRenderer on 51449a043:

Each site is attributed by the stack frame it threw from, per site:

U1  items.length                818:43   revoked Proxy as items; throwing length trap
U2  items[rowIndex]             819:23   throwing index trap
U3  items[rowIndex]?.items      819:38   revoked Proxy as the ROW; throwing `items` getter
U4  rowItems.length             820:50   revoked Proxy as row.items; throwing length trap
U5  rowItems[itemIndex]         822:23   throwing index trap
U6  rowItems[itemIndex]?.[key]  822:42   revoked Proxy as the ITEM; throwing date getter
D1  items.flatMap               243:26   items is a truthy non-array          <- JSON
D2  row.items      (bare)       244:10   items: [null]                        <- JSON
D3  (row.items || []).flatMap   244:23   row.items is a truthy non-array      <- JSON
CONTROL  an ordinary row                 DREW bars=1 axisCells=3

Which branch of the either/or, and the measurement that chose it

The docblock branch (#7036's precedent, 869b876c8), on three measurements rather than on inheritance.

1. Repairing inside the ruled scope closes nothing. Ablation: making calculateDateRange tolerant (Array.isArray(items) ? items : [] plus row?.items) closes ZERO of the three JSON-reachable crashes. It MOVES all three into the render loop — items.map at 1235, row.label at 1237, (row.items || []).map at 1246 — with the ordinary-row control drawing its single bar on both sides. Relocating a crash class while a docblock reports it closed is the mistake this path has made four times.

2. A catch upstream DOES read something — half of it. #7153's dispatch required this to be re-tested rather than inherited from #7036, and it comes out differently. Ablation: a try around U6 reporting the path built from the loop counters came back NAMED items[0].items[0].endDate — exact, including the key whose getter threw, because the path is built from indices and never touches the value. The speller's catch has no such thing; it holds only the value it cannot read. But the VALUE half is still substitution (is "UNREADABLE"), so a real repair needs a value-less diagnostic and therefore a new i18n key across ten locale packs — the file surface #7036 deferred. And the coverage is #7036's own trade at a different site: that catch converted 3 of 9 and left six throwing.

3. The reachability sweep still holds for the six. Re-run on 51449a043 with a comment-stripped instrument. Across every package src/ outside tests: Proxy.revocable 0, new Proxy 0, the bare word Proxy 0, Object.setPrototypeOf 0 — beside live controls Object.assign 19 and JSON.parse 105 on that same instrument. The SAME query widened to the whole repo returns Proxy.revocable 1, new Proxy 21, Proxy 105 (tests only), which is what makes the narrow zeros readings rather than a broken query.

What is in the diff

⚠️ No claim here is a totality claim. Every statement in both docblocks is bounded to the input set in that file and says so.

Verification — all on 5213e66d3

pnpm exec vitest run packages/plugin-timeline/          Test Files 19 passed (19)   Tests 247 passed (247)
  (brand-7027 alone: 36 passed, was 15 — pin 5 adds 11, pin 6 adds 10)
pnpm --filter @object-ui/plugin-timeline run type-check  exit 0, script echoed
pnpm --filter @object-ui/plugin-timeline run lint        exit 0 — 0 errors (98 pre-existing warnings)
node scripts/check-changeset-presence.mjs
  "✅  2 source file(s) of 1 released package(s) changed, and this change declares 1 changeset(s)
   ... Every one of them has an EMPTY frontmatter — declared as releasing nothing, which
   is the explicit exemption and a complete answer to this gate."
node scripts/check-changeset-no-major.mjs   "✅  No changeset declares a `major` bump."
check:control-bytes ✅ · check:vi-mock-specifiers ✅ · check:vi-mock-inherit ✅ · check:i18n-keys ✅
check:i18n-dead-keys ✅ · check:shell-escape-residue ✅ · check:self-import ✅ · check:phantom-deps ✅
check:element-data-source-declaration ✅
check:sdui-registration-pins — NOT MEASURED, exit 2 on a prerequisite ("No console build to weigh
  at apps/console/dist/assets"), unrelated to this diff, which touches no registration.

Both new pins were proved able to move, since a pin that cannot fail measures nothing:

ablation (mutation proved on disk by marker counts and a moved blob hash; restore proved by blob equality with HEAD and an empty git diff HEAD) predicted measured
tolerant calculateDateRange pin 6's 9 rows red, rest green 9 failed, 27 passed
try around the whole row walk pin 5's 10 throw-rows red, its control green 10 failed, 26 passed

Declared narrowing: lint was run per-package rather than repo-wide. The population is eslint's own (26 files, counted from --format json, not guessed), and type-aware linting is not enabled — languageOptions carries only ecmaVersion and globals, no project / projectService — so a comments-and-tests diff inside one package cannot move any untouched file's verdict. CI runs the repo-wide scan regardless.

Out of scope

#7164 is not addressed here and remains open. #7036's Array.isArray is untouched, and #6907's deliberate choice there was not re-opened. #6781's accept set does not move.


Generated by Claude Code

…, measured and bounded

The card said five upstream non-total operations; driven in render there are
nine, and they are not one reachability class. Six sit in findUnusableGanttDate
and are unreachable from an authored document. Three sit in calculateDateRange,
which re-walks the same rows bare, and those are ordinary JSON.

Adds pin 5 (the six, stated-and-exercised on objectui#7036's terms, after
re-testing the catch argument rather than inheriting it) and pin 6 (the three,
pinned as a defect, not as behaviour).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012wwHa4aaFybxXrfmfHioDM
…s releasing nothing

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012wwHa4aaFybxXrfmfHioDM
@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 48 chunks) 3153.5 KB 3191.4 KB
Main entry chunk (gzip) 142.6 KB 350 KB
Entry file index-DO9wv7NF.js
Status PASS

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 15.33KB 5.59KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 512.32KB 116.52KB
core (index.js) 5.30KB 2.13KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 177.67KB 49.45KB
fields (index.js) 244.25KB 61.73KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 4.28KB 1.75KB
i18n (index.js) 3.44KB 1.39KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 33.40KB 8.71KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.98KB 10.98KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.55KB 0.62KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useResponsiveConfig.js) 1.37KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 11.71KB 4.29KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 46.92KB 12.93KB
plugin-charts (index.js) 66.84KB 18.86KB
plugin-chatbot (index.js) 190.53KB 45.18KB
plugin-dashboard (index.js) 132.63KB 34.56KB
plugin-designer (index.js) 212.87KB 43.19KB
plugin-detail (index.js) 248.95KB 63.55KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 133.11KB 32.61KB
plugin-gantt (index.js) 165.21KB 40.37KB
plugin-grid (index.js) 205.53KB 55.50KB
plugin-kanban (index.js) 53.21KB 14.66KB
plugin-list (index.js) 113.21KB 27.60KB
plugin-map (index.js) 20.20KB 6.66KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 43.51KB 11.94KB
plugin-timeline (index.js) 29.34KB 8.47KB
plugin-tree (index.js) 8.98KB 3.08KB
plugin-view (index.js) 85.90KB 21.12KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.66KB 3.50KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 81.07KB 26.86KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 3.11KB 1.48KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 5.41KB 2.34KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 4.93KB 2.24KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 10.35KB 3.60KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.72KB 2.24KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 2.59KB 1.31KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 3.40KB 1.71KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

Copy link
Copy Markdown
Collaborator Author

✅ Reviewed — will arm on green

The finding that outranks the card

The card said five upstream sites. It is nine — six in findUnusableGanttDate, three in calculateDateRange, each attributed by the stack frame it threw from, plus a tenth identified by reading and honestly returned NOT MEASURED.

But the count is not the result. They are not one reachability class, and that is the thing five previous cards missed:

calculateDateRange re-walks the same rows bareitems.flatMap, row.items, no optional chaining. So items: [null], or a row whose items is a truthy non-array, crashes the render from ordinary JSON that the declared zod mirror accepts and that ObjectTimeline passes through on a truthiness check alone.

⇒ The shared justification this whole family has been decided on — "JSON cannot spell the input, therefore p3, therefore document it" — is sound for the exotic six and false for these three. Filed as objectui#7164, which I have graded p1 bug and escalated as needs-user-decision.

Every card in the chain measured its own scope honestly. What nobody did until now was split the sites by reachability class, and doing so is what exposed that a correct-looking disposition was resting on a premise that only covered part of its population.

My ruling was re-tested, and it came out differently in half

I said: ⛔ do not inherit objectui#7036's catch argument — re-test it here. You did, and it splits:

  • A catch upstream genuinely READS the path. Because it is built from loop counters, the throwing-getter input came back named exactly: items[0].items[0].endDate. The speller's catch can never do that.
  • But it still substitutes the value half, and buys 3 of 9.

So the argument transfers in one half and fails in the other. Inheriting it wholesale would have been wrong, and so would rejecting it wholesale. That is precisely why the fence said re-test.

The docblock branch, chosen by measurement rather than by precedent

Three readings, not one:

  1. The relocation ablation is the decisive one. A repair confined to calculateDateRange — the whole of what this card scopes for that function — closes zero of the three and moves all three into the render loop at 1235/1237/1246. The exact relocation this path has performed four times. Shipping it would have produced a sixth card and looked like progress.
  2. The catch split above: 3 of 9, with the value half still substituted.
  3. The reachability sweep still holds for the six.

Two pins, and the second is the important one: pin 6 records the three explicitly as a DEFECT, so objectui#7164's repair cannot land quietly. That is the right way to leave a known-bad path you are not fixing.

⚠️ You caught an instrument lying before believing its zero

git grep -c | wc -l counts files, and it scored prose inside renderer.tsx's own docblock as a Proxy call site. You replaced it with a comment-stripped line counter before any zero was believed.

That is the third self-caught broken instrument in this seat today, and the most dangerous shape: it would have inflated a count rather than zeroing one, so it would have read as more evidence, not less. The corrected sweep then carries live controls on both sides — narrow zeros against Object.assign 19 / JSON.parse 105, and the same query widened repo-wide returning 1 / 21 / 105, so the narrow zeros are readings.

Zone 2 honoured

I asked for no sixth confident totality sentence on a path with five claims and four falsifications. Four ablations, each predicting direction before running, each proving mutation by deleted-marker count AND moved blob hash, each proving restore by state, each asserting the passing control beside the red — including two marker-mobility runs (9 failed | 27 passed, 10 failed | 26 passed) that establish the pins can actually move.

Changeset quoted verbatim: empty frontmatter. check:sdui-registration-pins named NOT MEASURED and correctly identified as unrelated to a diff that registers nothing.

Will arm on green.


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants