@lssm/lib.opportunity-spec

Provider-neutral opportunity scoring and selection contracts for autonomous-company candidates.

This package closes the first canonical ContractSpec slice for the Autonomous Company Opportunity Engine. It defines reviewable candidate, scorecard, evidence, gate, validation, simulation, portfolio, and handoff contracts; it does not research markets, call providers, mutate CompanyOS/Builder state, or approve production implementation.

Scope

Use this package to model:

• autonomous-company opportunity candidates;
• core scorecards: AFS, BVS, GFS, CES, DMS, RTS, RCS, SFS, and TMS;
• diagnostic scores: QAS, DRS, TVS, VCS, and OTS;
• per-score and per-estimate evidence claims from hypothesis to live customer metrics;
• hard kill gates, downgrade gates, HITL load, GTM/CAC/budget assumptions, validation experiments, simulations, and portfolio decisions;
• branded refs to CompanyOS, Builder, ProductIntent, growth, finance, assurance, and orchestration surfaces.

Boundary

This package is contract-only. It must not contain provider credentials, network calls, filesystem mutation, live research, customer-facing sends, production workflow creation, or module imports. High opportunity scores are decision evidence, not implementation approval.

Public entrypoints

• @lssm/lib.opportunity-spec — root barrel
• @lssm/lib.opportunity-spec/types — Zod schemas and inferred types
• @lssm/lib.opportunity-spec/validation — semantic validation helpers
• @lssm/lib.opportunity-spec/validation-rules — reusable validation rule primitives for score coverage and evidence ref checks
• @lssm/lib.opportunity-spec/fixtures — safe synthetic fixtures

Evidence thresholds

• customer_validated requires evidence level 3 or higher.
• pilot_validated requires evidence level 4 or higher.
• live_proven requires evidence level 5.

Commands

• bun run test
• bun run typecheck
• bun run lint:check
• bun run build