obsidian-accomplishments-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Ostan Labs
+
+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,349 @@
+# Obsidian MCP Server
+
+An MCP (Model Context Protocol) server that enables AI assistants to manage structured project accomplishments in Obsidian. Works alongside the [Canvas Structured Items Plugin](https://bitbucket.org/ostanmarc/obsidian-canvas-structured-items/src/master/) for visual project management.
+
+## What This Does
+
+This MCP server lets AI assistants:
+- **Manage accomplishments** — create, update, and track work items with outcomes, acceptance criteria, and tasks
+- **Handle dependencies** — define what blocks what, find blocked items, and identify what's ready to start
+- **Track progress** — see project status, current work, and completion statistics
+- **Read and write documents** — access reference materials organized in workspaces
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                        Your Workflow                                │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│   ┌──────────┐      ┌──────────────┐      ┌──────────┐            │
+│   │ Obsidian │◄────►│  MCP Server  │◄────►│    AI    │            │
+│   │  Canvas  │      │  (this repo) │      │ Assistant│            │
+│   └────┬─────┘      └──────────────┘      └──────────┘            │
+│        │                                                           │
+│        ▼                                                           │
+│   ┌──────────┐      ┌──────────────┐                              │
+│   │  Plugin  │─────►│    Notion    │  (optional sync)             │
+│   └──────────┘      └──────────────┘                              │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18 or later
+- An Obsidian vault
+- The [Canvas Structured Items Plugin](https://bitbucket.org/ostanmarc/obsidian-canvas-structured-items/src/master/) installed in your vault
+
+### Option 1: Install from npm (Recommended)
+
+```bash
+npm install -g obsidian-accomplishments-mcp
+```
+
+Or run directly with npx:
+
+```bash
+npx obsidian-accomplishments-mcp
+```
+
+### Option 2: Install from Source
+
+```bash
+git clone https://github.com/ostanlabs/obsidian_mcp.git
+cd obsidian_mcp
+npm install
+npm run build
+```
+
+### Set Up Your Vault
+
+Create the required folder structure in your Obsidian vault:
+
+```
+your-vault/
+├── accomplishments/          # Accomplishment markdown files
+├── projects/
+│   └── main.canvas           # Your project canvas
+└── workspaces.json           # Workspace configuration (auto-created on first run)
+```
+
+### Configure Your AI Assistant
+
+Add the MCP server to your AI client's configuration.
+
+**For Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+Using npx (recommended):
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "npx",
+      "args": ["-y", "obsidian-accomplishments-mcp@latest"],
+      "env": {
+        "VAULT_PATH": "/absolute/path/to/your/obsidian/vault",
+        "ACCOMPLISHMENTS_FOLDER": "accomplishments",
+        "DEFAULT_CANVAS": "projects/main.canvas"
+      }
+    }
+  }
+}
+```
+
+Using global install:
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "obsidian-accomplishments-mcp",
+      "env": {
+        "VAULT_PATH": "/absolute/path/to/your/obsidian/vault",
+        "ACCOMPLISHMENTS_FOLDER": "accomplishments",
+        "DEFAULT_CANVAS": "projects/main.canvas"
+      }
+    }
+  }
+}
+```
+
+Using local install:
+```json
+{
+  "mcpServers": {
+    "obsidian": {
+      "command": "node",
+      "args": ["/path/to/obsidian_mcp/dist/index.js"],
+      "env": {
+        "VAULT_PATH": "/absolute/path/to/your/obsidian/vault",
+        "ACCOMPLISHMENTS_FOLDER": "accomplishments",
+        "DEFAULT_CANVAS": "projects/main.canvas"
+      }
+    }
+  }
+}
+```
+
+#### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `VAULT_PATH` | Yes | Absolute path to your Obsidian vault |
+| `ACCOMPLISHMENTS_FOLDER` | Yes | Folder for accomplishment files (relative to vault) |
+| `DEFAULT_CANVAS` | Yes | Path to your main project canvas file (relative to vault) |
+
+### Configure Workspaces
+
+On first run, the server creates a `workspaces.json` file in your vault. Edit this file to define document workspaces that the AI can access:
+
+```json
+{
+  "docs": {
+    "path": "/absolute/path/to/your/vault/docs",
+    "description": "Project documentation and reference materials"
+  },
+  "notes": {
+    "path": "/absolute/path/to/your/vault/notes",
+    "description": "Meeting notes and daily logs"
+  }
+}
+```
+
+Each workspace is a named folder containing markdown files that the AI can read and write.
+
+---
+
+## Core Concepts
+
+### Accomplishments
+
+An **accomplishment** is the atomic unit of work. Each accomplishment has:
+
+- **Title** — A clear name for the work item
+- **Outcome** — What will be true when this is done
+- **Acceptance Criteria** — Checkboxes defining completion
+- **Tasks** — Specific steps to achieve the outcome
+- **Dependencies** — Other accomplishments that must finish first
+- **Status** — Not Started, In Progress, Completed, or Blocked
+- **Effort Type** — Business, Engineering, Infra, or Research
+- **Priority** — Low, Medium, High, or Critical
+
+Example accomplishment file:
+
+```markdown
+---
+type: accomplishment
+title: User Authentication
+id: ACC-001
+effort: Engineering
+status: In Progress
+priority: High
+inProgress: true
+depends_on: ["ACC-000"]
+---
+
+# User Authentication (Accomplishment)
+
+## Outcome
+Users can securely log in and maintain sessions.
+
+## Acceptance Criteria
+- [ ] Login form validates credentials
+- [ ] Sessions persist across browser refreshes
+- [ ] Logout clears session completely
+
+## Tasks
+
+### Task 1: Design Auth Flow
+- **Goal:** Document the authentication sequence
+- **Estimate:** 2h
+- **Status:** Complete
+
+### Task 2: Implement Login API
+- **Goal:** Create backend authentication endpoint
+- **Estimate:** 4h
+- **Status:** InProgress
+```
+
+### Canvas as Project Board
+
+The `.canvas` file provides a visual project view:
+
+- **Nodes** = Accomplishments (colored by effort type)
+- **Arrows** = Dependencies (A → B means "B depends on A")
+- **Position** = Workflow stage (left-to-right progression)
+- **Red border** = Currently being worked on (`inProgress: true`)
+
+### Workspaces
+
+Workspaces are named document collections that the AI can access. Configure them in `workspaces.json` to give the AI access to:
+- Project documentation
+- Meeting notes
+- Reference materials
+- Any other markdown files
+
+---
+
+## Available Tools
+
+The MCP server provides 14 tools organized by function:
+
+### Accomplishment Management
+
+| Tool | Description |
+|------|-------------|
+| `manage_accomplishment` | Create, update, or delete accomplishments |
+| `get_accomplishment` | Get full details of a specific accomplishment |
+| `list_accomplishments` | List all accomplishments with optional status filter |
+
+### Task Management
+
+| Tool | Description |
+|------|-------------|
+| `manage_task` | Add, update, or remove tasks within an accomplishment |
+| `set_work_focus` | Set which accomplishment/task is currently being worked on |
+
+### Dependency Management
+
+| Tool | Description |
+|------|-------------|
+| `manage_dependency` | Add or remove dependencies between accomplishments |
+
+### Project Status
+
+| Tool | Description |
+|------|-------------|
+| `get_project_status` | Get project statistics and overview |
+| `get_current_work` | Get items marked as in-progress |
+| `get_blocked_items` | Get items waiting on incomplete dependencies |
+| `get_ready_to_start` | Get items with all dependencies complete |
+
+### Document Management
+
+| Tool | Description |
+|------|-------------|
+| `list_workspaces` | List all configured workspaces |
+| `list_files` | List all markdown files in a workspace |
+| `read_docs` | Read a document from a workspace |
+| `update_doc` | Create, update, or delete documents in a workspace |
+
+---
+
+## Usage Examples
+
+Once configured, ask your AI assistant things like:
+
+### Project Overview
+> "What's the status of my project?"
+> "Show me what's currently in progress"
+> "What items are blocked?"
+> "What can I start working on?"
+
+### Managing Accomplishments
+> "Create an accomplishment for building the payment system"
+> "Mark ACC-001 as complete"
+> "Set ACC-005 as my current focus"
+> "What are the details of ACC-003?"
+
+### Managing Tasks
+> "Add a task to ACC-003 for writing unit tests"
+> "Mark task 2 of ACC-001 as complete"
+> "What tasks are left on ACC-002?"
+
+### Dependencies
+> "ACC-004 depends on ACC-002 and ACC-003"
+> "Remove the dependency from ACC-005 to ACC-001"
+> "What's blocking ACC-006?"
+
+### Documents
+> "What workspaces are available?"
+> "List files in the docs workspace"
+> "Read the architecture document"
+> "Add a section about API design to the architecture doc"
+> "Create a new meeting notes document"
+
+---
+
+## Notion Sync (Optional)
+
+The [Canvas Structured Items Plugin](https://bitbucket.org/ostanmarc/obsidian-canvas-structured-items/src/master/) can sync accomplishments to Notion:
+
+1. Configure Notion API key and database ID in the plugin settings
+2. Accomplishments sync automatically when saved
+3. Dependencies become Notion relations
+4. Two-way sync keeps both systems updated
+
+This lets your team see project status in Notion while you manage everything from Obsidian.
+
+---
+
+## Development
+
+```bash
+# Build the project
+npm run build
+
+# Watch mode for development
+npm run dev
+
+# Run tests
+npm test
+```
+
+The server communicates via MCP protocol over stdio. Test by configuring it in an MCP-compatible client.
+
+---
+
+## Technical Reference
+
+For detailed API specifications, data models, and implementation details, see [Technical Specification](docs/MCP_TECHNICAL_SPEC.md).
+
+---
+
+## License
+
+MIT
+

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":""}

package/dist/index.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { getConfig } from './utils/config.js';
+import { MCPError } from './models/types.js';
+import { allToolDefinitions, handleManageAccomplishment, handleManageDependency, handleManageTask, handleSetWorkFocus, handleGetAccomplishment, handleListAccomplishments, handleGetCurrentWork, handleGetBlockedItems, handleGetReadyToStart, handleGetProjectStatus, handleReadDocs, handleUpdateDoc, handleListWorkspaces, handleListFiles, } from './tools/index.js';
+// Create server instance
+const server = new Server({
+    name: 'obsidian-accomplishments',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Get configuration
+let config;
+try {
+    config = getConfig();
+}
+catch (error) {
+    console.error('Configuration error:', error);
+    process.exit(1);
+}
+// Register tool list handler
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: allToolDefinitions,
+    };
+});
+// Register tool call handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case 'manage_accomplishment':
+                result = await handleManageAccomplishment(config, args);
+                break;
+            case 'manage_dependency':
+                result = await handleManageDependency(config, args);
+                break;
+            case 'manage_task':
+                result = await handleManageTask(config, args);
+                break;
+            case 'set_work_focus':
+                result = await handleSetWorkFocus(config, args);
+                break;
+            case 'get_accomplishment':
+                result = await handleGetAccomplishment(config, args);
+                break;
+            case 'list_accomplishments':
+                result = await handleListAccomplishments(config, args);
+                break;
+            case 'get_current_work':
+                result = await handleGetCurrentWork(config, args);
+                break;
+            case 'get_blocked_items':
+                result = await handleGetBlockedItems(config, args);
+                break;
+            case 'get_ready_to_start':
+                result = await handleGetReadyToStart(config, args);
+                break;
+            case 'get_project_status':
+                result = await handleGetProjectStatus(config, args);
+                break;
+            case 'read_docs':
+                result = await handleReadDocs(config, args);
+                break;
+            case 'update_doc':
+                result = await handleUpdateDoc(config, args);
+                break;
+            case 'list_workspaces':
+                result = await handleListWorkspaces(config, args);
+                break;
+            case 'list_files':
+                result = await handleListFiles(config, args);
+                break;
+            default:
+                throw new MCPError(`Unknown tool: ${name}`, 'UNKNOWN_TOOL', 400);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorCode = error instanceof MCPError ? error.code : 'INTERNAL_ERROR';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: true,
+                        code: errorCode,
+                        message: errorMessage,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Obsidian Accomplishments MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,yBAAyB;AACzB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,oBAAoB;AACpB,IAAI,MAAoC,CAAC;AACzC,IAAI,CAAC;IACH,MAAM,GAAG,SAAS,EAAE,CAAC;AACvB,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE,kBAAkB;KAC1B,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,IAAI,MAAe,CAAC;QAEpB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,uBAAuB;gBAC1B,MAAM,GAAG,MAAM,0BAA0B,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC/D,MAAM;YAER,KAAK,mBAAmB;gBACtB,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC3D,MAAM;YAER,KAAK,aAAa;gBAChB,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACrD,MAAM;YAER,KAAK,gBAAgB;gBACnB,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACvD,MAAM;YAER,KAAK,oBAAoB;gBACvB,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC5D,MAAM;YAER,KAAK,sBAAsB;gBACzB,MAAM,GAAG,MAAM,yBAAyB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC9D,MAAM;YAER,KAAK,kBAAkB;gBACrB,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACzD,MAAM;YAER,KAAK,mBAAmB;gBACtB,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC1D,MAAM;YAER,KAAK,oBAAoB;gBACvB,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC1D,MAAM;YAER,KAAK,oBAAoB;gBACvB,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBAC3D,MAAM;YAER,KAAK,WAAW;gBACd,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACnD,MAAM;YAER,KAAK,YAAY;gBACf,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACpD,MAAM;YAER,KAAK,iBAAiB;gBACpB,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACzD,MAAM;YAER,KAAK,YAAY;gBACf,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;gBACpD,MAAM;YAER;gBACE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,IAAI,EAAE,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAE5E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,IAAI;wBACX,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,YAAY;qBACtB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;AACxE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/models/types.d.ts

