@imenam/mcp-organizer 0.0.0-stage → 1.0.1

package/dist/shared/logic/labels.d.ts

@@ -0,0 +1,5 @@
+import type { TaskPriority, TaskStatus, TaskType } from "../schemas/enums.schema.js";
+/** Libellés français des statuts, priorités et types de tâche, communs à la GUI et aux résumés des actions de l'agent. */
+export declare const STATUS_LABELS: Record<TaskStatus, string>;
+export declare const PRIORITY_LABELS: Record<TaskPriority, string>;
+export declare const TYPE_LABELS: Record<TaskType, string>;

package/dist/shared/logic/labels.js

@@ -0,0 +1,17 @@
+/** Libellés français des statuts, priorités et types de tâche, communs à la GUI et aux résumés des actions de l'agent. */
+export const STATUS_LABELS = {
+    todo: "À faire",
+    doing: "En cours",
+    review: "En revue",
+    done: "Terminé",
+};
+export const PRIORITY_LABELS = {
+    low: "Basse",
+    medium: "Moyenne",
+    high: "Haute",
+    critical: "Critique",
+};
+export const TYPE_LABELS = {
+    standard: "Standard",
+    test: "Test",
+};

package/dist/shared/logic/positions.d.ts

@@ -0,0 +1,9 @@
+/** Rangs fractionnaires des éléments ordonnés (tâches d'une colonne, éléments d'une checklist). */
+/** Écart minimal entre deux rangs voisins ; en dessous, la liste est renumérotée. */
+export declare const MIN_POSITION_GAP = 0.000001;
+/**
+ * Rang d'un élément inséré entre `previous` et `next` (null : début ou fin de
+ * liste). Renvoie null quand l'écart entre les deux voisins est trop faible
+ * pour y loger un rang distinct : la liste doit d'abord être renumérotée.
+ */
+export declare function positionBetween(previous: number | null, next: number | null): number | null;

package/dist/shared/logic/positions.js

@@ -0,0 +1,19 @@
+/** Rangs fractionnaires des éléments ordonnés (tâches d'une colonne, éléments d'une checklist). */
+/** Écart minimal entre deux rangs voisins ; en dessous, la liste est renumérotée. */
+export const MIN_POSITION_GAP = 1e-6;
+/**
+ * Rang d'un élément inséré entre `previous` et `next` (null : début ou fin de
+ * liste). Renvoie null quand l'écart entre les deux voisins est trop faible
+ * pour y loger un rang distinct : la liste doit d'abord être renumérotée.
+ */
+export function positionBetween(previous, next) {
+    if (previous === null && next === null)
+        return 1;
+    if (previous === null)
+        return next - 1;
+    if (next === null)
+        return Math.floor(previous) + 1;
+    if (next - previous < MIN_POSITION_GAP * 2)
+        return null;
+    return (previous + next) / 2;
+}

package/dist/shared/logic/spaces.d.ts

@@ -0,0 +1,13 @@
+/** Logique pure des espaces, commune au serveur et à la GUI. */
+/** Préfixe des numéros de tâche de l'espace personnel. */
+export declare const PERSONAL_KEY_PREFIX = "PERSO";
+/** Nom de l'espace personnel. */
+export declare const PERSONAL_SPACE_NAME = "Personnel";
+/**
+ * Préfixe de clé dérivé du nom d'un espace : initiales des mots significatifs
+ * (2 à 4), ou les trois premières lettres d'un nom d'un seul mot. Le préfixe
+ * commence par une lettre ; un nom sans lettre donne `ESP`.
+ */
+export declare function deriveKeyPrefix(name: string): string;
+/** Initiales d'un nom affiché (deux lettres au plus), ou de l'adresse e-mail. */
+export declare function initialsOf(displayName: string | null, email: string): string;

package/dist/shared/logic/spaces.js

