OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

AI index

health.workouts.sync

Synchronize workouts from configured health providers.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.integrations
  • Tags: health, workouts, wearables
    • field.key.label
    health.workouts.sync
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    health.workouts.sync
    field.description.label

    Synchronize workouts from configured health providers.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.integrations
  • Tags: health, workouts, wearables
    • field.tags.label
    health,workouts,wearables
    field.owners.label
    @platform.integrations
    field.stability.label
    experimental

    Synchronize workouts from configured health providers.

    Goal

    Keep canonical workout records fresh for downstream experiences.

    Context

    Triggered by background sync jobs and manual refresh actions.

    Source Definition

    import {
	type AnyOperationSpec,
	defineCommand,
	defineQuery,
} from '@lssm-tech/lib.contracts-spec/operations';
import type { OperationSpecRegistry } from '@lssm-tech/lib.contracts-spec/operations/registry';
import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
import { HealthWorkoutRecord } from '../models';
import { HEALTH_TELEMETRY_EVENTS } from '../telemetry';

export const HealthSyncWorkouts = defineCommand({
	meta: {
		key: 'health.workouts.sync',
		version: '1.0.0',
		description: 'Synchronize workouts from configured health providers.',
		goal: 'Keep canonical workout records fresh for downstream experiences.',
		context: 'Triggered by background sync jobs and manual refresh actions.',
		owners: ['@platform.integrations'],
		tags: ['health', 'workouts', 'wearables'],
		stability: 'experimental',
	},
	io: {
		input: HealthSyncWorkoutsInput,
		output: HealthSyncWorkoutsOutput,
	},
	policy: {
		auth: 'admin',
	},
	telemetry: {
		success: {
			event: { key: HEALTH_TELEMETRY_EVENTS.workoutsSynced },
		},
		failure: {
			event: { key: HEALTH_TELEMETRY_EVENTS.workoutsSyncFailed },
		},
	},
});