Metadata-Version: 2.4
Name: sarib
Version: 0.1.0
Summary: Reference implementation of the .sarib knowledge language: query bounded subgraphs and apply id-addressed atomic edits over plain-text knowledge.
Author: Syed Sarib Sultan
License: MIT
Project-URL: Homepage, https://github.com/SyedSaribSultan/sarib-lang
Project-URL: Repository, https://github.com/SyedSaribSultan/sarib-lang
Project-URL: Issues, https://github.com/SyedSaribSultan/sarib-lang/issues
Keywords: knowledge,graph,markdown,mcp,ai-agents,llm,notes,property-graph
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Markup
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"

# sarib

Reference implementation of the **.sarib** knowledge language — a plain-text format
that is at once a readable document (a Markdown superset) and a labeled property graph.
Agents query bounded subgraphs and apply id-addressed atomic edits instead of
re-reading or regenerating whole files.

```bash
pip install sarib            # core, zero dependencies
pip install "sarib[mcp]"     # + the MCP server for agent clients
```

## CLI

```bash
sarib validate notes.sarib
sarib render   notes.sarib --view outline     # document | outline | board | mermaid
sarib query    notes.sarib --spec '{"select":"none","filter":{"type":"task"}}'
sarib apply    notes.sarib --op   '{"kind":"set-property","target":"t1","args":{"key":"status","value":"done"}}'
sarib canon    notes.sarib                     # canonical normal form (for hash/diff)
```

## MCP server

```bash
sarib-mcp /path/to/folder-of-.sarib-files
```

Exposes `sarib_query / sarib_apply / sarib_render / sarib_validate / sarib_canon`
to any MCP client (Claude Desktop, Claude Code, Cursor, …).

## Status

Research-grade **v0.1**. Spec, full design history, decision log, and benchmarks:
<https://github.com/SyedSaribSultan/sarib-lang>. License: MIT.
