@cavi-ai/api-client 0.1.0

package/dist/extensions/cavi/portal/tts.d.ts

@@ -0,0 +1,69 @@
+import type { HttpApiRequestInit } from "../../../core/http/types.js";
+import type { GatewayMediaJsonValue } from "../../../core/gateway/resources/media.js";
+export declare const PORTAL_TTS_PROVIDERS_PATH: "/api/plugins/machine/tts/providers";
+export declare const PORTAL_TTS_PATH: "/api/plugins/machine/tts";
+export type PortalTtsProviderVoiceLike = {
+    id: string;
+    name?: string;
+};
+export type PortalTtsProviderLike = {
+    id: string;
+    label?: string;
+    name?: string;
+    configured?: boolean;
+    voices?: readonly (PortalTtsProviderVoiceLike | string)[];
+};
+export type PortalTtsDashboardVoiceLike = {
+    current_voice_id?: string;
+    currentVoiceId?: string;
+    current_voice_name?: string;
+    currentVoiceName?: string;
+    target_voice?: string;
+    targetVoice?: string;
+};
+export type PortalTtsVoiceOption = {
+    value: string;
+    label: string;
+    detail?: string;
+    source: "gateway" | "dashboard";
+    voiceId: string;
+    providerId?: string;
+    providerLabel?: string;
+    agentKey?: string;
+};
+export type PortalTtsAgentVoiceAssignment = {
+    agentKey: string;
+    voiceValue: string;
+    voiceId: string;
+    voiceLabel: string;
+    providerId?: string;
+    providerLabel?: string;
+    assignedAt: string;
+};
+export type PortalTtsJsonRequester = <T>(path: string) => Promise<T>;
+export type PortalTtsBlobRequester = (path: string, init?: Pick<HttpApiRequestInit, "body" | "headers" | "method">) => Promise<Blob>;
+export type PortalTtsAudioTransport = {
+    requestBlob: PortalTtsBlobRequester;
+};
+export type PortalTtsAudioRequest = {
+    text: string;
+    voiceId?: string | null;
+    providerId?: string | null;
+    format?: string | null;
+    accept?: string | null;
+    options?: Record<string, GatewayMediaJsonValue>;
+};
+export declare function getPortalTtsProviderLabel(provider: PortalTtsProviderLike): string;
+export declare function buildPortalTtsVoiceOptions(params: {
+    providers?: readonly PortalTtsProviderLike[];
+    activeProviderId?: string;
+    dashboardVoices?: Record<string, PortalTtsDashboardVoiceLike>;
+}): PortalTtsVoiceOption[];
+export declare function createPortalTtsAgentVoiceAssignment(params: {
+    agentKey: string;
+    voice: PortalTtsVoiceOption;
+    assignedAt?: string;
+}): PortalTtsAgentVoiceAssignment;
+export declare function requestPortalTtsProviders(requestJson: PortalTtsJsonRequester): Promise<unknown>;
+export declare function requestPortalTtsAudio(transport: PortalTtsAudioTransport, body: PortalTtsAudioRequest): Promise<Blob>;
+//# sourceMappingURL=tts.d.ts.map

package/dist/extensions/cavi/portal/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/portal/tts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEtF,eAAO,MAAM,yBAAyB,sCAA0D,CAAC;AACjG,eAAO,MAAM,eAAe,4BAAiD,CAAC;AAE9E,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC,0BAA0B,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAErE,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,KAC3D,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACjD,CAAC;AAMF,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAEjF;AAmBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,SAAS,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CAC/D,GAAG,oBAAoB,EAAE,CA8DzB;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,6BAA6B,CAUhC;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,sBAAsB,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,uBAAuB,EAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/extensions/cavi/portal/tts.js

