devgrowth 1.0.0 → 1.1.0

package/src/commands/start.js

@@ -1,91 +1,97 @@
-import * as configManager from '../core/configManager.js';
-import * as schedule from '../core/schedule.js';
-import * as timer from '../core/timer.js';
-import * as browser from '../core/browser.js';
-import * as logger from '../core/logger.js';
-import * as stats from '../core/stats.js';
-import { printBanner, VERSION } from '../core/banner.js';
-import chalk from 'chalk';
-
-export async function startCommand(options = {}) {
-  const config = await configManager.getConfig();
-  const today = schedule.getTodaySkill(config);
-
-  // Compact banner only — `start` is the focus moment, not a stats dashboard.
-  if (options.banner !== false) {
-    await printBanner({
-      compact: true,
-      context: { version: VERSION, initialized: true, skill: today.skill, focus: today.focus }
-    });
-  }
-
-  if (today.skill === 'rest') {
-    console.log(chalk.green('☀️  Sunday is rest day. System is still alive. Come back tomorrow at 9 PM.'));
-    return;
-  }
-
-  if (today.skill === 'review') {
-    console.log(chalk.blue('📋 Saturday — Weekly Review Day'));
-    console.log('Open your log file and read all 5 logs from this week.');
-    console.log('Ask: Did I show up? What pattern do I see? What needs more time next week?');
-    console.log(chalk.gray('Run `devgrowth review` when you are done.'));
-    return;
-  }
-
-  const isLight = options.light || false;
-  const now = schedule.getSessionDate(new Date());
-
-  console.log(chalk.bold(`\n🎯 Tonight: ${today.skill.toUpperCase()} — ${today.focus}`));
-  console.log(chalk.gray(`Resource: ${today.resource || 'N/A'}`));
-
-  if (isLight) {
-    console.log(chalk.yellow('\n🟡 Light session mode — timer skipped.'));
-    console.log('Just write your log and close.\n');
-    return;
-  }
-
-  // Warm-up prompt
-  console.log(chalk.cyan('\n⏱️  Warm up: Read yesterday\'s log (2 min)...'));
-
-  // Open resource
-  if (today.url) {
-    console.log(chalk.gray(`Opening ${today.url}...`));
-    try {
-      await browser.openUrl(today.url);
-    } catch {
-      console.log(chalk.yellow(`⚠️  Could not open the browser (offline?). Visit manually: ${today.url}`));
-    }
-  }
-
-  // Start timer
-  const duration = config.session?.durationMinutes || 20;
-  console.log(chalk.bold(`\n🔥 Deep work: ${duration} minutes`));
-  console.log(chalk.gray('Press Ctrl+C to interrupt\n'));
-
-  const timerResult = await timer.start(duration * 60, {
-    onTick: (remaining) => {
-      const mins = Math.floor(remaining / 60);
-      const secs = remaining % 60;
-      const line = `${chalk.yellow('⏳')} ${String(mins).padStart(2, '0')}:${String(secs).padStart(2, '0')} remaining`;
-      process.stdout.write(`\r\x1b[K${line}`);
-    },
-    onWarning: () => {
-      console.log(chalk.yellow('\n⚠️  1 minute left. Wrap up.'));
-    },
-    onComplete: () => {
-      console.log(chalk.green('\n✅ Session complete!'));
-    }
-  });
-
-  process.stdout.write('\n');
-
-  if (timerResult.interrupted) {
-    console.log(chalk.red('\n⏹️  Session interrupted. Saving partial log...'));
-    await logger.writeLogEntry(now, today.skill, today.resource, duration, 'Interrupted', 'Session was interrupted.');
-    await stats.recordSession(now, today.skill, 0, 'Interrupted');
-    return;
-  }
-
-  console.log(chalk.green('\n📝 Time to log. Run:'));
-  console.log(chalk.bold('   devgrowth log "Today I learned ___. Tomorrow I will ___."\n'));
-}
+import * as configManager from '../core/configManager.js';
+import * as schedule from '../core/schedule.js';
+import * as timer from '../core/timer.js';
+import * as browser from '../core/browser.js';
+import * as logger from '../core/logger.js';
+import * as stats from '../core/stats.js';
+import * as eventLog from '../core/eventLog.js';
+import * as sync from '../core/sync.js';
+import { printBanner, VERSION } from '../core/banner.js';
+import chalk from 'chalk';
+
+export async function startCommand(options = {}) {
+  const config = await configManager.getConfig();
+  const today = schedule.getTodaySkill(config);
+
+  // Compact banner only — `start` is the focus moment, not a stats dashboard.
+  if (options.banner !== false) {
+    await printBanner({
+      compact: true,
+      context: { version: VERSION, initialized: true, skill: today.skill, focus: today.focus }
+    });
+  }
+
+  if (today.skill === 'rest') {
+    console.log(chalk.green('☀️  Sunday is rest day. System is still alive. Come back tomorrow at 9 PM.'));
+    return;
+  }
+
+  if (today.skill === 'review') {
+    console.log(chalk.blue('📋 Saturday — Weekly Review Day'));
+    console.log('Open your log file and read all 5 logs from this week.');
+    console.log('Ask: Did I show up? What pattern do I see? What needs more time next week?');
+    console.log(chalk.gray('Run `devgrowth review` when you are done.'));
+    return;
+  }
+
+  const isLight = options.light || false;
+  const now = schedule.getSessionDate(new Date());
+
+  console.log(chalk.bold(`\n🎯 Tonight: ${today.skill.toUpperCase()} — ${today.focus}`));
+  console.log(chalk.gray(`Resource: ${today.resource || 'N/A'}`));
+
+  if (isLight) {
+    console.log(chalk.yellow('\n🟡 Light session mode — timer skipped.'));
+    console.log('Just write your log and close.\n');
+    return;
+  }
+
+  // Warm-up prompt
+  console.log(chalk.cyan('\n⏱️  Warm up: Read yesterday\'s log (2 min)...'));
+
+  // Open resource
+  if (today.url) {
+    console.log(chalk.gray(`Opening ${today.url}...`));
+    try {
+      await browser.openUrl(today.url);
+    } catch {
+      console.log(chalk.yellow(`⚠️  Could not open the browser (offline?). Visit manually: ${today.url}`));
+    }
+  }
+
+  // Start timer
+  const duration = config.session?.durationMinutes || 20;
+  console.log(chalk.bold(`\n🔥 Deep work: ${duration} minutes`));
+  console.log(chalk.gray('Press Ctrl+C to interrupt\n'));
+
+  const timerResult = await timer.start(duration * 60, {
+    onTick: (remaining) => {
+      const mins = Math.floor(remaining / 60);
+      const secs = remaining % 60;
+      const line = `${chalk.yellow('⏳')} ${String(mins).padStart(2, '0')}:${String(secs).padStart(2, '0')} remaining`;
+      process.stdout.write(`\r\x1b[K${line}`);
+    },
+    onWarning: () => {
+      console.log(chalk.yellow('\n⚠️  1 minute left. Wrap up.'));
+    },
+    onComplete: () => {
+      console.log(chalk.green('\n✅ Session complete!'));
+    }
+  });
+
+  process.stdout.write('\n');
+
+  if (timerResult.interrupted) {
+    console.log(chalk.red('\n⏹️  Session interrupted. Saving partial log...'));
+    await logger.writeLogEntry(now, today.skill, today.resource, duration, 'Interrupted', 'Session was interrupted.');
+    await stats.recordSession(now, today.skill, 0, 'Interrupted');
+    await eventLog.recordSession(now, {
+      skill: today.skill, resource: today.resource, duration, status: 'Interrupted', message: 'Session was interrupted.'
+    });
+    await sync.trySync();
+    return;
+  }
+
+  console.log(chalk.green('\n📝 Time to log. Run:'));
+  console.log(chalk.bold('   devgrowth log "Today I learned ___. Tomorrow I will ___."\n'));
+}

