CopilotTaskMaster 0.1.1__py3-none-any.whl

copilottaskmaster-0.1.1.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: CopilotTaskMaster
+Version: 0.1.1
+Summary: Python tools for managing markdown task cards with MCP integration
+Author: CopilotTaskMaster Contributors
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: mcp>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+
+# CopilotTaskMaster
+
+Markdown-based task management for humans and AI agents. Manage tasks via CLI or MCP (Model Context Protocol).
+
+## Features
+
+- **Project-Scoped:** All tasks are organized by project folders.
+- **Agent Optimized:** Token-efficient responses designed for LLM integration.
+- **Markdown First:** Tasks are stored as plain `.md` files with YAML frontmatter.
+- **Dual Interface:** Full parity between CLI and MCP server tools.
+- **Hierarchical:** Supports nested subpaths and tag-based filtering.
+
+## Installation
+
+### From Source
+```bash
+git clone https://github.com/geekbozu/CopilotTaskMaster.git
+cd CopilotTaskMaster
+pip install -e .
+```
+
+### Via Docker
+Pull the pre-built image from GHCR:
+```bash
+docker pull ghcr.io/geekbozu/copilottaskmaster:latest
+```
+
+Or build locally:
+```bash
+docker build -t taskmaster .
+```
+
+## Usage
+
+### CLI Basics
+All operations require a **project** scope, either via `--project` or as a path prefix.
+
+```bash
+# Create
+taskmaster create backend/login.md "Implement Auth" --status open --priority high
+
+# List & Search
+taskmaster list --project backend
+taskmaster search --query "Auth" --status open
+
+taskmaster tags --project backend  # list tags for a project (omit --project to list all tags)
+
+# Update & Move
+taskmaster update backend/login.md --status in-progress
+taskmaster move backend/login.md backend/completed/login.md
+
+# Show Structure
+# Show the whole workspace tree
+taskmaster tree
+# Show tree scoped to a project
+taskmaster tree --project backend
+```
+
+### MCP Server (VS Code)
+Enable task management tools in VS Code by adding the server to your settings:
+
+```json
+{
+  "servers  ": {
+    "taskmaster": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm", 
+        "-v", "${workspaceFolder}/tasks:/tasks", 
+        "ghcr.io/geekbozu/copilottaskmaster:latest", 
+        "mcp-server"
+      ]
+    }
+  }
+}
+```
+
+**Available Tools:** `create_task`, `read_task`, `update_task`, `delete_task`, `list_tasks`, `search_tasks`, `move_task`, `get_structure`, `get_all_tags`.
+
+Tool details (selected):
+
+- `get_structure(subpath: str = "", project: Optional[str] = None)`: Return hierarchical folder/task structure. When `project` is provided, the structure is scoped to that project (raises ValueError if the project does not exist).
+- `get_all_tags(project: Optional[str] = None)`: Return the set of tags used across tasks. When `project` is provided, tags are collected only from that project's tasks (returns empty set if the project does not exist).
+
+## Task Format
+Tasks are standard Markdown files:
+
+```markdown
+---
+title: Implement Auth
+status: open
+priority: high
+tags: [auth, security]
+---
+# Implementation Details
+- [ ] Setup JWT
+- [ ] Hash Passwords
+```
+
+## Configuration
+- `TASKMASTER_TASKS_DIR`: Path to storage (default: `./tasks`).
+- Use `--tasks-dir` on any CLI command to override.
+
+## Development
+```bash
+pytest                 # Run tests
+black taskmaster/      # Format code
+```
+
+## License
+MIT

