node-walk 0.2.0__tar.gz → 0.3.1__tar.gz

node_walk-0.3.1/.github/workflows/release.yml

@@ -0,0 +1,142 @@
+name: Release & Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump_type:
+        description: "Version bump type"
+        required: true
+        default: "patch"
+        type: choice
+        options:
+          - "patch"
+          - "minor"
+          - "major"
+      target:
+        description: "Publish destination"
+        required: true
+        default: "pypi"
+        type: choice
+        options:
+          - "pypi"
+          - "testpypi"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    name: Auto-bump, Tag, Build & Publish
+    runs-on: ubuntu-latest
+    environment:
+      name: ${{ inputs.target == 'testpypi' && 'testpypi' || 'pypi' }}
+      url: ${{ inputs.target == 'testpypi' && 'https://test.pypi.org/project/node-walk/' || 'https://pypi.org/project/node-walk/' }}
+    steps:
+      - name: Generate GitHub App Token
+        id: app_token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ steps.app_token.outputs.token }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build hatchling hatch-vcs
+
+      - name: Calculate Version, Update Changelog & Create Tag
+        id: auto_tag
+        run: |
+          python - << 'EOF'
+          import os, re, subprocess, datetime
+
+          bump = os.environ.get("INPUT_BUMP_TYPE", "patch")
+
+          # 1. Find latest git tag
+          try:
+              latest_tag = subprocess.check_output(["git", "describe", "--tags", "--abbrev=0"], text=True).strip()
+          except Exception:
+              latest_tag = "v0.1.0"
+
+          current_ver = latest_tag.lstrip("v")
+          parts = [int(p) for p in re.findall(r'\d+', current_ver)]
+          while len(parts) < 3:
+              parts.append(0)
+
+          # 2. Calculate target version
+          if bump == "major":
+              target_ver = f"{parts[0]+1}.0.0"
+          elif bump == "minor":
+              target_ver = f"{parts[0]}.{parts[1]+1}.0"
+          else:
+              target_ver = f"{parts[0]}.{parts[1]}.{parts[2]+1}"
+
+          new_tag = f"v{target_ver}"
+          today = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%d")
+
+          print(f"Release version: {target_ver} (from {current_ver} via {bump} bump)")
+
+          # 3. Update CHANGELOG.md automatically
+          changelog_path = "CHANGELOG.md"
+          if os.path.exists(changelog_path):
+              with open(changelog_path, "r", encoding="utf-8") as f:
+                  content = f.read()
+
+              replacement = f"## [Unreleased]\n\n---\n\n## [{target_ver}] - {today}"
+              if "## [Unreleased]" in content:
+                  new_content = content.replace("## [Unreleased]", replacement, 1)
+                  with open(changelog_path, "w", encoding="utf-8") as f:
+                      f.write(new_content)
+                  print(f"Updated {changelog_path} with header [{target_ver}] - {today}")
+
+          # 4. Configure git bot, commit changelog, and push tag + commit
+          subprocess.run(["git", "config", "user.name", "github-actions[bot]"], check=True)
+          subprocess.run(["git", "config", "user.email", "github-actions[bot]@users.noreply.github.com"], check=True)
+
+          # Commit CHANGELOG update
+          subprocess.run(["git", "add", "CHANGELOG.md"], check=True)
+          subprocess.run(["git", "commit", "-m", f"chore(release): release {new_tag} [skip ci]"], check=True)
+
+          # Tag the commit
+          subprocess.run(["git", "tag", "-a", new_tag, "-m", f"Release {new_tag}"], check=True)
+
+          # Push commit and tag back to repository
+          branch = os.environ.get("GITHUB_REF_NAME", "main")
+          subprocess.run(["git", "push", "origin", f"HEAD:{branch}"], check=True)
+          subprocess.run(["git", "push", "origin", new_tag], check=True)
+
+          with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as out:
+              out.write(f"version={target_ver}\n")
+              out.write(f"tag={new_tag}\n")
+          EOF
+        env:
+          INPUT_BUMP_TYPE: ${{ inputs.bump_type }}
+
+      - name: Build package distributions
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: ${{ (inputs.target == 'testpypi') && 'https://test.pypi.org/legacy/' || '' }}
+          skip-existing: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          token: ${{ steps.app_token.outputs.token }}
+          tag_name: ${{ steps.auto_tag.outputs.tag }}
+          files: dist/*
+          generate_release_notes: true

{node_walk-0.2.0 → node_walk-0.3.1}/CHANGELOG.md

@@ -11,6 +11,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.3.1] - 2026-08-25
+
+---
+
+## [0.3.0] - 2026-08-23
+
+---
+
 ## [0.2.0] - 2026-08-23
 ### Added
 - **`node-walk serve` command**: Launches an embedded local HTTP server (`localhost:7777` by default) and auto-opens the browser to the interactive graph explorer. Accepts `--port`, `--host`, and `--no-open` flags.

{node_walk-0.2.0 → node_walk-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: node-walk
-Version: 0.2.0
+Version: 0.3.1
 Summary: Semantic code intelligence — local-first graph of your codebase for humans and LLMs
 Author: CodeGraph Contributors
 License: MIT
@@ -163,6 +163,16 @@ pytest tests/ -v
 
 ---
 
+## Release Automation Setup
+
+The `Release & Publish` workflow can push release commits/tags to `main`.
+
+If your repository ruleset requires pull requests for `main`, create a `RELEASE_PUSH_TOKEN` secret with a PAT from a user/app that is explicitly allowed to bypass that ruleset, then add that actor to the ruleset bypass list.
+
+If `RELEASE_PUSH_TOKEN` is not set, the workflow falls back to `GITHUB_TOKEN`.
+
+---
+
 ## Graph Storage & Lifecycle
 
 The generated graph is stored in `.node_walk/graph.db` inside your indexed repository. It is disposable and can be re-indexed at any time with `node-walk index .`.

{node_walk-0.2.0 → node_walk-0.3.1}/README.md

@@ -139,6 +139,16 @@ pytest tests/ -v
 
 ---
 
+## Release Automation Setup
+
+The `Release & Publish` workflow can push release commits/tags to `main`.
+
+If your repository ruleset requires pull requests for `main`, create a `RELEASE_PUSH_TOKEN` secret with a PAT from a user/app that is explicitly allowed to bypass that ruleset, then add that actor to the ruleset bypass list.
+
+If `RELEASE_PUSH_TOKEN` is not set, the workflow falls back to `GITHUB_TOKEN`.
+
+---
+
 ## Graph Storage & Lifecycle
 
 The generated graph is stored in `.node_walk/graph.db` inside your indexed repository. It is disposable and can be re-indexed at any time with `node-walk index .`.