lib.evolution
AI-powered contract evolution engine
@lssm-tech/lib.evolutionbun add @lssm-tech/lib.evolutionManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
AI-powered contract evolution engine.
What It Provides
- Layer: lib.
- Consumers: example-shared-ui, bundles.
- Key dependencies: ai-agent, contracts-spec, lifecycle, observability, schema.
- Related ContractSpec packages include
@lssm-tech/lib.ai-agent,@lssm-tech/lib.ai-providers,@lssm-tech/lib.contracts-integrations,@lssm-tech/lib.contracts-spec,@lssm-tech/lib.lifecycle,@lssm-tech/lib.observability, ...
Installation
npm install @lssm-tech/lib.evolution
or
bun add @lssm-tech/lib.evolution
Usage
Import the root entrypoint from @lssm-tech/lib.evolution, or choose a documented subpath when you only need one part of the package surface.
The root entrypoint includes the pure Company Intelligence governed-learning reducer, G01–G25 evaluation, deterministic comparison, rollback, and exact ordered replay. Callers inject time/deadline values and persist returned decisions separately. The module performs no provider, network, database, filesystem, Git, export, activation, or self-application action. The legacy canPromoteAiImprovement helper is not S9 promotion authority.
Architecture
src/analyzeris part of the package's public or composition surface.src/approvalis part of the package's public or composition surface.src/generatoris part of the package's public or composition surface.src/index.tsis the root public barrel and package entrypoint.src/types.tsis shared public type definitions.
Public Entry Points
- Export
.resolves through./src/index.ts.
Local Commands
bun run dev— contractspec-bun-build devbun run build— contractspec-bun-build buildbun run test— bun test --pass-with-no-testsbun run test:company-intelligence— deterministic governed-learning golden or unsafe corpusbun run lint— bun lint:fixbun run lint:check— biome check .bun run lint:fix— biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .bun run typecheck— tsgo --noEmitbun run publish:pkg— bun publish --tolerate-republish --ignore-scripts --verbosebun run publish:pkg:canary— bun publish:pkg --tag canarybun run clean— rimraf dist .turbobun run build:bundle— contractspec-bun-build transpilebun run build:types— contractspec-bun-build typesbun run prebuild— contractspec-bun-build prebuild
Recent Updates
- Replace eslint+prettier by biomejs to optimize speed.
- Add changesets and apply pending fixes.
- Resolve lint, build, and type errors across nine packages.
- Add AI provider ranking system with ranking-driven model selection.
Notes
- Evolution strategies affect contract migration paths; changes can break existing migrations.
- Depends on multiple core libs — verify compatibility when updating any dependency.
- Strategy selection logic must remain deterministic and auditable.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
12 declarations
@lssm-tech/lib.ai-agentworkspace:^
Read the package manual ↗@lssm-tech/lib.ai-providersworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-integrationsworkspace:^
Read the package manual ↗@lssm-tech/lib.orchestration-specworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗@lssm-tech/lib.companyos-specworkspace:^
Read the package manual ↗
Declared capabilities
AI-powered contract evolution engine
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun test --pass-with-no-teststest:company-intelligencebun test testdata/company-intelligence/promotion/governed-learning.test.tsprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit