dirsql 0.0.13__tar.gz → 0.0.15__tar.gz

{dirsql-0.0.13 → dirsql-0.0.15}/.claude/CLAUDE.md

@@ -10,6 +10,7 @@ Write scratch/temporary files to `/tmp` instead of asking permission. Use unique
 - **NEVER commit directly to main** - always create a PR
 - One PR per bead. Beads should be concise and small -- as small as possible while still being useful
 - Use `bd` (Beads) for task tracking: `bd list`, `bd show <id>`, `bd ready`
+- **Bead first**: When starting new work, the first step is always to create a bead (`bd create`). No implementation work begins without a bead.
 
 ### Git Worktrees
 
@@ -47,14 +48,15 @@ git worktree remove .worktrees/my-feature
 ### Subagent Workflow
 
 New work on beads should be done via subagents in isolated worktrees. Each subagent:
-1. Creates a worktree and branch for its bead
-2. Does the implementation work (red/green TDD)
-3. Pushes the branch and opens a PR
-4. Monitors the PR and proactively resolves:
+1. Claims the bead (`bd update <id> --claim`) before starting any work
+2. Creates a worktree and branch for its bead
+3. Does the implementation work (red/green TDD)
+4. Pushes the branch and opens a PR
+5. Monitors the PR and proactively resolves:
    - CI failures
    - GPG signing complaints
    - Merge conflicts
-5. Continues monitoring until the PR is in a mergeable state
+6. Continues monitoring until the PR is in a mergeable state
 
 ### Orchestrator Responsibilities
 
@@ -64,6 +66,7 @@ The orchestrator (main Claude session) must proactively:
 3. **Handle post-merge cleanup** as soon as a PR merges (pull main, remove worktree, delete branch, close bead).
 4. **Keep the user informed** of PR status without being asked.
 5. **Use foreground monitoring** when waiting on CI and there's no other work to do. Background monitoring causes the conversation to go silent -- use it only when there's genuinely parallel work to perform.
+6. **Scripts to `/tmp`**: For polling/monitoring scripts (watching CI, waiting for merges), write the script to `/tmp` then run it via `bash /tmp/script.sh`. Do not use inline bash loops in tool calls.
 
 ### Post-Merge Cleanup
 

dirsql-0.0.15/.github/workflows/minor-release.yml

