do-again 0.1.0__tar.gz

do_again-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install -e .
+      - run: python -m unittest discover -s tests -v
+      - run: do-again doctor

do_again-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install --upgrade build twine
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/do-again
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

do_again-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+build/
+*.egg-info/
+.DS_Store
+.env
+.env.*

do_again-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Steven Tran
+
+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.

do_again-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: do-again
+Version: 0.1.0
+Summary: Policy-controlled local execution for agent-driven development workflows
+Project-URL: Homepage, https://github.com/Tran-Steven/do-again
+Project-URL: Repository, https://github.com/Tran-Steven/do-again
+Project-URL: Issues, https://github.com/Tran-Steven/do-again/issues
+Author: Steven Tran
+License: MIT License
+        
+        Copyright (c) 2026 Steven Tran
+        
+        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.
+License-File: LICENSE
+Keywords: agents,automation,developer-tools,github,local-execution,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Do Again
+
+[![CI](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml/badge.svg)](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/do-again.svg)](https://pypi.org/project/do-again/)
+[![Python](https://img.shields.io/pypi/pyversions/do-again.svg)](https://pypi.org/project/do-again/)
+[![License](https://img.shields.io/github/license/Tran-Steven/do-again.svg)](LICENSE)
+
+Do Again is a policy-controlled local execution layer for agent-driven development workflows. It lets an agent submit scoped work to a developer machine, receive auditable receipts and artifacts, inspect the result, and continue working when another pass is needed.
+
+## Install
+
+```bash
+pip install do-again
+```
+
+The installed command is:
+
+```bash
+do-again
+```
+
+## Quick start
+
+```bash
+do-again doctor
+do-again init
+do-again status
+```
+
+## Why Do Again
+
+- Explicit policy-based command permissions
+- GitHub-backed request and receipt transport
+- Persistent local background execution architecture
+- Project-scoped filesystem and command access
+- Deterministic audit trail and recovery
+- No agent API keys embedded in the project
+- A shared platform interface for macOS, Linux, and Windows
+
+## Platform status
+
+| Platform | Status | Service backend |
+| --- | --- | --- |
+| macOS | Core working | launchd |
+| Linux | Adapter scaffolded | systemd user service |
+| Windows | Adapter scaffolded | Windows service |
+
+Do Again is currently alpha software. macOS is the first active platform while Linux and Windows service integration are being completed behind the same interface.
+
+## Development
+
+```bash
+git clone https://github.com/Tran-Steven/do-again.git
+cd do-again
+python -m pip install -e .
+python -m unittest discover -s tests -v
+do-again doctor
+```
+
+## Release model
+
+Releases use semantic versioning. Pushing a version tag such as `v0.1.0` builds a wheel and source distribution, validates both artifacts, and publishes them to PyPI through Trusted Publishing.
+
+PyPI distribution name: `do-again`
+
+CLI command: `do-again`
+
+Python package: `do_again`
+
+## Security
+
+Do Again is designed around explicit allowlists, scoped filesystem roots, bounded execution, and auditable request/receipt records. It should not be configured as unrestricted shell access.
+
+## License
+
+MIT

do_again-0.1.0/README.md

@@ -0,0 +1,76 @@
+# Do Again
+
+[![CI](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml/badge.svg)](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/do-again.svg)](https://pypi.org/project/do-again/)
+[![Python](https://img.shields.io/pypi/pyversions/do-again.svg)](https://pypi.org/project/do-again/)
+[![License](https://img.shields.io/github/license/Tran-Steven/do-again.svg)](LICENSE)
+
+Do Again is a policy-controlled local execution layer for agent-driven development workflows. It lets an agent submit scoped work to a developer machine, receive auditable receipts and artifacts, inspect the result, and continue working when another pass is needed.
+
+## Install
+
+```bash
+pip install do-again
+```
+
+The installed command is:
+
+```bash
+do-again
+```
+
+## Quick start
+
+```bash
+do-again doctor
+do-again init
+do-again status
+```
+
+## Why Do Again
+
+- Explicit policy-based command permissions
+- GitHub-backed request and receipt transport
+- Persistent local background execution architecture
+- Project-scoped filesystem and command access
+- Deterministic audit trail and recovery
+- No agent API keys embedded in the project
+- A shared platform interface for macOS, Linux, and Windows
+
+## Platform status
+
+| Platform | Status | Service backend |
+| --- | --- | --- |
+| macOS | Core working | launchd |
+| Linux | Adapter scaffolded | systemd user service |
+| Windows | Adapter scaffolded | Windows service |
+
+Do Again is currently alpha software. macOS is the first active platform while Linux and Windows service integration are being completed behind the same interface.
+
+## Development
+
+```bash
+git clone https://github.com/Tran-Steven/do-again.git
+cd do-again
+python -m pip install -e .
+python -m unittest discover -s tests -v
+do-again doctor
+```
+
+## Release model
+
+Releases use semantic versioning. Pushing a version tag such as `v0.1.0` builds a wheel and source distribution, validates both artifacts, and publishes them to PyPI through Trusted Publishing.
+
+PyPI distribution name: `do-again`
+
+CLI command: `do-again`
+
+Python package: `do_again`
+
+## Security
+
+Do Again is designed around explicit allowlists, scoped filesystem roots, bounded execution, and auditable request/receipt records. It should not be configured as unrestricted shell access.
+
+## License
+
+MIT

do_again-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "do-again"
+version = "0.1.0"
+description = "Policy-controlled local execution for agent-driven development workflows"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {file = "LICENSE"}
+authors = [{name = "Steven Tran"}]
+keywords = ["agents", "automation", "developer-tools", "github", "orchestration", "local-execution"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/Tran-Steven/do-again"
+Repository = "https://github.com/Tran-Steven/do-again"
+Issues = "https://github.com/Tran-Steven/do-again/issues"
+
+[project.scripts]
+do-again = "do_again.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/do_again"]

do_again-0.1.0/src/do_again/cli.py

@@ -0,0 +1,63 @@
+from __future__ import annotations
+
+import argparse
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+from .platforms.detect import detect_platform
+
+
+def doctor() -> int:
+    info = detect_platform()
+    checks = {
+        "python": sys.version_info >= (3, 11),
+        "git": shutil.which("git") is not None,
+        "platform": info.supported,
+    }
+    for key, ok in checks.items():
+        print(f"{'OK' if ok else 'FAIL'} {key}")
+    print(f"platform_name={info.name}")
+    print(f"service_manager={info.service_manager}")
+    return 0 if all(checks.values()) else 1
+
+
+def status() -> int:
+    info = detect_platform()
+    print(f"platform={info.name}")
+    print(f"service_manager={info.service_manager}")
+    return 0
+
+
+def init_project(path: str) -> int:
+    target = Path(path).expanduser().resolve()
+    target.mkdir(parents=True, exist_ok=True)
+    config = target / "do-again.toml"
+    if config.exists():
+        print(str(config))
+        return 0
+    config.write_text('[do_again]\ncontrol_branch = "operator-control"\n')
+    print(str(config))
+    return 0
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(prog="do-again")
+    sub = parser.add_subparsers(dest="command", required=True)
+    sub.add_parser("doctor")
+    sub.add_parser("status")
+    init_parser = sub.add_parser("init")
+    init_parser.add_argument("path", nargs="?", default=".")
+    args = parser.parse_args()
+    if args.command == "doctor":
+        return doctor()
+    if args.command == "status":
+        return status()
+    if args.command == "init":
+        return init_project(args.path)
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())