@multisystemsuite/engineering-governance

Publishable npm package — CLI and programmatic API for engineering governance analysis.

Install

npm install @multisystemsuite/engineering-governance
# or
pnpm add @multisystemsuite/engineering-governance

CLI

# Analyze project
engineering-governance analyze [path] [options]
eg analyze ./my-app --format json -o report.json

# Options
#   -f, --format <format>    json | csv | markdown  (default: json)
#   -o, --output <file>      Write report to file
#   -m, --modules <list>     Comma-separated module names

# Generate CI config
engineering-governance ci --provider github-actions -o .github/workflows/governance.yml

Exit code: 1 when overall health score is below 50 (useful for CI gates).

Programmatic API

import { analyzeProject, exportReport } from '@multisystemsuite/engineering-governance';

const { results, metrics } = await analyzeProject('./my-project', {
  modules: ['technical-debt', 'security', 'architecture'],
});

console.log(metrics.overallHealthScore);
await exportReport(results, 'markdown');

Re-exports

All analyzers and governance modules are re-exported from this package. See root README.

Scripts

pnpm --filter @multisystemsuite/engineering-governance build

Publishing

pnpm changeset:patch
pnpm version:packages
pnpm publish:packages

Related

• Analyzers
• Governance
• Root README