@gaia-ai/addon-gaia-ui 0.17.1 → 0.18.0

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

@@ -94,6 +94,23 @@ const lifecycleProperties = (document) => {
         })()),
         property('closed', attributes.closed === true ? 'yes' : 'no'),
     ];
+    const frozenAtRaw = attributes.frozen_at;
+    const frozenAt = asString(frozenAtRaw) ??
+        (typeof frozenAtRaw === 'number' && frozenAtRaw > 0
+            ? new Date(frozenAtRaw * 1000).toISOString()
+            : undefined);
+    if (attributes.frozen === true) {
+        extras.push(property('frozen', 'yes'));
+        if (frozenAt !== undefined)
+            extras.push(property('frozen at', frozenAt));
+    }
+    const stall = asString(attributes.stall_reason);
+    if (stall !== undefined) {
+        // `property()` treats values that start with "no " as empty states
+        // (`No conductor.` → none). `no conductor` is a real stall reason, so
+        // the value is kept verbatim.
+        extras.push({ key: 'stall', value: stall });
+    }
     const createdAt = asString(attributes.created);
     if (createdAt !== undefined)
         extras.push(property('created at', createdAt));

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

@@ -23,6 +23,10 @@ export interface TicketRow {
     projectId: string | null;
     /** Boolean closed flag; an absent attribute reads as open (spec D5). */
     closed: boolean;
+    /** Operator hold; an absent attribute reads as not frozen (GAIA-302). */
+    frozen: boolean;
+    /** Why the ticket is standing still: frozen|blocked|no conductor|failing, else ''. */
+    stallReason: string;
 }
 /** A `(id) → resource` lookup over a document's sideloaded `included` entries.
  *  JSON:API ids are UUIDs (unique across bundles), so id alone keys uniquely. */
