@devflow-tools/server 0.12.6 → 0.13.1

package/dist/common/response.interceptor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.interceptor.test.js","sourceRoot":"","sources":["../../src/common/response.interceptor.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,WAAW,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhE,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAS,CAAC;QAC1F,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5F,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,GAAG,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAS,CAAC;QAC1F,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,GAAG,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAS,CAAC;QAC1F,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAClH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/common/root-path.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const RootPathFromRequest: (...dataOrPipes: unknown[]) => ParameterDecorator;
+//# sourceMappingURL=root-path.decorator.d.ts.map

package/dist/common/root-path.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-path.decorator.d.ts","sourceRoot":"","sources":["../../src/common/root-path.decorator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,mDAK/B,CAAC"}

package/dist/common/root-path.decorator.js

@@ -0,0 +1,6 @@
+import { createParamDecorator } from "@nestjs/common";
+export const RootPathFromRequest = createParamDecorator((_data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    return request.query?.rootPath ?? request.headers["x-devflow-project"];
+});
+//# sourceMappingURL=root-path.decorator.js.map

package/dist/common/root-path.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-path.decorator.js","sourceRoot":"","sources":["../../src/common/root-path.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,gBAAgB,CAAC;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CACrD,CAAC,KAAc,EAAE,GAAqB,EAAsB,EAAE;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAChD,OAAQ,OAAO,CAAC,KAAK,EAAE,QAAmB,IAAK,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAwB,CAAC;AAC7G,CAAC,CACF,CAAC"}

package/dist/context/context.controller.d.ts

@@ -0,0 +1,43 @@
+import { ContextService, IndexStatus, FeedbackEntry } from "./context.service.js";
+import { ProjectsService } from "../projects/projects.service.js";
+import type { ContextResult, TaskContextResult } from "@devflow-tools/sdk";
+export declare class ContextController {
+    private readonly service;
+    private readonly projects;
+    constructor(service: ContextService, projects: ProjectsService);
+    private resolveRootPath;
+    status(rootPath?: string, xProject?: string): Promise<IndexStatus | null>;
+    index(body: {
+        rootPath?: string;
+    }, xProject?: string): Promise<IndexStatus>;
+    build(body: {
+        rootPath?: string;
+        query: string;
+        mode?: "fast" | "deep";
+        maxTokens?: number;
+    }, xProject?: string): Promise<ContextResult>;
+    buildTask(body: {
+        rootPath?: string;
+        query: string;
+        mode?: "fast" | "deep";
+        maxTokens?: number;
+    }, xProject?: string): Promise<TaskContextResult>;
+    feedback(body: {
+        rootPath?: string;
+        query: string;
+        feedback: "hit" | "partial" | "miss";
+        taskType?: string;
+        contextMode?: "general" | "task";
+        runId?: string;
+        tokenCount?: number;
+    }, xProject?: string): Promise<FeedbackEntry>;
+    feedbackSummary(): Promise<{
+        total: number;
+        hits: number;
+        partials: number;
+        misses: number;
+        hitRate: number;
+    }>;
+    findSymbol(name: string, rootPath?: string, xProject?: string): Promise<import("@devflow-tools/sdk").SymbolEntry[]>;
+}
+//# sourceMappingURL=context.controller.d.ts.map

package/dist/context/context.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.controller.d.ts","sourceRoot":"","sources":["../../src/context/context.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,qBACa,iBAAiB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADT,OAAO,EAAE,cAAc,EACtB,QAAQ,EAAE,eAAe;IAGrE,OAAO,CAAC,eAAe;IAOjB,MAAM,CAAoB,QAAQ,CAAC,EAAE,MAAM,EAAgC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAO1H,KAAK,CAAS,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAgC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKjH,KAAK,CAAS,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAAgC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK9K,SAAS,CAAS,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAAgC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKtL,QAAQ,CAAS,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAgC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAUrQ,eAAe;;;;;;;IAKf,UAAU,CAAgB,IAAI,EAAE,MAAM,EAAqB,QAAQ,CAAC,EAAE,MAAM,EAAgC,QAAQ,CAAC,EAAE,MAAM;CAGpI"}

