trusty-analyze 0.2.0

Sidecar code-analysis daemon for trusty-search: complexity, smells, quality, facts
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

/*
 * Why: All UI components hit the same analyzer REST surface; centralizing fetch
 * logic gives us one place to handle errors, base URL, and JSON parsing.
 * The analyzer serves the bundle at /ui and the API at flat paths
 * (/health, /indexes, /facts, ...) so requests are always same-origin in
 * production. In `vite dev`, vite.config.js proxies the API paths through to
 * 127.0.0.1:7879.
 * What: Thin wrappers returning parsed JSON or throwing on non-2xx.
 * Test: Console-call api.health() and confirm shape matches /health.
 */

const BASE =
  typeof window !== 'undefined' && window.__ANALYZER_BASE__
    ? window.__ANALYZER_BASE__
    : '';

async function request(path, opts = {}) {
  const res = await fetch(BASE + path, {
    headers: { 'Content-Type': 'application/json', ...(opts.headers || {}) },
    ...opts
  });
  if (!res.ok) {
    let detail = '';
    try {
      detail = await res.text();
    } catch {
      /* ignore */
    }
    throw new Error(`${res.status} ${res.statusText}: ${detail}`);
  }
  if (res.status === 204) return null;
  const ct = res.headers.get('content-type') || '';
  if (ct.includes('application/json')) return res.json();
  return res.text();
}

export const api = {
  health: () => request('/health'),
  indexes: () => request('/indexes'),
  complexityHotspots: (id, topK = 20) =>
    request(`/indexes/${encodeURIComponent(id)}/complexity_hotspots?top_k=${topK}`),
  smells: (id, category) =>
    request(
      `/indexes/${encodeURIComponent(id)}/smells${category ? '?category=' + encodeURIComponent(category) : ''}`
    ),
  quality: (id) => request(`/indexes/${encodeURIComponent(id)}/quality`),
  refactorSuggestions: (id, { minSeverity = 'low', topK = 20 } = {}) => {
    const qs = new URLSearchParams({
      min_severity: minSeverity,
      top_k: String(topK)
    });
    return request(`/indexes/${encodeURIComponent(id)}/refactor-suggestions?${qs}`);
  },
  clusters: (id, { k = 8, method = 'bow' } = {}) =>
    request(`/indexes/${encodeURIComponent(id)}/clusters?k=${k}&method=${method}`),
  listFacts: (subject, predicate) => {
    const qs = new URLSearchParams();
    if (subject) qs.set('subject', subject);
    if (predicate) qs.set('predicate', predicate);
    const tail = qs.toString();
    return request(`/facts${tail ? '?' + tail : ''}`);
  },
  upsertFact: (fact) =>
    request('/facts', { method: 'POST', body: JSON.stringify(fact) }),
  deleteFact: (id) =>
    request(`/facts/${encodeURIComponent(id)}`, { method: 'DELETE' })
};