flownav 0.2.0 → 0.2.1

package/README.md

@@ -185,12 +185,15 @@ Tool replies are written for an agent to act on. If a name matches several nodes
 $ flownav explain order
 error: "order" matches 5 nodes. Do not guess: ask the user which one they mean. Then use the workflow:node form.
   1. Order intake › Order Webhook  [webhook]  use: wf-orders:Order Webhook
+       Webhook POST /orders (responseNode) · group "Intake" · starts the workflow
   2. Order intake › Is Large Order  [if]  use: wf-orders:Is Large Order
+       IF 1 condition(s) · group "Intake" · after: Normalize
   3. Order intake › Save Order  [googleSheets]  use: wf-orders:Save Order
+       googleSheets: append · group "Intake" · after: Is Large Order
   ...
 ```
 
-If a partial name matches exactly one node, it resolves but the reply starts with a `NOTE:` asking the agent to confirm with the user before changing anything. To search a family of workflows, use `flownav find --match "<part of workflow name>" --name "<part of node name>"` (`--name` searches node names only; `--text` also searches parameters and code). The installed skill tells the agent to stop and ask in these cases. How reliably an agent follows that depends on the agent.
+Each candidate carries one line of context (what the node does, its sticky-note group, and what feeds it or what it plugs into), so the agent can ask a specific question instead of "which one?". Workflow candidates show their trigger types and whether they are active. If a partial name matches exactly one node, it resolves but the reply starts with a `NOTE:` asking the agent to confirm with the user before changing anything. To search a family of workflows, use `flownav find --match "<part of workflow name>" --name "<part of node name>"` (`--name` searches node names only; `--text` also searches parameters and code). The installed skill tells the agent to stop and ask in these cases. How reliably an agent follows that depends on the agent.
 
 ## Reading code in small pieces
 

package/dist/graph.js

@@ -66,7 +66,14 @@ export class G {
         const hits = exact.length ? exact : part;
         if (!hits.length)
             throw new Error(`No workflow matches "${q}". Run flownav_scan to list workflows.`);
-        const rows = hits.slice(0, 10).map((w, i) => `  ${i + 1}. ${w.name}  [id ${w.id}, ${w.nodeCount} nodes]`);
+        const rows = hits.slice(0, 10).flatMap((w, i) => {
+            const trig = [...new Set(this.nodesOf(w.id).filter((n) => n.trigger).map((n) => shortType(n.type)))];
+            const state = w.active === undefined ? '' : w.active ? ', active' : ', inactive';
+            return [
+                `  ${i + 1}. ${w.name}  [id ${w.id}, ${w.nodeCount} nodes${state}]`,
+                `       ${trig.length ? `started by: ${trig.slice(0, 4).join(', ')}` : 'no trigger of its own'}${w.errorWorkflow ? ' · has an error workflow' : ''}`,
+            ];
+        });
         if (hits.length > 10)
             rows.push(`  ... and ${hits.length - 10} more`);
         throw new Error([`"${q}" matches ${hits.length} workflows. ${ASK} Then use its id.`, ...rows,
@@ -76,8 +83,32 @@ export class G {
     resolveNode(q) {
         return this.resolveNodeEx(q).node;
     }
+    /** One line of context so the agent can tell candidates apart and ask a sharper question. */
+    contextLine(n) {
+        const bits = [n.summary];
+        if (n.group)
+            bits.push(`group "${n.group}"`);
+        if (n.disabled)
+            bits.push('disabled');
+        const names = (ids) => [...new Set(ids.map((id) => this.nodeById.get(id)?.name ?? id))];
+        const from = names(this.inE(n.id, ['main', 'capability']).map((e) => e.from));
+        const into = names(this.outE(n.id, ['capability']).map((e) => e.to));
+        if (n.trigger)
+            bits.push('starts the workflow');
+        else if (from.length)
+            bits.push(`after: ${from.slice(0, 2).join(', ')}${from.length > 2 ? ` (+${from.length - 2})` : ''}`);
+        else if (into.length)
+            bits.push(`plugs into: ${into.slice(0, 2).join(', ')}`);
+        else
+            bits.push('not connected to anything');
+        const line = bits.join(' · ');
+        return line.length > 150 ? `${line.slice(0, 149)}…` : line;
+    }
     ambiguousNodes(q, hits) {
-        const rows = hits.slice(0, 10).map((n, i) => `  ${i + 1}. ${this.g.workflows[n.wf]?.name ?? n.wf} › ${n.name}  [${shortType(n.type)}]  use: ${n.wf}:${n.name}`);
+        const rows = hits.slice(0, 10).flatMap((n, i) => [
+            `  ${i + 1}. ${this.g.workflows[n.wf]?.name ?? n.wf} › ${n.name}  [${shortType(n.type)}]  use: ${n.wf}:${n.name}`,
+            `       ${this.contextLine(n)}`,
+        ]);
         if (hits.length > 10)
             rows.push(`  ... and ${hits.length - 10} more`);
         return [`"${q}" matches ${hits.length} nodes. ${ASK} Then use the workflow:node form.`, ...rows].join('\n');

package/dist/viewer.js

@@ -126,10 +126,11 @@ aside li button{width:100%;text-align:left;margin:2px 0;border-radius:6px;overfl
 <script>
 (function () {
   var D = JSON.parse(document.getElementById('data').textContent);
-  var NS = 'http://www.w3.org/2000/svg';
+  var svg = document.getElementById('svg'), vp = document.getElementById('vp'), panel = document.getElementById('panel');
+  // The page's own <svg> element already carries the SVG namespace; reuse it for new elements.
+  var NS = svg.namespaceURI;
   var NW = 176, NH = 38, COLW = 250, ROWH = 62, PAD = 36, HEAD = 34, GAP = 50;
   var LAYER = { main: 1, capability: 1, calls: 1, on_error: 1, webhook_calls: 1 };
-  var svg = document.getElementById('svg'), vp = document.getElementById('vp'), panel = document.getElementById('panel');
 
   function el(tag, attrs, parent, text) {
     var e = document.createElementNS(NS, tag);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flownav",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "See what references an n8n node before you rename it. A typed graph of your workflows with a CLI and an MCP server, so AI agents read a few lines instead of the whole workflow JSON.",
   "author": "Omer Turkenits",
   "license": "MIT",