phabfive 0.7.1__tar.gz → 0.9.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. phabfive-0.9.0/.github/dependabot.yml +35 -0
  2. {phabfive-0.7.1 → phabfive-0.9.0}/.github/workflows/gitleaks.yml +2 -1
  3. {phabfive-0.7.1 → phabfive-0.9.0}/.github/workflows/release.yml +19 -11
  4. {phabfive-0.7.1 → phabfive-0.9.0}/.github/workflows/tox.yml +5 -3
  5. phabfive-0.9.0/.pre-commit-config.yaml +101 -0
  6. {phabfive-0.7.1 → phabfive-0.9.0}/AGENTS.md +52 -9
  7. {phabfive-0.7.1 → phabfive-0.9.0}/CHANGELOG.md +96 -0
  8. {phabfive-0.7.1 → phabfive-0.9.0}/Dockerfile +1 -1
  9. {phabfive-0.7.1 → phabfive-0.9.0}/LICENSE +1 -12
  10. {phabfive-0.7.1 → phabfive-0.9.0}/PKG-INFO +44 -28
  11. {phabfive-0.7.1 → phabfive-0.9.0}/README.md +37 -24
  12. phabfive-0.9.0/docs/edit-cli.md +615 -0
  13. {phabfive-0.7.1 → phabfive-0.9.0}/docs/index.md +2 -0
  14. phabfive-0.9.0/phabfive/cli/__init__.py +250 -0
  15. phabfive-0.9.0/phabfive/cli/completers.py +269 -0
  16. phabfive-0.9.0/phabfive/cli/diffusion.py +200 -0
  17. phabfive-0.9.0/phabfive/cli/edit.py +128 -0
  18. phabfive-0.9.0/phabfive/cli/maniphest.py +709 -0
  19. phabfive-0.9.0/phabfive/cli/passphrase.py +51 -0
  20. phabfive-0.9.0/phabfive/cli/paste.py +622 -0
  21. phabfive-0.9.0/phabfive/cli/repl.py +33 -0
  22. phabfive-0.9.0/phabfive/cli/user.py +44 -0
  23. phabfive-0.9.0/phabfive/constants.py +165 -0
  24. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/core.py +200 -20
  25. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/diffusion/core.py +13 -3
  26. phabfive-0.9.0/phabfive/display.py +577 -0
  27. phabfive-0.9.0/phabfive/edit/__init__.py +6 -0
  28. phabfive-0.9.0/phabfive/edit/batch.py +132 -0
  29. phabfive-0.9.0/phabfive/edit/core.py +362 -0
  30. phabfive-0.9.0/phabfive/edit/formatters.py +66 -0
  31. phabfive-0.9.0/phabfive/edit/validators.py +85 -0
  32. phabfive-0.9.0/phabfive/editor.py +136 -0
  33. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/core.py +753 -27
  34. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/fetchers.py +87 -0
  35. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/formatters.py +22 -0
  36. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/resolvers.py +3 -1
  37. phabfive-0.9.0/phabfive/passphrase.py +137 -0
  38. phabfive-0.9.0/phabfive/passphrase_display.py +198 -0
  39. phabfive-0.9.0/phabfive/paste/__init__.py +6 -0
  40. phabfive-0.9.0/phabfive/paste/core.py +335 -0
  41. phabfive-0.9.0/phabfive/repl.py +44 -0
  42. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/setup.py +127 -97
  43. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/transitions/base.py +4 -4
  44. phabfive-0.9.0/phabfive/yaml_utils.py +66 -0
  45. phabfive-0.9.0/pyproject.toml +60 -0
  46. phabfive-0.9.0/tests/test_arcconfig.py +171 -0
  47. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_arcrc.py +152 -4
  48. phabfive-0.9.0/tests/test_edit.py +751 -0
  49. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_maniphest.py +124 -37
  50. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_phabfive.py +2 -2
  51. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_setup.py +187 -28
  52. phabfive-0.9.0/uv.lock +1183 -0
  53. phabfive-0.7.1/.github/dependabot.yml +0 -9
  54. phabfive-0.7.1/.pre-commit-config.yaml +0 -90
  55. phabfive-0.7.1/MANIFEST.in +0 -3
  56. phabfive-0.7.1/phabfive/cli.py +0 -1318
  57. phabfive-0.7.1/phabfive/constants.py +0 -56
  58. phabfive-0.7.1/phabfive/passphrase.py +0 -69
  59. phabfive-0.7.1/phabfive/paste.py +0 -127
  60. phabfive-0.7.1/phabfive/repl.py +0 -29
  61. phabfive-0.7.1/pyproject.toml +0 -71
  62. phabfive-0.7.1/uv.lock +0 -1068
  63. {phabfive-0.7.1 → phabfive-0.9.0}/.editorconfig +0 -0
  64. {phabfive-0.7.1 → phabfive-0.9.0}/.flake8 +0 -0
  65. {phabfive-0.7.1 → phabfive-0.9.0}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  66. {phabfive-0.7.1 → phabfive-0.9.0}/.github/ISSUE_TEMPLATE/documentation_change.md +0 -0
  67. {phabfive-0.7.1 → phabfive-0.9.0}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  68. {phabfive-0.7.1 → phabfive-0.9.0}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  69. {phabfive-0.7.1 → phabfive-0.9.0}/.gitignore +0 -0
  70. {phabfive-0.7.1 → phabfive-0.9.0}/.gitleaksignore +0 -0
  71. {phabfive-0.7.1 → phabfive-0.9.0}/.mailmap +0 -0
  72. {phabfive-0.7.1 → phabfive-0.9.0}/.readthedocs.yaml +0 -0
  73. {phabfive-0.7.1 → phabfive-0.9.0}/.travis.yml +0 -0
  74. {phabfive-0.7.1 → phabfive-0.9.0}/.vscode/settings.json +0 -0
  75. {phabfive-0.7.1 → phabfive-0.9.0}/.yamllint.yml +0 -0
  76. {phabfive-0.7.1 → phabfive-0.9.0}/CLAUDE.md +0 -0
  77. {phabfive-0.7.1 → phabfive-0.9.0}/Dockerfile.phorge +0 -0
  78. {phabfive-0.7.1 → phabfive-0.9.0}/Makefile +0 -0
  79. {phabfive-0.7.1 → phabfive-0.9.0}/compose.yml +0 -0
  80. {phabfive-0.7.1 → phabfive-0.9.0}/docs/create-templates.md +0 -0
  81. {phabfive-0.7.1 → phabfive-0.9.0}/docs/development.md +0 -0
  82. {phabfive-0.7.1 → phabfive-0.9.0}/docs/maniphest-cli.md +0 -0
  83. {phabfive-0.7.1 → phabfive-0.9.0}/docs/maniphest-show.png +0 -0
  84. {phabfive-0.7.1 → phabfive-0.9.0}/docs/phorge-setup.md +0 -0
  85. {phabfive-0.7.1 → phabfive-0.9.0}/docs/releasing.md +0 -0
  86. {phabfive-0.7.1 → phabfive-0.9.0}/docs/search-templates.md +0 -0
  87. {phabfive-0.7.1 → phabfive-0.9.0}/mkdocs.yml +0 -0
  88. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/__init__.py +0 -0
  89. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/diffusion/__init__.py +0 -0
  90. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/diffusion/fetchers.py +0 -0
  91. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/diffusion/formatters.py +0 -0
  92. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/diffusion/resolvers.py +0 -0
  93. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/diffusion/validators.py +0 -0
  94. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/exceptions.py +0 -0
  95. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/__init__.py +0 -0
  96. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/filters.py +0 -0
  97. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/utils.py +0 -0
  98. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/maniphest/validators.py +0 -0
  99. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/project_filters.py +0 -0
  100. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/transitions/__init__.py +0 -0
  101. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/transitions/column.py +0 -0
  102. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/transitions/priority.py +0 -0
  103. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/transitions/status.py +0 -0
  104. {phabfive-0.7.1 → phabfive-0.9.0}/phabfive/user.py +0 -0
  105. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/entrypoint.sh +0 -0
  106. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/init-phorge.sh +0 -0
  107. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/lib/common.sh +0 -0
  108. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/lib/setup-auth.sh +0 -0
  109. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/lib/setup-projects.sh +0 -0
  110. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/lib/setup-tokens.sh +0 -0
  111. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/lib/setup-users.sh +0 -0
  112. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/phabfive +0 -0
  113. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/phorge.conf +0 -0
  114. {phabfive-0.7.1 → phabfive-0.9.0}/phorge/phorge.ini +0 -0
  115. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-create/mega-2024-simulation.yml +0 -0
  116. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-create/test-template-v2.yml +0 -0
  117. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-create/test-template.yaml +0 -0
  118. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/blocked-tasks.yaml +0 -0
  119. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/development-workflow-audit.yaml +0 -0
  120. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/escalated-priorities.yaml +0 -0
  121. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/high-priority-stale-tasks.yaml +0 -0
  122. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/project-status-overview.yaml +0 -0
  123. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/recently-moved-to-review.yaml +0 -0
  124. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/tasks-resolved-but-not-in-done.yaml +0 -0
  125. {phabfive-0.7.1 → phabfive-0.9.0}/templates/task-search/team-productivity-report.yaml +0 -0
  126. {phabfive-0.7.1 → phabfive-0.9.0}/tests/__init__.py +0 -0
  127. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_constants.py +0 -0
  128. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_priority_transitions.py +0 -0
  129. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_project_filters.py +0 -0
  130. {phabfive-0.7.1 → phabfive-0.9.0}/tests/test_status_transitions.py +0 -0
  131. {phabfive-0.7.1 → phabfive-0.9.0}/tox.ini +0 -0
