phabfive 0.7.0__tar.gz → 0.8.0__tar.gz

{phabfive-0.7.0 → phabfive-0.8.0}/.github/workflows/release.yml

@@ -100,12 +100,20 @@ jobs:
       - name: Build executable
         shell: bash
         run: |
-          pyinstaller --onefile --name phabfive phabfive/cli.py \
+          echo "from phabfive.cli import cli_entrypoint; cli_entrypoint()" > _entry.py
+          pyinstaller --onefile --name phabfive _entry.py \
             --collect-data rich \
             --copy-metadata rich \
             --collect-data phabricator \
             --hidden-import phabricator \
             --hidden-import anyconfig.backend.yaml \
+            --hidden-import phabfive.cli.maniphest \
+            --hidden-import phabfive.cli.diffusion \
+            --hidden-import phabfive.cli.passphrase \
+            --hidden-import phabfive.cli.paste \
+            --hidden-import phabfive.cli.user \
+            --hidden-import phabfive.cli.repl \
+            --hidden-import phabfive.cli.completers \
             --exclude-module mkdocs
 
       - name: Rename artifact

{phabfive-0.7.0 → phabfive-0.8.0}/.github/workflows/tox.yml

@@ -42,4 +42,6 @@ jobs:
 
       - name: Run linting (Python 3.13 only)
         if: matrix.python-version == '3.13' && matrix.os == 'ubuntu-latest'
-        run: uv run flake8 phabfive/ tests/
+        run: |
+          uv run ruff check phabfive/ tests/
+          uv run ruff format --check phabfive/ tests/

phabfive-0.8.0/.pre-commit-config.yaml

@@ -0,0 +1,101 @@
+---
+exclude: |
+  (?x)
+  # You don't usually want a bot to modify your legal texts
+  (LICENSE.*|COPYING.*)
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+        exclude: uv.lock
+      - id: check-ast
+      - id: check-builtin-literals
+      - id: check-case-conflict
+      - id: check-docstring-first
+      - id: check-executables-have-shebangs
+      - id: check-illegal-windows-names
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-shebang-scripts-are-executable
+      - id: check-symlinks
+      - id: check-toml
+      - id: check-xml
+      - id: check-yaml
+        args: [--allow-multiple-documents]
+      - id: debug-statements
+        exclude: phabfive/repl.py
+      - id: destroyed-symlinks
+      - id: detect-aws-credentials
+        args: [--allow-missing-credentials]
+      - id: detect-private-key
+      - id: end-of-file-fixer
+        exclude: |
+          (?x)
+          .drawio.svg|
+          .excalidraw.svg|
+          WHEEL
+      # - id: fix-byte-order-marker
+      # - id: forbid-new-submodules
+      - id: mixed-line-ending
+        args: [--fix=no]
+      - id: requirements-txt-fixer
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+        exclude: .patch
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.9.24
+    hooks:
+      - id: uv-lock
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.10
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/ComPWA/taplo-pre-commit
+    rev: v0.9.3
+    hooks:
+      - id: taplo-lint
+        name: lint TOML (taplo)
+      - id: taplo-format
+        name: format TOML (taplo)
+
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.37.1
+    hooks:
+      - id: yamllint
+        name: lint YAML
+        args: ["-d {rules: {line-length: disable}}", "-s"]
+        exclude: pnpm-lock.yaml
+
+  - repo: https://github.com/pre-commit/pygrep-hooks
+    rev: v1.10.0
+    hooks:
+      - id: python-check-blanket-noqa
+      - id: python-check-blanket-type-ignore
+      - id: python-use-type-annotations
+      - id: python-no-eval
+      # - id: text-unicode-replacement-char
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.19.1
+    hooks:
+      - id: mypy
+        stages: [manual]
+        files: ^(app/|cli/|lib/).*\.py$
+        args: []
+        additional_dependencies:
+          - pytest
+          - types-boto3
+          - types-click
+
+  - repo: https://github.com/abravalheri/validate-pyproject
+    rev: v0.24.1
+    hooks:
+      - id: validate-pyproject
+        additional_dependencies: ["validate-pyproject-schema-store[all]"]

{phabfive-0.7.0 → phabfive-0.8.0}/AGENTS.md

@@ -21,27 +21,30 @@ uv run pytest tests/test_foo.py      # run single test file
 uv run pytest -k test_name           # run specific test
 uv run tox                           # test all Python versions (3.10-3.14)
 
