Back to changelog index

13.1.0

Jul 12, 2026 · 7 packages · 10 unique changes · 3 release entries

appsbundlesintegrationslibs

This release affects the contracts, integrations, sharedLibs, solutions familyies.

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

Release summaries

  • companyos-solutions-starting-points

    Redesign the CompanyOS /solutions buyer path around starter workflows, reusable governed workflow patterns, and bring-your-own-process conversion while adding structured marketing contract card fields and icon-key transport.

    integrator

    MarketingSectionContract cards may now carry optional iconKey and structured fields. Existing title/description/href cards remain valid; renderers can opt into labelled card content without parsing description strings.

    customer

    CompanyOS /solutions now frames named packages as starter doors that prove reusable governed workflow patterns and routes buyers to bring their own workflow when the catalog does not match their first process.

  • connect-local-approval-kernel

    Add the durable local Connect approval kernel, linkage recovery, and tenant isolation.

    integrator

    Integrators can persist generic channel or Connect approval subjects with immutable digest generations and recover an incomplete Connect runtime link safely.

    maintainer

    PostgreSQL operators must run the ordered approval migrations with a migration owner while the non-owner runtime uses transaction-local tenant and workspace context.

  • managed-companyos-production-operation-v2

    Add explicit v2 design-partner readiness, expert attestation, and founder approval contracts with server-derived authority, scoped durable receipts, pending evidence projection, replay linkage, and fail-closed health while preserving v1 unchanged. The release supports a private production-scoped pilot but does not activate a tenant or authorize broader production surfaces.

    maintainer

    The key-only CompanyOS registry remains pinned to the unchanged v1 operations. A new companyOsDesignPartnerOperationVersions registry exposes 1.0.0 and 2.0.0 side by side.

    integrator

    Adopt v2 when the API derives authority from verified server sessions and can commit durable business state, audit, command receipt, and evidence outbox intent atomically.

    customer

    Activate only one approved tenant/workspace and the invite/login, readiness, expert attestation, founder approval, and audit/evidence/replay journey. Keep GA, mobile, VPS worker, providers/outbound dispatch, real customer data, public SLA, and compliance claims deferred until separately approved.

Migration guide

  • Structured card fields are additive

    Consumers that only read card title, description, and href do not need to change. Consumers that render richer contract pages can display cards[].fields as labelled rows and cards[].iconKey through an icon registry with a fallback.

    1. Continue accepting existing card title/description/href values.
    2. Render cards[].fields when present for scannable package or pattern cards.
    3. Resolve cards[].iconKey through the host icon set and keep a safe fallback for unknown keys.
  • Configure approval migration and runtime roles

    Required

    Apply the additive migrations with an owner distinct from the runtime role.

    When: Enabling durable PostgreSQL-backed local Connect review.

    1. Run migrations 001 through 004 in order with the migration-owner role.
    2. Ensure the runtime role owns no protected tables and has no BYPASSRLS capability.
    3. Bind the non-owner database role to its tenant and workspace using the separately authorized migration/admin context; runtime input cannot choose or mutate this binding.
  • Resolve the explicit v2 design-partner operations

    Adopt the versioned v2 registry while preserving the unchanged v1 key-only registry for existing consumers.

    1. Resolve each operation through companyOsDesignPartnerOperationVersions[key]['2.0.0'].
    2. Keep the v1 key-only registry until every generated client and handler has migrated.
  • Remove client-supplied mutation authority

    Required

    Derive every authority and evidence reference from the verified server session and transaction.

    1. Stop sending principal, role, evidence receipt, replay packet, prerequisite attestation, or correlation authority in request bodies.
    2. Preserve tenant, workspace, packet-version, receipt, and correlation scope through the tenant transaction.
  • Record every private-pilot activation decision

    Required

    Treat implementation readiness as separate from approval to activate the first tenant.

    1. Approve legal tenant/workspace names, named roles, data authority, residency, and exact domains/cookie parent.
    2. Configure web https://app.companyos.lssm.tech, API/auth https://api.companyos.lssm.tech, and cookie parent .companyos.lssm.tech exactly.
    3. Configure the API-owned admitted tenant, workspace, and scenario membership; do not accept browser-selected scope.
    4. Fail closed when any admitted membership identifier is missing, blank, or malformed outside test/development.
    5. Namespace idempotency with the exact packet version and verified principal before persistence.
    6. Run the credential-parameterized deployed journey only with explicit authorization and the complete secret-store prerequisite set.
    7. Verify expected authenticated user and tenant identities, then poll receipt-id evidence and correlation-id replay until projected.
    8. Assert proof reads are immutable and verify the degraded web UI on an authorized degraded deployment.
    9. Approve database, backup, restore, support, SLO, incident, rollback, deployed-journey, cron, and kill-switch evidence.
    10. Confirm every deferred surface in docs/managed-companyos-private-pilot.md remains disabled or reference-only.

