refactor: Refactor devlog management by replacing DevlogManager with MCPDevlogAdapter

- Removed DevlogManager implementation and replaced it with MCPDevlogAdapter for better integration with the Model Context Protocol.
- Updated index.ts to utilize MCPDevlogAdapter for handling devlog-related requests.
- Created mcp-adapter.ts to wrap DevlogManager and convert responses to MCP format.
- Adjusted test.ts to reflect changes in the API and ensure compatibility with the new adapter.
- Updated tsconfig.json and pnpm-lock.yaml to include references to the new core package.
- Removed devlog-manager.ts as it is no longer needed.

Author: tikazyq

CONTRIBUTING.md

@@ -38,6 +38,9 @@ pnpm build
 # Build only the MCP server
 pnpm build:mcp
 
+# Build only the core package  
+pnpm build:core
+
 # Build only the types package
 pnpm build:types
 
@@ -63,6 +66,10 @@ You can also work directly with individual packages using pnpm filters:
 pnpm --filter @devlog/mcp-server build
 pnpm --filter @devlog/mcp-server dev
 
+# Work on the core package
+pnpm --filter @devlog/core build
+pnpm --filter @devlog/core dev
+
 # Work on the types package
 pnpm --filter @devlog/types build
 pnpm --filter @devlog/types dev
@@ -92,10 +99,11 @@ When adding a new package to the monorepo:
 
 ### Package Structure
 
-- `@devlog/mcp-server`: The main MCP server implementation
+- `@devlog/types`: Shared TypeScript types and interfaces
+- `@devlog/core`: Core devlog management functionality (file system operations, CRUD, etc.)
+- `@devlog/mcp-server`: MCP server implementation that wraps the core functionality
 - Future packages might include:
   - `@devlog/cli`: Command-line interface for devlog management
-  - `@devlog/types`: Shared TypeScript types
   - `@devlog/web`: Web interface for browsing devlogs
   - `@devlog/utils`: Shared utilities
 

README.md

@@ -4,8 +4,14 @@ A monorepo containing development logging tools and utilities, including a Model
 
 ## Packages
 
+### `@devlog/types`
+Shared TypeScript types and interfaces used across all packages.
+
+### `@devlog/core` 
+Core devlog management functionality including file system operations, CRUD operations, filtering, and search. This package provides the foundation that other packages build upon.
+
 ### `@devlog/mcp-server`
-The main MCP server for development logging functionality.
+MCP (Model Context Protocol) server that wraps the core functionality for AI assistant integration.
 
 ## Features
 
@@ -42,10 +48,53 @@ pnpm dev
 pnpm build
 
 # Build specific packages
-pnpm build:mcp
 pnpm build:types
