contextlayer-mcp-server 0.1.0__py3-none-any.whl

contextlayer/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

contextlayer/detection.py

@@ -0,0 +1,186 @@
+"""Filesystem detection for ContextLayer. Pure functions, no MCP coupling."""
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Iterable
+
+MAX_SCAN_DEPTH = 3
+MAX_FILES_READ = 40
+MAX_BYTES_PER_FILE = 8 * 1024
+
+IGNORE_DIRS = {
+    ".git", "node_modules", "venv", ".venv", "__pycache__",
+    "dist", "build", ".next", "target", "vendor", ".mypy_cache",
+    ".pytest_cache", "coverage", ".idea", ".vscode",
+}
+
+LANGUAGE_MARKERS = {
+    "package.json": "Node.js",
+    "tsconfig.json": "TypeScript",
+    "go.mod": "Go",
+    "requirements.txt": "Python",
+    "pyproject.toml": "Python",
+    "Cargo.toml": "Rust",
+    "pom.xml": "Java (Maven)",
+    "build.gradle": "Java/Kotlin (Gradle)",
+    "Gemfile": "Ruby",
+    "composer.json": "PHP",
+}
+
+SOURCE_EXTS = {
+    ".py", ".ts", ".tsx", ".js", ".jsx", ".go", ".rs",
+    ".java", ".kt", ".rb", ".php",
+}
+
+STYLE_MARKERS = {
+    ".prettierrc": "prettier",
+    ".prettierrc.json": "prettier",
+    ".eslintrc": "eslint",
+    ".eslintrc.json": "eslint",
+    "ruff.toml": "ruff",
+    ".ruff.toml": "ruff",
+    "mypy.ini": "mypy",
+    ".golangci.yml": "golangci-lint",
+    "rustfmt.toml": "rustfmt",
+}
+
+
+@dataclass
+class ProjectContext:
+    root: str
+    languages: list[str] = field(default_factory=list)
+    frameworks: list[str] = field(default_factory=list)
+    paradigms: list[str] = field(default_factory=list)
+    key_files: list[str] = field(default_factory=list)
+    style_hints: list[str] = field(default_factory=list)
+
+    def env_line(self) -> str:
+        langs = ", ".join(self.languages) or "General Software Engineering"
+        if self.frameworks:
+            langs += f" (frameworks: {', '.join(self.frameworks)})"
+        return langs
+
+
+def _walk(root: Path, max_depth: int) -> Iterable[Path]:
+    root = root.resolve()
+    for dirpath, dirnames, filenames in os.walk(root):
+        current = Path(dirpath)
+        try:
+            depth = len(current.relative_to(root).parts)
+        except ValueError:
+            continue
+        dirnames[:] = [d for d in dirnames if d not in IGNORE_DIRS]
+        if depth >= max_depth:
+            dirnames[:] = []
+        for fn in filenames:
+            yield current / fn
+
+
+def detect_languages_and_frameworks(root: Path) -> tuple[list[str], list[str], list[str]]:
+    languages: set[str] = set()
+    frameworks: set[str] = set()
+    key_files: list[str] = []
+
+    for path in _walk(root, MAX_SCAN_DEPTH):
+        name = path.name
+        if name not in LANGUAGE_MARKERS:
+            continue
+        languages.add(LANGUAGE_MARKERS[name])
+        try:
+            key_files.append(str(path.relative_to(root)))
+        except ValueError:
+            key_files.append(str(path))
+
+        try:
+            if name == "package.json":
+                pkg = json.loads(path.read_text(encoding="utf-8"))
+                deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
+                for fw in ("next", "react", "vue", "express", "nestjs", "svelte", "vitest", "jest"):
+                    if any(fw in d for d in deps):
+                        frameworks.add(fw)
+            elif name == "go.mod":
+                txt = path.read_text(encoding="utf-8", errors="ignore")
+                for fw, needle in (("gin", "gin-gonic"), ("gRPC", "grpc"), ("echo", "labstack/echo")):
+                    if needle in txt:
+                        frameworks.add(fw)
+            elif name == "pyproject.toml":
+                txt = path.read_text(encoding="utf-8", errors="ignore").lower()
+                for fw in ("fastapi", "django", "flask", "pydantic", "pytest", "sqlalchemy"):
+                    if fw in txt:
+                        frameworks.add(fw)
+            elif name == "Cargo.toml":
+                txt = path.read_text(encoding="utf-8", errors="ignore")
+                for fw, needle in (("tokio", "tokio"), ("axum", "axum"), ("serde", "serde")):
+                    if needle in txt:
+                        frameworks.add(fw)
+        except (OSError, json.JSONDecodeError):
+            pass
+
+    return sorted(languages), sorted(frameworks), key_files[:20]
+
+
+def detect_paradigms(root: Path) -> list[str]:
+    hints: set[str] = set()
+    read_count = 0
+
+    for path in _walk(root, MAX_SCAN_DEPTH):
+        if read_count >= MAX_FILES_READ:
+            break
+        if path.suffix not in SOURCE_EXTS:
+            continue
+        try:
+            snippet = path.read_text(encoding="utf-8", errors="ignore")[:MAX_BYTES_PER_FILE]
+        except OSError:
+            continue
+        read_count += 1
+
+        if path.suffix == ".py":
+            if "from typing import" in snippet or "typing import" in snippet:
+                hints.add("typed Python")
+            if "async def" in snippet:
+                hints.add("async/await")
+            if "@dataclass" in snippet or "pydantic" in snippet.lower():
+                hints.add("dataclasses/pydantic")
+        elif path.suffix in {".ts", ".tsx"}:
+            if "interface " in snippet or " type " in snippet:
+                hints.add("TypeScript strict types")
+            if "react" in snippet.lower():
+                hints.add("React")
+        elif path.suffix == ".go":
+            if "interface {" in snippet:
+                hints.add("Go interfaces")
+            hints.add("explicit error returns")
+        elif path.suffix == ".rs":
+            if "Result<" in snippet:
+                hints.add("Rust Result-based errors")
+        elif path.suffix == ".js":
+            hints.add("JavaScript")
+
+    return sorted(hints)
+
+
+def detect_style_hints(root: Path) -> list[str]:
+    hints: list[str] = []
+    for marker, label in STYLE_MARKERS.items():
+        if (root / marker).exists() and label not in hints:
+            hints.append(label)
+    return hints
+
+
+def build_project_context(current_working_dir: str) -> ProjectContext:
+    root = Path(current_working_dir)
+    if not root.is_dir():
+        return ProjectContext(root=str(root))
+
+    langs, fws, key_files = detect_languages_and_frameworks(root)
+    return ProjectContext(
+        root=str(root),
+        languages=langs,
+        frameworks=fws,
+        paradigms=detect_paradigms(root),
+        key_files=key_files,
+        style_hints=detect_style_hints(root),
+    )

