weave-compose 0.3.0__tar.gz

weave_compose-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Weave Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

weave_compose-0.3.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: weave-compose
+Version: 0.3.0
+Summary: Platform-aware skill composition layer for AI coding tools
+License: MIT
+Project-URL: Homepage, https://github.com/Adityaraj0421/weave-compose
+Project-URL: Repository, https://github.com/Adityaraj0421/weave-compose
+Project-URL: Changelog, https://github.com/Adityaraj0421/weave-compose/blob/main/CHANGELOG.md
+Project-URL: Bug Tracker, https://github.com/Adityaraj0421/weave-compose/issues
+Keywords: ai,skills,composition,claude,cursor,codex,windsurf
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: sentence-transformers
+Requires-Dist: numpy
+Requires-Dist: pyyaml
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Dynamic: license-file
+
+# weave-compose
+
+Platform-aware skill composition layer for AI coding tools.
+
+> "Everyone's building skills. Weave makes them work together."
+
+---
+
+## How It Works
+
+Weave ingests skills from AI coding tools (Claude Code, Cursor, Codex, Windsurf) and normalises them into a universal schema — a single `Skill` object with a name, platform, capabilities, and semantic embedding. At query time it embeds your task description and selects the best skill(s) by cosine similarity against every loaded skill, with no manual routing required. When a task spans multiple skills, Weave composes their contexts into a single merged string ready for injection into any AI coding tool.
+
+---
+
+## Installation
+
+```bash
+pip install weave-compose
+```
+
+Requires **Python 3.11+**. All embeddings run locally — no API key, no cloud dependency.
+
+---
+
+## Quickstart
+
+```bash
+# 1. Load skills from a directory of SKILL.md files
+weave load ./tests/fixtures/claude_code
+# Loaded 2 skill(s) from ./tests/fixtures/claude_code (platform: claude_code)
+# Session saved to .weave_session.json
+
+# 2. Query for the best skill for your task
+weave query "design a UI component with Tailwind CSS"
+# [1] Naksha Design System (claude_code) — score: 0.6821
+#     UI component design and design system implementation for React applications using Tailwind CSS.
+
+# 3. List all loaded skills
+weave list
+#   Naksha Design System           claude_code     [design, components, ui...]
+#   Backend API Engineer           claude_code     [api, rest, fastapi...]
+#
+# Total: 2 skill(s)
+```
+
+---
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `weave load <path> [--platform] [--verbose]` | Load skills from a directory and save the session |
+| `weave query "<text>" [--explain] [--top N]` | Query loaded skills and return the best match(es) |
+| `weave list [--platform]` | List all skills in the current session |
+| `weave status` | Show skill count, platform breakdown, and session info |
+| `weave clear` | Clear all loaded skills and delete the session file |
+
+Session state is stored in `.weave_session.json` in your current working directory. Run `weave load` once; all subsequent `query`, `list`, and `status` calls restore the session automatically — no re-embedding required.
+
+---
+
+## How Weave Selects Skills
+
+Weave uses [`all-MiniLM-L6-v2`](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) (runs on CPU, ~80 MB, cached after first use) to embed both your query and each skill's context. It returns the top match by default. If the confidence gap between the first and second result is less than `0.1`, both skills are returned for composition — Weave assumes the task spans both domains.
+
+Use `--explain` to see the full score table:
+
+```bash
+weave query "design a REST API" --explain
+```
+
+Use `--top N` to request at least N results:
+
+```bash
+weave query "build a feature" --top 2
+```
+
+---
+
+## Contributing
+
+Contributions are welcome at every layer — new platform adapters, composition strategies, CLI improvements, and documentation.
+
+- **Contributor guide:** [docs/contributing.md](docs/contributing.md)
+- **Writing a new adapter:** [docs/adapters.md](docs/adapters.md)
+- **Architecture overview:** [docs/architecture.md](docs/architecture.md)
+
+All code must pass `pytest`, `ruff check .`, and `mypy --strict .` before merging.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

