@saptools/service-flow 0.1.50 → 0.1.51

package/dist/cli.js

@@ -16,7 +16,7 @@ import {
   parseServiceBindings,
   parseVars,
   trace
-} from "./chunk-52OUS3MO.js";
+} from "./chunk-YZJKE5UX.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -214,7 +214,7 @@ function migrate(db) {
 // package.json
 var package_default = {
   name: "@saptools/service-flow",
-  version: "0.1.50",
+  version: "0.1.51",
   description: "Trace SAP CAP service-to-service flows across multi-repository workspaces with runtime-aware graph resolution",
   type: "module",
   publishConfig: {
@@ -2053,18 +2053,39 @@ function diagnosticLines(diagnostic) {
   return [first, ...hintLines(diagnostic).map((hint) => `  ${hint}`)];
 }
 function hintLines(evidence) {
+  const dynamicLines = dynamicHintLines(evidence);
   const suggestions = evidence.implementationHintSuggestions;
-  if (!Array.isArray(suggestions)) return [];
+  if (!Array.isArray(suggestions)) return dynamicLines;
   const hints = suggestions.flatMap((item) => isRecord(item) && typeof item.cli === "string" ? [item.cli] : []);
   const unique = [...new Set(hints)];
   const shown = unique.slice(0, 3).map((hint) => `try ${hint}`);
   if (unique.length > shown.length)
     shown.push(`... ${unique.length - shown.length} more hint(s) available in JSON`);
-  return shown;
+  return [...dynamicLines, ...shown];
+}
+function dynamicHintLines(evidence) {
+  const exploration = isRecord(evidence.dynamicTargetExploration) ? evidence.dynamicTargetExploration : evidence;
+  const count = numberValue(exploration.candidateCount);
+  if (count === 0) return [];
+  const shown = numberValue(exploration.shownCandidateCount);
+  const omitted = numberValue(exploration.omittedCandidateCount);
+  const lines = [`candidates: ${shown} shown, ${omitted} omitted`];
+  lines.push(...varSetHints(exploration.suggestedVarSets));
+  if (omitted > 0 || shown < count)
+    lines.push("use --dynamic-mode candidates --max-dynamic-candidates 20 to explore candidate branches");
+  return lines;
+}
+function varSetHints(value) {
+  if (!Array.isArray(value)) return [];
+  const hints = value.flatMap((item) => isRecord(item) && typeof item.cli === "string" ? [`try ${item.cli}`] : []);
+  return [...new Set(hints)].slice(0, 3);
 }
 function isRecord(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
 
 // src/output/json-output.ts
 function renderJson(value) {
@@ -2264,7 +2285,7 @@ function createProgram() {
       );
     }).catch(fail)
   );
-  program.command("trace").option("--workspace <path>").option("--repo <name>").option("--operation <name>").option("--service <path>").option("--path <operationPath>").option("--handler <name>").option("--depth <n>", "trace depth", "25").option("--format <format>", "table|json|mermaid", "table").option("--include-external").option("--include-db").option("--include-async").option("--implementation-repo <name>").option("--implementation-hint <scope>", "scoped implementation hint", collect, []).option("--var <key=value>", "dynamic variable", collect, []).action(
+  program.command("trace").option("--workspace <path>").option("--repo <name>").option("--operation <name>").option("--service <path>").option("--path <operationPath>").option("--handler <name>").option("--depth <n>", "trace depth", "25").option("--format <format>", "table|json|mermaid", "table").option("--include-external").option("--include-db").option("--include-async").option("--implementation-repo <name>").option("--implementation-hint <scope>", "scoped implementation hint", collect, []).option("--var <key=value>", "dynamic variable", collect, []).option("--dynamic-mode <mode>", "strict|candidates|infer", "strict").option("--max-dynamic-candidates <n>", "maximum dynamic candidates to show", "5").action(
     (opts) => void withReadOnlyWorkspace(opts.workspace, (db) => {
       const result = trace(
         db,
@@ -2282,7 +2303,9 @@ function createProgram() {
           includeDb: Boolean(opts.includeDb),
           includeAsync: Boolean(opts.includeAsync),
           implementationRepo: opts.implementationRepo,
-          implementationHints: opts.implementationHint.map(parseImplementationHint)
+          implementationHints: opts.implementationHint.map(parseImplementationHint),
+          dynamicMode: parseDynamicMode(opts.dynamicMode),
+          maxDynamicCandidates: parsePositiveInteger(opts.maxDynamicCandidates, 5)
         }
       );
       process.stdout.write(
@@ -2351,7 +2374,7 @@ function createProgram() {
       process.stdout.write(renderJson(rows));
     }).catch(fail)
   );
-  program.command("graph").option("--workspace <path>").option("--repo <name>").option("--operation <name>").option("--service <path>").option("--path <operationPath>").option("--format <format>", "mermaid|json", "mermaid").option("--implementation-repo <name>").option("--implementation-hint <scope>", "scoped implementation hint", collect, []).option("--var <key=value>", "dynamic variable", collect, []).action(
+  program.command("graph").option("--workspace <path>").option("--repo <name>").option("--operation <name>").option("--service <path>").option("--path <operationPath>").option("--format <format>", "mermaid|json", "mermaid").option("--implementation-repo <name>").option("--implementation-hint <scope>", "scoped implementation hint", collect, []).option("--var <key=value>", "dynamic variable", collect, []).option("--dynamic-mode <mode>", "strict|candidates|infer", "strict").option("--max-dynamic-candidates <n>", "maximum dynamic candidates to show", "5").action(
     (opts) => void withReadOnlyWorkspace(opts.workspace, (db) => {
       const result = trace(
         db,
@@ -2368,7 +2391,9 @@ function createProgram() {
           includeExternal: true,
           vars: parseVars(opts.var),
           implementationRepo: opts.implementationRepo,
-          implementationHints: opts.implementationHint.map(parseImplementationHint)
+          implementationHints: opts.implementationHint.map(parseImplementationHint),
+          dynamicMode: parseDynamicMode(opts.dynamicMode),
+          maxDynamicCandidates: parsePositiveInteger(opts.maxDynamicCandidates, 5)
         }
       );
       process.stdout.write(
@@ -2434,6 +2459,15 @@ function collect(value, previous) {
   previous.push(value);
   return previous;
 }
+function parseDynamicMode(value) {
+  if (value === void 0 || value === "strict") return "strict";
+  if (value === "candidates" || value === "infer") return value;
+  throw new Error(`Invalid --dynamic-mode ${value}; expected strict, candidates, or infer`);
+}
+function parsePositiveInteger(value, fallback) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
+}
 function fail(error) {
   process.stderr.write(
     `${error instanceof Error ? error.message : String(error)}