@leclabs/agent-flow-navigator-mcp 1.0.0 → 1.1.0

package/README.md

@@ -60,34 +60,34 @@ Navigator returns: Step 2 of 8 - "Implement changes"
 
 ## MCP Tools Reference
 
-| Tool | Description |
-| ---- | ----------- |
-| `Navigate` | Start a workflow, get current state, or advance to next step |
-| `Diagram` | Generate a mermaid flowchart for a workflow |
-| `ListWorkflows` | List all available workflows |
-| `SelectWorkflow` | Get workflow selection dialog for user interaction |
-| `CopyWorkflows` | Copy workflows from catalog to project |
-| `ListCatalog` | List workflows available in the catalog |
+| Tool             | Description                                                  |
+| ---------------- | ------------------------------------------------------------ |
+| `Navigate`       | Start a workflow, get current state, or advance to next step |
+| `Diagram`        | Generate a mermaid flowchart for a workflow                  |
+| `ListWorkflows`  | List all available workflows                                 |
+| `SelectWorkflow` | Get workflow selection dialog for user interaction           |
+| `CopyWorkflows`  | Copy workflows from catalog to project                       |
+| `ListCatalog`    | List workflows available in the catalog                      |
 
 ### Navigate
 
 The primary tool for workflow navigation.
 
-| Parameter | Type | Description |
-| --------- | ---- | ----------- |
-| `workflowType` | string | Workflow ID (for start only, e.g., "feature-development") |
-| `description` | string | User's task description (for start) |
-| `taskFilePath` | string | Path to task file (for advance/current) |
-| `result` | "passed" \| "failed" | Step result (for advance) |
+| Parameter      | Type                 | Description                                               |
+| -------------- | -------------------- | --------------------------------------------------------- |
+| `workflowType` | string               | Workflow ID (for start only, e.g., "feature-development") |
+| `description`  | string               | User's task description (for start)                       |
+| `taskFilePath` | string               | Path to task file (for advance/current)                   |
+| `result`       | "passed" \| "failed" | Step result (for advance)                                 |
 
 ### Diagram
 
 Generates a mermaid diagram for visualizing workflow structure.
 
-| Parameter | Type | Description |
-| --------- | ---- | ----------- |
+| Parameter      | Type   | Description                         |
+| -------------- | ------ | ----------------------------------- |
 | `workflowType` | string | Workflow ID to visualize (required) |
-| `currentStep` | string | Optional step to highlight |
+| `currentStep`  | string | Optional step to highlight          |
 
 ## Architecture Overview
 

package/index.js

@@ -64,7 +64,7 @@ function loadProjectWorkflows(dirPath) {
     try {
       const content = JSON.parse(readFileSync(workflowFile, "utf-8"));
       if (validateWorkflow(id, content)) {
-        store.loadDefinition(id, content);
+        store.loadDefinition(id, content, "project");
         loaded.push(id);
       }
     } catch (e) {
@@ -90,7 +90,7 @@ function loadCatalogWorkflows(dirPath) {
     try {
       const content = JSON.parse(readFileSync(join(dirPath, file), "utf-8"));
       if (validateWorkflow(id, content)) {
-        store.loadDefinition(id, content);
+        store.loadDefinition(id, content, "catalog");
         loaded.push(id);
       }
     } catch (e) {
@@ -157,10 +157,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "ListWorkflows",
-        description: "List all available workflows. Returns data only, no dialog.",
+        description: "List available workflows. Filters by source when project workflows exist.",
         inputSchema: {
           type: "object",
-          properties: {},
+          properties: {
+            source: {
+              type: "string",
+              enum: ["all", "project", "catalog"],
+              description: "Filter by source. Default: 'project' if project workflows exist, else 'all'.",
+            },
+          },
         },
       },
       {
@@ -228,9 +234,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       case "ListWorkflows": {
+        // Default to project-only if project workflows exist
+        const hasProject = store.hasProjectWorkflows();
+        const filter = args.source || (hasProject ? "project" : "all");
+        const workflows = store.listWorkflows(filter);
         return jsonResponse({
           schemaVersion: 2,
-          workflows: store.listWorkflows(),
+          workflows,
+          filter,
+          hasProjectWorkflows: hasProject,
+          hint:
+            hasProject && filter === "project"
+              ? "Showing project workflows. Use source='all' to include catalog."
+              : undefined,
         });
       }
 
@@ -245,6 +261,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           throw new Error(`Workflow '${args.workflowType}' not found`);
         }
 
+        const source = store.getSource(args.workflowType);
         const markdown = generateDiagram(wfDef, args.currentStep);
 
         // Save diagram to file
@@ -254,7 +271,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const filePath = join(DIAGRAMS_PATH, `${args.workflowType}.md`);
         writeFileSync(filePath, markdown);
 
-        return jsonResponse({ savedTo: filePath });
+        return jsonResponse({ savedTo: filePath, source });
       }
 
       case "CopyWorkflows": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leclabs/agent-flow-navigator-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server that navigates agents through DAG-based workflows",
   "license": "MIT",
   "author": "leclabs",

package/store.js

@@ -29,16 +29,19 @@ export function validateWorkflow(id, content) {
 export class WorkflowStore {
   constructor() {
     this.workflows = new Map();
+    this.sources = new Map(); // Track source: "catalog" | "project"
   }
 
   /**
    * Load a workflow definition into the store
    * @param {string} id - Workflow identifier
    * @param {Object} workflow - Workflow definition
+   * @param {string} source - Source: "catalog" | "project"
    * @returns {string} The workflow id
    */
-  loadDefinition(id, workflow) {
+  loadDefinition(id, workflow, source = "catalog") {
     this.workflows.set(id, workflow);
+    this.sources.set(id, source);
     return id;
   }
 
@@ -53,15 +56,43 @@ export class WorkflowStore {
 
   /**
    * List all loaded workflows with metadata
+   * @param {string} filter - Filter by source: "all" | "project" | "catalog"
    * @returns {Array} Array of workflow summaries
    */
-  listWorkflows() {
-    return Array.from(this.workflows.entries()).map(([id, wf]) => ({
-      id,
-      name: wf.name || id,
-      description: wf.description || "",
-      stepCount: Object.keys(wf.nodes || {}).length,
-    }));
+  listWorkflows(filter = "all") {
+    const results = [];
+    for (const [id, wf] of this.workflows.entries()) {
+      const source = this.sources.get(id) || "catalog";
+      if (filter !== "all" && source !== filter) continue;
+      results.push({
+        id,
+        name: wf.name || id,
+        description: wf.description || "",
+        stepCount: Object.keys(wf.nodes || {}).length,
+        source,
+      });
+    }
+    return results;
+  }
+
+  /**
+   * Check if any project workflows exist
+   * @returns {boolean}
+   */
+  hasProjectWorkflows() {
+    for (const source of this.sources.values()) {
+      if (source === "project") return true;
+    }
+    return false;
+  }
+
+  /**
+   * Get the source of a workflow
+   * @param {string} id - Workflow identifier
+   * @returns {string|undefined} Source or undefined
+   */
+  getSource(id) {
+    return this.sources.get(id);
   }
 
   /**
@@ -78,6 +109,7 @@ export class WorkflowStore {
    */
   clear() {
     this.workflows.clear();
+    this.sources.clear();
   }
 
   /**