dbmd-core 0.3.6

Reference library for db.md, the open standard for databases in plain files. Parsing, store walk, wiki-link graph, validation, query, and write-through indexes. Zero AI dependencies.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# dbmd-core

The reference library for **db.md, the open standard for databases in plain files**.

`db.md` is a database made of markdown files: records are markdown with
YAML frontmatter, relationships are wiki-links, the directory is the
database, frontmatter carries structured fields, `DB.md` declares schemas,
and an agent is the query engine. It is the persistence layer for the
agent-native stack where readable context, an agent harness, and generated
surfaces replace much of the old database/backend/frontend shape.
`dbmd-core` is the Rust library that
implements every db.md operation; the
[`dbmd`](https://crates.io/crates/dbmd-cli) binary is a thin command-line
wrapper over it.

## What it provides

- **Parser** — frontmatter (YAML) + body, wiki-link extraction, section parsing.
- **Store** — store walk, date-sharding, type-folder enumeration, link lookup.
- **Graph** — backlinks, forwardlinks, neighborhood hydration, orphans (on-demand; no maintained graph).
- **Validate** — the full structured issue-code vocabulary (frontmatter, links, schema, policy, index integrity).
- **Query** — type / layer / field filters resolved against the `index.jsonl` sidecars.
- **Index + log** — write-through `index.md` (capped human browse) and complete `index.jsonl` machine twin; month-rotating append-only log.
- **Summary, stats, render, extract** — deterministic summaries, store stats, tree/outline structures, and document text extraction (PDF/docx/xlsx/epub/html).

## Design

- **Zero AI dependencies.** No model calls, no embeddings, no vectors — ever. The intelligence lives in the caller's agent; this library is the deterministic, fast tool it drives.
- **Embedded ripgrep** via the `grep` + `ignore` crates — no separate binary, no shelling out.
- **Permissive licensing only** under the allowlist in the repo root
  (`MIT`, `Apache-2.0`, BSD variants, `0BSD`, `Unlicense`, `MPL-2.0`, `Zlib`,
  `Unicode-3.0`).

## Usage

```toml
[dependencies]
dbmd-core = "0.3.5"
```

```rust
use dbmd_core::Store;

let store = Store::open("path/to/store")?;
// walk, validate, query, build indexes — see the API docs.
```

Full API documentation: <https://docs.rs/dbmd-core>.

## License

Apache-2.0. Copyright 2026 Carlos Galarza. See `LICENSE` and `NOTICE`.