Upgrade steps

  • Install the approval kernel schema

    assisted

    Apply the additive schema and verify FORCE RLS before enabling durable local review.

    Packages: @lssm-tech/lib.contracts-spec, @lssm-tech/integration.runtime, @lssm-tech/app.cli-contractspec, @lssm-tech/bundle.workspace

    1. Back up existing channel and Connect review tables.
    2. Apply the ordered migrations under the migration-owner role.
    3. Run tenant-isolation and linkage-recovery verification with the non-owner runtime role.
  • Adopt server-authoritative design-partner v2 operations

    manual

    Bind v2 handlers to verified session membership, durable idempotency receipts, immutable replay/evidence projection, and fail-closed health.

    Packages: @lssm-tech/lib.contracts-spec

    1. Preserve receipt and correlation ids from command transaction through outbox and projection.
    2. Return recorded_evidence_pending until evidence and replay rows are visible.
    3. Reject founder approval without an accepted expert attestation on the exact packet version.
    4. Degrade overall health for database, migration, relay, DLQ, or snapshot failures.
    5. Deny reads, mutations, and scheduled relay work when the server-owned tenant kill switch is disabled.

Unique release changes

  • - Add the durable local Connect approval kernel, linkage recovery, and tenant isolation.

    4 packages · 4 occurrences

  • - Apply the additive migrations with an owner distinct from the runtime role.

    4 packages · 4 occurrences

  • - Apply the additive schema and verify FORCE RLS before enabling durable local review.

    4 packages · 4 occurrences

  • - Consumers that only read card title, description, and href do not need to change. Consumers that render richer contract pages can display cards[].fields as labelled rows and cards[].iconKey through an icon registry with a fallback.

    4 packages · 4 occurrences

  • - Redesign the CompanyOS /solutions buyer path around starter workflows, reusable governed workflow patterns, and bring-your-own-process conversion while adding structured marketing contract card fields and icon-key transport.

    4 packages · 4 occurrences

  • - Add explicit v2 design-partner readiness, expert attestation, and founder approval contracts with server-derived authority, scoped durable receipts, pending evidence projection, replay linkage, and fail-closed health while preserving v1 unchanged. The release supports a private production-scoped pilot but does not activate a tenant or authorize broader production surfaces.

    1 packages · 1 occurrences

  • - Adopt the versioned v2 registry while preserving the unchanged v1 key-only registry for existing consumers.

    1 packages · 1 occurrences

  • - Bind v2 handlers to verified session membership, durable idempotency receipts, immutable replay/evidence projection, and fail-closed health.

    1 packages · 1 occurrences

  • - Derive every authority and evidence reference from the verified server session and transaction.

    1 packages · 1 occurrences

  • - Treat implementation readiness as separate from approval to activate the first tenant.

    1 packages · 1 occurrences

Impacted packages

  • @lssm-tech/app.cli-contractspec

    Layer: apps · 3 changes

  • @lssm-tech/app.web-application-monolith

    Layer: apps · 2 changes

  • @lssm-tech/bundle.marketing

    Layer: bundles · 2 changes

  • @lssm-tech/bundle.workspace

    Layer: bundles · 3 changes

  • @lssm-tech/integration.runtime

    Layer: integrations · 3 changes

  • @lssm-tech/lib.contracts-spec

    Layer: libs · 5 changes

  • @lssm-tech/lib.design-system

    Layer: libs · 2 changes