@@ -0,0 +1,116 @@
+import { CAVI_CONTROL_API_ENDPOINTS } from "../contracts/paths.js";
+export const PORTAL_TTS_PROVIDERS_PATH = CAVI_CONTROL_API_ENDPOINTS.portals.machine.ttsProviders;
+export const PORTAL_TTS_PATH = CAVI_CONTROL_API_ENDPOINTS.portals.machine.tts;
+function cleanString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function getPortalTtsProviderLabel(provider) {
+    return cleanString(provider.label) || cleanString(provider.name) || provider.id;
+}
+function dashboardVoiceId(voice) {
+    return cleanString(voice.current_voice_id) || cleanString(voice.currentVoiceId);
+}
+function dashboardVoiceLabel(agentKey, voice) {
+    return (cleanString(voice.current_voice_name) ||
+        cleanString(voice.currentVoiceName) ||
+        cleanString(voice.target_voice) ||
+        cleanString(voice.targetVoice) ||
+        agentKey);
+}
+export function buildPortalTtsVoiceOptions(params) {
+    const activeProviderId = cleanString(params.activeProviderId);
+    const providers = Array.isArray(params.providers)
+        ? [...params.providers].filter((provider) => provider.configured !== false &&
+            Array.isArray(provider.voices) &&
+            provider.voices.length > 0)
+        : [];
+    providers.sort((a, b) => {
+        const activeDiff = Number(b.id === activeProviderId) - Number(a.id === activeProviderId);
+        if (activeDiff !== 0)
+            return activeDiff;
+        return getPortalTtsProviderLabel(a).localeCompare(getPortalTtsProviderLabel(b));
+    });
+    const gatewayOptions = new Map();
+    for (const provider of providers) {
+        const providerId = cleanString(provider.id);
+        if (!providerId || !Array.isArray(provider.voices))
+            continue;
+        const providerLabel = getPortalTtsProviderLabel(provider);
+        const detail = providerId === activeProviderId ? `${providerLabel} (active)` : providerLabel;
+        for (const voice of provider.voices) {
+            const voiceId = typeof voice === "string" ? cleanString(voice) : cleanString(voice.id);
+            if (!voiceId)
+                continue;
+            const value = `gateway:${providerId}:${voiceId}`;
+            if (gatewayOptions.has(value))
+                continue;
+            gatewayOptions.set(value, {
+                value,
+                label: (typeof voice === "string" ? "" : cleanString(voice.name)) || voiceId,
+                detail,
+                source: "gateway",
+                voiceId,
+                providerId,
+                providerLabel,
+            });
+        }
+    }
+    if (gatewayOptions.size > 0) {
+        return [...gatewayOptions.values()];
+    }
+    return Object.entries(params.dashboardVoices ?? {})
+        .sort(([left], [right]) => left.localeCompare(right))
+        .flatMap(([agentKey, voice]) => {
+        const voiceId = dashboardVoiceId(voice);
+        if (!voiceId)
+            return [];
+        return [
+            {
+                value: `dashboard:${agentKey}:${voiceId}`,
+                label: dashboardVoiceLabel(agentKey, voice),
+                detail: `Dashboard voice (${agentKey})`,
+                source: "dashboard",
+                voiceId,
+                agentKey,
+            },
+        ];
+    });
+}
+export function createPortalTtsAgentVoiceAssignment(params) {
+    return {
+        agentKey: params.agentKey,
+        voiceValue: params.voice.value,
+        voiceId: params.voice.voiceId,
+        voiceLabel: params.voice.label,
+        ...(params.voice.providerId ? { providerId: params.voice.providerId } : {}),
+        ...(params.voice.providerLabel ? { providerLabel: params.voice.providerLabel } : {}),
+        assignedAt: params.assignedAt ?? new Date().toISOString(),
+    };
+}
+export function requestPortalTtsProviders(requestJson) {
+    return requestJson(PORTAL_TTS_PROVIDERS_PATH);
+}
+export async function requestPortalTtsAudio(transport, body) {
+    const text = cleanString(body.text);
+    if (!text) {
+        throw new Error("Enter text to synthesize.");
+    }
+    const voiceId = cleanString(body.voiceId);
+    const providerId = cleanString(body.providerId);
+    const format = cleanString(body.format);
+    const accept = cleanString(body.accept) || "audio/mpeg";
+    return transport.requestBlob(PORTAL_TTS_PATH, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Accept: accept,
+        },
+        body: {
+            text,
+            ...(voiceId ? { voiceId } : {}),
+            ...(providerId ? { providerId } : {}),
+            ...(format ? { format } : {}),
+            ...(body.options ? { options: body.options } : {}),
+        },
+    });
+}