weave_compose-0.3.0/README.md

@@ -0,0 +1,94 @@
+# weave-compose
+
+Platform-aware skill composition layer for AI coding tools.
+
+> "Everyone's building skills. Weave makes them work together."
+
+---
+
+## How It Works
+
+Weave ingests skills from AI coding tools (Claude Code, Cursor, Codex, Windsurf) and normalises them into a universal schema — a single `Skill` object with a name, platform, capabilities, and semantic embedding. At query time it embeds your task description and selects the best skill(s) by cosine similarity against every loaded skill, with no manual routing required. When a task spans multiple skills, Weave composes their contexts into a single merged string ready for injection into any AI coding tool.
+
+---
+
+## Installation
+
+```bash
+pip install weave-compose
+```
+
+Requires **Python 3.11+**. All embeddings run locally — no API key, no cloud dependency.
+
+---
+
+## Quickstart
+
+```bash
+# 1. Load skills from a directory of SKILL.md files
+weave load ./tests/fixtures/claude_code
+# Loaded 2 skill(s) from ./tests/fixtures/claude_code (platform: claude_code)
+# Session saved to .weave_session.json
+
+# 2. Query for the best skill for your task
+weave query "design a UI component with Tailwind CSS"
+# [1] Naksha Design System (claude_code) — score: 0.6821
+#     UI component design and design system implementation for React applications using Tailwind CSS.
+
+# 3. List all loaded skills
+weave list
+#   Naksha Design System           claude_code     [design, components, ui...]
+#   Backend API Engineer           claude_code     [api, rest, fastapi...]
+#
+# Total: 2 skill(s)
+```
+
+---
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `weave load <path> [--platform] [--verbose]` | Load skills from a directory and save the session |
+| `weave query "<text>" [--explain] [--top N]` | Query loaded skills and return the best match(es) |
+| `weave list [--platform]` | List all skills in the current session |
+| `weave status` | Show skill count, platform breakdown, and session info |
+| `weave clear` | Clear all loaded skills and delete the session file |
+
+Session state is stored in `.weave_session.json` in your current working directory. Run `weave load` once; all subsequent `query`, `list`, and `status` calls restore the session automatically — no re-embedding required.
+
+---
+
+## How Weave Selects Skills
+
+Weave uses [`all-MiniLM-L6-v2`](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) (runs on CPU, ~80 MB, cached after first use) to embed both your query and each skill's context. It returns the top match by default. If the confidence gap between the first and second result is less than `0.1`, both skills are returned for composition — Weave assumes the task spans both domains.
+
+Use `--explain` to see the full score table:
+
+```bash
+weave query "design a REST API" --explain
+```
+
+Use `--top N` to request at least N results:
+
+```bash
+weave query "build a feature" --top 2
+```
+
+---
+
+## Contributing
+
+Contributions are welcome at every layer — new platform adapters, composition strategies, CLI improvements, and documentation.
+
+- **Contributor guide:** [docs/contributing.md](docs/contributing.md)
+- **Writing a new adapter:** [docs/adapters.md](docs/adapters.md)
+- **Architecture overview:** [docs/architecture.md](docs/architecture.md)
+
+All code must pass `pytest`, `ruff check .`, and `mypy --strict .` before merging.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

weave_compose-0.3.0/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "weave-compose"
+version = "0.3.0"
+description = "Platform-aware skill composition layer for AI coding tools"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+keywords = ["ai", "skills", "composition", "claude", "cursor", "codex", "windsurf"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "typer",
+    "sentence-transformers",
+    "numpy",
+    "pyyaml",
+]
+
+[project.urls]
+Homepage = "https://github.com/Adityaraj0421/weave-compose"
+Repository = "https://github.com/Adityaraj0421/weave-compose"
+Changelog = "https://github.com/Adityaraj0421/weave-compose/blob/main/CHANGELOG.md"
+"Bug Tracker" = "https://github.com/Adityaraj0421/weave-compose/issues"
+
+[project.scripts]
+weave = "weave.cli.main:app"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "ruff",
+    "mypy",
+    "types-PyYAML",
+]
+
+[tool.setuptools.packages.find]
+include = ["weave*"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.ruff]
+line-length = 88
+
+[tool.mypy]
+strict = true
+
+[[tool.mypy.overrides]]
+module = "sentence_transformers"
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

