@forwardimpact/basecamp 2.5.0 → 2.6.0

package/template/.claude/skills/synthesize-deck/scripts/extract-pptx.mjs

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+/**
+ * Extract text from PowerPoint (.pptx) slides.
+ *
+ * PPTX files are ZIP archives containing XML. This script extracts all text
+ * from each slide and outputs it as structured markdown with slide headings.
+ * Handles multiple files and outputs to stdout or a file.
+ *
+ * Usage:
+ *   node scripts/extract-pptx.mjs <path-to-pptx>
+ *   node scripts/extract-pptx.mjs <path-to-pptx> -o /tmp/extract.txt
+ *   node scripts/extract-pptx.mjs file1.pptx file2.pptx
+ *   node scripts/extract-pptx.mjs -h|--help
+ *
+ * No external dependencies — uses Node.js built-in modules only.
+ */
+
+import { readFileSync, writeFileSync } from "node:fs";
+import { basename } from "node:path";
+
+const HELP = `extract-pptx — extract slide text from .pptx files
+
+Usage:
+  node scripts/extract-pptx.mjs <file.pptx> [file2.pptx ...]
+  node scripts/extract-pptx.mjs <file.pptx> -o <output.txt>
+  node scripts/extract-pptx.mjs -h|--help
+
+Options:
+  -o <path>   Write output to file instead of stdout
+  -h, --help  Show this help
+
+Output: Markdown-formatted text with ## Slide N headings per slide.
+Multiple files get # Deck: filename.pptx headings.`;
+
+if (
+  process.argv.includes("-h") ||
+  process.argv.includes("--help") ||
+  process.argv.length < 3
+) {
+  console.log(HELP);
+  process.exit(process.argv.length < 3 ? 1 : 0);
+}
+
+// --- Parse arguments ---
+
+const args = process.argv.slice(2);
+let outputPath = null;
+const files = [];
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === "-o" && i + 1 < args.length) {
+    outputPath = args[++i];
+  } else if (!args[i].startsWith("-")) {
+    files.push(args[i]);
+  }
+}
+
+if (files.length === 0) {
+  console.error("Error: no .pptx files provided");
+  process.exit(1);
+}
+
+// --- ZIP parsing (no dependencies) ---
+
+/**
+ * Parse a ZIP file's central directory to extract file entries.
+ * @param {Buffer} buf
+ * @returns {Array<{name: string, offset: number, compressedSize: number, compressionMethod: number}>}
+ */
+function parseZipEntries(buf) {
+  // Find End of Central Directory record (signature 0x06054b50)
+  let eocdOffset = -1;
+  for (let i = buf.length - 22; i >= 0; i--) {
+    if (
+      buf[i] === 0x50 &&
+      buf[i + 1] === 0x4b &&
+      buf[i + 2] === 0x05 &&
+      buf[i + 3] === 0x06
+    ) {
+      eocdOffset = i;
+      break;
+    }
+  }
+  if (eocdOffset === -1) throw new Error("Not a valid ZIP file");
+
+  const cdOffset = buf.readUInt32LE(eocdOffset + 16);
+  const cdEntries = buf.readUInt16LE(eocdOffset + 10);
+
+  const entries = [];
+  let pos = cdOffset;
+
+  for (let e = 0; e < cdEntries; e++) {
+    // Central directory file header signature: 0x02014b50
+    if (buf.readUInt32LE(pos) !== 0x02014b50) break;
+
+    const compressionMethod = buf.readUInt16LE(pos + 10);
+    const compressedSize = buf.readUInt32LE(pos + 20);
+    const nameLen = buf.readUInt16LE(pos + 28);
+    const extraLen = buf.readUInt16LE(pos + 30);
+    const commentLen = buf.readUInt16LE(pos + 32);
+    const localHeaderOffset = buf.readUInt32LE(pos + 42);
+    const name = buf.toString("utf8", pos + 46, pos + 46 + nameLen);
+
+    entries.push({
+      name,
+      offset: localHeaderOffset,
+      compressedSize,
+      compressionMethod,
+    });
+    pos += 46 + nameLen + extraLen + commentLen;
+  }
+
+  return entries;
+}
+
+const { inflateRawSync } = await import("node:zlib");
+
+/**
+ * Read the uncompressed content of a ZIP entry.
+ * @param {Buffer} buf
+ * @param {{offset: number, compressedSize: number, compressionMethod: number}} entry
+ * @returns {Buffer}
+ */
+function readEntry(buf, entry) {
+  const pos = entry.offset;
+  const nameLen = buf.readUInt16LE(pos + 26);
+  const extraLen = buf.readUInt16LE(pos + 28);
+  const dataStart = pos + 30 + nameLen + extraLen;
+  const raw = buf.subarray(dataStart, dataStart + entry.compressedSize);
+
+  if (entry.compressionMethod === 0) return raw;
+  if (entry.compressionMethod === 8) return inflateRawSync(raw);
+  throw new Error(
+    `Unsupported compression method ${entry.compressionMethod} for ${entry.name}`,
+  );
+}
+
+/**
+ * Extract all text content from slide XML using the DrawingML namespace.
+ * Matches <a:t>text</a:t> elements used by PowerPoint.
+ * @param {string} xml
+ * @returns {string[]}
+ */
+function extractTextFromXml(xml) {
+  const texts = [];
+  const re = /<a:t>([^<]*)<\/a:t>/g;
+  let match;
+  while ((match = re.exec(xml)) !== null) {
+    const text = match[1].trim();
+    if (text) texts.push(text);
+  }
+  return texts;
+}
+
+/**
+ * Extract slide text from a .pptx file.
+ * @param {string} filePath
+ * @returns {string} Markdown-formatted slide text
+ */
+function extractPptx(filePath) {
+  const buf = readFileSync(filePath);
+  const entries = parseZipEntries(buf);
+
+  // Find slide XML files and sort by slide number
+  const slideEntries = entries
+    .filter(
+      (e) => e.name.startsWith("ppt/slides/slide") && e.name.endsWith(".xml"),
+    )
+    .sort((a, b) => {
+      const numA = parseInt(a.name.match(/(\d+)/)?.[1] || "0", 10);
+      const numB = parseInt(b.name.match(/(\d+)/)?.[1] || "0", 10);
+      return numA - numB;
+    });
+
+  const lines = [];
+
+  for (const entry of slideEntries) {
+    const xml = readEntry(buf, entry).toString("utf8");
+    const texts = extractTextFromXml(xml);
+
+    if (texts.length > 0) {
+      const num = entry.name.match(/(\d+)/)?.[1] || "?";
+      lines.push(`## Slide ${num}`);
+      lines.push(texts.join("\n"));
+      lines.push("");
+    }
+  }
+
+  return lines.join("\n");
+}
+
+// --- Main ---
+
+const outputs = [];
+
+for (const file of files) {
+  if (files.length > 1) {
+    outputs.push(`# Deck: ${basename(file)}\n`);
+  }
+  outputs.push(extractPptx(file));
+}
+
+const result = outputs.join("\n");
+
+if (outputPath) {
+  writeFileSync(outputPath, result);
+  console.log(`Extracted ${files.length} deck(s) → ${outputPath}`);
+} else {
+  process.stdout.write(result);
+}