@@ -0,0 +1,35 @@
1
+ # To get started with Dependabot version updates, you'll need to specify which
2
+ # package ecosystems to update and where the package manifests are located.
3
+ # Please see the documentation for all configuration options:
4
+ # https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
5
+ ---
6
+ version: 2
7
+ updates:
8
+ - package-ecosystem: "uv"
9
+ # Look for `uv.lock` files in the `root` directory
10
+ directory: "/" # Location of package manifests
11
+ schedule:
12
+ interval: "weekly"
13
+
14
+ # Enable version updates for Docker
15
+ - package-ecosystem: "docker"
16
+ # Look for a `Dockerfile` in the `root` directory
17
+ directory: "/"
18
+ # Check for updates once a week
19
+ schedule:
20
+ interval: "weekly"
21
+
22
+ # Enable version updates for GitHub Actions
23
+ - package-ecosystem: "github-actions"
24
+ # Workflow files stored in the default location of `.github/workflows`
25
+ # You don't need to specify `/.github/workflows` for `directory`. You can use `directory: "/"`.
26
+ directory: "/"
27
+ schedule:
28
+ interval: "weekly"
29
+
30
+ # Enable version updates for pre-commit
31
+ - package-ecosystem: "pre-commit"
32
+ # Look for `.pre-commit-config.yaml` files in the `root` directory
33
+ directory: "/" # Location of package manifests
34
+ schedule:
35
+ interval: "weekly"
@@ -10,8 +10,9 @@ jobs:
10
10
  scan:
