mcp-task-server 2.0.0 → 3.0.0

package/README.md

@@ -55,7 +55,7 @@ Invoke any tool with `call <tool_name>`:
 
 | Command | Description |
 |---------|-------------|
-| `call help` | List all 27 available tools |
+| `call help` | List all 33 available tools |
 | `call list_tasks` | Show all tasks |
 | `call next_task` | Get recommended next task |
 | `call diagnose` | Check server configuration |
@@ -73,35 +73,44 @@ flowchart TB
     end
     
     subgraph MCP Task Server
-        B[27 Tools]
+        B[33 Tools]
         C[Preferences Engine]
+        P[Project Context]
     end
     
     subgraph Your Machine
         D[~/.cursor/shared-context.json]
         E[memory_bank/tasks/]
-        F[memory_bank/execution/progress.md]
+        F[memory_bank/execution/progress*.md]
+        G[~/.cursor/content-context.md]
     end
     
     A <-->|MCP Protocol| B
     B --> C
+    B --> P
     C -->|read/write| D
+    P -->|filter tasks| E
     B -->|read/write| E
     B -->|auto-sync| F
+    B -->|read/write| G
     D -->|inject into responses| A
 ```
 
 ## Features
 
-- **27 MCP Tools**: Comprehensive task management and coordination
+- **33 MCP Tools**: Comprehensive task management and coordination
+- **Multi-Project Support**: Manage tasks across multiple projects from one workspace with automatic filtering
 - **Auto Workspace Detection**: Works globally without per-project config
 - **Multi-Agent Coordination**: Support for Planner, Worker, and Judge roles
 - **Dependency Tracking**: Tasks can depend on other tasks
 - **Priority Levels**: Critical, High, Medium, Low
-- **Scalable Storage**: Individual task files with JSON registry and markdown summary
+- **Scalable Storage**: Individual task files with JSON registry and per-project markdown summaries
 - **Prompt-Based Operations**: PRD parsing, task expansion, complexity analysis
 - **Shared Context**: Reads user preferences from `~/.cursor/shared-context.json` to personalise prompts
-- **Project Initialisation**: Scaffolds 22 template files across agent-kit, memory_bank (architecture, context, execution, reference), and cursor rules
+- **Content Context**: Global content inventory at `~/.cursor/content-context.md` for content creators
+- **Project Initialisation**: Scaffolds 27 template files across agent-kit, memory_bank, and cursor rules
+- **Wellness Tracking**: Break reminder system via cursor rules, using session tracking in shared memory
+- **Work Stats Integration**: Fetch activity data from stats dashboard for work/break recommendations
 
 ## Quick Start
 
@@ -118,6 +127,32 @@ call add_task({ title: "Set up development environment" })
 call next_task
 ```
 
+## Multi-Project Workflow
+
+Manage tasks across multiple projects from a single workspace:
+
+```bash
+# Set project context
+call set_project({ project: "coach-platform" })
+
+# All task operations now filter by project
+call list_tasks  # Only shows coach-platform tasks
+call add_task({ title: "Add auth" })  # Creates in coach-platform
+
+# Switch to another project
+call set_project({ project: "obsidian-data-hub" })
+call list_tasks  # Only shows obsidian-data-hub tasks
+```
+
+Progress files are generated per-project:
+
+```
+memory_bank/execution/
+├── progress.md                    # Combined view (all projects)
+├── progress-coach-platform.md     # Coach platform tasks only
+└── progress-obsidian-data-hub.md  # Obsidian data hub tasks only
+```
+
 ## Shared Context & Preferences
 
 The server reads `~/.cursor/shared-context.json` for user preferences and automatically injects them into tool responses and prompts.
@@ -138,10 +173,13 @@ flowchart LR
 Before creating or reviewing content, agents should:
 
 1. Call `show_memory` to check for user preferences
-2. Look for `writing_preferences` category
+2. Look for recognised memory categories (see below)
 3. Apply discovered preferences to all content
 
-This is enforced by the Cursor rules in `.cursor/rules/agent-workflow.mdc` and `.cursor/rules/writing-review.mdc`.
+This is enforced by the Cursor rules created by `init_project`:
+- `.cursor/rules/agent-workflow.mdc` - Task management protocol
+- `.cursor/rules/wellness-check.mdc` - Break reminders based on time/duration
+- `.cursor/rules/shared-context-sync.mdc` - Memory sync guidance
 
 ### Memory Storage Architecture
 
