Ga naar inhoud

Publieke subpath-exports

Naast de hoofdplugin-entrypoint stelt opencode-mem één stabiele subpath bloot die andere opencode-plugins rechtstreeks kunnen importeren. Zo hoef je geen container-tagconventies te reverse-engineeren bij het schrijven van third-party tools die in dezelfde geheugenstore lezen of schrijven.

Canonieke container-taghelpers. Dezelfde functies die opencode-mem zelf gebruikt om auto-captured herinneringen te scopen.

import { getProjectTagInfo, getUserTagInfo, getTags } from "opencode-mem/tags";
// Canonical project tag derived from cwd (git remote URL if present, else
// the project root path). Format: `opencode_project_<sha16>`.
const projectTag = getProjectTagInfo(process.cwd()).tag;
// Canonical user tag derived from `git config user.email`.
// Format: `opencode_user_<sha16>`.
const userTag = getUserTagInfo().tag;
// Both at once.
const { user, project } = getTags(process.cwd());

Tags die deze helpers produceren komen overeen met wat auto-capture schrijft, zodat third-party plugins die POST /api/memories aanroepen in dezelfde shards belanden die de rest van het systeem al begrijpt. Handgerolde tags waarvan de substring niet _project_ of _user_ is, belanden in shadow shards die /api/stats en /api/memories stilzwijgend filteren — deze helpers gebruiken voorkomt die valkuil.