Skip to content

docs(intent): intent DSL reference + SDK ValidationException / checks-400#145

Open
delchev wants to merge 6 commits into
masterfrom
docs/intent-dsl-reference
Open

docs(intent): intent DSL reference + SDK ValidationException / checks-400#145
delchev wants to merge 6 commits into
masterfrom
docs/intent-dsl-reference

Conversation

@delchev

@delchev delchev commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Documentation for the intent-driven development surface.

  • Intent DSL reference page (docs/help/intent/dsl-reference.md) covering every supported construct + the planned list, with in-page anchors fixed for VitePress' slug rules.
  • SDK ValidationException (docs/sdk/db/): new reference page for org.eclipse.dirigible.sdk.db.ValidationException — thrown by client-side domain logic (declarative checks:, capacity guards, hand-written validation) to signal a business-rule violation, mapped by the controller runtime to HTTP 400. Listed in the db module index and the SDK sidebar.
  • checks: → 400: the DSL reference now states that a checks: violation returns HTTP 400 with the authored message over REST (and aborts the task completion on a workflow transition), cross-linking the SDK page.

Verified with npm run docs:build (VitePress dead-link check passes).

🤖 Generated with Claude Code

delchev and others added 6 commits July 10, 2026 15:24
…d list

Synced from the engine-intent README (eclipse-dirigible/dirigible#6228): one line + one
snippet per construct, incl. the newly landed checks, immutableIn, hierarchy/leafOnly,
views, postings, expansions, balance reports, settlements and actions - none of which the
site covered. Sidebar entry + overview link added; site builds clean.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…a single hyphen (GitHub-style '---' slugs 404 in-page)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…(snapshot case)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…n: Calendar landed

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Add the org.eclipse.dirigible.sdk.db.ValidationException reference page (a
  well-formed request that violates a business rule; mapped to HTTP 400), list it
  in the db module index, and register it in the SDK sidebar.
- DSL reference: note that a checks: violation returns HTTP 400 with the authored
  message over REST (and aborts the task completion on a workflow transition),
  cross-linking the new SDK page.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

1 participant