mcp-task-server 0.1.0

package/dist/templates.js

@@ -0,0 +1,441 @@
+/**
+ * Template files for init_project tool
+ *
+ * All templates use <project> as a placeholder for the project name.
+ */
+/**
+ * Get all template files with placeholders replaced
+ */
+export function getTemplateFiles(projectName) {
+    return [
+        // agent-kit files
+        {
+            path: "agent-kit/AGENT_RULES.md",
+            content: AGENT_RULES_TEMPLATE,
+        },
+        {
+            path: "agent-kit/TASKS.md",
+            content: TASKS_TEMPLATE,
+        },
+        {
+            path: "agent-kit/HANDOFF.md",
+            content: HANDOFF_TEMPLATE,
+        },
+        {
+            path: "agent-kit/SHARED_CONTEXT.md",
+            content: SHARED_CONTEXT_TEMPLATE,
+        },
+        // memory_bank/context files
+        {
+            path: "memory_bank/context/brief.md",
+            content: BRIEF_TEMPLATE.replace(/<project>/g, projectName),
+        },
+        {
+            path: "memory_bank/context/active.md",
+            content: ACTIVE_TEMPLATE.replace(/<project>/g, projectName),
+        },
+        // memory_bank/execution files
+        {
+            path: "memory_bank/execution/progress.md",
+            content: PROGRESS_TEMPLATE.replace(/<project>/g, projectName),
+        },
+        {
+            path: "memory_bank/execution/decisions.md",
+            content: DECISIONS_TEMPLATE.replace(/<project>/g, projectName),
+        },
+        // .cursor/rules file
+        {
+            path: ".cursor/rules/agent-workflow.mdc",
+            content: CURSOR_RULES_TEMPLATE,
+        },
+    ];
+}
+// =============================================================================
+// agent-kit templates
+// =============================================================================
+const AGENT_RULES_TEMPLATE = `# Agent Rules
+
+Read this file before making any changes.
+
+## Required Files
+
+- README.md
+- memory_bank/context/brief.md
+- memory_bank/context/active.md
+- memory_bank/execution/progress.md
+- memory_bank/execution/decisions.md
+
+## Guardrails
+
+- Assumptions → Request → Safeguards
+- One change → one run
+- Keep the model locked (no Auto)
+- Prefer small, reversible steps
+
+## Roles
+
+### Planner
+
+- Explore the repo and memory_bank/context/*.md
+- Add tasks via \`add_task\` tool or update memory_bank/execution/progress.md
+- Break down large tasks with \`expand_task\` or manually
+- Do not implement code unless explicitly requested
+
+**MCP Tool Permissions:**
+- ✅ add_task, expand_task, parse_prd, set_dependencies, analyze_complexity
+- ❌ claim_task, complete_task
+
+### Worker
+
+- Pick one task from memory_bank/execution/progress.md
+- Implement only that task
+- Update memory_bank/execution/progress.md with status and notes
+- Avoid new architecture decisions; log them in decisions.md
+
+**MCP Tool Permissions:**
+- ✅ claim_task, update_task, complete_task, add_subtask, research_task
+- ✅ release_task, handoff_task
+- ❌ add_task, approve_task
+
+### Judge
+
+- Review diffs and memory_bank/execution/progress.md
+- Verify acceptance criteria and tests
+- Decide: accept, request fixes, or re-plan
+
+**MCP Tool Permissions:**
+- ✅ review_task, approve_task, reject_task
+- ❌ claim_task, update_task
+
+## Update Cadence
+
+- After each task, update memory_bank/execution/progress.md
+- If a decision is made, update memory_bank/execution/decisions.md
+
+## Coordination Rules
+
+- One active task per worker
+- Do not modify tasks owned by another worker
+- If blocked, mark the task as blocked and explain why
+
+## Kickoff Prompts
+
+**Planner:**
+"Read AGENT_RULES.md, README.md, and memory_bank/context/*.md. Scan the repo and update memory_bank/execution/progress.md with 5 to 10 concrete tasks. Each task must include scope, target files, and acceptance criteria."
+
+**Worker:**
+"Read AGENT_RULES.md, README.md, and memory_bank/context/active.md. Pick one task from memory_bank/execution/progress.md, implement it fully, then update progress.md with a concise summary."
+
+**Judge:**
+"Read AGENT_RULES.md and memory_bank/execution/progress.md. Review the latest changes and verify acceptance criteria. If issues exist, write fixes in progress.md or add follow-up tasks."
+`;
+const TASKS_TEMPLATE = `# Tasks Reference
+
+Do not track tasks here.
+Use memory_bank/execution/progress.md for high-level task tracking.
+Detailed tasks are stored in memory_bank/tasks/task_XXX.txt files.
+
+## Required Reading
+
+- README.md
+- memory_bank/context/brief.md
+- memory_bank/context/active.md
+- memory_bank/execution/progress.md
+`;
+const HANDOFF_TEMPLATE = `# Handoff Reference
+
+Do not write handoffs here.
+Use memory_bank/execution/progress.md for status updates and
+memory_bank/execution/decisions.md for architectural decisions.
+
+## Handoff Protocol
+
+1. Worker completes task and calls \`handoff_task\` to Judge
+2. Task status changes to "review"
+3. Judge reviews and calls \`approve_task\` or \`reject_task\`
+4. Rejected tasks return to Worker with feedback
+5. Approved tasks are marked "completed"
+`;
+const SHARED_CONTEXT_TEMPLATE = `# Shared Context
+
+MCP servers are isolated processes with no access to Cursor's memory system.
+The shared context file bridges this gap.
+
+## File Location
+
+\`\`\`
+~/.cursor/shared-context.json
+\`\`\`
+
+## File Format
+
+\`\`\`json
+{
+  "cursor_memories": [
+    {
+      "id": "unique-id",
+      "title": "Memory title",
+      "content": "Memory content..."
+    }
+  ]
+}
+\`\`\`
+
+## Recognised Memory Titles
+
+| Title Contains | Used For |
+|----------------|----------|
+| identity or values | User context in prompts |
+| writing preferences | Formatting and style guidance |
+| workflow or memory bank | Task management preferences |
+
+## Keeping It Updated
+
+When Cursor creates or updates a memory, you'll be reminded to sync.
+Run \`sync-memories\` or edit \`~/.cursor/shared-context.json\` manually.
+
+See the full documentation in the MCP Task Server repository.
+`;
+// =============================================================================
+// memory_bank templates
+// =============================================================================
+const BRIEF_TEMPLATE = `---
+title: Project Brief
+slug: /applications/<project>/context/brief
+sidebar_label: brief
+sidebar_position: 1
+unlisted: false
+tags:
+  - application
+  - <project>
+  - context
+  - planning
+  - brief
+---
+
+# Project Brief
+
+## Purpose
+
+State the core purpose in 2 to 3 sentences.
+
+## Core Problem
+
+Describe the specific problem you are solving.
+
+## Real Goal
+
+- Primary outcome:
+- Secondary outcomes:
+
+## Audience
+
+- Primary users:
+- Secondary users:
+
+## Constraints
+
+- Must run where:
+- Cost limits:
+- Data/privacy requirements:
+`;
+const ACTIVE_TEMPLATE = `---
+title: Active Context
+slug: /applications/<project>/context/active
+sidebar_label: active
+sidebar_position: 2
+unlisted: false
+tags:
+  - application
+  - <project>
+  - context
+  - planning
+  - active
+---
+
+# Active Context
+
+> What is actively being worked on.
+
+## Current Stage and Phase
+
+- Stage:
+- Phase:
+
+## Current Focus
+
+- [ ] Task 1
+- [ ] Task 2
+
+## Near-term
+
+- [ ] Next step 1
+- [ ] Next step 2
+
+## Known Issues and Risks
+
+- Risk:
+  - Impact:
+  - Mitigation:
+
+## Guardrails
+
+- Assumptions → Request → Safeguards
+- One change → one run
+- Keep the model locked (no Auto)
+`;
+const PROGRESS_TEMPLATE = `---
+title: Progress
+slug: /applications/<project>/execution/progress
+sidebar_label: progress
+sidebar_position: 1
+unlisted: false
+tags:
+  - application
+  - <project>
+  - execution
+  - progress
+---
+
+# Implementation Progress
+
+## Status
+
+Last updated: ${new Date().toISOString().split("T")[0]}
+
+## Task Completion Summary
+
+### Completed Tasks (0/0)
+
+(No completed tasks yet)
+
+### In Progress Tasks (0/0)
+
+(No tasks in progress)
+
+### Pending Tasks (0/0)
+
+(No pending tasks)
+
+## Recent Updates
+
+- ${new Date().toISOString().split("T")[0]}: Project initialised
+
+---
+
+*Task details are in \`memory_bank/tasks/task_XXX.txt\` files.*
+*This summary is auto-generated from \`memory_bank/tasks/tasks.json\`.*
+`;
+const DECISIONS_TEMPLATE = `---
+title: Decision Log
+slug: /applications/<project>/execution/decisions
+sidebar_label: decisions
+sidebar_position: 3
+unlisted: false
+tags:
+  - application
+  - <project>
+  - execution
+  - decisions
+---
+
+# Decision Log
+
+## Structure
+
+- Date
+- Decision
+- Reasoning
+- Alternatives
+- Impact
+
+## Decision History
+
+### ${new Date().toISOString().slice(0, 7)}
+
+- Decision:
+  - Reasoning:
+  - Alternatives:
+  - Impact:
+`;
+// =============================================================================
+// .cursor/rules template
+// =============================================================================
+const CURSOR_RULES_TEMPLATE = `# Agent Workflow Rules
+
+## Task Management Protocol
+
+When working on this project, follow these task management rules:
+
+### Before Starting Work
+
+1. Check \`memory_bank/execution/progress.md\` for current task status
+2. Use \`list_tasks\` to see available tasks
+3. Use \`next_task\` to get the recommended task based on dependencies
+4. Claim the task before starting work
+
+### During Work
+
+1. Update task status as you progress
+2. Add subtasks if you discover additional work
+3. Document decisions in \`memory_bank/execution/decisions.md\`
+4. Keep \`memory_bank/context/active.md\` updated with current focus
+
+### After Completing Work
+
+1. Mark the task complete
+2. Update progress.md with completion notes
+3. Hand off to Judge for review if required
+4. Move to the next task
+
+## Role-Based Behaviour
+
+### As a Planner
+
+- Focus on breaking down requirements into actionable tasks
+- Set clear dependencies between tasks
+- Estimate complexity before assigning
+- Do not execute tasks yourself
+
+### As a Worker
+
+- Claim tasks before starting
+- Update progress frequently
+- Request help if blocked
+- Hand off completed work for review
+
+### As a Judge
+
+- Review completed work thoroughly
+- Provide specific, actionable feedback
+- Approve work that meets requirements
+- Request re-planning if approach is wrong
+
+## File Conventions
+
+- **progress.md**: High-level task summary, auto-synced with tasks.json
+- **tasks/task_XXX.txt**: Detailed task files
+- **decisions.md**: Architectural and design decisions
+- **active.md**: Current working context
+- **brief.md**: Project overview and goals
+
+## Communication
+
+When handing off between roles:
+1. Clearly state what was done
+2. Note any issues or concerns
+3. Specify what review is needed
+4. Include relevant file references
+`;
+/**
+ * Get the initial empty tasks.json content
+ */
+export function getInitialTasksJson() {
+    return JSON.stringify({
+        version: "2.0.0",
+        tasks: [],
+        agents: [],
+        updated_at: new Date().toISOString(),
+    }, null, 2);
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO;QACL,kBAAkB;QAClB;YACE,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,oBAAoB;SAC9B;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,cAAc;SACxB;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,gBAAgB;SAC1B;QACD;YACE,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,uBAAuB;SACjC;QACD,4BAA4B;QAC5B;YACE,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAC3D;QACD;YACE,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAC5D;QACD,8BAA8B;QAC9B;YACE,IAAI,EAAE,mCAAmC;YACzC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAC9D;QACD;YACE,IAAI,EAAE,oCAAoC;YAC1C,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAC/D;QACD,qBAAqB;QACrB;YACE,IAAI,EAAE,kCAAkC;YACxC,OAAO,EAAE,qBAAqB;SAC/B;KACF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2E5B,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;CAYtB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC/B,CAAC;AAEF,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCtB,CAAC;AAEF,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CvB,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;gBAiBV,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;IAkBlD,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;;;;;CAMzC,CAAC;AAEF,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;MAyBrB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;CAMzC,CAAC;AAEF,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE7B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}