package/template/.claude/skills/track-candidates/SKILL.md

@@ -36,6 +36,7 @@ Run this skill:
 
 - `knowledge/Candidates/{Full Name}/brief.md` — candidate profile note
 - `knowledge/Candidates/{Full Name}/CV.pdf` — local copy of CV (or `CV.docx`)
+- `knowledge/Candidates/{Full Name}/headshot.jpeg` — candidate headshot photo
 - `~/.cache/fit/basecamp/state/graph_processed` — updated with processed threads
 
 ---
@@ -192,6 +193,48 @@ cp "~/.cache/fit/basecamp/apple_mail/attachments/{thread_id}/{filename}" \
 Use `CV.pdf` for PDF files and `CV.docx` for Word documents. The `## CV` link in
 the brief uses a relative path: `./CV.pdf`.
 
+### Headshot Discovery
+
+Search two locations for candidate headshot photos:
+
+1. **Email attachments** —
+   `~/.cache/fit/basecamp/apple_mail/attachments/{thread_id}/` may contain
+   headshot images sent by recruiters alongside CVs. Look for `.jpg`, `.jpeg`,
+   or `.png` files with candidate name fragments in the filename or that are
+   clearly portrait photos (not logos, signatures, or email decorations like
+   `image001.png`).
+
+2. **Downloads folder** — search `~/Downloads/` recursively (including
+   subdirectories) for headshot images:
+
+```bash
+find ~/Downloads -maxdepth 3 -type f \( -iname "*.jpg" -o -iname "*.jpeg" -o -iname "*.png" -o -iname "*.heic" \) 2>/dev/null
+```
+
+Match images to candidates by name similarity in the filename (e.g.
+`vitalii.jpeg` matches "Vitalii Huliai", `qazi.jpeg` matches "Qazi Rehman"). Use
+first name, last name, or full name matching — case-insensitive.
+
+When a headshot is found, copy it into the candidate directory with a
+standardized name:
+
+```bash
+cp "{source_path}" "knowledge/Candidates/{Full Name}/headshot.jpeg"
+```
+
+Always use `headshot.jpeg` as the filename regardless of the source format. If
+the source is PNG or HEIC, convert it first:
+
+```bash
+# PNG to JPEG
+magick "{source}.png" "knowledge/Candidates/{Full Name}/headshot.jpeg"
+# HEIC to JPEG
+magick "{source}.heic" "knowledge/Candidates/{Full Name}/headshot.jpeg"
+```
+
+If headshots exist in both locations, prefer the Downloads folder version (more
+likely to be a curated, high-quality photo).
+
 ## Step 3: Determine Pipeline Status
 
 Assign a status based on the email context:
