@forwardimpact/outpost 3.0.3

package/templates/.claude/skills/doc-collab/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: doc-collab
+description: Help the user create, edit, and refine documents in the knowledge base. Use when the user asks to create, edit, review, or collaborate on a document. Supports direct editing and approval-based workflows with knowledge base context for entity references.
+---
+
+# Document Collaboration
+
+Help the user create, edit, and refine documents in the knowledge base. Supports
+direct editing and approval-based workflows. Always uses knowledge base context
+for entity references.
+
+## Trigger
+
+Run when the user asks to create, edit, review, or collaborate on a document.
+
+## Prerequisites
+
+- Knowledge base directory exists
+
+## Inputs
+
+- User's editing instructions
+- `knowledge/` — existing notes and documents
+- Document to edit (user-specified or searched)
+
+## Outputs
+
+- Created or modified documents in `knowledge/` or user-specified location
+
+---
+
+## First: Ask About Edit Mode
+
+**Before doing anything, ask:** "Should I make edits directly, or show you
+changes first for approval?"
+
+- **Direct mode:** Make edits immediately, confirm after
+- **Approval mode:** Show proposed changes, wait for approval
+
+Follow their choice for the entire session.
+
+## Core Principles
+
+- **Re-read before every response** — the user may have edited the file manually
+- **Be concise** — don't propose outlines unless asked
+- **Don't assume** — if unclear, ask ONE simple question
+- **Use knowledge context** — search knowledge base for mentioned entities, use
+  `[[wiki-links]]`
+
+## Processing Flow
+
+### Step 1: Find the Document
+
+Search thoroughly before saying a document doesn't exist:
+
+```bash
+rg -l -i "roadmap" knowledge/
+find knowledge/ -iname "*roadmap*" 2>/dev/null
+```
+
+**If found:** Read it and proceed. **If NOT found:** Ask "I couldn't find
+[name]. Shall I create it?"
+
+**Creating new documents:**
+
+1. Ask: "Shall I create knowledge/[name].md?"
+2. Create with just a title — don't pre-populate with structure
+3. Ask: "What would you like in this?"
+
+### Step 2: Understand the Request
+
+**NEVER make unsolicited edits.** If the user hasn't specified what to change,
+ask: "What would you like to change?"
+
+Types of requests:
+
+1. **Direct edits** — "Change the title", "Add a bullet about Y"
+2. **Content generation** — "Write an intro", "Draft the summary"
+3. **Review/feedback** — "What do you think?", "Is this clear?"
+4. **Research-backed additions** — "Add context about [Person]"
+5. **No clear request** — Read the doc, then ask: "What would you like to
+   change?"
+
+### Step 3: Execute Changes
+
+Make targeted edits — change only what's needed. Preserve the user's voice and
+don't reorganize unless asked.
+
+### Step 4: Confirm and Continue
+
+- Briefly confirm: "Added the executive summary section"
+- Ask: "What's next?"
+- Don't read back the entire document unless asked
+
+## Searching Knowledge for Context
+
+When the user mentions people, companies, or projects:
+
+```bash
+rg -l "Name" knowledge/
+cat "knowledge/People/Person.md"
+cat "knowledge/Organizations/Company.md"
+```
+
+Use `[[wiki-links]]` to connect to other notes. Only link to notes that exist.
+
+## Constraints
+
+- Match the user's tone and style
+- Make surgical edits — change only what's needed
+- Preserve the user's voice — don't reorganize unless asked
+- Only link to notes that exist — use `[[Person Name]]` for existing notes

