Skip to content

feat: add Kimball + UDA dimensional model for Claude Code user surface#8

Merged
alex-jadecli merged 2 commits intomainfrom
claude/investigate-uda-schemas-xVsxi
Apr 13, 2026
Merged

feat: add Kimball + UDA dimensional model for Claude Code user surface#8
alex-jadecli merged 2 commits intomainfrom
claude/investigate-uda-schemas-xVsxi

Conversation

@alex-jadecli
Copy link
Copy Markdown

Implements a Ralph Kimball star schema for Claude Code user/device/session analytics, expressed as a Netflix UDA knowledge graph with projections to GraphQL, Avro, and Zod (TypeScript Agent SDK structured output).

Domain model (domain_model.ttl):

  • 6 conformed dimensions: User (Type 2 SCD), Device, UserSurface, Model, Time, Tool
  • 3 fact tables: FactSession, FactToolUse, FactMessage
  • 7 enumerations as controlled vocabularies (PlanTier, SurfaceType, etc.)

Projections:

  • schema.graphqls: Federation-ready GraphQL with @udaUri directives
  • schema.avro: Data Mesh Avro with udaUri and pk attributes
  • kimball_dimensions.ts + kimball_facts.ts: Zod schemas for SDK output_format
  • mappings.ttl: UDA mappings connecting domain concepts to all three containers

Informed by Netflix UDA blog (onepiece example schemas) and Anthropic's knowledge graph cookbook (entity/relation extraction patterns).

https://claude.ai/code/session_01H5TrSfgA9x3vXTNYHnW4f8

Summary

Type of change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Dependency update
  • Documentation update

Test plan

  • make lint passes
  • make test-cov passes (coverage >= 90%)
  • make typecheck passes
  • Tested manually (describe below)

Checklist

  • My code follows the project conventions (see CONTRIBUTING.md)
  • I have added tests that prove my fix/feature works
  • Commit messages follow conventional commits (feat:, fix:, deps:)

claude added 2 commits April 12, 2026 15:48
Implements a Ralph Kimball star schema for Claude Code user/device/session
analytics, expressed as a Netflix UDA knowledge graph with projections to
GraphQL, Avro, and Zod (TypeScript Agent SDK structured output).

Domain model (domain_model.ttl):
  - 6 conformed dimensions: User (Type 2 SCD), Device, UserSurface, Model, Time, Tool
  - 3 fact tables: FactSession, FactToolUse, FactMessage
  - 7 enumerations as controlled vocabularies (PlanTier, SurfaceType, etc.)

Projections:
  - schema.graphqls: Federation-ready GraphQL with @udaUri directives
  - schema.avro: Data Mesh Avro with udaUri and _pk_ attributes
  - kimball_dimensions.ts + kimball_facts.ts: Zod schemas for SDK output_format
  - mappings.ttl: UDA mappings connecting domain concepts to all three containers

Informed by Netflix UDA blog (onepiece example schemas) and Anthropic's
knowledge graph cookbook (entity/relation extraction patterns).

https://claude.ai/code/session_01H5TrSfgA9x3vXTNYHnW4f8
The claude-code-action needs write access to post review comments on PRs.
The job had pull-requests: read which caused the claude-review check to fail.

https://claude.ai/code/session_01H5TrSfgA9x3vXTNYHnW4f8
@alex-jadecli alex-jadecli merged commit 6f4b3cb into main Apr 13, 2026
5 of 7 checks passed
@alex-jadecli alex-jadecli deleted the claude/investigate-uda-schemas-xVsxi branch April 13, 2026 09:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants