Files

T

SafiandClaude Opus 4.8 382b669481 Fix remaining #1392 skill bugs: --directed propagation, content-only semantic scope, cache staleness, video update, transcribe robustness

Closes the non-crash tier of #1392 in the Claude-path skill fragments:
- #6/#7: build_from_json/build_merge now take directed=IS_DIRECTED in Step 4, Step 5 rebuild, and the --update merge/diff, with prose telling the agent to substitute IS_DIRECTED like INPUT_PATH (a --directed run no longer silently rebuilds undirected and collapses reciprocal edges)
- #10: semantic extraction only flattens document/paper/image, not code (AST already covers code) so subagents stop re-reading every source file
- #12: .graphify_cached.json is deleted on a cache miss so Part C never merges a stale cache from a prior run
- #11: --update now transcribes changed video files and moves transcripts to documents before the semantic pipeline
- #4/#5/#23: transcribe writes via write_text (no shell redirect), uses GRAPHIFY_WHISPER_MODEL/PROMPT env, status to stderr
- #2/#3: add-watch and exports use $(cat graphify-out/.graphify_python) explicitly; MCP Desktop config documents the absolute interpreter path
- #21: extraction-spec example id namespaced (auth_session_validatetoken)
- #22: query term split keeps tokens >= 3 chars

aider/devin monoliths are pinned by the roundtrip invariant and excluded; their own Step 1 already instructs replacing python3 with the resolved interpreter.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-19 15:37:11 +01:00

3.3 KiB

Raw Blame History

graphify reference: extra exports and benchmark

Load this when the user passed one of the export flags (--wiki, --neo4j, --neo4j-push, --falkordb, --falkordb-push, --svg, --graphml, --mcp), or when the corpus is large enough for the token-reduction benchmark. Each step runs only for its own flag.

Step 6b - Wiki (only if --wiki flag)

Only run this step if --wiki was explicitly given in the original command.

Run this before Step 9 (cleanup) so .graphify_labels.json is still available.

graphify export wiki

Step 7 - Neo4j export (only if --neo4j or --neo4j-push flag)

If --neo4j - generate a Cypher file for manual import:

graphify export neo4j

If --neo4j-push <uri> - push directly to a running Neo4j instance. Ask the user for credentials if not provided:

graphify export neo4j --push bolt://localhost:7687 --user neo4j --password PASSWORD

Default URI is bolt://localhost:7687, default user is neo4j. Uses MERGE - safe to re-run without creating duplicates.

Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)

If --falkordb - generate a Cypher file. The statements are OpenCypher, but FalkorDB's GRAPH.QUERY runs one statement at a time (no bulk script import like Neo4j's cypher-shell), so prefer --falkordb-push to load a graph. Use this only when you want the portable cypher.txt artifact:

graphify export falkordb

If --falkordb-push <uri> - push directly to a running FalkorDB instance. Credentials are optional; ask the user only if the instance requires auth:

graphify export falkordb --push falkordb://localhost:6379

Default URI is falkordb://localhost:6379 (the scheme is informational - redis:// or a bare host:port work too), auth is optional, and the target graph defaults to graphify. Uses MERGE - safe to re-run without creating duplicates.

Step 7b - SVG export (only if --svg flag)

graphify export svg

Step 7c - GraphML export (only if --graphml flag)

graphify export graphml

Step 7d - MCP server (only if --mcp flag)

$(cat graphify-out/.graphify_python) -m graphify.serve graphify-out/graph.json

This starts a stdio MCP server that exposes tools: query_graph, get_node, get_neighbors, get_community, god_nodes, graph_stats, shortest_path. Add to Claude Desktop or any MCP-compatible agent orchestrator so other agents can query the graph live.

To configure in Claude Desktop, add to claude_desktop_config.json. Claude Desktop can't run $(...), and under uv tool install the system python3 can't import graphify — so set command to the absolute interpreter path printed by cat graphify-out/.graphify_python:

{
  "mcpServers": {
    "graphify": {
      "command": "<absolute path from: cat graphify-out/.graphify_python>",
      "args": ["-m", "graphify.serve", "/absolute/path/to/graphify-out/graph.json"]
    }
  }
}

Step 8 - Token reduction benchmark (only if total_words > 5000)

If total_words from graphify-out/.graphify_detect.json is greater than 5,000, run:

graphify benchmark

Print the output directly in chat. If total_words <= 5000, skip silently - the graph value is structural clarity, not token compression, for small corpora.

3.3 KiB Raw Blame History