exactdocs 0.1.0__tar.gz

exactdocs-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+reports/
+
+# Built web UI bundled into the wheel / image (see web/README.md)
+packages/exactdocs/src/exactdocs/_web/
+
+# Local data and secrets
+data/
+*.db
+.env
+.env.*
+!.env.example
+
+# Editors / OS
+.idea/
+.vscode/*
+!.vscode/extensions.json
+.DS_Store
+Thumbs.db
+
+# Claude Code local settings
+.claude/settings.local.json

exactdocs-0.1.0/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.5
+Name: exactdocs
+Version: 0.1.0
+Summary: Self-hosted, version-accurate documentation for AI coding agents (MCP server).
+Project-URL: Repository, https://github.com/SirCypkowskyy/ExactDocs
+Project-URL: Issues, https://github.com/SirCypkowskyy/ExactDocs/issues
+Author: Cyprian Gburek
+License-Expression: Apache-2.0
+Keywords: ai-agents,documentation,fastmcp,mcp,rag
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Framework :: FastAPI
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: cyclopts>=4
+Requires-Dist: exactdocs-kernel==0.1.0
+Requires-Dist: fastapi>=0.120
+Requires-Dist: fastmcp>=4
+Requires-Dist: mcp>=2
+Requires-Dist: pydantic-settings>=2.11
+Requires-Dist: pydantic>=2.12
+Requires-Dist: uvicorn[standard]>=0.38
+Description-Content-Type: text/markdown
+
+# exactdocs
+
+Self-hosted, version-accurate documentation for AI coding agents: an MCP server that serves
+the right docs for the right library version, verbatim and with sources.
+
+```bash
+uvx exactdocs serve            # HTTP: web UI + MCP on http://localhost:3000
+uvx exactdocs serve --stdio    # MCP over stdio
+```
+
+See the [project README](https://github.com/SirCypkowskyy/ExactDocs) for the full documentation.

exactdocs-0.1.0/README.md

@@ -0,0 +1,11 @@
+# exactdocs
+
+Self-hosted, version-accurate documentation for AI coding agents: an MCP server that serves
+the right docs for the right library version, verbatim and with sources.
+
+```bash
+uvx exactdocs serve            # HTTP: web UI + MCP on http://localhost:3000
+uvx exactdocs serve --stdio    # MCP over stdio
+```
+
+See the [project README](https://github.com/SirCypkowskyy/ExactDocs) for the full documentation.

exactdocs-0.1.0/features/catalog.feature

@@ -0,0 +1,20 @@
+Feature: Library catalog
+  As an AI coding agent
+  I want to know which libraries and versions ExactDocs has indexed
+  So that I only ask for documentation that actually exists
+
+  Background:
+    Given ExactDocs is running with the demo catalog
+
+  Scenario: Listing indexed libraries
+    When I list the libraries over the REST API
+    Then the response status is 200
+    And the libraries are:
+      | name    | versions |
+      | fastapi | 0.115    |
+      | react   | 19.1     |
+
+  Scenario: Asking for a library that is not indexed
+    When I request the library "vue"
+    Then the response status is 404
+    And the error code is "not_found"

exactdocs-0.1.0/features/search.feature

@@ -0,0 +1,17 @@
+Feature: Version-pinned documentation search
+  As an AI coding agent
+  I want search to be pinned to the exact library version I use
+  So that I never get a plausible answer for the wrong version
+
+  Background:
+    Given ExactDocs is running with the demo catalog
+
+  Scenario: The version is a hard filter, not a ranking hint
+    When I search "react" version "18.3" for "useFormState"
+    Then the response status is 404
+    And the error code is "not_found"
+
+  Scenario: An indexed version answers, even with no matching excerpt
+    When I search "react" version "19.1" for "useActionState"
+    Then the response status is 200
+    And I get 0 excerpts

exactdocs-0.1.0/features/steps/http_steps.py

@@ -0,0 +1,56 @@
+"""Steps that drive ExactDocs through its public HTTP API, like a real client would."""
+
+from contextlib import ExitStack
+
+from behave import given, then, when
+from behave.runner import Context
+from fastapi.testclient import TestClient
+
+from exactdocs.bootstrap.container import Container
+from exactdocs.bootstrap.http import create_app
+from exactdocs.bootstrap.settings import Settings
+
+
+@given("ExactDocs is running with the demo catalog")
+def step_running(context: Context) -> None:
+    stack = ExitStack()
+    context.add_cleanup(stack.close)  # runs the app's shutdown after the scenario
+    context.client = stack.enter_context(TestClient(create_app(Container.build(Settings()))))
+
+
+@when("I list the libraries over the REST API")
+def step_list(context: Context) -> None:
+    context.response = context.client.get("/api/v1/libraries")
+
+
+@when('I request the library "{name}"')
+def step_get(context: Context, name: str) -> None:
+    context.response = context.client.get(f"/api/v1/libraries/{name}")
+
+
+@when('I search "{library}" version "{version}" for "{query}"')
+def step_search(context: Context, library: str, version: str, query: str) -> None:
+    params = {"library": library, "version": version, "query": query}
+    context.response = context.client.get("/api/v1/search", params=params)
+
+
+@then("the response status is {status:d}")
+def step_status(context: Context, status: int) -> None:
+    assert context.response.status_code == status, context.response.text
+
+
+@then('the error code is "{code}"')
+def step_error(context: Context, code: str) -> None:
+    assert context.response.json()["error"] == code
+
+
+@then("the libraries are:")
+def step_libraries(context: Context) -> None:
+    expected = [(row["name"], row["versions"].split(", ")) for row in context.table or []]
+    actual = [(lib["name"], lib["versions"]) for lib in context.response.json()["libraries"]]
+    assert actual == expected, actual
+
+
+@then("I get {count:d} excerpts")
+def step_excerpts(context: Context, count: int) -> None:
+    assert len(context.response.json()["excerpts"]) == count

exactdocs-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "exactdocs"
+dynamic = ["version", "dependencies"]
+description = "Self-hosted, version-accurate documentation for AI coding agents (MCP server)."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.14"
+authors = [{ name = "Cyprian Gburek" }]
+keywords = ["mcp", "documentation", "rag", "ai-agents", "fastmcp"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Framework :: FastAPI",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+
+[project.scripts]
+exactdocs = "exactdocs.bootstrap.cli:main"
+
+[project.urls]
+Repository = "https://github.com/SirCypkowskyy/ExactDocs"
+Issues = "https://github.com/SirCypkowskyy/ExactDocs/issues"
+
+[build-system]
+requires = ["hatchling>=1.27", "uv-dynamic-versioning>=0.11"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.hatch.metadata.hooks.uv-dynamic-versioning]
+# The kernel is released in lockstep with the app.
+dependencies = [
+    "exactdocs-kernel=={{ version }}",
+    "cyclopts>=4",
+    "fastapi>=0.120",
+    "fastmcp>=4",
+    "mcp>=2",
+    "pydantic>=2.12",
+    "pydantic-settings>=2.11",
+    "uvicorn[standard]>=0.38",
+]
+
+[tool.uv-dynamic-versioning]
+vcs = "git"
+style = "pep440"
+fallback-version = "0.0.0"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/exactdocs"]
+# The web UI is built by `pnpm build` and copied here in CI/Docker; it is gitignored.
+artifacts = ["src/exactdocs/_web/**"]
+
+[tool.hatch.build.targets.sdist]
+artifacts = ["src/exactdocs/_web/**"]

exactdocs-0.1.0/src/exactdocs/__init__.py

@@ -0,0 +1,5 @@
+"""ExactDocs: self-hosted, version-accurate documentation for AI coding agents."""
+
+from exactdocs._version import __version__
+
+__all__ = ["__version__"]

exactdocs-0.1.0/src/exactdocs/__main__.py

@@ -0,0 +1,3 @@
+from exactdocs.bootstrap.cli import main
+
+main()

exactdocs-0.1.0/src/exactdocs/_version.py

@@ -0,0 +1,6 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("exactdocs")
+except PackageNotFoundError:  # running from a source tree without installed metadata
+    __version__ = "0.0.0"