Skip to content
ContractSpec
Start here

Package manual · platform

·Governance, decisions and approvals

module.governance-suite

Governance and audit suite — policy editor, audit trail, and compliance surfaces for the Agent + Workflow pillar

platformmodulev2.0.5experimentalservernode
@lssm-tech/module.governance-suite
bun add @lssm-tech/module.governance-suite
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Website: https://contractspec.io

Governance + Audit suite for the Agent + Workflow pillar — policy editor, constraint management, audit-trail inspection, and evidence attachment.

What It Provides

  • Layer: module.
  • Consumers: @lssm-tech/bundle.managed-companyos, the web-application-monolith /governance/** + /audit/** routes, and future native shells via shared view-models.
  • src/core/ — policy simulators, constraint reducers, audit-event projectors, evidence-attachment workflows.
  • src/presentation/ — promoted screens (GovernanceScreen, AuditTrailScreen, PolicyEditor, AuditEventDetail).
  • src/data-views/ — data-view specs for tables and detail panels.

Installation

npm install @lssm-tech/module.governance-suite

or

bun add @lssm-tech/module.governance-suite

Usage

Import the root entrypoint from @lssm-tech/module.governance-suite, or choose a documented subpath when you only need one slice of the surface.

Architecture

  • src/governance-suite.capability.ts — capability declaration.
  • src/governance-suite.feature.ts — feature manifest listing the 10 governance/audit operations the module owns.
  • src/core/ — domain logic.
  • src/presentation/ — UI (design-system-first).
  • src/data-views/ — data-view specs.
  • src/index.ts — public barrel.

Public Entry Points

  • . → ./src/index.ts
  • ./governance-suite.capability → ./src/governance-suite.capability.ts
  • ./governance-suite.feature → ./src/governance-suite.feature.ts
  • ./core → ./src/core/index.ts
  • ./presentation → ./src/presentation/index.ts
  • ./data-views → ./src/data-views/index.ts

Notes

  • Audit records are append-only; mutations and deletions break compliance invariants. Corrections are compensating events.
  • Auditor persona sees every action with disabled + tooltip, never silent capability strip.
  • Design-system primitives first; fallbacks marked // DS-FALLBACK:.

Transactional side effects use the generic @lssm-tech/lib.jobs/outbox/types port. The host supplies its transaction and persistent store; approval, policy, audit and caller-context behavior remain unchanged. Tests use the Jobs in-memory reference adapter rather than a Company runtime dependency.

Relationships

THIS PACKAGEmodule.governance-suite84 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

11 declarations

Declared capabilities

Module Governance Suite

Governance and audit suite — policy editor, audit trail, and compliance surfaces for the Agent + Workflow pillar

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit