@forwardimpact/basecamp 0.1.0

package/scripts/install.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+set -e
+
+# Basecamp Installer (development / repo context)
+#
+# Sets up scheduler config, default knowledge base, and LaunchAgent for local
+# development. The compiled binary is installed via the .pkg installer instead.
+#
+# This script is for engineers running from the repo with deno or node.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+APP_NAME="fit-basecamp"
+BASECAMP_HOME="$HOME/.fit/basecamp"
+DEFAULT_KB="$HOME/Documents/Personal"
+
+echo ""
+echo "Basecamp Installer (dev)"
+echo "========================"
+echo ""
+
+# ---------------------------------------------------------------------------
+# 1. Set up scheduler home
+# ---------------------------------------------------------------------------
+
+echo "Setting up scheduler home at $BASECAMP_HOME ..."
+mkdir -p "$BASECAMP_HOME/logs"
+
+# ---------------------------------------------------------------------------
+# 2. Copy scheduler config (single source of truth: config/scheduler.json)
+# ---------------------------------------------------------------------------
+
+CONFIG_SRC=""
+if [ -f "$SCRIPT_DIR/../config/scheduler.json" ]; then
+  CONFIG_SRC="$SCRIPT_DIR/../config/scheduler.json"
+fi
+
+if [ ! -f "$BASECAMP_HOME/scheduler.json" ]; then
+  if [ -n "$CONFIG_SRC" ]; then
+    cp "$CONFIG_SRC" "$BASECAMP_HOME/scheduler.json"
+    echo "  Created $BASECAMP_HOME/scheduler.json"
+  else
+    echo "  Warning: config/scheduler.json not found, skipping config setup."
+  fi
+else
+  echo "  Scheduler config already exists, skipping."
+fi
+
+# ---------------------------------------------------------------------------
+# 3. Initialize state file
+# ---------------------------------------------------------------------------
+
+if [ ! -f "$BASECAMP_HOME/state.json" ]; then
+  echo '{ "tasks": {} }' > "$BASECAMP_HOME/state.json"
+  echo "  Created $BASECAMP_HOME/state.json"
+fi
+
+# ---------------------------------------------------------------------------
+# 4. Initialize default knowledge base
+# ---------------------------------------------------------------------------
+
+echo ""
+if [ ! -d "$DEFAULT_KB" ]; then
+  echo "Initializing default knowledge base at $DEFAULT_KB ..."
+  SCHEDULER="$SCRIPT_DIR/../scheduler.js"
+  if command -v deno &>/dev/null && [ -f "$SCHEDULER" ]; then
+    deno run --allow-all "$SCHEDULER" --init "$DEFAULT_KB"
+  elif command -v node &>/dev/null && [ -f "$SCHEDULER" ]; then
+    node "$SCHEDULER" --init "$DEFAULT_KB"
+  else
+    echo "  Neither deno nor node found, skipping KB initialization."
+  fi
+else
+  echo "Basecamp already initialized at $DEFAULT_KB/"
+fi
+
+# ---------------------------------------------------------------------------
+# 5. Install LaunchAgent
+# ---------------------------------------------------------------------------
+
+echo ""
+echo "Installing background scheduler (LaunchAgent)..."
+SCHEDULER="$SCRIPT_DIR/../scheduler.js"
+if command -v deno &>/dev/null && [ -f "$SCHEDULER" ]; then
+  deno run --allow-all "$SCHEDULER" --install-launchd
+elif command -v node &>/dev/null && [ -f "$SCHEDULER" ]; then
+  node "$SCHEDULER" --install-launchd
+else
+  echo "  Neither deno nor node found, skipping LaunchAgent install."
+fi
+
+# ---------------------------------------------------------------------------
+# Summary
+# ---------------------------------------------------------------------------
+
+echo ""
+echo "Done! Basecamp is installed."
+echo ""
+echo "  Config:       $BASECAMP_HOME/scheduler.json"
+echo "  Knowledge:    $DEFAULT_KB/"
+echo "  Logs:         $BASECAMP_HOME/logs/"
+echo ""
+echo "Next steps:"
+echo "  1. Edit $DEFAULT_KB/USER.md with your name, email, and domain"
+echo "  2. Edit $BASECAMP_HOME/scheduler.json to configure tasks"
+echo "  3. Run the scheduler:    deno run --allow-all scheduler.js --status"
+echo "  4. Start the daemon:     deno run --allow-all scheduler.js --install-launchd"
+echo "  5. Open your KB:         cd $DEFAULT_KB && claude"
+echo ""

package/scripts/pkg-resources/conclusion.html

