css-mcp 0.1.2__tar.gz → 0.2.0__tar.gz

{css_mcp-0.1.2 → css_mcp-0.2.0}/.gitignore

@@ -57,7 +57,20 @@ dmypy.json
 # Cache
 .css_mcp_cache/
 .cache/
+.oneiric_cache/
+
+# Local settings overrides
+settings/local.yaml
 
 # OS
 .DS_Store
 Thumbs.db
+
+# Backup Files (added by gitignore audit)
+# ============================================================================
+*.backup
+*.bak
+/.backups/
+/.backup/
+.backups/
+.backup/

css_mcp-0.2.0/.lycheecache

@@ -0,0 +1,12 @@
+https://img.shields.io/badge/code%20style-crackerjack-000042,200,1781840750
+https://github.com/astral-sh/uv,200,1781840751
+https://github.com/lesleslie/crackerjack,200,1781840751
+https://keepachangelog.com/en/1.0.0/,200,1781840750
+https://img.shields.io/badge/runtime-oneiric-6e5494,200,1781840750
+https://github.com/lesleslie/oneiric,200,1781840751
+https://img.shields.io/badge/python-3.13%2B-green,200,1781840750
+https://semver.org/spec/v2.0.0.html,200,1781840750
+https://github.com/jlowin/fastmcp,200,1781840751
+https://img.shields.io/badge/framework-FastMCP-0ea5e9,200,1781840750
+https://www.python.org/downloads/,200,1781840750
+https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json,200,1781840750

css_mcp-0.2.0/AGENTS.md

@@ -0,0 +1,38 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+- `css_mcp/` contains the MCP server package, including tool implementations, parsing or analysis helpers, and server entrypoints.
+- Tests should live under `tests/`, mirroring package structure when practical.
+- Root files such as `pyproject.toml`, `uv.lock`, and `README.md` define packaging, dependency, and operator guidance; keep behavioral documentation there rather than scattering it across scripts.
+- Generated output in `dist/` or coverage artifacts should not be edited manually.
+
+## Build, Test, and Development Commands
+
+- `uv sync --group dev` installs development dependencies.
+- `uv run pytest` runs the full test suite.
+- `uv run mypy css_mcp` validates typing.
+- `uv run ruff check css_mcp tests` and `uv run ruff format css_mcp tests` cover linting and formatting.
+- Run the MCP server with the repo's documented local command before validating tool behavior.
+
+## Coding Style & Naming Conventions
+
+- Use explicit type hints, small focused modules, and structured tool inputs and outputs.
+- Keep module names snake_case and classes PascalCase.
+- Prefer extending existing CSS analysis or documentation helpers rather than adding parallel tool paths.
+
+## Testing Guidelines
+
+- Add tests with each tool or parser change, especially around CSS analysis edge cases and response formatting.
+- Prefer deterministic fixture inputs over live or generated CSS blobs unless the case requires end-to-end validation.
+- Review coverage locally after larger changes.
+
+## Commit & Pull Request Guidelines
+
+- Use focused commits such as `fix(parser): handle nested rule output`.
+- PRs should describe changed tools, commands run for validation, and any user-facing output differences.
+
+## Security & Configuration Tips
+
+- Validate file paths and CSS inputs rigorously.
+- Keep secrets and machine-specific paths out of version control.

{css_mcp-0.1.2 → css_mcp-0.2.0}/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-06-19
+
+### Internal
+
+- gitignore: Add backup file patterns to silence checkpoint tool artifacts
+
 ## [0.1.2] - 2026-02-25
 
 ### Changed

{css_mcp-0.1.2 → css_mcp-0.2.0}/CLAUDE.md

@@ -2,6 +2,8 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+For a shorter, tool-neutral bootstrap document, start with `AGENTS.md`.
+
 ## Project Overview
 
 CSS MCP Server is an MCP (Model Context Protocol) server for CSS analysis and documentation, designed for the FastBlocks ecosystem. It provides 9 tools for analyzing programmatically generated CSS from style adapters like Kelp UI and WebAwesome.
@@ -44,6 +46,7 @@ css_mcp/
 ### Key Components
 
 **CSSAnalyzer** (`analyzer.py`): The core analysis engine that parses CSS using tinycss2 and computes 150+ metrics including:
+
 - Complexity scores (0-100)
 - Specificity analysis with distribution
 - Selector patterns (ID, class, element, universal)
@@ -91,6 +94,7 @@ Environment variables (prefix: `CSS_MCP_`):
 ## FastBlocks Integration
 
 This server is designed for analyzing CSS generated by FastBlocks style adapters:
+
 - Kelp UI (custom lightweight framework)
 - WebAwesome (Font Awesome components)
 - Vanilla (minimal semantic styling)

{css_mcp-0.1.2 → css_mcp-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: css-mcp
-Version: 0.1.2
+Version: 0.2.0
 Summary: Universal CSS analysis and documentation MCP server with 150+ metrics
 Project-URL: Homepage, https://github.com/lesleslie/css-mcp
 Project-URL: Repository, https://github.com/lesleslie/css-mcp
@@ -13,13 +13,11 @@ Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.13
-Requires-Dist: cssselect>=1.2.0
 Requires-Dist: fastmcp>=0.6.0
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: mcp-common>=0.1.0
-Requires-Dist: oneiric>=0.1.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: tinycss2>=1.3.0
+Requires-Dist: httpx~=0.28.1
+Requires-Dist: mcp-common~=0.16.4
+Requires-Dist: pydantic~=2.13.4
+Requires-Dist: tinycss2~=1.5.1
 Provides-Extra: dev
 Requires-Dist: mypy>=1.9.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
@@ -30,6 +28,12 @@ Description-Content-Type: text/markdown
 
 # CSS MCP Server
 
+[![Code style: crackerjack](https://img.shields.io/badge/code%20style-crackerjack-000042)](https://github.com/lesleslie/crackerjack)
+[![Runtime: oneiric](https://img.shields.io/badge/runtime-oneiric-6e5494)](https://github.com/lesleslie/oneiric)
+[![Framework: FastMCP](https://img.shields.io/badge/framework-FastMCP-0ea5e9)](https://github.com/jlowin/fastmcp)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Python: 3.13+](https://img.shields.io/badge/python-3.13%2B-green)](https://www.python.org/downloads/)
+
 Universal CSS Analysis and Documentation MCP Server. Analyze any CSS with 150+ metrics for complexity, specificity, and quality.
 
 ## Features
@@ -108,22 +112,26 @@ suggestions = analyzer.get_suggestions()
 The analyzer provides 150+ metrics including:
 
 ### Basic Metrics
+
 - Total rules, selectors, properties
 - File size (bytes, gzipped)
 - Lines of code
 
 ### Selector Metrics
+
 - ID, class, element, universal selectors
 - Pseudo-classes and pseudo-elements
 - Combinators (descendant, child, sibling)
 - Selector depth
 
 ### Specificity Metrics
+
 - Average, min, max specificity
 - High specificity rules
 - Specificity distribution
 
 ### Property Metrics
+
 - Unique properties
 - Category distribution (layout, typography, etc.)
 - Vendor prefixes
@@ -131,6 +139,7 @@ The analyzer provides 150+ metrics including:
 - CSS custom properties
 
 ### Quality Metrics
+
 - Duplicate selectors
 - Duplicate properties
 - Empty rules
@@ -140,6 +149,7 @@ The analyzer provides 150+ metrics including:
 ## Browser Compatibility
 
 Built-in compatibility data for common CSS properties across:
+
 - Chrome
 - Firefox
 - Safari

{css_mcp-0.1.2 → css_mcp-0.2.0}/README.md

@@ -1,5 +1,11 @@
 # CSS MCP Server
 
+[![Code style: crackerjack](https://img.shields.io/badge/code%20style-crackerjack-000042)](https://github.com/lesleslie/crackerjack)
+[![Runtime: oneiric](https://img.shields.io/badge/runtime-oneiric-6e5494)](https://github.com/lesleslie/oneiric)
+[![Framework: FastMCP](https://img.shields.io/badge/framework-FastMCP-0ea5e9)](https://github.com/jlowin/fastmcp)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Python: 3.13+](https://img.shields.io/badge/python-3.13%2B-green)](https://www.python.org/downloads/)
+
 Universal CSS Analysis and Documentation MCP Server. Analyze any CSS with 150+ metrics for complexity, specificity, and quality.
 
 ## Features
@@ -78,22 +84,26 @@ suggestions = analyzer.get_suggestions()
 The analyzer provides 150+ metrics including:
 
 ### Basic Metrics
+
 - Total rules, selectors, properties
 - File size (bytes, gzipped)
 - Lines of code
 
 ### Selector Metrics
+
 - ID, class, element, universal selectors
 - Pseudo-classes and pseudo-elements
 - Combinators (descendant, child, sibling)
 - Selector depth
 
 ### Specificity Metrics
+
 - Average, min, max specificity
 - High specificity rules
 - Specificity distribution
 
 ### Property Metrics
+
 - Unique properties
 - Category distribution (layout, typography, etc.)
 - Vendor prefixes
@@ -101,6 +111,7 @@ The analyzer provides 150+ metrics including:
 - CSS custom properties
 
 ### Quality Metrics
+
 - Duplicate selectors
 - Duplicate properties
 - Empty rules
@@ -110,6 +121,7 @@ The analyzer provides 150+ metrics including:
 ## Browser Compatibility
 
 Built-in compatibility data for common CSS properties across:
+
 - Chrome
 - Firefox
 - Safari

{css_mcp-0.1.2 → css_mcp-0.2.0}/css_mcp/__init__.py

@@ -1,14 +1,17 @@
 """CSS MCP Server - CSS analysis and documentation for FastBlocks ecosystem."""
 
+from __future__ import annotations
+
 __version__ = "0.1.0"
 __author__ = "Les Leslie"
 
 from css_mcp.analyzer import CSSAnalyzer, CSSMetrics, CSSProperty
-from css_mcp.config import CSSMCPConfig
+from css_mcp.config import CSSMCPConfig, CSSMCPSettings
 
 __all__ = [
     "CSSAnalyzer",
     "CSSMetrics",
-    "CSSProperty",
     "CSSMCPConfig",
+    "CSSMCPSettings",
+    "CSSProperty",
 ]

{css_mcp-0.1.2 → css_mcp-0.2.0}/css_mcp/__main__.py

@@ -1,6 +1,8 @@
 """Entry point for running CSS MCP as a module."""
 
-from css_mcp.server import main
+from __future__ import annotations
+
+from css_mcp.cli import main
 
 if __name__ == "__main__":
     main()