Skip to content
← Back to changelog index

17.3.5

Oct 27, 2026 · 23 packages · 22 unique changes · 12 release entries

libsmodulesBreaking changes

This release affects the contracts, sharedLibs, solutions families.

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

Release summaries

  • cmp-facade-manifest-builder-owner

    Deprecate the facade docs/manifest-builder forward in favour of the lib.typescript-runtime owner and fix the i18n diagnostics README example

    integrator

    Behavior-compatible: @lssm-tech/lib.contracts-spec/docs/manifest-builder still exports buildPackageDocManifest and extractModuleDocData with the canonical function identities, and still needs the optional @lssm-tech/lib.typescript-runtime peer. Both exports are now marked @deprecated; import them from @lssm-tech/lib.typescript-runtime/docs-manifest-builder. The subpath and the optional peer are removed at the next major of @lssm-tech/lib.contracts-spec.

    maintainer

    The facade docs:manifest producer imports the tool owner directly, so no package tooling routes through the deprecated forward. The facade-docs-manifest-typescript-tooling boundary bridge keeps its two exact edges (optional peer and deprecated forward) and now exits only at the facade major. The translation-diagnostics README example uses a package-relative catalogDir.

  • compat-declaration-canonical-forwarding

    Preserve historical declaration compatibility through canonical forwarding

    maintainer

    Reproduce historical declaration forwards and verify type augmentation and runtime parity.

  • explicit-contracts-spec-entries

    Explicit ContractSpec build roots preserve existing compatibility surfaces

    maintainer

    Canonical package entries and frozen exports separate private implementation discovery from public compatibility.

  • facade-typescript-runtime-optional-peer

    The contracts-spec facade no longer installs the TypeScript compiler; docs/manifest-builder needs an optional peer

    integrator

    Only consumers of @lssm-tech/lib.contracts-spec/docs/manifest-builder are affected: they must add @lssm-tech/lib.typescript-runtime to their own dependencies. All other subpaths behave identically and stop pulling the compiler into production installs.

  • forms-private-module-ownership

    Preserve Forms behavior and public imports through cohesive private modules

    integrator

    Existing Forms imports keep the same constructor, nominal registry, model signatures and runtime statements; private implementation modules add no public subpaths.

  • generated-compatibility-artifacts

    Preserve generated compatibility export targets during production pruning

    integrator

    Required generated exports and declaration dependencies survive pruning.

  • lane-12b-facade-family-owners

    Remaining facade-owned definition families move to their canonical owners with identity-preserving forwards; host, platform and domain packages stop depending on owners their layer may not use

    integrator

    Import the moved definitions from their owners; every former @lssm-tech/lib.contracts-spec subpath keeps working with identical objects.

  • legacy-model-validation-canonical-runtime

    Restore Legacy model validators to their canonical runtime owner

    integrator

    Historical validation imports retain their optional-clock API and canonical runtime identities.

  • library-composition-canonical-owners

    Preserve library composition and structured-data assertions through canonical ownership.

    integrator

    Historical composition imports retain exact handlers, schemas and registry types.

  • semantic-tooling-canonical-owners

    Preserve semantic tooling and social publication APIs through exact canonical owner forwards.

    integrator

    Adopt canonical leaves while retaining historical imports and class/schema identity.

  • w4-ai-improvement-declaration-owner

    Preserve AI-improvement contracts through a canonical orchestration declaration owner and remove the provider facade backedge.

    integrator

    Legacy imports retain their exact types and V2 value identities; internal provider declarations use the canonical leaf.

  • w4-visual-scenario-validator-owner

    Preserve complete visual scenario validation through the existing canonical DesignCatalog entry.

    integrator

    Existing visual validator subpaths retain their exact function identities, context defaults, and ordered diagnostics; DesignCatalog provides canonical named bindings.

Deprecations

  • The @lssm-tech/lib.contracts-spec/docs/manifest-builder subpath (buildPackageDocManifest, extractModuleDocData) is deprecated and removed at the next major of @lssm-tech/lib.contracts-spec; use @lssm-tech/lib.typescript-runtime/docs-manifest-builder.