package/src/commands/status.js

@@ -1,53 +1,55 @@
-import * as configManager from '../core/configManager.js';
-import * as schedule from '../core/schedule.js';
-import * as stats from '../core/stats.js';
-import * as logger from '../core/logger.js';
-import chalk from 'chalk';
-
-const DAYS = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'];
-
-export async function statusCommand() {
-  const config = await configManager.getConfig();
-  const status = await stats.getStatus();
-  const now = new Date();
-  const weekStart = schedule.getWeekStart(now);
-
-  console.log(chalk.bold(`\nWeek ${schedule.getWeekNumber(now)} (${schedule.formatShortDate(weekStart)} – ${schedule.formatShortDate(addDays(weekStart, 6))})`));
-  console.log(chalk.gray('─'.repeat(50)));
-
-  // The whole week lives in a single log file keyed by the Monday's year/month
-  const logYear = weekStart.getFullYear();
-  const logMonth = String(weekStart.getMonth() + 1).padStart(2, '0');
-  const logs = await logger.readWeekLogs(logYear, logMonth, `week${schedule.getWeekNumber(now)}.md`);
-
-  for (let i = 0; i < 7; i++) {
-    const dayDate = addDays(weekStart, i);
-    const dayKey = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'][i];
-    const dayConfig = config.schedule[dayKey];
-
-    const dayStr = schedule.formatShortDate(dayDate);
-    // Match against the markdown header to avoid false positives
-    const headerPattern = new RegExp(`^## ${DAYS[i]}, ${dayStr}`, 'm');
-    const hasLog = headerPattern.test(logs);
-    const emoji = hasLog ? '✅' : (isToday(dayDate, now) ? '⬜' : '◻');
-    const label = hasLog ? chalk.green(dayConfig.skill) : chalk.gray(dayConfig.skill);
-
-    console.log(`${emoji}  ${DAYS[i].padEnd(3)}  ${label.padEnd(10)}  ${hasLog ? chalk.dim('Logged') : (isToday(dayDate, now) ? chalk.yellow('Today') : '—')}`);
-  }
-
-  console.log(chalk.gray('─'.repeat(50)));
-  console.log(`${status.currentWeek.completed}/5 sessions this week | Streak: ${chalk.bold(status.currentStreakWeeks)} weeks | Longest: ${status.longestStreakWeeks}`);
-  console.log();
-}
-
-function addDays(date, days) {
-  const result = new Date(date);
-  result.setDate(result.getDate() + days);
-  return result;
-}
-
-function isToday(d1, d2) {
-  return d1.getFullYear() === d2.getFullYear() &&
-         d1.getMonth() === d2.getMonth() &&
-         d1.getDate() === d2.getDate();
-}
+import * as configManager from '../core/configManager.js';
+import * as schedule from '../core/schedule.js';
+import * as stats from '../core/stats.js';
+import * as logger from '../core/logger.js';
+import * as sync from '../core/sync.js';
+import chalk from 'chalk';
+
+const DAYS = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'];
+
+export async function statusCommand() {
+  await sync.trySync();
+  const config = await configManager.getConfig();
+  const status = await stats.getStatus();
+  const now = new Date();
+  const weekStart = schedule.getWeekStart(now);
+
+  console.log(chalk.bold(`\nWeek ${schedule.getWeekNumber(now)} (${schedule.formatShortDate(weekStart)} – ${schedule.formatShortDate(addDays(weekStart, 6))})`));
+  console.log(chalk.gray('─'.repeat(50)));
+
+  // The whole week lives in a single log file keyed by the Monday's year/month
+  const logYear = weekStart.getFullYear();
+  const logMonth = String(weekStart.getMonth() + 1).padStart(2, '0');
+  const logs = await logger.readWeekLogs(logYear, logMonth, `week${schedule.getWeekNumber(now)}.md`);
+
+  for (let i = 0; i < 7; i++) {
+    const dayDate = addDays(weekStart, i);
+    const dayKey = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'][i];
+    const dayConfig = config.schedule[dayKey];
+
+    const dayStr = schedule.formatShortDate(dayDate);
+    // Match against the markdown header to avoid false positives
+    const headerPattern = new RegExp(`^## ${DAYS[i]}, ${dayStr}`, 'm');
+    const hasLog = headerPattern.test(logs);
+    const emoji = hasLog ? '✅' : (isToday(dayDate, now) ? '⬜' : '◻');
+    const label = hasLog ? chalk.green(dayConfig.skill) : chalk.gray(dayConfig.skill);
+
+    console.log(`${emoji}  ${DAYS[i].padEnd(3)}  ${label.padEnd(10)}  ${hasLog ? chalk.dim('Logged') : (isToday(dayDate, now) ? chalk.yellow('Today') : '—')}`);
+  }
+
+  console.log(chalk.gray('─'.repeat(50)));
+  console.log(`${status.currentWeek.completed}/5 sessions this week | Streak: ${chalk.bold(status.currentStreakWeeks)} weeks | Longest: ${status.longestStreakWeeks}`);
+  console.log();
+}
+
+function addDays(date, days) {
+  const result = new Date(date);
+  result.setDate(result.getDate() + days);
+  return result;
+}
+
+function isToday(d1, d2) {
+  return d1.getFullYear() === d2.getFullYear() &&
+         d1.getMonth() === d2.getMonth() &&
+         d1.getDate() === d2.getDate();
+}

