incremnt 0.1.18 → 0.2.0

package/src/contract.js

@@ -1,4 +1,4 @@
-export const contractVersion = 4;
+export const contractVersion = 5;
 
 export const capabilities = {
   readOnly: false,
@@ -225,6 +225,8 @@ export const officialCommands = [
   ...writeCommandSchema.map((c) => c.usage ?? c.command),
   'status',
   'contract',
+  'browse',
+  'tui',
   'login',
   'login --base-url <base-url>',
   'login --snapshot <snapshot-file>',

package/src/format.js

@@ -221,6 +221,133 @@ function formatProgramList(payload) {
   return lines.join('\n');
 }
 
+function formatGoalsShow(payload) {
+  if (!payload) {
+    return 'Goal plan not found.';
+  }
+
+  const lines = [` ${chalk.bold('GOAL PLAN')}${dimDot()}${payload.status ?? 'unknown'}`, ''];
+
+  lines.push(keyValue('Plan', payload.planId));
+  if (payload.programId) {
+    lines.push(keyValue('Program', payload.programId));
+  }
+  lines.push(keyValue('Level', String(payload.strengthLevel ?? 'unknown')));
+  lines.push(keyValue('Duration', `${payload.durationWeeks ?? '?'} weeks`));
+
+  if (payload.startDate) {
+    lines.push(keyValue('Start', formatShortDate(payload.startDate)));
+  }
+
+  if (payload.finishDate) {
+    lines.push(keyValue('Finish', formatShortDate(payload.finishDate)));
+  }
+
+  lines.push('');
+  lines.push(` ${chalk.bold('Lift goals')}`);
+
+  for (const goal of payload.liftGoals ?? []) {
+    const progress = goal.progressPercent != null ? ` ${chalk.dim(`(${goal.progressPercent}%)`)}` : '';
+    const current = goal.currentBestE1RM != null ? `${goal.currentBestE1RM} kg` : 'n/a';
+    const target = goal.targetE1RM != null ? `${goal.targetE1RM} kg` : 'n/a';
+    const weight = goal.currentBestWeight != null ? `${goal.currentBestWeight} kg` : 'n/a';
+    const reps = goal.currentBestReps != null ? `${goal.currentBestReps} reps` : 'n/a';
+    const estimated = `best ${weight} x ${reps} → ${current}`;
+    lines.push(`   ${chalk.bold(goal.exerciseName)}${progress}`);
+    lines.push(`     ${chalk.dim(estimated)}${dimDot()}${chalk.dim(`target ${target}`)}`);
+  }
+
+  if ((payload.liftGoals ?? []).length === 0) {
+    lines.push(`   ${chalk.dim('No lift goals found.')}`);
+  }
+
+  return lines.join('\n');
+}
+
+function formatTrainingLoad(payload) {
+  if (!payload?.available) {
+    return 'No training load data found.';
+  }
+
+  const lines = [` ${chalk.bold('TRAINING LOAD')}${dimDot()}${payload.status}`, ''];
+
+  lines.push(keyValue('Coverage', `${payload.coverageDays} days`));
+  lines.push(keyValue('Baseline', payload.baselineEstablished ? 'established' : 'building'));
+  lines.push(keyValue('7-day avg', String(payload.last7Days?.avgPerDay ?? 0)));
+  lines.push(keyValue('28-day avg', String(payload.last28Days?.avgPerDay ?? 0)));
+
+  if (payload.readiness) {
+    lines.push(keyValue('Readiness', `ATL ${payload.readiness.atl} / CTL ${payload.readiness.ctl} / TSB ${payload.readiness.tsb}`));
+  }
+
+  lines.push('');
+  lines.push(` ${payload.statusDescription ?? ''}`.trimEnd());
+
+  if (payload.byType && Object.keys(payload.byType).length > 0) {
+    lines.push('');
+    lines.push(` ${chalk.bold('By type')}`);
+    for (const [type, stats] of Object.entries(payload.byType)) {
+      lines.push(`   ${type.padEnd(12)} ${chalk.dim(`${stats.count} workouts, ${Math.round(stats.totalEffort)} load, ${stats.totalDurationMins} min`)}`);
+    }
+  }
+
+  if (payload.recentWorkouts?.length > 0) {
+    lines.push('');
+    lines.push(` ${chalk.bold('Recent workouts')}`);
+    for (const workout of payload.recentWorkouts.slice(0, 6)) {
+      const duration = workout.durationMins != null ? ` ${workout.durationMins} min` : '';
+      const hr = workout.avgHR != null ? ` ${workout.avgHR} bpm` : '';
+      lines.push(`   ${formatShortDate(workout.date).padEnd(8)} ${chalk.bold(workout.type)}${dimDot()}${chalk.dim(`effort ${workout.estimatedEffort ?? '?'}`)}${duration}${hr}`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+function formatHealthSummary(payload) {
+  if (!payload?.available) {
+    return 'No health data found.';
+  }
+
+  const lines = [` ${chalk.bold('HEALTH SUMMARY')}${dimDot()}last ${payload.days ?? 14} days`, ''];
+
+  if (payload.restingHR?.avg != null) {
+    lines.push(keyValue('Resting HR', `${payload.restingHR.avg} bpm`));
+  }
+
+  if (payload.hrv?.avg != null) {
+    lines.push(keyValue('HRV', `${payload.hrv.avg} ms`));
+  }
+
+  if (payload.vo2Max?.latest?.value != null) {
+    lines.push(keyValue('VO2 max', `${payload.vo2Max.latest.value}`));
+  }
+
+  if (payload.sleep?.avgHours != null) {
+    lines.push(keyValue('Sleep', `${payload.sleep.avgHours} h`));
+  }
+
+  if (payload.bodyWeight?.latest?.value != null) {
+    lines.push(keyValue('Body weight', `${payload.bodyWeight.latest.value} kg`));
+  }
+
+  if (payload.respiratoryRate?.avg != null) {
+    lines.push(keyValue('Resp. rate', `${payload.respiratoryRate.avg}`));
+  }
+
+  if (payload.bodyTemperature?.avg != null) {
+    lines.push(keyValue('Temp', `${payload.bodyTemperature.avg}`));
+  }
+
+  if (payload.trainingLoad?.available) {
+    lines.push('');
+    lines.push(` ${chalk.bold('Training load')}`);
+    lines.push(`   ${chalk.dim(payload.trainingLoad.statusDescription ?? 'No status available.')}`);
+  }
+
+  return lines.join('\n');
+}
+
 function formatProgramDetail(payload) {
   if (!payload) {
     return 'Program not found.';
@@ -538,6 +665,8 @@ export function formatHelp(opts = {}) {
     cmd('logout', 'Clear session'),
     '',
     header('OTHER'),
+    cmd('browse', 'Interactive Ink browser'),
+    cmd('tui', 'Alias for browse'),
     cmd('status', 'Connection & auth info'),
     cmd('contract', 'API contract info'),
     cmd('--json', 'Force JSON output'),
@@ -561,8 +690,11 @@ export function formatPretty(command, payload) {
     'program-summary': formatProgramSummary,
     'program-list': formatProgramList,
     'program-detail': formatProgramDetail,
+    'goals-show': formatGoalsShow,
     'planned-vs-actual': formatPlannedVsActual,
     'why-did-this-change': formatWhyDidThisChange,
+    'training-load': formatTrainingLoad,
+    'health-summary': formatHealthSummary,
     'cycle-summary-list': formatCycleSummaryList,
     'cycle-summary-show': formatCycleSummaryShow,
     'ask-history': formatAskHistory,

package/src/lib.js

@@ -15,6 +15,7 @@ import { clearSessionState, isSessionExpired, readSessionState, resolveConfigDir
 import { createTransport } from './transport.js';
 import { formatPretty, formatHelp } from './format.js';
 import { printLogo } from './logo.js';
+import { runBrowseCli } from './browse.js';
 
 function parseArgs(argv) {
   const commandTokens = [];
@@ -66,7 +67,9 @@ export async function runCli(argv, stdout, stderr) {
     explain: 'why-did-this-change',
     propose: 'programs-propose',
     proposals: 'programs-proposals',
-    dismiss: 'proposal-dismiss'
+    dismiss: 'proposal-dismiss',
+    browse: 'browse',
+    tui: 'browse'
   })[command] ?? command;
 
   const sessionState = await readSessionState();
@@ -325,6 +328,15 @@ export async function runCli(argv, stdout, stderr) {
     return 1;
   }
 
+  if (normalizedCommand === 'browse') {
+    if (!(stdout.isTTY ?? false) || !(process.stdin.isTTY ?? false)) {
+      stderr.write('browse requires an interactive TTY.\n');
+      return 1;
+    }
+
+    return runBrowseCli({ transport, stdout, stderr, options });
+  }
+
   const wantJson = options.json || !(stdout.isTTY ?? false);
   const explicitJson = Boolean(options.json);
 

package/src/logo.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import process from 'node:process';
 
 const startColor = { r: 0, g: 255, b: 163 }; // #00ffa3
 const endColor = { r: 59, g: 130, b: 246 };  // #3b82f6
@@ -30,46 +31,61 @@ const lineLength = rawLines[0].length + SHADOW_OFFSET_X;
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
-export async function printLogo(stdout = process.stdout) {
+function buildLogoLine(row, gradientStartIdx) {
+  let lineStr = '';
+
+  for (let c = 0; c < lineLength; c++) {
+    const fgY = row;
+    const fgX = c;
+    const hasFg = (fgY >= 0 && fgY < 5 && fgX >= 0 && fgX < rawLines[0].length && rawLines[fgY][fgX] === '#');
+
+    const bgY = row - SHADOW_OFFSET_Y;
+    const bgX = c - SHADOW_OFFSET_X;
+    const hasBg = (bgY >= 0 && bgY < 5 && bgX >= 0 && bgX < rawLines[0].length && rawLines[bgY][bgX] === '#');
+
+    if (hasFg) {
+      if (fgX < gradientStartIdx) {
+        lineStr += chalk.white('█');
+      } else {
+        const factor = Math.max(0, Math.min(1, (fgX - gradientStartIdx) / (rawLines[0].length - gradientStartIdx - 2)));
+        const col = interpolateColor(startColor, endColor, factor);
+        lineStr += chalk.rgb(col.r, col.g, col.b)('█');
+      }
+    } else if (hasBg) {
+      const shadowFactor = 0.35;
+      if (bgX < gradientStartIdx) {
+        lineStr += chalk.rgb(Math.round(255 * shadowFactor), Math.round(255 * shadowFactor), Math.round(255 * shadowFactor))('█');
+      } else {
+        const factor = Math.max(0, Math.min(1, (bgX - gradientStartIdx) / (rawLines[0].length - gradientStartIdx - 2)));
+        const col = interpolateColor(startColor, endColor, factor);
+        lineStr += chalk.rgb(Math.round(col.r * shadowFactor), Math.round(col.g * shadowFactor), Math.round(col.b * shadowFactor))('█');
+      }
+    } else {
+      lineStr += ' ';
+    }
+  }
+
+  return lineStr;
+}
+
+export function getLogoLines() {
   // Gradient starts at the 'M' character position
   // I: 0, N: 3, C: 14, R: 21, E: 29, M: 37
   const gradientStartIdx = 37;
+  const lines = [];
 
-  stdout.write('\n');
   for (let r = 0; r < totalLines; r++) {
-    let lineStr = '';
-
-    for (let c = 0; c < lineLength; c++) {
-      const fgY = r;
-      const fgX = c;
-      const hasFg = (fgY >= 0 && fgY < 5 && fgX >= 0 && fgX < rawLines[0].length && rawLines[fgY][fgX] === '#');
+    lines.push(buildLogoLine(r, gradientStartIdx));
+  }
 
-      const bgY = r - SHADOW_OFFSET_Y;
-      const bgX = c - SHADOW_OFFSET_X;
-      const hasBg = (bgY >= 0 && bgY < 5 && bgX >= 0 && bgX < rawLines[0].length && rawLines[bgY][bgX] === '#');
+  return lines;
+}
 
-      if (hasFg) {
-        if (fgX < gradientStartIdx) {
-          lineStr += chalk.white('█');
-        } else {
-          const factor = Math.max(0, Math.min(1, (fgX - gradientStartIdx) / (rawLines[0].length - gradientStartIdx - 2)));
-          const col = interpolateColor(startColor, endColor, factor);
-          lineStr += chalk.rgb(col.r, col.g, col.b)('█');
-        }
-      } else if (hasBg) {
-        const shadowFactor = 0.35;
-        if (bgX < gradientStartIdx) {
-          lineStr += chalk.rgb(Math.round(255 * shadowFactor), Math.round(255 * shadowFactor), Math.round(255 * shadowFactor))('█');
-        } else {
-          const factor = Math.max(0, Math.min(1, (bgX - gradientStartIdx) / (rawLines[0].length - gradientStartIdx - 2)));
-          const col = interpolateColor(startColor, endColor, factor);
-          lineStr += chalk.rgb(Math.round(col.r * shadowFactor), Math.round(col.g * shadowFactor), Math.round(col.b * shadowFactor))('█');
-        }
-      } else {
-        lineStr += ' ';
-      }
-    }
-    stdout.write(lineStr + '\n');
+export async function printLogo(stdout = process.stdout) {
+  const lines = getLogoLines();
+  stdout.write('\n');
+  for (const line of lines) {
+    stdout.write(`${line}\n`);
     await sleep(80);
   }
   stdout.write('\n');

package/src/mcp.js

@@ -2,6 +2,7 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -10,6 +11,8 @@ import { commandSchema, writeCommands, writeCommandSchema } from './contract.js'
 import { readSessionState } from './state.js';
 import { createTransport } from './transport.js';
 
+const globalScope = Function('return this')();
+
 function commandShape(cmd) {
   const shape = {};
 
@@ -48,9 +51,9 @@ export function registerMcpTools(server, {
           content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
         };
       } catch (error) {
-        const message = error?.message ?? String(error);
+        const message = error && error.message ? error.message : String(error);
 
-        if (error?.code === 'SNAPSHOT_NOT_FOUND') {
+        if (error && error.code === 'SNAPSHOT_NOT_FOUND') {
           return {
             content: [{ type: 'text', text: 'Not logged in. Run `incremnt login` first.' }],
             isError: true
@@ -77,12 +80,42 @@ export function createMcpServer(deps) {
   return registerMcpTools(server, deps);
 }
 
+export function createSandboxServer() {
+  const sandboxTransport = {
+    expired: false,
+    executeReadCommand: async (commandId) => ({
+      commandId,
+      sandbox: true,
+      ok: true
+    }),
+    executeWriteCommand: async (commandId) => ({
+      commandId,
+      sandbox: true,
+      ok: true
+    })
+  };
+
+  return createMcpServer({
+    readSessionStateFn: async () => ({}),
+    createTransportFn: async () => sandboxTransport
+  });
+}
+
 async function main() {
   const transport = new StdioServerTransport();
   const server = createMcpServer();
   await server.connect(transport);
 }
 
-if (process.argv[1] && fs.realpathSync(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url)) {
-  await main();
+const isDirectInvocation = process.argv[1]
+  && (
+    (typeof globalScope.__filename !== 'undefined' && fs.realpathSync(path.resolve(process.argv[1])) === globalScope.__filename)
+    || (typeof globalScope.__filename === 'undefined' && fs.realpathSync(path.resolve(process.argv[1])) === fileURLToPath(import.meta.url))
+  );
+
+if (isDirectInvocation) {
+  void main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });
 }