mcp-task-server 0.1.0

package/README.md

@@ -0,0 +1,317 @@
+# MCP Task Server
+
+A Model Context Protocol (MCP) server for task management with multi-agent coordination. Designed for use with Cursor IDE and other MCP-compatible AI tools.
+
+## Features
+
+- **Task Management**: Create, update, complete, and track tasks
+- **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
+- **Prompt-Based Operations**: PRD parsing, task expansion, complexity analysis
+- **Shared Context**: Reads user preferences from `~/.cursor/shared-context.json` to personalise prompts
+- **Project Initialization**: Scaffolds agent-kit, memory_bank, and cursor rules
+
+## Quick Start
+
+```bash
+# Add to a new project and initialize
+init_project({ project_name: "my-app" })
+
+# Add your first task
+add_task({ title: "Set up development environment" })
+
+# Get recommended next task
+next_task()
+```
+
+## Shared Context
+
+The server reads `~/.cursor/shared-context.json` for user preferences (writing style, identity, workflow) and includes them in generated prompts. This bridges the gap between Cursor's memory system and isolated MCP servers.
+
+### Compliance Checking
+
+Validate files against your preferences:
+
+```typescript
+// Review only
+check_compliance({ path: "README.md" })
+
+// Review a folder
+check_compliance({ path: "docs/" })
+
+// Review and fix issues
+check_compliance({ path: "README.md", fix: true })
+```
+
+See [agent-kit/SHARED_CONTEXT.md](agent-kit/SHARED_CONTEXT.md) for full setup and usage.
+
+## Installation
+
+### Via npx (recommended)
+
+```bash
+npx mcp-task-server
+```
+
+### Global Install
+
+```bash
+npm install -g mcp-task-server
+mcp-task-server
+```
+
+### From Source
+
+```bash
+git clone https://github.com/yourusername/mcp-task-server.git
+cd mcp-task-server
+npm install
+npm run build
+npm start
+```
+
+## Cursor IDE Integration
+
+Add to your `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "task-server": {
+      "command": "npx",
+      "args": ["-y", "mcp-task-server"],
+      "cwd": "/path/to/your/project"
+    }
+  }
+}
+```
+
+The `cwd` parameter sets the workspace root where task files will be stored.
+
+## Configuration
+
+Configure via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `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 |
+
+## Storage Architecture
+
+The server uses a scalable storage model with three layers:
+
+### 1. JSON Registry (`memory_bank/tasks/tasks.json`)
+
+Machine-readable source of truth containing task IDs, status, dependencies, and subtasks.
+
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "id": "1",
+      "title": "Project Setup",
+      "status": "done",
+      "priority": "high",
+      "subtasks": [
+        { "id": 1, "title": "Init project", "status": "done" }
+      ]
+    }
+  ]
+}
+```
+
+### 2. Task Files (`memory_bank/tasks/task_XXX.txt`)
+
+Human-readable detailed task files for each top-level task:
+
+```
+# Task ID: 1
+# Title: Project Setup and Configuration
+# Status: done
+# Dependencies: None
+# Priority: high
+# Description: Initialize the project with required tooling.
+# Details:
+Full implementation details here...
+
+# Subtasks:
+## 1. Init project [done]
+### Dependencies: None
+### Description: Create initial project structure
+```
+
+### 3. Progress Summary (`memory_bank/execution/progress.md`)
+
+High-level overview auto-generated from tasks.json:
+
+```markdown
+# Implementation Progress
+
+## Task Completion Summary
+
+### Completed Tasks (3/5)
+- ✅ Task 1: Project Setup
+- ✅ Task 2: Database Schema
+```
+
+This architecture scales well for complex projects with many tasks and subtasks.
+
+## Tools
+
+### Project Initialization
+
+| Tool | Description |
+|------|-------------|
+| `init_project` | Initialize project with agent-kit, memory_bank, and cursor rules |
+
+```typescript
+// Initialize with auto-detected project name
+init_project()
+
+// Initialize with custom name
+init_project({ project_name: "my-app" })
+
+// Force overwrite existing files
+init_project({ force: true })
+```
+
+### Core Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_tasks` | List all tasks, optionally filtered by status or assignee |
+| `get_task` | Get a specific task by ID with subtasks |
+| `add_task` | Create a new task |
+| `update_task` | Update task title, description, status, priority, or metadata |
+| `complete_task` | Mark a task as completed |
+| `next_task` | Get the next recommended task based on priority/dependencies |
+
+### Multi-Agent Coordination
+
+| Tool | Description |
+|------|-------------|
+| `claim_task` | Claim a task for the calling agent |
+| `release_task` | Release a claimed task |
+| `handoff_task` | Transfer task to another role |
+| `review_task` | Review a task (Judge role) |
+| `approve_task` | Approve completed task (Judge role) |
+| `reject_task` | Reject with feedback (Judge role) |
+
+### Task Breakdown
+
+| Tool | Description |
+|------|-------------|
+| `expand_task` | Get prompt to break task into subtasks |
+| `add_subtask` | Add a subtask to existing task |
+| `set_dependencies` | Set task dependencies |
+| `remove_task` | Remove a task |
+
+### Prompt-Based Tools
+
+| Tool | Description |
+|------|-------------|
+| `parse_prd` | Get prompt to parse PRD into tasks |
+| `research_task` | Get prompt to research a task |
+| `analyze_complexity` | Get prompt to analyze task complexity |
+| `check_compliance` | Check file/folder against user preferences from shared context |
+
+## Multi-Agent Mode
+
+The server supports three agent roles:
+
+### Planner
+- Creates and organizes tasks
+- Sets dependencies and priorities
+- Analyzes complexity
+- Cannot execute tasks
+
+### Worker  
+- Claims and executes tasks
+- Updates progress
+- Adds subtasks during implementation
+- Cannot create top-level tasks
+
+### Judge
+- Reviews completed work
+- Approves or rejects with feedback
+- Cannot claim or modify tasks
+
+### Usage
+
+```typescript
+// Solo mode (no role required)
+add_task({ title: "Build login page" })
+
+// Multi-agent mode (explicit identification)
+add_task({ 
+  title: "Build login page",
+  description: "Create a secure login page with form validation",
+  agent_id: "planner-1", 
+  role: "planner" 
+})
+
+claim_task({ 
+  task_id: "5", 
+  agent_id: "worker-1", 
+  role: "worker" 
+})
+```
+
+## Project Structure
+
+After running `init_project`:
+
+```
+your-project/
+├── agent-kit/
+│   ├── AGENT_RULES.md      # Role definitions and permissions
+│   ├── TASKS.md            # Task reference (points to memory_bank)
+│   ├── HANDOFF.md          # Handoff protocol reference
+│   └── SHARED_CONTEXT.md   # Shared context documentation
+├── memory_bank/
+│   ├── context/
+│   │   ├── brief.md        # Project overview
+│   │   └── active.md       # Current focus
+│   ├── execution/
+│   │   ├── progress.md     # Task summary (auto-synced)
+│   │   └── decisions.md    # Decision log
+│   └── tasks/
+│       ├── tasks.json      # Task registry (source of truth)
+│       ├── task_001.txt    # Detailed task file
+│       ├── task_002.txt    # ...
+│       └── ...
+└── .cursor/
+    └── rules/
+        └── agent-workflow.mdc  # Cursor agent rules
+```
+
+## Migration from v1.x
+
+If you have existing `.taskmaster/tasks.json`:
+
+1. Run any task command (e.g., `list_tasks`)
+2. The server auto-migrates to `memory_bank/tasks/`
+3. Individual task files are generated
+4. Progress summary is updated
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+MIT

