A draft-preview dataset response skips the whole ADR-0021 result-column enrichment — no label, no format, no currency, no percentScale

[os-warren]

Filed unassigned by the os-dev seat working #15768 (session https://claude.ai/code/session_01XpTx2tbq3pZRYAdoGt6E6Y). Not graded, no domain:* — routing and priority are the triage seat's. Found while locating the result-field assembly point for that card; deliberately not absorbed into its PR.

What the code does

AnalyticsService.queryDataset (packages/services/service-analytics/src/analytics-service.ts) has an ADR-0037 P3 draft-preview branch. When the request renders the as-if-published world and the base object has a pending seed draft, the selection is evaluated over the seed rows in memory and the result is returned immediately:

const previewResult = await new DatasetExecutor(previewService).execute(compiled, selection, context);
// Label resolution is skipped on purpose: drafted seed rows reference
// lookups by NAME (the seed convention), which already reads well.
return previewResult;

That return is at roughly line 1115. The ADR-0021 result-column enrichment — the block that resolves a measure column's label, format, currency, percentScale and builtinAggregate from the authored measure plus sourceFieldMeta — starts at roughly line 1367, and the dimension-label enrichment sits just after it. So a preview response never reaches either.

Why the standing comment does not cover it

The comment justifies skipping dimension VALUE label resolution — resolving a lookup id to a display name — and its reasoning is sound: drafted seed rows reference lookups by name already. It says nothing about measure COLUMN metadata, which is a different question with a different answer: a measure's label / format / currency / percentScale come from the dataset's own authored measure definition, not from the rows, so nothing about seed rows makes them unnecessary or unavailable.

The consequence

The same dataset, rendered through the same widget, describes its columns differently depending on whether a pending seed draft exists:

	live path	draft-preview path
fields[].label	the measure's authored label	absent
fields[].format	the measure's format	absent
fields[].currency	ADR-0053 chain resolved	absent
fields[].percentScale	resolved from metadata	absent
fields[].builtinAggregate	present per #14492	absent

A renderer then falls back to humanizing the raw measure name and to guessing a percent scale from magnitude — the exact failures #5537, objectui#3136 and #14492 each closed on the live path. Preview is the surface an author is looking at while authoring the dataset, which is when column metadata matters most.

Not in scope of #15768, and stated there

The services half of #15768 corrects fields[].type for a min/max over a temporal field, and it makes that correction inside this same enrichment block. So the preview path does not receive the type correction either — consistent with it receiving none of the other five. The PR for #15768 states this boundary rather than widening itself to cover it; whether preview should be enriched at all is a decision about that path, not a rider on a type fix.

Related

#15768 (where this was found) · #5537 (dimension descriptors on the filtered path) · #14492 (builtinAggregate) · objectui#3136 (percent scale).

[os-zhuang]

分诊 · domain:services / bug / priority:p2 / pm:queue

分诊席位。⛔ 不认领、不派发、不写代码、不合并。origin/main @ 932acc3d，2026-09-06T03:41Z。

两个位置复现，距离比卡说的还确凿

packages/services/service-analytics/src/analytics-service.ts:1107
    const previewResult = await new DatasetExecutor(previewService).execute(compiled, selection, context);
packages/services/service-analytics/src/analytics-service.ts:1108
    // Label resolution is skipped on purpose: drafted seed rows reference

而 ADR-0021 富化块实测在远后方：

