life-pulse 1.0.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Molly Cantillon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# life-pulse
+
+macOS life diagnostic — reads local data sources, generates actionable insights.
+
+Built with [Anthropic's long-running agent patterns](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents) for persistent context across sessions.
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g life-pulse
+
+# Or run directly
+npx life-pulse
+
+# First run: set up permissions
+life-pulse --setup
+```
+
+## Features
+
+### 🧠 Session Continuity (Anthropic Pattern)
+Each session picks up where the last left off:
+- Tracks what was surfaced (avoids re-showing items)
+- Remembers user decisions (learns from your choices)
+- Maintains pending follow-ups across sessions
+- Builds decision pattern profile over time
+
+Progress is stored in `~/.life-pulse/session-progress.json`.
+
+### 📱 iCloud Discovery
+Scans your iCloud Drive to discover apps and recommend integrations:
+- Obsidian vaults
+- Bear notes
+- Things 3 tasks
+- Day One journal
+- And more...
+
+"Here's what I found about you" — personalized setup.
+
+### ⚡ Incremental Processing
+Delta-based scanning — only processes what's changed:
+- Tracks file modification times
+- Remembers last scanned message ID
+- Skips sources that haven't changed
+- Faster subsequent runs
+
+### 🔐 Permission Flow
+Guided setup for macOS permissions:
+- Full Disk Access (required)
+- Contacts (for name resolution)
+- Automation (for calendar/reminders)
+- Accessibility (optional)
+
+Direct links to System Settings privacy panels.
+
+### 👁 Health Monitoring
+Long-running daemon mode with health checks:
+
+```bash
+# Start as daemon
+life-pulse --daemon
+
+# Check status
+life-pulse --health
+
+# Or via HTTP
+curl http://127.0.0.1:19876/health
+```
+
+## Commands
+
+```bash
+life-pulse              # Run interactive session
+life-pulse --setup      # Run first-time setup flow
+life-pulse --status     # Show session progress info
+life-pulse --daemon     # Run as background daemon
+life-pulse --health     # Check daemon health (JSON)
+life-pulse --raw        # Output raw collected data
+life-pulse --json       # Output analysis as JSON
+life-pulse --legacy     # Use single-shot LLM mode
+life-pulse --install    # Install launchd plist for morning briefs
+```
+
+## Environment Variables
+
+```bash
+# Required: Anthropic API key
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Optional: OpenRouter for legacy mode
+export OPENROUTER_API_KEY="..."
+```
+
+Store in `~/.config/life-pulse/.env` for persistence.
+
+## Data Sources
+
+life-pulse reads from local macOS databases (requires Full Disk Access):
+
+- **Messages** — iMessage/SMS conversations
+- **Email** — Apple Mail summaries
+- **Calendar** — Upcoming events
+- **Contacts** — Name resolution for phone numbers
+- **Safari/Chrome** — Browsing history
+- **Screen Time** — App usage patterns
+- **Notes** — Apple Notes
+- **Reminders** — Apple Reminders
+- **Notifications** — Recent alerts
+- **Find My** — Device locations
+- **Recent Files** — Recently opened documents
+- **Shell History** — Terminal commands
+
+All data stays local. Nothing leaves your machine except API calls to Claude.
+
+## Architecture
+
+```
+~/.life-pulse/
+├── session-progress.json  # Cross-session state (Anthropic pattern)
+├── daemon.pid             # PID file for daemon mode
+└── heartbeat              # Last activity timestamp
+
+~/Library/Application Support/life-pulse/
+├── state.json             # Analysis history
+├── config.json            # User preferences
+├── platforms.json         # Discovered apps/services
+└── todos.json             # Task tracking
+```
+
+## Design Principles
+
+1. **Session Continuity** — Like claude-progress.txt, each run knows what happened before
+2. **Incremental Processing** — Don't rescan what hasn't changed
+3. **Graceful Degradation** — Works with partial permissions
+4. **Local First** — All data stays on your machine
+5. **User Control** — Every surfaced item gets a decision
+
+## Development
+
+```bash
+git clone https://github.com/your-org/life-pulse
+cd life-pulse
+npm install
+npm run dev           # Run with tsx (hot reload)
+npm run build         # Compile TypeScript
+npm run start         # Run compiled version
+```
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -1,11 +1,14 @@
 /**
- * Agentic analysis with Claude Opus orchestrator + sub-agent workers.
+ * Executive Operating System — Claude Agent SDK.
  *
  * Architecture:
- *   Opus orchestrator → scans data → generates hypotheses → spawns workers
- *   Workers (Haiku) → validate specific predictions using tools → report back
- *   Opus → synthesizes validated findings into final analysis
+ *   - Orchestrator (Opus) via SDK query() with built-in tool execution
+ *   - Custom tools via in-process MCP server (life-pulse tools + ask_user)
+ *   - Remote MCP servers auto-discovered from platforms (Slack, Stripe, etc.)
+ *   - Workers dispatched as SDK subagents via Task tool
+ *   - Workers get full Claude Code capabilities (Read, Bash, WebSearch, etc.)
  */
 import type { Analysis } from './analyze.js';
 import type { ProgressSink } from './progress.js';
-export declare function runAgent(apiKey: string, progress?: ProgressSink, onCard?: (card: any) => Promise<string>): Promise<Analysis>;
+export declare function runAgent(_apiKey: string, // SDK reads ANTHROPIC_API_KEY from env
+progress?: ProgressSink, onCard?: (card: any) => Promise<string>): Promise<Analysis>;