weave_compose-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

weave_compose-0.3.0/tests/test_adapters.py

@@ -0,0 +1,163 @@
+"""Tests for all platform adapters."""
+
+from datetime import datetime
+from pathlib import Path
+
+import pytest
+
+from weave.core.adapters.base import BaseAdapter
+from weave.core.adapters.claude_code import ClaudeCodeAdapter
+from weave.core.adapters.cursor import CursorAdapter
+from weave.core.schema import Skill
+
+CLAUDE_FIXTURES = Path(__file__).parent / "fixtures" / "claude_code"
+CURSOR_FIXTURES = Path(__file__).parent / "fixtures" / "cursor"
+
+
+class _ConcreteAdapter(BaseAdapter):
+    """Minimal concrete subclass used to exercise BaseAdapter helper methods."""
+
+    def load(self, path: str) -> list[Skill]:
+        """Return an empty list — implementation not under test here."""
+        return []
+
+
+def test_base_adapter_cannot_be_instantiated_directly() -> None:
+    """BaseAdapter raises TypeError when instantiated without implementing load()."""
+    with pytest.raises(TypeError):
+        BaseAdapter()  # type: ignore[abstract]
+
+
+def test_generate_id_returns_unique_values() -> None:
+    """_generate_id() returns a different string on each call."""
+    adapter = _ConcreteAdapter()
+    first = adapter._generate_id()
+    second = adapter._generate_id()
+    assert first != second
+
+
+def test_timestamp_returns_valid_iso_format() -> None:
+    """_timestamp() returns a UTC ISO 8601 string parseable by datetime.fromisoformat()."""
+    adapter = _ConcreteAdapter()
+    result = adapter._timestamp()
+    # Raises ValueError if the string is not a valid ISO 8601 timestamp
+    parsed = datetime.fromisoformat(result)
+    assert result.endswith("+00:00"), f"Expected UTC offset '+00:00', got: {result!r}"
+    assert parsed.tzinfo is not None
+
+
+# ---------------------------------------------------------------------------
+# ClaudeCodeAdapter tests
+# ---------------------------------------------------------------------------
+
+
+@pytest.fixture
+def adapter() -> ClaudeCodeAdapter:
+    """Return a fresh ClaudeCodeAdapter instance for each test."""
+    return ClaudeCodeAdapter()
+
+
+@pytest.fixture
+def cursor_adapter() -> CursorAdapter:
+    """Return a fresh CursorAdapter instance for each test."""
+    return CursorAdapter()
+
+
+def test_claude_load_returns_all_skills_from_directory(adapter: ClaudeCodeAdapter) -> None:
+    """load() returns one Skill per .md file found in the fixtures directory."""
+    skills = adapter.load(str(CLAUDE_FIXTURES))
+    assert len(skills) == 2
+
+
+def test_claude_load_parses_frontmatter_name(adapter: ClaudeCodeAdapter) -> None:
+    """load() correctly reads the name field from YAML frontmatter."""
+    skills = adapter.load(str(CLAUDE_FIXTURES))
+    names = {s.name for s in skills}
+    assert "Backend API Engineer" in names
+
+
+def test_claude_load_falls_back_to_filename_when_no_frontmatter(
+    adapter: ClaudeCodeAdapter, tmp_path: Path
+) -> None:
+    """load() uses the file stem as name when no YAML frontmatter is present."""
+    md_file = tmp_path / "my_skill.md"
+    md_file.write_text("This skill handles data processing tasks.\n\nMore content here.")
+    skills = adapter.load(str(tmp_path))
+    assert skills[0].name == "my_skill"
+
+
+def test_claude_load_handles_empty_file_without_crashing(
+    adapter: ClaudeCodeAdapter, tmp_path: Path
+) -> None:
+    """load() skips empty .md files and returns an empty list without raising."""
+    (tmp_path / "empty.md").write_text("")
+    skills = adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_claude_load_returns_empty_list_for_directory_with_no_md_files(
+    adapter: ClaudeCodeAdapter, tmp_path: Path
+) -> None:
+    """load() returns an empty list when the directory contains no .md files."""
+    skills = adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_claude_detect_returns_true_for_directory_with_md_files(
+    adapter: ClaudeCodeAdapter,
+) -> None:
+    """detect() returns True for the claude_code fixtures directory."""
+    assert adapter.detect(str(CLAUDE_FIXTURES)) is True
+
+
+# ---------------------------------------------------------------------------
+# CursorAdapter tests
+# ---------------------------------------------------------------------------
+
+
+def test_cursor_load_returns_all_skills_from_directory(
+    cursor_adapter: CursorAdapter,
+) -> None:
+    """load() returns one Skill per cursor file found (cursorrules + mdc)."""
+    skills = cursor_adapter.load(str(CURSOR_FIXTURES))
+    assert len(skills) == 2
+
+
+def test_cursor_load_parses_cursorrules_name(cursor_adapter: CursorAdapter) -> None:
+    """load() uses the file stem as name for plain .cursorrules files."""
+    skills = cursor_adapter.load(str(CURSOR_FIXTURES))
+    names = {s.name for s in skills}
+    assert "frontend" in names
+
+
+def test_cursor_load_parses_mdc_frontmatter_description(
+    cursor_adapter: CursorAdapter,
+) -> None:
+    """load() uses the MDC frontmatter description as trigger_context."""
+    skills = cursor_adapter.load(str(CURSOR_FIXTURES))
+    mdc_skill = next(s for s in skills if s.metadata.get("format") == "mdc")
+    assert "TypeScript" in mdc_skill.trigger_context
+
+
+def test_cursor_load_handles_empty_file_without_crashing(
+    cursor_adapter: CursorAdapter, tmp_path: Path
+) -> None:
+    """load() skips empty .cursorrules files and returns an empty list."""
+    (tmp_path / "rules.cursorrules").write_text("")
+    skills = cursor_adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_cursor_load_returns_empty_list_for_directory_with_no_cursor_files(
+    cursor_adapter: CursorAdapter, tmp_path: Path
+) -> None:
+    """load() returns an empty list when no .cursorrules or .mdc files exist."""
+    skills = cursor_adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_cursor_detect_returns_true_for_directory_with_cursorrules(
+    cursor_adapter: CursorAdapter,
+) -> None:
+    """detect() returns True for the cursor fixtures directory."""
+    assert cursor_adapter.detect(str(CURSOR_FIXTURES)) is True

