{"id":"@lssm-tech/lib.evolution","slug":"lib.evolution","name":"@lssm-tech/lib.evolution","version":"5.0.5","path":"packages/domains/builder/evolution","manifestPath":"packages/domains/builder/evolution/package.json","manifestBlobSha":"02fd3a7098c2f13607dda0ed4de0aad877345d31","layer":"domains","physicalArea":"builder","primaryArea":"delivery-and-infrastructure","classification":{"privateDeclared":null,"catalogFamily":"sharedLibs","catalogKind":"library","catalogStatus":"active","adoptionMode":"adoptable","stability":"stable"},"description":"AI-powered contract evolution engine","descriptionOrigin":"package.json","catalog":{"family":"sharedLibs","kind":"library","status":"active","adoptionMode":"adoptable","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":["."],"documentation":[{"title":"Lib Evolution documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.evolution","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.lib.evolution","title":"Lib Evolution","description":"AI-powered contract evolution engine","status":"active","useCases":["Adopt ai-powered contract evolution engine"],"aliases":["contractspec","evolution","ai","automation","typescript","lib"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/lib.evolution","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/lib.evolution package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}]},"canonicalImports":[{"capabilityId":"package.lssm.tech.lib.evolution","from":"@lssm-tech/lib.evolution","symbols":[]}],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","dev":"contractspec-bun-build dev","clean":"rimraf dist .turbo","lint":"bun lint:fix","lint:fix":"node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .","lint:check":"node ../../../../scripts/biome.cjs check .","test":"bun test --pass-with-no-tests","test:company-intelligence":"bun test testdata/company-intelligence/promotion/governed-learning.test.ts","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.ai-agent":"workspace:^","@lssm-tech/lib.ai-providers":"workspace:^","@lssm-tech/lib.contracts-integrations":"workspace:^","@lssm-tech/lib.orchestration-spec":"workspace:^","@lssm-tech/lib.contracts-spec-core":"workspace:^","@lssm-tech/lib.companyos-spec":"workspace:^","@lssm-tech/lib.crypto-utils":"workspace:^","@lssm-tech/lib.lifecycle":"workspace:^","@lssm-tech/lib.observability":"workspace:^","@lssm-tech/lib.schema":"workspace:^","ai":"catalog:ai","zod":"catalog:"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:","@lssm-tech/tool.bun":"workspace:*"},"peerDependencies":{"@prisma/client":"7.10.0"},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/lib.evolution","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/domains/builder/evolution/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/evolution/src/index.ts","sourceStatus":"verified source file"}]}],"entryCount":1,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Lib Evolution documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.evolution","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/evolution","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/evolution/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/evolution/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.evolution.txt"},"readme":{"status":"available","body":"# @lssm-tech/lib.evolution\n\nWebsite: https://contractspec.io\n\n**AI-powered contract evolution engine.**\n\n## What It Provides\n\n- **Layer**: lib.\n- **Consumers**: example-shared-ui, bundles.\n- **Key dependencies**: ai-agent, contracts-spec, lifecycle, observability, schema.\n- 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`, ...\n\n## Installation\n\n`npm install @lssm-tech/lib.evolution`\n\nor\n\n`bun add @lssm-tech/lib.evolution`\n\n## Usage\n\nImport the root entrypoint from `@lssm-tech/lib.evolution`, or choose a documented subpath when you only need one part of the package surface.\n\nThe root entrypoint includes the pure Company Intelligence governed-learning\nreducer, G01–G25 evaluation, deterministic comparison, rollback, and exact\nordered replay. Callers inject time/deadline values and persist returned\ndecisions separately. The module performs no provider, network, database,\nfilesystem, Git, export, activation, or self-application action. The legacy\n`canPromoteAiImprovement` helper is not S9 promotion authority.\n\n## Architecture\n\n- `src/analyzer` is part of the package's public or composition surface.\n- `src/approval` is part of the package's public or composition surface.\n- `src/generator` is part of the package's public or composition surface.\n- `src/index.ts` is the root public barrel and package entrypoint.\n- `src/types.ts` is shared public type definitions.\n\n## Public Entry Points\n\n- Export `.` resolves through `./src/index.ts`.\n\n## Local Commands\n\n- `bun run dev` — contractspec-bun-build dev\n- `bun run build` — contractspec-bun-build build\n- `bun run test` — bun test --pass-with-no-tests\n- `bun run test:company-intelligence` — deterministic governed-learning golden or unsafe corpus\n- `bun run lint` — bun lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run typecheck` — tsgo --noEmit\n- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose\n- `bun run publish:pkg:canary` — bun publish:pkg --tag canary\n- `bun run clean` — rimraf dist .turbo\n- `bun run build:bundle` — contractspec-bun-build transpile\n- `bun run build:types` — contractspec-bun-build types\n- `bun run prebuild` — contractspec-bun-build prebuild\n\n## Recent Updates\n\n- Replace eslint+prettier by biomejs to optimize speed.\n- Add changesets and apply pending fixes.\n- Resolve lint, build, and type errors across nine packages.\n- Add AI provider ranking system with ranking-driven model selection.\n\n## Notes\n\n- Evolution strategies affect contract migration paths; changes can break existing migrations.\n- Depends on multiple core libs — verify compatibility when updating any dependency.\n- Strategy selection logic must remain deterministic and auditable.\n","sourcePath":"packages/domains/builder/evolution/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/evolution/README.md","blobSha":"2b55191778cd92a5022a09a0bcb26e557fd6eb10","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"delivery-and-infrastructure","areaTitle":"Delivery, infrastructure and runtime operations","displayName":"lib.evolution","runtimes":["node"],"platforms":["server"],"kind":"library","scope":"Package manifest","canonicalRoute":"/docs/packages/lib.evolution/","contextUrl":"/docs/packages/lib.evolution.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}