Migration guide

  • Import the DocBlock manifest builder from lib.typescript-runtime

    The facade subpath is a deprecated forward of the same functions. Switching the import is a no-op at runtime.

    1. Add @lssm-tech/lib.typescript-runtime as a dependency (it is already required as the optional peer of the deprecated subpath).
    2. Replace imports from @lssm-tech/lib.contracts-spec/docs/manifest-builder with @lssm-tech/lib.typescript-runtime/docs-manifest-builder.
  • Install the compiler peer for the manifest builder subpath

    Required

    @lssm-tech/lib.typescript-runtime is now an optional peer dependency of the facade; package managers do not install optional peers automatically.

    When: When importing @lssm-tech/lib.contracts-spec/docs/manifest-builder.

    1. Consumers of ./docs/manifest-builder install @lssm-tech/lib.typescript-runtime (add it to the consuming package dependencies), or import the canonical @lssm-tech/lib.typescript-runtime/docs-manifest-builder directly.
  • Replace @lssm-tech/lib.contracts-spec/jobs/durable-queue-v2 with...

    Replace @lssm-tech/lib.contracts-spec/jobs/durable-queue-v2 with @lssm-tech/lib.orchestration-spec/durable-queue-v2.

    1. Replace @lssm-tech/lib.contracts-spec/jobs/durable-queue-v2 with @lssm-tech/lib.orchestration-spec/durable-queue-v2.
  • Replace @lssm-tech/lib.contracts-spec/agent/protocol/automation[/<leaf>] with...

    Replace @lssm-tech/lib.contracts-spec/agent/protocol/automation[/<leaf>] with @lssm-tech/lib.agent-protocol-spec/protocol/automation[/<leaf>], .../agent/protocol/markdown-migration with @lssm-tech/lib.agent-protocol-spec/protocol/markdown-migration, and .../agent-step-observability[/<leaf>] with @lssm-tech/lib.agent-protocol-spec/agent-step-observability[/<leaf>].

    1. Replace @lssm-tech/lib.contracts-spec/agent/protocol/automation[/<leaf>] with @lssm-tech/lib.agent-protocol-spec/protocol/automation[/<leaf>], .../agent/protocol/markdown-migration with @lssm-tech/lib.agent-protocol-spec/protocol/markdown-migration, and .../agent-step-observability[/<leaf>] with @lssm-tech/lib.agent-protocol-spec/agent-step-observability[/<leaf>].
  • Replace @lssm-tech/lib.contracts-spec/adoption-catalog with...

    Replace @lssm-tech/lib.contracts-spec/adoption-catalog with @lssm-tech/lib.contractspec-catalog/adoption-catalog, .../graph-artifacts/<leaf> with @lssm-tech/lib.contracts-spec-core/graph-artifacts/<leaf>, .../shared/attach-context with @lssm-tech/lib.contracts-runtime-kernel/shared/attach-context, .../notifications[/<leaf>] with @lssm-tech/lib.communication-spec/notifications[/<leaf>] and .../sop[/<leaf>] with @lssm-tech/lib.sop-runtime/contracts[/<leaf>].

    1. Replace @lssm-tech/lib.contracts-spec/adoption-catalog with @lssm-tech/lib.contractspec-catalog/adoption-catalog, .../graph-artifacts/<leaf> with @lssm-tech/lib.contracts-spec-core/graph-artifacts/<leaf>, .../shared/attach-context with @lssm-tech/lib.contracts-runtime-kernel/shared/attach-context, .../notifications[/<leaf>] with @lssm-tech/lib.communication-spec/notifications[/<leaf>] and .../sop[/<leaf>] with @lssm-tech/lib.sop-runtime/contracts[/<leaf>].
  • Historical imports remain exact forwards

    Historical imports remain exact forwards; ContractsLibrary owns the corresponding canonical composition leaves.

    1. Historical imports remain exact forwards; ContractsLibrary owns the corresponding canonical composition leaves.
  • Report handlers retain their existing Bun CLI invocation requirement and server-only export...

    Report handlers retain their existing Bun CLI invocation requirement and server-only export conditions.

    1. Report handlers retain their existing Bun CLI invocation requirement and server-only export conditions.
  • Historical imports remain supported

    Historical imports remain supported; canonical leaves preserve their exact implementation and wire shapes.

    1. Historical imports remain supported; canonical leaves preserve their exact implementation and wire shapes.
  • Use GrowthSpec social-media leaves and OrchestrationSpec feature-hubs leaves for pure social and...

    Use GrowthSpec social-media leaves and OrchestrationSpec feature-hubs leaves for pure social and Hub contracts.

    1. Use GrowthSpec social-media leaves and OrchestrationSpec feature-hubs leaves for pure social and Hub contracts.