@@ -0,0 +1,62 @@
+<!doctype html>
+<html>
+  <head>
+    <style>
+      body {
+        font-family:
+          -apple-system,
+          Helvetica Neue,
+          sans-serif;
+        padding: 20px;
+        color: #1d1d1f;
+      }
+      h1 {
+        font-size: 22px;
+        font-weight: 600;
+        margin-bottom: 16px;
+      }
+      p {
+        font-size: 14px;
+        line-height: 1.6;
+        color: #424245;
+      }
+      code {
+        font-family:
+          SF Mono,
+          Menlo,
+          monospace;
+        font-size: 13px;
+        background: #f5f5f7;
+        padding: 2px 6px;
+        border-radius: 4px;
+      }
+      .cmd {
+        margin: 8px 0 8px 16px;
+      }
+      .note {
+        font-size: 12px;
+        color: #86868b;
+        margin-top: 20px;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>Basecamp is installed</h1>
+    <p>
+      The scheduler is running in the background and will start automatically on
+      login.
+    </p>
+    <p><strong>Next steps:</strong></p>
+    <p>1. Edit your identity file:</p>
+    <p class="cmd"><code>vim ~/Documents/Personal/USER.md</code></p>
+    <p>2. Configure scheduled tasks:</p>
+    <p class="cmd"><code>vim ~/.fit/basecamp/scheduler.json</code></p>
+    <p>3. Check scheduler status:</p>
+    <p class="cmd"><code>fit-basecamp --status</code></p>
+    <p>4. Open your knowledge base interactively:</p>
+    <p class="cmd"><code>cd ~/Documents/Personal &amp;&amp; claude</code></p>
+    <p class="note">
+      To uninstall, run: <code>/usr/local/share/fit-basecamp/uninstall.sh</code>
+    </p>
+  </body>
+</html>

package/scripts/pkg-resources/welcome.html

@@ -0,0 +1,64 @@
+<!doctype html>
+<html>
+  <head>
+    <style>
+      body {
+        font-family:
+          -apple-system,
+          Helvetica Neue,
+          sans-serif;
+        padding: 20px;
+        color: #1d1d1f;
+      }
+      h1 {
+        font-size: 22px;
+        font-weight: 600;
+        margin-bottom: 16px;
+      }
+      p {
+        font-size: 14px;
+        line-height: 1.6;
+        color: #424245;
+      }
+      ul {
+        font-size: 14px;
+        line-height: 1.8;
+        color: #424245;
+        padding-left: 20px;
+      }
+      .note {
+        font-size: 12px;
+        color: #86868b;
+        margin-top: 20px;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>Basecamp</h1>
+    <p>
+      Personal knowledge system with scheduled AI tasks. No server, no database.
+      just plain files, markdown, and Claude Code.
+    </p>
+    <p>This installer will:</p>
+    <ul>
+      <li>
+        Install the <code>fit-basecamp</code> binary to
+        <code>/usr/local/bin/</code>
+      </li>
+      <li>
+        Set up the scheduler configuration at <code>~/.fit/basecamp/</code>
+      </li>
+      <li>
+        Initialize a default knowledge base at
+        <code>~/Documents/Personal/</code>
+      </li>
+      <li>
+        Install a LaunchAgent so the scheduler runs automatically on login
+      </li>
+    </ul>
+    <p class="note">
+      Requires the Claude Code CLI (<code>claude</code>) to be installed and
+      authenticated.
+    </p>
+  </body>
+</html>

package/scripts/postinstall

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+# Basecamp postinstall script — runs as root after macOS pkg installation.
+#
+# Sets up per-user config, default knowledge base, and LaunchAgent for the
+# console user (the person who double-clicked the installer).
+
+REAL_USER=$(/usr/bin/stat -f "%Su" /dev/console)
+REAL_HOME=$(/usr/bin/dscl . -read "/Users/$REAL_USER" NFSHomeDirectory | /usr/bin/awk '{print $2}')
+
+BASECAMP_HOME="$REAL_HOME/.fit/basecamp"
+DEFAULT_KB="$REAL_HOME/Documents/Personal"
+SHARE_DIR="/usr/local/share/fit-basecamp"
+BINARY="/usr/local/bin/fit-basecamp"
+
+# --- Config home -------------------------------------------------------------
+
+/usr/bin/sudo -u "$REAL_USER" /bin/mkdir -p "$BASECAMP_HOME/logs"
+
+if [ ! -f "$BASECAMP_HOME/scheduler.json" ] && [ -f "$SHARE_DIR/config/scheduler.json" ]; then
+  /usr/bin/sudo -u "$REAL_USER" /bin/cp "$SHARE_DIR/config/scheduler.json" "$BASECAMP_HOME/scheduler.json"
+fi
+
+if [ ! -f "$BASECAMP_HOME/state.json" ]; then
+  echo '{ "tasks": {} }' | /usr/bin/sudo -u "$REAL_USER" /usr/bin/tee "$BASECAMP_HOME/state.json" > /dev/null
+fi
+
+# --- Default knowledge base --------------------------------------------------
+
+if [ ! -d "$DEFAULT_KB" ]; then
+  /usr/bin/sudo -u "$REAL_USER" "$BINARY" --init "$DEFAULT_KB" 2>/dev/null || true
+fi
+
+# --- LaunchAgent (runs as user, not root) ------------------------------------
+
+PLIST="$REAL_HOME/Library/LaunchAgents/com.fit-basecamp.scheduler.plist"
+if [ -f "$PLIST" ]; then
+  # Upgrade: binary already replaced by pkg payload. Kill the old daemon and
+  # let KeepAlive restart it with the new binary. No plist rewrite needed.
+  /usr/bin/killall fit-basecamp 2>/dev/null || true
+else
+  # Fresh install: create plist and load it.
+  /usr/bin/sudo -u "$REAL_USER" "$BINARY" --install-launchd 2>/dev/null || true
+fi
+
+exit 0

package/scripts/uninstall.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+set -e
+
+# Basecamp Uninstaller
+#
+# Removes the binary, LaunchAgent, and shared data installed by the .pkg.
+# User data at ~/Documents/Personal/ and config at ~/.fit/basecamp/ are preserved.
+
+APP_NAME="${1:-fit-basecamp}"
+PLIST_NAME="${2:-com.fit-basecamp.scheduler}"
+
+echo ""
+echo "Basecamp Uninstaller"
+echo "====================="
+echo ""
+
+# Remove LaunchAgent
+PLIST="$HOME/Library/LaunchAgents/$PLIST_NAME.plist"
+if [ -f "$PLIST" ]; then
+  launchctl unload "$PLIST" 2>/dev/null || true
+  rm -f "$PLIST"
+  echo "  Removed LaunchAgent"
+else
+  echo "  LaunchAgent not found, skipping."
+fi
+
+# Remove binary
+if [ -f "/usr/local/bin/$APP_NAME" ]; then
+  sudo rm -f "/usr/local/bin/$APP_NAME"
+  echo "  Removed /usr/local/bin/$APP_NAME"
+else
+  echo "  Binary not found at /usr/local/bin/$APP_NAME, skipping."
+fi
+
+# Remove shared data (default config template, this uninstall script's installed copy)
+if [ -d "/usr/local/share/fit-basecamp" ]; then
+  sudo rm -rf "/usr/local/share/fit-basecamp"
+  echo "  Removed /usr/local/share/fit-basecamp/"
+else
+  echo "  Shared data not found, skipping."
+fi
+
+# Forget pkg receipt
+pkgutil --pkgs 2>/dev/null | grep -q "com.fit-basecamp.scheduler" && {
+  sudo pkgutil --forget "com.fit-basecamp.scheduler" >/dev/null 2>&1
+  echo "  Removed installer receipt"
+} || true
+
+echo ""
+echo "Basecamp uninstalled."
+echo "Your data at ~/Documents/Personal/ has been preserved."
+echo "Your config at ~/.fit/basecamp/ has been preserved."
+echo ""
+echo "To remove all data:   rm -rf ~/Documents/Personal/"
+echo "To remove all config: rm -rf ~/.fit/basecamp/"
+echo ""

package/template/.claude/settings.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "permissions": {
+    "allow": [
+      "Read(~/Library/Mail/**)",
+      "Read(~/Library/Group Containers/group.com.apple.calendar/**)",
+      "Read(~/Library/Calendars/**)",
+      "Read(~/Desktop/**)",
+      "Read(~/Documents/**)",
+      "Read(~/Downloads/**)",
+      "Edit(~/Desktop/**)",
+      "Edit(~/Documents/**)",
+      "Edit(~/Downloads/**)",
+      "Read(~/.cache/fit/basecamp/**)",
+      "Edit(~/.cache/fit/basecamp/**)"
+    ],
+    "deny": [
+      "Edit(~/Library/**)",
+      "Read(~/Pictures/**)",
+      "Read(~/Music/**)",
+      "Read(~/Movies/**)",
+      "Read(~/Public/**)",
+      "Read(~/.ssh/**)",
+      "Read(~/.aws/**)",
+      "Read(~/.gnupg/**)",
+      "Read(~/.config/**)",
+      "Read(~/.env)",
+      "Read(~/.env.*)"
+    ],
+    "additionalDirectories": [
+      "~/Library/Mail",
+      "~/Library/Group Containers/group.com.apple.calendar",
+      "~/Library/Calendars",
+      "~/Desktop",
+      "~/Documents",
+      "~/Downloads",
+      "~/.cache/fit/basecamp"
+    ]
+  }
+}

package/template/.claude/skills/create-presentations/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: create-presentations
+description: Generate PDF slide decks from user requests using Playwright to render HTML slides to PDF. Use when the user asks to create a presentation, slide deck, or pitch 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 Presentations
+
+Generate PDF slide decks from user requests. Uses Playwright to render HTML
+slides 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 presentation, slide deck, or pitch deck.
+
+## Prerequisites
+
+- Node.js installed
+- Playwright will be installed on first use
+
+## Inputs
+
+- User's description of the presentation
+- `knowledge/` — optional context about company, product, team, projects
+
+## Outputs
+
+- `~/Desktop/presentation.pdf` — the generated PDF presentation
+
+---
+
+## Workflow
+
+1.  Check `knowledge/` for relevant context about the company, product, team,
+    etc.
+2.  Ensure Playwright is installed:
+    `npm install playwright && npx playwright install chromium`
+3.  Create an HTML file at `/tmp/basecamp-presentation.html` with slides
+    (1280x720px each)
+4.  Include the required CSS from [references/slide.css](references/slide.css)
+5.  Run the conversion script:
+
+        node scripts/convert-to-pdf.js
+
+6.  Tell the user: "Your presentation is ready at ~/Desktop/presentation.pdf"
+
+**Do NOT show HTML code to the user. Just create the PDF and deliver it.**
+
+The conversion script accepts optional arguments:
+
+    node scripts/convert-to-pdf.js [input.html] [output.pdf]
+
+Defaults: input = `/tmp/basecamp-presentation.html`, output =
+`~/Desktop/presentation.pdf`
+
+## PDF Rendering Rules
+
+**These prevent rendering issues in PDF:**
+
+1. **No layered elements** — Style content elements directly, no separate
+   background elements
+2. **No box-shadow** — Use borders instead: `border: 1px solid #e5e7eb`
+3. **Bullets via CSS only** — Use `li::before` pseudo-elements
+4. **Content must fit** — Slides are 1280x720px with 60px padding. Safe area is
+   1160x600px. Use `overflow: hidden`
+5. **No footers or headers** — No fixed/absolute positioned footer/header
+   elements
+
+## Constraints
+
+- Always use the knowledge base for context when available
+- Output to `~/Desktop/presentation.pdf` unless user specifies otherwise
+- Keep slides clean and readable — max 5-6 bullet points per slide
+- Use consistent styling throughout

package/template/.claude/skills/create-presentations/references/slide.css

@@ -0,0 +1,35 @@
+/* Required CSS for HTML slide decks rendered to PDF via Playwright.
+ *
+ * Include this in the <style> block of /tmp/basecamp-presentation.html.
+ * See scripts/convert-to-pdf.js for the rendering script.
+ *
+ * PDF rendering rules:
+ * - No layered elements — style content directly, no separate backgrounds
+ * - No box-shadow — use borders: border: 1px solid #e5e7eb
+ * - Bullets via CSS only — use li::before pseudo-elements
+ * - Content must fit — safe area is 1160x600px (1280x720 minus 60px padding)
+ * - No footers or headers — no fixed/absolute positioned elements
+ */
+
+@page {
+  size: 1280px 720px;
+  margin: 0;
+}
+
+html {
+  -webkit-print-color-adjust: exact !important;
+  print-color-adjust: exact !important;
+}
+
+.slide {
+  width: 1280px;
+  height: 720px;
+  padding: 60px;
+  overflow: hidden;
+  page-break-after: always;
+  page-break-inside: avoid;
+}
+
+.slide:last-child {
+  page-break-after: auto;
+}

package/template/.claude/skills/create-presentations/scripts/convert-to-pdf.js

@@ -0,0 +1,32 @@
+// Convert HTML slides to PDF using Playwright.
+//
+// Usage: node scripts/convert-to-pdf.js [input.html] [output.pdf]
+//
+// Defaults:
+//   input:  /tmp/basecamp-presentation.html
+//   output: ~/Desktop/presentation.pdf
+//
+// Requires: npm install playwright && npx playwright install chromium
+
+const { chromium } = require("playwright");
+const path = require("path");
+
+const input = process.argv[2] || "/tmp/basecamp-presentation.html";
+const output =
+  process.argv[3] || path.join(process.env.HOME, "Desktop", "presentation.pdf");
+
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.goto(`file://${path.resolve(input)}`, {
+    waitUntil: "networkidle",
+  });
+  await page.pdf({
+    path: output,
+    width: "1280px",
+    height: "720px",
+    printBackground: true,
+  });
+  await browser.close();
+  console.log(`Done: ${output}`);
+})();

package/template/.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