ua-status

name	ua-status
description	Check whether the knowledge graph is current relative to the git HEAD. Run before querying the graph to avoid reasoning from stale data.
argument-hint	[]

/ua-status

Lightweight preflight check. Compares the commit hash stored in .understand-anything/meta.json against the current git HEAD. No LLM invocation — pure shell commands.

Instructions

1. Check meta.json exists:

   [ -f .understand-anything/meta.json ] || { echo "No knowledge graph found. Run /understand first to create one."; exit 0; }
   

2. Read the stored hash and timestamp:

   STORED_HASH=$(node -p "JSON.parse(require('fs').readFileSync('.understand-anything/meta.json','utf8')).gitCommitHash")
   ANALYZED_AT=$(node -p "JSON.parse(require('fs').readFileSync('.understand-anything/meta.json','utf8')).lastAnalyzedAt")
   

3. Get the current HEAD:

   CURRENT_HASH=$(git rev-parse HEAD 2>/dev/null) || { echo "Cannot check git status — verify git is available and this is a git repository."; exit 0; }
   

4. If hashes match: print ✓ Knowledge graph is current (commit ${STORED_HASH:0:8}, analyzed ${ANALYZED_AT:0:10}). and STOP.

5. If stale, get the changed file list:

   CHANGED=$(git diff "$STORED_HASH".."$CURRENT_HASH" --name-only 2>/dev/null)
   COUNT=$(echo "$CHANGED" | grep -c . 2>/dev/null || echo 0)
   

6. Print the staleness warning:

   ⚠️  Knowledge graph is stale.
       Last analyzed: {ANALYZED_AT:0:10} (commit {STORED_HASH:0:8})
       Current HEAD:  {CURRENT_HASH:0:8}
       Files changed: {COUNT}
   
   {if COUNT <= 10: list each changed file as "  - {filename}"}
   {if COUNT > 10: list first 10 files then "  ... and {COUNT-10} more"}
   
   Run /understand to refresh before querying. Answers from /ua-chat or /understand-chat
   may not reflect recent changes until the graph is updated.