@forwardimpact/basecamp 0.3.0 → 1.0.0

package/{basecamp.js → src/basecamp.js}

@@ -16,7 +16,6 @@ import {
   writeFileSync,
   existsSync,
   mkdirSync,
-  readdirSync,
   unlinkSync,
   chmodSync,
 } from "node:fs";
@@ -34,9 +33,24 @@ const STATE_PATH = join(BASECAMP_HOME, "state.json");
 const LOG_DIR = join(BASECAMP_HOME, "logs");
 const __dirname =
   import.meta.dirname || dirname(fileURLToPath(import.meta.url));
-const KB_TEMPLATE_DIR = join(__dirname, "template");
+const SHARE_DIR = "/usr/local/share/fit-basecamp";
 const SOCKET_PATH = join(BASECAMP_HOME, "basecamp.sock");
 
+// --- posix_spawn (macOS app bundle only) ------------------------------------
+
+const USE_POSIX_SPAWN = !!process.env.BASECAMP_BUNDLE;
+let posixSpawn;
+if (USE_POSIX_SPAWN) {
+  try {
+    posixSpawn = await import("./posix-spawn.js");
+  } catch (err) {
+    console.error(
+      "Failed to load posix-spawn, falling back to child_process:",
+      err.message,
+    );
+  }
+}
+
 let daemonStartedAt = null;
 
 // --- Helpers ----------------------------------------------------------------
@@ -79,23 +93,36 @@ function log(msg) {
 }
 
 function findClaude() {
-  for (const c of [
-    "claude",
+  const paths = [
     "/usr/local/bin/claude",
     join(HOME, ".claude", "bin", "claude"),
     join(HOME, ".local", "bin", "claude"),
-  ]) {
-    try {
-      execSync(`which "${c}" 2>/dev/null || command -v "${c}" 2>/dev/null`, {
-        encoding: "utf8",
-      });
-      return c;
-    } catch {}
-    if (existsSync(c)) return c;
-  }
+    "/opt/homebrew/bin/claude",
+  ];
+  for (const p of paths) if (existsSync(p)) return p;
   return "claude";
 }
 
+/**
+ * Detect if running from inside a macOS .app bundle.
+ * The binary is at Basecamp.app/Contents/MacOS/fit-basecamp.
+ * @returns {{ bundle: string, resources: string } | null}
+ */
+function getBundlePath() {
+  try {
+    const exe = process.execPath || "";
+    const macosDir = dirname(exe);
+    const contentsDir = dirname(macosDir);
+    const resourcesDir = join(contentsDir, "Resources");
+    if (existsSync(join(resourcesDir, "config"))) {
+      return { bundle: dirname(contentsDir), resources: resourcesDir };
+    }
+  } catch {
+    /* not in bundle */
+  }
+  return null;
+}
+
 function loadConfig() {
   return readJSON(CONFIG_PATH, { tasks: {} });
 }