package/templates/.claude/skills/doc-create/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: doc-create
+description: Generate PDF documents from user requests using Playwright to render HTML to A4 PDF. Use when the user asks to create a document, proposal, report, or any multi-page PDF that is not a slide deck. Pulls context from the knowledge base for company info, project details, and people.
+compatibility: Requires Node.js installed. Playwright is installed on first use.
+---
+
+# Create Documents
+
+Generate multi-page A4 PDF documents from user requests. Uses Playwright to
+render self-contained HTML to PDF. Can pull context from the knowledge base for
+company info, project details, and people.
+
+## Trigger
+
+Run when the user asks to create a document, proposal, report, funding
+submission, brief, or any multi-page PDF that is not a slide deck.
+
+## Prerequisites
+
+- Node.js installed
+- Playwright will be installed on first use
+
+## Inputs
+
+- User's description of the document
+- `knowledge/` — optional context about company, product, team, projects
+
+## Outputs
+
+- An HTML file and a PDF rendered from it, placed where the user specifies
+  (default: `knowledge/Projects/`)
+
+---
+
+## Workflow
+
+1.  Check `knowledge/` for relevant context about the company, product, team,
+    projects, or people mentioned.
+2.  Ensure Playwright is installed:
+    `bun install playwright && bunx playwright install chromium`
+3.  Create a self-contained HTML file with all CSS inlined. The HTML must handle
+    its own page layout — see **HTML Document Rules** below.
+4.  Run the conversion script:
+
+        node .claude/skills/doc-create/scripts/convert-to-pdf.mjs <input.html> [output.pdf]
+
+    If output is omitted, the PDF is written alongside the HTML file with the
+    same name.
+
+5.  Read the PDF back to visually verify it renders correctly. Check each page
+    for overflow, clipped content, and correct page breaks. Fix and re-render if
+    needed.
+
+**Do NOT show HTML code to the user. Just create the PDF and deliver it.**
+
+## HTML Document Rules
+
+**Page layout:**
+
+- Each page is a `<div class="page">` sized to exactly 210mm × 297mm (A4)
+- Use `page-break-after: always` on every `.page` except the last
+- Handle margins with padding inside `.page`, not with PDF margin settings
+- The PDF is rendered with zero margins — the HTML owns all spacing
+
+**Print colours:**
+
+- Always set `-webkit-print-color-adjust: exact` and `print-color-adjust: exact`
+  on `body` so background colours render in the PDF
+
+**Fonts:**
+
+- Use system fonts only — no external font loading
+- Monospace stack: `'SF Mono', 'Menlo', 'Monaco', 'Consolas', monospace`
+- Sans-serif stack:
+  `-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif`
+
+**Content fitting:**
+
+- After the first render, visually check every page for overflow
+- Content must not bleed past the `.page` boundary — if it does, reduce spacing
+  or font sizes and re-render
+- Page numbers, if used, must not overlap with content. Position them in a
+  corner that has whitespace
+
+**CSS @page:**
+
+```css
+@page { size: A4; margin: 0; }
+```
+
+**Images:**
+
+- Use absolute `file://` paths for local images
+- Inline small images as base64 data URIs when possible
+- Verify images appear in the rendered PDF — Playwright can fail silently on
+  missing images
+
+## Design Principles
+
+- Clean, professional typography with clear hierarchy
+- Use monospace for section headers and numbers for a technical/engineering feel
+- Tables should be compact and readable — right-align monetary values
+- Use colour sparingly: one accent colour, one dark, lots of white space
+- Dark-background panels (timelines, hero sections) create visual contrast
+- Callout boxes with left borders draw attention to key statements

package/templates/.claude/skills/doc-create/scripts/convert-to-pdf.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env bun
+/**
+ * Convert an HTML document to A4 PDF using Playwright.
+ *
+ * Renders an HTML file into an A4 PDF with background colours preserved and
+ * zero margins (the HTML is expected to handle its own page layout via CSS
+ * @page rules and page-break-after). Defaults to writing the PDF alongside
+ * the input file when no output path is given.
+ *
+ * Requires: bun install playwright && bunx playwright install chromium
+ */
+
+import { resolve, dirname, basename, join } from "node:path";
+
+const HELP = `convert-to-pdf — render an HTML document to A4 PDF via Playwright
+
+Usage: bun scripts/convert-to-pdf.mjs <input.html> [output.pdf] [-h|--help]
+
+Arguments:
+  input.html   HTML document file (required)
+  output.pdf   Output PDF path (default: same directory and name as input, with .pdf extension)
+
+Requires: bun install playwright && bunx playwright install chromium`;
+
+if (
+  process.argv.includes("-h") ||
+  process.argv.includes("--help") ||
+  process.argv.length < 3
+) {
+  console.log(HELP);
+  process.exit(process.argv.length < 3 ? 1 : 0);
+}
+
+const positional = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+const input = resolve(positional[0]);
+const output =
+  positional[1] || join(dirname(input), basename(input, ".html") + ".pdf");
+
+const { chromium } = await import("playwright");
+const browser = await chromium.launch();
+const page = await browser.newPage();
+await page.goto(`file://${input}`, { waitUntil: "networkidle" });
+await page.pdf({
+  path: output,
+  format: "A4",
+  printBackground: true,
+  margin: { top: "0", right: "0", bottom: "0", left: "0" },
+});
+await browser.close();
+console.log(`Done: ${output}`);

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