@@ -430,3 +473,5 @@ produces a full framework-aligned assessment.
 - [ ] Skills tagged using framework skill IDs where possible
 - [ ] Gender field populated only from explicit pronouns/titles (never
       name-inferred)
+- [ ] Headshots searched in email attachments and `~/Downloads/` (recursive)
+- [ ] Found headshots copied as `headshot.jpeg` into candidate directory

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

@@ -70,56 +70,56 @@ detection.
 
 **New format** — stage-count summary (no HM/Recruiter/Location):
 
-| Row | Field                    | Example                                |
-| --- | ------------------------ | -------------------------------------- |
-| 1   | Title header             | `4951493 Principal Software Engineer…` |
-| 2   | Active Candidates        | `74 of 74`                             |
-| 3   | Active Referrals         | `3 of 3`                               |
-| 4   | Active Internal          | `4 of 4`                               |
-| 7+  | Stage counts             | `56 → Considered`                      |
+| Row | Field             | Example                                |
+| --- | ----------------- | -------------------------------------- |
+| 1   | Title header      | `4951493 Principal Software Engineer…` |
+| 2   | Active Candidates | `74 of 74`                             |
+| 3   | Active Referrals  | `3 of 3`                               |
+| 4   | Active Internal   | `4 of 4`                               |
+| 7+  | Stage counts      | `56 → Considered`                      |
 
 ### Candidates Sheet
 
 The parser auto-detects the candidates sheet and header row:
-- **Old format**: 3+ sheets; candidates on "Candidates" sheet or Sheet3;
-  header at row 3 (index 2); two "Job Application" columns
+
+- **Old format**: 3+ sheets; candidates on "Candidates" sheet or Sheet3; header
+  at row 3 (index 2); two "Job Application" columns
 - **New format**: 2 sheets; candidates on Sheet2; header at row 8 (index 7);
   single "Job Application" column
 
 Column mapping is header-driven — the parser reads the header row and maps
