rh-cli 0.1.0__py3-none-any.whl

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.
@@ -0,0 +1,217 @@
1
+ Metadata-Version: 2.4
2
+ Name: rh-cli
3
+ Version: 0.1.0
4
+ Summary: rh — orchestrate an AI research project end to end from the terminal
5
+ Author-email: Hitaishi V <hitaishi2222@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/hitaishi2222/research-helper
8
+ Project-URL: Repository, https://github.com/hitaishi2222/research-helper
9
+ Project-URL: Issues, https://github.com/hitaishi2222/research-helper/issues
10
+ Project-URL: Roadmap, https://github.com/hitaishi2222/research-helper/blob/main/ROADMAP.md
11
+ Keywords: research,cli,orchestration,agents,skill,literature
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Environment :: Console
14
+ Classifier: Intended Audience :: Science/Research
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Operating System :: OS Independent
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3 :: Only
19
+ Classifier: Topic :: Scientific/Engineering
20
+ Classifier: Topic :: Utilities
21
+ Requires-Python: >=3.9
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Requires-Dist: rich>=13
25
+ Provides-Extra: dev
26
+ Requires-Dist: pytest>=8; extra == "dev"
27
+ Requires-Dist: build>=1; extra == "dev"
28
+ Dynamic: license-file
29
+
30
+ # research-helper
31
+
32
+ **`rh` — orchestrate an AI research project end to end from the terminal.**
33
+
34
+ [![CI](https://github.com/hitaishi2222/research-helper/actions/workflows/ci.yml/badge.svg)](https://github.com/hitaishi2222/research-helper/actions/workflows/ci.yml)
35
+ [![PyPI](https://img.shields.io/pypi/v/rh-cli.svg)](https://pypi.org/project/rh-cli/)
36
+ [![Python](https://img.shields.io/pypi/pyversions/rh-cli.svg)](https://pypi.org/project/rh-cli/)
37
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
38
+
39
+ `rh` turns a research idea into a gated pipeline — config → intake → environment →
40
+ literature → plan → state → implement → critique → manuscript → close — with every
41
+ artifact, task, and decision kept in files an agent can read.
42
+
43
+ The **CLI is the product**. The **skill is additive**: it teaches an AI agent (pi,
44
+ Claude, Codex, …) how to drive `rh`, ask the user the right questions, and respect the
45
+ gates. Install the CLI, then optionally install the skill globally.
46
+
47
+ ---
48
+
49
+ ## Install
50
+
51
+ ```bash
52
+ # once published to PyPI (distribution name: rh-cli, command: rh)
53
+ uv tool install rh-cli
54
+
55
+ # or straight from git
56
+ uv tool install git+https://github.com/hitaishi2222/research-helper
57
+
58
+ # or from a clone
59
+ git clone https://github.com/hitaishi2222/research-helper
60
+ cd research-helper
61
+ uv tool install .
62
+ ```
63
+
64
+ `pipx install rh-cli` and `pip install --user rh-cli` work too.
65
+ Verify with:
66
+
67
+ ```bash
68
+ rh --version
69
+ rh describe
70
+ ```
71
+
72
+ ### Install the skill (optional)
73
+
74
+ ```bash
75
+ rh skill install # ~/.agents/skills/research-helper/
76
+ rh skill install --dest ~/.pi/agent/skills/research-helper # pi-specific location
77
+ ```
78
+
79
+ Pi and other [Agent Skills](https://agentskills.io/specification) clients discover
80
+ `~/.agents/skills/` automatically. The skill is bundled in the wheel, so there is
81
+ nothing else to download.
82
+
83
+ ---
84
+
85
+ ## Quickstart
86
+
87
+ ```bash
88
+ rh init --slug my-project
89
+ rh env set agents.count=2 agents.backend=tmux \
90
+ literature.search=crw project.git=true
91
+ rh env show # config as a table, validated
92
+ rh phase 4 # gated: refuses to skip unmet exits
93
+ rh describe # the map an agent reads
94
+ ```
95
+
96
+ The Orchestrator (your agent) interviews you for the environment and writes the
97
+ `## Environment` section of `ENV.md`; `rh` never probes or auto-fills binaries.
98
+ A tool on `PATH` does not mean this project should use it.
99
+
100
+ ---
101
+
102
+ ## Commands
103
+
104
+ | Command | What it does |
105
+ |---|---|
106
+ | `rh init [--slug NAME] [--clean]` | create the `.rh/` workspace |
107
+ | `rh env show` | print config as a table + environment notes, validate |
108
+ | `rh env set KEY=VALUE ...` | set any key from the §2 schema (`rh env list`) |
109
+ | `rh env list` | every settable key, type, choices, help |
110
+ | `rh add note <heading> [-m BODY] [--file NAME]` | create/append a note file |
111
+ | `rh add literature <DOI-or-heading> [-m BODY]` | append under that DOI/heading in `LITERATURE.md` |
112
+ | `rh add layout <heading> [-m BODY]` | append to `OUTPUT_LAYOUT.md` (patterns + our layout) |
113
+ | `rh add gaps\|problem\|plan\|status\|manuscript <heading> [-m BODY]` | same for the other artifacts |
114
+ | `rh add log --role R --title T [-m BODY]` | §7 log file |
115
+ | `rh add task "title" [--id S01] [--phase N] [--owner ROLE] [--state idle\|working\|complete] [--verify CMD] [--deliverable FILE] [--depends-on S01,S02] [--kind build\|spike]` | add a board task |
116
+ | `rh search <query> [--max N]` | rg-first local search over `.rh/` + artifacts |
117
+ | `rh task set <id> <idle\|working\|complete>` | change a task state |
118
+ | `rh task list [--phase N] [--state S]` | filter the board |
119
+ | `rh tasks [--phase N]` | lanes + progress bars + table |
120
+ | `rh status` | header, phase rail, per-phase progress |
121
+ | `rh workflow` | display the agent-authored `.rh/workflow.mmd` as ASCII (`--tools`, `--example`, `--png`, `--svg`) |
122
+ | `rh phase <0-9>` | set the current phase — **gated**; `--force` records a waiver |
123
+ | `rh plan import [--dry-run]` | mirror `PLAN.md` steps into `tasks.json` |
124
+ | `rh resume` / `rh -r` | open the agent harness with a go-forward prompt |
125
+ | `rh skill install [--dest DIR] [--force]` | install the bundled skill globally |
126
+ | `rh describe [--json]` | the AI map: layout, phases, env keys, budget |
127
+
128
+ Global flags (before the subcommand): `--root DIR`, `--json`, `--version`.
129
+ Every command supports `--json` for agent reads — never parse the pretty UI.
130
+
131
+ ---
132
+
133
+ ## How it works
134
+
135
+ ```
136
+ 0 CONFIG → 1 INTAKE → 2 ENVIRONMENT → 3 LITERATURE → 4 PLAN → 5 STATE
137
+ → 6 IMPLEMENT → 7 CRITIQUE → 8 MANUSCRIPT → 9 CLOSE
138
+ ↑ │
139
+ └── replan ──┘
140
+ ```
141
+
142
+ Each phase has an **exit gate**; `rh phase` refuses to advance past an unmet one.
143
+ State lives in plain files, not a database:
144
+
145
+ ```
146
+ <project>/
147
+ .rh/ machine mirror + logs, notes, managed PDFs, tasks
148
+ src/ implementation
149
+ results/ every number + the script that produced it
150
+ papers/ unmanaged PDFs
151
+ ENV.md config block + Orchestrator-written environment notes
152
+ PROBLEM.md goal, scope, success criteria, falsifier
153
+ OUTPUT_LAYOUT.md output skeleton + patterns from comparable papers
154
+ PLAN.md approved steps
155
+ STATUS.md truth
156
+ LITERATURE.md paper takes with DOI
157
+ GAPS.md implementation sourcing + upstream gaps
158
+ MANUSCRIPT.md write-up
159
+ ```
160
+
161
+ `ENV.md` is the single config source; `.rh/env.json` mirrors it. `rh env set`
162
+ rewrites the JSON block and preserves whatever the Orchestrator wrote below it.
163
+
164
+ ---
165
+
166
+ ## The skill (additive)
167
+
168
+ `src/rh/skills/research-helper/SKILL.md` is the agent-facing half of the project.
169
+ It defines the phases, roles, gates, templates, and the ask-before list. The CLI
170
+ does not need it; the skill does not need to reimplement the CLI.
171
+
172
+ ```bash
173
+ rh skill install
174
+ ```
175
+
176
+ What the skill adds:
177
+
178
+ - **Roles** — Orchestrator, Literature, Researcher, Reviewer, Critique, Writer,
179
+ with a budget mapping for 1–4 agents.
180
+ - **Gates** — user approves the plan, critique veto, "no result without a file".
181
+ - **Templates** — `ENV.md`, `STATUS.md`, `OUTPUT_LAYOUT.md`, `PLAN.md` steps, logs.
182
+ - **Reading discipline** — one layout, a pattern tally, DOI anchors, no paraphrasing
183
+ unread papers.
184
+
185
+ ---
186
+
187
+ ## Development
188
+
189
+ ```bash
190
+ uv venv
191
+ uv pip install -e ".[dev]"
192
+ uv run pytest -q
193
+ uv build # sdist + wheel in dist/
194
+ uv tool install dist/*.whl # smoke-test the installed command
195
+ ```
196
+
197
+ Layout:
198
+
199
+ ```
200
+ pyproject.toml
201
+ src/rh/ the CLI package
202
+ src/rh/skills/ the bundled skill (package data)
203
+ tests/ pytest smoke tests
204
+ docs/IDEA.md original design notes
205
+ ROADMAP.md where this is going
206
+ ```
207
+
208
+ ---
209
+
210
+ ## Roadmap
211
+
212
+ See [ROADMAP.md](ROADMAP.md). Short version: publish to PyPI, harden the CLI,
213
+ then add real agent orchestration.
214
+
215
+ ## License
216
+
217
+ [MIT](LICENSE) © 2026 Hitaishi V
@@ -0,0 +1,17 @@
1
+ rh/__init__.py,sha256=0dxus6Z20V2FT3YcOksuNba5Scs0ehvQr-ss14q-I8M,538
2
+ rh/add.py,sha256=EwI219FGle-SB-zsTrJRD9e7wIRoQX6MmOc_4CoOOk4,4090
3
+ rh/cli.py,sha256=w-OivfP-tlFI1R_mMSia5zQT_TRvilcI484AJofBUes,36672
4
+ rh/config.py,sha256=ScjGkEfRz5lHBCcsI0qTb6CqpdmGqhzHZHmGIatVqFc,12370
5
+ rh/paths.py,sha256=e69yrkVAf2BVQ6b3nwscOFhGOrgw6kgtu3GHa6eVrLw,2728
6
+ rh/resume.py,sha256=0AMmKZitw_03XORYDR6szB7rZ2B7JOPkdGX7S4KYWy4,8268
7
+ rh/search.py,sha256=Kqdzx8ilkOIR3qpbZMzxn3NpCKWqfjE6ef0UIYvgcCw,4080
8
+ rh/tasks.py,sha256=7zFT340Uomnz92XJ5wpIOVg8X0wB_sxBCB8AiE_d4MQ,7508
9
+ rh/ui.py,sha256=OupQeBP_bG0nRim_-yQpwXaWD-rKN0v8skTkCpvs0jU,4447
10
+ rh/workflow.py,sha256=MkKo6feS2Zr7Wfxyrv0Lbqoit2FNhIhjU6PW5jQQNGY,10972
11
+ rh/skills/research-helper/SKILL.md,sha256=6HDXhGcX88bM568iuMjvSNB8eqJFDQ9DENb_NjD6gN4,26537
12
+ rh_cli-0.1.0.dist-info/licenses/LICENSE,sha256=9-FmfuPuwDnf0l8LqAV-U3GGJiPzWt72PRO0yqfcPaM,1067
13
+ rh_cli-0.1.0.dist-info/METADATA,sha256=MEZoju-QGXI8szvK1WYUd0LLWs18I_83_uM0RO0EZ4U,8143
14
+ rh_cli-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
15
+ rh_cli-0.1.0.dist-info/entry_points.txt,sha256=RCi3gM5APmiu5E-UbEDDYgIvldjHnPFlQ0-oAi3Cywg,35
16
+ rh_cli-0.1.0.dist-info/top_level.txt,sha256=WWoMRauMYwpFM0ErdJ48LLYpZiBIQslQCaAkwFsZe4s,3
17
+ rh_cli-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.2.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ rh = rh.cli:main
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Hitaishi V
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1 @@
1
+ rh