Saucebox Registry
← Browse

@ataraxy-labs/sem

A

Semantic version control CLI. Entity-level diffs for Git (functions, classes, methods instead of lines).

skillclaude

Install

agr install @ataraxy-labs/sem --target claude

Writes 21 files into .claude/skills/, pinned to git-076309c1.

  • .claude/skills/sem/.dockerignore
  • .claude/skills/sem/.gitignore
  • .claude/skills/sem/CHANGELOG.md
  • .claude/skills/sem/CONTRIBUTING.md
  • .claude/skills/sem/Dockerfile
  • .claude/skills/sem/LICENSE-APACHE
  • .claude/skills/sem/LICENSE-MIT
  • .claude/skills/sem/README.md
  • .claude/skills/sem/SKILL.md
  • .claude/skills/sem/demo_arch.sh
  • .claude/skills/sem/demo_record.sh
  • .claude/skills/sem/flake.lock
  • .claude/skills/sem/flake.nix
  • .claude/skills/sem/install.sh
  • .claude/skills/sem/package.json
  • .claude/skills/sem/package.nix
  • .claude/skills/sem/ratatui-debug.log
  • .claude/skills/sem/server.json
  • .claude/skills/sem/shell.nix
  • .claude/skills/sem/tsup.config.ts
  • .claude/skills/sem/vitest.config.ts

Document

sem

Semantic version control CLI. Entity-level diffs for Git (functions, classes, methods instead of lines).

Structure

Cargo workspace at crates/:

  • sem-core — entity extraction engine, tree-sitter parsers, dependency graph
  • sem-cli — CLI binary (sem diff, sem graph, sem impact, sem blame)

Build & Test

cargo build --release -p sem-cli     # binary at target/release/sem
cargo test --workspace               # 134 tests

All cargo commands run from repo root. CI builds from crates/ directory.

Key Paths

  • Parsers: crates/sem-core/src/parser/plugins/ (24 language plugins + shebang detection)
  • Commands: crates/sem-cli/src/commands/
  • Entity model: crates/sem-core/src/model/
  • Git integration: crates/sem-core/src/git/

Adding a Language

  1. Add tree-sitter grammar to sem-core/Cargo.toml
  2. Create parser plugin in sem-core/src/parser/plugins/
  3. Register in sem-core/src/parser/mod.rs
  4. Add tests
  5. See CONTRIBUTING.md for the full 7-step guide

Conventions

  • Entity granularity: functions, classes, methods, structs, traits, interfaces
  • Methods have a parentId linking to their class
  • structural_hash for matching entities across versions
  • Release on tag push (v*)
  • License: MIT OR Apache-2.0

Trustgrade A

  • passBody integrity

    Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.

  • passType matchnot applicable to this artifact type

    Whether the artifact is really the kind of thing its metadata claims it is.

  • passFreshness

    How long since the source repository was last pushed to.

  • passPrompt injection

    Scans the artifact's own text for instructions aimed at your agent rather than at you.

  • passLicense

    Whether the source repository declares an SPDX license permissive enough to redistribute.

How the grade is calculated

Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:

  • Aevery check passed
  • Bone warning
  • Ctwo warnings
  • Dprompt injection or body integrity failed, or three warnings
  • Fone of those failed, and something else is wrong

These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.

Versions

  • git-076309c1a8722026-07-31