@@ -172,7 +199,7 @@ function shouldRun(task, taskState, now) {
 
 // --- Task execution ---------------------------------------------------------
 
-function runTask(taskName, task, _config, state) {
+async function runTask(taskName, task, _config, state) {
   if (!task.kb) {
     log(`Task ${taskName}: no "kb" specified, skipping.`);
     return;
@@ -201,6 +228,58 @@ function runTask(taskName, task, _config, state) {
   if (task.agent) spawnArgs.push("--agent", task.agent);
   spawnArgs.push("-p", prompt);
 
+  // Use posix_spawn when running inside the app bundle for TCC inheritance.
+  // Fall back to child_process.spawn for dev mode and other platforms.
+  if (posixSpawn) {
+    try {
+      const { pid, stdoutFd, stderrFd } = posixSpawn.spawn(
+        claude,
+        spawnArgs,
+        undefined,
+        kbPath,
+      );
+
+      // Read stdout and stderr concurrently to avoid pipe deadlocks,
+      // then wait for the child to exit.
+      const [stdout, stderr] = await Promise.all([
+        posixSpawn.readAll(stdoutFd),
+        posixSpawn.readAll(stderrFd),
+      ]);
+      const exitCode = await posixSpawn.waitForExit(pid);
+
+      if (exitCode === 0) {
+        log(`Task ${taskName} completed. Output: ${stdout.slice(0, 200)}...`);
+        Object.assign(ts, {
+          status: "finished",
+          startedAt: null,
+          lastRunAt: new Date().toISOString(),
+          lastError: null,
+          runCount: (ts.runCount || 0) + 1,
+        });
+      } else {
+        const errMsg = stderr || stdout || `Exit code ${exitCode}`;
+        log(`Task ${taskName} failed: ${errMsg.slice(0, 300)}`);
+        Object.assign(ts, {
+          status: "failed",
+          startedAt: null,
+          lastRunAt: new Date().toISOString(),
+          lastError: errMsg.slice(0, 500),
+        });
+      }
+      saveState(state);
+    } catch (err) {
+      log(`Task ${taskName} failed: ${err.message}`);
+      Object.assign(ts, {
+        status: "failed",
+        startedAt: null,
+        lastRunAt: new Date().toISOString(),
+        lastError: err.message.slice(0, 500),
+      });
+      saveState(state);
+    }
+    return;
+  }
+
   return new Promise((resolve) => {
     const child = spawn(claude, spawnArgs, {
       cwd: kbPath,
@@ -337,29 +416,6 @@ function handleStatusRequest(socket) {
   });
 }
 
-function handleRestartRequest(socket) {
-  send(socket, { type: "ack", command: "restart" });
-  setTimeout(() => process.exit(0), 100);
-}
-
-function handleRunRequest(socket, taskName) {
-  if (!taskName) {
-    send(socket, { type: "error", message: "Missing task name" });
-    return;
-  }
-  const config = loadConfig();
-  const task = config.tasks[taskName];
-  if (!task) {
-    send(socket, { type: "error", message: `Task not found: ${taskName}` });
-    return;
-  }
-  send(socket, { type: "ack", command: "run", task: taskName });
-  const state = loadState();
-  runTask(taskName, task, config, state).catch((err) => {
-    console.error(`[socket] runTask error for ${taskName}:`, err.message);
-  });
-}
-
 function handleMessage(socket, line) {
   let request;
   try {
@@ -369,21 +425,32 @@ function handleMessage(socket, line) {
     return;
   }
 
-  const handlers = {
-    status: () => handleStatusRequest(socket),
-    restart: () => handleRestartRequest(socket),
-    run: () => handleRunRequest(socket, request.task),
-  };
+  if (request.type === "status") return handleStatusRequest(socket);
 
-  const handler = handlers[request.type];
-  if (handler) {
-    handler();
-  } else {
-    send(socket, {
-      type: "error",
-      message: `Unknown request type: ${request.type}`,
-    });
+  if (request.type === "run") {
+    if (!request.task) {
+      send(socket, { type: "error", message: "Missing task name" });
+      return;
+    }
+    const config = loadConfig();
+    const task = config.tasks[request.task];
+    if (!task) {
+      send(socket, {
+        type: "error",
+        message: `Task not found: ${request.task}`,
+      });
+      return;
+    }
+    send(socket, { type: "ack", command: "run", task: request.task });
+    const state = loadState();
+    runTask(request.task, task, config, state).catch(() => {});
+    return;
   }
+
+  send(socket, {
+    type: "error",
+    message: `Unknown request type: ${request.type}`,
+  });
 }
 
 function startSocketServer() {
@@ -416,9 +483,6 @@ function startSocketServer() {
 
   const cleanup = () => {
     server.close();
-    try {
-      unlinkSync(SOCKET_PATH);
-    } catch {}
     process.exit(0);
   };
   process.on("SIGTERM", cleanup);
@@ -434,7 +498,7 @@ function daemon() {
   log("Scheduler daemon started. Polling every 60 seconds.");
   log(`Config: ${CONFIG_PATH}  State: ${STATE_PATH}`);
   startSocketServer();
-  runDueTasks();
+  runDueTasks().catch((err) => log(`Error: ${err.message}`));
   setInterval(async () => {
     try {
       await runDueTasks();
@@ -446,17 +510,18 @@ function daemon() {
 
 // --- Init knowledge base ----------------------------------------------------
 
-function copyDirRecursive(src, dest) {
-  for (const entry of readdirSync(src, { withFileTypes: true })) {
-    const s = join(src, entry.name),
-      d = join(dest, entry.name);
-    if (entry.isDirectory()) {
-      ensureDir(d);
-      copyDirRecursive(s, d);
-    } else if (!existsSync(d)) {
-      writeFileSync(d, readFileSync(s));
-    }
+function findTemplateDir() {
+  const bundle = getBundlePath();
+  if (bundle) {
+    const tpl = join(bundle.resources, "template");
+    if (existsSync(tpl)) return tpl;
   }
+  for (const d of [
+    join(SHARE_DIR, "template"),
+    join(__dirname, "..", "template"),
+  ])
+    if (existsSync(d)) return d;
+  return null;
 }
 
 function initKB(targetPath) {
@@ -465,6 +530,11 @@ function initKB(targetPath) {
     console.error(`Knowledge base already exists at ${dest}`);
     process.exit(1);
   }
+  const tpl = findTemplateDir();
+  if (!tpl) {
+    console.error("Template not found. Reinstall fit-basecamp.");
+    process.exit(1);
+  }
 
   ensureDir(dest);
   for (const d of [
@@ -472,11 +542,10 @@ function initKB(targetPath) {
     "knowledge/Organizations",
     "knowledge/Projects",
     "knowledge/Topics",
-    ".claude/skills",
   ])
     ensureDir(join(dest, d));
 
-  if (existsSync(KB_TEMPLATE_DIR)) copyDirRecursive(KB_TEMPLATE_DIR, dest);
+  execSync(`cp -R "${tpl}/." "${dest}/"`);
 
   console.log(
     `Knowledge base initialized at ${dest}\n\nNext steps:\n  1. Edit ${dest}/USER.md with your name, email, and domain\n  2. cd ${dest} && claude`,
@@ -492,26 +561,23 @@ function showStatus() {
 
   const tasks = Object.entries(config.tasks || {});
   if (tasks.length === 0) {
-    console.log(
-      `Tasks: (none configured)\n\nEdit ${CONFIG_PATH} to add tasks.`,
-    );
+    console.log(`No tasks configured.\n\nEdit ${CONFIG_PATH} to add tasks.`);
     return;
   }
 
   console.log("Tasks:");
   for (const [name, task] of tasks) {
     const s = state.tasks[name] || {};
-    const kbPath = task.kb ? expandPath(task.kb) : null;
-    const kbStatus = kbPath ? (existsSync(kbPath) ? "" : " (not found)") : "";
-    const lines = [
-      `  ${task.enabled !== false ? "+" : "-"} ${name}`,
-      `    KB: ${task.kb || "(none)"}${kbStatus}  Schedule: ${JSON.stringify(task.schedule)}`,
-      `    Status: ${s.status || "never-run"}  Last run: ${s.lastRunAt ? new Date(s.lastRunAt).toLocaleString() : "never"}  Runs: ${s.runCount || 0}`,
-    ];
-    if (task.agent) lines.push(`    Agent: ${task.agent}`);
-    if (task.skill) lines.push(`    Skill: ${task.skill}`);
-    if (s.lastError) lines.push(`    Error: ${s.lastError.slice(0, 80)}`);
-    console.log(lines.join("\n"));
+    const kbStatus =
+      task.kb && !existsSync(expandPath(task.kb)) ? " (not found)" : "";
+    console.log(
+      `  ${task.enabled !== false ? "+" : "-"} ${name}\n` +
+        `    KB: ${task.kb || "(none)"}${kbStatus}  Schedule: ${JSON.stringify(task.schedule)}\n` +
+        `    Status: ${s.status || "never-run"}  Last: ${s.lastRunAt ? new Date(s.lastRunAt).toLocaleString() : "never"}  Runs: ${s.runCount || 0}` +
+        (task.agent ? `\n    Agent: ${task.agent}` : "") +
+        (task.skill ? `\n    Skill: ${task.skill}` : "") +
+        (s.lastError ? `\n    Error: ${s.lastError.slice(0, 80)}` : ""),
+    );
   }
 }
 
@@ -544,7 +610,7 @@ function validate() {
     }
     const kbPath = expandPath(task.kb);
     if (!existsSync(kbPath)) {
-      console.log(`  [FAIL] ${name}: path does not exist: ${kbPath}`);
+      console.log(`  [FAIL] ${name}: path not found: ${kbPath}`);
       errors++;
       continue;
     }
@@ -559,25 +625,17 @@ function validate() {
           ? join("agents", sub.endsWith(".md") ? sub : sub + ".md")
           : join("skills", sub, "SKILL.md");
       const found = findInLocalOrGlobal(kbPath, relPath);
-      if (found) {
-        console.log(`  [OK]   ${name}: ${kind} "${sub}" found at ${found}`);
-      } else {
-        console.log(
-          `  [FAIL] ${name}: ${kind} "${sub}" not found in ${join(kbPath, ".claude", relPath)} or ${join(HOME, ".claude", relPath)}`,
-        );
-        errors++;
-      }
+      console.log(
+        `  [${found ? "OK" : "FAIL"}]  ${name}: ${kind} "${sub}"${found ? "" : " not found"}`,
+      );
+      if (!found) errors++;
     }
 
     if (!task.agent && !task.skill)
       console.log(`  [OK]   ${name}: no agent or skill to validate`);
   }
 
-  console.log(
-    errors > 0
-      ? `\nValidation failed: ${errors} error(s) found.`
-      : "\nAll tasks validated successfully.",
-  );
+  console.log(errors > 0 ? `\n${errors} error(s).` : "\nAll OK.");
   if (errors > 0) process.exit(1);
 }
 
@@ -586,7 +644,7 @@ function validate() {
 function showHelp() {
   const bin = "fit-basecamp";
   console.log(`
-Basecamp Scheduler — Run scheduled tasks across multiple knowledge bases.
+Basecamp — Run scheduled Claude tasks across knowledge bases.
 
 Usage:
   ${bin}                     Run due tasks once and exit
@@ -595,28 +653,10 @@ Usage:
   ${bin} --init <path>       Initialize a new knowledge base
   ${bin} --validate          Validate agents and skills exist
   ${bin} --status            Show task status
-  ${bin} --help              Show this help
 
 Config:  ~/.fit/basecamp/scheduler.json
 State:   ~/.fit/basecamp/state.json
 Logs:    ~/.fit/basecamp/logs/
-
-Config format:
-  {
-    "tasks": {
-      "sync-mail": {
-        "kb": "~/Documents/Personal",
-        "schedule": { "type": "interval", "minutes": 5 },
-        "prompt": "Sync Apple Mail.", "skill": "sync-apple-mail",
-        "agent": null, "enabled": true
-      }
-    }
-  }
-
-Schedule types:
-  interval: { "type": "interval", "minutes": 5 }
-  cron:     { "type": "cron", "expression": "0 8 * * *" }
-  once:     { "type": "once", "runAt": "2025-02-12T10:00:00Z" }
 `);
 }
 

package/template/.claude/settings.json

@@ -1,10 +1,47 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
   "permissions": {
+    "defaultMode": "acceptEdits",
     "allow": [
+      "Bash(python3 *)",
+      "Bash(sqlite3 *)",
+      "Bash(bash scripts/*)",
+      "Bash(sh scripts/*)",
+      "Bash(node *)",
+      "Bash(npm install *)",
+      "Bash(npx *)",
+      "Bash(rg *)",
+      "Bash(find *)",
+      "Bash(cat *)",
+      "Bash(head *)",
+      "Bash(tail *)",
+      "Bash(ls *)",
+      "Bash(ls)",
+      "Bash(grep *)",
+      "Bash(echo *)",
+      "Bash(date *)",
+      "Bash(mkdir *)",
+      "Bash(mv *)",
+      "Bash(cp *)",
+      "Bash(touch *)",
+      "Bash(sort *)",
+      "Bash(wc *)",
+      "Bash(cut *)",
+      "Bash(tr *)",
+      "Bash(uniq *)",
+      "Bash(awk *)",
+      "Bash(sed *)",
+      "Bash(basename *)",
+      "Bash(dirname *)",
+      "Bash(realpath *)",
+      "Bash(pwd)",
+      "Bash(which *)",
+      "Bash(textutil *)",
+      "Bash(pdftotext *)",
       "Read(~/Library/Mail/**)",
       "Read(~/Library/Group Containers/group.com.apple.calendar/**)",
       "Read(~/Library/Calendars/**)",
+      "Read(~/Library/Application Support/hyprnote/**)",
       "Read(~/Desktop/**)",
       "Read(~/Documents/**)",
       "Read(~/Downloads/**)",
@@ -15,6 +52,17 @@
       "Edit(~/.cache/fit/basecamp/**)"
     ],
     "deny": [
+      "Bash(curl *)",
+      "Bash(wget *)",
+      "Bash(open *)",
+      "Bash(osascript *)",
+      "Bash(sudo *)",
+      "Bash(rm -rf *)",
+      "Bash(chmod *)",
+      "Bash(chown *)",
+      "Bash(killall *)",
+      "Bash(launchctl *)",
+      "Bash(brew *)",
       "Edit(~/Library/**)",
       "Read(~/Pictures/**)",
       "Read(~/Music/**)",
@@ -31,6 +79,7 @@
       "~/Library/Mail",
       "~/Library/Group Containers/group.com.apple.calendar",
       "~/Library/Calendars",
+      "~/Library/Application Support/hyprnote",
       "~/Desktop",
       "~/Documents",
       "~/Downloads",

package/template/.claude/skills/draft-emails/SKILL.md

@@ -16,13 +16,15 @@ Run when the user asks to draft, reply to, or respond to an email.
 ## Prerequisites
 
 - Knowledge base populated (from `extract-entities` skill)
-- Synced email data in `~/.cache/fit/basecamp/apple_mail/`
+- Synced email data in `~/.cache/fit/basecamp/apple_mail/` or
+  `~/.cache/fit/basecamp/gmail/`
 
 ## Inputs
 
 - `knowledge/People/*.md` — person context
 - `knowledge/Organizations/*.md` — organization context
-- `~/.cache/fit/basecamp/apple_mail/*.md` — email threads
+- `~/.cache/fit/basecamp/apple_mail/*.md` or `~/.cache/fit/basecamp/gmail/*.md`
+  — email threads
 - `~/.cache/fit/basecamp/apple_calendar/*.json` — calendar events (for
   scheduling)
 - `drafts/last_processed` — timestamp of last processing run
@@ -116,7 +118,7 @@ cat "knowledge/Organizations/Company Name.md"
 **Calendar (for scheduling emails):**
 
 ```bash
-ls ~/.cache/fit/basecamp/apple_calendar/ 2>/dev/null
+ls ~/.cache/fit/basecamp/apple_calendar/ ~/.cache/fit/basecamp/google_calendar/ 2>/dev/null
 cat "$HOME/.cache/fit/basecamp/apple_calendar/event123.json"
 ```
 
@@ -184,6 +186,33 @@ date -u '+%Y-%m-%dT%H:%M:%SZ' > drafts/last_processed
 - {id}: {subject} — {reason}
 ```
 
+## Recruitment & Staffing Emails
+
+**CRITICAL: Candidates must NEVER be copied on internal emails about them.**
+
+When an email involves recruitment, staffing, or hiring:
+
+1. **Identify the candidate** — Determine who the candidate is from the email
+   thread and knowledge base (`knowledge/Candidates/`, `knowledge/People/`)
+2. **Strip the candidate from recipients** — The draft must ONLY be addressed to
+   internal stakeholders (hiring managers, recruiters, interview panel, etc.).
+   The candidate’s email address must NOT appear in To, CC, or BCC
+3. **Only recruiters email candidates directly** — If the email is a direct
+   reply TO a candidate (e.g., scheduling an interview, extending an offer),
+   flag it clearly so only the recruiter sends it. Add a note:
+   `⚠️ RECRUITER ONLY — This email goes directly to the candidate.`
+
+**Examples of internal recruitment emails (candidate must NOT be copied):**
+
+- Interview feedback or debrief
+- Candidate evaluation or comparison
+- Hiring decision discussions
+- Compensation/offer discussions
+- Reference check follow-ups between colleagues
+
+**When in doubt:** If an email thread mentions a candidate by name and involves
+multiple internal recipients, treat it as internal and exclude the candidate.
+
 ## Constraints
 
 - Never actually send emails — only create drafts

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

@@ -3,14 +3,15 @@
 #
 # Usage: bash scripts/scan-emails.sh
 #
-# Checks ~/.cache/fit/basecamp/apple_mail/ for email files
-# not yet listed in drafts/drafted or drafts/ignored.
+# Checks ~/.cache/fit/basecamp/apple_mail/ for email files not yet
+# listed in drafts/drafted or drafts/ignored.
 # Outputs tab-separated: email_id<TAB>subject
 
 set -euo pipefail
 
 MAIL_DIRS=(
   "$HOME/.cache/fit/basecamp/apple_mail"
+  "$HOME/.cache/fit/basecamp/gmail"
 )
 
 for dir in "${MAIL_DIRS[@]}"; do

package/template/.claude/skills/extract-entities/SKILL.md

@@ -264,7 +264,6 @@ person?"** test:
 - Transactional service providers (bank employees, support reps)
 - One-time administrative contacts
 - Large group meeting attendees you didn't interact with
-- Internal colleagues (@user.domain)
 - Assistants handling only logistics
 
 For people who don't get their own note, add to the Organization note's

package/template/.claude/skills/extract-entities/references/TEMPLATES.md

@@ -10,6 +10,7 @@ Templates for creating new knowledge base notes.
 ## Info
 **Role:** {role or inferred role with qualifier}
 **Organization:** [[Organizations/{organization}]]
+**Reports to:** [[People/{{Person}}]]
 **Email:** {email}
 **Aliases:** {comma-separated variants}
 **First met:** {YYYY-MM-DD}