copilottaskmaster-0.1.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+taskmaster/__init__.py,sha256=RJot_-TEwO9pLbE3ChcIj5oSKhsgoTjuAHVWJoIYBK8,1302
+taskmaster/_version.py,sha256=m8HxkqoKGw_wAJtc4ZokpJKNLXqp4zwnNhbnfDtro7w,704
+taskmaster/cli.py,sha256=iHDh9RiK9o8S3Y9aBBjz22OL5uugn1Glp8ZpBNs7aFM,10556
+taskmaster/mcp_server.py,sha256=VOYowbFhH0SqUVnbt-Vx4PKh1FLBcvBCkx3J7b0KMvo,18079
+taskmaster/search.py,sha256=x7fgJrFxXnpfOLK7hYDgkanbQbcIFc4Lkf-lMse6UR8,8442
+taskmaster/task_manager.py,sha256=isq-tY4YTAU94BBqkcMK1FwwrsFrTLzr37TjL6rUU3Q,13693
+taskmaster/utils.py,sha256=60z4FyHWI91NEcVS0djk0fiBg5ncdIKA-FFGK60n2sI,442
+copilottaskmaster-0.1.1.dist-info/METADATA,sha256=3GOAPCXvaE5c7hc9UEPM6Px6u9X_Z8pjUqMQZ9X7JQY,3899
+copilottaskmaster-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+copilottaskmaster-0.1.1.dist-info/entry_points.txt,sha256=x2l9TVb92kKXMCB7RgkFt6CbsnB7_bhNcbbsrvMxT6E,95
+copilottaskmaster-0.1.1.dist-info/top_level.txt,sha256=SPHiThSPLrfMwnXlniF0KxlcfMygYlWwvVFfEaDbZh0,11
+copilottaskmaster-0.1.1.dist-info/RECORD,,

copilottaskmaster-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

copilottaskmaster-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+taskmaster = taskmaster.cli:main
+taskmaster-mcp = taskmaster.mcp_server:main

copilottaskmaster-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+taskmaster

taskmaster/__init__.py

@@ -0,0 +1,39 @@
+"""
+CopilotTaskMaster - Markdown task card management with MCP integration
+"""
+
+import os
+from importlib.metadata import PackageNotFoundError, version as _version
+
+# Resolve package version with a simple precedence:
+# 1) TASKMASTER_VERSION env var (CI / Docker build-arg)
+# 2) setuptools_scm-generated file `taskmaster/_version.py` (if present)
+# 3) installed package metadata (importlib.metadata)
+# 4) fallback to "0.0.0"
+
+v = os.environ.get("TASKMASTER_VERSION")
+if v:
+    __version__ = v
+else:
+    # Prefer the file written by setuptools_scm at build time
+    ver_file = os.path.join(os.path.dirname(__file__), "_version.py")
+    if os.path.exists(ver_file):
+        try:
+            data = {}
+            with open(ver_file, "r", encoding="utf-8") as f:
+                exec(f.read(), data)
+            __version__ = data.get("version") or data.get("__version__")
+            if not __version__:
+                raise ValueError("no version in _version.py")
+        except Exception:
+            __version__ = "0.0.0"
+    else:
+        try:
+            __version__ = _version("CopilotTaskMaster")
+        except PackageNotFoundError:
+            __version__ = "0.0.0"
+
+from .task_manager import TaskManager
+from .search import TaskSearcher
+
+__all__ = ["TaskManager", "TaskSearcher", "__version__"]

taskmaster/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.1.1'
+__version_tuple__ = version_tuple = (0, 1, 1)
+
+__commit_id__ = commit_id = None

taskmaster/cli.py

