feat(scheduler): add manual trigger capability and fix docs parity

- Add 'trigger' tool to Scheduler MCP and 'ncp schedule trigger' CLI command
- Implement 'runTaskNow' in Scheduler service for immediate execution
- Fix documentation discrepancies in README and guides:
  - Correct schedule:add -> schedule:create in workflow guide
  - Add Analytics MCP to README
  - Correct MCP Management tool names in README
  - Replace deprecated 'ncp status' with 'ncp doctor' in advanced guide

Author: Arul-

README.md

@@ -440,7 +440,7 @@ Install and configure MCPs dynamically through natural language.
 ```bash
 # AI can discover and install MCPs for you
 ncp find "install mcp"
-# Shows: mcp:install, mcp:search, mcp:configure
+# Shows: mcp:add, mcp:remove, mcp:list
 ```
 
 **Features:**
@@ -480,6 +480,20 @@ const template = await skills.read_resource({
 
 **[→ Full Skills Guide](./SKILLS.md)**
 
+### **Analytics MCP** - Visualize Usage & Performance
+View usage statistics, token savings, and performance metrics directly in your chat.
+
+```bash
+# View usage overview with ASCII charts
+ncp run analytics:overview --params '{"period": 7}'
+```
+
+**Features:**
+- ✅ Usage trends and most used tools
+- ✅ Token savings analysis (Code-Mode efficiency)
+- ✅ Performance metrics (response times, error rates)
+- ✅ ASCII-formatted charts for AI consumption
+
 **Configuration:**
 Internal MCPs are disabled by default. Enable in your profile settings:
 
@@ -488,7 +502,8 @@ Internal MCPs are disabled by default. Enable in your profile settings:
   "settings": {
     "enable_schedule_mcp": true,
     "enable_mcp_management": true,
-    "enable_skills": true
+    "enable_skills": true,
+    "enable_analytics_mcp": true
   }
 }
 ```

docs/ADVANCED_USAGE_GUIDE.md

@@ -152,7 +152,7 @@ Debug logs include:
 
 ```bash
 # Check MCP health
-ncp status --detailed
+ncp doctor
 
 # Verify configuration
 ncp config location  # Check where configs are stored
@@ -171,7 +171,7 @@ ncp find "operation description"
 ncp list | grep "mcp-name"
 
 # Verify MCP is loaded
-ncp status
+ncp doctor
 ```
 
 **Symptom: "Command execution timeout"**
@@ -485,6 +485,6 @@ Typical performance metrics on a modern system:
 ## Getting Help
 
 - Check debug logs: `ncp config debugLogging true`
-- Review MCP status: `ncp status --detailed`
+- Review MCP status: ncp doctor
 - Consult test-drive guide: `ncp resources read ncp:test-drive`
 - Review docs: `ncp resources read ncp:help/getting-started`

docs/workflow-mcp-guide.md

@@ -485,21 +485,24 @@ Returns:
 
 ```bash
 # Schedule daily standup for weekdays at 9am
-ncp run schedule:add \
+ncp run schedule:create \
   name="daily-standup" \
-  command="ncp run workflow:execute workflowName=daily-standup context='{\"slackWebhook\":\"https://hooks.slack.com/...\",\"repo\":\"owner/repo\"}'" \
+  tool="workflow:execute" \
+  parameters='{"workflowName":"daily-standup", "context": {"slackWebhook":"https://hooks.slack.com/...", "repo":"owner/repo"}}' \
   schedule="0 9 * * 1-5"
 
 # Schedule content pipeline daily at midnight
-ncp run schedule:add \
+ncp run schedule:create \
   name="content-pipeline" \
-  command="ncp run workflow:execute workflowName=content-pipeline context='{\"sourceUrl\":\"https://...\",\"recipient\":\"team@company.com\"}'" \
+  tool="workflow:execute" \
+  parameters='{"workflowName":"content-pipeline", "context": {"sourceUrl":"https://...", "recipient":"user@example.com"}}' \
   schedule="0 0 * * *"
 
 # Schedule data sync daily at 2am
-ncp run schedule:add \
+ncp run schedule:create \
   name="data-sync" \
-  command="ncp run workflow:execute workflowName=data-sync context='{\"dbPath\":\"./data.db\",\"s3Bucket\":\"backups\",\"slackWebhook\":\"...\"}'" \
+  tool="workflow:execute" \
+  parameters='{"workflowName":"data-sync", "context": {"dbPath":"./data.db", "s3Bucket":"backups", "slackWebhook":"..."}}' \
   schedule="0 2 * * *"
 ```
 
@@ -535,44 +538,49 @@ ncp run workflow:execute \
   context='{"slackWebhook":"https://hooks.slack.com/services/T00/B00/XXX","repo":"anthropics/claude-code"}'
 
 # 2. If successful, schedule it
-ncp run schedule:add \
+ncp run schedule:create \
   name="team-standup" \
-  command="ncp run workflow:execute workflowName=daily-standup context='{\"slackWebhook\":\"https://hooks.slack.com/services/T00/B00/XXX\",\"repo\":\"anthropics/claude-code\"}'" \
+  tool="workflow:execute" \
+  parameters='{"workflowName":"daily-standup", "context": {"slackWebhook":"https://hooks.slack.com/services/T00/B00/XXX", "repo":"anthropics/claude-code"}}' \
   schedule="0 9 * * 1-5" \
   description="Daily standup summary posted to Slack"
 
 # 3. Verify it's scheduled
 ncp run schedule:list
 
 # 4. Remove if needed
-ncp run schedule:remove name="team-standup"
+ncp run schedule:delete job_id="team-standup"
 ```
 
 ### Advanced: Multiple Workflows on Different Schedules
 
 ```bash
 # Morning standup
-ncp run schedule:add \
+ncp run schedule:create \
   name="morning-standup" \
-  command="ncp run workflow:execute workflowName=daily-standup context='...'" \
+  tool="workflow:execute" \
+  parameters='{"workflowName":"daily-standup", "context": "..."}' \
   schedule="0 9 * * 1-5"
 
 # Hourly content check
-ncp run schedule:add \
+ncp run schedule:create \
   name="hourly-content-monitor" \
-  command="ncp run workflow:execute-task task='Check website for changes and alert if needed' context='...'" \
+  tool="workflow:execute-task" \
+  parameters='{"task": "Check website for changes and alert if needed", "context": "..."}' \
   schedule="0 * * * *"
 
 # Nightly backup
-ncp run schedule:add \
+ncp run schedule:create \
   name="nightly-backup" \
-  command="ncp run workflow:execute workflowName=data-sync context='...'" \
+  tool="workflow:execute" \
+  parameters='{"workflowName":"data-sync", "context": "..."}' \
   schedule="0 2 * * *"
 
 # Weekly report
-ncp run schedule:add \
+ncp run schedule:create \
   name="weekly-report" \
-  command="ncp run workflow:execute-custom workflow='...'" \
+  tool="workflow:execute-custom" \
+  parameters='{"workflow": "..."}' \
   schedule="0 9 * * 1"
 ```
 

src/cli/index.ts

@@ -2908,6 +2908,54 @@ scheduleCmd
     }
   });
 
