opendevbrowser 0.0.22 → 0.0.23

package/dist/cli/commands/macro-resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"macro-resolve.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/macro-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjG,KAAK,gBAAgB,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AA8GF,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU;;;;GAyBrD;AAED,eAAO,MAAM,QAAQ;qCAhGmB,MAAM,EAAE,KAAG,gBAAgB;CAkGlE,CAAC"}
+{"version":3,"file":"macro-resolve.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/macro-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjG,KAAK,gBAAgB,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAyIF,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU;;;;GAyBrD;AAED,eAAO,MAAM,QAAQ;qCAhGmB,MAAM,EAAE,KAAG,gBAAgB;CAkGlE,CAAC"}

package/dist/cli/daemon-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-commands.d.ts","sourceRoot":"","sources":["../../src/cli/daemon-commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA+ClD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAaF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CA6zBnH"}
+{"version":3,"file":"daemon-commands.d.ts","sourceRoot":"","sources":["../../src/cli/daemon-commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgDlD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAaF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CA6zBnH"}

package/dist/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAgB,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EACL,wBAAwB,EAGzB,MAAM,sCAAsC,CAAC;AAE9C,KAAK,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;AAE5E,UAAU,SAAS;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AAaD,eAAO,MAAM,kBAAkB,QAAO,UAAU,EAE/C,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,MAAM,EAI/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAIpD,CAAC;AAEJ,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAqE,CAAC;AAE7I,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EA8JhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,gDAAuB,CAAC;AAEtD,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EA8B5D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAmE5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,cAAc,EAgB3D,CAAC;AAkJF,wBAAgB,WAAW,IAAI,MAAM,CA+BpC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAgB,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EACL,wBAAwB,EAGzB,MAAM,sCAAsC,CAAC;AAE9C,KAAK,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;AAE5E,UAAU,SAAS;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAChC;AAaD,eAAO,MAAM,kBAAkB,QAAO,UAAU,EAE/C,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,MAAM,EAI/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EAIpD,CAAC;AAEJ,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAqE,CAAC;AAE7I,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EA8JhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,gDAAuB,CAAC;AAEtD,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EA8B5D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,SAAS,cAAc,EAmE5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAAS,cAAc,EAgB3D,CAAC;AA8JF,wBAAgB,WAAW,IAAI,MAAM,CA+BpC"}

package/dist/cli/index.js

@@ -31,7 +31,7 @@ import {
   resolveExitCode,
   startDaemon,
   toCliError
-} from "../chunk-OGE5KJ4X.js";
+} from "../chunk-2MG7BRPF.js";
 import "../chunk-STGGGVYT.js";
 import {
   createNoOpSkillRemovalResult,
@@ -63,7 +63,7 @@ import {
   setDefaultLogSink,
   stderrSink,
   summarizePrimaryProviderIssue
-} from "../chunk-ZE2E7ZGH.js";
+} from "../chunk-K2TEHJCV.js";
 import "../chunk-FUSXMW3G.js";
 
 // src/cli/args.ts
