standout 0.6.0 → 0.6.1

package/README.md

@@ -14,10 +14,12 @@ to build a full profile interactively.
 
 ## Runs monthly, automatically
 
-After a full run, standout schedules a monthly refresh (1st of each month) so
-your stats never decay — local session logs only cover ~30 days, and the
-refresh keeps your full history intact. Uses launchd on macOS and cron on
-Linux; not available on Windows.
+After a full run, standout schedules a monthly refresh so your stats never
+decay — local session logs only cover ~30 days, and the refresh keeps your
+full history intact. It fires at the first hour your machine is awake in each
+new month (an hourly launchd/cron tick guarded by a month stamp in
+`~/.standout/last-refresh`, so sleeping through the 1st never skips a month).
+Uses launchd on macOS and cron on Linux; not available on Windows.
 
 ```bash
 npx standout schedule status   # is it on? command, log path, last run

package/dist/cli.js

@@ -5203,7 +5203,14 @@ function escapeXml(text) {
 function unescapeXml(text) {
   return text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
 }
-function buildLaunchdPlist(command, logPath) {
+function buildGuardedCommand(runCommand) {
+  return `STAMP="$HOME/.standout/last-refresh"; MONTH=$(date +%Y-%m); [ "$(cat "$STAMP" 2>/dev/null)" = "$MONTH" ] || { mkdir -p "$HOME/.standout"; STANDOUT_SCHEDULED=1 ${runCommand} && echo "$MONTH" > "$STAMP"; }`;
+}
+function extractRunCommand(guarded) {
+  const m = guarded.match(/STANDOUT_SCHEDULED=1 (.*?) && echo "\$MONTH"/);
+  return m ? m[1] : null;
+}
+function buildLaunchdPlist(guardedCommand, logPath) {
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -5213,22 +5220,18 @@ function buildLaunchdPlist(command, logPath) {
   <array>
     <string>/bin/zsh</string>
     <string>-lc</string>
-    <string>${escapeXml(command)}</string>
+    <string>${escapeXml(guardedCommand)}</string>
   </array>
-  <key>StartCalendarInterval</key>
-  <dict>
-    <key>Day</key><integer>1</integer>
-    <key>Hour</key><integer>10</integer>
-    <key>Minute</key><integer>0</integer>
-  </dict>
+  <key>StartInterval</key><integer>3600</integer>
   <key>StandardOutPath</key><string>${escapeXml(logPath)}</string>
   <key>StandardErrorPath</key><string>${escapeXml(logPath)}</string>
 </dict>
 </plist>
 `;
 }