@@ -0,0 +1,48 @@
+/** Logique pure des espaces, commune au serveur et à la GUI. */
+/** Préfixe des numéros de tâche de l'espace personnel. */
+export const PERSONAL_KEY_PREFIX = "PERSO";
+/** Nom de l'espace personnel. */
+export const PERSONAL_SPACE_NAME = "Personnel";
+/** Mots ignorés pour former un préfixe à partir d'un nom. */
+const STOP_WORDS = new Set(["de", "du", "des", "la", "le", "les", "l", "d", "et", "a", "au", "aux", "en", "the", "of", "and"]);
+/** Lettres et chiffres d'un texte, sans accents, en majuscules, découpés en mots. */
+function words(name) {
+    return name
+        .normalize("NFD")
+        .replace(/[̀-ͯ]/g, "")
+        .toUpperCase()
+        .split(/[^A-Z0-9]+/)
+        .filter((word) => word.length > 0);
+}
+/**
+ * Préfixe de clé dérivé du nom d'un espace : initiales des mots significatifs
+ * (2 à 4), ou les trois premières lettres d'un nom d'un seul mot. Le préfixe
+ * commence par une lettre ; un nom sans lettre donne `ESP`.
+ */
+export function deriveKeyPrefix(name) {
+    const all = words(name).map((word) => word.replace(/^[0-9]+/, "")).filter((word) => word.length > 0);
+    const significant = all.filter((word) => !STOP_WORDS.has(word.toLowerCase()));
+    const chosen = significant.length > 0 ? significant : all;
+    if (chosen.length === 0)
+        return "ESP";
+    if (chosen.length === 1)
+        return chosen[0].slice(0, 3).padEnd(2, "X");
+    return chosen
+        .slice(0, 4)
+        .map((word) => word[0])
+        .join("");
+}
+/** Initiales d'un nom affiché (deux lettres au plus), ou de l'adresse e-mail. */
+export function initialsOf(displayName, email) {
+    const source = displayName && displayName.trim() !== "" ? displayName : email.split("@")[0];
+    const parts = source
+        .normalize("NFD")
+        .replace(/[̀-ͯ]/g, "")
+        .split(/[^A-Za-z0-9]+/)
+        .filter((part) => part.length > 0);
+    if (parts.length === 0)
+        return "?";
+    if (parts.length === 1)
+        return parts[0].slice(0, 2).toUpperCase();
+    return (parts[0][0] + parts[1][0]).toUpperCase();
+}

package/dist/shared/logic/test-summary.d.ts

@@ -0,0 +1,28 @@
+import type { TestResultValue } from "../schemas/enums.schema.js";
+/** Bilan d'une tâche de test : nombre de points par résultat combiné. */
+export interface TestSummary {
+    /** Nombre de points de vérification. */
+    total: number;
+    /** Points qui ont au moins un résultat autre que « à vérifier ». */
+    verified: number;
+    ok: number;
+    ko: number;
+    blocked: number;
+    /** Points qu'aucun testeur n'a encore vérifiés. */
+    untested: number;
+}
+/**
+ * Résultat combiné d'un point d'après les résultats de ses testeurs : KO si
+ * l'un d'eux a trouvé un KO, sinon Bloqué si l'un d'eux est bloqué, sinon OK
+ * si l'un d'eux l'a validé, sinon à vérifier.
+ */
+export declare function combinedResult(results: readonly TestResultValue[]): TestResultValue;
+/**
+ * Bilan des points `checkpointIds`, d'après les résultats des seuls testeurs
+ * `testerIds` (les assignés de la tâche).
+ */
+export declare function summarizeTest(checkpointIds: readonly string[], results: readonly {
+    checkpointId: string;
+    testerId: string;
+    result: TestResultValue;
+}[], testerIds: readonly string[]): TestSummary;

package/dist/shared/logic/test-summary.js

@@ -0,0 +1,35 @@
+/**
+ * Résultat combiné d'un point d'après les résultats de ses testeurs : KO si
+ * l'un d'eux a trouvé un KO, sinon Bloqué si l'un d'eux est bloqué, sinon OK
+ * si l'un d'eux l'a validé, sinon à vérifier.
+ */
+export function combinedResult(results) {
+    if (results.includes("ko"))
+        return "ko";
+    if (results.includes("blocked"))
+        return "blocked";
+    if (results.includes("ok"))
+        return "ok";
+    return "untested";
+}
+/**
+ * Bilan des points `checkpointIds`, d'après les résultats des seuls testeurs
+ * `testerIds` (les assignés de la tâche).
+ */
+export function summarizeTest(checkpointIds, results, testerIds) {
+    const testers = new Set(testerIds);
+    const byCheckpoint = new Map();
+    for (const entry of results) {
+        if (!testers.has(entry.testerId))
+            continue;
+        byCheckpoint.set(entry.checkpointId, [...(byCheckpoint.get(entry.checkpointId) ?? []), entry.result]);
+    }
+    const summary = { total: checkpointIds.length, verified: 0, ok: 0, ko: 0, blocked: 0, untested: 0 };
+    for (const id of checkpointIds) {
+        const result = combinedResult(byCheckpoint.get(id) ?? []);
+        summary[result] += 1;
+        if (result !== "untested")
+            summary.verified += 1;
+    }
+    return summary;
+}