@@ -0,0 +1,117 @@
+name: Minor Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  detect-changes:
+    runs-on: ubuntu-latest
+    outputs:
+      rust_changed: ${{ steps.changes.outputs.rust_changed }}
+      python_changed: ${{ steps.changes.outputs.python_changed }}
+      js_changed: ${{ steps.changes.outputs.js_changed }}
+      docs_changed: ${{ steps.changes.outputs.docs_changed }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Detect changed file types since last tag
+        id: changes
+        run: |
+          latest_tag=$(git tag --sort=-v:refname | grep -E '^v[0-9]' | head -n1)
+
+          if [ -z "$latest_tag" ]; then
+            # No tags yet -- treat everything as changed
+            echo "rust_changed=true" >> "$GITHUB_OUTPUT"
+            echo "python_changed=true" >> "$GITHUB_OUTPUT"
+            echo "js_changed=true" >> "$GITHUB_OUTPUT"
+            echo "docs_changed=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          changed_files=$(git diff --name-only "${latest_tag}..HEAD")
+
+          if [ -z "$changed_files" ]; then
+            echo "rust_changed=false" >> "$GITHUB_OUTPUT"
+            echo "python_changed=false" >> "$GITHUB_OUTPUT"
+            echo "js_changed=false" >> "$GITHUB_OUTPUT"
+            echo "docs_changed=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          rust_changed=false
+          python_changed=false
+          js_changed=false
+          docs_changed=false
+
+          while IFS= read -r file; do
+            case "$file" in
+              *.rs|Cargo.toml|Cargo.lock) rust_changed=true ;;
+              *.py|pyproject.toml|uv.lock) python_changed=true ;;
+              package.json|*.ts|*.js) js_changed=true ;;
+              README.md|*.md) docs_changed=true ;;
+            esac
+          done <<< "$changed_files"
+
+          echo "rust_changed=$rust_changed" >> "$GITHUB_OUTPUT"
+          echo "python_changed=$python_changed" >> "$GITHUB_OUTPUT"
+          echo "js_changed=$js_changed" >> "$GITHUB_OUTPUT"
+          echo "docs_changed=$docs_changed" >> "$GITHUB_OUTPUT"
+
+          echo "Rust: $rust_changed, Python: $python_changed, JS: $js_changed, Docs: $docs_changed"
+
+  release:
+    needs: detect-changes
+    uses: ./.github/workflows/publish.yml
+    with:
+      bump_type: minor
+      publish_pypi: ${{ needs.detect-changes.outputs.rust_changed == 'true' || needs.detect-changes.outputs.python_changed == 'true' || needs.detect-changes.outputs.docs_changed == 'true' }}
+      publish_crates: ${{ needs.detect-changes.outputs.rust_changed == 'true' || needs.detect-changes.outputs.docs_changed == 'true' }}
+    secrets: inherit
+    permissions:
+      contents: write
+      id-token: write
+
+  # npm publish inlined here because npm OIDC doesn't support reusable workflows
+  publish-npm:
+    needs: [detect-changes, release]
+    if: >-
+      always() &&
+      needs.release.outputs.tag_created == 'true' &&
+      (needs.detect-changes.outputs.rust_changed == 'true' ||
+       needs.detect-changes.outputs.js_changed == 'true' ||
+       needs.detect-changes.outputs.docs_changed == 'true')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check if package.json exists
+        id: check_npm
+        run: |
+          if [ -f package.json ]; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Setup Node.js
+        if: steps.check_npm.outputs.exists == 'true'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+
+      - name: Update package.json version
+        if: steps.check_npm.outputs.exists == 'true'
+        run: npm version "${{ needs.release.outputs.new_version }}" --no-git-tag-version
+
+      - name: Publish to npm
+        if: steps.check_npm.outputs.exists == 'true'
+        run: npm publish --provenance --access public

dirsql-0.0.15/.github/workflows/patch-release.yml