package/dist/context/context.controller.js

@@ -0,0 +1,120 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Controller, Get, Post, Body, Query, Param, Headers, Inject, BadRequestException } from "@nestjs/common";
+import { ContextService } from "./context.service.js";
+import { ProjectsService } from "../projects/projects.service.js";
+let ContextController = class ContextController {
+    constructor(service, projects) {
+        this.service = service;
+        this.projects = projects;
+    }
+    resolveRootPath(rootPath, xProject) {
+        const resolved = rootPath ?? xProject ?? this.projects.getActiveProjectRoot();
+        if (!resolved)
+            throw new BadRequestException("rootPath is required — no active project connected");
+        return resolved;
+    }
+    async status(rootPath, xProject) {
+        const resolved = rootPath ?? xProject ?? this.projects.getActiveProjectRoot();
+        if (!resolved)
+            return null; // No active project — graceful empty state
+        return this.service.getStatus(resolved);
+    }
+    async index(body, xProject) {
+        return this.service.indexProject(this.resolveRootPath(body.rootPath, xProject));
+    }
+    async build(body, xProject) {
+        return this.service.buildContext(this.resolveRootPath(body.rootPath, xProject), body.query, body.mode ?? "fast", body.maxTokens);
+    }
+    async buildTask(body, xProject) {
+        return this.service.buildTaskContext(this.resolveRootPath(body.rootPath, xProject), body.query, body.mode ?? "fast", body.maxTokens);
+    }
+    async feedback(body, xProject) {
+        return this.service.recordFeedback(this.resolveRootPath(body.rootPath, xProject), body.query, body.feedback, {
+            taskType: body.taskType,
+            contextMode: body.contextMode,
+            runId: body.runId,
+            tokenCount: body.tokenCount,
+        });
+    }
+    async feedbackSummary() {
+        return this.service.getFeedbackSummaries();
+    }
+    async findSymbol(name, rootPath, xProject) {
+        return this.service.findSymbol(this.resolveRootPath(rootPath, xProject), name);
+    }
+};
+__decorate([
+    Get("status"),
+    __param(0, Query("rootPath")),
+    __param(1, Headers("x-devflow-project")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "status", null);
+__decorate([
+    Post("index"),
+    __param(0, Body()),
+    __param(1, Headers("x-devflow-project")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "index", null);
+__decorate([
+    Post("build"),
+    __param(0, Body()),
+    __param(1, Headers("x-devflow-project")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "build", null);
+__decorate([
+    Post("build-task"),
+    __param(0, Body()),
+    __param(1, Headers("x-devflow-project")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "buildTask", null);
+__decorate([
+    Post("feedback"),
+    __param(0, Body()),
+    __param(1, Headers("x-devflow-project")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "feedback", null);
+__decorate([
+    Get("feedback-summary"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "feedbackSummary", null);
+__decorate([
+    Get("symbol/:name"),
+    __param(0, Param("name")),
+    __param(1, Query("rootPath")),
+    __param(2, Headers("x-devflow-project")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], ContextController.prototype, "findSymbol", null);
+ContextController = __decorate([
+    Controller("context"),
+    __param(0, Inject(ContextService)),
+    __param(1, Inject(ProjectsService)),
+    __metadata("design:paramtypes", [ContextService,
+        ProjectsService])
+], ContextController);
+export { ContextController };
+//# sourceMappingURL=context.controller.js.map

package/dist/context/context.controller.js.map

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

package/dist/context/context.controller.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.controller.spec.d.ts.map

package/dist/context/context.controller.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.controller.spec.d.ts","sourceRoot":"","sources":["../../src/context/context.controller.spec.ts"],"names":[],"mappings":""}

package/dist/context/context.controller.spec.js

@@ -0,0 +1,191 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { Test } from '@nestjs/testing';
+import { BadRequestException } from '@nestjs/common';
+import { ContextController } from './context.controller.js';
+import { ContextService } from './context.service.js';
+import { ProjectsService } from '../projects/projects.service.js';
+// Mock the context.service module to avoid loading context-engine (which requires node:sqlite)
+vi.mock('./context.service.js', () => ({
+    ContextService: vi.fn().mockImplementation(() => ({
+        buildTaskContext: vi.fn(),
+        buildContext: vi.fn(),
+        getStatus: vi.fn(),
+        indexProject: vi.fn(),
+        findSymbol: vi.fn(),
+        recordFeedback: vi.fn(),
+        getFeedbackSummaries: vi.fn(),
+    })),
+}));
+// Mock projects.service to avoid any transitive sqlite dependencies
+vi.mock('../projects/projects.service.js', () => ({
+    ProjectsService: vi.fn().mockImplementation(() => ({
+        getActiveProjectRoot: vi.fn(),
+    })),
+}));
+describe('ContextController', () => {
+    let controller;
+    let service;
+    let projectsService;
+    const mockTaskContextResult = {
+        taskType: 'debug',
+        requiredFiles: {
+            files: ['src/auth/login.ts'],
+            symbols: ['loginUser'],
+            reasoning: [
+                {
+                    source: 'symbol_match',
+                    fileGroup: 'required',
+                    explanation: 'Direct match for login query',
+                },
+            ],
+        },
+        optionalFiles: {
+            files: ['src/utils/logger.ts'],
+            symbols: ['logError'],
+            reasoning: [],
+        },
+        keySymbols: [
+            { name: 'loginUser', file: 'src/auth/login.ts', kind: 'function', relevance: 'direct' },
+        ],
+        graphSummary: {
+            roots: ['src/auth/login.ts'],
+            traversalDepth: 2,
+            relatedNodeCount: 5,
+        },
+        riskHints: [
+            {
+                level: 'medium',
+                category: 'api_contract',
+                description: 'Modifies service layer',
+                affectedFiles: ['src/auth/login.ts'],
+            },
+        ],
+        nextActions: [
+            {
+                kind: 'workflow',
+                label: 'Run debug workflow',
+                payload: 'debug',
+            },
+        ],
+        reasoning: [
+            {
+                source: 'symbol_match',
+                fileGroup: 'required',
+                explanation: 'Direct match for login query',
+            },
+        ],
+        confidence: 0.85,
+        tokenCount: 1500,
+    };
+    const mockService = {
+        buildTaskContext: vi.fn().mockResolvedValue(mockTaskContextResult),
+        buildContext: vi.fn(),
+        getStatus: vi.fn(),
+        indexProject: vi.fn(),
+        findSymbol: vi.fn(),
+        recordFeedback: vi.fn(),
+        getFeedbackSummaries: vi.fn(),
+    };
+    const mockProjectsService = {
+        getActiveProjectRoot: vi.fn().mockReturnValue('/test/project'),
+    };
+    beforeEach(async () => {
+        vi.clearAllMocks();
+        const module = await Test.createTestingModule({
+            controllers: [ContextController],
+            providers: [
+                {
+                    provide: ContextService,
+                    useValue: mockService,
+                },
+                {
+                    provide: ProjectsService,
+                    useValue: mockProjectsService,
+                },
+            ],
+        }).compile();
+        controller = module.get(ContextController);
+        service = module.get(ContextService);
+        projectsService = module.get(ProjectsService);
+    });
+    it('should be defined', () => {
+        expect(controller).toBeDefined();
+    });
+    describe('POST /context/build-task', () => {
+        it('should build task context with explicit rootPath', async () => {
+            const body = {
+                query: '修复登录重复请求',
+                rootPath: '/test/project',
+                mode: 'fast',
+            };
+            const result = await controller.buildTask(body);
+            expect(result).toHaveProperty('requiredFiles');
+            expect(result).toHaveProperty('optionalFiles');
+            expect(result).toHaveProperty('riskHints');
+            expect(result).toHaveProperty('nextActions');
+            expect(result).toHaveProperty('reasoning');
+            expect(result).toHaveProperty('taskType');
+            expect(result).toHaveProperty('confidence');
+            expect(result).toHaveProperty('tokenCount');
+            expect(service.buildTaskContext).toHaveBeenCalledWith('/test/project', '修复登录重复请求', 'fast', undefined);
+        });
+        it('should build task context with deep mode', async () => {
+            const body = {
+                query: 'understand auth flow',
+                rootPath: '/test/project',
+                mode: 'deep',
+            };
+            await controller.buildTask(body);
+            expect(service.buildTaskContext).toHaveBeenCalledWith('/test/project', 'understand auth flow', 'deep', undefined);
+        });
+        it('should use active project root when rootPath not provided', async () => {
+            const body = {
+                query: 'fix bug',
+                mode: 'fast',
+            };
+            await controller.buildTask(body);
+            expect(service.buildTaskContext).toHaveBeenCalledWith('/test/project', 'fix bug', 'fast', undefined);
+        });
+        it('should throw BadRequestException when no rootPath and no active project', async () => {
+            mockProjectsService.getActiveProjectRoot.mockReturnValue(null);
+            const body = {
+                query: 'fix bug',
+                mode: 'fast',
+            };
+            await expect(controller.buildTask(body)).rejects.toThrow(BadRequestException);
+            expect(service.buildTaskContext).not.toHaveBeenCalled();
+        });
+        it('should prefer x-devflow-project header over active project', async () => {
+            const body = {
+                query: 'fix bug',
+                mode: 'fast',
+            };
+            await controller.buildTask(body, '/header/project');
+            expect(service.buildTaskContext).toHaveBeenCalledWith('/header/project', 'fix bug', 'fast', undefined);
+        });
+        it('should pass maxTokens when provided', async () => {
+            const body = {
+                query: 'fix bug',
+                rootPath: '/test/project',
+                mode: 'fast',
+                maxTokens: 4000,
+            };
+            await controller.buildTask(body);
+            expect(service.buildTaskContext).toHaveBeenCalledWith('/test/project', 'fix bug', 'fast', 4000);
+        });
+        it('should return structured TaskContextResult', async () => {
+            const body = {
+                query: '修复登录重复请求',
+                rootPath: '/test/project',
+                mode: 'fast',
+            };
+            const result = await controller.buildTask(body);
+            expect(result).toEqual(mockTaskContextResult);
+            expect(result.taskType).toBe('debug');
+            expect(result.requiredFiles.files).toContain('src/auth/login.ts');
+            expect(result.riskHints).toHaveLength(1);
+            expect(result.nextActions).toHaveLength(1);
+        });
+    });
+});
+//# sourceMappingURL=context.controller.spec.js.map

package/dist/context/context.controller.spec.js.map

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

package/dist/context/context.module.d.ts

@@ -0,0 +1,3 @@
+export declare class ContextModule {
+}
+//# sourceMappingURL=context.module.d.ts.map

package/dist/context/context.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.module.d.ts","sourceRoot":"","sources":["../../src/context/context.module.ts"],"names":[],"mappings":"AAMA,qBACa,aAAa;CAAG"}

package/dist/context/context.module.js

@@ -0,0 +1,18 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Module } from "@nestjs/common";
+import { ContextService } from "./context.service.js";
+import { ContextController } from "./context.controller.js";
+import { ProjectsModule } from "../projects/projects.module.js";
+import { DataModule } from "../data/data.module.js";
+let ContextModule = class ContextModule {
+};
+ContextModule = __decorate([
+    Module({ imports: [ProjectsModule, DataModule], controllers: [ContextController], providers: [ContextService], exports: [ContextService] })
+], ContextModule);
+export { ContextModule };
+//# sourceMappingURL=context.module.js.map

package/dist/context/context.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.module.js","sourceRoot":"","sources":["../../src/context/context.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG7C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,aAAa;IADzB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;GAC/H,aAAa,CAAG"}

package/dist/context/context.service.d.ts

@@ -0,0 +1,47 @@
+import type { ContextResult, TaskContextResult } from "@devflow-tools/sdk";
+import { DataService } from "../data/data.service.js";
+export interface IndexStatus {
+    totalFiles: number;
+    totalSymbols: number;
+    lastIndexTime: number;
+    indexing: boolean;
+}
+export interface FeedbackEntry {
+    query: string;
+    feedback: "hit" | "partial" | "miss";
+    timestamp: number;
+    projectRoot: string;
+}
+export interface FeedbackInput {
+    projectRoot: string;
+    query: string;
+    taskType?: string;
+    feedback: "hit" | "partial" | "miss";
+    contextMode?: "general" | "task";
+    runId?: string;
+    tokenCount?: number;
+}
+export declare class ContextService {
+    private readonly dataService?;
+    private feedbackEntries;
+    constructor(dataService?: DataService | undefined);
+    indexProject(rootPath: string): Promise<IndexStatus>;
+    getStatus(rootPath: string): Promise<IndexStatus>;
+    buildContext(rootPath: string, query: string, mode: "fast" | "deep", maxTokens?: number): Promise<ContextResult>;
+    buildTaskContext(rootPath: string, query: string, mode: "fast" | "deep", maxTokens?: number): Promise<TaskContextResult>;
+    findSymbol(rootPath: string, name: string): Promise<import("@devflow-tools/sdk").SymbolEntry[]>;
+    recordFeedback(rootPath: string, query: string, feedback: "hit" | "partial" | "miss", extra?: {
+        taskType?: string;
+        contextMode?: "general" | "task";
+        runId?: string;
+        tokenCount?: number;
+    }): Promise<FeedbackEntry>;
+    getFeedbackSummaries(): Promise<{
+        total: number;
+        hits: number;
+        partials: number;
+        misses: number;
+        hitRate: number;
+    }>;
+}
+//# sourceMappingURL=context.service.d.ts.map

package/dist/context/context.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.service.d.ts","sourceRoot":"","sources":["../../src/context/context.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBACa,cAAc;IAIU,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAHhE,OAAO,CAAC,eAAe,CAAuB;gBAGM,WAAW,CAAC,EAAE,WAAW,YAAA;IAGvE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYpD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBjD,YAAY,CAChB,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GACzE,OAAO,CAAC,aAAa,CAAC;IAKnB,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GACzE,OAAO,CAAC,iBAAiB,CAAC;IAKvB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAKzC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA4BnN,oBAAoB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAO1H"}

package/dist/context/context.service.js

@@ -0,0 +1,104 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Injectable, Inject, Optional } from "@nestjs/common";
+import { createEngines } from "@devflow-tools/context-engine";
+import { DataService } from "../data/data.service.js";
+let ContextService = class ContextService {
+    constructor(dataService) {
+        this.dataService = dataService;
+        this.feedbackEntries = [];
+    }
+    async indexProject(rootPath) {
+        const { indexer, codegraph } = await createEngines(rootPath);
+        await indexer.reconcile();
+        const stats = codegraph.getStats();
+        return {
+            totalFiles: stats.fileCount,
+            totalSymbols: stats.nodeCount,
+            lastIndexTime: stats.lastUpdated,
+            indexing: codegraph.isIndexing(),
+        };
+    }
+    async getStatus(rootPath) {
+        try {
+            const { codegraph } = await createEngines(rootPath);
+            const stats = codegraph.getStats();
+            return {
+                totalFiles: stats.fileCount,
+                totalSymbols: stats.nodeCount,
+                lastIndexTime: stats.lastUpdated,
+                indexing: codegraph.isIndexing(),
+            };
+        }
+        catch {
+            return {
+                totalFiles: 0,
+                totalSymbols: 0,
+                lastIndexTime: 0,
+                indexing: false,
+            };
+        }
+    }
+    async buildContext(rootPath, query, mode, maxTokens) {
+        const { context } = await createEngines(rootPath);
+        return context.build({ query, mode, maxTokens: maxTokens ?? 8000, includeGraph: mode === "deep" });
+    }
+    async buildTaskContext(rootPath, query, mode, maxTokens) {
+        const { context } = await createEngines(rootPath);
+        return context.buildTaskContext(query, { mode, maxTokens: maxTokens ?? 8000 });
+    }
+    async findSymbol(rootPath, name) {
+        const { indexer } = await createEngines(rootPath);
+        return indexer.findSymbol(name);
+    }
+    async recordFeedback(rootPath, query, feedback, extra) {
+        const entry = { query, feedback, timestamp: Date.now(), projectRoot: rootPath };
+        this.feedbackEntries.push(entry);
+        // Record as telemetry event so it enters the telemetry/ROI pipeline
+        if (this.dataService) {
+            await this.dataService.recordTelemetryEvent({
+                toolName: "context_feedback",
+                args: {
+                    query,
+                    feedback,
+                    taskType: extra?.taskType,
+                    contextMode: extra?.contextMode,
+                    projectRoot: rootPath,
+                },
+                durationMs: 0,
+                success: true,
+                metadata: {
+                    projectRoot: rootPath,
+                    query,
+                    taskType: extra?.taskType,
+                },
+            });
+        }
+        return entry;
+    }
+    async getFeedbackSummaries() {
+        const total = this.feedbackEntries.length;
+        const hits = this.feedbackEntries.filter(e => e.feedback === "hit").length;
+        const partials = this.feedbackEntries.filter(e => e.feedback === "partial").length;
+        const misses = this.feedbackEntries.filter(e => e.feedback === "miss").length;
+        return { total, hits, partials, misses, hitRate: total > 0 ? hits / total : 0 };
+    }
+};
+ContextService = __decorate([
+    Injectable(),
+    __param(0, Optional()),
+    __param(0, Inject(DataService)),
+    __metadata("design:paramtypes", [DataService])
+], ContextService);
+export { ContextService };
+//# sourceMappingURL=context.service.js.map

package/dist/context/context.service.js.map

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

package/dist/data/data.controller.d.ts

@@ -0,0 +1,19 @@
+import { DataService, TelemetryEventInput, BenchmarkRunResult } from './data.service.js';
+export declare class DataController {
+    private readonly dataService;
+    constructor(dataService: DataService);
+    recordTelemetryEvent(event: TelemetryEventInput): Promise<{
+        eventId: string;
+        success: boolean;
+    }>;
+    getProjectStats(rootPath: string): Promise<import("./data.service.js").ProjectStats | null>;
+    updateProjectStats(body: {
+        projectRoot: string;
+        stats: any;
+    }): Promise<import("./data.service.js").ProjectStats>;
+    recordBenchmarkResult(result: BenchmarkRunResult): {
+        success: boolean;
+    };
+    getBenchmarkResults(projectRoot?: string): BenchmarkRunResult[];
+}
+//# sourceMappingURL=data.controller.d.ts.map

package/dist/data/data.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.controller.d.ts","sourceRoot":"","sources":["../../src/data/data.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzF,qBACa,cAAc;IACQ,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAGpE,oBAAoB,CAAS,KAAK,EAAE,mBAAmB;;;;IAMvD,eAAe,CAAoB,QAAQ,EAAE,MAAM;IAKnD,kBAAkB,CAAS,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE;IAK1E,qBAAqB,CAAS,MAAM,EAAE,kBAAkB;;;IAMxD,mBAAmB,CAAuB,WAAW,CAAC,EAAE,MAAM;CAG/D"}