fix: resolve CLI validation, CI workflow, lint, and config issues

.changeset/clear-all-db-adapter.md

@@ -0,0 +1,5 @@
+---
+"zerithdb-db": patch
+---
+
+Add a `clearAll()` helper to remove every document from a collection.

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ concurrency:
 jobs:
   # ── 1. Lint & Format ────────────────────────────────────────────────────────
   lint-format:
-    name: Lint & Format
+    name: 🔍 Lint & Format
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -50,7 +50,7 @@ jobs:
 
   # ── 2. TypeScript type-check ────────────────────────────────────────────────
   typecheck:
-    name: TypeCheck
+    name: 🧠 TypeCheck
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -75,7 +75,7 @@ jobs:
 
   # ── 3. Build & Unit Tests ───────────────────────────────────────────────────
   build-and-test:
-    name: Build & Test
+    name: 🏗️ Build & Test
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -118,7 +118,7 @@ jobs:
 
   # ── 4. Python SDK ───────────────────────────────────────────────────────────
   python-sdk:
-    name: Python SDK (py${{ matrix.python }})
+    name: 🐍 Python SDK (py${{ matrix.python }})
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
@@ -153,7 +153,7 @@ jobs:
   # This is the single required status check to add in branch protection rules.
   # All jobs must pass for this to succeed.
   ci-success:
-    name: CI Passed
+    name: ✅ CI Passed
     needs: [lint-format, typecheck, build-and-test, python-sdk]
     runs-on: ubuntu-latest
     if: always()

.github/workflows/issue-assign.yml

@@ -0,0 +1,94 @@
+name: Issue Auto Assign
+
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+  assign:
+    name: Assign User
+    if: contains(github.event.comment.body, '/assign') || contains(github.event.comment.body, '/unassign')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - name: Process Assignment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const comment = context.payload.comment.body.trim().toLowerCase();
+            const issue_number = context.payload.issue.number;
+            const user = context.payload.comment.user.login;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            // Check if comment starts with /assign or /unassign
+            if (comment.startsWith('/assign')) {
+              const assignees = context.payload.issue.assignees.map(a => a.login);
+
+              if (assignees.length > 0) {
+                if (assignees.includes(user)) {
+                  await github.rest.issues.createComment({
+                    owner,
+                    repo,
+                    issue_number,
+                    body: `👋 Hi @${user}, you are already assigned to this issue!`
+                  });
+                } else {
+                  await github.rest.issues.createComment({
+                    owner,
+                    repo,
+                    issue_number,
+                    body: `⚠️ **Already Assigned**\n\nSorry @${user}, this issue is already assigned to @${assignees.join(', @')}. Please find another unassigned issue to contribute to! 🚀`
+                  });
+                }
+                return;
+              }
+
+              console.log(`Assigning @${user} to issue #${issue_number}`);
+              try {
+                await github.rest.issues.addAssignees({
+                  owner,
+                  repo,
+                  issue_number,
+                  assignees: [user]
+                });
+
+                const message = `### ✅ Issue Assigned!\n\nHi @${user}, you have been successfully assigned to this issue. We're excited to see your contribution! 🚀\n\nIf you have any questions, feel free to ask here or join our [Discord server](https://discord.gg/mwCayEMK4h). Happy coding!`;
+
+                await github.rest.issues.createComment({
+                  owner,
+                  repo,
+                  issue_number,
+                  body: message
+                });
+              } catch (error) {
+                console.error(error);
+                await github.rest.issues.createComment({
+                  owner,
+                  repo,
+                  issue_number,
+                  body: `❌ **Failed to assign @${user}.**\n\nError: ${error.message}`
+                });
+              }
+            } else if (comment.startsWith('/unassign')) {
+              console.log(`Unassigning @${user} from issue #${issue_number}`);
+              try {
+                await github.rest.issues.removeAssignees({
+                  owner,
+                  repo,
+                  issue_number,
+                  assignees: [user]
+                });
+
+                await github.rest.issues.createComment({
+                  owner,
+                  repo,
+                  issue_number,
+                  body: `👋 @${user} has been unassigned from this issue.`
+                });
+              } catch (error) {
+                console.error(error);
+              }
+            }

.github/workflows/pr-labeler.yml

