@gaia-ai/addon-gaia-ui 0.15.0 → 0.15.1

package/dist/src/Component/list-chrome/index.d.ts

@@ -3,11 +3,14 @@ import { type VNode } from '@opentui/core';
 export interface ListFilterBadge {
     /** Stable id suffix — node id is `${stripId}-${id}`. */
     id: string;
-    /** Idle label (key hint), e.g. `/ search` or `x closed`. */
+    /**
+     * Shortcut plus a space plus the idle caption, e.g. `/ search` or `x closed`.
+     * The first space-delimited token is the shortcut rendered before an active value.
+     */
     label: string;
     /**
-     * When set, the badge is active: {@link FOREGROUND_ACTIVE} fg and this value text
-     * (e.g. `closed: hidden`, `who: cw`).
+     * Active caption rendered after the shortcut (e.g. `closed: hidden`, `who: cw`).
+     * Undefined or empty keeps the badge idle: {@link label} only, idle palette.
      */
     value?: string;
 }

package/dist/src/Component/list-chrome/index.js

@@ -32,7 +32,16 @@ export const filterBadgeStrip = (id, badges) => {
             paddingLeft: 2,
             paddingRight: 2,
             flexDirection: 'row',
-        }, textNode({
+        }, ...(active
+            ? [
+                textNode({
+                    id: `${id}-${badge.id}-key`,
+                    content: `${badge.label.split(' ', 1)[0]} `,
+                    bg: DEFAULT_BACKGROUND,
+                    fg: FOREGROUND,
+                }),
+            ]
+            : []), textNode({
             id: `${id}-${badge.id}`,
             content: label,
             bg: active ? BACKGROUND_ACTIVE : DEFAULT_BACKGROUND,

package/dist/src/Entity/conductor/Data/conductors.d.ts

@@ -11,6 +11,8 @@ export interface Conductor {
     machineId: string | undefined;
     /** Liveness, as the control plane reports it. */
     status: string | undefined;
+    /** Operator-set lifecycle flag; inactive conductors are never assignable. */
+    active: boolean;
     /** The conductor's project, `null` when unlinked. */
     projectId: string | null;
     /** The user who owns this record, `null` when unowned (GAIA-460 D8/D9). */
@@ -188,13 +190,16 @@ export declare const CONDUCTOR_TABLE: {
     }, {
         /** A CLOSED VOCABULARY. `ConductorStatus`'s reachable members here are
          *  `online | stale | offline` — this screen can never produce
-         *  `registry-only`, because every row IS a control-plane record — whose
-         *  longest is 7, so 9 shows each of them whole. */
+         *  `registry-only`, because every row IS a control-plane record — and an
+         *  inactive row appends a trailing `!`, whose longest, `offline!`, is 8,
+         *  so 9 still shows each of them whole (GAIA-542 N1: `(inactive)` does
+         *  not fit this budget without disturbing every other column's exact
+         *  width, so the marker is a glyph rather than a word). */
         readonly key: "status";
         readonly label: "STATUS";
         readonly width: 9;
-        readonly fields: readonly ["status", "lease_expires_at", "last_seen"];
-        readonly get: (row: ConductorRow) => ConductorStatus;
+        readonly fields: readonly ["status", "active", "lease_expires_at", "last_seen"];
+        readonly get: (row: ConductorRow) => string;
     }, {
         /** `humanizeAge`'s own vocabulary, exactly as on the projects list: `—`,
          *  `just now`, `<n>m|h|d ago`. 8 is the longest of them. */
@@ -296,13 +301,16 @@ export declare const PROJECT_CONDUCTOR_TABLE: {
     } | {
         /** A CLOSED VOCABULARY. `ConductorStatus`'s reachable members here are
          *  `online | stale | offline` — this screen can never produce
-         *  `registry-only`, because every row IS a control-plane record — whose
-         *  longest is 7, so 9 shows each of them whole. */
+         *  `registry-only`, because every row IS a control-plane record — and an
+         *  inactive row appends a trailing `!`, whose longest, `offline!`, is 8,
+         *  so 9 still shows each of them whole (GAIA-542 N1: `(inactive)` does
+         *  not fit this budget without disturbing every other column's exact
+         *  width, so the marker is a glyph rather than a word). */
         readonly key: "status";
         readonly label: "STATUS";
         readonly width: 9;
-        readonly fields: readonly ["status", "lease_expires_at", "last_seen"];
-        readonly get: (row: ConductorRow) => ConductorStatus;
+        readonly fields: readonly ["status", "active", "lease_expires_at", "last_seen"];
+        readonly get: (row: ConductorRow) => string;
     } | {
         /** `humanizeAge`'s own vocabulary, exactly as on the projects list: `—`,
          *  `just now`, `<n>m|h|d ago`. 8 is the longest of them. */

package/dist/src/Entity/conductor/Data/conductors.js

@@ -20,6 +20,7 @@ const toConductor = (r) => ({
     // Registration key (GAIA-353 renamed machine_id → conductor_id).
     machineId: str(r.attr('conductor_id')) ?? str(r.attr('machine_id')),
     status: str(r.attr('status')),
+    active: r.attr('active') !== false,
     projectId: r.rel('project_id'),
     ownerUserId: r.rel('owner_user_id'),
 });
@@ -199,13 +200,16 @@ export const CONDUCTOR_TABLE = {
         {
             /** A CLOSED VOCABULARY. `ConductorStatus`'s reachable members here are
              *  `online | stale | offline` — this screen can never produce
-             *  `registry-only`, because every row IS a control-plane record — whose
-             *  longest is 7, so 9 shows each of them whole. */
+             *  `registry-only`, because every row IS a control-plane record — and an
+             *  inactive row appends a trailing `!`, whose longest, `offline!`, is 8,
+             *  so 9 still shows each of them whole (GAIA-542 N1: `(inactive)` does
+             *  not fit this budget without disturbing every other column's exact
+             *  width, so the marker is a glyph rather than a word). */
             key: 'status',
             label: 'STATUS',
             width: 9,
-            fields: ['status', 'lease_expires_at', 'last_seen'],
-            get: (row) => row.derivedStatus,
+            fields: ['status', 'active', 'lease_expires_at', 'last_seen'],
+            get: (row) => row.active ? row.derivedStatus : `${row.derivedStatus}!`,
         },
         {
             /** `humanizeAge`'s own vocabulary, exactly as on the projects list: `—`,
@@ -382,14 +386,17 @@ const toConductorRow = (raw, ctx, machinesById) => {
 /**
  * The query both reads share: the narrowing, the declared order, the sideload.
  *
- * `sort=-last_seen` is not cosmetic (GAIA-460 D7, GAIA-458 AC-2). Paging over a
- * collection with no declared order lets a row repeat on two pages while another
- * is skipped entirely, so the order is a correctness property of the paging
- * before it is a convenience for the reader.
+ * `sort=-last_seen,-drupal_internal__id` is not cosmetic (GAIA-460 D7,
+ * GAIA-458 AC-2). Paging over a collection with no total order lets a row
+ * repeat on two pages while another is skipped entirely, so the order is a
+ * correctness property of the paging before it is a convenience for the reader.
+ * `last_seen` is nullable and two conductors can share a heartbeat; the serial
+ * id is the unique second key that makes offset paging well defined.
  */
 const conductorParams = (query) => {
     const params = new DrupalJsonApiParams().addInclude(['machine']);
     params.addSort('last_seen', 'DESC');
+    params.addSort('drupal_internal__id', 'DESC');
     if (query.projectId)
         params.addFilter('project_id.id', query.projectId);
     if (query.ownerUserId)

package/dist/src/Entity/conductor/Screen/conductors.d.ts

@@ -53,8 +53,8 @@ export declare class ConductorsScreen extends ListScreen<ConductorRow, Conductor
             readonly key: "status";
             readonly label: "STATUS";
             readonly width: 9;
-            readonly fields: readonly ["status", "lease_expires_at", "last_seen"];
-            readonly get: (row: ConductorRow) => import("../Data/liveness.js").ConductorStatus;
+            readonly fields: readonly ["status", "active", "lease_expires_at", "last_seen"];
+            readonly get: (row: ConductorRow) => string;
         }, {
             readonly key: "age";
             readonly label: "AGE";

package/dist/src/Entity/conductor/Screen/project-conductors.d.ts

@@ -46,8 +46,8 @@ export declare class ProjectConductorsScreen extends ListScreen<ConductorRow, Co
             readonly key: "status";
             readonly label: "STATUS";
             readonly width: 9;
-            readonly fields: readonly ["status", "lease_expires_at", "last_seen"];
-            readonly get: (row: ConductorRow) => import("../Data/liveness.js").ConductorStatus;
+            readonly fields: readonly ["status", "active", "lease_expires_at", "last_seen"];
+            readonly get: (row: ConductorRow) => string;
         } | {
             readonly key: "age";
             readonly label: "AGE";

package/dist/src/Entity/project/Data/with-tickets.js

@@ -31,6 +31,7 @@ export async function loadProjectWithTickets(client, projectSlug) {
         parent: null,
         who: null,
         owner: null,
+        project: null,
     });
     return {
         project,

package/dist/src/Entity/project/Data/workload.js

@@ -10,16 +10,9 @@ const relationshipIds = (relationship) => {
     return (Array.isArray(data) ? data : [data]).map(({ id }) => id);
 };
 const repositoryUrl = (value) => {
-    if (!Array.isArray(value))
+    if (!value || typeof value !== 'object')
         return undefined;
-    for (const repository of value) {
-        if (!repository || typeof repository !== 'object')
-            continue;
-        const url = asString(repository.url);
-        if (url)
-            return url;
-    }
-    return undefined;
+    return asString(value.url);
 };
 async function loadProjectContext(client, projectId) {
     const params = new DrupalJsonApiParams()
@@ -37,7 +30,7 @@ async function loadProjectContext(client, projectId) {
         return name ? [name] : [];
     });
     const key = asString(project.attributes?.key);
-    const repository = repositoryUrl(project.attributes?.repos);
+    const repository = repositoryUrl(project.attributes?.repository);
     return {
         id: project.id ?? projectId,
         name: asString(project.attributes?.name) ?? projectId,

package/dist/src/Entity/run/Component/run-detail/index.d.ts

@@ -14,7 +14,7 @@ export declare function runDetailTitle(document: TicketDetailDocument, runId: st
  * `presentation()` puts the kernel's body-window root over it, because the id of
  * that slot is the kernel's to know and a component may not import it.
  */
-export declare function runDetailTree(document: TicketDetailDocument, runId: string | null | undefined): VNode;
+export declare function runDetailTree(document: TicketDetailDocument, runId: string | null | undefined, baseUrl?: string | undefined): VNode;
 /**
  * The run block as PLAIN TEXT — the pipe's own output (spec F5).
  *
@@ -30,4 +30,4 @@ export declare function runDetailTree(document: TicketDetailDocument, runId: str
  * Nothing here measures a string (R5): a pipe's text is unpadded by definition,
  * so this is the same rows the tree carries and no column arithmetic at all.
  */
-export declare function runDetailRows(document: TicketDetailDocument, runId: string | null | undefined): string[];
+export declare function runDetailRows(document: TicketDetailDocument, runId: string | null | undefined, baseUrl?: string | undefined): string[];

package/dist/src/Entity/run/Component/run-detail/index.js

@@ -37,19 +37,6 @@ function relId(resource, name) {
         return null;
     return Array.isArray(data) ? (data[0]?.id ?? null) : data.id;
 }
-/**
- * A `text_long` value as a plain string. `log`/`error_log` arrive as
- * `{value, format, processed}` when captured and as `null` when they never were
- * (measured null on GAIA-255's own runs) — the same shape the ticket description
- * has, unwrapped by the same rule.
- */
-function longText(value) {
-    if (value && typeof value === 'object' && 'value' in value) {
-        const inner = value.value;
-        return typeof inner === 'string' ? inner : '';
-    }
-    return typeof value === 'string' ? value : '';
-}
 /** A scalar field as a display row value: the value, or an explicit dash. */
 function scalar(value) {
     if (typeof value === 'string' && value !== '')
@@ -103,7 +90,7 @@ export function runDetailTitle(document, runId) {
  * it once the screen handed over nodes, and a second description of a screen
  * that nobody draws is exactly what drifts.
  */
-function keyedSections(document, runId) {
+function keyedSections(document, runId, baseUrl) {
     const run = runResource(document, runId);
     if (!run) {
         return [
@@ -115,20 +102,23 @@ function keyedSections(document, runId) {
         ];
     }
     const a = run.attributes ?? {};
-    const textSection = (key, heading, value, emptyMessage) => {
-        const text = longText(value);
+    // The transcript/error payload no longer lives on the entity (GAIA-556) —
+    // preSave() writes it to a private file and clears the field, so what the
+    // API returns is the byte count, not the text. `bytes > 0` and "unset"
+    // read differently: the first is a payload retrievable through the run
+    // log download route, the second is either a true empty log or, for the
+    // transcript, a `capture_logs: false` conductor — the operator cannot
+    // tell those apart from a truncated body, so say "not captured" instead
+    // of implying failure.
+    const logSizeSection = (key, heading, bytes, notCapturedMessage, kind) => {
+        const captured = typeof bytes === 'number';
+        const text = captured
+            ? `Captured (${bytes} bytes). ${runLogUrl(baseUrl, run.id, kind) ?? 'Retrieve via the run log download route.'}`
+            : notCapturedMessage;
         return {
             key,
             heading,
-            // Keyed WITHIN the section, so line n of a transcript is `<section>-n`
-            // whatever the fields above it do. A transcript only ever grows at the
-            // end, which is the one shape a positional key is honest about.
-            rows: text
-                ? text.split('\n').map((line, index) => ({
-                    key: `${key}-${index}`,
-                    text: line,
-                }))
-                : [{ key: `${key}-empty`, text: emptyMessage }],
+            rows: [{ key: `${key}-empty`, text }],
         };
     };
     return [
@@ -186,12 +176,24 @@ function keyedSections(document, runId) {
                 },
             ],
         },
-        // R5: no cap and no truncation — a truncated log would be a silent lie. It is
-        // scrollable like any other body.
-        textSection('log', 'Log', a.log, 'No log captured.'),
-        textSection('error-log', 'Error log', a.error_log, 'No errors logged.'),
+        // R5 no longer applies to what's rendered here: the payload moved to a
+        // private file (GAIA-556), so the section shows the size, not the text.
+        logSizeSection('log', 'Log', a.log_bytes, 'Transcript not captured.', 'log'),
+        logSizeSection('error-log', 'Error log', a.error_log_bytes, 'No errors logged.', 'error_log'),
     ];
 }
+/**
+ * The run-log download route's resolved URL (`_gaia-api/run/{uuid}/log/{kind}`,
+ * @see gaia-cli/addons/remote-drupal/src/index.ts createRunLogFetcher), so an
+ * operator reading the run detail screen has something to open rather than a
+ * sentence naming a route with no address. `undefined` when the control plane's
+ * base URL is not known, which the caller falls back on.
+ */
+function runLogUrl(baseUrl, runId, kind) {
+    if (!baseUrl || !runId)
+        return undefined;
+    return `${baseUrl.replace(/\/+$/, '')}/_gaia-api/run/${runId}/log/${kind}`;
+}
 /**
  * One body row as a renderable. Bold is a PROP here, never an index (D3), and
  * it is stated on every row rather than only on the bold ones — a log line that
@@ -211,8 +213,8 @@ const textRow = (key, text, bold = false) => textNode({ id: `run-detail-${key}`,
  * asserts the two projections row for row, so a section reachable from only one
  * of them fails rather than diverges quietly.
  */
-function flatRows(document, runId) {
-    return keyedSections(document, runId).flatMap((section) => [
+function flatRows(document, runId, baseUrl) {
+    return keyedSections(document, runId, baseUrl).flatMap((section) => [
         { key: `section-${section.key}`, text: section.heading, bold: true },
         ...section.rows.map((entry) => ({
             key: entry.key,
@@ -238,8 +240,8 @@ function flatRows(document, runId) {
  * `presentation()` puts the kernel's body-window root over it, because the id of
  * that slot is the kernel's to know and a component may not import it.
  */
-export function runDetailTree(document, runId) {
-    return columnNode('run-detail', ...flatRows(document, runId).map((entry) => textRow(entry.key, entry.text, entry.bold)));
+export function runDetailTree(document, runId, baseUrl) {
+    return columnNode('run-detail', ...flatRows(document, runId, baseUrl).map((entry) => textRow(entry.key, entry.text, entry.bold)));
 }
 /**
  * The run block as PLAIN TEXT — the pipe's own output (spec F5).
@@ -256,6 +258,6 @@ export function runDetailTree(document, runId) {
  * Nothing here measures a string (R5): a pipe's text is unpadded by definition,
  * so this is the same rows the tree carries and no column arithmetic at all.
  */
-export function runDetailRows(document, runId) {
-    return flatRows(document, runId).map((entry) => entry.text);
+export function runDetailRows(document, runId, baseUrl) {
+    return flatRows(document, runId, baseUrl).map((entry) => entry.text);
 }

package/dist/src/Entity/run/Data/query.js

@@ -65,6 +65,7 @@ export function buildConductorRunQueryParams(conductorId, page = { size: LIST_PA
     params.addFields('gaia_ticket--gaia_ticket', CONDUCTOR_RUN_TICKET_INCLUDE_FIELDS);
     params.addFields('gaia_run--gaia_run', RUN_LIST_FIELDS);
     params.addSort('started_at', 'DESC');
+    params.addSort('drupal_internal__id', 'DESC');
     params.addPageLimit(page.size);
     if (page.index > 0)
         params.addPageOffset(page.index * page.size);
@@ -79,6 +80,7 @@ function applyRunCriteria(params, criteria, page) {
     params.addFields('gaia_ticket--gaia_ticket', RUN_TICKET_INCLUDE_FIELDS);
     params.addFields('gaia_run--gaia_run', RUN_LIST_FIELDS);
     params.addSort('started_at', 'DESC');
+    params.addSort('drupal_internal__id', 'DESC');
     params.addPageLimit(page.size);
     // Page one carries no offset, so its query is the shortest it can be.
     if (page.index > 0)

package/dist/src/Entity/run/Screen/run-detail.js

@@ -42,7 +42,7 @@ export class RunDetailScreen extends AsyncScreen {
         return ['Loading run…'];
     }
     renderReady(document, context) {
-        return runDetailTree(document, context.params?.runId ?? '');
+        return runDetailTree(document, context.params?.runId ?? '', context.services?.baseUrl);
     }
     chrome(context) {
         return {
@@ -107,6 +107,6 @@ export class RunDetailScreen extends AsyncScreen {
      * 97.7 % of a 1.34 MB captured agent transcript.
      */
     renderNonInteractive(context) {
-        return runDetailRows(this.readyValue ?? {}, context.params?.runId ?? '');
+        return runDetailRows(this.readyValue ?? {}, context.params?.runId ?? '', context.services?.baseUrl);
     }
 }

package/dist/src/Entity/team/Data/projects.js

@@ -7,6 +7,7 @@ export async function listLinkedProjectIds(client, teamId) {
     while (true) {
         const params = new DrupalJsonApiParams()
             .addFilter('teams.id', teamId)
+            .addSort('drupal_internal__id', 'ASC')
             .addPageLimit(LIST_PAGE_SIZE);
         if (offset > 0)
             params.addPageOffset(offset);

package/dist/src/Entity/team/Data/teams.js

@@ -160,6 +160,7 @@ export const MEMBERSHIP_RESOURCE = 'og_membership/default';
 export async function readMembershipPage(client, filters, offset) {
     const params = new DrupalJsonApiParams()
         .addFilter('state', MEMBERSHIP_STATE_ACTIVE)
+        .addSort('drupal_internal__id', 'ASC')
         .addPageLimit(MEMBERSHIP_PAGE_SIZE);
     for (const [field, value] of Object.entries(filters)) {
         params.addFilter(field, value);

package/dist/src/Entity/ticket/Component/ticket-content/model.js

@@ -100,9 +100,6 @@ const lifecycleProperties = (document) => {
     const changed = asString(attributes.changed);
     if (changed !== undefined)
         extras.push(property('changed', changed));
-    const gitlab = asString(attributes.gitlab_assignee_username);
-    if (gitlab !== undefined)
-        extras.push(property('gitlab assignee', gitlab));
     return extras;
 };
 const technicalProperties = (byHeading, document, labels) => {

package/dist/src/Entity/ticket/Data/parents-all.d.ts

@@ -0,0 +1,14 @@
+import type { DropshClient } from '../../../types.js';
+import { type ListOutcome } from '../../transport.js';
+import type { ParentCandidate } from './parents.js';
+/** A page of candidates for the My work parent picker. */
+export declare const MY_WORK_PARENT_PAGE_SIZE = 50;
+/**
+ * One page of tickets that have children, across every project.
+ *
+ * The `filter[identifier][operator]=CONTAINS` shape is the same one the
+ * project-scoped parent picker uses for `match === 'identifier'` (GAIA-284,
+ * PM steer). `has_children = 1` filters on the server side via
+ * `HasChildrenFilterSubscriber`.
+ */
+export declare function loadAllParentCandidates(client: DropshClient, query: string): Promise<ListOutcome<ParentCandidate>>;

package/dist/src/Entity/ticket/Data/parents-all.js

@@ -0,0 +1,44 @@
+// GAIA-540 — the My work PARENT CANDIDATE read. Mirrors `loadParentCandidates`
+// from `parents.ts` but does NOT scope the read by `filter[project_id.id]`:
+// My work spans every project the operator is assigned to, so a parent picker
+// they reach from My work must offer parents from all of them.
+//
+// The remaining policy bits stay: `parent: null` and `who: null` criteria
+// (F7), so an active parent filter can never narrow the picker to that
+// parent's own children, and `has_children = 1` so the picker offers only
+// tickets that CAN be picked.
+import { DrupalJsonApiParams } from 'drupal-jsonapi-params';
+import { messageOf } from '../../transport.js';
+/** A page of candidates for the My work parent picker. */
+export const MY_WORK_PARENT_PAGE_SIZE = 50;
+const toCandidate = (item) => {
+    const id = item.id ?? '';
+    return {
+        id,
+        identifier: item.attributes?.identifier ?? id,
+        title: item.attributes?.title ?? 'Untitled',
+    };
+};
+/**
+ * One page of tickets that have children, across every project.
+ *
+ * The `filter[identifier][operator]=CONTAINS` shape is the same one the
+ * project-scoped parent picker uses for `match === 'identifier'` (GAIA-284,
+ * PM steer). `has_children = 1` filters on the server side via
+ * `HasChildrenFilterSubscriber`.
+ */
+export async function loadAllParentCandidates(client, query) {
+    const params = new DrupalJsonApiParams()
+        .addPageLimit(MY_WORK_PARENT_PAGE_SIZE)
+        .addFields('gaia_ticket--gaia_ticket', ['identifier', 'title']);
+    if (query)
+        params.addFilter('identifier', query, 'CONTAINS');
+    params.addFilter('has_children', '1');
+    try {
+        const doc = (await client.get('gaia_ticket/gaia_ticket', params));
+        return { rows: (doc?.data ?? []).map(toCandidate) };
+    }
+    catch (caught) {
+        return { rows: [], error: messageOf(caught) };
+    }
+}

package/dist/src/Entity/ticket/Data/parents.js

@@ -85,6 +85,7 @@ export async function loadParentCandidates(client, projectId, query, match = 'id
         who: null,
         // Same rule for the owner filter (GAIA-416).
         owner: null,
+        project: null,
     }, 
     // Its own page, stated explicitly: the picker discloses truncation at
     // PARENT_PAGE_SIZE, so inheriting the list's LIST_PAGE_SIZE (20 since

package/dist/src/Entity/ticket/Data/projects-search.d.ts

@@ -0,0 +1,35 @@
+import type { DropshClient } from '../../../types.js';
+import { type ListOutcome } from '../../transport.js';
+/** One project offered as a possible filter, as the picker needs it. */
+export interface ProjectCandidate {
+    id: string;
+    /** The project's `name`; falls back to the uuid, so nothing renders blank. */
+    name: string;
+}
+/**
+ * The most rows one read can return: Drupal's `OffsetPage::SIZE_MAX`, verified
+ * against the control plane.
+ *
+ * Exported because a bag of exactly this length may be a TRUNCATED answer, and
+ * only the module that performs the read knows the number. The picker does
+ * not currently disclose truncation here (project names are short and a small
+ * bag is rare), but the constant is the same shape `parents` and `users`
+ * already publish so a future disclosure can find it.
+ */
+export declare const PROJECT_PAGE_SIZE = 50;
+/**
+ * One page of projects whose `name` contains the typed fragment.
+ *
+ * `name` is a plain string field on `gaia_project` (no `display_name`
+ * computed field), so `filter[name][operator]=CONTAINS` is a real server-side
+ * filter — matching is name-only, the same restriction the Who picker's
+ * matching carries for the same reason (R4 of GAIA-299). The two-character
+ * gate (AC-3 of GAIA-540) is THIS field's policy, encoded in the source that
+ * calls this read, NOT here — the data layer returns whatever it was asked
+ * for, including an empty array for the empty query.
+ *
+ * Yields the OUTCOME rather than a swallowed array, so the adapter can record
+ * a `projects` error like every other option bag (D4) instead of presenting an
+ * empty candidate list as "no projects exist".
+ */
+export declare function loadProjectCandidates(client: DropshClient, query: string): Promise<ListOutcome<ProjectCandidate>>;

package/dist/src/Entity/ticket/Data/projects-search.js

@@ -0,0 +1,61 @@
+// GAIA-540 — the PROJECT CANDIDATE read for the project-filter picker (the
+// My work screen's `r` key on the bar). A data module like its neighbours:
+// it returns projects and knows nothing about forms, `Option`s or popups; the
+// label, the form declaration and the screen all sit above this file (boundary
+// guard G2, the `Data/` leaf rule).
+//
+// The query is built directly against `gaia_project` (not through
+// `buildTicketQueryParams`, since this read is NOT a ticket read): every
+// gaia_project the operator can name is fair game, and the
+// `filter[name][operator]=CONTAINS&filter[name][value]=<query>` form is
+// exactly what Drupal JSON:API expects. `display_name`-style computed fields
+// would not be filterable; `name` is the canonical label.
+import { DrupalJsonApiParams } from 'drupal-jsonapi-params';
+import { asString } from '../../../lib/format.js';
+import { messageOf } from '../../transport.js';
+/**
+ * The most rows one read can return: Drupal's `OffsetPage::SIZE_MAX`, verified
+ * against the control plane.
+ *
+ * Exported because a bag of exactly this length may be a TRUNCATED answer, and
+ * only the module that performs the read knows the number. The picker does
+ * not currently disclose truncation here (project names are short and a small
+ * bag is rare), but the constant is the same shape `parents` and `users`
+ * already publish so a future disclosure can find it.
+ */
+export const PROJECT_PAGE_SIZE = 50;
+const toCandidate = (item) => {
+    const id = item.id ?? '';
+    return {
+        id,
+        name: asString(item.attributes?.name) ?? id,
+    };
+};
+/**
+ * One page of projects whose `name` contains the typed fragment.
+ *
+ * `name` is a plain string field on `gaia_project` (no `display_name`
+ * computed field), so `filter[name][operator]=CONTAINS` is a real server-side
+ * filter — matching is name-only, the same restriction the Who picker's
+ * matching carries for the same reason (R4 of GAIA-299). The two-character
+ * gate (AC-3 of GAIA-540) is THIS field's policy, encoded in the source that
+ * calls this read, NOT here — the data layer returns whatever it was asked
+ * for, including an empty array for the empty query.
+ *
+ * Yields the OUTCOME rather than a swallowed array, so the adapter can record
+ * a `projects` error like every other option bag (D4) instead of presenting an
+ * empty candidate list as "no projects exist".
+ */
+export async function loadProjectCandidates(client, query) {
+    const params = new DrupalJsonApiParams();
+    if (query)
+        params.addFilter('name', query, 'CONTAINS');
+    params.addPageLimit(PROJECT_PAGE_SIZE);
+    try {
+        const doc = (await client.get('gaia_project/gaia_project', params));
+        return { rows: (doc?.data ?? []).map(toCandidate) };
+    }
+    catch (caught) {
+        return { rows: [], error: messageOf(caught) };
+    }
+}

package/dist/src/Entity/ticket/Data/query.d.ts

@@ -13,6 +13,13 @@ export interface WhoCriterion {
     /** The display name — what the summary names, carried so no lookup is needed. */
     label: string;
 }
+/** A picked project: the uuid the query filters by, plus the name the summary names. */
+export interface ProjectCriterion {
+    /** The project's uuid — what the query filters by. */
+    id: string;
+    /** The project name — what the summary names, carried so no lookup is needed. */
+    label: string;
+}
 /** The active search + filter criteria for the project ticket list. */
 export interface TicketCriteria {
     query: string;
@@ -35,6 +42,8 @@ export interface TicketCriteria {
      * exposed-Views facet, which the TUI never queries through.
      */
     owner: WhoCriterion | null;
+    /** Tickets in this project only (GAIA-540); `null` means "all". */
+    project: ProjectCriterion | null;
 }
 /** The shipped default: everything unset, closed rows hidden (GAIA-282 D1). */
 export declare const DEFAULT_TICKET_CRITERIA: TicketCriteria;
@@ -61,6 +70,9 @@ export interface TicketQueryOptions {
     /** Sideload parent_id + conductor_id for the PARENT/COND columns. Default true;
      *  the parent picker passes false because it renders neither (D8). */
     includes?: boolean;
+    /** Apply criteria.project as a filter. Default false; set true in
+     *  buildUserTicketQueryParams so My work can narrow by project (GAIA-540). */
+    projectFromCriteria?: boolean;
 }
 export declare function buildTicketQueryParams(projectId: string, criteria: TicketCriteria, options?: TicketQueryOptions): DrupalJsonApiParams;
 /**