Graph-It-Live

Tool annotations

27/49 tools have annotations

Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.

All four hints declared on every tool

22/49 tools missing one or more hints — graph-it-live_find_referencing_files (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); graph-it-live_analyze_dependencies (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); graph-it-live_crawl_dependency_graph (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +19 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.

For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.

Tool annotations match behaviour

22 read-only tools perform write/delete/exec — graphitlive_analyze_dependencies (line 76: fs.appendFileSync(DEBUG_LOG_PATH, line)); graphitlive_crawl_dependency_graph (line 76: fs.appendFileSync(DEBUG_LOG_PATH, line)); graphitlive_find_referencing_files (line 76: fs.appendFileSync(DEBUG_LOG_PATH, line))

Either remove the readOnlyHint:true annotation, or remove the write/delete call from the tool handler.

Destructive tools are labelled

1 tool perform destructive updates without destructiveHint — graphitlive_set_workspace deletes at line 47 (fs.unlinkSync(DEBUG_LOG_BACKUP))

Add destructiveHint:true to any tool whose handler calls .delete(), .upsert(), .update(), unlink, rm, DELETE, DROP, REPLACE INTO, or any operation that overwrites existing data.

Descriptions match behaviour

6 tools describe read intent but their handlers mutate — graphitlive_analyze_dependencies (line 76: fs.appendFileSync(DEBUG_LOG_PATH, line)); graphitlive_get_symbol_callers (line 76: fs.appendFileSync(DEBUG_LOG_PATH, line)); graphitlive_review_pr (line 76: fs.appendFileSync(DEBUG_LOG_PATH, line))

Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.

Dependency freshness

2/19 production deps stale: cytoscape-fcose@2023-01-17 (3.7y), reactflow@2024-06-20 (2.2y)

Tool description accuracy

3 tools have description/behavior mismatches: graphitlive_analyze_dependencies: description implies read-only but handler writes/deletes/executes; graphitlive_review_pr: description implies read-only but handler writes/deletes/executes; graphitlive_graph_context: description implies read-only but handler writes/deletes/executes

Update tool descriptions to accurately reflect all capabilities — especially write, delete, or execute operations.