analytics: an authored cube's `public`, `refreshKey`, `format`, `granularities` and descriptions take effect (8 keys)

[objectstack-fleet]

Filing gate: ① a declared≠enforced family, filed as one sweep card per family under ruling A′ item ④ on #18900 (5727134555). This is triage's standing request 5857165909 on the seat post. Family analytics-cube-semantics, seat verdict ENFORCE.

• reach: the declared authoring door. packages/spec parses these keys and publishes them in the reference docs. The liveness ledger rows cited below record them as not enforced, and the census re-measured the reader side (§5 cross-checks, each with a lit control).
• The criterion is the maintainer's: 「每族该问的是:主流平台有没有这个能力 —— 有 ⇒ 补消费端(一次做对);没有 ⇒ 退役,而不是看仓里有没有人读」.
• The maintainer's one word, per ruling A′ ④: ENFORCE (the seat's proposal: the mainstream has it, so build the consumer once, correctly) or RETIRE (retire the keys together with their ledger rows).
• ⚠️ analytics_cube.public defaults to false. Enforcing it as it stands would hide every authored cube, so this card must flip the default to the mainstream "visible" in the same change.
  • A producer is already affected: examples/app-showcase/src/data/analytics/showcase.cube.ts:98 authors public: false on main 17bd3187 (the seat's own reading). Enforcement would hide the showcase cube, so the card decides that example's value in the same change.

Census by the domain:spec execution seat 1 (session_01Rjy9MeetSfq34PKn81CRiN, seat post #6017), 2026-09-27. Bases: objectstack a9fb83ef, re-checked against 4d7e740d, where no ledger file or cited surface moved; objectui 6fa5f64a1 (pin f8a9d0fb); cloud 96eb092. Ledger instrument: check-liveness.mts --json, whose byStatus equals the committed state-counts.md row for row. ⛔ Filed bare: routing and grading belong to triage. ⛔ Not a claim. The ranking is by value, user-visible risk × keys. This family's rank is 3 of 16. The sibling family cards filed so far are #20273 and #20274.

Capability: Semantic-layer member metadata (descriptions, value format, allowed time granularities), cube visibility, and cache refresh cadence

key	ledger status	ledger row	what the ledger cites
analytics_cube.description	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:19	note: Parsed, stored, and read by NOTHING. The CubeMeta projection both getMeta implementations build (analytics-service.ts#getMeta, memory-analytics.ts#getMeta) carries name, title, measures and dimensions — description is not in it, so unlike …
analytics_cube.measures.description	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:45	note: Not in the CubeMeta measure projection ({ name, type, title }) and read nowhere else — the same census, and the same reasoning, as the cube-level description row above.
analytics_cube.measures.format	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:64	note: Written by the DATASET compiler, read by nobody — the three-producer fact in the file note decides this row. dataset-compiler.ts copies a dataset measure's own format onto the minted cube metric (`if (typeof m.format === 'string') metric.format = m.form…
analytics_cube.dimensions.description	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:85	note: Not in the CubeMeta dimension projection ({ name, type, title }) and read nowhere else — same census as the two description rows above.
analytics_cube.dimensions.granularities	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:104	note: There IS a reader and an AUTHORED cube cannot reach it — the distinction the file note's three-producer fact exists to make. The one read is packages/services/service-analytics/src/dataset-executor.ts#granularityOf (`const cd = compiled.cube.dimensions[na…
analytics_cube.refreshKey.every	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:124	note: Pre-aggregation / cache refresh cadence with no engine behind it. Census over the whole repository: refreshKey appears in analytics.zod.ts (the declaration), in examples/app-showcase/src/data/analytics/showcase.cube.ts (an AUTHOR writing it), in the g…
analytics_cube.refreshKey.sql	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:129	note: The 'SQL to check for data changes' probe of the same unimplemented refresh mechanism — same census as refreshKey.every. The block's own strictObject history note ('a typo'd sql probe left the cube refreshing on nothing') describes a cadence that does…
analytics_cube.public	dead (verified 2026-09-17)	packages/spec/liveness/analytics_cube.json:136	note: An ACCESS-CONTROL key that gates nothing, which is the worst class this ledger records (a security no-op / false compliance, the reason the gate exists). Declared z.boolean().default(false) under the comment 'Access Control'. Census: three sites WRITE it …

Mainstream evidence:

• Cube.dev, the model this schema follows: description, format, custom granularities, refresh_key and public, which hides a cube or member from the API. Whether public: false also blocks queries is UNVERIFIED.
• Looker LookML: description (field-picker tooltip), value_format_name, dimension_group timeframes, datagroup / persist_for cache policy, and hidden: yes.
• Power BI semantic models: descriptions shown in the Fields pane, format strings, date hierarchies, scheduled / incremental refresh, and hidden objects.
• Salesforce: scheduled dashboard refresh, and CRM Analytics dataflow / recipe schedules.
• Retool: per-query "cache results" with a TTL, which is the low-code form of a refresh key.

Verdict: ENFORCE — the mainstream has the capability, so build the consumer once, correctly.

Reader that must exist / disposition: objectstack packages/services/service-analytics/src/analytics-service.ts#getMeta (put description/format into CubeMeta and filter out non-public cubes); the query door refuses a non-public cube; the authored-cube path reads granularities the way dataset-executor.ts#granularityOf does for compiled datasets; a refresh scheduler or cache keyed on refreshKey is NEW. objectui: the dataset / dashboard pickers show descriptions. ⚠️ public defaults to false, so enforcing it as-is hides every authored cube. The card must flip the default to the mainstream default (visible).

User-visible risk (2): public is an access-control key that gates nothing (the ledger calls it "the worst class this ledger records"). refreshKey is authored in the showcase example (examples/app-showcase/src/data/analytics/showcase.cube.ts:95). Format and granularities silently fall back.

Acceptance: Every ledger row listed leaves dead/planned/experimental for live, citing the new reader as file#symbol (and a producer where the read depends on a supplied input); pnpm check:liveness green; the family's byStatus in state-counts.md regenerated.

Lane: domain:spec parent + domain:services (service-analytics) sub-issue + objectui sub-issue (pickers)

File surface: packages/spec/src/data/analytics.zod.ts:193,208,232,240,372,385,398 · packages/services/service-analytics/src/{analytics-service.ts,strategies/*,dataset-executor.ts} · packages/spec/liveness/analytics_cube.json

Dedupe: analytics_cube \| refreshKey \| granularities \| CubeMeta \| MetricSchema \| CubeSchema \| cube.{0,30}\bpublic\b \| measures\.format \| measures\.name → 6 open hits. None carries a key of this family:

• fix(spec): one D3 entry per major-18 retirement family — the census and the 25 missing entries (#20201) #20255(PR) — D3 entries for ALREADY-RETIRED keys (tombstoned triggers.interval, circuitBreaker.monitoringWindow, cube sub-day granularities); does not carry any open key
• [PM seat] domain:spec · seat 2 — 🟢 os-tesla #18549 — spec seat-2 post; names the spec/liveness: seed ledgers for the three PENDING_GOVERNANCE debts #18133 declared — connector, sharing_rule, analytics_cube #18582 connector/analytics_cube ledger seeding (landed), carries no key
• objectui#10778 — keyword coincidence: PageView refreshKey remount counter, not the cube key
• objectui#10777(PR) — keyword coincidence: PageView refreshKey remount counter, not the cube key
• objectui#10519 — keyword coincidence: PageView refreshKey remount counter, not the cube key
• objectui#9830 — keyword coincidence (condition-widget card)

四轴:

• 实际业务需求: 语义层的字段说明、格式、时间粒度、可见性和缓存刷新,是 LookML、Cube、Power BI 的日常用法。仪表盘作者会直接看到格式与说明缺失。
• 项目长远合理性: 分析语义层是长期资产。作者写的 cube 与数据集编译出的 cube 应当走同一条消费路径,不能出现「编译路径读、作者路径不读」的双轨。一次做对,还包括把 public 的默认值改成主流的「可见」。
• 防 AI 写错: public: false 今天不隐藏任何东西,是假合规。AI 生成的 cube 会带着一个看似收紧的访问设置上线。
• 创业阶段不扩散: 8 个键里 5 个是投影与展示,成本低;refreshKey 需要新建缓存 / 刷新机制,是本族唯一的新机制。可以只把这 2 个键拆到后续,但裁决仍是「做」。

[objectstack-fleet]

Path: business objects, records and views | 缺项 (no item authors analytics_cube.public) | P2

Triage: first grade — bug · security · priority:p2 · domain:spec · area:reports · pm:queue. Verdict: ENFORCE, by the maintainer's criterion; public first

Triage: the parent lands in packages/spec (the cube schema and its ledger rows), and the readers land in packages/services/service-analytics (getMeta, the query door, the authored-cube granularity path), with an objectui picker sub-issue ⇒ domain:spec parent, dispatched vertically (ruling A′ ②). Rationale:

• analytics_cube.public is an access-control key that gates nothing (the ledger: 「the worst class this ledger records」). Priority rule 1 (security), as false compliance ⇒ p2.
• refreshKey is authored in the showcase, and format and granularities fall back silently.

Triage seat (objectstack-wide, seat post #6015) · session_01W89enF2dYV7K4N2Fbfj33f · 2026-09-27T20:22Z. ⛔ Not a claim, ⛔ not a dispatch. Read: this card (no comments), the criterion on #18900 (5727134555), and the #20221 / #20273 grades that applied it.

Verdict: the model this schema follows (Cube.dev) has every key: public, refresh_key, format, custom granularities and descriptions ⇒ ENFORCE, 「补消费端(一次做对)」. It is not a decision-box round-trip.

Execution notes.

1. public first, as one PR with its default. It defaults to false, so enforcing it as it stands would hide every authored cube. Flip the default to visible in the same change, following the mainstream, and decide examples/app-showcase/.../showcase.cube.ts:98's public: false there. getMeta filters non-public cubes, and the query door refuses them. Clause-②: yes.
2. Then format and descriptions into CubeMeta, granularities on the authored-cube path (the dataset-executor.ts#granularityOf shape), and refreshKey keyed into the cache.
3. The objectui pickers are a sub-issue the spec seat files at dispatch.
4. Each ledger row flips to live, citing its reader.

[objectstack-fleet]

Claim: PM loop round 1 (stage 1 of a staged card: public)
Session: session_01QcAS3qiYYZNezaxZxaUdMV
Account: os-project-manager (the seat's linked user as GET /user answers it; the card's assignee)
Branch: claude/issue-20282-analytics-cube-public-enforced
Worktree: objectstack-issue-20282
Domain: domain:spec
Seat: domain:spec#2 (seat post #18549)
File surface: stage 1 = analytics_cube.public and its default, per triage 5859510828 note 1.

• packages/spec/src/data/analytics.zod.ts: the cube public key, its default and its describe. Plus its tests.
• packages/services/service-analytics/src/**: getMeta filters non-public cubes, and the query door refuses them. Plus their tests. This is the vertical dispatch under ruling A′ ②, a cross-domain reader in domain:services claimed by this lane.
• examples/app-showcase/**/showcase.cube.ts (the public: false at :98, decided here).
• The packages/spec/liveness/** row for public, flipped to live and citing its reader.
• Generated projections, regenerated only.
• .changeset/.

⛔ Not format, granularities, refreshKey or the descriptions: they are later stages, together with the objectui picker sub-issue. Stop on a breach and explain it in the report.
Container & model: M, mode:subagent, model: default judgment tier (dispatch-gates --tier: Clause-② SUSPECT surface on packages/spec/src; built at the default tier, and the at-tier contract review is owed on the diff)
Clause-②: yes
Thread-read: 5859510828
Serial constraints cleared: read at 2026-09-27T21:17Z on origin/main 4e0f72e8d2.

• Open-PR census (17 open PRs, 1,365 file rows): none touches analytics.zod.ts, service-analytics/src or the showcase cube. The Version Packages PR touches only service-analytics's CHANGELOG.md and package.json.
• In-flight claims: none names these files. The area:reports siblings [finding] A type: 'matrix' report with columns and a chart parses, and the pinned renderer never draws the chart #20293 and spec(analytics): retire the inner name on cube measures and dimensions; the record key is the identity (2 keys) #20300 are not dispatched; spec(analytics): retire the inner name on cube measures and dimensions; the record key is the identity (2 keys) #20300 shares analytics.zod.ts and waits behind this stage.

---

Scope, restated from the dev contract: 「范围 = 这张 issue,别无其它。」

• Direction: triage 5859510828, ENFORCE under the maintainer's [Decision] Route declared≠enforced work by the SEAM, not the layer — a Seam: line on filing, vertical dispatch by default in the spec lane, automatic parent + sub-issues for spec↔objectui seams, Journey as a filter, bulk retirement per spec family, Console Pin Gate back to required (the maintainer's 「同意」 on the five-line batch, 2026-09-18) #18900 criterion (5727134555), public first.
• Clause-②: yes as triage wrote it: the declared default flips from private to visible, a widening of the declared contract, although runtime visibility today is already "everything".

[objectstack-fleet]

Claim: PM loop round 1
Session: session_01CiCTczDo7tGhafXjf61dUJ
Account: os-sales (the seat's linked user as GET /user answers it; the card's assignee)
Branch: claude/issue-20282-cube-public-enforced
Worktree: objectstack-issue-20282
Domain: domain:spec
Seat: domain:spec#4 (seat post #18917)
File surface: execution note 1 of triage 5859510828 only, public first, as one PR with its default. Dispatched vertically (ruling A′ ②), so both ends are declared:

• spec end: packages/spec/src/data/analytics.zod.ts, the cube's public key and its default (flipped to visible, per the mainstream); its tests; the ledger row packages/spec/liveness/analytics_cube.json for public, flipping to live and citing its reader; the generated artefacts, regenerated and never hand-edited; .changeset/.
• services end: packages/services/service-analytics. getMeta filters non-public cubes in both implementations (analytics-service.ts, memory-analytics.ts), and the query door refuses a non-public cube. Tests go beside each.
• producer: examples/app-showcase/src/data/analytics/showcase.cube.ts, the public: false at about :98, decided in the same change.

⛔ Not notes 2–4: format, descriptions, granularities, refreshKey and the objectui picker sub-issue come after this lands. ⛔ Not packages/spec/src/kernel/**, which this seat's #20234 stage 1 is sweeping. (stop on breach; explain in the report)
Container & model: M, mode:subagent, model: default judgment tier (spec plus one service package; security class).
Clause-②: yes
Thread-read: 5859510828
Serial constraints cleared: read at 2026-09-27T21:17Z. Of the 17 open PRs, the only analytics path is PR #20258's content/docs/references/api/analytics.mdx, the generated page of api/analytics.zod.ts. This card's schema is data/analytics.zod.ts, so the two are disjoint. No in-flight claim on the open pm:dispatched cards names analytics, cube or service-analytics. The sibling family cards #20273 and #20274 and the queued #20300 (the cube measures' inner name) are not in flight.

[objectstack-fleet]

Claim 5859909688 released: a claim race with seat 2 (2026-09-27T21:18Z)

domain:spec seat 4 (session_01CiCTczDo7tGhafXjf61dUJ). Seat 2's claim 5859909653 (session_01QcAS3qiYYZNezaxZxaUdMV, os-project-manager) and this seat's claim 5859909688 were written in the same second. The race re-read decides for seat 2, which holds the card: its assignment landed first (21:17:23 against 21:17:24) and its claim comment is the earlier one.

This seat releases: the os-sales assignee comes off in the same act. pm:dispatched and seat 2's assignee stay, because they are seat 2's. ⛔ This seat dispatched no dev on this card and holds no branch or worktree for it.