Skip to content
← Back to changelog index

5.1.4

Oct 28, 2026 · 7 packages · 30 unique changes · 18 release entries

appsbundleslibsmodulesBreaking changes

This release affects the sharedLibs, solutions families.

Run contractspec connect adoption resolve --family sharedLibs to see how it impacts your project.

Release summaries

  • cmp-fix-w9-bot-repair-web-composition

    Wire the existing operator bot repair panel into OPA settings and the trusted web proxy

    integrator

    OrganizationPlanningDynamicTemplate now composes the existing localized OpaBotDeadLetterPanel in its settings section for the host-bound enterprise administrator role. The CompanyOS web host admits the existing GET bot-dead-letters and POST bot-dead-letters/:captureRef/repair routes with session authentication, exact paths, same-origin mutation checks, a 4 KiB body limit and the canonical strict repair schema. Browser-authored tenant/owner inputs and bearer authorization are refused. The API remains authoritative for operator capabilities and owner scope.

    maintainer

    Compatibility is patch: this restores reachability of existing operation and presentation behavior without adding an operation, export, dependency or role grant. Repair data/actions and retry state are cleared when the list or mutation receives 401/403. A shared request generation and abort lease fence superseded list/repair responses and unmounts; the trusted owner/session scope key remounts the panel on authority changes. Existing EN/FR/ES copy is reused.

  • cmp-live-capture-hardening

    Live capture keeps its recording on the device until uploaded, emits its declared events and sweeps expired live rows

    customer

    While a live meeting capture records, the audio is also kept in your browser until it is uploaded. If the tab closes or crashes, your next visit to the meeting sends the rest and the recording is transcribed as usual. The copy on your device is deleted once uploaded. A copy that could not be sent stays in the browser until you next open that meeting; one more than 7 days old is deleted unsent the next time you open any meeting in that browser.

    integrator

    The live-capture panel stores recordings in IndexedDB database lssm-opa-live-recordings and holds Web Locks named lssm-opa-live-recording:<captureRef>; where either is missing, or the journal stalls for more than 3 s, the recording stays in memory as before. OpaLiveCapturePanel and LiveCaptureDependencies are exported from @lssm-tech/bundle.managed-companyos/ui/organization-planning (and ./ui) with the journal port types (LiveRecordingJournalPort, LiveRecordingJournalEntry, LiveRecordingJournalHandle, LiveRecordingOrphan), createLiveRecordingJournal, LIVE_RECORDING_JOURNAL and LiveRecordingJournalCorruptError. A host passes dependencies.recordingJournal to supply its own journal, or recordingJournal: undefined to keep recordings in memory; a custom journal's read() rejects with LiveRecordingJournalCorruptError for slices that cannot rebuild the recording, which recovery then deletes.

    maintainer

    The CompanyOS API (private) emits opa.live_capture.lifecycle_transitioned, segment_finalized, highlight_added and finalized after commit through CompanyLiveCaptureServicePorts.events (payloads parsed with the contract schemas; no text, notes or note digests leave the service; the default sink logs opa_live_capture_event without refs). It adds sweepCompanyLiveCaptureRetention on the restricted companyos_capture_runtime login (0181, 0188): oldest retention first across tenants, rescanning past each 100-row scan, at most 25 captures per run and no new delete after 20 s, each deleted with its windows, segments, highlights and receipts in its own owner-bound transaction. The host mounts liveCaptureRetentionCronHandler (GET /api/cron/opa-live-capture-retention) in the opa-capture-pipeline-crons group with the capture and outcome processing crons (a direct mount on the host chain hits TS2589), vercel.json schedules it every 15 minutes and the deploy/lssm-ecosystem CompanyOS API profile mirrors the same 22 crons; a composed-host test proves the route reaches the handler.

  • communication-os-thread-next-step

    CommunicationOS threads in CompanyOS can record the next step with a responsible person and the information still awaited

    customer

    On a conversation, save the next step with the person responsible for it and, when needed, the information you are still waiting for. The step stays visible when you come back to the conversation. Saving a step never sends a message.

    maintainer

    The panel stores pending action governed work (details origin next_step, owner, optional openQuestion and awaiting) via the existing createGovernedWork client and BFF allowlist; it is gated on inbox.manage. Local demo captures use the CommunicationOS v2 demo upstream in tests-e2e/helpers (in-memory, deterministic assist).

  • communication-runtime-connection-sync-owner

    Communication runtime owns the connection subscription and sync coordinators moved out of the CommunicationOS worker

    integrator

    Import @lssm-tech/lib.communication-runtime/ecosystem-subscription-coordinator or @lssm-tech/lib.communication-runtime/ecosystem-connection-sync to run provider subscription renewal or cursor-based connection sync behind your own adapter, effect-authority and failure ports.

  • companyos-copy-followups

    CompanyOS superapp shell persona and company-metrics dashboard copy is complete in English, French and Spanish

    integrator

    The superapp shell catalogs now localize the frontline staff persona label and objective, a Spanish catalog is exported, and personas may declare an explicit objective message key. The company-metrics peer-client catalog adds a localized growthNew label used by the managed CompanyOS metrics dashboard.

  • companyos-e2e-product-fixes

    CompanyOS fixes from the local E2E lane - configured web origin for OPA writes and public booking URLs, scope-switch editor lock, typed 503 for a misconfigured auth sender, accessibility fixes

    integrator

    auth.emailAddress.add declares an additive EMAIL_DELIVERY_UNAVAILABLE (503) error. Clients that map by status keep working; the body carries only a generic message and the code.

    maintainer

    Non-production web hosts (local stack, previews) now post OPA mutations with their own configured origin and render public booking links on that origin. Production behaviour is unchanged when APP_WEB_BASE_URL is https://www.companyos.run or unset.

  • companyos-state-coverage

    CompanyOS status, audit, inbox and CommunicationOS screen templates take an optional surface state projected by createManagedCompanyOsWebShell and render localized loading, empty and error copy (en, fr, es) through the StateCopyPanel.

    integrator

    Additive view-model and props surface: createManagedCompanyOsWebShell accepts optional state and locale and returns an optional state field (always set by the factory, default ready) with catalog-resolved stateCopy. StatusTemplate, AuditTemplate, InboxTemplate and ManagedCompanyOsCommunicationScreen accept optional state and locale; StatusTemplate, AuditTemplate and InboxTemplate also accept optional degradedBanner (pass shell.degradedBanner) so the state panel never reports healthy operation during a degradation; StateCopyPanel accepts optional labels. Omitting the new inputs keeps the previous English output.

    maintainer

    New bundle catalog keys surfaceState.* (loading, empty, error, degraded and StateCopyPanel labels) and surfaceTitle.* (operationalStatus, auditLog, operatorInbox) exist in en, fr and es. They stay disjoint from the web-app-only state.* namespace. The en values equal MANAGED_COMPANYOS_WEB_STATE_COPY, and a test guards the parity.

    customer

    Status, audit, inbox and communication pages show a clear message while they load, when there is nothing to show yet, and when they fail to load, in English, French or Spanish.

  • companyos-visual-growth

    CompanyOS "Room for the real work" campaign: design pack, audience landing pages, video compositions with authoring-time narration, and AppearanceMenu prop update.

    customer

    companyos.run gains a "Room for the real work" campaign visual with a new /for-owners landing page (en/fr/es). The marketing layout applies the campaign theme automatically; no user-selected workspace design is changed.

    integrator

    AppearanceMenu from @lssm-tech/bundle.managed-companyos has a breaking prop change: replace mode, onModeChange, activeDesignKey, onDesignChange, pending, and error with committed (AppearanceSelection), onCommit (async persist-and-apply, rejects on failure), systemMode (resolved OS colour scheme for the system preview), and scopeKey (workspace/tenant scope; a change clears transient preview state). Import AppearanceSelection and AppearanceMenuProps from @lssm-tech/bundle.managed-companyos/ui/appearance. The campaign design pack companyos.design.room-for-work is not offered in the workspace picker and must not be passed as a designs entry to AppearanceMenu. Video hosts may use ./compositions/companyos/timeline and ./i18n/companyos-film from @lssm-tech/lib.video-gen to render OwnersFirstArticle; narration must be pre-generated with companyos:narrate in the video-studio before rendering.

  • fo2-s06-founder-briefing-composition

    Production composition of founder briefings, meeting evidence persistence and the protected meeting-intake executor

    integrator

    MeetingPreparationRunTotals.sourceUnavailable is additive. Hosts that bind runScheduledMeetingPreparation no longer need to catch calendar read failures around the whole run.

    maintainer

    Founder briefings stay inactive until COMPANYOS_FOUNDER_BRIEFINGS_ENABLED=1 and the owner's local times are set; otherwise the cron reports configuration_required. A workflow still enabled in legacy calendar-intelligence preferences reports cutover_required (one active owner). The meeting-intake executor requires OPA_MEETING_INTAKE_EXECUTION_URL to end in /api/opa/meeting-intake/execute and fails closed otherwise.

  • fo2-ui-executive-captures

    Founder executive cockpit shows localized, unambiguous timestamps, "Not set" values, a pending status and localized label punctuation

    integrator

    No API change. The founder executive surfaces (FounderExecutiveTemplate) render updatedAt and dueAt as a locale date with a UTC clock time when the value is an ISO-8601 instant with Z or a ±hh:mm offset, as a date alone for YYYY-MM-DD, and keep any other text unchanged. The server render and the browser hydration produce the same text in every time zone. Empty values read "Not set". The live status reads "Updating…" while an action is pending. Label colons follow the locale. Hosts that assert on the old raw ISO text or on hard-coded Label: strings should update those assertions.

    maintainer

    Compatibility classification: patch for the package, minor (1.0.0 to 1.1.0) for the companyos.founder-executive.messages translation bundle, whose four new keys are additive and present in EN, FR and ES. Data views pin only the translation key, and the registry resolves the latest version. Executive times are shown in UTC; showing them in the brief's or workspace's own time zone is follow-up FO2-UI-F4.

  • managed-companyos-api-repository-ownership

    Managed CompanyOS repository ports, Special Ops domain and evidence ledger move to the bundle

    integrator

    New driver-free subpaths expose the workspace capability and mutation ledger repositories, deterministic in-memory repositories, the Special Ops domain (policy, receipts, report export, in-memory and injected-SQL repositories, host-bound facade) and the evidence ledger adapter for lib.observability ports.

  • managed-companyos-host-domain-ownership

    Managed CompanyOS bundle owns shared behavior signals, RoleMorph action contracts, the superapp shell and host read/supervision projections; authority decisions fail closed.

    integrator

    New subpaths ./rolemorph-action-contracts, ./superapp-shell, ./read-projections, ./worker-supervision and ./view-models/company-intelligence, plus guarded behavior-signal builders and createCompanyOsBehaviorSignalRecorder on ./observability. Hosts inject their capture sink, translator, workspace config and RoleMorph evidence binding.

    maintainer

    createManagedCompanyOsAuthorityDecisions takes the resolved policy decisions as a required third argument and returns deny for actions without exactly one policy decision. Major bump rationale: a required parameter was added and an unconditional allow became a fail-closed deny; all in-repository callers were migrated and their resolved action boundaries are unchanged.

  • managed-companyos-web-host-extraction

    Managed CompanyOS bundle owns profile draft redaction, runtime access policy, the public booking client and container, and the organization/workspace switcher

    integrator

    New subpaths ./access-policy (session-role, sibling-revoke, integration-configure and workflow-decision predicates plus role-to-actor-kind mapping), ./profile-drafts (browser redaction of protected authority and server refs, ref re-binding, default intro event draft), ./public-booking (v2 public booking availability, lifecycle client and status parsing over an injected transport), ./ui/public-booking (smart container for PublicBookingTemplate over a host binding) and ./ui/organization-workspace (localized en/fr/es context switcher and state hook over OrganizationWorkspaceTransport); the root adds buildIntegrationHubRegistryCatalog.

  • opa-automation-settings-diagnostics

    Distinct not-available / forbidden / unavailable automation settings states and structured 503 diagnostics.

    customer

    Automation settings explain whether the feature is not yet available, not permitted, or temporarily failing, instead of one generic error.

  • opa-booking-plain-language

    Replace engineering jargon on the OPA Booking page and collapse operator booking repair.

    customer

    The Booking page uses plain product language and hides support-only repair tools by default.

  • opa-profile-publish-sequencing

    Save-then-publish the exact accepted profile revision and surface stale publish as a conflict.

    customer

    Booking profile admins see clear saving, publishing, published and conflict states and can no longer publish a stale revision.

  • opa-recorder-bitrate

    OPA browser meeting recorder fits a 2 h meeting under the 32 MiB capture bound and never uploads a discarded recording

    maintainer

    The recorder bounds live in meeting-recorder-limits.ts (32 kbps, 2 h, 30 MiB). The container preference is unchanged (WebM/Opus first). Whether the transcription model accepts WebM/Opus is still unverified until the first real call; no server-side transcoding was added.

  • opa-tabs-ux-pass

    Remove raw keys, enum values and internal text from OPA tabs; distinguishable automation scopes.

    customer

    OPA Today, Meetings, Booking and Settings show localized guidance instead of raw ids, enum values or internal explanations.

