skill-tuple-space 0.1.0__tar.gz

skill_tuple_space-0.1.0/.devcontainer/maintainer/Containerfile

@@ -0,0 +1,11 @@
+FROM mcr.microsoft.com/devcontainers/python:3.12-bookworm
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git curl vim jq \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /workspace
+
+RUN pip install --upgrade pip hatch ruff black mypy
+
+USER vscode

skill_tuple_space-0.1.0/.devcontainer/maintainer/devcontainer.json

@@ -0,0 +1,29 @@
+{
+  "name": "aider-skills dev",
+  "build": {
+    "dockerfile": "Containerfile",
+    "context": "../.."
+  },
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached",
+  "workspaceFolder": "/workspace",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.black-formatter",
+        "charliermarsh.ruff",
+        "ms-python.mypy-type-checker",
+        "eamodio.gitlens"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/local/bin/python",
+        "editor.formatOnSave": true,
+        "[python]": {
+          "editor.defaultFormatter": "ms-python.black-formatter"
+        }
+      }
+    }
+  },
+  "postCreateCommand": "bash .devcontainer/agentskills/scripts/post-create.sh",
+  "remoteUser": "vscode"
+}

skill_tuple_space-0.1.0/.devcontainer/maintainer/scripts/build.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+IMAGE_NAME="aider-skills-dev"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+CONTAINERFILE="$SCRIPT_DIR/../Containerfile"
+
+command -v podman &>/dev/null && RUNTIME="podman" || RUNTIME="docker"
+echo "==> Runtime: $RUNTIME"
+
+$RUNTIME build \
+  --file "$CONTAINERFILE" \
+  --tag "$IMAGE_NAME:latest" \
+  "$REPO_ROOT"
+
+echo "==> Built: $IMAGE_NAME:latest"
+echo "    Next: .devcontainer/maintainer/scripts/run.sh"
+

skill_tuple_space-0.1.0/.devcontainer/maintainer/scripts/post-create.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "==> Installing aider-skills in editable (dev) mode ..."
+pip install -e ".[dev]" --quiet
+
+echo "==> Confirming CLI entry point ..."
+aider-skills --version
+
+echo "==> Dev environment ready!"
+echo "    Run: aider-skills --help"
+echo "    Run: pytest"

