ontology-docs 0.5.0

A standalone, searchable Ontology documentation and agent-skills demo.
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

# ontology-docs

A standalone documentation dataset demonstrating Ontology's native executable,
JSON/MCP interface, original image and discoverable/exportable Agent Skills.

```sh
cargo install ontology-docs
ontology-docs
ontology-docs search 'password protection'
ontology-docs version
ontology-docs provenance document:overview
ontology-docs images
ontology-docs skills list
ontology-docs skills read ontology-authoring
ontology-docs skills export ontology-authoring --output ./agent-skills
ontology-docs mcp-config
```

Normal commands return `{ok,command,data,next}` JSON; follow the actual next argv
arrays for cited reads, image fetches and skill export. `--human` opts into text.
`serve` is newline-delimited stdio MCP. No runtime files, network, compiler or
embedding service is needed. This is a target-specific native executable, with
normal platform runtime requirements. WASM is future work.

The committed data/docs.ontology fixture contains portable ontology:// provenance,
the root README, format/agent/HTTP/ACP packaging and Notes guides, an original 32x24 gold/teal PNG, and three
skills: ontology-skill-creator, ontology-authoring and ontology-docs-use. The grid
was created directly from alternating RGB blocks; it has no third-party image
source. Runtime image embeddings are deliberately absent; import aligned external
vectors when needed rather than claim a bundled diffusion encoder.

Regenerate from the repository root after updating docs or skills:

```sh
cargo run --example generate_docs --locked
cargo build -p ontology-docs --release --locked
```

The Rust generator uses library builders and the native skill linter. The binary
includes the resulting fixture with include_bytes; generation runs only while
authoring the crate, never on installation or at runtime. Export writes the chosen
ROOT/skill-name and does not install skills or change harness configuration.

`ontology-docs server --port 0` launches the embedded dashboard and shared HTTP API.
The demo includes current competition/usage guides, original binary bytes and a
nested package; explore `objects`, `graph`, `embeddings` and `packages`.

Version and Provenance tabs expose packaging identity, full checksums, original document metadata, Git author/history records and source tracing. Compression research and local log benchmarks are bundled as searchable documentation.