KGCompass

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 35 Open GitHub ↗

Multi-source retrieval and function localization for repository repair

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# KGCompass

KGCompass is a fixed-budget function-level repair-context system for
issue-driven repository repair. It builds a time-safe repository knowledge
graph, mines file-local paths inside grounded files, and exports compact
candidate windows with typed issue-to-code paths.

This repository is the public artifact branch for the KGCompass manuscript. It
keeps the demo, core scripts, and the paper-facing ledgers needed to audit the
reported RQ1-RQ4 claims. Older diagnostics, unreported ablations, and partial
intermediate results are intentionally omitted from `artifacts/results/`.

## Repository Layout

| Path | Purpose |
| --- | --- |
| `app.py`, `demo_web.py`, `static/`, `templates/` | Local web demo. |
| `kgcompass/` | Core KGCompass localization and repair modules. |
| `scripts/` | Workspace scripts used to build localization and summary ledgers. |
| `artifacts/` | Paper-facing result ledgers, prompts, audit notes, and verifier. |
| `artifacts/results/` | Small committed ledgers aligned with manuscript tables and claims. |
| `artifacts/RESULT_TRACEABILITY.md` | Mapping from manuscript claims to artifact files and rerun commands. |

## Quick Start

Create a Python environment:

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

Run the paper-side verifier:

```bash
python3 artifacts/scripts/verify_paper_results.py
```

Expected result:

```json
{
  "ok": true,
  "scope": "all",
  "failed": []
}
```

The verifier reads only files committed under `artifacts/results/` and checks
the manuscript-facing values for the ground-truth mapping, RQ1 controlled
context windows, RQ2 LLM and released-localizer fusion rows, RQ3
patch-derived repair-context coverage and mechanism accounting, RQ4 full-500
repair outcomes, and leakage/sensitivity statements.

## Paper-Facing Results

The main ledgers are:

- `artifacts/results/tse_gt_mapping_v6.tsv`
- `artifacts/results/path_mining_file_expansion_ablation_20260531.tsv`
- `artifacts/results/llm_pathmined_kg_ht10_20260531.tsv`
- `artifacts/results/glm5_baseline_fusion_controls_top10_20260614.tsv`
- `artifacts/results/external_verified_loc_baselines_cosil_release_20260601.tsv`
- `artifacts/results/qwen25_32b_kgcompass_fusion_20260601.tsv`
- `artifacts/results/local_open_models_pathmined_top10_5p5_summary.tsv`
- `artifacts/results/glm5_pathmined_kg_complementarity_20260531.json`
- `artifacts/results/rq3_file_local_path_mining_summary.tsv`
- `artifacts/results/patch_derived_context_summary_20260702.tsv`
- `artifacts/results/claudecode_context_probe_glm5_20260531.tsv`

See `artifacts/RESULT_TRACEABILITY.md` for the complete file-to-claim mapping
and the full-workspace commands used to produce the ledgers.

## Web Demo

Install the smaller web-demo dependency set if you only want to run the UI:

```bash
pip install -r requirements_web.txt
python3 demo_web.py
```

Or start the Flask app directly:

```bash
python3 app.py
```

The web app writes generated outputs to `web_outputs/` at runtime. Those outputs
are intentionally ignored by the repository.

KGCompass

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README