{"id":"@lssm-tech/lib.opportunity-runtime","slug":"lib.opportunity-runtime","name":"@lssm-tech/lib.opportunity-runtime","version":"2.0.4","path":"packages/domains/opportunity/runtime","manifestPath":"packages/domains/opportunity/runtime/package.json","manifestBlobSha":"74e98a92356964a75b936b448360a51298561310","layer":"domains","physicalArea":"opportunity","primaryArea":"intelligence-and-research","classification":{"privateDeclared":null,"catalogFamily":"runtime","catalogKind":"library","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Pure deterministic scoring, gate, simulation, and portfolio projections for autonomous-company opportunities.","descriptionOrigin":"package.json","catalog":{"family":"runtime","kind":"library","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./gates","./portfolio","./scoring","./discovery","./economics"],"documentation":[{"title":"Lib Opportunity Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.opportunity-runtime","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.lib.opportunity.runtime","title":"Lib Opportunity Runtime","description":"Pure deterministic scoring, gate, simulation, and portfolio projections for autonomous-company opportunities.","status":"active","useCases":["Adopt pure deterministic scoring, gate, simulation, and portfolio projections for autonomous-company opportunities"],"aliases":["lib","opportunity","runtime"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/lib.opportunity-runtime","symbols":[]},{"from":"@lssm-tech/lib.opportunity-runtime/gates","symbols":[]},{"from":"@lssm-tech/lib.opportunity-runtime/portfolio","symbols":[]},{"from":"@lssm-tech/lib.opportunity-runtime/scoring","symbols":[]},{"from":"@lssm-tech/lib.opportunity-runtime/discovery","symbols":[]},{"from":"@lssm-tech/lib.opportunity-runtime/economics","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/lib.opportunity-runtime package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}]},"canonicalImports":[{"capabilityId":"package.lssm.tech.lib.opportunity.runtime","from":"@lssm-tech/lib.opportunity-runtime","symbols":[]},{"capabilityId":"package.lssm.tech.lib.opportunity.runtime","from":"@lssm-tech/lib.opportunity-runtime/gates","symbols":[]},{"capabilityId":"package.lssm.tech.lib.opportunity.runtime","from":"@lssm-tech/lib.opportunity-runtime/portfolio","symbols":[]},{"capabilityId":"package.lssm.tech.lib.opportunity.runtime","from":"@lssm-tech/lib.opportunity-runtime/scoring","symbols":[]},{"capabilityId":"package.lssm.tech.lib.opportunity.runtime","from":"@lssm-tech/lib.opportunity-runtime/discovery","symbols":[]},{"capabilityId":"package.lssm.tech.lib.opportunity.runtime","from":"@lssm-tech/lib.opportunity-runtime/economics","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 .","lint:check":"node ../../../../scripts/biome.cjs check .","test":"bun test","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.opportunity-spec":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./discovery":"./src/discovery.ts","./economics":"./src/economics.ts","./economics-acquisition":"./src/economics-acquisition.ts","./economics-capacity":"./src/economics-capacity.ts","./economics-costs":"./src/economics-costs.ts","./economics-retention":"./src/economics-retention.ts","./economics-values":"./src/economics-values.ts","./gates":"./src/gates.ts","./portfolio":"./src/portfolio.ts","./scoring":"./src/scoring.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./discovery":{"types":"./dist/discovery.d.ts","browser":"./dist/browser/discovery.js","bun":"./dist/discovery.js","node":"./dist/node/discovery.js","default":"./dist/discovery.js"},"./economics":{"types":"./dist/economics.d.ts","browser":"./dist/browser/economics.js","bun":"./dist/economics.js","node":"./dist/node/economics.js","default":"./dist/economics.js"},"./economics-acquisition":{"types":"./dist/economics-acquisition.d.ts","browser":"./dist/browser/economics-acquisition.js","bun":"./dist/economics-acquisition.js","node":"./dist/node/economics-acquisition.js","default":"./dist/economics-acquisition.js"},"./economics-capacity":{"types":"./dist/economics-capacity.d.ts","browser":"./dist/browser/economics-capacity.js","bun":"./dist/economics-capacity.js","node":"./dist/node/economics-capacity.js","default":"./dist/economics-capacity.js"},"./economics-costs":{"types":"./dist/economics-costs.d.ts","browser":"./dist/browser/economics-costs.js","bun":"./dist/economics-costs.js","node":"./dist/node/economics-costs.js","default":"./dist/economics-costs.js"},"./economics-retention":{"types":"./dist/economics-retention.d.ts","browser":"./dist/browser/economics-retention.js","bun":"./dist/economics-retention.js","node":"./dist/node/economics-retention.js","default":"./dist/economics-retention.js"},"./economics-values":{"types":"./dist/economics-values.d.ts","browser":"./dist/browser/economics-values.js","bun":"./dist/economics-values.js","node":"./dist/node/economics-values.js","default":"./dist/economics-values.js"},"./gates":{"types":"./dist/gates.d.ts","browser":"./dist/browser/gates.js","bun":"./dist/gates.js","node":"./dist/node/gates.js","default":"./dist/gates.js"},"./portfolio":{"types":"./dist/portfolio.d.ts","browser":"./dist/browser/portfolio.js","bun":"./dist/portfolio.js","node":"./dist/node/portfolio.js","default":"./dist/portfolio.js"},"./scoring":{"types":"./dist/scoring.d.ts","browser":"./dist/browser/scoring.js","bun":"./dist/scoring.js","node":"./dist/node/scoring.js","default":"./dist/scoring.js"}},"types":"./dist/index.d.ts","files":["dist","README.md","AGENTS.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/lib.opportunity-runtime","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/domains/opportunity/runtime/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./discovery","importPath":"@lssm-tech/lib.opportunity-runtime/discovery","target":"./src/discovery.ts","targets":[{"conditions":[],"target":"./src/discovery.ts","sourcePath":"packages/domains/opportunity/runtime/src/discovery.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/discovery.ts","sourceStatus":"verified source file"}]},{"subpath":"./economics","importPath":"@lssm-tech/lib.opportunity-runtime/economics","target":"./src/economics.ts","targets":[{"conditions":[],"target":"./src/economics.ts","sourcePath":"packages/domains/opportunity/runtime/src/economics.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/economics.ts","sourceStatus":"verified source file"}]},{"subpath":"./economics-acquisition","importPath":"@lssm-tech/lib.opportunity-runtime/economics-acquisition","target":"./src/economics-acquisition.ts","targets":[{"conditions":[],"target":"./src/economics-acquisition.ts","sourcePath":"packages/domains/opportunity/runtime/src/economics-acquisition.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/economics-acquisition.ts","sourceStatus":"verified source file"}]},{"subpath":"./economics-capacity","importPath":"@lssm-tech/lib.opportunity-runtime/economics-capacity","target":"./src/economics-capacity.ts","targets":[{"conditions":[],"target":"./src/economics-capacity.ts","sourcePath":"packages/domains/opportunity/runtime/src/economics-capacity.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/economics-capacity.ts","sourceStatus":"verified source file"}]},{"subpath":"./economics-costs","importPath":"@lssm-tech/lib.opportunity-runtime/economics-costs","target":"./src/economics-costs.ts","targets":[{"conditions":[],"target":"./src/economics-costs.ts","sourcePath":"packages/domains/opportunity/runtime/src/economics-costs.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/economics-costs.ts","sourceStatus":"verified source file"}]},{"subpath":"./economics-retention","importPath":"@lssm-tech/lib.opportunity-runtime/economics-retention","target":"./src/economics-retention.ts","targets":[{"conditions":[],"target":"./src/economics-retention.ts","sourcePath":"packages/domains/opportunity/runtime/src/economics-retention.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/economics-retention.ts","sourceStatus":"verified source file"}]},{"subpath":"./economics-values","importPath":"@lssm-tech/lib.opportunity-runtime/economics-values","target":"./src/economics-values.ts","targets":[{"conditions":[],"target":"./src/economics-values.ts","sourcePath":"packages/domains/opportunity/runtime/src/economics-values.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/economics-values.ts","sourceStatus":"verified source file"}]},{"subpath":"./gates","importPath":"@lssm-tech/lib.opportunity-runtime/gates","target":"./src/gates.ts","targets":[{"conditions":[],"target":"./src/gates.ts","sourcePath":"packages/domains/opportunity/runtime/src/gates.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/gates.ts","sourceStatus":"verified source file"}]},{"subpath":"./portfolio","importPath":"@lssm-tech/lib.opportunity-runtime/portfolio","target":"./src/portfolio.ts","targets":[{"conditions":[],"target":"./src/portfolio.ts","sourcePath":"packages/domains/opportunity/runtime/src/portfolio.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/portfolio.ts","sourceStatus":"verified source file"}]},{"subpath":"./scoring","importPath":"@lssm-tech/lib.opportunity-runtime/scoring","target":"./src/scoring.ts","targets":[{"conditions":[],"target":"./src/scoring.ts","sourcePath":"packages/domains/opportunity/runtime/src/scoring.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/src/scoring.ts","sourceStatus":"verified source file"}]}],"entryCount":11,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Lib Opportunity Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.opportunity-runtime","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.opportunity-runtime.txt"},"readme":{"status":"available","body":"# `@lssm-tech/lib.opportunity-runtime`\n\nPure deterministic scoring, gate, simulation, and portfolio projections for autonomous-company opportunities.\n\nThis package consumes `@lssm-tech/lib.opportunity-spec` contracts and provides input-only helpers for normalizing scorecards, computing weighted scores, projecting verdicts, summarizing simulation bottlenecks, and ranking portfolios.\n\n## Scope\n\nUse this package to:\n\n- normalize `0..5` scores to `0..100`;\n- verify the canonical opportunity score weights sum to `100%`;\n- compute weighted opportunity scores;\n- apply hard-gate and evidence-threshold verdict overrides;\n- summarize autonomous-operation simulation bottlenecks;\n- produce deterministic portfolio selections with explainable reasons.\n\n## Boundary\n\nThis runtime is side-effect-free. It does not fetch research, synthesize claims with LLMs, call providers, persist data, mutate files, create CompanyOS/Builder workflows, contact customers, or execute production actions. It only projects over caller-provided spec objects.\n\n## Public entrypoints\n\n- `@lssm-tech/lib.opportunity-runtime` — root barrel\n- `@lssm-tech/lib.opportunity-runtime/scoring` — normalization and weighted scoring helpers\n- `@lssm-tech/lib.opportunity-runtime/gates` — verdict and bottleneck projections\n- `@lssm-tech/lib.opportunity-runtime/portfolio` — deterministic portfolio ranking\n\n## Distribution-first discovery (additive, experimental)\n\nThe `./discovery` entrypoint screens captured draft records with supplied catalog\nIDs, profile and as-of date. `selfserve-first@1.0.0` applies prerequisite gates\nbefore ranking; unavailable dimensions retain null subtotals. Product\nattractiveness, distribution feasibility, evidence strength and experiment\npriority remain separate. Families are consolidated before selection, and empty\nor all-blocked draft inputs return an empty shortlist with explanations.\n\n`SALES_ASSISTED_DISCOVERY_PROFILE` (`sales-assisted@1.0.0`) screens 1.1.0 waves\nwith the same ranking recipe; it scores `assisted_conversion` in place of\n`selfserve_adoption`. `discoveryProfileById` returns either profile. Planned sales\nminutes stay assumptions until an observed metric replaces them.\n\nThe mature `rankOpportunityPortfolio` API remains unchanged: it throws on empty\ninput and can return a blocked primary when no candidate is viable. New discovery\ncallers must use the empty-safe draft result rather than interpreting that legacy\nbehavior as eligibility.\n\nThe `./economics` entrypoint supplies scoped acquisition, contribution, funnel,\nreferral, sponsor/marketplace, cohort and payback projections. Unknown inputs never\nbecome zero; scenario estimates and editorial priors never become customer\nmeasurements. Cost allocation must count salaries, discounts, rewards and seed\nacquisition once. Finite horizons and payer-aware denominators prevent inferred\nrenewals, infinite lifetime value and beneficiary-to-paying-customer confusion.\n\nGeneration, research, catalog/file access and exports belong to the local runner,\nnot these helpers. No provider or customer-facing action is performed here.\n\n## Package verification\n\n- `bun run test`\n- `bun run typecheck`\n- `bun run lint:check`\n- `bun run build`\n","sourcePath":"packages/domains/opportunity/runtime/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/runtime/README.md","blobSha":"486353a2f64ee94ad6aa6a26401526edb2f6a967","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":"intelligence-and-research","areaTitle":"Intelligence, research and applications","displayName":"lib.opportunity-runtime","runtimes":["node"],"platforms":["server"],"kind":"library","scope":"Package manifest","canonicalRoute":"/docs/packages/lib.opportunity-runtime/","contextUrl":"/docs/packages/lib.opportunity-runtime.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}