@forwardimpact/basecamp 2.9.2 → 2.9.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/basecamp",
-  "version": "2.9.2",
+  "version": "2.9.4",
   "description": "Claude Code-native personal knowledge system with autonomous agents",
   "license": "Apache-2.0",
   "repository": {
@@ -30,7 +30,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "xlsx": "^0.18.5"
+    "read-excel-file": "^7.0.3"
   },
   "publishConfig": {
     "access": "public"

package/template/.claude/skills/workday-requisition/SKILL.md

@@ -28,9 +28,9 @@ Run this skill:
 
 - A Workday requisition export file (`.xlsx`) accessible on the filesystem
   (typically in `~/Downloads/`)
-- The `xlsx` npm package installed in the KB root:
+- The `read-excel-file` npm package installed in the KB root:
   ```bash
-  npm install xlsx
+  npm install read-excel-file
   ```
 - User identity configured in `USER.md`
 
@@ -135,9 +135,9 @@ Names may include parenthetical annotations:
 
 1. Read `USER.md` to get the user's name, email, and domain.
 2. Confirm the XLSX file path with the user (or use the provided path).
-3. Ensure the `xlsx` package is installed:
+3. Ensure the `read-excel-file` package is installed:
    ```bash
-   npm list xlsx 2>/dev/null || npm install xlsx
+   npm list read-excel-file 2>/dev/null || npm install read-excel-file
    ```
 
 ## Step 1: Parse the Export

package/template/.claude/skills/workday-requisition/scripts/parse-workday.mjs

@@ -19,11 +19,9 @@
  *   node scripts/parse-workday.mjs <path-to-xlsx> --summary
  *   node scripts/parse-workday.mjs -h|--help
  *
- * Requires: npm install xlsx
+ * Requires: npm install read-excel-file
  */
 
-import { readFileSync } from "node:fs";
-
 if (
   process.argv.includes("-h") ||
   process.argv.includes("--help") ||
@@ -39,16 +37,16 @@ Usage:
 Output (JSON):
   { requisition: { id, title, ... }, candidates: [ { name, ... }, ... ] }
 
-Requires: npm install xlsx`);
+Requires: npm install read-excel-file`);
   process.exit(process.argv.length < 3 ? 1 : 0);
 }
 
-let XLSX;
+let readXlsxFile;
 try {
-  XLSX = await import("xlsx");
+  readXlsxFile = (await import("read-excel-file/node")).default;
 } catch {
   console.error(
-    "Error: xlsx package not found. Install it first:\n  npm install xlsx",
+    "Error: read-excel-file package not found. Install it first:\n  npm install read-excel-file",
   );
   process.exit(1);
 }
