detection

name	detection
description	Use when detecting a project's programming language and documentation framework from filesystem markers — package.json, Cargo.toml, pyproject.toml, mkdocs.yml, etc.

Stack Detection

Language Detection

Scan the project root for these marker files. First match wins; if multiple match, use the one with the highest priority.

Priority	Marker File	Language
1	Cargo.toml	Rust
2	go.mod	Go
3	pyproject.toml, setup.py, setup.cfg, Pipfile	Python
4	tsconfig.json	TypeScript
5	package.json (without tsconfig)	JavaScript
6	*.csproj, *.sln	C#
7	pom.xml, build.gradle, build.gradle.kts	Java/Kotlin
8	None of the above	Generic

When config.language is not "auto", skip detection and use the configured value.

Framework Detection

Scan for documentation framework config files. First match wins.

Priority	Marker File	Framework	Doc Root
1	mkdocs.yml or mkdocs.yaml	MkDocs	docs/ (or per mkdocs.yml docs_dir)
2	.vitepress/config.ts or .vitepress/config.js or .vitepress/config.mts	VitePress	directory containing .vitepress/
3	docusaurus.config.js or docusaurus.config.ts	Docusaurus	docs/ (or per config docsDir)
4	conf.py (with extensions containing sphinx)	Sphinx	source/ or directory containing conf.py
5	docs/ directory exists with .md files	Plain Markdown	docs/
6	README.md only	Plain Markdown	project root

When config.framework is not "auto", skip detection and use the configured value.

Detection Output

Return a JSON object:

{
  "language": "typescript",
  "languageConfidence": "high",
  "framework": "vitepress",
  "frameworkConfidence": "high",
  "docRoot": "docs/",
  "markers": ["tsconfig.json", ".vitepress/config.ts"]
}

Confidence levels:

• high: marker file found and unambiguous
• medium: marker found but could be misidentified (e.g., JS project with stale tsconfig)
• low: fallback / guessing