devchain-cli 0.10.4 → 0.11.0

package/dist/server/modules/mcp/services/handlers/document-tools.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleListDocuments = handleListDocuments;
+exports.handleGetDocument = handleGetDocument;
+exports.handleCreateDocument = handleCreateDocument;
+exports.handleUpdateDocument = handleUpdateDocument;
+const logger_1 = require("../../../../common/logging/logger");
+const mcp_dto_1 = require("../../dtos/mcp.dto");
+const dto_mappers_1 = require("../mappers/dto-mappers");
+const document_link_resolver_1 = require("../utils/document-link-resolver");
+const logger = (0, logger_1.createLogger)('McpService');
+function redactSessionId(sessionId) {
+    if (!sessionId)
+        return '(none)';
+    return sessionId.slice(0, 4) + '****';
+}
+function missingSessionResolver() {
+    return {
+        success: false,
+        error: {
+            code: 'SERVICE_UNAVAILABLE',
+            message: 'Session resolution requires full app context (not available in standalone MCP mode)',
+        },
+    };
+}
+async function resolveSessionContext(ctx, sessionId) {
+    if (!ctx.resolveSessionContext) {
+        return missingSessionResolver();
+    }
+    return ctx.resolveSessionContext(sessionId);
+}
+async function handleListDocuments(ctx, params) {
+    const validated = mcp_dto_1.ListDocumentsParamsSchema.parse(params);
+    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
+    if (!sessionCtxResult.success)
+        return sessionCtxResult;
+    const { project } = sessionCtxResult.data;
+    if (!project) {
+        return {
+            success: false,
+            error: {
+                code: 'PROJECT_NOT_FOUND',
+                message: 'No project associated with this session',
+            },
+        };
+    }
+    logger.debug({ sessionId: redactSessionId(validated.sessionId), projectId: project.id }, 'Resolved session to project');
+    const filters = {
+        projectId: project.id,
+    };
+    if (validated.tags?.length) {
+        filters.tags = validated.tags;
+    }
+    if (validated.q) {
+        filters.q = validated.q;
+    }
+    if (validated.limit !== undefined) {
+        filters.limit = validated.limit;
+    }
+    if (validated.offset !== undefined) {
+        filters.offset = validated.offset;
+    }
+    const result = await ctx.storage.listDocuments(filters);
+    const response = {
+        documents: result.items.map((document) => (0, dto_mappers_1.mapDocumentSummary)(document)),
+        total: result.total,
+        limit: result.limit,
+        offset: result.offset,
+    };
+    return { success: true, data: response };
+}
+async function handleGetDocument(ctx, params) {
+    const validated = mcp_dto_1.GetDocumentParamsSchema.parse(params);
+    const includeLinks = validated.includeLinks ?? 'meta';
+    let document;
+    if (validated.id) {
+        document = await ctx.storage.getDocument({ id: validated.id });
+    }
+    else {
+        const projectId = validated.projectId === '' ? null : validated.projectId;
+        document = await ctx.storage.getDocument({ slug: validated.slug, projectId });
+    }
+    const response = {
+        document: (0, dto_mappers_1.mapDocumentDetail)(document),
+        links: [],
+    };
+    let cache = new Map();
+    if (includeLinks !== 'none') {
+        const collected = await (0, document_link_resolver_1.collectDocumentLinks)(ctx.storage, document);
+        response.links = collected.links;
+        cache = collected.cache;
+        if (includeLinks === 'inline') {
+            const inline = await (0, document_link_resolver_1.buildInlineResolution)(ctx.storage, document, cache, validated.maxDepth ?? 1, validated.maxBytes ?? ctx.defaultInlineMaxBytes ?? 64 * 1024);
+            response.resolved = inline;
+        }
+    }
+    return { success: true, data: response };
+}
+async function handleCreateDocument(ctx, params) {
+    const validated = mcp_dto_1.CreateDocumentParamsSchema.parse(params);
+    const sessionCtxResult = await resolveSessionContext(ctx, validated.sessionId);
+    if (!sessionCtxResult.success)
+        return sessionCtxResult;
+    const { project } = sessionCtxResult.data;
+    if (!project) {
+        return {
+            success: false,
+            error: {
+                code: 'PROJECT_NOT_FOUND',
+                message: 'No project associated with this session',
+            },
+        };
+    }
+    logger.debug({ sessionId: redactSessionId(validated.sessionId), projectId: project.id }, 'Resolved session to project for document creation');
+    const document = await ctx.storage.createDocument({
+        projectId: project.id,
+        title: validated.title,
+        contentMd: validated.contentMd,
+        tags: validated.tags,
+    });
+    const response = {
+        document: (0, dto_mappers_1.mapDocumentDetail)(document),
+    };
+    return { success: true, data: response };
+}
+async function handleUpdateDocument(ctx, params) {
+    const validated = mcp_dto_1.UpdateDocumentParamsSchema.parse(params);
+    const document = await ctx.storage.updateDocument(validated.id, {
+        title: validated.title,
+        slug: validated.slug,
+        contentMd: validated.contentMd,
+        tags: validated.tags,
+        archived: validated.archived,
+        version: validated.version,
+    });
+    const response = {
+        document: (0, dto_mappers_1.mapDocumentDetail)(document),
+    };
+    return { success: true, data: response };
+}
+//# sourceMappingURL=document-tools.js.map

