agmh 0.2.0__tar.gz

agmh-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: Bug report
+description: Report a reproducible AGMH bug.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What went wrong?
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: AGMH version or commit
+      placeholder: "0.1.0 or commit SHA"
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "python --version"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: "Ubuntu 24.04, Debian 12, Windows 11, etc."
+    validations:
+      required: true
+  - type: textarea
+    id: command
+    attributes:
+      label: Command
+      description: Paste the command you ran.
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: config
+    attributes:
+      label: Sanitized config
+      description: Remove tokens, webhook URLs, private repository names, and credentialized URLs.
+      render: toml
+  - type: textarea
+    id: logs
+    attributes:
+      label: Sanitized logs or traceback
+      description: Remove secrets before posting.
+      render: text
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+

agmh-0.2.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,9 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security report
+    url: mailto:root@haltman.io
+    about: Do not open public security issues. Email root@haltman.io.
+  - name: Repository
+    url: https://github.com/haltman-io/agmh
+    about: Main AGMH repository.
+

agmh-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,41 @@
+name: Feature request
+description: Suggest a focused AGMH improvement.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What workflow is hard or missing?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: What should AGMH do?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - sources
+        - destinations
+        - local mirror
+        - remote mirror
+        - watching
+        - notifications
+        - packaging
+        - documentation
+  - type: textarea
+    id: notes
+    attributes:
+      label: Additional context
+

agmh-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+## Summary
+
+- 
+
+## Validation
+
+- [ ] `python -m compileall -q src tests`
+- [ ] `PYTHONPATH=src python -m unittest discover -s tests -v`
+- [ ] `python -m pip install -e . --dry-run --no-deps`
+
+## Checklist
+
+- [ ] User-facing behavior is documented.
+- [ ] Secrets are not logged or exposed.
+- [ ] Source/destination terminology remains consistent.
+- [ ] `CHANGELOG.md` is updated when behavior changes.
+
+## Security
+
+Do not include private vulnerability details in this pull request. Follow
+`SECURITY.md` instead.
+

agmh-0.2.0/.github/dependabot.yml

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