package/dist/shared/schemas/agent-api.schema.d.ts

@@ -0,0 +1,268 @@
+import { z } from "zod";
+/** Corps des requêtes et des réponses de la file de l'agent et de l'historique dans la GUI. */
+export declare const MAX_REQUEST_LENGTH = 10000;
+/** Types de demande que la GUI dépose directement (la review de test et la promotion d'idée ont leur propre route). */
+export declare const GUI_REQUEST_KINDS: readonly ["idea", "remark", "message"];
+export declare const RequestTextSchema: z.ZodString;
+export declare const CreateRequestSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        idea: "idea";
+        message: "message";
+        remark: "remark";
+    }>;
+    text: z.ZodString;
+    contextTaskId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CreateRequest = z.infer<typeof CreateRequestSchema>;
+export declare const UpdateRequestSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type UpdateRequest = z.infer<typeof UpdateRequestSchema>;
+/** Action de l'agent telle que l'affichent la page Agent et le panneau assistant. */
+export declare const AgentActionViewSchema: z.ZodObject<{
+    id: z.ZodString;
+    seq: z.ZodNumber;
+    entityType: z.ZodEnum<{
+        agent_action: "agent_action";
+        agent_request: "agent_request";
+        agent_token: "agent_token";
+        attachment: "attachment";
+        checklist_item: "checklist_item";
+        comment: "comment";
+        idea: "idea";
+        invitation: "invitation";
+        membership: "membership";
+        notification: "notification";
+        space: "space";
+        tag: "tag";
+        task: "task";
+        test_checkpoint: "test_checkpoint";
+        test_result: "test_result";
+        test_review: "test_review";
+        user: "user";
+        user_settings: "user_settings";
+    }>;
+    operation: z.ZodEnum<{
+        assign: "assign";
+        create: "create";
+        delete: "delete";
+        move: "move";
+        update: "update";
+    }>;
+    label: z.ZodString;
+    summary: z.ZodString;
+    taskId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    undoneAt: z.ZodNullable<z.ZodISODateTime>;
+    undoneByName: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AgentActionView = z.infer<typeof AgentActionViewSchema>;
+/** Jeton d'agent tel que l'affichent la page Agent et le panneau assistant : son nom et son propriétaire. */
+export declare const AgentRefSchema: z.ZodObject<{
+    tokenId: z.ZodString;
+    name: z.ZodString;
+    ownerName: z.ZodString;
+}, z.core.$strip>;
+export type AgentRef = z.infer<typeof AgentRefSchema>;
+export declare const RequestViewSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        idea: "idea";
+        idea_promotion: "idea_promotion";
+        message: "message";
+        remark: "remark";
+        test_review: "test_review";
+    }>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        failed: "failed";
+        pending: "pending";
+        processing: "processing";
+    }>;
+    text: z.ZodString;
+    title: z.ZodString;
+    authorId: z.ZodString;
+    authorName: z.ZodString;
+    authorEmail: z.ZodString;
+    targetSpaceId: z.ZodString;
+    targetSpaceName: z.ZodString;
+    contextTask: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        key: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+    reply: z.ZodNullable<z.ZodString>;
+    failureReason: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    claimedAt: z.ZodNullable<z.ZodISODateTime>;
+    agent: z.ZodNullable<z.ZodObject<{
+        tokenId: z.ZodString;
+        name: z.ZodString;
+        ownerName: z.ZodString;
+    }, z.core.$strip>>;
+    completedAt: z.ZodNullable<z.ZodISODateTime>;
+    cancelledByName: z.ZodNullable<z.ZodString>;
+    canEdit: z.ZodBoolean;
+    canRelease: z.ZodBoolean;
+    canUndo: z.ZodBoolean;
+    actions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        seq: z.ZodNumber;
+        entityType: z.ZodEnum<{
+            agent_action: "agent_action";
+            agent_request: "agent_request";
+            agent_token: "agent_token";
+            attachment: "attachment";
+            checklist_item: "checklist_item";
+            comment: "comment";
+            idea: "idea";
+            invitation: "invitation";
+            membership: "membership";
+            notification: "notification";
+            space: "space";
+            tag: "tag";
+            task: "task";
+            test_checkpoint: "test_checkpoint";
+            test_result: "test_result";
+            test_review: "test_review";
+            user: "user";
+            user_settings: "user_settings";
+        }>;
+        operation: z.ZodEnum<{
+            assign: "assign";
+            create: "create";
+            delete: "delete";
+            move: "move";
+            update: "update";
+        }>;
+        label: z.ZodString;
+        summary: z.ZodString;
+        taskId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        undoneAt: z.ZodNullable<z.ZodISODateTime>;
+        undoneByName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RequestView = z.infer<typeof RequestViewSchema>;
+export declare const RequestListResponseSchema: z.ZodObject<{
+    requests: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            idea: "idea";
+            idea_promotion: "idea_promotion";
+            message: "message";
+            remark: "remark";
+            test_review: "test_review";
+        }>;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            done: "done";
+            failed: "failed";
+            pending: "pending";
+            processing: "processing";
+        }>;
+        text: z.ZodString;
+        title: z.ZodString;
+        authorId: z.ZodString;
+        authorName: z.ZodString;
+        authorEmail: z.ZodString;
+        targetSpaceId: z.ZodString;
+        targetSpaceName: z.ZodString;
+        contextTask: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            key: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strip>>;
+        reply: z.ZodNullable<z.ZodString>;
+        failureReason: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        claimedAt: z.ZodNullable<z.ZodISODateTime>;
+        agent: z.ZodNullable<z.ZodObject<{
+            tokenId: z.ZodString;
+            name: z.ZodString;
+            ownerName: z.ZodString;
+        }, z.core.$strip>>;
+        completedAt: z.ZodNullable<z.ZodISODateTime>;
+        cancelledByName: z.ZodNullable<z.ZodString>;
+        canEdit: z.ZodBoolean;
+        canRelease: z.ZodBoolean;
+        canUndo: z.ZodBoolean;
+        actions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            seq: z.ZodNumber;
+            entityType: z.ZodEnum<{
+                agent_action: "agent_action";
+                agent_request: "agent_request";
+                agent_token: "agent_token";
+                attachment: "attachment";
+                checklist_item: "checklist_item";
+                comment: "comment";
+                idea: "idea";
+                invitation: "invitation";
+                membership: "membership";
+                notification: "notification";
+                space: "space";
+                tag: "tag";
+                task: "task";
+                test_checkpoint: "test_checkpoint";
+                test_result: "test_result";
+                test_review: "test_review";
+                user: "user";
+                user_settings: "user_settings";
+            }>;
+            operation: z.ZodEnum<{
+                assign: "assign";
+                create: "create";
+                delete: "delete";
+                move: "move";
+                update: "update";
+            }>;
+            label: z.ZodString;
+            summary: z.ZodString;
+            taskId: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodISODateTime;
+            undoneAt: z.ZodNullable<z.ZodISODateTime>;
+            undoneByName: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    pendingCount: z.ZodNumber;
+    agents: z.ZodArray<z.ZodObject<{
+        tokenId: z.ZodString;
+        name: z.ZodString;
+        ownerName: z.ZodString;
+        lastUsedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RequestListResponse = z.infer<typeof RequestListResponseSchema>;
+/** Version d'une tâche dans son historique. */
+export declare const TaskVersionViewSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+    actorType: z.ZodEnum<{
+        agent: "agent";
+        user: "user";
+    }>;
+    actorName: z.ZodString;
+    requestId: z.ZodNullable<z.ZodString>;
+    changes: z.ZodArray<z.ZodString>;
+    current: z.ZodBoolean;
+}, z.core.$strip>;
+export type TaskVersionView = z.infer<typeof TaskVersionViewSchema>;
+export declare const TaskVersionsResponseSchema: z.ZodObject<{
+    versions: z.ZodArray<z.ZodObject<{
+        version: z.ZodNumber;
+        createdAt: z.ZodISODateTime;
+        actorType: z.ZodEnum<{
+            agent: "agent";
+            user: "user";
+        }>;
+        actorName: z.ZodString;
+        requestId: z.ZodNullable<z.ZodString>;
+        changes: z.ZodArray<z.ZodString>;
+        current: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TaskVersionsResponse = z.infer<typeof TaskVersionsResponseSchema>;

package/dist/shared/schemas/agent-api.schema.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { ActorTypeSchema, AgentOperationSchema, EntityTypeSchema, RequestKindSchema, RequestStatusSchema } from "./enums.schema.js";
+import { IdSchema, TimestampSchema } from "./entities.schema.js";
+import { TaskRefSchema } from "./tasks-api.schema.js";
+/** Corps des requêtes et des réponses de la file de l'agent et de l'historique dans la GUI. */
+export const MAX_REQUEST_LENGTH = 10_000;
+/** Types de demande que la GUI dépose directement (la review de test et la promotion d'idée ont leur propre route). */
+export const GUI_REQUEST_KINDS = ["idea", "remark", "message"];
+export const RequestTextSchema = z
+    .string()
+    .trim()
+    .min(1, "La demande est vide : écrivez ce que vous voulez confier à l'agent.")
+    .max(MAX_REQUEST_LENGTH, `La demande dépasse ${MAX_REQUEST_LENGTH} caractères.`);
+export const CreateRequestSchema = z.object({
+    kind: z.enum(GUI_REQUEST_KINDS),
+    text: RequestTextSchema,
+    /** Tâche ouverte au moment de l'écriture, que l'agent reçoit pour contexte. */
+    contextTaskId: IdSchema.nullable().optional(),
+});
+export const UpdateRequestSchema = z.object({ text: RequestTextSchema });
+/** Action de l'agent telle que l'affichent la page Agent et le panneau assistant. */
+export const AgentActionViewSchema = z.object({
+    id: IdSchema,
+    seq: z.number().int(),
+    entityType: EntityTypeSchema,
+    operation: AgentOperationSchema,
+    /** Identifiant lisible de la tâche concernée (`ORG-41`), « Idée » pour une idée. */
+    label: z.string(),
+    /** Description en français : « Statut En cours → En revue ». */
+    summary: z.string(),
+    /** Tâche concernée, si elle existe encore. */
+    taskId: IdSchema.nullable(),
+    createdAt: TimestampSchema,
+    undoneAt: TimestampSchema.nullable(),
+    undoneByName: z.string().nullable(),
+});
+/** Jeton d'agent tel que l'affichent la page Agent et le panneau assistant : son nom et son propriétaire. */
+export const AgentRefSchema = z.object({
+    tokenId: IdSchema,
+    name: z.string(),
+    ownerName: z.string(),
+});
+export const RequestViewSchema = z.object({
+    id: IdSchema,
+    kind: RequestKindSchema,
+    status: RequestStatusSchema,
+    text: z.string(),
+    /** Ligne affichée dans la file : le texte, ou un résumé pour une review de test ou une promotion d'idée. */
+    title: z.string(),
+    authorId: IdSchema,
+    authorName: z.string(),
+    authorEmail: z.string(),
+    targetSpaceId: IdSchema,
+    targetSpaceName: z.string(),
+    contextTask: TaskRefSchema.nullable(),
+    reply: z.string().nullable(),
+    failureReason: z.string().nullable(),
+    createdAt: TimestampSchema,
+    updatedAt: TimestampSchema,
+    claimedAt: TimestampSchema.nullable(),
+    /** Jeton qui a pris la demande, en cours ou terminée ; null en attente, annulée, ou si le jeton n'existe plus. */
+    agent: AgentRefSchema.nullable(),
+    completedAt: TimestampSchema.nullable(),
+    cancelledByName: z.string().nullable(),
+    /** Vrai si l'utilisateur peut modifier ou annuler la demande (en attente, et membre de son espace). */
+    canEdit: z.boolean(),
+    /** Vrai si l'utilisateur peut libérer la demande prise par l'agent (en cours, et membre de son espace). */
+    canRelease: z.boolean(),
+    /** Vrai si l'utilisateur voit et peut annuler les actions du lot (membre de son espace, demande terminée). */
+    canUndo: z.boolean(),
+    /** Actions du lot, dans l'ordre ; vide pour qui n'est pas membre de son espace. */
+    actions: z.array(AgentActionViewSchema),
+});
+export const RequestListResponseSchema = z.object({
+    /** Demandes de l'espace, de la plus récente à la plus ancienne. */
+    requests: z.array(RequestViewSchema),
+    pendingCount: z.number().int().min(0),
+    /** Jetons actifs qui couvrent l'espace, du plus récemment utilisé au moins récemment. */
+    agents: z.array(AgentRefSchema.extend({ lastUsedAt: TimestampSchema.nullable() })),
+});
+/** Version d'une tâche dans son historique. */
+export const TaskVersionViewSchema = z.object({
+    version: z.number().int(),
+    createdAt: TimestampSchema,
+    actorType: ActorTypeSchema,
+    /** Utilisateur auteur de la version ; pour l'agent, l'auteur de la demande. */
+    actorName: z.string(),
+    requestId: IdSchema.nullable(),
+    /** Champs modifiés par rapport à la version précédente, en français ; « Création » pour la première. */
+    changes: z.array(z.string()),
+    /** Vrai pour la version qui décrit l'état actuel. */
+    current: z.boolean(),
+});
+export const TaskVersionsResponseSchema = z.object({ versions: z.array(TaskVersionViewSchema) });