Skip to content

TML-2956: accept ADR 231 and close project workspace - #30149

Merged
SevInf merged 2 commits into
mainfrom
tml-2956-close-typed-attribute-parsers
Aug 27, 2026
Merged

TML-2956: accept ADR 231 and close project workspace#30149
SevInf merged 2 commits into
mainfrom
tml-2956-close-typed-attribute-parsers

Conversation

@StevenMcClankerton

@StevenMcClankerton StevenMcClankerton commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Linked issue

Refs TML-2956.

Summary

Closes the typed attribute parsers project after the SQL and Mongo interpreter migrations landed. ADR 231 now records the accepted architecture as implemented, while the completed project coordination workspace is removed.

Changes

  • ADR 231: Reconciles the decision with the shipped ArgType, InterpretCtx, collection, reference, oneOf, and typed funcCall APIs. It documents dynamic SQL default and Mongo index specs, accepts the interpreter architecture, and separates current behavior from the language-tooling follow-up.
  • Project close-out: Removes 44 transient specs, plans, and dispatch briefs after classifying the architecture as the only durable output.

Project DoD verification

  • The attribute-spec kit and SQL @relation landed in #891.
  • The remaining non-default SQL attributes landed in #932.
  • Dynamic SQL @default specs and typed function calls landed in #938.
  • Mongo attributes landed in #29833.
  • The mandatory final retro completed; its durable architectural conclusions are incorporated into ADR 231.
  • Language-server consumption remains an explicit follow-up under the Language Tools project.

Testing performed

  • pnpm lint:deps — no dependency violations across 2,010 modules and 3,121 dependencies.
  • pnpm build — 85/85 tasks passed.
  • pnpm fixtures:check — passed with no generated drift.
  • git diff --check — passed.

Skill update

n/a — this PR closes project documentation and reconciles an ADR. The user-facing Mongo syntax migration and executable upgrade instructions landed in #29833.

Checklist

  • All commits are signed off (git commit -s) per the DCO.
  • I read CONTRIBUTING.md and the change is scoped to one logical concern.
  • Tests are updated or not required for the documentation/deletion-only close-out diff.
  • The PR title is in TML-NNNN: <sentence-case title> form.
  • The Skill update section is filled in.

Notes for the reviewer

The large deletion is entirely transient project coordination material. ADR 231 is the only retained document and intentionally distinguishes the interpreter implementation from central spec discovery and language-server traversal that have not shipped yet.

Summary by CodeRabbit

  • Documentation
    • Updated the attribute specification architecture decision record to reflect its accepted status.
    • Clarified the current scope, including interpreter-owned specifications and typed parsing for SQL and Mongo.
    • Documented deferred follow-up work for central registration and language-server integration.
    • Simplified the documented combinator approach and revised related examples and alternatives.

SevInf added 2 commits August 27, 2026 14:27
Signed-off-by: Steven McClankerton <tatarintsev@prisma.io>
Signed-off-by: Steven McClankerton <tatarintsev@prisma.io>
@StevenMcClankerton
StevenMcClankerton requested a review from a team as a code owner August 27, 2026 14:31
@coderabbitai

coderabbitai Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro Plus

Run ID: 83e909e4-9402-4d43-9031-6ad8578b5a58

📥 Commits

Reviewing files that changed from the base of the PR and between 878e673 and 99e64d6.

⛔ Files ignored due to path filters (44)
  • projects/typed-attribute-parsers/plan.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/02-combinators.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/03-migrate-relation.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/04-address-review-r1.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/06-oneof-identifier.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/07-adr-reconcile.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/08-address-review-r2.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/09-prune-comments.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/10-unify-duplicate-check.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/11-vocab-ratchet.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/12-vocab-allowlist.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/13-comment-revision.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/dispatches/14-unite-diagnostic-code.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/plan.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/attribute-spec-kit/spec.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/dispatches/01-mongo-wiring-map.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/dispatches/02-mongo-relation.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/dispatches/03-mongo-polymorphism.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/dispatches/04-kit-str-value-json.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/dispatches/05-mongo-index.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/dispatches/06-mongo-textindex-cleanup.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/plan.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/mongo-attributes/spec.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/dispatches/01-model-attribute-kit.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/dispatches/02-map.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/dispatches/03-id-unique.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/dispatches/04-index.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/dispatches/05-control.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/dispatches/06-polymorphism.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/plan.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-attributes/spec.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/01-kit-scalar-funccall.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/02-migrate-nonenum.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/03-migrate-enum.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/04-delete-legacy-funccall-parser.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/05-dynamic-nonenum.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/06-dynamic-enum.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/07-remove-superseded-combinators.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/08-funccall-signatures-kit.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/09-typed-funccall-signatures.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/dispatches/10-remove-raw-funccall.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/plan.md is excluded by !projects/**
  • projects/typed-attribute-parsers/slices/sql-default/spec.md is excluded by !projects/**
  • projects/typed-attribute-parsers/spec.md is excluded by !projects/**
📒 Files selected for processing (1)
  • docs/architecture docs/adrs/ADR 231 - Declarative attribute specifications.md

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.


📝 Walkthrough

Walkthrough

The ADR changes from Proposed to Accepted. It narrows implementation scope to interpreter-owned SQL and Mongo specifications, revises the combinator and typed function-call model, updates examples and policies, and records deferred language-tooling work.

Changes

Declarative attribute specifications

Layer / File(s) Summary
Accepted scope and core contracts
docs/architecture docs/adrs/ADR 231 - Declarative attribute specifications.md
The ADR defines the accepted scope, revised design principles, ArgType, InterpretCtx, AttributeSpec, and InferAttr<S> behavior.
Combinator and function-call model
docs/architecture docs/adrs/ADR 231 - Declarative attribute specifications.md
Scalar, reference, collection, JSON, alternative, and typed function-call specifications are revised. Removed combinators and arktype-backed leaves are documented as excluded.
SQL and Mongo application rules
docs/architecture docs/adrs/ADR 231 - Declarative attribute specifications.md
SQL defaults, Mongo index elements, refinement timing, surface policies, and storage-type authoring are updated.
Consequences and follow-up
docs/architecture docs/adrs/ADR 231 - Declarative attribute specifications.md
Deferred language-tooling work, additional follow-up items, consequences, alternatives, and references are revised.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to 99e64

This PR reconciles an architecture document and removes completed project coordination files without changing product behavior; the reported validation checks passed, and no actionable merge-blocking risk remains.

Suggested reviewers: sevinf

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the two main changes: accepting ADR 231 and closing the project workspace.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch tml-2956-close-typed-attribute-parsers

Comment @coderabbitai help to get the list of available commands.

@SevInf
SevInf added this pull request to the merge queue Aug 27, 2026
Merged via the queue into main with commit ee57306 Aug 27, 2026
19 checks passed
@SevInf
SevInf deleted the tml-2956-close-typed-attribute-parsers branch August 27, 2026 15:07
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