task-agent 1.3.3__tar.gz → 1.3.8__tar.gz

task_agent-1.3.8/.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      # https://github.com/actions/checkout
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      # The committed .env carries this developer's local ejected-store
+      # path (see .env, and _handle_ejected_symlink in discovery.py). A
+      # legacy migration branch there reloads .env with override=True,
+      # so an env var can't reliably countermand it — remove the file
+      # itself so discover() falls back to its safe in-repo default.
+      - name: Remove developer-local .env
+        run: rm -f .env
+
+      # Several tests create real git repos (auto-commit, store migration)
+      # and need a committer identity; the runner has none by default.
+      - name: Configure git identity for tests
+        run: |
+          git config --global user.name "CI Runner"
+          git config --global user.email "ci@task-agent.invalid"
+
+      # https://github.com/astral-sh/setup-uv
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Run ruff
+        run: uv run ruff check .
+
+      - name: Run mypy
+        run: uv run mypy src
+
+      - name: Run pytest
+        run: uv run pytest

task_agent-1.3.8/.github/workflows/publish.yml

@@ -0,0 +1,62 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+      attestations: write
+
+    steps:
+      # https://github.com/actions/checkout
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      # The committed .env carries this developer's local ejected-store
+      # path (see .env, and _handle_ejected_symlink in discovery.py). A
+      # legacy migration branch there reloads .env with override=True,
+      # so an env var can't reliably countermand it — remove the file
+      # itself so discover() falls back to its safe in-repo default.
+      - name: Remove developer-local .env
+        run: rm -f .env
+
+      # Several tests create real git repos (auto-commit, store migration)
+      # and need a committer identity; the runner has none by default.
+      - name: Configure git identity for tests
+        run: |
+          git config --global user.name "CI Runner"
+          git config --global user.email "ci@task-agent.invalid"
+
+      # https://github.com/astral-sh/setup-uv
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run test suite
+        run: uv run pytest
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true

{task_agent-1.3.3 → task_agent-1.3.8}/.gitignore

@@ -11,6 +11,8 @@ taskhash
 .task-agent
 .pytest_cache/
 pytest-of-*/
+node_modules/
+.venv/
 
 
 # task-agent: human-facing store symlink

