@automagik/genie 3.260303.2 → 3.260309.1

package/.claude-plugin/marketplace.json

@@ -1,16 +1,16 @@
 {
-  "name": "namastexlabs",
+  "name": "automagik",
   "owner": {
     "name": "Namastex Labs"
   },
   "metadata": {
     "description": "Plugins by Namastex Labs",
-    "homepage": "https://github.com/namastexlabs/genie-cli"
+    "homepage": "https://github.com/automagik-dev/genie"
   },
   "plugins": [
     {
       "name": "genie",
-      "version": "3.260303.2",
+      "version": "3.260309.1",
       "source": "./plugins/genie",
       "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, wish them into plans, make with parallel agents, ship as one team. A coding genie that grows with your project."
     }

package/.coderabbit.yaml

@@ -0,0 +1,29 @@
+language: en-US
+tone_instructions: "Be direct and concise. Focus on bugs, security, and correctness over style."
+
+reviews:
+  profile: assertive
+  high_level_summary: true
+  poem: false
+  auto_review:
+    enabled: true
+    auto_incremental_review: true
+    ignore_title_keywords:
+      - "WIP"
+      - "DO NOT MERGE"
+      - "wip"
+  path_filters:
+    - "!.wishes/**"
+    - "!.beads/**"
+    - "!memory/**"
+    - "!.claude/**"
+    - "!*.md"
+    - "!dist/**"
+    - "!plugins/genie/scripts/**"
+  path_instructions:
+    - path: "src/**"
+      instructions: "Core CLI source. Check for breaking changes to exported types."
+    - path: "plugins/**"
+      instructions: "Claude Code plugin. Verify plugin manifest updates are consistent."
+    - path: ".github/workflows/**"
+      instructions: "CI workflows. Check for hardcoded secrets, proper caching keys, and timeout settings."

package/.genie/wishes/resolve-dev-desync/WISH.md

@@ -0,0 +1,116 @@
+# Wish: Resolve Dev Branch Desync After Worker→Agent Rename
+
+| Field | Value |
+|-------|-------|
+| **Status** | SHIPPED |
+| **Slug** | `resolve-dev-desync` |
+| **Date** | 2026-03-06 |
+
+## Summary
+
+Local dev branch has 9 uncommitted files from cascading dead-code cleanup (biome warning elimination round 2). Meanwhile, origin/dev advanced 8 commits including a major `Worker→Agent` type rename and `worker-registry.ts→agent-registry.ts` file rename. Need to commit local changes, rebase onto origin/dev, resolve conflicts, re-apply dead-code removals to renamed files, and verify all quality gates pass.
+
+## Scope
+
+### IN
+
+- Commit local dead-code cleanup changes on dev branch
+- Rebase onto origin/dev (8 commits behind)
+- Resolve conflict in `src/lib/beads-registry.ts` (local: dead-code removal + private heartbeat; upstream: Worker→Agent type rename)
+- Re-apply `countByTask` export removal to `src/lib/agent-registry.ts` (was `worker-registry.ts`)
+- Verify all cascading dead-code removals still apply after upstream changes
+- Run and pass all quality gates: typecheck, lint (0 warnings), dead-code (knip), tests (489/489)
+
+### OUT
+
+- No new feature work — this is purely a merge/sync operation
+- No additional refactoring beyond what's needed for the merge
+- No changes to upstream code that isn't part of conflict resolution
+
+## Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| Commit local changes first, then rebase | Preserves our work as a distinct commit; cleaner than stash-pop |
+| Rebase (not merge) | Keeps linear history on dev branch |
+| Re-apply dead-code removals to renamed files | `worker-registry.ts` → `agent-registry.ts` means our `countByTask` export removal needs to target the new filename |
+
+## Success Criteria
+
+- [ ] Local dev branch is up-to-date with origin/dev
+- [ ] All 9 local file changes are preserved (dead-code removals)
+- [ ] `bun run check` exits 0 (typecheck + lint + dead-code + tests)
+- [ ] `bunx biome check . --max-diagnostics=300` shows 0 warnings, 0 errors
+- [ ] `bun test` passes 489/489 (or more, if upstream added tests)
+- [ ] `git status` shows clean working tree
+- [ ] Changes are pushed to origin/dev
+
+## Execution Groups
+
+### Group 1: Commit & Rebase
+
+**Goal:** Get local dead-code cleanup committed and rebased onto origin/dev.
+
+**Deliverables:**
+1. Commit all 9 local file changes with descriptive message
+2. `git pull --rebase origin dev`
+3. Resolve conflicts:
+   - `src/lib/beads-registry.ts`: Accept upstream Worker→Agent renames, keep local dead-code removals (delete `heartbeat` export, `listWorkers` function)
+   - `src/lib/worker-registry.ts` → `src/lib/agent-registry.ts`: Apply `countByTask` export→private change to new filename
+
+**Acceptance criteria:**
+- Rebase completes without unresolved conflicts
+- `git log --oneline` shows local commit on top of upstream commits
+
+**Validation:**
+```bash
+git status  # clean working tree
+git log --oneline -3  # local commit on top
+```
+
+### Group 2: Verify & Fix Cascading Issues
+
+**Goal:** Ensure all quality gates pass after rebase. Upstream changes may have introduced new dead code or broken our previous fixes.
+
+**Deliverables:**
+1. Run `bun run typecheck` — fix any type errors from merge
+2. Run `bunx biome check .` — fix any new warnings (upstream may have added code with warnings)
+3. Run `bun run dead-code` — fix any new dead exports
+4. Run `bun test` — all tests pass
+
+**Acceptance criteria:**
+- `bun run check` exits 0
+- 0 biome warnings
+- 0 knip findings
+
+**Validation:**
+```bash
+bun run check  # exits 0
+bunx biome check . --max-diagnostics=300 2>&1 | grep -E 'warning|error' || echo "Clean"
+```
+
+### Group 3: Push
+
+**Goal:** Push resolved branch to remote.
+
+**Deliverables:**
+1. `git push origin dev`
+2. Verify `git status` shows up-to-date with origin
+
+**Acceptance criteria:**
+- Push succeeds
+- Branch is up-to-date with origin/dev
+
+**Validation:**
+```bash
+git status  # "Your branch is up to date with 'origin/dev'"
+```
+
+## Assumptions / Risks
+
+| Risk | Mitigation |
+|------|------------|
+| Upstream may have re-introduced dead code we already cleaned | Group 2 re-runs knip and fixes new findings |
+| Worker→Agent rename may have broken imports we modified | Typecheck in Group 2 will catch this |
+| Upstream may have added new biome warnings | Group 2 re-runs biome and fixes |
+| Test count may have changed upstream | Accept whatever the new count is, as long as all pass |

package/.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  secrets-scan:
+    name: Secrets Scan (GitGuardian)
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 5
+    if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: GitGuardian/ggshield-action@v1
+        if: ${{ env.GITGUARDIAN_API_KEY != '' }}
+        env:
+          GITHUB_PUSH_BEFORE_SHA: ${{ github.event.before }}
+          GITHUB_PUSH_BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          GITHUB_DEFAULT_BRANCH: main
+          GITGUARDIAN_API_KEY: ${{ secrets.GITGUARDIAN_API_KEY }}
+
+  quality-gate:
+    name: Quality Gate (typecheck + lint + test)
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Cache bun packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.bun/install/cache
+          key: bun-${{ runner.os }}-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            bun-${{ runner.os }}-
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build
+        run: bun run build
+
+      - name: Typecheck
+        run: bun run typecheck
+
+      - name: Lint
+        run: bunx biome check .
+
+      - name: Dead code check (knip)
+        run: bunx knip
+
+      - name: Test
+        run: bun test

package/.github/workflows/commitlint.yml

@@ -0,0 +1,25 @@
+name: Commitlint
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+concurrency:
+  group: commitlint-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  commitlint:
+    name: Commit Messages
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: wagoid/commitlint-github-action@v6
+        with:
+          configFile: commitlint.config.ts

package/.github/workflows/release.yml

@@ -0,0 +1,111 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create Release
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Read version from package.json
+        id: pkg
+        run: |
+          VERSION=$(jq -r '.version' package.json)
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "Version from package.json: ${VERSION}"
+
+      - name: Check if release already exists
+        id: exists
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="v${{ steps.pkg.outputs.version }}"
+
+          if gh release view "${TAG}" > /dev/null 2>&1; then
+            echo "Release ${TAG} already exists — skipping."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "skip=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Find previous release tag
+        id: prev
+        if: steps.exists.outputs.skip != 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="v${{ steps.pkg.outputs.version }}"
+          PREV=$(gh release list --limit 50 --json tagName -q '.[].tagName' | grep -v "^${TAG}$" | head -1)
+          # Verify the tag is reachable from HEAD (same history line)
+          if [ -n "$PREV" ] && git merge-base --is-ancestor "$PREV" HEAD 2>/dev/null; then
+            echo "tag=${PREV}" >> "$GITHUB_OUTPUT"
+            echo "Previous release tag: ${PREV}"
+          else
+            echo "tag=" >> "$GITHUB_OUTPUT"
+            echo "Previous release tag not reachable from HEAD — treating as initial release"
+          fi
+
+      - name: Generate changelog
+        uses: orhun/git-cliff-action@v4
+        id: cliff
+        if: steps.exists.outputs.skip != 'true' && steps.prev.outputs.tag != ''
+        with:
+          config: cliff.toml
+          args: ${{ format('{0}..HEAD', steps.prev.outputs.tag) }}
+        env:
+          GITHUB_REPO: ${{ github.repository }}
+
+      - name: Create release
+        if: steps.exists.outputs.skip != 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_NOTES: ${{ steps.cliff.outputs.content }}
+        run: |
+          TAG="v${{ steps.pkg.outputs.version }}"
+          if [ -z "$RELEASE_NOTES" ]; then
+            RELEASE_NOTES="Initial release of genie v3 CLI."
+          fi
+          printf '%s' "$RELEASE_NOTES" > /tmp/release-notes.md
+          gh release create "${TAG}" \
+            --target "${{ github.sha }}" \
+            --title "${TAG}" \
+            --notes-file /tmp/release-notes.md
+
+      - name: Setup Bun
+        if: steps.exists.outputs.skip != 'true'
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        if: steps.exists.outputs.skip != 'true'
+        run: bun install --frozen-lockfile
+
+      - name: Build CLI
+        if: steps.exists.outputs.skip != 'true'
+        run: bun run build
+
+      - name: Publish to npm
+        if: steps.exists.outputs.skip != 'true'
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_CONFIG_TOKEN: ${{ secrets.NPM_TOKEN }}
+          HUSKY: "0"
+        run: |
+          if [ -z "$NPM_TOKEN" ]; then
+            echo "ERROR: NPM_TOKEN secret is not set. Cannot publish to npm." >&2
+            exit 1
+          fi
+          bun publish --access public

package/.github/workflows/rolling-pr.yml

@@ -0,0 +1,52 @@
+name: Rolling PR Maintenance
+
+on:
+  schedule:
+    - cron: '0 * * * *'
+  workflow_dispatch:
+
+concurrency:
+  group: rolling-pr
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  maintain:
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 5
+    steps:
+      - name: Check/Create Rolling PR
+        env:
+          # GITHUB_TOKEN cannot create PRs (org restriction).
+          # Use a PAT with contents:read + pull-requests:write scopes.
+          GH_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+        run: |
+          # Check if open PR exists (dev -> main)
+          PR=$(gh pr list --repo ${{ github.repository }} --base main --head dev --state open --json number --jq '.[0].number')
+
+          if [ -z "$PR" ]; then
+            # Create new rolling PR
+            gh pr create --repo ${{ github.repository }} \
+              --base main --head dev \
+              --title "chore: rolling promotion dev -> main" \
+              --body "$(cat <<'BODY'
+          ## Rolling Promotion PR
+
+          Auto-maintained rolling promotion PR from `dev` to `main`.
+
+          **Process:**
+          - This PR is automatically created and kept open
+          - Agent monitors CI status and fixes issues
+          - Human reviews and merges when ready
+          - Label `ready-to-merge` added when all checks pass
+
+          > Human approval required for merge to production.
+          BODY
+          )"
+            echo "Created new rolling PR"
+          else
+            echo "Rolling PR #$PR exists and is up to date"
+          fi

package/.github/workflows/version.yml

@@ -0,0 +1,83 @@
+name: Version
+
+on:
+  workflow_run:
+    workflows: ["CI"]
+    types: [completed]
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  # This workflow always writes to `dev`, regardless of the trigger ref.
+  group: version-dev
+  cancel-in-progress: false
+
+jobs:
+  auto-version:
+    name: Auto Version
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    timeout-minutes: 5
+    if: >-
+      (github.event_name == 'workflow_dispatch') ||
+      (github.event.workflow_run.conclusion == 'success' &&
+       github.event.workflow_run.event == 'push' &&
+       github.event.workflow_run.head_branch == 'main' &&
+       startsWith(github.event.workflow_run.head_commit.message, 'Merge pull request') &&
+       contains(github.event.workflow_run.head_commit.message, '/dev') &&
+       !contains(github.event.workflow_run.head_commit.message, '[skip ci]'))
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: dev
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Derive version
+        id: version
+        run: |
+          TODAY=$(date -u +%y%m%d)
+          EXISTING=$(git tag --list "v3.${TODAY}.*" | wc -l)
+          BUILD_NUMBER=$((EXISTING + 1))
+          VERSION="3.${TODAY}.${BUILD_NUMBER}"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "build_number=${BUILD_NUMBER}" >> "$GITHUB_OUTPUT"
+          echo "Derived version: ${VERSION}"
+
+      - name: Sync all version files
+        run: bun run version
+        env:
+          GENIE_BUILD_NUMBER: ${{ steps.version.outputs.build_number }}
+
+      - name: Format versioned JSON (Biome)
+        run: |
+          bunx biome format --write package.json openclaw.plugin.json plugins/genie/.claude-plugin/plugin.json plugins/genie/package.json .claude-plugin/marketplace.json 2>/dev/null || true
+
+      - name: Commit and tag
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+
+          git add -A '*.json' 'src/lib/version.ts'
+          if git diff --cached --quiet; then
+            echo "No version changes to commit"
+          else
+            git commit -m "chore(version): bump to ${VERSION} [skip ci]"
+          fi
+
+          git tag "v${VERSION}"
+          git push --atomic origin HEAD:refs/heads/dev "refs/tags/v${VERSION}"

package/.husky/commit-msg

@@ -0,0 +1 @@
+bunx commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1 @@
+bunx biome check --staged --no-errors-on-unmatched

package/.husky/pre-push

@@ -0,0 +1,13 @@
+set -e
+
+remote="$1"
+while read local_ref local_oid remote_ref remote_oid; do
+  if echo "$remote_ref" | grep -qE 'refs/heads/(main|master)$'; then
+    echo "BLOCKED: push to $remote_ref is forbidden."
+    echo "Main is production — human merges the rolling PR."
+    exit 1
+  fi
+done
+
+bun run typecheck
+bun test

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Automagik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Makefile

@@ -0,0 +1,24 @@
+.PHONY: build lint lint-fix format typecheck test check clean
+
+build:
+	bun run build
+
+lint:
+	bunx biome check .
+
+lint-fix:
+	bunx biome check --write .
+
+format:
+	bunx biome format --write .
+
+typecheck:
+	bun run typecheck
+
+test:
+	bun test
+
+check: lint typecheck test
+
+clean:
+	rm -rf dist node_modules