@xenonbyte/req-2-plan 0.6.0 → 0.6.1

package/README.md

@@ -43,7 +43,7 @@ important behavior, or when you want a durable handoff between agents.
 - **Four supported platforms**: installs matching surfaces for Claude Code (`claude`), Codex (`codex`), Gemini (`gemini`), and opencode (`opencode`).
 - **One lifecycle CLI**: `r2p install`, `r2p uninstall`, `r2p status`, `r2p version`, and `r2p help`.
 - **Manifest-backed install safety**: pre-existing files are backed up, and uninstall removes only managed paths.
-- **Project Context Pack**: `--repo-path` captures real repository facts for tiering and PLAN checks.
+- **Project Context Pack**: real repository facts (the current directory by default, or `--repo-path <dir>`) ground tiering and PLAN checks.
 - **Repair paths**: reopen closed runs, route upstream gaps, and resolve repaired decisions.
 - **Execution handoff**: `r2p-execute` can drive an approved PLAN through an in-place implementation loop.
 
@@ -109,20 +109,19 @@ r2p install --platform claude,codex,gemini,opencode
 Install the platform skills, then start a workflow from your agent:
 
 ```text
-/r2p-start --repo-path . "Add rate limiting"
+/r2p-start "Add rate limiting"
 /r2p-continue
 ```
 
 Start from a requirement file instead of inline text:
 
 ```text
-/r2p-start --repo-path . --file change-req.md
+/r2p-start --file change-req.md
 ```
 
-For repositories used as requirement context, pass `--repo-path`. Use `.` for the
-current repository or a path to the target repository for cross-project work.
-This builds the Project Context Pack used by tier estimation and PLAN reference
-checks.
+Tier estimation and the Project Context Pack are grounded in the current
+directory by default. Pass `--repo-path <dir>` to ground them in a different
+repository instead - for example, a target repository for cross-project work.
 
 The workflow stops whenever it needs a human or agent action: tier lock,
 artifact content, quality-gate repair, checkpoint approval, subagent review, or

package/README.zh-CN.md

@@ -38,7 +38,7 @@ AI agent 执行很快，但模糊需求容易变成含糊计划、隐藏范围
 - **支持 4 个平台**：为 Claude Code（`claude`）、Codex（`codex`）、Gemini（`gemini`）、opencode（`opencode`）安装匹配入口。
 - **单一生命周期 CLI**：`r2p install`、`r2p uninstall`、`r2p status`、`r2p version`、`r2p help`。
 - **Manifest-backed 安装安全**：覆盖前备份已存在文件，卸载只删除受管路径。
-- **Project Context Pack**：`--repo-path` 捕获真实仓库事实，用于 tier 估算和 PLAN 校验。
+- **Project Context Pack**：以真实仓库事实（默认当前目录，或用 `--repo-path <dir>`）支撑 tier 估算和 PLAN 校验。
 - **修复路径**：可重开 closed run、路由上游缺口，并关闭已修复的决策路线。
 - **执行交接**：`r2p-execute` 可以把获批 PLAN 接入当前分支上的实现循环。
 
@@ -101,18 +101,18 @@ r2p install --platform claude,codex,gemini,opencode
 安装平台 skill 后，在 agent 里启动一次工作流：
 
 ```text
-/r2p-start --repo-path . "Add rate limiting"
+/r2p-start "Add rate limiting"
 /r2p-continue
 ```
 
 也可以从需求文件启动，而不是传内联文本：
 
 ```text
-/r2p-start --repo-path . --file change-req.md
+/r2p-start --file change-req.md
 ```
 
-只要需求以代码仓库为上下文，就传 `--repo-path`。当前仓库传 `.`，跨项目需求传目标仓库路径。
-这会构建 Project Context Pack，供 tier 估算和 PLAN 引用校验使用。
+tier 估算和 Project Context Pack 默认以当前目录为基准。传 `--repo-path <dir>`
+可改为以另一个仓库为基准——例如跨项目需求里的目标仓库。
 
 工作流会在需要人或 agent 动作时停下：锁定 tier、填写 artifact、修复 quality gate、
 批准 checkpoint、执行 subagent review，或解决 gap。按输出里的 `next:` 命令执行，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenonbyte/req-2-plan",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Requirement-to-PLAN workflow CLI and agent integration installer.",
   "bin": {
     "r2p": "bin/r2p.js"

package/tools/workflow_cli/cli.py

@@ -936,9 +936,9 @@ def _cmd_gap_open(args):
         )
         mgr.save(record)
     except Exception as e:
-        run_md_path.write_text(run_md_before, encoding="utf-8")
+        atomic_write_text(run_md_path, run_md_before)
         for _d, _aa, _artifact_file, artifact_path, artifact_before in reversed(affected):
-            artifact_path.write_text(artifact_before, encoding="utf-8")
+            atomic_write_text(artifact_path, artifact_before)
         print_and_exit(
             format_error(
                 f"Cannot gap-open: failed to mark downstream stale atomically ({e})",

package/tools/workflow_cli/install.py

@@ -18,6 +18,7 @@ from pathlib import Path
 from typing import Any
 
 from tools.workflow_cli.version import R2P_VERSION
+from tools.workflow_cli.atomic import atomic_write_text
 
 
 # ---------------------------------------------------------------------------
@@ -1120,6 +1121,6 @@ def _safe_write(
         backup = _backup_path(backup_dir, dest)
         shutil.copy2(str(dest), str(backup))
         backups.append({"target": str(dest), "backup": str(backup)})
-    dest.write_text(content, encoding="utf-8")
+    atomic_write_text(dest, content)
     installed_paths.append(str(dest))
     written.append(dest)

package/tools/workflow_cli/version.py

@@ -1 +1 @@
-R2P_VERSION = "0.6.0"
+R2P_VERSION = "0.6.1"