agent/claude/research/collection/HOOKS.md
Snider 62b9ee7729
Some checks failed
CI / test (push) Failing after 3s
refactor(plugin): split research skills into separate plugin
New plugin: claude/research (core-research v0.1.0)
- 12 collection/research skills moved from core
- collection subsystem (hooks, scripts) moved
- Installed separately when research work is needed

Core plugin bumped to v0.12.0 — now focused on:
- Dispatch, review, messaging, OpenBrain (operational)
- Deploy, app-split, repo-sweep (infrastructure)
- Architecture review, security review (quality)

Marketplace updated with CoreResearch entry.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-21 18:16:06 +00:00

1.6 KiB

Collection Hooks

Event-driven hooks that trigger during data collection.

Available Hooks

Hook Trigger Purpose
collect-whitepaper.sh PDF/paper URL detected Auto-queue whitepapers
on-github-release.sh Release found Archive release metadata
on-explorer-block.sh Block data fetched Index blockchain data

Hook Events

on_url_found

Fired when a new URL is discovered during collection.

# Pattern matching
*.pdf              → collect-whitepaper.sh
*/releases/*       → on-github-release.sh
*/api/block/*      → on-explorer-block.sh

on_file_collected

Fired after a file is successfully downloaded.

# Post-processing
*.json             → validate-json.sh
*.html             → extract-links.sh
*.pdf              → extract-metadata.sh

on_collection_complete

Fired when a job batch finishes.

# Reporting
→ generate-index.sh
→ update-registry.sh

Plugin Integration

For the marketplace plugin system:

{
  "name": "whitepaper-collector",
  "version": "1.0.0",
  "hooks": {
    "on_url_found": {
      "pattern": "*.pdf",
      "handler": "./collect-whitepaper.sh"
    }
  }
}

Registration

Hooks register in hooks.json:

{
  "on_url_found": [
    {
      "pattern": "\\.pdf$",
      "handler": "./hooks/collect-whitepaper.sh",
      "priority": 10
    }
  ]
}

Usage in Collectors

Collectors call hooks via:

# In job-collector/process.sh
source ./hooks/dispatch.sh

# When URL found
dispatch_hook "on_url_found" "$URL"

# When file collected
dispatch_hook "on_file_collected" "$FILE" "$TYPE"