11
11
  name: gitleaks
12
12
  runs-on: ubuntu-latest
13
+ if: github.actor != 'dependabot[bot]'
13
14
  steps:
14
- - uses: actions/checkout@v3
15
+ - uses: actions/checkout@v6
15
16
  with:
16
17
  fetch-depth: 0
17
18
  - uses: gitleaks/gitleaks-action@v2
@@ -16,10 +16,10 @@ jobs:
16
16
  runs-on: ubuntu-latest
17
17
  steps:
18
18
  - name: Checkout repository
19
- uses: actions/checkout@v4
19
+ uses: actions/checkout@v6
20
20
 
21
21
  - name: Install uv
22
- uses: astral-sh/setup-uv@v6
22
+ uses: astral-sh/setup-uv@v7
23
23
  with:
24
24
  enable-cache: true
25
25
 
@@ -30,7 +30,7 @@ jobs:
30
30
  run: uv build
31
31
 
32
32
  - name: Upload distribution artifacts
33
- uses: actions/upload-artifact@v4
33
+ uses: actions/upload-artifact@v7
34
34
  with:
35
35
  name: python-package-distributions
36
36
  path: dist/
@@ -80,14 +80,14 @@ jobs:
80
80
  skip_signing: true
81
81
  steps:
82
82
  - name: Checkout repository
83
- uses: actions/checkout@v4
83
+ uses: actions/checkout@v6
84
84
 
85
85
  - name: Install Cosign
86
86
  if: ${{ !matrix.skip_signing }}
87
87
  uses: sigstore/cosign-installer@v3
88
88
 
89
89
  - name: Set up Python
90
- uses: actions/setup-python@v5
90
+ uses: actions/setup-python@v6
91
91
  with:
92
92
  python-version: "3.12"
93
93
 
@@ -100,12 +100,20 @@ jobs:
100
100
  - name: Build executable
101
101
  shell: bash
102
102
  run: |
103
- pyinstaller --onefile --name phabfive phabfive/cli.py \
103
+ echo "from phabfive.cli import cli_entrypoint; cli_entrypoint()" > _entry.py
104
+ pyinstaller --onefile --name phabfive _entry.py \
104
105
  --collect-data rich \
105
106
  --copy-metadata rich \
106
107
  --collect-data phabricator \
107
108
  --hidden-import phabricator \
108
109
  --hidden-import anyconfig.backend.yaml \
