@nodesify/astria 1.0.5 → 1.0.7

package/skills/skill-kiro.md

@@ -36,4 +36,6 @@ The `.kiro/steering/astria.md` steering file enforces graph usage. You MUST:
 
 ## After editing code
 
-Run `astria update .` to keep the graph current.
+If git hooks are installed (`astria hook install`), the graph refreshes itself after every commit — this step is already done.
+
+Otherwise run `astria update .` to keep the graph current (`--quiet --if-stale 10` skips while fresh). To share the graph, `astria export --format html --out graph.html` writes a self-contained interactive bubble viewer — click to expand, search to jump, click a node to focus its relation-labeled neighbors.

package/skills/skill-opencode.md

@@ -41,4 +41,6 @@ When `.astria/` exists, the astria plugin intercepts `view`, `grep`, `glob`, `ls
 
 ## After editing code
 
-Run `astria update .` to keep the graph current.
+If git hooks are installed (`astria hook install`), the graph refreshes itself after every commit — this step is already done.
+
+Otherwise run `astria update .` to keep the graph current (`--quiet --if-stale 10` skips while fresh). To share the graph, `astria export --format html --out graph.html` writes a self-contained interactive bubble viewer — click to expand, search to jump, click a node to focus its relation-labeled neighbors.

package/skills/skill-trae.md

@@ -43,4 +43,6 @@ Only use native file tools AFTER the graph identified the exact files.
 
 ## After editing code
 
-Run `astria update .` to keep the graph current.
+If git hooks are installed (`astria hook install`), the graph refreshes itself after every commit — this step is already done.
+
+Otherwise run `astria update .` to keep the graph current (`--quiet --if-stale 10` skips while fresh). To share the graph, `astria export --format html --out graph.html` writes a self-contained interactive bubble viewer — click to expand, search to jump, click a node to focus its relation-labeled neighbors.

package/skills/skill.md

@@ -140,6 +140,11 @@ Optional enrichment (each needs a semantic backend: `ASTRIA_LLM_API_KEY` /
   symbols to concept nodes from other files as INFERRED edges
   (`context='deep'`). Cached per file content hash — an unchanged file is
   never re-billed.
+- `--judge jev` — TypeSafe decision layer over the backend: gates trivial
+  files before they cost engine calls, re-judges relations/node types from
+  the allowlists, drops spurious edges, and stores a calibrated
+  `confidence_score` on semantic edges. Needs an explicit backend (Jev
+  cannot generate extractions itself); judge calls count toward the budget.
 - `ASTRIA_LLM_BUDGET` caps total tokens for a run; every backend response's
   usage block is counted and printed after the run.
 
@@ -149,6 +154,16 @@ Incremental rebuild — only re-extracts files that changed (SHA-256 detection).
 
 Much faster than `run` for existing projects.
 
+Options (all also available on `run`, except `--quiet`/`--if-stale`):
+- `--no-dedup` — skip near-duplicate node merging
+- `--backend <name>` / `--model <name>` — semantic LLM backend (claude, openai, gemini) and model
+- `--judge jev` — optional decision layer over the backend (gate, verify, calibrated edge confidence)
+- `--embed` — compute local embeddings: `similar_to` edges + semantic query recall
+- `--label-communities` — name changed communities thematically (one LLM call per changed community)
+- `--deep` — second extraction tier: LLM-linked cross-file concept edges
+- `--quiet` — suppress progress lines and the token benchmark (for hooks/CI)
+- `--if-stale <minutes>` — skip the rebuild entirely when the graph is fresher than N minutes
+
 ### `astria health [options]`
 
 Code-health report (heuristic 0-100 score): unreachable-symbol candidates,
@@ -224,7 +239,11 @@ Repeated queries leave a trace: node pairs that keep coming up across distinct q
 
 ### MCP server
 
-`astria mcp --graph .` runs an MCP stdio server exposing the graph to AI agents with tools: `query_graph` (supports `cursor` continuation and `detail` tiers), `repo_map`, `explain`, `get_neighbors`, `shortest_path`, `affected`, `god_nodes`, `list_communities`, `graph_stats`.
+`astria mcp --graph .` runs an MCP stdio server exposing the graph to AI agents with tools: `query_graph` (supports `cursor` continuation and `detail` tiers), `repo_map`, `explain`, `get_neighbors`, `shortest_path`, `affected`, `god_nodes`, `list_communities`, `graph_stats`, `health`.
+
+### Git hooks
+
+`astria hook install|uninstall|status` — per-machine git hooks that run a quiet, freshness-throttled `astria update .` after every code commit and branch switch, so the graph stays current without anyone remembering to run `update`. Skips during rebase/merge; re-run `astria hook install` after upgrading astria to refresh the installed template. `astria hook-guard <mode>` installs the editor PreToolUse guard (`search | read | gemini`).
 
 
 ### `astria stats [options]`
@@ -237,14 +256,19 @@ Graph staleness check: fresh/stale/very_stale with age in minutes.
 
 ### `astria export [options]`
 
-Export graph to JSON, HTML, GraphML, or Cypher (Neo4j).
+Export graph to JSON, HTML, GraphML, SVG, Cypher (Neo4j), or FalkorDB Cypher.
 
 ```
 astria export --format html --out graph.html
+astria export --format svg --out graph.svg              # static, embeds anywhere
 astria export --format graphml --out graph.graphml
-astria export --format cypher --out astria.cypher   # idempotent MERGE script for Neo4j
+astria export --format cypher --out astria.cypher       # idempotent MERGE script for Neo4j
+astria export --format falkordb --out astria.cypher     # Cypher for FalkorDB/Redis
 ```
 
+`--format html` writes a self-contained interactive viewer (opens as community bubbles; click to expand, search symbols or community names to jump, focus a node to see its relation-labeled neighbors, "All nodes" for the full graph). `--mode standard` allows up to 5,000 nodes; `--mode large` lifts the cap. For a filesystem-hierarchy view instead, `astria tree --out tree.html`.
+`--neo4j-push <bolt://host:port>` pushes the cypher export live to Neo4j; `--redis-push <host:port>` pushes a falkordb export to FalkorDB/Redis. (Obsidian is a wiki format: `astria wiki --format obsidian`.)
+
 ### `astria wiki [options]`
 
 Wikipedia-style markdown wiki of the graph: `index.md` plus one article per community and per god node, cross-linked with relative markdown links. Readable by any agent without the CLI — point an agent at `.astria/wiki/index.md` and it navigates by reading files.
@@ -257,7 +281,9 @@ astria wiki --format obsidian --out my-vault   # Obsidian vault + canvas
 
 ## Post-Edit Protocol
 
-After modifying code files in a session with an active graph:
+With git hooks installed (`astria hook install`), the graph refreshes itself after every commit — nothing to do.
+
+After modifying code files in a session with an active graph (no hooks):
 
 ```bash
 astria update .