task_agent-1.3.8/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: task-agent
+Version: 1.3.8
+Summary: A prioritized, file-based task queue for autonomous agentic workers
+Project-URL: Homepage, https://github.com/InTEGr8or/task-agent
+Project-URL: Repository, https://github.com/InTEGr8or/task-agent.git
+Project-URL: Issues, https://github.com/InTEGr8or/task-agent/issues
+Project-URL: Documentation, https://github.com/InTEGr8or/task-agent/blob/main/README.md
+Author-email: Mark Stouffer <1802850+InTEGr8or@users.noreply.github.com>
+License: MIT
+Keywords: agentic-workflow,ai-agent,antigravity,claude-code,grok,matrix-bridge,mcp,model-context-protocol,multi-agent,opencode,task-agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.12
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: githubkit>=0.15.5
+Requires-Dist: google-genai>=0.1.0
+Requires-Dist: mcp<2.0.0,>=1.26.0
+Requires-Dist: multi-agent-registry>=0.1.0
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: python-dotenv>=1.2.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=13.9.4
+Requires-Dist: transitions>=0.9.2
+Requires-Dist: verkit>=0.1.4
+Description-Content-Type: text/markdown
+
+# Task Agent 🤖
+
+A prioritized, file-based task queue for autonomous agentic workers. This system uses a "Mission Control" approach to manage multiple agents working on git-tracked improvements across various branches and worktrees.
+
+## 📂 System Architecture
+
+The project follows a specific folder structure to manage the lifecycle of an improvement:
+
+- `docs/issues/`: The core queue.
+    - `mission.usv`: A prioritized list of issues using Unit Separator Value (`\x1f`) format. This serves as the source of truth for task priority.
+    - `datapackage.json`: Frictionless Data metadata for the `mission.usv` schema.
+    - `pending/`: New issues awaiting triage or assignment.
+    - `draft/`: Issues currently being refined or planned.
+    - `active/`: Issues actively being worked on by an agent.
+    - `completed/{year}/`: Successfully implemented and verified improvements.
+- `.gwt/`: Git Worktree directory where active branches are checked out for isolated agent execution.
+
+## 🛠️ Tooling: `ta` (Task Agent CLI)
+
+The `ta` tool automates the transition of issues through the queue and manages the underlying git infrastructure.
+
+### Commands
+
+| Command | Action |
+| :--- | :--- |
+| `ta next` | Displays the top prioritized issue from `mission.usv`. |
+| `ta new` | Creates a new issue file and adds it to the queue. |
+| `ta done` | Moves issue to `completed/`, removes it from the queue, and auto-commits the result. |
+| `ta start <slug>` | Moves issue to `active/`, creates a git branch, and sets up a `.gwt/` worktree. |
+| `ta run <slug>` | Invokes the sidecar worker defined at `.ta/worker` to process an active issue. |
+
+## 🚀 Workflow
+
+1. **Prioritize**: Use `ta new -t "Title"` to add a task.
+2. **Review**: Run `ta next` to see what is currently at the top of the queue.
+3. **Dispatch**: (Planned) Run `ta start <slug>` to prepare the workspace.
+4. **Execute**: (Planned) The agent (Gemini CLI) processes the task in its isolated worktree via `ta run <slug>`.
+5. **Finalize**: Once verified, `ta done` moves the task to the finished state.
+
+## 🤖 Multi-Agent CLI Portfolio (`multi-agent-registry`)
+
+`task-agent` integrates with [`multi-agent-registry`](https://github.com/InTEGr8or/multi-agent-registry) (`multi_agent_registry`) to automatically detect, configure, and inspect AI agent CLIs across your developer workstation:
+
+- **Supported Agent CLIs**: Claude Code (`claude`), Antigravity CLI (`agy`), OpenCode (`opencode`), Grok Build (`grok`), GitHub Copilot CLI (`copilot`), Cursor (`cursor`), Windsurf (`windsurf`), Aider (`aider`), Continue (`continue`), Cline (`cline`), Roo Code (`roo`).
+- **Features**: Automatic CLI detection, MCP configuration generation (`ta init-mcp`), session discovery, recent agent activity tracking (`ta agent recent`), and plugin management.
+
+---
+
+## 💬 Matrix Messaging Integration & Sidecar Daemon
+
+`task-agent` includes a zero-dependency Matrix sidecar bridge daemon ([`sidecars/matrix-bridge/`](file:///home/mstouffer/repos/task-agent/sidecars/matrix-bridge/)) for real-time remote notification and task chat bridging:
+
+- **Global Space & Store Binding**:
+  ```bash
+  # Configure machine-wide Matrix Space link
+  ta store matrix space set 'https://matrix.to/#/!space_id:matrix.org'
+
+  # Configure secret token reference (1Password op://, Linux keyring secret-tool://, or pass://)
+  ta store matrix token set 'op://Private/6pcab3dt5sml3sslfh6xffqit4/Saved on account.matrix.org/access-token'
+  ```
+- **Automated Space & Child Room Provisioning**:
+  When launched, the sidecar daemon (`python3 sidecars/matrix-bridge/matrix_bridge.py`) auto-discovers or provisions unencrypted child rooms inside your Space for each repository store and delivers real-time inbox comments.
+

task_agent-1.3.3/PKG-INFO → task_agent-1.3.8/README.md

@@ -1,64 +1,63 @@
-Metadata-Version: 2.5
-Name: task-agent
-Version: 1.3.3
-Summary: A prioritized, file-based task queue for autonomous agentic workers
-Author-email: Mark Stouffer <1802850+InTEGr8or@users.noreply.github.com>
-License: MIT
-Requires-Python: >=3.12
-Requires-Dist: agent-cli-registry>=0.1.1
-Requires-Dist: boto3>=1.34.0
-Requires-Dist: githubkit>=0.15.5
-Requires-Dist: google-genai>=0.1.0
-Requires-Dist: mcp<2.0.0,>=1.26.0
-Requires-Dist: pydantic>=2.10.6
-Requires-Dist: pyperclip>=1.9.0
-Requires-Dist: python-dotenv>=1.2.2
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: questionary>=2.1.1
-Requires-Dist: rich>=13.9.4
-Requires-Dist: transitions>=0.9.2
-Requires-Dist: verkit>=0.1.4
-Description-Content-Type: text/markdown
-
-# Task Agent 🤖
-
-A prioritized, file-based task queue for autonomous agentic workers. This system uses a "Mission Control" approach to manage multiple agents working on git-tracked improvements across various branches and worktrees.
-
-## 📂 System Architecture
-
-The project follows a specific folder structure to manage the lifecycle of an improvement:
-
-- `docs/issues/`: The core queue.
-    - `mission.usv`: A prioritized list of issues using Unit Separator Value (`\x1f`) format. This serves as the source of truth for task priority.
-    - `datapackage.json`: Frictionless Data metadata for the `mission.usv` schema.
-    - `pending/`: New issues awaiting triage or assignment.
-    - `draft/`: Issues currently being refined or planned.
-    - `active/`: Issues actively being worked on by an agent.
-    - `completed/{year}/`: Successfully implemented and verified improvements.
-- `.gwt/`: Git Worktree directory where active branches are checked out for isolated agent execution.
-
-## 🛠️ Tooling: `ta` (Task Agent CLI)
-
-The `ta` tool automates the transition of issues through the queue and manages the underlying git infrastructure.
-
-### Commands
-
-| Command | Action |
-| :--- | :--- |
-| `ta next` | Displays the top prioritized issue from `mission.usv`. |
-| `ta new` | Creates a new issue file and adds it to the queue. |
-| `ta done` | Moves issue to `completed/`, removes it from the queue, and auto-commits the result. |
-| `ta start <slug>` | Moves issue to `active/`, creates a git branch, and sets up a `.gwt/` worktree. |
-| `ta run <slug>` | Invokes the sidecar worker defined at `.ta/worker` to process an active issue. |
-
-## 🚀 Workflow
-
-1. **Prioritize**: Use `ta new -t "Title"` to add a task.
-2. **Review**: Run `ta next` to see what is currently at the top of the queue.
-3. **Dispatch**: (Planned) Run `ta start <slug>` to prepare the workspace.
-4. **Execute**: (Planned) The agent (Gemini CLI) processes the task in its isolated worktree via `ta run <slug>`.
-5. **Finalize**: Once verified, `ta done` moves the task to the finished state.
-
-## 🤖 Gemini CLI Integration
-
-By utilizing the Gemini CLI's headless mode, this system can orchestrate multiple agents simultaneously without requiring manual terminal management, significantly improving portability and scalability between Windows and WSL environments.
+# Task Agent 🤖
+
+A prioritized, file-based task queue for autonomous agentic workers. This system uses a "Mission Control" approach to manage multiple agents working on git-tracked improvements across various branches and worktrees.
+
+## 📂 System Architecture
+
+The project follows a specific folder structure to manage the lifecycle of an improvement:
+
+- `docs/issues/`: The core queue.
+    - `mission.usv`: A prioritized list of issues using Unit Separator Value (`\x1f`) format. This serves as the source of truth for task priority.
+    - `datapackage.json`: Frictionless Data metadata for the `mission.usv` schema.
+    - `pending/`: New issues awaiting triage or assignment.
+    - `draft/`: Issues currently being refined or planned.
+    - `active/`: Issues actively being worked on by an agent.
+    - `completed/{year}/`: Successfully implemented and verified improvements.
+- `.gwt/`: Git Worktree directory where active branches are checked out for isolated agent execution.
+
+## 🛠️ Tooling: `ta` (Task Agent CLI)
+
+The `ta` tool automates the transition of issues through the queue and manages the underlying git infrastructure.
+
+### Commands
+
+| Command | Action |
+| :--- | :--- |
+| `ta next` | Displays the top prioritized issue from `mission.usv`. |
+| `ta new` | Creates a new issue file and adds it to the queue. |
+| `ta done` | Moves issue to `completed/`, removes it from the queue, and auto-commits the result. |
+| `ta start <slug>` | Moves issue to `active/`, creates a git branch, and sets up a `.gwt/` worktree. |
+| `ta run <slug>` | Invokes the sidecar worker defined at `.ta/worker` to process an active issue. |
+
+## 🚀 Workflow
+
+1. **Prioritize**: Use `ta new -t "Title"` to add a task.
+2. **Review**: Run `ta next` to see what is currently at the top of the queue.
+3. **Dispatch**: (Planned) Run `ta start <slug>` to prepare the workspace.
+4. **Execute**: (Planned) The agent (Gemini CLI) processes the task in its isolated worktree via `ta run <slug>`.
+5. **Finalize**: Once verified, `ta done` moves the task to the finished state.
+
+## 🤖 Multi-Agent CLI Portfolio (`multi-agent-registry`)
+
+`task-agent` integrates with [`multi-agent-registry`](https://github.com/InTEGr8or/multi-agent-registry) (`multi_agent_registry`) to automatically detect, configure, and inspect AI agent CLIs across your developer workstation:
+
+- **Supported Agent CLIs**: Claude Code (`claude`), Antigravity CLI (`agy`), OpenCode (`opencode`), Grok Build (`grok`), GitHub Copilot CLI (`copilot`), Cursor (`cursor`), Windsurf (`windsurf`), Aider (`aider`), Continue (`continue`), Cline (`cline`), Roo Code (`roo`).
+- **Features**: Automatic CLI detection, MCP configuration generation (`ta init-mcp`), session discovery, recent agent activity tracking (`ta agent recent`), and plugin management.
+
+---
+
+## 💬 Matrix Messaging Integration & Sidecar Daemon
+
+`task-agent` includes a zero-dependency Matrix sidecar bridge daemon ([`sidecars/matrix-bridge/`](file:///home/mstouffer/repos/task-agent/sidecars/matrix-bridge/)) for real-time remote notification and task chat bridging:
+
+- **Global Space & Store Binding**:
+  ```bash
+  # Configure machine-wide Matrix Space link
+  ta store matrix space set 'https://matrix.to/#/!space_id:matrix.org'
+
+  # Configure secret token reference (1Password op://, Linux keyring secret-tool://, or pass://)
+  ta store matrix token set 'op://Private/6pcab3dt5sml3sslfh6xffqit4/Saved on account.matrix.org/access-token'
+  ```
+- **Automated Space & Child Room Provisioning**:
+  When launched, the sidecar daemon (`python3 sidecars/matrix-bridge/matrix_bridge.py`) auto-discovers or provisions unencrypted child rooms inside your Space for each repository store and delivers real-time inbox comments.
+

{task_agent-1.3.3 → task_agent-1.3.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "task-agent"
-version = "1.3.3"
+version = "1.3.8"
 description = "A prioritized, file-based task queue for autonomous agentic workers"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -8,6 +8,28 @@ authors = [
     { name = "Mark Stouffer", email = "1802850+InTEGr8or@users.noreply.github.com" }
 ]
 license = { text = "MIT" }
+keywords = [
+    "task-agent",
+    "ai-agent",
+    "multi-agent",
+    "mcp",
+    "model-context-protocol",
+    "agentic-workflow",
+    "claude-code",
+    "antigravity",
+    "opencode",
+    "grok",
+    "matrix-bridge",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Build Tools",
+]
+
 dependencies = [
     "mcp>=1.26.0,<2.0.0",
     "pydantic>=2.10.6",
@@ -17,13 +39,19 @@ dependencies = [
     "rich>=13.9.4",
     "githubkit>=0.15.5",
     "verkit>=0.1.4",
-    "agent-cli-registry>=0.1.1",
+    "multi-agent-registry>=0.1.0",
     "transitions>=0.9.2",
     "boto3>=1.34.0",
     "google-genai>=0.1.0",
     "pyyaml>=6.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/InTEGr8or/task-agent"
+Repository = "https://github.com/InTEGr8or/task-agent.git"
+Issues = "https://github.com/InTEGr8or/task-agent/issues"
+Documentation = "https://github.com/InTEGr8or/task-agent/blob/main/README.md"
+
 
 [project.scripts]
 ta = "taskagent.cli:main"
@@ -64,7 +92,4 @@ replace = "version = \"{new_version}\""
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 
-[tool.uv.sources]
-verkit = { path = "/home/mstouffer/repos/verkit" }
-
 

task_agent-1.3.8/sidecars/keet-bridge/README.md

@@ -0,0 +1,51 @@
+# Task Agent <-> Keet Bridge Sidecar
+
+This sidecar daemon bridges **Task Agent (`ta`)** store inbox messages (`.task-agent/inbox/unread/`) with **Keet** P2P chat rooms using the **Hyperswarm** DHT protocol.
+
+## Architecture
+
+- **Outbound (Agent → Keet)**: Monitors `.task-agent/inbox/unread/` in real time. When an agent posts a question (`kind="question"` or `kind="ack-request"`), the bridge formats and broadcasts the payload to connected peers in the Keet room.
+- **Inbound (Keet → Agent)**: Listens for incoming P2P chat responses from Keet room participants, writing them as `.msg.md` files into `.task-agent/inbox/unread/`. This immediately unblocks agents waiting on `watch_inbox_mcp` or `watch_inbox`.
+
+## Installation
+
+```bash
+cd sidecars/keet-bridge
+npm install
+```
+
+## Usage
+
+Run the bridge daemon by pointing it to your Keet room invite URI and task-agent store root:
+
+```bash
+node bridge.js --room "keet://chat/<your-room-secret-key>" --repo /path/to/repo
+```
+
+### Options
+
+| Flag | Environment Variable | Default | Description |
+|------|----------------------|---------|-------------|
+| `--room` | `KEET_ROOM_URI` | *(required)* | Keet room URI (`keet://chat/...`) or topic key |
+| `--repo` | `TA_STORE_PATH` | Current Directory (`.`) | Path to target task-agent store root |
+| `--interval` | - | `1000` | Polling frequency in milliseconds for inbox changes |
+| `--moniker` | `TA_STORE_MONIKER` | `keet-bridge` | Moniker identifier for this sidecar node |
+
+## Testing
+
+You can test the flow by running the bridge in one terminal window and using the `ta` CLI in another:
+
+1. **Start the bridge**:
+   ```bash
+   node sidecars/keet-bridge/bridge.js --room "keet://chat/gfouuoztj3z59..." --repo .
+   ```
+
+2. **Send a test question from an agent**:
+   ```bash
+   ta inbox send --repo . --kind question --thread my-task --body "Should we proceed with Option A or B?"
+   ```
+
+3. **Verify unread messages or response delivery**:
+   ```bash
+   ta inbox list
+   ```