kemdicode-mcp 1.15.0

package/dist/kanban/workspace-store.js

@@ -0,0 +1,386 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Workspace Store
+ *
+ * Redis-based persistence layer for Workspace management.
+ * Workspaces enable cross-session collaboration by grouping sessions
+ * that can share Kanban boards.
+ *
+ * @module kanban/workspace-store
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { Logger } from '../utils/logger.js';
+import { getSharedRedis } from '../infrastructure/redis/connection.js';
+import { KANBAN_KEYS, DEFAULT_TASK_TTL } from './types.js';
+const getRedis = getSharedRedis;
+/**
+ * Generate a unique workspace ID
+ *
+ * @description Creates a workspace ID with 'ws_' prefix followed by UUID
+ * @returns {string} Unique workspace ID (format: ws_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
+ * @internal
+ */
+function generateWorkspaceId() {
+    return `ws_${uuidv4()}`;
+}
+/**
+ * Create a new workspace for cross-session collaboration
+ *
+ * @description Creates a workspace that can group multiple sessions together,
+ *              enabling them to share Kanban boards. The creating session
+ *              automatically becomes a member.
+ * @param {CreateWorkspaceInput} input - Workspace creation parameters
+ * @param {string} input.name - Human-readable workspace name
+ * @param {string} [input.description] - Optional workspace description
+ * @param {string} input.ownerSessionId - Session ID of the workspace creator
+ * @param {string} input.ownerId - Agent ID of the workspace creator
+ * @param {string[]} [input.initialMemberSessions] - Additional sessions to invite
+ * @returns {Promise<Workspace>} The created workspace with generated ID and timestamps
+ *
+ * @example
+ * ```typescript
+ * const workspace = await createWorkspace({
+ *   name: 'Frontend Team',
+ *   description: 'Shared workspace for frontend developers',
+ *   ownerSessionId: 'session-123',
+ *   ownerId: 'agent-1',
+ *   initialMemberSessions: ['session-456'],
+ * });
+ * ```
+ */
+export async function createWorkspace(input) {
+    const client = await getRedis();
+    const id = generateWorkspaceId();
+    const now = Date.now();
+    const memberSessions = [input.ownerSessionId, ...(input.initialMemberSessions || [])];
+    // Deduplicate sessions
+    const uniqueSessions = [...new Set(memberSessions)];
+    const workspace = {
+        id,
+        name: input.name,
+        description: input.description,
+        ownerId: input.ownerId,
+        ownerSessionId: input.ownerSessionId,
+        memberSessions: uniqueSessions,
+        createdAt: now,
+        updatedAt: now,
+    };
+    const pipeline = client.pipeline();
+    // Store workspace data
+    pipeline.setex(KANBAN_KEYS.workspace(id), DEFAULT_TASK_TTL, JSON.stringify(workspace));
+    // Add to global workspace list
+    pipeline.sadd(KANBAN_KEYS.allWorkspaces, id);
+    // Add sessions to workspace
+    for (const sessionId of uniqueSessions) {
+        pipeline.sadd(KANBAN_KEYS.workspaceSessions(id), sessionId);
+        pipeline.sadd(KANBAN_KEYS.workspacesBySession(sessionId), id);
+        pipeline.expire(KANBAN_KEYS.workspacesBySession(sessionId), DEFAULT_TASK_TTL);
+    }
+    pipeline.expire(KANBAN_KEYS.workspaceSessions(id), DEFAULT_TASK_TTL);
+    await pipeline.exec();
+    Logger.debug(`workspace-store: created workspace '${input.name}' (${id})`);
+    return workspace;
+}
+/**
+ * Retrieve a workspace by its ID
+ *
+ * @description Fetches workspace data from Redis by ID
+ * @param {string} workspaceId - The workspace ID to retrieve
+ * @returns {Promise<Workspace | null>} The workspace if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const workspace = await getWorkspace('ws_abc123');
+ * if (workspace) {
+ *   console.log(`Found: ${workspace.name}`);
+ * }
+ * ```
+ */
+export async function getWorkspace(workspaceId) {
+    const client = await getRedis();
+    const data = await client.get(KANBAN_KEYS.workspace(workspaceId));
+    if (!data) {
+        return null;
+    }
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        Logger.error(`workspace-store: failed to parse workspace ${workspaceId}`);
+        return null;
+    }
+}
+/**
+ * List all workspaces a session belongs to
+ *
+ * @description Retrieves all workspaces that include the given session as a member
+ * @param {string} sessionId - Session ID to look up
+ * @returns {Promise<Workspace[]>} Array of workspaces the session belongs to
+ *
+ * @example
+ * ```typescript
+ * const workspaces = await listWorkspacesForSession('session-123');
+ * console.log(`Session belongs to ${workspaces.length} workspaces`);
+ * ```
+ */
+export async function listWorkspacesForSession(sessionId) {
+    const client = await getRedis();
+    const workspaceIds = await client.smembers(KANBAN_KEYS.workspacesBySession(sessionId));
+    if (workspaceIds.length === 0) {
+        return [];
+    }
+    const workspaces = [];
+    for (const wsId of workspaceIds) {
+        const workspace = await getWorkspace(wsId);
+        if (workspace) {
+            workspaces.push(workspace);
+        }
+    }
+    return workspaces;
+}
+/**
+ * List all available workspaces
+ *
+ * @description Retrieves all workspaces in the system. Useful for discovery.
+ * @param {Object} [options] - Listing options
+ * @param {number} [options.limit=50] - Maximum number of workspaces to return
+ * @returns {Promise<Workspace[]>} Array of all workspaces
+ *
+ * @example
+ * ```typescript
+ * const allWorkspaces = await listAllWorkspaces({ limit: 10 });
+ * ```
+ */
+export async function listAllWorkspaces(options) {
+    const client = await getRedis();
+    const limit = options?.limit ?? 50;
+    const workspaceIds = await client.smembers(KANBAN_KEYS.allWorkspaces);
+    const idsToFetch = workspaceIds.slice(0, limit);
+    const workspaces = [];
+    for (const wsId of idsToFetch) {
+        const workspace = await getWorkspace(wsId);
+        if (workspace) {
+            workspaces.push(workspace);
+        }
+    }
+    return workspaces;
+}
+/**
+ * Add a session to a workspace
+ *
+ * @description Adds a session as a member of the workspace, enabling it to
+ *              access shared boards within the workspace
+ * @param {string} workspaceId - Workspace to join
+ * @param {string} sessionId - Session to add
+ * @returns {Promise<boolean>} True if session was added, false if workspace not found
+ *
+ * @example
+ * ```typescript
+ * const success = await joinWorkspace('ws_abc123', 'session-456');
+ * if (success) {
+ *   console.log('Session joined workspace');
+ * }
+ * ```
+ */
+export async function joinWorkspace(workspaceId, sessionId) {
+    const client = await getRedis();
+    const workspace = await getWorkspace(workspaceId);
+    if (!workspace) {
+        return false;
+    }
+    // Check if already a member
+    if (workspace.memberSessions.includes(sessionId)) {
+        return true; // Already a member
+    }
+    // Update workspace data
+    workspace.memberSessions.push(sessionId);
+    workspace.updatedAt = Date.now();
+    const pipeline = client.pipeline();
+    // Update workspace
+    pipeline.setex(KANBAN_KEYS.workspace(workspaceId), DEFAULT_TASK_TTL, JSON.stringify(workspace));
+    // Add session to workspace members
+    pipeline.sadd(KANBAN_KEYS.workspaceSessions(workspaceId), sessionId);
+    // Add workspace to session's list
+    pipeline.sadd(KANBAN_KEYS.workspacesBySession(sessionId), workspaceId);
+    pipeline.expire(KANBAN_KEYS.workspacesBySession(sessionId), DEFAULT_TASK_TTL);
+    await pipeline.exec();
+    Logger.debug(`workspace-store: session ${sessionId} joined workspace ${workspaceId}`);
+    return true;
+}
+/**
+ * Remove a session from a workspace
+ *
+ * @description Removes a session's membership from the workspace. The owner
+ *              cannot leave their own workspace (must delete it instead).
+ * @param {string} workspaceId - Workspace to leave
+ * @param {string} sessionId - Session to remove
+ * @returns {Promise<boolean>} True if session was removed, false if not found or is owner
+ *
+ * @example
+ * ```typescript
+ * const success = await leaveWorkspace('ws_abc123', 'session-456');
+ * ```
+ */
+export async function leaveWorkspace(workspaceId, sessionId) {
+    const client = await getRedis();
+    const workspace = await getWorkspace(workspaceId);
+    if (!workspace) {
+        return false;
+    }
+    // Owner cannot leave their own workspace
+    if (workspace.ownerSessionId === sessionId) {
+        Logger.warn(`workspace-store: owner session ${sessionId} cannot leave workspace ${workspaceId}`);
+        return false;
+    }
+    // Check if member
+    const index = workspace.memberSessions.indexOf(sessionId);
+    if (index === -1) {
+        return true; // Not a member, consider success
+    }
+    // Update workspace data
+    workspace.memberSessions.splice(index, 1);
+    workspace.updatedAt = Date.now();
+    const pipeline = client.pipeline();
+    // Update workspace
+    pipeline.setex(KANBAN_KEYS.workspace(workspaceId), DEFAULT_TASK_TTL, JSON.stringify(workspace));
+    // Remove session from workspace members
+    pipeline.srem(KANBAN_KEYS.workspaceSessions(workspaceId), sessionId);
+    // Remove workspace from session's list
+    pipeline.srem(KANBAN_KEYS.workspacesBySession(sessionId), workspaceId);
+    await pipeline.exec();
+    Logger.debug(`workspace-store: session ${sessionId} left workspace ${workspaceId}`);
+    return true;
+}
+/**
+ * Update workspace metadata
+ *
+ * @description Updates workspace name, description, or metadata
+ * @param {string} workspaceId - Workspace to update
+ * @param {Object} updates - Fields to update
+ * @param {string} [updates.name] - New workspace name
+ * @param {string} [updates.description] - New description
+ * @param {Record<string, unknown>} [updates.metadata] - Additional metadata
+ * @returns {Promise<Workspace | null>} Updated workspace or null if not found
+ *
+ * @example
+ * ```typescript
+ * const updated = await updateWorkspace('ws_abc123', {
+ *   name: 'Updated Team Name',
+ *   description: 'New description',
+ * });
+ * ```
+ */
+export async function updateWorkspace(workspaceId, updates) {
+    const client = await getRedis();
+    const workspace = await getWorkspace(workspaceId);
+    if (!workspace) {
+        return null;
+    }
+    // Apply updates
+    if (updates.name !== undefined) {
+        workspace.name = updates.name;
+    }
+    if (updates.description !== undefined) {
+        workspace.description = updates.description;
+    }
+    if (updates.metadata !== undefined) {
+        workspace.metadata = { ...workspace.metadata, ...updates.metadata };
+    }
+    workspace.updatedAt = Date.now();
+    await client.setex(KANBAN_KEYS.workspace(workspaceId), DEFAULT_TASK_TTL, JSON.stringify(workspace));
+    Logger.debug(`workspace-store: updated workspace ${workspaceId}`);
+    return workspace;
+}
+/**
+ * Delete a workspace
+ *
+ * @description Permanently deletes a workspace and removes all session associations.
+ *              Only the workspace owner can delete a workspace.
+ * @param {string} workspaceId - Workspace to delete
+ * @param {string} requestingSessionId - Session requesting deletion (must be owner)
+ * @returns {Promise<boolean>} True if deleted, false if not found or unauthorized
+ *
+ * @example
+ * ```typescript
+ * const deleted = await deleteWorkspace('ws_abc123', 'session-owner');
+ * ```
+ */
+export async function deleteWorkspace(workspaceId, requestingSessionId) {
+    const client = await getRedis();
+    const workspace = await getWorkspace(workspaceId);
+    if (!workspace) {
+        return false;
+    }
+    // Only owner can delete
+    if (workspace.ownerSessionId !== requestingSessionId) {
+        Logger.warn(`workspace-store: session ${requestingSessionId} not authorized to delete workspace ${workspaceId}`);
+        return false;
+    }
+    const pipeline = client.pipeline();
+    // Remove workspace data
+    pipeline.del(KANBAN_KEYS.workspace(workspaceId));
+    // Remove from global list
+    pipeline.srem(KANBAN_KEYS.allWorkspaces, workspaceId);
+    // Remove workspace sessions set
+    pipeline.del(KANBAN_KEYS.workspaceSessions(workspaceId));
+    // Remove workspace from all member sessions
+    for (const sessionId of workspace.memberSessions) {
+        pipeline.srem(KANBAN_KEYS.workspacesBySession(sessionId), workspaceId);
+    }
+    await pipeline.exec();
+    Logger.debug(`workspace-store: deleted workspace ${workspaceId}`);
+    return true;
+}
+/**
+ * Check if a session is a member of a workspace
+ *
+ * @description Verifies workspace membership for authorization checks
+ * @param {string} workspaceId - Workspace to check
+ * @param {string} sessionId - Session to verify
+ * @returns {Promise<boolean>} True if session is a member
+ *
+ * @example
+ * ```typescript
+ * if (await isWorkspaceMember('ws_abc123', 'session-456')) {
+ *   // Allow access to workspace boards
+ * }
+ * ```
+ */
+export async function isWorkspaceMember(workspaceId, sessionId) {
+    const client = await getRedis();
+    return (await client.sismember(KANBAN_KEYS.workspaceSessions(workspaceId), sessionId)) === 1;
+}
+/**
+ * Get all sessions in a workspace
+ *
+ * @description Lists all session IDs that are members of the workspace
+ * @param {string} workspaceId - Workspace to query
+ * @returns {Promise<string[]>} Array of member session IDs
+ *
+ * @example
+ * ```typescript
+ * const sessions = await getWorkspaceSessions('ws_abc123');
+ * console.log(`${sessions.length} sessions in workspace`);
+ * ```
+ */
+export async function getWorkspaceSessions(workspaceId) {
+    const client = await getRedis();
+    return client.smembers(KANBAN_KEYS.workspaceSessions(workspaceId));
+}
+//# sourceMappingURL=workspace-store.js.map

