Skip to main content

astria 1.0.0: the graphify rebrand is complete

· 2 min read
Nodesify
Nodesify

1.0.0 is out — npm install -g @nodesify/astria. This is the release the project is fully astria: the binary, the npm package, the .astria/ graph directory, the environment variables, the skill files. Same idea that inspired it, new engine throughout.

Coming from @nodesify/graphify?​

1.0 is a rebrand, not a rewrite of your data. Install the new package and run once:

astria migrate          # renames .graphify/ -> .astria/ and the global store
astria install          # refreshes AI-tool skills/hooks (also cleans the old graphify entries)

GRAPHIFY_* environment variables keep working; ASTRIA_* takes precedence.

What's new since 0.8.0​

  • Hypergraph, deterministically — n-ary hyperedges produced without an LLM: community participate_in groups and shares_reference literal groups. They flow into graph.json, the report, the wiki, HTML hulls, and explain. Graphify's hyperedges are LLM-produced; ours are local and reproducible.
  • Cross-repo global graph — ~/.astria/global.db: global add/remove/list/path, repo-tag prefixed merging that unifies external symbols across repos, same_type_as type edges, and cross-repo call resolution that fails closed on ambiguity.
  • Graph health + feedback loop — diagnose (read-only health report), save-result/reflect curated memory (.astria/memory/ → graph nodes → LESSONS.md) alongside automatic learned edges, build-time validation, a JSONL query log, and always-on instruction blocks in AGENTS.md/CLAUDE.md.
  • Ingest breadth (offline-first) — Cargo workspace topology, .mcp.json/mcp_servers.json/claude_desktop_config.json (env names only, never values), add --scip, add --postgres (read-only), and transcript sidecars in .astria/transcripts/.
  • SSRF-hardened URL ingestion — add <url> validates every redirect hop, blocks loopback/private/link-local addresses (IPv4 and IPv6), and slugifies downloaded filenames so a hostile URL cannot write outside raw/. The HTML export renders labels as text, never interpolates HTML.

Docs, versioned​

The docs site now ships per-release versions: 1.0.0 is the default, 0.8.0 stays available as an archive, and Next tracks what is landing after 1.0.0. See the docs — and benchmarks for how every number is measured and reproduced.

astria is developed at Nodesify/astria — issues, the worked examples, and the head-to-head benchmark data all live in the repo. It is built by Nodesify.