@@ -0,0 +1,155 @@
+name: Patch Release
+
+on:
+  schedule:
+    # Run at 2:00 AM UTC every day
+    - cron: '0 2 * * *'
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    outputs:
+      should_release: ${{ steps.decide.outputs.should_release }}
+    steps:
+      - id: decide
+        env:
+          EVENT: ${{ github.event_name }}
+          STRATEGY: ${{ vars.RELEASE_STRATEGY }}
+          COMMIT_MSG: ${{ github.event.head_commit.message }}
+        run: |
+          if [ "$EVENT" = "workflow_dispatch" ]; then
+            echo "should_release=true" >> "$GITHUB_OUTPUT"
+          elif [ "$EVENT" = "schedule" ] && [ "$STRATEGY" != "immediate" ]; then
+            echo "should_release=true" >> "$GITHUB_OUTPUT"
+          elif [ "$EVENT" = "push" ] && [ "$STRATEGY" = "immediate" ]; then
+            case "$COMMIT_MSG" in
+              *'[no-release]'*) echo "should_release=false" >> "$GITHUB_OUTPUT" ;;
+              *) echo "should_release=true" >> "$GITHUB_OUTPUT" ;;
+            esac
+          else
+            echo "should_release=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  detect-changes:
+    needs: check
+    if: needs.check.outputs.should_release == 'true'
+    runs-on: ubuntu-latest
+    outputs:
+      rust_changed: ${{ steps.changes.outputs.rust_changed }}
+      python_changed: ${{ steps.changes.outputs.python_changed }}
+      js_changed: ${{ steps.changes.outputs.js_changed }}
+      docs_changed: ${{ steps.changes.outputs.docs_changed }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Detect changed file types since last tag
+        id: changes
+        run: |
+          latest_tag=$(git tag --sort=-v:refname | grep -E '^v[0-9]' | head -n1)
+
+          if [ -z "$latest_tag" ]; then
+            # No tags yet -- treat everything as changed
+            echo "rust_changed=true" >> "$GITHUB_OUTPUT"
+            echo "python_changed=true" >> "$GITHUB_OUTPUT"
+            echo "js_changed=true" >> "$GITHUB_OUTPUT"
+            echo "docs_changed=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          changed_files=$(git diff --name-only "${latest_tag}..HEAD")
+
+          if [ -z "$changed_files" ]; then
+            echo "rust_changed=false" >> "$GITHUB_OUTPUT"
+            echo "python_changed=false" >> "$GITHUB_OUTPUT"
+            echo "js_changed=false" >> "$GITHUB_OUTPUT"
+            echo "docs_changed=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          rust_changed=false
+          python_changed=false
+          js_changed=false
+          docs_changed=false
+
+          while IFS= read -r file; do
+            case "$file" in
+              *.rs|Cargo.toml|Cargo.lock) rust_changed=true ;;
+              *.py|pyproject.toml|uv.lock) python_changed=true ;;
+              package.json|*.ts|*.js) js_changed=true ;;
+              README.md|*.md) docs_changed=true ;;
+            esac
+          done <<< "$changed_files"
+
+          echo "rust_changed=$rust_changed" >> "$GITHUB_OUTPUT"
+          echo "python_changed=$python_changed" >> "$GITHUB_OUTPUT"
+          echo "js_changed=$js_changed" >> "$GITHUB_OUTPUT"
+          echo "docs_changed=$docs_changed" >> "$GITHUB_OUTPUT"
+
+          echo "Rust: $rust_changed, Python: $python_changed, JS: $js_changed, Docs: $docs_changed"
+
+  release:
+    needs: [check, detect-changes]
+    if: >-
+      needs.check.outputs.should_release == 'true' &&
+      (needs.detect-changes.outputs.rust_changed == 'true' ||
+       needs.detect-changes.outputs.python_changed == 'true' ||
+       needs.detect-changes.outputs.docs_changed == 'true')
+    uses: ./.github/workflows/publish.yml
+    with:
+      bump_type: patch
+      publish_pypi: ${{ needs.detect-changes.outputs.rust_changed == 'true' || needs.detect-changes.outputs.python_changed == 'true' || needs.detect-changes.outputs.docs_changed == 'true' }}
+      publish_crates: ${{ needs.detect-changes.outputs.rust_changed == 'true' || needs.detect-changes.outputs.docs_changed == 'true' }}
+    secrets: inherit
+    permissions:
+      contents: write
+      id-token: write
+
+  # npm publish inlined here because npm OIDC doesn't support reusable workflows
+  # (it validates the caller workflow name, not the called workflow)
+  publish-npm:
+    needs: [check, detect-changes, release]
+    if: >-
+      always() &&
+      needs.check.outputs.should_release == 'true' &&
+      needs.release.outputs.tag_created == 'true' &&
+      (needs.detect-changes.outputs.rust_changed == 'true' ||
+       needs.detect-changes.outputs.js_changed == 'true' ||
+       needs.detect-changes.outputs.docs_changed == 'true')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check if package.json exists
+        id: check_npm
+        run: |
+          if [ -f package.json ]; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Setup Node.js
+        if: steps.check_npm.outputs.exists == 'true'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+
+      - name: Update package.json version
+        if: steps.check_npm.outputs.exists == 'true'
+        run: npm version "${{ needs.release.outputs.new_version }}" --no-git-tag-version
+
+      - name: Publish to npm
+        if: steps.check_npm.outputs.exists == 'true'
+        run: npm publish --provenance --access public

{dirsql-0.0.13 → dirsql-0.0.15}/.github/workflows/publish.yml

@@ -7,6 +7,16 @@ on:
         description: 'Version bump type: patch or minor'
         required: true
         type: string
+      publish_pypi:
+        description: 'Whether to publish to PyPI'
+        required: false
+        type: boolean
+        default: true
+      publish_crates:
+        description: 'Whether to publish to crates.io'
+        required: false
+        type: boolean
+        default: true
     outputs:
       tag_created:
         description: 'Whether a tag was created'
@@ -127,7 +137,7 @@ jobs:
 
   build:
     needs: [check-python, tag]
-    if: needs.check-python.outputs.has_python == 'true' && needs.tag.outputs.created == 'true'
+    if: needs.check-python.outputs.has_python == 'true' && needs.tag.outputs.created == 'true' && inputs.publish_pypi
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -164,7 +174,7 @@ jobs:
 
   sdist:
     needs: [check-python, tag]