package/dist/kanban/workspace-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-store.js","sourceRoot":"","sources":["../../src/kanban/workspace-store.ts"],"names":[],"mappings":"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"}

package/dist/loci/graph-storage.d.ts

@@ -0,0 +1,120 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Loci Graph Storage
+ *
+ * Redis-based graph storage for the knowledge graph.
+ * Uses sorted sets for edges and hashes for nodes.
+ */
+import { RedisBackedService } from '../infrastructure/redis/redis-backed-service.js';
+import type { GraphNode, GraphEdge, GraphNodeType, GraphEdgeType, GraphQueryOptions } from './types.js';
+/**
+ * Graph Storage configuration
+ */
+export interface GraphStorageConfig {
+    /** Default TTL for nodes in seconds */
+    nodeTtl?: number;
+    /** Default TTL for edges in seconds */
+    edgeTtl?: number;
+}
+/**
+ * Graph Storage
+ */
+export declare class GraphStorage extends RedisBackedService {
+    protected get serviceName(): string;
+    private config;
+    constructor(config?: GraphStorageConfig);
+    /**
+     * Generate a unique node ID
+     */
+    generateNodeId(type: GraphNodeType): string;
+    /**
+     * Generate a unique edge ID
+     */
+    generateEdgeId(): string;
+    /**
+     * Add a node to the graph
+     */
+    addNode(node: Omit<GraphNode, 'id' | 'createdAt' | 'lastAccessedAt' | 'accessCount'>): Promise<GraphNode | null>;
+    /**
+     * Get a node by ID
+     */
+    getNode(nodeId: string): Promise<GraphNode | null>;
+    /**
+     * Update a node
+     */
+    updateNode(nodeId: string, updates: Partial<GraphNode>): Promise<boolean>;
+    /**
+     * Delete a node and its edges
+     */
+    deleteNode(nodeId: string): Promise<boolean>;
+    /**
+     * Add an edge between nodes
+     */
+    addEdge(fromNodeId: string, toNodeId: string, type: GraphEdgeType, weight?: number, metadata?: Record<string, unknown>): Promise<GraphEdge | null>;
+    /**
+     * Get an edge by ID
+     */
+    getEdge(edgeId: string): Promise<GraphEdge | null>;
+    /**
+     * Delete an edge
+     */
+    deleteEdge(edgeId: string): Promise<boolean>;
+    /**
+     * Get outgoing edges from a node
+     */
+    getOutgoingEdges(nodeId: string): Promise<GraphEdge[]>;
+    /**
+     * Get incoming edges to a node
+     */
+    getIncomingEdges(nodeId: string): Promise<GraphEdge[]>;
+    /**
+     * Query nodes with filters
+     */
+    queryNodes(options: GraphQueryOptions): Promise<GraphNode[]>;
+    /**
+     * Get neighbors of a node
+     */
+    getNeighbors(nodeId: string, direction?: 'out' | 'in' | 'both'): Promise<GraphNode[]>;
+    /**
+     * Serialize node for Redis
+     */
+    private serializeNode;
+    /**
+     * Parse node from Redis data
+     */
+    private parseNode;
+    /**
+     * Serialize edge for Redis
+     */
+    private serializeEdge;
+    /**
+     * Parse edge from Redis data
+     */
+    private parseEdge;
+    private safeJsonParse;
+}
+/**
+ * Get the global graph storage
+ */
+export declare function getGraphStorage(): GraphStorage;
+/**
+ * Reset the global graph storage (for testing)
+ */
+export declare function resetGraphStorage(): void;
+//# sourceMappingURL=graph-storage.d.ts.map

package/dist/loci/graph-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-storage.d.ts","sourceRoot":"","sources":["../../src/loci/graph-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,kBAAkB;IAClD,SAAS,KAAK,WAAW,WAA6B;IACtD,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,kBAAuB;IAQ3C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAI3C;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC,GAC3E,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAgC5B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAwBxD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB/E;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiClD;;OAEG;IACG,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,MAAY,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAiD5B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAqBxD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBlD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmB5D;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmB5D;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA8DlE;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,KAAK,GAAG,IAAI,GAAG,MAAe,GACxC,OAAO,CAAC,SAAS,EAAE,CAAC;IAiCvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,aAAa;CAQtB;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}