@mcoda/core 0.1.4

package/dist/services/tasks/TaskDetailService.js

@@ -0,0 +1,332 @@
+import fs from "node:fs/promises";
+import { Connection, WorkspaceRepository, GlobalRepository } from "@mcoda/db";
+import { PathHelper } from "@mcoda/shared";
+import { TaskApiResolver } from "./TaskApiResolver.js";
+const hasTables = async (db, required) => {
+    const placeholders = required.map(() => "?").join(", ");
+    const rows = await db.all(`SELECT name FROM sqlite_master WHERE type = 'table' AND name IN (${placeholders})`, required);
+    return rows.length === required.length;
+};
+export class TaskDetailService {
+    constructor(workspace, db, repo, globalRepo, apiResolver = new TaskApiResolver()) {
+        this.workspace = workspace;
+        this.db = db;
+        this.repo = repo;
+        this.globalRepo = globalRepo;
+        this.apiResolver = apiResolver;
+    }
+    static async create(workspace) {
+        const dbPath = PathHelper.getWorkspaceDbPath(workspace.workspaceRoot);
+        try {
+            await fs.access(dbPath);
+        }
+        catch {
+            throw new Error(`No workspace DB found at ${dbPath}. Run mcoda create-tasks first or ensure it exists.`);
+        }
+        const connection = await Connection.open(dbPath);
+        const ok = await hasTables(connection.db, ["projects", "epics", "user_stories", "tasks"]);
+        if (!ok) {
+            await connection.close();
+            throw new Error(`Workspace DB at ${dbPath} is missing required tables. Re-run create-tasks to seed it.`);
+        }
+        const repo = new WorkspaceRepository(connection.db, connection);
+        return new TaskDetailService(workspace, connection.db, repo, undefined, new TaskApiResolver());
+    }
+    async close() {
+        await this.repo.close();
+        if (this.globalRepo) {
+            await this.globalRepo.close();
+        }
+    }
+    getRepository() {
+        return this.repo;
+    }
+    async getTaskDetail(options) {
+        if (!options.taskKey) {
+            throw new Error("taskKey is required");
+        }
+        const task = await this.resolveTask(options.taskKey, options.projectKey);
+        const dependencies = await this.getDependencies(task.id);
+        const comments = await this.repo.listTaskComments(task.id, { limit: options.commentsLimit ?? 20 });
+        const logs = options.includeLogs ? await this.getLogs(task.id, options.logsLimit ?? 20) : undefined;
+        const history = options.includeHistory ? await this.getHistory(task.id, options.historyLimit ?? 20) : undefined;
+        return {
+            task,
+            dependencies,
+            comments,
+            logs,
+            history,
+        };
+    }
+    async resolveTask(taskKey, projectKey) {
+        const openApiTaskId = await this.apiResolver.resolveTaskId(taskKey, projectKey);
+        if (openApiTaskId) {
+            return this.resolveTaskById(openApiTaskId);
+        }
+        const clauses = ["t.key = ?"];
+        const params = [taskKey];
+        if (projectKey) {
+            clauses.push("p.key = ?");
+            params.push(projectKey);
+        }
+        const where = `WHERE ${clauses.join(" AND ")}`;
+        const rows = await this.db.all(`
+      SELECT
+        t.id AS task_id,
+        t.key AS task_key,
+        t.title AS task_title,
+        t.description AS task_description,
+        t.type AS task_type,
+        t.status AS task_status,
+        t.story_points AS task_story_points,
+        t.priority AS task_priority,
+        t.assigned_agent_id AS assigned_agent_id,
+        t.assignee_human AS assignee_human,
+        t.vcs_branch AS vcs_branch,
+        t.vcs_base_branch AS vcs_base_branch,
+        t.vcs_last_commit_sha AS vcs_last_commit_sha,
+        t.metadata_json AS metadata_json,
+        t.created_at AS created_at,
+        t.updated_at AS updated_at,
+        p.id AS project_id,
+        p.key AS project_key,
+        p.name AS project_name,
+        e.id AS epic_id,
+        e.key AS epic_key,
+        e.title AS epic_title,
+        us.id AS story_id,
+        us.key AS story_key,
+        us.title AS story_title
+      FROM tasks t
+      INNER JOIN projects p ON p.id = t.project_id
+      INNER JOIN epics e ON e.id = t.epic_id
+      INNER JOIN user_stories us ON us.id = t.user_story_id
+      ${where}
+    `, params);
+        if (!rows || rows.length === 0) {
+            const suffix = projectKey ? ` in project "${projectKey}"` : "";
+            throw new Error(`No task with key "${taskKey}"${suffix}.`);
+        }
+        if (rows.length > 1 && !projectKey) {
+            throw new Error(`Multiple tasks found with key "${taskKey}"; please specify --project.`);
+        }
+        const row = rows[0];
+        const assignedAgentSlug = await this.resolveAgentSlug(row.assigned_agent_id);
+        return {
+            id: row.task_id,
+            key: row.task_key,
+            title: row.task_title,
+            description: row.task_description,
+            type: row.task_type,
+            status: row.task_status,
+            storyPoints: row.task_story_points,
+            priority: row.task_priority,
+            assignedAgentId: row.assigned_agent_id,
+            assignedAgentSlug: assignedAgentSlug ?? null,
+            assigneeHuman: row.assignee_human,
+            vcsBranch: row.vcs_branch,
+            vcsBaseBranch: row.vcs_base_branch,
+            vcsLastCommitSha: row.vcs_last_commit_sha,
+            metadata: row.metadata_json ? JSON.parse(row.metadata_json) : null,
+            project: {
+                id: row.project_id,
+                key: row.project_key,
+                name: row.project_name,
+            },
+            epic: {
+                id: row.epic_id,
+                key: row.epic_key,
+                title: row.epic_title,
+            },
+            story: {
+                id: row.story_id,
+                key: row.story_key,
+                title: row.story_title,
+            },
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    async getDependencies(taskId) {
+        const upstream = await this.db.all(`
+      SELECT td.depends_on_task_id AS taskId, dep.key AS key, dep.status AS status, td.relation_type AS relationType
+      FROM task_dependencies td
+      INNER JOIN tasks dep ON dep.id = td.depends_on_task_id
+      WHERE td.task_id = ?
+      ORDER BY dep.key
+    `, taskId);
+        const downstream = await this.db.all(`
+      SELECT td.task_id AS taskId, t.key AS key, t.status AS status, td.relation_type AS relationType
+      FROM task_dependencies td
+      INNER JOIN tasks t ON t.id = td.task_id
+      WHERE td.depends_on_task_id = ?
+      ORDER BY t.key
+    `, taskId);
+        return { upstream: upstream ?? [], downstream: downstream ?? [] };
+    }
+    async resolveTaskById(taskId) {
+        const rows = await this.db.all(`
+      SELECT
+        t.id AS task_id,
+        t.key AS task_key,
+        t.title AS task_title,
+        t.description AS task_description,
+        t.type AS task_type,
+        t.status AS task_status,
+        t.story_points AS task_story_points,
+        t.priority AS task_priority,
+        t.assigned_agent_id AS assigned_agent_id,
+        t.assignee_human AS assignee_human,
+        t.vcs_branch AS vcs_branch,
+        t.vcs_base_branch AS vcs_base_branch,
+        t.vcs_last_commit_sha AS vcs_last_commit_sha,
+        t.metadata_json AS metadata_json,
+        t.created_at AS created_at,
+        t.updated_at AS updated_at,
+        p.id AS project_id,
+        p.key AS project_key,
+        p.name AS project_name,
+        e.id AS epic_id,
+        e.key AS epic_key,
+        e.title AS epic_title,
+        us.id AS story_id,
+        us.key AS story_key,
+        us.title AS story_title
+      FROM tasks t
+      INNER JOIN projects p ON p.id = t.project_id
+      INNER JOIN epics e ON e.id = t.epic_id
+      INNER JOIN user_stories us ON us.id = t.user_story_id
+      WHERE t.id = ?
+    `, [taskId]);
+        if (!rows || rows.length === 0) {
+            throw new Error(`Task with id "${taskId}" not found in local DB.`);
+        }
+        const row = rows[0];
+        const assignedAgentSlug = await this.resolveAgentSlug(row.assigned_agent_id);
+        return {
+            id: row.task_id,
+            key: row.task_key,
+            title: row.task_title,
+            description: row.task_description,
+            type: row.task_type,
+            status: row.task_status,
+            storyPoints: row.task_story_points,
+            priority: row.task_priority,
+            assignedAgentId: row.assigned_agent_id,
+            assignedAgentSlug: assignedAgentSlug ?? null,
+            assigneeHuman: row.assignee_human,
+            vcsBranch: row.vcs_branch,
+            vcsBaseBranch: row.vcs_base_branch,
+            vcsLastCommitSha: row.vcs_last_commit_sha,
+            metadata: row.metadata_json ? JSON.parse(row.metadata_json) : null,
+            project: {
+                id: row.project_id,
+                key: row.project_key,
+                name: row.project_name,
+            },
+            epic: {
+                id: row.epic_id,
+                key: row.epic_key,
+                title: row.epic_title,
+            },
+            story: {
+                id: row.story_id,
+                key: row.story_key,
+                title: row.story_title,
+            },
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    async getLogs(taskId, limit) {
+        const rows = await this.db.all(`
+      SELECT l.task_run_id, l.timestamp, l.level, l.source, l.message, l.details_json, r.command, r.status
+      FROM task_logs l
+      INNER JOIN task_runs r ON r.id = l.task_run_id
+      WHERE r.task_id = ?
+      ORDER BY datetime(l.timestamp) DESC
+      LIMIT ?
+    `, taskId, limit);
+        return (rows ?? []).map((row) => ({
+            taskRunId: row.task_run_id,
+            timestamp: row.timestamp,
+            level: row.level,
+            source: row.source,
+            message: row.message,
+            command: row.command,
+            status: row.status,
+            details: row.details_json ? JSON.parse(row.details_json) : null,
+        }));
+    }
+    async resolveAgentSlug(agentId) {
+        if (!agentId)
+            return undefined;
+        if (!this.globalRepo) {
+            this.globalRepo = await GlobalRepository.create();
+        }
+        const agent = await this.globalRepo.getAgentById(agentId);
+        return agent?.slug ?? undefined;
+    }
+    async getHistory(taskId, limit) {
+        const rows = await this.db.all(`
+      SELECT id, job_id, command_run_id, snapshot_before_json, snapshot_after_json, created_at
+      FROM task_revisions
+      WHERE task_id = ?
+      ORDER BY datetime(created_at) DESC
+      LIMIT ?
+    `, taskId, limit);
+        return (rows ?? []).map((row) => {
+            const before = row.snapshot_before_json ? this.safeParse(row.snapshot_before_json) : null;
+            const after = row.snapshot_after_json ? this.safeParse(row.snapshot_after_json) : null;
+            const statusBefore = this.pickField(before, ["status", "task_status"]);
+            const statusAfter = this.pickField(after, ["status", "task_status"]);
+            const spBefore = this.pickField(before, ["story_points", "storyPoints", "task_story_points"]);
+            const spAfter = this.pickField(after, ["story_points", "storyPoints", "task_story_points"]);
+            const changedFields = this.diffFields(before, after);
+            return {
+                id: row.id,
+                jobId: row.job_id,
+                commandRunId: row.command_run_id,
+                changedAt: row.created_at,
+                statusBefore: statusBefore ?? undefined,
+                statusAfter: statusAfter ?? undefined,
+                storyPointsBefore: spBefore ?? null,
+                storyPointsAfter: spAfter ?? null,
+                changedFields,
+                snapshotBefore: before,
+                snapshotAfter: after,
+            };
+        });
+    }
+    safeParse(raw) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    pickField(obj, keys) {
+        if (!obj)
+            return undefined;
+        for (const key of keys) {
+            if (obj[key] !== undefined)
+                return obj[key];
+        }
+        return undefined;
+    }
+    diffFields(before, after) {
+        if (!before || !after)
+            return undefined;
+        const keys = new Set([...Object.keys(before), ...Object.keys(after)]);
+        const changed = [];
+        for (const key of keys) {
+            const lhs = before[key];
+            const rhs = after[key];
+            const same = JSON.stringify(lhs) === JSON.stringify(rhs);
+            if (!same)
+                changed.push(key);
+        }
+        return changed.length ? changed : undefined;
+    }
+}

package/dist/services/telemetry/TelemetryService.d.ts

@@ -0,0 +1,53 @@
+import { TokenUsageRow, TokenUsageSummaryRow, type TelemetryConfig as ApiTelemetryConfig } from "@mcoda/integrations";
+import { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
+export type { TokenUsageRow, TokenUsageSummaryRow } from "@mcoda/integrations";
+type GroupByDimension = "project" | "agent" | "command" | "day" | "model" | "job" | "action";
+export interface TelemetryConfigState extends ApiTelemetryConfig {
+    configPath: string;
+}
+export interface TelemetrySummaryOptions {
+    projectKey?: string;
+    agent?: string;
+    command?: string;
+    jobId?: string;
+    since?: string;
+    until?: string;
+    groupBy?: GroupByDimension[];
+}
+export interface TokenUsageQueryOptions {
+    projectKey?: string;
+    agent?: string;
+    command?: string;
+    jobId?: string;
+    since?: string;
+    until?: string;
+    page?: number;
+    pageSize?: number;
+}
+export declare class TelemetryService {
+    private workspace;
+    private globalRepo?;
+    private client?;
+    private db?;
+    private connection?;
+    private constructor();
+    static create(workspace: WorkspaceResolution, options?: {
+        allowMissingTelemetry?: boolean;
+        requireApi?: boolean;
+    }): Promise<TelemetryService>;
+    close(): Promise<void>;
+    private get configPath();
+    private readConfigFile;
+    private writeConfigFile;
+    private resolveProjectId;
+    private getGlobalRepo;
+    private resolveAgentId;
+    private filterRows;
+    private mapConfig;
+    getSummary(options?: TelemetrySummaryOptions): Promise<TokenUsageSummaryRow[]>;
+    getTokenUsage(options?: TokenUsageQueryOptions): Promise<TokenUsageRow[]>;
+    getConfig(): Promise<TelemetryConfigState>;
+    optOut(strict?: boolean): Promise<TelemetryConfigState>;
+    optIn(): Promise<TelemetryConfigState>;
+}
+//# sourceMappingURL=TelemetryService.d.ts.map

package/dist/services/telemetry/TelemetryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryService.d.ts","sourceRoot":"","sources":["../../../src/services/telemetry/TelemetryService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,aAAa,EAAE,oBAAoB,EAAE,KAAK,eAAe,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACvI,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,KAAK,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7F,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0FD,qBAAa,gBAAgB;IAMP,OAAO,CAAC,SAAS;IALrC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,CAAW;IACtB,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC,OAAO;WAMM,MAAM,CACjB,SAAS,EAAE,mBAAmB,EAC9B,OAAO,GAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACtE,OAAO,CAAC,gBAAgB,CAAC;IA6BtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,KAAK,UAAU,GAErB;YAEa,cAAc;YASd,eAAe;YAKf,gBAAgB;YAMhB,aAAa;YAOb,cAAc;IAc5B,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,SAAS;IAWX,UAAU,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA6GlF,aAAa,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuG7E,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAqB1C,MAAM,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAerD,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAc7C"}