first commit

Author: TusharKarkera22

.github/workflows/release.yml

@@ -0,0 +1,97 @@
+name: Test, Build, Publish
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+    branches: [main]
+
+jobs:
+  # ─── Run tests on every push / PR ────────────────────────────────────────
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev,scale,visual,mcp]"
+
+      - name: Run tests
+        run: pytest --cov=repomap --cov-report=term-missing
+
+  # ─── Build Python wheel + sdist (only on version tags) ───────────────────
+  build-python:
+    name: Build Python package
+    needs: test
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build wheel and sdist
+        run: |
+          pip install build
+          python -m build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+  # ─── Publish to PyPI using trusted publishing (no token needed) ──────────
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build-python
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+    permissions:
+      id-token: write   # required for OIDC trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # ─── Publish npm wrapper to npmjs.com ────────────────────────────────────
+  publish-npm:
+    name: Publish to npm
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      # Keep the npm package version in sync with the git tag (strips leading 'v')
+      - name: Sync npm version to git tag
+        working-directory: npm
+        run: |
+          TAG="${GITHUB_REF#refs/tags/v}"
+          npm version "$TAG" --no-git-tag-version
+
+      - name: Publish to npm
+        working-directory: npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,58 @@
+# ── Python ────────────────────────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+*.egg
+MANIFEST
+
+# ── Virtual environments ──────────────────────────────────────────────────────
+.venv/
+venv/
+env/
+ENV/
+
+# ── Build / dist ──────────────────────────────────────────────────────────────
+dist/
+build/
+
+# ── Testing ───────────────────────────────────────────────────────────────────
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+*.xml
+*.log
+
+# ── RepoMap local cache ───────────────────────────────────────────────────────
+.repomap/
+
+# ── IDE / editor ─────────────────────────────────────────────────────────────
+.vscode/settings.json
+.cursor/
+.claude/
+*.swp
+*.swo
+.idea/
+*.iml
+
+# ── macOS ─────────────────────────────────────────────────────────────────────
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# ── npm / Node ────────────────────────────────────────────────────────────────
+node_modules/
+npm/.npmrc
+
+# ── Secrets / env ─────────────────────────────────────────────────────────────
+.env
+.env.*
+.envrc
+*.pem
+*.key
+*.p12
+credentials.json
+secrets.json

.vscode/mcp.json

@@ -0,0 +1 @@
+{"servers":{"repomap":{"type":"stdio","command":"repomap","args":["serve","--transport","stdio"]}}}