tail -f ~/.openclaw/logs/semfora-error-reporter.log

git clone https://github.com/Semfora-AI/semfora-error-reporter.git
cd semfora-error-reporter
npm install
npm run build

{
  "mcpServers": {
    "semfora-error-reporter": {
      "command": "node",
      "args": ["/path/to/semfora-error-reporter/dist/index.js"]
    }
  }
}

mcporter config add semfora-error-reporter \
  --command node \
  --args /path/to/semfora-error-reporter/dist/index.js

{
  "mcpServers": {
    "semfora-error-reporter": {
      "command": "node",
      "args": ["/path/to/semfora-error-reporter/dist/index.js"]
    }
  }
}

### Semfora Error Reporting (semfora-engine project only)

When working on `semfora-engine`, use the `semfora-error-reporter` MCP tools to report issues with the engine:

- **Report** (`reportSemforaIssue`) when semfora returns wrong/missing results, crashes on valid input,
  produces output that doesn't match reality, or has broken commands. Do NOT report your own misuse.
- **Severity:** `critical` (crashes/data loss), `high` (blocks task), `medium` (workaround exists), `low` (minor/cosmetic).
- **After reporting:** Continue with fallbacks (manual file reading, ripgrep). Do not fix semfora unless
  that's your task. Do not `confirmSemforaIssue` on your own reports.
- **Required fields:** `projectRootAbsolutePath`, `filePathAbsolute`, `workflowSeverity`, `reportingModel`,
  `semforaVersion`, `projectDetails` (languages, estimatedSize, additionalContext), `semforaToolUsed`,
  `toolPurpose`, `details`.

### Semfora Error Reporting (semfora-engine project only)

When reviewing PRs for `semfora-engine`, use the `semfora-error-reporter` MCP tools:

- **Report** (`reportSemforaIssue`) if you encounter semfora returning wrong/missing results, crashes,
  or broken commands during review. Do NOT report your own misuse.
- **Confirm/Invalidate** issues filed by other agents. Only verify reports you did NOT file yourself.
  To confirm, reproduce the exact scenario. To invalidate, explain why (duplicate, user error, already fixed).
- **Severity:** `critical` (crashes/data loss), `high` (blocks task), `medium` (workaround exists), `low` (minor/cosmetic).

# List confirmed issues from the local DB
node dist/index.js  # (via MCP: listSemforaIssues with status "confirmed")

# Create a GitHub issue from a confirmed report
gh issue create \
  --repo Semfora-AI/semfora-engine \
  --title "Bug: <description from report>" \
  --body "Reported by: <reportingModel>
Severity: <workflowSeverity>
Semfora version: <semforaVersion>
Tool used: <semforaToolUsed>

## Details
<details field from report>

## Confirmation
Confirmed by: <confirmedByModel>
<confirmationDetails>"

#!/usr/bin/env bash
# escalate-confirmed.sh — create GH issues from confirmed semfora error reports

DB="$HOME/.openclaw/semfora-errors.json"
REPO="Semfora-AI/semfora-engine"

jq -c '.confirmedSemforaErrors[]' "$DB" | while read -r entry; do
  title="Bug: $(echo "$entry" | jq -r '.semforaToolUsed') — $(echo "$entry" | jq -r '.toolPurpose' | head -c 60)"
  body=$(cat <<EOF
**Reported by:** $(echo "$entry" | jq -r '.reportingModel')
**Severity:** $(echo "$entry" | jq -r '.workflowSeverity')
**Semfora version:** $(echo "$entry" | jq -r '.semforaVersion')
**Tool used:** $(echo "$entry" | jq -r '.semforaToolUsed')
**Discovered:** $(echo "$entry" | jq -r '.discoveredAt')

## Details
$(echo "$entry" | jq -r '.details')

## Confirmation
**Confirmed by:** $(echo "$entry" | jq -r '.confirmedByModel')
$(echo "$entry" | jq -r '.confirmationDetails')

---
*Auto-created from semfora-error-reporter ID: $(echo "$entry" | jq -r '.id')*
EOF
  )
  gh issue create --repo "$REPO" --title "$title" --body "$body" --label "bug"
done

projectRootAbsolutePath  — absolute path to the repo root
filePathAbsolute          — file involved (null if not file-specific)
workflowSeverity          — low | medium | high | critical
reportingModel            — your model name (e.g. "claude-sonnet-4-5")
semforaVersion            — output of `semfora-engine --version`
projectDetails.languages  — ["Rust", "Python", etc.]
projectDetails.estimatedSize — "small" / "medium" / "large" / "10K files"
projectDetails.additionalContext — anything relevant
semforaToolUsed           — the command/tool name (e.g. "search", "query overview")
toolPurpose               — what you were trying to do
details                   — exact command, expected vs actual output