kiroo 0.3.4 → 0.4.0

package/bin/kiroo.js

@@ -6,7 +6,7 @@ import { executeRequest } from '../src/executor.js';
 import { listInteractions, replayInteraction } from '../src/replay.js';
 import { saveSnapshot, compareSnapshots, listSnapshots } from '../src/snapshot.js';
 import { setEnv, setVar, deleteVar, listEnv } from '../src/env.js';
-// import { showGraph } from '../src/graph.js';
+import { showGraph } from '../src/graph.js';
 import { initProject } from '../src/init.js';
 import { showStats } from '../src/stats.js';
 import { handleImport } from '../src/import.js';
@@ -17,7 +17,7 @@ const program = new Command();
 program
   .name('kiroo')
   .description('Git for API interactions. Record, replay, snapshot, and diff your APIs.')
-  .version('0.3.4');
+  .version('0.4.0');
 
 // Init command
 program
@@ -129,6 +129,14 @@ snapshot
     await compareSnapshots(tag1, tag2);
   });
 
+// Graph command
+program
+  .command('graph')
+  .description('Show visual dependency graph of API interactions')
+  .action(async () => {
+    await showGraph();
+  });
+
 // Import command
 program
   .command('import')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiroo",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "Git for API interactions. Record, replay, snapshot, and diff your APIs.",
   "type": "module",
   "bin": {

package/src/executor.js

@@ -4,16 +4,20 @@ import ora from 'ora';
 import { saveInteraction, loadEnv, saveEnv } from './storage.js';
 import { formatResponse } from './formatter.js';
 
-function applyEnvReplacements(data, envVars) {
+function applyEnvReplacements(data, envVars, usedKeys = null) {
   if (typeof data === 'string') {
     return data.replace(/\{\{(.+?)\}\}/g, (match, key) => {
-      return envVars[key] !== undefined ? envVars[key] : match;
+      if (envVars[key] !== undefined) {
+        if (usedKeys) usedKeys.add(key);
+        return envVars[key];
+      }
+      return match;
     });
   }
   if (typeof data === 'object' && data !== null) {
     const newData = Array.isArray(data) ? [] : {};
     for (const key in data) {
-      newData[key] = applyEnvReplacements(data[key], envVars);
+      newData[key] = applyEnvReplacements(data[key], envVars, usedKeys);
     }
     return newData;
   }
@@ -52,8 +56,11 @@ export async function executeRequest(method, url, options = {}) {
   const env = loadEnv();
   const currentEnvVars = env.environments[env.current] || {};
 
+  const usedKeys = new Set();
+  const savedKeys = [];
+
   // Apply replacements to URL
-  url = applyEnvReplacements(url, currentEnvVars);
+  url = applyEnvReplacements(url, currentEnvVars, usedKeys);
 
   // Auto-BaseURL logic
   if (currentEnvVars.baseUrl) {
@@ -103,7 +110,7 @@ export async function executeRequest(method, url, options = {}) {
     options.header.forEach(h => {
       const [key, ...valueParts] = h.split(':');
       const headerValue = valueParts.join(':').trim();
-      headers[key.trim()] = applyEnvReplacements(headerValue, currentEnvVars);
+      headers[key.trim()] = applyEnvReplacements(headerValue, currentEnvVars, usedKeys);
     });
   }
 
@@ -112,7 +119,7 @@ export async function executeRequest(method, url, options = {}) {
   if (options.data) {
     let rawData = options.data;
     // Apply replacements to raw data string before parsing
-    rawData = applyEnvReplacements(rawData, currentEnvVars);
+    rawData = applyEnvReplacements(rawData, currentEnvVars, usedKeys);
 
     try {
       body = JSON.parse(rawData);
@@ -175,6 +182,7 @@ export async function executeRequest(method, url, options = {}) {
           const val = getDeep(response, responsePath);
           if (val !== undefined) {
             env.environments[env.current][envKey] = val;
+            savedKeys.push(envKey);
             console.log(chalk.cyan(`  ✨ Saved to env:`), chalk.white(`${envKey}=${val}`));
           } else {
             console.log(chalk.yellow(`  ⚠️  Could not find path '${responsePath}' in response`));
@@ -197,6 +205,8 @@ export async function executeRequest(method, url, options = {}) {
         data: response.data,
       },
       duration,
+      saves: savedKeys,
+      uses: Array.from(usedKeys)
     });
 
     console.log(chalk.gray('\n  💾 Interaction saved:'), chalk.white(interactionId));

package/src/graph.js

@@ -0,0 +1,75 @@
+import chalk from 'chalk';
+import { getAllInteractions } from './storage.js';
+
+export async function showGraph() {
+  const interactions = getAllInteractions().reverse(); // Chronological order
+
+  if (interactions.length === 0) {
+    console.log(chalk.yellow('\n  No interactions recorded yet.'));
+    console.log(chalk.gray('  Run some requests to see the dependency graph!\n'));
+    return;
+  }
+
+  // 1. Map: Variable -> Provider Interaction (Method + Path)
+  const variableProviders = {};
+  
+  // 2. Interaction nodes with their connections
+  const nodes = [];
+
+  const getPath = (urlStr) => {
+    try {
+      const urlObj = new URL(urlStr);
+      return urlObj.pathname;
+    } catch (e) {
+      return urlStr.startsWith('http') ? urlStr : (urlStr.startsWith('/') ? urlStr : '/' + urlStr);
+    }
+  };
+
+  interactions.forEach(int => {
+    const path = getPath(int.request.url);
+    const method = int.request.method;
+    const saves = int.metadata.saves || [];
+    const uses = int.metadata.uses || [];
+
+    // Track which variables this interaction provides
+    saves.forEach(v => {
+      variableProviders[v] = { method, path };
+    });
+
+    nodes.push({ method, path, saves, uses });
+  });
+
+  console.log(chalk.cyan('\n  🕸️  API Dependency Graph:'));
+  console.log(chalk.gray('  (Shows how data flows between endpoints)\n'));
+
+  // Simple visualization
+  const seenPaths = new Set();
+  
+  nodes.forEach((node, idx) => {
+    const nodeLabel = `${chalk.white(node.method)} ${chalk.gray(node.path)}`;
+    
+    // Find dependencies based on 'uses'
+    const dependencies = node.uses.map(v => {
+      const provider = variableProviders[v];
+      return provider ? `[${v}] from ${provider.method} ${provider.path}` : null;
+    }).filter(Boolean);
+
+    // Render the node
+    if (dependencies.length > 0) {
+      console.log(`  ${chalk.blue('⬇')} ${nodeLabel}`);
+      dependencies.forEach((dep, depIdx) => {
+        const branchToken = depIdx === dependencies.length - 1 ? '└─' : '├─';
+        console.log(`     ${chalk.gray(branchToken)} ${chalk.yellow('uses')} ${dep}`);
+      });
+    } else {
+      console.log(`  ${chalk.green('○')} ${nodeLabel}`);
+    }
+
+    if (node.saves.length > 0) {
+      const saveToken = node.uses.length > 0 ? '     │' : '     ';
+      console.log(`${saveToken}  ${chalk.magenta('↳')} ${chalk.gray('saves')} ${chalk.white(node.saves.join(', '))}`);
+    }
+    
+    console.log('');
+  });
+}

package/src/snapshot.js

@@ -59,15 +59,27 @@ export async function compareSnapshots(tag1, tag2) {
     const results = [];
     let breakingChanges = 0;
     
-    // Simplistic comparison: match by URL and Method
+    // Helper to get path from URL string
+    const getPath = (urlStr) => {
+      try {
+        const urlObj = new URL(urlStr);
+        return urlObj.pathname;
+      } catch (e) {
+        // If it's already a path or invalid full URL, return as is
+        return urlStr.startsWith('http') ? urlStr : (urlStr.startsWith('/') ? urlStr : '/' + urlStr);
+      }
+    };
+
+    // Domain-agnostic comparison: match by Path and Method
     s2.interactions.forEach(int2 => {
-      const int1 = s1.interactions.find(i => i.url === int2.url && i.method === int2.method);
+      const path2 = getPath(int2.url);
+      const int1 = s1.interactions.find(i => getPath(i.url) === path2 && i.method === int2.method);
       
       if (!int1) {
         results.push({
           type: 'NEW',
           method: int2.method,
-          url: int2.url,
+          url: path2,
           msg: chalk.blue('New interaction added')
         });
         return;
@@ -97,7 +109,7 @@ export async function compareSnapshots(tag1, tag2) {
         results.push({
           type: 'CHANGE',
           method: int2.method,
-          url: int2.url,
+          url: path2,
           msg: diffs.join('\n    ')
         });
       }

package/src/storage.js

@@ -39,6 +39,8 @@ export async function saveInteraction(interaction) {
     response: interaction.response,
     metadata: {
       duration_ms: interaction.duration,
+      saves: interaction.saves || [], // Variables saved from this response
+      uses: interaction.uses || [],   // Variables used in this request
     },
   };