HarperFast / HarperFast/Cortex

Webhook Ingestion Sources — Roadmap

Offen
#22 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement roadmap
Vorherrschende Sprache
JavaScript
Sterne
4
Forks
0
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

## Overview

Cortex ships with a Slack Events API webhook (`/SlackWebhook`) that automatically classifies, embeds, and stores messages. The same pattern — receive → classify → embed → store — can be extended to any platform that pushes events via HTTP.

This issue tracks which ingestion sources are live, which are planned, and how to add your own.

---

### Live

- [x] **Slack** — `SlackWebhook` Resource · Events API · messages + threads · [setup guide](packages/cortex/docs/slack-app-setup.md)

### Planned

- [ ] **GitHub** — issue comments, PR reviews, discussion posts
- [ ] **Linear** — issue updates, comments, project changes
- [ ] **Discord** — guild messages via Gateway or webhook relay
- [ ] **Jira** — issue events, comments, sprint changes
- [ ] **Notion** — page / database change webhooks (when available)
- [ ] **Email (IMAP / SendGrid Inbound Parse)** — inbound email → memory

---

### Adding a custom source

Any HTTP service that can POST JSON can feed Cortex. Create a new Resource class:

```js
import { Resource } from 'harperdb';
export class MyWebhook extends Resource {
async post(data) {
// 1. Verify authenticity
// 2. Extract text + metadata
// 3. classifyMessage(text) → category, entities, summary
// 4. generateEmbedding(text) → 384-dim vector
// 5. Memory.put(record)
}
}
```

See `SlackWebhook` in `packages/cortex/resources/slack-webhook.js` for a complete reference implementation.

---

**Want a specific source prioritized? Comment below or open a PR.**

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Lies packages/cortex/resources/slack-webhook.js und die Checkliste in diesem Issue, um das bestehende Ingestion-Muster und die geplanten Quellen zu verstehen. Für einen Beitrag müsste eine bestimmte Quelle ausgewählt, der Umfang ihrer Implementierung abgestimmt und die Roadmap aktualisiert werden, sobald diese Quelle vollständig ist; es wird keine Testdatei genannt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
javascript
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.