skillware 0.3.1__tar.gz → 0.3.2__tar.gz

{skillware-0.3.1/skillware.egg-info → skillware-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.3.1
+Version: 0.3.2
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -81,6 +81,7 @@ Dynamic: license-file
   <a href="#architecture">Architecture</a> •
   <a href="#quick-start">Quick Start</a> •
   <a href="#documentation">Documentation</a> •
+  <a href="CHANGELOG.md">Changelog</a> •
   <a href="#contributing">Contributing</a> •
   <a href="#comparison">Comparison</a> •
   <a href="#contact">Contact</a>
@@ -163,7 +164,7 @@ pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working.
+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.
 
 ### 3. Configuration
 
@@ -240,6 +241,7 @@ For other providers and shared integration patterns, see the [usage guides index
 | Topic | Link |
 | :--- | :--- |
 | Introduction | [docs/introduction.md](docs/introduction.md) |
+| Changelog | [CHANGELOG.md](CHANGELOG.md) |
 | Testing | [docs/TESTING.md](docs/TESTING.md) |
 | Skill library | [docs/skills/README.md](docs/skills/README.md) |
 | Usage guides | [index](docs/usage/README.md) — [Gemini](docs/usage/gemini.md) · [Claude](docs/usage/claude.md) · [OpenAI](docs/usage/openai.md) · [DeepSeek](docs/usage/deepseek.md) · [Ollama](docs/usage/ollama.md); [agent loops](docs/usage/agent_loops.md); [API keys](docs/usage/api_keys.md) |

{skillware-0.3.1 → skillware-0.3.2}/README.md

@@ -19,6 +19,7 @@
   <a href="#architecture">Architecture</a> •
   <a href="#quick-start">Quick Start</a> •
   <a href="#documentation">Documentation</a> •
+  <a href="CHANGELOG.md">Changelog</a> •
   <a href="#contributing">Contributing</a> •
   <a href="#comparison">Comparison</a> •
   <a href="#contact">Contact</a>
@@ -101,7 +102,7 @@ pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working.
+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.
 
 ### 3. Configuration
 
@@ -178,6 +179,7 @@ For other providers and shared integration patterns, see the [usage guides index
 | Topic | Link |
 | :--- | :--- |
 | Introduction | [docs/introduction.md](docs/introduction.md) |
+| Changelog | [CHANGELOG.md](CHANGELOG.md) |
 | Testing | [docs/TESTING.md](docs/TESTING.md) |
 | Skill library | [docs/skills/README.md](docs/skills/README.md) |
 | Usage guides | [index](docs/usage/README.md) — [Gemini](docs/usage/gemini.md) · [Claude](docs/usage/claude.md) · [OpenAI](docs/usage/openai.md) · [DeepSeek](docs/usage/deepseek.md) · [Ollama](docs/usage/ollama.md); [agent loops](docs/usage/agent_loops.md); [API keys](docs/usage/api_keys.md) |

{skillware-0.3.1 → skillware-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.3.1"
+version = "0.3.2"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [

{skillware-0.3.1 → skillware-0.3.2}/skills/compliance/mica_module/manifest.yaml

@@ -1,6 +1,7 @@
 name: compliance/mica_module
 version: 0.1.0
 description: A highly specialized, localized RAG and policy enforcement engine for the Markets in Crypto-Assets (MiCA) regulation.
+short_description: "Local RAG and policy enforcement engine for MiCA regulation."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/compliance/pii_masker/manifest.yaml

@@ -1,6 +1,7 @@
 name: compliance/pii_masker
 version: 0.1.0
 description: High-precision, local PII detection and redaction using the micro-f1-mask model via Ollama.
+short_description: "Detects and redacts PII locally using the micro-f1-mask model."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/compliance/tos_evaluator/manifest.yaml

@@ -1,6 +1,7 @@
 name: "compliance/tos_evaluator"
 version: "0.1.0"
 description: "Evaluates whether an intended automated website action appears permissible by checking robots.txt, discovered legal pages, and optional low-cost LLM review for ambiguous policy language."
+short_description: "Evaluates whether an automated web action is permitted by site policy."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/data_engineering/novelty_extractor/manifest.yaml

@@ -1,6 +1,7 @@
 name: "data_engineering/novelty_extractor"
 version: "0.1.0"
 description: "Filters a text dataset by semantic novelty, retaining only chunks that carry new information above a configurable threshold."
+short_description: "Filters text datasets by semantic novelty using local embeddings."
 issuer:
   name: Martin Rizzo Lozano
   email: rizzolozanomartin@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/data_engineering/synthetic_generator/manifest.yaml

@@ -1,6 +1,7 @@
 name: "data_engineering/synthetic_generator"
 version: "0.1.0"
 description: "Generates high-entropy structured synthetic data for model fine-tuning to avoid mode collapse."
+short_description: "Generates high-entropy synthetic JSONL data for model fine-tuning."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/dev_tools/issue_resolver/manifest.yaml

@@ -1,6 +1,7 @@
 name: "dev_tools/issue_resolver"
 version: "0.1.0"
 description: "Analyzes any GitHub issue against its target repository and produces a structured resolution plan with ranked implementation options, affected files, and caveats."
+short_description: "Analyzes a GitHub issue and produces a ranked implementation plan."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/finance/wallet_screening/manifest.yaml

@@ -2,6 +2,7 @@ name: wallet_screening
 version: 1.0.0
 description: |
   A comprehensive crypto wallet screening tool. Checks Ethereum addresses against sanctions lists (OFAC, FBI, etc.) and known malicious contracts (Mixers, Scams). analyze transaction history for risk.
+short_description: "Screens Ethereum wallets against OFAC sanctions and mixer lists."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/finance/wallet_screening/skill.py

@@ -1,11 +1,15 @@
 import json
 import os
+import re
 import requests
 import glob
 from typing import Any, Dict, List, Optional
 from datetime import datetime
 from skillware.core.base_skill import BaseSkill
 
+_ETH_ADDRESS_RE = re.compile(r"^0x[a-fA-F0-9]{40}$")
+_ZERO_WIDTH_CHARS = "\u200b\u200c\u200d\ufeff"
+
 
 class WalletScreeningSkill(BaseSkill):
     """
@@ -31,13 +35,17 @@ class WalletScreeningSkill(BaseSkill):
         # Load Additional Datasets dynamically (normalized files, etc.)
         self.additional_datasets = self._load_additional_datasets()
 
+        # ETH address -> sanctions records (built once; O(1) lookup per screen)
+        self._sanctions_index: Dict[str, List[Dict]] = {}
+        self._build_sanctions_index()
+
     @property
     def manifest(self) -> Dict[str, Any]:
         return {}
 
     def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:
-        address = params.get("address")
-        if not address or not self._validate_eth_address(address):
+        address = self.normalize_eth_address(params.get("address") or "")
+        if not address:
             return {"error": "Invalid Ethereum address provided."}
 
         if not self.etherscan_api_key:
@@ -49,9 +57,8 @@ class WalletScreeningSkill(BaseSkill):
         eth_usd = self._get_price(self.coingecko_url_usd, "usd")
         eth_eur = self._get_price(self.coingecko_url_eur, "eur")
 
-        # 2. Sanctions Check (Core + Additional)
-        sanctions_hits = self._check_against_sanctions(address)
-        sanctions_hits.extend(self._check_against_additional_sanctions(address))
+        # 2. Sanctions Check (FTM + additional lists via index)
+        sanctions_hits = self._lookup_sanctions_hits(address)
 
         # 3. Analyze Transactions
         analysis = self._analyze_transactions(txs, address)
@@ -126,10 +133,85 @@ class WalletScreeningSkill(BaseSkill):
 
     # --- API Helpers ---
 
-    def _validate_eth_address(self, address: str) -> bool:
-        return (
-            isinstance(address, str) and address.startswith("0x") and len(address) == 42
+    @staticmethod
+    def normalize_eth_address(address: str) -> Optional[str]:
+        """Normalize and validate an Ethereum address (EIP-55 checksum not required)."""
+        if not isinstance(address, str):
+            return None
+        cleaned = address.strip().translate(
+            {ord(c): None for c in _ZERO_WIDTH_CHARS}
         )
+        if not cleaned.lower().startswith("0x"):
+            return None
+        normalized = "0x" + cleaned[2:].lower()
+        if _ETH_ADDRESS_RE.match(normalized):
+            return normalized
+        return None
+
+    @staticmethod
+    def _iter_property_values(properties: Dict, key: str):
+        raw = properties.get(key)
+        if raw is None:
+            return
+        if isinstance(raw, list):
+            for item in raw:
+                if item is not None:
+                    yield str(item)
+        else:
+            yield str(raw)
+
+    def _eth_addresses_from_record(self, record: Dict) -> List[str]:
+        """Collect normalized Ethereum addresses from a sanctions or FTM record."""
+        found: List[str] = []
+        if "addresses" in record and isinstance(record["addresses"], list):
+            for a in record["addresses"]:
+                norm = self.normalize_eth_address(str(a))
+                if norm:
+                    found.append(norm)
+
+        properties = record.get("properties") or {}
+        if isinstance(properties, dict):
+            for key in ("address", "publicKey"):
+                for value in self._iter_property_values(properties, key):
+                    for part in value.split(","):
+                        norm = self.normalize_eth_address(part)
+                        if norm:
+                            found.append(norm)
+
+        if "address" in record and not isinstance(record["address"], list):
+            norm = self.normalize_eth_address(str(record["address"]))
+            if norm:
+                found.append(norm)
+
+        return list(dict.fromkeys(found))
+
+    def _build_sanctions_index(self) -> None:
+        """Index normalized ETH addresses from FTM and additional datasets."""
+        index: Dict[str, List[Dict]] = {}
+        for entity in self.sanctions_entities:
+            addrs = self._eth_addresses_from_record(entity)
+            if not addrs:
+                continue
+            tagged = dict(entity)
+            tagged["__source_file__"] = "entities.ftm.json"
+            for addr in addrs:
+                index.setdefault(addr, []).append(tagged)
+
+        for entry in self.additional_datasets:
+            addrs = self._eth_addresses_from_record(entry)
+            if not addrs:
+                continue
+            tagged = dict(entry)
+            for addr in addrs:
+                index.setdefault(addr, []).append(tagged)
+
+        self._sanctions_index = index
+
+    def _lookup_sanctions_hits(self, address: str) -> List[Dict]:
+        normalized = self.normalize_eth_address(address)
+        if not normalized:
+            return []
+        return list(self._sanctions_index.get(normalized, []))
 
     def _get_price(self, url: str, currency: str) -> float:
         try:
@@ -179,42 +261,6 @@ class WalletScreeningSkill(BaseSkill):
 
     # --- Logic Helpers ---
 
-    def _check_against_sanctions(self, address: str) -> List[Dict]:
-        hits = []
-        lower_addr = address.lower()
-        for entity in self.sanctions_entities:
-            matches = False
-            if "addresses" in entity:
-                if any(a.lower() == lower_addr for a in entity["addresses"]):
-                    matches = True
-            elif "properties" in entity and "address" in entity["properties"]:
-                if entity["properties"]["address"].lower() == lower_addr:
-                    matches = True
-
-            if matches:
-                entity["__source_file__"] = "entities.ftm.json"
-                hits.append(entity)
-        return hits
-
-    def _check_against_additional_sanctions(self, address: str) -> List[Dict]:
-        hits = []
-        lower_addr = address.lower()
-        for entry in self.additional_datasets:
-            addr = None
-            if "address" in entry:
-                addr = entry["address"]
-            elif "properties" in entry and "address" in entry["properties"]:
-                addr = entry["properties"]["address"]
-            elif "addresses" in entry and isinstance(entry["addresses"], list):
-                for a in entry["addresses"]:
-                    if a.lower() == lower_addr:
-                        addr = a
-                        break
-
-            if addr and addr.lower() == lower_addr:
-                hits.append(entry)
-        return hits
-
     def _analyze_transactions(
         self, txs: List[Dict], wallet_addr: str
     ) -> Dict[str, Any]:

{skillware-0.3.1 → skillware-0.3.2}/skills/office/pdf_form_filler/manifest.yaml

@@ -1,6 +1,7 @@
 name: pdf_form_filler
 version: 0.1.0
 description: Fills PDF forms based on natural language instructions.
+short_description: "Fills PDF forms from natural language instructions using Claude."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

{skillware-0.3.1 → skillware-0.3.2}/skills/optimization/prompt_rewriter/manifest.yaml

@@ -1,6 +1,7 @@
 name: "optimization/prompt_rewriter"
 version: "0.1.0"
 description: "A powerful middleware skill that aggressively compresses massive, bloated prompts into fewer tokens while retaining 100% of the semantic meaning and instructions."
+short_description: "Compresses bloated prompts into fewer tokens without losing meaning."
 issuer:
   name: Ross Peili
   email: vpeilivanidis@gmail.com

skillware-0.3.2/skillware/cli.py

@@ -0,0 +1,299 @@
+import argparse
+import yaml
+from pathlib import Path
+from typing import List, Dict, Any, Optional
+
+from skillware.core.loader import SkillLoader
+
+TABLE_STYLE = "bold #C7CEEA"  # lavender  - headers
+CATEGORY_STYLE = "bold #FFDAC1"  # peach     - category column
+ID_STYLE = "#B5EAD7"  # mint      - skill ID column
+BORDER_STYLE = "#C7CEEA"  # lavender  - table border
+
+SPLASH_STYLE = "#C7CEEA"  # lavender  - skillware splash color
+MENU_STYLE = "#FFDAC1"  # peach     - menu category
+
+
+def _get_skill_roots(skills_root_override: Optional[Path] = None) -> List[Path]:
+    """Return the list of roots to search for skills, mirrors SkillLoader resolution order."""
+    if skills_root_override is not None:
+        if skills_root_override.exists():
+            return [skills_root_override]
+        return []
+
+    roots = []
+    seen = set()
+
+    for root in (
+        SkillLoader._env_skill_roots()
+        + SkillLoader._cwd_skill_roots()
+        + [SkillLoader._bundled_skills_root()]
+    ):
+        resolved = root.resolve()
+        if resolved not in seen and resolved.exists():
+            seen.add(resolved)
+            roots.append(resolved)
+
+    return roots
+
+
+def _short_description(data: Dict[str, Any], max_len: int = 80) -> str:
+    """Return short_description if present, else first sentence of description truncated."""
+    short = data.get("short_description", "").strip()
+    if short:
+        return short[:max_len] + ("…" if len(short) > max_len else "")
+
+    desc = data.get("description", "").strip()
+
+    seps = [".", "!", "?"]
+
+    for sep in seps:
+        idx = desc.find(sep)
+        if idx != -1:
+            desc = desc[: idx + 1]
+            break
+
+    return desc[:max_len] + ("…" if len(desc) > max_len else "")
+
+
+def _discover_skills(
+    skills_root_override: Optional[Path] = None,
+) -> List[Dict[str, Any]]:
+    """Walk all skill roots and return a list of dicts with each skill's metadata."""
+    roots = _get_skill_roots(skills_root_override)
+
+    skills = []
+    seen_ids = set()
+
+    for root in roots:
+        for manifest_path in root.glob("*/*/manifest.yaml"):
+
+            if not SkillLoader._is_skill_dir(manifest_path.parent):
+                continue
+
+            with open(manifest_path, encoding="utf-8") as f:
+                data = yaml.safe_load(f) or {}
+
+            skill_id = f"{manifest_path.parent.parent.name}/{manifest_path.parent.name}"
+
+            # skip duplicates found in multiple roots
+            if skill_id in seen_ids:
+                continue
+            seen_ids.add(skill_id)
+
+            issuer = data.get("issuer") or {}
+
+            skills.append(
+                {
+                    "id": skill_id,
+                    "category": manifest_path.parent.parent.name,
+                    "name": manifest_path.parent.name,
+                    "version": data.get("version", "?").strip(),
+                    "description": _short_description(data),
+                    "requirements": ", ".join(data.get("requirements") or []).strip(),
+                    "issuer": issuer.get("github") or issuer.get("name") or "",
+                }
+            )
+
+    return skills
+
+
+def cmd_list(
+    skills_root_override: Optional[Path] = None,
+    category_filter: Optional[str] = None,
+    issuer_filter: Optional[str] = None,
+    console=None,
+) -> None:
+    """Print a formatted table of all available skills."""
+    try:
+        from rich.table import Table
+        from rich.console import Console
+        from rich import box
+    except ImportError:
+        raise SystemExit(
+            "rich is required for the CLI. Install it with: pip install 'skillware[cli]'"
+        )
+
+    if console is None:
+        console = Console()
+
+    skills = _discover_skills(skills_root_override)
+
+    if category_filter:
+        skills = [s for s in skills if s["category"] == category_filter]
+
+    if issuer_filter:
+        skills = [s for s in skills if s["issuer"] == issuer_filter]
+
+    if not skills:
+        console.print("No skills found.")
+        return
+
+    table = Table(
+        box=box.SIMPLE_HEAVY,
+        border_style=BORDER_STYLE,
+        header_style=TABLE_STYLE,
+        expand=True,
+    )
+
+    table.add_column("ID", style=ID_STYLE, no_wrap=True, ratio=2)
+    table.add_column("VERSION", style="dim", no_wrap=True, ratio=1)
+    table.add_column("CATEGORY", style=CATEGORY_STYLE, no_wrap=True, ratio=1)
+    table.add_column("ISSUER", style="dim", no_wrap=True, ratio=1)
+    table.add_column("DESCRIPTION", ratio=3)
+    table.add_column("REQUIREMENTS", style="dim", ratio=2)
+
+    for skill in skills:
+        table.add_row(
+            skill["id"],
+            skill["version"],
+            skill["category"],
+            skill["issuer"],
+            skill["description"],
+            skill["requirements"],
+        )
+
+    console.print(table)
+
+
+def _print_menu(console, menu) -> None:
+    for num, name, desc in menu:
+        console.print(f"    [{num}] {name:<20}— {desc}", style=MENU_STYLE)
+
+    console.print()
+
+
+def cmd_interactive(console=None, parser=None) -> None:
+    """Launch ASCII splash screen and interactive menu."""
+    try:
+        from rich.console import Console
+        from rich.text import Text
+    except ImportError:
+        raise SystemExit(
+            "rich is required for the CLI. Install it with: pip install 'skillware[cli]'"
+        )
+
+    import importlib.metadata
+
+    if console is None:
+        console = Console()
+
+    try:
+        version = importlib.metadata.version("skillware")
+    except importlib.metadata.PackageNotFoundError:
+        version = "dev"
+
+    splash = r"""
+  ███████╗██╗  ██╗██╗██╗     ██╗    ██╗ █████╗ ██████╗ ███████╗
+  ██╔════╝██║ ██╔╝██║██║     ██║    ██║██╔══██╗██╔══██╗██╔════╝
+  ███████╗█████╔╝ ██║██║     ██║ █╗ ██║███████║██████╔╝█████╗
+  ╚════██║██╔═██╗ ██║██║     ██║███╗██║██╔══██║██╔══██╗██╔══╝
+  ███████║██║  ██╗██║███████╗╚███╔███╔╝██║  ██║██║  ██║███████╗
+  ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝"""
+
+    console.print(Text(splash, style=SPLASH_STYLE))
+    console.print(
+        Text(
+            f"  Skill Management Framework — v{version}",
+            style=f"dim {SPLASH_STYLE}",
+        )
+    )
+
+    console.print(
+        Text(
+            "  https://skillware.site  ·  https://github.com/arpahls/skillware\n",
+            style=f"dim {SPLASH_STYLE}",
+        )
+    )
+
+    menu = [
+        ("1", "list", "discover and display all locally installed skills"),
+        ("2", "paths (soon, #81)", "show and repair skill directory resolution paths"),
+        ("3", "test (soon, #83)", "run test_skill.py for one or all skills"),
+        ("4", "help", "usage guide for any command"),
+    ]
+
+    commands = {
+        "1": "list",
+        "list": "list",
+        "2": "paths",
+        "paths": "paths",
+        "3": "test",
+        "test": "test",
+        "4": "help",
+        "help": "help",
+    }
+
+    _print_menu(console, menu)
+
+    while True:
+        try:
+            choice = input("  > ").strip().lower()
+        except (KeyboardInterrupt, EOFError):
+            console.print("\n  Bye.", style="dim")
+            return
+
+        if choice == "q":
+            console.print("  Bye.", style="dim")
+            return
+
+        command = commands.get(choice)
+
+        if command == "list":
+            cmd_list(console=console)
+        elif command in ("paths", "test"):
+            console.print(
+                f"  '{command}' is not yet implemented. Coming in a future release.",
+                style="dim",
+            )
+        elif command == "help":
+            if parser:
+                parser.print_help()
+            else:
+                console.print(
+                    "  Run 'skillware --help' for usage information.", style="dim"
+                )
+        else:
+            console.print(f"  Unknown command: '{choice}'", style="dim #FF9AA2")
+
+        console.print()
+        _print_menu(console, menu)
+
+
+def main() -> None:
+    """CLI entry point."""
+    parser = argparse.ArgumentParser(prog="skillware")
+    subparsers = parser.add_subparsers(dest="command")
+
+    list_parser = subparsers.add_parser("list", help="List all available skills.")
+    list_parser.add_argument(
+        "--skills-root",
+        type=Path,
+        default=None,
+        help="Override the skills directory path.",
+    )
+    list_parser.add_argument(
+        "--category",
+        default=None,
+        help="Filter skills by category.",
+    )
+    list_parser.add_argument(
+        "--issuer",
+        default=None,
+        help="Filter skills by issuer GitHub handle or name.",
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "list":
+        cmd_list(
+            skills_root_override=args.skills_root,
+            category_filter=args.category,
+            issuer_filter=args.issuer,
+        )
+    else:
+        cmd_interactive(parser=parser)
+
+
+if __name__ == "__main__":
+    main()

{skillware-0.3.1 → skillware-0.3.2/skillware.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.3.1
+Version: 0.3.2
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -81,6 +81,7 @@ Dynamic: license-file
   <a href="#architecture">Architecture</a> •
   <a href="#quick-start">Quick Start</a> •
   <a href="#documentation">Documentation</a> •
+  <a href="CHANGELOG.md">Changelog</a> •
   <a href="#contributing">Contributing</a> •
   <a href="#comparison">Comparison</a> •
   <a href="#contact">Contact</a>
@@ -163,7 +164,7 @@ pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working.
+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.
 
 ### 3. Configuration
 
@@ -240,6 +241,7 @@ For other providers and shared integration patterns, see the [usage guides index
 | Topic | Link |
 | :--- | :--- |
 | Introduction | [docs/introduction.md](docs/introduction.md) |
+| Changelog | [CHANGELOG.md](CHANGELOG.md) |
 | Testing | [docs/TESTING.md](docs/TESTING.md) |
 | Skill library | [docs/skills/README.md](docs/skills/README.md) |
 | Usage guides | [index](docs/usage/README.md) — [Gemini](docs/usage/gemini.md) · [Claude](docs/usage/claude.md) · [OpenAI](docs/usage/openai.md) · [DeepSeek](docs/usage/deepseek.md) · [Ollama](docs/usage/ollama.md); [agent loops](docs/usage/agent_loops.md); [API keys](docs/usage/api_keys.md) |

{skillware-0.3.1 → skillware-0.3.2}/tests/test_cli.py

@@ -1,4 +1,9 @@
-from skillware.cli import _discover_skills, cmd_list
+from skillware.cli import (
+    _discover_skills,
+    cmd_list,
+    cmd_interactive,
+    _short_description,
+)
 
 
 def test_discover_skills_returns_skills(tmp_path):
@@ -138,3 +143,79 @@ def test_cmd_list_filter_by_category(tmp_path):
     output = buf.getvalue()
     assert "office" in output
     assert "finance" not in output
+
+
+def test_short_description_uses_short_description_field():
+    """short_description field takes priority over description."""
+    data = {
+        "short_description": "Short one.",
+        "description": "This is a much longer description that should not appear.",
+    }
+    assert _short_description(data) == "Short one."
+
+
+def test_short_description_truncates_at_80_chars():
+    """short_description longer than 80 chars should be truncated with …"""
+    data = {"short_description": "A" * 90}
+    result = _short_description(data)
+    assert len(result) == 81  # 80 + "…"
+    assert result.endswith("…")
+
+
+def test_short_description_falls_back_to_first_sentence():
+    """Without short_description, use first sentence of description."""
+    data = {"description": "First sentence. Second sentence follows."}
+    assert _short_description(data) == "First sentence."
+
+
+def test_short_description_empty_manifest():
+    """Empty manifest should return empty string."""
+    assert _short_description({}) == ""
+
+
+def test_cmd_interactive_exits_on_q(monkeypatch):
+    """Entering q should exit cleanly."""
+    import io
+    from rich.console import Console
+
+    monkeypatch.setattr("builtins.input", lambda _: "q")
+    buf = io.StringIO()
+    cmd_interactive(console=Console(file=buf, force_terminal=False))
+    assert "Bye" in buf.getvalue()
+
+
+def test_cmd_interactive_unknown_command(monkeypatch):
+    """Unknown command should print error then exit on q."""
+    import io
+    from rich.console import Console
+
+    responses = iter(["unknown_cmd", "q"])
+    monkeypatch.setattr("builtins.input", lambda _: next(responses))
+    buf = io.StringIO()
+    cmd_interactive(console=Console(file=buf, force_terminal=False))
+    assert "Unknown command" in buf.getvalue()
+
+
+def test_cmd_interactive_list_dispatch(tmp_path, monkeypatch):
+    """Entering 1 or list should dispatch to cmd_list."""
+    import io
+    from rich.console import Console
+
+    skill_dir = tmp_path / "office" / "test_skill"
+    skill_dir.mkdir(parents=True)
+    (skill_dir / "skill.py").touch()
+    (skill_dir / "manifest.yaml").write_text(
+        "name: test_skill\nversion: 0.1.0\ndescription: Test.\n"
+        "short_description: Test skill.\n"
+    )
+
+    responses = iter(["1", "q"])
+    monkeypatch.setattr("builtins.input", lambda _: next(responses))
+    monkeypatch.chdir(tmp_path)
+
+    buf = io.StringIO()
+    console = Console(file=buf, force_terminal=False)
+    cmd_interactive(console=console)
+
+    output = buf.getvalue()
+    assert "test_skill" in output

skillware-0.3.1/skillware/cli.py

@@ -1,162 +0,0 @@
-import argparse
-import yaml
-from pathlib import Path
-from typing import List, Dict, Any, Optional
-
-from skillware.core.loader import SkillLoader
-
-
-def _get_skill_roots(skills_root_override: Optional[Path] = None) -> List[Path]:
-    """Return the list of roots to search for skills, mirrors SkillLoader resolution order."""
-    if skills_root_override is not None:
-        if skills_root_override.exists():
-            return [skills_root_override]
-        return []
-
-    roots = []
-    seen = set()
-
-    for root in (
-        SkillLoader._env_skill_roots()
-        + SkillLoader._cwd_skill_roots()
-        + [SkillLoader._bundled_skills_root()]
-    ):
-        resolved = root.resolve()
-        if resolved not in seen and resolved.exists():
-            seen.add(resolved)
-            roots.append(resolved)
-
-    return roots
-
-
-def _discover_skills(
-    skills_root_override: Optional[Path] = None,
-) -> List[Dict[str, Any]]:
-    """Walk all skill roots and return a list of dicts with each skill's metadata."""
-    roots = _get_skill_roots(skills_root_override)
-
-    skills = []
-    seen_ids = set()
-
-    for root in roots:
-        for manifest_path in root.glob("*/*/manifest.yaml"):
-
-            if not SkillLoader._is_skill_dir(manifest_path.parent):
-                continue
-
-            with open(manifest_path, encoding="utf-8") as f:
-                data = yaml.safe_load(f) or {}
-
-            skill_id = f"{manifest_path.parent.parent.name}/{manifest_path.parent.name}"
-
-            # skip duplicates found in multiple roots
-            if skill_id in seen_ids:
-                continue
-            seen_ids.add(skill_id)
-
-            issuer = data.get("issuer") or {}
-
-            skills.append(
-                {
-                    "id": skill_id,
-                    "category": manifest_path.parent.parent.name,
-                    "name": manifest_path.parent.name,
-                    "version": data.get("version", "?").strip(),
-                    "description": data.get("description", "").strip(),
-                    "requirements": ", ".join(data.get("requirements") or []).strip(),
-                    "issuer": issuer.get("github") or issuer.get("name") or "",
-                }
-            )
-
-    return skills
-
-
-def cmd_list(
-    skills_root_override: Optional[Path] = None,
-    category_filter: Optional[str] = None,
-    issuer_filter: Optional[str] = None,
-    console=None,
-) -> None:
-    """Print a formatted table of all available skills."""
-    try:
-        from rich.table import Table
-        from rich.console import Console
-    except ImportError:
-        raise SystemExit(
-            "rich is required for the CLI. Install it with: pip install 'skillware[cli]'"
-        )
-
-    if console is None:
-        console = Console()
-
-    skills = _discover_skills(skills_root_override)
-
-    if category_filter:
-        skills = [s for s in skills if s["category"] == category_filter]
-
-    if issuer_filter:
-        skills = [s for s in skills if s["issuer"] == issuer_filter]
-
-    if not skills:
-        console.print("No skills found.")
-        return
-
-    table = Table()
-
-    table.add_column("ID")
-    table.add_column("VERSION")
-    table.add_column("CATEGORY")
-    table.add_column("ISSUER")
-    table.add_column("DESCRIPTION")
-    table.add_column("REQUIREMENTS")
-
-    for skill in skills:
-        table.add_row(
-            skill["id"],
-            skill["version"],
-            skill["category"],
-            skill["issuer"],
-            skill["description"],
-            skill["requirements"],
-        )
-
-    console.print(table)
-
-
-def main() -> None:
-    """CLI entry point."""
-    parser = argparse.ArgumentParser(prog="skillware")
-    subparsers = parser.add_subparsers(dest="command")
-
-    list_parser = subparsers.add_parser("list", help="List all available skills.")
-    list_parser.add_argument(
-        "--skills-root",
-        type=Path,
-        default=None,
-        help="Override the skills directory path.",
-    )
-    list_parser.add_argument(
-        "--category",
-        default=None,
-        help="Filter skills by category.",
-    )
-    list_parser.add_argument(
-        "--issuer",
-        default=None,
-        help="Filter skills by issuer GitHub handle or name.",
-    )
-
-    args = parser.parse_args()
-
-    if args.command == "list":
-        cmd_list(
-            skills_root_override=args.skills_root,
-            category_filter=args.category,
-            issuer_filter=args.issuer,
-        )
-    else:
-        parser.print_help()
-
-
-if __name__ == "__main__":
-    main()