@@ -0,0 +1,333 @@
+"""
+CLI - Command-line interface for TaskMaster
+"""
+
+import os
+import sys
+import json
+from pathlib import Path
+import click
+from . import __version__
+from .task_manager import TaskManager
+from .search import TaskSearcher
+
+
+@click.group()
+@click.version_option(__version__, prog_name="CopilotTaskMaster")
+@click.option('--tasks-dir', default=None, help='Path to tasks directory')
+@click.pass_context
+def main(ctx, tasks_dir):
+    """CopilotTaskMaster - Manage markdown task cards"""
+    ctx.ensure_object(dict)
+    
+    if tasks_dir is None:
+        tasks_dir = os.environ.get('TASKMASTER_TASKS_DIR', './tasks')
+    
+    ctx.obj['tasks_dir'] = tasks_dir
+    ctx.obj['manager'] = TaskManager(tasks_dir)
+    ctx.obj['searcher'] = TaskSearcher(tasks_dir)
+
+
+@main.command()
+@click.argument('path')
+@click.argument('title')
+@click.option('--content', default="", help='Task content')
+@click.option('--status', default='open', help='Task status')
+@click.option('--priority', default='medium', help='Task priority')
+@click.option('--tags', multiple=True, help='Task tags')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def create(ctx, path, title, content, status, priority, tags, project):
+    """Create a new task card"""
+    manager = ctx.obj['manager']
+    
+    metadata = {
+        'status': status,
+        'priority': priority
+    }
+    
+    if tags:
+        metadata['tags'] = list(tags)
+
+    from .utils import project_resolution_error_msg
+
+    try:
+        result = manager.create_task(path, title, content, metadata, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+
+    click.echo(f"✓ Created task: {result['path']}")
+    click.echo(f"  Title: {result['title']}")
+    click.echo(f"  Created: {result['created']}")
+
+
+@main.command()
+@click.argument('path')
+@click.option('--full', is_flag=True, help='Show full content')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def show(ctx, path, full, project):
+    """Show a task card"""
+    manager = ctx.obj['manager']
+    
+    from .utils import project_resolution_error_msg
+
+    try:
+        task = manager.read_task(path, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+
+    if not task:
+        click.echo(f"✗ Task not found: {path}", err=True)
+        sys.exit(1)
+    
+    click.echo(f"Path: {task['path']}")
+    click.echo(f"Title: {task['title']}")
+    click.echo(f"\nMetadata:")
+    for key, value in task['metadata'].items():
+        click.echo(f"  {key}: {value}")
+    
+    if full:
+        click.echo(f"\nContent:\n{task['content']}")
+
+
+@main.command()
+@click.argument('path')
+@click.option('--title', default=None, help='New title')
+@click.option('--content', default=None, help='New content')
+@click.option('--status', default=None, help='New status')
+@click.option('--priority', default=None, help='New priority')
+@click.option('--add-tag', multiple=True, help='Add tags')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def update(ctx, path, title, content, status, priority, add_tag, project):
+    """Update a task card"""
+    manager = ctx.obj['manager']
+    
+    metadata = {}
+    if status:
+        metadata['status'] = status
+    if priority:
+        metadata['priority'] = priority
+    
+    from .utils import project_resolution_error_msg
+
+    try:
+        if add_tag:
+            # Read existing tags first
+            task = manager.read_task(path, project=project)
+            if task:
+                existing_tags = task['metadata'].get('tags', [])
+                if isinstance(existing_tags, str):
+                    existing_tags = [existing_tags]
+                metadata['tags'] = list(set(existing_tags + list(add_tag)))
+
+        result = manager.update_task(path, title, content, metadata, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+
+    if not result:
+        click.echo(f"✗ Task not found: {path}", err=True)
+        sys.exit(1)
+    
+    click.echo(f"✓ Updated task: {result['path']}")
+
+
+@main.command()
+@click.argument('path')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def delete(ctx, path, project):
+    """Delete a task card"""
+    manager = ctx.obj['manager']
+    
+    from .utils import project_resolution_error_msg
+
+    try:
+        success = manager.delete_task(path, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+
+    if success:
+        click.echo(f"✓ Deleted task: {path}")
+    else:
+        click.echo(f"✗ Task not found: {path}", err=True)
+        sys.exit(1)
+
+
+@main.command()
+@click.option('--subpath', default="", help='Subdirectory to list')
+@click.option('--recursive/--no-recursive', default=True, help='Include subdirectories')
+@click.option('--full', is_flag=True, help='Show full content')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def list(ctx, subpath, recursive, full, project):
+    """List all tasks"""
+    manager = ctx.obj['manager']
+    
+    from .utils import project_resolution_error_msg
+
+    try:
+        tasks = manager.list_tasks(subpath=subpath, recursive=recursive, include_content=full, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+    
+    if not tasks:
+        click.echo("No tasks found.")
+        return
+    
+    click.echo(f"Found {len(tasks)} task(s):\n")
+    for task in tasks:
+        click.echo(f"• {task['path']}")
+        click.echo(f"  {task['title']}")
+        
+        if 'status' in task['metadata']:
+            click.echo(f"  Status: {task['metadata']['status']}")
+        
+        if full and 'content' in task:
+            click.echo(f"  Content: {task['content'][:100]}...")
+        
+        click.echo()
+
+
+@main.command()
+@click.option('--subpath', default="", help='Subdirectory to show structure for')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def tree(ctx, subpath, project):
+    """Show hierarchical structure of tasks"""
+    manager = ctx.obj['manager']
+    
+    from .utils import project_resolution_error_msg
+
+    try:
+        structure = manager.get_structure(subpath, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+    
+    def print_tree(node, prefix="", is_last=True):
+        connector = "└── " if is_last else "├── "
+        click.echo(f"{prefix}{connector}{node['name']}")
+        
+        if node['type'] == 'directory' and 'children' in node:
+            extension = "    " if is_last else "│   "
+            for i, child in enumerate(node['children']):
+                is_last_child = i == len(node['children']) - 1
+                print_tree(child, prefix + extension, is_last_child)
+        elif node['type'] == 'task':
+            if 'title' in node and node['title']:
+                extension = "    " if is_last else "│   "
+                click.echo(f"{prefix}{extension}    {node['title']}")
+    
+    print_tree(structure, "", True)
+
+
+@main.command()
+@click.option('--query', default="", help='Text to search for')
+@click.option('--status', default=None, help='Filter by status')
+@click.option('--priority', default=None, help='Filter by priority')
+@click.option('--tags', multiple=True, help='Filter by tags')
+@click.option('--path-pattern', default="", help='Path pattern to search')
+@click.option('--max-results', default=50, help='Maximum results')
+@click.option('--full', is_flag=True, help='Show full content')
+@click.pass_context
+def search(ctx, query, status, priority, tags, path_pattern, max_results, full):
+    """Search for tasks"""
+    searcher = ctx.obj['searcher']
+    
+    metadata_filters = {}
+    if status:
+        metadata_filters['status'] = status
+    if priority:
+        metadata_filters['priority'] = priority
+    if tags:
+        metadata_filters['tags'] = list(tags)
+    
+    results = searcher.search(
+        query=query,
+        metadata_filters=metadata_filters if metadata_filters else None,
+        path_pattern=path_pattern,
+        max_results=max_results,
+        include_content=full
+    )
+    
+    if not results:
+        click.echo("No tasks found.")
+        return
+    
+    click.echo(f"Found {len(results)} task(s):\n")
+    for result in results:
+        click.echo(f"• {result['path']} (score: {result['score']})")
+        click.echo(f"  {result['title']}")
+        
+        if 'snippet' in result:
+            click.echo(f"  {result['snippet']}")
+        
+        if full and 'content' in result:
+            click.echo(f"\n{result['content']}\n")
+        
+        click.echo()
+
+
+@main.command()
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def tags(ctx, project):
+    """List all tags"""
+    searcher = ctx.obj['searcher']
+    
+    all_tags = searcher.get_all_tags(project=project)
+    
+    if not all_tags:
+        click.echo("No tags found.")
+        return
+    
+    click.echo("Tags:")
+    for tag in sorted(all_tags):
+        click.echo(f"  • {tag}")
+
+
+@main.command()
+@click.argument('old_path')
+@click.argument('new_path')
+@click.option('--project', default=None, help='Project name to scope operation')
+@click.pass_context
+def move(ctx, old_path, new_path, project):
+    """Move/rename a task"""
+    manager = ctx.obj['manager']
+    
+    from .utils import project_resolution_error_msg
+
+    try:
+        success = manager.move_task(old_path, new_path, project=project)
+    except ValueError as e:
+        click.echo(project_resolution_error_msg(e), err=True)
+        sys.exit(2)
+
+    if success:
+        click.echo(f"✓ Moved task from {old_path} to {new_path}")
+    else:
+        click.echo(f"✗ Failed to move task", err=True)
+        sys.exit(1)
+
+
+@main.command(name="mcp-server")
+@click.pass_context
+def mcp_server_cmd(ctx):
+    """Start the MCP server for LLM integration"""
+    from .mcp_server import main as run_mcp
+    
+    # Pass the tasks directory to the MCP server via environment variable
+    os.environ['TASKMASTER_TASKS_DIR'] = ctx.obj['tasks_dir']
+    
+    run_mcp()
+
+
+if __name__ == '__main__':
+    main()