v0.1.2

Changes since v0.1.1.

Highlights

Ontology descriptions - capture the meaning, not just the label

Knowledge is now more than names and types: you can attach a human-readable explanation to
what you record.

• Per-instance descriptions: observe takes an optional description on each entity and
  each relation - what the entity is, or what the connection means and why. Descriptions are
  content identity (folded into the observation's content-address), so a different description
  is a distinct asserted claim; the projected entity/relation carries the latest one, and the
  log keeps the full history. Shown in the live viewer's detail panel (node description; the
  relation description on row hover).
• Type glossary (T-Box): a new define_type tool records what an entity type or a
  relation type means (e.g. Driver = "a kernel module that ...", depends_on = "X
  requires Y at runtime"). A definition is required (a type has no meaning without one), and
  the vocabulary is workspace-scoped. Read it back via the new
  supragnosis://workspace/{ws}/types resource. Type definitions ride the observation log
  like any other assertion, so the glossary is a deterministic projection.

Viewer - hull rendering overhaul

• The hyperedge cohesion force is on by default now (the baseline layout organizer); the
  hulls button is a render-only overlay toggle, and group mode takes precedence so the two
  organizers never fight. Toggling the overlay no longer reheats the simulation.
• Hull areas render as smooth rounded blobs (a single outward-offset path, no overshoot) with
  uniform per-hull opacity that no longer floods the canvas; overlapping contexts still blend.
• Hovering or focusing a node emphasizes its own hulls (fills and labels) and fades the rest.
• The hull gap encloses the node glyphs, and cohesion/opacity scale with hull size.

CLI - supervisor-aware lifecycle

• stop / restart / status now detect a launchd-managed daemon (macOS) and drive it via
  launchctl (restart = kickstart -k, stop = bootout), falling back to the self-managed
  pidfile daemon otherwise. So supragnosis restart restarts the running MCP server + viewer
  regardless of who started it.
• The launchd label is standardized to com.supragnosis.daemon; deploy/install.sh migrates
  the legacy label automatically.

Install

curl -fsSL https://raw.githubusercontent.com/Ashon/supragnosis/main/scripts/install.sh | sh

Or download the platform tar.gz from the assets below, extract it, and put supragnosis
on your PATH. Supported: macOS (arm64 / x86_64), Linux (x86_64); each asset ships a .sha256.

• CLI: supragnosis --help. Register with an MCP client: claude mcp add supragnosis -- ~/.local/bin/supragnosis.

Notes / limitations

• Storage-format note: including description in the observation content-address changes
  the id of assertion-bearing observations (text-only observations are unchanged). After
  upgrading, such observations will not dedup against ones ingested by an earlier version.
  This is acceptable for the 0.x format (which may still change).
• define_type currently validates well-formedness and writes to the workspace T-Box directly
  (single-user workspace). The proposal gate and T-Box consistency check are future work.
• The prebuilt binary is keyword + hashing search. For local ONNX semantic search,
  build from source with cargo build --release --features fastembed.
• HTTP daemon / viewer are loopback-only (no auth) - a local trust surface. Remote
  exposure, auth, and TLS are future work.
• 0.x early release - the storage format and surfaces may still change.