@@ -0,0 +1,99 @@
+name: "PR Labeler"
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened, edited]
+
+permissions:
+  contents: read
+  issues: read
+  pull-requests: write
+
+jobs:
+  label:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Auto Label PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const body = context.payload.pull_request.body || "";
+            const prNumber = context.payload.pull_request.number;
+
+            // Regex to find linked issues (e.g., "Fixes #123", "Closes #456")
+            const issueRegex = /(?:close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved)\s+#(\d+)/gi;
+            const linkedIssueIds = new Set();
+            let match;
+            while ((match = issueRegex.exec(body)) !== null) {
+              linkedIssueIds.add(match[1]);
+            }
+
+            const labelsToAdd = new Set();
+            labelsToAdd.add('gssoc-26'); // Default label for this repo
+            labelsToAdd.add('status: needs-review'); // Mark as needing review
+
+            // 1. Inherit labels from linked issues
+            if (linkedIssueIds.size > 0) {
+              console.log(`Found linked issues: ${Array.from(linkedIssueIds).join(', ')}`);
+              for (const id of linkedIssueIds) {
+                try {
+                  const { data: issue } = await github.rest.issues.get({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    issue_number: parseInt(id),
+                  });
+                  if (issue.labels) {
+                    issue.labels.forEach(l => {
+                      const labelName = typeof l === 'string' ? l : l.name;
+                      labelsToAdd.add(labelName);
+                    });
+                  }
+                } catch (e) {
+                  console.log(`Error fetching issue #${id}: ${e.message}`);
+                }
+              }
+            }
+
+            // 2. Path-based labeling (as fallback or addition)
+            try {
+              const { data: files } = await github.rest.pulls.listFiles({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                pull_number: prNumber,
+              });
+
+              const filePaths = files.map(f => f.filename);
+
+              if (filePaths.some(p => p.startsWith('packages/db/'))) {
+                labelsToAdd.add('package:db');
+              }
+
+              if (filePaths.some(p => p.endsWith('.md') || p.startsWith('docs/'))) {
+                labelsToAdd.add('type:docs');
+              }
+
+              if (filePaths.some(p => p.toLowerCase().includes('test') || p.toLowerCase().includes('spec') || p.includes('__tests__'))) {
+                labelsToAdd.add('type:testing');
+              }
+
+              if (filePaths.some(p => p.startsWith('.github/') || p.includes('package.json') || p.includes('package-lock.json'))) {
+                labelsToAdd.add('type:chore');
+              }
+
+              if (filePaths.some(p => p.startsWith('infra/'))) {
+                labelsToAdd.add('type:devops');
+              }
+            } catch (e) {
+              console.log(`Error listing files: ${e.message}`);
+            }
+
+            // 3. Apply labels
+            if (labelsToAdd.size > 0) {
+              console.log(`Adding labels: ${Array.from(labelsToAdd).join(', ')}`);
+              await github.rest.issues.addLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: prNumber,
+                labels: Array.from(labelsToAdd),
+              });
+            }

.github/workflows/pr-welcome.yml

@@ -0,0 +1,27 @@
+name: PR Welcome Bot
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  welcome-comment:
+    name: Post Welcome Comment
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Welcome Comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const creator = context.payload.pull_request.user.login;
+            const message = "### Hello @" + creator + "!\n\nOur reviewers will be checking your PR shortly. In the meantime, please join our Discord server to connect with the team and other contributors:\n\n**Join Discord:** https://discord.gg/mwCayEMK4h";
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number,
+              body: message
+            });

CONTRIBUTING.md

@@ -35,8 +35,8 @@ constructive. Violations → `conduct@zerithdb.dev`
 ### Bootstrap
 
 ```bash
-git clone https://github.com/YOUR_USERNAME/zerithdb.git
-cd zerithdb
+git clone https://github.com/YOUR_USERNAME/ZerithDB.git
+cd ZerithDB
 git remote add upstream https://github.com/Zerith-Labs/ZerithDB.git
 pnpm install
 pnpm build
@@ -49,7 +49,7 @@ pnpm dev           # start all packages in watch mode
 ```bash
 pnpm --filter zerithdb-db dev
 pnpm --filter zerithdb-sync test
-pnpm --filter zerithdb-todo-app dev
+pnpm --filter zerithdb-sdk dev
 ```
 
 ---
@@ -62,7 +62,7 @@ pnpm --filter zerithdb-todo-app dev
   [`good-first-issue`](https://github.com/Zerith-Labs/ZerithDB/issues?q=label%3Agood-first-issue) or
   [`help-wanted`](https://github.com/Zerith-Labs/ZerithDB/issues?q=label%3Ahelp-wanted).
 - For features, open a Discussion before writing code.
-- Comment "I'll work on this" to claim an issue.
+- Comment `/assign` to automatically claim an issue. Use `/unassign` if you can no longer work on it.
 
 ### 2. Branch Naming