devgrowth 1.0.0 → 1.1.0

package/README.md

@@ -1,90 +1,135 @@
-# 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.
+# DevGrowth CLI
+
+Zero-friction developer growth CLI for Saw Eh Doh Wah.
+
+## Installation
+
+Install the published package globally so the `devgrowth` command is
+available anywhere:
+
+```bash
+npm install -g devgrowth
+```
+
+### Developing locally
+
+If you're working from a clone of this repo instead of the published
+package, use `npm link` to symlink your local checkout into the global npm
+bin:
+
+```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
+```
+
+## Sync across devices
+
+devgrowth works fully offline. To share your sessions, streaks, milestones and config across several computers (and see them in the web dashboard), connect each device to a [devgrowth-cloud](https://github.com/EhDohWah/devgrowth-cloud) server:
+
+```bash
+devgrowth register --api https://your-server   # first device: creates the account
+devgrowth login --api https://your-server      # every other device
+devgrowth sync                                 # sync now (commands also sync on their own)
+devgrowth sync status                          # pending changes, last sync
+devgrowth dashboard                            # open the web dashboard
+devgrowth logout                               # disconnect this device; local data stays
+```
+
+You can also set `DEVGROWTH_API_URL` instead of passing `--api` each time. The default is `http://localhost:3000`.
+
+**What happens on first login**
+- **The account is empty** (usually your first device): this device's current stats, milestones and config become the account's starting point.
+- **The account already has data**: this device's own data is copied to `~/.devgrowth/backups/<time>/`. The device then takes on the account's history, including its Markdown logs.
+
+**Offline**
+- Commands never wait on the network for more than a few seconds, and they never fail because you're offline.
+- Changes queue up in `~/.devgrowth/events.jsonl` and upload the next time a command can reach the server.
+- In scripts, pipe the password in: `printf '%s\n' "$PW" | devgrowth login --email me@example.com`.
+
+## 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, you likely installed without `-g`
+  (`npm install devgrowth` puts it in a local `node_modules` folder, not on
+  your PATH). Run `npm install -g devgrowth` instead. If you're developing
+  from a clone, run `npm link` from the project directory.
+- Still not found after a global install? The npm global bin folder may not
+  be on your PATH. Run `npm config get prefix` to find it (on Windows,
+  typically `%AppData%\npm`), confirm that folder is on PATH, then open a
+  new terminal.
+- Windows install script requires the CLI to be in PATH. Ensure it has been
+  installed globally (or linked) first.

package/package.json

@@ -1,48 +1,52 @@
-{
-  "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"
-  }
-}
+{
+  "name": "devgrowth",
+  "version": "1.1.0",
+  "description": "Zero-friction developer growth CLI",
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
+  "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",
+    "devgrowth-core": "^1.0.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/src/commands/config.js

@@ -1,50 +1,54 @@
-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);
-    }
-  }
-}
+import * as configManager from '../core/configManager.js';
+import * as storage from '../core/storage.js';
+import * as sync from '../core/sync.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)}`));
+      // Sync notices config.json changed and records it for your other devices.
+      await sync.trySync();
+      break;
+    }
+    case 'edit': {
+      const configPath = path.join(storage.getDevGrowthDir(), 'config.json');
+      try {
+        await open(configPath);
+        console.log('Opening config in default editor...');
+        console.log(chalk.gray('Your edits sync to other devices the next time devgrowth syncs.'));
+      } 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/dashboard.js

@@ -0,0 +1,13 @@
+import chalk from 'chalk';
+import * as auth from '../core/auth.js';
+import * as browser from '../core/browser.js';
+
+export async function dashboardCommand(options = {}) {
+  const url = `${await auth.resolveApiUrl(options.api)}/`;
+  console.log(chalk.gray(`Opening ${url}`));
+  try {
+    await browser.openUrl(url);
+  } catch {
+    console.log(chalk.yellow(`Could not open the browser. Visit: ${url}`));
+  }
+}

package/src/commands/history.js

@@ -1,73 +1,75 @@
-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();
-}
+import * as logger from '../core/logger.js';
+import * as schedule from '../core/schedule.js';
+import * as storage from '../core/storage.js';
+import * as sync from '../core/sync.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) {
+  await sync.trySync();
+  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();
+}