mcp-taskflow 0.1.0

package/dist/tools/thought/thoughtTools.js

@@ -0,0 +1,47 @@
+/**
+ * Thought Tools Implementation
+ *
+ * Implements MCP tools for structured thinking and reasoning processes.
+ *
+ * Tools:
+ * - process_thought: Record and structure reasoning steps
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ProcessThoughtParamsSchema, } from '../../data/schemas.js';
+import { ProcessThoughtPromptBuilder, } from '../../prompts/thoughtPromptBuilder.js';
+/**
+ * Register all thought tools with the MCP server
+ *
+ * @param server - MCP server instance
+ */
+export function registerThoughtTools(server) {
+    const container = server.getContainer();
+    registerProcessThought(server, container);
+}
+/**
+ * Register process_thought tool
+ */
+function registerProcessThought(server, container) {
+    server.registerTool({
+        name: 'process_thought',
+        description: 'Record a structured thought step in a reasoning process with stage tracking.',
+        inputSchema: zodToJsonSchema(ProcessThoughtParamsSchema, { $refStrategy: 'none' }),
+        execute: async (args) => {
+            const params = ProcessThoughtParamsSchema.parse(args);
+            const { logger } = container;
+            logger.info({
+                thoughtNumber: params.thoughtNumber,
+                totalThoughts: params.totalThoughts,
+                stage: params.stage,
+            }, 'Processing thought');
+            const builder = new ProcessThoughtPromptBuilder();
+            const result = await builder.build(params.thought, params.thoughtNumber, params.totalThoughts, params.stage, params.nextThoughtNeeded, params.tags ?? undefined, params.axiomsUsed ?? undefined, params.assumptionsChallenged ?? undefined);
+            logger.info({
+                thoughtNumber: params.thoughtNumber,
+                nextNeeded: params.nextThoughtNeeded,
+            }, 'Thought processed');
+            return result;
+        },
+    });
+}
+//# sourceMappingURL=thoughtTools.js.map

package/dist/tools/thought/thoughtTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thoughtTools.js","sourceRoot":"","sources":["../../../src/tools/thought/thoughtTools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,0BAA0B,GAE3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,2BAA2B,GAC5B,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IAExC,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,MAAiB,EAAE,SAA2B;IAC5E,MAAM,CAAC,YAAY,CAAC;QAClB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,eAAe,CAAC,0BAA0B,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAIhF;QACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;YAC/B,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;YAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YAE7B,MAAM,CAAC,IAAI,CAAC;gBACV,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,EAAE,oBAAoB,CAAC,CAAC;YAEzB,MAAM,OAAO,GAAG,IAAI,2BAA2B,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAChC,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,IAAI,IAAI,SAAS,EACxB,MAAM,CAAC,UAAU,IAAI,SAAS,EAC9B,MAAM,CAAC,qBAAqB,IAAI,SAAS,CAC1C,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC;gBACV,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,UAAU,EAAE,MAAM,CAAC,iBAAiB;aACrC,EAAE,mBAAmB,CAAC,CAAC;YAExB,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/docs/API.md

@@ -0,0 +1,32 @@
+# API Reference
+
+TaskFlow MCP exposes tools over MCP. This document summarizes the tool set at a high level.
+
+## Task Planning
+
+- `plan_task`: turn a goal into a structured plan
+- `split_tasks`: split a plan into discrete tasks
+- `analyze_task`: capture analysis state for a task
+- `reflect_task`: record a reflection on a task
+
+## Task Management
+
+- `list_tasks`: list tasks by status
+- `get_task_detail`: detailed view of a task
+- `query_task`: search tasks
+- `create_task`: create a new task
+- `update_task`: update fields/status
+- `delete_task`: remove a task
+- `clear_all_tasks`: remove all tasks
+
+## Workflow
+
+- `execute_task`: mark a task in progress and capture execution notes
+- `verify_task`: score and mark a task complete
+
+## Research and Project
+
+- `research_mode`: guided research with state tracking
+- `process_thought`: record a reasoning step
+- `init_project_rules`: create default project rules
+- `get_server_info`: server status and counts

package/docs/ARCHITECTURE.md

@@ -0,0 +1,44 @@
+# Architecture
+
+TaskFlow MCP is a local MCP server with a small, layered design.
+
+```mermaid
+flowchart TD
+  A[MCP Client] -->|STDIO JSON-RPC| B[MCP Server]
+  B --> C[Tools Layer]
+  C --> D[Data Layer]
+  C --> E[Prompt Templates]
+```
+
+## Layers
+
+1. **Server**: MCP protocol handling and tool registration
+2. **Tools**: business logic for task planning, workflow, and research
+3. **Data**: task persistence and queries
+4. **Prompts**: templates used by planning and research tools
+
+## Data Model
+
+Tasks are stored in a JSON document under the configured `DATA_DIR`. The schema is validated at runtime and includes fields for status, timestamps, dependencies, notes, and summaries.
+
+```mermaid
+classDiagram
+  class TaskDocument {
+    string version
+    TaskItem[] tasks
+  }
+  class TaskItem {
+    string id
+    string name
+    string description
+    string status
+    string createdAt
+    string updatedAt
+    string completedAt
+  }
+  TaskDocument "1" --> "*" TaskItem
+```
+
+## Transport
+
+The server uses STDIO transport. Clients call `tools/list` to discover tools and `tools/call` to execute them.