package/dist/extensions/cavi/project-board/constants.d.ts

@@ -0,0 +1,68 @@
+import type { ProjectBoardBacklogPriority, ProjectBoardBacklogStatus } from "../domain/index.js";
+export declare const PROJECT_BOARD_CANONICAL_AVATAR_CANDIDATES: readonly [string, string, string];
+export declare const PROJECT_BOARD_FALLBACK_LIMITATIONS: readonly ["Cavi Control adapter used compatibility projection for Project Board payload."];
+export type ProjectBoardProfileApiResponse = {
+    name: string;
+    role: string;
+    photoPath: string | null;
+    photoUrl: string | null;
+    emails: string[];
+    lastUpdated: number;
+    storage: "json-file";
+    limitations: readonly string[];
+};
+export type ProjectBoardSprintApiResponse = {
+    sprint: {
+        id: string;
+        name: string;
+        goal: string;
+        startsOn: string | null;
+        endsOn: string | null;
+    };
+    statusMetrics: {
+        total: number;
+        todo: number;
+        inProgress: number;
+        blocked: number;
+        done: number;
+        completionRate: number;
+    };
+    lastUpdated: number;
+    storage: "json-file";
+    limitations: readonly string[];
+};
+export type ProjectBoardBacklogApiItemResponse = {
+    id: string;
+    title: string;
+    description: string | null;
+    section: string;
+    priority: ProjectBoardBacklogPriority;
+    status: ProjectBoardBacklogStatus;
+    tags: string[];
+    createdAt: number;
+    updatedAt: number;
+};
+export type ProjectBoardBacklogApiResponse = {
+    sections: Array<{
+        section: string;
+        items: ProjectBoardBacklogApiItemResponse[];
+    }>;
+    priorities: Record<ProjectBoardBacklogPriority, number>;
+    statusCounters: Record<ProjectBoardBacklogStatus, number>;
+    totalItems: number;
+    lastUpdated: number;
+    storage: "json-file";
+    limitations: readonly string[];
+};
+export type ProjectBoardCallApiAckResponse = {
+    ackId: string;
+    status: "queued";
+    action: string;
+    requestedBy: string;
+    queuedAt: number;
+    queueDepth: number;
+    note: string;
+    storage: "json-file";
+    limitations: readonly string[];
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/extensions/cavi/project-board/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/project-board/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,yCAAyC,mCAI5C,CAAC;AAEX,eAAO,MAAM,kCAAkC,4FAErC,CAAC;AAEX,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,yBAAyB,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,kCAAkC,EAAE,CAAC;KAC7C,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;IACxD,cAAc,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC"}

package/dist/extensions/cavi/project-board/constants.js

@@ -0,0 +1,9 @@
+import { resolveProjectBoardAssetPath } from "../runtime/paths.js";
+export const PROJECT_BOARD_CANONICAL_AVATAR_CANDIDATES = [
+    resolveProjectBoardAssetPath("project-board-wave.png"),
+    resolveProjectBoardAssetPath("project-board-reports.png"),
+    resolveProjectBoardAssetPath("project-board-laptop.png"),
+];
+export const PROJECT_BOARD_FALLBACK_LIMITATIONS = [
+    "Cavi Control adapter used compatibility projection for Project Board payload.",
+];

package/dist/extensions/cavi/project-board/fallback.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectBoardWorkspaceSnapshot } from "../domain/index.js";
+export declare const fallbackProjectBoardWorkspace: ProjectBoardWorkspaceSnapshot;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/extensions/cavi/project-board/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/project-board/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAIxE,eAAO,MAAM,6BAA6B,EAAE,6BA4H3C,CAAC"}

package/dist/extensions/cavi/project-board/fallback.js

