Skip to content
ContractSpec
Start here

Package manual · platform

·Governance, decisions and approvals

module.editions

Reusable deterministic edition platform surfaces for resources, UI, workflows, storage, agents, and evidence.

platformmodulev2.0.4experimentalservernode
@lssm-tech/module.editions
bun add @lssm-tech/module.editions
Package source ↗Manifest ↗

Manifest 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. ./proof intentionally 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:

TrackResponsibilityReview focus
./resourcesResource template metadata for live proof/showcase callers.No injected resolver side effects or provider calls.
./uiView-model projection for edition screens.Uses typed edition identity/evidence fields; no private source imports.
./workflowLifecycle transitions and audit events.Published, rollback, archive, and migration transitions preserve evidence refs.
./storageAdapter composition over file/database edition projections.File and database counts derive from lib storage kinds, not product-specific ids.
./agentsDeterministic improvement plans.No provider execution; plans cite edition refs and reversible steps.
./evidenceHarness/replay/knowledge evidence composition.Reuses canonical evidence refs instead of inventing module-local proof systems.
./proofAggregate 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

bash
bun run test
bun run typecheck
bun run build
node ../../../scripts/biome.cjs check .

Relationships

THIS PACKAGEmodule.editions8 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

3 declarations

Declared capabilities

Module Editions

Reusable deterministic edition platform surfaces for resources, UI, workflows, storage, agents, and evidence.

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint: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 prebuild
  • testbun test
  • typechecktsgo --noEmit