+// schedule trigger
+scheduleCmd
+  .command('trigger <job-id>')
+  .description('Trigger a scheduled job immediately (manual run)')
+  .action(async (jobId) => {
+    try {
+      const { Scheduler } = await import('../services/scheduler/scheduler.js');
+      const scheduler = new Scheduler();
+
+      let job = scheduler.getTask(jobId);
+      if (!job) {
+        job = scheduler.getTaskByName(jobId);
+        if (job) jobId = job.id;
+      }
+
+      if (!job) {
+        console.error(chalk.red(`❌ Job not found: ${jobId}`));
+        process.exit(1);
+      }
+
+      console.log(chalk.blue(`🚀 Triggering job: ${job.name}...`));
+      
+      const result = await scheduler.runTaskNow(jobId);
+      
+      const statusIcon = result.status === 'success' ? chalk.green('✅') : chalk.red('❌');
+      const duration = result.duration ? `${result.duration}ms` : 'N/A';
+      
+      console.log(`${statusIcon} Manual execution completed`);
+      console.log(`  ${chalk.dim('ID:')} ${result.executionId}`);
+      console.log(`  ${chalk.dim('Status:')} ${result.status}`);
+      console.log(`  ${chalk.dim('Duration:')} ${duration}`);
+      
+      if (result.result) {
+        console.log(chalk.bold('\nResult:'));
+        console.log(result.result);
+      }
+      
+      if (result.error) {
+        console.log(chalk.bold('\nError:'));
+        console.log(chalk.red(result.error));
+      }
+      
+    } catch (error) {
+      console.error(chalk.red('❌ Trigger failed:'), error);
+      process.exit(1);
+    }
+  });
+
 // schedule cleanup
 scheduleCmd
   .command('cleanup')

src/internal-mcps/scheduler.ts

@@ -320,6 +320,20 @@ export class SchedulerMCP implements InternalMCP {
           }
         }
       }
+    },
+    {
+      name: 'trigger',
+      description: 'Trigger an immediate execution of a scheduled job (manual run).',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          job_id: {
+            type: 'string',
+            description: 'Job ID or name'
+          }
+        },
+        required: ['job_id']
+      }
     }
   ];
 