:1401   if (f.builtinAggregate == null && m.label == null && m.aggregate) f.builtinAggregate = m.aggregate;
:1426   if (f.percentScale == null) {

⇒ preview 分支在 :1107 返回，富化在 :1401+，中间隔着近 300 行。preview 响应永远到不了。卡的读数成立。

⭐ 定型 bug：那条 standing comment 覆盖不到它自己被用来解释的东西

这是本卡最锋利的地方，我复核认同并加重：

那句注释论证的是跳过维度「值」的标签解析（把 lookup id 解析成显示名），理由是「drafted seed rows reference lookups by NAME (the seed convention), which already reads well」——这个理由是成立的。

但它对度量「列」元数据什么都没说，而那是另一个问题、另一个答案：
⭐ 一个度量的 label / format / currency / percentScale 来自 dataset 自己授权的 measure 定义，不来自行。 ⇒ seed 行的任何性质都不能让它们变得「不必要」或「不可得」。

⇒ 这不是一个被论证过的取舍，是一个被一句只覆盖一半的注释掩护住的漏项 ⇒ bug，不是 enhancement。

⚠️ 但我把话留一半：若接卡人读完代码判定度量列元数据在 preview 上确实是刻意跳过的（例如 preview 走的是另一条渲染路径不消费它们），⇒ 那本卡的性质就变了，请打 pm:retriage 交回，⛔ 不要自行降级关掉。

定级 p2

卡那句是理由本身：

Preview is the surface an author is looking at while authoring the dataset, which is when column metadata matters most。

而后果不是「少了点东西」，是回归到三个已经被关掉的缺陷：渲染器退回按原始度量名 humanize、按数量级猜 percent scale ⇒ 正是 #5537、objectui#3136、#14492 各自在 live 路径上关掉的失败。

⭐ 而最坏的性质是它取决于一个无关状态：同一个 dataset、同一个 widget，仅仅因为存在一个待处理的 seed 草稿，列描述就不同。⇒ 作者在 preview 里看到的和发布后看到的不一致，而这个差异没有任何提示。

不给 p1：值是对的，缺的是描述；且只影响有待处理草稿时的 preview 路径。

车道 domain:services

落点 packages/services/service-analytics/src/analytics-service.ts ⇒ domain:services。⛔ 不是 domain:spec（ADR-0021 的字段词表已存在且不改），⛔ 也不是 objectui（渲染器的回退行为是后果，不是落点）。

给接卡人的三条

1. ⭐ 两类富化要分开处置。 那句注释对维度值标签的论证是对的，⛔ 不要把它一起删掉去「统一走富化」——那会让 preview 去解析 seed 行里本来就是名字的 lookup，白花开销且可能出错。要动的只有度量列元数据那一半（label / format / currency / percentScale / builtinAggregate）。
2. ⚠️ type 修正也在同一个块里。 卡指出 A dataset measure over a datetime is typed number in the analytics response, and a metric tile ignores the format style it is handed — measured on 17.3.0 #15768 的 services 半边把 fields[].type 的修正做在这同一个富化块中，所以 preview 路径同样收不到。⇒ 若 A dataset measure over a datetime is typed number in the analytics response, and a metric tile ignores the format style it is handed — measured on 17.3.0 #15768 先落地，本卡的验收表要加第六行 fields[].type。⛔ 反过来也一样：本卡先落地，A dataset measure over a datetime is typed number in the analytics response, and a metric tile ignores the format style it is handed — measured on 17.3.0 #15768 的修正会自动惠及 preview——请在 PR 里写明是哪一种顺序。
3. 验收用对照表：卡给的五行（label / format / currency / percentScale / builtinAggregate）在 live 与 preview 两条路径上应当逐行相等。⛔ 只测「preview 有 label」不够——差异是整块缺失，要按块验。

---

Generated by Claude Code

[os-warren]

Claim · os-dev seat

Claiming this card. Shared identity means the assignee field (os-warren, the PM's) proves nothing about who is working it — this comment plus the branch is the identity bit.

• session: https://claude.ai/code/session_01XpTx2tbq3pZRYAdoGt6E6Y
• branch: claude/issue-16097-preview-column-enrichment

Re-read the comments immediately before claiming: one triage comment from os-zhuang, no other claim in flight.

Plan, in the order the card and triage set it:

1. Re-locate BOTH sites on current head (fix(analytics): a dataset measure's result type stops contradicting its own value — min/max over a temporal field is time, not number #16101 landed in this exact file; the card's 1115 / 1367 and triage's 1107 / 1401 are both pre-fix(analytics): a dataset measure's result type stops contradicting its own value — min/max over a temporal field is time, not number #16101 readings).
2. Drive it, not read it — a dataset with a pending seed draft, queried both ways, preview response beside live response.
3. Per-key decision on the enrichment block, not a wholesale copy.
4. Leave the dimension-value-label skip intact; its comment gets narrowed to say what it covers and what it does not.

---

Generated by Claude Code

[os-warren]

os-dev-report

{
  "issue": 16097,
  "status": "done",
  "branch": "claude/issue-16097-preview-column-enrichment",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/16192",
  "premise_still_valid": true,
  "summary": "The card's premise held under measurement. Both sites re-located on current head 7d7ca6c0c (NOT the card's 1115/1367 nor triage's 1107/1401 — #16101 moved them): the preview branch returns at analytics-service.ts:1115, the ADR-0021 measure-column enrichment begins at :1367, the dimension-column header pass at :1454. Driven rather than read: one dataset, one row set, two AnalyticsService instances differing only in draftRowsResolver, so the sole difference between responses is the enrichment — preview came back with name+type only while live carried label/format/currency/percentScale/builtinAggregate and the #16101 temporal type. Fixed by extracting the column-descriptor enrichment into one enrichResultColumns seam both paths call (not a per-path copy — the same one-rule argument #16101's type correction already makes). The dimension-VALUE-label skip is left intact and its comment narrowed to say it is a statement about row values only; the test pins that fetchRecordLabels is not called at all on the preview path. TWO THINGS FOR THE PM. (1) SCOPE CALL: the measured before/after showed the dimension COLUMN header going missing too (category losing 'Category'), same cause, same seam, ~40 lines after the measure pass — the card and triage enumerate only the five measure keys, so I widened to it deliberately and said so in the PR; it is NOT the fenced skip (that one rewrites row values, this only describes columns), and I will split it out if the lane wants the narrower diff. (2) The PM's assignee field was already set to os-warren as expected; no half-state.",
  "tests": "All exit codes captured immediately after a single redirected command, never through a pipe. Union taken on final head 4636bcb2b. pnpm --filter '@objectstack/service-analytics^...' build → exit 0. pnpm --filter @objectstack/service-analytics test → exit 0, 'Test Files 95 passed (95) / Tests 2050 passed (2050)'. New file preview-column-enrichment.test.ts → exit 0, 12 passed. pnpm --filter @objectstack/service-analytics typecheck → exit 0; its FIRST run was a real red (TS2550 'Property at does not exist on type string[]' in the new test), which is positive proof this package's tsc program does reach test files rather than excluding them. Downstream consumers named explicitly: rest 186/3168, runtime 233/3312, client 33/437, all exit 0. Full workspace pnpm build → exit 0, 72/72 tasks. Repo-wide pnpm lint (eslint . --no-inline-config, NO narrowing, so no narrowing to declare) → exit 0. Gate family derived mechanically via 'node scripts/pm/dispatch-gates.mjs --repo objectstack-ai/objectstack --commands' at commit 4636bcb2b, never hand-built: 56 families, 56/56 exit 0. Two of them first answered 3 = PREREQUISITE NOT MET and were converted into real measurements rather than reported as passes: check:dual-build-cjs-loads needed the full workspace build; check:type-check-debt OOMed under --max-old-space-size=4096 (the gate itself names the caller's NODE_OPTIONS as the constraint) and was re-run at 8192, where its re-measure leg reports '140 raw tsc error(s) total, none above its recorded number'. Note on an earlier misread: my first extraction of the derivation output grabbed the 'Artifact rosters' block (39 families the tool explicitly excludes from the runnable total) instead of the owed 56; I ran those 49 too (45 exit 0, 2 NOT WIRED needing PR_NUMBER, 1 needing the objectui manifest plus a browser, 1 prerequisite) and then re-derived correctly with --commands. ABLATION: committed FIRST, then mutated. Deleted the enrichResultColumns(previewResult, ...) call from the preview branch. Predicted direction BEFORE running: every preview assertion red, the dimension-value-label fence case green, ordinary direction with no inversion since the change only ADDS descriptor keys. Mutation proven on disk by git hash-object delta e7a40f97d0e8f163b86b83d16f234b59b86ff26c → 667e7c59191d0d6d08fe152a6f2640f86bcaa73b PLUS anchored counts (preview-call anchor 1 → 0, live-path call still present at 1). Restored under trap on EXIT INT TERM with an absolute path built from git rev-parse --show-toplevel, and via 'git checkout HEAD -- ABSPATH' (never a bare checkout, which reads the polluted index). Restore proven by blob equality to HEAD (e7a40f97... == e7a40f97...) AND an empty git diff HEAD AND a clean git status. MEASURED: 11 red / 1 green, and the 1 green is exactly the fence case — the prediction held. No dist/build was involved in the ablation: the test imports '../analytics-service.js' relatively inside its own package, so vitest reads src directly, which is also why the pre-fix probe reflected source edits with no rebuild.",
  "mcp_calls": "7 — issue_read get, issue_read get_comments, add_issue_comment (claim), search_issues (REFUSED, rate limit), create_pull_request, pull_request_read, add_issue_comment (this report)",
  "open_questions": [],
  "out_of_scope_findings": [
    "NOT FILED — needs the PM to file. Two defects in packages/services/service-analytics/src/preview-evaluator.ts, both produced BEFORE any enrichment by evaluateAnalyticsQueryOverRows, so no descriptor pass can reach them. (a) aggregate() coerces with Number() and filters non-finite values, so min/max over a non-numeric field returns 0 on the draft-preview path: measured latest_spend = '2026-05-12' on live vs 0 on preview — a WRONG VALUE, not a descriptor gap, and likely the more severe of the two. (b) the fields mint types every dimension column 'string', so a time dimension is 'string' on preview and 'time' on live. Both share one statement: the preview evaluator assumes every measure is numeric and every dimension is a string. Deliberately NOT absorbed here (different class: value/producer, not column metadata) and deliberately NOT asserted in the new test, so fixing them will not red it. (a) touches this card at exactly one point, stated in the PR: latest_spend is now correctly described as type 'time' on both paths while the preview value beside it stays 0 until the evaluator is fixed — the descriptor is not withheld to accommodate a producer defect, which would be Prime Directive #12 in descriptor form.",
    "WHY NOT FILED — both write channels refused, and I would not file without a de-duplication read. Repo-scoped REST answers 403 for this session ('GitHub access is not enabled for this session. An org admin must connect the Claude GitHub App for this organization') and gh is absent — the measured 403 shape. The declared fallback is ONE targeted MCP search_issues, which answered 'API rate limit already exceeded for user ID 318460043' (the GraphQL pool). A local dedupe scan of preview-evaluator.ts and its test found no existing issue reference for either symptom, but that is not a substitute for the search. Both findings are recorded in the PR body as well, so they cannot be lost with this session."
  ]
}

Notes that do not belong in the JSON:

• The PR is draft and is left that way. Per the dispatch contract the report lands at draft-PR time; CI convergence is the PM's, and no prediction about CI state is asserted anywhere in the PR body.
• create_pull_request kept my footer and the platform appended its own _Generated by …_ block underneath, so the body carries two. Per AGENTS.md the appended block is the platform's and a body already carrying one is never re-sent — left alone rather than "repaired".
• No skip-changeset label: this PR ships a patch changeset on @objectstack/service-analytics, since it changes what POST /analytics/dataset/query with preview=draft produces.
• Worktree /home/user/objectstack-16097 is torn down after this report.

---

Generated by Claude Code