diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..ae95089 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,9 @@ +# Agent rules for this repo + +- Dev: `cmake -S . -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j && ctest --test-dir build -V`. +- Style: exact, minimal diffs. Prefer editing existing files over creating new ones. +- NEVER use em dashes (U+2014) anywhere: not in code, docs, comments, commit messages, or chat output. Use a hyphen, comma, or colon instead. +- Verify through execution: run the suite after behavior changes. +- Destructive endpoints stay dry-run by default, date-guarded where remote data is at stake, and scoped to the claimed directory or allowed roots. + +See also: README.md, INSTALL.md, CLI.md, PLAN.md, REGISTRY.md, AGENTS.md, skills/versiond-admin/SKILL.md. diff --git a/CHANGELOG.md b/CHANGELOG.md index 3343def..76c3d66 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,3 +5,5 @@ - Native C++20 static library and CLI. - SQLite catalog, deduplicated store, HTTP API, SFTP replication. - Verified to 50000 concurrent loopback clients. + +See also: README.md, INSTALL.md, CLI.md, PLAN.md, REGISTRY.md, AGENTS.md, skills/versiond-admin/SKILL.md. diff --git a/CLI.md b/CLI.md new file mode 100644 index 0000000..128e96d --- /dev/null +++ b/CLI.md @@ -0,0 +1,109 @@ +# CLI guide (versiond-cli) + +Full operator manual. See README.md (overview), INSTALL.md (build), PLAN.md (module map), REGISTRY.md (provenance), AGENTS.md (rules), skills/versiond-admin/SKILL.md (agent playbook). + +Binary: `build/versiond-cli`. Home: `$VERSIOND_HOME` else `/tmp/versiond`. Config: `config/config.toml`. Index: `data/index.sqlite`. Spool: content-addressed store. + +## serve + +Start HTTP API on host:port (default 127.0.0.1:9922, loopback only). +`./build/versiond-cli serve` +Routes: `/`, `/dashboard`, `/api/health` (`{"ok":true}`), `/api/stats`, `/api/versions`, `/api/blobs`. See README.md. + +## add