devgrowth 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EhDohWah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# DevGrowth CLI
+
+Zero-friction developer growth CLI for Saw Eh Doh Wah.
+
+## Installation
+
+```bash
+npm install
+npm link
+```
+
+## Windows Notification Setup
+
+```powershell
+# Requires devgrowth to be globally available (via npm link or installed globally)
+.\scripts\install-windows.ps1
+```
+
+## Usage
+
+```bash
+devgrowth                         # Splash banner + command list
+devgrowth banner                  # Banner with current stats
+devgrowth banner --compact        # Single-line banner
+devgrowth init                    # Initialize configuration
+devgrowth start                   # Start tonight's session
+devgrowth start --light           # Low-energy mode (skip timer)
+devgrowth start --no-banner       # Skip the startup banner
+devgrowth log "..."             # Write session log
+devgrowth log "..." --light     # Mark as light session
+devgrowth status                  # Show weekly progress
+devgrowth review                  # Weekly review (auto-saves review section)
+devgrowth milestone list          # Show achievement grid
+devgrowth milestone check laravel m1 formRequests  # Check off milestone
+devgrowth milestone progress laravel               # Show milestone progress
+devgrowth history                 # Browse current week logs
+devgrowth history --week 32       # View a specific week
+devgrowth history --week 1 --year 2027  # View week across year boundaries
+devgrowth history --skill laravel # Filter by skill
+devgrowth history --search "Form Request"  # Full-text search
+devgrowth config show             # View configuration
+devgrowth config set <key> <value>  # Update configuration
+devgrowth config edit             # Open config in default editor
+```
+
+## Banner
+
+Running `devgrowth` with no arguments shows a splash screen: the `devGrowth`
+wordmark in block letters with the turtle riding beside it, then tonight's
+skill, weekly progress, and your streak. `devgrowth start` shows a one-line
+version of it.
+
+```
+    █             ▄▀▀▀▄                     ▄   █      　　  ＿＿　　　＿
+ ▄▄▄█  ▄▄▄  ▄   ▄ █     ▄ ▄▄   ▄▄▄  ▄   ▄  ▄█▄  █ ▄▄   　 ／ ♯ ＃ ＼　/･_)
+█   █ █▄▄▄█ █   █ █ ▀▀█ █▀    █   █ █ ▄ █   █   █▀  █  （ｿ♯ ＃ ♯ ＃Ｙ ／
+▀▄▄▄█ ▀▄▄▄   ▀▄▀  ▀▄▄▄█ █     ▀▄▄▄▀ █▀ ▀█   █▄▄ █   █  　(_)――-(_)′
+
+Saw Eh Doh Wah@DESKTOP-BOD610M · v1.0.0
+──────────────────────────────────────────────────────────────────────────
+Tonight   laravel — Deepen
+Resource  Laravel Daily
+Session   21:00 · 20 min
+Week 36   ░░░░░ 0/5 sessions
+Streak    0 weeks (best: 0)
+Totals    1 session · 0 min
+Data      ~/.devgrowth
+```
+
+The banner is suppressed automatically when output is not a TTY, so piping and
+scheduled runs stay clean:
+
+```bash
+devgrowth config show | jq .      # no banner
+```
+
+| Control | Effect |
+| --- | --- |
+| `DEVGROWTH_NO_BANNER=1` | Never show the banner |
+| `DEVGROWTH_BANNER=1` | Show it even when piped |
+| `--no-banner` | Skip it for one `devgrowth start` |
+| `NO_COLOR=1` | Banner without color (handled by chalk) |
+
+Terminals narrower than the 74-column header automatically fall back to the
+one-line banner, so the layout never wraps.
+
+## Troubleshooting
+
+- If `devgrowth` command is not found after `npm install`, run `npm link` from the project directory.
+- Windows install script requires the CLI to be in PATH. Ensure `npm link` has been run first.