weave_compose-0.3.0/tests/test_adapters_codex.py

@@ -0,0 +1,63 @@
+"""Tests for the CodexAdapter."""
+
+from pathlib import Path
+
+import pytest
+
+from weave.core.adapters.codex import CodexAdapter
+
+CODEX_FIXTURES = Path(__file__).parent / "fixtures" / "codex"
+
+
+@pytest.fixture
+def codex_adapter() -> CodexAdapter:
+    """Return a fresh CodexAdapter instance for each test."""
+    return CodexAdapter()
+
+
+def test_codex_load_returns_all_skills_from_directory(
+    codex_adapter: CodexAdapter,
+) -> None:
+    """load() returns one Skill per codex file found (AGENTS.md + .codex/*.md)."""
+    skills = codex_adapter.load(str(CODEX_FIXTURES))
+    assert len(skills) == 2
+
+
+def test_codex_load_parses_agents_md_heading_name(codex_adapter: CodexAdapter) -> None:
+    """load() uses the first # heading as name for AGENTS.md files."""
+    skills = codex_adapter.load(str(CODEX_FIXTURES))
+    names = {s.name for s in skills}
+    assert "Security Code Reviewer" in names
+
+
+def test_codex_load_parses_first_paragraph_as_trigger_context(
+    codex_adapter: CodexAdapter,
+) -> None:
+    """load() uses the first non-heading paragraph as trigger_context."""
+    skills = codex_adapter.load(str(CODEX_FIXTURES))
+    agents_skill = next(s for s in skills if s.name == "Security Code Reviewer")
+    assert "security" in agents_skill.trigger_context.lower()
+
+
+def test_codex_load_handles_empty_file_without_crashing(
+    codex_adapter: CodexAdapter, tmp_path: Path
+) -> None:
+    """load() skips an empty AGENTS.md and returns an empty list."""
+    (tmp_path / "AGENTS.md").write_text("")
+    skills = codex_adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_codex_load_returns_empty_list_for_directory_with_no_codex_files(
+    codex_adapter: CodexAdapter, tmp_path: Path
+) -> None:
+    """load() returns an empty list when no AGENTS.md or .codex/*.md files exist."""
+    skills = codex_adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_codex_detect_returns_true_for_directory_with_agents_md(
+    codex_adapter: CodexAdapter,
+) -> None:
+    """detect() returns True for the codex fixtures directory."""
+    assert codex_adapter.detect(str(CODEX_FIXTURES)) is True

