catence 0.2.1-beta.4 → 0.2.1-beta.6

package/dist/contracts/release.d.ts

@@ -3,7 +3,7 @@
  * Keep these values synchronized with release/manifest.json; release checks
  * deliberately reject drift before a package can be published.
  */
-export declare const CATENCE_RUNTIME_VERSION = "0.2.1-beta.4";
+export declare const CATENCE_RUNTIME_VERSION = "0.2.1-beta.6";
 export declare const CATENCE_PROTOCOL_VERSION = 1;
 export type CatenceRuntimeCapabilities = {
     mcp: true;

package/dist/contracts/release.js

@@ -3,7 +3,7 @@
  * Keep these values synchronized with release/manifest.json; release checks
  * deliberately reject drift before a package can be published.
  */
-export const CATENCE_RUNTIME_VERSION = '0.2.1-beta.4';
+export const CATENCE_RUNTIME_VERSION = '0.2.1-beta.6';
 export const CATENCE_PROTOCOL_VERSION = 1;
 export function catenceRuntimeHealth() {
     return {

package/dist/elt/application/management.d.ts

@@ -37,4 +37,11 @@ export declare function resolveExtractionErrors(paths: CatencePaths, opts?: {
  * previously mis-parsed nutrition_days/nutrition_items from stored payloads.
  */
 export declare function reimportNutrition(paths: CatencePaths): Promise<Record<string, unknown>>;
+/**
+ * Re-run normalization over already-captured Garmin weigh-in entities without
+ * contacting any provider. Stores synced before beta.5 staged weigh_ins
+ * payloads but never projected them to daily_metrics, so this backfills
+ * weight_kg from stored payloads. Idempotent upserts make it safe to re-run.
+ */
+export declare function reimportWeight(paths: CatencePaths): Promise<Record<string, unknown>>;
 export {};

package/dist/elt/application/management.js

@@ -722,6 +722,36 @@ export async function reimportNutrition(paths) {
         await database.close();
     }
 }
+/**
+ * Re-run normalization over already-captured Garmin weigh-in entities without
+ * contacting any provider. Stores synced before beta.5 staged weigh_ins
+ * payloads but never projected them to daily_metrics, so this backfills
+ * weight_kg from stored payloads. Idempotent upserts make it safe to re-run.
+ */
+export async function reimportWeight(paths) {
+    if (!existsSync(paths.database))
+        throw new Error('No Catence database exists yet. Complete a sync before re-importing weight.');
+    const database = await CatenceDatabase.open(paths);
+    try {
+        const rows = await database.rows(`SELECT provider, entity_type, remote_id, parent_remote_id, occurred_on, source_updated_at, raw_object_hash,
+              cast(payload_json AS VARCHAR) AS payload_json, cast(extension_json AS VARCHAR) AS extension_json
+       FROM source_entities
+       WHERE provider = 'garmin' AND entity_type = 'body_composition'
+       ORDER BY occurred_on, remote_id`);
+        for (const row of rows) {
+            await importSourceEntity(database, {
+                kind: 'source_entity', schemaVersion: 1, provider: row.provider, entityType: row.entity_type,
+                remoteId: row.remote_id, parentRemoteId: row.parent_remote_id, occurredOn: row.occurred_on, sourceUpdatedAt: row.source_updated_at,
+                rawObjectHash: row.raw_object_hash, payload: parseJsonObject(row.payload_json), extension: parseJsonObject(row.extension_json),
+            });
+        }
+        const weights = (await database.rows(`SELECT count(*) AS count FROM daily_metrics WHERE metric_name = 'weight_kg'`))[0]?.count ?? 0;
+        return { reimportedEntities: rows.length, weightObservations: Number(weights) };
+    }
+    finally {
+        await database.close();
+    }
+}
 function parseJsonObject(value) {
     if (!value)
         return {};

package/dist/elt/normalization/normalizers.js

@@ -271,6 +271,8 @@ export async function importSourceEntity(database, entity) {
     }
     if (entity.entityType === 'wellness' || entity.entityType === 'daily_health')
         await importDailyMetrics(database, entity.provider, entity.remoteId, entity.occurredOn, payload, rawHash);
+    if (entity.provider === 'garmin' && entity.entityType === 'body_composition')
+        await importGarminWeight(database, entity.occurredOn, payload, rawHash);
     if (entity.entityType === 'nutrition_day' || entity.entityType === 'nutrition_log')
         await importNutrition(database, entity.provider, entity.occurredOn, entity.remoteId, payload, rawHash);
     if (entity.provider === 'garmin' && entity.entityType === 'training_metric')
@@ -968,6 +970,64 @@ async function importDailyMetrics(database, provider, remoteId, date, payload, r
     if (provider === 'garmin')
         await importGarminDailyDetails(database, remoteId, metricDate, payload, rawHash);
 }
+/**
+ * Weight-only projection for Garmin weigh-ins. The range endpoint returns
+ * `{dailyWeightSummaries: [{summaryDate, allWeightMetrics: [{weight, ...}]}]}`
+ * with weight in grams, while dayview returns `{dateWeightList: [...]}`.
+ * The worker stages a whole range window as one `body_composition` entity,
+ * so dates are derived per entry here. Multiple weigh-ins on one day resolve
+ * to the latest timestamp. Body-composition fields (fat, muscle, ...) are
+ * deliberately ignored.
+ */
+function weightKgFromValue(value) {
+    if (value === null)
+        return null;
+    return value > 1000 ? value / 1000 : value;
+}
+function weightEntryDate(entry, fallbackDay) {
+    // Prefer the parent summaryDate (Garmin's local day) over the entry's UTC
+    // timestampGMT, which can fall on a different UTC date.
+    return fallbackDay
+        ?? datePart(firstString(entry, ['summaryDate', 'calendarDate', 'date']))
+        ?? datePart(timestamp(entry.timestampGMT));
+}
+function collectGarminWeightEntries(payload, fallbackDay) {
+    const entries = [];
+    const pushEntry = (entry, fallback) => {
+        const kg = weightKgFromValue(firstNumber(entry, ['weight', 'weightValue', 'weightInKg']));
+        if (kg === null)
+            return;
+        const day = weightEntryDate(entry, fallback ?? fallbackDay);
+        if (!day)
+            return;
+        const ts = typeof entry.timestampGMT === 'number' && Number.isFinite(entry.timestampGMT) ? entry.timestampGMT : 0;
+        entries.push({ date: day, kg, ts });
+    };
+    for (const summary of objectArray(payload.dailyWeightSummaries)) {
+        const day = datePart(firstString(summary, ['summaryDate', 'calendarDate', 'date'])) ?? fallbackDay;
+        for (const metric of objectArray(summary.allWeightMetrics))
+            pushEntry(metric, day);
+    }
+    for (const key of ['dateWeightList', 'allWeightMetrics']) {
+        for (const entry of objectArray(payload[key]))
+            pushEntry(entry, fallbackDay);
+    }
+    if (firstNumber(payload, ['weight', 'weightValue', 'weightInKg']) !== null)
+        pushEntry(payload, fallbackDay);
+    return entries;
+}
+async function importGarminWeight(database, date, payload, rawHash) {
+    const fallbackDay = datePart(date);
+    const latestByDay = new Map();
+    for (const entry of collectGarminWeightEntries(payload, fallbackDay)) {
+        const current = latestByDay.get(entry.date);
+        if (!current || entry.ts >= current.ts)
+            latestByDay.set(entry.date, { kg: entry.kg, ts: entry.ts });
+    }
+    for (const [metricDate, { kg }] of latestByDay) {
+        await upsertDailyMetric(database, 'garmin', metricDate, 'weight_kg', kg, null, 'kg', rawHash);
+    }
+}
 async function importNutrition(database, provider, date, remoteId, payload, rawHash) {
     const nutritionDate = datePart(date) ?? datePart(firstString(payload, ['id', 'date', 'calendarDate'])) ?? null;
     if (!nutritionDate)

package/dist/interfaces/cli/commands.js

@@ -2,7 +2,7 @@
 import { createInterface } from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import { Command } from 'commander';
-import { addAthlete, athleteStorePaths, CATENCE_RUNTIME_VERSION, CatenceDatabase, channelForVersion, createDemoStore, dataStatus, defaultCatalogHome, disconnectStravaAccount, fetchNpmDistTags, fetchPypiReleases, hasCommand, importStagedFile, initializeCatalog, isGlobalNpmInstall, linkActivity, loadCatalog, npmGlobalPrefix, planSelfUpdate, readInstalledConsoleVersion, rebuildRetrievalIndex, reimportNutrition, resolveExtractionErrors, resolveAthlete, resolveCatalogPaths, retryDataSync, runSelfUpdateCommand, setAthleteSecret, syncData, syncProgress, connectStrava, connectStravaWithCallback, unlinkActivity, } from '../../runtime/index.js';
+import { addAthlete, athleteStorePaths, CATENCE_RUNTIME_VERSION, CatenceDatabase, channelForVersion, createDemoStore, dataStatus, defaultCatalogHome, disconnectStravaAccount, fetchNpmDistTags, fetchPypiReleases, hasCommand, importStagedFile, initializeCatalog, isGlobalNpmInstall, linkActivity, loadCatalog, npmGlobalPrefix, planSelfUpdate, readInstalledConsoleVersion, rebuildRetrievalIndex, reimportNutrition, reimportWeight, resolveExtractionErrors, resolveAthlete, resolveCatalogPaths, retryDataSync, runSelfUpdateCommand, setAthleteSecret, syncData, syncProgress, connectStrava, connectStravaWithCallback, unlinkActivity, } from '../../runtime/index.js';
 const program = new Command()
     .name('catence-data')
     .description('Athlete-scoped Catence data setup, extraction, and normalization.')
@@ -256,6 +256,10 @@ program.command('reimport-nutrition').description('Re-run normalization over cap
     const { paths } = await currentAthlete();
     process.stdout.write(`${JSON.stringify(await reimportNutrition(paths), null, 2)}\n`);
 });
+program.command('reimport-weight').description('Backfill weight_kg from captured Garmin weigh-in entities without contacting providers.').action(async () => {
+    const { paths } = await currentAthlete();
+    process.stdout.write(`${JSON.stringify(await reimportWeight(paths), null, 2)}\n`);
+});
 program
     .command('import')
     .description('Import a staged JSONL file (for example a swim-length backfill) into one athlete’s data store.')

package/dist/runtime/index.d.ts

@@ -29,7 +29,7 @@ export { WELLNESS_METRICS, WellnessService } from '../core/query/wellness.js';
 export { jsonSafe, ReadOnlyRepository } from '../core/query/repository.js';
 export { queryReadOnlyData } from '../core/query/sql-guard.js';
 export { createDemoStore, demoStoreMetadata } from '../elt/application/demo.js';
-export { connectStrava, connectStravaWithCallback, dataStatus, disconnectStravaAccount, initializeDataStore, importStagedFile, linkActivity, rebuildRetrievalIndex, reimportNutrition, resolveExtractionErrors, retryDataSync, syncData, syncProgress, unlinkActivity, } from '../elt/application/management.js';
+export { connectStrava, connectStravaWithCallback, dataStatus, disconnectStravaAccount, initializeDataStore, importStagedFile, linkActivity, rebuildRetrievalIndex, reimportNutrition, reimportWeight, resolveExtractionErrors, retryDataSync, syncData, syncProgress, unlinkActivity, } from '../elt/application/management.js';
 export type { ProviderChoice } from '../elt/application/management.js';
 export { DETACHED_SYNC_PROVIDERS, DetachedSyncBusyError, startDetachedSync, } from '../elt/application/detached-sync.js';
 export type { DetachedSyncHandle, DetachedSyncProvider, DetachedSyncRequest, DetachedSyncSpawner } from '../elt/application/detached-sync.js';

package/dist/runtime/index.js

@@ -16,7 +16,7 @@ export { WELLNESS_METRICS, WellnessService } from '../core/query/wellness.js';
 export { jsonSafe, ReadOnlyRepository } from '../core/query/repository.js';
 export { queryReadOnlyData } from '../core/query/sql-guard.js';
 export { createDemoStore, demoStoreMetadata } from '../elt/application/demo.js';
-export { connectStrava, connectStravaWithCallback, dataStatus, disconnectStravaAccount, initializeDataStore, importStagedFile, linkActivity, rebuildRetrievalIndex, reimportNutrition, resolveExtractionErrors, retryDataSync, syncData, syncProgress, unlinkActivity, } from '../elt/application/management.js';
+export { connectStrava, connectStravaWithCallback, dataStatus, disconnectStravaAccount, initializeDataStore, importStagedFile, linkActivity, rebuildRetrievalIndex, reimportNutrition, reimportWeight, resolveExtractionErrors, retryDataSync, syncData, syncProgress, unlinkActivity, } from '../elt/application/management.js';
 export { DETACHED_SYNC_PROVIDERS, DetachedSyncBusyError, startDetachedSync, } from '../elt/application/detached-sync.js';
 export { buildOpenCodeGoConsoleProfiles, classifyOpenCodeGoModel, fetchOpenCodeGoModelIds, mergeOpenCodeGoConsoleProfiles, OPENCODE_GO_API_BASE_ENV, OPENCODE_GO_API_KEY_ENV, OPENCODE_GO_DEFAULT_BASE_URL, OPENCODE_GO_MESSAGES_API_BASE_ENV, } from '../core/runtime/opencode-go.js';
 export { CatenceDatabase, openReadOnlyRepository, ReadOnlyDatabaseError } from '../elt/storage/database.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "catence",
-  "version": "0.2.1-beta.4",
+  "version": "0.2.1-beta.6",
   "description": "Local MCP access to normalized Garmin, Intervals.icu, and targeted Strava fitness data.",
   "license": "AGPL-3.0-or-later",
   "repository": {