package/bin/devgrowth.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { program } from '../src/index.js';
+program.parse();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "devgrowth",
+  "version": "1.0.0",
+  "description": "Zero-friction developer growth CLI",
+  "type": "module",
+  "keywords": [
+    "cli",
+    "productivity",
+    "habit-tracker",
+    "developer-growth",
+    "learning"
+  ],
+  "homepage": "https://github.com/EhDohWah/devgrowth#readme",
+  "bugs": {
+    "url": "https://github.com/EhDohWah/devgrowth/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EhDohWah/devgrowth.git"
+  },
+  "license": "MIT",
+  "author": "EhDohWah <ehdohwah007@gmail.com>",
+  "files": [
+    "bin",
+    "src",
+    "scripts"
+  ],
+  "bin": {
+    "devgrowth": "bin/devgrowth.js"
+  },
+  "scripts": {
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
+    "test:win": "set NODE_OPTIONS=--experimental-vm-modules && jest --coverage"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "node-notifier": "^10.0.1",
+    "open": "^9.1.0"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/install-windows.ps1

@@ -0,0 +1,28 @@
+#Requires -RunAsAdministrator
+
+param(
+    [string]$DevGrowthPath
+)
+
+$taskName = "DevGrowthNotify"
+
+# Resolve devgrowth executable path
+$devgrowth = $null
+if ($DevGrowthPath) {
+    $devgrowth = Get-Command $DevGrowthPath -ErrorAction SilentlyContinue
+} else {
+    $devgrowth = Get-Command devgrowth -ErrorAction SilentlyContinue
+}
+
+if (-not $devgrowth) {
+    Write-Error "devgrowth command not found in PATH. Install the CLI first (e.g. run 'npm link' in the project directory)."
+    exit 1
+}
+
+$action = New-ScheduledTaskAction -Execute $devgrowth.Source -Argument "notify"
+$trigger = New-ScheduledTaskTrigger -Daily -At "20:55"
+$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries
+
+Register-ScheduledTask -TaskName $taskName -Action $action -Trigger $trigger -Settings $settings -Force
+
+Write-Host "Scheduled task '$taskName' created. Runs 'devgrowth notify' daily at 20:55."

package/src/commands/config.js

@@ -0,0 +1,50 @@
+import * as configManager from '../core/configManager.js';
+import * as storage from '../core/storage.js';
+import * as path from 'path';
+import open from 'open';
+import chalk from 'chalk';
+
+function parseValue(raw) {
+  if (raw === 'true') return true;
+  if (raw === 'false') return false;
+  if (/^-?\d+$/.test(raw)) return parseInt(raw, 10);
+  if (/^-?\d*\.\d+$/.test(raw)) return parseFloat(raw);
+  return raw;
+}
+
+export async function configCommand(subcommand, args = []) {
+  switch (subcommand) {
+    case 'show': {
+      const config = await configManager.getConfig();
+      console.log(JSON.stringify(config, null, 2));
+      break;
+    }
+    case 'set': {
+      const [keyPath, value] = args;
+      if (!keyPath || value === undefined) {
+        console.error(chalk.red('Usage: devgrowth config set <key.path> <value>'));
+        process.exit(1);
+      }
+      const parsed = parseValue(value);
+      await configManager.setConfigValue(keyPath, parsed);
+      console.log(chalk.green(`Updated ${keyPath} = ${JSON.stringify(parsed)}`));
+      break;
+    }
+    case 'edit': {
+      const configPath = path.join(storage.getDevGrowthDir(), 'config.json');
+      try {
+        await open(configPath);
+        console.log('Opening config in default editor...');
+      } catch (err) {
+        console.error(chalk.red(`Could not open editor: ${err.message}`));
+        console.log(chalk.yellow(`Fallback: Open this file manually:\n  ${configPath}`));
+      }
+      break;
+    }
+    default: {
+      console.error(chalk.red(`Unknown subcommand: ${subcommand}`));
+      console.log('Usage: devgrowth config <show|set|edit>');
+      process.exit(1);
+    }
+  }
+}

package/src/commands/history.js

@@ -0,0 +1,73 @@
+import * as logger from '../core/logger.js';
+import * as schedule from '../core/schedule.js';
+import * as storage from '../core/storage.js';
+import * as path from 'path';
+import chalk from 'chalk';
+
+function getDateOfISOWeek(w, y) {
+  const simple = new Date(Date.UTC(y, 0, 1 + (w - 1) * 7));
+  const dow = simple.getUTCDay();
+  const ISOweekStart = new Date(simple);
+  if (dow <= 4) {
+    ISOweekStart.setUTCDate(simple.getUTCDate() - simple.getUTCDay() + 1);
+  } else {
+    ISOweekStart.setUTCDate(simple.getUTCDate() + 8 - simple.getUTCDay());
+  }
+  return ISOweekStart;
+}
+
+export async function historyCommand(options) {
+  const now = new Date();
+  let year;
+  let month;
+  let weekFile;
+
+  if (options.week) {
+    const weekNum = parseInt(options.week, 10);
+    const requestedYear = options.year ? parseInt(options.year, 10) : now.getFullYear();
+    const mon = getDateOfISOWeek(weekNum, requestedYear);
+    // The week may start in the previous year (e.g. ISO week 1 of 2026 begins
+    // Dec 29, 2025) — key the file by the Monday's actual year/month.
+    year = mon.getUTCFullYear();
+    month = String(mon.getUTCMonth() + 1).padStart(2, '0');
+    weekFile = `week${weekNum}.md`;
+  } else {
+    // Current week: key by this week's Monday so month boundaries don't split logs
+    const weekStart = schedule.getWeekStart(now);
+    year = weekStart.getFullYear();
+    month = String(weekStart.getMonth() + 1).padStart(2, '0');
+    weekFile = schedule.getCurrentWeekFileName(now);
+  }
+
+  const logs = await logger.readWeekLogs(year, month, weekFile);
+
+  console.log(chalk.bold(`\nHistory \u2014 ${weekFile.replace('.md', '')}`));
+  console.log(chalk.gray('\u2500'.repeat(50)));
+
+  let entries = logger.parseLogEntries(logs);
+
+  if (options.skill) {
+    const skillLower = options.skill.toLowerCase();
+    entries = entries.filter(entry => {
+      const block = logs.split(/\n(?=## )/).find(b => b.includes(entry.date));
+      return block && block.toLowerCase().includes(`**skill:** ${skillLower}`);
+    });
+  }
+
+  if (options.search) {
+    const searchLower = options.search.toLowerCase();
+    entries = entries.filter(entry => {
+      const block = logs.split(/\n(?=## )/).find(b => b.includes(entry.date));
+      return block && block.toLowerCase().includes(searchLower);
+    });
+  }
+
+  if (entries.length === 0) {
+    console.log(chalk.yellow('No logs found.'));
+  } else {
+    for (const entry of entries) {
+      console.log(`${chalk.cyan(entry.date)} \u2014 ${entry.message}`);
+    }
+  }
+  console.log();
+}

package/src/commands/init.js

@@ -0,0 +1,31 @@
+import * as configManager from '../core/configManager.js';
+import * as storage from '../core/storage.js';
+import { DEFAULT_MILESTONES } from '../core/milestones.js';
+import * as path from 'path';
+
+export async function initCommand() {
+  const dir = storage.getDevGrowthDir();
+  const configPath = path.join(dir, 'config.json');
+  const exists = await storage.fileExists(configPath);
+
+  if (exists) {
+    console.log(`✓ DevGrowth already initialized at ${dir}`);
+    return;
+  }
+
+  await configManager.createDefaultConfig();
+  await storage.writeJson(path.join(dir, 'stats.json'), {
+    currentStreakWeeks: 0,
+    longestStreakWeeks: 0,
+    totalSessions: 0,
+    totalMinutesDeepWork: 0,
+    currentWeek: { completed: 0, total: 5, status: 'not_started' },
+    weeklyHistory: [],
+    lastSessionDate: null,
+    lastFinalizedWeek: null
+  });
+  await storage.writeJson(path.join(dir, 'milestones.json'), DEFAULT_MILESTONES);
+
+  console.log(`✓ DevGrowth initialized at ${dir}`);
+  console.log('  Run `devgrowth start` to begin your first session.');
+}

package/src/commands/log.js

@@ -0,0 +1,36 @@
+import * as configManager from '../core/configManager.js';
+import * as schedule from '../core/schedule.js';
+import * as logger from '../core/logger.js';
+import * as stats from '../core/stats.js';
+import chalk from 'chalk';
+
+export async function logCommand(message, options = {}) {
+  if (!message || message.trim().length === 0) {
+    console.error(chalk.red('Error: Log message required.'));
+    console.log('Usage: devgrowth log "Today I learned ___. Tomorrow I will ___."');
+    process.exit(1);
+  }
+
+  if (message.length < 10) {
+    console.log(chalk.yellow('⚠️  Warning: Log message is very short, but saving anyway.'));
+  }
+
+  const config = await configManager.getConfig();
+  const today = schedule.getTodaySkill(config);
+  const now = schedule.getSessionDate(new Date());
+  const isLight = options.light || false;
+  const status = isLight ? 'Light' : 'Completed';
+  const duration = config.session?.durationMinutes || 20;
+
+  await logger.writeLogEntry(now, today.skill, today.resource, duration, status, message);
+  const updatedStats = await stats.recordSession(now, today.skill, duration, status);
+
+  const weekFile = schedule.getWeekFileName(now);
+  const weekStart = schedule.getWeekStart(now);
+  const logYear = weekStart.getFullYear();
+  const logMonth = String(weekStart.getMonth() + 1).padStart(2, '0');
+  console.log(chalk.green('✓ Log saved.'));
+  console.log(chalk.gray(`  File: ~/.devgrowth/logs/${logYear}/${logMonth}/${weekFile}`));
+  console.log(chalk.gray(`  Week progress: ${updatedStats.currentWeek.completed}/5 sessions`));
+  console.log(chalk.gray(`  Streak: ${updatedStats.currentStreakWeeks} weeks (longest: ${updatedStats.longestStreakWeeks})`));
+}

package/src/commands/milestone.js

@@ -0,0 +1,51 @@
+import * as milestones from '../core/milestones.js';
+import chalk from 'chalk';
+
+export async function milestoneCommand(subcommand, args = []) {
+  switch (subcommand) {
+    case 'list': {
+      const data = await milestones.getMilestones();
+      for (const [skill, config] of Object.entries(data)) {
+        console.log(chalk.bold(`\n${skill.toUpperCase()}`));
+        console.log(chalk.gray('\u2500'.repeat(40)));
+        for (const [monthKey, monthData] of Object.entries(config)) {
+          console.log(chalk.cyan(`  ${monthKey.toUpperCase()}: ${monthData.title}`));
+          for (const [itemKey, done] of Object.entries(monthData.items)) {
+            const emoji = done ? '\u2705' : '\u2B1C';
+            console.log(`    ${emoji} ${itemKey}`);
+          }
+        }
+      }
+      console.log();
+      break;
+    }
+    case 'check': {
+      const [skill, month, item] = args;
+      if (!skill || !month || !item) {
+        console.error(chalk.red('Usage: devgrowth milestone check <skill> <month> <item>'));
+        process.exit(1);
+      }
+      await milestones.checkMilestone(skill, month, item);
+      console.log(chalk.green(`\u2705 Milestone checked: ${skill} ${month} ${item}`));
+      break;
+    }
+    case 'progress': {
+      const [skill] = args;
+      if (!skill) {
+        console.error(chalk.red('Usage: devgrowth milestone progress <skill>'));
+        process.exit(1);
+      }
+      const progress = await milestones.getProgress(skill);
+      const barLength = 20;
+      const filled = Math.round((progress.completed / progress.total) * barLength);
+      const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(barLength - filled);
+      console.log(`${chalk.bold(skill.toUpperCase())} ${bar} ${progress.percentage}% (${progress.completed}/${progress.total})`);
+      break;
+    }
+    default: {
+      console.error(chalk.red(`Unknown subcommand: ${subcommand}`));
+      console.log('Usage: devgrowth milestone <list|check|progress>');
+      process.exit(1);
+    }
+  }
+}

package/src/commands/notify.js

@@ -0,0 +1,23 @@
+import * as configManager from '../core/configManager.js';
+import * as schedule from '../core/schedule.js';
+import * as notifier from '../core/notifier.js';
+
+export async function notifyCommand() {
+  const config = await configManager.getConfig();
+
+  if (config.notification?.enabled === false) {
+    return;
+  }
+
+  const today = schedule.getTodaySkill(config);
+
+  if (today.skill === 'rest') {
+    return;
+  }
+
+  const minutes = config.notification?.reminderMinutesBefore ?? 5;
+  const skillName = today.skill.charAt(0).toUpperCase() + today.skill.slice(1);
+  const focusText = today.focus ? ` ${today.focus}` : '';
+  const message = `DevGrowth session in ${minutes} minutes — Tonight: ${skillName}${focusText}`;
+  await notifier.send('DevGrowth', message);
+}

package/src/commands/review.js

@@ -0,0 +1,57 @@
+import * as logger from '../core/logger.js';
+import * as stats from '../core/stats.js';
+import * as storage from '../core/storage.js';
+import * as schedule from '../core/schedule.js';
+import * as path from 'path';
+import chalk from 'chalk';
+
+export async function reviewCommand() {
+  const now = new Date();
+  // Key the log file by this week's Monday so month/year boundaries don't split logs
+  const weekStart = schedule.getWeekStart(now);
+  const year = weekStart.getFullYear();
+  const month = String(weekStart.getMonth() + 1).padStart(2, '0');
+  const weekFile = schedule.getCurrentWeekFileName(now);
+
+  const logs = await logger.readWeekLogs(year, month, weekFile);
+
+  console.log(chalk.bold('\nWeekly Review'));
+  console.log(chalk.gray('\u2500'.repeat(50)));
+
+  const entries = logger.parseLogEntries(logs);
+  if (entries.length === 0) {
+    console.log(chalk.yellow('No logs found for this week.'));
+  } else {
+    for (const entry of entries) {
+      console.log(`${chalk.cyan(entry.date)} \u2014 ${entry.message}`);
+    }
+  }
+
+  console.log(chalk.gray('\u2500'.repeat(50)));
+  console.log(chalk.bold('Review Questions:'));
+  console.log('1. What was your biggest win this week?');
+  console.log('2. What blocked you?');
+  console.log('3. What will you focus on next week?');
+  console.log();
+
+  const result = await stats.finalizeWeek(now);
+  if (result.justFinalized) {
+    console.log(chalk.green(`Week finalized! Streak: ${result.currentStreakWeeks} weeks | Longest: ${result.longestStreakWeeks} weeks`));
+  } else {
+    console.log(chalk.yellow(`Week already finalized. Streak unchanged: ${result.currentStreakWeeks} weeks (longest: ${result.longestStreakWeeks})`));
+  }
+  console.log();
+
+  // Append review block to the week's markdown file (only on first finalize)
+  if (result.justFinalized) {
+    const filePath = path.join(storage.getDevGrowthDir(), 'logs', String(year), month, weekFile);
+    const exists = await storage.fileExists(filePath);
+    if (exists) {
+      let content = await storage.readFile(filePath);
+      const weekNum = schedule.getWeekNumber(now);
+      const reviewBlock = `## Week ${weekNum} Review\n- **Date:** ${schedule.formatDate(now)}\n- **Sessions:** ${result.currentWeek?.completed || entries.length}\n- **Streak:** ${result.currentStreakWeeks} weeks (longest: ${result.longestStreakWeeks})\n- **Biggest Win:** _\n- **Blocker:** _\n- **Next Week Focus:** _\n\n`;
+      content += reviewBlock;
+      await storage.writeFile(filePath, content);
+    }
+  }
+}

package/src/commands/start.js

@@ -0,0 +1,91 @@
+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'));
+}

package/src/commands/status.js

@@ -0,0 +1,53 @@
+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();
+}