Skip to content
ContractSpec
Start here

Area guide · 26 packages · Trace an operating proposal into Work

Company, work and service operations

Connect operating goals, shared work, planning, meetings and support through their canonical domain boundaries.

What are you trying to do?

  • Which package owns tasks and project state?
  • How do CompanyOS projections use shared work?
  • How can support and meeting workflows hand off work without copying another domain?

Why start with these packages

Suggested entry point

@lssm-tech/lib.work-runtime

Start with immutable Work events, recurrence, sync conflict handling and durable-store ports.

Read package manual →

Suggested entry point

@lssm-tech/lib.companyos-runtime

Use CompanyOS authority, operating-loop, graph and outcome projections over shared references.

Read package manual →

Suggested entry point

@lssm-tech/lib.organization-planning-runtime

Inspect OPA planning/meeting services and their current authority and consent boundaries.

Read package manual →

Suggested entry point

@lssm-tech/lib.customer-support-runtime

Inspect SupportOS lifecycle, case concurrency, routing and reference-based ecosystem handoffs.

Read package manual →

Practical steps

Step 01

Trace one work item

Open its contract and follow event reduction, revision checks, storage and the projection used by the UI. Compare a repeated command and a conflicting update using the owning runtime’s existing tests or fixtures.

Step 02

Follow one domain handoff

Choose a support-to-work or meeting-to-work path. Identify which domain owns the original record, which references cross the boundary and where authority is rechecked before the receiving action.

Step 03

Inspect the composed availability

Check the bundle’s installed modules, handlers, required ports and selected capabilities. Show proposals, queued actions and completed effects separately, then link an operator to the evidence or recovery path relevant to that exact state.

Follow the owner of durable state

WorkRuntime is the shared owner for task/project reducers and persistence ports. It consumes immutable events, checks revision order, expands recurrence and resolves sync authority/conflicts. CompanyOS runtime uses Work references for operating reviews and graph projections. Keep that direction when adding a feature: a dashboard or assistant should reference the canonical task rather than maintaining a parallel mutable task copy. Concrete PostgreSQL, queue, realtime and connector behavior belongs to the selected integrations and host.

Understand domain-specific handoffs

CompanyOS adds authority explanations, autonomy classification, operator inbox routing and evidence-backed outcome projections. OPA contributes profile and meeting-workspace behavior, while SupportOS contributes case lifecycle, routing and service operations. Support routing can evaluate candidate projections deterministically, but assignment remains a separate governed effect. Message bodies stay with CommunicationOS and form answers with Forms. A cross-domain handoff should therefore name the exact referenced work or operation and the evidence needed by its receiving owner.

Inspect retries and active capabilities

Work outbox delivery uses leased, destination-specific records and fenced acknowledgements; current source requires the exact delivery attempt for settlement. OPA distinguishes its operation catalog, partial handler map and installed registry. Saving an automation policy does not itself activate background execution. These distinctions are useful product states, not implementation trivia: an operator needs to know whether a proposal exists, a handler is installed, delivery is pending or an external effect completed. Preserve that vocabulary in a composed product.

Follow a practical path.

Trace one work item

Open its contract and follow event reduction, revision checks, storage and the projection used by the UI. Compare a repeated command and a conflicting update using the owning runtime’s existing tests or fixtures.

Follow one domain handoff

Choose a support-to-work or meeting-to-work path. Identify which domain owns the original record, which references cross the boundary and where authority is rechecked before the receiving action.

Inspect the composed availability

Check the bundle’s installed modules, handlers, required ports and selected capabilities. Show proposals, queued actions and completed effects separately, then link an operator to the evidence or recovery path relevant to that exact state.

Packages in this area (26)

26 of 26 shown

Curated but no longer in the workspace: app.meeting-effect-worker, app.meeting-intake-worker, app.organization-planning-host, app.supportos-api, app.supportos-desktop, app.supportos-web, app.supportos-worker, integration.meeting-effect-worker-postgres-http, integration.meeting-intake-worker-postgres-http, integration.supportos-worker-managed