Unique release changes

  • Remaining facade-owned definition families move to their canonical owners with identity-preserving forwards; host, platform and domain packages stop depending on owners their layer may not use

    15 packages · 15 occurrences

  • Replace @lssm-tech/lib.contracts-spec/adoption-catalog with @lssm-tech/lib.contractspec-catalog/adoption-catalog, .../graph-artifacts/<leaf> with @lssm-tech/lib.contracts-spec-core/graph-artifacts/<leaf>, .../shared/attach-context with @lssm-tech/lib.contracts-runtime-kernel/shared/attach-context, .../notifications[/<leaf>] with @lssm-tech/lib.communication-spec/notifications[/<leaf>] and .../sop[/<leaf>] with @lssm-tech/lib.sop-runtime/contracts[/<leaf>].

    15 packages · 15 occurrences

  • Replace @lssm-tech/lib.contracts-spec/agent/protocol/automation[/<leaf>] with @lssm-tech/lib.agent-protocol-spec/protocol/automation[/<leaf>], .../agent/protocol/markdown-migration with @lssm-tech/lib.agent-protocol-spec/protocol/markdown-migration, and .../agent-step-observability[/<leaf>] with @lssm-tech/lib.agent-protocol-spec/agent-step-observability[/<leaf>].

    15 packages · 15 occurrences

  • Replace @lssm-tech/lib.contracts-spec/jobs/durable-queue-v2 with @lssm-tech/lib.orchestration-spec/durable-queue-v2.

    15 packages · 15 occurrences

  • Historical imports remain supported; canonical leaves preserve their exact implementation and wire shapes.

    7 packages · 7 occurrences

  • Preserve semantic tooling and social publication APIs through exact canonical owner forwards.

    7 packages · 7 occurrences

  • Use GrowthSpec social-media leaves and OrchestrationSpec feature-hubs leaves for pure social and Hub contracts.

    7 packages · 7 occurrences

  • Preserve historical declaration compatibility through canonical forwarding

    5 packages · 5 occurrences

  • Historical imports remain exact forwards; ContractsLibrary owns the corresponding canonical composition leaves.

    3 packages · 3 occurrences

  • Preserve AI-improvement contracts through a canonical orchestration declaration owner and remove the provider facade backedge.

    3 packages · 3 occurrences

  • Preserve library composition and structured-data assertions through canonical ownership.

    3 packages · 3 occurrences

  • Report handlers retain their existing Bun CLI invocation requirement and server-only export conditions.

    3 packages · 3 occurrences

  • Deprecate the facade docs/manifest-builder forward in favour of the lib.typescript-runtime owner and fix the i18n diagnostics README example

    2 packages · 2 occurrences

  • Preserve complete visual scenario validation through the existing canonical DesignCatalog entry.

    2 packages · 2 occurrences

  • The @lssm-tech/lib.contracts-spec/docs/manifest-builder subpath (buildPackageDocManifest, extractModuleDocData) is deprecated and removed at the next major of @lssm-tech/lib.contracts-spec; use @lssm-tech/lib.typescript-runtime/docs-manifest-builder.

    2 packages · 2 occurrences

  • The facade subpath is a deprecated forward of the same functions. Switching the import is a no-op at runtime.

    2 packages · 2 occurrences

  • @lssm-tech/lib.typescript-runtime is now an optional peer dependency of the facade; package managers do not install optional peers automatically.

    1 package · 1 occurrence

  • Explicit ContractSpec build roots preserve existing compatibility surfaces

    1 package · 1 occurrence

  • Preserve Forms behavior and public imports through cohesive private modules

    1 package · 1 occurrence

  • Preserve generated compatibility export targets during production pruning

    1 package · 1 occurrence

  • Restore Legacy model validators to their canonical runtime owner

    1 package · 1 occurrence

  • The contracts-spec facade no longer installs the TypeScript compiler; docs/manifest-builder needs an optional peer

    1 package · 1 occurrence

Impacted packages

  • @lssm-tech/lib.agent-protocol-spec

    Layer: libs · 4 changes

  • @lssm-tech/lib.billing-spec

    Layer: libs · 4 changes

  • @lssm-tech/lib.communication-spec

    Layer: libs · 4 changes

  • @lssm-tech/lib.contracts-library

    Layer: libs · 3 changes

  • @lssm-tech/lib.contracts-runtime-core

    Layer: libs · 3 changes

  • @lssm-tech/lib.contracts-runtime-kernel

    Layer: libs · 4 changes

  • @lssm-tech/lib.contracts-spec

    Layer: libs · 1 change

  • @lssm-tech/lib.contracts-spec-core

    Layer: libs · 4 changes

  • @lssm-tech/lib.contracts-transformers

    Layer: libs · 3 changes

  • @lssm-tech/lib.contractspec-catalog

    Layer: libs · 4 changes

  • @lssm-tech/lib.design-catalog

    Layer: libs · 1 change

  • @lssm-tech/lib.design-system

    Layer: libs · 4 changes

  • @lssm-tech/lib.gamification-spec

    Layer: libs · 4 changes

  • @lssm-tech/lib.growth-spec

    Layer: libs · 3 changes

  • @lssm-tech/lib.lssm-os-runtime

    Layer: libs · 4 changes

  • @lssm-tech/lib.notification

    Layer: libs · 4 changes

  • @lssm-tech/lib.observability-spec

    Layer: libs · 4 changes

  • @lssm-tech/lib.orchestration-spec

    Layer: libs · 1 change

  • @lssm-tech/lib.provider-spec

    Layer: libs · 1 change

  • @lssm-tech/lib.sop-runtime

    Layer: libs · 4 changes

  • @lssm-tech/lib.surface-runtime

    Layer: libs · 3 changes

  • @lssm-tech/lib.typescript-runtime

    Layer: libs · 3 changes

  • @lssm-tech/module.lssm-os-control-plane

    Layer: modules · 4 changes