bark-agent-hook 0.1.1__tar.gz

bark_agent_hook-0.1.1/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "bark-agent-hook",
+  "interface": {
+    "displayName": "bark-agent-hook"
+  },
+  "plugins": [
+    {
+      "name": "bark-agent-hook-codex",
+      "source": {
+        "source": "local",
+        "path": "./plugins/bark-agent-hook-codex"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

bark_agent_hook-0.1.1/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "bark-agent-hook",
+  "description": "Claude Code plugins for Bark agent hook workflows.",
+  "owner": {
+    "name": "qsoyq"
+  },
+  "plugins": [
+    {
+      "name": "bark-agent-hook",
+      "description": "Send Bark notifications from Claude Code lifecycle hooks through bark-agent-hook.",
+      "author": {
+        "name": "qsoyq"
+      },
+      "category": "productivity",
+      "source": "./plugins/bark-agent-hook-claude",
+      "homepage": "https://github.com/qsoyq/bark-agent-hook"
+    }
+  ]
+}

bark_agent_hook-0.1.1/.env.example

@@ -0,0 +1,15 @@
+# Copy this file to .env for local development.
+# Do not put real secrets in committed files.
+
+BARK_DEVICE_KEY=
+BARK_SERVER=https://api.day.app
+BARK_GROUP=
+AGENT_BARK_NOTIFY_GROUP_MODE=agent
+AGENT_BARK_NOTIFY_HOOK_URL=
+AGENT_BARK_NOTIFY_TITLE_TEMPLATE=
+AGENT_BARK_NOTIFY_AUDIT_LOG=
+AGENT_BARK_NOTIFY_AUDIT_LOG_FILE=
+LODY_ELECTRON_BOOTSTRAP=
+LODY_ELECTRON_SESSION_USER_ID=
+LODY_SESSION_ID=
+LODY_WORKSPACE_SESSION_ID=

bark_agent_hook-0.1.1/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

bark_agent_hook-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,43 @@
+name: Bug Report
+description: Report a reproducible defect.
+title: "fix: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: background
+    attributes:
+      label: Background
+      description: What happened and why does it matter?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Reproduction Steps
+      description: Provide the smallest reproducible command or workflow.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+    validations:
+      required: true
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation
+      description: How should the fix be verified?
+    validations:
+      required: true
+  - type: textarea
+    id: risk
+    attributes:
+      label: Risk
+      description: Note security, compatibility, or release risks.

bark_agent_hook-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,51 @@
+name: Feature Request
+description: Propose a user-facing capability.
+title: "feat: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: background
+    attributes:
+      label: Background
+      description: What problem should this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+      description: What outcome should be true when this is complete?
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: Scope
+      description: What is included?
+    validations:
+      required: true
+  - type: textarea
+    id: non_scope
+    attributes:
+      label: Non-goals
+      description: What is intentionally excluded?
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance Criteria
+      description: Use checkboxes for observable acceptance criteria.
+      value: "- [ ] "
+    validations:
+      required: true
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation
+      description: Commands, manual checks, or evidence expected.
+    validations:
+      required: true
+  - type: textarea
+    id: risk
+    attributes:
+      label: Risk
+      description: Compatibility, security, rollout, or rollback concerns.

bark_agent_hook-0.1.1/.github/ISSUE_TEMPLATE/tech_task.yml

@@ -0,0 +1,53 @@
+name: Tech Task
+description: Track maintenance, governance, refactor, or infrastructure work.
+title: "chore: "
+labels: ["maintenance"]
+body:
+  - type: dropdown
+    id: type
+    attributes:
+      label: Type
+      options:
+        - Tech Task
+        - Refactor
+        - Research
+        - QA Task
+        - Release Task
+        - Incident
+    validations:
+      required: true
+  - type: textarea
+    id: background
+    attributes:
+      label: Background
+    validations:
+      required: true
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: Scope
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance Criteria
+      value: "- [ ] "
+    validations:
+      required: true
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation
+    validations:
+      required: true
+  - type: textarea
+    id: risk
+    attributes:
+      label: Risk

bark_agent_hook-0.1.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,43 @@
+## Summary
+
+-
+
+## Related Issue
+
+Closes #
+
+## Change Type
+
+- [ ] Feature
+- [ ] Bug fix
+- [ ] Refactor
+- [ ] Docs
+- [ ] CI / governance
+- [ ] Test
+
+## Impact
+
+-
+
+## Validation
+
+- [ ] `uv run pre-commit run --all-files`
+- [ ] `uv run pytest -q`
+- [ ] Manual verification:
+
+## Risk And Rollback
+
+-
+
+Rollback:
+
+-
+
+## AI Assistance
+
+- [ ] AI assistance was used and the changes were reviewed by a human.
+- [ ] AI assistance was not used.
+
+## Reviewer Focus
+
+-

bark_agent_hook-0.1.1/.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5

bark_agent_hook-0.1.1/.github/settings.yml

@@ -0,0 +1,26 @@
+repository:
+  has_issues: true
+  has_projects: true
+  has_wiki: false
+  default_branch: main
+
+branches:
+  - name: main
+    protection:
+      required_pull_request_reviews:
+        required_approving_review_count: 1
+        dismiss_stale_reviews: true
+        require_code_owner_reviews: true
+        require_last_push_approval: true
+      required_status_checks:
+        strict: true
+        contexts:
+          - "test (3.10)"
+          - "test (3.11)"
+          - "test (3.12)"
+          - "test (3.13)"
+          - "test (3.14)"
+          - "lint"
+      enforce_admins: false
+      required_conversation_resolution: true
+      restrictions: null

bark_agent_hook-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,113 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dev group
+        run: uv sync --group dev --no-install-project
+
+      - name: Run tox
+        run: uv run tox -e ${{ matrix.python-version }}
+
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install dev group
+        run: uv sync --group dev --no-install-project
+
+      - name: Check plugin versions
+        run: uv run python scripts/check_versions.py
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files
+
+  release:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    needs: [test, lint]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Install release dependencies
+        run: uv sync --group dev --no-install-project
+
+      - name: Resolve project version
+        id: version
+        run: |
+          VERSION=$(uv run python - <<'PY'
+          from pathlib import Path
+          import tomllib
+
+          doc = tomllib.loads(Path("pyproject.toml").read_text(encoding="utf-8"))
+          project = doc.get("project", {})
+          if not isinstance(project, dict) or not isinstance(project.get("version"), str):
+              raise SystemExit("project.version is missing from pyproject.toml")
+          print(project["version"])
+          PY
+          )
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check release
+        id: release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if gh release view "${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+            echo "Release ${{ steps.version.outputs.version }} already exists; skipping."
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create release
+        if: steps.release.outputs.exists == 'false'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${{ steps.version.outputs.version }}" \
+            --target "$GITHUB_SHA" \
+            --generate-notes \
+            --title "${{ steps.version.outputs.version }}"

bark_agent_hook-0.1.1/.github/workflows/release-pypi.yml

@@ -0,0 +1,136 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  checks: read
+
+jobs:
+  gate:
+    if: github.event.release.prerelease == false
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    outputs:
+      release-sha: ${{ steps.release-target.outputs.sha }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.release.tag_name }}
+
+      - name: Resolve release target
+        id: release-target
+        run: |
+          sha="$(git rev-parse HEAD^{commit})"
+          echo "sha=$sha" >> "$GITHUB_OUTPUT"
+          echo "Release target commit: $sha"
+
+      - name: Verify required CI checks
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          RELEASE_SHA: ${{ steps.release-target.outputs.sha }}
+        run: |
+          set -euo pipefail
+
+          required_checks=(
+            "test (3.10)"
+            "test (3.11)"
+            "test (3.12)"
+            "test (3.13)"
+            "test (3.14)"
+            "lint"
+          )
+
+          for attempt in {1..30}; do
+            response="$(gh api \
+              -H "Accept: application/vnd.github+json" \
+              -H "X-GitHub-Api-Version: 2022-11-28" \
+              "/repos/${GITHUB_REPOSITORY}/commits/${RELEASE_SHA}/check-runs?per_page=100")"
+
+            pending=()
+            failed=()
+            missing=()
+
+            for check in "${required_checks[@]}"; do
+              match="$(jq -r --arg name "$check" '
+                .check_runs
+                | map(select(.name == $name))
+                | sort_by(.started_at // .created_at)
+                | last
+                | if . == null then empty else [.status, (.conclusion // "")] | @tsv end
+              ' <<<"$response")"
+
+              if [[ -z "$match" ]]; then
+                missing+=("$check")
+                continue
+              fi
+
+              status="${match%%$'\t'*}"
+              conclusion="${match#*$'\t'}"
+
+              if [[ "$status" != "completed" ]]; then
+                pending+=("$check: $status")
+              elif [[ "$conclusion" != "success" ]]; then
+                failed+=("$check: $conclusion")
+              fi
+            done
+
+            if (( ${#failed[@]} > 0 )); then
+              printf 'Required CI checks failed:\n'
+              printf -- '- %s\n' "${failed[@]}"
+              exit 1
+            fi
+
+            if (( ${#missing[@]} == 0 && ${#pending[@]} == 0 )); then
+              echo "All required CI checks passed."
+              exit 0
+            fi
+
+            if (( attempt == 30 )); then
+              if (( ${#missing[@]} > 0 )); then
+                printf 'Required CI checks were missing:\n'
+                printf -- '- %s\n' "${missing[@]}"
+              fi
+              if (( ${#pending[@]} > 0 )); then
+                printf 'Required CI checks were still pending:\n'
+                printf -- '- %s\n' "${pending[@]}"
+              fi
+              exit 1
+            fi
+
+            echo "Required CI checks are not ready yet; retrying in 20 seconds."
+            sleep 20
+          done
+
+  publish:
+    if: github.event.release.prerelease == false
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    needs: [gate]
+    permissions:
+      contents: read
+      id-token: write
+    concurrency:
+      group: release-pypi
+      cancel-in-progress: false
+    environment:
+      name: pypi
+      url: https://pypi.org/p/bark-agent-hook
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ needs.gate.outputs.release-sha }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish package
+        run: uv publish --trusted-publishing always

bark_agent_hook-0.1.1/.gitignore

@@ -0,0 +1,13 @@
+.DS_Store
+.env
+.venv/
+.tox/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/
+node_modules/

bark_agent_hook-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,66 @@
+repos:
+    - repo: local
+      hooks:
+          - id: sync-plugin-versions
+            name: sync plugin versions
+            entry: uv run python scripts/sync_versions.py
+            language: system
+            always_run: true
+            pass_filenames: false
+
+    - repo: https://github.com/pre-commit/pre-commit-hooks
+      rev: v6.0.0
+      hooks:
+          - id: check-yaml
+          - id: check-toml
+          - id: check-json
+          - id: check-case-conflict
+          - id: check-docstring-first
+          - id: check-added-large-files
+          - id: check-executables-have-shebangs
+          - id: debug-statements
+          - id: end-of-file-fixer
+          - id: trailing-whitespace
+            files: "\\.(py|txt|yaml|json|md|toml|lock|cfg|html|sh|js|ts|yml)$"
+          - id: mixed-line-ending
+            files: "\\.(py|txt|yaml|json|md|toml|lock|cfg|html|sh|js|ts|yml)$"
+          - id: fix-byte-order-marker
+          - id: name-tests-test
+
+    - repo: https://github.com/pycqa/isort
+      rev: "7.0.0"
+      hooks:
+          - id: isort
+            files: "\\.(py)$"
+            args: [--settings-path=pyproject.toml]
+
+    - repo: https://github.com/hadialqattan/pycln
+      rev: v2.6.0
+      hooks:
+          - id: pycln
+            args: [--config=pyproject.toml]
+
+    - repo: https://github.com/pre-commit/mirrors-mypy
+      rev: "v1.19.1"
+      hooks:
+          - id: mypy
+            args: ["--config=pyproject.toml"]
+            additional_dependencies:
+                - httpx
+                - pydantic_settings
+                - rich
+                - typer
+
+    - repo: https://github.com/astral-sh/ruff-pre-commit
+      rev: v0.14.14
+      hooks:
+          - id: ruff-check
+            types_or: [python, pyi]
+            args: [--fix]
+          - id: ruff-format
+            types_or: [python, pyi]
+
+    - repo: https://github.com/astral-sh/uv-pre-commit
+      rev: 0.9.28
+      hooks:
+          - id: uv-lock

bark_agent_hook-0.1.1/AGENTS.md

@@ -0,0 +1,21 @@
+# Repository Guidelines
+
+## Project Structure
+
+`bark_agent_hook/` contains the Python package and Typer CLI. The public entry point is `bark-agent-hook`, wired through `bark_agent_hook.cli:cmd`. Runtime plugin assets live under `plugins/`, with separate Codex, Claude Code, and OpenClaw plugin directories. Tests live in `tests/` and mirror CLI behavior and plugin manifests.
+
+## Development Commands
+
+- `uv sync --group dev`: install the local development environment.
+- `uv run pytest -q`: run the test suite.
+- `uv run tox`: run the configured Python compatibility matrix.
+- `uv run pre-commit run --all-files`: run formatting, linting, type, lockfile, and hygiene checks.
+- `uv build`: build the wheel and source distribution.
+
+## Conventions
+
+Use Python 3.10+ and keep code typed where practical. Ruff is the formatter and linter with a 200-character line length. Keep this repository focused on Bark agent hooks; do not add unrelated utilities or generated command docs.
+
+## Security
+
+Do not commit real secrets, tokens, certificates, private keys, `.env`, or local service configuration. `bark-agent-hook` audit logging must not record raw hook payloads, Bark device keys/URLs, full notification bodies, or click URLs.

bark_agent_hook-0.1.1/CLAUDE.md

@@ -0,0 +1,22 @@
+# CLAUDE.md
+
+This repository contains the standalone `bark-agent-hook` CLI and companion plugin assets for Codex, Claude Code, and OpenClaw.
+
+## Common Commands
+
+- `uv sync --group dev`
+- `uv run pytest -q`
+- `uv run pytest -q tests/<file>_test.py`
+- `uv run tox`
+- `uv run pre-commit run --all-files`
+- `uv build`
+
+## Architecture
+
+The Typer CLI is exposed as `bark-agent-hook`. It intentionally has only three subcommands: `hook`, `install`, and `uninstall`. Install guidance belongs in the root help text, not in generated command docs or a separate `plugins` command group.
+
+Plugin manifests are under `plugins/`; marketplace manifests are under `.agents/plugins/` and `.claude-plugin/`. Keep manifest versions synchronized across Codex, Claude Code, OpenClaw package metadata, and OpenClaw native manifest.
+
+## Security-Sensitive Areas
+
+The hook receives agent lifecycle payloads and sends Bark requests. Audit logging must remain opt-in and must not persist raw hook payloads, Bark device keys or URLs, full notification bodies, or rendered click URLs.

bark_agent_hook-0.1.1/CODEOWNERS

@@ -0,0 +1 @@
+* @qsoyq