do-again 0.1.0__tar.gz → 0.2.0__tar.gz

do_again-0.2.0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"

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

@@ -0,0 +1,60 @@
+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:
+  version-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.13"
+      - run: python tools/check_release_version.py
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install .
+      - run: python -m pip check
+      - run: python -m unittest discover -s tests -v
+      - run: do-again doctor
+
+  npm-package:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: "24"
+          package-manager-cache: false
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.13"
+      - run: npm ci
+      - run: npm test
+      - run: npm pack --dry-run --ignore-scripts

do_again-0.2.0/.github/workflows/npm-release.yml

@@ -0,0 +1,50 @@
+name: NPM Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: npm
+      url: https://www.npmjs.com/package/do-again
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+          package-manager-cache: false
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.13"
+      - name: Verify release versions
+        run: python tools/check_release_version.py --tag "$GITHUB_REF_NAME"
+      - run: npm ci
+      - run: npm test
+      - run: npm publish
+      - name: Wait for npm registry availability
+        shell: bash
+        run: |
+          version=$(node -p "require('./package.json').version")
+          for attempt in $(seq 1 120); do
+            published=$(npm view "do-again@$version" version 2>/dev/null || true)
+            latest=$(npm view do-again dist-tags.latest 2>/dev/null || true)
+            if [ "$published" = "$version" ] && [ "$latest" = "$version" ]; then
+              echo "do-again@$version is available from the public npm registry"
+              exit 0
+            fi
+            echo "Waiting for npm registry propagation ($attempt/120)..."
+            sleep 15
+          done
+          echo "Timed out waiting for do-again@$version to become publicly available" >&2
+          exit 1

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

@@ -0,0 +1,55 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.13"
+      - name: Verify release versions
+        run: python tools/check_release_version.py --tag "$GITHUB_REF_NAME"
+      - run: python -m pip install --upgrade build twine
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # 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@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release view "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1 ||
+            gh release create "$GITHUB_REF_NAME"               --repo "$GITHUB_REPOSITORY"               --verify-tag               --generate-notes               --title "Do Again $GITHUB_REF_NAME"

do_again-0.2.0/.npmignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.py[cod]
+.DS_Store
+.venv/
+dist/
+build/