agmh-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  tests:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install package
+        run: |
+          python -m pip install -U pip
+          python -m pip install -e ".[tui,dev]"
+
+      - name: Compile
+        run: python -m compileall -q src tests
+
+      - name: Test
+        run: python -m unittest discover -s tests -v
+
+  package:
+    name: Package
+    runs-on: ubuntu-latest
+    needs: tests
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+          cache: pip
+
+      - name: Install build tooling
+        run: |
+          python -m pip install -U pip
+          python -m pip install ".[dev]"
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: python -m twine check --strict dist/*
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+          if-no-files-found: error
+

agmh-0.2.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,63 @@
+name: Publish PyPI Manually
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-pypi-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+          cache: pip
+
+      - name: Install build tooling
+        run: |
+          python -m pip install -U pip
+          python -m pip install ".[dev]"
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: python -m twine check --strict dist/*
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/project/agmh/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

agmh-0.2.0/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,66 @@
+name: Publish TestPyPI
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-testpypi-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+          cache: pip
+
+      - name: Install build tooling
+        run: |
+          python -m pip install -U pip
+          python -m pip install ".[dev]"
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: python -m twine check --strict dist/*
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to TestPyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/agmh/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+
+      - name: Publish distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+

agmh-0.2.0/.github/workflows/release-please.yml

@@ -0,0 +1,65 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+
+concurrency:
+  group: release-please-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - name: Create or update release PR
+        id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created == 'true' }}
+    environment:
+      name: pypi
+      url: https://pypi.org/project/agmh/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout release tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.release-please.outputs.tag_name }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+          cache: pip
+
+      - name: Install build tooling
+        run: |
+          python -m pip install -U pip
+          python -m pip install ".[dev]"
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: python -m twine check --strict dist/*
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

agmh-0.2.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.0"
+}

agmh-0.2.0/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable project changes should be documented in this file.
+
+This project uses human-readable release notes grouped by version. Dates use
+`YYYY-MM-DD`.
+
+## [0.2.0](https://github.com/haltman-io/agmh/compare/v0.1.0...v0.2.0) (2026-06-13)
+
+
+### Features
+
+* add notification system with webhooks for events ([174db38](https://github.com/haltman-io/agmh/commit/174db38ae36085ec69bf55d5e6ddc59a7faa259c))
+* enhance project structure with CI workflows, release automation, and packaging improvements ([dceb257](https://github.com/haltman-io/agmh/commit/dceb2573c32944a04ef2af54ee14cfeb772ceb34))
+* enhance project structure with CI workflows, release automation… ([19e3806](https://github.com/haltman-io/agmh/commit/19e3806bb27dce7c99b8769ecb2c899c48bd9746))
+* update project metadata, add templates, and enhance documentation ([5ecef83](https://github.com/haltman-io/agmh/commit/5ecef83d860032a08cf809337ae267b883e76b8b))
+
+## [Unreleased]
+
+### Added
+
+- Security reporting policy.
+- Contribution and support guidelines.
+- Project maintenance files and GitHub issue/PR templates.
+- PyPI/TestPyPI publishing workflows using Trusted Publishing.
+- Release Please configuration for automated version bumps, changelog updates,
+  Git tags, and GitHub Releases.
+- CI workflow for Python tests and distribution checks.
+
+### Changed
+
+- Package metadata now identifies `extencil <extencil@segfault.net>` as author
+  and maintainer.
+
+## [0.1.0] - 2026-06-13
+
+### Added
+
+- Initial AGMH CLI package.
+- Repository discovery from GitHub, GitLab, Forgejo/Codeberg, Bitbucket, and
+  SourceHut sources.
+- Local mirror, remote mirror, full mirror, and watching workflows.
+- Destination support for GitHub, GitLab, Forgejo/Codeberg, Bitbucket, and
+  SourceHut.
+- Optional marker commits before remote mirrors.
+- Optional webhook notifications for generic endpoints, Discord, and Telegram.

agmh-0.2.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,18 @@
+# Code Of Conduct
+
+AGMH is a direct, security-oriented project. Keep collaboration technical,
+specific, and useful.
+
+Expected behavior:
+
+- Stay focused on the work.
+- Be precise when reporting bugs or reviewing code.
+- Assume reports may involve stressful incidents and handle them seriously.
+- Do not post secrets, private repository data, or personal information.
+- Do not harass, threaten, spam, or derail maintainers or contributors.
+
+Unacceptable behavior may result in closed issues, removed comments, blocked
+accounts, or private handling by maintainers.
+
+For private conduct or abuse reports, contact `root@haltman.io`.
+

agmh-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing
+
+AGMH accepts focused changes that keep the tool reliable, scriptable, and easy
+to audit.
+
+## Development Setup
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install -U pip
+python -m pip install -e ".[tui,dev]"
+```
+
+On Windows PowerShell:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install -U pip
+python -m pip install -e ".[tui,dev]"
+```
+
+## Local Checks
+
+Run these before sending changes:
+
+```bash
+python -m compileall -q src tests
+PYTHONPATH=src python -m unittest discover -s tests -v
+python -m build
+python -m twine check --strict dist/*
+python -m pip install -e . --dry-run --no-deps
+```
+
+## Change Guidelines
+
+- Keep source/destination terminology precise.
+- Do not reintroduce legacy `aghm` names.
+- Do not log secrets, tokens, webhook URLs, or credentialized Git URLs.
+- Prefer small, reviewable changes.
+- Add focused tests for behavior changes.
+- Update `README.md`, `config.example.toml`, and `CHANGELOG.md` when user-facing
+  behavior changes.
+- Use Conventional Commit messages so Release Please can generate releases and
+  changelog entries.
+
+## Security Issues
+
+Do not report security issues through public issues or pull requests. Follow
+`SECURITY.md`.
+
+## Releases
+
+See `RELEASING.md`.

agmh-0.2.0/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <https://unlicense.org>

agmh-0.2.0/MAINTAINERS.md

@@ -0,0 +1,22 @@
+# Maintainers
+
+## Current Maintainer
+
+- extencil <extencil@segfault.net>
+
+## Repository
+
+- https://github.com/haltman-io/agmh
+
+## Security Contact
+
+- root@haltman.io
+
+## Maintenance Notes
+
+- Keep package metadata aligned with `pyproject.toml`.
+- Keep generated examples aligned with `config.example.toml`.
+- Keep security-sensitive changes covered by tests.
+- Keep release notes in `CHANGELOG.md`.
+- Keep `RELEASING.md` and GitHub Actions publishing workflows aligned with PyPI
+  Trusted Publishing settings.

agmh-0.2.0/MANIFEST.in

@@ -0,0 +1,17 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include SECURITY.md
+include CONTRIBUTING.md
+include SUPPORT.md
+include CODE_OF_CONDUCT.md
+include MAINTAINERS.md
+include RELEASING.md
+include config.example.toml
+include sources.example.txt
+include destinations.example.txt
+include .release-please-manifest.json
+include release-please-config.json
+recursive-include .github *.md *.yml
+recursive-include src *.typed
+recursive-include tests *.py