-    if: needs.check-python.outputs.has_python == 'true' && needs.tag.outputs.created == 'true'
+    if: needs.check-python.outputs.has_python == 'true' && needs.tag.outputs.created == 'true' && inputs.publish_pypi
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -187,7 +197,7 @@ jobs:
 
   publish-pypi:
     needs: [tag, build, sdist]
-    if: always() && needs.tag.outputs.created == 'true' && needs.sdist.result == 'success'
+    if: always() && needs.tag.outputs.created == 'true' && needs.sdist.result == 'success' && inputs.publish_pypi
     runs-on: ubuntu-latest
     permissions:
       id-token: write
@@ -211,7 +221,7 @@ jobs:
 
   publish-crates:
     needs: tag
-    if: needs.tag.outputs.created == 'true'
+    if: needs.tag.outputs.created == 'true' && inputs.publish_crates
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -269,8 +279,8 @@ jobs:
     if: |
       always() &&
       needs.tag.outputs.created == 'true' &&
-      needs.publish-pypi.result != 'success' &&
-      needs.publish-crates.result != 'success'
+      (needs.publish-pypi.result == 'failure' ||
+       needs.publish-crates.result == 'failure')
     runs-on: ubuntu-latest
     permissions:
       contents: write

{dirsql-0.0.13 → dirsql-0.0.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dirsql
-Version: 0.0.13
+Version: 0.0.15
 Requires-Dist: pytest>=8 ; extra == 'dev'
 Requires-Dist: pytest-describe>=2 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23 ; extra == 'dev'

{dirsql-0.0.13 → dirsql-0.0.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "dirsql"
-version = "0.0.13"
+version = "0.0.15"
 description = "Ephemeral SQL index over a local directory"
 license = "MIT"
 requires-python = ">=3.12"
@@ -36,3 +36,5 @@ exclude = [
     "AGENTS.md",
     "justfile",
 ]
+python-source = "python"
+module-name = "dirsql._dirsql"

dirsql-0.0.15/python/dirsql/__init__.py

@@ -0,0 +1,6 @@
+"""dirsql - Ephemeral SQL index over a local directory."""
+
+from dirsql._dirsql import DirSQL, Table, RowEvent, __version__
+from dirsql._async import AsyncDirSQL
+
+__all__ = ["DirSQL", "Table", "RowEvent", "AsyncDirSQL", "__version__"]

dirsql-0.0.15/python/dirsql/_async.py

@@ -0,0 +1,63 @@
+"""Async wrapper for DirSQL."""
+
+import asyncio
+
+from dirsql._dirsql import DirSQL
+
+
+class _WatchStream:
+    """Async iterator that polls for file events."""
+
+    def __init__(self, db):
+        self._db = db
+        self._started = False
+        self._buffer = []
+
+    def __aiter__(self):
+        return self
+
+    async def __anext__(self):
+        if not self._started:
+            await asyncio.to_thread(self._db._start_watcher)
+            self._started = True
+
+        while True:
+            if self._buffer:
+                return self._buffer.pop(0)
+            events = await asyncio.to_thread(self._db._poll_events, 200)
+            if events:
+                self._buffer.extend(events)
+
+
+class AsyncDirSQL:
+    """Async wrapper around DirSQL.
+
+    Usage:
+        db = await AsyncDirSQL(root, tables=[...])
+        results = await db.query("SELECT ...")
+        async for event in db.watch():
+            ...
+    """
+
+    def __init__(self, root, *, tables, ignore=None):
+        self._root = root
+        self._tables = tables
+        self._ignore = ignore
+        self._db = None
+
+    def __await__(self):
+        return self._init().__await__()
+
+    async def _init(self):
+        self._db = await asyncio.to_thread(
+            DirSQL, self._root, tables=self._tables, ignore=self._ignore
+        )
+        return self
+
+    async def query(self, sql):
+        """Execute a SQL query asynchronously."""
+        return await asyncio.to_thread(self._db.query, sql)
+
+    def watch(self):
+        """Start watching for file changes. Returns an async iterable of RowEvent."""
+        return _WatchStream(self._db)