@@ -0,0 +1,136 @@
+export type AccomplishmentStatus = 'Not Started' | 'In Progress' | 'Completed' | 'Blocked';
+export type TaskStatus = 'Open' | 'InProgress' | 'Complete' | 'OnHold';
+export type Effort = 'Business' | 'Infra' | 'Engineering' | 'Research';
+export type Priority = 'Low' | 'Medium' | 'High' | 'Critical';
+export interface AccomplishmentFrontmatter {
+    type: 'accomplishment';
+    title: string;
+    id: string;
+    effort: Effort;
+    status: AccomplishmentStatus;
+    priority: Priority;
+    inProgress: boolean;
+    depends_on: string[];
+    created_by_plugin: boolean;
+    collapsed_height: number;
+    expanded_height: number;
+    expanded_width: number;
+    created: string;
+    updated: string;
+    canvas_source: string;
+    vault_path: string;
+    notion_page_id?: string;
+}
+export interface Task {
+    number: number;
+    name: string;
+    goal: string;
+    description: string;
+    technical_notes?: string;
+    estimate?: number;
+    status: TaskStatus;
+    notes?: string;
+}
+export interface Accomplishment {
+    frontmatter: AccomplishmentFrontmatter;
+    outcome: string;
+    acceptance_criteria: string[];
+    tasks: Task[];
+    notes: string;
+    is_blocked?: boolean;
+}
+export interface AccomplishmentSummary {
+    id: string;
+    title: string;
+    status: AccomplishmentStatus;
+    priority: Priority;
+    effort: Effort;
+    inProgress: boolean;
+    is_blocked: boolean;
+    depends_on: string[];
+    task_count: number;
+    completed_task_count: number;
+}
+export interface CanvasNode {
+    id: string;
+    type: 'file' | 'text' | 'link' | 'group';
+    file?: string;
+    text?: string;
+    url?: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color?: string;
+}
+export interface CanvasEdge {
+    id: string;
+    fromNode: string;
+    toNode: string;
+    fromSide: 'top' | 'right' | 'bottom' | 'left';
+    toSide: 'top' | 'right' | 'bottom' | 'left';
+    color?: string;
+    label?: string;
+}
+export interface CanvasFile {
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+}
+export interface CreateAccomplishmentData {
+    title: string;
+    effort: Effort;
+    priority?: Priority;
+    status?: AccomplishmentStatus;
+    outcome?: string;
+    acceptance_criteria?: string[];
+    depends_on?: string[];
+    canvas_source?: string;
+}
+export interface UpdateAccomplishmentData {
+    title?: string;
+    effort?: Effort;
+    priority?: Priority;
+    status?: AccomplishmentStatus;
+    inProgress?: boolean;
+    outcome?: string;
+    acceptance_criteria?: string[];
+    notes?: string;
+}
+export interface TaskData {
+    name: string;
+    goal: string;
+    description?: string;
+    technical_notes?: string;
+    estimate?: number;
+    status?: TaskStatus;
+    notes?: string;
+}
+export interface WorkspaceConfig {
+    path: string;
+    description: string;
+}
+export interface Config {
+    vaultPath: string;
+    accomplishmentsFolder: string;
+    defaultCanvas: string;
+    workspaces: Record<string, WorkspaceConfig>;
+}
+export interface Position {
+    x: number;
+    y: number;
+}
+export declare class MCPError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+export declare class NotFoundError extends MCPError {
+    constructor(message: string);
+}
+export declare class ValidationError extends MCPError {
+    constructor(message: string);
+}
+export declare class ConflictError extends MCPError {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/models/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC3F,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AACvE,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AACvE,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAG9D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,yBAAyB,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAEd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAGD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAGD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C;AAGD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAGD,qBAAa,QAAS,SAAQ,KAAK;IAGxB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,MAAM;gBAFzB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY;CAKlC;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAG5B"}

package/dist/models/types.js

@@ -0,0 +1,27 @@
+// Error types
+export class MCPError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode = 500) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'MCPError';
+    }
+}
+export class NotFoundError extends MCPError {
+    constructor(message) {
+        super(message, 'NOT_FOUND', 404);
+    }
+}
+export class ValidationError extends MCPError {
+    constructor(message) {
+        super(message, 'VALIDATION_ERROR', 400);
+    }
+}
+export class ConflictError extends MCPError {
+    constructor(message) {
+        super(message, 'CONFLICT', 409);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/models/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AAoJA,cAAc;AACd,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,aAAqB,GAAG;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAc;QAG/B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;CACF"}