skillware 0.3.3__tar.gz → 0.3.6__tar.gz

{skillware-0.3.3/skillware.egg-info → skillware-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.3.3
+Version: 0.3.6
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -38,13 +38,13 @@ Requires-Dist: pyyaml
 Requires-Dist: python-dotenv
 Requires-Dist: beautifulsoup4
 Requires-Dist: packaging
+Requires-Dist: rich>=13.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Provides-Extra: cli
-Requires-Dist: rich>=13.0; extra == "cli"
 Provides-Extra: gemini
 Requires-Dist: google-genai; extra == "gemini"
 Provides-Extra: claude
@@ -53,12 +53,20 @@ Provides-Extra: openai
 Requires-Dist: openai; extra == "openai"
 Provides-Extra: office
 Requires-Dist: pymupdf; extra == "office"
+Provides-Extra: defi
+Requires-Dist: web3>=6.0.0; extra == "defi"
+Provides-Extra: embeddings
+Requires-Dist: fastembed; extra == "embeddings"
+Requires-Dist: numpy; extra == "embeddings"
 Provides-Extra: all
 Requires-Dist: rich>=13.0; extra == "all"
 Requires-Dist: google-genai; extra == "all"
 Requires-Dist: anthropic; extra == "all"
 Requires-Dist: openai; extra == "all"
 Requires-Dist: pymupdf; extra == "all"
+Requires-Dist: web3>=6.0.0; extra == "all"
+Requires-Dist: fastembed; extra == "all"
+Requires-Dist: numpy; extra == "all"
 Dynamic: license-file
 
 <div align="center">
@@ -118,7 +126,7 @@ documentation. Runnable provider scripts are indexed in
 ```text
 Skillware/
 ├── docs/                       # Introduction, testing, skill catalog, usage guides (docs/usage/)
-├── examples/                   # Provider reference scripts (Gemini, Claude, OpenAI, Ollama, ...)
+├── examples/                   # Provider reference scripts — usage demos, not pytest (see examples/README.md)
 ├── skills/                     # Skill Registry
 │   └── category/               # Domain boundaries (e.g., finance)
 │       └── skill_name/         # The Skill bundle
@@ -126,7 +134,7 @@ Skillware/
 │           ├── skill.py        # Executable Python logic
 │           ├── instructions.md # Cognitive map for the LLM
 │           ├── card.json       # Optional UI presentation metadata
-│           └── test_skill.py   # Unit tests and schema validation
+│           └── test_skill.py   # Bundle test (required for new skills; see docs/TESTING.md)
 ├── skillware/                  # Core Framework Package
 │   ├── cli.py                  # Command-line interface
 │   └── core/
@@ -135,7 +143,9 @@ Skillware/
 │       └── loader.py           # Universal Skill Loader and Model Adapter
 ├── templates/                  # Boilerplate templates for new skills
 │   └── python_skill/           # Standard template with required files
-└── tests/                      # Automated test suite
+└── tests/                      # Clone-repo tests (framework + optional maintainer skill tests)
+    ├── test_*.py               # Framework tests (loader, CLI, issuer, …)
+    └── skills/                 # Optional maintainer skill tests (edge cases)
 ```
 
 ## Quick Start
@@ -161,11 +171,16 @@ pip install -e .
 ### 2. Verify your installation
 
 ```bash
-pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working. Running `skillware` with no arguments opens the interactive menu.
+This prints a table of all locally available skills and confirms the install
+and path resolution are working. Running `skillware` with no arguments opens
+the interactive menu.
+
+If `skillware` is not recognized, Python's `Scripts` directory may not be on
+your PATH — use `python -m skillware list` as a fallback. See
+[CLI Reference](docs/usage/cli.md#running-the-cli) for details.
 
 ### 3. Configuration
 
@@ -255,7 +270,7 @@ Also read the [Agent Code of Conduct](CODE_OF_CONDUCT.md). Open PRs with the [pu
 
 ## Comparison
 
-Skillware differs from the Model Context Protocol (MCP), and Anthropic's Skills repository in several ways:
+Skillware differs from the Model Context Protocol (MCP), and Agent Skills (SKILL.md) in several ways:
 
 *   **Model Agnostic**: Native adapters for Gemini, Claude, Ollama, and OpenAI.
 *   **Code-First**: Skills are executable Python packages, not just server specs.

{skillware-0.3.3 → skillware-0.3.6}/README.md

@@ -55,7 +55,7 @@ documentation. Runnable provider scripts are indexed in
 ```text
 Skillware/
 ├── docs/                       # Introduction, testing, skill catalog, usage guides (docs/usage/)
-├── examples/                   # Provider reference scripts (Gemini, Claude, OpenAI, Ollama, ...)
+├── examples/                   # Provider reference scripts — usage demos, not pytest (see examples/README.md)
 ├── skills/                     # Skill Registry
 │   └── category/               # Domain boundaries (e.g., finance)
 │       └── skill_name/         # The Skill bundle
@@ -63,7 +63,7 @@ Skillware/
 │           ├── skill.py        # Executable Python logic
 │           ├── instructions.md # Cognitive map for the LLM
 │           ├── card.json       # Optional UI presentation metadata
-│           └── test_skill.py   # Unit tests and schema validation
+│           └── test_skill.py   # Bundle test (required for new skills; see docs/TESTING.md)
 ├── skillware/                  # Core Framework Package
 │   ├── cli.py                  # Command-line interface
 │   └── core/
@@ -72,7 +72,9 @@ Skillware/
 │       └── loader.py           # Universal Skill Loader and Model Adapter
 ├── templates/                  # Boilerplate templates for new skills
 │   └── python_skill/           # Standard template with required files
-└── tests/                      # Automated test suite
+└── tests/                      # Clone-repo tests (framework + optional maintainer skill tests)
+    ├── test_*.py               # Framework tests (loader, CLI, issuer, …)
+    └── skills/                 # Optional maintainer skill tests (edge cases)
 ```
 
 ## Quick Start
@@ -98,11 +100,16 @@ pip install -e .
 ### 2. Verify your installation
 
 ```bash
-pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working. Running `skillware` with no arguments opens the interactive menu.
+This prints a table of all locally available skills and confirms the install
+and path resolution are working. Running `skillware` with no arguments opens
+the interactive menu.
+
+If `skillware` is not recognized, Python's `Scripts` directory may not be on
+your PATH — use `python -m skillware list` as a fallback. See
+[CLI Reference](docs/usage/cli.md#running-the-cli) for details.
 
 ### 3. Configuration
 
@@ -192,7 +199,7 @@ Also read the [Agent Code of Conduct](CODE_OF_CONDUCT.md). Open PRs with the [pu
 
 ## Comparison
 
-Skillware differs from the Model Context Protocol (MCP), and Anthropic's Skills repository in several ways:
+Skillware differs from the Model Context Protocol (MCP), and Agent Skills (SKILL.md) in several ways:
 
 *   **Model Agnostic**: Native adapters for Gemini, Claude, Ollama, and OpenAI.
 *   **Code-First**: Skills are executable Python packages, not just server specs.

{skillware-0.3.3 → skillware-0.3.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.3.3"
+version = "0.3.6"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [
@@ -23,6 +23,7 @@ dependencies = [
     "python-dotenv",
     "beautifulsoup4",
     "packaging",
+    "rich>=13.0",
 ]
 requires-python = ">=3.10"
 
@@ -36,9 +37,7 @@ dev = [
     "flake8",
     "black",
 ]
-cli = [
-    "rich>=13.0",
-]
+cli = []
 gemini = [
     "google-genai",
 ]
@@ -51,12 +50,22 @@ openai = [
 office = [
     "pymupdf",
 ]
+defi = [
+    "web3>=6.0.0",
+]
+embeddings = [
+    "fastembed",
+    "numpy",
+]
 all = [
     "rich>=13.0",
     "google-genai",
     "anthropic",
     "openai",
     "pymupdf",
+    "web3>=6.0.0",
+    "fastembed",
+    "numpy",
 ]
 
 [tool.setuptools]
@@ -69,3 +78,11 @@ include = ["skillware*", "skills*"]
 # and this wildcard. No per-skill entries needed when adding registry skills.
 [tool.setuptools.package-data]
 skills = ["**/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "skills"]
+addopts = "--ignore=examples"
+
+[tool.black]
+line-length = 88
+target-version = ["py310"]

skillware-0.3.6/skills/compliance/mica_module/test_skill.py

@@ -0,0 +1,67 @@
+import os
+
+import pytest
+import yaml
+
+from .skill import MiCAModuleSkill
+
+
+@pytest.fixture
+def skill():
+    return MiCAModuleSkill()
+
+
+@pytest.fixture
+def manifest():
+    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+    with open(manifest_path, "r", encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def test_skill_manifest_consistency(skill, manifest):
+    skill_manifest = skill.manifest
+    assert skill_manifest["name"] == manifest["name"]
+    assert skill_manifest["version"] == manifest["version"]
+
+
+def test_stateless_rag_execution(skill):
+    result = skill.execute(
+        {
+            "user_prompt": (
+                "I want to issue an asset-referenced token. "
+                "What are the authorization rules?"
+            ),
+            "run_evaluator": False,
+        }
+    )
+    assert result["policy_status"] == "CAUTION"
+    assert "retrieved_sections" in result
+    assert "final_context_for_agent" in result
+    assert "Evaluator disabled" in result["gemini_evaluator_feedback"]["holes_found"]
+
+
+def test_router_normalization(skill):
+    mock_corpus = [
+        {
+            "title_num": "Title V",
+            "article_num": "Article 59",
+            "keywords": ["authorisation", "casp"],
+            "content": "CASP Authorization rules...",
+        }
+    ]
+    matched = skill._route_and_fetch("Authorization of a CASP", mock_corpus)
+    assert len(matched) > 0
+    assert matched[0]["article_num"] == "Article 59"
+
+
+def test_router_deduplication(skill):
+    mock_corpus = [
+        {
+            "title_num": "Title V",
+            "article_num": "Article 59",
+            "keywords": ["authorisation", "casp"],
+            "content": "CASP Authorization rules...",
+        }
+    ]
+    matched = skill._route_and_fetch("authorisation casp", mock_corpus)
+    assert len(matched) == 1

{skillware-0.3.3 → skillware-0.3.6}/skills/compliance/pii_masker/skill.py

@@ -11,10 +11,7 @@ class PIIMaskerSkill(BaseSkill):
 
     @property
     def manifest(self) -> Dict[str, Any]:
-        return {
-            "name": "compliance/pii_masker",
-            "version": "0.1.0"
-        }
+        return {"name": "compliance/pii_masker", "version": "0.1.0"}
 
     def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:
         text = params.get("text", "")
@@ -25,7 +22,7 @@ class PIIMaskerSkill(BaseSkill):
         sanitized_text = self._apply_mode(sanitized_text, mode)
 
         # Build unique entity types list
-        entities = list(set([re.sub(r'_[0-9]+$', '', e) for e in detected_entities]))
+        entities = list(set([re.sub(r"_[0-9]+$", "", e) for e in detected_entities]))
 
         return {
             "sanitized_text": sanitized_text,
@@ -33,17 +30,21 @@ class PIIMaskerSkill(BaseSkill):
                 "detected_entities": entities,
                 "entity_count": len(detected_entities),
                 "security_level": "local-only",
-                "model": "arpacorp/micro-f1-mask"
-            }
+                "model": "arpacorp/micro-f1-mask",
+            },
         }
 
     def _call_ollama(self, text: str, endpoint: str) -> Tuple[str, List[str]]:
         try:
-            response = requests.post(f"{endpoint}/api/generate", json={
-                "model": "arpacorp/micro-f1-mask",
-                "prompt": text,
-                "stream": False
-            }, timeout=30)
+            response = requests.post(
+                f"{endpoint}/api/generate",
+                json={
+                    "model": "arpacorp/micro-f1-mask",
+                    "prompt": text,
+                    "stream": False,
+                },
+                timeout=30,
+            )
             if response.status_code == 200:
                 result_text = response.json().get("response", text)
             else:
@@ -56,7 +57,7 @@ class PIIMaskerSkill(BaseSkill):
             result_text = text
 
         # Detect entities in the response
-        detected = re.findall(r'\[([A-Z_]+(?:_[0-9]+)?)\]', result_text)
+        detected = re.findall(r"\[([A-Z_]+(?:_[0-9]+)?)\]", result_text)
         return result_text, detected
 
     def _apply_mode(self, text: str, mode: str) -> str:
@@ -64,14 +65,14 @@ class PIIMaskerSkill(BaseSkill):
             return text
 
         # Pattern to catch [DOCUMENT], [PERSON_1], etc.
-        pattern = r'\[[A-Z_]+(?:_[0-9]+)?\]'
+        pattern = r"\[[A-Z_]+(?:_[0-9]+)?\]"
         if mode == "redact":
             return re.sub(pattern, "XXXX", text)
         elif mode == "remove":
             # Replace token and any immediate preceding/following spaces safely
             # A simple sub is sufficient. Cleaning up double spaces.
             text = re.sub(pattern, "", text)
-            text = re.sub(r'\s+', ' ', text).strip()
+            text = re.sub(r"\s+", " ", text).strip()
             return text
 
         return text

skillware-0.3.6/skills/compliance/pii_masker/test_skill.py

@@ -0,0 +1,58 @@
+import os
+
+import pytest
+import yaml
+
+from .skill import PIIMaskerSkill
+
+
+@pytest.fixture
+def skill():
+    return PIIMaskerSkill()
+
+
+@pytest.fixture
+def manifest():
+    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+    with open(manifest_path, "r", encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def test_skill_manifest_consistency(skill, manifest):
+    skill_manifest = skill.manifest
+    assert skill_manifest["name"] == manifest["name"]
+    assert skill_manifest["version"] == manifest["version"]
+
+
+def test_pii_masker_modes(mocker, skill):
+    mock_response = (
+        "Hello [PERSON_1], your wallet [CRYPTO_ADDRESS] and [EMAIL] have been verified."
+    )
+    mocker.patch.object(
+        skill,
+        "_call_ollama",
+        return_value=(mock_response, ["PERSON_1", "CRYPTO_ADDRESS", "EMAIL"]),
+    )
+
+    sample_text = (
+        "Hello John Doe, your wallet 0xabc and john@doe.com have been verified."
+    )
+
+    result_mask = skill.execute({"text": sample_text})
+    assert (
+        result_mask["sanitized_text"]
+        == "Hello [PERSON_1], your wallet [CRYPTO_ADDRESS] and [EMAIL] have been verified."
+    )
+    assert "PERSON" in result_mask["metadata"]["detected_entities"]
+    assert "CRYPTO_ADDRESS" in result_mask["metadata"]["detected_entities"]
+
+    result_redact = skill.execute({"text": sample_text, "mode": "redact"})
+    assert (
+        result_redact["sanitized_text"]
+        == "Hello XXXX, your wallet XXXX and XXXX have been verified."
+    )
+
+    result_remove = skill.execute({"text": sample_text, "mode": "remove"})
+    assert (
+        result_remove["sanitized_text"] == "Hello , your wallet and have been verified."
+    )

{skillware-0.3.3 → skillware-0.3.6}/skills/compliance/tos_evaluator/skill.py

@@ -213,7 +213,9 @@ class TOSEvaluatorSkill(BaseSkill):
         try:
             response = self.session.get(robots_url, timeout=10)
             if response.status_code >= 400:
-                assessment["reason"] = f"robots.txt returned HTTP {response.status_code}."
+                assessment["reason"] = (
+                    f"robots.txt returned HTTP {response.status_code}."
+                )
                 return assessment
 
             parser = RobotFileParser()
@@ -266,13 +268,20 @@ class TOSEvaluatorSkill(BaseSkill):
                 else:
                     candidates[item["url"]] = item
 
-        ordered = sorted(candidates.values(), key=lambda item: item["score"], reverse=True)
+        ordered = sorted(
+            candidates.values(), key=lambda item: item["score"], reverse=True
+        )
         return {"candidates": ordered[:max_terms_pages]}
 
-    def _extract_candidate_links(self, page_url: str, origin: str) -> List[Dict[str, Any]]:
+    def _extract_candidate_links(
+        self, page_url: str, origin: str
+    ) -> List[Dict[str, Any]]:
         links: List[Dict[str, Any]] = []
         response = self._safe_get(page_url, timeout=10)
-        if not response or "html" not in response.headers.get("Content-Type", "").lower():
+        if (
+            not response
+            or "html" not in response.headers.get("Content-Type", "").lower()
+        ):
             return links
 
         soup = BeautifulSoup(response.text[:300000], "html.parser")
@@ -449,7 +458,10 @@ class TOSEvaluatorSkill(BaseSkill):
             return False
         if robots_assessment.get("can_fetch") is False:
             return False
-        return bool(tos_assessment.get("matched_clauses") or tos_assessment["status"] == "caution")
+        return bool(
+            tos_assessment.get("matched_clauses")
+            or tos_assessment["status"] == "caution"
+        )
 
     def _run_llm_evaluator(
         self, normalized: Dict[str, Any], tos_assessment: Dict[str, Any]
@@ -512,26 +524,33 @@ class TOSEvaluatorSkill(BaseSkill):
         verdict = "INSUFFICIENT_EVIDENCE"
         confidence_score = 0.35
         reason = "Insufficient policy evidence to safely approve the requested action."
-        recommended_next_step = "Review the discovered policy pages manually before proceeding."
+        recommended_next_step = (
+            "Review the discovered policy pages manually before proceeding."
+        )
 
         if robots_assessment.get("can_fetch") is False:
             verdict = "UNSAFE"
             confidence_score = 0.98
             reason = robots_assessment["reason"]
-            recommended_next_step = (
-                "Do not automate access to this path unless you have explicit permission."
-            )
+            recommended_next_step = "Do not automate access to this path unless you have explicit permission."
         elif tos_assessment["status"] == "blocked":
             verdict = "UNSAFE"
             confidence_score = 0.9
             reason = tos_assessment["summary"]
-            recommended_next_step = "Avoid the requested action or obtain explicit written permission."
+            recommended_next_step = (
+                "Avoid the requested action or obtain explicit written permission."
+            )
         elif tos_assessment["status"] == "caution":
             verdict = "CAUTION"
             confidence_score = 0.65
             reason = tos_assessment["summary"]
-            recommended_next_step = "Prefer an official API or documented integration path if one exists."
-        elif tos_assessment["status"] == "allowed" and robots_assessment.get("can_fetch") is not False:
+            recommended_next_step = (
+                "Prefer an official API or documented integration path if one exists."
+            )
+        elif (
+            tos_assessment["status"] == "allowed"
+            and robots_assessment.get("can_fetch") is not False
+        ):
             verdict = "SAFE"
             confidence_score = 0.72
             reason = tos_assessment["summary"]
@@ -575,7 +594,9 @@ class TOSEvaluatorSkill(BaseSkill):
             "tos_assessment": tos_assessment,
             "llm_assessment": llm_assessment or {"status": "not_used"},
             "discovered_policy_urls": {
-                "candidates": [item["url"] for item in policy_candidates.get("candidates", [])]
+                "candidates": [
+                    item["url"] for item in policy_candidates.get("candidates", [])
+                ]
             },
             "evidence": evidence,
         }

{skillware-0.3.3 → skillware-0.3.6}/skills/data_engineering/novelty_extractor/test_skill.py

@@ -1,32 +1,66 @@
+import os
+from unittest.mock import MagicMock
+
+import numpy as np
 import pytest
 import yaml
-import os
+
 from .skill import NoveltyExtractor
 
 
+def _mock_embed_vectors(texts):
+    """Deterministic keyword vectors — no HuggingFace download in CI."""
+    vectors = []
+    for text in texts:
+        t = text.lower()
+        if "bitcoin" in t:
+            vectors.append(np.array([1.0, 0.0, 0.0], dtype=float))
+        elif "sky" in t or "blue" in t:
+            vectors.append(np.array([0.0, 1.0, 0.0], dtype=float))
+        elif "python" in t:
+            vectors.append(np.array([0.0, 0.0, 1.0], dtype=float))
+        else:
+            vectors.append(np.array([0.1, 0.1, 0.1], dtype=float))
+    return vectors
+
+
+@pytest.fixture(autouse=True)
+def mock_embedding_model(monkeypatch):
+    """Bundle tests must stay offline; mock fastembed to avoid HF rate limits in CI."""
+    NoveltyExtractor._model = None
+    mock_model = MagicMock()
+    mock_model.embed.side_effect = _mock_embed_vectors
+
+    @classmethod
+    def _fake_get_model(cls):
+        if cls._model is None:
+            cls._model = mock_model
+        return cls._model
+
+    monkeypatch.setattr(NoveltyExtractor, "_get_model", _fake_get_model)
+    yield
+    NoveltyExtractor._model = None
+
+
 @pytest.fixture
 def skill():
-    """Fixture to initialize the skill."""
     return NoveltyExtractor()
 
 
 @pytest.fixture
 def manifest():
-    """Fixture to load manifest.yaml for validation."""
     manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
     with open(manifest_path, "r", encoding="utf-8") as f:
         return yaml.safe_load(f)
 
 
 def test_skill_manifest_consistency(skill, manifest):
-    """Verify the skill manifest matches manifest.yaml."""
     skill_manifest = skill.manifest
     assert skill_manifest["name"] == manifest["name"]
     assert skill_manifest["version"] == manifest["version"]
 
 
 def test_skill_returns_dict(skill):
-    """Execution result must be a dictionary."""
     result = skill.execute(
         {
             "dataset_chunk": "Bitcoin is going to rise.\n\nThe sky is blue.",
@@ -37,7 +71,6 @@ def test_skill_returns_dict(skill):
 
 
 def test_skill_output_keys(skill):
-    """Result must contain the three expected output keys."""
     result = skill.execute(
         {
             "dataset_chunk": "Bitcoin is going to rise.\n\nThe sky is blue.",
@@ -50,7 +83,6 @@ def test_skill_output_keys(skill):
 
 
 def test_skill_filters_redundant_chunks(skill):
-    """Semantically similar chunks should be filtered out."""
     result = skill.execute(
         {
             "dataset_chunk": (
@@ -67,7 +99,6 @@ def test_skill_filters_redundant_chunks(skill):
 
 
 def test_skill_empty_input(skill):
-    """Empty input should return empty result without crashing."""
     result = skill.execute(
         {
             "dataset_chunk": "",
@@ -79,7 +110,6 @@ def test_skill_empty_input(skill):
 
 
 def test_skill_baseline_filters_seen_content(skill):
-    """Chunks already in baseline should be filtered out."""
     baseline = "Bitcoin is going to rise.\n\nThe sky is blue."
     result = skill.execute(
         {
@@ -93,7 +123,6 @@ def test_skill_baseline_filters_seen_content(skill):
 
 
 def test_skill_sentence_strategy(skill):
-    """Sentence chunking strategy should work without crashing."""
     result = skill.execute(
         {
             "dataset_chunk": "Bitcoin is going to rise. The sky is blue. Python is great.",