package/src/commands/sync.js

@@ -0,0 +1,29 @@
+import chalk from 'chalk';
+import * as auth from '../core/auth.js';
+import * as eventLog from '../core/eventLog.js';
+import * as sync from '../core/sync.js';
+
+async function showStatus() {
+  const session = await auth.getAuth();
+  if (!session) {
+    console.log('Not logged in. Run `devgrowth login` to sync across devices.');
+    return;
+  }
+  const state = await eventLog.getSyncState();
+  console.log(chalk.bold('Sync'));
+  console.log(`  Account:     ${session.email}`);
+  console.log(`  Server:      ${session.apiUrl}`);
+  console.log(`  Pending:     ${state.outbox.length} change(s) not yet uploaded`);
+  console.log(`  Last synced: ${state.lastSyncAt ? new Date(state.lastSyncAt).toLocaleString() : 'never'}`);
+}
+
+export async function syncCommand(subcommand) {
+  if (subcommand === 'status') return showStatus();
+  if (subcommand !== undefined) {
+    console.error(chalk.red(`Unknown subcommand: ${subcommand}`));
+    console.log('Usage: devgrowth sync [status]');
+    process.exit(1);
+  }
+  const { pushed, pulled } = await sync.sync();
+  console.log(chalk.green(`✓ Synced: ${pushed} uploaded, ${pulled} downloaded.`));
+}

