Skip to content
← Back to changelog index

9.0.4

Nov 05, 2026 · 20 packages · 16 unique changes · 9 release entries

bundlesintegrationslibsmodulesBreaking changes

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

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

Release summaries

  • authos-baseline-fixes

    Repair AuthOS baseline gate defects (OSINT conformance discovery, Reddit exemption and catalog metadata, external example inventory admission) without changing authority semantics

    maintainer

    scripts/test-postgres.sh applies only migrations/NNNN_*.sql, matching OSINT_STORE_MIGRATIONS_V0 discovery; PROPOSED_* files stay unadmitted and still require explicit migration admission, security review and a canonical AuthOS/OSINT dev target.

    integrator

    social-network.reddit remains BYOK-only; its credential exemption reason now states that managed Reddit access is unsupported. The Reddit provider catalog entry lists its README and a read-only, server-only capability with explicit avoidWhen constraints.

    maintainer

    The workspace inventory admits @lssm-tech/example.lssm-id-external-app (created in 00b8645c20) as a new example owner and @lssm-tech/integration.provider-reddit (created in c15f1c58f9) as a new provider owner, both with owner decisions pending; admission is not acceptance or approval of either identity.

  • canonical-integration-database-contracts

    Own integration operations and database contracts in ContractsIntegrations

    integrator

    Legacy integration and database contract imports retain canonical value and registry identity.

  • opa-bots-notetaker

    OPA notetaker meeting bots (Attendee) with consent and participant notice, global dispatcher and reconciliation crons, kill switches, EU-governed transcript output and deletion propagation; production stays off.

    maintainer

    MeetingCaptureState gains in_call and MeetingCaptureAction gains recording (additive unions; exhaustive consumers must handle them). MeetingBotCaptureProvider.recording is optional. The OPA v2 manifest adds seven opa.bot_capture.* operations (136 total). Bot work runs only through the global dispatcher under per-capture leases; every provider call reproves the lease, the global/workspace/meeting switches and capture authority.

    integrator

    No action while OPA_BOTS_ENABLED is unset. Enabling requires migration 0165, a companyos_bot_dispatcher login (MANAGED_COMPANYOS_BOT_DISPATCH_DATABASE_URL), the OPA_BOTS_ATTENDEE_* deployment variables with EU region and approval references, and the Attendee DPA / EU-processing evidence listed in docs/evidence/opa/opa-bots-production-readiness-2026-10-19.md.

  • social-tracking-measurement-semantics

    Carry per-metric availability, definition version and measurement window with social tracking values, and add measurement semantics where missing is never zero and no reported metric grants posting or payment authority.

    integrator

    Integrators can mark each observed metric as available, measured_zero, partial or stale and each missing metric as unavailable, unauthorized, deleted_or_private, unsupported or no_observation, with its definition version and window. All new fields are optional.

    maintainer

    Measurement semantics are ported from Taketide creator-platform-ugc modules/tracking/src/measurement-semantics.ts (provisional cohort 07bb01cc1). Aggregates, deltas and rates refuse to infer values from missing, incompatible or zero baselines.

  • taketide-measurement-owner

    Social measurement definitions and the account capability matrix have one contract owner, and the creator-platform connected-account surface consumes the matrix without ever implying posting or payout authority.

    integrator

    Import measurement definitions from @lssm-tech/lib.contracts-integrations/integrations/social/tracking-measurement-definitions and the capability matrix from integrations/social/tracking-account-capabilities. Existing runtime and provider exports (MEASUREMENT_DEFINITION_VERSION, metricDefinitions, definitionVersionOf, <PROVIDER>_MEASUREMENT_DEFINITION_VERSION, capabilityMatrix) remain and are the same values.

    integrator

    TrackingConnectionCapabilityInput.sourceQualification now accepts null (a source that is no longer current), which the matrix treats as test-only and the view treats as not verified. DisconnectImpact defaults its remoteRevocation type to not_required, pending, complete or unavailable.

    integrator

    Connected-account view models map capability rows to en/fr labels and tones, account qualification, disconnect impact and allow-listed connection outcomes, and parse the brand projection of shared creator accounts fail-closed. Hosts supply the authorized, nonsecret projections and own routes, persistence and copy for other locales.

  • ts-01-p-ai

    Object response format and raw response identity for the Gateway LLM, a 16-bit PCM WAV inspector with STT coverage/warnings, and abortable PDF text extraction (TS-01-P-AI).

    maintainer

    LLM, STT and PDF extractor contracts gain optional fields only. Adapters that cannot honor an object response format must reject it; Gateway STT coverage is reported as partial whenever provider duration proof is missing or short.

  • ts-01-p-ig

    Instagram staged image and carousel publication provider, contract and scoped growth store (TS-01-P-IG).

    integrator

    InstagramNativePublicationProvider is a SocialPublicationProviderV2 for platform 'instagram'. Hosts inject the publishing token (exact instagram_business_basic + instagram_business_content_publish scopes), the approved slide bytes and short-lived bearer URLs, per-step authorization and a scoped SqlInstagramPublicationStore. An accepted publish reports accepted; status confirms only when the retained parent container reads PUBLISHED. Uncertain publications are never retried. Live provider qualification remains installation work.

    maintainer

    Ported from tellshift-monorepo@eefc58b (instagram publishing and fixture adapters, instagram-publishing contract, workspace instagram-stage and instagram-publish, provider and DB tests). Fixture-only qualification; no live request was made.

  • ts-01-p-social

    LinkedIn platform and member analytics source, X weighted text and thread access, and owned comment readers for LinkedIn, X and Instagram (TS-01-P-SOCIAL).

    integrator

    SocialPlatform now includes 'linkedin'. LinkedInSocialTrackingSource reads owned-post member analytics only (content.metrics); it exposes no publication capability and is registered by injection. Comment readers are read-only and require the exact comment scope set. X thread publication honours a host-supplied qualification: an unqualified thread or over-weight text dispatches nothing. Live provider qualification remains installation work.

    maintainer

    Ported from tellshift-monorepo@eefc58b (linkedin, x, instagram and comments integrations, x-wire, linkedin-wire, comments/linkedin/x/instagram contracts). Fixture-only qualification.

  • w4-integrations-final-canonical-return

    Preserve integration bodies and doc registry identity through canonical suppliers.

    integrator

    Complete contract defaults, assertions, doc payloads and registration order remain intact.

