module.editions
Reusable deterministic edition platform surfaces for resources, UI, workflows, storage, agents, and evidence.
@lssm-tech/module.editionsbun add @lssm-tech/module.editionsManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Reusable deterministic edition platform surfaces for ContractSpec.
This module owns composed behavior around canonical @lssm-tech/lib.contracts-spec/editions contracts: resource builders, UI view models, workflows, storage adapter wiring, deterministic agent plans, and evidence composition.
Boundaries
- Imports libs only.
- No peer modules, bundles, apps, examples, provider SDKs, raw secrets, external database requirement, or production writes.
- Public tracks stay narrow and acyclic:
./resources,./ui,./workflow,./storage,./agents,./evidence../proofintentionally composes those tracks into an aggregate readiness proof.
Public tracks and review boundaries
The module is a composition layer over @lssm-tech/lib.contracts-spec/editions; it must not create a second edition ontology. Keep each track deterministic and credential-free:
| Track | Responsibility | Review focus |
|---|---|---|
./resources | Resource template metadata for live proof/showcase callers. | No injected resolver side effects or provider calls. |
./ui | View-model projection for edition screens. | Uses typed edition identity/evidence fields; no private source imports. |
./workflow | Lifecycle transitions and audit events. | Published, rollback, archive, and migration transitions preserve evidence refs. |
./storage | Adapter composition over file/database edition projections. | File and database counts derive from lib storage kinds, not product-specific ids. |
./agents | Deterministic improvement plans. | No provider execution; plans cite edition refs and reversible steps. |
./evidence | Harness/replay/knowledge evidence composition. | Reuses canonical evidence refs instead of inventing module-local proof systems. |
./proof | Aggregate platform readiness proof. | Public exports, runtime wiring, and gate refs stay aligned with package exports. |
For published-edition API work, review code and docs against the subject-generic identity contract in packages/platform/delivery/contracts-spec-compat/src/editions/README.md: module callers should depend on subjectKey, subjectType, editionKind, editionId, storage projection refs, authority scopes, and evidence refs rather than parsing CompanyOS-specific fixture ids.
Commands
bun run test
bun run typecheck
bun run build
node ../../../scripts/biome.cjs check .Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
3 declarations
@lssm-tech/lib.contracts-libraryworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-runtime-kernelworkspace:^
Read the package manual ↗zodcatalog:
Declared capabilities
Reusable deterministic edition platform surfaces for resources, UI, workflows, storage, agents, and evidence.
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 .prebuildcontractspec-bun-build prebuildtestbun testtypechecktsgo --noEmit