@@ -165,33 +203,49 @@ flowchart TB
     D --> E --> F
 ```
 
-### Syncing Cursor Memories
+### Managing Memories
 
-The `sync` action transfers memories from Cursor to shared context, preserving IDs:
+Memories use simple sequential IDs (1, 2, 3...) managed by the server:
 
-```mermaid
-flowchart TD
-    A["Agent sees Cursor memory (ID: 13502615)"] --> B["update_memory(action: sync, id: 13502615)"]
-    B --> C{ID or title exists?}
-    C -->|Yes| D[Update existing memory]
-    C -->|No| E[Create with Cursor ID]
-    D --> F[Save to shared-context.json]
-    E --> F
-```
+| Action | What it does |
+|--------|--------------|
+| `create` | Add new memory with next available ID |
+| `update` | Update existing memory by ID |
+| `delete` | Remove memory by ID |
+| `sync` | Create or update by title match (recommended) |
+| `migrate` | One-time conversion of old IDs to sequential |
+
+### Recognised Memory Titles
 
-Always include the Cursor memory ID to keep IDs consistent:
+| Title (case-insensitive) | Purpose |
+|--------------------------|---------|
+| `identity` or `values` | User context for prompts |
+| `writing preferences` | Formatting, style, avoided words |
+| `workflow` or `memory bank` | Task management preferences |
+| `wellness preferences` | Break reminder settings and thresholds |
+| `current_project` | Active project for multi-project filtering |
+
+The `sync` action is recommended because it matches by title, avoiding duplicates:
 
 ```bash
-# Sync with Cursor ID (recommended)
 call update_memory({ 
   action: "sync",
-  id: "13502615",                    # Cursor's memory ID
   title: "Writing preferences", 
-  content: "British English, ISO dates, no emojis..." 
+  content: "British English, no emojis..." 
 })
-# Returns: { status: "synced_existing", memory: { id: "13502615", ... } }
+# Returns: { status: "synced_new", memory: { id: "1", ... } }
+```
+
+**Migrating from old IDs:** If you have memories with old-style IDs (like `mem_1737900000_abc123` or Cursor IDs), run migrate once:
+
+```bash
+call update_memory({ action: "migrate" })
+# Returns: { status: "migrated", changes: [{ old_id: "mem_...", new_id: "1", title: "..." }] }
+# Or: { status: "already_migrated" } if already sequential
 ```
 
+> **Why not Cursor IDs?** Cursor's memory system is unreliable - agents cannot always create memories, and when they can, the ID is not always accessible. Sequential IDs managed by the server are simpler and more reliable.
+
 ### Why Shared Context Exists
 
 Cursor's memory system has limitations that make shared context necessary:
@@ -225,14 +279,12 @@ flowchart TB
 |-------------------------|--------|----------|
 | No API access | MCP tools can't read Cursor's memory database | `~/.cursor/shared-context.json` as shared store |
 | Isolated per conversation | Memories don't persist across all contexts | Shared file accessible to all MCP servers |
-| No programmatic sync | Can't auto-export memories | `update_memory` sync action with Cursor ID |
-| Different ID systems | Cursor IDs vs generated IDs cause duplicates | Pass Cursor ID to sync to preserve consistency |
+| Unreliable memory creation | Agents cannot always create Cursor memories | Server-managed sequential IDs |
 
 **Workflow:**
-1. Cursor creates a memory (you see it in chat with ID like `13502615`)
-2. Ask agent to sync it: `update_memory({ action: "sync", id: "13502615", title: "...", content: "..." })`
-3. Memory saved to `~/.cursor/shared-context.json` with same ID
-4. All MCP servers can now read it
+1. Ask the agent to sync your preferences: `update_memory({ action: "sync", title: "Writing preferences", content: "..." })`
+2. Memory saved to `~/.cursor/shared-context.json` with sequential ID
+3. All MCP servers can now read it via `show_memory`
 
 ### Where Preferences Are Used
 
@@ -241,6 +293,7 @@ flowchart TB
 | `list_tasks`, `get_task`, `add_task`, `update_task`, `next_task` | Brief hint in response |
 | `parse_prd`, `expand_task`, `research_task` | Full context in generated prompt |
 | `check_compliance` | All preferences for validation |
+| Wellness cursor rule | Session tracking and break reminders |
 
 ### Compliance Checking
 
@@ -411,7 +464,7 @@ grep -r "warning\|error" ~/Library/Application\ Support/Cursor/logs/*/window*/ex
 
 Key log messages:
 - `No workspace folders found` → Empty workspace issue
-- `Found 27 tools` → Server connected successfully
+- `Found 33 tools` → Server connected successfully
 - `Workspace: /path` → Shows detected workspace
 
 ## Configuration
@@ -423,6 +476,7 @@ Configure via environment variables:
 | `TASK_MD_PATH` | `memory_bank/execution/progress.md` | Path to markdown summary |
 | `TASK_JSON_PATH` | `memory_bank/tasks/tasks.json` | Path to JSON registry |
 | `TASK_DIR` | `memory_bank/tasks` | Directory for task files |
+| `STATS_API_URL` | `https://stats-dev.reids.net.au` | Work stats dashboard API URL |
 
 ## Storage Architecture
 