+pnpm build:core  
+pnpm build:mcp
 ```
 
+### Using the Core Package
+
+The `@devlog/core` package can be used directly in your own applications:
+
+```typescript
+import { DevlogManager } from '@devlog/core';
+
+// Initialize the manager
+const devlog = new DevlogManager({
+  workspaceRoot: '/path/to/your/project',
+  // devlogDir: '/custom/path/.devlog' // optional custom directory
+});
+
+// Create a new devlog entry
+const entry = await devlog.createDevlog({
+  title: 'Implement user authentication',
+  type: 'feature',
+  description: 'Add JWT-based authentication system',
+  priority: 'high',
+  businessContext: 'Users need secure login to access protected features',
+  technicalContext: 'Using JWT tokens with refresh mechanism'
+});
+
+// Update the devlog
+await devlog.updateDevlog({
+  id: entry.id,
+  status: 'in-progress',
+  progress: 'Completed user registration endpoint'
+});
+
+// List all devlogs
+const allDevlogs = await devlog.listDevlogs();
+
+// Search devlogs
+const authDevlogs = await devlog.searchDevlogs('authentication');
+
+// Get active context for AI assistants
+const activeContext = await devlog.getActiveContext(5);
+```
+
+This makes it easy to build additional tools like CLI interfaces, web dashboards, or integrations with other development tools.
+
 ### Available Tools
 
 #### `create_devlog`

package.json

@@ -15,7 +15,8 @@
     "clean": "pnpm -r clean",
     "install-all": "pnpm install",
     "build:mcp": "pnpm --filter @devlog/mcp-server build",
-    "build:types": "pnpm --filter @devlog/types build"
+    "build:types": "pnpm --filter @devlog/types build",
+    "build:core": "pnpm --filter @devlog/core build"
   },
   "keywords": [
     "monorepo",

packages/core/README.md

@@ -0,0 +1,134 @@
+# @devlog/core
+
+Core functionality for the devlog system. This package provides the main `DevlogManager` class that handles creation, updating, querying, and management of development logs.
+
+## Features
+
+- **CRUD Operations**: Create, read, update, and delete devlog entries
+- **File System Storage**: JSON-based storage in `.devlog` directory
+- **Rich Context**: Support for business context, technical context, and AI-enhanced metadata
+- **Filtering & Search**: Query devlogs by status, type, priority, tags, and text search
+- **Notes & Progress Tracking**: Add timestamped notes to track progress
+- **AI Context Management**: Special handling for AI assistant context and insights
+- **Decision Tracking**: Record important decisions with rationale
+- **Statistics**: Get overview statistics of your devlog entries
+
+## Installation
+
+```bash
+pnpm add @devlog/core
+```
+
+## Usage
+
+```typescript
+import { DevlogManager } from '@devlog/core';
+
+// Initialize the manager
+const devlog = new DevlogManager({
+  workspaceRoot: '/path/to/your/project',
+  // devlogDir: '/custom/path/.devlog' // optional custom directory
+});
+
+// Create a new devlog entry
+const entry = await devlog.createDevlog({
+  title: 'Implement user authentication',
+  type: 'feature',
+  description: 'Add JWT-based authentication system',
+  priority: 'high',
+  businessContext: 'Users need secure login to access protected features',
+  technicalContext: 'Using JWT tokens with refresh mechanism',
+  acceptanceCriteria: [
+    'Users can register with email/password',
+    'Users can login and receive JWT token',
+    'Protected routes require valid token'
+  ]
+});
+
+// Update the devlog
+await devlog.updateDevlog({
+  id: entry.id,
+  status: 'in-progress',
+  progress: 'Completed user registration endpoint'
+});
+
+// Add a note
+await devlog.addNote(entry.id, {
+  category: 'progress',
+  content: 'Fixed validation issues with email format'
+});
+
+// List all devlogs
+const allDevlogs = await devlog.listDevlogs();
+
+// Filter devlogs
+const inProgressTasks = await devlog.listDevlogs({
+  status: ['in-progress'],
+  type: ['feature', 'bugfix']
+});
+
+// Search devlogs
+const authDevlogs = await devlog.searchDevlogs('authentication');
+
+// Get active context for AI assistants
+const activeContext = await devlog.getActiveContext(5);
+
+// Complete a devlog
+await devlog.completeDevlog(entry.id, 'Authentication system implemented and tested');
+```
+
+## API Reference
+
+### DevlogManager
+
+#### Constructor
+
+```typescript
+new DevlogManager(options?: DevlogManagerOptions)
+```
+
+Options:
+- `workspaceRoot?: string` - Root directory of your project (defaults to `process.cwd()`)
+- `devlogDir?: string` - Custom directory for devlog storage (defaults to `{workspaceRoot}/.devlog`)
+
+#### Methods
+
+- `createDevlog(request: CreateDevlogRequest): Promise<DevlogEntry>`
+- `updateDevlog(request: UpdateDevlogRequest): Promise<DevlogEntry>`
+- `getDevlog(id: string): Promise<DevlogEntry | null>`
+- `listDevlogs(filters?: DevlogFilter): Promise<DevlogEntry[]>`
+- `searchDevlogs(query: string): Promise<DevlogEntry[]>`
+- `addNote(id: string, note: Omit<DevlogNote, "id" | "timestamp">): Promise<DevlogEntry>`
+- `completeDevlog(id: string, summary?: string): Promise<DevlogEntry>`
+- `deleteDevlog(id: string): Promise<void>`
+- `getActiveContext(limit?: number): Promise<DevlogEntry[]>`
+- `updateAIContext(args: AIContextUpdate): Promise<DevlogEntry>`
+- `addDecision(args: DecisionArgs): Promise<DevlogEntry>`
+- `getStats(): Promise<DevlogStats>`
+
+## Storage Format
+
+Devlogs are stored as JSON files in the `.devlog` directory with the following structure:
+
+```
+.devlog/
+├── index.json          # Maps devlog IDs to filenames
+├── feature-auth-123.json
+├── bugfix-validation-456.json
+└── ...
+```
+
+Each devlog file contains a complete `DevlogEntry` object with all metadata, notes, and context information.
+
+## Integration
+
+This core package is designed to be used by:
+
+- `@devlog/mcp-server` - MCP server for AI assistants
+- `@devlog/cli` - Command-line interface
+- `@devlog/web` - Web interface for browsing devlogs
+- Custom applications and scripts
+
+## License
+
+MIT

packages/core/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@devlog/core",
+  "version": "1.0.0",
+  "description": "Core devlog management functionality",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "type": "module",
+  "files": [
+    "build/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-username/devlog-monorepo.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/your-username/devlog-monorepo#readme",
+  "bugs": {
+    "url": "https://github.com/your-username/devlog-monorepo/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "prepare": "pnpm build",
+    "clean": "rm -rf build",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "devlog",
+    "development-notes",
+    "core",
+    "library"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@devlog/types": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/ui": "^2.1.9",
+    "typescript": "^5.0.0",
+    "vitest": "^2.1.9"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}