@forwardimpact/basecamp 2.4.2 → 2.6.0

package/template/.claude/skills/draft-emails/scripts/scan-emails.mjs

@@ -3,7 +3,7 @@
  * Scan for unprocessed emails and output their IDs and subjects.
  *
  * Checks ~/.cache/fit/basecamp/apple_mail/ for email thread markdown files not
- * yet listed in drafts/drafted or drafts/ignored. Outputs one tab-separated
+ * yet listed in drafts/handled or drafts/ignored. Outputs one tab-separated
  * line per unprocessed thread: email_id<TAB>subject. Used by the draft-emails
  * skill to identify threads that need a reply.
  */
@@ -17,7 +17,7 @@ const HELP = `scan-emails — list unprocessed email threads
 Usage: node scripts/scan-emails.mjs [-h|--help]
 
 Scans ~/.cache/fit/basecamp/apple_mail/ for .md thread files not yet
-recorded in drafts/drafted or drafts/ignored. Outputs one line per
+recorded in drafts/handled or drafts/ignored. Outputs one line per
 unprocessed thread as: email_id<TAB>subject`;
 
 if (process.argv.includes("-h") || process.argv.includes("--help")) {
@@ -49,14 +49,14 @@ function extractSubject(filePath) {
 function main() {
   if (!existsSync(MAIL_DIR)) return;
 
-  const drafted = loadIdSet("drafts/drafted");
+  const handled = loadIdSet("drafts/handled");
   const ignored = loadIdSet("drafts/ignored");
 
   for (const name of readdirSync(MAIL_DIR).sort()) {
     if (!name.endsWith(".md")) continue;
 
     const emailId = basename(name, ".md");
-    if (drafted.has(emailId) || ignored.has(emailId)) continue;
+    if (handled.has(emailId) || ignored.has(emailId)) continue;
 
     const subject = extractSubject(join(MAIL_DIR, name));
     console.log(`${emailId}\t${subject}`);

package/template/.claude/skills/draft-emails/scripts/send-email.mjs

@@ -6,13 +6,18 @@
  * Apple Mail. The script writes a temporary .scpt file, executes it with
  * osascript, and cleans up afterwards. Mail.app must be running.
  *
- * The body should be plain text — no HTML. Do NOT include an email signature;
- * Apple Mail appends the user's configured signature automatically.
+ * The body should be plain text — no HTML. Do NOT include an email signature
+ * or sign-off; Apple Mail appends the user's configured signature automatically.
  */
 
 import { execFileSync } from "node:child_process";
-import { mkdtempSync, writeFileSync, unlinkSync } from "node:fs";
-import { join } from "node:path";
+import {
+  appendFileSync,
+  mkdtempSync,
+  writeFileSync,
+  unlinkSync,
+} from "node:fs";
+import { basename, join } from "node:path";
 import { tmpdir } from "node:os";
 
 const HELP = `send-email — send an email via Apple Mail
@@ -25,9 +30,10 @@ Options:
   --bcc <addrs>      Comma-separated BCC recipients
   --subject <subj>   Email subject line (required)
   --body <text>      Plain-text email body (required)
+  --draft <path>     Draft file — deleted after send, ID appended to drafts/handled
   -h, --help         Show this help message and exit
 
-Mail.app must be running. No email signature needed — Apple Mail appends it.`;
+Mail.app must be running. No signature or sign-off needed — Apple Mail appends it.`;
 
 if (process.argv.includes("-h") || process.argv.includes("--help")) {
   console.log(HELP);
@@ -59,7 +65,8 @@ function main() {
     cc = "",
     bcc = "",
     subject = "",
-    body = "";
+    body = "",
+    draft = "";
 
   for (let i = 0; i < args.length; i++) {
     switch (args[i]) {
@@ -78,6 +85,9 @@ function main() {
       case "--body":
         body = args[++i] ?? "";
         break;
+      case "--draft":
+        draft = args[++i] ?? "";
+        break;
     }
   }
 
@@ -87,6 +97,13 @@ function main() {
     process.exit(1);
   }
 
+  // Strip leading two-space padding from each line and trim overall whitespace
+  body = body
+    .split("\n")
+    .map((line) => line.replace(/^ {2}/, ""))
+    .join("\n")
+    .trim();
+
   const lines = [
     'tell application "Mail"',
     `    set newMessage to make new outgoing message with properties {subject:"${escapeAS(subject)}", content:"${escapeAS(body)}", visible:false}`,
@@ -106,6 +123,24 @@ function main() {
     writeFileSync(tmp, lines);
     execFileSync("osascript", [tmp], { stdio: "inherit" });
     console.log(`Sent: ${subject}`);
+
+    // Clean up draft and mark thread as handled
+    if (draft) {
+      try {
+        unlinkSync(draft);
+        console.log(`Removed draft: ${draft}`);
+      } catch {
+        // ignore if draft already gone
+      }
+
+      // Extract email ID from draft filename (e.g. "drafts/12345_draft.md" → "12345")
+      const draftBasename = basename(draft, ".md");
+      const emailId = draftBasename.replace(/_draft$/, "");
+      if (emailId) {
+        appendFileSync("drafts/handled", emailId + "\n");
+        console.log(`Marked as handled: ${emailId}`);
+      }
+    }
   } finally {
     try {
       unlinkSync(tmp);

package/template/.claude/skills/meeting-prep/SKILL.md

@@ -63,16 +63,19 @@ When the user asks to prep for a meeting:
 
 ### Step 1: Identify the Meeting
 
-If specified, look it up in calendar:
+Use the calendar query script to find upcoming meetings:
 
 ```bash
-ls ~/.cache/fit/basecamp/apple_calendar/ 2>/dev/null
-cat "$HOME/.cache/fit/basecamp/apple_calendar/event123.json"
+# Next 2 hours of meetings as JSON
+node .claude/skills/sync-apple-calendar/scripts/query.mjs --upcoming 2h --json
+
+# Today's full schedule
+node .claude/skills/sync-apple-calendar/scripts/query.mjs --today
 ```
 
 If "prep me for my next meeting":
 
-- List upcoming events
+- Query upcoming events with `--upcoming 2h`
 - Find the next meeting with external attendees
 - Confirm with user if unclear
 

package/template/.claude/skills/process-hyprnote/SKILL.md

@@ -51,27 +51,36 @@ Run this skill:
 ## Before Starting
 
 1. Read `USER.md` to get the user's name, email, and domain.
-2. List all session directories:
+2. **Scan for unprocessed sessions** using the scan script:
 
 ```bash
-ls "$HOME/Library/Application Support/hyprnote/sessions/"
+node .claude/skills/process-hyprnote/scripts/scan.mjs
 ```
 
-3. For each session, check if it needs processing by looking up its key files in
-   the graph state:
+This checks all sessions against the `graph_processed` state file and reports
+which need processing, with titles, dates, and content previews.
 
-```bash
-grep -F "{file_path}" ~/.cache/fit/basecamp/state/graph_processed
-```
+**Options:**
+
+| Flag        | Description                                              |
+| ----------- | -------------------------------------------------------- |
+| `--changed` | Also detect sessions whose memo/summary hash has changed |
+| `--json`    | Output as JSON (for programmatic use)                    |
+| `--count`   | Just print the count (for quick checks)                  |
+| `--limit N` | Max sessions to display (default: 20)                    |
 
 A session needs processing if:
 
 - Its `_memo.md` path is **not** in `graph_processed`, OR
-- Its `_memo.md` hash has changed (compute SHA-256 and compare), OR
+- Its `_memo.md` hash has changed (use `--changed` to detect this), OR
 - Its `_summary.md` exists and is not in `graph_processed` or has changed
 
 **Process all unprocessed sessions in one run** (typically few sessions).
 
+**Do NOT write bespoke scripts to scan for unprocessed sessions.** Use this
+script — it handles all edge cases (empty memos, missing summaries, metadata
+fallback).
+
 ## Step 0: Build Knowledge Index
 
 Scan existing notes to avoid duplicates and resolve entities:

package/template/.claude/skills/process-hyprnote/scripts/scan.mjs

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+/**
+ * Scan for unprocessed Hyprnote sessions.
+ *
+ * Compares session _memo.md and _summary.md files against the graph_processed
+ * state file to identify sessions that need processing. Reports unprocessed
+ * sessions with title, date, and content preview.
+ *
+ * Usage:
+ *   node scripts/scan.mjs              List unprocessed sessions
+ *   node scripts/scan.mjs --changed    Also detect changed (re-edited) sessions
+ *   node scripts/scan.mjs --json       Output as JSON
+ *   node scripts/scan.mjs --count      Just print the count
+ */
+
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+const HOME = homedir();
+const SESSIONS_DIR = join(
+  HOME,
+  "Library/Application Support/hyprnote/sessions",
+);
+const STATE_FILE = join(HOME, ".cache/fit/basecamp/state/graph_processed");
+
+if (process.argv.includes("-h") || process.argv.includes("--help")) {
+  console.log(`scan — find unprocessed Hyprnote sessions
+
+Usage:
+  node scripts/scan.mjs [options]
+
+Options:
+  --changed    Also detect sessions whose memo/summary hash has changed
+  --json       Output as JSON array
+  --count      Just print the unprocessed count (for scripting)
+  --limit N    Max sessions to display (default: 20)
+  -h, --help   Show this help message
+
+Sessions dir: ~/Library/Application Support/hyprnote/sessions/
+State file:   ~/.cache/fit/basecamp/state/graph_processed`);
+  process.exit(0);
+}
+
+const args = process.argv.slice(2);
+const detectChanged = args.includes("--changed");
+const jsonOutput = args.includes("--json");
+const countOnly = args.includes("--count");
+const limitIdx = args.indexOf("--limit");
+const limit = limitIdx !== -1 ? parseInt(args[limitIdx + 1], 10) || 20 : 20;
+
+// --- Load state ---
+
+const state = new Map();
+if (existsSync(STATE_FILE)) {
+  const text = readFileSync(STATE_FILE, "utf8");
+  for (const line of text.split("\n")) {
+    if (!line) continue;
+    const idx = line.indexOf("\t");
+    if (idx === -1) continue;
+    state.set(line.slice(0, idx), line.slice(idx + 1));
+  }
+}
+
+/**
+ * Compute SHA-256 hash of file contents.
+ */
+function fileHash(filePath) {
+  return createHash("sha256").update(readFileSync(filePath)).digest("hex");
+}
+
+/**
+ * Check if a file needs processing (new or changed).
+ */
+function needsProcessing(filePath) {
+  const storedHash = state.get(filePath);
+  if (!storedHash) return { needed: true, reason: "new" };
+  if (detectChanged) {
+    const currentHash = fileHash(filePath);
+    if (currentHash !== storedHash) return { needed: true, reason: "changed" };
+  }
+  return { needed: false, reason: null };
+}
+
+/**
+ * Extract title and date from a memo file.
+ */
+function parseMemo(memoPath) {
+  try {
+    const content = readFileSync(memoPath, "utf8");
+
+    // Skip empty/whitespace-only memos
+    const body = content.replace(/---[\s\S]*?---/, "").trim();
+    if (!body || body === " ") return null;
+
+    // Extract title from first H1
+    const titleMatch = content.match(/^#\s+(.+)/m);
+    const title = titleMatch ? titleMatch[1].trim() : null;
+
+    // Extract date from content or fall back to file mtime
+    const dateMatch = content.match(/\d{4}-\d{2}-\d{2}/);
+    let date = dateMatch ? dateMatch[0] : null;
+
+    if (!date) {
+      const stat = statSync(memoPath);
+      date = stat.mtime.toISOString().slice(0, 10);
+    }
+
+    return { title, date, preview: body.slice(0, 150).replace(/\n/g, " ") };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read _meta.json for session metadata.
+ */
+function readMeta(sessionDir) {
+  const metaPath = join(sessionDir, "_meta.json");
+  if (!existsSync(metaPath)) return null;
+  try {
+    return JSON.parse(readFileSync(metaPath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+// --- Scan sessions ---
+
+if (!existsSync(SESSIONS_DIR)) {
+  console.error(`Hyprnote sessions directory not found: ${SESSIONS_DIR}`);
+  process.exit(1);
+}
+
+const sessionIds = readdirSync(SESSIONS_DIR);
+const unprocessed = [];
+let totalWithMemos = 0;
+let processedCount = 0;
+
+for (const uuid of sessionIds) {
+  const sessionPath = join(SESSIONS_DIR, uuid);
+  const stat = statSync(sessionPath, { throwIfNoEntry: false });
+  if (!stat || !stat.isDirectory()) continue;
+
+  const memoPath = join(sessionPath, "_memo.md");
+  const summaryPath = join(sessionPath, "_summary.md");
+  const hasMemo = existsSync(memoPath);
+  const hasSummary = existsSync(summaryPath);
+
+  if (!hasMemo && !hasSummary) continue;
+
+  totalWithMemos++;
+
+  // Check memo
+  const memoCheck = hasMemo
+    ? needsProcessing(memoPath)
+    : { needed: false, reason: null };
+
+  // Check summary
+  const summaryCheck = hasSummary
+    ? needsProcessing(summaryPath)
+    : { needed: false, reason: null };
+
+  if (!memoCheck.needed && !summaryCheck.needed) {
+    processedCount++;
+    continue;
+  }
+
+  // Parse memo for display info
+  const memo = hasMemo ? parseMemo(memoPath) : null;
+  if (hasMemo && !memo) {
+    // Empty memo, no summary → skip
+    if (!hasSummary) continue;
+  }
+
+  // Read meta for title fallback
+  const meta = readMeta(sessionPath);
+
+  const title = memo?.title || meta?.title || uuid.slice(0, 8);
+  const date =
+    memo?.date ||
+    (meta?.created_at ? meta.created_at.slice(0, 10) : null) ||
+    statSync(sessionPath).mtime.toISOString().slice(0, 10);
+
+  unprocessed.push({
+    uuid,
+    title,
+    date,
+    hasMemo,
+    hasSummary,
+    memoReason: memoCheck.reason,
+    summaryReason: summaryCheck.reason,
+    preview: memo?.preview || "(summary only)",
+    memoPath: hasMemo ? memoPath : null,
+    summaryPath: hasSummary ? summaryPath : null,
+  });
+}
+
+// Sort by date descending (newest first)
+unprocessed.sort((a, b) => b.date.localeCompare(a.date));
+
+// --- Output ---
+
+if (countOnly) {
+  console.log(unprocessed.length);
+  process.exit(0);
+}
+
+if (jsonOutput) {
+  console.log(JSON.stringify(unprocessed.slice(0, limit), null, 2));
+  process.exit(0);
+}
+
+// Formatted output
+console.log(
+  `Sessions: ${totalWithMemos} total, ${processedCount} processed, ${unprocessed.length} unprocessed`,
+);
+
+if (unprocessed.length === 0) {
+  console.log("\nAll sessions are up to date.");
+  process.exit(0);
+}
+
+console.log("");
+const display = unprocessed.slice(0, limit);
+for (const s of display) {
+  const flags = [];
+  if (s.memoReason) flags.push(`memo:${s.memoReason}`);
+  if (s.summaryReason) flags.push(`summary:${s.summaryReason}`);
+  const sources = [];
+  if (s.hasMemo) sources.push("memo");
+  if (s.hasSummary) sources.push("summary");
+
+  console.log(
+    `${s.date} | ${s.title} | ${sources.join("+")} | ${flags.join(", ")}`,
+  );
+  console.log(`  ${s.uuid}`);
+  if (s.preview && s.preview !== "(summary only)") {
+    console.log(`  ${s.preview.slice(0, 100)}…`);
+  }
+}
+
+if (unprocessed.length > limit) {
+  console.log(`\n... and ${unprocessed.length - limit} more`);
+}