@@ -469,9 +523,14 @@ Full implementation details here...
 ### Description: Create initial project structure
 ```
 
-### 3. Progress Summary (`memory_bank/execution/progress.md`)
+### 3. Progress Summary
+
+The server generates progress summaries automatically:
+
+- `memory_bank/execution/progress.md` - Combined view of all projects
+- `memory_bank/execution/progress-{project}.md` - Per-project progress files
 
-High-level overview auto-generated from tasks.json:
+**Combined Progress** (shows all projects):
 
 ```markdown
 # Implementation Progress
@@ -545,6 +604,104 @@ call init_project({ force: true })
 | `check_compliance` | Check file/folder against user preferences from shared context | ✓ full |
 | `analyse_project` | Analyse project structure and suggest memory_bank updates | ✓ full |
 
+### Project Context Tools
+
+| Tool | Description |
+|------|-------------|
+| `set_project` | Set current project context for session |
+| `get_project` | Get current project and list all known projects |
+| `tag_all_tasks` | Bulk tag tasks with a project name (for migration) |
+
+```bash
+# Set project context for the session
+call set_project({ project: "coach-platform" })
+# Returns: { project: "coach-platform", is_new_project: false, known_projects: [...] }
+
+# Check current project and see all projects
+call get_project
+# Returns: { current_project: "coach-platform", known_projects: [...], project_stats: {...} }
+
+# Bulk tag all unassigned tasks with a project
+call tag_all_tasks({ project: "coach-platform" })
+# Returns: { tagged: 100, skipped: 0, message: "Tagged 100 tasks..." }
+
+# Overwrite existing project assignments
+call tag_all_tasks({ project: "new-project", overwrite: true })
+```
+
+All task operations (`list_tasks`, `add_task`, `next_task`) automatically filter by the current project context.
+
+### Content Context Tools
+
+| Tool | Description |
+|------|-------------|
+| `show_content_context` | Read global content context file |
+| `update_content_context` | Update a section of the content context |
+
+```bash
+# Read content context
+call show_content_context
+# Returns: { exists: true, path: "~/.cursor/content-context.md", content: "..." }
+
+# Update a section
+call update_content_context({ section: "Published Content", content: "- Post 1\n- Post 2" })
+```
+
+The content context file (`~/.cursor/content-context.md`) stores content inventory, themes, and locations for content creators.
+
+### Work Stats Tools
+
+| Tool | Description |
+|------|-------------|
+| `stats` | Fetch work activity statistics from stats dashboard |
+
+```bash
+# Quick check - today's hours and recommendation
+call stats
+# Returns: { today: { hours: 3.5 }, recommendation: { status: "continue", message: "..." } }
+
+# Detailed with costs and billing period
+call stats({ detailed: true })
+# Returns: Full stats including costs, period, and totals
+```
+
+Returns data from your stats dashboard (`STATS_API_URL` env var, defaults to `stats-dev.reids.net.au`):
+
+| Field | Description |
+|-------|-------------|
+| `today` | Hours, commits, pipelines for today |
+| `thisWeek` | Weekly totals |
+| `streak` | Current and longest streak |
+| `recommendation` | continue/pause/stop with message |
+| `costs` (detailed) | Usage and subscription costs |
+| `period` (detailed) | Billing cycle start/end dates |
+| `totals` (detailed) | Active days, estimated hours, projects |
+
+**File Format:**
+
+```markdown
+# Content Context
+
+## Current State
+| Property | Value |
+|----------|-------|
+| Last update | 2026-02-01 |
+
+## Published Content
+- Post 1: Title (2026-01-15)
+- Post 2: Title (2026-01-20)
+
+## Themes Covered
+- Theme A
+- Theme B
+
+## Content Locations
+| Type | Location |
+|------|----------|
+| Draft posts | ~/drafts |
+| Published | ~/published |
+```
+
 ### Utility Tools
 
 | Tool | Description |