@@ -83,8 +87,8 @@ export declare const TICKET_COLUMNS: readonly [{
 }, {
     readonly key: "run";
     readonly label: "RUN";
-    readonly width: 8;
-    readonly fields: readonly ["derived_status"];
+    readonly width: 12;
+    readonly fields: readonly ["derived_status", "stall_reason"];
     readonly get: (r: TicketRow) => string;
 }, {
     readonly key: "parent";
@@ -153,8 +157,8 @@ export declare const TICKET_TABLE: {
     }, {
         readonly key: "run";
         readonly label: "RUN";
-        readonly width: 8;
-        readonly fields: readonly ["derived_status"];
+        readonly width: 12;
+        readonly fields: readonly ["derived_status", "stall_reason"];
         readonly get: (r: TicketRow) => string;
     }, {
         readonly key: "parent";
@@ -217,8 +221,8 @@ export declare const CONDUCTOR_TICKET_COLUMNS: readonly [{
 }, {
     readonly key: "run";
     readonly label: "RUN";
-    readonly width: 8;
-    readonly fields: readonly ["derived_status"];
+    readonly width: 12;
+    readonly fields: readonly ["derived_status", "stall_reason"];
     readonly get: (r: TicketRow) => string;
 }, {
     readonly key: "conductor";
@@ -264,8 +268,8 @@ export declare const CONDUCTOR_TICKET_TABLE: {
     }, {
         readonly key: "run";
         readonly label: "RUN";
-        readonly width: 8;
-        readonly fields: readonly ["derived_status"];
+        readonly width: 12;
+        readonly fields: readonly ["derived_status", "stall_reason"];
         readonly get: (r: TicketRow) => string;
     }, {
         readonly key: "conductor";
@@ -292,7 +296,7 @@ export declare const CONDUCTOR_TICKET_TABLE: {
  * down to the bytes on the wire. Column order would emit `title` last (it rides
  * the trailing TITLE column) instead of second.
  */
-export declare const TICKET_LIST_ATTRIBUTES: readonly ["identifier", "title", "state", "priority", "assignee_initials", "owner_initials", "derived_status", "workflow", "closed"];
+export declare const TICKET_LIST_ATTRIBUTES: readonly ["identifier", "title", "state", "priority", "assignee_initials", "owner_initials", "derived_status", "stall_reason", "workflow", "closed", "frozen"];
 /** What `addFields('gaia_ticket--gaia_ticket', …)` takes. */
 export declare const TICKET_LIST_FIELDS: string[];
 /** The sideloaded conductor renders one column: its label. */

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

@@ -57,7 +57,7 @@ export const TICKET_LIST_RELATIONSHIPS = [
  * columns' union PLUS this list, and this list is an explicit declaration rather
  * than an unstated remainder.
  */
-const TICKET_PREDICATE_ATTRIBUTES = ['workflow', 'closed'];
+const TICKET_PREDICATE_ATTRIBUTES = ['workflow', 'closed', 'frozen'];
 /**
  * The ticket list's columns — the header, the width, the cell value AND the
  * fieldset entry of each, in ONE declaration (GAIA-294 AC 4).
@@ -125,9 +125,13 @@ export const TICKET_COLUMNS = [
     {
         key: 'run',
         label: 'RUN',
-        width: 8,
-        fields: ['derived_status'],
-        get: (r) => r.derivedStatus,
+        width: 12,
+        // `stall_reason` rides this column: GAIA-302 shows WHY a ticket is standing
+        // still exactly where it would otherwise show what it is doing, so the two
+        // share one cell and therefore one fieldset entry. Width 12 fits
+        // `no conductor`, the longest operator-facing reason.
+        fields: ['derived_status', 'stall_reason'],
+        get: (r) => r.stallReason || r.derivedStatus,
     },
     {
         key: 'parent',
@@ -220,8 +224,10 @@ export const TICKET_LIST_ATTRIBUTES = [
     'assignee_initials',
     'owner_initials',
     'derived_status',
+    'stall_reason',
     'workflow',
     'closed',
+    'frozen',
 ];
 /** What `addFields('gaia_ticket--gaia_ticket', …)` takes. */
 export const TICKET_LIST_FIELDS = [
@@ -265,6 +271,7 @@ export function mapTicketData(item, included) {
         assigneeInitials: str('assignee_initials') ?? '',
         ownerInitials: str('owner_initials') ?? '',
         derivedStatus: str('derived_status') ?? 'idle',
+        stallReason: str('stall_reason') ?? '',
         labels,
         type: str('workflow') ?? null,
         parent,
@@ -272,6 +279,7 @@ export function mapTicketData(item, included) {
         assigneeId: singleRelId(rel('assignee_user_id')),
         projectId: singleRelId(rel('project_id')),
         closed: typeof raw('closed') === 'boolean' ? raw('closed') : false,
+        frozen: typeof raw('frozen') === 'boolean' ? raw('frozen') : false,
     };
 }
 /**

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

@@ -11,6 +11,13 @@ export declare const TICKET_TYPE = "gaia_ticket--gaia_ticket";
  * silent failure that criterion forbids.
  */
 export declare function updateTicketAssignment(client: DropshClient | undefined, ticketId: string, body: ResourceWriteBody): Promise<unknown>;
+/**
+ * PATCH a ticket's `frozen` flag (GAIA-302).
+ *
+ * Same write path as assignment: a refusal is not caught here so the caller
+ * can put the server's words on the status line.
+ */
+export declare function updateTicketFrozen(client: DropshClient | undefined, ticketId: string, frozen: boolean): Promise<unknown>;
 /** The text format every ticket description is stored in (`gaia_rich`). */
 export declare const TICKET_DESCRIPTION_FORMAT = "gaia_rich";
 /**

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

@@ -16,6 +16,15 @@ export function updateTicketAssignment(client, ticketId, body) {
     }
     return client.update(TICKET_TYPE, ticketId, body);
 }
+/**
+ * PATCH a ticket's `frozen` flag (GAIA-302).
+ *
+ * Same write path as assignment: a refusal is not caught here so the caller
+ * can put the server's words on the status line.
+ */
+export function updateTicketFrozen(client, ticketId, frozen) {
+    return updateTicketAssignment(client, ticketId, { attributes: { frozen } });
+}
 /** The text format every ticket description is stored in (`gaia_rich`). */
 export const TICKET_DESCRIPTION_FORMAT = 'gaia_rich';
 /** A JSON:API to-one linkage, or nothing at all. */

package/dist/src/Entity/ticket/Screen/conductor-tickets.d.ts

@@ -57,8 +57,8 @@ export declare class ConductorTicketsScreen extends ListScreen<TicketRow, void>
         }, {
             readonly key: "run";
             readonly label: "RUN";
-            readonly width: 8;
-            readonly fields: readonly ["derived_status"];
+            readonly width: 12;
+            readonly fields: readonly ["derived_status", "stall_reason"];
             readonly get: (r: TicketRow) => string;
         }, {
             readonly key: "conductor";

package/dist/src/Entity/ticket/Screen/ticket-content-screen.d.ts

@@ -18,6 +18,7 @@ export declare abstract class TicketContentScreen extends AsyncScreen<TicketDeta
     private initializedKey;
     protected labels: AssignmentLabels | undefined;
     private status;
+    private readonly freezeBusy;
     private releaseStore;
     private expanded;
     protected viewMode: UiViewMode;
@@ -47,6 +48,12 @@ export declare abstract class TicketContentScreen extends AsyncScreen<TicketDeta
     setLabels(labels: AssignmentLabels | undefined): void;
     select(index: number, context: ScreenContext): boolean;
     activate(index: number, context: ScreenContext): boolean;
+    private isFrozen;
+    /**
+     * PATCH `frozen` through the write client, then re-read on the session
+     * client so the ladder and document agree with the server.
+     */
+    private toggleFrozen;
     handleInput(input: string, context: ScreenContext): boolean;
     commandForInput(input: string): string | undefined;
     actionForInput(input: string, context: ScreenContext): ScreenAction | undefined;

package/dist/src/Entity/ticket/Screen/ticket-content-screen.js

@@ -1,13 +1,17 @@
 import { actionItem, } from '../../../Component/footer-actions/index.js';
 import { copyThrough } from '../../../lib/clipboard.js';
+import { serverMessage } from '../../../lib/jsonapi-error.js';
 import { BORDER, textNode } from '../../../lib/vnode.js';
 import { AsyncScreen, } from '../../../Screen/async-screen.js';
+import { runRowAction } from '../../../Screen/row-action.js';
 import { TicketContent, } from '../Component/ticket-content/index.js';
 import { initialExpandedKeys, resolveSelectedKey, retainExpandedKeys, ticketContentModel, ticketContentRowId, } from '../Component/ticket-content/model.js';
 import { handleTicketCopy, ticketCopyActions, ticketEditAction, ticketHeaderTree, ticketTitleOf, } from '../Component/ticket-detail/index.js';
 import { ticketTeaserLines, ticketTeaserTree, } from '../Component/ticket-teaser/index.js';
+import { loadTicketDetail } from '../Data/detail.js';
 import { ticketDetailInputContext } from '../Data/input.js';
 import { loadTicketView, readTicket, refreshTicket, saveTicket, ticketLoaded, watchTicket, } from '../Data/store.js';
+import { updateTicketFrozen } from '../Data/write.js';
 /** Overview width when the context carries none — a pipe has no terminal. */
 const DEFAULT_COLUMNS = 80;
 /**
@@ -20,6 +24,7 @@ export class TicketContentScreen extends AsyncScreen {
     initializedKey;
     labels;
     status = '';
+    freezeBusy = new Set();
     releaseStore;
     expanded = new Set();
     viewMode = 'full';
@@ -186,6 +191,47 @@ export class TicketContentScreen extends AsyncScreen {
         context.requestDraw();
         return true;
     }
+    isFrozen() {
+        return this.document?.data?.attributes?.frozen === true;
+    }
+    /**
+     * PATCH `frozen` through the write client, then re-read on the session
+     * client so the ladder and document agree with the server.
+     */
+    toggleFrozen(context) {
+        const id = this.document?.data?.id ?? context.params?.ticketId;
+        if (!id || !context.services)
+            return true;
+        const next = !this.isFrozen();
+        const guard = this.captureLifecycle(context);
+        return runRowAction({
+            rowId: id,
+            busy: this.freezeBusy,
+            context,
+            perform: async () => {
+                try {
+                    await updateTicketFrozen(context.services?.writeClient ?? context.services?.client, id, next);
+                }
+                catch (caught) {
+                    throw new Error(serverMessage(caught));
+                }
+                return { message: next ? 'frozen' : 'no longer frozen' };
+            },
+            refresh: async (ctx) => {
+                refreshTicket(ctx);
+                if (!ctx.services)
+                    return;
+                const document = await loadTicketDetail(ctx.services.client, id, this.includes);
+                this.replaceReadyIfCurrent(guard, saveTicket(ctx, document), ctx);
+            },
+            setStatus: (status) => {
+                this.status = status;
+            },
+            captureLifecycle: () => guard,
+            lifecycleIsCurrent: (current, ctx) => this.lifecycleIsCurrent(current, ctx),
+            failPrefix: 'freeze failed',
+        });
+    }
     handleInput(input, context) {
         if (super.handleInput(input, context))
             return true;
@@ -198,6 +244,8 @@ export class TicketContentScreen extends AsyncScreen {
             context.requestDraw();
             return true;
         }
+        if (input === 'f')
+            return this.toggleFrozen(context);
         if ((input === 'enter' || input === ' ') && keys.length > 0)
             return this.activate(selectedIndex, context);
         if (keys.length > 1 && (input === 'j' || input === 'down'))
@@ -276,9 +324,12 @@ export class TicketContentScreen extends AsyncScreen {
         return [
             actionItem('detail-tab', 'Tab', 'section'),
             actionItem('detail-edit', 'e', 'edit'),
-            ...ticketCopyActions(),
+            // Freeze and paging before copy: at 80 columns the footer clips the
+            // tail, and `Y:Copy link` is the hint that yields.
+            actionItem('detail-freeze', 'f', this.isFrozen() ? 'unfreeze' : 'freeze'),
             actionItem('detail-arrows', '↑↓', selectable > 1 ? 'select' : 'scroll'),
             actionItem('detail-page', 'PgUp/PgDn', 'page'),
+            ...ticketCopyActions(),
             ...(selectable > 0
                 ? [actionItem('detail-enter', 'Enter/Space', 'expand')]
                 : []),
@@ -298,6 +349,7 @@ export class TicketContentScreen extends AsyncScreen {
         this.initializedKey = undefined;
         this.labels = undefined;
         this.status = '';
+        this.freezeBusy.clear();
         this.expanded = new Set();
         this.viewMode = 'full';
     }

package/dist/src/Entity/ticket/Screen/tickets.d.ts

@@ -41,8 +41,8 @@ export declare class TicketsScreen extends ListScreen<TicketRow, void> {
         }, {
             readonly key: "run";
             readonly label: "RUN";
-            readonly width: 8;
-            readonly fields: readonly ["derived_status"];
+            readonly width: 12;
+            readonly fields: readonly ["derived_status", "stall_reason"];
             readonly get: (r: TicketRow) => string;
         }, {
             readonly key: "parent";

package/dist/src/Entity/ticket/Screen/user-tickets.d.ts

@@ -42,8 +42,8 @@ export declare abstract class MemberTicketsScreen extends ListScreen<TicketRow,
         }, {
             readonly key: "run";
             readonly label: "RUN";
-            readonly width: 8;
-            readonly fields: readonly ["derived_status"];
+            readonly width: 12;
+            readonly fields: readonly ["derived_status", "stall_reason"];
             readonly get: (r: TicketRow) => string;
         }, {
             readonly key: "parent";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/addon-gaia-ui",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "description": "GAIA TUI: interactive terminal UI (dashboard, projects, tickets) as a dropsh `tui` renderer plugin.",
   "type": "module",
   "license": "MIT",
@@ -29,6 +29,6 @@
     "zustand": "^5.0.15"
   },
   "peerDependencies": {
-    "@gaia-ai/core": "^0.17.1"
+    "@gaia-ai/core": "^0.18.0"
   }
 }