catence 0.2.0-beta.20 → 0.2.0-beta.21

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.0-beta.20";
+export declare const CATENCE_RUNTIME_VERSION = "0.2.0-beta.21";
 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.0-beta.20';
+export const CATENCE_RUNTIME_VERSION = '0.2.0-beta.21';
 export const CATENCE_PROTOCOL_VERSION = 1;
 export function catenceRuntimeHealth() {
     return {

package/dist/interfaces/http/generation-status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Read + classify the generation progress sidecar written by the Catence
+ * Console agent turn (see `catence_console/generation_sidecar.py`). Mirrors the
+ * detached-sync sidecar logic: a run is "running" until it reaches a terminal
+ * stage, and "stale" (i.e. likely stuck) when its heartbeat is older than the
+ * threshold. This powers the chat UI's "still thinking vs stalled" signal.
+ */
+export interface GenerationStatus {
+    threadId: string;
+    stage?: string;
+    running: boolean;
+    stale: boolean;
+    heartbeatAt?: string;
+    startedAt?: string;
+    updatedAt?: string;
+    toolCallCount: number;
+    lastTool?: string | null;
+}
+export declare function generationStatus(homeRoot: string, threadId: string): Promise<GenerationStatus>;

package/dist/interfaces/http/generation-status.js

@@ -0,0 +1,55 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+const TERMINAL_STAGES = new Set([
+    'completed',
+    'failed',
+    'interrupted',
+    'timed_out'
+]);
+const STALE_MS = 5 * 60 * 1000; // 5 minutes
+function emptyStatus(threadId) {
+    return {
+        threadId,
+        running: false,
+        stale: false,
+        toolCallCount: 0
+    };
+}
+export async function generationStatus(homeRoot, threadId) {
+    const safe = threadId.replace(/[^a-zA-Z0-9_-]/g, '');
+    if (!safe)
+        return emptyStatus(threadId);
+    const file = path.join(homeRoot, 'generation', `${safe}.generation.json`);
+    let raw;
+    try {
+        raw = await readFile(file, 'utf8');
+    }
+    catch {
+        return emptyStatus(threadId);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return emptyStatus(threadId);
+    }
+    const base = {
+        threadId,
+        stage: typeof data.stage === 'string' ? data.stage : undefined,
+        heartbeatAt: typeof data.heartbeatAt === 'string' ? data.heartbeatAt : undefined,
+        startedAt: typeof data.startedAt === 'string' ? data.startedAt : undefined,
+        updatedAt: typeof data.updatedAt === 'string' ? data.updatedAt : undefined,
+        toolCallCount: typeof data.toolCallCount === 'number' ? data.toolCallCount : 0,
+        lastTool: data.lastTool === null || typeof data.lastTool === 'string'
+            ? data.lastTool
+            : undefined
+    };
+    if (base.stage && TERMINAL_STAGES.has(base.stage)) {
+        return { ...base, running: false, stale: false };
+    }
+    const hb = base.heartbeatAt ? Date.parse(base.heartbeatAt) : NaN;
+    const stale = !Number.isFinite(hb) || Date.now() - hb > STALE_MS;
+    return { ...base, running: true, stale };
+}
+//# sourceMappingURL=generation-status.js.map

package/dist/interfaces/http/server.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { catenceRuntimeHealth, DashboardSnapshotService, DetachedSyncBusyError, DETACHED_SYNC_PROVIDERS, jsonSafe, loadCatalog, mergeOpenCodeGoConsoleProfiles, openReadOnlyRepository, resolveAthlete, resolveCatalogPaths, startDetachedSync, syncProgress, } from '../../runtime/index.js';
 import { createCatenceMcpServer } from '../mcp/server.js';
+import { generationStatus } from './generation-status.js';
 const MAX_REQUEST_BYTES = 1_000_000;
 function json(response, statusCode, value) {
     const body = JSON.stringify(jsonSafe(value));
@@ -239,6 +240,10 @@ export function createCatenceHttpServer(options = {}) {
                 json(response, 200, catenceRuntimeHealth());
                 return;
             }
+            if (pathname === '/api/v1/health' && request.method === 'GET') {
+                json(response, 200, catenceRuntimeHealth());
+                return;
+            }
             if (pathname === '/api/v1/athletes' && request.method === 'GET') {
                 if (!catalogPaths) {
                     json(response, 200, { defaultAthleteId: 'local', athletes: [{ id: 'local', label: 'Local athlete' }] });
@@ -335,6 +340,31 @@ export function createCatenceHttpServer(options = {}) {
                 }
                 return;
             }
+            if (pathname.startsWith('/api/v1/threads/') &&
+                pathname.endsWith('/generation') &&
+                request.method === 'GET') {
+                try {
+                    const segments = pathname.split('/').filter(Boolean);
+                    const threadId = segments[segments.length - 2];
+                    if (!threadId)
+                        throw new Error('Missing threadId in request path.');
+                    const base = (catalogPaths ?? staticPaths ?? resolveCatalogPaths());
+                    const root = base?.root;
+                    if (!root || typeof root !== 'string') {
+                        throw new Error('No Catence data store is configured.');
+                    }
+                    json(response, 200, await generationStatus(root, threadId));
+                }
+                catch (error) {
+                    json(response, 400, {
+                        error: {
+                            code: 'generation_status_unavailable',
+                            message: error instanceof Error ? error.message : String(error)
+                        }
+                    });
+                }
+                return;
+            }
             if (pathname === '/mcp') {
                 await handleMcpRequest(request, response, catalogPaths ?? staticPaths ?? resolveCatalogPaths());
                 return;

package/docs/development.md

@@ -321,6 +321,10 @@ Recommended dev defaults:
 - The deployed scaffold's `sync.sh` / `hash-password.sh` / `doctor.sh` helpers are generated by `scripts/deploy-console.sh`; the dev container does not generate them — use the `npm run` / `uv run` equivalents above, or run the same `catence-data --home /data` commands via `docker compose exec`.
 - If the Console settings panel shows no Model dropdown, the data home's `config.json` has no `console.profiles` — re-copy `config.example.json` or re-run the discovery script, then restart the Console.
 
+### Status vs Dashboard
+
+The **Dashboard** (`/dashboard`) is now a pure analytics view — it renders charts and recent activities from `GET /api/v1/dashboard` and, when a detached sync holds the DuckDB write lock, shows a non-blocking amber banner (“Data temporarily unavailable — a sync is running. View live progress on the Status page.”) instead of a full-page `dashboard_unavailable` error. The **Status** page (`/status`) is the lock-safe control plane: it reads `GET /api/v1/health` (runtime `catenceRuntimeHealth()`), `GET /api/v1/sync/status` (sidecar heartbeats + `lastSync`), and `GET /api/v1/athletes` (roster), so it never needs a successful `dashboardSnapshot` and never 400s under lock. The interactive **Sync** button (with instant grey-out via `startingRef`) lives only on Status; Dashboard keeps a read-only “Syncing…” pill and a “Sync moved to Status →” banner.
+
 ## Troubleshooting
 
 - **Doctor reports runtime unreachable** — the Console was started without `--mcp-url` and its auto-started runtime is on a different port. Start the runtime explicitly and pass `--mcp-url http://127.0.0.1:8787/mcp` to the Console, or use `uv run --project console catence-console doctor --home "$CATENCE_HOME" --mcp-url http://127.0.0.1:8787/mcp`.

package/package.json

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