Migration guide

  • Provision the live-capture retention sweep

    Additive. The CompanyOS API host mounts the cron and vercel.json schedules it every 15 minutes; without the capture runtime URL it answers 200 stoppedBy: unprovisioned and deletes nothing.

    When: When a deployment wants expired live captures (retention_until, 365 days) deleted.

    1. Apply migration 0188 and create the companyos_capture_runtime login (0181).
    2. Set MANAGED_COMPANYOS_CAPTURE_RUNTIME_DATABASE_URL and CRON_SECRET on the API and deploy; the scheduled cron (*/15 * * * *) then deletes at most 25 captures per run.
    3. Check that the next call answers ok: true with observed, deleted and deferred counts.
  • Optionally spread the Spanish superapp shell catalog

    Additive only; existing imports are unchanged. Hosts that support Spanish may spread SUPERAPP_SHELL_MESSAGES_ES into their Spanish translation catalog.

    1. Import SUPERAPP_SHELL_MESSAGES_ES from @lssm-tech/bundle.managed-companyos/superapp-shell and spread it into the host es catalog.
  • Move AppearanceMenu callers to the commit model

    Required

    Replace AppearanceMenu props: pass committed (the persisted AppearanceSelection) and onCommit (an async function that persists then applies; must reject on failure) in place of the removed props. Pass systemMode if the host can detect the OS colour scheme; omit to default to 'light'. Pass scopeKey as the workspace or tenant identifier so transient previews are cleared on context switches.

    When: When a host renders AppearanceMenu.

    1. Pass committed and onCommit in place of the removed props.
    2. Pass systemMode when the host can detect the OS colour scheme.
    3. Pass scopeKey as the workspace or tenant identifier.
  • Apply migrations and cut over briefing ownership

    Required

    Founder briefings and meeting intake need new app migrations and a single active workflow owner.

    When: Enabling founder briefings or the meeting intake executor

    1. Apply app migrations 0105 (founder briefing occurrences), 0106 (meeting evidence) and 0107 (intake execution receipts) before enabling the new cron or executor route.
    2. Before enabling the founder morning or meeting-preparation workflow, disable the legacy morning recap / preparation preference for that user.
  • Optionally call the new Managed CompanyOS repository subpaths

    Additive only; existing imports are unchanged. Hosts may import the bundle subpaths instead of re-declaring repository ports, Special Ops policy or the evidence ledger adapter locally, and inject their own query functions.

    1. Import ports and adapters from @lssm-tech/bundle.managed-companyos/repositories, /special-ops or /evidence-ledger instead of a host-local copy.
    2. Keep env-based adapter selection, database pools and driver binding in the host composition root.
  • Bind authority decisions to resolved policy

    Required

    Authority decisions no longer allow unconditionally; pass the same policy decisions given to resolveRoleMorphSurface.

    When: When a caller invokes createManagedCompanyOsAuthorityDecisions.

    1. Pass the RoleMorph policyDecisions array as the third argument, e.g. createManagedCompanyOsAuthorityDecisions(workflowId, actionIds, policyDecisions).
    2. Add a policy decision for every governed action that should be authorized; actions without exactly one policy decision are denied.
    3. Optionally pass { namespace, allowReason } as the fourth argument for host-specific ontology refs and copy.
  • Optionally call the new owner subpaths

    Additive; hosts may replace local copies of behavior-signal shaping, superapp shell resolution, read projections, worker supervision health and Company Intelligence snapshot projection with the owner subpaths.

    1. Import from @lssm-tech/bundle.managed-companyos/observability, /superapp-shell, /read-projections, /worker-supervision or /view-models/company-intelligence and inject host transports.
  • Optionally call the new Managed CompanyOS owner subpaths

    Additive only; existing imports are unchanged. Hosts keep fetch, cookie, storage, navigation and digest bindings and pass them to the bundle instead of reimplementing the policy, redaction or booking client locally.

    1. Replace host-local copies with imports from the matching @lssm-tech/bundle.managed-companyos subpath.
    2. Pass host bindings explicitly (booking transport, privacy policy version, manage-session storage, opaque digests).