@@ -0,0 +1,141 @@
+---
+name: draft-emails
+description: Draft and send email responses using the knowledge base and calendar for context. Use when the user asks to draft, reply to, respond to, or send an email.
+---
+
+# Draft Emails
+
+Draft and send email responses using the knowledge base and calendar for full
+context on every person and conversation. Every draft requires explicit user
+approval before sending.
+
+## Trigger
+
+The user asks to draft, reply to, respond to, or send an email.
+
+## Prerequisites
+
+- Knowledge base populated (from `extract-entities`).
+- Synced email data in `~/.cache/fit/outpost/apple_mail/`.
+
+## Data locations
+
+| Data            | Location                                     |
+| --------------- | -------------------------------------------- |
+| People          | `knowledge/People/*.md`                      |
+| Organizations   | `knowledge/Organizations/*.md`               |
+| Email threads   | `~/.cache/fit/outpost/apple_mail/*.md`       |
+| Calendar events | `~/.cache/fit/outpost/apple_calendar/*.json` |
+| Handled IDs     | `drafts/handled` (one ID per line)           |
+| Ignored IDs     | `drafts/ignored` (one ID per line)           |
+| Draft files     | `drafts/{email_id}_draft.md`                 |
+
+`handled` and `ignored` both exclude threads from `scan-emails.mjs`. Use
+`handled` for resolved threads (sent here, replied manually, resolved via DM);
+`ignored` for threads that need no response (newsletters, spam, outbound with no
+reply).
+
+<do_confirm_checklist goal="Verify a draft is safe and ready before sending">
+
+- [ ] Sender and organization were looked up in `knowledge/` before drafting.
+- [ ] Draft is a single email (not multiple variants) and matches the incoming
+      tone.
+- [ ] Body has no sign-off / name / "Best" — Apple Mail signature handles it.
+- [ ] Recruitment thread: candidate excluded from internal recipients; any
+      direct-to-candidate draft is flagged `⚠️ RECRUITER ONLY`.
+- [ ] No sensitive personal data (health, politics, etc.) was included.
+- [ ] User has explicitly approved the draft before any send.
+- [ ] Send used `--draft <path>` so cleanup and `drafts/handled` happen
+      automatically.
+
+</do_confirm_checklist>
+
+## Procedure
+
+### 1. Scan for new emails
+
+```bash
+node scripts/scan-emails.mjs
+```
+
+Outputs `email_id<TAB>subject` for unprocessed emails (those not in
+`drafts/handled` or `drafts/ignored`).
+
+### 2. Classify
+
+**Ignore** (append ID to `drafts/ignored`): newsletters, marketing, automated
+notifications, spam, outbound with no reply.
+
+**Draft a response**: meeting requests, personal mail from known contacts,
+business inquiries or follow-ups, requests for information or action.
+
+Be conservative with ignore — when in doubt, draft.
+
+### 3. Gather context
+
+Before drafting, look up the sender and organization in `knowledge/`:
+
+```bash
+rg -l "sender_name" knowledge/
+cat "knowledge/People/Sender Name.md"
+cat "knowledge/Organizations/Company Name.md"
+```
+
+For scheduling emails, also read the relevant calendar event:
+
+```bash
+ls ~/.cache/fit/outpost/apple_calendar/ 2>/dev/null
+cat "$HOME/.cache/fit/outpost/apple_calendar/event123.json"
+```
+
+Extract role, organization, relationship history, and open items. If intent is
+unclear or the person has multiple contexts, **ask** rather than guess.
+
+### 4. Write the draft
+
+Save to `drafts/{email_id}_draft.md` using the template in
+[references/template.md](references/template.md). Reference past interactions
+naturally; for scheduling, propose specific times from calendar availability.
+
+### 5. Recruitment & staffing emails
+
+Candidates **must never** be copied on internal threads about them.
+
+- Identify the candidate from the thread and `knowledge/Candidates/`.
+- Strip the candidate from To/CC; draft to internal stakeholders only.
+- Direct-to-candidate emails carry the warning header
+  `⚠️ RECRUITER ONLY — This email goes directly to the candidate.`
+
+If a thread mentions a candidate and includes multiple internal recipients,
+treat it as internal and exclude the candidate.
+
+### 6. Present and approve
+
+Show the draft to the user. Wait for explicit approval before sending. Apply
+edits and present again as needed.
+
+### 7. Send
+
+After approval, send via Apple Mail:
+
+```bash
+node scripts/send-email.mjs \
+  --to "recipient@example.com" \
+  --cc "other@example.com" \
+  --subject "Re: Subject" \
+  --body "Plain text body" \
+  --draft "drafts/12345_draft.md"
+```
+
+Required: `--to`, `--subject`, `--body` (plain text). Optional: `--cc`, `--bcc`,
+`--draft`. With `--draft`, the draft file is deleted and the email ID is
+appended to `drafts/handled` automatically.
+
+### 8. Mark handled without sending
+
+When a thread is resolved through other channels:
+
+```bash
+echo "$EMAIL_ID" >> drafts/handled
+rm -f "drafts/${EMAIL_ID}_draft.md"
+```