@@ -0,0 +1,127 @@
+import { resolveProjectBoardAssetPath } from "../runtime/paths.js";
+import { fallbackSnapshotNow as now } from "../fallbacks/snapshots/shared.js";
+export const fallbackProjectBoardWorkspace = {
+    profile: {
+        name: "Project Board",
+        role: "Project Board Operator",
+        photoPath: resolveProjectBoardAssetPath("project-board-wave.png"),
+        photoUrl: null,
+        avatarCandidates: [
+            resolveProjectBoardAssetPath("project-board-wave.png"),
+            resolveProjectBoardAssetPath("project-board-reports.png"),
+            resolveProjectBoardAssetPath("project-board-laptop.png"),
+        ],
+        emails: ["ops@bloktix.io", "release-managers@bloktix.io"],
+        lastUpdated: now - 16 * 60_000,
+        storage: "json-file",
+        limitations: ["Mock fallback data for Cavi Control Project Board workspace."],
+    },
+    emails: [
+        { id: "ops@bloktix.io", email: "ops@bloktix.io" },
+        { id: "release-managers@bloktix.io", email: "release-managers@bloktix.io" },
+    ],
+    sprint: {
+        sprint: {
+            id: "current",
+            name: "Sprint 2026-W14",
+            goal: "Cavi Control store path realignment and Project Board data pipeline fixes",
+            startsOn: "2026-03-31",
+            endsOn: "2026-04-06",
+        },
+        statusMetrics: {
+            total: 4,
+            todo: 1,
+            inProgress: 1,
+            blocked: 1,
+            done: 1,
+            completionRate: 0.25,
+        },
+        lastUpdated: now - 14 * 60_000,
+        storage: "json-file",
+        limitations: ["Mock fallback data for Cavi Control Project Board workspace."],
+    },
+    backlog: {
+        sections: [
+            {
+                section: "now",
+                items: [
+                    {
+                        id: "project-board-backlog-2",
+                        title: "Fix store path alignment for project-board-store.json",
+                        description: "Move project-board-store.json from state/cavi-control/ to state/runtime/ to match workspace layout.",
+                        section: "now",
+                        priority: "p0",
+                        status: "in_progress",
+                        tags: ["infra", "store"],
+                        createdAt: now - 120 * 60_000,
+                        updatedAt: now - 20 * 60_000,
+                    },
+                ],
+            },
+            {
+                section: "blocked",
+                items: [
+                    {
+                        id: "project-board-backlog-3",
+                        title: "Validate Project Board API contract parity after store migration",
+                        description: "Waiting on rebuilt Project Board container to verify response field alignment.",
+                        section: "blocked",
+                        priority: "p0",
+                        status: "blocked",
+                        tags: ["contract", "api"],
+                        createdAt: now - 180 * 60_000,
+                        updatedAt: now - 65 * 60_000,
+                    },
+                ],
+            },
+            {
+                section: "next",
+                items: [
+                    {
+                        id: "project-board-backlog-1",
+                        title: "Update mock fallback data to current sprint",
+                        description: "Refresh mock backlog items and sprint metadata for W14.",
+                        section: "next",
+                        priority: "p1",
+                        status: "todo",
+                        tags: ["ui", "mock"],
+                        createdAt: now - 200 * 60_000,
+                        updatedAt: now - 45 * 60_000,
+                    },
+                ],
+            },
+            {
+                section: "done",
+                items: [
+                    {
+                        id: "project-board-backlog-4",
+                        title: "Add boot-time sync to Project Board server startup",
+                        description: "GitHub field cache refreshed automatically on container start.",
+                        section: "done",
+                        priority: "p2",
+                        status: "done",
+                        tags: ["infra", "sync"],
+                        createdAt: now - 210 * 60_000,
+                        updatedAt: now - 90 * 60_000,
+                    },
+                ],
+            },
+        ],
+        priorities: {
+            p0: 2,
+            p1: 1,
+            p2: 1,
+            p3: 0,
+        },
+        statusCounters: {
+            todo: 1,
+            in_progress: 1,
+            blocked: 1,
+            done: 1,
+        },
+        totalItems: 4,
+        lastUpdated: now - 20 * 60_000,
+        storage: "json-file",
+        limitations: ["Mock fallback data for Cavi Control Project Board workspace."],
+    },
+};