Deprecations

  • OPA_BOT_CAPTURE_ENABLED is replaced by OPA_BOTS_ENABLED (it was never enabled in any environment).

Migration guide

  • Create the Instagram publication tables

    marketing_execution.instagram_publications and instagram_publication_history are created by SqlInstagramPublicationStore.migrate(), or by migrateAllGrowthStores once the registry entry lands.

    When: Before mounting InstagramNativePublicationProvider with the SQL store.

    1. Run the store migration on the owner (migrator) client, then apply row-level security for the new tables.
  • Cover the linkedin social platform in exhaustive consumers

    Required

    SocialPlatform is a closed union that gained 'linkedin'; exhaustive records and switches over it no longer compile until they handle LinkedIn.

    When: When code builds a Record<SocialPlatform, ...> or exhaustively switches on SocialPlatform.

    1. Add a 'linkedin' entry, or narrow the key type to Exclude<SocialPlatform, 'linkedin'> where LinkedIn is deliberately unsupported.
  • Apply the notetaker bot migration

    Required

    Apply app migration 0165 (companyos/opa-bot-captures-0165) before setting OPA_BOTS_ENABLED=1.

    1. Apply app migration 0165 with the tracked runner before setting OPA_BOTS_ENABLED=1.

Upgrade steps

  • Declare why a metric is missing instead of omitting or zeroing it

    manual

    Providers may add an availability to unavailableMetrics entries and a definition version and window to collected values. Consumers that ignore the new fields keep current behavior.

    Packages: @lssm-tech/lib.contracts-integrations, @lssm-tech/integration.social-tracking-runtime

    1. Never write 0 for a metric the provider did not return; list it in unavailableMetrics.
    2. Treat manual or self-reported figures as reviewed observations, never as payable or posting authority.
  • Import measurement definitions from the contract owner

    manual

    New code should import definition versions and the capability matrix from the social tracking contract subpaths rather than mirror them.

    Packages: @lssm-tech/lib.contracts-integrations, @lssm-tech/integration.social-tracking-runtime, @lssm-tech/integration.provider-youtube, @lssm-tech/integration.provider-tiktok, @lssm-tech/integration.provider-instagram, @lssm-tech/integration.provider-x, @lssm-tech/module.social-analytics

    1. Replace local copies of the measurement definition version with the contract export.
    2. Treat a null source qualification as not provider qualified.
  • Qualify and enable notetaker bots

    manual

    Keep production off until the provider contract and EU processing are confirmed.

    Packages: @lssm-tech/lib.contracts-integrations, @lssm-tech/integration.provider-meeting-recorder, @lssm-tech/lib.organization-planning-spec, @lssm-tech/lib.organization-planning-runtime, @lssm-tech/bundle.managed-companyos

    1. Sign the Attendee DPA and obtain written EU hosting/processing confirmation; record both approval references.
    2. Create the companyos_bot_dispatcher login role (member of companyos_bot_dispatcher only) and set its URL.
    3. Configure OPA_BOTS_ATTENDEE_BASE_URL, _API_KEY, _WEBHOOK_SECRET, _REGION=eu, OPA_BOTS_WEBHOOK_BASE_URL and both approval references.
    4. Set OPA_BOTS_PROVIDER_TRANSCRIPT_REGION=eu only if the provider transcript is confirmed EU-processed.
    5. Set OPA_BOTS_ENABLED=1, then let workspace administrators opt in from OPA settings.