contextlayer/server.py

@@ -0,0 +1,26 @@
+"""MCP server entry point. Run with: python -m contextlayer.server"""
+from __future__ import annotations
+
+from mcp.server.mcpserver import MCPServer
+
+from contextlayer.detection import build_project_context
+from contextlayer.wrapper import build_expert_prompt
+
+mcp = MCPServer("ContextLayer-SE")
+
+
+@mcp.tool()
+def analyze_and_wrap_prompt(user_prompt: str, current_working_dir: str) -> str:
+    """Detect the project's tech stack, then wrap `user_prompt` in a
+    strict senior-engineer schema before the model ever sees it."""
+    ctx = build_project_context(current_working_dir)
+    return build_expert_prompt(user_prompt, ctx)
+
+
+def main() -> None:
+    import anyio
+    anyio.run(mcp.run_stdio_async)
+
+
+if __name__ == "__main__":
+    main()

contextlayer/wrapper.py

@@ -0,0 +1,32 @@
+"""Prompt wrapper: turns a ProjectContext + user prompt into an expert prompt."""
+from __future__ import annotations
+
+from .detection import ProjectContext
+
+SE_DIRECTIVES = """\
+CRITICAL OUTPUT DIRECTIVES:
+1. Do NOT explain basic concepts. Provide direct, production-grade solutions immediately.
+2. Enforce strict type safety and error handling matching best practices for the detected stack.
+3. Output code snippets first, followed only by highly specific edge cases or impacted file names.
+4. Match existing codebase paradigms layout in the working directory.
+5. Do not introduce new frameworks or dependencies unless explicitly requested."""
+
+
+def build_expert_prompt(user_prompt: str, ctx: ProjectContext) -> str:
+    paradigms = ", ".join(ctx.paradigms) or "none detected"
+    style = ", ".join(ctx.style_hints) or "none detected"
+    manifests = "\n    - ".join(ctx.key_files) or "(no manifest files found)"
+
+    return f"""ROLE: Principal Systems Architect & Senior Engineer.
+ENVIRONMENT DETECTED: {ctx.env_line()}
+
+DETECTED PARADIGMS: {paradigms}
+DETECTED STYLE CONFIG: {style}
+KEY MANIFESTS:
+    - {manifests}
+
+{SE_DIRECTIVES}
+
+USER REQUEST:
+{user_prompt}
+"""

contextlayer_mcp_server-0.1.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: contextlayer-mcp-server
+Version: 0.1.0
+Summary: Invisible intelligence layer for AI coding tools (MCP)
+Author: Rudra Nalawade
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0

contextlayer_mcp_server-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+contextlayer/__init__.py,sha256=Pru0BlFBASFCFo7McHdohtKkUtgMPDwbGfyUZlE2_Vw,21
+contextlayer/detection.py,sha256=31ww0wZAcaR8x_QM8yPWGQr7pEcw38BEO3RxCBWTbmI,6297
+contextlayer/server.py,sha256=INT9JykyBubuBCOyUiIxHNrVBBxJFjFj-7I02TnBJwk,742
+contextlayer/wrapper.py,sha256=GzPZs298LALFqgoicnyTc24DA5BIwc_-2zIgjaSrUwg,1168
+contextlayer_mcp_server-0.1.0.dist-info/METADATA,sha256=Y1I5y9_TBRtkCwXVz4IYXQM1JiwntkuCwDQdIYjKMGk,244
+contextlayer_mcp_server-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+contextlayer_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=EIk9OpDRwWvG11g4_UOo3sEvGmzR3OfRT4vV-2bqVdk,58
+contextlayer_mcp_server-0.1.0.dist-info/top_level.txt,sha256=hmfZnx_fUURJrg6Ftf4AOLOY_kRgc0MRM-q0vPy_bYQ,13
+contextlayer_mcp_server-0.1.0.dist-info/RECORD,,

contextlayer_mcp_server-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

contextlayer_mcp_server-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+contextlayer = contextlayer.server:main

contextlayer_mcp_server-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+contextlayer