@statewavedev/connectors-markdown
v0.1.0
Published
Markdown/docs connector for Statewave — scans a folder and maps .md/.mdx files into episodes
Maintainers
Readme
@statewavedev/connectors-markdown
Markdown / docs connector for Statewave — recursively scans .md and .mdx files into normalized episodes for project and decision memory.
Part of the Statewave Connectors ecosystem.
What it ingests
| Path / filename pattern | Episode kind |
|---|---|
| Anything under adrs/ or ADR-NNNN-… | docs.adr |
| Anything under rfcs/ or RFC-NNNN-… | docs.rfc |
| Filenames containing decision, paths under architecture/ | docs.decision |
| Everything else | docs.page |
The connector parses YAML frontmatter when present (title, date, …), uses the H1 of the body as a fallback title, and computes idempotency keys from the file's path plus content hash.
Quickstart
statewave-connectors sync markdown \
--path ./docs \
--subject repo:smaramwbc/statewave \
--dry-runLocal-first — no network calls beyond the optional Statewave ingest.
Status
v0.1.0 preview. See RELEASE_NOTES.md.
