{"report":{"v":1,"package":"trace-mcp","version":"3.44.1","ranAt":"2026-11-16T11:30:49.424Z","install":{"ok":true,"bin":"trace-mcp","integrity":"sha512-F53wWLO97sJQQLXCcEwiA30jlCUTEdNle9K+pR8R923n7roZn1EWX/3QbTVF7aeu1ErFETDg1LV07M7Hu4bFFw==","deps":287,"scripts":["@parcel/watcher","onnxruntime-node","protobufjs","trace-mcp"],"bins":["trace","trace-mcp"],"license":"MIT","engines":"node >=22.0.0","repository":"https://github.com/nikolai-vysotskyi/trace-mcp"},"start":{"ok":true,"ms":653,"serverName":"trace","serverVersion":"3.44.1","protocol":"2025-06-18","stderr":"2423.db\",\"projectRoot\":\"/\",\"msg\":\"LocalBackend: read-only fallback — serving daemon-indexed snapshot, indexing stack idle\"}\n{\"level\":30,\"time\":1794828677805,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"preset\":\"minimal\",\"tools\":20,\"msg\":\"Tool preset active\"}\n{\"level\":30,\"time\":1794828677812,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"msg\":\"Migration: added updated_at column to decisions table\"}\n{\"level\":30,\"time\":1794828677867,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"dbPath\":\"/tmp/.trace/index/-8a5edab28263-session-702a2423.db\",\"projectRoot\":\"/\",\"msg\":\"LocalBackend started\"}\n{\"level\":30,\"time\":1794828677868,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"mode\":\"local\",\"projectRoot\":\"/\",\"idleTimeoutMs\":1800000,\"daemonStabilityMs\":30000,\"msg\":\"StdioSession bootstrapped\"}\n{\"level\":30,\"time\":1794828677868,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"port\":3741,\"timeoutMs\":20000,\"msg\":\"StdioSession: attempting daemon auto-spawn in background\"}\n{\"level\":30,\"time\":1794828677871,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"profile\":\"generic\",\"msg\":\"StdioSession: resolved client profile\"}\n{\"level\":30,\"time\":1794828677893,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"port\":3741,\"msg\":\"Auto-spawning daemon\"}\n{\"level\":30,\"time\":1794828678464,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"port\":3741,\"strategy\":\"detached\",\"msg\":\"Auto-spawned daemon is up\"}\n{\"level\":30,\"time\":1794828678464,\"pid\":101,\"hostname\":\"1c4e4a03f424\",\"name\":\"trace-mcp\",\"msg\":\"StdioSession: daemon is reachable after auto-spawn\"}\n"},"tools":[{"name":"get_index_health","description":"Get index status, statistics, health, and pipeline progress (indexing, summarization, embedding). Includes the session projectRoot; when the index is empty, next_steps names the empty root and points at list_projects + call_project_tool for other registered projects. Read-only, no side effects. Use to verify the index is ready before running queries. Returns JSON: { status, stats, projectRoot, next_steps?, config, warnings, pipelineProgress, embedding }.","params":[]},{"name":"register_edit","description":"Notify trace-mcp that a file was edited. Reindexes the single file and invalidates search caches. Call after Edit/Write to keep index fresh — much lighter than full reindex. Also flags duplicate symbols — if `_duplication_warnings` appears, you may be recreating existing logic; review them. Each one is reported once per file, not on every edit; `check_duplication` re-asks. Mutates the index; idempotent. Returns JSON: { status, file, totalFiles, indexed, _duplication_warnings? }.","params":["file_path"]},{"name":"get_project_map","description":"Get project overview: detected frameworks, languages, file counts, structure. Read-only, no side effects. Call with summary_only=true at session start to orient yourself before diving into code. Use instead of manual ls/find. Returns JSON: { frameworks, languages, fileCount, symbolCount, structure }.","params":["summary_only"]},{"name":"search","description":"Search symbols by name, kind, or text. Use instead of Grep for functions, classes, methods, variables. For raw text/comment search use search_text; for references to a known symbol use find_usages. Read-only. Returns JSON: { items: [{ symbol_id, name, kind, fqn, signature, file, line, score }], total, search_mode } — mode-specific shape when mode!=single. Supports `output_format: \"toon\"`.","params":["query","kind","language","file_pattern","implements","extends","decorator","fuzzy","fuzzy_threshold","max_edit_distance","semantic","semantic_weight","fusion","limit","offset","mode","drill_from","retriever","detail_level","output_format"]},{"name":"suggest_queries","description":"Onboarding helper: shows top imported files, most connected symbols (PageRank), language stats, and example tool calls. Call this first when exploring an unfamiliar project. For a structured project map use get_project_map instead. Read-only. Returns JSON: { topFiles, topSymbols, languageStats, exampleQueries }.","params":[]},{"name":"get_symbol","description":"Look up a symbol by symbol_id or FQN and return its source code. Use instead of Read when you need one specific function/class/method — returns only the symbol, not the whole file. For multiple symbols at once, prefer get_context_bundle. Read-only. Returns JSON: { symbol_id, name, kind, fqn, signature, file, line_start, line_end, source }.","params":["symbol_id","fqn","max_lines","verify_against_git"]},{"name":"get_outline","description":"Get all symbols for a file (signatures only, no bodies) — cheaper than Read for understanding a file before editing. Follow up with get_symbol to read one symbol's source. `nested: true` expands large top-level symbols (default ≥100 LOC) into inner declarations, each carrying `parentId` + `depth` (max 3). Accepts project-relative or absolute file paths. For files in other registered projects, use call_project_tool. Read-only. Returns JSON: { path, language, symbols: [{ symbolId, name, kind, signature, lineStart, lineEnd, parentId?, depth? }] }. Supports `output_format: \"toon\"`.","params":["path","detail_level","nested","min_loc_for_nesting","output_format"]},{"name":"get_change_impact","description":"Full change impact report: risk score + mitigations, breaking change detection, enriched dependents (complexity, coverage, exports), module groups, affected tests, co-change hidden couplings. Pass symbol_ids to scope to changed symbols. Use before modifying code. For a quick risk score alone use assess_change_risk; for who-calls-what use get_call_graph. compact pages results; bundle recalls. Read-only. Returns JSON: { risk, dependents, affectedTests, breakingChanges, totalAffected }.","params":["file_path","symbol_id","fqn","symbol_ids","decorator_filter","depth","max_dependents","compact","bundle"]},{"name":"get_context_bundle","description":"Get a symbol's source code + its import dependencies + optional callers, packed within a token budget. Supports batch queries with shared-import deduplication. Use instead of chaining get_symbol calls. For a single symbol without imports, use get_symbol — lighter. Read-only. Returns JSON: { primary: [{ symbol_id, file, source }], imports: [{ file, source }], token_usage }.","params":["symbol_id","symbol_ids","fqn","include_callers","token_budget","output_format"]},{"name":"get_feature_context","description":"Search code by keyword/topic → returns ranked source snippets within a token budget. Use when you need to READ actual code for a concept or feature. For structured task context with tests and entry points use get_task_context instead; for symbol metadata without source use search. Read-only. Returns JSON (default) or Markdown: { items: [{ symbol_id, name, file, source, score }], token_usage } | { content: \"...markdown...\" }. Supports `output_format: \"toon\"`. Capped by `memory.recall.timeoutMs` (default 5000ms); on timeout returns `{ items: [], token_usage, degraded: true }`.","params":["description","token_budget","detail_level","output_format"]},{"name":"get_task_context","description":"All-in-one context for starting a dev task: execution paths, tests, entry points, adapted by task type. Use as your FIRST call when beginning any new task — replaces manual chaining of search → get_symbol → Read. For narrower feature-code lookup use get_feature_context instead. Read-only. Returns JSON (default) or Markdown.","params":["task","token_budget","focus","include_tests","detail_level","output_format"]},{"name":"find_usages","description":"Find all references to a symbol or file (imports, calls, renders, dispatches). Use instead of Grep for symbol usages — semantic, not text matches. For raw text use search_text; for a bidirectional call graph use get_call_graph. Weakly-grounded `text_matched` edges into a name-colliding target are dropped by default (phantom god-node filter); `include_ambiguous_text_matched: true` keeps them. Read-only. Returns JSON: { references: [{ edge_type, resolution_tier, file, symbol }], total, truncated?, ambiguous_filtered? } — page caps at 50, `total` counts all.","params":["symbol_id","fqn","file_path","detail_level","include_ambiguous_text_matched","limit"]},{"name":"get_call_graph","description":"Build a bidirectional call graph centered on a symbol (who calls it + what it calls). Each branch keeps its direction: depth 2 = callers of callers, callees of callees. Use to understand control flow through a function. For flat list of all references use find_usages instead. Read-only. Returns JSON: { root: { symbol_id, name, calls: [...], called_by: [...] } }.","params":["symbol_id","fqn","depth"]},{"name":"search_text","description":"Full-text search across all indexed files. Supports regex, glob file patterns, language filter. Use for finding strings, comments, TODOs, config values, error messages — anything not captured as a symbol. Skips .env files: secret values are never searched or returned, use get_env_vars for env keys. For symbol search (functions, classes) use search instead. Read-only. Returns JSON: { files: [{ file, language, hits: [{ line, column, match, context }] }], total_matches } — hits grouped per file, so a long path is paid once. Pass `grouping: \"flat\"` for the ungrouped matches[] shape.","params":["query","is_regex","file_pattern","language","max_results","context_lines","case_sensitive","timeout_ms","grouping"]},{"name":"get_diagnostics","description":"Execute type-checker (tsc, mypy, pyright) and map errors to enclosing AST symbols. Read-only.","params":["file_path","checker","max_per_file","max_files","timeout_ms","reduce_output"]},{"name":"mine_sessions","description":"Mine Claude Code / Claw Code session logs for architectural decisions, tech choices, bug root causes, and preferences. Strategies: \"regex\" (default, free, ~20-40% recall), \"llm\" (higher recall, costs tokens), \"hybrid\" (regex + LLM safety net). Skips already-mined sessions unless force=true. Mutates the decision store; idempotent. Returns JSON: { mined, decisions_extracted, sessions_processed, strategy?, llm_sessions?, llm_decisions_extracted? }.","params":["project_root","force","min_confidence","review_threshold","reject_threshold","strategy","incremental_cursor"]},{"name":"remember_decision","description":"Live agent write into the decision knowledge graph. Confidence-scores the input and routes it through the memoir review queue: high-confidence rows enter the active graph immediately, mid-confidence rows queue for human approval, low-confidence rows are dropped without persistence. Per-session dedup + rate-limit. Use during a session to capture decisions in real time. For manual high-confidence writes use add_decision; for post-hoc extraction from session logs use mine_sessions. Returns JSON: { id, review_status, confidence, deduplicated? }.","params":["title","content","type","service_name","symbol_id","file_path","tags","session_id","git_branch"]},{"name":"query_decisions","description":"Query the decision knowledge graph. Filter by type, subproject, code symbol, file path, tag, or time — answers \"why was this architecture chosen?\" with the actual decision record. Defaults to approved decisions; use include_pending or review_status for other tiers. Read-only. Returns JSON: { decisions: [{ id, title, type, content, tags, review_status, cluster_ids? }], clusters_summary?, total_results }. Supports `output_format: \"toon\"`.","params":["type","service_name","symbol_id","file_path","tag","search","as_of","include_invalidated","include_pending","review_status","git_branch","order_by","limit","verify","verification","index_only","output_format"]},{"name":"invalidate_decision","description":"Mark a decision as no longer valid. The decision remains in the knowledge graph for historical queries but is excluded from active queries. Use when a decision is superseded or reversed. Mutates the decision store; idempotent. Returns JSON: { invalidated: { id, title, valid_until } }.","params":["id","valid_until"]},{"name":"get_preset_info","description":"Show active tool preset, available presets, which tools are registered in this session, and which are deferred (loadable via load_tools). Read-only. Returns JSON: { active_preset, registered_tools, tool_names, available_presets, deferred_tools }.","params":[]},{"name":"load_tools","description":"Load tools this session's preset deferred, by preset name and/or explicit tool names. Call with no arguments to list what is deferred. Emits notifications/tools/list_changed and returns the loaded tools' schemas, so they are usable even if your client ignores that notification (call them through `batch`). Returns JSON: { loaded, already_loaded, unknown, blocked, tools, hint }.","params":["preset","tools"]},{"name":"get_session_analytics","description":"Analyze AI agent session logs: token usage, prompt-cache hit rate (blended and split by provider/model), cost breakdown by tool/server, top files, models used. Parses Claude Code JSONL logs automatically. Read-only. For waste detection use get_optimization_report; for cost trends use get_usage_trends. Returns JSON: { sessionsCount, totals, cacheHitRate: { blended, byModel, byProvider }, byToolServer, topTools, topFiles, modelsUsed }.","params":["period","session_id"]},{"name":"get_optimization_report","description":"Detect token waste patterns in AI agent sessions: repeated file reads, Bash grep instead of search, large file reads, unused trace-mcp tools. Provides savings estimates. Read-only. For usage/cost overview use get_session_analytics; for A/B savings comparison use get_real_savings. Returns JSON: { patterns: [{ type, description, savings_estimate }], total_waste }.","params":["period"]},{"name":"get_coverage_report","description":"Technology profile of the project: detected frameworks/ORMs/UI libs from manifests (package.json, composer.json, etc.), which are covered by trace-mcp plugins, and coverage gaps. Read-only. Returns JSON: { detected, covered, gaps }.","params":[]},{"name":"get_real_savings","description":"A/B comparison: how many tokens could be saved by using trace-mcp instead of raw Read/Bash file reads. Per-file breakdown. Read-only. For pattern-based waste detection use get_optimization_report instead. Returns JSON: { files: [{ file, raw_tokens, compact_tokens, savings }], total_savings }.","params":["period"]},{"name":"get_usage_trends","description":"Daily token usage time-series: sessions, tokens, estimated cost, tool calls, prompt-cache hit rate per day. For spotting cost spikes. Read-only. For detailed session breakdown use get_session_analytics instead. Returns JSON: { days, daily: [{ date, sessions, tokens, cost_usd, tool_calls, cache_hit_rate, cache_hit_rate_by_provider }], totals }.","params":["days"]},{"name":"get_session_stats","description":"Token savings stats for this session: per-tool call counts, estimated token savings, reduction percentage, dedup savings, and per-tool latency (p50/p95/max/error_rate). Read-only. Returns JSON: { session: { ..., latency_per_tool }, cumulative, dedup_saved_tokens, report }.","params":[]},{"name":"plan_turn","description":"Opening-move router for new tasks. Combines BM25/PageRank search + session journal (negative evidence + focus signals) + framework-aware insertion-point suggestions + change-risk + turn-budget advisor into ONE call. Returns verdict (exists/partial/missing/ambiguous), confidence, ranked targets with provenance, scaffold hints when missing, and recommended next tool calls. Call this FIRST on a new task to break the empty-result hallucination chain. Read-only. For broader task context with source code use get_task_context instead. Returns JSON: { verdict, confidence, targets, scaffoldHints, nextSteps }.","params":["task","intent","max_targets","skip_risk"]},{"name":"batch","description":"Execute multiple trace-mcp tools in a single MCP request. Dispatches any registered tool by name, including tools this session's preset defers — so a deferred tool is callable here without a load_tools round-trip (tools.exclude stays a hard restriction). Use to reduce round-trips when you need several independent queries (e.g., get_outline for 3 files, or search + get_symbol together). Read-only (delegates to other tools). Returns JSON: { batch_results: [{ tool, result }], total }.","params":["calls"]}],"toolsHash":"6903cb8d5f5a29c19285df659fd77efc18bdea94c77e9b29d7e354ad72a3cdde","wrote":["/tmp/.trace/activity.db","/tmp/.trace/telemetry-state.json","/tmp/.trace/daemon.log","/tmp/.trace/decisions.db-shm","/tmp/.trace/.config.json","/tmp/.trace/state.db","/tmp/.trace/decisions.db","/tmp/.trace/state.db-wal","/tmp/.trace/state.db-shm","/tmp/.trace/index/-8a5edab28263-session-702a2423.db","/tmp/.trace/index/-8a5edab28263-session-702a2423.db-shm","/tmp/.trace/index/-8a5edab28263-session-702a2423.db-wal","/tmp/.trace/activity.db-shm","/tmp/.trace/activity.db-wal","/tmp/.trace/sessions/8a5edab28263-snapshot.json","/tmp/.trace/decisions.db-wal","/tmp/.trace/daemon.pid"],"callsAt":"2026-11-16T11:31:19.898Z","calls":[{"tool":"get_index_health","ok":true,"ms":8,"bytes":2852},{"tool":"get_project_map","ok":true,"ms":3,"bytes":476},{"tool":"get_symbol","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: {\"error\":\"Symbol not found (session root has empty index)\",\"projectRoot\":\"/\",\"indexFiles\":0,\"reason\":\"filesystem_root_session\",\"message\":\"Session is running at filesystem root ('/'). Relative paths ca"},{"tool":"get_change_impact","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: {\"error\":{\"code\":\"VALIDATION_ERROR\",\"message\":\"No file_path, symbol_id, fqn, or symbol_ids provided — specify at least one\"}}"},{"tool":"get_context_bundle","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: {\"error\":{\"code\":\"VALIDATION_ERROR\",\"message\":\"Provide symbol_id, symbol_ids, or fqn\"}}"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["www.google-analytics.com","registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":["www.google-analytics.com"],"flags":[],"tools":29,"wrote":17,"callsTried":5,"callsAnswered":2,"callContacts":[]},"history":[{"package":"trace-mcp","version":"3.44.1","ranAt":"2026-11-16T11:30:49.424Z","outcome":"started","tools":29,"contacts":1,"flags":0,"serious":0,"toolsHash":"6903cb8d5f5a29c19285df659fd77efc18bdea94c77e9b29d7e354ad72a3cdde"},{"package":"trace-mcp","version":"3.44.0","ranAt":"2026-11-12T17:47:48.048Z","outcome":"started","tools":29,"contacts":1,"flags":0,"serious":0,"toolsHash":"6903cb8d5f5a29c19285df659fd77efc18bdea94c77e9b29d7e354ad72a3cdde"}],"page":"https://bragproof.smaverk.com/r/trace-mcp"}