task-graph-mcp 0.5.0

MCP server for agent task workflows with phases, prompts, gates, and multi-agent coordination
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! CLI command definitions for task-graph-mcp
//!
//! This module defines the CLI structure using clap's derive macros.
//! The main entry point is the `Cli` struct which contains subcommands.

pub mod agent;
pub mod diff;
pub mod export;
pub mod import;
pub mod migrate;

use agent::AgentArgs;
use clap::{Parser, Subcommand, ValueEnum};
use diff::DiffArgs;
use export::ExportArgs;
use import::ImportArgs;
use migrate::MigrateArgs;

/// UI mode for the server.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, ValueEnum)]
pub enum UiMode {
    /// No UI, MCP server only (default)
    #[default]
    None,
    /// Enable web dashboard UI
    Web,
}

/// Default port for the web dashboard.
pub const DEFAULT_UI_PORT: u16 = 31994;

/// Task Graph MCP Server and CLI tools
#[derive(Parser, Debug)]
#[command(author, version, about, long_about = None)]
pub struct Cli {
    /// Path to configuration file
    #[arg(short, long, global = true)]
    pub config: Option<String>,

    /// Path to database file (overrides config)
    #[arg(short, long, global = true)]
    pub database: Option<String>,

    /// Path to media directory (overrides config)
    #[arg(short, long, global = true)]
    pub media_dir: Option<String>,

    /// Path to log directory (overrides config)
    #[arg(long, global = true)]
    pub log_dir: Option<String>,

    /// Enable verbose logging
    #[arg(short, long, global = true)]
    pub verbose: bool,

    /// Logging output: 0/off, 1/stdout, 2/stderr (default), or filename
    #[arg(short, long, default_value = "2", global = true)]
    pub log: String,

    /// UI mode: none (MCP only) or web (enable dashboard)
    #[arg(long, value_enum, global = true)]
    pub ui: Option<UiMode>,

    /// Port for the web dashboard (default: 31994)
    #[arg(long, global = true)]
    pub ui_port: Option<u16>,

    /// Start MCP server on stdio (required when no subcommand is given).
    /// This flag is required to explicitly start the MCP server, preventing
    /// accidental invocation that would block waiting for MCP input.
    #[arg(long)]
    pub stdio: bool,

    #[command(subcommand)]
    pub command: Option<Command>,
}

/// Available subcommands
#[derive(Subcommand, Debug)]
pub enum Command {
    /// Start the MCP server (default if no subcommand given)
    Serve,

    /// Export task database to structured JSON format
    Export(ExportArgs),

    /// Import task data from a structured JSON export file
    Import(ImportArgs),

    /// Compare snapshot files or snapshot against database
    Diff(DiffArgs),

    /// Migrate from deprecated .task-graph/ to task-graph/ directory
    Migrate(MigrateArgs),

    /// Agent commands for background workers without MCP access
    Agent(AgentArgs),
}