Upgrade steps

  • Verify events, retention and the device journal

    auto

    Run the live-capture API and managed-companyos tests.

    Packages: @lssm-tech/bundle.managed-companyos

    1. Run the live-capture events and retention PGlite tests and the retention cron test in api-application-monolith.
    2. Run the live-capture journal, recovery, durable recording and panel tests in managed-companyos.
  • Pass the surface state to templates

    assisted

    Optional; templates render as before when no state is passed.

    Packages: @lssm-tech/bundle.managed-companyos

    1. Create the shell with createManagedCompanyOsWebShell({ state, locale }) and pass shell.state and the request locale to StatusTemplate, AuditTemplate, InboxTemplate or ManagedCompanyOsCommunicationScreen.
    2. Also pass shell.degradedBanner as degradedBanner to StatusTemplate, AuditTemplate and InboxTemplate.
  • Update AppearanceMenu callers to the commit model

    manual

    The menu now operates on a committed/preview distinction. Build a single onCommit that persists the selection and resolves; the menu handles saving state and error display internally.

    Packages: @lssm-tech/bundle.managed-companyos, @lssm-tech/bundle.marketing, @lssm-tech/lib.video-gen, @lssm-tech/app.video-studio

    1. Remove mode, onModeChange, activeDesignKey, onDesignChange, pending, and error from every <AppearanceMenu> call site.
    2. Add committed (current persisted selection), onCommit (async persist function), systemMode (resolved OS scheme), and scopeKey (workspace id).
  • Run narration before rendering video compositions

    manual

    OwnersFirstArticle requires pre-generated narration audio. Run companyos:narrate from packages/apps/video-studio before companyos:mix and companyos:render. Provide ELEVENLABS_API_KEY only for lines not yet cached.

    Packages: @lssm-tech/bundle.managed-companyos, @lssm-tech/bundle.marketing, @lssm-tech/lib.video-gen, @lssm-tech/app.video-studio

    1. From packages/apps/video-studio, run bun run companyos:narrate with ELEVENLABS_API_KEY set (only needed for new or changed lines).
    2. Then run bun run companyos:mix and bun run companyos:render.

