asobi 0.5.1

A persistent, project-local knowledge graph CLI for AI agents.
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

.PHONY: help build build-documents run test test-documents test-scripts test-turso-scripts test-documents-scripts verify-storage-boundary verify-libsql verify-turso bench-libsql bench-turso bench-criterion bench-vector-criterion bench-alloc bench-sql-plans fmt fmt-check lint check check-documents check-turso bench clean init

# Default task: Show help
help:
	@echo "Available tasks:"
	@echo "  build         - Compile the Asobi CLI and library"
	@echo "  build-documents - Compile with fastembed document commands"
	@echo "  run           - Run the Asobi CLI via cargo"
	@echo "  test          - Run all Rust tests"
	@echo "  test-documents - Run tests with the fastembed document feature"
	@echo "  test-scripts  - Run uv-managed graph-tier CLI integration checks"
	@echo "  test-turso-scripts - Run experimental Turso CLI integration checks"
	@echo "  test-documents-scripts - Run uv-managed document-tier CLI checks"
	@echo "  verify-storage-boundary - Reject provider references outside src/storage"
	@echo "  verify-libsql - Run the default libSQL CLI verification"
	@echo "  verify-turso - Run the experimental Turso CLI verification"
	@echo "  bench-libsql - Run graph benchmarks against the default build"
	@echo "  bench-turso - Build the Turso graph benchmark (set ASOBI_BACKEND=turso to select it)"
	@echo "  bench-criterion - Run statistical graph hot-path benchmarks"
	@echo "  bench-vector-criterion - Run statistical vector-search benchmarks"
	@echo "  bench-alloc   - Write a DHAT allocation profile for graph hot paths"
	@echo "  bench-sql-plans - Print query plans for graph hot-path SQL"
	@echo "  fmt           - Format Rust, Python, JSON, and YAML code"
	@echo "  fmt-check     - Verify formatting without writing (gate; run fmt to fix)"
	@echo "  lint          - Run Rust clippy and Python ruff"
	@echo "  check         - Run format check, lint, and tests (CI baseline, libSQL only)"
	@echo "  check-documents - Run document feature build and tests"
	@echo "  check-turso   - Build/test/verify the experimental Turso backend (opt-in)"
	@echo "  bench         - Run graph-tier benchmark harness"
	@echo "  clean         - Remove build artifacts"
	@echo "  init          - Print dev environment setup (nix develop)"

build:
	cargo build

build-documents:
	cargo build --features documents

run:
	cargo run -- $(ARGS)

test:
	cargo test -- --test-threads=1

test-documents:
	cargo test --features documents -- --test-threads=1

test-scripts:
	uv run scripts/verify_cli.py

test-turso-scripts:
	uv run scripts/verify_cli.turso.py

test-documents-scripts:
	uv run scripts/verify_documents_cli.py

verify-storage-boundary:
	uv run --no-project python scripts/verify_storage_boundary.py

verify-libsql: build
	uv run scripts/verify_cli.py

verify-turso:
	cargo build --features turso-experimental
	uv run scripts/verify_cli.turso.py

bench-libsql:
	cargo bench --bench graph

# Turso is outside the default gate; libSQL is the supported default. To run
# this benchmark against Turso rather than the default backend, select it:
#   ASOBI_BACKEND=turso make bench-turso
bench-turso:
	cargo bench --features turso-experimental --bench graph

bench-criterion:
	cargo bench --bench graph_criterion

bench-vector-criterion:
	cargo bench --features documents --bench vector_criterion

bench-alloc:
	cargo bench --bench allocations

bench-sql-plans:
	cargo bench --bench sql_plans

fmt:
	cargo fmt
	bun x prettier --write "**/*.{json,yaml,yml}"
	ruff format .

fmt-check:
	cargo fmt --check
	bun x prettier --check "**/*.{json,yaml,yml}"
	ruff format --check .

lint:
	cargo clippy -- -D warnings
	cargo clippy --features documents -- -D warnings
	ruff check .

check: verify-storage-boundary fmt-check lint test test-scripts check-documents

check-documents: build-documents test-documents test-documents-scripts

# Experimental Turso backend is opt-in and not part of the default `check`
# baseline (which ships libSQL). Run this to exercise the feature-gated matrix.
check-turso:
	cargo clippy --features turso-experimental -- -D warnings
	cargo test --features turso-experimental -- --test-threads=1
	cargo build --features turso-experimental
	uv run scripts/verify_cli.turso.py

bench:
	cargo bench

clean:
	cargo clean
	rm -rf target/

init:
	@echo "Nix serves this repo. Enter the dev shell with:"
	@echo "  nix develop"
	@echo "(provides rust, uv, ruff, bun, and make)"