package/src/core/apiClient.js

@@ -0,0 +1,46 @@
+// Minimal client for the devgrowth-cloud API, on Node 18+'s built-in fetch.
+
+export class ApiError extends Error {
+  constructor(status, code, message, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+  }
+}
+
+/**
+ * `request(apiUrl, 'POST', '/v1/events', { token, body, timeoutMs })`.
+ * Resolves to the parsed JSON body (null for 204). Throws ApiError, with
+ * status 0 and code `network_error` when the server can't be reached in time.
+ */
+export async function request(apiUrl, method, apiPath, { token, body, timeoutMs = 10000 } = {}) {
+  const headers = {};
+  if (token) headers.authorization = `Bearer ${token}`;
+  if (body !== undefined) headers['content-type'] = 'application/json';
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  let res;
+  try {
+    res = await fetch(`${apiUrl.replace(/\/+$/, '')}${apiPath}`, {
+      method,
+      headers,
+      body: body === undefined ? undefined : JSON.stringify(body),
+      signal: controller.signal
+    });
+  } catch (err) {
+    const reason = err.name === 'AbortError' ? 'timed out' : (err.cause?.code || err.message);
+    throw new ApiError(0, 'network_error', `Could not reach ${apiUrl} (${reason})`);
+  } finally {
+    clearTimeout(timer);
+  }
+
+  if (res.status === 204) return null;
+  const data = await res.json().catch(() => null);
+  if (!res.ok) {
+    const err = data?.error;
+    throw new ApiError(res.status, err?.code ?? 'http_error', err?.message ?? `Request failed (${res.status})`, err?.details);
+  }
+  return data;
+}

package/src/core/auth.js

@@ -0,0 +1,34 @@
+import * as storage from './storage.js';
+import * as path from 'path';
+
+// ~/.devgrowth/auth.json: { apiUrl, token, userId, deviceId, email }.
+// The token is a credential, so the file is readable by its owner only.
+
+export const DEFAULT_API_URL = 'http://localhost:3000';
+
+function authPath() {
+  return path.join(storage.getDevGrowthDir(), 'auth.json');
+}
+
+export async function getAuth() {
+  const file = authPath();
+  return (await storage.fileExists(file)) ? await storage.readJson(file) : null;
+}
+
+export async function saveAuth(auth) {
+  await storage.writeJson(authPath(), auth, { mode: 0o600 });
+}
+
+export async function clearAuth() {
+  await storage.removePath(authPath());
+}
+
+export async function isLoggedIn() {
+  return (await getAuth()) !== null;
+}
+
+/** Where to find the server: flag, then env, then the saved login, then localhost. */
+export async function resolveApiUrl(flag) {
+  const saved = await getAuth();
+  return (flag || process.env.DEVGROWTH_API_URL || saved?.apiUrl || DEFAULT_API_URL).replace(/\/+$/, '');
+}