Unique release changes

  • OwnersFirstArticle requires pre-generated narration audio. Run companyos:narrate from packages/apps/video-studio before companyos:mix and companyos:render. Provide ELEVENLABS_API_KEY only for lines not yet cached.

    4 packages · 4 occurrences

  • CompanyOS "Room for the real work" campaign: design pack, audience landing pages, video compositions with authoring-time narration, and AppearanceMenu prop update.

    4 packages · 4 occurrences

  • Replace AppearanceMenu props: pass committed (the persisted AppearanceSelection) and onCommit (an async function that persists then applies; must reject on failure) in place of the removed props. Pass systemMode if the host can detect the OS colour scheme; omit to default to 'light'. Pass scopeKey as the workspace or tenant identifier so transient previews are cleared on context switches.

    4 packages · 4 occurrences

  • The menu now operates on a committed/preview distinction. Build a single onCommit that persists the selection and resolves; the menu handles saving state and error display internally.

    4 packages · 4 occurrences

  • Additive only; existing imports are unchanged. Hosts that support Spanish may spread SUPERAPP_SHELL_MESSAGES_ES into their Spanish translation catalog.

    2 packages · 2 occurrences

  • CompanyOS fixes from the local E2E lane - configured web origin for OPA writes and public booking URLs, scope-switch editor lock, typed 503 for a misconfigured auth sender, accessibility fixes

    2 packages · 2 occurrences

  • CompanyOS superapp shell persona and company-metrics dashboard copy is complete in English, French and Spanish

    2 packages · 2 occurrences

  • Additive only; existing imports are unchanged. Hosts keep fetch, cookie, storage, navigation and digest bindings and pass them to the bundle instead of reimplementing the policy, redaction or booking client locally.

    1 package · 1 occurrence

  • Additive only; existing imports are unchanged. Hosts may import the bundle subpaths instead of re-declaring repository ports, Special Ops policy or the evidence ledger adapter locally, and inject their own query functions.

    1 package · 1 occurrence

  • Additive; hosts may replace local copies of behavior-signal shaping, superapp shell resolution, read projections, worker supervision health and Company Intelligence snapshot projection with the owner subpaths.

    1 package · 1 occurrence

  • Additive. The CompanyOS API host mounts the cron and vercel.json schedules it every 15 minutes; without the capture runtime URL it answers 200 stoppedBy: unprovisioned and deletes nothing.

    1 package · 1 occurrence

  • Authority decisions no longer allow unconditionally; pass the same policy decisions given to resolveRoleMorphSurface.

    1 package · 1 occurrence

  • Communication runtime owns the connection subscription and sync coordinators moved out of the CommunicationOS worker

    1 package · 1 occurrence

  • CommunicationOS threads in CompanyOS can record the next step with a responsible person and the information still awaited

    1 package · 1 occurrence

  • CompanyOS status, audit, inbox and CommunicationOS screen templates take an optional surface state projected by createManagedCompanyOsWebShell and render localized loading, empty and error copy (en, fr, es) through the StateCopyPanel.

    1 package · 1 occurrence

  • Distinct not-available / forbidden / unavailable automation settings states and structured 503 diagnostics.

    1 package · 1 occurrence

  • Founder briefings and meeting intake need new app migrations and a single active workflow owner.

    1 package · 1 occurrence

  • Founder executive cockpit shows localized, unambiguous timestamps, "Not set" values, a pending status and localized label punctuation

    1 package · 1 occurrence

  • Live capture keeps its recording on the device until uploaded, emits its declared events and sweeps expired live rows

    1 package · 1 occurrence

  • Managed CompanyOS bundle owns profile draft redaction, runtime access policy, the public booking client and container, and the organization/workspace switcher

    1 package · 1 occurrence

  • Managed CompanyOS bundle owns shared behavior signals, RoleMorph action contracts, the superapp shell and host read/supervision projections; authority decisions fail closed.

    1 package · 1 occurrence

  • Managed CompanyOS repository ports, Special Ops domain and evidence ledger move to the bundle

    1 package · 1 occurrence

  • OPA browser meeting recorder fits a 2 h meeting under the 32 MiB capture bound and never uploads a discarded recording

    1 package · 1 occurrence

  • Optional; templates render as before when no state is passed.

    1 package · 1 occurrence

  • Production composition of founder briefings, meeting evidence persistence and the protected meeting-intake executor

    1 package · 1 occurrence

  • Remove raw keys, enum values and internal text from OPA tabs; distinguishable automation scopes.

    1 package · 1 occurrence

  • Replace engineering jargon on the OPA Booking page and collapse operator booking repair.

    1 package · 1 occurrence

  • Run the live-capture API and managed-companyos tests.

    1 package · 1 occurrence

  • Save-then-publish the exact accepted profile revision and surface stale publish as a conflict.

    1 package · 1 occurrence

  • Wire the existing operator bot repair panel into OPA settings and the trusted web proxy

    1 package · 1 occurrence

Impacted packages

  • @lssm-tech/app.video-studio

    Layer: apps · 4 changes

  • @lssm-tech/bundle.managed-companyos

    Layer: bundles · 2 changes

  • @lssm-tech/bundle.marketing

    Layer: bundles · 4 changes

  • @lssm-tech/lib.authos-spec

    Layer: libs · 1 change

  • @lssm-tech/lib.communication-runtime

    Layer: libs · 1 change

  • @lssm-tech/lib.video-gen

    Layer: libs · 4 changes

  • @lssm-tech/module.company-metrics

    Layer: modules · 2 changes