@@ -553,12 +710,12 @@ call init_project({ force: true })
 | `get_version` | Get server version and workspace detection info |
 | `diagnose` | Diagnose MCP configuration, paths, and workspace detection |
 | `show_memory` | Show shared context memories from `~/.cursor/shared-context.json` |
-| `update_memory` | Create, update, sync, or delete memories (sync preserves Cursor IDs) |
+| `update_memory` | Create, update, sync, or delete memories (sync matches by title) |
 
 ```bash
 # List all tools
 call help
-# Returns: { server, version, usage, tool_count: 27, tools: [...] }
+# Returns: { server, version, usage, tool_count: 33, tools: [...] }
 
 # Get help for specific tool
 call help({ tool: "update_memory" })
@@ -581,15 +738,14 @@ call show_memory({ search: "writing" })
 # Force reload from file (clears cache)
 call show_memory({ reload: true })
 
-# Sync a Cursor memory (preserves Cursor ID)
+# Sync a memory by title (recommended - avoids duplicates)
 call update_memory({ 
   action: "sync",
-  id: "13502615",             # Cursor's memory ID
   title: "Writing preferences", 
   content: "British English, ISO dates, no emojis..." 
 })
 
-# Create a new memory (generates ID)
+# Create a new memory (generates sequential ID)
 call update_memory({ 
   action: "create", 
   title: "Project conventions", 
@@ -599,13 +755,16 @@ call update_memory({
 # Update an existing memory by ID
 call update_memory({ 
   action: "update", 
-  id: "13502615", 
+  id: "1", 
   title: "Writing preferences", 
   content: "Updated content..." 
 })
 
 # Delete a memory
-call update_memory({ action: "delete", id: "13502615" })
+call update_memory({ action: "delete", id: "1" })
+
+# Migrate old IDs to sequential (one-time)
+call update_memory({ action: "migrate" })
 
 # Analyse project and get suggestions for memory_bank
 call analyse_project
@@ -667,6 +826,7 @@ After running `init_project`:
 your-project/
 ├── agent-kit/
 │   ├── AGENT_RULES.md      # Role definitions and permissions
+│   ├── KICKOFF.md          # Session startup checklist
 │   ├── TASKS.md            # Task reference (points to memory_bank)
 │   ├── HANDOFF.md          # Handoff protocol reference
 │   └── SHARED_CONTEXT.md   # Shared context documentation
@@ -701,10 +861,12 @@ your-project/
 │       └── ...
 └── .cursor/
     └── rules/
-        └── agent-workflow.mdc  # Cursor agent rules
+        ├── agent-workflow.mdc      # Task management protocol
+        ├── wellness-check.mdc      # Break reminders
+        └── shared-context-sync.mdc # Memory sync guidance
 ```
 
-The full structure includes 22 template files covering architecture, context, and execution tracking.
+The full structure includes 27 template files covering architecture, context, execution tracking, and cursor rules.
 
 ## Migration from v1.x
 
