Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

fix(forms): consistently call answer checks gates (#8490)

Wolf Mermelstein00d88d1dbfa0
diff --git a/apps/docs/AGENTS.md b/apps/docs/AGENTS.md
index d49c7e1353..7f69ff601f 100644
--- a/apps/docs/AGENTS.md
+++ b/apps/docs/AGENTS.md
@@ -20,6 +20,7 @@ expose.
## Terminology
+- Call a form’s conditional answer check a **gate** in UI copy, AI tools, and docs.
- A **block** is the core unit in Macro (doc, email, channel, task, call, canvas, etc.). Use "block", not "module" or "app"
- Use **@mention** (not "at-mention" or "tag") for references created with `@`
- Use **channel** (not "chat room"), **agent** (not "bot"), and **workspace** for a user's whole Macro environment
diff --git a/apps/docs/AI/mcp/tools/create-form.mdx b/apps/docs/AI/mcp/tools/create-form.mdx
index b3abc0002a..15c4c74a7c 100644
--- a/apps/docs/AI/mcp/tools/create-form.mdx
+++ b/apps/docs/AI/mcp/tools/create-form.mdx
@@ -1,13 +1,13 @@
---
title: CreateForm
description: >-
- Create a complete questionnaire with response columns, ordered sections,
- screeners and an optional saved booking link.
+ Create a complete questionnaire with response columns, ordered sections, gates
+ and an optional saved booking link.
---
# CreateForm
-Create a complete questionnaire with response columns, ordered sections, screeners and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in screeners and reference only earlier sections. Required questions require an answer; screeners compare answers using AND/OR. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating.
+Create a complete questionnaire with response columns, ordered sections, gates and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in gates and reference only earlier sections. Required questions require an answer; gates compare answers using AND/OR. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating.
## Parameters
diff --git a/apps/docs/AI/mcp/tools/edit-form.mdx b/apps/docs/AI/mcp/tools/edit-form.mdx
index 3197959f16..0028268fb6 100644
--- a/apps/docs/AI/mcp/tools/edit-form.mdx
+++ b/apps/docs/AI/mcp/tools/edit-form.mdx
@@ -6,7 +6,7 @@ description: >-
# EditForm
-Edit the live form using typed targeted operations. ReadForm provides stable question/section IDs. Edits produce granular CRDT updates; concurrent changes merge using the same rules as the builder. Omitted fields stay unchanged. Invalid merged layouts are refused. Changes can add or move questions/sections, edit requiredness/help/screeners and attach an existing booking target. New columns use explicit stable IDs. Question labels follow backing column names; rename them through database tools. Removing a question keeps its column and answers. Schema retyping and conditional column cleanup are unsupported. Keep screeners after the questions they test and booking last. Read the current form after a timeout or partial result before proceeding. Opening and sharing require SetFormAccess.
+Edit the live form using typed targeted operations. ReadForm provides stable question/section IDs. Edits produce granular CRDT updates; concurrent changes merge using the same rules as the builder. Omitted fields stay unchanged. Invalid merged layouts are refused. Changes can add or move questions/sections, edit requiredness/help/gates and attach an existing booking target. New columns use explicit stable IDs. Question labels follow backing column names; rename them through database tools. Removing a question keeps its column and answers. Schema retyping and conditional column cleanup are unsupported. Keep gates after the questions they test and booking last. Read the current form after a timeout or partial result before proceeding. Opening and sharing require SetFormAccess.
## Parameters
diff --git a/apps/web/src/features/block-form/components/builder/booking-card.tsx b/apps/web/src/features/block-form/components/builder/booking-card.tsx
index c71e22923a..b4adf015bc 100644
--- a/apps/web/src/features/block-form/components/builder/booking-card.tsx
+++ b/apps/web/src/features/block-form/components/builder/booking-card.tsx
@@ -138,7 +138,7 @@ export type BookingLinkState =
/**
* The booking step: always last, shown to respondents only after their
- * response is saved and has passed every screener.
+ * response is saved and has passed every gate.
*/
export function BookingCard(props: {
sectionId: string;
@@ -236,9 +236,8 @@ export function BookingCard(props: {
</div>
<p class="text-[11px] text-ink-muted">
Respondents see this calendar only after their response is saved and
- passes every screener. Anyone who already has the booking link can
- still book it directly. Removing this step keeps the link and its
- bookings.
+ passes every gate. Anyone who already has the booking link can still
+ book it directly. Removing this step keeps the link and its bookings.
</p>
</div>
</section>
diff --git a/apps/web/src/features/block-form/components/builder/booking-link-dialog.tsx b/apps/web/src/features/block-form/components/builder/booking-link-dialog.tsx
index 0d551b0979..5ffd24761a 100644
--- a/apps/web/src/features/block-form/components/builder/booking-link-dialog.tsx
+++ b/apps/web/src/features/block-form/components/builder/booking-link-dialog.tsx
@@ -30,7 +30,7 @@ export function BookingLinkDialog(props: {
Choose a booking link
</Dialog.Title>
<Dialog.Description class="text-sm text-ink-muted">
- Respondents can book after passing this form’s screeners.
+ Respondents can book after passing this form’s gates.
</Dialog.Description>
<div class="flex max-h-[50dvh] flex-col gap-1 overflow-y-auto">
<Switch>
diff --git a/apps/web/src/features/block-form/components/builder/section-card.tsx b/apps/web/src/features/block-form/components/builder/section-card.tsx
index 9450f73cc6..dd4042d65e 100644
--- a/apps/web/src/features/block-form/components/builder/section-card.tsx
+++ b/apps/web/src/features/block-form/components/builder/section-card.tsx
@@ -188,8 +188,8 @@ export function GateCard(props: {
<span>{props.eyebrow}</span>
</div>
<LiveTextInput
- aria-label="Screener title"
- placeholder="Untitled screener"
+ aria-label="Gate title"
+ placeholder="Untitled gate"
value={props.title}
maxlength={200}
class="h-8 w-full rounded-md border border-transparent bg-transparent px-1.5 text-base font-semibold text-ink outline-none placeholder:text-ink-placeholder hover:border-edge-muted focus:border-edge-focus focus:bg-input"
@@ -206,8 +206,8 @@ export function GateCard(props: {
>
<span class="flex-1">
{props.brokenRules === 1
- ? 'A rule checks a question that is no longer before this screener. Responses are refused until it is fixed.'
- : `${props.brokenRules} rules check questions that are no longer before this screener. Responses are refused until they are fixed.`}
+ ? 'A rule checks a question that is no longer before this gate. Responses are refused until it is fixed.'
+ : `${props.brokenRules} rules check questions that are no longer before this gate. Responses are refused until they are fixed.`}
</span>
<Button variant="outline" size="sm" onClick={props.onRepair}>
Remove broken rules
@@ -218,8 +218,8 @@ export function GateCard(props: {
when={!props.noQuestionsBefore}
fallback={
<p class="rounded-lg border border-edge-muted bg-surface px-3 py-2 text-xs text-ink-muted">
- A screener checks answers from the sections before it. Move it
- below a section with questions to add rules.
+ A gate checks answers from the sections before it. Move it below a
+ section with questions to add rules.
</p>
}
>
diff --git a/apps/web/src/features/block-form/context/form-context.tsx b/apps/web/src/features/block-form/context/form-context.tsx
index a84ca28a15..4016c1a44e 100644
--- a/apps/web/src/features/block-form/context/form-context.tsx
+++ b/apps/web/src/features/block-form/context/form-context.tsx
@@ -196,7 +196,7 @@ export type MyResponse = {
status: 'submitted' | 'stopped';
submittedAt: string;
answers: SubmittedAnswer[];
- /** The booking step, while the saved answers still pass the form's screeners. */
+ /** The booking step, while the saved answers still pass the form's gates. */
booking: UnlockedBooking | null;
};
diff --git a/apps/web/src/features/block-form/core/form-layout.test.ts b/apps/web/src/features/block-form/core/form-layout.test.ts
index c5b9aeec4d..35ac9dacb8 100644
--- a/apps/web/src/features/block-form/core/form-layout.test.ts
+++ b/apps/web/src/features/block-form/core/form-layout.test.ts
@@ -318,7 +318,7 @@ describe('broken gate rules', () => {
expect(brokenGateColumns(offsite(), GATE)).toEqual([]);
});
- it('keeps edits open around a screener whose question went in the grid', () => {
+ it('keeps edits open around a gate whose question went in the grid', () => {
const layout: FormLayout = {
sections: offsite().sections.map((section) =>
section.id === ABOUT
@@ -649,7 +649,7 @@ describe('booking step', () => {
)._unsafeUnwrap();
}
- it('adds a booking step after every question and screener, whatever index it was given', () => {
+ it('adds a booking step after every question and gate, whatever index it was given', () => {
const layout = addSection(
offsite(),
{
@@ -682,7 +682,7 @@ describe('booking step', () => {
]);
});
- it('inserts new sections and screeners before the booking step', () => {
+ it('inserts new sections and gates before the booking step', () => {
const layout = addSection(
withBooking(),
{
@@ -725,7 +725,7 @@ describe('booking step', () => {
).toEqual({ kind: 'booking-must-be-last', sectionId: BOOKING });
});
- it('refuses moving the booking step ahead of a screener, or a section after it', () => {
+ it('refuses moving the booking step ahead of a gate, or a section after it', () => {
expect(moveSection(withBooking(), BOOKING, 1)._unsafeUnwrapErr()).toEqual({
kind: 'booking-must-be-last',
sectionId: BOOKING,
diff --git a/apps/web/src/features/block-form/core/form-layout.ts b/apps/web/src/features/block-form/core/form-layout.ts
index 2c1ef3a2de..55ee566e3d 100644
--- a/apps/web/src/features/block-form/core/form-layout.ts
+++ b/apps/web/src/features/block-form/core/form-layout.ts
@@ -19,7 +19,7 @@ export type LayoutRefusal =
| { kind: 'unknown-section'; sectionId: string }
| { kind: 'gate-section'; sectionId: string }
| { kind: 'booking-section'; sectionId: string }
- /** The booking step is unique and comes after every question and screener. */
+ /** The booking step is unique and comes after every question and gate. */
| { kind: 'booking-must-be-last'; sectionId: string }
| { kind: 'column-on-form'; columnId: string }
| {
@@ -120,7 +120,7 @@ function layoutProblems(layout: FormLayout): LayoutRefusal[] {
/**
* The edited layout, or the first problem the edit brings. Problems the
- * layout already had (two booking steps added concurrently, a screener whose
+ * layout already had (two booking steps added concurrently, a gate whose
* question went in the grid) do not block edits, so they stay repairable.
*/
function checkedEdit(
diff --git a/apps/web/src/features/block-form/core/form-model.ts b/apps/web/src/features/block-form/core/form-model.ts
index 67435a9fbc..d5d0e58c30 100644
--- a/apps/web/src/features/block-form/core/form-model.ts
+++ b/apps/web/src/features/block-form/core/form-model.ts
@@ -26,7 +26,7 @@ export type FormBookingTarget = { profileId: string; eventTypeId: string };
/**
* The booking step a response unlocked: only the server hands out its
- * target, once the response is saved and has passed every screener.
+ * target, once the response is saved and has passed every gate.
*/
export type UnlockedBooking = {
sectionId: string;
diff --git a/apps/web/src/features/block-form/core/layout-messages.test.ts b/apps/web/src/features/block-form/core/layout-messages.test.ts
index 408b23a8cb..2091954f4c 100644
--- a/apps/web/src/features/block-form/core/layout-messages.test.ts
+++ b/apps/web/src/features/block-form/core/layout-messages.test.ts
@@ -37,19 +37,17 @@ describe('sectionName', () => {
it('numbers question sections and gates separately, as their cards do', () => {
expect(sectionName(layout, 'about')).toBe('About you');
expect(sectionName(layout, 'logistics')).toBe('Section 2');
- expect(sectionName(layout, 'first-gate')).toBe('Screener 1');
- expect(sectionName(layout, 'second-gate')).toBe('Screener 2');
+ expect(sectionName(layout, 'first-gate')).toBe('Gate 1');
+ expect(sectionName(layout, 'second-gate')).toBe('Gate 2');
});
});
describe('routingLine', () => {
it('names the gates checked on the way, and a trailing gate before submitting', () => {
expect(routingLine(layout, 'about')).toBe(
- 'Check screener, then continue to section 2'
- );
- expect(routingLine(layout, 'logistics')).toBe(
- 'Check screener, then submit'
+ 'Check gate, then continue to section 2'
);
+ expect(routingLine(layout, 'logistics')).toBe('Check gate, then submit');
expect(
routingLine({ sections: [section('only', 'questions')] }, 'only')
).toBe('Submit form');
@@ -82,7 +80,7 @@ describe('booking step', () => {
it('is named Booking until titled, and the last section submits then books', () => {
expect(sectionName(booked, 'call')).toBe('Booking');
expect(routingLine(booked, 'about')).toBe(
- 'Check screener, then submit and book a time'
+ 'Check gate, then submit and book a time'
);
expect(
routingLine(
@@ -108,7 +106,7 @@ describe('booking step', () => {
names
)
).toBe(
- 'The booking step comes last, after every question and screener. Move “Booking” to the end.'
+ 'The booking step comes last, after every question and gate. Move “Booking” to the end.'
);
expect(
layoutRefusalMessage(
diff --git a/apps/web/src/features/block-form/core/layout-messages.ts b/apps/web/src/features/block-form/core/layout-messages.ts
index 53b82f57c3..0f8c71532d 100644
--- a/apps/web/src/features/block-form/core/layout-messages.ts
+++ b/apps/web/src/features/block-form/core/layout-messages.ts
@@ -30,7 +30,7 @@ export function sectionName(layout: FormLayout, sectionId: string): string {
const position = sectionPosition(layout, sectionId);
return match(section.kind)
.with('questions', () => `Section ${position}`)
- .with('gate', () => `Screener ${position}`)
+ .with('gate', () => `Gate ${position}`)
.with('booking', () => 'Booking')
.exhaustive();
}
@@ -43,7 +43,7 @@ export function routingLine(layout: FormLayout, sectionId: string): string {
const gates = (nextAt < 0 ? later : later.slice(0, nextAt)).filter(
(item) => item.kind === 'gate'
).length;
- const check = gates === 1 ? 'Check screener' : `Check ${gates} screeners`;
+ const check = gates === 1 ? 'Check gate' : `Check ${gates} gates`;
if (nextAt < 0) {
const booking = later.some((item) => item.kind === 'booking');
if (gates > 0)
@@ -71,7 +71,7 @@ export function layoutRefusalMessage(
)
.with(
{ kind: 'gate-section' },
- () => 'A screener holds rules, not questions. Drop it in a section.'
+ () => 'A gate holds rules, not questions. Drop it in a section.'
)
.with(
{ kind: 'booking-section' },
@@ -81,7 +81,7 @@ export function layoutRefusalMessage(
.with(
{ kind: 'booking-must-be-last' },
({ sectionId }) =>
- `The booking step comes last, after every question and screener. Move “${names.section(sectionId)}” to the end.`
+ `The booking step comes last, after every question and gate. Move “${names.section(sectionId)}” to the end.`
)
.with(
{ kind: 'column-on-form' },
diff --git a/apps/web/src/features/block-form/primitives/create-builder.test.ts b/apps/web/src/features/block-form/primitives/create-builder.test.ts
index d8611a71b5..ad4dd23a14 100644
--- a/apps/web/src/features/block-form/primitives/create-builder.test.ts
+++ b/apps/web/src/features/block-form/primitives/create-builder.test.ts
@@ -456,7 +456,7 @@ describe('createBuilder', () => {
builder.removeQuestion('q-team');
expect(builder.selectedId()).toBe('q-name');
expect(builder.layout()?.sections[1].gateRules?.conditions).toEqual([]);
- expect(notices).toEqual(['✓ Removed 1 screener rule that checked it.']);
+ expect(notices).toEqual(['✓ Removed 1 gate rule that checked it.']);
expect(calls).toEqual([]);
expect(builder.hiddenColumns().map((column) => column.name)).toEqual([
'Team',
@@ -820,28 +820,28 @@ describe('the booking step', () => {
});
});
- it('puts new sections and screeners before the booking step and keeps it last when reordering', async () => {
+ it('puts new sections and gates before the booking step and keeps it last when reordering', async () => {
const { writes } = fakeWrites();
await createRoot(async (dispose) => {
const { builder, notices } = setup({ writes });
const { sectionId } = builder.addBooking(INTRO_CALL) ?? {};
builder.focusSection('details');
const travel = builder.addSection('questions');
- const screener = builder.addSection('gate');
+ const gate = builder.addSection('gate');
expect(builder.layout()?.sections.map((section) => section.id)).toEqual([
'about',
'gate',
'details',
travel,
- screener,
+ gate,
sectionId,
]);
expect(builder.sectionMoveRefusal('details', 5)).toBe(
- 'The booking step comes last, after every question and screener. Move “Book a time” to the end.'
+ 'The booking step comes last, after every question and gate. Move “Book a time” to the end.'
);
expect(builder.moveSection(sectionId ?? '', 0)).toBe(false);
expect(notices).toEqual([
- '✗ The booking step comes last, after every question and screener. Move “Book a time” to the end.',
+ '✗ The booking step comes last, after every question and gate. Move “Book a time” to the end.',
]);
dispose();
});
diff --git a/apps/web/src/features/block-form/primitives/create-builder.ts b/apps/web/src/features/block-form/primitives/create-builder.ts
index d10d6425c9..428b580861 100644
--- a/apps/web/src/features/block-form/primitives/create-builder.ts
+++ b/apps/web/src/features/block-form/primitives/create-builder.ts
@@ -332,8 +332,8 @@ export function createBuilder(options: BuilderOptions) {
if (committed && pruned > 0)
options.notify.success(
pruned === 1
- ? 'Removed 1 screener rule that checked it.'
- : `Removed ${pruned} screener rules that checked it.`
+ ? 'Removed 1 gate rule that checked it.'
+ : `Removed ${pruned} gate rules that checked it.`
);
return committed;
}
diff --git a/apps/web/src/features/block-form/primitives/create-respond.test.ts b/apps/web/src/features/block-form/primitives/create-respond.test.ts
index 1d84c0129f..85cb6071f6 100644
--- a/apps/web/src/features/block-form/primitives/create-respond.test.ts
+++ b/apps/web/src/features/block-form/primitives/create-respond.test.ts
@@ -118,7 +118,7 @@ function offsite(): FormDetail {
const now = () => new Date('2026-10-01T12:00:00Z');
describe('createRespond', () => {
- it('previews a closed form, validates required answers and screeners, and never reads or writes a response', async () => {
+ it('previews a closed form, validates required answers and gates, and never reads or writes a response', async () => {
const detail: FormDetail = {
form: {
id: 'preview-form',
@@ -156,7 +156,7 @@ describe('createRespond', () => {
],
},
{
- id: 'screener',
+ id: 'gate',
kind: 'gate',
title: 'Eligibility',
description: '',
diff --git a/apps/web/src/features/block-form/queries/form-layout-collaboration.test.ts b/apps/web/src/features/block-form/queries/form-layout-collaboration.test.ts
index 4dbc27bff2..63050c2ed9 100644
--- a/apps/web/src/features/block-form/queries/form-layout-collaboration.test.ts
+++ b/apps/web/src/features/block-form/queries/form-layout-collaboration.test.ts
@@ -17,12 +17,12 @@ describe('flushFailureOf', () => {
flushFailureOf(
new FormFlushError({
kind: 'publication',
- message: 'Screener “Eligibility” checks a question asked after it.',
+ message: 'Gate “Eligibility” checks a question asked after it.',
})
)
).toEqual({
message:
- 'Respondents still see the last valid version of this form. Screener “Eligibility” checks a question asked after it.',
+ 'Respondents still see the last valid version of this form. Gate “Eligibility” checks a question asked after it.',
refusal: 'invalid-layout',
});
expect(flushFailureOf(new Error('socket closed')).message).toBe(
diff --git a/apps/web/src/features/block-form/queries/form-publication.test.ts b/apps/web/src/features/block-form/queries/form-publication.test.ts
index 09be3f9dee..86f8c87f40 100644
--- a/apps/web/src/features/block-form/queries/form-publication.test.ts
+++ b/apps/web/src/features/block-form/queries/form-publication.test.ts
@@ -46,7 +46,7 @@ const detail: FormCollaboration['detail'] = {
};
describe('publicationMessage', () => {
- it('names the affected question and uses screener wording', () => {
+ it('names the affected question and uses gate wording', () => {
expect(
publicationMessage({
detail,
@@ -55,7 +55,7 @@ describe('publicationMessage', () => {
problem: { kind: 'gateNamesLaterColumn', column: 'column' },
},
})
- ).toBe('“Name” must come before the screener that checks it.');
+ ).toBe('“Name” must come before the gate that checks it.');
expect(
publicationMessage({
detail,
diff --git a/apps/web/src/features/block-form/queries/form-publication.ts b/apps/web/src/features/block-form/queries/form-publication.ts
index 801dd662b9..3275fa57dd 100644
--- a/apps/web/src/features/block-form/queries/form-publication.ts
+++ b/apps/web/src/features/block-form/queries/form-publication.ts
@@ -39,7 +39,7 @@ export function publicationMessage(
match(problem)
.with(
{ kind: 'bookingMustBeLast' },
- () => 'Keep one booking step after all questions and screeners.'
+ () => 'Keep one booking step after all questions and gates.'
)
.with(
{ kind: 'unknownColumn' },
@@ -64,12 +64,11 @@ export function publicationMessage(
.with(
{ kind: 'gateNamesLaterColumn' },
({ column }) =>
- `${columnName(column)} must come before the screener that checks it.`
+ `${columnName(column)} must come before the gate that checks it.`
)
.with(
{ kind: 'gateRule' },
- () =>
- 'Review your screener rules; one no longer matches its question.'
+ () => 'Review your gate rules; one no longer matches its question.'
)
.with(
{ kind: 'textTooLong' },
diff --git a/apps/web/src/features/block-form/views/builder-view.test.tsx b/apps/web/src/features/block-form/views/builder-view.test.tsx
index ea5bf785a1..f7583a45e0 100644
--- a/apps/web/src/features/block-form/views/builder-view.test.tsx
+++ b/apps/web/src/features/block-form/views/builder-view.test.tsx
@@ -712,10 +712,10 @@ describe('BuilderView', () => {
it('says respondents still see the last valid version while the layout can’t be published', () => {
const { shared } = mount();
shared.setPublicationError(
- 'Screener “Eligibility” checks a question asked after it.'
+ 'Gate “Eligibility” checks a question asked after it.'
);
expect(screen.getByRole('alert').textContent).toBe(
- 'Respondents still see the last valid version of this form. Screener “Eligibility” checks a question asked after it.'
+ 'Respondents still see the last valid version of this form. Gate “Eligibility” checks a question asked after it.'
);
shared.setPublicationError(undefined);
expect(screen.queryByRole('alert')).toBeNull();
diff --git a/apps/web/src/features/block-form/views/builder-view.tsx b/apps/web/src/features/block-form/views/builder-view.tsx
index ccb7118a43..bdb6b73908 100644
--- a/apps/web/src/features/block-form/views/builder-view.tsx
+++ b/apps/web/src/features/block-form/views/builder-view.tsx
@@ -351,7 +351,7 @@ function BuilderCanvas(
.with({ kind: 'question' }, ({ id }) => `question “${questionTitle(id)}”`)
.with({ kind: 'section' }, ({ id }) => `“${sectionName(layout(), id)}”`)
.with({ kind: 'new-section' }, ({ id }) =>
- id === 'gate' ? 'screener' : 'section'
+ id === 'gate' ? 'gate' : 'section'
)
.with(
{ kind: 'new-question' },
@@ -715,7 +715,7 @@ function BuilderCanvas(
}
deleteLabel={
section()?.kind === 'gate'
- ? 'Delete screener'
+ ? 'Delete gate'
: 'Delete section'
}
onMoveUp={() =>
@@ -775,7 +775,7 @@ function BuilderCanvas(
<Match when={current().kind === 'gate'}>
<GateCard
sectionId={sectionId}
- eyebrow={`Screener ${sectionPosition(layout(), sectionId)}`}
+ eyebrow={`Gate ${sectionPosition(layout(), sectionId)}`}
title={current().title}
sentence={rulesSentence(
current().gateRules,
diff --git a/apps/web/src/lib/core/component/AI/component/tool/Forms.tsx b/apps/web/src/lib/core/component/AI/component/tool/Forms.tsx
index 74a795ea27..ef9ac147bb 100644
--- a/apps/web/src/lib/core/component/AI/component/tool/Forms.tsx
+++ b/apps/web/src/lib/core/component/AI/component/tool/Forms.tsx
@@ -124,7 +124,7 @@ const readForm = createToolRenderer({
<p>
{section.title ||
(section.kind === 'gate'
- ? 'Screener'
+ ? 'Gate'
: section.kind === 'booking'
? 'Booking'
: 'Questions')}
diff --git a/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.tsx b/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.tsx
index e728ec7b87..9014c646ce 100644
--- a/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.tsx
+++ b/apps/web/src/lib/core/component/AI/component/tool/forms/ResultDetails.tsx
@@ -35,7 +35,7 @@ export function SavedFormDetails(props: { saved: SavedForm }) {
(section.kind === 'questions'
? 'Questions'
: section.kind === 'gate'
- ? 'Screener'
+ ? 'Gate'
: 'Booking')}
</p>
<Show when={section.kind === 'questions' && section}>
diff --git a/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts b/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts
index 4ec8bb51dd..b139020713 100644
--- a/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts
+++ b/apps/web/src/lib/service-clients/service-cognition/generated/tools/types.ts
@@ -7199,7 +7199,7 @@ export interface CreateDocumentResponse {
documentId: string;
}
/**
- * Create a complete questionnaire with response columns, ordered sections, screeners and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in screeners and reference only earlier sections. Required questions require an answer; screeners compare answers using AND/OR. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating.
+ * Create a complete questionnaire with response columns, ordered sections, gates and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in gates and reference only earlier sections. Required questions require an answer; gates compare answers using AND/OR. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating.
*/
export interface CreateForm {
/**
@@ -7262,7 +7262,7 @@ export interface OptionDraft {
label: string;
}
/**
- * Screeners support AND/OR, at most eight levels and 200 conditions.
+ * Gates support AND/OR, at most eight levels and 200 conditions.
*/
export interface Rules {
conjunction: Conjunction;
@@ -7552,7 +7552,7 @@ export interface Capabilities {
*/
safeLinkedTypeChanges: boolean;
/**
- * False: screeners reveal links, but independent booking URLs remain usable.
+ * False: gates reveal links, but independent booking URLs remain usable.
*/
requiredBookingQualification: boolean;
}
@@ -8652,7 +8652,7 @@ export interface EditDocumentResponse {
clarification?: string | null;
}
/**
- * Edit the live form using typed targeted operations. ReadForm provides stable question/section IDs. Edits produce granular CRDT updates; concurrent changes merge using the same rules as the builder. Omitted fields stay unchanged. Invalid merged layouts are refused. Changes can add or move questions/sections, edit requiredness/help/screeners and attach an existing booking target. New columns use explicit stable IDs. Question labels follow backing column names; rename them through database tools. Removing a question keeps its column and answers. Schema retyping and conditional column cleanup are unsupported. Keep screeners after the questions they test and booking last. Read the current form after a timeout or partial result before proceeding. Opening and sharing require SetFormAccess.
+ * Edit the live form using typed targeted operations. ReadForm provides stable question/section IDs. Edits produce granular CRDT updates; concurrent changes merge using the same rules as the builder. Omitted fields stay unchanged. Invalid merged layouts are refused. Changes can add or move questions/sections, edit requiredness/help/gates and attach an existing booking target. New columns use explicit stable IDs. Question labels follow backing column names; rename them through database tools. Removing a question keeps its column and answers. Schema retyping and conditional column cleanup are unsupported. Keep gates after the questions they test and booking last. Read the current form after a timeout or partial result before proceeding. Opening and sharing require SetFormAccess.
*/
export interface EditForm {
formId: FormId;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formSectionDetailOneOfFive.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formSectionDetailOneOfFive.ts
index b89baf80ef..49ba0edac5 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/formSectionDetailOneOfFive.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/formSectionDetailOneOfFive.ts
@@ -10,7 +10,7 @@ import type { FormSectionDetailOneOfFiveKind } from './formSectionDetailOneOfFiv
/**
* A booking step. Its destination is withheld from respondents until
-their response has passed every screener and been accepted.
+their response has passed every gate and been accepted.
*/
export type FormSectionDetailOneOfFive = {
/** Its description. */
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/layoutProblemOneOf.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/layoutProblemOneOf.ts
index f40f463866..b9301b888d 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/layoutProblemOneOf.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/layoutProblemOneOf.ts
@@ -7,7 +7,7 @@
import type { LayoutProblemOneOfKind } from './layoutProblemOneOfKind';
/**
- * A booking step must be unique and follow all questions and screeners.
+ * A booking step must be unique and follow all questions and gates.
*/
export type LayoutProblemOneOf = {
kind: LayoutProblemOneOfKind;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
index a52be58622..63c49382ed 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
@@ -20178,7 +20178,7 @@ export const getFormResponse = zod
title: zod.string().describe('Its title.'),
})
.describe(
- 'A booking step. Its destination is withheld from respondents until\ntheir response has passed every screener and been accepted.'
+ 'A booking step. Its destination is withheld from respondents until\ntheir response has passed every gate and been accepted.'
),
])
.describe('One section of a form as it reads.')
@@ -20751,7 +20751,7 @@ export const collaborateFormResponse = zod
title: zod.string().describe('Its title.'),
})
.describe(
- 'A booking step. Its destination is withheld from respondents until\ntheir response has passed every screener and been accepted.'
+ 'A booking step. Its destination is withheld from respondents until\ntheir response has passed every gate and been accepted.'
),
])
.describe('One section of a form as it reads.')
@@ -20783,7 +20783,7 @@ export const collaborateFormResponse = zod
kind: zod.enum(['bookingMustBeLast']),
})
.describe(
- 'A booking step must be unique and follow all questions and screeners.'
+ 'A booking step must be unique and follow all questions and gates.'
),
zod
.object({
@@ -21617,7 +21617,7 @@ export const putFormLayoutResponse = zod
title: zod.string().describe('Its title.'),
})
.describe(
- 'A booking step. Its destination is withheld from respondents until\ntheir response has passed every screener and been accepted.'
+ 'A booking step. Its destination is withheld from respondents until\ntheir response has passed every gate and been accepted.'
),
])
.describe('One section of a form as it reads.')
@@ -21649,7 +21649,7 @@ export const putFormLayoutResponse = zod
kind: zod.enum(['bookingMustBeLast']),
})
.describe(
- 'A booking step must be unique and follow all questions and screeners.'
+ 'A booking step must be unique and follow all questions and gates.'
),
zod
.object({
diff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.json
index 13bb5f6323..6d712df321 100644
--- a/apps/web/src/lib/service-clients/service-storage/openapi.json
+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json
@@ -29672,7 +29672,7 @@
},
{
"type": "object",
- "description": "A booking step. Its destination is withheld from respondents until\ntheir response has passed every screener and been accepted.",
+ "description": "A booking step. Its destination is withheld from respondents until\ntheir response has passed every gate and been accepted.",
"required": ["id", "title", "description", "kind"],
"properties": {
"description": {
@@ -32049,7 +32049,7 @@
"oneOf": [
{
"type": "object",
- "description": "A booking step must be unique and follow all questions and screeners.",
+ "description": "A booking step must be unique and follow all questions and gates.",
"required": ["kind"],
"properties": {
"kind": {
diff --git a/crates/forms/src/domain/authoring/contracts.rs b/crates/forms/src/domain/authoring/contracts.rs
index 023a353071..464434a672 100644
--- a/crates/forms/src/domain/authoring/contracts.rs
+++ b/crates/forms/src/domain/authoring/contracts.rs
@@ -131,7 +131,7 @@ pub struct Capabilities {
pub conditional_column_cleanup: bool,
/// Retyping through AI is unavailable until its recovery guarantees exist.
pub safe_linked_type_changes: bool,
- /// False: screeners reveal links, but independent booking URLs remain usable.
+ /// False: gates reveal links, but independent booking URLs remain usable.
pub required_booking_qualification: bool,
}
/// An authorized snapshot of the actual durable draft and current schema.
diff --git a/crates/forms/src/domain/authoring/models.rs b/crates/forms/src/domain/authoring/models.rs
index 223a081299..8203795a5d 100644
--- a/crates/forms/src/domain/authoring/models.rs
+++ b/crates/forms/src/domain/authoring/models.rs
@@ -107,7 +107,7 @@ pub enum Rule {
/// Nested conjunction.
Group(Rules),
}
-/// Screeners support AND/OR, at most eight levels and 200 conditions.
+/// Gates support AND/OR, at most eight levels and 200 conditions.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "camelCase", deny_unknown_fields)]
pub struct Rules {
diff --git a/crates/forms/src/domain/authoring/validate.rs b/crates/forms/src/domain/authoring/validate.rs
index 0f28b73542..662f9a5c29 100644
--- a/crates/forms/src/domain/authoring/validate.rs
+++ b/crates/forms/src/domain/authoring/validate.rs
@@ -312,7 +312,7 @@ fn resolve_rules(
return Err(fail(
Code::EmptyScreeningGroup,
"rules",
- "Add a condition or remove the screener; an empty group qualifies everyone.",
+ "Add a condition or remove the gate; an empty group qualifies everyone.",
));
}
if depth >= 8 {
@@ -580,7 +580,7 @@ pub fn canonical_preserving(
return Err(fail(
Code::GateReferencesLaterQuestion,
"rules",
- "Screeners may only reference questions in earlier sections.",
+ "Gates may only reference questions in earlier sections.",
));
}
check_rules(rules, columns)?;
diff --git a/crates/forms/src/domain/service/test/layout.rs b/crates/forms/src/domain/service/test/layout.rs
index 64117f132b..d2e41d0e6f 100644
--- a/crates/forms/src/domain/service/test/layout.rs
+++ b/crates/forms/src/domain/service/test/layout.rs
@@ -51,7 +51,7 @@ fn respondent_details_withhold_the_booking_destination() {
}
#[tokio::test]
-async fn booking_must_follow_every_question_and_screener() {
+async fn booking_must_follow_every_question_and_gate() {
let world = world();
seed_rsvp(&world, Audience::Public);
let booking = FormSection::Booking {
diff --git a/crates/forms/src/inbound/toolset/create_form.rs b/crates/forms/src/inbound/toolset/create_form.rs
index 02f26382e6..fe8b1850f4 100644
--- a/crates/forms/src/inbound/toolset/create_form.rs
+++ b/crates/forms/src/inbound/toolset/create_form.rs
@@ -11,7 +11,7 @@ use serde::Deserialize;
#[derive(Debug, Clone, Deserialize, JsonSchema)]
#[schemars(
title = "CreateForm",
- description = "Create a complete questionnaire with response columns, ordered sections, screeners and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in screeners and reference only earlier sections. Required questions require an answer; screeners compare answers using AND/OR. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating."
+ description = "Create a complete questionnaire with response columns, ordered sections, gates and an optional saved booking link. Creates closed and private; use SetFormAccess afterward to open or share it. Existing-table attachment requires database Owner and an unbound table. Use local question/option keys in gates and reference only earlier sections. Required questions require an answer; gates compare answers using AND/OR. Empty answers pass only IsEmpty. A final booking step reveals an existing authorized link after acceptance; its independent URL remains usable, and strict qualification is unsupported. Each invocation creates a new form; after a timeout, use ListForms and ReadForm before trying again. Returns actual saved IDs, links and completion state; inspect partial work instead of recreating."
)]
pub struct CreateForm {
/// Flat workflow arguments shared with the domain service.
diff --git a/crates/forms/src/inbound/toolset/edit_form.rs b/crates/forms/src/inbound/toolset/edit_form.rs
index 4a7b955080..dc41751252 100644
--- a/crates/forms/src/inbound/toolset/edit_form.rs
+++ b/crates/forms/src/inbound/toolset/edit_form.rs
@@ -11,7 +11,7 @@ use serde::Deserialize;
#[derive(Debug, Clone, Deserialize, JsonSchema)]
#[schemars(
title = "EditForm",
- description = "Edit the live form using typed targeted operations. ReadForm provides stable question/section IDs. Edits produce granular CRDT updates; concurrent changes merge using the same rules as the builder. Omitted fields stay unchanged. Invalid merged layouts are refused. Changes can add or move questions/sections, edit requiredness/help/screeners and attach an existing booking target. New columns use explicit stable IDs. Question labels follow backing column names; rename them through database tools. Removing a question keeps its column and answers. Schema retyping and conditional column cleanup are unsupported. Keep screeners after the questions they test and booking last. Read the current form after a timeout or partial result before proceeding. Opening and sharing require SetFormAccess."
+ description = "Edit the live form using typed targeted operations. ReadForm provides stable question/section IDs. Edits produce granular CRDT updates; concurrent changes merge using the same rules as the builder. Omitted fields stay unchanged. Invalid merged layouts are refused. Changes can add or move questions/sections, edit requiredness/help/gates and attach an existing booking target. New columns use explicit stable IDs. Question labels follow backing column names; rename them through database tools. Removing a question keeps its column and answers. Schema retyping and conditional column cleanup are unsupported. Keep gates after the questions they test and booking last. Read the current form after a timeout or partial result before proceeding. Opening and sharing require SetFormAccess."
)]
pub struct EditForm {
/// Flat workflow arguments shared with the domain service.
diff --git a/crates/models_forms/src/detail.rs b/crates/models_forms/src/detail.rs
index 1a8b2edda5..c210ebd2ce 100644
--- a/crates/models_forms/src/detail.rs
+++ b/crates/models_forms/src/detail.rs
@@ -64,7 +64,7 @@ pub enum FormSectionDetail {
message: String,
},
/// A booking step. Its destination is withheld from respondents until
- /// their response has passed every screener and been accepted.
+ /// their response has passed every gate and been accepted.
Booking {
/// The section.
#[schema(value_type = Uuid)]
diff --git a/crates/models_forms/src/error.rs b/crates/models_forms/src/error.rs
index 572bc630f8..c28c63d147 100644
--- a/crates/models_forms/src/error.rs
+++ b/crates/models_forms/src/error.rs
@@ -93,7 +93,7 @@ pub enum FormErrorCode {
rename_all_fields = "camelCase"
)]
pub enum LayoutProblem {
- /// A booking step must be unique and follow all questions and screeners.
+ /// A booking step must be unique and follow all questions and gates.
#[error("the booking step must be the final section of the form")]
BookingMustBeLast,
/// A question names a column the form's table does not have.
diff --git a/docs/agent-guide/ai-chat.md b/docs/agent-guide/ai-chat.md
index 465cf89b45..e8e54d0d77 100644
--- a/docs/agent-guide/ai-chat.md
+++ b/docs/agent-guide/ai-chat.md
@@ -1170,7 +1170,7 @@ reads `Waiting for approval`. The agent's hidden context names the owner and the
## Forms authoring and sharing
With Forms enabled, ask the agent to create a complete form, including ordered
-sections and qualification screeners. Creation starts closed and members-only.
+sections and qualification gates. Creation starts closed and members-only.
The expandable tool result shows the saved questions, builder link, respondent
link, and actual response availability. Edits use granular CRDT updates
to preserve unrelated human changes. Partial outcomes have recovery guidance;
@@ -1180,7 +1180,7 @@ a link by itself is not a completed or open form.
and channel-sharing services as the browser. There is no custom review card.
Channel Edit also grants access to the entire response database. Settings and
channel grants are separate writes; inspect any partial outcome before retrying.
-See [Forms](forms.md#forms-through-the-ai-tools) for screeners, booking link reveal,
+See [Forms](forms.md#forms-through-the-ai-tools) for gates, booking link reveal,
supported edits and retry behavior.
## In channels
diff --git a/docs/agent-guide/forms.md b/docs/agent-guide/forms.md
index 5da22781b0..629f2744f7 100644
--- a/docs/agent-guide/forms.md
+++ b/docs/agent-guide/forms.md
@@ -52,7 +52,7 @@ on hover and navigates to them on click. It marks the selected section or questi
Each question section ends with a large **Add question** menu. It appends a new
question or existing database field to that section, regardless of the current
selection. Three visible actions sit below the canvas: **Add section** adds a
-question section directly, **Add gate** adds a screener with its inline rule editor
+question section directly, **Add gate** adds a gate with its inline rule editor
open, and **Add meeting link** opens the booking-link picker (when scheduling is
available). Hover a question boundary to reveal a plus that inserts a question
at that position. Hover between sections to insert a **Section** or **Gate**.
@@ -93,14 +93,14 @@ keeps the meeting link last. Start an empty form by adding a section, then its q
questions; **Add** puts one on the form.
- Layout edits collaborate live through Loro. Other editors' selections appear
in the builder. Connection and save failures are visible; there is no
- persistent saved badge. Invalid screener drafts remain editable while the
+ persistent saved badge. Invalid gate drafts remain editable while the
public form keeps its last valid layout.
- A type change that existing answers do not fit shows **Convert into a new
question**: a new column gets the answers that convert and the question
moves to it; the old column stays (listed under columns not on the form).
- **Preview** opens a new tab with the respondent experience after pending
question and form settings edits are saved, including edits started before
- switching tabs. Fill it, try the screeners, and return to the builder. Preview
+ switching tabs. Fill it, try the gates, and return to the builder. Preview
creates no response rows, file uploads or bookings.
On touch devices, Preview, Publish (or Open form), and Share are in the
floating header above the editor.
@@ -108,14 +108,14 @@ keeps the meeting link last. Start an empty form by adding a section, then its q
**More → Scheduling** workspace, or opens that workspace to create one.
It is always the last step. Once added, the action becomes **View meeting link**
and focuses the existing step rather than adding a duplicate. **Change** selects another link;
- **Remove booking step** leaves the link itself intact. A form's screeners
+ **Remove booking step** leaves the link itself intact. A form's gates
control when its respondents see the link; the native link still works directly.
- New standalone forms share their name with the database they create. Rename
either to change both. Forms added to existing tables have independent names.
### Responses
-The linked table's grid, embedded and live, with summary tiles: Responses, Stopped submissions (per screener in its hint), Rows in
+The linked table's grid, embedded and live, with summary tiles: Responses, Stopped submissions (per gate in its hint), Rows in
the table, and (owners, when posted in channels) People in its channels (the
owner excluded; a dash for public forms). Every row of the table shows,
including rows added in the grid. Stopped submissions counts signed-in respondents
@@ -182,7 +182,7 @@ discovers an existing response but cannot load its receipt, **Try again** reload
that response without submitting another one.
When the form ends with a booking step, the last action reads **Continue to
-booking**. After the server accepts the response and its screeners, Macro's
+booking**. After the server accepts the response and its gates, Macro's
time picker appears. Booking opens `/app/booking/<id>#<private-token>`; retain
that private link for cancellation or rescheduling. A returning signed-in
respondent can use **Book a time** on their receipt if their saved answers still
@@ -239,12 +239,12 @@ linked type changes, independent display-label overrides, and reference pickers
are not offered by these tools.
Required means an answer must be present; it does not mean the answer qualifies.
-Use nonempty AND/OR screeners for qualification. Rules must refer to questions in
+Use nonempty AND/OR gates for qualification. Rules must refer to questions in
earlier sections and options belonging to those questions. Empty answers pass
only an `isEmpty` presence check, including for negative comparisons. Zero and
false are answers. Put at most one booking section last. Select a saved accessible
profile/event identity from the scheduling UI or available booking tools. Booking
-screeners reveal a link after an accepted response; the independent booking URL
+gates reveal a link after an accepted response; the independent booking URL
remains usable. Requests for strict booking enforcement are refused.
`ListForms` searches forms reachable through your actual grants, not every public
diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.json
index 13bb5f6323..6d712df321 100644
--- a/packages/sdk/specs/storage.json
+++ b/packages/sdk/specs/storage.json
@@ -29672,7 +29672,7 @@
},
{
"type": "object",
- "description": "A booking step. Its destination is withheld from respondents until\ntheir response has passed every screener and been accepted.",
+ "description": "A booking step. Its destination is withheld from respondents until\ntheir response has passed every gate and been accepted.",
"required": ["id", "title", "description", "kind"],
"properties": {
"description": {
@@ -32049,7 +32049,7 @@
"oneOf": [
{
"type": "object",
- "description": "A booking step must be unique and follow all questions and screeners.",
+ "description": "A booking step must be unique and follow all questions and gates.",
"required": ["kind"],
"properties": {
"kind": {