#### Problem to Solve The preview (https://gitlab.com/groups/gitlab-org/rust/-/epics/10+) of the Knowledge Graph will have validated our core technology and user experience with GitLab team members. The next critical step is to make this powerful tool available to the broader developer community. A manual, script-based installation and a partial call graph are sufficient for internal testing, but do not meet the bar for a polished public release. To fulfill our vision of a ubiquitous, extensible code intelligence tool, we must provide a smooth installation experience, a highly accurate and complete call graph for major languages, and the security assurances that come with a formal review. #### Proposed Solution We will execute a **Public Launch** of the GitLab Knowledge Graph. This launch will deliver a production-ready `gkg` binary that is easily installable via familiar package managers like Homebrew. The key feature of this release is the completion of **Phase 3: Cross-File Reference Resolution**, providing a precise and comprehensive call graph for our most important languages. The IDE extensions will be updated to provide a "one-click" installation experience, automatically downloading and setting up `gkg` for the user. The entire system will undergo a formal security review, and we will publish detailed public documentation to encourage adoption and community contributions. #### Definition of Done **Core Features & Language Support:** - [ ] **Phase 3 Complete:** Full, language-specific cross-file reference resolution is implemented and stable for the primary language set (Python, JS/TS, Ruby, Go, Java, Kotlin), as tracked in https://gitlab.com/groups/gitlab-org/rust/-/epics/9+. - [ ] The call graph is demonstrably accurate, enabling precise "Go to Definition" and "Find References" across the entire project for supported languages. - [ ] The `gkg` binary is stable, with all critical/high bugs discovered during the internal preview period resolved. **Distribution & Installation:** ~~- [ ] A Homebrew formula for `gkg` is created and published, allowing for `brew install gkg` on macOS.↵~~ ~~- [ ] A Windows package manager solution (e.g., Winget, Chocolatey) is available for easy installation on Windows.~~ - [x] All release binaries for all target platforms (macOS, Linux, Windows) are fully signed with GitLab's production certificates (https://gitlab.com/gitlab-org/rust/knowledge-graph/-/issues/65+). - [x] MacOS - [ ] Windows (blocked) - [x] Linux - [ ] The VS Code and JetBrains extensions are updated to detect if `gkg` is not installed and can prompt the user to automatically download and install it, providing a seamless "one-click" setup experience. **Security & Documentation:** - [ ] A formal security review of the `gkg` binary, its HTTP server, and its interaction with the file system has been completed, and all critical findings have been addressed (https://gitlab.com/gitlab-org/rust/knowledge-graph/-/issues/66+). - [ ] Public-facing documentation is published (e.g., on `docs.gitlab.com` or a dedicated handbook page). - [x] Knowledge Graph Specific Documentation Website https://gitlab.com/gitlab-org/rust/knowledge-graph/-/issues/12+ - [x] Documentation includes: - Clear installation instructions for all platforms. - A user guide on how to use the tool and the debug UI. - An architectural overview. - Initial documentation for the Graph Extractor Language (Gel) to showcase extensibility. - [ ] `CONTRIBUTING.md` and other community health files are in place to encourage contributions. #### Related Epics & Issues * **Core Indexer Epic:** https://gitlab.com/groups/gitlab-org/-/epics/17517+ * **Phase 3 (Cross-File References):** https://gitlab.com/groups/gitlab-org/rust/-/epics/9+ * **Distribution & Installation:** https://gitlab.com/groups/gitlab-org/rust/-/epics/3+ * **IDE Integration:** https://gitlab.com/groups/gitlab-org/rust/-/epics/7+ * **Server-Side Architecture:** https://gitlab.com/groups/gitlab-org/-/epics/17518+ * **Security Review:** https://gitlab.com/gitlab-org/rust/knowledge-graph/-/issues/66+