{do_again-0.1.0 → do_again-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: do-again
-Version: 0.1.0
+Version: 0.2.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
@@ -35,69 +35,124 @@ 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)
+[![CI](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/do-again.svg?cacheSeconds=300)](https://pypi.org/project/do-again/)
+[![npm](https://img.shields.io/npm/v/do-again.svg?cacheSeconds=300)](https://www.npmjs.com/package/do-again)
+[![Python](https://img.shields.io/pypi/pyversions/do-again.svg?cacheSeconds=300)](https://pypi.org/project/do-again/)
+[![License](https://img.shields.io/github/license/Tran-Steven/do-again.svg?cacheSeconds=300)](LICENSE)
+
+Do Again gives AI coding agents a policy-controlled way to execute work on a local development machine, return auditable receipts and artifacts, and keep iterating when another pass is needed.
+
+## How it works
+
+```text
+agent
+  |
+  | request
+  v
+operator-control branch
+  |
+  v
+Do Again -> policy validation -> local command / file / test / git action
+  ^                                         |
+  |                                         |
+  +----------- receipt / artifact -----------+
+```
 
-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.
+The agent can inspect the result, decide what still needs work, and submit another scoped action instead of stopping at the first attempt.
 
 ## Install
 
+### Python / PyPI
+
 ```bash
 pip install do-again
 ```
 
-The installed command is:
+### Node / npm
+
+```bash
+npm install -g do-again
+```
+
+or run it without a global install:
+
+```bash
+npx do-again doctor
+```
+
+Both distributions expose the same command:
 
 ```bash
 do-again
 ```
 
+The npm package ships the same Python runtime from this repository behind a small Node launcher. It requires Node.js 18+ and Python 3.11+.
+
 ## Quick start
 
 ```bash
 do-again doctor
 do-again init
+do-again install
 do-again status
 ```
 
+## Service lifecycle
+
+On macOS, Do Again can install a per-repository launchd agent:
+
+    do-again install
+    do-again status
+    do-again restart
+    do-again stop
+    do-again uninstall
+
+For attended or cross-platform use, run the agent in the foreground:
+
+    do-again run
+    do-again run --once
+
+Each repository gets an isolated runtime, control worktree, state directory, policy copy, and service label under ~/.do_again. The installed service runs from a copied runtime so installs made through either PyPI or npm remain stable after the invoking shell exits.
+
 ## 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
+- CI-tested on Python 3.11, 3.12, and 3.13 across all three platforms
 
 ## Platform status
 
 | Platform | Status | Service backend |
 | --- | --- | --- |
-| macOS | Core working | launchd |
-| Linux | Adapter scaffolded | systemd user service |
-| Windows | Adapter scaffolded | Windows service |
+| macOS | Service lifecycle working | launchd |
+| Linux | Foreground runner working; service adapter scaffolded | systemd user service |
+| Windows | Foreground runner working; service 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.
+Do Again is currently alpha software. The foreground runner works across the supported Python platforms; macOS is the first platform with an installable background service 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 pip install .
 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.
+Releases use semantic versioning. Pushing a version tag such as `v0.2.0` validates the shared release version, publishes the Python distribution to PyPI and the Node launcher to npm through Trusted Publishing, and creates the matching GitHub Release.
 
 PyPI distribution name: `do-again`
 
+npm package name: `do-again`
+
 CLI command: `do-again`
 
 Python package: `do_again`

do_again-0.2.0/README.md

@@ -0,0 +1,131 @@
+# Do Again
+
+[![CI](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Tran-Steven/do-again/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/do-again.svg?cacheSeconds=300)](https://pypi.org/project/do-again/)
+[![npm](https://img.shields.io/npm/v/do-again.svg?cacheSeconds=300)](https://www.npmjs.com/package/do-again)
+[![Python](https://img.shields.io/pypi/pyversions/do-again.svg?cacheSeconds=300)](https://pypi.org/project/do-again/)
+[![License](https://img.shields.io/github/license/Tran-Steven/do-again.svg?cacheSeconds=300)](LICENSE)
+
+Do Again gives AI coding agents a policy-controlled way to execute work on a local development machine, return auditable receipts and artifacts, and keep iterating when another pass is needed.
+
+## How it works
+
+```text
+agent
+  |
+  | request
+  v
+operator-control branch
+  |
+  v
+Do Again -> policy validation -> local command / file / test / git action
+  ^                                         |
+  |                                         |
+  +----------- receipt / artifact -----------+
+```
+
+The agent can inspect the result, decide what still needs work, and submit another scoped action instead of stopping at the first attempt.
+
+## Install
+
+### Python / PyPI
+
+```bash
+pip install do-again
+```
+
+### Node / npm
+
+```bash
+npm install -g do-again
+```
+
+or run it without a global install:
+
+```bash
+npx do-again doctor
+```
+
+Both distributions expose the same command:
+
+```bash
+do-again
+```
+
+The npm package ships the same Python runtime from this repository behind a small Node launcher. It requires Node.js 18+ and Python 3.11+.
+
+## Quick start
+
+```bash
+do-again doctor
+do-again init
+do-again install
+do-again status
+```
+
+## Service lifecycle
+
+On macOS, Do Again can install a per-repository launchd agent:
+
+    do-again install
+    do-again status
+    do-again restart
+    do-again stop
+    do-again uninstall
+
+For attended or cross-platform use, run the agent in the foreground:
+
+    do-again run
+    do-again run --once
+
+Each repository gets an isolated runtime, control worktree, state directory, policy copy, and service label under ~/.do_again. The installed service runs from a copied runtime so installs made through either PyPI or npm remain stable after the invoking shell exits.
+
+## Why Do Again
+
+- Explicit policy-based command permissions
+- GitHub-backed request and receipt transport
+- 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
+- CI-tested on Python 3.11, 3.12, and 3.13 across all three platforms
+
+## Platform status
+
+| Platform | Status | Service backend |
+| --- | --- | --- |
+| macOS | Service lifecycle working | launchd |
+| Linux | Foreground runner working; service adapter scaffolded | systemd user service |
+| Windows | Foreground runner working; service adapter scaffolded | Windows service |
+
+Do Again is currently alpha software. The foreground runner works across the supported Python platforms; macOS is the first platform with an installable background service 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 .
+python -m unittest discover -s tests -v
+do-again doctor
+```
+
+## Release model
+
+Releases use semantic versioning. Pushing a version tag such as `v0.2.0` validates the shared release version, publishes the Python distribution to PyPI and the Node launcher to npm through Trusted Publishing, and creates the matching GitHub Release.
+
+PyPI distribution name: `do-again`
+
+npm package 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.2.0/bin/do-again.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const MIN_PYTHON = [3, 11];
+
+function parsePythonVersion(output) {
+  const match = String(output || "").match(/Python\s+(\d+)\.(\d+)(?:\.(\d+))?/i);
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3] || 0)];
+}
+
+function versionAtLeast(version, minimum = MIN_PYTHON) {
+  if (!version) return false;
+  if (version[0] !== minimum[0]) return version[0] > minimum[0];
+  return version[1] >= minimum[1];
+}
+
+function candidates() {
+  const configured = process.env.DO_AGAIN_PYTHON;
+  if (configured) return [{ command: configured, prefix: [] }];
+
+  if (process.platform === "win32") {
+    return [
+      { command: "py", prefix: ["-3"] },
+      { command: "python", prefix: [] },
+      { command: "python3", prefix: [] }
+    ];
+  }
+  return [
+    { command: "python3", prefix: [] },
+    { command: "python", prefix: [] }
+  ];
+}
+
+function findPython() {
+  for (const candidate of candidates()) {
+    const probe = spawnSync(candidate.command, [...candidate.prefix, "--version"], {
+      encoding: "utf8",
+      windowsHide: true
+    });
+    if (probe.error || probe.status !== 0) continue;
+    const version = parsePythonVersion(`${probe.stdout || ""}\n${probe.stderr || ""}`);
+    if (versionAtLeast(version)) return candidate;
+  }
+  return null;
+}
+
+function main() {
+  const python = findPython();
+  if (!python) {
+    console.error("Do Again requires Python 3.11 or newer.");
+    console.error("Install Python, or set DO_AGAIN_PYTHON to a Python 3.11+ executable.");
+    return 1;
+  }
+
+  const packageRoot = path.resolve(__dirname, "..");
+  const sourceRoot = path.join(packageRoot, "src");
+  const packageDir = path.join(sourceRoot, "do_again");
+  if (!fs.existsSync(packageDir)) {
+    console.error(`Do Again runtime is missing from the npm package: ${packageDir}`);
+    return 1;
+  }
+
+  const env = { ...process.env };
+  env.PYTHONDONTWRITEBYTECODE = env.PYTHONDONTWRITEBYTECODE || "1";
+  env.PYTHONPATH = env.PYTHONPATH
+    ? `${sourceRoot}${path.delimiter}${env.PYTHONPATH}`
+    : sourceRoot;
+
+  const child = spawnSync(
+    python.command,
+    [...python.prefix, "-m", "do_again.cli", ...process.argv.slice(2)],
+    {
+      cwd: process.cwd(),
+      env,
+      stdio: "inherit",
+      windowsHide: true
+    }
+  );
+
+  if (child.error) {
+    console.error(`Failed to launch Do Again: ${child.error.message}`);
+    return 1;
+  }
+  if (child.signal) return 1;
+  return child.status ?? 1;
+}
+
+process.exitCode = main();

do_again-0.2.0/npm-tests/launcher.test.js

@@ -0,0 +1,30 @@
+"use strict";
+
+const assert = require("node:assert/strict");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+const test = require("node:test");
+
+const root = path.resolve(__dirname, "..");
+const launcher = path.join(root, "bin", "do-again.js");
+
+function run(args, extraEnv = {}) {
+  return spawnSync(process.execPath, [launcher, ...args], {
+    cwd: root,
+    encoding: "utf8",
+    env: { ...process.env, ...extraEnv }
+  });
+}
+
+test("npm launcher runs the bundled Python CLI", () => {
+  const result = run(["status"]);
+  assert.equal(result.status, 0, result.stderr);
+  assert.match(result.stdout, /platform=/);
+  assert.match(result.stdout, /service_manager=/);
+});
+
+test("npm launcher reports a missing configured Python cleanly", () => {
+  const result = run(["status"], { DO_AGAIN_PYTHON: "definitely-not-a-python-executable" });
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /requires Python 3\.11 or newer/);
+});

do_again-0.2.0/package-lock.json

@@ -0,0 +1,19 @@
+{
+  "name": "do-again",
+  "version": "0.2.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "do-again",
+      "version": "0.2.0",
+      "license": "MIT",
+      "bin": {
+        "do-again": "bin/do-again.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    }
+  }
+}

do_again-0.2.0/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "do-again",
+  "version": "0.2.0",
+  "description": "Policy-controlled local execution for AI coding agents",
+  "license": "MIT",
+  "author": "Steven Tran",
+  "type": "commonjs",
+  "bin": {
+    "do-again": "bin/do-again.js"
+  },
+  "files": [
+    "bin/",
+    "src/do_again/**/*.py",
+    "README.md",
+    "LICENSE",
+    "src/do_again/default_policy.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tran-Steven/do-again.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Tran-Steven/do-again/issues"
+  },
+  "homepage": "https://github.com/Tran-Steven/do-again#readme",
+  "keywords": [
+    "ai-agents",
+    "coding-agents",
+    "automation",
+    "developer-tools",
+    "python",
+    "local-execution"
+  ],
+  "scripts": {
+    "test": "node --test npm-tests/*.test.js",
+    "prepack": "npm test"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

{do_again-0.1.0 → do_again-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "do-again"
-version = "0.1.0"
+version = "0.2.0"
 description = "Policy-controlled local execution for agent-driven development workflows"
 readme = "README.md"
 requires-python = ">=3.11"