@@ -789,6 +951,29 @@ npm run dev
 npm pack  # Creates .tgz file for inspection
 ```
 
+### Testing Local Changes
+
+To test changes without publishing, create a per-project MCP config that points to your local build:
+
+```json
+// .cursor/mcp.json (in this project)
+{
+  "mcpServers": {
+    "task-server": {
+      "command": "node",
+      "args": ["/Users/andy/Projects/tools/mcp-task-server/dist/index.js"]
+    }
+  }
+}
+```
+
+This overrides the global config only for this workspace. Other projects continue using the npm version.
+
+After making changes:
+1. Run `npm run build`
+2. Reload Cursor (`Cmd+Shift+P` → "Developer: Reload Window")
+3. Test with `call help` to verify tools are available
+
 ## License
 
 MIT

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 import { Config } from "./types.js";
+export declare const STATS_API_URL: string;
 export interface WorkspaceDetection {
     root: string;
     source: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CA8BxD;AAKD;;GAEG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CAKjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAmBlC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGpC,eAAO,MAAM,aAAa,QAAgE,CAAC;AAE3F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CA8BxD;AAKD;;GAEG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CAKjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAmBlC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE"}

package/dist/config.js

@@ -1,5 +1,7 @@
 import { existsSync } from "fs";
 import { dirname, join } from "path";
+// Stats Dashboard API URL
+export const STATS_API_URL = process.env.STATS_API_URL || "https://stats-dev.reids.net.au";
 /**
  * Detect the workspace root using multiple strategies
  *

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGrC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,gCAAgC,CAAC;AAO3F;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,uBAAuB;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC5E,CAAC;IAED,kEAAkE;IAClE,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACxD,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC;IAEjB,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;gBAClC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC;YAClD,CAAC;QACH,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,cAAc;IACd,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;AACnE,CAAC;AAED,uCAAuC;AACvC,IAAI,eAAe,GAA8B,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,mBAAmB,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,6CAA6C;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,qCAAqC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,uCAAuC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,WAAW,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,KAAK,CAAC,6CAA6C,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,WAAW,EAAE,CAAC,CAAC;QAChH,OAAO,CAAC,KAAK,CAAC,oCAAoC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACL,YAAY,EACV,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,mCAAmC;QACjE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,8BAA8B;QACtE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,mBAAmB;QACrD,aAAa,EAAE,SAAS,CAAC,IAAI;KAC9B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,YAAoB;IAC9D,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,aAAa,IAAI,YAAY,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAc;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,WAAW,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,SAAS,QAAQ,MAAM,CAAC,CAAC;AACxE,CAAC"}

package/dist/context.d.ts

@@ -31,6 +31,10 @@ export declare function getUserIdentity(): string | null;
  * Get workflow preferences from shared context
  */
 export declare function getWorkflowPreferences(): string | null;
+/**
+ * Get wellness preferences from shared context
+ */
+export declare function getWellnessPreferences(): string | null;
 /**
  * Clear the cached context (useful for testing or reloading)
  */
@@ -45,13 +49,12 @@ export declare function saveSharedContext(context: SharedContext): void;
 export declare function upsertMemory(memory: CursorMemory): SharedContext;
 /**
  * Add or update a memory by title (case-insensitive match)
- * If a memory with the same title exists, updates it. Otherwise creates new.
+ * If a memory with the same title exists, updates it. Otherwise creates new with sequential ID.
  *
  * @param title - Memory title
  * @param content - Memory content
- * @param cursorId - Optional Cursor memory ID to use (preserves original ID from Cursor)
  */
-export declare function upsertMemoryByTitle(title: string, content: string, cursorId?: string): {
+export declare function upsertMemoryByTitle(title: string, content: string): {
     memory: CursorMemory;
     wasUpdated: boolean;
 };
@@ -63,7 +66,25 @@ export declare function deleteMemory(id: string): {
     context: SharedContext | null;
 };
 /**
- * Generate a unique ID for a new memory
+ * Generate a sequential ID for a new memory
  */
 export declare function generateMemoryId(): string;
+/**
+ * Check if memories are already using sequential IDs (1, 2, 3...)
+ */
+export declare function isAlreadyMigrated(): boolean;
+/**
+ * Migrate all memories to sequential IDs (1, 2, 3...)
+ * Returns mapping of old IDs to new IDs
+ */
+export declare function migrateMemories(): {
+    migrated: boolean;
+    alreadyMigrated: boolean;
+    changes: Array<{
+        old_id: string;
+        new_id: string;
+        title: string;
+    }>;
+    total: number;
+};
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAgBxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAOvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAW9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAiBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAoC/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAgB5F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,YAAY,EAAE,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAgBxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAOvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAW9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAqB/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAgB5F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAWzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAe3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,KAAK,EAAE,MAAM,CAAC;CACf,CA4BA"}

package/dist/context.js

@@ -61,6 +61,13 @@ export function getWorkflowPreferences() {
     const memory = getMemoryByTitle("workflow") || getMemoryByTitle("memory bank");
     return memory?.content || null;
 }
+/**
+ * Get wellness preferences from shared context
+ */
+export function getWellnessPreferences() {
+    const memory = getMemoryByTitle("wellness preferences");
+    return memory?.content || null;
+}
 /**
  * Clear the cached context (useful for testing or reloading)
  */
@@ -100,39 +107,24 @@ export function upsertMemory(memory) {
 }
 /**
  * Add or update a memory by title (case-insensitive match)
- * If a memory with the same title exists, updates it. Otherwise creates new.
+ * If a memory with the same title exists, updates it. Otherwise creates new with sequential ID.
  *
  * @param title - Memory title
  * @param content - Memory content
- * @param cursorId - Optional Cursor memory ID to use (preserves original ID from Cursor)
  */
-export function upsertMemoryByTitle(title, content, cursorId) {
+export function upsertMemoryByTitle(title, content) {
     let ctx = loadSharedContext() || { cursor_memories: [] };
-    // First check if we have a memory with this exact Cursor ID
-    if (cursorId) {
-        const existingByIdIndex = ctx.cursor_memories.findIndex((m) => m.id === cursorId);
-        if (existingByIdIndex >= 0) {
-            // Update existing by ID - also update title in case it changed
-            ctx.cursor_memories[existingByIdIndex].content = content;
-            ctx.cursor_memories[existingByIdIndex].title = title;
-            saveSharedContext(ctx);
-            return { memory: ctx.cursor_memories[existingByIdIndex], wasUpdated: true };
-        }
-    }
-    // Fall back to case-insensitive title match
-    const existingByTitleIndex = ctx.cursor_memories.findIndex((m) => m.title.toLowerCase() === title.toLowerCase());
-    if (existingByTitleIndex >= 0) {
-        // Update existing - use provided cursorId if available, otherwise keep existing ID
-        if (cursorId) {
-            ctx.cursor_memories[existingByTitleIndex].id = cursorId;
-        }
-        ctx.cursor_memories[existingByTitleIndex].content = content;
-        ctx.cursor_memories[existingByTitleIndex].title = title;
+    // Case-insensitive title match
+    const existingIndex = ctx.cursor_memories.findIndex((m) => m.title.toLowerCase() === title.toLowerCase());
+    if (existingIndex >= 0) {
+        // Update existing - keep ID, update content and title
+        ctx.cursor_memories[existingIndex].content = content;
+        ctx.cursor_memories[existingIndex].title = title;
         saveSharedContext(ctx);
-        return { memory: ctx.cursor_memories[existingByTitleIndex], wasUpdated: true };
+        return { memory: ctx.cursor_memories[existingIndex], wasUpdated: true };
     }
-    // Create new - use cursorId if provided, otherwise generate
-    const memory = { id: cursorId || generateMemoryId(), title, content };
+    // Create new with sequential ID
+    const memory = { id: generateMemoryId(), title, content };
     ctx.cursor_memories.push(memory);
     saveSharedContext(ctx);
     return { memory, wasUpdated: false };
@@ -154,9 +146,65 @@ export function deleteMemory(id) {
     return { deleted: false, context: ctx };
 }
 /**
- * Generate a unique ID for a new memory
+ * Generate a sequential ID for a new memory
  */
 export function generateMemoryId() {
-    return `mem_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+    const ctx = loadSharedContext();
+    if (!ctx?.cursor_memories?.length)
+        return "1";
+    // Find highest numeric ID
+    const maxId = ctx.cursor_memories.reduce((max, m) => {
+        const num = parseInt(m.id, 10);
+        return !isNaN(num) && num > max ? num : max;
+    }, 0);
+    return String(maxId + 1);
+}
+/**
+ * Check if memories are already using sequential IDs (1, 2, 3...)
+ */
+export function isAlreadyMigrated() {
+    const ctx = loadSharedContext();
+    if (!ctx?.cursor_memories?.length)
+        return true; // No memories = nothing to migrate
+    const ids = ctx.cursor_memories.map((m) => m.id).sort((a, b) => {
+        const numA = parseInt(a, 10);
+        const numB = parseInt(b, 10);
+        return numA - numB;
+    });
+    // Check if IDs are sequential starting from 1
+    for (let i = 0; i < ids.length; i++) {
+        if (ids[i] !== String(i + 1))
+            return false;
+    }
+    return true;
+}
+/**
+ * Migrate all memories to sequential IDs (1, 2, 3...)
+ * Returns mapping of old IDs to new IDs
+ */
+export function migrateMemories() {
+    if (isAlreadyMigrated()) {
+        const ctx = loadSharedContext();
+        return {
+            migrated: false,
+            alreadyMigrated: true,
+            changes: [],
+            total: ctx?.cursor_memories?.length || 0
+        };
+    }
+    const ctx = loadSharedContext();
+    if (!ctx?.cursor_memories?.length) {
+        return { migrated: false, alreadyMigrated: true, changes: [], total: 0 };
+    }
+    const changes = [];
+    ctx.cursor_memories.forEach((memory, index) => {
+        const newId = String(index + 1);
+        if (memory.id !== newId) {
+            changes.push({ old_id: memory.id, new_id: newId, title: memory.title });
+            memory.id = newId;
+        }
+    });
+    saveSharedContext(ctx);
+    return { migrated: true, alreadyMigrated: false, changes, total: ctx.cursor_memories.length };
 }
 //# sourceMappingURL=context.js.map