@mcoda/core 0.1.4

package/dist/services/system/SystemUpdateService.d.ts

@@ -0,0 +1,55 @@
+import { ApplyUpdateResponse, UpdateChannel, UpdateInfo } from "@mcoda/shared";
+import { GlobalCommandStatus, GlobalRepository } from "@mcoda/db";
+import { SystemClient } from "@mcoda/integrations";
+interface ReleasesState {
+    lastCheck?: (UpdateInfo & {
+        checkedAt: string;
+    });
+    preferences?: {
+        channel?: UpdateChannel;
+    };
+}
+export interface UpdateCheckResult {
+    info: UpdateInfo;
+    checkedAt: string;
+    channel: UpdateChannel;
+}
+export type ApplyStatus = ApplyUpdateResponse["status"];
+export interface ApplyResult extends ApplyUpdateResponse {
+    targetVersion: string;
+    npmCommand: string;
+}
+export declare class SystemUpdateService {
+    private client;
+    private repo?;
+    private mcodaDir;
+    private constructor();
+    static create(baseUrl?: string, options?: {
+        client?: SystemClient;
+        repo?: GlobalRepository;
+        mcodaDir?: string;
+    }): Promise<SystemUpdateService>;
+    close(): Promise<void>;
+    private releasesPath;
+    readState(): Promise<ReleasesState>;
+    private writeState;
+    startRun(payload: Record<string, unknown>): Promise<string | undefined>;
+    finishRun(id: string | undefined, update: {
+        status: GlobalCommandStatus;
+        exitCode?: number;
+        errorSummary?: string | null;
+        result?: Record<string, unknown>;
+    }): Promise<void>;
+    resolveChannel(preferred?: UpdateChannel): Promise<UpdateChannel>;
+    savePreferredChannel(channel: UpdateChannel): Promise<void>;
+    checkUpdate(channel?: UpdateChannel): Promise<UpdateCheckResult>;
+    applyUpdate(channel?: UpdateChannel): Promise<ApplyUpdateResponse>;
+    recordApplyState(info: UpdateInfo, channel: UpdateChannel, targetVersion: string): Promise<void>;
+    runNpmInstall(targetVersion: string, options?: {
+        quiet?: boolean;
+    }): Promise<{
+        code: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=SystemUpdateService.d.ts.map

package/dist/services/system/SystemUpdateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemUpdateService.d.ts","sourceRoot":"","sources":["../../../src/services/system/SystemUpdateService.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAc,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,CAAC,UAAU,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,aAAa,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAExD,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI,CAAC;IAJf,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;WAQM,MAAM,CACjB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAClF,OAAO,CAAC,mBAAmB,CAAC;IAezB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,YAAY;IAId,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;YAI3B,UAAU;IAKlB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAWvE,SAAS,CACb,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACzH,OAAO,CAAC,IAAI,CAAC;IAWV,cAAc,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAKjE,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBhE,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAKlE,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhG,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CASzG"}

package/dist/services/system/SystemUpdateService.js

@@ -0,0 +1,136 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { spawn } from "node:child_process";
+import { PathHelper } from "@mcoda/shared";
+import { GlobalRepository } from "@mcoda/db";
+import { SystemClient } from "@mcoda/integrations";
+const nowIso = () => new Date().toISOString();
+const normalizeChannel = (channel) => {
+    if (!channel)
+        return "stable";
+    if (channel === "stable" || channel === "beta" || channel === "nightly")
+        return channel;
+    throw new Error(`Unsupported channel: ${channel}`);
+};
+const parseJson = async (filePath) => {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+};
+export class SystemUpdateService {
+    constructor(client, repo, options = {}) {
+        this.client = client;
+        this.repo = repo;
+        this.mcodaDir = options.mcodaDir ?? PathHelper.getGlobalMcodaDir();
+    }
+    static async create(baseUrl, options = {}) {
+        const client = options.client ??
+            new SystemClient(baseUrl ?? process.env.MCODA_API_BASE_URL ?? process.env.MCODA_SYSTEM_API_URL);
+        let repo = options.repo;
+        if (!repo) {
+            try {
+                repo = await GlobalRepository.create();
+            }
+            catch {
+                repo = undefined;
+            }
+        }
+        return new SystemUpdateService(client, repo, { mcodaDir: options.mcodaDir });
+    }
+    async close() {
+        if (this.repo) {
+            await this.repo.close();
+        }
+    }
+    releasesPath() {
+        return path.join(this.mcodaDir, "releases.json");
+    }
+    async readState() {
+        return (await parseJson(this.releasesPath())) ?? {};
+    }
+    async writeState(state) {
+        await PathHelper.ensureDir(this.mcodaDir);
+        await fs.writeFile(this.releasesPath(), JSON.stringify(state, null, 2), "utf8");
+    }
+    async startRun(payload) {
+        const startedAt = nowIso();
+        const run = await this.repo?.createCommandRun({
+            commandName: "update",
+            startedAt,
+            status: "running",
+            payload,
+        });
+        return run?.id;
+    }
+    async finishRun(id, update) {
+        if (!id || !this.repo)
+            return;
+        await this.repo.completeCommandRun(id, {
+            status: update.status,
+            completedAt: nowIso(),
+            exitCode: update.exitCode ?? null,
+            errorSummary: update.errorSummary ?? null,
+            result: update.result,
+        });
+    }
+    async resolveChannel(preferred) {
+        const state = await this.readState();
+        return normalizeChannel(preferred ?? state.preferences?.channel ?? "stable");
+    }
+    async savePreferredChannel(channel) {
+        const state = await this.readState();
+        await this.writeState({
+            ...state,
+            preferences: { ...(state.preferences ?? {}), channel },
+        });
+    }
+    async checkUpdate(channel) {
+        const resolved = await this.resolveChannel(channel);
+        const info = await this.client.checkUpdate(resolved);
+        const checkedAt = nowIso();
+        const state = await this.readState();
+        await this.writeState({
+            ...state,
+            preferences: { ...(state.preferences ?? {}), channel: resolved },
+            lastCheck: {
+                ...info,
+                checkedAt,
+                channel: resolved,
+            },
+        });
+        return { info, checkedAt, channel: resolved };
+    }
+    async applyUpdate(channel) {
+        const resolved = channel ? normalizeChannel(channel) : undefined;
+        return this.client.applyUpdate(resolved ? { channel: resolved } : undefined);
+    }
+    async recordApplyState(info, channel, targetVersion) {
+        const checkedAt = nowIso();
+        const state = await this.readState();
+        await this.writeState({
+            ...state,
+            preferences: { ...(state.preferences ?? {}), channel },
+            lastCheck: {
+                ...info,
+                currentVersion: targetVersion,
+                latestVersion: targetVersion,
+                updateAvailable: false,
+                channel,
+                checkedAt,
+            },
+        });
+    }
+    async runNpmInstall(targetVersion, options = {}) {
+        return new Promise((resolve, reject) => {
+            const child = spawn("npm", ["install", "-g", `mcoda@${targetVersion}`], {
+                stdio: options.quiet ? "ignore" : "inherit",
+            });
+            child.on("error", (error) => reject(error));
+            child.on("close", (code) => resolve({ code: code ?? 0 }));
+        });
+    }
+}

package/dist/services/tasks/TaskApiResolver.d.ts

@@ -0,0 +1,7 @@
+export declare class TaskApiResolver {
+    private baseUrl?;
+    constructor(baseUrl?: string | undefined);
+    private getBaseUrl;
+    resolveTaskId(taskKey: string, projectKey?: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=TaskApiResolver.d.ts.map

package/dist/services/tasks/TaskApiResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskApiResolver.d.ts","sourceRoot":"","sources":["../../../src/services/tasks/TaskApiResolver.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IACd,OAAO,CAAC,OAAO,CAAC;gBAAR,OAAO,CAAC,EAAE,MAAM,YAAA;IAEpC,OAAO,CAAC,UAAU;IAIZ,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CA6BvF"}

package/dist/services/tasks/TaskApiResolver.js

@@ -0,0 +1,41 @@
+export class TaskApiResolver {
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    getBaseUrl() {
+        return this.baseUrl ?? process.env.MCODA_API_BASE_URL ?? process.env.MCODA_TASKS_API_URL;
+    }
+    async resolveTaskId(taskKey, projectKey) {
+        const base = this.getBaseUrl();
+        if (!base)
+            return undefined;
+        try {
+            const url = new URL("/tasks", base);
+            url.searchParams.set("key", taskKey);
+            if (projectKey) {
+                url.searchParams.set("project", projectKey);
+            }
+            const resp = await fetch(url, { headers: { accept: "application/json" } });
+            if (!resp.ok)
+                return undefined;
+            const body = await resp.json();
+            const candidates = Array.isArray(body)
+                ? body
+                : Array.isArray(body?.tasks)
+                    ? body.tasks
+                    : Array.isArray(body?.data)
+                        ? body.data
+                        : [];
+            if (!candidates.length)
+                return undefined;
+            if (candidates.length > 1 && !projectKey) {
+                throw new Error(`Multiple tasks found with key "${taskKey}" via OpenAPI; please specify --project.`);
+            }
+            const taskId = candidates[0]?.id ?? candidates[0]?.task_id;
+            return typeof taskId === "string" ? taskId : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}

package/dist/services/tasks/TaskDetailService.d.ts

@@ -0,0 +1,106 @@
+import { WorkspaceRepository, type TaskCommentRow } from "@mcoda/db";
+import type { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
+export interface DependencySummary {
+    taskId: string;
+    key: string;
+    status: string;
+    relationType: string;
+}
+export interface TaskLogSummary {
+    taskRunId: string;
+    timestamp: string;
+    level?: string | null;
+    source?: string | null;
+    message?: string | null;
+    command?: string;
+    status?: string;
+    details?: Record<string, unknown> | null;
+}
+export interface TaskRevisionSummary {
+    id: string;
+    jobId?: string | null;
+    commandRunId?: string | null;
+    changedAt: string;
+    statusBefore?: string;
+    statusAfter?: string;
+    storyPointsBefore?: number | null;
+    storyPointsAfter?: number | null;
+    changedFields?: string[];
+    snapshotBefore?: Record<string, unknown> | null;
+    snapshotAfter?: Record<string, unknown> | null;
+}
+export interface TaskDetailRecord {
+    id: string;
+    key: string;
+    title: string;
+    description?: string | null;
+    type?: string | null;
+    status: string;
+    storyPoints?: number | null;
+    priority?: number | null;
+    assignedAgentId?: string | null;
+    assignedAgentSlug?: string | null;
+    assigneeHuman?: string | null;
+    vcsBranch?: string | null;
+    vcsBaseBranch?: string | null;
+    vcsLastCommitSha?: string | null;
+    metadata?: Record<string, unknown> | null;
+    project: {
+        id: string;
+        key: string;
+        name?: string | null;
+    };
+    epic: {
+        id: string;
+        key: string;
+        title: string;
+    };
+    story: {
+        id: string;
+        key: string;
+        title: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TaskDetailResult {
+    task: TaskDetailRecord;
+    dependencies: {
+        upstream: DependencySummary[];
+        downstream: DependencySummary[];
+    };
+    comments: TaskCommentRow[];
+    logs?: TaskLogSummary[];
+    history?: TaskRevisionSummary[];
+}
+export interface TaskDetailOptions {
+    taskKey: string;
+    projectKey?: string;
+    includeLogs?: boolean;
+    includeHistory?: boolean;
+    commentsLimit?: number;
+    logsLimit?: number;
+    historyLimit?: number;
+}
+export declare class TaskDetailService {
+    private workspace;
+    private db;
+    private repo;
+    private globalRepo?;
+    private apiResolver;
+    private constructor();
+    static create(workspace: WorkspaceResolution): Promise<TaskDetailService>;
+    close(): Promise<void>;
+    getRepository(): WorkspaceRepository;
+    getTaskDetail(options: TaskDetailOptions): Promise<TaskDetailResult>;
+    private resolveTask;
+    private getDependencies;
+    private resolveTaskById;
+    private getLogs;
+    private resolveAgentSlug;
+    private getHistory;
+    private safeParse;
+    private pickField;
+    private diffFields;
+}
+//# sourceMappingURL=TaskDetailService.d.ts.map

package/dist/services/tasks/TaskDetailService.d.ts.map

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