@gobing-ai/spur 0.4.7 → 0.4.9

package/plugins/sp/scripts/daily-summary/daily-summary.mjs

@@ -1,626 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/scripts/daily-summary/daily-summary.ts
-import { spawn, spawnSync } from "child_process";
-import { existsSync as existsSync2, mkdirSync, readlinkSync, writeFileSync } from "fs";
-import { dirname as dirname2, isAbsolute, join as join2, resolve as resolve2 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-
-// plugins/sp/lib/env.ts
-function getEnvVar(name, fallback) {
-  const raw = process.env[name];
-  return raw === undefined ? fallback : raw;
-}
-function getEnvVars() {
-  return process.env;
-}
-
-// plugins/sp/lib/inline-run-app.ts
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-function resolveAppEntry(spurBin) {
-  const fallback = fileURLToPath(new URL("../../../apps/cli/src/index.ts", import.meta.url));
-  const candidates = spurBin !== "" ? [spurBin] : [fallback];
-  for (const candidate of candidates) {
-    const tokens = candidate.split(/\s+/).filter(Boolean);
-    const mainModule = [...tokens].reverse().find((t) => t.endsWith(".ts"));
-    if (mainModule === undefined || !existsSync(mainModule))
-      continue;
-    const repoRoot = resolve(dirname(mainModule), "..", "..", "..");
-    const appEntry = join(repoRoot, "packages", "app", "src", "index.ts");
-    if (existsSync(appEntry))
-      return { entry: appEntry, portable: false };
-  }
-  const entry = fileURLToPath(new URL("../lib/inline-run.generated.mjs", import.meta.url));
-  if (!existsSync(entry)) {
-    throw new Error("inline application bundle is missing — rebuild/install the sp plugin before running inline");
-  }
-  return { entry, portable: true };
-}
-async function loadInlineApp(spurBin, resolveAppEntry, required) {
-  const { entry, portable } = resolveAppEntry(spurBin);
-  const app = await import(entry);
-  const missing = portable ? required.filter((name) => typeof app[name] !== "function") : [];
-  if (missing.length > 0) {
-    throw new Error(`inline application bundle ${entry} is older than its scripts — missing ${missing.join(", ")}. Reinstall sp with a superskill release that stages lib/ (commit b42961b), or pass --spur-bin <spur checkout>/apps/cli/src/index.ts.`);
-  }
-  return { app, portable };
-}
-
-// plugins/sp/scripts/daily-summary/daily-summary.ts
-var consoleEnabled = true;
-function enableLogger(consoleOn) {
-  consoleEnabled = consoleOn;
-}
-function logAt(stream, message) {
-  if (!consoleEnabled)
-    return;
-  console[stream](message);
-}
-var logger = {
-  info: (message) => logAt("log", message),
-  warn: (message) => logAt("warn", message),
-  error: (message) => logAt("error", message)
-};
-var DAILY_DIR = "docs/daily";
-var DEFAULT_DATE = "today";
-function parseArgs(argv = process.argv.slice(2)) {
-  const args = argv;
-  const options = {
-    date: DEFAULT_DATE,
-    dryRun: false,
-    skipGit: false,
-    skipCcusage: false
-  };
-  for (let i = 0;i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--date" && i + 1 < args.length) {
-      options.date = args[++i] ?? options.date;
-    } else if (arg === "--dry-run") {
-      options.dryRun = true;
-    } else if (arg === "--output" && i + 1 < args.length) {
-      options.outputPath = args[++i];
-    } else if (arg === "--no-git") {
-      options.skipGit = true;
-    } else if (arg === "--no-ccusage") {
-      options.skipCcusage = true;
-    } else if (arg === "--help" || arg === "-h") {
-      printUsage();
-      process.exit(0);
-    }
-  }
-  if (options.date === "today") {
-    options.date = todayLocal();
-  } else if (options.date === "yesterday") {
-    options.date = yesterdayLocal();
-  }
-  return options;
-}
-function printUsage() {
-  console.log(`
-sp:daily-summary \u2014 Generate daily summary reports
-
-Usage: daily-summary.ts [options]
-
-Options:
-  --date YYYY-MM-DD     Date for summary (default: today, also: yesterday)
-  --dry-run             Show summary without writing file
-  --output <path>       Write to custom path
-  --no-git              Skip git history collection
-  --no-ccusage          Skip token usage collection
-  --help, -h            Show this help
-
-Examples:
-  daily-summary.ts                        # Today's summary
-  daily-summary.ts --date yesterday     # Yesterday's summary
-  daily-summary.ts --dry-run            # Preview without writing
-`);
-}
-function todayLocal() {
-  const proc = spawnSync("date", ["+%Y-%m-%d"], { encoding: "utf8" });
-  return (proc.stdout ?? "").trim();
-}
-function yesterdayLocal() {
-  const epochProc = spawnSync("date", ["+%s"], { encoding: "utf8" });
-  const epoch = parseInt((epochProc.stdout ?? "").trim(), 10);
-  const yesterdayEpoch = epoch - 86400;
-  let proc = spawnSync("date", ["-r", String(yesterdayEpoch), "+%Y-%m-%d"], { encoding: "utf8" });
-  if ((proc.status ?? 1) !== 0) {
-    proc = spawnSync("date", ["-d", `@${yesterdayEpoch}`, "+%Y-%m-%d"], { encoding: "utf8" });
-  }
-  return (proc.stdout ?? "").trim();
-}
-function getDateRange(dateStr) {
-  const date = new Date(`${dateStr}T00:00:00`);
-  const start = `${dateStr} 00:00:00`;
-  const endDate = new Date(date);
-  endDate.setDate(endDate.getDate() + 1);
-  const end = `${endDate.toISOString().slice(0, 10)} 00:00:00`;
-  return { start, end };
-}
-var defaultProcessSpawner = (cmd, args, env) => {
-  return new Promise((resolve, reject) => {
-    try {
-      const proc = spawn(cmd, args, {
-        stdio: ["ignore", "pipe", "pipe"],
-        env: env ?? getEnvVars()
-      });
-      const stdoutChunks = [];
-      const stderrChunks = [];
-      proc.stdout.on("data", (chunk) => stdoutChunks.push(Buffer.from(chunk)));
-      proc.stderr.on("data", (chunk) => stderrChunks.push(Buffer.from(chunk)));
-      proc.on("close", (exitCode) => {
-        resolve({
-          stdout: Buffer.concat(stdoutChunks).toString("utf8"),
-          stderr: Buffer.concat(stderrChunks).toString("utf8"),
-          exitCode: exitCode ?? 0
-        });
-      });
-      proc.on("error", (err) => {
-        reject(err);
-      });
-    } catch (err) {
-      reject(err);
-    }
-  });
-};
-var processSpawner = defaultProcessSpawner;
-function setProcessSpawner(next) {
-  processSpawner = next ?? defaultProcessSpawner;
-}
-async function getCcusageData(date) {
-  try {
-    const env = { ...getEnvVars() };
-    const ccusageCheck = await processSpawner("ccusage", ["--version"], env);
-    if (ccusageCheck.exitCode !== 0) {
-      return null;
-    }
-    const since = `${date}T00:00:00`;
-    const until = `${date}T23:59:59`;
-    const proc = await processSpawner("ccusage", ["daily", "--since", since, "--until", until, "--json"], env);
-    if (proc.exitCode !== 0) {
-      logger.warn(`ccusage error: ${proc.stderr}`);
-      return null;
-    }
-    const data = JSON.parse(proc.stdout);
-    return data;
-  } catch (error) {
-    logger.warn(`Failed to get ccusage data: ${error}`);
-    return null;
-  }
-}
-function composeHistoryHealth(reading) {
-  const loops = reading.loops.map((row) => ({
-    toolName: row.toolName,
-    argsDigest: row.argsDigest || "repeated execution",
-    repeats: row.repeats,
-    sessionId: row.sessionId,
-    fromSeq: row.firstSeq,
-    toSeq: row.lastSeq,
-    wastedTokens: row.repeats * 250
-  }));
-  const remediationProposals = [];
-  for (const lp of loops.slice(0, 5)) {
-    const cleanTool = lp.toolName.replace(/[^a-zA-Z0-9_-]/g, "_");
-    const key = `repetition:${cleanTool}:${lp.argsDigest.slice(0, 16)}`;
-    const title = `Break execution loop in ${lp.toolName} (${lp.repeats} repeats)`;
-    const command = `spur task create "<title>" --feature <id> && spur task update <wbs> --section Plan --from-file <path>`;
-    remediationProposals.push({ key, title, command });
-  }
-  if (reading.toolCalls > 0 && reading.errorRatePct > 10) {
-    remediationProposals.push({
-      key: "reliability:tooling:high-error-rate",
-      title: `Investigate high tool error rate (${reading.errorRatePct.toFixed(1)}%)`,
-      command: `spur task create "<title>" --feature <id> && spur task update <wbs> --section Plan --from-file <path>`
-    });
-  }
-  return {
-    toolCalls: reading.toolCalls,
-    toolErrors: reading.toolErrors,
-    errorRatePct: reading.errorRatePct,
-    loops,
-    redundantCalls: loops.reduce((acc, l) => acc + Math.max(0, l.repeats - 1), 0),
-    wastedTokens: loops.reduce((acc, l) => acc + l.wastedTokens, 0),
-    remediationProposals
-  };
-}
-async function getSpurHistoryHealth(date, dbPath = ".spur/spur.db") {
-  try {
-    const resolvedPath = resolve2(process.cwd(), dbPath);
-    const { app } = await loadInlineApp(getEnvVar("SPUR_BIN") ?? "", resolveAppEntry, [
-      "readHistoryHealth"
-    ]);
-    const reading = await app.readHistoryHealth({ date, dbPath: resolvedPath });
-    return reading === null ? null : composeHistoryHealth(reading);
-  } catch {
-    return null;
-  }
-}
-async function getGitCommits(date) {
-  try {
-    const { start, end } = getDateRange(date);
-    const proc = await processSpawner("git", [
-      "log",
-      "--since",
-      start,
-      "--until",
-      end,
-      "--pretty=format:%H|%ad|%s",
-      "--date=iso",
-      "--numstat"
-    ]);
-    if (proc.exitCode !== 0) {
-      logger.warn("Failed to get git commits");
-      return [];
-    }
-    const commits = [];
-    const lines = proc.stdout.trim().split(`
-`);
-    let currentCommit = null;
-    for (const line of lines) {
-      if (!line.trim())
-        continue;
-      if (line.includes("|")) {
-        const parts = line.split("|");
-        if (parts.length >= 3) {
-          if (currentCommit?.hash) {
-            commits.push(currentCommit);
-          }
-          currentCommit = {
-            hash: parts[0],
-            date: parts[1],
-            message: parts[2],
-            filesChanged: 0,
-            insertions: 0,
-            deletions: 0
-          };
-        }
-      } else if (currentCommit && line.includes("\t")) {
-        const parts = line.split("\t");
-        if (parts.length >= 3) {
-          const insertions = parseInt(parts[0] ?? "", 10) || 0;
-          const deletions = parseInt(parts[1] ?? "", 10) || 0;
-          currentCommit.filesChanged = (currentCommit.filesChanged ?? 0) + 1;
-          currentCommit.insertions = (currentCommit.insertions ?? 0) + insertions;
-          currentCommit.deletions = (currentCommit.deletions ?? 0) + deletions;
-        }
-      }
-    }
-    if (currentCommit?.hash) {
-      commits.push(currentCommit);
-    }
-    return commits;
-  } catch (error) {
-    logger.warn(`Failed to get git commits: ${error}`);
-    return [];
-  }
-}
-async function promptUser() {
-  if (getEnvVar("SP_DAILY_SUMMARY_NO_PROMPT") === "1") {
-    return { learnings: "", issuesFixed: "", pending: "" };
-  }
-  if (getEnvVar("RD3_DAILY_SUMMARY_NO_PROMPT") === "1") {
-    logger.warn("[deprecate] RD3_DAILY_SUMMARY_NO_PROMPT is deprecated; use SP_DAILY_SUMMARY_NO_PROMPT");
-    return { learnings: "", issuesFixed: "", pending: "" };
-  }
-  console.log(`
-\uD83D\uDCCA Daily Summary \u2014 ${todayLocal()}`);
-  console.log("\u2550".repeat(50));
-  console.log(`
-Please provide the following (press Enter to skip):
-`);
-  if (!process.stdin.isTTY) {
-    const chunks = [];
-    for await (const chunk of process.stdin) {
-      chunks.push(chunk);
-    }
-    const buffered = Buffer.concat(chunks).toString("utf-8");
-    const [learnings = "", issuesFixed = "", pending = ""] = buffered.split(`
-`);
-    return {
-      learnings: learnings.trim(),
-      issuesFixed: issuesFixed.trim(),
-      pending: pending.trim()
-    };
-  }
-  const readline = await import("readline");
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  const question = (prompt) => new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      resolve(answer.trim());
-    });
-  });
-  const learnings = await question(`1. What did you learn today? (optional)
-   > `);
-  const issuesFixed = await question(`
-2. What issues did you fix? (optional)
-   > `);
-  const pending = await question(`
-3. What's pending for tomorrow? (optional)
-   > `);
-  rl.close();
-  return {
-    learnings,
-    issuesFixed,
-    pending
-  };
-}
-function generateMarkdown(summary) {
-  const lines = [];
-  lines.push(`# Daily Summary \u2014 ${summary.date}`);
-  lines.push("");
-  lines.push(`**Generated:** ${summary.generatedAt}`);
-  lines.push("");
-  lines.push("## Meta");
-  lines.push("");
-  lines.push(`- **Date:** ${summary.date}`);
-  lines.push(`- **Platforms:** ${summary.platforms.join(", ") || "unknown"}`);
-  lines.push("");
-  if (summary.tokenUsage) {
-    const tu = summary.tokenUsage;
-    lines.push("## Token Usage");
-    lines.push("");
-    lines.push(`| Metric | Value |`);
-    lines.push(`|--------|-------|`);
-    lines.push(`| Input Tokens | ${tu.inputTokens.toLocaleString()} |`);
-    lines.push(`| Output Tokens | ${tu.outputTokens.toLocaleString()} |`);
-    lines.push(`| Cache Tokens | ${tu.cacheTokens.toLocaleString()} |`);
-    lines.push(`| Total Tokens | ${tu.totalTokens.toLocaleString()} |`);
-    lines.push(`| Estimated Cost | $${tu.costUsd.toFixed(4)} |`);
-    lines.push("");
-    if (tu.inputTokens > 0) {
-      const cacheHitRate = tu.cacheTokens / (tu.inputTokens + tu.cacheTokens) * 100;
-      lines.push(`**Cache Hit Rate:** ${cacheHitRate.toFixed(1)}%`);
-      lines.push("");
-    }
-  }
-  if (summary.gitActivity) {
-    const ga = summary.gitActivity;
-    lines.push("## Git Activity");
-    lines.push("");
-    lines.push(`| Metric | Value |`);
-    lines.push(`|--------|-------|`);
-    lines.push(`| Commits | ${ga.commitCount} |`);
-    lines.push(`| Files Changed | ${ga.filesChanged} |`);
-    lines.push(`| Insertions | +${ga.insertions} |`);
-    lines.push(`| Deletions | -${ga.deletions} |`);
-    lines.push("");
-  }
-  if (summary.commits.length > 0) {
-    lines.push("## Commits");
-    lines.push("");
-    for (const commit of summary.commits.slice(0, 10)) {
-      const shortHash = commit.hash.slice(0, 7);
-      lines.push(`- \`${shortHash}\` ${commit.message}`);
-    }
-    if (summary.commits.length > 10) {
-      lines.push(`- ... and ${summary.commits.length - 10} more commits`);
-    }
-    lines.push("");
-  }
-  const { learnings, issuesFixed, pending } = summary.annotations;
-  if (learnings) {
-    lines.push("## Learnings");
-    lines.push("");
-    lines.push(learnings);
-    lines.push("");
-  }
-  if (issuesFixed) {
-    lines.push("## Issues Fixed");
-    lines.push("");
-    lines.push(issuesFixed);
-    lines.push("");
-  }
-  if (pending) {
-    lines.push("## Pending");
-    lines.push("");
-    lines.push(pending);
-    lines.push("");
-  }
-  if (summary.historyHealth) {
-    const hh = summary.historyHealth;
-    lines.push("## Execution Loops & Health Findings");
-    lines.push("");
-    if (hh.loops.length === 0 && hh.toolCalls === 0) {
-      lines.push("- **Status:** \u2705 Clean \u2014 No execution loops or tool calls recorded for this date.");
-      lines.push("");
-    } else {
-      lines.push("| Metric | Value |");
-      lines.push("|--------|-------|");
-      lines.push(`| Tool Invocations | ${hh.toolCalls.toLocaleString()} |`);
-      lines.push(`| Tool Errors | ${hh.toolErrors.toLocaleString()} (${hh.errorRatePct.toFixed(1)}%) |`);
-      lines.push(`| Detected Loops (Repeats \u2265 3) | ${hh.loops.length} |`);
-      lines.push(`| Redundant Invocations | ${hh.redundantCalls.toLocaleString()} |`);
-      lines.push(`| Estimated Wasted Tokens | ${hh.wastedTokens.toLocaleString()} |`);
-      lines.push("");
-      if (hh.loops.length > 0) {
-        lines.push("### Detected Execution Loops");
-        lines.push("");
-        for (const lp of hh.loops.slice(0, 10)) {
-          const seqInfo = lp.fromSeq && lp.toSeq ? ` (steps #${lp.fromSeq} \u2192 #${lp.toSeq})` : "";
-          const argsHint = lp.argsDigest === "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b" ? "empty/unrecorded arguments" : lp.argsDigest.length > 28 ? `${lp.argsDigest.slice(0, 24)}...` : lp.argsDigest;
-          lines.push(`- \`${lp.toolName || "unknown"}\` \xD7 **${lp.repeats} repeats** in session \`${lp.sessionId}\`${seqInfo}`);
-          lines.push(`  - *Args hint:* \`${argsHint}\` (~${lp.wastedTokens.toLocaleString()} wasted tokens)`);
-        }
-        lines.push("");
-      }
-      if (hh.remediationProposals.length > 0) {
-        lines.push("### Auto-Healing Remediation Proposals");
-        lines.push("");
-        lines.push("To remediate root causes and prevent recurring token waste, execute:");
-        lines.push("");
-        lines.push("```bash");
-        for (const prop of hh.remediationProposals) {
-          lines.push(`# ${prop.title} [${prop.key}]`);
-          lines.push(prop.command);
-          lines.push("");
-        }
-        lines.push("```");
-        lines.push("");
-      }
-    }
-  }
-  if (summary.historyReportPath) {
-    lines.push("## History Report");
-    lines.push("");
-    lines.push(`- **Newest artifact:** ${summary.historyReportPath}`);
-    lines.push("");
-  }
-  lines.push("---");
-  lines.push("");
-  lines.push(`*Generated by sp:daily-summary at ${summary.generatedAt}*`);
-  return lines.join(`
-`);
-}
-function ensureDir(path) {
-  if (!existsSync2(path)) {
-    mkdirSync(path, { recursive: true });
-  }
-}
-function writeSummary(markdown, options) {
-  const filename = `summary_${options.date.replace(/-/g, "")}.md`;
-  const outputPath = options.outputPath || join2(DAILY_DIR, filename);
-  ensureDir(join2(outputPath, ".."));
-  writeFileSync(outputPath, markdown, "utf-8");
-  return outputPath;
-}
-function resolveHistoryReportPath() {
-  const pointer = resolve2(process.cwd(), ".spur", "reports", "history", "latest.json");
-  if (!existsSync2(pointer)) {
-    return;
-  }
-  try {
-    const target = readlinkSync(pointer);
-    const resolved = isAbsolute(target) ? target : resolve2(dirname2(pointer), target);
-    return existsSync2(resolved) ? resolved : undefined;
-  } catch {
-    return;
-  }
-}
-async function buildDailySummary(options) {
-  const platforms = [];
-  let tokenUsage;
-  if (!options.skipCcusage) {
-    const ccusageData = await getCcusageData(options.date);
-    if (ccusageData?.totals) {
-      const totals = ccusageData.totals;
-      tokenUsage = {
-        inputTokens: totals.inputTokens,
-        outputTokens: totals.outputTokens,
-        cacheTokens: totals.cacheCreationTokens + totals.cacheReadTokens,
-        totalTokens: totals.totalTokens,
-        costUsd: totals.totalCost
-      };
-      platforms.push("Claude Code");
-    }
-  }
-  let gitActivity;
-  let commits = [];
-  if (!options.skipGit) {
-    commits = await getGitCommits(options.date);
-    if (commits.length > 0) {
-      gitActivity = commits.reduce((acc, commit) => ({
-        commitCount: acc.commitCount + 1,
-        filesChanged: acc.filesChanged + (commit.filesChanged || 0),
-        insertions: acc.insertions + (commit.insertions || 0),
-        deletions: acc.deletions + (commit.deletions || 0)
-      }), { commitCount: 0, filesChanged: 0, insertions: 0, deletions: 0 });
-      platforms.push("Git");
-    }
-  }
-  const historyReportPath = resolveHistoryReportPath();
-  const annotations = await promptUser();
-  const result = {
-    date: options.date,
-    platforms,
-    commits,
-    annotations,
-    historyReportPath,
-    generatedAt: new Date().toISOString().replace("T", " ").slice(0, 19)
-  };
-  if (tokenUsage !== undefined) {
-    result.tokenUsage = tokenUsage;
-  }
-  if (gitActivity !== undefined) {
-    result.gitActivity = gitActivity;
-  }
-  const historyHealth = await getSpurHistoryHealth(options.date);
-  if (historyHealth) {
-    result.historyHealth = historyHealth;
-    platforms.push("Spur History");
-  }
-  return result;
-}
-async function main() {
-  if (!process.versions.bun) {
-    const child = spawnSync("bun", [fileURLToPath2(import.meta.url), ...process.argv.slice(2)], {
-      stdio: "inherit"
-    });
-    if (!child.error)
-      process.exit(child.status ?? 1);
-    console.error(`daily-summary: Bun not on PATH (${child.error.message}); history health unavailable`);
-  }
-  const options = parseArgs();
-  logger.info(`Generating daily summary for ${options.date}...`);
-  try {
-    const summary = await buildDailySummary(options);
-    const markdown = generateMarkdown(summary);
-    if (options.dryRun) {
-      console.log(`
-${markdown}
-`);
-      logger.info("(dry-run) Summary not written to file");
-    } else {
-      const outputPath = writeSummary(markdown, options);
-      console.log(`
-${markdown}
-`);
-      console.log(`
-\u2705 Summary written to: ${outputPath}`);
-    }
-    console.log(`
-\uD83D\uDCCA Summary Statistics:`);
-    console.log(`   Date: ${summary.date}`);
-    console.log(`   Platforms: ${summary.platforms.join(", ") || "none"}`);
-    if (summary.tokenUsage) {
-      console.log(`   Tokens: ${summary.tokenUsage.totalTokens.toLocaleString()}`);
-      console.log(`   Cost: $${summary.tokenUsage.costUsd.toFixed(4)}`);
-    }
-    if (summary.gitActivity) {
-      console.log(`   Commits: ${summary.gitActivity.commitCount}`);
-    }
-  } catch (error) {
-    logger.error(`Failed to generate summary: ${error}`);
-    process.exit(1);
-  }
-}
-{
-  main().catch((error) => {
-    logger.error(`Daily summary failed: ${error}`);
-    process.exit(1);
-  });
-}
-export {
-  buildDailySummary,
-  defaultProcessSpawner,
-  enableLogger,
-  ensureDir,
-  generateMarkdown,
-  getCcusageData,
-  getDateRange,
-  getGitCommits,
-  getSpurHistoryHealth,
-  main,
-  parseArgs,
-  printUsage,
-  promptUser,
-  setProcessSpawner,
-  todayLocal,
-  writeSummary,
-  yesterdayLocal
-};