110
+ --hidden-import phabfive.cli.maniphest \
111
+ --hidden-import phabfive.cli.diffusion \
112
+ --hidden-import phabfive.cli.passphrase \
113
+ --hidden-import phabfive.cli.paste \
114
+ --hidden-import phabfive.cli.user \
115
+ --hidden-import phabfive.cli.repl \
116
+ --hidden-import phabfive.cli.completers \
109
117
  --exclude-module mkdocs
110
118
 
111
119
  - name: Rename artifact
@@ -122,7 +130,7 @@ jobs:
122
130
 
123
131
  - name: Upload executable and signature
124
132
  if: ${{ !matrix.skip_signing }}
125
- uses: actions/upload-artifact@v4
133
+ uses: actions/upload-artifact@v7
126
134
  with:
127
135
  name: ${{ matrix.asset_name }}
128
136
  path: |
@@ -131,7 +139,7 @@ jobs:
131
139
 
132
140
  - name: Upload executable (unsigned)
133
141
  if: ${{ matrix.skip_signing }}
134
- uses: actions/upload-artifact@v4
142
+ uses: actions/upload-artifact@v7
135
143
  with:
136
144
  name: ${{ matrix.asset_name }}
137
145
  path: dist/${{ matrix.asset_name }}
@@ -148,7 +156,7 @@ jobs:
148
156
  id-token: write
149
157
  steps:
150
158
  - name: Download distribution artifacts
151
- uses: actions/download-artifact@v4
159
+ uses: actions/download-artifact@v8
152
160
  with:
153
161
  name: python-package-distributions
154
162
  path: dist/
@@ -165,10 +173,10 @@ jobs:
165
173
  contents: write
166
174
  steps:
167
175
  - name: Checkout repository
168
- uses: actions/checkout@v4
176
+ uses: actions/checkout@v6
169
177
 
170
178
  - name: Download all artifacts
171
- uses: actions/download-artifact@v4
179
+ uses: actions/download-artifact@v8
172
180
  with:
173
181
  path: artifacts/
174
182
 
@@ -24,10 +24,10 @@ jobs:
24
24
 
25
25
  steps:
26
26
  - name: Check out repository code
27
- uses: actions/checkout@v5
27
+ uses: actions/checkout@v6
28
28
 
29
29
  - name: Install uv
30
- uses: astral-sh/setup-uv@v6
30
+ uses: astral-sh/setup-uv@v7
31
31
  with:
32
32
  enable-cache: true
33
33
 
@@ -42,4 +42,6 @@ jobs:
42
42
 
43
43
  - name: Run linting (Python 3.13 only)
44
44
  if: matrix.python-version == '3.13' && matrix.os == 'ubuntu-latest'