package/dist/extensions/cavi/project-board/live.d.ts

@@ -0,0 +1,16 @@
+import type { ProjectBoardBacklogDraft, ProjectBoardBacklogPriority, ProjectBoardBacklogStatus, ProjectBoardProfile, ProjectBoardWorkspaceSnapshot } from "../domain/index.js";
+import type { JsonHttpRequest } from "../../../core/http/json-client.js";
+export declare function createProjectBoardLiveHelpers(requestJson: JsonHttpRequest): {
+    loadProjectBoardWorkspaceLive: () => Promise<ProjectBoardWorkspaceSnapshot>;
+    loadProjectBoardProfileForEmailMutation: () => Promise<ProjectBoardProfile>;
+    persistProjectBoardEmails: (emails: string[]) => Promise<ProjectBoardProfile>;
+    toBacklogMutationPayload: (draft: ProjectBoardBacklogDraft) => {
+        title: string;
+        description: string | null;
+        section: string;
+        priority: ProjectBoardBacklogPriority;
+        status: ProjectBoardBacklogStatus;
+        tags: string[];
+    };
+};
+//# sourceMappingURL=live.d.ts.map

package/dist/extensions/cavi/project-board/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/project-board/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAUzE,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,eAAe;yCACxB,OAAO,CAAC,6BAA6B,CAAC;mDAyB5B,OAAO,CAAC,mBAAmB,CAAC;wCAarC,MAAM,EAAE,KAAG,OAAO,CAAC,mBAAmB,CAAC;sCA2B/E,wBAAwB,KAC9B;QACD,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,2BAA2B,CAAC;QACtC,MAAM,EAAE,yBAAyB,CAAC;QAClC,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB;EA4BF"}

package/dist/extensions/cavi/project-board/live.js

@@ -0,0 +1,86 @@
+import { GatewayHttpError } from "../../../core/http/gateway-error.js";
+import { API_PROJECT_BOARD, PROJECT_BOARD_API } from "../contracts/paths.js";
+import { normalizeEmailList, toProjectBoardProfile, toProjectBoardWorkspaceFromCompatPayload, toProjectBoardWorkspaceSnapshot, } from "./normalize.js";
+import { asString } from "../../../core/data/guards.js";
+export function createProjectBoardLiveHelpers(requestJson) {
+    const loadProjectBoardWorkspaceLive = async () => {
+        try {
+            const [profilePayload, sprintPayload, backlogPayload] = await Promise.all([
+                requestJson(PROJECT_BOARD_API.profile),
+                requestJson(PROJECT_BOARD_API.sprint),
+                requestJson(PROJECT_BOARD_API.backlog),
+            ]);
+            return toProjectBoardWorkspaceSnapshot({
+                profilePayload,
+                sprintPayload,
+                backlogPayload,
+            });
+        }
+        catch (error) {
+            if (!(error instanceof GatewayHttpError) || error.status !== 404) {
+                throw error;
+            }
+            const compatPayload = await requestJson(API_PROJECT_BOARD);
+            return toProjectBoardWorkspaceFromCompatPayload(compatPayload);
+        }
+    };
+    const loadProjectBoardProfileForEmailMutation = async () => {
+        try {
+            const profilePayload = await requestJson(PROJECT_BOARD_API.profile);
+            return toProjectBoardProfile(profilePayload);
+        }
+        catch (error) {
+            if (!(error instanceof GatewayHttpError) || error.status !== 404) {
+                throw error;
+            }
+            const compatPayload = await requestJson(API_PROJECT_BOARD);
+            return toProjectBoardWorkspaceFromCompatPayload(compatPayload).profile;
+        }
+    };
+    const persistProjectBoardEmails = async (emails) => {
+        const normalizedEmails = normalizeEmailList(emails);
+        try {
+            const payload = await requestJson(PROJECT_BOARD_API.profile, {
+                method: "PUT",
+                body: {
+                    emails: normalizedEmails,
+                },
+            });
+            return toProjectBoardProfile(payload);
+        }
+        catch (error) {
+            if (!(error instanceof GatewayHttpError) || error.status !== 404) {
+                throw error;
+            }
+            const compatPayload = await requestJson(API_PROJECT_BOARD, {
+                method: "PUT",
+                body: {
+                    emails: normalizedEmails,
+                },
+            });
+            return toProjectBoardWorkspaceFromCompatPayload(compatPayload).profile;
+        }
+    };
+    const toBacklogMutationPayload = (draft) => {
+        const title = draft.title.trim();
+        const section = draft.section.trim();
+        const description = draft.description.trim();
+        return {
+            title,
+            description: description.length > 0 ? description : null,
+            section,
+            priority: draft.priority,
+            status: draft.status,
+            tags: Array.from(new Set(draft.tags
+                .map((tag) => asString(tag))
+                .filter((tag) => Boolean(tag))
+                .map((tag) => tag.toLowerCase()))),
+        };
+    };
+    return {
+        loadProjectBoardWorkspaceLive,
+        loadProjectBoardProfileForEmailMutation,
+        persistProjectBoardEmails,
+        toBacklogMutationPayload,
+    };
+}