-function buildCronLine(command, logPath) {
-  return `0 10 1 * * /bin/bash -lc '${command}' >> "${logPath}" 2>&1 ${CRON_MARKER}`;
+function buildCronLine(guardedCommand, logPath) {
+  const escaped = guardedCommand.replace(/%/g, "\\%");
+  return `0 * * * * /bin/bash -lc '${escaped}' >> "${logPath}" 2>&1 ${CRON_MARKER}`;
 }
 function stripCronEntries(crontab) {
   return crontab.split("\n").filter((line) => !line.includes(CRON_MARKER)).join("\n");
@@ -5261,6 +5264,23 @@ function writeOptOut() {
 function clearOptOut() {
   rmSync2(optOutPath(), { force: true });
 }
+function refreshStampPath() {
+  return join6(stateDir(), "last-refresh");
+}
+function readRefreshStamp() {
+  try {
+    return readFileSync6(refreshStampPath(), "utf8").trim() || null;
+  } catch {
+    return null;
+  }
+}
+function writeRefreshStamp() {
+  mkdirSync2(stateDir(), { recursive: true });
+  const now = /* @__PURE__ */ new Date();
+  const month = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
+  writeFileSync(refreshStampPath(), `${month}
+`);
+}
 function launchctl(args) {
   const res = spawnSync2("launchctl", args, { encoding: "utf8" });
   return {
@@ -5286,10 +5306,11 @@ function writeCrontab(content) {
   }
 }
 function installJob(command) {
+  const guarded = buildGuardedCommand(command);
   if (process.platform === "darwin") {
     const path2 = plistPath();
     mkdirSync2(join6(homedir6(), "Library", "LaunchAgents"), { recursive: true });
-    writeFileSync(path2, buildLaunchdPlist(command, schedLogPath()));
+    writeFileSync(path2, buildLaunchdPlist(guarded, schedLogPath()));
     launchctl(["bootout", `gui/${uid()}/${LAUNCHD_LABEL}`]);
     const res = launchctl(["bootstrap", `gui/${uid()}`, path2]);
     if (res.status !== 0) {
@@ -5301,10 +5322,11 @@ function installJob(command) {
     mkdirSync2(stateDir(), { recursive: true });
     const stripped = stripCronEntries(readCrontab());
     const base = stripped === "" || stripped.endsWith("\n") ? stripped : stripped + "\n";
-    writeCrontab(base + buildCronLine(command, schedLogPath()) + "\n");
+    writeCrontab(base + buildCronLine(guarded, schedLogPath()) + "\n");
   }
+  writeRefreshStamp();
 }
-function installedCommand() {
+function installedShellCommand() {
   if (process.platform === "darwin") {
     if (!existsSync6(plistPath())) return null;
     const xml = readFileSync6(plistPath(), "utf8");
@@ -5314,7 +5336,7 @@ function installedCommand() {
   if (process.platform === "linux") {
     const line = readCrontab().split("\n").find((l) => l.includes(CRON_MARKER));
     const m = line?.match(/-lc '([^']*)'/);
-    return m ? m[1] : null;
+    return m ? m[1].replace(/\\%/g, "%") : null;
   }
   return null;
 }
@@ -5330,7 +5352,7 @@ async function installSchedule(slug, flags) {
   installJob(command);
   process.stderr.write(
     `
-  ${chalk.hex(ACCENT)("\u2713")} ${chalk.white("monthly refresh scheduled")} ${chalk.dim("(1st of each month, 10:00)")}
+  ${chalk.hex(ACCENT)("\u2713")} ${chalk.white("monthly refresh scheduled")} ${chalk.dim("(first awake hour of each month)")}
 ` + chalk.dim(`    runs: ${command}
 `) + chalk.dim(`    log:  ${schedLogPath()}
 `) + chalk.dim("    disable anytime with `npx standout schedule off`\n\n")
@@ -5377,19 +5399,21 @@ async function scheduleStatus() {
     );
     return;
   }
-  const command = installedCommand();
-  if (!command) {
+  const shell = installedShellCommand();
+  if (!shell) {
     process.stderr.write(
       `
   ${chalk.white("no monthly schedule installed")}` + (isOptedOut() ? chalk.dim(" (opted out)") : "") + "\n" + chalk.dim("    enable with `npx standout schedule`\n\n")
     );
     return;
   }
+  const stamp = readRefreshStamp();
   process.stderr.write(
     `
-  ${chalk.hex(ACCENT)("\u2713")} ${chalk.white("monthly refresh is on")} ${chalk.dim("(1st of each month, 10:00)")}
-` + chalk.dim(`    runs: ${command}
+  ${chalk.hex(ACCENT)("\u2713")} ${chalk.white("monthly refresh is on")} ${chalk.dim("(first awake hour of each month)")}
+` + chalk.dim(`    runs: ${extractRunCommand(shell) ?? shell}
 `) + chalk.dim(`    log:  ${schedLogPath()}
+`) + chalk.dim(`    last refreshed month: ${stamp ?? "never"}
 `)
   );
   if (process.platform === "darwin") {
@@ -5418,24 +5442,28 @@ async function scheduleStatus() {
   }
   process.stderr.write("\n");
 }
+function autoRefreshNotice(headline) {
+  const optOut = "npx standout schedule off";
+  return `
+  ${chalk.hex(ACCENT)("\u27F3")} ${chalk.bold.white(headline)}
+    ${chalk.white("standout re-runs once a month so your wrapped keeps building")}
+    ${chalk.white("(because local logs only keep ~30 days of history).")}
+    ${chalk.white("opt out anytime:")} ${chalk.hex(ACCENT)(optOut)}
+
+`;
+}
 async function maybeAutoInstallSchedule(slug) {
   try {
+    if (process.env.STANDOUT_SCHEDULED === "1") return;
     if (!supportedPlatform() || isOptedOut()) return;
     const command = buildRunCommand(slug, []);
-    if (installedCommand() === command) {
-      process.stderr.write(
-        chalk.dim(
-          "  monthly refresh is on \u2014 `npx standout schedule off` to disable\n\n"
-        )
-      );
+    if (installedShellCommand() === buildGuardedCommand(command)) {
+      writeRefreshStamp();
+      process.stderr.write(autoRefreshNotice("auto-refresh is on"));
       return;
     }
     installJob(command);
-    process.stderr.write(
-      `  ${chalk.hex(ACCENT)("\u2713")} ${chalk.white("monthly refresh scheduled")} ${chalk.dim("(1st of each month) \u2014 disable with `npx standout schedule off`")}
-
-`
-    );
+    process.stderr.write(autoRefreshNotice("auto-refresh scheduled"));
   } catch (error) {
     process.stderr.write(
       chalk.dim(
@@ -7703,6 +7731,7 @@ async function runAgent(jobId) {
 `
       );
     }
+    await maybeAutoInstallSchedule(jobId);
     await maybeShareWrapped(wrapped);
   } else {
     process.stderr.write(
@@ -7872,7 +7901,6 @@ async function main() {
   } else {
     if (jobId) process.env.STANDOUT_JOB_ID = jobId;
     await runAgent(jobId);
-    await maybeAutoInstallSchedule(jobId);
   }
 }
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "standout",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Build your developer profile with AI. One command, zero friction.",
   "type": "module",
   "main": "./dist/cli.js",