45
- run: uv run flake8 phabfive/ tests/
45
+ run: |
46
+ uv run ruff check phabfive/ tests/
47
+ uv run ruff format --check phabfive/ tests/
@@ -0,0 +1,101 @@
1
+ ---
2
+ exclude: |
3
+ (?x)
4
+ # You don't usually want a bot to modify your legal texts
5
+ (LICENSE.*|COPYING.*)
6
+
7
+ repos:
8
+ - repo: https://github.com/pre-commit/pre-commit-hooks
9
+ rev: v6.0.0
10
+ hooks:
11
+ - id: check-added-large-files
12
+ exclude: uv.lock
13
+ - id: check-ast
14
+ - id: check-builtin-literals
15
+ - id: check-case-conflict
16
+ - id: check-docstring-first
17
+ - id: check-executables-have-shebangs
18
+ - id: check-illegal-windows-names
19
+ - id: check-json
20
+ - id: check-merge-conflict
21
+ - id: check-shebang-scripts-are-executable
22
+ - id: check-symlinks
23
+ - id: check-toml
24
+ - id: check-xml
25
+ - id: check-yaml
26
+ args: [--allow-multiple-documents]
27
+ - id: debug-statements
28
+ exclude: phabfive/repl.py
29
+ - id: destroyed-symlinks
30
+ - id: detect-aws-credentials
31
+ args: [--allow-missing-credentials]
32
+ - id: detect-private-key
33
+ - id: end-of-file-fixer
34
+ exclude: |
35
+ (?x)
36
+ .drawio.svg|
37
+ .excalidraw.svg|
38
+ WHEEL
39
+ # - id: fix-byte-order-marker
40
+ # - id: forbid-new-submodules
41
+ - id: mixed-line-ending
42
+ args: [--fix=no]
43
+ - id: requirements-txt-fixer
44
+ - id: trailing-whitespace
45
+ args: [--markdown-linebreak-ext=md]
46
+ exclude: .patch
47
+
48
+ - repo: https://github.com/astral-sh/uv-pre-commit
49
+ rev: 0.11.8
50
+ hooks:
51
+ - id: uv-lock
52
+
53
+ - repo: https://github.com/astral-sh/ruff-pre-commit
54
+ rev: v0.15.12
55
+ hooks:
56
+ - id: ruff-check
57
+ args: [--fix]
58
+ - id: ruff-format
59
+
60
+ - repo: https://github.com/ComPWA/taplo-pre-commit
61
+ rev: v0.9.3
62
+ hooks:
63
+ - id: taplo-lint
64
+ name: lint TOML (taplo)
65
+ - id: taplo-format
66
+ name: format TOML (taplo)
67
+
68
+ - repo: https://github.com/adrienverge/yamllint.git
69
+ rev: v1.38.0
70
+ hooks:
71
+ - id: yamllint
72
+ name: lint YAML
73
+ args: ["-d {rules: {line-length: disable}}", "-s"]
74
+ exclude: pnpm-lock.yaml
75
+
76
+ - repo: https://github.com/pre-commit/pygrep-hooks
77
+ rev: v1.10.0
78
+ hooks:
79
+ - id: python-check-blanket-noqa
80
+ - id: python-check-blanket-type-ignore
81
+ - id: python-use-type-annotations
82
+ - id: python-no-eval
83
+ # - id: text-unicode-replacement-char
84
+
85
+ - repo: https://github.com/pre-commit/mirrors-mypy
86
+ rev: v1.20.2
87
+ hooks:
88
+ - id: mypy
89
+ stages: [manual]
90
+ files: ^(app/|cli/|lib/).*\.py$
91
+ args: []
92
+ additional_dependencies:
93
+ - pytest
94
+ - types-boto3
95
+ - types-click
96
+
97
+ - repo: https://github.com/abravalheri/validate-pyproject
98
+ rev: v0.25
99
+ hooks:
100
+ - id: validate-pyproject
101
+ additional_dependencies: ["validate-pyproject-schema-store[all]"]
@@ -21,27 +21,41 @@ uv run pytest tests/test_foo.py # run single test file
21
21
  uv run pytest -k test_name # run specific test
22
22
  uv run tox # test all Python versions (3.10-3.14)
23
23
 
24
- # Lint
25
- uv run flake8 phabfive/ tests/
24
+ # Lint and format
25
+ uv run ruff check phabfive/ tests/
26
+ uv run ruff format phabfive/ tests/
26
27
 
27
28
  # Local Phorge instance for testing
28
29
  make up # start local Phorge
29
30
  make down # stop containers
30
31
 
31
32
  # Merge PRs (rebase only - merge and squash are disabled)