@@ -56,13 +54,20 @@ try {
 const filePath = process.argv[2];
 const summaryMode = process.argv.includes("--summary");
 
-const data = readFileSync(filePath);
-const wb = XLSX.read(data, { type: "buffer", cellDates: true });
+/** Read a sheet by number (1-indexed) or name, returning rows as arrays of strings. */
+async function readSheet(file, sheet) {
+  const rows = await readXlsxFile(file, { sheet });
+  // Normalise null cells to empty strings to match previous behaviour
+  return rows.map((row) => row.map((cell) => (cell == null ? "" : cell)));
+}
+
+// Get sheet names to find the candidates sheet
+const sheets = await readXlsxFile(filePath, { getSheets: true });
+const sheetNames = sheets.map((s) => s.name);
 
 // --- Sheet 1: Requisition metadata ---
 
-const ws1 = wb.Sheets[wb.SheetNames[0]];
-const sheet1Rows = XLSX.utils.sheet_to_json(ws1, { header: 1, defval: "" });
+const sheet1Rows = await readSheet(filePath, 1);
 
 /** Extract the requisition ID and title from the header row. */
 function parseReqHeader(headerText) {
@@ -113,10 +118,9 @@ const requisition = {
 //   - Old format: 3+ sheets, candidates on a sheet named "Candidates" or Sheet3
 //   - New format: 2 sheets, candidates on Sheet2
 const candSheetName =
-  wb.SheetNames.find((n) => n.toLowerCase() === "candidates") ||
-  wb.SheetNames[Math.min(2, wb.SheetNames.length - 1)];
-const ws3 = wb.Sheets[candSheetName];
-const candRows = XLSX.utils.sheet_to_json(ws3, { header: 1, defval: "" });
+  sheetNames.find((n) => n.toLowerCase() === "candidates") ||
+  sheetNames[Math.min(2, sheetNames.length - 1)];
+const candRows = await readSheet(filePath, candSheetName);
 
 // Find the header row dynamically — look for a row containing "Stage"
 // Old format: row 3 (index 2). New format: row 8 (index 7).
@@ -199,7 +203,7 @@ function parseName(raw) {
   const match = name.match(/^(.+?)\s*\(([^)]+)\)\s*$/);
   if (match) {
     const annotation = match[2].trim();
-    let ie = "";
+    let ie;
     if (/prior\s*worker/i.test(annotation)) ie = "External (Prior Worker)";
     else if (/internal/i.test(annotation)) ie = "Internal";
     else ie = annotation;

package/README.md

@@ -1,229 +0,0 @@
-# @forwardimpact/basecamp
-
-A personal knowledge system that runs as scheduled Claude Code tasks. No server,
-no database — just plain files, markdown, and the `claude` CLI. Packaged as a
-native macOS app bundle (`Basecamp.app`) with TCC-compliant process management.
-
-Part of the [Forward Impact](https://www.forwardimpact.team) monorepo.
-
-## Architecture
-
-```
-Basecamp.app/                             # macOS app bundle
-└── Contents/
-    ├── Info.plist                         # Bundle metadata (LSUIElement)
-    ├── MacOS/
-    │   ├── Basecamp                      # Swift launcher (TCC responsible)
-    │   └── fit-basecamp                  # Deno scheduler (child process)
-    └── Resources/
-        ├── config/scheduler.json         # Default config
-        └── template/                     # KB template
-
-~/.fit/basecamp/                          # Scheduler home (user config)
-├── scheduler.json                        # Task definitions
-├── state.json                            # Task run state
-├── basecamp.sock                         # IPC socket
-└── logs/                                 # Scheduler logs
-
-~/Documents/Personal/                     # Default personal knowledge base
-├── CLAUDE.md                             # Claude Code instructions for this KB
-├── knowledge/                            # The knowledge graph
-│   ├── People/
-│   ├── Organizations/
-│   ├── Projects/
-│   └── Topics/
-├── .claude/skills/                       # Claude Code skill files
-└── drafts/                               # Email drafts
-```
-
-### Process Tree
-
-```
-Basecamp (Swift launcher, CFBundleExecutable, TCC responsible)
-├── fit-basecamp --daemon    (Deno scheduler, spawned via posix_spawn)
-│   └── claude --print ...   (spawned via posix_spawn FFI)
-└── [status menu UI]         (AppKit menu bar, in-process)
-```
-
-The Swift launcher is the main executable and TCC responsible process. It spawns
-the Deno scheduler via `posix_spawn` so child processes inherit TCC attributes.
-Users grant Calendar, Contacts, and other permissions once to Basecamp.app.
-
-## Install from Package
-
-1. Double-click `fit-basecamp-<version>.pkg`
-2. Follow the installer prompts
-
-The installer places `Basecamp.app` in `/Applications/` and initializes
-`~/Documents/Personal/` as the default knowledge base.
-
-After installing, open Basecamp from `/Applications/`. It runs as a menu bar app
-— use "Quit Basecamp" from the status menu to stop it.
-
-To uninstall, run `just uninstall` from the source tree.
-
-## Install from Source
-
-```bash
-cd products/basecamp
-
-# Run the scheduler in dev mode
-just daemon
-
-# Or initialize a new KB
-just init ~/Documents/Personal
-
-# Configure your identity
-vi ~/Documents/Personal/USER.md
-```
-
-## Building
-
-Requires [Deno](https://deno.com) >= 2.x and Xcode Command Line Tools.
-
-```bash
-# Build scheduler + launcher binaries
-just build
-
-# Build + assemble Basecamp.app
-just build-app
-
-# Build + assemble + .pkg installer
-just pkg
-
-# Or via npm:
-npm run build           # binaries only
-npm run build:app       # + Basecamp.app
-npm run build:pkg       # + .pkg installer
-```
-
-Output goes to `dist/`:
-
-```
-dist/
-├── fit-basecamp             # Deno scheduler binary
-├── Basecamp                 # Swift launcher binary
-└── Basecamp.app/            # Assembled app bundle
-```
-
-## Multiple Knowledge Bases
-
-The scheduler can run tasks across multiple knowledge bases. Each KB is an
-independent directory with its own CLAUDE.md, skills, and knowledge graph.
-
-### Adding a new KB
-
-```bash
-# Initialize a new knowledge base
-deno run --allow-all src/basecamp.js --init ~/Documents/Team
-
-# Edit the scheduler config to register it
-vi ~/.fit/basecamp/scheduler.json
-```
-
-### Scheduler config format
-
-`~/.fit/basecamp/scheduler.json`:
-
-```json
-{
-  "tasks": {
-    "sync-personal-mail": {
-      "kb": "~/Documents/Personal",
-      "schedule": { "type": "interval", "minutes": 5 },
-      "enabled": true,
-      "skill": "sync-apple-mail",
-      "prompt": "Sync Apple Mail."
-    },
-    "sync-team-calendar": {
-      "kb": "~/Documents/Team",
-      "schedule": { "type": "interval", "minutes": 10 },
-      "enabled": true,
-      "skill": "sync-apple-calendar",
-      "prompt": "Sync Apple Calendar."
-    }
-  }
-}
-```
-
-### Task fields
-
-| Field      | Required | Description                                                     |
-| ---------- | -------- | --------------------------------------------------------------- |
-| `kb`       | yes      | Path to the knowledge base directory (supports `~`)             |
-| `schedule` | yes      | When to run (`interval`, `cron`, or `once`)                     |
-| `prompt`   | yes      | The prompt sent to Claude                                       |
-| `enabled`  | no       | Set to `false` to disable. Default: `true`                      |
-| `agent`    | no       | Claude sub-agent name (passed as `--agent`)                     |
-| `skill`    | no       | Skill name (matches `.claude/skills/<name>/SKILL.md` in the KB) |
-
-### Schedule types
-
-```json
-{ "type": "interval", "minutes": 5 }
-{ "type": "cron", "expression": "0 8 * * *" }
-{ "type": "once", "runAt": "2025-02-12T10:00:00Z" }
-```
-
-## Updating
-
-When you upgrade Basecamp (install a new `.pkg`), the installer automatically
-runs `--update` on all configured knowledge bases. This pushes the latest
-`CLAUDE.md`, skills, and agents into each KB without touching your data.
-
-You can also run it manually at any time:
-
-```bash
-# Update all configured knowledge bases
-/Applications/Basecamp.app/Contents/MacOS/fit-basecamp --update
-
-# Update a specific knowledge base
-/Applications/Basecamp.app/Contents/MacOS/fit-basecamp --update ~/Documents/Personal
-```
-
-The update merges `.claude/settings.json` non-destructively — new entries are
-added but your existing permissions are preserved.
-
-## CLI Reference
-
-```
-fit-basecamp                     Run due tasks once and exit
-fit-basecamp --daemon            Run continuously (poll every 60s)
-fit-basecamp --run <task>        Run a specific task immediately
-fit-basecamp --init <path>       Initialize a new knowledge base
-fit-basecamp --update [path]     Update KB skills, agents, and CLAUDE.md
-fit-basecamp --status            Show knowledge bases and task status
-fit-basecamp --validate          Validate agents and skills exist
-fit-basecamp --help              Show this help
-```
-
-When running from source, use `deno run --allow-all src/basecamp.js` or
-`just run` instead of `fit-basecamp`.
-
-## Skills
-
-Skills are Claude Code-native `SKILL.md` files that are auto-discovered from
-`.claude/skills/<name>/SKILL.md` inside each knowledge base. The default KB
-ships with these skills:
-
-| Skill                  | Directory              | Purpose                                        |
-| ---------------------- | ---------------------- | ---------------------------------------------- |
-| Sync Apple Mail        | `sync-apple-mail`      | Sync Apple Mail threads via SQLite             |
-| Sync Apple Calendar    | `sync-apple-calendar`  | Sync Apple Calendar events via SQLite          |
-| Extract Entities       | `extract-entities`     | Process synced data into knowledge graph notes |
-| Draft Emails           | `draft-emails`         | Draft email responses using knowledge context  |
-| Meeting Prep           | `meeting-prep`         | Prepare briefings for upcoming meetings        |
-| Create Presentations   | `create-presentations` | Create slide decks as PDF                      |
-| Document Collaboration | `doc-collab`           | Document creation and collaboration            |
-| Organize Files         | `organize-files`       | File organization and cleanup                  |
-
-## Requirements
-
-- Claude CLI (`claude`) installed and authenticated
-- macOS 13+ (Ventura or later)
-- Xcode Command Line Tools (for building the Swift launcher)
-- Deno >= 2.x (for building the standalone binary)
-
-## License
-
-Apache-2.0