package/dist/agents.d.ts

@@ -0,0 +1,25 @@
+import { Agent, AgentRole, TaskStore } from "./types.js";
+/**
+ * Check if an agent role has permission for a tool
+ */
+export declare function hasPermission(role: AgentRole | undefined, tool: string): boolean;
+/**
+ * Get or create an agent in the store
+ */
+export declare function getOrCreateAgent(store: TaskStore, agentId: string, role: AgentRole): Agent;
+/**
+ * Validate that an agent can perform an action on a task
+ */
+export declare function canActOnTask(store: TaskStore, taskId: string, agentId: string | undefined, action: "update" | "complete" | "release"): {
+    allowed: boolean;
+    reason?: string;
+};
+/**
+ * Get the default agent ID for solo mode
+ */
+export declare function getDefaultAgentId(): string;
+/**
+ * Get the default role for solo mode
+ */
+export declare function getDefaultRole(): AgentRole;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqCzD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GACd,KAAK,CAcP;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GACxC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAqBvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAE1C"}

package/dist/agents.js

@@ -0,0 +1,93 @@
+/**
+ * Permission matrix for agent roles
+ */
+const ROLE_PERMISSIONS = {
+    planner: new Set([
+        "list_tasks",
+        "get_task",
+        "add_task",
+        "expand_task",
+        "parse_prd",
+        "set_dependencies",
+        "analyze_complexity",
+        "remove_task",
+    ]),
+    worker: new Set([
+        "list_tasks",
+        "get_task",
+        "next_task",
+        "claim_task",
+        "update_task",
+        "complete_task",
+        "add_subtask",
+        "research_task",
+        "release_task",
+        "handoff_task",
+    ]),
+    judge: new Set([
+        "list_tasks",
+        "get_task",
+        "review_task",
+        "approve_task",
+        "reject_task",
+    ]),
+};
+/**
+ * Check if an agent role has permission for a tool
+ */
+export function hasPermission(role, tool) {
+    // Solo mode - no role specified, allow everything
+    if (!role)
+        return true;
+    return ROLE_PERMISSIONS[role]?.has(tool) ?? false;
+}
+/**
+ * Get or create an agent in the store
+ */
+export function getOrCreateAgent(store, agentId, role) {
+    let agent = store.agents.find((a) => a.id === agentId);
+    if (!agent) {
+        agent = {
+            id: agentId,
+            role,
+            registered_at: new Date().toISOString(),
+        };
+        store.agents.push(agent);
+    }
+    agent.last_seen = new Date().toISOString();
+    return agent;
+}
+/**
+ * Validate that an agent can perform an action on a task
+ */
+export function canActOnTask(store, taskId, agentId, action) {
+    const task = store.tasks.find((t) => t.id === taskId);
+    if (!task) {
+        return { allowed: false, reason: "Task not found" };
+    }
+    // Solo mode - no agent specified
+    if (!agentId) {
+        return { allowed: true };
+    }
+    // Check ownership for modification actions
+    if (task.assigned_to && task.assigned_to !== agentId) {
+        return {
+            allowed: false,
+            reason: `Task is assigned to ${task.assigned_to}`,
+        };
+    }
+    return { allowed: true };
+}
+/**
+ * Get the default agent ID for solo mode
+ */
+export function getDefaultAgentId() {
+    return "default-worker";
+}
+/**
+ * Get the default role for solo mode
+ */
+export function getDefaultRole() {
+    return "worker";
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,gBAAgB,GAAmC;IACvD,OAAO,EAAE,IAAI,GAAG,CAAC;QACf,YAAY;QACZ,UAAU;QACV,UAAU;QACV,aAAa;QACb,WAAW;QACX,kBAAkB;QAClB,oBAAoB;QACpB,aAAa;KACd,CAAC;IACF,MAAM,EAAE,IAAI,GAAG,CAAC;QACd,YAAY;QACZ,UAAU;QACV,WAAW;QACX,YAAY;QACZ,aAAa;QACb,eAAe;QACf,aAAa;QACb,eAAe;QACf,cAAc;QACd,cAAc;KACf,CAAC;IACF,KAAK,EAAE,IAAI,GAAG,CAAC;QACb,YAAY;QACZ,UAAU;QACV,aAAa;QACb,cAAc;QACd,aAAa;KACd,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA2B,EAC3B,IAAY;IAEZ,kDAAkD;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,OAAe,EACf,IAAe;IAEf,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAEvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG;YACN,EAAE,EAAE,OAAO;YACX,IAAI;YACJ,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACxC,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAgB,EAChB,MAAc,EACd,OAA2B,EAC3B,MAAyC;IAEzC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtD,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,2CAA2C;IAC3C,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,uBAAuB,IAAI,CAAC,WAAW,EAAE;SAClD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import { Config } from "./types.js";
+/**
+ * Get configuration from environment variables with sensible defaults
+ */
+export declare function getConfig(): Config;
+/**
+ * Resolve a path relative to the workspace root
+ */
+export declare function resolvePath(config: Config, relativePath: string): string;
+/**
+ * Get the path for an individual task file
+ */
+export declare function getTaskFilePath(config: Config, taskId: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAQlC;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

@@ -0,0 +1,28 @@
+/**
+ * Get configuration from environment variables with sensible defaults
+ */
+export function getConfig() {
+    return {
+        markdownPath: process.env.TASK_MD_PATH || "memory_bank/execution/progress.md",
+        jsonPath: process.env.TASK_JSON_PATH || "memory_bank/tasks/tasks.json",
+        tasksDir: process.env.TASK_DIR || "memory_bank/tasks",
+        workspaceRoot: process.cwd(),
+    };
+}
+/**
+ * Resolve a path relative to the workspace root
+ */
+export function resolvePath(config, relativePath) {
+    if (relativePath.startsWith("/")) {
+        return relativePath;
+    }
+    return `${config.workspaceRoot}/${relativePath}`;
+}
+/**
+ * Get the path for an individual task file
+ */
+export function getTaskFilePath(config, taskId) {
+    const paddedId = taskId.padStart(3, "0");
+    return resolvePath(config, `${config.tasksDir}/task_${paddedId}.txt`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,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,OAAO,CAAC,GAAG,EAAE;KAC7B,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

@@ -0,0 +1,38 @@
+export interface CursorMemory {
+    id: string;
+    title: string;
+    content: string;
+}
+export interface SharedContext {
+    cursor_memories: CursorMemory[];
+}
+/**
+ * Load shared context from ~/.cursor/shared-context.json
+ * Caches the result for subsequent calls
+ */
+export declare function loadSharedContext(): SharedContext | null;
+/**
+ * Find a memory by partial title match (case-insensitive)
+ */
+export declare function getMemoryByTitle(title: string): CursorMemory | undefined;
+/**
+ * Get all memories as a formatted string for prompts
+ */
+export declare function getAllMemoriesForPrompt(): string | null;
+/**
+ * Get writing preferences from shared context
+ */
+export declare function getWritingPreferences(): string | null;
+/**
+ * Get user identity/values from shared context
+ */
+export declare function getUserIdentity(): string | null;
+/**
+ * Get workflow preferences from shared context
+ */
+export declare function getWorkflowPreferences(): string | null;
+/**
+ * Clear the cached context (useful for testing or reloading)
+ */
+export declare function clearContextCache(): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +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"}

package/dist/context.js

@@ -0,0 +1,70 @@
+import { homedir } from "os";
+import { join } from "path";
+import { existsSync, readFileSync } from "fs";
+let cachedContext = null;
+/**
+ * Load shared context from ~/.cursor/shared-context.json
+ * Caches the result for subsequent calls
+ */
+export function loadSharedContext() {
+    if (cachedContext)
+        return cachedContext;
+    const contextPath = join(homedir(), ".cursor", "shared-context.json");
+    if (!existsSync(contextPath)) {
+        return null;
+    }
+    try {
+        cachedContext = JSON.parse(readFileSync(contextPath, "utf-8"));
+        return cachedContext;
+    }
+    catch {
+        // Failed to parse shared-context.json - continue without it
+        return null;
+    }
+}
+/**
+ * Find a memory by partial title match (case-insensitive)
+ */
+export function getMemoryByTitle(title) {
+    const ctx = loadSharedContext();
+    return ctx?.cursor_memories?.find((m) => m.title.toLowerCase().includes(title.toLowerCase()));
+}
+/**
+ * Get all memories as a formatted string for prompts
+ */
+export function getAllMemoriesForPrompt() {
+    const ctx = loadSharedContext();
+    if (!ctx?.cursor_memories?.length)
+        return null;
+    return ctx.cursor_memories
+        .map((m) => `**${m.title}**: ${m.content}`)
+        .join("\n\n");
+}
+/**
+ * Get writing preferences from shared context
+ */
+export function getWritingPreferences() {
+    const memory = getMemoryByTitle("writing preferences");
+    return memory?.content || null;
+}
+/**
+ * Get user identity/values from shared context
+ */
+export function getUserIdentity() {
+    const memory = getMemoryByTitle("identity") || getMemoryByTitle("values");
+    return memory?.content || null;
+}
+/**
+ * Get workflow preferences from shared context
+ */
+export function getWorkflowPreferences() {
+    const memory = getMemoryByTitle("workflow") || getMemoryByTitle("memory bank");
+    return memory?.content || null;
+}
+/**
+ * Clear the cached context (useful for testing or reloading)
+ */
+export function clearContextCache() {
+    cachedContext = null;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAY9C,IAAI,aAAa,GAAyB,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAEtE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/D,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,OAAO,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/C,OAAO,GAAG,CAAC,eAAe;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;SAC1C,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IACvD,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GACV,gBAAgB,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC/E,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}