@mcoda/integrations 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## Unreleased
+- Initial public packaging for @mcoda/integrations.
+
+## 0.1.4
+- Initial release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 bekir dag
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @mcoda/integrations
+
+External integrations for mcoda (vcs, QA, telemetry).
+
+## Usage
+This package is primarily an internal dependency of `mcoda`.
+
+## License
+MIT - see `LICENSE`.

package/dist/docdex/DocdexClient.d.ts

@@ -0,0 +1,50 @@
+export interface DocdexSegment {
+    id: string;
+    docId: string;
+    index: number;
+    content: string;
+    heading?: string;
+}
+export interface DocdexDocument {
+    id: string;
+    docType: string;
+    path?: string;
+    title?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    segments?: DocdexSegment[];
+}
+export interface RegisterDocumentInput {
+    docType: string;
+    path?: string;
+    title?: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class DocdexClient {
+    private options;
+    constructor(options?: {
+        workspaceRoot?: string;
+        storePath?: string;
+        baseUrl?: string;
+        authToken?: string;
+    });
+    private getStorePath;
+    private normalizePath;
+    private loadStore;
+    private fetchRemote;
+    private saveStore;
+    fetchDocumentById(id: string): Promise<DocdexDocument>;
+    findDocumentByPath(docPath: string, docType?: string): Promise<DocdexDocument | undefined>;
+    search(filter: {
+        docType?: string;
+        projectKey?: string;
+        query?: string;
+        profile?: string;
+    }): Promise<DocdexDocument[]>;
+    registerDocument(input: RegisterDocumentInput): Promise<DocdexDocument>;
+    ensureRegisteredFromFile(docPath: string, docType: string, metadata?: Record<string, unknown>): Promise<DocdexDocument>;
+}
+//# sourceMappingURL=DocdexClient.d.ts.map

package/dist/docdex/DocdexClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocdexClient.d.ts","sourceRoot":"","sources":["../../src/docdex/DocdexClient.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAyCD,qBAAa,YAAY;IAErB,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACf;IAGR,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;YAYP,SAAS;YAaT,WAAW;YAYX,SAAS;IAOjB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAoBtD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAU1F,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA0BtH,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IA6DvE,wBAAwB,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,cAAc,CAAC;CAO3B"}

package/dist/docdex/DocdexClient.js

@@ -0,0 +1,216 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { promises as fs } from "node:fs";
+const nowIso = () => new Date().toISOString();
+const segmentize = (docId, content) => {
+    const lines = content.split(/\r?\n/);
+    const segments = [];
+    let buffer = [];
+    let heading = "";
+    const flush = () => {
+        if (buffer.length === 0)
+            return;
+        segments.push({
+            id: `${docId}-seg-${segments.length + 1}`,
+            docId,
+            index: segments.length,
+            content: buffer.join("\n").trim(),
+            heading: heading || undefined,
+        });
+        buffer = [];
+        heading = "";
+    };
+    for (const line of lines) {
+        if (/^#{1,6}\s+/.test(line)) {
+            flush();
+            heading = line.replace(/^#{1,6}\s+/, "").trim();
+        }
+        buffer.push(line);
+        if (buffer.join("").length > 1500) {
+            flush();
+        }
+    }
+    flush();
+    return segments;
+};
+export class DocdexClient {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    getStorePath() {
+        const base = this.options.storePath
+            ? path.resolve(this.options.storePath)
+            : path.join(this.options.workspaceRoot ?? process.cwd(), ".mcoda", "docdex", "documents.json");
+        return base;
+    }
+    normalizePath(inputPath) {
+        if (!inputPath)
+            return undefined;
+        const absolute = path.resolve(inputPath);
+        if (this.options.workspaceRoot) {
+            const root = path.resolve(this.options.workspaceRoot);
+            if (absolute.startsWith(root)) {
+                return path.relative(root, absolute);
+            }
+        }
+        return absolute;
+    }
+    async loadStore() {
+        const storePath = this.getStorePath();
+        try {
+            const raw = await fs.readFile(storePath, "utf8");
+            const parsed = JSON.parse(raw);
+            parsed.documents = parsed.documents ?? [];
+            parsed.segments = parsed.segments ?? [];
+            return parsed;
+        }
+        catch {
+            return { updatedAt: nowIso(), documents: [], segments: [] };
+        }
+    }
+    async fetchRemote(pathname, init) {
+        if (!this.options.baseUrl)
+            throw new Error("Docdex baseUrl not configured");
+        const url = new URL(pathname, this.options.baseUrl);
+        const headers = { "Content-Type": "application/json" };
+        if (this.options.authToken)
+            headers.authorization = `Bearer ${this.options.authToken}`;
+        const response = await fetch(url, { ...init, headers: { ...headers, ...init?.headers } });
+        if (!response.ok) {
+            throw new Error(`Docdex request failed (${response.status}): ${await response.text()}`);
+        }
+        return (await response.json());
+    }
+    async saveStore(store) {
+        const storePath = this.getStorePath();
+        await fs.mkdir(path.dirname(storePath), { recursive: true });
+        const payload = { ...store, updatedAt: nowIso() };
+        await fs.writeFile(storePath, JSON.stringify(payload, null, 2), "utf8");
+    }
+    async fetchDocumentById(id) {
+        if (this.options.baseUrl) {
+            try {
+                const doc = await this.fetchRemote(`/documents/${id}`);
+                return doc;
+            }
+            catch (error) {
+                // fall through to local if remote fails
+                // eslint-disable-next-line no-console
+                console.warn(`Docdex remote fetch failed, falling back to local: ${error.message}`);
+            }
+        }
+        const store = await this.loadStore();
+        const doc = store.documents.find((d) => d.id === id);
+        if (!doc) {
+            throw new Error(`Docdex document not found: ${id}`);
+        }
+        const segments = store.segments.filter((s) => s.docId === id);
+        return { ...doc, segments };
+    }
+    async findDocumentByPath(docPath, docType) {
+        const normalized = this.normalizePath(docPath);
+        const store = await this.loadStore();
+        const doc = store.documents.find((d) => d.path === normalized && (!docType || d.docType.toLowerCase() === docType.toLowerCase()));
+        if (!doc)
+            return undefined;
+        return { ...doc, segments: store.segments.filter((s) => s.docId === doc.id) };
+    }
+    async search(filter) {
+        if (this.options.baseUrl) {
+            try {
+                const params = new URLSearchParams();
+                if (filter.docType)
+                    params.set("doc_type", filter.docType);
+                if (filter.projectKey)
+                    params.set("project_key", filter.projectKey);
+                if (filter.query)
+                    params.set("q", filter.query);
+                if (filter.profile)
+                    params.set("profile", filter.profile);
+                const path = `/documents?${params.toString()}`;
+                const docs = await this.fetchRemote(path);
+                return docs;
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.warn(`Docdex remote search failed, falling back to local: ${error.message}`);
+            }
+        }
+        const store = await this.loadStore();
+        return store.documents
+            .filter((doc) => {
+            if (filter.docType && doc.docType.toLowerCase() !== filter.docType.toLowerCase())
+                return false;
+            if (filter.projectKey && doc.metadata && doc.metadata.projectKey !== filter.projectKey)
+                return false;
+            return true;
+        })
+            .map((doc) => ({ ...doc, segments: store.segments.filter((s) => s.docId === doc.id) }));
+    }
+    async registerDocument(input) {
+        if (this.options.baseUrl) {
+            try {
+                const registered = await this.fetchRemote(`/documents`, {
+                    method: "POST",
+                    body: JSON.stringify({
+                        doc_type: input.docType,
+                        path: input.path,
+                        title: input.title,
+                        content: input.content,
+                        metadata: input.metadata,
+                    }),
+                });
+                return registered;
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.warn(`Docdex remote register failed, falling back to local: ${error.message}`);
+            }
+        }
+        const store = await this.loadStore();
+        const normalizedPath = this.normalizePath(input.path);
+        const existingByPath = normalizedPath
+            ? store.documents.find((d) => d.path === normalizedPath &&
+                d.docType.toLowerCase() === input.docType.toLowerCase() &&
+                (input.metadata?.projectKey ? d.metadata?.projectKey === input.metadata.projectKey : true))
+            : undefined;
+        const now = nowIso();
+        if (existingByPath) {
+            const updated = {
+                ...existingByPath,
+                content: input.content ?? existingByPath.content,
+                metadata: { ...(existingByPath.metadata ?? {}), ...(input.metadata ?? {}) },
+                title: input.title ?? existingByPath.title,
+                updatedAt: now,
+            };
+            const segments = segmentize(updated.id, input.content);
+            store.documents[store.documents.findIndex((d) => d.id === existingByPath.id)] = updated;
+            store.segments = store.segments.filter((s) => s.docId !== updated.id).concat(segments);
+            await this.saveStore(store);
+            return { ...updated, segments };
+        }
+        const doc = {
+            id: randomUUID(),
+            docType: input.docType,
+            path: normalizedPath,
+            content: input.content,
+            metadata: input.metadata,
+            title: input.title,
+            createdAt: now,
+            updatedAt: now,
+        };
+        const segments = segmentize(doc.id, input.content);
+        store.documents.push(doc);
+        store.segments.push(...segments);
+        await this.saveStore(store);
+        return { ...doc, segments };
+    }
+    async ensureRegisteredFromFile(docPath, docType, metadata) {
+        const normalizedPath = this.normalizePath(docPath) ?? docPath;
+        const existing = await this.findDocumentByPath(normalizedPath, docType);
+        if (existing)
+            return existing;
+        const content = await fs.readFile(docPath, "utf8");
+        return this.registerDocument({ docType, path: docPath, content, metadata });
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./docdex/DocdexClient.js";
+export * from "./telemetry/TelemetryClient.js";
+export * from "./vcs/VcsClient.js";
+export * from "./qa/index.js";
+export * from "./system/SystemClient.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./docdex/DocdexClient.js";
+export * from "./telemetry/TelemetryClient.js";
+export * from "./vcs/VcsClient.js";
+export * from "./qa/index.js";
+export * from "./system/SystemClient.js";

package/dist/issues/IssuesClient.d.ts

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

package/dist/issues/IssuesClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssuesClient.d.ts","sourceRoot":"","sources":["../../src/issues/IssuesClient.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;CAAG"}

package/dist/issues/IssuesClient.js

@@ -0,0 +1,2 @@
+export class IssuesClient {
+}

package/dist/qa/ChromiumQaAdapter.d.ts

@@ -0,0 +1,10 @@
+import { QaProfile } from '@mcoda/shared/qa/QaProfile.js';
+import { QaAdapter } from './QaAdapter.js';
+import { QaContext, QaEnsureResult, QaRunResult } from './QaTypes.js';
+export declare class ChromiumQaAdapter implements QaAdapter {
+    private resolveCwd;
+    ensureInstalled(profile: QaProfile, ctx: QaContext): Promise<QaEnsureResult>;
+    private persistLogs;
+    invoke(profile: QaProfile, ctx: QaContext): Promise<QaRunResult>;
+}
+//# sourceMappingURL=ChromiumQaAdapter.d.ts.map

package/dist/qa/ChromiumQaAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromiumQaAdapter.d.ts","sourceRoot":"","sources":["../../src/qa/ChromiumQaAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOtE,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,UAAU;IASZ,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;YAiBpE,WAAW;IAYnB,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAqCvE"}

package/dist/qa/ChromiumQaAdapter.js

@@ -0,0 +1,85 @@
+import path from 'node:path';
+import { exec as execCb } from 'node:child_process';
+import { promisify } from 'node:util';
+import fs from 'node:fs/promises';
+const exec = promisify(execCb);
+const shouldSkipInstall = (ctx) => process.env.MCODA_QA_SKIP_INSTALL === '1' || ctx.env?.MCODA_QA_SKIP_INSTALL === '1';
+export class ChromiumQaAdapter {
+    resolveCwd(profile, ctx) {
+        if (profile.working_dir) {
+            return path.isAbsolute(profile.working_dir)
+                ? profile.working_dir
+                : path.join(ctx.workspaceRoot, profile.working_dir);
+        }
+        return ctx.workspaceRoot;
+    }
+    async ensureInstalled(profile, ctx) {
+        if (shouldSkipInstall(ctx))
+            return { ok: true, details: { skipped: true } };
+        const cwd = this.resolveCwd(profile, ctx);
+        try {
+            await exec('npx playwright --version', { cwd, env: { ...process.env, ...profile.env, ...ctx.env } });
+            return { ok: true };
+        }
+        catch (versionError) {
+            const installCommand = profile.install_command ?? 'npx playwright install chromium';
+            try {
+                await exec(installCommand, { cwd, env: { ...process.env, ...profile.env, ...ctx.env } });
+                return { ok: true, details: { installedVia: installCommand } };
+            }
+            catch (error) {
+                return { ok: false, message: error?.message ?? versionError?.message ?? 'Chromium QA install failed' };
+            }
+        }
+    }
+    async persistLogs(ctx, stdout, stderr) {
+        const artifacts = [];
+        if (!ctx.artifactDir)
+            return artifacts;
+        await fs.mkdir(ctx.artifactDir, { recursive: true });
+        const outPath = path.join(ctx.artifactDir, 'stdout.log');
+        const errPath = path.join(ctx.artifactDir, 'stderr.log');
+        await fs.writeFile(outPath, stdout ?? '', 'utf8');
+        await fs.writeFile(errPath, stderr ?? '', 'utf8');
+        artifacts.push(path.relative(ctx.workspaceRoot, outPath), path.relative(ctx.workspaceRoot, errPath));
+        return artifacts;
+    }
+    async invoke(profile, ctx) {
+        const command = ctx.testCommandOverride ?? profile.test_command ?? 'npx playwright test --reporter=list';
+        const startedAt = new Date().toISOString();
+        const cwd = this.resolveCwd(profile, ctx);
+        try {
+            const { stdout, stderr } = await exec(command, {
+                cwd,
+                env: { ...process.env, ...profile.env, ...ctx.env },
+            });
+            const finishedAt = new Date().toISOString();
+            const artifacts = await this.persistLogs(ctx, stdout, stderr);
+            return {
+                outcome: 'pass',
+                exitCode: 0,
+                stdout,
+                stderr,
+                artifacts,
+                startedAt,
+                finishedAt,
+            };
+        }
+        catch (error) {
+            const stdout = error?.stdout ?? '';
+            const stderr = error?.stderr ?? String(error);
+            const exitCode = typeof error?.code === 'number' ? error.code : null;
+            const finishedAt = new Date().toISOString();
+            const artifacts = await this.persistLogs(ctx, stdout, stderr);
+            return {
+                outcome: exitCode === null ? 'infra_issue' : exitCode === 0 ? 'pass' : 'fail',
+                exitCode,
+                stdout,
+                stderr,
+                artifacts,
+                startedAt,
+                finishedAt,
+            };
+        }
+    }
+}

package/dist/qa/CliQaAdapter.d.ts

@@ -0,0 +1,10 @@
+import { QaProfile } from '@mcoda/shared/qa/QaProfile.js';
+import { QaAdapter } from './QaAdapter.js';
+import { QaContext, QaEnsureResult, QaRunResult } from './QaTypes.js';
+export declare class CliQaAdapter implements QaAdapter {
+    private resolveCwd;
+    ensureInstalled(profile: QaProfile, ctx: QaContext): Promise<QaEnsureResult>;
+    private persistLogs;
+    invoke(profile: QaProfile, ctx: QaContext): Promise<QaRunResult>;
+}
+//# sourceMappingURL=CliQaAdapter.d.ts.map

package/dist/qa/CliQaAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliQaAdapter.d.ts","sourceRoot":"","sources":["../../src/qa/CliQaAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKtE,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,UAAU;IASZ,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;YAapE,WAAW;IAYnB,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAiDvE"}

package/dist/qa/CliQaAdapter.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import { exec as execCb } from 'node:child_process';
+import { promisify } from 'node:util';
+import fs from 'node:fs/promises';
+const exec = promisify(execCb);
+export class CliQaAdapter {
+    resolveCwd(profile, ctx) {
+        if (profile.working_dir) {
+            return path.isAbsolute(profile.working_dir)
+                ? profile.working_dir
+                : path.join(ctx.workspaceRoot, profile.working_dir);
+        }
+        return ctx.workspaceRoot;
+    }
+    async ensureInstalled(profile, ctx) {
+        if (!profile.install_command)
+            return { ok: true };
+        try {
+            await exec(profile.install_command, {
+                cwd: this.resolveCwd(profile, ctx),
+                env: { ...process.env, ...profile.env, ...ctx.env },
+            });
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, message: error?.message ?? 'QA install failed' };
+        }
+    }
+    async persistLogs(ctx, stdout, stderr) {
+        const artifacts = [];
+        if (!ctx.artifactDir)
+            return artifacts;
+        await fs.mkdir(ctx.artifactDir, { recursive: true });
+        const outPath = path.join(ctx.artifactDir, 'stdout.log');
+        const errPath = path.join(ctx.artifactDir, 'stderr.log');
+        await fs.writeFile(outPath, stdout ?? '', 'utf8');
+        await fs.writeFile(errPath, stderr ?? '', 'utf8');
+        artifacts.push(path.relative(ctx.workspaceRoot, outPath), path.relative(ctx.workspaceRoot, errPath));
+        return artifacts;
+    }
+    async invoke(profile, ctx) {
+        const command = ctx.testCommandOverride ?? profile.test_command;
+        const startedAt = new Date().toISOString();
+        if (!command) {
+            const finishedAt = new Date().toISOString();
+            return {
+                outcome: 'infra_issue',
+                exitCode: null,
+                stdout: '',
+                stderr: 'No test_command configured for QA profile',
+                artifacts: [],
+                startedAt,
+                finishedAt,
+            };
+        }
+        const cwd = this.resolveCwd(profile, ctx);
+        try {
+            const { stdout, stderr } = await exec(command, {
+                cwd,
+                env: { ...process.env, ...profile.env, ...ctx.env },
+            });
+            const finishedAt = new Date().toISOString();
+            const artifacts = await this.persistLogs(ctx, stdout, stderr);
+            return {
+                outcome: 'pass',
+                exitCode: 0,
+                stdout,
+                stderr,
+                artifacts,
+                startedAt,
+                finishedAt,
+            };
+        }
+        catch (error) {
+            const stdout = error?.stdout ?? '';
+            const stderr = error?.stderr ?? String(error);
+            const exitCode = typeof error?.code === 'number' ? error.code : null;
+            const finishedAt = new Date().toISOString();
+            const artifacts = await this.persistLogs(ctx, stdout, stderr);
+            return {
+                outcome: exitCode === null ? 'infra_issue' : exitCode === 0 ? 'pass' : 'fail',
+                exitCode,
+                stdout,
+                stderr,
+                artifacts,
+                startedAt,
+                finishedAt,
+            };
+        }
+    }
+}

package/dist/qa/MaestroQaAdapter.d.ts

@@ -0,0 +1,10 @@
+import { QaProfile } from '@mcoda/shared/qa/QaProfile.js';
+import { QaAdapter } from './QaAdapter.js';
+import { QaContext, QaEnsureResult, QaRunResult } from './QaTypes.js';
+export declare class MaestroQaAdapter implements QaAdapter {
+    private resolveCwd;
+    ensureInstalled(profile: QaProfile, ctx: QaContext): Promise<QaEnsureResult>;
+    private persistLogs;
+    invoke(profile: QaProfile, ctx: QaContext): Promise<QaRunResult>;
+}
+//# sourceMappingURL=MaestroQaAdapter.d.ts.map

package/dist/qa/MaestroQaAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaestroQaAdapter.d.ts","sourceRoot":"","sources":["../../src/qa/MaestroQaAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOtE,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,UAAU;IASZ,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;YAmBpE,WAAW;IAYnB,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAqCvE"}

package/dist/qa/MaestroQaAdapter.js

@@ -0,0 +1,87 @@
+import path from 'node:path';
+import { exec as execCb } from 'node:child_process';
+import { promisify } from 'node:util';
+import fs from 'node:fs/promises';
+const exec = promisify(execCb);
+const shouldSkipInstall = (ctx) => process.env.MCODA_QA_SKIP_INSTALL === '1' || ctx.env?.MCODA_QA_SKIP_INSTALL === '1';
+export class MaestroQaAdapter {
+    resolveCwd(profile, ctx) {
+        if (profile.working_dir) {
+            return path.isAbsolute(profile.working_dir)
+                ? profile.working_dir
+                : path.join(ctx.workspaceRoot, profile.working_dir);
+        }
+        return ctx.workspaceRoot;
+    }
+    async ensureInstalled(profile, ctx) {
+        if (shouldSkipInstall(ctx))
+            return { ok: true, details: { skipped: true } };
+        const cwd = this.resolveCwd(profile, ctx);
+        try {
+            await exec('maestro --version', { cwd, env: { ...process.env, ...profile.env, ...ctx.env } });
+            return { ok: true };
+        }
+        catch (versionError) {
+            if (!profile.install_command) {
+                return { ok: false, message: versionError?.message ?? 'Maestro not available' };
+            }
+            try {
+                await exec(profile.install_command, { cwd, env: { ...process.env, ...profile.env, ...ctx.env } });
+                return { ok: true, details: { installedVia: profile.install_command } };
+            }
+            catch (error) {
+                return { ok: false, message: error?.message ?? versionError?.message ?? 'Maestro install failed' };
+            }
+        }
+    }
+    async persistLogs(ctx, stdout, stderr) {
+        const artifacts = [];
+        if (!ctx.artifactDir)
+            return artifacts;
+        await fs.mkdir(ctx.artifactDir, { recursive: true });
+        const outPath = path.join(ctx.artifactDir, 'stdout.log');
+        const errPath = path.join(ctx.artifactDir, 'stderr.log');
+        await fs.writeFile(outPath, stdout ?? '', 'utf8');
+        await fs.writeFile(errPath, stderr ?? '', 'utf8');
+        artifacts.push(path.relative(ctx.workspaceRoot, outPath), path.relative(ctx.workspaceRoot, errPath));
+        return artifacts;
+    }
+    async invoke(profile, ctx) {
+        const command = ctx.testCommandOverride ?? profile.test_command ?? 'maestro test';
+        const startedAt = new Date().toISOString();
+        const cwd = this.resolveCwd(profile, ctx);
+        try {
+            const { stdout, stderr } = await exec(command, {
+                cwd,
+                env: { ...process.env, ...profile.env, ...ctx.env },
+            });
+            const finishedAt = new Date().toISOString();
+            const artifacts = await this.persistLogs(ctx, stdout, stderr);
+            return {
+                outcome: 'pass',
+                exitCode: 0,
+                stdout,
+                stderr,
+                artifacts,
+                startedAt,
+                finishedAt,
+            };
+        }
+        catch (error) {
+            const stdout = error?.stdout ?? '';
+            const stderr = error?.stderr ?? String(error);
+            const exitCode = typeof error?.code === 'number' ? error.code : null;
+            const finishedAt = new Date().toISOString();
+            const artifacts = await this.persistLogs(ctx, stdout, stderr);
+            return {
+                outcome: exitCode === null ? 'infra_issue' : exitCode === 0 ? 'pass' : 'fail',
+                exitCode,
+                stdout,
+                stderr,
+                artifacts,
+                startedAt,
+                finishedAt,
+            };
+        }
+    }
+}

package/dist/qa/QaAdapter.d.ts

@@ -0,0 +1,7 @@
+import { QaContext, QaEnsureResult, QaRunResult } from './QaTypes.js';
+import { QaProfile } from '@mcoda/shared/qa/QaProfile.js';
+export interface QaAdapter {
+    ensureInstalled(profile: QaProfile, ctx: QaContext): Promise<QaEnsureResult>;
+    invoke(profile: QaProfile, ctx: QaContext): Promise<QaRunResult>;
+}
+//# sourceMappingURL=QaAdapter.d.ts.map

package/dist/qa/QaAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaAdapter.d.ts","sourceRoot":"","sources":["../../src/qa/QaAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClE"}

package/dist/qa/QaAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/qa/QaClient.d.ts

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

package/dist/qa/QaClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaClient.d.ts","sourceRoot":"","sources":["../../src/qa/QaClient.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;CAAG"}

package/dist/qa/QaClient.js

@@ -0,0 +1,2 @@
+export class QaClient {
+}

package/dist/qa/QaTypes.d.ts

@@ -0,0 +1,24 @@
+export type QaOutcome = 'pass' | 'fail' | 'infra_issue';
+export interface QaRunResult {
+    outcome: QaOutcome;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    artifacts: string[];
+    startedAt: string;
+    finishedAt: string;
+}
+export interface QaEnsureResult {
+    ok: boolean;
+    message?: string;
+    details?: Record<string, unknown>;
+}
+export interface QaContext {
+    workspaceRoot: string;
+    jobId: string;
+    taskKey: string;
+    env: NodeJS.ProcessEnv;
+    testCommandOverride?: string;
+    artifactDir?: string;
+}
+//# sourceMappingURL=QaTypes.d.ts.map

package/dist/qa/QaTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaTypes.d.ts","sourceRoot":"","sources":["../../src/qa/QaTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/qa/QaTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/qa/index.d.ts

@@ -0,0 +1,6 @@
+export * from './QaTypes.js';
+export * from './QaAdapter.js';
+export * from './CliQaAdapter.js';
+export * from './ChromiumQaAdapter.js';
+export * from './MaestroQaAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/qa/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qa/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/qa/index.js

@@ -0,0 +1,5 @@
+export * from './QaTypes.js';
+export * from './QaAdapter.js';
+export * from './CliQaAdapter.js';
+export * from './ChromiumQaAdapter.js';
+export * from './MaestroQaAdapter.js';

package/dist/system/SystemClient.d.ts

@@ -0,0 +1,12 @@
+import { ApplyUpdateResponse, UpdateChannel, UpdateInfo } from "@mcoda/shared";
+export declare class SystemClient {
+    private baseUrl?;
+    constructor(baseUrl?: string | undefined);
+    private ensureBaseUrl;
+    private fetchJson;
+    checkUpdate(channel?: UpdateChannel): Promise<UpdateInfo>;
+    applyUpdate(body?: {
+        channel?: UpdateChannel;
+    }): Promise<ApplyUpdateResponse>;
+}
+//# sourceMappingURL=SystemClient.d.ts.map

package/dist/system/SystemClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemClient.d.ts","sourceRoot":"","sources":["../../src/system/SystemClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ/E,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO,CAAC;gBAAR,OAAO,CAAC,EAAE,MAAM,YAAA;IAEpC,OAAO,CAAC,aAAa;YAOP,SAAS;IAYjB,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAUzD,WAAW,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;CASpF"}

package/dist/system/SystemClient.js

@@ -0,0 +1,47 @@
+const toQueryChannel = (channel) => {
+    if (!channel)
+        return undefined;
+    if (channel === "nightly")
+        return "nightly";
+    return channel;
+};
+export class SystemClient {
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    ensureBaseUrl() {
+        if (!this.baseUrl) {
+            throw new Error("System update API is not configured (set MCODA_API_BASE_URL or MCODA_SYSTEM_API_URL).");
+        }
+        return this.baseUrl;
+    }
+    async fetchJson(input, init) {
+        const resp = await fetch(input, {
+            ...init,
+            headers: { accept: "application/json", ...init?.headers },
+        });
+        if (!resp.ok) {
+            const detail = await resp.text().catch(() => "");
+            throw new Error(`System update request failed (${resp.status}): ${detail || resp.statusText}`);
+        }
+        return (await resp.json());
+    }
+    async checkUpdate(channel) {
+        const base = this.ensureBaseUrl();
+        const url = new URL("/system/update", base);
+        const queryChannel = toQueryChannel(channel);
+        if (queryChannel) {
+            url.searchParams.set("channel", queryChannel);
+        }
+        return this.fetchJson(url);
+    }
+    async applyUpdate(body) {
+        const base = this.ensureBaseUrl();
+        const url = new URL("/system/update", base);
+        return this.fetchJson(url, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: body && body.channel ? JSON.stringify({ channel: toQueryChannel(body.channel) }) : undefined,
+        });
+    }
+}

package/dist/telemetry/TelemetryClient.d.ts

@@ -0,0 +1,79 @@
+export interface TokenUsageSummaryRow {
+    workspace_id: string;
+    project_id?: string | null;
+    agent_id?: string | null;
+    model_name?: string | null;
+    command_name?: string | null;
+    action?: string | null;
+    job_id?: string | null;
+    day?: string | null;
+    calls: number;
+    tokens_prompt: number;
+    tokens_completion: number;
+    tokens_total: number;
+    cost_estimate: number | null;
+}
+export interface TokenUsageRow {
+    workspace_id: string;
+    agent_id: string | null;
+    model_name: string | null;
+    job_id: string | null;
+    command_run_id: string | null;
+    task_run_id: string | null;
+    task_id: string | null;
+    project_id: string | null;
+    epic_id: string | null;
+    user_story_id: string | null;
+    tokens_prompt: number | null;
+    tokens_completion: number | null;
+    tokens_total: number | null;
+    cost_estimate: number | null;
+    duration_seconds: number | null;
+    timestamp: string;
+    command_name?: string | null;
+    action?: string | null;
+    error_kind?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface TelemetryConfig {
+    localRecording: boolean;
+    remoteExport: boolean;
+    optOut: boolean;
+    strict: boolean;
+    [key: string]: unknown;
+}
+export declare class TelemetryClient {
+    private options;
+    constructor(options: {
+        baseUrl: string;
+        authToken?: string;
+    });
+    private request;
+    getSummary(params: {
+        workspaceId: string;
+        projectId?: string;
+        agentId?: string;
+        commandName?: string;
+        jobId?: string;
+        from?: string;
+        to?: string;
+        groupBy?: string[];
+    }): Promise<TokenUsageSummaryRow[]>;
+    getTokenUsage(params: {
+        workspaceId: string;
+        projectId?: string;
+        agentId?: string;
+        commandName?: string;
+        jobId?: string;
+        taskId?: string;
+        from?: string;
+        to?: string;
+        page?: number;
+        pageSize?: number;
+        sort?: string;
+    }): Promise<TokenUsageRow[]>;
+    getConfig(workspaceId: string): Promise<TelemetryConfig>;
+    optOut(workspaceId: string, strict?: boolean): Promise<TelemetryConfig>;
+    optIn(workspaceId: string): Promise<TelemetryConfig>;
+}
+//# sourceMappingURL=TelemetryClient.d.ts.map

package/dist/telemetry/TelemetryClient.d.ts.map

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

package/dist/telemetry/TelemetryClient.js

@@ -0,0 +1,80 @@
+export class TelemetryClient {
+    constructor(options) {
+        this.options = options;
+    }
+    async request(pathname, init) {
+        const url = new URL(pathname, this.options.baseUrl);
+        const headers = { "Content-Type": "application/json" };
+        if (this.options.authToken)
+            headers.authorization = `Bearer ${this.options.authToken}`;
+        const response = await fetch(url, { ...init, headers: { ...headers, ...init?.headers } });
+        if (!response.ok) {
+            throw new Error(`Telemetry request failed (${response.status}): ${await response.text()}`);
+        }
+        if (response.status === 204)
+            return undefined;
+        return (await response.json());
+    }
+    async getSummary(params) {
+        const search = new URLSearchParams();
+        search.set("workspace_id", params.workspaceId);
+        if (params.projectId)
+            search.set("project_id", params.projectId);
+        if (params.agentId)
+            search.set("agent_id", params.agentId);
+        if (params.commandName)
+            search.set("command_name", params.commandName);
+        if (params.jobId)
+            search.set("job_id", params.jobId);
+        if (params.from)
+            search.set("from", params.from);
+        if (params.to)
+            search.set("to", params.to);
+        if (params.groupBy && params.groupBy.length > 0) {
+            search.set("group_by", params.groupBy.join(","));
+        }
+        return this.request(`/telemetry/summary?${search.toString()}`);
+    }
+    async getTokenUsage(params) {
+        const search = new URLSearchParams();
+        search.set("workspace_id", params.workspaceId);
+        if (params.projectId)
+            search.set("project_id", params.projectId);
+        if (params.agentId)
+            search.set("agent_id", params.agentId);
+        if (params.commandName)
+            search.set("command_name", params.commandName);
+        if (params.jobId)
+            search.set("job_id", params.jobId);
+        if (params.taskId)
+            search.set("task_id", params.taskId);
+        if (params.from)
+            search.set("from", params.from);
+        if (params.to)
+            search.set("to", params.to);
+        if (params.page !== undefined)
+            search.set("page", String(params.page));
+        if (params.pageSize !== undefined)
+            search.set("page_size", String(params.pageSize));
+        if (params.sort)
+            search.set("sort", params.sort);
+        return this.request(`/telemetry/token-usage?${search.toString()}`);
+    }
+    async getConfig(workspaceId) {
+        const search = new URLSearchParams();
+        search.set("workspace_id", workspaceId);
+        return this.request(`/telemetry/config?${search.toString()}`);
+    }
+    async optOut(workspaceId, strict) {
+        return this.request(`/telemetry/opt-out`, {
+            method: "POST",
+            body: JSON.stringify({ workspace_id: workspaceId, strict: strict ?? false }),
+        });
+    }
+    async optIn(workspaceId) {
+        return this.request(`/telemetry/opt-in`, {
+            method: "POST",
+            body: JSON.stringify({ workspace_id: workspaceId }),
+        });
+    }
+}

package/dist/vcs/VcsClient.d.ts

@@ -0,0 +1,29 @@
+export declare class VcsClient {
+    private runGit;
+    private gitDirExists;
+    ensureRepo(cwd: string): Promise<void>;
+    hasRemote(cwd: string): Promise<boolean>;
+    currentBranch(cwd: string): Promise<string | null>;
+    branchExists(cwd: string, branch: string): Promise<boolean>;
+    private hasCommits;
+    private ensureMainBranch;
+    ensureBaseBranch(cwd: string, base: string): Promise<void>;
+    checkoutBranch(cwd: string, branch: string): Promise<void>;
+    createOrCheckoutBranch(cwd: string, branch: string, base: string): Promise<void>;
+    applyPatch(cwd: string, patch: string): Promise<void>;
+    stage(cwd: string, paths: string[]): Promise<void>;
+    commit(cwd: string, message: string, options?: {
+        noVerify?: boolean;
+        noGpgSign?: boolean;
+    }): Promise<void>;
+    merge(cwd: string, source: string, target: string, ensureClean?: boolean): Promise<void>;
+    push(cwd: string, remote: string, branch: string): Promise<void>;
+    pull(cwd: string, remote: string, branch: string, ffOnly?: boolean): Promise<void>;
+    status(cwd: string): Promise<string>;
+    dirtyPaths(cwd: string): Promise<string[]>;
+    conflictPaths(cwd: string): Promise<string[]>;
+    ensureClean(cwd: string, ignoreDotMcoda?: boolean): Promise<void>;
+    lastCommitSha(cwd: string): Promise<string>;
+    diff(cwd: string, base: string, head: string, paths?: string[]): Promise<string>;
+}
+//# sourceMappingURL=VcsClient.d.ts.map

package/dist/vcs/VcsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VcsClient.d.ts","sourceRoot":"","sources":["../../src/vcs/VcsClient.ts"],"names":[],"mappings":"AAQA,qBAAa,SAAS;YACN,MAAM;YAKN,YAAY;IASpB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASxC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASlD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YASnD,UAAU;YASV,gBAAgB;IAaxB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhF,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACxD,OAAO,CAAC,IAAI,CAAC;IAOV,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtF,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB1C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS7C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9D,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAQvF"}

package/dist/vcs/VcsClient.js

@@ -0,0 +1,201 @@
+import { exec as execCb, execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+import fs from "node:fs/promises";
+import path from "node:path";
+const exec = promisify(execCb);
+const execFile = promisify(execFileCb);
+export class VcsClient {
+    async runGit(cwd, args) {
+        const { stdout, stderr } = await execFile("git", args, { cwd });
+        return { stdout, stderr };
+    }
+    async gitDirExists(cwd) {
+        try {
+            await fs.access(path.join(cwd, ".git"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureRepo(cwd) {
+        if (await this.gitDirExists(cwd))
+            return;
+        await this.runGit(cwd, ["init"]);
+    }
+    async hasRemote(cwd) {
+        try {
+            const { stdout } = await this.runGit(cwd, ["remote"]);
+            return stdout.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async currentBranch(cwd) {
+        try {
+            const { stdout } = await this.runGit(cwd, ["rev-parse", "--abbrev-ref", "HEAD"]);
+            return stdout.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    async branchExists(cwd, branch) {
+        try {
+            await this.runGit(cwd, ["show-ref", "--verify", `refs/heads/${branch}`]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async hasCommits(cwd) {
+        try {
+            await this.runGit(cwd, ["rev-parse", "--verify", "HEAD"]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureMainBranch(cwd) {
+        await this.ensureRepo(cwd);
+        if (await this.branchExists(cwd, "main"))
+            return;
+        const hasHistory = await this.hasCommits(cwd);
+        if (!hasHistory) {
+            await this.runGit(cwd, ["checkout", "--orphan", "main"]);
+            await this.runGit(cwd, ["commit", "--allow-empty", "-m", "chore:init-repo"]);
+            return;
+        }
+        const current = (await this.currentBranch(cwd)) ?? "HEAD";
+        await this.runGit(cwd, ["checkout", "-b", "main", current]);
+    }
+    async ensureBaseBranch(cwd, base) {
+        await this.ensureMainBranch(cwd);
+        if (await this.branchExists(cwd, base))
+            return;
+        const hasHistory = await this.hasCommits(cwd);
+        const baseFrom = hasHistory
+            ? (await this.branchExists(cwd, "main")) ? "main" : (await this.currentBranch(cwd)) ?? "HEAD"
+            : undefined;
+        const args = ["checkout", "-b", base];
+        if (baseFrom)
+            args.push(baseFrom);
+        await this.runGit(cwd, args);
+    }
+    async checkoutBranch(cwd, branch) {
+        await this.runGit(cwd, ["checkout", branch]);
+    }
+    async createOrCheckoutBranch(cwd, branch, base) {
+        if (await this.branchExists(cwd, branch)) {
+            await this.checkoutBranch(cwd, branch);
+            return;
+        }
+        await this.runGit(cwd, ["checkout", "-b", branch, base]);
+    }
+    async applyPatch(cwd, patch) {
+        const opts = { cwd, shell: true };
+        const applyCmd = `cat <<'__PATCH__' | git apply --whitespace=nowarn\n${patch}\n__PATCH__`;
+        try {
+            await exec(applyCmd, opts);
+            return;
+        }
+        catch (error) {
+            // If the patch is already applied, a reverse --check succeeds; treat that as a no-op.
+            const reverseCheckCmd = `cat <<'__PATCH__' | git apply --reverse --check --whitespace=nowarn\n${patch}\n__PATCH__`;
+            try {
+                await exec(reverseCheckCmd, opts);
+                return;
+            }
+            catch {
+                throw error;
+            }
+        }
+    }
+    async stage(cwd, paths) {
+        await this.runGit(cwd, ["add", ...paths]);
+    }
+    async commit(cwd, message, options = {}) {
+        const args = ["commit", "-m", message];
+        if (options.noVerify)
+            args.push("--no-verify");
+        if (options.noGpgSign)
+            args.push("--no-gpg-sign");
+        await this.runGit(cwd, args);
+    }
+    async merge(cwd, source, target, ensureClean = false) {
+        await this.checkoutBranch(cwd, target);
+        if (ensureClean) {
+            await this.ensureClean(cwd);
+        }
+        await this.runGit(cwd, ["merge", "--no-edit", source]);
+    }
+    async push(cwd, remote, branch) {
+        await this.runGit(cwd, ["push", remote, branch]);
+    }
+    async pull(cwd, remote, branch, ffOnly = true) {
+        const args = ["pull"];
+        if (ffOnly)
+            args.push("--ff-only");
+        args.push(remote, branch);
+        await this.runGit(cwd, args);
+    }
+    async status(cwd) {
+        const { stdout } = await this.runGit(cwd, ["status", "--porcelain"]);
+        return stdout;
+    }
+    async dirtyPaths(cwd) {
+        // Use NUL-terminated porcelain to avoid quoting/escaping issues and to handle renames reliably.
+        // Format: `XY <path>\0` or for renames/copies: `XY <old>\0<new>\0`.
+        const { stdout } = await this.runGit(cwd, ["status", "--porcelain", "-z"]);
+        const entries = stdout.split("\0").filter(Boolean);
+        const paths = [];
+        for (let i = 0; i < entries.length; i += 1) {
+            const entry = entries[i];
+            if (entry.length < 4)
+                continue;
+            const x = entry[0];
+            const path1 = entry.slice(3);
+            if ((x === "R" || x === "C") && i + 1 < entries.length) {
+                const path2 = entries[i + 1];
+                if (path2)
+                    paths.push(path2);
+                i += 1;
+                continue;
+            }
+            if (path1)
+                paths.push(path1);
+        }
+        return paths;
+    }
+    async conflictPaths(cwd) {
+        try {
+            const { stdout } = await this.runGit(cwd, ["diff", "--name-only", "--diff-filter=U"]);
+            return stdout.split(/\r?\n/).filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    async ensureClean(cwd, ignoreDotMcoda = true) {
+        const dirty = await this.dirtyPaths(cwd);
+        const filtered = ignoreDotMcoda ? dirty.filter((p) => !p.startsWith(".mcoda")) : dirty;
+        if (filtered.length) {
+            throw new Error(`Working tree dirty: ${filtered.join(", ")}`);
+        }
+    }
+    async lastCommitSha(cwd) {
+        const { stdout } = await this.runGit(cwd, ["rev-parse", "HEAD"]);
+        return stdout.trim();
+    }
+    async diff(cwd, base, head, paths) {
+        const args = ["diff", `${base}...${head}`];
+        if (paths && paths.length) {
+            args.push("--", ...paths);
+        }
+        const { stdout } = await this.runGit(cwd, args);
+        return stdout;
+    }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@mcoda/integrations",
+  "version": "0.1.4",
+  "description": "External integrations for mcoda (vcs, QA, telemetry).",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./qa/*": "./dist/qa/*",
+    "./docdex/*": "./dist/docdex/*",
+    "./vcs/*": "./dist/vcs/*",
+    "./telemetry/*": "./dist/telemetry/*"
+  },
+  "files": [
+    "dist",
+    "!dist/**/__tests__/**",
+    "!dist/**/*.test.*",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "echo \"lint not configured\"",
+    "test": "pnpm run build && node ../../scripts/run-node-tests.js dist"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bekirdag/mcoda.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bekirdag/mcoda/issues"
+  },
+  "homepage": "https://github.com/bekirdag/mcoda#readme",
+  "license": "MIT",
+  "author": "bekir dag",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mcoda/shared": "workspace:*"
+  }
+}