package/docs/COMPATIBILITY_REPORT.md

@@ -0,0 +1,26 @@
+# Compatibility Report
+
+This report summarizes final verification for TaskFlow MCP.
+
+## Summary
+
+- ✅ MCP JSON-RPC flow verified via integration tests
+- ✅ All MCP tools list and execute correctly
+- ✅ Changesets release workflow configured
+- ✅ Package builds and runs from `dist`
+- ✅ Performance benchmarks and tests documented
+
+## Evidence
+
+- Protocol and workflow coverage: `tests/integration/mcpProtocol.test.ts`
+- Performance coverage: `tests/integration/performance.test.ts`
+- Release workflow: `.github/workflows/release-workflow.yml`
+- Changesets config: `.changeset/config.json`
+- Build output: `dist/index.js`
+
+## Latest Verification (2026-02-04)
+
+- `pnpm test` passed (27 test files, 593 tests).
+- `pnpm build` succeeded and templates copied to `dist/prompts/templates`.
+
+## Notes

package/docs/PERFORMANCE.md

@@ -0,0 +1,66 @@
+# Performance Guide
+
+This document describes how to measure TaskFlow MCP performance, expected baselines, and how to interpret results. Performance will vary by machine, disk, and OS. Use these numbers as target SLOs, not absolute guarantees.
+
+## What We Measure
+
+- Task CRUD latency
+- Search performance on 1,000+ tasks
+- Template rendering speed
+- JSON parse/serialize time
+- Sustained load behavior
+- Memory growth under repeated operations
+
+## Benchmarking
+
+Run the benchmark script after building:
+
+```bash
+pnpm build
+pnpm run benchmark
+```
+
+The script creates a temporary dataset and prints timings for task creation, list operations, search, planning, and JSON parse/serialize.
+
+## Integration Performance Tests
+
+The integration test suite includes performance checks:
+
+```bash
+pnpm test tests/integration/performance.test.ts
+```
+
+These tests validate latency and sustained load characteristics against the targets below.
+
+## Profiling
+
+For deeper profiling, run Node with built-in profiling:
+
+```bash
+node --prof dist/index.js
+```
+
+You can also profile the benchmark script:
+
+```bash
+node --prof benchmarks/run-benchmarks.mjs
+```
+
+The generated `isolate-*.log` can be inspected with `node --prof-process`.
+
+## Target SLOs
+
+These are the performance objectives for typical developer machines:
+
+- Task operations: < 50ms for 1,000 tasks
+- Search: < 100ms for 1,000 tasks
+- Template rendering: < 10ms
+- JSON parse/serialize: < 20ms for 1,000 tasks
+- Memory: < 100MB during steady load
+- Sustained load: < 100ms average list time on 500 tasks
+
+## Notes
+
+- Cold runs are slower due to disk caches and module initialization.
+- Disk speed impacts CRUD and list performance the most.
+- Use the benchmark output to compare improvements across releases.

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "mcp-taskflow",
+  "version": "0.1.0",
+  "description": "MCP server for workflow orchestration, planning, and structured development",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-taskflow": "./dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "task-management",
+    "research",
+    "ai-assistant"
+  ],
+  "author": "Caleb German",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "dotenv": "^16.3.1",
+    "pino": "^8.21.0",
+    "pino-pretty": "^13.1.3",
+    "zod": "^3.22.4",
+    "zod-to-json-schema": "^3.22.4"
+  },
+  "devDependencies": {
+    "@jazzer.js/core": "^2.1.0",
+    "@types/node": "^20.19.30",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-security": "^3.0.1",
+    "prettier": "^3.8.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.17",
+    "@changesets/cli": "^2.27.11",
+    "rimraf": "^6.0.1"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md",
+    "CHANGELOG.md",
+    "docs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc",
+    "postbuild": "node scripts/copy-templates.mjs",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "audit": "pnpm audit --audit-level=moderate",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "start": "node dist/index.js",
+    "benchmark": "node benchmarks/run-benchmarks.mjs",
+    "fuzz:pathResolver": "jazzer tests/security/fuzz/pathResolver.fuzz.mjs",
+    "clean": "pnpm rimraf dist",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "check": "changeset status"
+  }
+}