# @aibvf/core

> AI BVF: deterministic AI investment assessment with disclosed assumptions and work design checks.

Latest version **0.10.6** (published 2026-10-03) · MIT license · 0 weekly downloads

## Install

```sh
npm install @aibvf/core
pnpm add @aibvf/core
yarn add @aibvf/core
bun add @aibvf/core
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.10.6 |
| Published | 2026-10-03 |
| First published | 2026-04-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 358.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 0 |
| Author | Craig Horton |
| Maintainers | bvf123 |
| Keywords | ai, bvf, ai-governance, enterprise-ai, ai-scoring, ai-roi, eu-ai-act, standards |

## Links

- npm: https://www.npmjs.com/package/@aibvf/core
- Repository: https://github.com/Craig-Horton/ai-bvf
- Homepage: https://www.aibvf.com/protocol
- Issues: https://github.com/Craig-Horton/ai-bvf/issues
- npm.io page: https://npm.io/package/@aibvf/core

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 0.10.6 (latest) — 2026-10-03
- 0.10.5 — 2026-09-21
- 0.10.4 — 2026-08-23
- 0.10.3 — 2026-08-23
- 0.10.2 — 2026-08-23
- 0.10.1 — 2026-08-23
- 0.10.0 — 2026-08-01
- 0.9.0 — 2026-07-22
- 0.8.1 — 2026-07-08
- 0.8.0 — 2026-07-08
- 0.7.1 — 2026-07-06
- 0.7.0 — 2026-07-05
- 0.6.0 — 2026-07-05
- 0.5.0 — 2026-07-05
- 0.4.0 — 2026-07-05
- … 8 more at https://npm.io/package/@aibvf/core/versions

## README

# @aibvf/core

Deterministic AI investment assessment with disclosed assumptions, evidence gaps and work design checks. The public portfolio format is version 1.0.

> **Source:** [github.com/Craig-Horton/ai-bvf](https://github.com/Craig-Horton/ai-bvf) · [Try an assessment](https://www.aibvf.com/start) · [Issues](https://github.com/Craig-Horton/ai-bvf/issues) · Built by [Craig Horton Advisory](https://craighortonadvisory.com)

```bash
npm install @aibvf/core
```

## Validate a portfolio

```ts
import { validate } from '@aibvf/core';

const result = validate(portfolioJson);
if (!result.valid) console.error(result.errors);
```

## Score an initiative

```ts
import { score } from '@aibvf/core';

const r = score({
  industry: 'manufacturing',
  revenue_eur: 2_400_000_000,
  function: 'supply',
  ai_tier: 'gen2',
  readiness: 'traditional',
  scores: {
    strategic_alignment: 72,
    financial_return: 64,
    change_enablement: 48,
    governance_risk: 35,
  },
  work_architecture: {
    workflow_redesigned: true,
    roles_redesigned: false,
    decision_rights_defined: true,
    measures_updated: false,
  },
});

console.log(r.classification);   // 'Fix'
console.log(r.work_architecture.gaps); // roles and measures still need redesign
console.log(r.net_low_eur);      // ~75.6M
console.log(r.net_high_eur);     // ~247M
```

The work architecture fields are optional inputs and accept only evidence the organisation has. An explicit `false` value or an omitted check holds an otherwise green initiative at Fix, while the response names each gap or unknown and returns the next question to ask. Accelerate requires all four checks to be evidenced as complete.

## Reading the result

The fields `net_low_eur` and `net_high_eur` are readiness-adjusted benefit scenarios before project build, operating and change costs. They require a separate costed business case.

The `confidence` field is a heuristic score derived from pillar inputs and input completeness, with no calibrated probability interpretation. Sector labels in `applied_modules` identify model context and do not certify regulatory compliance.

[Formulas and assumptions](https://github.com/Craig-Horton/ai-bvf/blob/main/docs/scoring-formulas.md) · [Reproducible example](https://github.com/Craig-Horton/ai-bvf/blob/main/docs/worked-example.md)

## Spec

Full specification at [www.aibvf.com/protocol](https://www.aibvf.com/protocol).
JSON Schema at [www.aibvf.com/bvf-protocol.schema.json](https://www.aibvf.com/bvf-protocol.schema.json).

## License

MIT. The underlying specification is CC-BY-4.0.

---
_Source: https://npm.io/package/@aibvf/core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._