Unique release changes

  • New code should import definition versions and the capability matrix from the social tracking contract subpaths rather than mirror them.

    7 packages · 7 occurrences

  • Social measurement definitions and the account capability matrix have one contract owner, and the creator-platform connected-account surface consumes the matrix without ever implying posting or payout authority.

    7 packages · 7 occurrences

  • Apply app migration 0165 (companyos/opa-bot-captures-0165) before setting OPA_BOTS_ENABLED=1.

    5 packages · 5 occurrences

  • Keep production off until the provider contract and EU processing are confirmed.

    5 packages · 5 occurrences

  • LinkedIn platform and member analytics source, X weighted text and thread access, and owned comment readers for LinkedIn, X and Instagram (TS-01-P-SOCIAL).

    5 packages · 5 occurrences

  • OPA notetaker meeting bots (Attendee) with consent and participant notice, global dispatcher and reconciliation crons, kill switches, EU-governed transcript output and deletion propagation; production stays off.

    5 packages · 5 occurrences

  • OPA_BOT_CAPTURE_ENABLED is replaced by OPA_BOTS_ENABLED (it was never enabled in any environment).

    5 packages · 5 occurrences

  • SocialPlatform is a closed union that gained 'linkedin'; exhaustive records and switches over it no longer compile until they handle LinkedIn.

    5 packages · 5 occurrences

  • Object response format and raw response identity for the Gateway LLM, a 16-bit PCM WAV inspector with STT coverage/warnings, and abortable PDF text extraction (TS-01-P-AI).

    4 packages · 4 occurrences

  • Instagram staged image and carousel publication provider, contract and scoped growth store (TS-01-P-IG).

    3 packages · 3 occurrences

  • marketing_execution.instagram_publications and instagram_publication_history are created by SqlInstagramPublicationStore.migrate(), or by migrateAllGrowthStores once the registry entry lands.

    3 packages · 3 occurrences

  • Own integration operations and database contracts in ContractsIntegrations

    3 packages · 3 occurrences

  • Repair AuthOS baseline gate defects (OSINT conformance discovery, Reddit exemption and catalog metadata, external example inventory admission) without changing authority semantics

    3 packages · 3 occurrences

  • Carry per-metric availability, definition version and measurement window with social tracking values, and add measurement semantics where missing is never zero and no reported metric grants posting or payment authority.

    2 packages · 2 occurrences

  • Providers may add an availability to unavailableMetrics entries and a definition version and window to collected values. Consumers that ignore the new fields keep current behavior.

    2 packages · 2 occurrences

  • Preserve integration bodies and doc registry identity through canonical suppliers.

    1 package · 1 occurrence

Impacted packages

  • @lssm-tech/bundle.managed-companyos

    Layer: bundles · 4 changes

  • @lssm-tech/integration.growth-persistence

    Layer: integrations · 2 changes

  • @lssm-tech/integration.osint-store

    Layer: integrations · 1 change

  • @lssm-tech/integration.provider-database

    Layer: integrations · 1 change

  • @lssm-tech/integration.provider-instagram

    Layer: integrations · 2 changes

  • @lssm-tech/integration.provider-linkedin

    Layer: integrations · 2 changes

  • @lssm-tech/integration.provider-llm

    Layer: integrations · 1 change

  • @lssm-tech/integration.provider-meeting-recorder

    Layer: integrations · 4 changes

  • @lssm-tech/integration.provider-reddit

    Layer: integrations · 1 change

  • @lssm-tech/integration.provider-tiktok

    Layer: integrations · 2 changes

  • @lssm-tech/integration.provider-voice

    Layer: integrations · 1 change

  • @lssm-tech/integration.provider-x

    Layer: integrations · 2 changes

  • @lssm-tech/integration.provider-youtube

    Layer: integrations · 2 changes

  • @lssm-tech/integration.social-tracking-runtime

    Layer: integrations · 2 changes

  • @lssm-tech/lib.contracts-integrations

    Layer: libs · 1 change

  • @lssm-tech/lib.contracts-spec

    Layer: libs · 1 change

  • @lssm-tech/lib.knowledge

    Layer: libs · 1 change

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

    Layer: libs · 4 changes

  • @lssm-tech/lib.organization-planning-spec

    Layer: libs · 4 changes

  • @lssm-tech/module.social-analytics

    Layer: modules · 2 changes