v3.1.0 — Phase 2: Trust

[Jovancoding]

Phase 2 — Trust

This release hardens Network-AI with five production-grade improvements focused on reliability, observability, and developer experience.

What's New

Structured Logging — Replace all raw console.* calls with a leveled, transport-pluggable logger (lib/logger.ts). Supports DEBUG, INFO, WARN, ERROR, and SILENT levels with module-scoped instances.

Typed Error Hierarchy — 10 purpose-built error classes (lib/errors.ts) extending a common NetworkAIError base, enabling precise catch blocks:
ValidationError, LockAcquisitionError, ConflictError, TimeoutError, IdentityVerificationError, NamespaceViolationError, AdapterAlreadyRegisteredError, AdapterNotFoundError, AdapterNotInitializedError, ParallelLimitError

API Input Validation — All 20 public entry points now validate arguments at the boundary and throw ValidationError with clear messages before any side effects.

JSDoc on All Exports — Every exported class, interface, type, and method now carries full JSDoc with @param, @returns, @throws, and @example blocks.

Unified Lock + Audit Metadata — LockedBlackboard optionally accepts a SecureAuditLogger, automatically recording lock holder, duration, version, and outcome on every write and delete.

Stats

• 13 files changed — +1,095 / −182 lines
• 251 tests passing (79 core + 33 security + 139 adapter)
• Zero compile errors

Install

npm install network-ai@3.1.0

<hr /><em>This discussion was created from the release <a href='https://github.com/jovanSAPFIONEER/Network-AI/releases/tag/v3.1.0'>v3.1.0 — Phase 2: Trust</a>.</em>