skill_tuple_space-0.1.0/.devcontainer/maintainer/scripts/run.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Usage:
+#   ./run.sh              — interactive shell
+#   ./run.sh pytest       — run tests and exit
+#   ./run.sh aider-skills --help
+set -euo pipefail
+
+IMAGE_NAME="aider-skills-dev"
+CONTAINER_NAME="aider-skills-dev"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+command -v podman &>/dev/null && RUNTIME="podman" || RUNTIME="docker"
+$RUNTIME rm -f "$CONTAINER_NAME" 2>/dev/null || true
+
+if [ $# -eq 0 ]; then
+  TTY_FLAGS=("-it"); EXEC_ARGS=("bash")
+else
+  TTY_FLAGS=("-i");  EXEC_ARGS=("$@")
+fi
+
+$RUNTIME run \
+  "${TTY_FLAGS[@]}" \
+  --rm \
+  --name "$CONTAINER_NAME" \
+  --volume "$REPO_ROOT:/workspace:z" \
+  --workdir /workspace \
+  --user vscode \
+  "$IMAGE_NAME:latest" \
+  "${EXEC_ARGS[@]}"

skill_tuple_space-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - name: Install dev dependencies
+        run: uv sync --extra dev
+      - name: Ruff check
+        run: uv run ruff check .
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+  typecheck:
+    name: Type check
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - name: Install dev dependencies
+        run: uv sync --extra dev
+      - name: mypy
+        run: uv run mypy src/
+
+  test:
+    name: Test / Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.12"
+          - "3.13"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install dev dependencies
+        run: uv sync --extra dev
+      - name: Run tests
+        run: uv run pytest tests/ -v --tb=short

skill_tuple_space-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,75 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"   # triggers on v0.1.0, v1.2.3, etc.
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build wheel and sdist
+        run: |
+          uv pip install hatchling --system
+          python -m hatchling build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/skill-tuple-space
+    permissions:
+      id-token: write   # required for trusted publishing (no API key needed)
+
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-github-release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true

skill_tuple_space-0.1.0/.github/workflows/set-label-triage-to-new-issue.yml

@@ -0,0 +1,21 @@
+name: Set label triage to new issue
+on:
+  issues:
+    types:
+      - reopened
+      - opened
+jobs:
+  label_issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/github-script@v6
+        with:
+          script: |
+            github.rest.issues.addLabels({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              labels: ["triage"]
+            })

skill_tuple_space-0.1.0/.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+*.egg
+*.whl
+MANIFEST
+
+# uv / hatch
+.venv/
+.hatch/
+.uv/
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+htmlcov/
+.coverage
+coverage.xml
+
+# skill-space runtime data
+~/.skill-space/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# secrets
+.env
+*.env.local

skill_tuple_space-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Halter
+
+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.

skill_tuple_space-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: skill-tuple-space
+Version: 0.1.0
+Summary: Fuzzy Tuple Space for Agent Skills — index, search, and predict across skill git repos
+Author-email: roebi <roebi@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: gitpython>=3.1
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Requires-Dist: sentence-transformers>=3
+Requires-Dist: sqlite-vec>=0.1
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: types-pyyaml>=6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# skill-tuple-space
+
+**Fuzzy Tuple Space for Agent Skills.**
+
+Inspired by David Gelernter's Linda coordination language and JavaSpaces,
+`skill-tuple-space` indexes your agent skill git repos into a local SQLite store
+and lets you query them using two complementary mechanisms:
+
+- **Fuzzy layer** — membership-function scoring on structured metadata
+  (`skill_class`, `crud_verb`, `topic`, `requires_role`).
+- **Semantic layer** — RAG / cosine similarity on SKILL.md descriptions
+  via `sentence-transformers`.
+
+These are **two distinct things**: the semantic layer finds what is _similar_,
+the fuzzy layer reasons about how well something _fits your current taxonomy and context_.
+
+## Install
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+## Quickstart
+
+```bash
+# 1. Copy and edit config
+mkdir -p ~/.skill-space
+cp config.example.toml ~/.skill-space/config.toml
+
+# 2. Index your repos
+skill-space index run
+
+# 3. Semantic + fuzzy search
+skill-space search query "create something visual with 3d"
+
+# 4. Linda-style template matching
+skill-space search read "skill_class=Process, crud_verb=create, topic=*"
+
+# 5. Learning journal
+skill-space learn claim create-openscad-from-construction-image-en
+skill-space learn done create-openscad-from-construction-image-en --level 4
+skill-space learn next --topic agent-skills
+
+# 6. Space health
+skill-space space stats
+skill-space space drift
+```
+
+## Architecture
+
+```
+src/skill_space/
+├── cli.py        # typer CLI entry point
+├── indexer.py    # git clone + SKILL.md parse + embed
+├── embedder.py   # sentence-transformers (all-MiniLM-L6-v2, 384-dim)
+├── store.py      # SQLite + sqlite-vec persistence
+├── matcher.py    # fuzzy membership functions + cosine combiner
+├── journal.py    # learning events CRUD
+├── predictor.py  # readiness scoring + next-skill suggestion
+└── display.py    # rich terminal output
+```
+
+## License
+
+MIT

skill_tuple_space-0.1.0/README.md

@@ -0,0 +1,65 @@
+# skill-tuple-space
+
+**Fuzzy Tuple Space for Agent Skills.**
+
+Inspired by David Gelernter's Linda coordination language and JavaSpaces,
+`skill-tuple-space` indexes your agent skill git repos into a local SQLite store
+and lets you query them using two complementary mechanisms:
+
+- **Fuzzy layer** — membership-function scoring on structured metadata
+  (`skill_class`, `crud_verb`, `topic`, `requires_role`).
+- **Semantic layer** — RAG / cosine similarity on SKILL.md descriptions
+  via `sentence-transformers`.
+
+These are **two distinct things**: the semantic layer finds what is _similar_,
+the fuzzy layer reasons about how well something _fits your current taxonomy and context_.
+
+## Install
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+## Quickstart
+
+```bash
+# 1. Copy and edit config
+mkdir -p ~/.skill-space
+cp config.example.toml ~/.skill-space/config.toml
+
+# 2. Index your repos
+skill-space index run
+
+# 3. Semantic + fuzzy search
+skill-space search query "create something visual with 3d"
+
+# 4. Linda-style template matching
+skill-space search read "skill_class=Process, crud_verb=create, topic=*"
+
+# 5. Learning journal
+skill-space learn claim create-openscad-from-construction-image-en
+skill-space learn done create-openscad-from-construction-image-en --level 4
+skill-space learn next --topic agent-skills
+
+# 6. Space health
+skill-space space stats
+skill-space space drift
+```
+
+## Architecture
+
+```
+src/skill_space/
+├── cli.py        # typer CLI entry point
+├── indexer.py    # git clone + SKILL.md parse + embed
+├── embedder.py   # sentence-transformers (all-MiniLM-L6-v2, 384-dim)
+├── store.py      # SQLite + sqlite-vec persistence
+├── matcher.py    # fuzzy membership functions + cosine combiner
+├── journal.py    # learning events CRUD
+├── predictor.py  # readiness scoring + next-skill suggestion
+└── display.py    # rich terminal output
+```
+
+## License
+
+MIT

skill_tuple_space-0.1.0/config.example.toml

@@ -0,0 +1,16 @@
+# ~/.skill-space/config.toml
+# List all skill git repos to index into your local space.
+# trust: high | medium | low — influences result ranking.
+
+[[repos]]
+url   = "https://github.com/roebi/agent-skills"
+trust = "high"
+
+[[repos]]
+url   = "https://github.com/roebi/new-work-skills"
+trust = "high"
+
+# Example: third-party repo with lower trust
+# [[repos]]
+# url   = "https://github.com/someone/community-skills"
+# trust = "low"

skill_tuple_space-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "skill-tuple-space"
+version = "0.1.0"
+description = "Fuzzy Tuple Space for Agent Skills — index, search, and predict across skill git repos"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "roebi", email = "roebi@users.noreply.github.com" }]
+requires-python = ">=3.12"
+dependencies = [
+    "typer>=0.12",
+    "rich>=13",
+    "gitpython>=3.1",
+    "sentence-transformers>=3",
+    "sqlite-vec>=0.1",
+    "pyyaml>=6",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "mypy>=1.10",
+    "ruff>=0.4",
+    "types-PyYAML>=6",
+]
+
+[project.scripts]
+skill-space = "skill_space.cli:app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/skill_space"]
+
+[tool.hatch.envs.default]
+installer = "uv"
+
+[tool.mypy]
+strict = false
+warn_unused_ignores = true
+ignore_missing_imports = true
+
+[tool.ruff]
+line-length = 100