package/dist/server/modules/mcp/services/handlers/document-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-tools.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/services/handlers/document-tools.ts"],"names":[],"mappings":";;AA2CA,kDAyDC;AAED,8CAuCC;AAED,oDAqCC;AAED,oDAmBC;AAxMD,8DAAiE;AACjE,gDAW4B;AAC5B,wDAA+E;AAC/E,4EAA8F;AAG9F,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,YAAY,CAAC,CAAC;AAE1C,SAAS,eAAe,CAAC,SAA6B;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,QAAQ,CAAC;IAChC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;AACxC,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EACL,qFAAqF;SACxF;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,GAAmB,EAAE,SAAiB;IACzE,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QAC/B,OAAO,sBAAsB,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,GAAmB,EACnB,MAAe;IAEf,MAAM,SAAS,GAAG,mCAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1D,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/E,IAAI,CAAC,gBAAgB,CAAC,OAAO;QAAE,OAAO,gBAAgB,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAsB,CAAC;IAE5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,yCAAyC;aACnD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CACV,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,EAC1E,6BAA6B,CAC9B,CAAC;IAEF,MAAM,OAAO,GAMT;QACF,SAAS,EAAE,OAAO,CAAC,EAAE;KACtB,CAAC;IAEF,IAAI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAClC,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,QAAQ,GAA0B;QACtC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,gCAAkB,EAAC,QAAQ,CAAC,CAAC;QACvE,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAEM,KAAK,UAAU,iBAAiB,CACrC,GAAmB,EACnB,MAAe;IAEf,MAAM,SAAS,GAAG,iCAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC;IAEtD,IAAI,QAAkB,CAAC;IACvB,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;QACjB,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,SAAU,CAAC;QAC3E,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,QAAQ,GAAwB;QACpC,QAAQ,EAAE,IAAA,+BAAiB,EAAC,QAAQ,CAAC;QACrC,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,IAAI,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,IAAA,6CAAoB,EAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QACjC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QAExB,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,IAAA,8CAAqB,EACxC,GAAG,CAAC,OAAO,EACX,QAAQ,EACR,KAAK,EACL,SAAS,CAAC,QAAQ,IAAI,CAAC,EACvB,SAAS,CAAC,QAAQ,IAAI,GAAG,CAAC,qBAAqB,IAAI,EAAE,GAAG,IAAI,CAC7D,CAAC;YACF,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,GAAmB,EACnB,MAAe;IAEf,MAAM,SAAS,GAAG,oCAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3D,MAAM,gBAAgB,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/E,IAAI,CAAC,gBAAgB,CAAC,OAAO;QAAE,OAAO,gBAAgB,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAsB,CAAC;IAE5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,yCAAyC;aACnD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CACV,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,EAC1E,mDAAmD,CACpD,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;QAChD,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,IAAI,EAAE,SAAS,CAAC,IAAI;KACrB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAA2B;QACvC,QAAQ,EAAE,IAAA,+BAAiB,EAAC,QAAQ,CAAC;KACtC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,GAAmB,EACnB,MAAe;IAEf,MAAM,SAAS,GAAG,oCAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,EAAE;QAC9D,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,OAAO,EAAE,SAAS,CAAC,OAAO;KAC3B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAA2B;QACvC,QAAQ,EAAE,IAAA,+BAAiB,EAAC,QAAQ,CAAC;KACtC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC"}

package/dist/server/modules/mcp/services/handlers/epic-tools.d.ts

@@ -0,0 +1,11 @@
+import { McpResponse } from '../../dtos/mcp.dto';
+import type { McpToolContext } from './types';
+export declare function handleListAgents(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleGetAgentByName(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleListStatuses(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleListEpics(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleListAssignedEpicsTasks(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleCreateEpic(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleGetEpicById(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleAddEpicComment(ctx: McpToolContext, params: unknown): Promise<McpResponse>;
+export declare function handleUpdateEpic(ctx: McpToolContext, params: unknown): Promise<McpResponse>;