@mcoda/integrations

@mcoda/integrations

External integrations for mcoda (docdex, telemetry, VCS, QA runners, update checks).

Install

• Requires Node.js >= 20.
• Install: npm i @mcoda/integrations

What it provides

• DocdexClient for docdex daemon queries and CLI-backed ingestion.
• TelemetryClient for token usage reporting.
• VcsClient for Git operations.
• SystemClient for update checks.
• QA adapters (Chromium, Maestro, CLI) and types.

Example

import { DocdexClient } from "@mcoda/integrations";

const client = new DocdexClient({
  workspaceRoot: process.cwd(),
  baseUrl: process.env.MCODA_DOCDEX_URL,
});

const docs = await client.search({ docType: "rfp", query: "payments" });

Notes

• Docdex state lives under ~/.docdex (managed by the docdex CLI); mcoda does not create repo-local .docdex.
• Chromium QA expects Docdex-installed Chromium (docdex setup or MCODA_QA_CHROMIUM_PATH).
• Some integrations call external services; configure base URLs and tokens as needed.
• Primarily used by the mcoda CLI; APIs may evolve.

License

MIT - see LICENSE.