@saptools/service-flow 0.1.45 → 0.1.46

package/dist/cli.js

@@ -3,6 +3,7 @@ import {
   classifyODataPathIntent,
   containsSupportedOutboundCall,
   discoverRepositories,
+  implementationHintSuggestions,
   linkWorkspace,
   normalizeODataOperationInvocationPath,
   normalizePath,
@@ -14,7 +15,7 @@ import {
   parsePackageJson,
   parseServiceBindings,
   trace
-} from "./chunk-BXSCE5CR.js";
+} from "./chunk-EGY2A4AT.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -210,7 +211,7 @@ function migrate(db) {
 // package.json
 var package_default = {
   name: "@saptools/service-flow",
-  version: "0.1.45",
+  version: "0.1.46",
   description: "Trace SAP CAP service-to-service flows across multi-repository workspaces with runtime-aware graph resolution",
   type: "module",
   publishConfig: {
@@ -1479,6 +1480,7 @@ function implementationEdgeCategories(db, detail) {
     ...item,
     servicePathPattern: pathPattern(servicePaths),
     suggestedAction: categoryAction(String(item.category)),
+    suggestedHints: suggestedHints(item.examples),
     examples: item.examples.slice(0, 3),
     expandedExamples: detail ? item.examples : void 0
   }));
@@ -1491,11 +1493,22 @@ function addImplementationCategory(grouped, row) {
   const baseOperation = String(row.baseOperation ?? row.operationName ?? evidence.operationName ?? "unknown");
   const key = [category, baseOperation, reason, family].join("\0");
   const current = grouped.get(key) ?? { category, baseOperation, reason, candidateFamily: family, count: 0, servicePaths: [], examples: [] };
+  const hintSuggestions = implementationSuggestions(evidence);
   current.count += 1;
   current.servicePaths.push(String(row.servicePath ?? evidence.servicePath ?? ""));
-  current.examples.push({ servicePath: row.servicePath, operation: row.operationName, status: row.status, reason: row.unresolvedReason });
+  current.examples.push({ servicePath: row.servicePath, operation: row.operationName, status: row.status, reason: row.unresolvedReason, implementationHintSuggestions: hintSuggestions });
   grouped.set(key, current);
 }
+function implementationSuggestions(evidence) {
+  const persisted = asRecords(evidence.implementationHintSuggestions);
+  const suggestions = persisted.length ? persisted : implementationHintSuggestions(evidence);
+  return suggestions.length ? suggestions : void 0;
+}
+function suggestedHints(examples) {
+  const hints = examples.flatMap((example) => asRecords(example.implementationHintSuggestions).flatMap((suggestion) => typeof suggestion.cli === "string" ? [String(suggestion.cli)] : []));
+  const unique = [...new Set(hints)].slice(0, 3);
+  return unique.length ? unique : void 0;
+}
 function missingParameterMetadataCategory(db, detail = false) {
   const examples = db.prepare(`SELECT sc.source_file sourceFile,sc.source_line sourceLine,sc.callee_expression calleeExpression
     FROM symbol_calls sc JOIN symbols s ON s.id=sc.callee_symbol_id
@@ -1712,11 +1725,24 @@ function renderTraceTable(result) {
   const lines = ["Step  Type                 From                                To                                  Evidence"];
   for (const e of result.edges) {
     lines.push(`${String(e.step).padEnd(5)} ${e.type.padEnd(20)} ${e.from.slice(0, 34).padEnd(35)} ${e.to.slice(0, 35).padEnd(36)} ${location(e.evidence)}`);
+    const hint = firstHint(e.evidence);
+    if (e.unresolvedReason && hint) lines.push(`      try ${hint}`);
   }
-  if (result.diagnostics.length > 0) lines.push("", "Diagnostics:", ...result.diagnostics.map((d) => `${String(d.severity ?? "info")} ${String(d.code ?? "diagnostic")} ${String(d.message ?? "")}`));
+  if (result.diagnostics.length > 0) lines.push("", "Diagnostics:", ...result.diagnostics.flatMap(diagnosticLines));
   return `${lines.join("\n")}
 `;
 }
+function diagnosticLines(diagnostic) {
+  const first = `${String(diagnostic.severity ?? "info")} ${String(diagnostic.code ?? "diagnostic")} ${String(diagnostic.message ?? "")}`;
+  const hint = firstHint(diagnostic);
+  return hint ? [first, `  try ${hint}`] : [first];
+}
+function firstHint(evidence) {
+  const suggestions = evidence.implementationHintSuggestions;
+  if (!Array.isArray(suggestions)) return void 0;
+  const first = suggestions.find((item) => Boolean(item) && typeof item === "object");
+  return typeof first?.cli === "string" ? first.cli : void 0;
+}
 
 // src/output/json-output.ts
 function renderJson(value) {