skill_tuple_space-0.1.0/src/skill_space/__init__.py

@@ -0,0 +1,3 @@
+"""skill-space — Fuzzy Tuple Space for Agent Skills."""
+
+__version__ = "0.1.0"

skill_tuple_space-0.1.0/src/skill_space/cli.py

@@ -0,0 +1,140 @@
+"""skill-space CLI — Fuzzy Tuple Space for Agent Skills."""
+
+import typer
+from rich.console import Console
+
+app = typer.Typer(
+    name="skill-space",
+    help="Fuzzy Tuple Space for Agent Skills. Index repos, search by fuzzy template, track learning.",
+    no_args_is_help=True,
+)
+console = Console()
+
+
+# ── Sub-command groups ─────────────────────────────────────────────────────────
+
+index_app = typer.Typer(help="Index skill git repos into the local space.")
+search_app = typer.Typer(help="Search and match skills.")
+learn_app = typer.Typer(help="Learning journal: claim, done, next.")
+space_app = typer.Typer(help="Space health: stats, drift.")
+
+app.add_typer(index_app, name="index")
+app.add_typer(search_app, name="search")
+app.add_typer(learn_app, name="learn")
+app.add_typer(space_app, name="space")
+
+
+# ── index ──────────────────────────────────────────────────────────────────────
+
+
+@index_app.command("run")
+def index_run(
+    repo: str = typer.Option(None, help="Single repo URL to index (overrides config)."),
+    force: bool = typer.Option(False, "--force", help="Re-index even if up to date."),
+) -> None:
+    """Crawl configured repos, parse SKILL.md files, embed and store."""
+    from skill_space.indexer import Indexer
+
+    indexer = Indexer()
+    indexer.run(repo_url=repo, force=force)
+
+
+# ── search ─────────────────────────────────────────────────────────────────────
+
+
+@search_app.command("query")
+def search_query(
+    query: str = typer.Argument(
+        ..., help="Free-text query, e.g. 'create something visual with 3d'"
+    ),
+    skill_class: str = typer.Option(
+        None, "--class", help="Filter: Role | Topic | Process | OneStepProcess"
+    ),
+    lang: str = typer.Option("en", "--lang", help="Language filter."),
+    top: int = typer.Option(5, "--top", help="Number of results."),
+) -> None:
+    """Semantic + fuzzy search across all indexed skills."""
+    from skill_space.matcher import Matcher
+
+    matcher = Matcher()
+    results = matcher.search(query=query, skill_class=skill_class, lang=lang, top=top)
+    from skill_space.display import display_results
+
+    display_results(results)
+
+
+@search_app.command("read")
+def search_read(
+    template: str = typer.Argument(
+        ...,
+        help="Linda-style template, e.g. 'skill_class=Process, crud_verb=create, topic=*'",
+    ),
+) -> None:
+    """Template-based tuple matching (JavaSpaces / Linda style)."""
+    from skill_space.matcher import Matcher
+
+    matcher = Matcher()
+    results = matcher.read_template(template)
+    from skill_space.display import display_results
+
+    display_results(results)
+
+
+# ── learn ──────────────────────────────────────────────────────────────────────
+
+
+@learn_app.command("claim")
+def learn_claim(skill_name: str = typer.Argument(...)) -> None:
+    """Mark a skill as 'currently learning'."""
+    from skill_space.journal import Journal
+
+    Journal().claim(skill_name)
+    console.print(f"[green]Claimed:[/green] {skill_name}")
+
+
+@learn_app.command("done")
+def learn_done(
+    skill_name: str = typer.Argument(...),
+    level: int = typer.Option(..., "--level", min=1, max=5, help="Mastery level reached (1–5)."),
+) -> None:
+    """Record completion of a skill at a given mastery level."""
+    from skill_space.journal import Journal
+
+    Journal().done(skill_name, level=level)
+    console.print(f"[green]Done:[/green] {skill_name} at level {level}")
+
+
+@learn_app.command("next")
+def learn_next(
+    topic: str = typer.Option(None, "--topic", help="Filter suggestions by topic."),
+) -> None:
+    """Predict the best next skill to learn based on your journal."""
+    from skill_space.predictor import Predictor
+
+    suggestion = Predictor().next_skill(topic=topic)
+    from skill_space.display import display_suggestion
+
+    display_suggestion(suggestion)
+
+
+# ── space ──────────────────────────────────────────────────────────────────────
+
+
+@space_app.command("stats")
+def space_stats() -> None:
+    """Show space statistics: repos indexed, skill count, last sync."""
+    from skill_space.store import Store
+
+    Store().print_stats()
+
+
+@space_app.command("drift")
+def space_drift() -> None:
+    """Detect stale skills: pinned commits behind HEAD, old last-touched dates."""
+    from skill_space.indexer import Indexer
+
+    Indexer().drift_report()
+
+
+if __name__ == "__main__":
+    app()