List all concepts in the bundle (or a subdirectory).

Returns concept_id, type, title, description, tags, and timestamp for each concept. Reserved files (index.md, log.md) are excluded.

Retrieve a full concept document by its ID.

Returns the concept's frontmatter metadata and its markdown body.

Get the index.md content for a directory in the bundle.

Index files list the directory's concepts for progressive disclosure. Returns empty string if no index exists.

Get the log.md content for a directory in the bundle.

Log files contain the chronological history of changes. Returns empty string if no log exists.

Search concepts by full-text query, tags, and/or type.

Case-insensitive substring search across concept IDs, titles, descriptions, and body content. All provided filters are ANDed together.

Create a new OKF concept document.

Fails if the concept already exists — use update_concept to modify existing ones.

Update an existing OKF concept document.

Merges frontmatter_updates into existing metadata and refreshes the timestamp. Pass body=null to keep the existing body unchanged. Set a frontmatter key to null to remove it.

Delete a concept document from the bundle.

Also removes any parent directories that become empty after deletion (stopping at the bundle root).

Create or overwrite an index.md file for a directory.

Index files have no frontmatter (except the bundle root which may include okf_version) and list the directory's concepts for progressive disclosure. See OKF spec §6 for the recommended format.

Auto-generate an index.md for a directory from existing concept frontmatter.

Scans only the immediate children of the directory (one level deep). Writes and returns the generated index content.

Append a dated entry to the log.md file for a directory.

Entries are grouped under today's ISO 8601 date heading, newest first. Creates log.md if it does not exist.