Architecture review you can automate.

Install the package in a server-rendered Node.js application. The default provider requires an API key or a custom provider implementation.

npm install @arcinfra/sdk

Review a repository with operational context, then score the structured result.

import "dotenv/config";
import { Arc } from "@arcinfra/sdk";

const arc = new Arc({
  provider: "openai",
  apiKey: process.env.OPENAI_API_KEY,
});

const review = await arc.architecture.review({
  repository: process.cwd(),
  context: {
    productionTrafficRps: 2_500,
    availabilityTarget: "99.95%",
    constraints: ["SOC 2", "zero-downtime deployments"],
  },
});

console.log(review.summary);
console.table(arc.architecture.score(review));

ARC separates deterministic analysis from provider-backed reasoning. Local rules stay fast and repeatable; deeper reviews remain structured and schema-validated.

Review one source or combine multiple signals for a richer understanding of the production system.

OpenAI is the default. Select a provider explicitly for xAI, Gemini, or Claude, or implement AIProvider for an internal gateway.

Use validateArchitecture() for repeatable operational and design controls without credentials. Deterministic utilities can be imported directly without constructing an ARC client.

Scoring is deterministic and normalized across eight dimensions. Use it to establish a baseline, compare revisions, and expose where a high overall number may hide a weak subsystem.

const review = await arc.architecture.review(input);
const score = arc.architecture.score(review);

console.table(score.dimensions);
console.log(score.overall);

Diagram generation is deterministic and never sends the design to a provider. Choose Mermaid text or a JSON graph.

A review is the starting point. Use ARC to test alternatives, produce targeted improvements, and translate the same system for different audiences.

const comparison = await arc.architecture.compare({
  left: currentReview,
  right: proposedReview,
  context: "Choose the safer migration path",
});

const optimized = await arc.architecture.optimize({
  review: currentReview,
  priorities: ["security", "deployment", "cost"],
});

const executiveBrief = await arc.architecture.explain({
  review: optimized,
  audience: "executive",
});

ARC exposes a typed error hierarchy so applications can distinguish configuration, schema, authentication, rate-limit, timeout, and provider failures.