package/dist/extensions/cavi/project-board/mutations.d.ts

@@ -0,0 +1,43 @@
+import type { ProjectBoardBacklogDraft, ProjectBoardCallRequest, ProjectBoardEmailDraft } from "../domain/index.js";
+import type { JsonHttpRequest } from "../../../core/http/json-client.js";
+import { type MutationResult } from "../../../core/gateway/envelope/index.js";
+import type { createProjectBoardLiveHelpers } from "./live.js";
+type ProjectBoardLiveHelpers = ReturnType<typeof createProjectBoardLiveHelpers>;
+export declare function createProjectBoardMutations(requestJson: JsonHttpRequest, projectBoardLive: ProjectBoardLiveHelpers): {
+    createProjectBoardEmail: (draft: ProjectBoardEmailDraft) => Promise<MutationResult<{
+        id: string;
+        email: string;
+    }>>;
+    updateProjectBoardEmail: (emailId: string, draft: ProjectBoardEmailDraft) => Promise<MutationResult<{
+        id: string;
+        email: string;
+    }>>;
+    removeProjectBoardEmail: (emailId: string) => Promise<MutationResult<{
+        id: string;
+    }>>;
+    createProjectBoardBacklogItem: (draft: ProjectBoardBacklogDraft) => Promise<MutationResult<{
+        id: string;
+        title: string;
+        description: string | null;
+        section: string;
+        priority: import("../index.js").ProjectBoardBacklogPriority;
+        status: import("../index.js").ProjectBoardBacklogStatus;
+        tags: string[];
+        createdAt: number;
+        updatedAt: number;
+    }>>;
+    updateProjectBoardBacklogItem: (itemId: string, draft: ProjectBoardBacklogDraft) => Promise<MutationResult<{
+        id: string;
+        title: string;
+        description: string | null;
+        section: string;
+        priority: import("../index.js").ProjectBoardBacklogPriority;
+        status: import("../index.js").ProjectBoardBacklogStatus;
+        tags: string[];
+        createdAt: number;
+        updatedAt: number;
+    }>>;
+    callProjectBoard: (request: ProjectBoardCallRequest) => Promise<MutationResult<import("../index.js").ProjectBoardCallResult>>;
+};
+export {};
+//# sourceMappingURL=mutations.d.ts.map

package/dist/extensions/cavi/project-board/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/project-board/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,yCAAyC,CAAC;AAgBjD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAE/D,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEhF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,eAAe,EAC5B,gBAAgB,EAAE,uBAAuB;qCAU9B,sBAAsB,KAC5B,OAAO,CAAC,cAAc,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;uCAwC9C,MAAM,SACR,sBAAsB,KAC5B,OAAO,CAAC,cAAc,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;uCA2C9C,MAAM,KACd,OAAO,CAAC,cAAc,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;2CA8BG,wBAAwB;;;;;;;;;;;4CA8BvB,MAAM,SAAS,wBAAwB;;;;;;;;;;;gCAoCnD,uBAAuB;EAgF5D"}