@@ -360,14 +374,16 @@ export class SchedulerMCP implements InternalMCP {
           return await this.handleResume(args);
         case 'executions':
           return await this.handleExecutions(args);
+        case 'trigger':
+          return await this.handleTrigger(args);
 
         default:
           return {
             success: false,
-            error: `Unknown schedule tool: ${toolName}. Available: validate, create, list, get, retrieve, pause, resume, cancel, executions`,
+            error: `Unknown schedule tool: ${toolName}. Available: validate, create, list, get, retrieve, pause, resume, cancel, executions, trigger`,
             content: [{
               type: 'text',
-              text: `❌ Unknown schedule tool: ${toolName}\n\n📋 Available tools: validate, create, list, get, retrieve, pause, resume, cancel, executions`
+              text: `❌ Unknown schedule tool: ${toolName}\n\n📋 Available tools: validate, create, list, get, retrieve, pause, resume, cancel, executions, trigger`
             }]
           };
       }
@@ -990,4 +1006,76 @@ export class SchedulerMCP implements InternalMCP {
       limit: args?.limit || 50
     });
   }
+
+  /**
+   * Trigger immediate execution of a job
+   */
+  private async handleTrigger(args: any): Promise<InternalToolResult> {
+    if (!args?.job_id) {
+      return {
+        success: false,
+        error: 'job_id parameter is required',
+        content: [{
+          type: 'text',
+          text: '❌ job_id parameter is required'
+        }]
+      };
+    }
+
+    let jobId = args.job_id;
+    let job = this.scheduler.getJob(jobId);
+    if (!job) {
+      job = this.scheduler.getJobByName(jobId);
+      if (job) jobId = job.id;
+    }
+
+    if (!job) {
+      return {
+        success: false,
+        error: `Job not found: ${args.job_id}`,
+        content: [{
+          type: 'text',
+          text: `❌ Job not found: ${args.job_id}`
+        }]
+      };
+    }
+
+    try {
+      const result = await this.scheduler.runTaskNow(jobId);
+      
+      const statusIcon = result.status === 'success' ? '✅' : '❌';
+      const duration = result.duration ? `${result.duration}ms` : 'N/A';
+      
+      let message = `${statusIcon} Manual execution completed: ${job.name}\n\n` +
+                    `  ID: ${result.executionId}\n` +
+                    `  Status: ${result.status}\n` +
+                    `  Duration: ${duration}\n`;
+      
+      if (result.result) {
+        message += `\n📤 Result:\n${result.result}`;
+      }
+      
+      if (result.error) {
+        message += `\n❌ Error:\n${result.error}`;
+      }
+
+      return {
+        success: result.status === 'success',
+        content: [{
+          type: 'text',
+          text: message
+        }]
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        success: false,
+        error: errorMessage,
+        content: [{
+          type: 'text',
+          text: `❌ Trigger failed: ${errorMessage}`
+        }]
+      };
+    }
+  }
 }

src/services/scheduler/scheduler.ts

@@ -505,6 +505,24 @@ export class Scheduler {
     logger.info(`[Scheduler] Task deleted: ${task.name} (${taskId})`);
   }
 
+  /**
+   * Run a task immediately (manual trigger)
+   */
+  async runTaskNow(taskId: string): Promise<any> {
+    if (!this.scheduleManager) {
+      throw new Error('Scheduler not available on this platform');
+    }
+
+    const task = this.taskManager.getTask(taskId);
+    if (!task) {
+      throw new Error(`Task ${taskId} not found`);
+    }
+
+    logger.info(`[Scheduler] Manually triggering task: ${task.name} (${taskId})`);
+    
+    return this.timingExecutor.executeSingleTask(taskId);
+  }
+
   /**
    * Get executions for a task
    */

src/services/scheduler/timing-executor.ts

@@ -43,6 +43,22 @@ export class TimingExecutor {
     this.executionRecorder = new ExecutionRecorder();
   }
 
+  /**
+   * Execute a single task immediately
+   */
+  async executeSingleTask(taskId: string, timeout?: number): Promise<TaskExecutionResult> {
+    const task = this.taskManager.getTask(taskId);
+    
+    if (!task) {
+      throw new Error(`Task ${taskId} not found`);
+    }
+
+    logger.info(`[TimingExecutor] Executing single task: ${task.name} (${task.id})`);
+    
+    // Execute in child process for isolation
+    return this.executeTaskInChildProcess(task, timeout);
+  }
+
   /**
    * Execute all active tasks for a timing group in parallel
    */