weave_compose-0.3.0/tests/test_adapters_windsurf.py

@@ -0,0 +1,65 @@
+"""Tests for the WindsurfAdapter."""
+
+from pathlib import Path
+
+import pytest
+
+from weave.core.adapters.windsurf import WindsurfAdapter
+
+WINDSURF_FIXTURES = Path(__file__).parent / "fixtures" / "windsurf"
+
+
+@pytest.fixture
+def windsurf_adapter() -> WindsurfAdapter:
+    """Return a fresh WindsurfAdapter instance for each test."""
+    return WindsurfAdapter()
+
+
+def test_windsurf_load_returns_all_skills_from_directory(
+    windsurf_adapter: WindsurfAdapter,
+) -> None:
+    """load() returns one Skill per .windsurfrules file found in the fixtures dir."""
+    skills = windsurf_adapter.load(str(WINDSURF_FIXTURES))
+    assert len(skills) == 2
+
+
+def test_windsurf_load_parses_name_from_file_stem(
+    windsurf_adapter: WindsurfAdapter,
+) -> None:
+    """load() uses the file stem as the Skill name."""
+    skills = windsurf_adapter.load(str(WINDSURF_FIXTURES))
+    names = {s.name for s in skills}
+    assert "python_standards" in names
+
+
+def test_windsurf_load_parses_first_paragraph_as_trigger_context(
+    windsurf_adapter: WindsurfAdapter,
+) -> None:
+    """load() uses the first paragraph of content as trigger_context."""
+    skills = windsurf_adapter.load(str(WINDSURF_FIXTURES))
+    python_skill = next(s for s in skills if s.name == "python_standards")
+    assert "Python" in python_skill.trigger_context
+
+
+def test_windsurf_load_handles_empty_file_without_crashing(
+    windsurf_adapter: WindsurfAdapter, tmp_path: Path
+) -> None:
+    """load() skips empty .windsurfrules files and returns an empty list."""
+    (tmp_path / ".windsurfrules").write_text("")
+    skills = windsurf_adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_windsurf_load_returns_empty_list_for_directory_with_no_windsurfrules(
+    windsurf_adapter: WindsurfAdapter, tmp_path: Path
+) -> None:
+    """load() returns an empty list when no .windsurfrules files exist."""
+    skills = windsurf_adapter.load(str(tmp_path))
+    assert skills == []
+
+
+def test_windsurf_detect_returns_true_for_directory_with_windsurfrules(
+    windsurf_adapter: WindsurfAdapter,
+) -> None:
+    """detect() returns True for the windsurf fixtures directory."""
+    assert windsurf_adapter.detect(str(WINDSURF_FIXTURES)) is True