opendevbrowser 0.0.17 → 0.0.18

package/skills/opendevbrowser-best-practices/scripts/odb-workflow.sh

@@ -1,6 +1,23 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=./resolve-odb-cli.sh
+source "$script_dir/resolve-odb-cli.sh"
+
+render_cli_prefix() {
+  local rendered=()
+  local part
+  for part in "${ODB_CLI[@]}"; do
+    rendered+=("$(printf '%q' "$part")")
+  done
+  printf '%s' "${rendered[*]}"
+}
+
+CLI_PREFIX="$(render_cli_prefix)"
+PACKAGE_ROOT="$(cd "$script_dir/../../.." && pwd)"
+TRANSCRIPT_PROBE_PATH="$(printf '%q' "$PACKAGE_ROOT/scripts/youtube-transcript-live-probe.mjs")"
+
 print_help() {
   cat <<'EOF'
 OpenDevBrowser workflow router
@@ -17,6 +34,9 @@ Workflows:
   canvas-preflight
   canvas-feedback-eval
   parity-check
+  release-direct-gates
+  skill-runtime-audit
+  validated-capabilities
   surface-audit
   ops-channel-check
   cdp-channel-check
@@ -91,26 +111,26 @@ opendevbrowser_network_poll sessionId="<session-id>" max=100
 EOF
     ;;
   canvas-preflight)
-    cat <<'EOF'
+    cat <<EOF
 cat skills/opendevbrowser-best-practices/assets/templates/canvas-handshake-example.json
 cat skills/opendevbrowser-best-practices/assets/templates/canvas-generation-plan.v1.json
-npx opendevbrowser canvas --command canvas.session.open --params '{"requestId":"req_open_01","browserSessionId":"<browser-session-id>","documentId":null,"repoPath":null,"mode":"dual-track"}'
+$CLI_PREFIX canvas --command canvas.session.open --params '{"requestId":"req_open_01","browserSessionId":"<browser-session-id>","documentId":null,"repoPath":null,"mode":"dual-track"}'
 # Read handshake before any mutation. Require preflightState=handshake_read.
-npx opendevbrowser canvas --command canvas.plan.set --params-file skills/opendevbrowser-best-practices/assets/templates/canvas-generation-plan.v1.json
+$CLI_PREFIX canvas --command canvas.plan.set --params-file skills/opendevbrowser-best-practices/assets/templates/canvas-generation-plan.v1.json
 # Replace placeholders in the plan file with canvasSessionId, leaseId, and documentId from the open response.
-npx opendevbrowser canvas --command canvas.plan.get --params '{"requestId":"req_plan_get_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","documentId":"<document-id>"}'
+$CLI_PREFIX canvas --command canvas.plan.get --params '{"requestId":"req_plan_get_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","documentId":"<document-id>"}'
 # Require planStatus=accepted or preflightState=plan_accepted before canvas.document.patch.
 EOF
     ;;
   canvas-feedback-eval)
-    cat <<'EOF'
+    cat <<EOF
 cat skills/opendevbrowser-best-practices/artifacts/canvas-governance-playbook.md
 cat skills/opendevbrowser-best-practices/assets/templates/canvas-feedback-eval.json
 cat skills/opendevbrowser-best-practices/assets/templates/canvas-blocker-checklist.json
-npx opendevbrowser canvas --command canvas.feedback.poll --params '{"requestId":"req_feedback_01","canvasSessionId":"<canvas-session-id>","documentId":"<document-id>","targetId":"<target-id>","afterCursor":null}'
+$CLI_PREFIX canvas --command canvas.feedback.poll --params '{"requestId":"req_feedback_01","canvasSessionId":"<canvas-session-id>","documentId":"<document-id>","targetId":"<target-id>","afterCursor":null}'
 # Verify every feedback item is target-attributed and uses approved categories.
-npx opendevbrowser canvas --command canvas.preview.refresh --params '{"requestId":"req_refresh_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","targetId":"<target-id>","refreshMode":"full"}'
-npx opendevbrowser canvas --command canvas.document.save --params '{"requestId":"req_save_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","documentId":"<document-id>","repoPath":null}'
+$CLI_PREFIX canvas --command canvas.preview.refresh --params '{"requestId":"req_refresh_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","targetId":"<target-id>","refreshMode":"full"}'
+$CLI_PREFIX canvas --command canvas.document.save --params '{"requestId":"req_save_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","documentId":"<document-id>","repoPath":null}'
 # Save should fail or warn when requiredBeforeSave governance blocks remain unresolved.
 EOF
     ;;
@@ -119,6 +139,55 @@ EOF
 npm run test -- tests/parity-matrix.test.ts
 npm run test -- tests/tools.test.ts tests/daemon-commands.integration.test.ts
 ./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh
+EOF
+    ;;
+  release-direct-gates)
+    cat <<'EOF'
+mkdir -p artifacts/release/vX.Y.Z
+node scripts/provider-direct-runs.mjs --release-gate --out artifacts/release/vX.Y.Z/provider-direct-runs.json
+node scripts/live-regression-direct.mjs --release-gate --out artifacts/release/vX.Y.Z/live-regression-direct.json
+EOF
+    ;;
+  skill-runtime-audit)
+    cat <<'EOF'
+npm run build
+node scripts/docs-drift-check.mjs
+# Discovery, lifecycle, and help parity
+npm run test -- tests/skill-loader.test.ts tests/skill-list-tool.test.ts tests/cli-skills-installer.test.ts
+npm run test -- tests/cli-help.test.ts tests/cli-help-parity.test.ts tests/skill-runtime-audit.test.ts tests/skill-workflow-packs.test.ts
+npx opendevbrowser --help
+npx opendevbrowser help
+WORKDIR=$(mktemp -d /tmp/odb-skill-audit-XXXXXX)
+OPENCODE_CONFIG_DIR="$WORKDIR/config" CODEX_HOME="$WORKDIR/codex-home" CLAUDECODE_HOME="$WORKDIR/claude-home" AMP_CLI_HOME="$WORKDIR/amp-home" npx opendevbrowser --global --full --no-prompt
+OPENCODE_CONFIG_DIR="$WORKDIR/config" CODEX_HOME="$WORKDIR/codex-home" CLAUDECODE_HOME="$WORKDIR/claude-home" AMP_CLI_HOME="$WORKDIR/amp-home" npx opendevbrowser --uninstall --global --no-prompt
+./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-best-practices/scripts/run-robustness-audit.sh
+./skills/opendevbrowser-continuity-ledger/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-data-extraction/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-design-agent/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-form-testing/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-login-automation/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-product-presentation-asset/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-research/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-shopping/scripts/validate-skill-assets.sh
+node scripts/skill-runtime-audit.mjs --smoke --out artifacts/skill-runtime-audit/smoke.json
+node scripts/skill-runtime-audit.mjs --out artifacts/skill-runtime-audit/full.json
+EOF
+    ;;
+  validated-capabilities)
+    cat <<EOF
+# Public-first YouTube transcript probe
+node $TRANSCRIPT_PROBE_PATH --url "https://www.youtube.com/watch?v=aircAruvnKk" --youtube-mode auto --out artifacts/capability-fix/youtube-transcript-auto.json
+
+# Generic topical research without shopping contamination
+$CLI_PREFIX research run --topic "Chrome extension debugging workflows" --days 30 --source-selection auto --mode json --output-format json
+
+# Deterministic shopping reruns with explicit providers
+$CLI_PREFIX shopping run --query "wireless ergonomic mouse" --providers shopping/bestbuy,shopping/ebay --budget 150 --browser-mode managed --mode json --output-format json
+$CLI_PREFIX shopping run --query "27 inch 4k monitor" --providers shopping/bestbuy,shopping/ebay --budget 350 --sort lowest_price --browser-mode managed --mode json --output-format json
+
+# Region note: advisory unless output reports meta.selection.region_authoritative=true
+$CLI_PREFIX shopping run --query "wireless earbuds" --providers shopping/amazon --region us --browser-mode managed --mode json --output-format json
 EOF
     ;;
   surface-audit)
@@ -130,29 +199,29 @@ cat skills/opendevbrowser-best-practices/assets/templates/surface-audit-checklis
 EOF
     ;;
   ops-channel-check)
-    cat <<'EOF'
-npx opendevbrowser serve
-npx opendevbrowser launch --extension-only --wait-for-extension --output-format json
-npx opendevbrowser status --daemon --output-format json
+    cat <<EOF
+$CLI_PREFIX serve
+$CLI_PREFIX launch --extension-only --wait-for-extension --output-format json
+$CLI_PREFIX status --daemon --output-format json
 # Verify opsConnected=true and extensionHandshakeComplete=true
 cat skills/opendevbrowser-best-practices/assets/templates/ops-request-envelope.json
 EOF
     ;;
   cdp-channel-check)
-    cat <<'EOF'
-npx opendevbrowser serve
-npx opendevbrowser launch --extension-only --extension-legacy --wait-for-extension --output-format json
-npx opendevbrowser status --daemon --output-format json
+    cat <<EOF
+$CLI_PREFIX serve
+$CLI_PREFIX launch --extension-only --extension-legacy --wait-for-extension --output-format json
+$CLI_PREFIX status --daemon --output-format json
 # Verify cdpConnected=true while legacy session is active
 cat skills/opendevbrowser-best-practices/assets/templates/cdp-forward-envelope.json
 EOF
     ;;
   mode-flag-matrix)
-    cat <<'EOF'
+    cat <<EOF
 cat skills/opendevbrowser-best-practices/assets/templates/mode-flag-matrix.json