@@ -580,6 +580,9 @@ function assertCommandCoverage() {
       if (!detail || !detail.description.trim() || !detail.usage.trim()) {
         throw new Error(`Missing command help metadata: ${command}`);
       }
+      if (detail.examples.length === 0) {
+        throw new Error(`Missing command example metadata: ${command}`);
+      }
       for (const flag of detail.flags) {
         if (!FLAG_SET.has(flag)) {
           throw new Error(`Command help metadata references unknown flag ${flag} for ${command}`);
@@ -620,6 +623,9 @@ function assertToolCoverage() {
     if (!entry.description.trim()) {
       throw new Error(`Help tool is missing a description: ${entry.name}`);
     }
+    if (!entry.example?.trim()) {
+      throw new Error(`Help tool is missing an example: ${entry.name}`);
+    }
     if (seen.has(entry.name)) {
       throw new Error(`Help tool appears multiple times: ${entry.name}`);
     }
@@ -641,7 +647,9 @@ function formatCommandGroups() {
         description: detail.description,
         details: [
           { label: "usage:", value: detail.usage },
-          { label: "flags:", value: formatFlags(detail.flags) }
+          { label: "flags:", value: formatFlags(detail.flags) },
+          ...detail.examples.map((example) => ({ label: "example:", value: example })),
+          ...detail.notes.map((note) => ({ label: "note:", value: note }))
         ]
       };
     });
@@ -664,7 +672,11 @@ function formatToolEntries() {
   return formatRows(HELP_TOOL_ENTRIES.map((entry) => ({
     label: entry.name,
     description: entry.description,
-    details: entry.cliEquivalent ? [{ label: "cli:", value: entry.cliEquivalent }] : [{ label: "scope:", value: "tool-only" }]
+    details: [
+      ...entry.cliEquivalent ? [{ label: "cli:", value: entry.cliEquivalent }] : [{ label: "scope:", value: "tool-only" }],
+      ...entry.example ? [{ label: "example:", value: entry.example }] : [],
+      ...(entry.notes ?? []).map((note) => ({ label: "note:", value: note }))
+    ]
   })));
 }
 function formatOnboardingEntries() {
@@ -3247,6 +3259,12 @@ async function runSessionDisconnect(args) {
 // src/cli/utils/workflow-message.ts
 var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
 var readNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+var UNRESOLVED_COMMAND_PLACEHOLDER_RE = /<[^>\n]+>/;
+var readRunnableStepCommand = (step) => {
+  const command = readNonEmptyString(step.command);
+  if (!command) return null;
+  return UNRESOLVED_COMMAND_PLACEHOLDER_RE.test(command) ? null : command;
+};
 var readMeta = (data) => {
   return asRecord(asRecord(data)?.meta);
 };
@@ -3294,6 +3312,17 @@ var readSuggestedNextAction = (data) => {
   if (!record) return null;
   return readNonEmptyString(record.suggestedNextAction) ?? readNonEmptyString(asRecord(record.sessionInspector)?.suggestedNextAction);
 };
+var readSuggestedStepCommand = (data) => {
+  let current = asRecord(data);
+  while (current) {
+    const command = readSuggestedSteps(current).map(readRunnableStepCommand).find((step) => Boolean(step));
+    if (command) {
+      return command;
+    }
+    current = asRecord(current.challengePlan);
+  }
+  return null;
+};
 var readSuggestedStepReason = (data) => {
   let current = asRecord(data);
   while (current) {
@@ -3324,7 +3353,7 @@ var buildWorkflowCompletionMessage = (workflowLabel, data) => {
   if (followthroughSummary) {
     return buildNextStepMessage(
       `${workflowLabel} completed. ${followthroughSummary}`,
-      readSuggestedNextAction(data) ?? readSuggestedStepReason(data)
+      readSuggestedNextAction(data) ?? readSuggestedStepCommand(data) ?? readSuggestedStepReason(data)
     );
   }
   return `${workflowLabel} completed.`;
@@ -6470,12 +6499,28 @@ var asRecord2 = (value) => {
   }
   return value;
 };
+var readNonEmptyString2 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
 var hasExecutionBlocker = (result) => {
   const execution = asRecord2(asRecord2(result)?.execution);
   const meta = asRecord2(execution?.meta);
   return asRecord2(meta?.blocker) !== null;
 };
+var readMacroResolveSummary = (result) => readNonEmptyString2(asRecord2(result)?.followthroughSummary);
+var readMacroResolveNextStep = (result) => {
+  const record = asRecord2(result);
+  const explicit = readNonEmptyString2(record?.suggestedNextAction);
+  if (explicit) {
+    return explicit;
+  }
+  const [firstStep] = Array.isArray(record?.suggestedSteps) ? record.suggestedSteps.filter((step) => Boolean(step) && typeof step === "object") : [];
+  return readNonEmptyString2(firstStep?.command) ?? readNonEmptyString2(firstStep?.reason);
+};
 var buildMacroResolveMessage = (execute, result) => {
+  const summary = readMacroResolveSummary(result);
+  const nextStep = readMacroResolveNextStep(result);
+  if (summary) {
+    return nextStep ? `${summary} Next step: ${nextStep}` : summary;
+  }
   if (!execute) {
     return "Macro resolved.";
   }
@@ -7369,7 +7414,7 @@ async function runInspiredesignCommand(args) {
 // package.json
 var package_default = {
   name: "opendevbrowser",
-  version: "0.0.22",
+  version: "0.0.23",
   description: "Browser automation runtime with snapshot-refs-actions, browser replay screencasts, public read-only desktop observation, and browser-scoped computer-use orchestration",
   type: "module",
   main: "dist/index.js",