Skip to content

docs(intent): sync AI assistant guide with the parser implementation#6295

Merged
iliyan-velichkov merged 1 commit into
masterfrom
docs/intent-assistant-guide-sync
Jul 15, 2026
Merged

docs(intent): sync AI assistant guide with the parser implementation#6295
iliyan-velichkov merged 1 commit into
masterfrom
docs/intent-assistant-guide-sync

Conversation

@iliyan-velichkov

Copy link
Copy Markdown
Contributor

What

Reconciles components/engine/engine-intent/src/main/resources/intent-assistant-guide.md — the system prompt that powers the Intent Editor's AI assistant — with what IntentParser actually accepts. The parser + model POJOs are the single source of truth.

Why

The guide had drifted from the implementation in a few places, most notably claiming the calendar family was "reserved / not yet available" when it ships and is accepted by validateViews. Since this file is the assistant's system prompt, drift here directly degrades the suggestions users get in the editor.

Changes

  • Fix Calendar. view: calendar | range | slots, the calendar: / slots: config blocks, and function: Calendar are fully implemented (IntentParser.validateViews, CalendarIntent, SlotsIntent). Corrected the reserved-values note: the entity functions that are recognised-but-rejected are Board / Gantt / Timeline.
  • Add a "views - calendar, range, and slots" section documenting the calendar: block (start/end/title/color/scope/initialView) and the slots: block (start/open/close/step/disabledDays), plus the embedded-calendar-in-detail-pane behaviour for composition children.
  • Document assignee: personal on user tasks (routes the task to the record owner's Inbox; requires a personal: relation — the parser rejects it otherwise).
  • Document field aggregate: true (document totals footer).
  • Document scheduled generate.children (per-matched-row fan-out, e.g. a day row per working day).
  • Extend the Allowed-values table with the entity/field/relation function, entity view, report kind/chart/widget.kind, custom-widget kind, rollup op and expansion unit enums.

Verification

Every added/changed statement was checked against IntentParser.java and the model/*.java POJOs (enum sets, validateViews, validateTaskFormActions for assignee: personal, CalendarIntent/SlotsIntent field names and defaults). Content-only change to a classpath Markdown resource; no code paths affected.

🤖 Generated with Claude Code

Reconcile intent-assistant-guide.md (the Intent Editor AI assistant's
system prompt) with what IntentParser actually accepts:

- Fix Calendar: it is fully implemented (view: calendar|range|slots,
  calendar:/slots: blocks, function: Calendar), not "reserved/not yet
  available". The reserved-and-rejected entity functions are Board /
  Gantt / Timeline.
- Add a "views - calendar, range, and slots" capability section
  documenting the calendar:/slots: blocks and their keys.
- Document assignee: personal on user tasks (routes to the record
  owner's Inbox; requires a personal: relation).
- Document field aggregate: true (document totals footer).
- Document scheduled generate.children (per-matched-row fan-out).
- Extend the Allowed values table with entity/field/relation function,
  entity view, report kind/chart/widget, custom widget kind, rollup op
  and expansion unit enums.

Source of truth: IntentParser.java + the model POJOs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@iliyan-velichkov iliyan-velichkov self-assigned this Jul 15, 2026
@iliyan-velichkov
iliyan-velichkov merged commit 3492cab into master Jul 15, 2026
10 checks passed
@iliyan-velichkov
iliyan-velichkov deleted the docs/intent-assistant-guide-sync branch July 15, 2026 10:46
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