opendevbrowser 0.0.28 → 0.0.30

package/skills/opendevbrowser-research/assets/templates/context.json

@@ -1,8 +1,59 @@
 {
   "topic": "",
   "timebox": {
-    "days": 30
+    "days": 30,
+    "from": null,
+    "to": null
   },
+  "source_families": [],
+  "evidence_gate": {
+    "status": "pending_review",
+    "reviewed_artifacts": [],
+    "accepted_claims": [],
+    "tentative_claims": [],
+    "unsupported_claims": [],
+    "blockers": []
+  },
+  "artifact_files": [
+    "summary.md",
+    "report.md",
+    "records.json",
+    "context.json",
+    "meta.json",
+    "bundle-manifest.json"
+  ],
+  "source_ledger": [],
+  "search_direction_notes": [],
+  "candidate_triage_schema": {
+    "url": "",
+    "rank": 0,
+    "engine": "",
+    "query": "",
+    "source_family": "",
+    "title": "",
+    "status": "pending|accepted|rejected",
+    "blocker_notes": "",
+    "rejection_reason": "",
+    "replacement_url": "",
+    "retrieval_notes": "",
+    "extraction_status": "pending|fetched|blocked|shell|stale|irrelevant"
+  },
+  "candidate_triage": {
+    "accepted_destination_records": 0,
+    "rejected_shell_or_dead_end_candidates": 0
+  },
+  "rejected_candidates": [],
+  "deep_dive_pages": [],
+  "iteration_log": [],
+  "synthesis_feedback": "",
+  "staleness_checks": [],
+  "provider_constraints": [],
+  "search_engine_passes": [],
+  "serp_candidates": [],
+  "selected_destination_pages": [],
+  "engine_failures": [],
+  "provenance": [],
+  "limitations": [],
   "issue_ids": [
     "ISSUE-06",
     "ISSUE-09",

package/skills/opendevbrowser-research/assets/templates/report.md

@@ -1,9 +1,62 @@
 # Research Report
 
-## Executive Summary
+## Topic and Scope
 
-## Findings
+## Evidence Gate Status
 
-## Confidence and Gaps
+State whether the run passed evidence review. Do not publish shell-only, stale-only, login-only, not-found-only, or zero-source-evidence claims.
 
-## Sources
+## Claim Map
+
+| Claim | Status | Evidence | Notes |
+|---|---|---|---|
+|  | accepted, tentative, or excluded | destination URL or artifact record id |  |
+
+## Evidence
+
+Summarize accepted destination-page evidence from `records.json`, with source date, fetch date, provider, and extraction quality.
+
+## Confidence
+
+Explain confidence by claim, including corroboration quality and independence.
+
+## Provider Constraints and Limitations
+
+Record provider blockers, rate limits, login walls, challenge pages, stale pages, extraction limits, and unsupported claims.
+
+## Search Engine Discovery
+
+If used, summarize search_engine_passes, serp_candidates, selected_destination_pages, engine_failures, provenance, and limitations. SERPs are discovery-only and cannot be final evidence.
+
+## Search Direction
+
+Summarize what the provider or search-engine pass suggested and which follow-up direction was chosen.
+
+## Candidate Triage
+
+List useful destinations, duplicates, privacy or terms pages, login or account pages, blocked pages, shells, stale pages, and off-topic pages.
+
+## Rejected Candidates
+
+Record rejected_candidates with URL, source, reason, and whether another candidate replaced it.
+
+## Deep Dives
+
+Summarize deep_dive_pages opened after triage, including destination URL, accepted evidence, and remaining uncertainty.
+
+## Synthesis Feedback
+
+Explain how the evidence changed the research direction, what gaps remain, and what the next query or source should be if more work is needed.
+
+## Final Answer
+
+Provide only claims supported by reviewed destination evidence. Label unresolved points as tentative or omit them.
+
+## Artifact Paths
+
+- `summary.md`:
+- `report.md`:
+- `records.json`:
+- `context.json`:
+- `meta.json`:
+- `bundle-manifest.json`:

package/skills/opendevbrowser-research/examples/sample-input.json

@@ -1,6 +1,6 @@
 {
   "topic": "ai browser automation",
   "days": 30,
-  "sourceSelection": "auto",
+  "sources": ["web", "community"],
   "mode": "context"
 }

package/skills/opendevbrowser-research/examples/sample-output.md

@@ -1,4 +1,29 @@
 # Sample Output
 
-1. Example finding one
-2. Example finding two
+## Search Direction
+
+- Provider pass produced destination candidates; accepted evidence came from following usable destination pages before considering browser recovery.
+
+## Candidate Triage
+
+- Accepted: `https://example.com/browser-automation-evidence`
+- Rejected: `https://example.com/login` as login_or_account; replacement destination followed: `https://example.com/browser-automation-evidence`
+- Rejected: `https://example.com/privacy/choices` as privacy_or_terms; replacement destination followed: `https://example.com/browser-automation-evidence`
+- Remaining candidate queue: `https://example.org/challenge-recovery-field-notes`
+
+## Deep Dives
+
+- Opened `https://example.com/browser-automation-evidence`; extracted destination-page evidence, blocker notes, and artifact review guidance.
+
+## Synthesis Feedback
+
+- The first accepted page shifted the next query toward challenge recovery handoff evidence.
+- Next query or evidence gap: find corroborating field notes from an independent browser automation source.
+
+## Evidence
+
+- Accepted claim: Browser automation research needs destination-page evidence, blocker notes, and artifact review before synthesis.
+
+## Limitations
+
+- Reddit evidence was excluded when only login or shell pages were available.

package/skills/opendevbrowser-research/scripts/run-research.sh

@@ -2,24 +2,20 @@
 set -euo pipefail
 
 if [[ $# -lt 1 ]]; then
-  echo "Usage: run-research.sh <topic> [days] [mode] [source-selection] [sources]"
+  echo "Usage: run-research.sh <topic> [days] [mode] [sources]"
   exit 1
 fi
 
 TOPIC="$1"
 DAYS="${2:-30}"
 MODE="${3:-context}"
-SOURCE_SELECTION="${4:-}"
-SOURCES="${5:-}"
+SOURCES="${4:-}"
 
 script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=../../opendevbrowser-best-practices/scripts/resolve-odb-cli.sh
 source "$script_dir/../../opendevbrowser-best-practices/scripts/resolve-odb-cli.sh"
 
 cmd=("${ODB_CLI[@]}" research run --topic "$TOPIC" --days "$DAYS" --mode "$MODE")
-if [[ -n "$SOURCE_SELECTION" ]]; then
-  cmd+=(--source-selection "$SOURCE_SELECTION")
-fi
 if [[ -n "$SOURCES" ]]; then
   cmd+=(--sources "$SOURCES")
 fi

package/skills/opendevbrowser-research/scripts/validate-skill-assets.sh

@@ -15,6 +15,65 @@ required=(
   "scripts/validate-skill-assets.sh"
 )
 
+posture_files=(
+  "SKILL.md"
+  "artifacts/research-workflows.md"
+  "assets/templates/compact.md"
+  "assets/templates/context.json"
+  "assets/templates/report.md"
+)
+
+required_markers=(
+  "evidence-gated"
+  "provider-constrained"
+  "discovery-only"
+  "candidate_triage"
+  "rejected_candidates"
+  "deep_dive_pages"
+  "synthesis_feedback"
+  "search_engine_passes"
+  "summary.md"
+  "report.md"
+  "records.json"
+  "context.json"
+  "meta.json"
+  "bundle-manifest.json"
+)
+
+required_file_markers=(
+  "SKILL.md|Search Engine Discovery Lane"
+  "SKILL.md|Guided Research Loop"
+  "SKILL.md|privacy"
+  "SKILL.md|login"
+  "SKILL.md|Keep SERPs discovery-only"
+  "SKILL.md|bundle-manifest.json"
+  "artifacts/research-workflows.md|Search Engine Discovery Lane"
+  "artifacts/research-workflows.md|Iterative destination-follow workflow"
+  "artifacts/research-workflows.md|candidate queue"
+  "artifacts/research-workflows.md|Keep SERPs discovery-only"
+  "artifacts/research-workflows.md|search_engine_passes"
+  "assets/templates/context.json|bundle-manifest.json"
+  "assets/templates/context.json|rejected_candidates"
+  "assets/templates/context.json|deep_dive_pages"
+  "assets/templates/context.json|search_engine_passes"
+  "assets/templates/context.json|blocker_notes"
+  "assets/templates/context.json|retrieval_notes"
+  "assets/templates/report.md|SERPs are discovery-only"
+  "assets/templates/report.md|Deep Dives"
+  "assets/templates/report.md|Synthesis Feedback"
+  "assets/templates/report.md|bundle-manifest.json"
+  "assets/templates/compact.md|deep-dive pages"
+)
+
+forbidden_markers=(
+  "research_reliable"
+  "auto is the recommended default"
+  "generic topical research is currently safest"
+  "privacy pages can support final claims"
+  "login pages can support final claims"
+  "SERP snippets are evidence"
+)
+
 status=0
 validator_cli="$root/../opendevbrowser-best-practices/scripts/validator-fixture-cli.sh"
 export ODB_CLI_VALIDATOR_OVERRIDE="$validator_cli"
@@ -28,6 +87,44 @@ require_marker() {
     status=1
   fi
 }
+
+require_file_marker() {
+  local marker="$1"
+  local found=0
+  local rel
+  for rel in "${posture_files[@]}"; do
+    if [[ -f "$root/$rel" ]] && grep -Fq "$marker" "$root/$rel"; then
+      found=1
+      break
+    fi
+  done
+  if [[ $found -eq 0 ]]; then
+    echo "Research assets missing required marker: $marker" >&2
+    status=1
+  fi
+}
+
+require_marker_in_file() {
+  local entry="$1"
+  local rel="${entry%%|*}"
+  local marker="${entry#*|}"
+  if [[ ! -f "$root/$rel" ]] || ! grep -Fq "$marker" "$root/$rel"; then
+    echo "Research asset $rel missing required marker: $marker" >&2
+    status=1
+  fi
+}
+
+reject_forbidden_marker() {
+  local marker="$1"
+  local rel
+  for rel in "${posture_files[@]}"; do
+    if [[ -f "$root/$rel" ]] && tr -d '`' < "$root/$rel" | grep -Fq "$marker"; then
+      echo "Research assets contain forbidden marker in $rel: $marker" >&2
+      status=1
+    fi
+  done
+}
+
 for rel in "${required[@]}"; do
   if [[ ! -f "$root/$rel" ]]; then
     echo "Missing required asset: $rel" >&2
@@ -59,6 +156,18 @@ for rel in scripts/run-research.sh scripts/render-output.sh scripts/write-artifa
   fi
 done
 
+for marker in "${required_markers[@]}"; do
+  require_file_marker "$marker"
+done
+
+for marker in "${required_file_markers[@]}"; do
+  require_marker_in_file "$marker"
+done
+
+for marker in "${forbidden_markers[@]}"; do
+  reject_forbidden_marker "$marker"
+done
+
 if [[ -f "$root/assets/templates/context.json" ]]; then
   if ! node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync(process.argv[1], "utf8"));' "$root/assets/templates/context.json" >/dev/null 2>&1; then
     echo "Invalid JSON template: assets/templates/context.json" >&2
@@ -66,13 +175,18 @@ if [[ -f "$root/assets/templates/context.json" ]]; then
   fi
 fi
 
-context_output="$("$root/scripts/run-research.sh" "ai browser automation" 30 context auto "web,docs")"
+context_output="$("$root/scripts/run-research.sh" "ai browser automation" 30 context "web,docs")"
 require_marker "run-research context" "$context_output" "# Research Context"
 require_marker "run-research context" "$context_output" "ISSUE-09"
 
 report_output="$("$root/scripts/render-output.sh" "ai browser automation" report)"
 require_marker "render-output report" "$report_output" "# Research Report"
 require_marker "render-output report" "$report_output" "Source selection"
+require_marker "render-output report" "$report_output" "Search Direction"
+require_marker "render-output report" "$report_output" "Candidate Triage"
+require_marker "render-output report" "$report_output" "Rejected Candidates"
+require_marker "render-output report" "$report_output" "Deep Dives"
+require_marker "render-output report" "$report_output" "Synthesis Feedback"
 
 tmpdir="$(mktemp -d)"
 trap 'rm -rf "$tmpdir"' EXIT