livespec 0.24.0__tar.gz

livespec-0.24.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "livespec",
+  "description": "Local marketplace for the livespec Claude Code plugin (code intelligence + Spec traceability).",
+  "owner": {
+    "name": "Juan Pablo Diaz",
+    "email": "juanpablo516@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "livespec",
+      "source": "./plugin",
+      "description": "Code intelligence + Spec traceability: livespec MCP server, specialized subagent, and preloaded Skill."
+    }
+  ]
+}

livespec-0.24.0/.commit-guard.json

@@ -0,0 +1,3 @@
+{
+  "ignore_paths": ["\\.(png|jpe?g|gif|ico|webp|svg|pdf|woff2?|ttf|otf)$"]
+}

livespec-0.24.0/.github/workflows/ci.yml

@@ -0,0 +1,85 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint-build:
+    name: ruff + package build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+      - name: Create venv
+        run: uv venv --python 3.12
+      - name: Install
+        run: uv pip install -e ".[dev]"
+      - name: ruff check
+        run: uv run ruff check src tests
+      - name: Build wheel + sdist (regression gate for packaging config)
+        run: uv build
+      - name: Verify wheel contents
+        run: |
+          python3 - <<'EOF'
+          import glob, sys, zipfile
+          wheel = glob.glob("dist/*.whl")[0]
+          names = zipfile.ZipFile(wheel).namelist()
+          required = [
+              "livespec_mcp/storage/schema.sql",
+              "livespec_mcp/templates/AGENT_PLAYBOOK.md",
+          ]
+          missing = [r for r in required if r not in names]
+          if missing:
+              sys.exit(f"wheel missing required data files: {missing}")
+          print("wheel OK:", wheel)
+          EOF
+
+  test:
+    name: pytest (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Create venv
+        run: uv venv --python ${{ matrix.python-version }}
+      - name: Install
+        run: uv pip install -e ".[dev]"
+      - name: Run tests (no embeddings)
+        run: uv run pytest -q -m "not embeddings"
+
+  embeddings:
+    name: pytest -m embeddings
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+      - name: Create venv
+        run: uv venv --python 3.12
+      - name: Install with extras
+        run: uv pip install -e ".[dev,embeddings]"
+      - name: Cache HuggingFace models
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/huggingface
+          key: hf-embeddings-${{ runner.os }}
+      - name: Run embeddings tests
+        run: uv run pytest -q -m embeddings

livespec-0.24.0/.github/workflows/livespec-pr-comment.yml

@@ -0,0 +1,52 @@
+name: Livespec PR impact
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  spec-impact-comment:
+    name: Post Spec diff impact
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+
+      - name: Create venv
+        run: uv venv --python 3.12
+
+      - name: Install
+        run: uv pip install -e ".[dev]"
+
+      - name: Index workspace and render markdown
+        env:
+          LIVESPEC_WORKSPACE: ${{ github.workspace }}
+          GITHUB_BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          GITHUB_HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: uv run python scripts/pr_diff_impact.py > /tmp/livespec-pr-comment.md
+
+      - name: Show comment preview
+        run: cat /tmp/livespec-pr-comment.md
+
+      - name: Post PR comment
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if [ -z "${GH_TOKEN:-}" ]; then
+            echo "No GITHUB_TOKEN — skipping PR comment (markdown still in /tmp/livespec-pr-comment.md)"
+            exit 0
+          fi
+          gh pr comment "${{ github.event.pull_request.number }}" \
+            --body-file /tmp/livespec-pr-comment.md \
+            --repo "${{ github.repository }}"

livespec-0.24.0/.github/workflows/publish.yml

@@ -0,0 +1,65 @@
+name: Publish to PyPI
+
+# Publishes the `livespec` distribution to PyPI on every version tag push.
+# Uses PyPI Trusted Publishing (OIDC) — no API token or secret is stored here.
+#
+# Setup, one time. Because the project does not exist on PyPI yet, this is the
+# PENDING publisher flow, registered at the ACCOUNT level, not inside a project:
+#   pypi.org → Account settings → Publishing → add a pending publisher
+#     PyPI Project Name: livespec
+#     Owner:             Rixmerz
+#     Repository name:   livespec
+#     Workflow name:     publish.yml
+#     Environment:       (leave blank)
+# The first successful run creates the project and converts it to a normal
+# publisher. Once the project exists, the same settings live under
+# pypi.org → project → Manage → Publishing instead.
+#
+# The distribution, the console command and the GitHub repo are all `livespec`.
+# They used to disagree — package `livespec-mcp`, repo `livespec` — and since
+# Trusted Publishing matches on the REPO, a publisher registered under the old
+# name failed every release with:
+#   invalid-publisher: valid token, but no corresponding publisher
+#   `repository`: `Rixmerz/livespec`
+# which reads like a permissions problem and is really a name mismatch. It
+# silently broke v0.23.0 and v0.24.0. PyPI cannot rename a publisher, and it
+# permanently blocks re-registering a deleted project name — which is why the
+# distribution moved to `livespec` rather than reclaiming `livespec-mcp`.
+# If this ever returns: the `repository` claim printed in the failure log is
+# the authoritative value to compare against what is registered.
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # required for Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Verify version tag matches package version
+        run: |
+          PKG_VERSION="$(uv run python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          echo "package=$PKG_VERSION tag=$TAG_VERSION"
+          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
+            echo "::error::Tag $GITHUB_REF_NAME does not match pyproject version $PKG_VERSION"
+            exit 1
+          fi
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

livespec-0.24.0/.gitignore

@@ -0,0 +1,49 @@
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+.mcp-docs/
+.mcp-docs-agent-log-fallback/
+.coverage
+.env
+.DS_Store
+.claude/
+
+# RAG layer / ML model caches (never commit weights or local dumps)
+local_cache/
+models/
+.fastembed_cache/
+.huggingface/
+.cache/
+*.onnx
+*.safetensors
+*.gguf
+*.bin
+*.pt
+*.npy
+*.npz
+
+# Ad-hoc dumps from search/embeddings debugging
+chunks_dump.*
+embeddings_dump.*
+*.dump.json
+
+# Editor / OS personal
+.idea/
+.vscode/
+*.swp
+*.swo
+Thumbs.db
+
+# jig local scratch state
+.jig/
+
+# Playwright MCP debug output
+.playwright-mcp/
+.vise/