-npx opendevbrowser launch --no-extension --output-format json
-npx opendevbrowser launch --extension-only --wait-for-extension --output-format json
-npx opendevbrowser launch --extension-only --extension-legacy --wait-for-extension --output-format json
+$CLI_PREFIX launch --no-extension --output-format json
+$CLI_PREFIX launch --extension-only --wait-for-extension --output-format json
+$CLI_PREFIX launch --extension-only --extension-legacy --wait-for-extension --output-format json
 EOF
     ;;
   robustness-audit)

package/skills/opendevbrowser-best-practices/scripts/resolve-odb-cli.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+set_odb_cli_from_entry() {
+  local cli_entry="$1"
+  if [[ ! -f "$cli_entry" ]]; then
+    return 1
+  fi
+  if ! command -v node >/dev/null 2>&1; then
+    echo "node is required to run $cli_entry" >&2
+    return 1
+  fi
+  ODB_CLI=(node "$cli_entry")
+  return 0
+}
+
+find_odb_cli_from_pwd() {
+  local current pkg_path cli_entry pkg_name
+  if ! command -v node >/dev/null 2>&1; then
+    return 1
+  fi
+  current="$(pwd -P)"
+
+  while true; do
+    pkg_path="$current/package.json"
+    cli_entry="$current/dist/cli/index.js"
+    if [[ -f "$pkg_path" ]]; then
+      pkg_name="$(node -e 'const fs=require("fs"); try { const pkg=JSON.parse(fs.readFileSync(process.argv[1], "utf8")); process.stdout.write(typeof pkg.name === "string" ? pkg.name : ""); } catch {}' "$pkg_path")"
+      if [[ "$pkg_name" == "opendevbrowser" ]] && set_odb_cli_from_entry "$cli_entry"; then
+        return 0
+      fi
+    fi
+    if [[ "$current" == "/" ]]; then
+      break
+    fi
+    current="$(dirname "$current")"
+  done
+
+  return 1
+}
+
+find_odb_cli_from_node_resolution() {
+  local pkg_path pkg_root cli_entry
+  if ! command -v node >/dev/null 2>&1; then
+    return 1
+  fi
+
+  pkg_path="$(node -e 'const path=require("path"); try { const resolved=require.resolve("opendevbrowser/package.json", { paths: [process.cwd()] }); process.stdout.write(resolved); } catch {}')"
+  if [[ -z "$pkg_path" ]]; then
+    return 1
+  fi
+
+  pkg_root="$(cd "$(dirname "$pkg_path")" && pwd)"
+  cli_entry="$pkg_root/dist/cli/index.js"
+  set_odb_cli_from_entry "$cli_entry"
+}
+
+resolve_odb_cli() {
+  local helper_dir package_root cli_entry
+
+  if [[ -n "${ODB_CLI_VALIDATOR_OVERRIDE:-}" ]]; then
+    if [[ ! -x "$ODB_CLI_VALIDATOR_OVERRIDE" ]]; then
+      echo "ODB_CLI_VALIDATOR_OVERRIDE is not executable: $ODB_CLI_VALIDATOR_OVERRIDE" >&2
+      return 1
+    fi
+    ODB_CLI=("$ODB_CLI_VALIDATOR_OVERRIDE")
+    return 0
+  fi
+
+  helper_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  package_root="$(cd "$helper_dir/../../.." && pwd)"
+  cli_entry="$package_root/dist/cli/index.js"
+
+  if set_odb_cli_from_entry "$cli_entry"; then
+    return 0
+  fi
+
+  if find_odb_cli_from_pwd; then
+    return 0
+  fi
+
+  if find_odb_cli_from_node_resolution; then
+    return 0
+  fi
+
+  if command -v opendevbrowser >/dev/null 2>&1; then
+    ODB_CLI=("$(command -v opendevbrowser)")
+    return 0
+  fi
+
+  if command -v npx >/dev/null 2>&1; then
+    ODB_CLI=(npx --yes opendevbrowser)
+    return 0
+  fi
+
+  echo "Unable to locate the opendevbrowser CLI. Build a local dist/cli/index.js, install opendevbrowser as a local dependency, install the binary, or make npx available." >&2
+  return 1
+}
+
+resolve_odb_cli

package/skills/opendevbrowser-best-practices/scripts/run-robustness-audit.sh

@@ -26,6 +26,7 @@ skills=(
   "opendevbrowser-shopping:ISSUE-06 ISSUE-09 ISSUE-10 ISSUE-11 ISSUE-12"
   "opendevbrowser-product-presentation-asset:ISSUE-10 ISSUE-11 ISSUE-12"
   "opendevbrowser-research:ISSUE-06 ISSUE-09 ISSUE-10 ISSUE-12"
+  "opendevbrowser-design-agent:ISSUE-01 ISSUE-07 ISSUE-08 ISSUE-12"
 )
 
 canvas_issue_ids=(