package/templates/.claude/skills/draft-emails/references/template.md

@@ -0,0 +1,26 @@
+# Draft File Template
+
+Save each draft to `drafts/{email_id}_draft.md` using this layout:
+
+```markdown
+# Draft Response
+
+**To:** recipient@example.com
+**CC:** other@example.com
+**Subject:** Re: {subject}
+
+---
+
+{personalized draft body — no sign-off, no name at end}
+
+---
+
+## Notes
+- **Original Email ID:** {id}
+- **From:** {sender}
+- **Context:** {knowledge base notes used}
+```
+
+The body must end with the last sentence of content. Apple Mail appends the
+user's configured signature automatically, so do **not** add a sign-off, "Best",
+"Cheers", or the user's name.

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

@@ -0,0 +1,66 @@
+#!/usr/bin/env bun
+/**
+ * Scan for unprocessed emails and output their IDs and subjects.
+ *
+ * Checks ~/.cache/fit/outpost/apple_mail/ for email thread markdown files not
+ * 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.
+ */
+
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { homedir } from "node:os";
+
+const HELP = `scan-emails — list unprocessed email threads
+
+Usage: node scripts/scan-emails.mjs [-h|--help]
+
+Scans ~/.cache/fit/outpost/apple_mail/ for .md thread files not yet
+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")) {
+  console.log(HELP);
+  process.exit(0);
+}
+
+const HOME = homedir();
+const MAIL_DIR = join(HOME, ".cache/fit/outpost/apple_mail");
+
+/** Load a file of IDs (one per line) into a Set. */
+function loadIdSet(path) {
+  const ids = new Set();
+  if (!existsSync(path)) return ids;
+  for (const line of readFileSync(path, "utf-8").split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed) ids.add(trimmed);
+  }
+  return ids;
+}
+
+/** Extract the first H1 heading from a markdown file. */
+function extractSubject(filePath) {
+  const text = readFileSync(filePath, "utf-8");
+  const match = text.match(/^# (.+)$/m);
+  return match ? match[1] : "";
+}
+
+function main() {
+  if (!existsSync(MAIL_DIR)) return;
+
+  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 (handled.has(emailId) || ignored.has(emailId)) continue;
+
+    const subject = extractSubject(join(MAIL_DIR, name));
+    console.log(`${emailId}\t${subject}`);
+  }
+}
+
+main();

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

@@ -0,0 +1,139 @@
+#!/usr/bin/env bun
+/**
+ * Send an email via Apple Mail using AppleScript.
+ *
+ * Builds an AppleScript command to create and send an outgoing message through
+ * 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
+ * or sign-off; Apple Mail appends the user's configured signature automatically.
+ */
+
+import { execFileSync } from "node:child_process";
+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
+
+Usage: node scripts/send-email.mjs --to <addrs> --subject <subj> --body <text> [options]
+
+Options:
+  --to <addrs>       Comma-separated To recipients (required)
+  --cc <addrs>       Comma-separated CC recipients
+  --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 signature or sign-off needed — Apple Mail appends it.`;
+
+if (process.argv.includes("-h") || process.argv.includes("--help")) {
+  console.log(HELP);
+  process.exit(0);
+}
+
+/** Escape a string for AppleScript double-quoted context. */
+function escapeAS(s) {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+/** Build recipient lines for AppleScript. */
+function recipientLines(type, addrs) {
+  if (!addrs) return "";
+  return addrs
+    .split(",")
+    .map((a) => a.trim())
+    .filter(Boolean)
+    .map(
+      (addr) =>
+        `        make new ${type} at end of ${type}s with properties {address:"${escapeAS(addr)}"}`,
+    )
+    .join("\n");
+}
+
+function parseArgs(args) {
+  const parsed = { to: "", cc: "", bcc: "", subject: "", body: "", draft: "" };
+  const keyMap = {
+    "--to": "to",
+    "--cc": "cc",
+    "--bcc": "bcc",
+    "--subject": "subject",
+    "--body": "body",
+    "--draft": "draft",
+  };
+  for (let i = 0; i < args.length; i++) {
+    const key = keyMap[args[i]];
+    if (key) parsed[key] = args[++i] ?? "";
+  }
+  if (!parsed.to || !parsed.subject || !parsed.body) {
+    console.error("Error: --to, --subject, and --body are required.");
+    console.error("Run with --help for usage info.");
+    process.exit(1);
+  }
+  parsed.body = parsed.body
+    .split("\n")
+    .map((line) => line.replace(/^ {2}/, ""))
+    .join("\n")
+    .trim();
+  return parsed;
+}
+
+function buildAppleScript({ to, cc, bcc, subject, body }) {
+  return [
+    'tell application "Mail"',
+    `    set newMessage to make new outgoing message with properties {subject:"${escapeAS(subject)}", content:"${escapeAS(body)}", visible:false}`,
+    "    tell newMessage",
+    recipientLines("to recipient", to),
+    cc ? recipientLines("cc recipient", cc) : "",
+    bcc ? recipientLines("bcc recipient", bcc) : "",
+    "    end tell",
+    "    send newMessage",
+    "end tell",
+  ]
+    .filter(Boolean)
+    .join("\n");
+}
+
+function handleDraftCleanup(draft) {
+  if (!draft) return;
+  try {
+    unlinkSync(draft);
+    console.log(`Removed draft: ${draft}`);
+  } catch {
+    /* ignore */
+  }
+  const draftBasename = basename(draft, ".md");
+  const emailId = draftBasename.replace(/_draft$/, "");
+  if (emailId) {
+    appendFileSync("drafts/handled", emailId + "\n");
+    console.log(`Marked as handled: ${emailId}`);
+  }
+}
+
+function main() {
+  const parsed = parseArgs(process.argv.slice(2));
+  const script = buildAppleScript(parsed);
+  const tmp = join(mkdtempSync(join(tmpdir(), "send-email-")), "mail.scpt");
+  try {
+    writeFileSync(tmp, script);
+    execFileSync("osascript", [tmp], { stdio: "inherit" });
+    console.log(`Sent: ${parsed.subject}`);
+    handleDraftCleanup(parsed.draft);
+  } finally {
+    try {
+      unlinkSync(tmp);
+    } catch {
+      /* ignore */
+    }
+  }
+}
+
+main();