-# Lint
-uv run flake8 phabfive/ tests/
+# Lint and format
+uv run ruff check phabfive/ tests/
+uv run ruff format phabfive/ tests/
 
 # Local Phorge instance for testing
 make up                              # start local Phorge
 make down                            # stop containers
 
 # Merge PRs (rebase only - merge and squash are disabled)
-gh pr merge --rebase
+gh pr merge --rebase --delete-branch
 ```
 
 ## Architecture
 
-### CLI Layer (`cli.py`)
-- Uses `docopt-ng` for argument parsing with docstring-based CLI definitions
-- Monogram shortcuts allow direct access: `phabfive T123` expands to `phabfive maniphest show T123`
-- Entry point: `cli_entrypoint()` → `parse_cli()`
+### CLI Layer (`cli/`)
+- Uses `typer` for argument parsing with built-in shell completion
+- Modular structure: `__init__.py` (main app), `maniphest.py`, `diffusion.py`, `paste.py`, `user.py`, `passphrase.py`, `repl.py`
+- Monogram shortcuts via `preprocess_monograms()`: `phabfive T123` expands to `phabfive maniphest show T123`
+- Entry point: `cli_entrypoint()`
+- Shell completion: `phabfive --install-completion bash|zsh|fish`
 
 ### Core Layer (`core.py`)
 - `Phabfive` class: central configuration and API client management
-- Loads config from environment variables or `~/.config/phabfive.yaml`
+- Loads config from `.arcconfig`, `~/.arcrc`, `~/.config/phabfive.yaml`, and environment variables
 - Uses the `phabricator` library for Conduit API calls
 - Output formatting: supports `rich` (terminal), `yaml`, and `strict` (machine-readable) modes
 
@@ -59,7 +62,36 @@ Complex features use a consistent subpackage structure:
 - `transitions/` - state machine for task status/priority/column changes
 
 ### Configuration
-Required: `PHAB_TOKEN` and `PHAB_URL` (via environment or config file)
+
+Required: `PHAB_TOKEN` and `PHAB_URL`
+
+Config precedence (later overrides earlier):
+1. Hard-coded defaults
+2. `/etc/phabfive.yaml`
+3. `/etc/phabfive.d/*.yaml`
+4. `~/.config/phabfive.yaml` (PHAB_URL/PHAB_TOKEN deprecated here, use for PHAB_SPACE/PHAB_FALLBACK/PHABFIVE_DEBUG)
+5. `~/.config/phabfive.d/*.yaml`
+6. `.arcconfig` in git root (provides PHAB_URL from `phabricator.uri`)
+7. `~/.arcrc` (provides PHAB_TOKEN for matched URL)
+8. Environment variables
+
+## AI Agent Usage
+
+Use `--format=yaml` or `--format=json` for machine-readable output:
+
+```bash
+# Get task details as YAML
+phabfive --format=yaml T123
+
+# Get task details as JSON
+phabfive --format=json T123
+
+# Search tasks with structured output
+phabfive --format=json maniphest search --tag=projectname
+
+# Pipe JSON to jq
+phabfive --format=json T123 | jq '.Task.Title'
+```
 
 ## Version Management
 

{phabfive-0.7.0 → phabfive-0.8.0}/CHANGELOG.md

@@ -1,3 +1,61 @@
+# 0.8.0 (2026-03-30)
+
+## Prelude
+
+Major release featuring a migration from docopt-ng to Typer for the CLI framework, Arcanist-compatible configuration, and numerous new features including shell completion, JSON output, parent/subtask support, and search metadata embedding.
+
+## Upgrade Notes
+
+* **Breaking change:** Configuration now uses Arcanist-compatible `.arcrc` format. Existing `~/.config/phabfive.yaml` configurations need to be migrated. Run `phabfive user setup` for guided setup.
+* **CLI framework migrated from docopt-ng to Typer** - Command syntax is unchanged, but help output and error messages may differ.
+* **`--format=strict` renamed to `--format=yaml`** - The `strict` alias is still accepted for backwards compatibility.
+
+## New Features
+
+### CLI & Shell Completion
+* **Typer-based CLI** - Migrated from docopt-ng to Typer for better argument parsing, type safety, and help output
+* **Smart shell completion** - Tab completion for `--priority`, `--status`, `--column` values, and all other option values
+* **JSON output format** - New `--format=json` option for machine-readable output
+
+### Maniphest Enhancements
+* **Multi-task show** - `maniphest show` now accepts multiple task IDs (e.g., `phabfive maniphest show T123 T456`)
+* **Parents and subtasks** - New `maniphest parents` and `maniphest subtasks` commands, plus Parents/Subtasks fields in task output
+* **Search metadata Query embedding** - `--show-metadata` now includes a `Query` section with original search parameters, enabling downstream tools to access search context without duplicate arguments
+
+### Configuration
+* **Arcanist-compatible configuration** - Reads credentials from `.arcrc` files, compatible with Arcanist/Phorge tooling
+* **Interactive server selector** - When multiple hosts are configured in `.arcrc`, presents an interactive selection prompt
+
+### Other
+* **Passphrase structured output** - `passphrase show` now outputs structured data
+* **Optional ptpython REPL** - Enhanced REPL experience when ptpython is installed
+
+## Bug Fixes
+
+* Fix JSON output producing invalid JSON array for multiple tasks
+* Fix monogram shortcuts not working with global options
+* Improve error handling and standardize error format
+* Fix passphrase show subcommand for monogram shortcuts
+* Fix PyInstaller entry point for Typer CLI package structure
+* Fix insecure temp file reuse vulnerability in requests (upgrade to 2.33.0)
+
+## Other Notes
+
+* Replaced flake8 with ruff for linting
+* Updated license to SPDX identifier format
+* Removed unused MANIFEST.in
+* Updated pre-commit hooks
+* Cleaned up constants.py
+* Added `exclude-newer` to `[tool.uv]` for supply chain protection
+
+
+# 0.7.1 (2026-03-07)
+
+## Bug Fixes
+
+* Fix standalone executables exiting silently without output
+
+
 # 0.7.0 (2026-03-07)
 
 ## Prelude

{phabfive-0.7.0 → phabfive-0.8.0}/LICENSE

@@ -175,18 +175,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2026 Dynamist AB
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{phabfive-0.7.0 → phabfive-0.8.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: phabfive
-Version: 0.7.0
+Version: 0.8.0
 Summary: CLI for Phabricator and Phorge - built for humans and AI agents
 Project-URL: Homepage, https://github.com/dynamist/phabfive
 Project-URL: Download, https://github.com/dynamist/phabfive/releases
 Author-email: Rickard Eriksson <rickard@dynamist.se>
-License: Apache License 2.0
+License: Apache-2.0
 License-File: LICENSE
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -23,20 +23,23 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Requires-Dist: anyconfig>=0.10.0
 Requires-Dist: appdirs
-Requires-Dist: docopt-ng
+Requires-Dist: inquirerpy>=0.3.4
 Requires-Dist: jinja2
 Requires-Dist: mkdocs>=1.6.1
 Requires-Dist: phabricator
 Requires-Dist: pyyaml
 Requires-Dist: rich>=13.0.0
 Requires-Dist: ruamel-yaml>=0.18.16
+Requires-Dist: typer[all]>=0.12.0
 Provides-Extra: docs
 Requires-Dist: mkdocs; extra == 'docs'
+Provides-Extra: repl
+Requires-Dist: ptpython; extra == 'repl'
 Provides-Extra: test
 Requires-Dist: coverage; extra == 'test'
-Requires-Dist: flake8; extra == 'test'
 Requires-Dist: pytest; extra == 'test'
 Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: ruff; extra == 'test'
 Description-Content-Type: text/markdown
 
 # phabfive
@@ -84,11 +87,35 @@ mise use --global --pin pipx:phabfive
 
 ## Quick Start
 
-### 1. Get an API token
+```bash
+phabfive user setup
+```
+
+The interactive setup wizard will guide you through connecting to your Phabricator/Phorge instance.
+
+Then start using phabfive:
+
+```bash
+phabfive passphrase K123
+phabfive paste list
+phabfive maniphest search "migration tasks" --tag myproject
+phabfive maniphest search --tag myproject --updated-after=1w
+```
 
-Grab a Phabricator/Phorge token at `https://<yourserver.com>/settings/panel/apitokens/`
+## Shell Completion
 
-### 2. Configure credentials
+Enable tab completion for bash, zsh, or fish:
+
+```bash
+phabfive --install-completion bash
+phabfive --install-completion zsh
+phabfive --install-completion fish
+```
+
+After installation, restart your shell or source your profile.
+
+<details>
+<summary>Manual configuration (advanced)</summary>
 
 **Environment variables:**
 
@@ -97,34 +124,18 @@ export PHAB_TOKEN=cli-ABC123
 export PHAB_URL=https://yourserver.com/api/
 ```
 
-**Or use a configuration file:**
+**Or configuration file** at `~/.config/phabfive.yaml`:
 
-```bash
-# Linux/XDG
-cat << 'EOF' > ~/.config/phabfive.yaml
+```yaml
 PHAB_TOKEN: cli-ABC123
 PHAB_URL: https://yourserver.com/api/
-EOF
-
-# macOS
-cat << 'EOF' > ~/Library/Application\ Support/phabfive.yaml
-PHAB_TOKEN: cli-ABC123
-PHAB_URL: https://yourserver.com/api/
-EOF
-
-# Windows - create at: %LOCALAPPDATA%\phabfive\phabfive.yaml
 ```
 
-**Note:** On macOS, you can use `~/.config` by setting `export XDG_CONFIG_HOME=~/.config`
+Other config file locations: `~/Library/Application Support/phabfive.yaml` (macOS) or `%LOCALAPPDATA%\phabfive\phabfive.yaml` (Windows).
 
-### 3. Use phabfive
+**Windows SSL certificates:** If you encounter certificate errors, install [pip-system-certs](https://pypi.org/project/pip-system-certs/) to use the Windows certificate store: `pip install pip-system-certs`
 
-```bash
-phabfive passphrase K123
-phabfive paste list
-phabfive maniphest search "migration tasks" --tag myproject
-phabfive maniphest search --tag myproject --updated-after=1w
-```
+</details>
 
 ## Documentation
 

{phabfive-0.7.0 → phabfive-0.8.0}/README.md

@@ -43,11 +43,35 @@ mise use --global --pin pipx:phabfive
 
 ## Quick Start
 
-### 1. Get an API token
+```bash
+phabfive user setup
+```
+
+The interactive setup wizard will guide you through connecting to your Phabricator/Phorge instance.
+
+Then start using phabfive:
+
+```bash
+phabfive passphrase K123
+phabfive paste list
+phabfive maniphest search "migration tasks" --tag myproject
+phabfive maniphest search --tag myproject --updated-after=1w
+```
 
-Grab a Phabricator/Phorge token at `https://<yourserver.com>/settings/panel/apitokens/`
+## Shell Completion
 
-### 2. Configure credentials
+Enable tab completion for bash, zsh, or fish:
+
+```bash
+phabfive --install-completion bash
+phabfive --install-completion zsh
+phabfive --install-completion fish
+```
+
+After installation, restart your shell or source your profile.
+
+<details>
+<summary>Manual configuration (advanced)</summary>
 
 **Environment variables:**
 
@@ -56,34 +80,18 @@ export PHAB_TOKEN=cli-ABC123
 export PHAB_URL=https://yourserver.com/api/
 ```
 
-**Or use a configuration file:**
+**Or configuration file** at `~/.config/phabfive.yaml`:
 
-```bash
-# Linux/XDG
-cat << 'EOF' > ~/.config/phabfive.yaml
+```yaml
 PHAB_TOKEN: cli-ABC123
 PHAB_URL: https://yourserver.com/api/
-EOF
-
-# macOS
-cat << 'EOF' > ~/Library/Application\ Support/phabfive.yaml
-PHAB_TOKEN: cli-ABC123
-PHAB_URL: https://yourserver.com/api/
-EOF
-
-# Windows - create at: %LOCALAPPDATA%\phabfive\phabfive.yaml
 ```
 
-**Note:** On macOS, you can use `~/.config` by setting `export XDG_CONFIG_HOME=~/.config`
+Other config file locations: `~/Library/Application Support/phabfive.yaml` (macOS) or `%LOCALAPPDATA%\phabfive\phabfive.yaml` (Windows).
 
-### 3. Use phabfive
+**Windows SSL certificates:** If you encounter certificate errors, install [pip-system-certs](https://pypi.org/project/pip-system-certs/) to use the Windows certificate store: `pip install pip-system-certs`
 
-```bash
-phabfive passphrase K123
-phabfive paste list
-phabfive maniphest search "migration tasks" --tag myproject
-phabfive maniphest search --tag myproject --updated-after=1w
-```
+</details>
 
 ## Documentation