32
- gh pr merge --rebase
33
+ gh pr merge --rebase --delete-branch
33
34
  ```
34
35
 
36
+ ## Pre-commit Checks
37
+
38
+ **Always run before committing:**
39
+
40
+ ```bash
41
+ uv run ruff check phabfive/ tests/
42
+ uv run ruff format phabfive/ tests/
43
+ ```
44
+
45
+ CI will fail if files are not properly formatted.
46
+
35
47
  ## Architecture
36
48
 
37
- ### CLI Layer (`cli.py`)
38
- - Uses `docopt-ng` for argument parsing with docstring-based CLI definitions
39
- - Monogram shortcuts allow direct access: `phabfive T123` expands to `phabfive maniphest show T123`
40
- - Entry point: `cli_entrypoint()` → `parse_cli()`
49
+ ### CLI Layer (`cli/`)
50
+ - Uses `typer` for argument parsing with built-in shell completion
51
+ - Modular structure: `__init__.py` (main app), `maniphest.py`, `diffusion.py`, `paste.py`, `user.py`, `passphrase.py`, `repl.py`
52
+ - Monogram shortcuts via `preprocess_monograms()`: `phabfive T123` expands to `phabfive maniphest show T123`
53
+ - Entry point: `cli_entrypoint()`
54
+ - Shell completion: `phabfive --install-completion bash|zsh|fish`
41
55
 
42
56
  ### Core Layer (`core.py`)
43
57
  - `Phabfive` class: central configuration and API client management
44
- - Loads config from environment variables or `~/.config/phabfive.yaml`
58
+ - Loads config from `.arcconfig`, `~/.arcrc`, `~/.config/phabfive.yaml`, and environment variables
45
59
  - Uses the `phabricator` library for Conduit API calls
46
60
  - Output formatting: supports `rich` (terminal), `yaml`, and `strict` (machine-readable) modes
47
61
 
@@ -59,7 +73,36 @@ Complex features use a consistent subpackage structure:
59
73
  - `transitions/` - state machine for task status/priority/column changes
60
74
 
61
75
  ### Configuration
62
- Required: `PHAB_TOKEN` and `PHAB_URL` (via environment or config file)
76
+
77
+ Required: `PHAB_TOKEN` and `PHAB_URL`
78
+
79
+ Config precedence (later overrides earlier):
80
+ 1. Hard-coded defaults
81
+ 2. `/etc/phabfive.yaml`
82
+ 3. `/etc/phabfive.d/*.yaml`
83
+ 4. `~/.config/phabfive.yaml` (PHAB_URL/PHAB_TOKEN deprecated here, use for PHAB_SPACE/PHAB_FALLBACK/PHABFIVE_DEBUG)
84
+ 5. `~/.config/phabfive.d/*.yaml`
85
+ 6. `.arcconfig` in git root (provides PHAB_URL from `phabricator.uri`)
86
+ 7. `~/.arcrc` (provides PHAB_TOKEN for matched URL)
87
+ 8. Environment variables
88
+
89
+ ## AI Agent Usage
90
+
91
+ Use `--format=yaml` or `--format=json` for machine-readable output:
92
+
93
+ ```bash
94
+ # Get task details as YAML
95
+ phabfive --format=yaml T123
96
+
97
+ # Get task details as JSON
98
+ phabfive --format=json T123
99
+
100
+ # Search tasks with structured output
101
+ phabfive --format=json maniphest search --tag=projectname
102
+
103
+ # Pipe JSON to jq
104
+ phabfive --format=json T123 | jq '.Task.Title'
105
+ ```
63
106
 
64
107
  ## Version Management
65
108
 
@@ -1,3 +1,99 @@
1
+ # 0.9.0 (2026-05-04)
2
+
3
+ ## Prelude
4
+
5
+ This release completes the unified create/edit command UX for both Maniphest and Paste applications. Single task creation is now feature complete with consistent patterns across all object types.
6
+
7
+ ## New Features
8
+
9
+ ### Unified Edit Command
10
+ * **Batch editing** - Edit multiple tasks at once with comma-separated IDs (e.g., `phabfive maniphest edit T123,T124,T125 --status=resolved`)
11
+ * **Description editing** - New `--description` option with `$EDITOR` support, unified diff display, and confirmation prompts
12
+ * **Title editing** - Positional title argument for quick renames (e.g., `phabfive maniphest edit T123 "New Title"`) with diff display
13
+ * **Subscriber management** - New `--subscribe` option to add subscribers during edit (`--subscribe=@me`)
14
+ * **Diff confirmation** - All text changes (title, description, content) show unified diffs and prompt for confirmation
15
+
16
+ ### Shell Completion Enhancements
17
+ * **Context-aware column completion** - `--column` completion fetches actual column names from the board specified by `--tag`
18
+ * **Tag completion** - `--tag` option now completes project names from API
19
+ * **Pattern prefix support** - Completions support filter prefixes like `in:`, `not:in:`, `from:`, `to:`
20
+
21
+ ### Paste App Modernization
22
+ * **Edit command** - New `phabfive paste edit P1` with `--content`, `--language`, `--tag`, `--subscribe` options
23
+ * **Comment command** - New `phabfive paste comment P1 "text"` for adding comments
24
+ * **Free-text search** - `phabfive paste search "query"` searches paste titles
25
+ * **Positional title** - Quick title changes with `phabfive paste edit P1 "New Title"`
26
+
27
+ ### UX Improvements
28
+ * **Unified dry-run output** - Consistent `[DRY RUN]` format across create and edit commands
29
+ * **Editor temp file prefixes** - Temp files use descriptive prefixes (e.g., `description-T123.remarkup`)
30
+ * **Graceful error handling** - API connection errors show clean messages without tracebacks
31
+
32
+ ## Bug Fixes
33
+
34
+ * Fix priority value comparison using shared constants
35
+ * Handle statusMap values that can be strings or dicts
36
+ * Remove traceback output for user-facing errors
37
+
38
+ ## Other Notes
39
+
40
+ * Restructured `edit.py` into `edit/` package for better organization
41
+ * Removed deprecated `paste list` command (use `paste search` instead)
42
+ * Added pre-commit checks documentation to AGENTS.md
43
+ * Various dependency updates via Dependabot
44
+
45
+
46
+ # 0.8.0 (2026-03-30)
47
+
48
+ ## Prelude
49
+
50
+ 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.
51
+
52
+ ## Upgrade Notes
53
+
54
+ * **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.
55
+ * **CLI framework migrated from docopt-ng to Typer** - Command syntax is unchanged, but help output and error messages may differ.
56
+ * **`--format=strict` renamed to `--format=yaml`** - The `strict` alias is still accepted for backwards compatibility.
57
+
58
+ ## New Features
59
+
60
+ ### CLI & Shell Completion
61
+ * **Typer-based CLI** - Migrated from docopt-ng to Typer for better argument parsing, type safety, and help output
62
+ * **Smart shell completion** - Tab completion for `--priority`, `--status`, `--column` values, and all other option values
63
+ * **JSON output format** - New `--format=json` option for machine-readable output
64
+
65
+ ### Maniphest Enhancements
66
+ * **Multi-task show** - `maniphest show` now accepts multiple task IDs (e.g., `phabfive maniphest show T123 T456`)
67
+ * **Parents and subtasks** - New `maniphest parents` and `maniphest subtasks` commands, plus Parents/Subtasks fields in task output
68
+ * **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
69
+
70
+ ### Configuration
71
+ * **Arcanist-compatible configuration** - Reads credentials from `.arcrc` files, compatible with Arcanist/Phorge tooling
72
+ * **Interactive server selector** - When multiple hosts are configured in `.arcrc`, presents an interactive selection prompt
73
+
74
+ ### Other
75
+ * **Passphrase structured output** - `passphrase show` now outputs structured data
76
+ * **Optional ptpython REPL** - Enhanced REPL experience when ptpython is installed
77
+
78
+ ## Bug Fixes
79
+
80
+ * Fix JSON output producing invalid JSON array for multiple tasks
81
+ * Fix monogram shortcuts not working with global options
82
+ * Improve error handling and standardize error format
83
+ * Fix passphrase show subcommand for monogram shortcuts
84
+ * Fix PyInstaller entry point for Typer CLI package structure
85
+ * Fix insecure temp file reuse vulnerability in requests (upgrade to 2.33.0)
86
+
87
+ ## Other Notes
88
+
89
+ * Replaced flake8 with ruff for linting
90
+ * Updated license to SPDX identifier format
91
+ * Removed unused MANIFEST.in
92
+ * Updated pre-commit hooks
93
+ * Cleaned up constants.py
94
+ * Added `exclude-newer` to `[tool.uv]` for supply chain protection
95
+
96
+
1
97
  # 0.7.1 (2026-03-07)
2
98
 
3
99
  ## Bug Fixes
@@ -1,4 +1,4 @@
1
- FROM alpine:3.22
1
+ FROM alpine:3.23
2
2
 
3
3
  # Install terminfo database for proper terminal support
4
4
  RUN apk add --no-cache ncurses-terminfo-base
@@ -175,18 +175,7 @@
175
175
 
176
176
  END OF TERMS AND CONDITIONS
177
177
 
178
- APPENDIX: How to apply the Apache License to your work.
179
-
180
- To apply the Apache License to your work, attach the following
181
- boilerplate notice, with the fields enclosed by brackets "[]"
182
- replaced with your own identifying information. (Don't include
183
- the brackets!) The text should be enclosed in the appropriate
184
- comment syntax for the file format. We also recommend that a
185
- file or class name and description of purpose be included on the
186
- same "printed page" as the copyright notice for easier
187
- identification within third-party archives.
188
-
189
- Copyright [yyyy] [name of copyright owner]
178
+ Copyright 2026 Dynamist AB
190
179
 
191
180
  Licensed under the Apache License, Version 2.0 (the "License");
192
181
  you may not use this file except in compliance with the License.
@@ -1,11 +1,11 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: phabfive
3
- Version: 0.7.1
3
+ Version: 0.9.0
4
4
  Summary: CLI for Phabricator and Phorge - built for humans and AI agents
5
5
  Project-URL: Homepage, https://github.com/dynamist/phabfive
6
6
  Project-URL: Download, https://github.com/dynamist/phabfive/releases
7
7
  Author-email: Rickard Eriksson <rickard@dynamist.se>
8
- License: Apache License 2.0
8
+ License: Apache-2.0
9
9
  License-File: LICENSE
10
10
  Classifier: Development Status :: 4 - Beta
11
11
  Classifier: Environment :: Console
@@ -23,20 +23,23 @@ Classifier: Programming Language :: Python :: 3.14
23
23
  Requires-Python: >=3.10
24
24
  Requires-Dist: anyconfig>=0.10.0
25
25
  Requires-Dist: appdirs
26
- Requires-Dist: docopt-ng
26
+ Requires-Dist: inquirerpy>=0.3.4
27
27
  Requires-Dist: jinja2
28
28
  Requires-Dist: mkdocs>=1.6.1
29
29
  Requires-Dist: phabricator
30
30
  Requires-Dist: pyyaml
31
31
  Requires-Dist: rich>=13.0.0
32
32
  Requires-Dist: ruamel-yaml>=0.18.16
33
+ Requires-Dist: typer[all]>=0.12.0
33
34
  Provides-Extra: docs
34
35
  Requires-Dist: mkdocs; extra == 'docs'
36
+ Provides-Extra: repl
37
+ Requires-Dist: ptpython; extra == 'repl'
35
38
  Provides-Extra: test
36
39
  Requires-Dist: coverage; extra == 'test'
37
- Requires-Dist: flake8; extra == 'test'
38
40
  Requires-Dist: pytest; extra == 'test'
39
41
  Requires-Dist: pytest-cov; extra == 'test'
42
+ Requires-Dist: ruff; extra == 'test'
40
43
  Description-Content-Type: text/markdown
41
44
 
42
45
  # phabfive
@@ -54,6 +57,7 @@ A summary of the currently supported features:
54
57
  - **Paste** - List, get, and add pastes
55
58
  - **User** - Get information about the logged-in user
56
59
  - **Maniphest** - Add comments, show task details, create tasks from templates
60
+ - **Edit** - Unified editing with auto-detection, batch operations, and smart column/priority navigation
57
61
 
58
62
  For complete documentation, see [Read the Docs](https://phabfive.readthedocs.io/).
59
63
 
@@ -84,11 +88,39 @@ mise use --global --pin pipx:phabfive
84
88
 
85
89
  ## Quick Start
86
90
 
87
- ### 1. Get an API token
91
+ ```bash
92
+ phabfive user setup
93
+ ```
94
+
95
+ The interactive setup wizard will guide you through connecting to your Phabricator/Phorge instance.
96
+
97
+ Then start using phabfive:
98
+
99
+ ```bash
100
+ phabfive passphrase K123
101
+ phabfive paste list
102
+ phabfive maniphest search "migration tasks" --tag myproject
103
+ phabfive maniphest search --tag myproject --updated-after=1w
104
+
105
+ # Edit tasks with smart navigation
106
+ phabfive edit T123 --priority=raise --status=resolved
107
+ phabfive maniphest search --assigned=@me | phabfive edit --column=Done
108
+ ```
109
+
110
+ ## Shell Completion
111
+
112
+ Enable tab completion for bash, zsh, or fish:
88
113
 
89
- Grab a Phabricator/Phorge token at `https://<yourserver.com>/settings/panel/apitokens/`
114
+ ```bash
115
+ phabfive --install-completion bash
116
+ phabfive --install-completion zsh
117
+ phabfive --install-completion fish
118
+ ```
90
119
 
91
- ### 2. Configure credentials
120
+ After installation, restart your shell or source your profile.
121
+
122
+ <details>
123
+ <summary>Manual configuration (advanced)</summary>
92
124
 
93
125
  **Environment variables:**
94
126
 
@@ -97,34 +129,18 @@ export PHAB_TOKEN=cli-ABC123
97
129
  export PHAB_URL=https://yourserver.com/api/
98
130
  ```
99
131
 
100
- **Or use a configuration file:**
101
-
102
- ```bash
103
- # Linux/XDG
104
- cat << 'EOF' > ~/.config/phabfive.yaml
105
- PHAB_TOKEN: cli-ABC123
106
- PHAB_URL: https://yourserver.com/api/
107
- EOF
132
+ **Or configuration file** at `~/.config/phabfive.yaml`:
108
133
 
109
- # macOS
110
- cat << 'EOF' > ~/Library/Application\ Support/phabfive.yaml
134
+ ```yaml
111
135
  PHAB_TOKEN: cli-ABC123
112
136
  PHAB_URL: https://yourserver.com/api/
113
- EOF
114
-
115
- # Windows - create at: %LOCALAPPDATA%\phabfive\phabfive.yaml
116
137
  ```
117
138
 
118
- **Note:** On macOS, you can use `~/.config` by setting `export XDG_CONFIG_HOME=~/.config`
139
+ Other config file locations: `~/Library/Application Support/phabfive.yaml` (macOS) or `%LOCALAPPDATA%\phabfive\phabfive.yaml` (Windows).
119
140
 
120
- ### 3. Use phabfive
141
+ **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`
121
142
 
122
- ```bash
123
- phabfive passphrase K123
124
- phabfive paste list
125
- phabfive maniphest search "migration tasks" --tag myproject
126
- phabfive maniphest search --tag myproject --updated-after=1w
127
- ```
143
+ </details>
128
144
 
129
145
  ## Documentation
130
146