@runeya/runeya 2.0.76 → 2.0.78

package/agent/index.js

@@ -859,10 +859,21 @@ var KanbanAttachmentSchema = z19.object({
   contentType: z19.string().max(128)
 });
 var KanbanCardEventSchema = z19.object({
-  type: z19.enum(["created", "edited", "moved", "image_added", "image_removed", "title_changed", "conversation_started", "scenario_started", "comment"]),
+  type: z19.enum(["created", "edited", "moved", "image_added", "image_removed", "title_changed", "conversation_started", "scenario_started", "comment", "archived", "unarchived"]),
   timestamp: z19.string(),
   /** Extra context: old/new column name, old/new title, comment text, etc. */
-  detail: z19.string().max(5e3).optional(),
+  /**
+   * Le texte de l'entrée : le corps d'un commentaire, ou le contexte du geste.
+   *
+   * Borné comme le corps d'une carte (100 000), et non plus à 5 000 : un
+   * commentaire est de la prose comme une description, et rien de technique ne
+   * justifiait un écart de vingt fois. La borne étroite s'est vue à l'import
+   * d'un Kanbanize, où des commentaires de 12 000 caractères passaient par
+   * l'API publique — bornée, elle, à 20 000 — pour écrire en base une donnée que
+   * ce schéma déclarait invalide, et qu'aucune reprise depuis l'interface
+   * n'aurait ensuite pu enregistrer.
+   */
+  detail: z19.string().max(1e5).optional(),
   /**
    * Stable identity of the event, used to tell an edit from an insertion when a
    * whole history is written back. Absent on events recorded before the field
@@ -872,8 +883,17 @@ var KanbanCardEventSchema = z19.object({
   /** Who authored this event — 'ai' or 'user'. Only set for comment events. */
   author: z19.enum(["ai", "user"]).optional(),
   /**
-   * The human behind a comment, stamped by the server. This is what makes
-   * "my own comment" answerable; `author` only separates AI from human.
+   * Qui est derrière l'événement, estampillé par le serveur — jamais pris du
+   * client, sans quoi n'importe qui pourrait signer au nom d'un autre.
+   *
+   * Posé sur les commentaires (c'est ce qui rend « mon propre commentaire »
+   * répondable ; `author` ne sépare que l'IA de l'humain) et sur les
+   * déplacements. Absent des événements écrits avant qu'on l'estampille : un
+   * lecteur doit donc afficher « on ne sait pas », pas un nom vide.
+   *
+   * Pour une clé d'API, c'est le nom de la clé et non son porteur : la clé
+   * emprunte les droits de son créateur, pas son identité — personne ne doit
+   * croire qu'un humain a déplacé ce qu'un robot de CI a déplacé.
    */
   authorUser: z19.object({ id: z19.string().max(128), name: z19.string().max(200) }).optional(),
   /** Set when the author amended their comment, so the UI can say so. */
@@ -911,6 +931,19 @@ var KanbanCardSchema = z19.object({
    * d'en créer un en le tapant, sans passer par un écran d'administration.
    */
   groups: z19.array(z19.string().min(1).max(60)).max(30).optional(),
+  /**
+   * L'échéance de la carte : le jour où elle est attendue, `AAAA-MM-JJ`.
+   *
+   * Un jour, pas un instant, et c'est une décision : une équipe se dit « pour
+   * vendredi », jamais « pour vendredi 23:59:59 UTC ». Stocker un instant
+   * ferait afficher une échéance au 4 mars comme le 3 mars à qui travaille à
+   * l'ouest de Greenwich — la carte serait en retard d'un jour pour la moitié
+   * de l'équipe, et personne ne saurait pourquoi.
+   *
+   * Facultative, et absente veut dire « pas d'échéance », pas « en retard » :
+   * une carte qu'on n'a pas datée ne doit pas s'annoncer comme urgente.
+   */
+  deadline: z19.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
   /**
    * La couleur de la carte, en hexadécimal (`#RRGGBB`) — un liseré en haut de
    * la carte, et rien d'autre : ce qu'elle veut dire appartient à l'équipe.
@@ -945,6 +978,31 @@ var KanbanCardSchema = z19.object({
   conversationEvents: z19.array(KanbanCardEventSchema).optional(),
   createdAt: z19.string(),
   updatedAt: z19.string(),
+  /**
+   * Quand la carte a été archivée — absente tant qu'elle est au tableau.
+   *
+   * Une carte archivée reste dans sa colonne en base : c'est la lecture qui la
+   * retire du tableau, jamais une écriture qui la déplace. Rien à recoller donc
+   * au désarchivage, et aucun cimetière où une carte pourrait se perdre.
+   */
+  archivedAt: z19.string().optional(),
+  /**
+   * La colonne d'où la carte a été archivée, telle qu'elle s'appelait alors.
+   *
+   * L'identifiant sert à l'y remettre, le titre à le dire dans l'archive même
+   * quand la colonne a disparu depuis — auquel cas le désarchivage repose la
+   * carte dans la première colonne, sans se taire sur son origine.
+   */
+  archivedFrom: z19.object({ columnId: z19.string().max(128), columnTitle: z19.string().max(200) }).optional(),
+  /**
+   * Quand la carte a été supprimée. Rien n'est effacé : la carte reste en base,
+   * et toutes les lectures l'écartent.
+   *
+   * Une suppression est le seul geste que rien ne rattrape — sauf à ne pas
+   * l'exécuter vraiment. La colonne et le tableau portent le même champ, pour
+   * que supprimer l'un n'emporte jamais les cartes de l'autre.
+   */
+  deletedAt: z19.string().optional(),
   /**
    * People assigned to the card. Names are denormalized for display; the server
    * keeps only members of the owning organization, and notifies newcomers.
@@ -962,7 +1020,9 @@ var KanbanColumnSchema = z19.object({
   id: z19.string(),
   title: z19.string().min(1).max(200),
   order: z19.number().int(),
-  cards: z19.array(KanbanCardSchema).default([])
+  cards: z19.array(KanbanCardSchema).default([]),
+  /** Supprimée, mais conservée — voir `deletedAt` sur la carte. */
+  deletedAt: z19.string().optional()
 });
 var KanbanBoardSchema = z19.object({
   id: z19.string(),
@@ -978,6 +1038,8 @@ var KanbanBoardSchema = z19.object({
   instructions: z19.string().max(2e4).default(""),
   columns: z19.array(KanbanColumnSchema).default([]),
   archived: z19.boolean().default(false),
+  /** Supprimé, mais conservé avec ses cartes — voir `deletedAt` sur la carte. */
+  deletedAt: z19.string().optional(),
   createdAt: z19.string(),
   updatedAt: z19.string()
 });