-columns by name, not position. Columns that vary between exports (e.g.
-"Jobs Applied to", "Referred by", "Convenience Task") are handled
-automatically.
+columns by name, not position. Columns that vary between exports (e.g. "Jobs
+Applied to", "Referred by", "Convenience Task") are handled automatically.
 
 **Core columns** (present in all formats):
 
-| Header                 | Maps to brief field…     |
-| ---------------------- | ------------------------ |
-| Job Application        | `# {Name}`               |
+| Header                 | Maps to brief field…                     |
+| ---------------------- | ---------------------------------------- |
+| Job Application        | `# {Name}`                               |
 | Stage                  | Row detection only (not used for status) |
-| Step / Disposition     | **Workday step** → status derivation |
-| Resume                 | Reference only (no file) |
-| Date Applied           | **First seen**           |
-| Current Job Title      | **Current title**, Title |
-| Current Company        | **Current title** suffix |
-| Source                 | **Source**               |
-| Referred by            | **Source** suffix        |
-| Candidate Location     | **Location**             |
-| Phone                  | **Phone**                |
-| Email                  | **Email**                |
-| Availability Date      | **Availability**         |
-| Visa Requirement       | Notes                    |
-| Eligible to Work       | Notes                    |
-| Relocation             | Notes                    |
-| Salary Expectations    | **Rate**                 |
-| Non-Compete            | Notes                    |
-| Total Years Experience | Summary context          |
-| All Job Titles         | Work History context     |
-| Companies              | Work History context     |
-| Degrees                | Education                |
-| Fields of Study        | Education                |
-| Language               | **English** / Language   |
-| Resume Text            | `CV.md` content          |
+| Step / Disposition     | **Workday step** → status derivation     |
+| Resume                 | Reference only (no file)                 |
+| Date Applied           | **First seen**                           |
+| Current Job Title      | **Current title**, Title                 |
+| Current Company        | **Current title** suffix                 |
+| Source                 | **Source**                               |
+| Referred by            | **Source** suffix                        |
+| Candidate Location     | **Location**                             |
+| Phone                  | **Phone**                                |
+| Email                  | **Email**                                |
+| Availability Date      | **Availability**                         |
+| Visa Requirement       | Notes                                    |
+| Eligible to Work       | Notes                                    |
+| Relocation             | Notes                                    |
+| Salary Expectations    | **Rate**                                 |
+| Non-Compete            | Notes                                    |
+| Total Years Experience | Summary context                          |
+| All Job Titles         | Work History context                     |
+| Companies              | Work History context                     |
+| Degrees                | Education                                |
+| Fields of Study        | Education                                |
+| Language               | **English** / Language                   |
+| Resume Text            | `CV.md` content                          |
 
 #### Name Annotations
 
@@ -175,28 +175,28 @@ Use fuzzy matching — the Workday name may differ slightly from an existing not
 
 ## Step 3: Determine Pipeline Status
 
-Map the **Step / Disposition** column to the `track-candidates` pipeline
-status. Do NOT use the Stage column for status — it is only used for row
-detection (stop condition):
-
-| Workday Step / Disposition                 | Pipeline Status    |
-| ------------------------------------------ | ------------------ |
-| `Considered`                               | `new`              |
-| `Review`                                   | `new`              |
-| `Manager Resume Screen`                    | `screening`        |
-| `Schedule Recruiter Phone Screen`          | `screening`        |
-| `Manager Request to Move Forward (HS)`     | `screening`        |
-| `Proposed Interview Slate`                 | `screening`        |
-| `Assessment`                               | `screening`        |
-| `Manager Request to Decline (HS)`          | `rejected`         |
-| `Interview` / `Phone Screen`              | `first-interview`  |
-| `Second Interview`                         | `second-interview` |
-| `Reference Check`                          | `second-interview` |
-| `Offer`                                    | `offer`            |
-| `Employment Agreement`                     | `offer`            |
-| `Background Check`                         | `hired`            |
-| `Ready for Hire`                           | `hired`            |
-| `Rejected` / `Declined`                    | `rejected`         |
+Map the **Step / Disposition** column to the `track-candidates` pipeline status.
+Do NOT use the Stage column for status — it is only used for row detection (stop
+condition):
+
+| Workday Step / Disposition             | Pipeline Status    |
+| -------------------------------------- | ------------------ |
+| `Considered`                           | `new`              |
+| `Review`                               | `new`              |
+| `Manager Resume Screen`                | `screening`        |
+| `Schedule Recruiter Phone Screen`      | `screening`        |
+| `Manager Request to Move Forward (HS)` | `screening`        |
+| `Proposed Interview Slate`             | `screening`        |
+| `Assessment`                           | `screening`        |
+| `Manager Request to Decline (HS)`      | `rejected`         |
+| `Interview` / `Phone Screen`           | `first-interview`  |
+| `Second Interview`                     | `second-interview` |
+| `Reference Check`                      | `second-interview` |
+| `Offer`                                | `offer`            |
+| `Employment Agreement`                 | `offer`            |
+| `Background Check`                     | `hired`            |
+| `Ready for Hire`                       | `hired`            |
+| `Rejected` / `Declined`                | `rejected`         |
 
 If the step value is empty or not recognized, default to `new`.
 

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

@@ -122,11 +122,7 @@ const candRows = XLSX.utils.sheet_to_json(ws3, { header: 1, defval: "" });
 // Old format: row 3 (index 2). New format: row 8 (index 7).
 let HEADER_ROW = 2;
 for (let i = 0; i < Math.min(15, candRows.length); i++) {
-  if (
-    candRows[i].some(
-      (c) => String(c).trim().toLowerCase() === "stage",
-    )
-  ) {
+  if (candRows[i].some((c) => String(c).trim().toLowerCase() === "stage")) {
     HEADER_ROW = i;
     break;
   }

package/template/CLAUDE.md

@@ -99,8 +99,8 @@ cycle. The naming convention is `{agent}_triage.md`:
 - `recruiter_triage.md` — candidate pipeline, assessments, track distribution
 - `head_hunter_triage.md` — prospect pipeline, source rotation, match strength
 
-The **chief-of-staff** reads all five triage files to synthesize daily
-briefings in `knowledge/Briefings/`.
+The **chief-of-staff** reads all five triage files to synthesize daily briefings
+in `knowledge/Briefings/`.
 
 ## Cache Directory (`~/.cache/fit/basecamp/`)